From: Evan Hunt <each@isc.org>
Date: Sat, 3 Oct 2009 23:34:19 +0000 (+0000)
Subject: 2700.	[doc]		The match-mapped-addresses option is discouraged.
X-Git-Tag: v9.5.2-P1~1^5~25
X-Git-Url: http://git.ipfire.org/cgi-bin/gitweb.cgi?a=commitdiff_plain;h=54611c86b5c773eeef6eee80494e713aa12798b8;p=thirdparty%2Fbind9.git

2700.	[doc]		The match-mapped-addresses option is discouraged.
			[RT #12252]
---

diff --git a/CHANGES b/CHANGES
index 474d94b6e61..b598f12f911 100644
--- a/CHANGES
+++ b/CHANGES
@@ -1,3 +1,6 @@
+2700.	[doc]		The match-mapped-addresses option is discouraged.
+			[RT #12252]
+
 2698.   [cleanup]       configure --enable-libbind is deprecated. [RT #20090]
 
 2697.	[port]		win32: ensure that S_IFMT, S_IFDIR, S_IFCHR and
diff --git a/doc/arm/Bv9ARM-book.xml b/doc/arm/Bv9ARM-book.xml
index 47dc13fef39..6ec0fbf102e 100644
--- a/doc/arm/Bv9ARM-book.xml
+++ b/doc/arm/Bv9ARM-book.xml
@@ -35,7 +35,7 @@
  - PERFORMANCE OF THIS SOFTWARE.
 -->
 
-<!-- File: $Id: Bv9ARM-book.xml,v 1.340.24.43 2009/08/25 04:41:23 marka Exp $ -->
+<!-- File: $Id: Bv9ARM-book.xml,v 1.340.24.44 2009/10/03 23:34:19 each Exp $ -->
 <book xmlns:xi="http://www.w3.org/2001/XInclude">
   <title>BIND 9 Administrator Reference Manual</title>
 
@@ -5865,13 +5865,15 @@ options {
                   If <userinput>yes</userinput>, then an
                   IPv4-mapped IPv6 address will match any address match
                   list entries that match the corresponding IPv4 address.
-                  Enabling this option is sometimes useful on IPv6-enabled
-                  Linux
-                  systems, to work around a kernel quirk that causes IPv4
-                  TCP connections such as zone transfers to be accepted
-                  on an IPv6 socket using mapped addresses, causing
-                  address match lists designed for IPv4 to fail to match.
-                  The use of this option for any other purpose is discouraged.
+                </para>
+                <para>
+                  This option was introduced to work around a kernel quirk
+                  in some operating systems that causes IPv4 TCP
+                  connections, such as zone transfers, to be accepted on an
+                  IPv6 socket using mapped addresses.  This caused address
+                  match lists designed for IPv4 to fail to match.  However,
+                  <command>named</command> now solves this problem
+                  internally.  The use of this option is discouraged.
                 </para>
               </listitem>
             </varlistentry>