misc/48307: Updating http://www.netbsd.org/docs/network/ipv6/

[sm+bsd%elandsys.com@localhost]

>Number:         48307
>Category:       misc
>Synopsis:       Updating http://www.netbsd.org/docs/network/ipv6/
>Confidential:   no
>Severity:       non-critical
>Priority:       low
>Responsible:    misc-bug-people
>State:          open
>Class:          change-request
>Submitter-Id:   net
>Arrival-Date:   Sun Oct 13 15:30:00 +0000 2013
>Originator:     S. Moonesamy
>Release:        not applicable
>Organization:
>Environment:
not applicable
>Description:
The page at http://www.netbsd.org/docs/network/ipv6/ could be updated as:

1. IPsec is now recommended instead of being mandatory (see RFC 6434)

2. Stateless host autoconfiguration is currently specified in RFC 4862.

3. DHCPv6 is specified in RFC3315

4. ip6.int has been deprecated (see RFC 4159).

5. 6bone prefixes are no longer valid since June 2006.

6. A6 now has a historic status.

7. The webring has been discontinued.
>How-To-Repeat:

>Fix:
--- docs/network/ipv6/index.xml.orig    2012-07-20 16:23:29.000000000 +0000
+++ docs/network/ipv6/index.xml 2013-10-13 08:00:04.000000000 +0000
@@ -34,7 +34,6 @@
        <listitem><ulink 
url="http://orange.kame.net/dev/cvsweb.cgi/kame/IMPLEMENTATION";>detailed 
information on the implementation</ulink></listitem>
        <listitem><ulink 
url="http://www.onlamp.com/pub/a/onlamp/2001/05/24/ipv6_tutorial.html";>Introduction
 to IPv6</ulink> by Hubert Feyrer</listitem>
        <listitem><ulink 
url="http://www.onlamp.com/pub/a/onlamp/2001/06/01/ipv6_tutorial.html";>Getting 
Connected with 6to4</ulink> by Hubert Feyrer</listitem>
-       <listitem>Some <ulink url="http://www.ipv6tools.com/";>IPv6 
tools</ulink> accessible through a web page.</listitem>
        </itemizedlist>
 
 </sect2>
@@ -106,13 +105,13 @@
        a DHCP server.
        With IPv6, a "stateless host autoconfiguration" mechanism is mandatory.
        This is much simpler to use and manage than IPv4 DHCP.
-       <!-- RFC -->RFC2462 has the specification for it.</listitem>
+       <!-- RFC -->RFC4862 has the specification for it.</listitem>
 
        <listitem><emphasis role="bold">Security</emphasis>.
        With IPv4, IPsec is optional and you need to ask the peer if it
        supports IPsec.
-       With IPv6, IPsec support is mandatory.
-       By mandating IPsec, we can assume that you can secure your IP
+       With IPv6, IPsec support is recommended.
+       By recommending IPsec, we can assume that you can secure your IP
        communication whenever you talk to IPv6 devices.</listitem>
 
        <listitem><emphasis role="bold">Friendly to traffic engineering 
technologies</emphasis>.
@@ -241,9 +240,9 @@
        <para>There are two separate mechanisms defined for IPv6 host 
autoconfiguration.
        One is called <emphasis>stateless address autoconfiguration</emphasis>,
        and is specified in <!-- RFC -->RFC2462.
-       The other is called <emphasis>DHCPv6</emphasis>, and is being discussed 
by the IETF dhc
-       working group.
-       NetBSD currently implements the former.</para>
+       The other is called <emphasis>DHCPv6</emphasis>, and is specified in 
+       <!-- RFC --> RFC3315.  DHCPv6 is discussed in the IETF dhc working 
group.
+       NetBSD currently implements the RFC2462.</para>
 
        <para>Stateless address configuration basically works as follows.
        We have two parties here: a host (which is to be autoconfigured) and a 
router
@@ -516,15 +515,14 @@
 
        <para>Note: If you have heard about A6 records and bitstring
        labels for DNS &ndash; A6 and bitstrings are now in
-       experimental status, so you don't need to worry about them. AAAA
+       historic status, so you don't need to worry about them. AAAA
        is to be used for production service and works
        fine.</para>
 
-       <para>Also note that the reverse DNS table is moving from
+       <para>Also note that the reverse DNS table has moved from
        <code>ip6.int</code> to <code>ip6.arpa</code>; 6Bone (3ffe)
-       addresses are at the time of this writing only known in ip6.int,
-       production addresses should be announced under ip6.arpa, as
-       ip6.int will go away.</para>
+       addresses are no longer used. Production addresses should be
+       announced under ip6.arpa.</para>
 
        </listitem>
        </orderedlist>
@@ -594,12 +592,6 @@
        encapsulated into IPv4 packets). The section talks about the
        latter case.</para>
 
-       <para>You can hook your machine up to experimental IPv6 network,
-       called <ulink url="http://www.6bone.net/";>"6bone"</ulink>. You
-       will need to talk with nearest 6bone site, to get your IPv6
-       address prefix. Note that you'll need to have a fixed IPv4
-       global address for this.</para>
-
        <para>If you do not have a fixed IPv4 global address (if you are
        using dialup ISP connection), don't panic. You can hook yourself
        up to <ulink url="http://www.freenet6.net/";>Freenet6</ulink>.
@@ -1172,11 +1164,9 @@
 <title> Where to ask questions</title>
 
        <para>If you have any questions, do not hesitate to ask on the
-       tech-net mailing list, or <ulink
-       url="http://www.ipv6.org/";>users%ipv6.org@localhost</ulink>. When you 
ask
-       about your configuration, be VERY sure to attach a network
-       diagram for your site. Without a network diagram, nobody can
-       guess your network configuration.</para>
+       tech-net mailing list. When you ask about your configuration, be
+        VERY sure to attach a network diagram for your site. Without a
+        network diagram, nobody can guess your network configuration.</para>
 
 </sect3>
 <sect3 id="maintenance">
@@ -1291,18 +1281,9 @@
 
 </sect3>
 
-<para>This <ulink url="http://www.ipv6.euronet.be/webring/";>IPv6
-Configuration Help</ulink> site is owned by <ulink url="/">The NetBSD
+<para>This IPv6 Configuration Help site is owned by <ulink url="/">The NetBSD
 Project</ulink>.</para>
 
-<para>
-[
-<ulink 
url="http://go.webring.yahoo.com/go?ring=ipv6&amp;id=3&amp;prev";>Previous</ulink>
 |
-<ulink 
url="http://go.webring.yahoo.com/go?ring=ipv6&amp;id=3&amp;next";>Next</ulink> |
-<ulink 
url="http://go.webring.yahoo.com/go?ring=ipv6&amp;id=3&amp;random";>Random 
Site</ulink> |
-<ulink url="http://nav.webring.yahoo.com/hub?ring=ipv6&amp;list";>List 
Sites</ulink>
-]
-</para>
 
 </sect2>
 </sect1>