From: Daniel Earl Poirier <poirier@apache.org>
Date: Thu, 4 Nov 2010 20:22:41 +0000 (+0000)
Subject: Add some more cross-references related to the protocol
X-Git-Tag: 2.3.9~142
X-Git-Url: https://granicus.if.org/sourcecode?a=commitdiff_plain;h=6f58211fd0afb4fd05ae2a6106a1036ffb8de9d3;p=apache

Add some more cross-references related to the protocol
argument for Listen and AcceptFilter, as suggested by
Otmar Lendl.  PR45286


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

diff --git a/docs/manual/bind.xml b/docs/manual/bind.xml
index f269618ae2..40c26fb5d2 100644
--- a/docs/manual/bind.xml
+++ b/docs/manual/bind.xml
@@ -148,6 +148,25 @@
     default on FreeBSD, NetBSD, and OpenBSD.</p>
   </section>
 
+  <section id="protocol">
+    <title>Specifying the protocol with Listen</title>
+    <p>The optional second <var>protocol</var> argument of
+       <directive module="mpm_common">Listen</directive>
+       is not required for most 
+       configurations. If not specified, <code>https</code> is the default for 
+       port 443 and <code>http</code> the default for all other ports.  The 
+       protocol is used to determine which module should handle a request, and
+       to apply protocol specific optimizations with the 
+       <directive module="core">AcceptFilter</directive> directive.</p>
+
+    <p>You only need to set the protocol if you are running on non-standard 
+       ports.  For example, running an <code>https</code> site on port 8443:</p>
+
+    <example>
+      Listen 192.170.2.1:8443 https
+    </example>
+  </section>
+
   <section id="virtualhost">
     <title>How This Works With Virtual Hosts</title>
 
diff --git a/docs/manual/mod/core.xml b/docs/manual/mod/core.xml
index c56af0e18c..282f2e29a1 100644
--- a/docs/manual/mod/core.xml
+++ b/docs/manual/mod/core.xml
@@ -50,6 +50,12 @@ On Windows from Apache httpd 2.3.3 and later.</compatibility>
        send data first, such as <code>ftp:</code> or <code>nntp</code>:</p>
     <example>AcceptFilter nntp none</example>
 
+    <p>The default protocol names are <code>https</code> for port 443
+       and <code>http</code> for all other ports.  To specify another protocol
+       is being used with a listening port, add the <var>protocol</var>
+       argument to the <directive module="mpm_common">Listen</directive>
+       directive.</p>
+
     <p>The default values on FreeBSD are:</p>
     <example>
         AcceptFilter http httpready <br/>