1<?xml version="1.0" encoding="ISO-8859-1"?>
2<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
3<html xmlns="http://www.w3.org/1999/xhtml" lang="en" xml:lang="en"><head><!--
4        XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
5              This file is generated from xml source: DO NOT EDIT
6        XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
7      -->
8<title>Multi-Processing Modules (MPMs) - Apache HTTP Server</title>
9<link href="/style/css/manual.css" rel="stylesheet" media="all" type="text/css" title="Main stylesheet" />
10<link href="/style/css/manual-loose-100pc.css" rel="alternate stylesheet" media="all" type="text/css" title="No Sidebar - Default font size" />
11<link href="/style/css/manual-print.css" rel="stylesheet" media="print" type="text/css" /><link rel="stylesheet" type="text/css" href="/style/css/prettify.css" />
12<script src="/style/scripts/prettify.js" type="text/javascript">
13</script>
14
15<link href="/images/favicon.ico" rel="shortcut icon" /></head>
16<body id="manual-page"><div id="page-header">
17<p class="menu"><a href="/mod/">Modules</a> | <a href="/mod/directives.html">Directives</a> | <a href="http://wiki.apache.org/httpd/FAQ">FAQ</a> | <a href="/glossary.html">Glossary</a> | <a href="/sitemap.html">Sitemap</a></p>
18<p class="apache">Apache HTTP Server Version 2.2</p>
19<img alt="" src="/images/feather.gif" /></div>
20<div class="up"><a href="./"><img title="&lt;-" alt="&lt;-" src="/images/left.gif" /></a></div>
21<div id="path">
22<a href="http://www.apache.org/">Apache</a> &gt; <a href="http://httpd.apache.org/">HTTP Server</a> &gt; <a href="http://httpd.apache.org/docs/">Documentation</a> &gt; <a href="./">Version 2.2</a></div><div id="page-content"><div id="preamble"><h1>Multi-Processing Modules (MPMs)</h1>
23<div class="toplang">
24<p><span>Available Languages: </span><a href="/de/mpm.html" hreflang="de" rel="alternate" title="Deutsch">&nbsp;de&nbsp;</a> |
25<a href="/en/mpm.html" title="English">&nbsp;en&nbsp;</a> |
26<a href="/es/mpm.html" hreflang="es" rel="alternate" title="Espa�ol">&nbsp;es&nbsp;</a> |
27<a href="/fr/mpm.html" hreflang="fr" rel="alternate" title="Fran�ais">&nbsp;fr&nbsp;</a> |
28<a href="/ja/mpm.html" hreflang="ja" rel="alternate" title="Japanese">&nbsp;ja&nbsp;</a> |
29<a href="/ko/mpm.html" hreflang="ko" rel="alternate" title="Korean">&nbsp;ko&nbsp;</a> |
30<a href="/tr/mpm.html" hreflang="tr" rel="alternate" title="T�rk�e">&nbsp;tr&nbsp;</a> |
31<a href="/zh-cn/mpm.html" hreflang="zh-cn" rel="alternate" title="Simplified Chinese">&nbsp;zh-cn&nbsp;</a></p>
32</div>
33
34<p>This document describes what a Multi-Processing Module is and
35how they are used by the Apache HTTP Server.</p>
36</div>
37<div id="quickview"><ul id="toc"><li><img alt="" src="/images/down.gif" /> <a href="#introduction">Introduction</a></li>
38<li><img alt="" src="/images/down.gif" /> <a href="#choosing">Choosing an MPM</a></li>
39<li><img alt="" src="/images/down.gif" /> <a href="#defaults">MPM Defaults</a></li>
40</ul><ul class="seealso"><li><a href="#comments_section">Comments</a></li></ul></div>
41<div class="top"><a href="#page-header"><img alt="top" src="/images/up.gif" /></a></div>
42<div class="section">
43<h2><a name="introduction" id="introduction">Introduction</a></h2>
44
45    <p>The Apache HTTP Server is designed to be a powerful and
46    flexible web server that can work on a very wide variety of
47    platforms in a range of different environments. Different
48    platforms and different environments often require different
49    features, or may have different ways of implementing the same
50    feature most efficiently. Apache has always accommodated a wide
51    variety of environments through its modular design. This design
52    allows the webmaster to choose which features will be included
53    in the server by selecting which modules to load either at
54    compile-time or at run-time.</p>
55
56    <p>Apache 2.0 extends this modular design to the most basic
57    functions of a web server. The server ships with a selection of
58    Multi-Processing Modules (MPMs) which are responsible for
59    binding to network ports on the machine, accepting requests,
60    and dispatching children to handle the requests.</p>
61
62    <p>Extending the modular design to this level of the server
63    allows two important benefits:</p>
64
65    <ul>
66      <li>Apache can more cleanly and efficiently support a wide
67      variety of operating systems. In particular, the Windows
68      version of Apache is now much more efficient, since
69      <code class="module"><a href="/mod/mpm_winnt.html">mpm_winnt</a></code> can use native
70      networking features in place of the POSIX layer used in
71      Apache 1.3. This benefit also extends to other operating
72      systems that implement specialized MPMs.</li>
73
74      <li>The server can be better customized for the needs of the
75      particular site. For example, sites that need a great deal of
76      scalability can choose to use a threaded MPM like 
77      <code class="module"><a href="/mod/worker.html">worker</a></code> or <code class="module"><a href="/mod/event.html">event</a></code>, while sites requiring
78      stability or compatibility with older software can use a
79      <code class="module"><a href="/mod/prefork.html">prefork</a></code>.</li>
80    </ul>
81
82    <p>At the user level, MPMs appear much like other Apache
83    modules. The main difference is that one and only one MPM must
84    be loaded into the server at any time. The list of available
85    MPMs appears on the <a href="mod/">module index page</a>.</p>
86
87</div><div class="top"><a href="#page-header"><img alt="top" src="/images/up.gif" /></a></div>
88<div class="section">
89<h2><a name="choosing" id="choosing">Choosing an MPM</a></h2>
90
91    <p>MPMs must be chosen during configuration, and compiled into
92    the server. Compilers are capable of optimizing a lot of
93    functions if threads are used, but only if they know that
94    threads are being used.</p>
95
96    <p>To actually choose the desired MPM, use the argument
97      <code>--with-mpm=<em>NAME</em></code> with the
98      <code class="program"><a href="/programs/configure.html">configure</a></code> script. <em>NAME</em> is the name of the
99      desired MPM.</p>
100
101    <p>Once the server has been compiled, it is possible to
102    determine which MPM was chosen by using <code>/httpd
103    -l</code>. This command will list every module that is compiled
104    into the server, including the MPM.</p>
105</div><div class="top"><a href="#page-header"><img alt="top" src="/images/up.gif" /></a></div>
106<div class="section">
107<h2><a name="defaults" id="defaults">MPM Defaults</a></h2>
108
109<p>The following table lists the default MPMs for various operating
110systems.  This will be the MPM selected if you do not make another
111choice at compile-time.</p>
112
113<table>
114
115<tr><td>BeOS</td><td><code class="module"><a href="/mod/beos.html">beos</a></code></td></tr>
116<tr><td>Netware</td><td><code class="module"><a href="/mod/mpm_netware.html">mpm_netware</a></code></td></tr>
117<tr><td>OS/2</td><td><code class="module"><a href="/mod/mpmt_os2.html">mpmt_os2</a></code></td></tr>
118<tr><td>Unix</td><td><code class="module"><a href="/mod/prefork.html">prefork</a></code></td></tr>
119<tr><td>Windows</td><td><code class="module"><a href="/mod/mpm_winnt.html">mpm_winnt</a></code></td></tr>
120</table>
121</div></div>
122<div class="bottomlang">
123<p><span>Available Languages: </span><a href="/de/mpm.html" hreflang="de" rel="alternate" title="Deutsch">&nbsp;de&nbsp;</a> |
124<a href="/en/mpm.html" title="English">&nbsp;en&nbsp;</a> |
125<a href="/es/mpm.html" hreflang="es" rel="alternate" title="Espa�ol">&nbsp;es&nbsp;</a> |
126<a href="/fr/mpm.html" hreflang="fr" rel="alternate" title="Fran�ais">&nbsp;fr&nbsp;</a> |
127<a href="/ja/mpm.html" hreflang="ja" rel="alternate" title="Japanese">&nbsp;ja&nbsp;</a> |
128<a href="/ko/mpm.html" hreflang="ko" rel="alternate" title="Korean">&nbsp;ko&nbsp;</a> |
129<a href="/tr/mpm.html" hreflang="tr" rel="alternate" title="T�rk�e">&nbsp;tr&nbsp;</a> |
130<a href="/zh-cn/mpm.html" hreflang="zh-cn" rel="alternate" title="Simplified Chinese">&nbsp;zh-cn&nbsp;</a></p>
131</div><div class="top"><a href="#page-header"><img src="/images/up.gif" alt="top" /></a></div><div class="section"><h2><a id="comments_section" name="comments_section">Comments</a></h2><div class="warning"><strong>Notice:</strong><br />This is not a Q&amp;A section. Comments placed here should be pointed towards suggestions on improving the documentation or server, and may be removed again by our moderators if they are either implemented or considered invalid/off-topic. Questions on how to manage the Apache HTTP Server should be directed at either our IRC channel, #httpd, on Freenode, or sent to our <a href="http://httpd.apache.org/lists.html">mailing lists</a>.</div>
132<script type="text/javascript"><!--//--><![CDATA[//><!--
133var comments_shortname = 'httpd';
134var comments_identifier = 'http://httpd.apache.org/docs/2.2/mpm.html';
135(function(w, d) {
136    if (w.location.hostname.toLowerCase() == "httpd.apache.org") {
137        d.write('<div id="comments_thread"><\/div>');
138        var s = d.createElement('script');
139        s.type = 'text/javascript';
140        s.async = true;
141        s.src = 'https://comments.apache.org/show_comments.lua?site=' + comments_shortname + '&page=' + comments_identifier;
142        (d.getElementsByTagName('head')[0] || d.getElementsByTagName('body')[0]).appendChild(s);
143    }
144    else { 
145        d.write('<div id="comments_thread">Comments are disabled for this page at the moment.<\/div>');
146    }
147})(window, document);
148//--><!]]></script></div><div id="footer">
149<p class="apache">Copyright 2013 The Apache Software Foundation.<br />Licensed under the <a href="http://www.apache.org/licenses/LICENSE-2.0">Apache License, Version 2.0</a>.</p>
150<p class="menu"><a href="/mod/">Modules</a> | <a href="/mod/directives.html">Directives</a> | <a href="http://wiki.apache.org/httpd/FAQ">FAQ</a> | <a href="/glossary.html">Glossary</a> | <a href="/sitemap.html">Sitemap</a></p></div><script type="text/javascript"><!--//--><![CDATA[//><!--
151if (typeof(prettyPrint) !== 'undefined') {
152    prettyPrint();
153}
154//--><!]]></script>
155</body></html>