From: Jeff Trawick Date: Wed, 19 Dec 2001 18:16:40 +0000 (+0000) Subject: Add some documentation on the ServerLimit and ThreadLimit X-Git-Url: https://granicus.if.org/sourcecode?a=commitdiff_plain;h=b8e0d1b52a63af6a9723a07d68867d9bd68c12af;p=apache 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. git-svn-id: https://svn.apache.org/repos/asf/httpd/httpd/trunk@92536 13f79535-47bb-0310-9956-ffa450edef68 --- diff --git a/docs/manual/mod/directives.html b/docs/manual/mod/directives.html index 47ab314752..58929b8f68 100644 --- a/docs/manual/mod/directives.html +++ b/docs/manual/mod/directives.html @@ -589,6 +589,8 @@
  • ServerAlias
    • +
  • ServerLimit
    • +
  • ServerName
  • ServerPath
    • @@ -644,6 +646,8 @@
  • StartThreads
    • +
  • ThreadLimit
    • +
  • ThreadsPerChild
    • diff --git a/docs/manual/mod/mpm_common.html b/docs/manual/mod/mpm_common.html index 6f53267250..bd3f076b85 100644 --- a/docs/manual/mod/mpm_common.html +++ b/docs/manual/mod/mpm_common.html @@ -53,10 +53,14 @@
  • SendBufferSize
    • +
  • ServerLimit
    • +
  • StartServers
  • StartThreads
    • +
  • ThreadLimit
    • +
  • ThreadsPerChild
  • User
    • @@ -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 HARD_SERVER_LIMIT - entry in mpm_default.h and recompile.

    + 256 clients with the prefork MPM, you must use the ServerLimit directive. To configure + more than 1024 clients with the worker MPM, you must use the + ServerLimit and ThreadLimit directives.

    Any connection attempts over the MaxClients limit will normally be queued, up to a number based on the +

    ServerLimit

    + +

    Syntax: ServerLimit + number
    + Default: ServerLimit + 256 (prefork MPM), ServerLimit 16 (worker MPM)
    + Context: server config
    + Status: MPM
    + Module: prefork, worker

    + +

    For the prefork MPM, this directive sets the maximum configured + value for MaxClients for + the lifetime of the Apache process. For the worker MPM, this + directive in combination with + ThreadLimit sets the maximum configured value for + MaxClients + for the lifetime of the Apache process. Any attempts to change + this directive during a restart will be ignored, but + MaxClients can be modified during a restart.

    + +

    Special care must be taken when using this directive. + If ServerLimit is set to a value much higher than + necessary, extra, unused shared memory will be allocated. + If both ServerLimit and MaxClients + are set to values higher than the system can handle, Apache + may not start or the system may become unstable.

    + +

    With the prefork MPM, use this directive only if you need to + set MaxClients higher higher than 256. Do not set + the value of this directive any higher than what you might want + to set MaxClients to.

    + +

    With the worker MPM, use this directive only if your + MaxClients and ThreadsPerChild + 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 MaxClients + and ThreadsPerChild.

    +
    +

    StartServers directive

    @@ -602,6 +655,43 @@ parameter.

    +

    ThreadLimit

    + +

    Syntax: ThreadLimit + number
    + Default: ThreadLimit + 64
    + Context: server config
    + Status: MPM
    + Module: worker

    + +

    This directive sets the maximum configured value for + ThreadsPerChild for + the lifetime of the Apache process. Any attempts to change this + directive during a restart will be ignored, but + ThreadsPerChild can be modified during a restart up to + the value of this directive.

    + +

    Special care must be taken when using this directive. + If ThreadLimit is set to a value much higher than + ThreadsPerChild, extra unused shared memory will be + allocated. If both ThreadLimit and + ThreadsPerChild are set to values higher than the system + can handle, Apache may not start or the system may become + unstable.

    + +

    Use this directive only if you need to set + ThreadsPerChild higher than 64. Do not set the value of + this directive any higher than what you might want to set + ThreadsPerChild to.

    +
    +

    ThreadsPerChild

    diff --git a/docs/manual/mod/prefork.html b/docs/manual/mod/prefork.html index 05b25c84d8..016e0dee36 100644 --- a/docs/manual/mod/prefork.html +++ b/docs/manual/mod/prefork.html @@ -107,6 +107,9 @@
  • SendBufferSize
    • +
  • ServerLimit
    • +
  • StartServers
    • diff --git a/docs/manual/mod/worker.html b/docs/manual/mod/worker.html index 48e4d6642c..40ee8348ef 100644 --- a/docs/manual/mod/worker.html +++ b/docs/manual/mod/worker.html @@ -107,9 +107,15 @@
  • SendBufferSize
    • +
  • ServerLimit
    • +
  • StartServers
    • +
  • ThreadLimit
    • +
  • ThreadsPerChild