svn commit: r109600 - /perl/modperl/docs/trunk/src/docs/2.0/user/handlers/server.pod

[st...@apache.org]

Author: stas
Date: Thu Dec  2 16:27:02 2004
New Revision: 109600

URL: http://svn.apache.org/viewcvs?view=rev&rev=109600
Log:
document the various issues with httpd -k (...)

Modified:
   perl/modperl/docs/trunk/src/docs/2.0/user/handlers/server.pod

Modified: perl/modperl/docs/trunk/src/docs/2.0/user/handlers/server.pod
Url: http://svn.apache.org/viewcvs/perl/modperl/docs/trunk/src/docs/2.0/user/handlers/server.pod?view=diff&rev=109600&p1=perl/modperl/docs/trunk/src/docs/2.0/user/handlers/server.pod&r1=109599&p2=perl/modperl/docs/trunk/src/docs/2.0/user/handlers/server.pod&r2=109600
==============================================================================
--- perl/modperl/docs/trunk/src/docs/2.0/user/handlers/server.pod	(original)
+++ perl/modperl/docs/trunk/src/docs/2.0/user/handlers/server.pod	Thu Dec  2 16:27:02 2004
@@ -428,6 +428,64 @@
   PerlChildExitHandler  MyApache::StartupLog::child_exit
 
 
+
+=head1 Startup Apache Commands
+
+Some notes on how Apache start/restart Apache commands affect
+mod_perl.
+
+META: not sure this is the best place for this section, but start some
+notes here.
+
+Apache reparses F<httpd.conf> at least once for B<each> of the
+following commands (and will run any mod_perl code found in it).
+
+
+=over
+
+=item httpd -k start
+
+No special issues here.
+
+Apache start and immediately restarts itself.
+
+
+
+=item httpd -k restart
+
+This will abort any processed requests and restart the server.
+
+All kind of problems could be encountered here, including segfaults
+and other kind of crashes. This is because when the C<SIGTERM> signal
+is sent, things in process will be aborted.
+
+Avoid using this method.
+
+Alternatively C<httpd -k restart> can be executed C<kill -HUP
+HTTPD_PID>.
+
+
+
+=item httpd -k graceful
+
+No issues here. Apache starts and restarts itself just like with
+C<start>, but it waits for the existing requests to finish before
+killing them.
+
+Alternatively C<httpd -k graceful> can be executed C<kill -USR1
+HTTPD_PID>.
+
+
+=item httpd -k stop
+
+Similarly to C<httpd -k restart> you may encounter all kind of issue
+here, due to the C<SIGTERM> signal.
+
+=back
+
+
+
+
 =head1 Maintainers
 
 Maintainer is the person(s) you should contact with updates,

---------------------------------------------------------------------
To unsubscribe, e-mail: docs-cvs-unsubscribe@perl.apache.org
For additional commands, e-mail: docs-cvs-help@perl.apache.org