documentation/2902: apachectl(8) manpage does not report restart failure when httpd runs chrooted and additional modules are loaded

From: Francesco Toscan <francesco(at)toscan.biz>
Date: Sat Aug 24 2002 - 09:50:45 EDT

>Number: 2902
>Category: documentation
>Synopsis: apachectl(8) manpage does not report restart failure when httpd runs chrooted and additional modules are loaded
>Confidential: no
net
>Environment:

	System      : OpenBSD 3.1
	Architecture: OpenBSD.i386
	Machine     : i386

>Description:

	When the Apache daemon runs chrooted and additional modules are loaded,
	ie. mod_perl, apachectl restart will fail since modules are outside
	the chroot tree. A complete stop/start is required.

	[Sat Aug 24 15:21:48 2002] [notice] SIGHUP received.  Attempting to restart
	Syntax error on line 197 of /conf/httpd.conf:
	Cannot load /usr/lib/apache/modules/mod_perl.so into server: No such file or directory
	
	httpd dies.

>How-To-Repeat:

Index: apachectl.8

---

RCS file: /cvs/src/usr.sbin/httpd/src/support/apachectl.8,v retrieving revision 1.3
diff -u -r1.3 apachectl.8
--- apachectl.8 2002/03/29 02:08:08 1.3 +++ apachectl.8 2002/08/24 13:35:47
@@ -100,6 +100,13 @@
 This command automatically checks the configuration files via  .BI configtest
 before initiating the restart to make sure Apache doesn't die.

+If the Apache daemon runs chrooted (default in OpenBSD) and      
+additional modules are loaded, restart will fail due to path
+inconsistency. Completely
+.BI stop
+and
+.BI start
+the daemon instead.

 .TP
 .BI fullstatus
 Displays a full status report from

>Release-Note:
Received on Thu Nov 7 16:12:51 2002