You are viewing a plain text version of this content. The canonical link for it is here.
Posted to cvs@httpd.apache.org by tr...@apache.org on 2001/12/19 19:16:40 UTC
cvs commit: httpd-2.0/docs/manual/mod directives.html mpm_common.html prefork.html worker.html
trawick 01/12/19 10:16:40
Modified: docs/manual/mod directives.html mpm_common.html prefork.html
worker.html
Log:
Add some documentation on the ServerLimit and ThreadLimit
directives.
Both were added to mpm_common.html even though ThreadLimit
is used only by worker at the moment. It is expected that
ThreadLimit will be supported by WinNT and perchild MPMs
in the future.
Revision Changes Path
1.93 +4 -0 httpd-2.0/docs/manual/mod/directives.html
Index: directives.html
===================================================================
RCS file: /home/cvs/httpd-2.0/docs/manual/mod/directives.html,v
retrieving revision 1.92
retrieving revision 1.93
diff -u -r1.92 -r1.93
--- directives.html 2001/12/14 02:13:49 1.92
+++ directives.html 2001/12/19 18:16:40 1.93
@@ -589,6 +589,8 @@
<li><a href="core.html#serveralias">ServerAlias</a></li>
+ <li><a href="mpm_common.html#serverlimit">ServerLimit</a></li>
+
<li><a href="core.html#servername">ServerName</a></li>
<li><a href="core.html#serverpath">ServerPath</a></li>
@@ -643,6 +645,8 @@
<li><a
href="mpm_common.html#startthreads">StartThreads</a></li>
+
+ <li><a href="mpm_common.html#threadlimit">ThreadLimit</a></li>
<li><a
href="mpm_common.html#threadsperchild">ThreadsPerChild</a></li>
1.17 +92 -2 httpd-2.0/docs/manual/mod/mpm_common.html
Index: mpm_common.html
===================================================================
RCS file: /home/cvs/httpd-2.0/docs/manual/mod/mpm_common.html,v
retrieving revision 1.16
retrieving revision 1.17
diff -u -r1.16 -r1.17
--- mpm_common.html 2001/11/19 18:07:27 1.16
+++ mpm_common.html 2001/12/19 18:16:40 1.17
@@ -53,10 +53,14 @@
<li><a href="#sendbuffersize">SendBufferSize</a></li>
+ <li><a href="#serverlimit">ServerLimit</a></li>
+
<li><a href="#startservers">StartServers</a></li>
<li><a href="#startthreads">StartThreads</a></li>
+ <li><a href="#threadlimit">ThreadLimit</a></li>
+
<li><a href="#threadsperchild">ThreadsPerChild</a></li>
<li><a href="#user">User</a></li>
@@ -332,8 +336,11 @@
child processes that will be created to serve requests. When
the server is built without threading, no more than this number
of clients can be served simultaneously. To configure more than
- 256 clients, you must edit the <code>HARD_SERVER_LIMIT</code>
- entry in <code>mpm_default.h</code> and recompile.</p>
+ 256 clients with the prefork MPM, you must use the <a
+ href="#serverlimit">ServerLimit</a> directive. To configure
+ more than 1024 clients with the worker MPM, you must use the
+ <a href="#serverlimit">ServerLimit</a> and <a
+ href="#threadlimit">ThreadLimit</a> directives.
<p>Any connection attempts over the MaxClients limit will
normally be queued, up to a number based on the <a
@@ -554,6 +561,52 @@
transcontinental fast pipes)
<hr />
+ <h2><a id="serverlimit"
+ name="serverlimit">ServerLimit</a></h2>
+
+ <p><a href="directive-dict.html#Syntax"
+ rel="Help"><strong>Syntax:</strong></a> ServerLimit
+ <em>number</em><br />
+ <a href="directive-dict.html#Default"
+ rel="Help"><strong>Default:</strong></a> <code>ServerLimit
+ 256</code> (prefork MPM), <code>ServerLimit 16</code> (worker MPM)<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> prefork, worker</p>
+
+ <p>For the prefork MPM, this directive sets the maximum configured
+ value for <code><a href="#maxclients">MaxClients</a></code> for
+ the lifetime of the Apache process. For the worker MPM, this
+ directive in combination with <code><a href="#threadlimit">
+ ThreadLimit</a></code> sets the maximum configured value for
+ <code><a href="#maxclients">MaxClients</a></code>
+ for the lifetime of the Apache process. Any attempts to change
+ this directive during a restart will be ignored, but
+ <code>MaxClients</code> can be modified during a restart.</p>
+
+ <p>Special care must be taken when using this directive.
+ If <code>ServerLimit</code> is set to a value much higher than
+ necessary, extra, unused shared memory will be allocated.
+ If both <code>ServerLimit</code> and <code>MaxClients</code>
+ are set to values higher than the system can handle, Apache
+ may not start or the system may become unstable.</p>
+
+ <p>With the prefork MPM, use this directive only if you need to
+ set <code>MaxClients</code> higher higher than 256. Do not set
+ the value of this directive any higher than what you might want
+ to set <code>MaxClients</code> to.</p>
+
+ <p>With the worker MPM, use this directive only if your
+ <code>MaxClients</code> and <code>ThreadsPerChild</code>
+ settings require more than 16 server processes. Do not set the
+ value of this directive any higher than the number of server
+ processes required by what you may want for <code>MaxClients
+ </code> and <code>ThreadsPerChild</code>.</p>
+ <hr />
+
<h2><a id="startservers" name="startservers">StartServers
directive</a></h2>
<!--%plaintext <?INDEX {\tt StartServers} directive> -->
@@ -600,6 +653,43 @@
number of threads is dynamically controlled depending on the
load, there is usually little reason to adjust this
parameter.</p>
+ <hr />
+
+ <h2><a id="threadlimit"
+ name="threadlimit">ThreadLimit</a></h2>
+
+ <p><a href="directive-dict.html#Syntax"
+ rel="Help"><strong>Syntax:</strong></a> ThreadLimit
+ <em>number</em><br />
+ <a href="directive-dict.html#Default"
+ rel="Help"><strong>Default:</strong></a> <code>ThreadLimit
+ 64</code><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> worker</p>
+
+ <p>This directive sets the maximum configured value for
+ <code><a href="#threadsperchild">ThreadsPerChild</a></code> for
+ the lifetime of the Apache process. Any attempts to change this
+ directive during a restart will be ignored, but <code>
+ ThreadsPerChild</code> can be modified during a restart up to
+ the value of this directive.</p>
+
+ <p>Special care must be taken when using this directive.
+ If <code>ThreadLimit</code> is set to a value much higher than
+ <code>ThreadsPerChild</code>, extra unused shared memory will be
+ allocated. If both <code>ThreadLimit</code> and <code>
+ ThreadsPerChild</code> are set to values higher than the system
+ can handle, Apache may not start or the system may become
+ unstable.</p>
+
+ <p>Use this directive only if you need to set <code>
+ ThreadsPerChild</code> higher than 64. Do not set the value of
+ this directive any higher than what you might want to set <code>
+ ThreadsPerChild</code> to.</p>
<hr />
<h2><a id="threadsperchild"
1.8 +3 -0 httpd-2.0/docs/manual/mod/prefork.html
Index: prefork.html
===================================================================
RCS file: /home/cvs/httpd-2.0/docs/manual/mod/prefork.html,v
retrieving revision 1.7
retrieving revision 1.8
diff -u -r1.7 -r1.8
--- prefork.html 2001/09/22 19:36:01 1.7
+++ prefork.html 2001/12/19 18:16:40 1.8
@@ -108,6 +108,9 @@
href="mpm_common.html#sendbuffersize">SendBufferSize</a></li>
<li><a
+ href="mpm_common.html#serverlimit">ServerLimit</a></li>
+
+ <li><a
href="mpm_common.html#startservers">StartServers</a></li>
<li><a href="mpm_common.html#user">User</a></li>
1.2 +6 -0 httpd-2.0/docs/manual/mod/worker.html
Index: worker.html
===================================================================
RCS file: /home/cvs/httpd-2.0/docs/manual/mod/worker.html,v
retrieving revision 1.1
retrieving revision 1.2
diff -u -r1.1 -r1.2
--- worker.html 2001/11/19 18:15:26 1.1
+++ worker.html 2001/12/19 18:16:40 1.2
@@ -108,7 +108,13 @@
href="mpm_common.html#sendbuffersize">SendBufferSize</a></li>
<li><a
+ href="mpm_common.html#serverlimit">ServerLimit</a></li>
+
+ <li><a
href="mpm_common.html#startservers">StartServers</a></li>
+
+ <li><a
+ href="mpm_common.html#threadlimit">ThreadLimit</a></li>
<li><a
href="mpm_common.html#threadsperchild">ThreadsPerChild</a></li>