pcs 98/10/07 01:52:32
Modified: htdocs/manual windows.html Log: Document the -k command line argument. This is based on a previous patch to add this documentation from [EMAIL PROTECTED] (16 Jun 1998). Revision Changes Path 1.23 +33 -3 apache-1.3/htdocs/manual/windows.html Index: windows.html =================================================================== RCS file: /export/home/cvs/apache-1.3/htdocs/manual/windows.html,v retrieving revision 1.22 retrieving revision 1.23 diff -u -r1.22 -r1.23 --- windows.html 1998/09/17 14:14:49 1.22 +++ windows.html 1998/10/07 08:52:31 1.23 @@ -17,7 +17,7 @@ <H1 ALIGN="CENTER">Using Apache With Microsoft Windows</H1> <P>This document explains how to install, configure and run - Apache 1.3 under Microsoft Windows. Please note that at + Apache 1.3b6 and later under Microsoft Windows. Please note that at this time, Windows support is entirely experimental, and is recommended only for experienced users. The Apache Group does not guarantee that this software will work as documented, or even at @@ -47,6 +47,7 @@ <LI><A HREF="#run">Running Apache for Windows</A> <LI><A HREF="#use">Using Apache for Windows</A> <LI><A HREF="#cmdline">Running Apache for Windows from the Command Line</A> + <LI><A HREF="#signal">Signalling Apache when running</A> <LI><A HREF="#comp">Compiling Apache for Windows</A> </UL> @@ -183,8 +184,8 @@ To run Apache from a console window, select the "Apache Server" option from the Start menu. This will open a console window and start Apache running inside it. The window will remain active until you stop -Apache. To stop Apache running, press Control-C within the console -window. +Apache. To stop Apache running, see <A HREF="#signal>Signalling Apache +when Running</SAMP>. <P> @@ -355,6 +356,35 @@ apache -u </PRE> + +<H2><A NAME="signal">Signalling Apache when running</A></H2> + +On Windows 95 Apache runs as a console application. You can tell a +running Apache to stop by opening another console window and running + +<PRE> + apache -k shutdown +</PRE> + +This should be used instead of pressing Control-C in the running +Apache console window, because it lets Apache end any current +transactions and cleanup gracefully. + +<P> + +You can also tell Apache to restart. This makes it re-read the +configuration files. Any transactions in progress are allowed to +complete without interruption. To restart Apache, run + +<PRE> + apache -k restart +</PRE> + +Note for people familiar with the Unix version of Apache: these +commands provide a Windows equivalent to <CODE>kill -TERM +<i>pid</i></CODE> and <CODE>kill -USR1 <i>pid</i></CODE>. The command +line option used, <CODE>-k</CODE>, was chosen as a reminder of the +"kill" command used on Unix. <H2><A NAME="comp">Compiling Apache for Windows</A></H2>