From nobody@FreeBSD.org  Tue Oct 16 01:08:33 2012
Return-Path: <nobody@FreeBSD.org>
Received: from mx1.freebsd.org (mx1.freebsd.org [69.147.83.52])
	by hub.freebsd.org (Postfix) with ESMTP id CCEE9FD8
	for <freebsd-gnats-submit@FreeBSD.org>; Tue, 16 Oct 2012 01:08:33 +0000 (UTC)
	(envelope-from nobody@FreeBSD.org)
Received: from red.freebsd.org (red.freebsd.org [IPv6:2001:4f8:fff6::22])
	by mx1.freebsd.org (Postfix) with ESMTP id B2F338FC0A
	for <freebsd-gnats-submit@FreeBSD.org>; Tue, 16 Oct 2012 01:08:33 +0000 (UTC)
Received: from red.freebsd.org (localhost [127.0.0.1])
	by red.freebsd.org (8.14.5/8.14.5) with ESMTP id q9G18XpS062358
	for <freebsd-gnats-submit@FreeBSD.org>; Tue, 16 Oct 2012 01:08:33 GMT
	(envelope-from nobody@red.freebsd.org)
Received: (from nobody@localhost)
	by red.freebsd.org (8.14.5/8.14.5/Submit) id q9G18Xgs062357;
	Tue, 16 Oct 2012 01:08:33 GMT
	(envelope-from nobody)
Message-Id: <201210160108.q9G18Xgs062357@red.freebsd.org>
Date: Tue, 16 Oct 2012 01:08:33 GMT
From: Wade Duvall <wsduvall@jlab.org>
To: freebsd-gnats-submit@FreeBSD.org
Subject: IPv6 handbooks lacks info about accepting router advertisements
X-Send-Pr-Version: www-3.1
X-GNATS-Notify:

>Number:         172743
>Category:       docs
>Synopsis:       IPv6 handbooks lacks info about accepting router advertisements
>Confidential:   no
>Severity:       non-critical
>Priority:       low
>Responsible:    dru
>State:          closed
>Quarter:        
>Keywords:       
>Date-Required:  
>Class:          doc-bug
>Submitter-Id:   current-users
>Arrival-Date:   Tue Oct 16 01:10:00 UTC 2012
>Closed-Date:    Fri Mar 07 17:12:29 UTC 2014
>Last-Modified:  Fri Mar  7 17:20:00 UTC 2014
>Originator:     Wade Duvall
>Release:        9.0-RELEASE
>Organization:
>Environment:
FreeBSD <hostname redacted> 9.0-RELEASE FreeBSD 9.0-RELEASE #0: Tue Oct 16 16:15:22 EDT 2012     <hostname redacted>:/usr/obj/usr/src/sys/GENERIC  amd64

>Description:
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.
>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
>Fix:
Add ifconfig_$if_ipv6="accept_rtadv" and a bit about accepting router advertisements to the docs

>Release-Note:
>Audit-Trail:
Responsible-Changed-From-To: freebsd-doc->dru 
Responsible-Changed-By: dru 
Responsible-Changed-When: Fri Mar 7 17:11:07 UTC 2014 
Responsible-Changed-Why:  
I'll take this one. 

http://www.freebsd.org/cgi/query-pr.cgi?pr=172743 
State-Changed-From-To: open->closed 
State-Changed-By: dru 
State-Changed-When: Fri Mar 7 17:11:32 UTC 2014 
State-Changed-Why:  
This should be much clearer in r44179. 

http://www.freebsd.org/cgi/query-pr.cgi?pr=172743 

From: dfilter@FreeBSD.ORG (dfilter service)
To: bug-followup@FreeBSD.org
Cc:  
Subject: Re: docs/172743: commit references a PR
Date: Fri,  7 Mar 2014 17:10:51 +0000 (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"
 
>Unformatted:
