granicus.if.org Git - apache/blob - docs/manual/mod/mpm_winnt.html.en

   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 <meta content="text/html; charset=ISO-8859-1" http-equiv="Content-Type" />
   5 <!--
   6         XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
   7               This file is generated from xml source: DO NOT EDIT
   8         XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
   9       -->
  10 <title>mpm_winnt - Apache HTTP Server Version 2.5</title>
  11 <link href="../style/css/manual.css" rel="stylesheet" media="all" type="text/css" title="Main stylesheet" />
  12 <link href="../style/css/manual-loose-100pc.css" rel="alternate stylesheet" media="all" type="text/css" title="No Sidebar - Default font size" />
  13 <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" />
  14 <script src="../style/scripts/prettify.min.js" type="text/javascript">
  15 </script>
  16
  17 <link href="../images/favicon.ico" rel="shortcut icon" /></head>
  18 <body>
  19 <div id="page-header">
  20 <p class="menu"><a href="../mod/">Modules</a> | <a href="../mod/quickreference.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>
  21 <p class="apache">Apache HTTP Server Version 2.5</p>
  22 <img alt="" src="../images/feather.gif" /></div>
  23 <div class="up"><a href="./"><img title="&lt;-" alt="&lt;-" src="../images/left.gif" /></a></div>
  24 <div id="path">
  25 <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.5</a> &gt; <a href="./">Modules</a></div>
  26 <div id="page-content">
  27 <div id="preamble"><h1>Apache MPM winnt</h1>
  28 <div class="toplang">
  29 <p><span>Available Languages: </span><a href="../de/mod/mpm_winnt.html" hreflang="de" rel="alternate" title="Deutsch">&nbsp;de&nbsp;</a> |
  30 <a href="../en/mod/mpm_winnt.html" title="English">&nbsp;en&nbsp;</a> |
  31 <a href="../ja/mod/mpm_winnt.html" hreflang="ja" rel="alternate" title="Japanese">&nbsp;ja&nbsp;</a></p>
  32 </div>
  33 <table class="module"><tr><th><a href="module-dict.html#Description">Description:</a></th><td>Multi-Processing Module optimized for Windows NT.</td></tr>
  34 <tr><th><a href="module-dict.html#Status">Status:</a></th><td>MPM</td></tr>
  35 <tr><th><a href="module-dict.html#ModuleIdentifier">Module Identifier:</a></th><td>mpm_winnt_module</td></tr>
  36 <tr><th><a href="module-dict.html#SourceFile">Source File:</a></th><td>mpm_winnt.c</td></tr></table>
  37 <h3>Summary</h3>
  38
  39     <p>This Multi-Processing Module (MPM) is the default for the
  40     Windows NT operating systems. It uses a single control process
  41     which launches a single child process which in turn creates
  42     threads to handle requests</p>
  43
  44     <p>Capacity is configured using the
  45     <code class="directive"><a href="../mod/mpm_common.html#threadsperchild">ThreadsPerChild</a></code> directive,
  46     which sets the maximum number of concurrent client connections.</p>
  47
  48     <p>By default, this MPM uses advanced Windows APIs for accepting
  49     new client connections.  In some configurations, third-party products
  50     may interfere with this implementation, with the following messages
  51     written to the web server log:</p>
  52
  53     <div class="example"><p><code>
  54         Child: Encountered too many AcceptEx faults accepting client connections.<br />
  55         winnt_mpm: falling back to 'AcceptFilter none'.
  56     </code></p></div>
  57
  58     <p>The MPM falls back to a safer implementation, but some client requests
  59     were not processed correctly.  In order to avoid this error, use
  60     <code class="directive"><a href="../mod/core.html#acceptfilter">AcceptFilter</a></code> with accept filter
  61     <code>none</code>.</p>
  62
  63     <pre class="prettyprint lang-config">AcceptFilter http none
  64 AcceptFilter https none</pre>
  65
  66
  67     <p><em>In Apache httpd 2.0 and 2.2,
  68     <code class="directive">Win32DisableAcceptEx</code> was used for this purpose.</em></p>
  69
  70     <p>The WinNT MPM differs from the Unix MPMs such as worker and event
  71     in several areas:</p>
  72
  73     <ul>
  74       <li>When a child process is exiting due to shutdown, restart, or
  75       <code class="directive"><a href="../mod/mpm_common.html#maxconnectionsperchild">MaxConnectionsPerChild</a></code>,
  76       active requests in the exiting process have
  77       <code class="directive"><a href="../mod/core.html#timeout">TimeOut</a></code> seconds to finish before
  78       processing is aborted.  Alternate types of restart and shutdown are not
  79       implemented.</li>
  80
  81       <li>New child processes read the configuration files instead of
  82       inheriting the configuration from the parent.  The behavior will
  83       be the same as on Unix if the child process is created at startup
  84       or restart, but if a child process is created because the prior
  85       one crashed or reached
  86       <code class="directive"><a href="../mod/mpm_common.html#maxconnectionsperchild">MaxConnectionsPerChild</a></code>,
  87       any pending changes to the configuration will become active in the
  88       child at that point, and the parent and child will be using a
  89       different configuration.  If planned configuration changes have been
  90       partially implemented and the current configuration cannot be
  91       parsed, the replacement child process cannot start up and the server
  92       will halt.  Because of this behavior, configuration files should not
  93       be changed until the time of a server restart.</li>
  94
  95       <li>The <code>monitor</code> and <code>fatal_exception</code> hooks
  96       are not currently implemented.</li>
  97
  98       <li><code class="directive">AcceptFilter</code> is implemented in the MPM
  99       and has a different type of control over handling of new connections.
 100       (Refer to the <code class="directive"><a href="../mod/core.html#acceptfilter">AcceptFilter</a></code>
 101       documentation for details.)</li>
 102     </ul>
 103
 104 </div>
 105 <div id="quickview"><h3 class="directives">Directives</h3>
 106 <ul id="toc">
 107 <li><img alt="" src="../images/right.gif" /> <a href="core.html#acceptfilter">AcceptFilter</a></li>
 108 <li><img alt="" src="../images/right.gif" /> <a href="mpm_common.html#coredumpdirectory">CoreDumpDirectory</a></li>
 109 <li><img alt="" src="../images/right.gif" /> <a href="mpm_common.html#listen">Listen</a></li>
 110 <li><img alt="" src="../images/right.gif" /> <a href="mpm_common.html#listenbacklog">ListenBacklog</a></li>
 111 <li><img alt="" src="../images/right.gif" /> <a href="mpm_common.html#maxconnectionsperchild">MaxConnectionsPerChild</a></li>
 112 <li><img alt="" src="../images/right.gif" /> <a href="mpm_common.html#maxmemfree">MaxMemFree</a></li>
 113 <li><img alt="" src="../images/right.gif" /> <a href="mpm_common.html#pidfile">PidFile</a></li>
 114 <li><img alt="" src="../images/right.gif" /> <a href="mpm_common.html#receivebuffersize">ReceiveBufferSize</a></li>
 115 <li><img alt="" src="../images/right.gif" /> <a href="mpm_common.html#scoreboardfile">ScoreBoardFile</a></li>
 116 <li><img alt="" src="../images/right.gif" /> <a href="mpm_common.html#sendbuffersize">SendBufferSize</a></li>
 117 <li><img alt="" src="../images/right.gif" /> <a href="mpm_common.html#threadlimit">ThreadLimit</a></li>
 118 <li><img alt="" src="../images/right.gif" /> <a href="mpm_common.html#threadsperchild">ThreadsPerChild</a></li>
 119 <li><img alt="" src="../images/right.gif" /> <a href="mpm_common.html#threadstacksize">ThreadStackSize</a></li>
 120 </ul>
 121 <h3>See also</h3>
 122 <ul class="seealso">
 123 <li><a href="../platform/windows.html">Using Apache HTTP Server on Microsoft Windows</a></li>
 124 </ul><ul class="seealso"><li><a href="#comments_section">Comments</a></li></ul></div>
 125
 126 </div>
 127 <div class="bottomlang">
 128 <p><span>Available Languages: </span><a href="../de/mod/mpm_winnt.html" hreflang="de" rel="alternate" title="Deutsch">&nbsp;de&nbsp;</a> |
 129 <a href="../en/mod/mpm_winnt.html" title="English">&nbsp;en&nbsp;</a> |
 130 <a href="../ja/mod/mpm_winnt.html" hreflang="ja" rel="alternate" title="Japanese">&nbsp;ja&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[//><!--
 133 var comments_shortname = 'httpd';
 134 var comments_identifier = 'http://httpd.apache.org/docs/trunk/mod/mpm_winnt.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 2016 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/quickreference.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[//><!--
 151 if (typeof(prettyPrint) !== 'undefined') {
 152     prettyPrint();
 153 }
 154 //--><!]]></script>
 155 </body></html>