httpd-docs mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From Colm MacCarthaigh <c...@stdlib.net>
Subject [PATCH] [resend] [colm@stdlib.net IPv6 changes in bind.xml]
Date Sun, 28 Sep 2003 14:33:54 GMT

While I'm at it;
Rather than bother the list with resends, is it (or would it be more) 
appropriate to open a wishlist/feature req bug for documentation 
changes ?

----- Forwarded message from Colm MacCarthaigh <colm@stdlib.net> -----

From: Colm MacCarthaigh <colm@stdlib.net>
Reply-To: colm@stdlib.net
Date: Mon, 1 Sep 2003 15:54:48 +0100
To: docs@httpd.apache.org
Subject: IPv6 changes in bind.xml


Summary;
With Justins rewrite, and Jeffs and my patches now committed to the 
server listen code there is no longer any need for different Listen 
directives to use mapped/non-mapped addresses. Also cleared up that not all
platforms support v6-only sockets.

Index: bind.html.en
===================================================================
RCS file: /home/cvspublic/httpd-2.0/docs/manual/bind.html.en,v
retrieving revision 1.36
diff -u -u -r1.36 bind.html.en
--- bind.html.en	30 Jun 2003 01:16:29 -0000	1.36
+++ bind.html.en	1 Sep 2003 14:49:51 -0000
@@ -98,18 +98,14 @@
     platforms.  But even on systems where it is disallowed by default, a 
     special configure parameter can change this behavior for Apache.</p>
 
-    <p>If you want Apache to handle IPv4 and IPv6 connections with a 
-    minimum of sockets, which requires using IPv4-mapped IPv6 addresses, 
-    specify the <code>--enable-v4-mapped</code> configure option and use 
-    generic Listen directives like the following:</p>
+    <p>On the other hand, on some platforms such as Linux and Tru64 the 
+    <strong>only</strong> way to handle both IPv6 and IPv4 is to use 
+    mapped addresses. If you want Apache to handle IPv4 and IPv6 connections 
+    with a minimum of sockets, which requires using IPv4-mapped IPv6 
+    addresses, specify the <code>--enable-v4-mapped</code> configure 
+    option.</p>
 
-    <div class="example"><p><code>
-      Listen 80
-    </code></p></div>
-
-    <p>With <code>--enable-v4-mapped</code>, the Listen directives in the

-    default configuration file created by Apache will use this form.  
-    <code>--enable-v4-mapped</code> is the default on all platforms but 
+    <p><code>--enable-v4-mapped</code> is the default on all platforms
but 
     FreeBSD, NetBSD, and OpenBSD, so this is probably how your Apache was 
     built.</p>
 
@@ -122,21 +118,11 @@
       Listen 192.170.2.1:80
     </code></p></div>
 
-    <p>If you want Apache to handle IPv4 and IPv6 connections on separate 
-    sockets (i.e., to disable IPv4-mapped addresses), specify the 
-    <code>--disable-v4-mapped</code> configure option and use specific Listen

-    directives like the following:</p>
-
-    <div class="example"><p><code>
-      Listen [::]:80<br />
-      Listen 0.0.0.0:80
-    </code></p></div>
-
-    <p>With <code>--disable-v4-mapped</code>, the Listen directives in
the 
-    default configuration file created by Apache will use this form.  
-    <code>--disable-v4-mapped</code> is the default on FreeBSD, NetBSD, and 
-    OpenBSD.</p>
-
+    <p>If your platform supports it and you want Apache to handle IPv4 and 
+    IPv6  connections on separate sockets (i.e., to disable IPv4-mapped 
+    addresses), specify the <code>--disable-v4-mapped</code> configure 
+    option. <code>--disable-v4-mapped</code> is the default on FreeBSD, 
+    NetBSD, and OpenBSD.</p>
   </div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif"
/></a></div>
 <div class="section">
 <h2><a name="virtualhost" id="virtualhost">How This Works With Virtual Hosts</a></h2>
Index: bind.xml
===================================================================
RCS file: /home/cvspublic/httpd-2.0/docs/manual/bind.xml,v
retrieving revision 1.8
diff -u -u -r1.8 bind.xml
--- bind.xml	22 Jun 2003 15:31:23 -0000	1.8
+++ bind.xml	1 Sep 2003 14:49:51 -0000
@@ -89,18 +89,14 @@
     platforms.  But even on systems where it is disallowed by default, a 
     special configure parameter can change this behavior for Apache.</p>
 
-    <p>If you want Apache to handle IPv4 and IPv6 connections with a 
-    minimum of sockets, which requires using IPv4-mapped IPv6 addresses, 
-    specify the <code>--enable-v4-mapped</code> configure option and use 
-    generic Listen directives like the following:</p>
+    <p>On the other hand, on some platforms such as Linux and Tru64 the 
+    <strong>only</strong> way to handle both IPv6 and IPv4 is to use 
+    mapped addresses. If you want Apache to handle IPv4 and IPv6 connections 
+    with a minimum of sockets, which requires using IPv4-mapped IPv6 
+    addresses, specify the <code>--enable-v4-mapped</code> configure 
+    option.</p>
 
-    <example>
-      Listen 80
-    </example>
-
-    <p>With <code>--enable-v4-mapped</code>, the Listen directives in the

-    default configuration file created by Apache will use this form.  
-    <code>--enable-v4-mapped</code> is the default on all platforms but 
+    <p><code>--enable-v4-mapped</code> is the default on all platforms
but 
     FreeBSD, NetBSD, and OpenBSD, so this is probably how your Apache was 
     built.</p>
 
@@ -113,21 +109,11 @@
       Listen 192.170.2.1:80
     </example>
 
-    <p>If you want Apache to handle IPv4 and IPv6 connections on separate 
-    sockets (i.e., to disable IPv4-mapped addresses), specify the 
-    <code>--disable-v4-mapped</code> configure option and use specific Listen

-    directives like the following:</p>
-
-    <example>
-      Listen [::]:80<br />
-      Listen 0.0.0.0:80
-    </example>
-
-    <p>With <code>--disable-v4-mapped</code>, the Listen directives in
the 
-    default configuration file created by Apache will use this form.  
-    <code>--disable-v4-mapped</code> is the default on FreeBSD, NetBSD, and 
-    OpenBSD.</p>
-
+    <p>If your platform supports it and you want Apache to handle IPv4 and 
+    IPv6  connections on separate sockets (i.e., to disable IPv4-mapped 
+    addresses), specify the <code>--disable-v4-mapped</code> configure 
+    option. <code>--disable-v4-mapped</code> is the default on FreeBSD, 
+    NetBSD, and OpenBSD.</p>
   </section>
 
   <section id="virtualhost">
-- 
Colm MacCárthaigh                        Public Key: colm+pgp@stdlib.net
colm@stdlib.net					  http://www.stdlib.net/

----- End forwarded message -----

-- 
Colm MacCárthaigh                        Public Key: colm+pgp@stdlib.net
colm@stdlib.net					  http://www.stdlib.net/

---------------------------------------------------------------------
To unsubscribe, e-mail: docs-unsubscribe@httpd.apache.org
For additional commands, e-mail: docs-help@httpd.apache.org


Mime
View raw message