From nobody@FreeBSD.org  Fri Jul 27 21:41:14 2012
Return-Path: <nobody@FreeBSD.org>
Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:4f8:fff6::34])
	by hub.freebsd.org (Postfix) with ESMTP id 6FD55106564A
	for <freebsd-gnats-submit@FreeBSD.org>; Fri, 27 Jul 2012 21:41:14 +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 5AB848FC17
	for <freebsd-gnats-submit@FreeBSD.org>; Fri, 27 Jul 2012 21:41:14 +0000 (UTC)
Received: from red.freebsd.org (localhost [127.0.0.1])
	by red.freebsd.org (8.14.4/8.14.4) with ESMTP id q6RLfDv3085064
	for <freebsd-gnats-submit@FreeBSD.org>; Fri, 27 Jul 2012 21:41:13 GMT
	(envelope-from nobody@red.freebsd.org)
Received: (from nobody@localhost)
	by red.freebsd.org (8.14.4/8.14.4/Submit) id q6RLfDIc085060;
	Fri, 27 Jul 2012 21:41:13 GMT
	(envelope-from nobody)
Message-Id: <201207272141.q6RLfDIc085060@red.freebsd.org>
Date: Fri, 27 Jul 2012 21:41:13 GMT
From: Olivier Cochard-Labb <olivier@cochard.me>
To: freebsd-gnats-submit@FreeBSD.org
Subject: IPv6 configuration section for 9.x is incorrect
X-Send-Pr-Version: www-3.1
X-GNATS-Notify:

>Number:         170223
>Category:       docs
>Synopsis:       IPv6 configuration section for 9.x is incorrect
>Confidential:   no
>Severity:       non-critical
>Priority:       low
>Responsible:    brd
>State:          closed
>Quarter:        
>Keywords:       
>Date-Required:  
>Class:          doc-bug
>Submitter-Id:   current-users
>Arrival-Date:   Fri Jul 27 21:50:06 UTC 2012
>Closed-Date:    Tue Nov 12 17:53:21 UTC 2013
>Last-Modified:  Tue Nov 12 17:53:21 UTC 2013
>Originator:     Olivier Cochard-Labb
>Release:        9.1-prerelease
>Organization:
BSDRP
>Environment:
FreeBSD R1 9.1-PRERELEASE FreeBSD 9.1-PRERELEASE #0: Thu Jul 26 15:04:16 CEST 2012     root@orange.bsdrp.net:/usr/obj/BSDRP.amd64/usr/local/BSDRP/FreeBSD/src/sys/BSDRP-AMD64  amd64
>Description:
Hi,
the section "32.12.5.1 IPv6 Client Settings" of the handbook is wrong.

It says:

To have rtsol(8) autoconfigure your interface on boot on FreeBSD 9.x and later, add:
ipv6_prefer="YES"
to rc.conf.

=> This is totally wrong, if you put ipv6_prefer on a 9.x it will say:
"WARNING: $ipv6_prefer is obsolete.  Ignored."

A working method on a 9.0 is to configure the rc.conf like this:
ipv6_enable="YES"
ipv6_network_interfaces="em0"

A working method on a 9.1-prerelease is to configure the rc.conf like that:
ipv6_activate_all_interfaces="YES"
ifconfig_em0_ipv6="inet6 accept_rtadv"

(without the last line, the interface will not accept the rtadv: Then no global address neither default route).

Regards,
>How-To-Repeat:

>Fix:


>Release-Note:
>Audit-Trail:
Responsible-Changed-From-To: freebsd-doc->gjb 
Responsible-Changed-By: gjb 
Responsible-Changed-When: Fri Jul 27 22:44:40 UTC 2012 
Responsible-Changed-Why:  
Documenting IPv6 inconsistencies has been my headache recently... 


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

From: moggie <moggie@elasticmind.net>
To: bug-followup@FreeBSD.org
Cc:  
Subject: Re: docs/170223: IPv6 configuration section for 9.x is incorrect
Date: Tue, 31 Jul 2012 15:09:55 +0100

 Hi,
 
 Please also mention rtsold(8) in the IPv6 configuration documentation 
 and stress the importance of running it all the time on properly 
 configured networks. From what I understand, without rtsold(8), IPv6 
 clients will not automatically adapt to route advertisement changes 
 within the network.
 
 Thanks.

From: moggie <moggie@elasticmind.net>
To: bug-followup@FreeBSD.org
Cc:  
Subject: Re: docs/170223: IPv6 configuration section for 9.x is incorrect
Date: Tue, 31 Jul 2012 18:25:27 +0100

 Thinking about it, I realise that the roles rtsol(8) and rtsold(8) play 
 are different from what I originally understood. Meaning, rtsold(8) 
 should only be needed in situations where routers don't (for some 
 reason) automatically send route advertisement messages themselves. 
 Sorry for the misunderstanding and noise.
Responsible-Changed-From-To: gjb->freebsd-docs 
Responsible-Changed-By: gjb 
Responsible-Changed-When: Mon Sep 24 11:11:38 UTC 2012 
Responsible-Changed-Why:  
Back to the pool for now.  I have not had time to make proper progress 
on this. 


http://www.freebsd.org/cgi/query-pr.cgi?pr=170223 
Responsible-Changed-From-To: freebsd-docs->freebsd-doc 
Responsible-Changed-By: gjb 
Responsible-Changed-When: Mon Sep 24 11:14:23 UTC 2012 
Responsible-Changed-Why:  
Fix assignment. 


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

From: Davide Davini <davide.davini@trebigen.it>
To: bug-followup@FreeBSD.org, olivier@cochard.me
Cc:  
Subject: Re: docs/170223: IPv6 configuration section for 9.x is incorrect
Date: Fri, 01 Feb 2013 08:14:14 +0100

 Still no fix on the handbook documentation. That can be very annoying.
 I'm talking out of personal experience. Please fix it.
 
 -- 
 Distinti saluti,
 Davide Davini (Int: .99)
 
 Trebi Generalconsult srl - Tel: 02-581913.1 Fax: 02-58115059
State-Changed-From-To: open->feedback 
State-Changed-By: brd 
State-Changed-When: Tue Aug 27 09:33:27 UTC 2013 
State-Changed-Why:  
I have committed a fix, please test and let me know if it works now. 


Responsible-Changed-From-To: freebsd-doc->brd 
Responsible-Changed-By: brd 
Responsible-Changed-When: Tue Aug 27 09:33:27 UTC 2013 
Responsible-Changed-Why:  

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

From: dfilter@FreeBSD.ORG (dfilter service)
To: bug-followup@FreeBSD.org
Cc:  
Subject: Re: docs/170223: commit references a PR
Date: Tue, 27 Aug 2013 09:33:13 +0000 (UTC)

 Author: brd
 Date: Tue Aug 27 09:33:05 2013
 New Revision: 42590
 URL: http://svnweb.freebsd.org/changeset/doc/42590
 
 Log:
   - Fix IPv6 Setup instructions for the handbook [1]
   - Break the auto/static configure sections apart to make it easier to tell the difference
   - Add some replaceable tags
   - Switch to using the IPv6 doc prefix
   - Fix a few small typos
   
   PR:		170223 [1]
   Reviewed by:	bz@, gavin@
 
 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	Mon Aug 26 13:23:19 2013	(r42589)
 +++ head/en_US.ISO8859-1/books/handbook/advanced-networking/chapter.xml	Tue Aug 27 09:33:05 2013	(r42590)
 @@ -5319,29 +5319,38 @@ redirect_port tcp 192.168.0.3:80 80</pro
  	<filename>/etc/rc.conf</filename></title>
  
        <sect3>
 -	<title><acronym>IPv6</acronym> Client Settings</title>
 +	<title><acronym>IPv6</acronym> Client Auto-Configuration</title>
  
 -	<para>These settings configure a machine on a
 +	<para>To automatically configure a machine on a
  	  <acronym>LAN</acronym> which acts as a client, not a
 -	  router.  To instruct &man.rtsol.8; to autoconfigure the
 -	  interface on boot on
 -	  &os;&nbsp;9.<replaceable>x</replaceable> and later, add
 -	  this line to <filename>rc.conf</filename>:</para>
 -
 -	<programlisting>ipv6_prefer="YES"</programlisting>
 +	  router, two items are required.  First to enable the
 +	  <devicename>em0</devicename> to receive the router solicitation
 +	  messages, add this line to <filename>rc.conf</filename>:</para>
 +	
 +	<programlisting>ifconfig_<replaceable>em0</replaceable>_ipv6="inet6 accept_rtadv"</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>For &os;&nbsp;8.<replaceable>x</replaceable>,
  	  add:</para>
  
  	<programlisting>ipv6_enable="YES"</programlisting>
 +	  </sect3>
 +	  <sect3>
 +	    <title><acronym>IPv6</acronym> Client Static
 +	      Configuration</title>
  
  	<para>To statically assign the <acronym>IPv6</acronym>
  	  address, <hostid
 -	    role="ip6addr">2001:471:1f11:251:290:27ff:fee0:2093</hostid>,
 +	    role="ip6addr">2001:db8:4672:6565:2026:5043:2d42:5344</hostid>,
  	  to <devicename>fxp0</devicename>, add the following for
  	  &os;&nbsp;9.<replaceable>x</replaceable>:</para>
  
 -	<programlisting>ifconfig_fxp0_ipv6="inet6 2001:471:1f11:251:290:27ff:fee0:2093 prefixlen <replaceable>64</replaceable>"</programlisting>
 +	<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
 @@ -5349,16 +5358,16 @@ redirect_port tcp 192.168.0.3:80 80</pro
  	    subnet.</para>
  	</note>
  
 -	<para>For &os;&nbsp;8<replaceable>x</replaceable>,
 +	<para>For &os;&nbsp;8.<replaceable>x</replaceable>,
  	  add:</para>
  
 -	<programlisting>ipv6_ifconfig_fxp0="2001:471:1f11:251:290:27ff:fee0:2093"</programlisting>
 +	<programlisting>ipv6_ifconfig_<replaceable>fxp0</replaceable>="2001:db8:4672:6565:2026:5043:2d42:5344"</programlisting>
  
  	<para>To assign a default router of <hostid
 -	    role="ip6addr">2001:471:1f11:251::1</hostid>, add the
 +	    role="ip6addr">2001:db8:4672:6565::1</hostid>, add the
  	  following to <filename>/etc/rc.conf</filename>:</para>
  
 -	<programlisting>ipv6_defaultrouter="2001:471:1f11:251::1"</programlisting>
 +	<programlisting>ipv6_defaultrouter="2001:db8:4672:6565::1"</programlisting>
        </sect3>
  
        <sect3>
 @@ -5372,9 +5381,9 @@ redirect_port tcp 192.168.0.3:80 80</pro
  
  	<para>The first entry lists the generic tunneling interfaces
  	  to be configured.  This example configures one interface,
 -	  <devicename>gif0</devicename>:</para>
 +	  <devicename>gif<replaceable>0</replaceable></devicename>:</para>
  
 -	<programlisting>gif_interfaces="gif0"</programlisting>
 +	<programlisting>gif_interfaces="gif<replaceable>0</replaceable>"</programlisting>
  
  	<para>To configure that interface with a local endpoint of
  	  <replaceable>MY_IPv4_ADDR</replaceable> to a remote endpoint
 _______________________________________________
 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"
 
State-Changed-From-To: feedback->closed 
State-Changed-By: brd 
State-Changed-When: Tue Nov 12 17:53:10 UTC 2013 
State-Changed-Why:  
Timeout 

http://www.freebsd.org/cgi/query-pr.cgi?pr=170223 
>Unformatted:
