diff options
author | Jeff Trawick <trawick@apache.org> | 2004-03-15 23:24:40 +0000 |
---|---|---|
committer | Jeff Trawick <trawick@apache.org> | 2004-03-15 23:24:40 +0000 |
commit | 854d853e537404640f84680fbd41d5076a294dd3 (patch) | |
tree | 937395b5fb0ec872fea0f2d3aafca23419b11973 /docs/manual/mod/mpm_common.html.en | |
parent | c940ea5b58bb5007cba67c4f912d5f74f5ffc605 (diff) | |
download | httpd-854d853e537404640f84680fbd41d5076a294dd3.tar.gz |
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
Diffstat (limited to 'docs/manual/mod/mpm_common.html.en')
-rw-r--r-- | docs/manual/mod/mpm_common.html.en | 90 |
1 files changed, 45 insertions, 45 deletions
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)</td></tr> <li><img alt="" src="../images/down.gif" /> <a href="#startthreads">StartThreads</a></li> <li><img alt="" src="../images/down.gif" /> <a href="#threadlimit">ThreadLimit</a></li> <li><img alt="" src="../images/down.gif" /> <a href="#threadsperchild">ThreadsPerChild</a></li> +<li><img alt="" src="../images/down.gif" /> <a href="#threadstacksize">ThreadStackSize</a></li> <li><img alt="" src="../images/down.gif" /> <a href="#user">User</a></li> -<li><img alt="" src="../images/down.gif" /> <a href="#workerstacksize">WorkerStackSize</a></li> </ul> </div> @@ -791,6 +791,50 @@ and later</td></tr> </div> <div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div> +<div class="directive-section"><h2><a name="ThreadStackSize" id="ThreadStackSize">ThreadStackSize</a> <a name="threadstacksize" id="threadstacksize">Directive</a></h2> +<table class="directive"> +<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>The size in bytes of the stack used by threads handling +client connections</td></tr> +<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>ThreadStackSize <var>size</var></code></td></tr> +<tr><th><a href="directive-dict.html#Default">Default:</a></th><td><code>65536 on NetWare; varies on other operating systems</code></td></tr> +<tr><th><a href="directive-dict.html#Context">Context:</a></th><td>server config</td></tr> +<tr><th><a href="directive-dict.html#Status">Status:</a></th><td>MPM</td></tr> +<tr><th><a href="directive-dict.html#Module">Module:</a></th><td><code class="module"><a href="../mod/leader.html">leader</a></code>, <code class="module"><a href="../mod/mpm_netware.html">mpm_netware</a></code>, <code class="module"><a href="../mod/mpm_winnt.html">mpm_winnt</a></code>, <code class="module"><a href="../mod/perchild.html">perchild</a></code>, <code class="module"><a href="../mod/threadpool.html">threadpool</a></code>, <code class="module"><a href="../mod/worker.html">worker</a></code></td></tr> +<tr><th><a href="directive-dict.html#Compatibility">Compatibility:</a></th><td>Available in Apache 2.1 and later</td></tr> +</table> + <p>The <code class="directive">ThreadStackSize</code> 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:</p> + + <ul> + <li>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 <code class="directive">ThreadStackSize</code> 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.</li> + + <li>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 <code class="directive">ThreadStackSize</code> 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 <code class="directive">ThreadStackSize</code> setting.</li> + </ul> + +</div> +<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div> <div class="directive-section"><h2><a name="User" id="User">User</a> <a name="user" id="user">Directive</a></h2> <table class="directive"> <tr><th><a href="directive-dict.html#Description">Description:</a></th><td>The userid under which the server will answer @@ -852,50 +896,6 @@ requests</td></tr> </div> </div> -<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div> -<div class="directive-section"><h2><a name="WorkerStackSize" id="WorkerStackSize">WorkerStackSize</a> <a name="workerstacksize" id="workerstacksize">Directive</a></h2> -<table class="directive"> -<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>The size in bytes of the stack used by threads handling -client connections</td></tr> -<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>WorkerStackSize <var>size</var></code></td></tr> -<tr><th><a href="directive-dict.html#Default">Default:</a></th><td><code>varies by operating system</code></td></tr> -<tr><th><a href="directive-dict.html#Context">Context:</a></th><td>server config</td></tr> -<tr><th><a href="directive-dict.html#Status">Status:</a></th><td>MPM</td></tr> -<tr><th><a href="directive-dict.html#Module">Module:</a></th><td><code class="module"><a href="../mod/leader.html">leader</a></code>, <code class="module"><a href="../mod/mpm_winnt.html">mpm_winnt</a></code>, <code class="module"><a href="../mod/perchild.html">perchild</a></code>, <code class="module"><a href="../mod/threadpool.html">threadpool</a></code>, <code class="module"><a href="../mod/worker.html">worker</a></code></td></tr> -<tr><th><a href="directive-dict.html#Compatibility">Compatibility:</a></th><td>Available in Apache 2.1 and later</td></tr> -</table> - <p>The <code class="directive">WorkerStackSize</code> 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:</p> - - <ul> - <li>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 <code class="directive">WorkerStackSize</code> 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.</li> - - <li>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 <code class="directive">WorkerStackSize</code> 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 <code class="directive">WorkerStackSize</code> setting.</li> - </ul> - -</div> </div> <div class="bottomlang"> <p><span>Available Languages: </span><a href="../de/mod/mpm_common.html" hreflang="de" rel="alternate" title="Deutsch"> de </a> | |