You are viewing a plain text version of this content. The canonical link for it is here.
Posted to cvs@httpd.apache.org by sl...@apache.org on 2005/12/05 21:35:27 UTC
svn commit: r354164 - in /httpd/httpd/trunk/docs/manual/mod: event.xml
leader.xml worker.xml
Author: slive
Date: Mon Dec 5 12:35:24 2005
New Revision: 354164
URL: http://svn.apache.org/viewcvs?rev=354164&view=rev
Log:
Give a clue about what event really does, and some
small improvements to the leader and worker docs.
Submitted by: Noirin Plunkett <firebird nerdchic.net>, Joshua Slive
Modified:
httpd/httpd/trunk/docs/manual/mod/event.xml
httpd/httpd/trunk/docs/manual/mod/leader.xml
httpd/httpd/trunk/docs/manual/mod/worker.xml
Modified: httpd/httpd/trunk/docs/manual/mod/event.xml
URL: http://svn.apache.org/viewcvs/httpd/httpd/trunk/docs/manual/mod/event.xml?rev=354164&r1=354163&r2=354164&view=diff
==============================================================================
--- httpd/httpd/trunk/docs/manual/mod/event.xml (original)
+++ httpd/httpd/trunk/docs/manual/mod/event.xml Mon Dec 5 12:35:24 2005
@@ -30,14 +30,46 @@
<summary>
<note type="warning"><title>Warning</title>
- <p>This MPM is experimental, so it may or may not work
- as expected.</p>
+ <p>This MPM is experimental, so it may or may not work as
+ expected.</p>
</note>
-
+
+ <p>The <module>event</module> Multi-Processing Module (MPM) is
+ designed to allow more requests to be served simultaneously by
+ passing off some processing work to supporting threads, freeing up
+ the main threads to work on new requests. It is based on the
+ <module>worker</module> MPM, which implements a hybrid
+ multi-process multi-threaded server. Run-time configuration
+ directives are identical to those provided by
+ <module>worker</module>.</p>
+
<p>To use the <module>event</module> MPM, add
<code>--with-mpm=event</code> to the <program>configure</program>
script's arguments when building the <program>httpd</program>.</p>
-
+
+</summary>
+
+<seealso><a href="worker.html">The worker MPM</a></seealso>
+
+<section id="how-it-works"><title>How it Works</title>
+ <p>This MPM tries to fix the 'keep alive problem' in HTTP. After a client
+ completes the first request, the client can keep the connection
+ open, and send further requests using the same socket. This can
+ save signifigant overhead in creating TCP connections. However,
+ Apache traditionally keeps an entire child process/thread waiting
+ for data from the client, which brings its own disadvantages. To
+ solve this problem, this MPM uses a dedicated thread to handle both
+ the Listening sockets, and all sockets that are in a Keep Alive
+ state.</p>
+
+ <p>The MPM assumes that the underlying <code>apr_pollset</code>
+ implementation is reasonably threadsafe. This enables the MPM to
+ avoid excessive high level locking, or having to wake up the listener
+ thread in order to send it a keep-alive socket. This is currently
+ only compatible with KQueue and EPoll.</p>
+
+</section>
+<section id="requirements"><title>Requirements</title>
<p>This MPM depends on <glossary>APR</glossary>'s atomic
compare-and-swap operations for thread synchronization. If you are
compiling for an x86 target and you don't need to support 386s, or
@@ -46,8 +78,32 @@
<code>--enable-nonportable-atomics=yes</code> to the
<program>configure</program> script's arguments. This will cause
APR to implement atomic operations using efficient opcodes not
- available in older CPUs.</p>
-</summary>
+ available in older CPUs.</p>
+
+ <p>This MPM does not perform well on older platforms which lack good
+ threading, but the requirement for EPoll or KQueue makes this
+ moot.</p>
+
+ <ul>
+
+ <li>To use this MPM on FreeBSD, FreeBSD 5.3 or higher is recommended.
+ However, it is possible to run this MPM on FreeBSD 5.2.1, if you
+ use <code>libkse</code> (see <code>man libmap.conf</code>).</li>
+
+ <li>For NetBSD, at least version 2.0 is recommended.</li>
+
+ <li>For Linux, a 2.6 kernel is recommended. It is also necessary to
+ ensure that your version of <code>glibc</code> has been compiled
+ with support for EPoll.</li>
+
+ </ul>
+</section>
+
+<section id="issues"><title>Issues</title>
+ <p>At present, this MPM is incompatible with <module>mod_ssl</module>, and
+ other input filters.</p>
+</section>
+
<directivesynopsis location="mpm_common"><name>AcceptMutex</name>
</directivesynopsis>
Modified: httpd/httpd/trunk/docs/manual/mod/leader.xml
URL: http://svn.apache.org/viewcvs/httpd/httpd/trunk/docs/manual/mod/leader.xml?rev=354164&r1=354163&r2=354164&view=diff
==============================================================================
--- httpd/httpd/trunk/docs/manual/mod/leader.xml (original)
+++ httpd/httpd/trunk/docs/manual/mod/leader.xml Mon Dec 5 12:35:24 2005
@@ -43,7 +43,9 @@
<p>To use the <module>leader</module> MPM, add
<code>--with-mpm=leader</code> to the <program>configure</program>
script's arguments when building the <program>httpd</program>.</p>
-
+
+</summary>
+<section id="requirements"><title>Requirements</title>
<p>This MPM depends on APR's atomic compare-and-swap operations for
thread synchronization. If you are compiling for an x86 target
and you don't need to support 386s, or you are compiling for a
@@ -52,7 +54,9 @@
<program>configure</program> script's arguments. This will cause
APR to implement atomic operations
using efficient opcodes not available in older CPUs.</p>
-</summary>
+</section>
+
+<seealso><a href="worker.html">The worker MPM</a></seealso>
<directivesynopsis location="mpm_common"><name>AcceptMutex</name>
</directivesynopsis>
Modified: httpd/httpd/trunk/docs/manual/mod/worker.xml
URL: http://svn.apache.org/viewcvs/httpd/httpd/trunk/docs/manual/mod/worker.xml?rev=354164&r1=354163&r2=354164&view=diff
==============================================================================
--- httpd/httpd/trunk/docs/manual/mod/worker.xml (original)
+++ httpd/httpd/trunk/docs/manual/mod/worker.xml Mon Dec 5 12:35:24 2005
@@ -30,9 +30,9 @@
<summary>
<p>This Multi-Processing Module (MPM) implements a hybrid
- multi-process multi-threaded server. By using threads to serve
+ multi-process multi-threaded server. By using threads to serve
requests, it is able to serve a large number of requests with
- less system resources than a process-based server. Yet it
+ fewer system resources than a process-based server. However, it
retains much of the stability of a process-based server by
keeping multiple processes available, each with many threads.</p>
@@ -60,7 +60,7 @@
threads or processes to be created before their requests can be
served. The number of processes that will initially launched is
set by the <directive module="mpm_common">StartServers</directive>
- directive. Then during operation, Apache assesses the total number
+ directive. During operation, 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 <directive
module="mpm_common">MinSpareThreads</directive> and <directive
@@ -91,14 +91,14 @@
non-default values are specified for these directives, they
should appear before other <module>worker</module> directives.</p>
- <p>In addition to a the set of active child processes, there may
- be additional child processes which are terminating but where at
+ <p>In addition to the set of active child processes, there may
+ be additional child processes which are terminating, but where at
least one server thread is still handling an existing client
connection. Up to <directive
module="mpm_common">MaxClients</directive> terminating processes
may be present, though the actual number can be expected to be
much smaller. This behavior can be avoided by disabling the
- termination of individual child processes, which is achieved by
+ termination of individual child processes, which is achieved using
the following:</p>
<ul>