summaryrefslogtreecommitdiffstats
path: root/docs/manual/mod/mpm_common.html.en
diff options
context:
space:
mode:
authorAndré Malo <nd@apache.org>2017-05-06 19:06:28 +0200
committerAndré Malo <nd@apache.org>2017-05-06 19:06:28 +0200
commit08a050a14a6d592501d6596e273f26e08775d3de (patch)
tree66e20cb4a369e44a9917c9782e644a547dd111bf /docs/manual/mod/mpm_common.html.en
parentproperty fixes (diff)
downloadapache2-08a050a14a6d592501d6596e273f26e08775d3de.tar.xz
apache2-08a050a14a6d592501d6596e273f26e08775d3de.zip
update transformation
git-svn-id: https://svn.apache.org/repos/asf/httpd/httpd/trunk@1794163 13f79535-47bb-0310-9956-ffa450edef68
Diffstat (limited to 'docs/manual/mod/mpm_common.html.en')
-rw-r--r--docs/manual/mod/mpm_common.html.en21
1 files changed, 21 insertions, 0 deletions
diff --git a/docs/manual/mod/mpm_common.html.en b/docs/manual/mod/mpm_common.html.en
index 0d2756bf49..b56633e9b3 100644
--- a/docs/manual/mod/mpm_common.html.en
+++ b/docs/manual/mod/mpm_common.html.en
@@ -304,6 +304,27 @@ in *BSDs.</td></tr>
The number of children processes needs to be a multiple of the number
of buckets to optimally accept connections.</p>
+ <div class="note">
+ <h3>Multiple <code class="directive">Listen</code>ers or Apache HTTP servers on
+ the same IP address and port</h3>
+ <p>Setting the <code>SO_REUSEPORT</code> option on the listening socket(s)
+ consequently allows multiple processes (sharing the same <code>EUID</code>,
+ e.g. <code>root</code>) to bind to the the same IP address and port,
+ without the binding error raised by the system in the usual case.</p>
+ <p>This also means that multiple instances of Apache httpd configured on a
+ same <code>IP:port</code> and with a positive <code class="directive">ListenCoresBucketsRatio</code>
+ would start without an error too, and then run with incoming connections
+ evenly distributed accross both instances (this is NOT a recommendation or
+ a sensible usage in any case, but just a notice that it would prevent such
+ possible issues to be detected).</p>
+ <p>Within the same instance, Apache httpd will check and fail to start if
+ multiple <code class="directive">Listen</code> directives on the exact same IP (or
+ hostname) and port are configured, thus avoiding the creation of some
+ duplicated buckets which would be useless and kill performances. However
+ it can't (and won't try harder to) catch all the possible overlapping cases
+ (like a hostname resolving to an IP used elsewhere).</p>
+ </div>
+
</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>