summaryrefslogtreecommitdiffstats
diff options
context:
space:
mode:
authorCorinna Vinschen <corinna@vinschen.de>2014-10-29 10:09:41 +0000
committerCorinna Vinschen <corinna@vinschen.de>2014-10-29 10:09:41 +0000
commit1a6fa5618aa9689a4c4d7d48e97ffa5673395ea7 (patch)
tree5dc7ce18acaea98acf0d9daec6c24a0b4d3c4ef7
parent6bb19351d92b3ea1691f96c15fdd230f2f4ce9ac (diff)
downloadcygnal-1a6fa5618aa9689a4c4d7d48e97ffa5673395ea7.tar.gz
cygnal-1a6fa5618aa9689a4c4d7d48e97ffa5673395ea7.tar.bz2
cygnal-1a6fa5618aa9689a4c4d7d48e97ffa5673395ea7.zip
* ntsec.xml (ntsec-mapping-caching): Describe service dependencies
in terms of cygserver.
-rw-r--r--winsup/doc/ChangeLog5
-rw-r--r--winsup/doc/ntsec.xml45
2 files changed, 50 insertions, 0 deletions
diff --git a/winsup/doc/ChangeLog b/winsup/doc/ChangeLog
index 7d3c0e2d8..f8a9d3203 100644
--- a/winsup/doc/ChangeLog
+++ b/winsup/doc/ChangeLog
@@ -1,3 +1,8 @@
+2014-10-29 Dave Habermann <dahabermann@dow.com>
+
+ * ntsec.xml (ntsec-mapping-caching): Describe service dependencies
+ in terms of cygserver.
+
2014-10-28 Corinna Vinschen <corinna@vinschen.de>
* xidepend: Make PDF file dependent on the same input files as the
diff --git a/winsup/doc/ntsec.xml b/winsup/doc/ntsec.xml
index 79e8fd1e2..e158615a2 100644
--- a/winsup/doc/ntsec.xml
+++ b/winsup/doc/ntsec.xml
@@ -932,6 +932,51 @@ its service. Additionally, all information requested from
be cached inside the process itself and, again, propagated to child processes.
</para>
+<para>
+If you automatically start Cygwin processes as Windows services at system
+startup, you may wish to consider starting
+<command><link linkend="using-cygserver">cygserver</link></command> first in
+order to take advantage of this system-wide caching. To assure that
+<command><link linkend="using-cygserver">cygserver</link></command> has started
+prior to starting <command>sshd</command> or other Cygwin processes, you may
+wish to create service startup dependencies.
+<command><link linkend="using-cygserver">Cygserver</link></command> should
+probably wait for Windows TCPIP and AFD services before it starts, and then
+other Cygwin process should start after
+<command><link linkend="using-cygserver">cygserver</link></command>. Example
+Windows commands to accomplish this (after the services already exist) are
+shown below. You will need an administrative prompt to run the
+<command>sc config</command> commands.
+</para>
+
+<screen>
+ # Delay Cygserver until TCPIP and AFD have started
+ # Note the (odd) required space character after "depend="
+
+ sc config cygserver depend= tcp/afd
+
+ # Delay sshd until after Cygserver has started
+ # Again note the (odd) required space character after "depend="
+
+ sc config sshd depend= cygserver
+
+ # View the Cygserver service details
+
+ sc qc cygserver
+</screen>
+
+<para>
+Note that this <command>sc config</command> command
+<emphasis>replaces</emphasis> any existing dependencies. The above changes
+will not impact the running instance, only future instances.
+</para>
+
+<screen>
+ # To remove all dependencies from the cygserver service
+
+ sc config cygserver depend= /
+</screen>
+
</sect3>
<sect3 id="ntsec-mapping-nfs"><title id="ntsec-mapping-nfs.title">NFS account mapping</title>