dexter.html revision f73f1be6f87a6cdee2dbe06ac4381676d160df4c
394N/A<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 3.2 Final//EN">
394N/A<HTML>
394N/A<HEAD>
394N/A<TITLE>Apache MPM dexter</TITLE>
394N/A</HEAD>
394N/A
394N/A<!-- Background white, links blue (unvisited), navy (visited), red (active) -->
394N/A<BODY
394N/A BGCOLOR="#FFFFFF"
394N/A TEXT="#000000"
394N/A LINK="#0000FF"
394N/A VLINK="#000080"
394N/A ALINK="#FF0000"
394N/A>
394N/A<!--#include virtual="header.html" -->
394N/A
394N/A<H1 ALIGN="CENTER">Multi-Processing Module dexter</H1>
394N/A<P>
394N/AThis Multi-Processing Module implements a hybrid multi-process
394N/Amulti-threaded web server with a variable number of threads per
3996N/Aprocess.
394N/A</P>
394N/A
394N/A<P><A
394N/AHREF="module-dict.html#Status"
394N/AREL="Help"
394N/A><STRONG>Status:</STRONG></A> MPM
394N/A<BR>
394N/A<A
394N/AHREF="module-dict.html#SourceFile"
844N/AREL="Help"
844N/A><STRONG>Source File:</STRONG></A> dexter.c
394N/A<BR>
394N/A<A
1273N/AHREF="module-dict.html#ModuleIdentifier"
394N/AREL="Help"
3661N/A><STRONG>Module Identifier:</STRONG></A> mpm_dexter_module
3661N/A</P>
3778N/A
3778N/A<H2>Summary</H2>
3778N/A
3996N/A<p>This Multi-Processing Module (MPM) implements a hybrid
3996N/Amulti-process, multi-threaded web server. A fixed number of processes
3996N/Acreate threads to handle requests. Fluctuations in load are handled
394N/Aby increasing or decreasing the number of threads in each process.</p>
394N/A
1874N/A<p>A single control process launches the number of child processes
394N/Aindicated by the <code>NumServers</code> directive at server startup.
1874N/AEach child process creates threads as specified in the
394N/A<code>StartThreads</code> directive. The individual threads then
394N/Alisten for connections and serve them when they arrive.</p>
394N/A
394N/A<p>Apache always tries to maintain a pool of <em>spare</em> or idle
server threads, which stand ready to serve incoming requests. In this
way, clients do not need to wait for new threads to be created. For
each child process, Apache assesses the number of idle threads and
creates or destroys threads to keep this number within the boundaries
specified by <code>MinSpareThreads</code> and
<code>MaxSpareThreads</code>. Since this process is very
self-regulating, it is rarely necessary to modify these directives
from their default values. The maximum number of clients that may be
served simultaneously is determined by multiplying the number
of server processes that will be created (<code>NumServers</code>) by
the maximum number of threads created in each process
(<code>MaxThreadsPerChild</code>).</p>
<p>While the parent process is usually started as root under Unix in
order to bind to port 80, the child processes and threads are launched
by Apache as a less-privileged user. The <code>User</code> and
<code>Group</code> directives are used to set the privileges of the
Apache child processes. The child processes must be able to read all
the content that will be served, but should have as few privileges
beyond that as possible. In addition, unless <a
href="/suexec.html">suexec</a> is used, these directives also set
the privileges which will be inherited by CGI scripts.</p>
<p><code>MaxRequestsPerChild</code> controls how frequently the server
recycles processes by killing old ones and launching new ones.</p>
<p>See also: <a href="/bind.html">Setting which addresses and ports
Apache uses</a>.</p>
<H2>Directives</H2>
<UL>
<li><a href="mpm_common.html#connectionstatus">ConnectionStatus</a></li>
<li><a href="mpm_common.html#coredumpdirectory">CoreDumpDirectory</a></li>
<li><a href="mpm_common.html#group">Group</a></li>
<li><a href="mpm_common.html#pidfile">PidFile</a></li>
<li><a href="mpm_common.html#listen">Listen</a></li>
<li><a href="mpm_common.html#listenbacklog">ListenBacklog</a></li>
<li><a href="mpm_common.html#lockfile">LockFile</a></li>
<li><a href="mpm_common.html#maxrequestsperchild">MaxRequestsPerChild</a></li>
<li><a href="mpm_common.html#maxsparethreads">MaxSpareThreads</a></li>
<li><a href="mpm_common.html#maxthreadsperchild">MaxThreadsPerChild</a></li>
<li><a href="mpm_common.html#minsparethreads">MinSpareThreads</a></li>
<li><a href="mpm_common.html#numservers">NumServers</a></li>
<li><a href="mpm_common.html#scoreboardfile">ScoreBoardFile</a></li>
<li><a href="mpm_common.html#sendbuffersize">SendBufferSize</a></li>
<li><a href="mpm_common.html#startthreads">StartThreads</a></li>
<li><a href="mpm_common.html#user">User</a></li>
</UL>
<!--#include virtual="footer.html" -->
</BODY>
</HTML>