mpm_netware.xml revision 87ffb6e33f3cbef3b9bb406cc2d27039fa336eaa
e1e8390280254f7f0580d701e583f670643d4f3fnilgun<!DOCTYPE modulesynopsis SYSTEM "/style/modulesynopsis.dtd">
e1e8390280254f7f0580d701e583f670643d4f3fnilgun<?xml-stylesheet type="text/xsl" href="/style/manual.en.xsl"?>
e1e8390280254f7f0580d701e583f670643d4f3fnilgun Copyright 2002-2004 The Apache Software Foundation
e1e8390280254f7f0580d701e583f670643d4f3fnilgun Licensed under the Apache License, Version 2.0 (the "License");
e1e8390280254f7f0580d701e583f670643d4f3fnilgun you may not use this file except in compliance with the License.
e1e8390280254f7f0580d701e583f670643d4f3fnilgun You may obtain a copy of the License at
e1e8390280254f7f0580d701e583f670643d4f3fnilgun Unless required by applicable law or agreed to in writing, software
e1e8390280254f7f0580d701e583f670643d4f3fnilgun distributed under the License is distributed on an "AS IS" BASIS,
e1e8390280254f7f0580d701e583f670643d4f3fnilgun WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
e1e8390280254f7f0580d701e583f670643d4f3fnilgun See the License for the specific language governing permissions and
e1e8390280254f7f0580d701e583f670643d4f3fnilgun limitations under the License.
e1e8390280254f7f0580d701e583f670643d4f3fnilgun<description>Multi-Processing Module implementing an exclusively threaded web
e1e8390280254f7f0580d701e583f670643d4f3fnilgun server optimized for Novell NetWare</description>
e1e8390280254f7f0580d701e583f670643d4f3fnilgun <p>This Multi-Processing Module (MPM) implements an exclusively
e1e8390280254f7f0580d701e583f670643d4f3fnilgun threaded web server that has been optimized for Novell
e1e8390280254f7f0580d701e583f670643d4f3fnilgun NetWare.</p>
e1e8390280254f7f0580d701e583f670643d4f3fnilgun <p>The main thread is responsible for launching child
e1e8390280254f7f0580d701e583f670643d4f3fnilgun worker threads which listen for connections and serve them when they
e1e8390280254f7f0580d701e583f670643d4f3fnilgun arrive. Apache always tries to maintain several <dfn>spare</dfn>
e1e8390280254f7f0580d701e583f670643d4f3fnilgun or idle worker threads, which stand ready to serve incoming
e1e8390280254f7f0580d701e583f670643d4f3fnilgun requests. In this way, clients do not need to wait for a new
e1e8390280254f7f0580d701e583f670643d4f3fnilgun child threads to be spawned before their requests can be
e1e8390280254f7f0580d701e583f670643d4f3fnilgun served.</p>
e1e8390280254f7f0580d701e583f670643d4f3fnilgun <p>The <directive module="mpm_common">StartThreads</directive>,
e1e8390280254f7f0580d701e583f670643d4f3fnilgun <directive module="mpm_common">MinSpareThreads</directive>,
e1e8390280254f7f0580d701e583f670643d4f3fnilgun <directive module="mpm_common">MaxSpareThreads</directive>, and
e1e8390280254f7f0580d701e583f670643d4f3fnilgun <directive module="mpm_netware">MaxThreads</directive>
e1e8390280254f7f0580d701e583f670643d4f3fnilgun regulate how the main thread creates worker threads to serve
e1e8390280254f7f0580d701e583f670643d4f3fnilgun requests. In general, Apache is very self-regulating, so most
e1e8390280254f7f0580d701e583f670643d4f3fnilgun sites do not need to adjust these directives from their default
e1e8390280254f7f0580d701e583f670643d4f3fnilgun values. Sites with limited memory may need to decrease <directive
e1e8390280254f7f0580d701e583f670643d4f3fnilgun module="mpm_netware">MaxThreads</directive> to keep the server from
e1e8390280254f7f0580d701e583f670643d4f3fnilgun thrashing (spawning and terminating idle threads). More information
2704de98885368683621b01c8f8f4e4b01557611takashi about tuning process creation is provided in the <a
e1e8390280254f7f0580d701e583f670643d4f3fnilgun documentation.</p>
e1e8390280254f7f0580d701e583f670643d4f3fnilgun <p><directive module="mpm_common">MaxRequestsPerChild</directive>
e1e8390280254f7f0580d701e583f670643d4f3fnilgun controls how frequently the server recycles processes by killing old
e1e8390280254f7f0580d701e583f670643d4f3fnilgun ones and launching new ones. On the NetWare OS it is highly
e1e8390280254f7f0580d701e583f670643d4f3fnilgun recommended that this directive remain set to 0. This allows worker
e1e8390280254f7f0580d701e583f670643d4f3fnilgun threads to continue servicing requests indefinitely.</p>
e1e8390280254f7f0580d701e583f670643d4f3fnilgun<seealso><a href="/bind.html">Setting which addresses and
e1e8390280254f7f0580d701e583f670643d4f3fnilgun ports Apache uses</a>
e1e8390280254f7f0580d701e583f670643d4f3fnilgun<directivesynopsis location="mpm_common"><name>Listen</name>
e1e8390280254f7f0580d701e583f670643d4f3fnilgun</directivesynopsis>
e1e8390280254f7f0580d701e583f670643d4f3fnilgun<directivesynopsis location="mpm_common"><name>ListenBacklog</name>
e1e8390280254f7f0580d701e583f670643d4f3fnilgun</directivesynopsis>
2704de98885368683621b01c8f8f4e4b01557611takashi<directivesynopsis location="mpm_common"><name>MaxMemFree</name>
e1e8390280254f7f0580d701e583f670643d4f3fnilgun</directivesynopsis>
e1e8390280254f7f0580d701e583f670643d4f3fnilgun<directivesynopsis location="mpm_common"><name>MaxRequestsPerChild</name>
e1e8390280254f7f0580d701e583f670643d4f3fnilgun</directivesynopsis>
e1e8390280254f7f0580d701e583f670643d4f3fnilgun<directivesynopsis location="mpm_common"><name>SendBufferSize</name>
e1e8390280254f7f0580d701e583f670643d4f3fnilgun</directivesynopsis>
e1e8390280254f7f0580d701e583f670643d4f3fnilgun<directivesynopsis location="mpm_common"><name>MaxSpareThreads</name>
e1e8390280254f7f0580d701e583f670643d4f3fnilgun</directivesynopsis>
e1e8390280254f7f0580d701e583f670643d4f3fnilgun<directivesynopsis location="mpm_common"><name>MinSpareThreads</name>
e1e8390280254f7f0580d701e583f670643d4f3fnilgun</directivesynopsis>
e1e8390280254f7f0580d701e583f670643d4f3fnilgun<directivesynopsis location="mpm_common"><name>StartThreads</name>
e1e8390280254f7f0580d701e583f670643d4f3fnilgun</directivesynopsis>
e1e8390280254f7f0580d701e583f670643d4f3fnilgun<directivesynopsis location="mpm_common"><name>ThreadStackSize</name>
e1e8390280254f7f0580d701e583f670643d4f3fnilgun</directivesynopsis>
e1e8390280254f7f0580d701e583f670643d4f3fnilgun<directivesynopsis>
e1e8390280254f7f0580d701e583f670643d4f3fnilgun<description>Set the maximum number of worker threads</description>
e1e8390280254f7f0580d701e583f670643d4f3fnilgun<contextlist><context>server config</context></contextlist>
e1e8390280254f7f0580d701e583f670643d4f3fnilgun <p>The <directive>MaxThreads</directive> directive sets the desired
e1e8390280254f7f0580d701e583f670643d4f3fnilgun maximum number worker threads allowable. The default value is
e1e8390280254f7f0580d701e583f670643d4f3fnilgun also the compiled in hard limit. Therefore it can only be lowered,
e1e8390280254f7f0580d701e583f670643d4f3fnilgun for example:</p>
e1e8390280254f7f0580d701e583f670643d4f3fnilgun MaxThreads 512
e1e8390280254f7f0580d701e583f670643d4f3fnilgun</directivesynopsis>
e1e8390280254f7f0580d701e583f670643d4f3fnilgun</modulesynopsis>