From: Jeff Trawick Date: Mon, 15 Mar 2004 23:24:40 +0000 (+0000) Subject: Change "new" WorkerStackSize directive to ThreadStackSize X-Git-Tag: pre_ajp_proxy~520 X-Git-Url: https://granicus.if.org/sourcecode?a=commitdiff_plain;h=854d853e537404640f84680fbd41d5076a294dd3;p=apache Change "new" WorkerStackSize directive to ThreadStackSize Move existing Netware docs and links on ThreadStackSize to mpm_common git-svn-id: https://svn.apache.org/repos/asf/httpd/httpd/trunk@102976 13f79535-47bb-0310-9956-ffa450edef68 --- diff --git a/docs/manual/mod/directives.html.en b/docs/manual/mod/directives.html.en index 44f2d513e2..4b8849c61f 100644 --- a/docs/manual/mod/directives.html.en +++ b/docs/manual/mod/directives.html.en @@ -377,7 +377,7 @@
  • SuexecUserGroup
  • ThreadLimit
  • ThreadsPerChild
    • -
  • ThreadStackSize
    • +
  • ThreadStackSize
  • TimeOut
  • TransferLog
  • TypesConfig
    • @@ -391,7 +391,6 @@
  • VirtualScriptAlias
  • VirtualScriptAliasIP
  • Win32DisableAcceptEx
    • -
  • WorkerStackSize
  • XBitHack
    • diff --git a/docs/manual/mod/directives.html.ko.euc-kr b/docs/manual/mod/directives.html.ko.euc-kr index 6e9aad4aba..6e783acef5 100644 --- a/docs/manual/mod/directives.html.ko.euc-kr +++ b/docs/manual/mod/directives.html.ko.euc-kr @@ -373,7 +373,7 @@
  • SuexecUserGroup
  • ThreadLimit
  • ThreadsPerChild
    • -
  • ThreadStackSize
    • +
  • ThreadStackSize
  • TimeOut
  • TransferLog
  • TypesConfig
    • @@ -387,7 +387,6 @@
  • VirtualScriptAlias
  • VirtualScriptAliasIP
  • Win32DisableAcceptEx
    • -
  • WorkerStackSize
  • XBitHack
    • diff --git a/docs/manual/mod/leader.html.en b/docs/manual/mod/leader.html.en index 6eb37b3c5d..c3f82f2f96 100644 --- a/docs/manual/mod/leader.html.en +++ b/docs/manual/mod/leader.html.en @@ -74,8 +74,8 @@ MPM
  • StartServers
  • ThreadLimit
  • ThreadsPerChild
    • +
  • ThreadStackSize
  • User
    • -
  • WorkerStackSize
    • diff --git a/docs/manual/mod/leader.xml b/docs/manual/mod/leader.xml index ac7ed17557..38d08a27b3 100644 --- a/docs/manual/mod/leader.xml +++ b/docs/manual/mod/leader.xml @@ -89,9 +89,9 @@ MPM ThreadsPerChild -User +ThreadStackSize -WorkerStackSize +User diff --git a/docs/manual/mod/mpm_common.html.en b/docs/manual/mod/mpm_common.html.en index ef57259257..6b4b06fcd2 100644 --- a/docs/manual/mod/mpm_common.html.en +++ b/docs/manual/mod/mpm_common.html.en @@ -51,8 +51,8 @@ more than one multi-processing module (MPM)
  • StartThreads
  • ThreadLimit
  • ThreadsPerChild
    • +
  • ThreadStackSize
  • User
    • -
  • WorkerStackSize
    • @@ -789,6 +789,50 @@ and later 64 when used with mpm_winnt and 25 when used with the others.

    + +
    top
    +

    ThreadStackSize Directive

    + + + + + + + + +
    Description:The size in bytes of the stack used by threads handling +client connections
    Syntax:ThreadStackSize size
    Default:65536 on NetWare; varies on other operating systems
    Context:server config
    Status:MPM
    Module:leader, mpm_netware, mpm_winnt, perchild, threadpool, worker
    Compatibility:Available in Apache 2.1 and later
    +

    The ThreadStackSize directive sets the + size of the stack (for autodata) of threads which handle client + connections and call modules to help process those connections. + In most cases the operating system default for stack size is + reasonable, but there are some conditions where it may need to be + adjusted:

    + +
      +
    • On platforms with a relatively small default thread stack size + (e.g., HP-UX), Apache may crash when using some third-party modules + which use a relatively large amount of autodata storage. Those + same modules may have worked fine on other platforms where the + default thread stack size is larger. This type of crash is + resolved by setting ThreadStackSize to a + value higher than the operating system default. This type of + adjustment is necessary only if the provider of the third-party + module specifies that it is required, or if diagnosis of an Apache + crash indicates that the thread stack size was too small.
      • + +
    • On platforms where the default thread stack size is + significantly larger than necessary for the web server + configuration, a higher number of threads per child process + will be achievable if ThreadStackSize is + set to a value lower than the operating system default. This type + of adjustment should only be made in a test environment which allows + the full set of web server processing can be exercised, as there + may be infrequent requests which require more stack to process. + A change in the web server configuration can invalidate the + current ThreadStackSize setting.
      • +
    +
    top

    User Directive

    @@ -851,50 +895,6 @@ requests reasons.

    - -
    top
    -

    WorkerStackSize Directive

    - - - - - - - - -
    Description:The size in bytes of the stack used by threads handling -client connections
    Syntax:WorkerStackSize size
    Default:varies by operating system
    Context:server config
    Status:MPM
    Module:leader, mpm_winnt, perchild, threadpool, worker
    Compatibility:Available in Apache 2.1 and later
    -

    The WorkerStackSize directive sets the - size of the stack (for autodata) of threads which handle client - connections and call modules to help process those connections. - In most cases the operating system default for stack size is - reasonable, but there are some conditions where it may need to be - adjusted:

    - -
      -
    • On platforms with a relatively small default thread stack size - (e.g., HP-UX), Apache may crash when using some third-party modules - which use a relatively large amount of autodata storage. Those - same modules may have worked fine on other platforms where the - default thread stack size is larger. This type of crash is - resolved by setting WorkerStackSize to a - value higher than the operating system default. This type of - adjustment is necessary only if the provider of the third-party - module specifies that it is required, or if diagnosis of an Apache - crash indicates that the thread stack size was too small.
      • - -
    • On platforms where the default thread stack size is - significantly larger than necessary for the web server - configuration, a higher number of threads per child process - will be achievable if WorkerStackSize is - set to a value lower than the operating system default. This type - of adjustment should only be made in a test environment which allows - the full set of web server processing can be exercised, as there - may be infrequent requests which require more stack to process. - A change in the web server configuration can invalidate the - current WorkerStackSize setting.
      • -
    -
    diff --git a/docs/manual/mod/mpm_common.xml b/docs/manual/mod/mpm_common.xml index 300007c3fd..aa8a6bec2c 100644 --- a/docs/manual/mod/mpm_common.xml +++ b/docs/manual/mod/mpm_common.xml @@ -825,6 +825,53 @@ and later + +ThreadStackSize +The size in bytes of the stack used by threads handling +client connections +ThreadStackSize size +65536 on NetWare; varies on other operating systems +server config +leadermpm_netware +mpm_winntperchild +threadpoolworker + +Available in Apache 2.1 and later + + +

    The ThreadStackSize directive sets the + size of the stack (for autodata) of threads which handle client + connections and call modules to help process those connections. + In most cases the operating system default for stack size is + reasonable, but there are some conditions where it may need to be + adjusted:

    + +
      +
    • On platforms with a relatively small default thread stack size + (e.g., HP-UX), Apache may crash when using some third-party modules + which use a relatively large amount of autodata storage. Those + same modules may have worked fine on other platforms where the + default thread stack size is larger. This type of crash is + resolved by setting ThreadStackSize to a + value higher than the operating system default. This type of + adjustment is necessary only if the provider of the third-party + module specifies that it is required, or if diagnosis of an Apache + crash indicates that the thread stack size was too small.
      • + +
    • On platforms where the default thread stack size is + significantly larger than necessary for the web server + configuration, a higher number of threads per child process + will be achievable if ThreadStackSize is + set to a value lower than the operating system default. This type + of adjustment should only be made in a test environment which allows + the full set of web server processing can be exercised, as there + may be infrequent requests which require more stack to process. + A change in the web server configuration can invalidate the + current ThreadStackSize setting.
      • +
    +     +     + User The userid under which the server will answer @@ -892,51 +939,4 @@ requests - -WorkerStackSize -The size in bytes of the stack used by threads handling -client connections -WorkerStackSize size -varies by operating system -server config -leadermpm_winnt -perchildthreadpool -worker - -Available in Apache 2.1 and later - - -

    The WorkerStackSize directive sets the - size of the stack (for autodata) of threads which handle client - connections and call modules to help process those connections. - In most cases the operating system default for stack size is - reasonable, but there are some conditions where it may need to be - adjusted:

    - -
      -
    • On platforms with a relatively small default thread stack size - (e.g., HP-UX), Apache may crash when using some third-party modules - which use a relatively large amount of autodata storage. Those - same modules may have worked fine on other platforms where the - default thread stack size is larger. This type of crash is - resolved by setting WorkerStackSize to a - value higher than the operating system default. This type of - adjustment is necessary only if the provider of the third-party - module specifies that it is required, or if diagnosis of an Apache - crash indicates that the thread stack size was too small.
      • - -
    • On platforms where the default thread stack size is - significantly larger than necessary for the web server - configuration, a higher number of threads per child process - will be achievable if WorkerStackSize is - set to a value lower than the operating system default. This type - of adjustment should only be made in a test environment which allows - the full set of web server processing can be exercised, as there - may be infrequent requests which require more stack to process. - A change in the web server configuration can invalidate the - current WorkerStackSize setting.
      • -
    -     -     - diff --git a/docs/manual/mod/mpm_netware.html.en b/docs/manual/mod/mpm_netware.html.en index a5e48bf8a7..0f869c077f 100644 --- a/docs/manual/mod/mpm_netware.html.en +++ b/docs/manual/mod/mpm_netware.html.en @@ -71,7 +71,7 @@
  • MinSpareThreads
  • SendBufferSize
  • StartThreads
    • -
  • ThreadStackSize
    • +
  • ThreadStackSize

    • See also

      @@ -99,21 +99,6 @@ MaxThreads 512

    - -
    top
    -

    ThreadStackSize Directive

    - - - - - - - -
    Description:Determine the stack size for each thread
    Syntax:ThreadStackSize number
    Default:ThreadStackSize 65536
    Context:server config
    Status:MPM
    Module:mpm_netware
    -

    This directive tells the server what stack size to use for - each of the running threads. If you ever get a stack overflow - you will need to bump this number to a higher setting.

    -
    diff --git a/docs/manual/mod/mpm_netware.xml b/docs/manual/mod/mpm_netware.xml index da435a5b74..8c1964a6d9 100644 --- a/docs/manual/mod/mpm_netware.xml +++ b/docs/manual/mod/mpm_netware.xml @@ -79,6 +79,8 @@ StartThreads +ThreadStackSize + MaxThreads @@ -99,18 +101,4 @@ - -ThreadStackSize -Determine the stack size for each thread -ThreadStackSize number -ThreadStackSize 65536 -server config - - -

    This directive tells the server what stack size to use for - each of the running threads. If you ever get a stack overflow - you will need to bump this number to a higher setting.

    -     -     - diff --git a/docs/manual/mod/mpm_winnt.html.en b/docs/manual/mod/mpm_winnt.html.en index 37af18f43f..65537728db 100644 --- a/docs/manual/mod/mpm_winnt.html.en +++ b/docs/manual/mod/mpm_winnt.html.en @@ -49,8 +49,8 @@ NT.
  • SendBufferSize
  • ThreadLimit
  • ThreadsPerChild
    • +
  • ThreadStackSize
  • Win32DisableAcceptEx
    • -
  • WorkerStackSize
    • diff --git a/docs/manual/mod/mpm_winnt.xml b/docs/manual/mod/mpm_winnt.xml index ae2d996f6b..6c63c76a01 100644 --- a/docs/manual/mod/mpm_winnt.xml +++ b/docs/manual/mod/mpm_winnt.xml @@ -54,7 +54,7 @@ NT.     ThreadsPerChild -WorkerStackSize +ThreadStackSize diff --git a/docs/manual/mod/perchild.html.en b/docs/manual/mod/perchild.html.en index 66725fabf3..61e6335fc4 100644 --- a/docs/manual/mod/perchild.html.en +++ b/docs/manual/mod/perchild.html.en @@ -63,8 +63,8 @@ requests to be assigned a variety of different userids
  • ServerLimit
  • StartThreads
  • ThreadLimit
    • +
  • ThreadStackSize
  • User
    • -
  • WorkerStackSize

    • Topics

      diff --git a/docs/manual/mod/perchild.xml b/docs/manual/mod/perchild.xml index aa30c2b77c..e882bd31b4 100644 --- a/docs/manual/mod/perchild.xml +++ b/docs/manual/mod/perchild.xml @@ -172,9 +172,9 @@ uses ThreadLimit -User +ThreadStackSize -WorkerStackSize +User diff --git a/docs/manual/mod/quickreference.html.en b/docs/manual/mod/quickreference.html.en index 5eb9f188cc..b0d9df9d6b 100644 --- a/docs/manual/mod/quickreference.html.en +++ b/docs/manual/mod/quickreference.html.en @@ -672,7 +672,8 @@ Certificate verification ThreadLimit numbersMSets the upper limit on the configurable number of threads per child process ThreadsPerChild numbersMNumber of threads created by each child process -ThreadStackSize number 65536 sMDetermine the stack size for each thread +ThreadStackSize sizesMThe size in bytes of the stack used by threads handling +client connections TimeOut seconds 300 sCAmount of time the server will wait for certain events before failing a request TransferLog file|pipesvBSpecify location of a log file @@ -697,9 +698,7 @@ a given virtual host VirtualScriptAliasIP interpolated-directory|none none svEDynamically configure the location of the cgi directory for a given virtual host Win32DisableAcceptExsMUse accept() rather than AcceptEx() to accept network connections -WorkerStackSize sizesMThe size in bytes of the stack used by threads handling -client connections -XBitHack on|off|full off svdhBParse SSI directives in files with the execute bit +XBitHack on|off|full off svdhBParse SSI directives in files with the execute bit set
      diff --git a/docs/manual/mod/threadpool.html.en b/docs/manual/mod/threadpool.html.en index c24e6d91b7..26ed0631c3 100644 --- a/docs/manual/mod/threadpool.html.en +++ b/docs/manual/mod/threadpool.html.en @@ -67,8 +67,8 @@
    • StartServers
    • ThreadLimit
    • ThreadsPerChild
      • +
    • ThreadStackSize
    • User
      • -
    • WorkerStackSize
    diff --git a/docs/manual/mod/threadpool.xml b/docs/manual/mod/threadpool.xml index 6c22abcc0e..faf2c72c1b 100644 --- a/docs/manual/mod/threadpool.xml +++ b/docs/manual/mod/threadpool.xml @@ -84,9 +84,9 @@     ThreadsPerChild -User +ThreadStackSize -WorkerStackSize +User diff --git a/docs/manual/mod/worker.html.en b/docs/manual/mod/worker.html.en index a6a9db1e11..6cc814349b 100644 --- a/docs/manual/mod/worker.html.en +++ b/docs/manual/mod/worker.html.en @@ -67,8 +67,8 @@
  • StartServers
  • ThreadLimit
  • ThreadsPerChild
    • +
  • ThreadStackSize
  • User
    • -
  • WorkerStackSize

    • Topics

      diff --git a/docs/manual/mod/worker.xml b/docs/manual/mod/worker.xml index 28deb4a353..f0be287656 100644 --- a/docs/manual/mod/worker.xml +++ b/docs/manual/mod/worker.xml @@ -175,9 +175,9 @@ uses ThreadsPerChild -User +ThreadStackSize -WorkerStackSize +User diff --git a/docs/manual/platform/netware.html.en b/docs/manual/platform/netware.html.en index fc21c6d2ab..782607e8b1 100644 --- a/docs/manual/platform/netware.html.en +++ b/docs/manual/platform/netware.html.en @@ -362,7 +362,7 @@ This directive limits the total number of work threads to a maximum value. The recommended default is ThreadsPerChild 250.

      -

      ThreadStackSize - +

      ThreadStackSize - This directive tells the server what size of stack to use for the individual worker thread. The recommended default is ThreadStackSize 65536.

      diff --git a/docs/manual/platform/netware.xml b/docs/manual/platform/netware.xml index df685bc52b..9e5308575d 100644 --- a/docs/manual/platform/netware.xml +++ b/docs/manual/platform/netware.xml @@ -361,7 +361,7 @@ This directive limits the total number of work threads to a maximum value. The recommended default is ThreadsPerChild 250.

      -

      ThreadStackSize - +

      ThreadStackSize - This directive tells the server what size of stack to use for the individual worker thread. The recommended default is ThreadStackSize 65536.

      diff --git a/docs/manual/server-wide.html.en b/docs/manual/server-wide.html.en index 05b3d6da8e..c023a72ab1 100644 --- a/docs/manual/server-wide.html.en +++ b/docs/manual/server-wide.html.en @@ -72,7 +72,7 @@ the basic operations of the server.

      Limiting Resource Usage

      -
      Related ModulesRelated Directives
      +
      Related ModulesRelated Directives

      The LimitRequest* directives are used to place limits on the amount of resources @@ -86,8 +86,8 @@ the basic operations of the server.

      this will control resources used by CGI scripts and SSI exec commands.

      -

      The ThreadStackSize directive - is used only on Netware to control the stack size.

      +

      The ThreadStackSize + directive is used with some platforms to control the stack size.

      Available Languages:  en  | diff --git a/docs/manual/server-wide.xml b/docs/manual/server-wide.xml index 50c03272a1..6d5c876691 100644 --- a/docs/manual/server-wide.xml +++ b/docs/manual/server-wide.xml @@ -94,7 +94,7 @@ the basic operations of the server.

      RLimitCPU RLimitMEM RLimitNPROC - ThreadStackSize + ThreadStackSize @@ -110,7 +110,7 @@ the basic operations of the server.

      this will control resources used by CGI scripts and SSI exec commands.

      -

      The ThreadStackSize directive - is used only on Netware to control the stack size.

      +

      The ThreadStackSize + directive is used with some platforms to control the stack size.