home *** CD-ROM | disk | FTP | other *** search
/ Chip 2004 November / CMCD1104.ISO / Software / Complet / Apache / apache_2.0.52-win32-x86-no_ssl.msi / Data.Cab / F278395_mpm_netware.xml < prev    next >
Extensible Markup Language  |  2004-04-17  |  5KB  |  118 lines
  1. <?xml version="1.0"?>
  2. <!DOCTYPE modulesynopsis SYSTEM "../style/modulesynopsis.dtd">
  3. <?xml-stylesheet type="text/xsl" href="../style/manual.en.xsl"?>
  4. <!-- $Revision: 1.5.2.5 $ -->
  5.  
  6. <!--
  7.  Copyright 2002-2004 The Apache Software Foundation
  8.  
  9.  Licensed under the Apache License, Version 2.0 (the "License");
  10.  you may not use this file except in compliance with the License.
  11.  You may obtain a copy of the License at
  12.  
  13.      http://www.apache.org/licenses/LICENSE-2.0
  14.  
  15.  Unless required by applicable law or agreed to in writing, software
  16.  distributed under the License is distributed on an "AS IS" BASIS,
  17.  WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
  18.  See the License for the specific language governing permissions and
  19.  limitations under the License.
  20. -->
  21.  
  22. <modulesynopsis metafile="mpm_netware.xml.meta">
  23. <name>mpm_netware</name>
  24. <description>Multi-Processing Module implementing an exclusively threaded web
  25.     server optimized for Novell NetWare</description>
  26. <status>MPM</status>
  27. <sourcefile>mpm_netware.c</sourcefile>
  28. <identifier>mpm_netware_module</identifier>
  29.  
  30. <summary>
  31.     <p>This Multi-Processing Module (MPM) implements an exclusively
  32.     threaded web server that has been optimized for Novell
  33.     NetWare.</p>
  34.  
  35.     <p>The main thread is responsible for launching child
  36.     worker threads which listen for connections and serve them when they
  37.     arrive. Apache always tries to maintain several <dfn>spare</dfn>
  38.     or idle worker threads, which stand ready to serve incoming
  39.     requests. In this way, clients do not need to wait for a new
  40.     child threads to be spawned before their requests can be
  41.     served.</p>
  42.  
  43.     <p>The <directive module="mpm_common">StartThreads</directive>,
  44.     <directive module="mpm_common">MinSpareThreads</directive>,
  45.     <directive module="mpm_common">MaxSpareThreads</directive>, and
  46.     <directive module="mpm_netware">MaxThreads</directive>
  47.     regulate how the main thread creates worker threads to serve
  48.     requests. In general, Apache is very self-regulating, so most
  49.     sites do not need to adjust these directives from their default
  50.     values. Sites with limited memory may need to decrease <directive
  51.     module="mpm_netware">MaxThreads</directive> to keep the server from
  52.     thrashing (spawning and terminating idle threads). More information
  53.     about tuning process creation is provided in the <a
  54.     href="../misc/perf-tuning.html">performance hints</a>
  55.     documentation.</p>
  56.  
  57.     <p><directive module="mpm_common">MaxRequestsPerChild</directive>
  58.     controls how frequently the server recycles processes by killing old
  59.     ones and launching new ones. On the NetWare OS it is highly
  60.     recommended that this directive remain set to 0. This allows worker
  61.     threads to continue servicing requests indefinitely.</p>
  62. </summary>
  63. <seealso><a href="../bind.html">Setting which addresses and
  64.     ports Apache uses</a>
  65. </seealso>
  66.  
  67. <directivesynopsis location="mpm_common"><name>Listen</name>
  68. </directivesynopsis>
  69. <directivesynopsis location="mpm_common"><name>ListenBacklog</name>
  70. </directivesynopsis>
  71. <directivesynopsis location="mpm_common"><name>MaxMemFree</name>
  72. </directivesynopsis>
  73. <directivesynopsis location="mpm_common"><name>MaxRequestsPerChild</name>
  74. </directivesynopsis>
  75. <directivesynopsis location="mpm_common"><name>SendBufferSize</name>
  76. </directivesynopsis>
  77. <directivesynopsis location="mpm_common"><name>MaxSpareThreads</name>
  78. </directivesynopsis>
  79. <directivesynopsis location="mpm_common"><name>MinSpareThreads</name>
  80. </directivesynopsis>
  81. <directivesynopsis location="mpm_common"><name>StartThreads</name>
  82. </directivesynopsis>
  83.  
  84. <directivesynopsis>
  85. <name>MaxThreads</name>
  86. <description>Set the maximum number of worker threads</description>
  87. <syntax>MaxThreads <var>number</var></syntax>
  88. <default>MaxThreads 2048</default>
  89. <contextlist><context>server config</context></contextlist>
  90.  
  91. <usage>
  92.     <p>The <directive>MaxThreads</directive> directive sets the desired
  93.     maximum number worker threads allowable. The default value is
  94.     also the compiled in hard limit. Therefore it can only be lowered,
  95.     for example:</p>
  96.  
  97.     <example>
  98.       MaxThreads 512
  99.     </example>
  100. </usage>
  101. </directivesynopsis>
  102.  
  103. <directivesynopsis>
  104. <name>ThreadStackSize</name>
  105. <description>Determine the stack size for each thread</description>
  106. <syntax>ThreadStackSize <var>number</var></syntax>
  107. <default>ThreadStackSize 65536</default>
  108. <contextlist><context>server config</context></contextlist>
  109.  
  110. <usage>
  111.     <p>This directive tells the server what stack size to use for
  112.     each of the running threads. If you ever get a stack overflow
  113.     you will need to bump this number to a higher setting.</p>
  114. </usage>
  115. </directivesynopsis>
  116.  
  117. </modulesynopsis>
  118.