Bug 172743

Summary: IPv6 handbooks lacks info about accepting router advertisements
Product: Documentation Reporter: Wade Duvall <wsduvall>
Component: Books & ArticlesAssignee: Dru Lavigne <dru>
Status: Closed FIXED    
Severity: Affects Only Me    
Priority: Normal    
Version: Latest   
Hardware: Any   
OS: Any   

Description Wade Duvall 2012-10-16 02:10:00 UTC
The IPv6 handbook page (found here http://www.freebsd.org/doc/handbook/network-ipv6.html) explains how to set up a static ipv6 addr, but not how to accept router advertisements. It should contain something to the effect of:

ifconfig_$if_ipv6="accept_rtadv" is used to enable IPv6 router advertisements.

Fix: 

Add ifconfig_$if_ipv6="accept_rtadv" and a bit about accepting router advertisements to the docs
How-To-Repeat: Boot up a fresh 9.0-RELEASE on an IPv6 enabled network with SLAAC and follow instruction on IPv6 handbook page. Observe yourself getting no IPv6
Comment 1 dfilter service freebsd_committer freebsd_triage 2014-03-07 17:10:51 UTC
Author: dru
Date: Fri Mar  7 17:10:44 2014
New Revision: 44179
URL: http://svnweb.freebsd.org/changeset/doc/44179

Log:
  Edits needed to close PR.
  
  PR: 172743
  Sponsored by: iXsystems

Modified:
  head/en_US.ISO8859-1/books/handbook/advanced-networking/chapter.xml

Modified: head/en_US.ISO8859-1/books/handbook/advanced-networking/chapter.xml
==============================================================================
--- head/en_US.ISO8859-1/books/handbook/advanced-networking/chapter.xml	Fri Mar  7 16:53:34 2014	(r44178)
+++ head/en_US.ISO8859-1/books/handbook/advanced-networking/chapter.xml	Fri Mar  7 17:10:44 2014	(r44179)
@@ -4557,50 +4557,36 @@ Received 264951 bytes in 0.1 seconds</sc
 	</listitem>
       </itemizedlist>
 
-	<para>To automatically configure a machine on a
-	  <acronym>LAN</acronym> which acts as a client, not a
-	  router, two items are required.  First to enable the
-	  <filename>em0</filename> to receive the router
-	  solicitation messages, add this line to
+	<para>To configure a &os; system as an
+	  <acronym>IPv6</acronym> client, add these two lines to
 	  <filename>rc.conf</filename>:</para>
 
-	<programlisting>ifconfig_<replaceable>em0</replaceable>_ipv6="inet6 accept_rtadv"</programlisting>
+	<programlisting>ifconfig_<replaceable>em0</replaceable>_ipv6="inet6 accept_rtadv"
+rtsold_enable="YES"</programlisting>
 
-	<para>Secondly, the router solicitation daemon, &man.rtsol.8;,
-	  should be enabled by adding the following to
-	  <filename>rc.conf</filename>:</para>
-
-	<programlisting>rtsold_enable="YES"</programlisting>
+	<para>The first line enables the specified interface to receive
+	  router solicitation messages.  The second line enables the
+	  router solicitation daemon, &man.rtsol.8;.</para>
 
 	<para>For &os;&nbsp;8.<replaceable>x</replaceable>,
-	  add:</para>
+	  add a third line:</para>
 
 	<programlisting>ipv6_enable="YES"</programlisting>
 
-	<para>To statically assign the <acronym>IPv6</acronym>
-	  address,
-	  <systemitem>2001:db8:4672:6565:2026:5043:2d42:5344</systemitem>,
-	  to <filename>fxp0</filename>, add the following for
-	  &os;&nbsp;9.<replaceable>x</replaceable>:</para>
-
-	<programlisting>ifconfig_<replaceable>fxp0</replaceable>_ipv6="inet6 2001:db8:4672:6565:2026:5043:2d42:5344 prefixlen 64"</programlisting>
-
-	<note>
-	  <para>Be sure to change <replaceable>prefixlen
-	      64</replaceable> to the appropriate value for the
-	    subnet.</para>
-	</note>
+	<para>If the interface needs a statically assigned <acronym>IPv6</acronym>
+	  address, add an entry to specify the static address and
+	  associated prefix length:</para>
 
-	<para>For &os;&nbsp;8.<replaceable>x</replaceable>,
-	  add:</para>
+	<programlisting>ifconfig_<replaceable>fxp0</replaceable>_ipv6="inet6 <replaceable>2001:db8:4672:6565:2026:5043:2d42:5344</replaceable> prefixlen <replaceable>64</replaceable>"</programlisting>
+
+	<para>On a &os;&nbsp;8.<replaceable>x</replaceable> system,
+	  that line uses this format instead:</para>
 
-	<programlisting>ipv6_ifconfig_<replaceable>fxp0</replaceable>="2001:db8:4672:6565:2026:5043:2d42:5344"</programlisting>
+	<programlisting>ipv6_ifconfig_<replaceable>fxp0</replaceable>="<replaceable>2001:db8:4672:6565:2026:5043:2d42:5344</replaceable>"</programlisting>
 
-	<para>To assign a default router of
-	  <systemitem>2001:db8:4672:6565::1</systemitem>, add the
-	  following to <filename>/etc/rc.conf</filename>:</para>
+	<para>To assign a default router, specify its address:</para>
 
-	<programlisting>ipv6_defaultrouter="2001:db8:4672:6565::1"</programlisting>
+	<programlisting>ipv6_defaultrouter="<replaceable>2001:db8:4672:6565::1</replaceable>"</programlisting>
       </sect2>
 
       <sect2>
_______________________________________________
svn-doc-all@freebsd.org mailing list
http://lists.freebsd.org/mailman/listinfo/svn-doc-all
To unsubscribe, send any mail to "svn-doc-all-unsubscribe@freebsd.org"
Comment 2 Dru Lavigne freebsd_committer freebsd_triage 2014-03-07 17:11:07 UTC
Responsible Changed
From-To: freebsd-doc->dru

I'll take this one.
Comment 3 Dru Lavigne freebsd_committer freebsd_triage 2014-03-07 17:11:32 UTC
State Changed
From-To: open->closed

This should be much clearer in r44179.