Bug 170223
| Summary: | IPv6 configuration section for 9.x is incorrect | ||
|---|---|---|---|
| Product: | Documentation | Reporter: | olivier |
| Component: | Books & Articles | Assignee: | Brad Davis <brd> |
| Status: | Closed FIXED | ||
| Severity: | Affects Only Me | ||
| Priority: | Normal | ||
| Version: | Latest | ||
| Hardware: | Any | ||
| OS: | Any | ||
|
Description
olivier
2012-07-27 22:50:06 UTC
Responsible Changed From-To: freebsd-doc->gjb Documenting IPv6 inconsistencies has been my headache recently... 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. 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 Back to the pool for now. I have not had time to make proper progress on this. Responsible Changed From-To: freebsd-docs->freebsd-doc Fix assignment. 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 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; 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; 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; 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; 8<replaceable>x</replaceable>, + <para>For &os; 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: open->feedback I have committed a fix, please test and let me know if it works now. Responsible Changed From-To: freebsd-doc->brd State Changed From-To: feedback->closed Timeout |
