granicus.if.org Git - apache/blob - docs/manual/mod/mpm_netware.xml

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