Describe IPv6 syntax for Listen, Allow from, and <VirtualHost >.

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

1 files changed, 36 insertions, 0 deletions

diff --git a/docs/manual/bind.html b/docs/manual/bind.html
index d587810315..a52d8ee3d0 100644
--- a/docs/manual/bind.html
+++ b/docs/manual/bind.html
@@ -47,6 +47,42 @@
    Listen 192.170.2.1:80
    Listen 192.170.2.5:8000
 </pre>
+    IPv6 addresses must be surrounded in square brackets, as in the
+    following example:
+<pre>
+   Listen [fe80::a00:20ff:fea7:ccea]:80
+</pre>
+
+    <h2>Special IPv6 considerations</h2>
+
+    When APR supports IPv6, Apache will create IPv6-capable listening
+    sockets by default (i.e., when no IP address is specified on the
+    Listen directive).  In other words, when APR supports IPv6,
+<pre>
+   Listen 80
+</pre>
+    is equivalent to 
+<pre>
+   Listen [::]:80
+</pre>
+    When APR does not support IPv6,
+<pre>
+   Listen 80
+</pre>
+    is equivalent to
+<pre>
+   Listen 0.0.0.0:80
+</pre>
+    On some platforms, such as NetBSD, binding to the IPv6 wildcard address 
+    ("::") does not allow Apache to accept connections on IPv4 interfaces.
+    In this situation, multiple Listen directives are required, as shown
+    below:
+<pre>
+   Listen 0.0.0.0:80
+   Listen [::]:80
+</pre>
+    Apache does not currently detect this, so the Listen statements must
+    be edited manually by the administrator.
 
     <h2>How this works with Virtual Hosts</h2>