worker.html revision 52f786c4400efff1823bbdb062b80718079fc9e4
0N/A<html xmlns="http://www.w3.org/TR/xhtml1/strict"><head><!--
2362N/AXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
0N/A This file is generated from xml source: DO NOT EDIT
0N/AXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
0N/A--><title>worker - Apache HTTP Server</title><link href="/style/manual.css" type="text/css" rel="stylesheet"/></head><body><blockquote><div align="center"><img alt="[APACHE DOCUMENTATION]" src="/images/sub.gif"/><h3>Apache HTTP Server Version 2.0</h3></div><h1 align="center">Apache Module worker</h1><table cellspacing="1" cellpadding="0" bgcolor="#cccccc"><tr><td><table bgcolor="#ffffff"><tr><td valign="top"><span class="help">Description:</span></td><td>Multi-Processing Module implementing a hybrid
0N/A multi-threaded multi-process web server</td></tr><tr><td><a href="module-dict.html#Status" class="help">Status:</a></td><td>MPM</td></tr><tr><td><a href="module-dict.html#ModuleIdentifier" class="help">Module&nbsp;Identifier:</a></td><td>mpm_worker_module</td></tr></table></td></tr></table><h2>Summary</h2>
2362N/A <p>This Multi-Processing Module (MPM) implements a hybrid
0N/A multi-process multi-threaded server. Each process has a fixed
2362N/A number of threads. The server adjusts to handle load by
0N/A increasing or decreasing the number of processes.</p>
0N/A
0N/A <p>A single control process is responsible for launching child
0N/A processes. Each child process creates a fixed number of threads
0N/A as specified in the <code>ThreadsPerChild</code> directive. The
0N/A individual threads then listen for connections and serve them
0N/A when they arrive.</p>
0N/A
0N/A <p>Apache always tries to maintain a pool of <em>spare</em> or
0N/A idle server threads, which stand ready to serve incoming
0N/A requests. In this way, clients do not need to wait for a new
2362N/A threads or processes to be created before their requests can be
2362N/A served. Apache assesses the total number of idle threads in all
2362N/A processes, and forks or kills processes to keep this number
0N/A within the boundaries specified by <code>MinSpareThreads</code>
0N/A and <code>MaxSpareThreads</code>. Since this process is very
0N/A self-regulating, it is rarely necessary to modify these
0N/A directives from their default values. The maximum number of
0N/A clients that may be served simultaneously is determined by
0N/A multiplying the maximum number of server processes that will be
0N/A created (<code>MaxClients</code>) by the number of threads
0N/A created in each process (<code>ThreadsPerChild</code>).</p>
0N/A
0N/A <p>While the parent process is usually started as root under
0N/A Unix in order to bind to port 80, the child processes and
0N/A threads are launched by Apache as a less-privileged user. The
0N/A <code>User</code> and <code>Group</code> directives are used to
0N/A set the privileges of the Apache child processes. The child
0N/A processes must be able to read all the content that will be
0N/A served, but should have as few privileges beyond that as
0N/A possible. In addition, unless <a href="/suexec.html">suexec</a> is used, these directives also
0N/A set the privileges which will be inherited by CGI scripts.</p>
0N/A
0N/A <p><code>MaxRequestsPerChild</code> controls how frequently the
0N/A server recycles processes by killing old ones and launching new
0N/A ones.</p>
0N/A
0N/A <p>See also: <a href="/bind.html">Setting which addresses and
0N/A ports Apache uses</a>.</p>
0N/A<h2>Directives</h2><ul><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#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#maxclients">MaxClients</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#minsparethreads">MinSpareThreads</a></li><li><a href="mpm_common.html#pidfile">PidFile</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#serverlimit">ServerLimit</a></li><li><a href="mpm_common.html#startservers">StartServers</a></li><li><a href="mpm_common.html#threadlimit">ThreadLimit</a></li><li><a href="mpm_common.html#threadsperchild">ThreadsPerChild</a></li><li><a href="mpm_common.html#user">User</a></li></ul><hr/><h3 align="center">Apache HTTP Server Version 2.0</h3><a href="./"><img alt="Index" src="/images/index.gif"/></a><a href="../"><img alt="Home" src="/images/home.gif"/></a></blockquote></body></html>