Commit fbfe37c1 authored by Graham Leggett's avatar Graham Leggett
Browse files

Update transformations. 


git-svn-id: https://svn.apache.org/repos/asf/httpd/httpd/branches/2.4.x@1705493 13f79535-47bb-0310-9956-ffa450edef68
parent 01bb7186

docs/manual/mod/directives.html.en

+1 −0
Original line number Diff line number Diff line
@@ -347,6 +347,7 @@ 
<li><a href="core.html#limitxmlrequestbody">LimitXMLRequestBody</a></li>

<li><a href="mpm_common.html#listen">Listen</a></li>

<li><a href="mpm_common.html#listenbacklog">ListenBackLog</a></li>

<li><a href="mpm_common.html#listencoresbucketsratio">ListenCoresBucketsRatio</a></li>

<li><a href="mod_so.html#loadfile">LoadFile</a></li>

<li><a href="mod_so.html#loadmodule">LoadModule</a></li>

<li><a href="core.html#location">&lt;Location&gt;</a></li>

docs/manual/mod/mpm_common.html.en

+36 −0
Original line number Diff line number Diff line
@@ -43,6 +43,7 @@ more than one multi-processing module (MPM)</td></tr> 
<li><img alt="" src="../images/down.gif" /> <a href="#gracefulshutdowntimeout">GracefulShutdownTimeout</a></li>

<li><img alt="" src="../images/down.gif" /> <a href="#listen">Listen</a></li>

<li><img alt="" src="../images/down.gif" /> <a href="#listenbacklog">ListenBackLog</a></li>

<li><img alt="" src="../images/down.gif" /> <a href="#listencoresbucketsratio">ListenCoresBucketsRatio</a></li>

<li><img alt="" src="../images/down.gif" /> <a href="#maxconnectionsperchild">MaxConnectionsPerChild</a></li>

<li><img alt="" src="../images/down.gif" /> <a href="#maxmemfree">MaxMemFree</a></li>

<li><img alt="" src="../images/down.gif" /> <a href="#maxrequestworkers">MaxRequestWorkers</a></li>
@@ -252,6 +253,41 @@ including other causes.</a></li> 
    but use a number based on (but normally larger than) what is

    set.</p>



</div>

<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>

<div class="directive-section"><h2><a name="ListenCoresBucketsRatio" id="ListenCoresBucketsRatio">ListenCoresBucketsRatio</a> <a name="listencoresbucketsratio" id="listencoresbucketsratio">Directive</a></h2>

<table class="directive">

<tr><th><a href="directive-dict.html#Description">Description:</a></th><td>Ratio between the number of CPU cores (online) and the number of

listeners' buckets</td></tr>

<tr><th><a href="directive-dict.html#Syntax">Syntax:</a></th><td><code>ListenCoresBucketsRatio <var>ratio</var></code></td></tr>

<tr><th><a href="directive-dict.html#Default">Default:</a></th><td><code>ListenCoresBucketsRatio 0 (disabled)</code></td></tr>

<tr><th><a href="directive-dict.html#Context">Context:</a></th><td>server config</td></tr>

<tr><th><a href="directive-dict.html#Status">Status:</a></th><td>MPM</td></tr>

<tr><th><a href="directive-dict.html#Module">Module:</a></th><td><code class="module"><a href="../mod/event.html">event</a></code>, <code class="module"><a href="../mod/prefork.html">prefork</a></code>, <code class="module"><a href="../mod/worker.html">worker</a></code></td></tr>

<tr><th><a href="directive-dict.html#Compatibility">Compatibility:</a></th><td>Available in Apache HTTP Server 2.4.13, with a kernel supporting

the socket option <code>SO_REUSEPORT</code> and distributing new connections

evenly accross listening processes' (or threads') sockets using it (eg. Linux

3.9 and later, but not the current implementations of <code>SO_REUSEPORT</code>

in *BSDs.</td></tr>

</table>

    <p>A <var>ratio</var> between the number of (online) CPU cores and the

    number of listeners' buckets can be used to make Apache HTTP Server create

    <code>num_cpu_cores / ratio</code> listening buckets, each containing its

    own <code class="directive">Listen</code>-ing socket(s) on the same port(s), and

    then make each child handle a single bucket (with round-robin distribution

    of the buckets at children creation time).</p>



    <p><code class="directive">ListenCoresBucketsRatio</code> can improve the

    scalability when accepting new connections is/becomes the bottleneck.

    On systems with a large number of CPU cores, enabling this feature has

    been tested to show significant performances improvement and shorter

    responses time.</p>



    <p>There must be at least twice the number of CPU cores than the

    configured <var>ratio</var> for this to be active. The recommended

    <var>ratio</var> is <code>8</code>, hence at least <code>16</code>

    cores should be available at runtime when this value is used.</p>



</div>

<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>

<div class="directive-section"><h2><a name="MaxConnectionsPerChild" id="MaxConnectionsPerChild">MaxConnectionsPerChild</a> <a name="maxconnectionsperchild" id="maxconnectionsperchild">Directive</a></h2>

docs/manual/mod/mpm_common.xml.de

+1 −1
Original line number Diff line number Diff line 
<?xml version="1.0"?>

<!DOCTYPE modulesynopsis SYSTEM "../style/modulesynopsis.dtd">

<?xml-stylesheet type="text/xsl" href="../style/manual.de.xsl"?>

<!-- English Revision: 151408:1590654 (outdated) -->

<!-- English Revision: 151408:1705492 (outdated) -->



<!--

 Licensed to the Apache Software Foundation (ASF) under one or more

docs/manual/mod/mpm_common.xml.ja

+1 −1
Original line number Diff line number Diff line 
<?xml version="1.0" encoding="UTF-8" ?>

<!DOCTYPE modulesynopsis SYSTEM "../style/modulesynopsis.dtd">

<?xml-stylesheet type="text/xsl" href="../style/manual.ja.xsl"?>

<!-- English Revision: 674934:1590654 (outdated) -->

<!-- English Revision: 674934:1705492 (outdated) -->



<!--

 Licensed to the Apache Software Foundation (ASF) under one or more

docs/manual/mod/mpm_common.xml.meta

+1 −1
Original line number Diff line number Diff line
@@ -11,6 +11,6 @@ 
    <variant>en</variant>

    <variant>fr</variant>

    <variant outdated="yes">ja</variant>

    <variant>tr</variant>

    <variant outdated="yes">tr</variant>

  </variants>

</metafile>