]> granicus.if.org Git - apache/commitdiff
use the old threaded.html contents for worker MPM docs (not carefully
authorJeff Trawick <trawick@apache.org>
Mon, 19 Nov 2001 18:15:26 +0000 (18:15 +0000)
committerJeff Trawick <trawick@apache.org>
Mon, 19 Nov 2001 18:15:26 +0000 (18:15 +0000)
examined, but there isn't much there that could be wrong)

git-svn-id: https://svn.apache.org/repos/asf/httpd/httpd/trunk@92038 13f79535-47bb-0310-9956-ffa450edef68

STATUS
docs/manual/mod/worker.html [new file with mode: 0644]

diff --git a/STATUS b/STATUS
index cd1969314876d206cfd858019fd0a01a0653312a..82a837958d1da42f7df8239a80ac68f29fc1fdf0 100644 (file)
--- a/STATUS
+++ b/STATUS
@@ -1,5 +1,5 @@
 APACHE 2.0 STATUS:                                             -*-text-*-
-Last modified at [$Date: 2001/11/19 18:07:27 $]
+Last modified at [$Date: 2001/11/19 18:15:26 $]
 
 Release:
 
@@ -319,8 +319,6 @@ RELEASE NON-SHOWSTOPPERS BUT WOULD BE REAL NICE TO WRAP THESE UP:
       -0:   Aaron (premature decision, needs more discussion)
       -0:   Cliff (I think the default config should be the safest possible)
 
-    * The worker MPM needs some doc.
-
 PRs that have been suspended forever waiting for someone to
 put them into 'the next release':
 
diff --git a/docs/manual/mod/worker.html b/docs/manual/mod/worker.html
new file mode 100644 (file)
index 0000000..48e4d66
--- /dev/null
@@ -0,0 +1,121 @@
+<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
+    "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
+
+<html xmlns="http://www.w3.org/1999/xhtml">
+  <head>
+    <meta name="generator" content="HTML Tidy, see www.w3.org" />
+
+    <title>Apache MPM worker</title>
+  </head>
+  <!-- Background white, links blue (unvisited), navy (visited), red (active) -->
+
+  <body bgcolor="#FFFFFF" text="#000000" link="#0000FF"
+  vlink="#000080" alink="#FF0000">
+    <!--#include virtual="header.html" -->
+
+    <h1 align="CENTER">Multi-Processing Module worker</h1>
+
+    <p>This Multi-Processing Module implements a hybrid
+    multi-threaded multi-process web server.</p>
+
+    <p><a href="module-dict.html#Status"
+    rel="Help"><strong>Status:</strong></a> MPM<br />
+     <a href="module-dict.html#SourceFile"
+    rel="Help"><strong>Source File:</strong></a> worker.c<br />
+     <a href="module-dict.html#ModuleIdentifier"
+    rel="Help"><strong>Module Identifier:</strong></a>
+    mpm_worker_module</p>
+
+    <h2>Summary</h2>
+
+    <p>This Multi-Processing Module (MPM) is the default for most
+    unix-like operating systems. It implements a hybrid
+    multi-process multi-threaded server. Each process has a fixed
+    number of threads. The server adjusts to handle load by
+    increasing or decreasing the number of processes.</p>
+
+    <p>A single control process is responsible for launching child
+    processes. Each child process creates a fixed number of threads
+    as specified in the <code>ThreadsPerChild</code> directive. The
+    individual threads then listen for connections and serve them
+    when they arrive.</p>
+
+    <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 a new
+    threads or processes to be created before their requests can be
+    served. Apache assesses the total number of idle threads in all
+    processes, and forks or kills processes 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 maximum number of server processes that will be
+    created (<code>MaxClients</code>) by the number of threads
+    created in each process (<code>ThreadsPerChild</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#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#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#scoreboardfile">ScoreBoardFile</a></li>
+
+      <li><a
+      href="mpm_common.html#sendbuffersize">SendBufferSize</a></li>
+
+      <li><a
+      href="mpm_common.html#startservers">StartServers</a></li>
+
+      <li><a
+      href="mpm_common.html#threadsperchild">ThreadsPerChild</a></li>
+
+      <li><a href="mpm_common.html#user">User</a></li>
+    </ul>
+    <!--#include virtual="footer.html" -->
+  </body>
+</html>
+