JehanneOS/newlib
1
0
Fork 0
Code Issues Pull Requests Projects Releases Wiki Activity

* cygwin.xsl: Allow 3 section levels in TOC.

Browse Source 
* new-features.xml: (ov-new1.7.32): Add new section.
	* ntsec.xml: Rename top-level section to reflect extension of topics.
	Remove old /etc/passwd, /etc/group considerations.  Add new sections
	explaining Windows to POSIX account mapping.  Make setuid sections
	third level sections.
	* pathnames.xml: Note new method of account mapping for fstab.d/$USER.
	* faq-setup.xml: Rework references to /etc/passwd and /etc/group to
	reflect changes to account handling.
	* faq-using.xml: Ditto.
This commit is contained in:
Corinna Vinschen 2014-07-30 11:07:34 +00:00
parent db0378d50f
commit f092b3ddf3
7 changed files with 1368 additions and 208 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

13
winsup/doc/ChangeLog
View File

@ -1,3 +1,16 @@
2014-07-30 Corinna Vinschen <corinna@vinschen.de>
* cygwin.xsl: Allow 3 section levels in TOC.
* new-features.xml: (ov-new1.7.32): Add new section.
* ntsec.xml: Rename top-level section to reflect extension of topics.
Remove old /etc/passwd, /etc/group considerations. Add new sections
explaining Windows to POSIX account mapping. Make setuid sections
third level sections.
* pathnames.xml: Note new method of account mapping for fstab.d/$USER.
* faq-setup.xml: Rework references to /etc/passwd and /etc/group to
reflect changes to account handling.
* faq-using.xml: Ditto.
2014-07-21 Corinna Vinschen <corinna@vinschen.de>
* new-features.xml: (ov-new1.7.31): Add new section.

1
winsup/doc/cygwin.xsl
View File

@ -8,5 +8,6 @@
<xsl:param name="html.stylesheet" select="'docbook.css'"/>
<xsl:param name="use.id.as.filename" select="1" />
<xsl:param name="root.filename" select="@id" />
<xsl:param name="toc.section.depth" select="3" />
</xsl:stylesheet>

15
winsup/doc/faq-setup.xml
View File

@ -377,8 +377,9 @@ you are much better off if you can avoid the problem entirely.
run mkpasswd.
</para>
</listitem>
<listitem><para>You can simply edit the /etc/passwd file and change the Cygwin user name
(first field). It's also a good idea to avoid spaces in the home directory.
<listitem><para>If you already have an /etc/passwd file, you can simply edit
your Cygwin user name (first field). It's also a good idea to avoid spaces in
the home directory.
</para>
</listitem>
</orderedlist>
@ -396,7 +397,7 @@ in order of decreasing priority:
<listitem><para><literal>HOME</literal> from the Windows environment, translated to POSIX form.
</para>
</listitem>
<listitem><para>The entry in /etc/passwd
<listitem><para>The pw_home field from the passwd entry as returned by <command>getent passwd</command>.
</para>
</listitem>
<listitem><para>/home/USERNAME
@ -404,8 +405,7 @@ in order of decreasing priority:
</listitem>
</orderedlist>
<para>When using Cygwin from the network (telnet, ssh,...), <literal>HOME</literal> is set
from /etc/passwd.
<para>When using Cygwin from the network (telnet, ssh,...), <literal>HOME</literal> is taken from the passwd entry.
</para>
<para>If your <literal>HOME</literal> is set to a value such as /cygdrive/c, it is likely
that it was set in Windows. Start a DOS Command Window and type
@ -413,8 +413,9 @@ that it was set in Windows. Start a DOS Command Window and type
</para>
<para>Access to shared drives is often restricted when starting from the network,
thus Domain users may wish to have a different <literal>HOME</literal> in the
Windows environment (on shared drive) than in /etc/passwd (on local drive).
Note that ssh only considers /etc/passwd, disregarding <literal>HOME</literal>.
Windows environment (on shared drive) than in Cygwin (on local drive).
Note that ssh only considers the account information as retrieved by
getpwnam(3), disregarding <literal>HOME</literal>.
</para>
</answer></qandaentry>

21
winsup/doc/faq-using.xml
View File

@ -137,7 +137,7 @@ as such.
<para>Your .bashrc is read from your home directory specified by the HOME
environment variable. It uses /.bashrc if HOME is not set. So you need
to set HOME (and the home dir in your /etc/passwd entry) correctly.
to set HOME (and the home dir in your passwd account information) correctly.
</para>
</answer></qandaentry>
@ -265,12 +265,6 @@ must create the whatis database. Just run the command
<question><para>Why doesn't <literal>chmod</literal> work?</para></question>
<answer>
<para>The most common case is that your <literal>/etc/passwd</literal>
or <literal>/etc/group</literal> files are not properly set up. If
<literal>ls -l</literal> shows a group of <literal>mkpasswd</literal>
or <literal>mkgroup</literal>, you need to run one or both of those
commands.
</para>
<para>If you're using FAT32 instead of NTFS, <literal>chmod</literal>
will fail since FAT32 does not provide any permission information.
You should really consider converting the drive to NTFS with
@ -1031,19 +1025,6 @@ If everything looks ok, run bash. Starting with Windows Vista, make
sure you're running bash elevated.
</para>
<para>
If "cyg_server" is not already in <literal>/etc/passwd</literal>, add it
using <literal>mkpasswd</literal>. Make sure all domain accounts which are
supposed to be able to logon via ssh are in <literal>/etc/passwd</literal>.
Also make sure that all important domain groups are in
<literal>/etc/group</literal>. If in doubt, call
</para>
<screen>
$ mkpasswd -l -d your_domain > /etc/passwd
$ mkgroup -l -d your_domain > /etc/group
</screen>
<para>
Then run ssh-host-config. Answer all questions so that "cyg_server" is
used to run the service. When done, check ownership of

14
winsup/doc/new-features.xml
View File

@ -4,6 +4,20 @@
<sect1 id="ov-new1.7"><title>What's new and what changed in Cygwin 1.7</title>
<sect2 id="ov-new1.7.32"><title>What's new and what changed from 1.7.31 to 1.7.32</title>
<itemizedlist mark="bullet">
<listitem><para>
Introduce reading passwd/group entries directly from SAM/AD, thus allowing
to do without /etc/passwd and /etc/group files. Introduce /etc/nsswitch.conf
file to configure passwd/group handling.
</para></listitem>
</itemizedlist>
</sect2>
<sect2 id="ov-new1.7.31"><title>What's new and what changed from 1.7.30 to 1.7.31</title>
<itemizedlist mark="bullet">

1508
winsup/doc/ntsec.xml
View File

File diff suppressed because it is too large Load Diff

4
winsup/doc/pathnames.xml
View File

@ -44,7 +44,9 @@ all users. Sometimes there's a requirement to have user specific
mount points. The Cygwin DLL supports user specific fstab files.
These are stored in the directory <filename>/etc/fstab.d</filename>
and the name of the file is the Cygwin username of the user, as it's
stored in the <filename>/etc/passwd</filename> file. The structure of the
created from the Windows account database or stored in the
<filename>/etc/passwd</filename> file (see
<xref linkend="ntsec-mapping"></xref>). The structure of the
user specific file is identical to the system-wide
<filename>fstab</filename> file.</para>