From: Joshua Slive <slive@apache.org>
Date: Sun, 19 Nov 2000 19:56:42 +0000 (+0000)
Subject: Add the perchild MPM docs and do a little bit of cleanup.
X-Git-Url: https://granicus.if.org/sourcecode?a=commitdiff_plain;h=4ca40865c725b3261d6287d78dceca28ebcc1011;p=apache

Add the perchild MPM docs and do a little bit of cleanup.

This finishes up the basic structure of the windows and unix
MPMs.  I can do a little more cleanup, but this will need some heavy
input from others, because I don't feel like going through each
MPM to figure out what all these directive actually do.


git-svn-id: https://svn.apache.org/repos/asf/httpd/httpd/trunk@87029 13f79535-47bb-0310-9956-ffa450edef68
---

diff --git a/docs/manual/mod/dexter.html b/docs/manual/mod/dexter.html
index b214947e85..51c047d277 100644
--- a/docs/manual/mod/dexter.html
+++ b/docs/manual/mod/dexter.html
@@ -28,12 +28,12 @@ REL="Help"
 <A
 HREF="module-dict.html#SourceFile"
 REL="Help"
-><STRONG>Source File:</STRONG></A> mpmt_pthread.c
+><STRONG>Source File:</STRONG></A> dexter.c
 <BR>
 <A
 HREF="module-dict.html#ModuleIdentifier"
 REL="Help"
-><STRONG>Module Identifier:</STRONG></A> mpm_mpmt_pthread_module
+><STRONG>Module Identifier:</STRONG></A> mpm_dexter_module
 </P>
 
 <H2>Summary</H2>
@@ -47,7 +47,7 @@ or decreasing the number of threads.</p>
 
 <H2>Directives</H2>
 <UL>
-<li><a href="#connectionstatus">ConnectionStatus</a></li>
+<li><a href="mpm_common.html#connectionstatus">ConnectionStatus</a></li>
 <li><a href="mpm_common.html#coredumpdirectory">CoreDumpDirectory</a></li>
 <li><a href="mpm_common.html#group">Group</a></li>
 <li><a href="mpm_common.html#pidfile">PidFile</a></li>
@@ -57,91 +57,13 @@ or decreasing the number of threads.</p>
 <li><a href="mpm_common.html#maxrequestsperchild">MaxRequestsPerChild</a></li>
 <li><a href="mpm_common.html#maxsparethreads">MaxSpareThreads</a></li>
 <li><a href="mpm_common.html#minsparethreads">MinSpareThreads</a></li>
-<li><a href="#numservers">NumServers</a></li>
+<li><a href="mpm_common.html#numservers">NumServers</a></li>
 <li><a href="mpm_common.html#scoreboardfile">ScoreBoardFile</a></li>
 <li><a href="mpm_common.html#sendbuffersize">SendBufferSize</a></li>
-<li><a href="#startthreads">StartThreads</a></li>
+<li><a href="mpm_common.html#startthreads">StartThreads</a></li>
 <li><a href="mpm_common.html#user">User</a></li>
 </UL>
 
-
-<H2><A NAME="connectionstatus">ConnectionStatus directive</A></H2>
-<p><A
- HREF="directive-dict.html#Syntax"
- REL="Help"
-><STRONG>Syntax:</STRONG></A>
-<A
- HREF="directive-dict.html#Default"
- REL="Help"
-><STRONG>Default:</STRONG></A>
-<A
- HREF="directive-dict.html#Context"
- REL="Help"
-><STRONG>Context:</STRONG></A> server config<BR>
-<A
- HREF="directive-dict.html#Status"
- REL="Help"
-><STRONG>Status:</STRONG></A> MPM<P>
-<A
- HREF="directive-dict.html#Module"
- REL="Help"
-><STRONG>Module:</STRONG></A> dexter</p>
-
-<p>Whether or not to maintain status information on current 
-connections</p>
-
-<p><hr></p>
-
-<H2><A NAME="numservers">NumServers directive</A></H2>
-<p><A
- HREF="directive-dict.html#Syntax"
- REL="Help"
-><STRONG>Syntax:</STRONG></A>
-<A
- HREF="directive-dict.html#Default"
- REL="Help"
-><STRONG>Default:</STRONG></A>
-<A
- HREF="directive-dict.html#Context"
- REL="Help"
-><STRONG>Context:</STRONG></A> server config<BR>
-<A
- HREF="directive-dict.html#Status"
- REL="Help"
-><STRONG>Status:</STRONG></A> MPM<P>
-<A
- HREF="directive-dict.html#Module"
- REL="Help"
-><STRONG>Module:</STRONG></A> dexter</p>
-
-<p>Number of children alive at the same time.</p>
-
-<p><hr></p>
-
-<H2><A NAME="startthreads">StartThreads directive</A></H2>
-<p><A
- HREF="directive-dict.html#Syntax"
- REL="Help"
-><STRONG>Syntax:</STRONG></A>
-<A
- HREF="directive-dict.html#Default"
- REL="Help"
-><STRONG>Default:</STRONG></A>
-<A
- HREF="directive-dict.html#Context"
- REL="Help"
-><STRONG>Context:</STRONG></A> server config<BR>
-<A
- HREF="directive-dict.html#Status"
- REL="Help"
-><STRONG>Status:</STRONG></A> MPM<P>
-<A
- HREF="directive-dict.html#Module"
- REL="Help"
-><STRONG>Module:</STRONG></A> dexter</p>
-
-<p>Number of threads each child creates.</p>
-
 <!--#include virtual="footer.html" -->
 </BODY>
 </HTML>
diff --git a/docs/manual/mod/directives.html b/docs/manual/mod/directives.html
index cd56461b4e..824a6d31c8 100644
--- a/docs/manual/mod/directives.html
+++ b/docs/manual/mod/directives.html
@@ -54,6 +54,7 @@ of the terms used in their descriptions available.
 <LI><A HREF="mod_auth_anon.html#MustGiveEmail">Anonymous_MustGiveEmail</A>
 <LI><A HREF="mod_auth_anon.html#NoUserID">Anonymous_NoUserID</A>
 <LI><A HREF="mod_auth_anon.html#VerifyEmail">Anonymous_VerifyEmail</A>
+<LI><A HREF="perchild.html#assignuserid">AssignUserID</A>
 <LI><A HREF="mod_auth.html#authauthoritative">AuthAuthoritative</A>
 <LI><A HREF="mod_auth_db.html#authdbauthoritative">AuthDBAuthoritative</A>
 <LI><A HREF="mod_auth_db.html#authdbgroupfile">AuthDBGroupFile</A>
@@ -62,7 +63,6 @@ of the terms used in their descriptions available.
 <LI><A HREF="mod_auth_dbm.html#authdbmgroupfile">AuthDBMGroupFile</A>
 <LI><A HREF="mod_auth_db.html#authdbuserfile">AuthDBUserFile</A>
 <LI><A HREF="mod_auth_dbm.html#authdbmuserfile">AuthDBMUserFile</A>
-<LI><A HREF="mod_digest.html#authdigestfile">AuthDigestFile</A>
 <LI><A HREF="mod_auth.html#authgroupfile">AuthGroupFile</A>
 <LI><A HREF="core.html#authname">AuthName</A>
 <LI><A HREF="core.html#authtype">AuthType</A>
@@ -85,13 +85,14 @@ of the terms used in their descriptions available.
 <LI><A HREF="mod_charset_lite.html#charsetsourceenc">CharsetSourceEnc</A>
 <LI><A HREF="mod_charset_lite.html#charsetoptions">CharsetOptions</A>
 <LI><A HREF="mod_speling.html#checkspelling">CheckSpelling</A>
+<LI><A HREF="perchild.html#childperuserid">ChildPerUserID</A>
 <LI><A HREF="core.html#clearmodulelist">ClearModuleList</A>
+<LI><A HREF="mpm_common.html#connectionstatus">ConnectionStatus</A>
 <LI><A HREF="core.html#contentdigest">ContentDigest</A>
 <LI><A HREF="mod_usertrack.html#cookieexpires">CookieExpires</A>
-<LI><A HREF="mod_cookies.html#cookielog">CookieLog</A> (mod_cookies)
-<LI><A HREF="mod_log_config.html#cookielog">CookieLog</A> (mod_log_config)
+<LI><A HREF="mod_log_config.html#cookielog">CookieLog</A>
 <LI><A HREF="mod_usertrack.html#cookietracking">CookieTracking</A>
-<LI><A HREF="mpmt_pthread.html#coredumpdirectory">CoreDumpDirectory</A>
+<LI><A HREF="mpm_common.html#coredumpdirectory">CoreDumpDirectory</A>
 <LI><A HREF="mod_log_config.html#customlog">CustomLog</A>
 <LI><A HREF="mod_dav.html#dav">Dav</A>
 <LI><A HREF="mod_dav.html#davdepthinfinity">DavDepthInfinity</A>
@@ -118,7 +119,7 @@ of the terms used in their descriptions available.
 <LI><A HREF="core.html#files">&lt;Files&gt;</A>
 <LI><A HREF="core.html#filesmatch">&lt;FilesMatch&gt;</A>
 <LI><A HREF="mod_mime.html#forcetype">ForceType</A>
-<LI><A HREF="core.html#group">Group</A>
+<LI><A HREF="mpm_common.html#group">Group</A>
 <LI><A HREF="mod_headers.html#header">Header</A>
 <LI><A HREF="mod_autoindex.html#headername">HeaderName</A>
 <LI><A HREF="core.html#hostnamelookups">HostNameLookups</A>
@@ -146,31 +147,33 @@ of the terms used in their descriptions available.
 <LI><A HREF="core.html#limitrequestfieldsize">LimitRequestFieldsize</A>
 <LI><A HREF="core.html#limitrequestline">LimitRequestLine</A>
 <LI><A HREF="mod_dav.html#limitxmlrequestbody">LimitXMLRequestBody</A>
-<LI><A HREF="core.html#listen">Listen</A>
-<LI><A HREF="core.html#listenbacklog">ListenBacklog</A>
+<LI><A HREF="mpm_common.html#listen">Listen</A>
+<LI><A HREF="mpm_common.html#listenbacklog">ListenBacklog</A>
 <LI><A HREF="mod_so.html#loadfile">LoadFile</A>
 <LI><A HREF="mod_so.html#loadmodule">LoadModule</A>
 <LI><A HREF="core.html#location">&lt;Location&gt;</A>
 <LI><A HREF="core.html#locationmatch">&lt;LocationMatch&gt;</A>
-<LI><A HREF="mpmt_pthread.html#lockfile">LockFile</A>
+<LI><A HREF="mpm_common.html#lockfile">LockFile</A>
 <LI><A HREF="mod_log_config.html#logformat">LogFormat</A>
 <LI><A HREF="core.html#loglevel">LogLevel</A>
-<LI><A HREF="mpmt_pthread.html#maxclients">MaxClients</A>
+<LI><A HREF="mpm_common.html#maxclients">MaxClients</A>
 <LI><A HREF="core.html#maxkeepaliverequests">MaxKeepAliveRequests</A>
-<LI><A HREF="mpmt_pthread.html#maxrequestsperchild">MaxRequestsPerChild</A>
-<LI><A HREF="mpmt_pthread.html#maxsparethreads">MaxSpareThreads</A>
+<LI><A HREF="mpm_common.html#maxrequestsperchild">MaxRequestsPerChild</A>
+<LI><A HREF="prefork.html#maxspareservers">MaxSpareServers</A>
+<LI><A HREF="mpm_common.html#maxsparethreads">MaxSpareThreads</A>
 <LI><A HREF="mod_cern_meta.html#metadir">MetaDir</A>
 <LI><A HREF="mod_cern_meta.html#metafiles">MetaFiles</A>
 <LI><A HREF="mod_cern_meta.html#metasuffix">MetaSuffix</A>
 <LI><A HREF="mod_mime_magic.html#mimemagicfile">MimeMagicFile</A>
-<LI><A HREF="mpmt_pthread.html#minsparethreads">MinSpareThreads</A>
-<LI><A HREF="mod_mmap_static.html#mmapfile">MMapFile</A>
+<LI><A HREF="prefork.html#minspareservers">MinSpareServers</A>
+<LI><A HREF="mpm_common.html#minsparethreads">MinSpareThreads</A>
 <LI><A HREF="core.html#namevirtualhost">NameVirtualHost</A>
 <LI><A HREF="mod_proxy.html#nocache">NoCache</A>
+<LI><A HREF="mpm_common.html#numservers">NumServers</A>
 <LI><A HREF="core.html#options">Options</A>
 <LI><A HREF="mod_access.html#order">Order</A>
 <LI><A HREF="mod_env.html#passenv">PassEnv</A>
-<LI><A HREF="mpmt_pthread.html#pidfile">PidFile</A>
+<LI><A HREF="mpm_common.html#pidfile">PidFile</A>
 <LI><A HREF="core.html#port">Port</A>
 <LI><A HREF="mod_proxy.html#proxyblock">ProxyBlock</A>
 <LI><A HREF="mod_proxy.html#proxydomain">ProxyDomain</A>
@@ -203,7 +206,7 @@ of the terms used in their descriptions available.
 <LI><A HREF="core.html#rlimitmem">RLimitMEM</A>
 <LI><A HREF="core.html#rlimitnproc">RLimitNPROC</A>
 <LI><A HREF="core.html#satisfy">Satisfy</A>
-<LI><A HREF="mpmt_pthread.html#scoreboardfile">ScoreBoardFile</A>
+<LI><A HREF="mpm_common.html#scoreboardfile">ScoreBoardFile</A>
 <LI><A HREF="mod_actions.html#script">Script</A>
 <LI><A HREF="mod_alias.html#scriptalias">ScriptAlias</A>
 <LI><A HREF="mod_alias.html#scriptaliasmatch">ScriptAliasMatch</A>
@@ -211,7 +214,7 @@ of the terms used in their descriptions available.
 <LI><A HREF="mod_cgi.html#scriptlog">ScriptLog</A>
 <LI><A HREF="mod_cgi.html#scriptlogbuffer">ScriptLogBuffer</A>
 <LI><A HREF="mod_cgi.html#scriptloglength">ScriptLogLength</A>
-<LI><A HREF="core.html#sendbuffersize">SendBufferSize</A>
+<LI><A HREF="mpm_common.html#sendbuffersize">SendBufferSize</A>
 <LI><A HREF="core.html#serveradmin">ServerAdmin</A>
 <LI><A HREF="core.html#serveralias">ServerAlias</A>
 <LI><A HREF="core.html#servername">ServerName</A>
@@ -224,14 +227,15 @@ of the terms used in their descriptions available.
 <LI><A HREF="mod_setenvif.html#setenvif">SetEnvIf</A>
 <LI><A HREF="mod_setenvif.html#SetEnvIfNoCase">SetEnvIfNoCase</A>
 <LI><A HREF="mod_mime.html#sethandler">SetHandler</A>
-<LI><A HREF="mpmt_pthread.html#startservers">StartServers</A>
-<LI><A HREF="mpmt_pthread.html#threadsperchild">ThreadsPerChild</A>
+<LI><A HREF="mpm_common.html#startservers">StartServers</A>
+<LI><A HREF="mpm_common.html#startthreads">StartThreads</A>
+<LI><A HREF="mpm_common.html#threadsperchild">ThreadsPerChild</A>
 <LI><A HREF="core.html#timeout">TimeOut</A>
 <LI><A HREF="mod_log_config.html#transferlog">TransferLog</A>
 <LI><A HREF="mod_mime.html#typesconfig">TypesConfig</A>
 <LI><A HREF="mod_env.html#unsetenv">UnsetEnv</A>
 <LI><A HREF="core.html#usecanonicalname">UseCanonicalName</A>
-<LI><A HREF="core.html#user">User</A>
+<LI><A HREF="mpm_common.html#user">User</A>
 <LI><A HREF="mod_userdir.html#userdir">UserDir</A>
 <LI><A HREF="core.html#virtualhost">&lt;VirtualHost&gt;</A>
 <LI><A HREF="mod_vhost_alias.html#virtualdocumentroot">VirtualDocumentRoot</A>
diff --git a/docs/manual/mod/index.html b/docs/manual/mod/index.html
index 03e47193eb..7c385a3396 100644
--- a/docs/manual/mod/index.html
+++ b/docs/manual/mod/index.html
@@ -30,14 +30,17 @@ directives</A>.
 <DT><A HREF="core.html">Core</A>
 <DD>Core Apache features.
 <DT><a href="dexter.html">dexter</a>
-<DD>Multi-Processing Model with Threading via Pthreads; Fixed number
+<DD>Multi-Processing Module with Threading via Pthreads; Fixed number
 of processes, variable number of threads/child
 <DT><A HREF="mpmt_pthread.html">mpmt_pthread</A>
-<DD>Multi-Processing Model with Threading via Pthreads; Variable number
+<DD>Multi-Processing Module with Threading via Pthreads; Variable number
 of processes, constant number of threads/child
 <DT><a href="mpm_winnt.html">mpm_winnt</a>
-<DD>Multi-Processing Model with a single control process and a single
+<DD>Multi-Processing Module with a single control process and a single
 server process with multiple threads for Windows NT
+<DT><a href="perchild.html">perchild</a>
+<DD>Multi-Processing Module with the ability to server different
+virtual hosts under different userids.
 <DT><a href="prefork.html">prefork</a>
 <DD>Non-threaded preforking processes model similar to Apache 1.3
 </DL>
diff --git a/docs/manual/mod/mod_usertrack.html b/docs/manual/mod/mod_usertrack.html
index 51099659af..69c27990f4 100644
--- a/docs/manual/mod/mod_usertrack.html
+++ b/docs/manual/mod/mod_usertrack.html
@@ -63,8 +63,7 @@ added.</p>
 own logging, using the <TT>CookieLog</TT> directive. In this release,
 this module does no logging at all. Instead, a configurable log
 format file should be used to log user click-streams. This is possible
-because the logging module now allows <A
-HREF="../multilogs.html">multiple log files</A>. The cookie itself is
+because the logging module allows multiple log files. The cookie itself is
 logged by using the text <TT>%{cookie}n </TT>
 in the log file format. For example:
 <PRE>
diff --git a/docs/manual/mod/mpm_common.html b/docs/manual/mod/mpm_common.html
index 2b192e8de6..2381122704 100644
--- a/docs/manual/mod/mpm_common.html
+++ b/docs/manual/mod/mpm_common.html
@@ -22,6 +22,7 @@ than one multi-processing module (MPM).
 
 <H2>Directives</H2>
 <UL>
+<li><a href="#connectionstatus">ConnectionStatus</a></li>
 <li><a href="#coredumpdirectory">CoreDumpDirectory</a></li>
 <li><a href="#group">Group</a></li>
 <li><a href="#pidfile">PidFile</a></li>
@@ -32,14 +33,43 @@ than one multi-processing module (MPM).
 <li><a href="#maxrequestsperchild">MaxRequestsPerChild</a></li>
 <li><a href="#maxsparethreads">MaxSpareThreads</a></li>
 <li><a href="#minsparethreads">MinSpareThreads</a></li>
+<li><a href="#numservers">NumServers</a></li>
 <li><a href="#scoreboardfile">ScoreBoardFile</a></li>
 <li><a href="#sendbuffersize">SendBufferSize</a></li>
 <li><a href="#startservers">StartServers</a></li>
+<li><a href="#startthreads">StartThreads</a></li>
 <li><a href="#threadsperchild">ThreadsPerChild</a></li>
 <li><a href="#user">User</a></li>
 </UL>
 <HR>
 
+<H2><A NAME="connectionstatus">ConnectionStatus directive</A></H2>
+<p><A
+ HREF="directive-dict.html#Syntax"
+ REL="Help"
+><STRONG>Syntax:</STRONG></A><BR>
+<A
+ HREF="directive-dict.html#Default"
+ REL="Help"
+><STRONG>Default:</STRONG></A><BR>
+<A
+ HREF="directive-dict.html#Context"
+ REL="Help"
+><STRONG>Context:</STRONG></A> server config<BR>
+<A
+ HREF="directive-dict.html#Status"
+ REL="Help"
+><STRONG>Status:</STRONG></A> MPM<BR>
+<A
+ HREF="directive-dict.html#Module"
+ REL="Help"
+><STRONG>Module:</STRONG></A> dexter, perchild</p>
+
+<p>Whether or not to maintain status information on current 
+connections</p>
+
+<p><hr></p>
+
 <H2><A NAME="coredumpdirectory">CoreDumpDirectory directive</A></H2>
 <!--%plaintext &lt;?INDEX {\tt CoreDumpDirectory} directive&gt; -->
 <p><A
@@ -61,7 +91,7 @@ than one multi-processing module (MPM).
 <A
  HREF="directive-dict.html#Module"
  REL="Help"
-><STRONG>Module:</STRONG></A> dexter, mpmt_pthread, prefork, mpm_winnt</p>
+><STRONG>Module:</STRONG></A> dexter, mpmt_pthread, perchild, prefork, mpm_winnt</p>
 
 <p>This controls the directory to which Apache attempts to switch
 before dumping core.  The default is in the <A
@@ -92,7 +122,7 @@ you can use this directive to place it in a different location.<P><HR>
 <A
  HREF="directive-dict.html#Module"
  REL="Help"
-><STRONG>Module:</STRONG></A> dexter, mpmt_pthread, prefork</p>
+><STRONG>Module:</STRONG></A> dexter, mpmt_pthread, perchild, prefork</p>
 
 The Group directive sets the group under which the server will answer requests.
 In order to use this directive, the stand-alone server must be run initially
@@ -142,7 +172,7 @@ considerations.<P><HR>
 <A
  HREF="directive-dict.html#Module"
  REL="Help"
-><STRONG>Module:</STRONG></A> dexter, mpmt_pthread, prefork, mpm_winnt</p>
+><STRONG>Module:</STRONG></A> dexter, mpmt_pthread, perchild, prefork, mpm_winnt</p>
 
 <p>The PidFile directive sets the file to which the server records the
 process id of the daemon. If the filename does not begin with a slash
@@ -177,7 +207,7 @@ Listen [<EM>IP address</EM>:]<EM>port number</EM><BR>
 <A
  HREF="directive-dict.html#Module"
  REL="Help"
-><STRONG>Module:</STRONG></A> dexter, mpmt_pthread, prefork, mpm_winnt</p>
+><STRONG>Module:</STRONG></A> dexter, mpmt_pthread, perchild, prefork, mpm_winnt</p>
 
 
 <P>The Listen directive instructs Apache to listen to more than one IP
@@ -247,7 +277,7 @@ interfaces and port numbers, use
 <A
  HREF="directive-dict.html#Module"
  REL="Help"
-><STRONG>Module:</STRONG></A> dexter, mpmt_pthread, prefork, mpm_winnt</p>
+><STRONG>Module:</STRONG></A> dexter, mpmt_pthread, perchild, prefork, mpm_winnt</p>
 
 <P>The maximum length of the queue of pending connections.  Generally no
 tuning is needed or desired, however on some systems it is desirable
@@ -280,7 +310,7 @@ use exactly what is specified as the backlog, but use a number based on
 <A
  HREF="directive-dict.html#Module"
  REL="Help"
-><STRONG>Module:</STRONG></A> dexter, mpmt_pthread, prefork</p>
+><STRONG>Module:</STRONG></A> dexter, mpmt_pthread, perchild, prefork</p>
 
 <p>The LockFile directive sets the path to the lockfile used when
 Apache is compiled with either USE_FCNTL_SERIALIZED_ACCEPT or
@@ -362,7 +392,7 @@ href="#threadsperchild">ThreadsPerChild</a>.</p>
 <A
  HREF="directive-dict.html#Module"
  REL="Help"
-><STRONG>Module:</STRONG></A> dexter, mpmt_pthread, prefork, mpm_winnt</p>
+><STRONG>Module:</STRONG></A> dexter, mpmt_pthread, prefork, perchild, mpm_winnt</p>
 
 <p>The MaxRequestsPerChild directive sets the limit on the number of requests
 that an individual child server process will handle. After MaxRequestsPerChild
@@ -405,7 +435,7 @@ behavior to limit the number of <EM>connections</EM> per child.
 <A
  HREF="directive-dict.html#Module"
  REL="Help"
-><STRONG>Module:</STRONG></A> dexter, mpmt_pthread</p>
+><STRONG>Module:</STRONG></A> dexter, mpmt_pthread, perchild</p>
 
 <P>Maximum number of idle threads.</p>
 
@@ -435,7 +465,7 @@ behavior to limit the number of <EM>connections</EM> per child.
 <A
  HREF="directive-dict.html#Module"
  REL="Help"
-><STRONG>Module:</STRONG></A> dexter, mpmt_pthread</p>
+><STRONG>Module:</STRONG></A> dexter, mpmt_pthread, perchild</p>
 
 <p>Minimum number of idle threads to handle request spikes.
 
@@ -443,6 +473,32 @@ See also <A HREF="#maxsparethreads">MaxSpareThreads</A> and
 <A HREF="#startservers">StartServers</A>.<P><HR>
 
 
+<H2><A NAME="numservers">NumServers directive</A></H2>
+<p><A
+ HREF="directive-dict.html#Syntax"
+ REL="Help"
+><STRONG>Syntax:</STRONG></A><BR>
+<A
+ HREF="directive-dict.html#Default"
+ REL="Help"
+><STRONG>Default:</STRONG></A><BR>
+<A
+ HREF="directive-dict.html#Context"
+ REL="Help"
+><STRONG>Context:</STRONG></A> server config<BR>
+<A
+ HREF="directive-dict.html#Status"
+ REL="Help"
+><STRONG>Status:</STRONG></A> MPM<BR>
+<A
+ HREF="directive-dict.html#Module"
+ REL="Help"
+><STRONG>Module:</STRONG></A> dexter, perchild</p>
+
+<p>Number of children alive at the same time.</p>
+
+<p><hr></p>
+
 <H2><A NAME="scoreboardfile">ScoreBoardFile directive</A></H2>
 <!--%plaintext &lt;?INDEX {\tt ScoreBoardFile} directive&gt; -->
 <p><A
@@ -469,7 +525,7 @@ See also <A HREF="#maxsparethreads">MaxSpareThreads</A> and
 <A
  HREF="directive-dict.html#Module"
  REL="Help"
-><STRONG>Module:</STRONG></A> dexter, mpmt_pthread, prefork</p>
+><STRONG>Module:</STRONG></A> dexter, mpmt_pthread, perchild, prefork</p>
 
 <p>The ScoreBoardFile directive is required on some architectures to place
 a file that the server will use to communicate between its children and
@@ -507,7 +563,7 @@ about log file placement and
 <A
  HREF="directive-dict.html#Module"
  REL="Help"
-><STRONG>Module:</STRONG></A> dexter, mpmt_pthread, prefork, mpm_winnt</p>
+><STRONG>Module:</STRONG></A> dexter, mpmt_pthread, perchild, prefork, mpm_winnt</p>
 
 The server will set the TCP buffer size to the number of bytes
 specified. Very useful to increase past standard OS defaults on high
@@ -546,6 +602,33 @@ on the load, there is usually little reason to adjust this parameter.</P>
 <P>See also <A HREF="#minsparethreads">MinSpareThreads</A> and
 <A HREF="#maxsparethreads">MaxSpareThreads</A>.<P><HR>
 
+
+<H2><A NAME="startthreads">StartThreads directive</A></H2>
+<p><A
+ HREF="directive-dict.html#Syntax"
+ REL="Help"
+><STRONG>Syntax:</STRONG></A><BR>
+<A
+ HREF="directive-dict.html#Default"
+ REL="Help"
+><STRONG>Default:</STRONG></A><BR>
+<A
+ HREF="directive-dict.html#Context"
+ REL="Help"
+><STRONG>Context:</STRONG></A> server config<BR>
+<A
+ HREF="directive-dict.html#Status"
+ REL="Help"
+><STRONG>Status:</STRONG></A> MPM<BR>
+<A
+ HREF="directive-dict.html#Module"
+ REL="Help"
+><STRONG>Module:</STRONG></A> dexter, perchild</p>
+
+<p>Number of threads each child creates.</p>
+
+<p><hr></p>
+
 <H2><A NAME="threadsperchild">ThreadsPerChild</A></H2>
 <p><A
  HREF="directive-dict.html#Syntax"
@@ -595,7 +678,7 @@ process.</p>
 <A
  HREF="directive-dict.html#Module"
  REL="Help"
-><STRONG>Module:</STRONG></A> dexter, mpmt_pthread, prefork</p>
+><STRONG>Module:</STRONG></A> dexter, mpmt_pthread, perchild, prefork</p>
 
 The User directive sets the userid as which the server will answer requests.
 In order to use this directive, the standalone server must be run initially
diff --git a/docs/manual/mod/perchild.html b/docs/manual/mod/perchild.html
new file mode 100644
index 0000000000..cabafdab90
--- /dev/null
+++ b/docs/manual/mod/perchild.html
@@ -0,0 +1,123 @@
+<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 3.2 Final//EN">
+<HTML>
+<HEAD>
+<TITLE>Apache MPM mpmt_pthread</TITLE>
+</HEAD>
+
+<!-- Background white, links blue (unvisited), navy (visited), red (active) -->
+<BODY
+ BGCOLOR="#FFFFFF"
+ TEXT="#000000"
+ LINK="#0000FF"
+ VLINK="#000080"
+ ALINK="#FF0000"
+>
+<!--#include virtual="header.html" -->
+
+<H1 ALIGN="CENTER">Multi-Processing Module perchild</H1>
+<P>
+This Multi-Processing Module allows for daemon processes serving requests
+to be assigned a variety of different userids.
+</P>
+
+<P><A
+HREF="module-dict.html#Status"
+REL="Help"
+><STRONG>Status:</STRONG></A> MPM
+<BR>
+<A
+HREF="module-dict.html#SourceFile"
+REL="Help"
+><STRONG>Source File:</STRONG></A> perchild.c
+<BR>
+<A
+HREF="module-dict.html#ModuleIdentifier"
+REL="Help"
+><STRONG>Module Identifier:</STRONG></A> mpm_perchild_module
+</P>
+
+<H2>Summary</H2>
+
+<p>Some description on how this whole thing works with a couple examples.</p>
+
+
+<H2>Directives</H2>
+<UL>
+<li><a href="#assignuserid">AssignUserID</a></li>
+<li><a href="#childperuserid">ChildPerUserID</a></li>
+<li><a href="mpm_common.html#connectionstatus">ConnectionStatus</a></li>
+<li><a href="mpm_common.html#coredumpdirectory">CoreDumpDirectory</a></li>
+<li><a href="mpm_common.html#group">Group</a></li>
+<li><a href="mpm_common.html#pidfile">PidFile</a></li>
+<li><a href="mpm_common.html#listen">Listen</a></li>
+<li><a href="mpm_common.html#listenbacklog">ListenBacklog</a></li>
+<li><a href="mpm_common.html#lockfile">LockFile</a></li>
+<li><a href="mpm_common.html#maxrequestsperchild">MaxRequestsPerChild</a></li>
+<li><a href="mpm_common.html#maxsparethreads">MaxSpareThreads</a></li>
+<li><a href="mpm_common.html#minsparethreads">MinSpareThreads</a></li>
+<li><a href="mpm_common.html#numservers">NumServers</a></li>
+<li><a href="mpm_common.html#scoreboardfile">ScoreBoardFile</a></li>
+<li><a href="mpm_common.html#sendbuffersize">SendBufferSize</a></li>
+<li><a href="mpm_common.html#startthreads">StartThreads</a></li>
+<li><a href="mpm_common.html#user">User</a></li>
+</UL>
+
+<p><hr></p>
+
+<H2><A NAME="assignuserid">AssignUserID directive</A></H2>
+<p><A
+ HREF="directive-dict.html#Syntax"
+ REL="Help"
+><STRONG>Syntax:</STRONG></A><BR>
+<A
+ HREF="directive-dict.html#Default"
+ REL="Help"
+><STRONG>Default:</STRONG></A><BR>
+<A
+ HREF="directive-dict.html#Context"
+ REL="Help"
+><STRONG>Context:</STRONG></A> server config<BR>
+<A
+ HREF="directive-dict.html#Status"
+ REL="Help"
+><STRONG>Status:</STRONG></A> MPM<BR>
+<A
+ HREF="directive-dict.html#Module"
+ REL="Help"
+><STRONG>Module:</STRONG></A> perchild</p>
+
+<p>Tie a virtual host to a specific child process.</p>
+
+<p><hr></p>
+
+<H2><A NAME="childperuserid">ChilePerUserID directive</A></H2>
+<p><A
+ HREF="directive-dict.html#Syntax"
+ REL="Help"
+><STRONG>Syntax:</STRONG></A><BR>
+<A
+ HREF="directive-dict.html#Default"
+ REL="Help"
+><STRONG>Default:</STRONG></A><BR>
+<A
+ HREF="directive-dict.html#Context"
+ REL="Help"
+><STRONG>Context:</STRONG></A> server config<BR>
+<A
+ HREF="directive-dict.html#Status"
+ REL="Help"
+><STRONG>Status:</STRONG></A> MPM<BR>
+<A
+ HREF="directive-dict.html#Module"
+ REL="Help"
+><STRONG>Module:</STRONG></A> perchild</p>
+
+<p>Specify a User and Group for a specific child process.</p>
+
+
+
+
+
+<!--#include virtual="footer.html" -->
+</BODY>
+</HTML>