Commit 3c8a7b7b authored by Ryan Bloom's avatar Ryan Bloom
Browse files

Remove the dexter MPM. This has been replaced with the Perchild MPM. 

The two MPMs are basically identical, except that Perchild also allows
each child process to have a unique uid/gid combination.


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

CHANGES

+5 −0
Original line number Diff line number Diff line 
Changes with Apache 2.0b1



  *) Remove the dexter MPM.  Perchild is the same basic idea, but it has the

     added feature of allowing a uid/gid per child process.  If no

     uid/gid is specified, then Perchild behaves exactly like dexter.

     [Ryan Bloom]



  *) Get perchild building again. [Ryan Bloom]



  *) Don't disable threads just because we are using the prefork MPM.

INSTALL

+0 −2
Original line number Diff line number Diff line
@@ -325,8 +325,6 @@ 
          mpmt_pthread ..... Mutli-process(dynamic) Multi-threaded(static) 

                             Unix MPM

          prefork .......... Preforking Unix MPM

          dexter ........... Multi-process(static) Multi-threaded(dynamic)

                             Unix MPM

          perchild ......... Multi-process(static) Multi-threaded(dynamic)

                             Unix MPM, that allows a User per child process

docs/conf/httpd-std.conf

+3 −3
Original line number Diff line number Diff line
@@ -72,7 +72,7 @@ PidFile logs/httpd.pid 
# this file will be  created when you run Apache) then you *must* ensure that

# no two invocations of Apache share the same scoreboard file.

#

<IfModule !dexter.c>

<IfModule !perchild.c>

ScoreBoardFile logs/apache_runtime_status

</IfModule>
@@ -134,14 +134,14 @@ ThreadsPerChild 20 
MaxRequestsPerChild  0

</IfModule>



# dexter MPM

# perchild MPM

# NumServers ........... constant number of server processes

# StartThreads ......... initial  number of worker threads in each server process

# MinSpareThreads ...... minimum  number of worker threads which are kept spare

# MaxSpareThreads ...... maximum  number of worker threads which are kept spare

# MaxThreadsPerChild ... maximum  number of worker threads in each server process

# MaxRequestsPerChild .. maximum  number of connections per server process (then it dies)

<IfModule dexter.c>

<IfModule perchild.c>

NumServers           5

StartThreads         5

MinSpareThreads      5

docs/manual/mod/dexter.html

deleted100644 → 0
+0 −107
Original line number Diff line number Diff line 
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 3.2 Final//EN">

<HTML>

<HEAD>

<TITLE>Apache MPM dexter</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 dexter</H1>

<P>

This Multi-Processing Module implements a hybrid multi-process

multi-threaded web server with a variable number of threads per

process.

</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> dexter.c

<BR>

<A

HREF="module-dict.html#ModuleIdentifier"

REL="Help"

><STRONG>Module Identifier:</STRONG></A> mpm_dexter_module

</P>



<H2>Summary</H2>



<p>This Multi-Processing Module (MPM) implements a hybrid

multi-process, multi-threaded web server.  A fixed number of processes

create threads to handle requests.  Fluctuations in load are handled

by increasing or decreasing the number of threads in each process.</p>



<p>A single control process launches the number of child processes

indicated by the <code>NumServers</code> directive at server startup.

Each child process creates threads as specified in the

<code>StartThreads</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 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>

docs/manual/mod/index-bytype.html

+0 −3
Original line number Diff line number Diff line
@@ -28,9 +28,6 @@ directives</A>. 
<DL>

<DT><A HREF="core.html">Core</A>

<DD>Core Apache features.

<DT><a href="dexter.html">dexter</a>

<DD>Multi-Processing Module with Threading via Pthreads; Fixed number

of processes, variable number of threads/child

<DT><A HREF="mpmt_pthread.html">mpmt_pthread</A>

<DD>Multi-Processing Module with Threading via Pthreads; Variable number

of processes, constant number of threads/child