Blame docs/manual/mod/mpm_winnt.html.en

Packit 90a5c9
Packit 90a5c9
Packit 90a5c9
<html xmlns="http://www.w3.org/1999/xhtml" lang="en" xml:lang="en"><head>
Packit 90a5c9
<meta content="text/html; charset=ISO-8859-1" http-equiv="Content-Type" />
Packit 90a5c9
Packit 90a5c9
        XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
Packit 90a5c9
              This file is generated from xml source: DO NOT EDIT
Packit 90a5c9
        XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
Packit 90a5c9
      -->
Packit 90a5c9
<title>mpm_winnt - Apache HTTP Server Version 2.4</title>
Packit 90a5c9
<link href="../style/css/manual.css" rel="stylesheet" media="all" type="text/css" title="Main stylesheet" />
Packit 90a5c9
<link href="../style/css/manual-loose-100pc.css" rel="alternate stylesheet" media="all" type="text/css" title="No Sidebar - Default font size" />
Packit 90a5c9
<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" />
Packit 90a5c9
<script src="../style/scripts/prettify.min.js" type="text/javascript">
Packit 90a5c9
</script>
Packit 90a5c9
Packit 90a5c9
<link href="../images/favicon.ico" rel="shortcut icon" /></head>
Packit 90a5c9
<body>
Packit 90a5c9
Packit 90a5c9

Modules | Directives | FAQ | Glossary | Sitemap

Packit 90a5c9

Apache HTTP Server Version 2.4

Packit 90a5c9
Packit 90a5c9
<-
Packit 90a5c9
Packit 90a5c9
Apache > HTTP Server > Documentation > Version 2.4 > Modules
Packit 90a5c9
Packit 90a5c9

Apache MPM winnt

Packit 90a5c9
Packit 90a5c9

Available Languages:  de  |

Packit 90a5c9
 en  |
Packit 90a5c9
 fr  |
Packit 90a5c9
 ja 

Packit 90a5c9
Packit 90a5c9
Description:Multi-Processing Module optimized for Windows NT.
Packit 90a5c9
Status:MPM
Packit 90a5c9
Module Identifier:mpm_winnt_module
Packit 90a5c9
Source File:mpm_winnt.c
Packit 90a5c9

Summary

Packit 90a5c9
Packit 90a5c9
    

This Multi-Processing Module (MPM) is the default for the

Packit 90a5c9
    Windows NT operating systems. It uses a single control process
Packit 90a5c9
    which launches a single child process which in turn creates
Packit 90a5c9
    threads to handle requests

Packit 90a5c9
Packit 90a5c9
    

Capacity is configured using the

Packit 90a5c9
    ThreadsPerChild directive,
Packit 90a5c9
    which sets the maximum number of concurrent client connections.

Packit 90a5c9
Packit 90a5c9
    

By default, this MPM uses advanced Windows APIs for accepting

Packit 90a5c9
    new client connections.  In some configurations, third-party products
Packit 90a5c9
    may interfere with this implementation, with the following messages
Packit 90a5c9
    written to the web server log:

Packit 90a5c9
Packit 90a5c9
    

Packit 90a5c9
        Child: Encountered too many AcceptEx faults accepting client connections.
Packit 90a5c9
        winnt_mpm: falling back to 'AcceptFilter none'.
Packit 90a5c9
    

Packit 90a5c9
Packit 90a5c9
    

The MPM falls back to a safer implementation, but some client requests

Packit 90a5c9
    were not processed correctly.  In order to avoid this error, use
Packit 90a5c9
    AcceptFilter with accept filter 
Packit 90a5c9
    none.

Packit 90a5c9
Packit 90a5c9
    
AcceptFilter http none
Packit 90a5c9
AcceptFilter https none
Packit 90a5c9
Packit 90a5c9
    
Packit 90a5c9
    

In Apache httpd 2.0 and 2.2,

Packit 90a5c9
    Win32DisableAcceptEx was used for this purpose.

Packit 90a5c9
Packit 90a5c9
    

The WinNT MPM differs from the Unix MPMs such as worker and event

Packit 90a5c9
    in several areas:

Packit 90a5c9
Packit 90a5c9
    
    Packit 90a5c9
          
  • When a child process is exiting due to shutdown, restart, or
  • Packit 90a5c9
          MaxConnectionsPerChild,
    Packit 90a5c9
          active requests in the exiting process have
    Packit 90a5c9
          TimeOut seconds to finish before
    Packit 90a5c9
          processing is aborted.  Alternate types of restart and shutdown are not
    Packit 90a5c9
          implemented.
    Packit 90a5c9
    Packit 90a5c9
          
  • New child processes read the configuration files instead of
  • Packit 90a5c9
          inheriting the configuration from the parent.  The behavior will
    Packit 90a5c9
          be the same as on Unix if the child process is created at startup
    Packit 90a5c9
          or restart, but if a child process is created because the prior
    Packit 90a5c9
          one crashed or reached 
    Packit 90a5c9
          MaxConnectionsPerChild,
    Packit 90a5c9
          any pending changes to the configuration will become active in the
    Packit 90a5c9
          child at that point, and the parent and child will be using a
    Packit 90a5c9
          different configuration.  If planned configuration changes have been
    Packit 90a5c9
          partially implemented and the current configuration cannot be
    Packit 90a5c9
          parsed, the replacement child process cannot start up and the server 
    Packit 90a5c9
          will halt.  Because of this behavior, configuration files should not
    Packit 90a5c9
          be changed until the time of a server restart.
    Packit 90a5c9
    Packit 90a5c9
          
  • The monitor and fatal_exception hooks
  • Packit 90a5c9
          are not currently implemented.
    Packit 90a5c9
    Packit 90a5c9
          
  • AcceptFilter is implemented in the MPM
  • Packit 90a5c9
          and has a different type of control over handling of new connections.
    Packit 90a5c9
          (Refer to the AcceptFilter
    Packit 90a5c9
          documentation for details.)
    Packit 90a5c9
        
    Packit 90a5c9
    Packit 90a5c9
    Packit 90a5c9
    Support Apache!

    Directives

    Packit 90a5c9
      Packit 90a5c9
    • AcceptFilter
    • Packit 90a5c9
    • CoreDumpDirectory
    • Packit 90a5c9
    • Listen
    • Packit 90a5c9
    • ListenBacklog
    • Packit 90a5c9
    • MaxConnectionsPerChild
    • Packit 90a5c9
    • MaxMemFree
    • Packit 90a5c9
    • PidFile
    • Packit 90a5c9
    • ReceiveBufferSize
    • Packit 90a5c9
    • ScoreBoardFile
    • Packit 90a5c9
    • SendBufferSize
    • Packit 90a5c9
    • ThreadLimit
    • Packit 90a5c9
    • ThreadsPerChild
    • Packit 90a5c9
    • ThreadStackSize
    • Packit 90a5c9
      Packit 90a5c9

      Bugfix checklist

      See also

      Packit 90a5c9
        Packit 90a5c9
      • Using Apache HTTP Server on Microsoft Windows
      • Packit 90a5c9
      • Comments
      • Packit 90a5c9
        Packit 90a5c9
        Packit 90a5c9
        Packit 90a5c9

        Available Languages:  de  |

        Packit 90a5c9
         en  |
        Packit 90a5c9
         fr  |
        Packit 90a5c9
         ja 

        Packit 90a5c9
        top

        Comments

        Notice:
        This is not a Q&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 mailing lists.
        Packit 90a5c9
        <script type="text/javascript">
        Packit 90a5c9
        var comments_shortname = 'httpd';
        Packit 90a5c9
        var comments_identifier = 'http://httpd.apache.org/docs/2.4/mod/mpm_winnt.html';
        Packit 90a5c9
        (function(w, d) {
        Packit 90a5c9
            if (w.location.hostname.toLowerCase() == "httpd.apache.org") {
        Packit 90a5c9
                d.write('
        <\/div>');
        Packit 90a5c9
                var s = d.createElement('script');
        Packit 90a5c9
                s.type = 'text/javascript';
        Packit 90a5c9
                s.async = true;
        Packit 90a5c9
                s.src = 'https://comments.apache.org/show_comments.lua?site=' + comments_shortname + '&page=' + comments_identifier;
        Packit 90a5c9
                (d.getElementsByTagName('head')[0] || d.getElementsByTagName('body')[0]).appendChild(s);
        Packit 90a5c9
            }
        Packit 90a5c9
            else { 
        Packit 90a5c9
                d.write('
        Comments are disabled for this page at the moment.<\/div>');
        Packit 90a5c9
            }
        Packit 90a5c9
        })(window, document);
        Packit 90a5c9
        //--></script>
        Packit 90a5c9

        Copyright 2018 The Apache Software Foundation.
        Licensed under the Apache License, Version 2.0.

        Packit 90a5c9

        Modules | Directives | FAQ | Glossary | Sitemap

        <script type="text/javascript">
        Packit 90a5c9
        if (typeof(prettyPrint) !== 'undefined') {
        Packit 90a5c9
            prettyPrint();
        Packit 90a5c9
        }
        Packit 90a5c9
        //--></script>
        Packit 90a5c9
        </body></html>