libapache2-mod-chroot for Debian GNU/Linux
-----------------------------------------

Usage on Kernels 2.6.x with NPTL:

 If using libapache2-mod-chroot on Kernel Versions 2.6, in 
 connection with the Native Posix Threading Libraries, Apache2
 will fail to start as soon as the `ChrootDir' Directive in 
 `/etc/apache2/apache2.conf' is present.

 The Problem is that mod_chroot Chroots into the Directory
 specified in the `ChrootDir' directive after loading all 
 needed Libraries and as a consequence fails to Load other
 Libs outside of /lib/tls/.
 
 It is likely that you will Discover Messages like this one
 in your `/var/log/apache2/error.log':
 
  libgcc_s.so.1 must be installed for pthread_cancel to work

 To solve this Problem, you have to load the Libraries by
 placing the `LoadFile' Directive in `/etc/apache2/httpd.conf':

   <IfModule mod_chroot.c>
   	LoadFile /lib/libgcc_s.so.1
   </IfModule>
		  
 For more Informations regarding mod_chroot and Apache 2.x 
 please read README.Apache20.


Apache20 fails to find its pid file:

 Debian's Apache2 stores its pid file in /var/run/apache2.pid, not
 /var/run/httpd.pid (as mentioned in upstream's README.Apache20).
 Restarting the Apache daemon by using the init scripts in /etc/init.d/
 wont work, if the pid file gets linked to /var/run/httpd.pid. 

 To make it work, do the following steps:

    1. ln -s /var/www/var/run/apache2.pid /var/run/apache2.pid

    2. Append the following to /etc/apache2/apache2.conf:
        <IfModule mod_chroot.c>
            LoadFile /lib/libgcc_s.so.1
            PidFile /var/run/apache2.pid
            ChrootDir /var/www
            DocumentRoot /
        </IfModule>