Add ListenBacklog directive to control the backlog passed to listen().

Also change the default to 511 for platforms that use an 8-bit datatype
to store it.

A slightly different implementation than suggested by Taso Devetzis
<devetzis@snet.net>, who submitted the PR.

PR: 240
Reviewed by:	Dean Gaudet, Jim Jagielski
Submitted by:
Obtained from:

git-svn-id: https://svn.apache.org/repos/asf/httpd/httpd/trunk@78428 13f79535-47bb-0310-9956-ffa450edef68

diff --git a/docs/manual/mod/core.html b/docs/manual/mod/core.html
index 4f0a3033cf6742782b03d172d793f2138d269d4a..94d0af234655be415e903a2682b6d75e9b68ac52 100644 (file)
--- a/docs/manual/mod/core.html
+++ b/docs/manual/mod/core.html
@@ -43,6 +43,7 @@ always available.
 <li><A HREF="#keepalivetimeout">KeepAliveTimeout</A>
 <li><A HREF="#limit">&lt;Limit&gt;</A>
 <li><A HREF="#listen">Listen</A>
+<li><A HREF="#listenbacklog">ListenBacklog</A>
 <li><A HREF="#location">&lt;Location&gt;</A>
 <li><A HREF="#maxclients">MaxClients</A>
 <li><A HREF="#maxkeepaliverequests">MaxKeepAliveRequests</a>
@@ -658,6 +659,19 @@ directive.</p>
 <a href="../misc/known_bugs.html#listenbug">Known Bugs</a></p>
 <hr>
 
+<A NAME="listenbacklog"<H2>ListenBacklog</H2></A>
+<strong>Syntax:</strong> ListenBacklog <em>backlog</em><br>
+<strong>Default:</strong> <code>ListenBacklog 511</code><br>
+<strong>Context:</strong> server config<br>
+<strong>Status:</strong> Core<br>
+<strong>Compatibility:</strong> ListenBacklog is only available in Apache
+versions after 1.2.0.<p>
+
+The maximum length of the queue of pending connections.  Generally no
+tuning is needed or desired, however on some systems it is desirable
+to increase this when under a TCP SYN flood attack.  See 
+the backlog parameter to the <code>listen(2)</code> system call.
+
 <A name="limit"><h2>&lt;Limit&gt; directive</h2></A>
 <!--%plaintext &lt;?INDEX {\tt Limit} section directive&gt; -->
 <strong>Syntax:</strong>

diff --git a/docs/manual/mod/directives.html b/docs/manual/mod/directives.html
index 23599099c2b3a77607692e5bf1689c760d2f9dc7..c912c648c029f9519eb19f42179e082a75a812e5 100644 (file)
--- a/docs/manual/mod/directives.html
+++ b/docs/manual/mod/directives.html
@@ -103,6 +103,7 @@
 <li><A HREF="mod_negotiation.html#languagepriority">LanguagePriority</A>
 <li><A HREF="core.html#limit">&lt;Limit&gt;</A>
 <li><A HREF="core.html#listen">Listen</A>
+<li><A HREF="core.html#listenbacklog">ListenBacklog</A>
 <li><A HREF="mod_dld.html#loadfile">LoadFile</A>
 <li><A HREF="mod_dld.html#loadmodule">LoadModule</A>
 <li><A HREF="core.html#location">&lt;Location&gt;</A>