From 6bb0e45638f1708b766dffe63b13a799ebf78b15 Mon Sep 17 00:00:00 2001 From: Joshua Slive Date: Sun, 10 Mar 2002 05:06:42 +0000 Subject: [PATCH] Convert the last module (mpm_netware) and add the skeleton xml for the automatic module index. git-svn-id: https://svn.apache.org/repos/asf/httpd/httpd/trunk@93829 13f79535-47bb-0310-9956-ffa450edef68 --- docs/manual/mod/index.xml | 18 +++++ docs/manual/mod/mpm_netware.xml | 131 ++++++++++++++++++++++++++++++++ 2 files changed, 149 insertions(+) create mode 100644 docs/manual/mod/index.xml create mode 100644 docs/manual/mod/mpm_netware.xml diff --git a/docs/manual/mod/index.xml b/docs/manual/mod/index.xml new file mode 100644 index 0000000000..a509c2eb0d --- /dev/null +++ b/docs/manual/mod/index.xml @@ -0,0 +1,18 @@ + + +]> + + + +Module Index + + +

Below is a list of all of the modules that come as part of + the Apache distribution. See also the complete + alphabetical list of all Apache + directives.

+ + +&allmodules; + \ No newline at end of file diff --git a/docs/manual/mod/mpm_netware.xml b/docs/manual/mod/mpm_netware.xml new file mode 100644 index 0000000000..e10f259409 --- /dev/null +++ b/docs/manual/mod/mpm_netware.xml @@ -0,0 +1,131 @@ + + + + +mpm_netware +Multi-Processing Module implementing an exclusively threaded web + server optimized for Novell NetWare +MPM +mpm_netware.c +mpm_netware_module + + +

This Multi-Processing Module (MPM) implements an exclusively threaded web server + that has been optimized for Novell NetWare.

+ +

The main thread is responsible for launching child + worker threads which listen for connections and serve them when they + arrive. Apache always tries to maintain several spare + or idle worker threads, which stand ready to serve incoming + requests. In this way, clients do not need to wait for a new + child threads to be spawned before their requests can be + served.

+ +

The StartThreads, MinSpareThreads, + MaxSpareThreads, and MaxThreads + regulate how the main thread creates worker threads to serve + requests. In general, Apache is very self-regulating, so most + sites do not need to adjust these directives from their default + values. Sites which need to serve more than 250 simultaneous + requests may need to increase MaxThreads, while + sites with limited memory may need to decrease + MaxThreads to keep the server from thrashing (spawning and + terminating idle threads). More information about + tuning process creation is provided in the performance hints + documentation.

+ +

MaxRequestsPerChild controls how frequently the + server recycles processes by killing old ones and launching new + ones.  On the NetWare OS it is highly recommended that this directive + remain set to 0.  This allows worker threads to continue servicing + requests indefinitely.

+ +

See also: Setting which addresses and + ports Apache uses.

+ + +Listen + +ListenBacklog + +MaxRequestsPerChild + +SendBufferSize + + + +MaxThreads +MaxThreads number +MaxThreads 250 +server config + + +

The MaxThreads directive sets the desired maximum + number worker threads allowable.

+ + + + +MaxSpareThreads +MaxSpareThreads number +MaxSpareThreads 100 +server config + + +

The MaxSpareThreads directive sets the + desired maximum number of idle worker threads. An idle + worker thread is one which is not handling a request. If there are + more than MaxSpareThreads idle, then the main thread will kill off + the excess worker threads.

+ +

Tuning of this parameter should only be necessary on very + busy sites. Setting this parameter to a large number is almost + always a bad idea.

+ + + + +MinSpareThreads +MinSpareThreads number +MinSpareThreads 10 +server config + + +

The MinSpareThreads directive sets the +desired minimum number of idle worker threads. An idle worker +thread is one which is not handling a request. If there are fewer than +MinSpareThreads idle, then the main thread spawns new worker.

+ +

Tuning of this parameter should only be necessary on very + busy sites. Setting this parameter to a large number is almost + always a bad idea.

+ + + + +StartThreads +StartThreads number +StartThreads 50 +server config + + +

The StartThreads directive sets the desired + number of worker threads to spawn and startup

+ + + + +ThreadStackSize +ThreadStackSize number +ThreadStackSize 65536 +server config + + +

This directive tells the server what stack size to use for + each of the running threads. If you ever get a stack overflow + you will need to bump this number to a higher setting.

+ + + + \ No newline at end of file -- 2.40.0