From: Mark Andrews <marka@isc.org>
Date: Sat, 17 Aug 2002 03:26:46 +0000 (+0000)
Subject: reviewed: marka
X-Git-Tag: v9.2.3rc1~104^2~371
X-Git-Url: http://git.ipfire.org/gitweb/?a=commitdiff_plain;h=ab5d8edc1bd391a1b306db68114fac303484b30f;p=thirdparty%2Fbind9.git

reviewed: marka
developer: jinmei
1362.   [func]          "localhost" and "localnet" acls now include IPv6
                        addresses / prefixes.
---

diff --git a/CHANGES b/CHANGES
index d7bd87e418b..b6651676140 100644
--- a/CHANGES
+++ b/CHANGES
@@ -1,3 +1,6 @@
+1362.	[func]		"localhost" and "localnet" acls now include IPv6
+			addresses / prefixes.
+
 1361.	[func]		Log file name when unable to open memory statistics
 			and dump database files. [RT# 3437]
 
diff --git a/doc/arm/Bv9ARM-book.xml b/doc/arm/Bv9ARM-book.xml
index af9be9e675a..8510c0cc899 100644
--- a/doc/arm/Bv9ARM-book.xml
+++ b/doc/arm/Bv9ARM-book.xml
@@ -2,7 +2,7 @@
 <!DOCTYPE book PUBLIC "-//OASIS//DTD DocBook XML V4.0//EN"
                "http://www.oasis-open.org/docbook/xml/4.0/docbookx.dtd">
 
-<!-- File: $Id: Bv9ARM-book.xml,v 1.204 2002/07/29 06:58:45 marka Exp $ -->
+<!-- File: $Id: Bv9ARM-book.xml,v 1.205 2002/08/17 03:26:46 marka Exp $ -->
 
 <book>
 <title>BIND 9 Administrator Reference Manual</title>
@@ -2221,25 +2221,17 @@ Usage</title>
 </row>
 <row rowsep = "0">
 <entry colname = "1"><para><command>localhost</command></para></entry>
-<entry colname = "2"><para>Matches the IPv4 addresses of all network
+<entry colname = "2"><para>Matches the IPv4 and IPv6 addresses of all network
 interfaces on the system.</para></entry>
 </row>
 <row rowsep = "0">
 <entry colname = "1"><para><command>localnets</command></para></entry>
-<entry colname = "2"><para>Matches any host on an IPv4 network for which
-the system has an interface.</para></entry>
+<entry colname = "2"><para>Matches any host on an IPv4 or IPv6 network
+for which the system has an interface.</para></entry>
 </row>
 </tbody>
 </tgroup></informaltable>
 
-<para>The <command>localhost</command> and <command>localnets</command>
-ACLs do not currently support IPv6 (that is,
-<command>localhost</command> does not match the host's IPv6 addresses,
-and <command>localnets</command> does not match the host's attached
-IPv6 networks) due to the lack of a standard method of determining the
-complete set of local IPv6 addresses for a host.
-</para>
-
 </sect2>
 <sect2>
       <title><command>controls</command> Statement Grammar</title>
@@ -3542,24 +3534,25 @@ listen-on port 1234 { !1.2.3.4; 1.2/16; };
 <para>If no <command>listen-on</command> is specified, the
 server will listen on port 53 on all interfaces.</para>
 
-<para>The <command>listen-on-v6</command> option is used to
-specify the ports on which the server will listen for incoming
-queries sent using IPv6.</para>
-
-<para>The server does not bind a separate socket to each IPv6
-interface address as it does for IPv4. Instead, it always
-listens on the IPv6 wildcard address. Therefore, the only
-values allowed for the <varname>address_match_list</varname>
-argument to the <command>listen-on-v6</command> statement are
-<programlisting>{ any; }</programlisting> and
-<programlisting>{ none;}</programlisting></para>
+<para>By default, the server does not bind a separate socket to each
+IPv6 interface address as it does for IPv4. Instead, it always
+listens on the IPv6 wildcard address.
+However, some particular IPv6 addresses can also be specified,
+in which case the server makes a separate socket for each specified
+address.</para>
 
-<para>Multiple <command>listen-on-v6</command> options can be
-used to listen on multiple ports:</para>
+<para>Multiple <command>listen-on-v6</command> options can be used.
+For example,</para>
 
-<programlisting>listen-on-v6 port 53 { any; };
-listen-on-v6 port 1234 { any; };
+<programlisting>listen-on-v6 { any; };
+listen-on-v6 port 1234 { !3ffe::/16; any; };
 </programlisting>
+
+<para>will enable the name server on port 53 for any IPv6 addresses
+(with a single wildcard socket),
+and on port 1234 of IPv6 addresses that is not in the prefix
+3ffe::/16 (with separate sockets for each matched address.)</para>
+
 <para>To make the server not listen on any IPv6 address, use</para>
 <programlisting>listen-on-v6 { none; };
 </programlisting>
@@ -5026,7 +5019,7 @@ Experimental.  Described in RFC 1183.</para></entry>
 <row rowsep = "0">
 <entry colname = "1"><para>APL</para></entry>
 <entry colname = "2"><para>address prefix list.  Experimental.
-Described in RFC 3123.<para></entry>
+Described in RFC 3123.</para></entry>
 </row>
 <row rowsep = "0">
 <entry colname = "1"><para>CERT</para></entry>