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