Apache MPM mpmt

From 43e6780ec48bb150ba73492626479dd69d7b66b9 Mon Sep 17 00:00:00 2001 From: Joshua Slive Date: Sun, 19 Nov 2000 19:56:42 +0000 Subject: [PATCH] Add the perchild MPM docs and do a little bit of cleanup. This finishes up the basic structure of the windows and unix MPMs. I can do a little more cleanup, but this will need some heavy input from others, because I don't feel like going through each MPM to figure out what all these directive actually do. git-svn-id: https://svn.apache.org/repos/asf/httpd/httpd/trunk@87029 13f79535-47bb-0310-9956-ffa450edef68 --- docs/manual/mod/dexter.html | 88 ++------------------- docs/manual/mod/directives.html | 42 +++++----- docs/manual/mod/index.html | 9 ++- docs/manual/mod/mod_usertrack.html | 3 +- docs/manual/mod/mpm_common.html | 107 ++++++++++++++++++++++--- docs/manual/mod/perchild.html | 123 +++++++++++++++++++++++++++++ 6 files changed, 253 insertions(+), 119 deletions(-) create mode 100644 docs/manual/mod/perchild.html diff --git a/docs/manual/mod/dexter.html b/docs/manual/mod/dexter.html index b214947e85..51c047d277 100644 --- a/docs/manual/mod/dexter.html +++ b/docs/manual/mod/dexter.html @@ -28,12 +28,12 @@ REL="Help" Source File: mpmt_pthread.c +>Source File: dexter.c
Module Identifier: mpm_mpmt_pthread_module +>Module Identifier: mpm_dexter_module

Summary

@@ -47,7 +47,7 @@ or decreasing the number of threads.

Directives

- -

ConnectionStatus directive

Syntax: -Default: -Context: server config
-Status: MPM

-Module: dexter

- -

Whether or not to maintain status information on current -connections

- -

NumServers directive

Syntax: -Default: -Context: server config
-Status: MPM

-Module: dexter

- -

Number of children alive at the same time.

- -

StartThreads directive

Syntax: -Default: -Context: server config
-Status: MPM

-Module: dexter

- -

Number of threads each child creates.

- diff --git a/docs/manual/mod/directives.html b/docs/manual/mod/directives.html index cd56461b4e..824a6d31c8 100644 --- a/docs/manual/mod/directives.html +++ b/docs/manual/mod/directives.html @@ -54,6 +54,7 @@ of the terms used in their descriptions available.

Anonymous_MustGiveEmail

Anonymous_NoUserID

Anonymous_VerifyEmail +

AssignUserID

AuthAuthoritative

AuthDBAuthoritative

AuthDBGroupFile @@ -62,7 +63,6 @@ of the terms used in their descriptions available.

AuthType @@ -85,13 +85,14 @@ of the terms used in their descriptions available.

CookieLog (mod_cookies) -

CookieLog (mod_log_config) +

Dav

DavDepthInfinity @@ -118,7 +119,7 @@ of the terms used in their descriptions available.

<Files>

ForceType -

Group +

Group

Header

HeaderName

HostNameLookups @@ -146,31 +147,33 @@ of the terms used in their descriptions available.

LimitRequestFieldsize

LimitRequestLine

LimitXMLRequestBody -

Listen -

Listen +

MaxKeepAliveRequests -

MaxRequestsPerChild -

MaxSpareThreads +

MaxRequestsPerChild +

MetaDir

NoCache +

Options

Order

PassEnv -

PidFile +

PidFile

Port

ProxyBlock

ProxyDomain @@ -203,7 +206,7 @@ of the terms used in their descriptions available.

Satisfy -

Script

ScriptAliasMatch @@ -211,7 +214,7 @@ of the terms used in their descriptions available.

ServerName @@ -224,14 +227,15 @@ of the terms used in their descriptions available.

TimeOut

User +

User

UserDir

VirtualDocumentRoot diff --git a/docs/manual/mod/index.html b/docs/manual/mod/index.html index 03e47193eb..7c385a3396 100644 --- a/docs/manual/mod/index.html +++ b/docs/manual/mod/index.html @@ -30,14 +30,17 @@ directives.

Core

Core Apache features.

dexter -

Multi-Processing Model with Threading via Pthreads; Fixed number +

Multi-Processing Module with Threading via Pthreads; Fixed number of processes, variable number of threads/child

mpmt_pthread -

Multi-Processing Model with Threading via Pthreads; Variable number +

Multi-Processing Module with Threading via Pthreads; Variable number of processes, constant number of threads/child

mpm_winnt -

Multi-Processing Model with a single control process and a single +

Multi-Processing Module with a single control process and a single server process with multiple threads for Windows NT +

perchild +

Multi-Processing Module with the ability to server different +virtual hosts under different userids.

prefork

Non-threaded preforking processes model similar to Apache 1.3 diff --git a/docs/manual/mod/mod_usertrack.html b/docs/manual/mod/mod_usertrack.html index 51099659af..69c27990f4 100644 --- a/docs/manual/mod/mod_usertrack.html +++ b/docs/manual/mod/mod_usertrack.html @@ -63,8 +63,7 @@ added.

own logging, using the CookieLog directive. In this release, this module does no logging at all. Instead, a configurable log format file should be used to log user click-streams. This is possible -because the logging module now allows multiple log files. The cookie itself is +because the logging module allows multiple log files. The cookie itself is logged by using the text %{cookie}n in the log file format. For example:

diff --git a/docs/manual/mod/mpm_common.html b/docs/manual/mod/mpm_common.html
index 2b192e8de6..2381122704 100644
--- a/docs/manual/mod/mpm_common.html
+++ b/docs/manual/mod/mpm_common.html
@@ -22,6 +22,7 @@ than one multi-processing module (MPM).
 
 Directives
 
+ConnectionStatus
 CoreDumpDirectory
 Group
 PidFile
@@ -32,14 +33,43 @@ than one multi-processing module (MPM).
 MaxRequestsPerChild
 MaxSpareThreads
 MinSpareThreads
+NumServers
 ScoreBoardFile
 SendBufferSize
 StartServers
+StartThreads
 ThreadsPerChild
 User
 
 
 
+ConnectionStatus directive
+Syntax:

+Default:

+Context: server config

+Status: MPM

+Module: dexter, perchild
+
+Whether or not to maintain status information on current 
+connections
+
+

+
 CoreDumpDirectory directive
 
 Module: dexter, mpmt_pthread, prefork, mpm_winnt
+>Module: dexter, mpmt_pthread, perchild, prefork, mpm_winnt
 
 This controls the directory to which Apache attempts to switch
 before dumping core.  The default is in the 

 Module: dexter, mpmt_pthread, prefork
+>Module: dexter, mpmt_pthread, perchild, prefork
 
 The Group directive sets the group under which the server will answer requests.
 In order to use this directive, the stand-alone server must be run initially
@@ -142,7 +172,7 @@ considerations.

 Module: dexter, mpmt_pthread, prefork, mpm_winnt
+>Module: dexter, mpmt_pthread, perchild, prefork, mpm_winnt
 
 The PidFile directive sets the file to which the server records the
 process id of the daemon. If the filename does not begin with a slash
@@ -177,7 +207,7 @@ Listen [IP address:]port number

 Module: dexter, mpmt_pthread, prefork, mpm_winnt
+>Module: dexter, mpmt_pthread, perchild, prefork, mpm_winnt
 
 
 The Listen directive instructs Apache to listen to more than one IP
@@ -247,7 +277,7 @@ interfaces and port numbers, use
 Module: dexter, mpmt_pthread, prefork, mpm_winnt
+>Module: dexter, mpmt_pthread, perchild, prefork, mpm_winnt
 
 The maximum length of the queue of pending connections.  Generally no
 tuning is needed or desired, however on some systems it is desirable
@@ -280,7 +310,7 @@ use exactly what is specified as the backlog, but use a number based on
 Module: dexter, mpmt_pthread, prefork
+>Module: dexter, mpmt_pthread, perchild, prefork
 
 The LockFile directive sets the path to the lockfile used when
 Apache is compiled with either USE_FCNTL_SERIALIZED_ACCEPT or
@@ -362,7 +392,7 @@ href="#threadsperchild">ThreadsPerChild.
 Module: dexter, mpmt_pthread, prefork, mpm_winnt
+>Module: dexter, mpmt_pthread, prefork, perchild, mpm_winnt
 
 The MaxRequestsPerChild directive sets the limit on the number of requests
 that an individual child server process will handle. After MaxRequestsPerChild
@@ -405,7 +435,7 @@ behavior to limit the number of connections per child.
 Module: dexter, mpmt_pthread
+>Module: dexter, mpmt_pthread, perchild
 
 Maximum number of idle threads.
 
@@ -435,7 +465,7 @@ behavior to limit the number of connections per child.
 Module: dexter, mpmt_pthread
+>Module: dexter, mpmt_pthread, perchild
 
 Minimum number of idle threads to handle request spikes.
 
@@ -443,6 +473,32 @@ See also MaxSpareThreads and
 StartServers.

 
 
+NumServers directive
+Syntax:

+Default:

+Context: server config

+Status: MPM

+Module: dexter, perchild
+
+Number of children alive at the same time.
+
+

+
 ScoreBoardFile directive
 
 MaxSpareThreads and
 Module: dexter, mpmt_pthread, prefork
+>Module: dexter, mpmt_pthread, perchild, prefork
 
 The ScoreBoardFile directive is required on some architectures to place
 a file that the server will use to communicate between its children and
@@ -507,7 +563,7 @@ about log file placement and
 Module: dexter, mpmt_pthread, prefork, mpm_winnt
+>Module: dexter, mpmt_pthread, perchild, prefork, mpm_winnt
 
 The server will set the TCP buffer size to the number of bytes
 specified. Very useful to increase past standard OS defaults on high
@@ -546,6 +602,33 @@ on the load, there is usually little reason to adjust this parameter.
 See also MinSpareThreads and
 MaxSpareThreads.

 
+
+StartThreads directive
+Syntax:

+Default:

+Context: server config

+Status: MPM

+Module: dexter, perchild
+
+Number of threads each child creates.
+
+

+
 ThreadsPerChild
 
 Module: dexter, mpmt_pthread, prefork
+>Module: dexter, mpmt_pthread, perchild, prefork
 
 The User directive sets the userid as which the server will answer requests.
 In order to use this directive, the standalone server must be run initially
diff --git a/docs/manual/mod/perchild.html b/docs/manual/mod/perchild.html
new file mode 100644
index 0000000000..cabafdab90
--- /dev/null
+++ b/docs/manual/mod/perchild.html
@@ -0,0 +1,123 @@
+
+
+
+Apache MPM mpmt_pthread
+
+
+
+
+
+
+Multi-Processing Module perchild
+
+This Multi-Processing Module allows for daemon processes serving requests
+to be assigned a variety of different userids.
+
+
+Status: MPM
+

+Source File: perchild.c
+

+Module Identifier: mpm_perchild_module
+
+
+Summary
+
+Some description on how this whole thing works with a couple examples.
+
+
+Directives
+
+AssignUserID
+ChildPerUserID
+ConnectionStatus
+CoreDumpDirectory
+Group
+PidFile
+Listen
+ListenBacklog
+LockFile
+MaxRequestsPerChild
+MaxSpareThreads
+MinSpareThreads
+NumServers
+ScoreBoardFile
+SendBufferSize
+StartThreads
+User
+
+
+

+
+AssignUserID directive
+Syntax:

+Default:

+Context: server config

+Status: MPM

+Module: perchild
+
+Tie a virtual host to a specific child process.
+
+

+
+ChilePerUserID directive
+Syntax:

+Default:

+Context: server config

+Status: MPM

+Module: perchild
+
+Specify a User and Group for a specific child process.
+
+
+
+
+
+
+
+
-- 
2.40.0