svn commit: r225543 - user/hrs/ipv6/share/man/man5

[Ben Kaduk]

On Tue, Sep 13, 2011 at 9:45 PM, Hiroki Sato <hrs at freebsd.org> wrote:
> Author: hrs
> Date: Wed Sep 14 01:45:12 2011
> New Revision: 225543
> URL: http://svn.freebsd.org/changeset/base/225543
>
> Modified: user/hrs/ipv6/share/man/man5/rc.conf.5
> ==============================================================================
> --- user/hrs/ipv6/share/man/man5/rc.conf.5      Wed Sep 14 00:40:00 2011        (r225542)
> +++ user/hrs/ipv6/share/man/man5/rc.conf.5      Wed Sep 14 01:45:12 2011        (r225543)
> @@ -1311,19 +1317,45 @@ If the variable is
>  the default address selection policy table set by
>  .Xr ip6addrctl 8
>  will be IPv4-preferred.
> -.Pp
> -This variable is deprecated.  Use
> -.Va ip6addrctl_policy
> -instead.
>  .It Va ipv6_activate_all_interfaces
> +.Pq Vt bool
> +This controls initial configuration on IPv6-capable
> +interfaces with no corresponding
> +.Va ifconfig_ Ns Ao Ar interface Ac Ns _ipv6
> +variable.
> +Note that it is not always necessary to set this variable to
> +.Dq YES
> +to use IPv6 functionality on
> +.Fx .
> +In most cases, just configuring
> +.Va ifconfig_ Ns Ao Ar interface Ac Ns _ipv6
> +variables works.
> +.Pp
>  If the variable is
>  .Dq Li NO ,
> -all of interfaces which do not have the corrsponding
> +all of interfaces which do not have the corresponding

s/of//; s/the/a/

>  .Va ifconfig_ Ns Ao Ar interface Ac Ns _ipv6
>  variable will be marked as
>  .Dq Li IFDISABLED
> -for security reason.  This means only IPv6 functionality on that interface
> -is completely disabled.  For more details of
> +when it becomes available for security reason.

"will be marked as IFDISABLED when it becomes available for security
reason" is very hard to parse.  Maybe "will be marked as IFDISABLED at
creation, enforcing a security policy"?

> +This means only IPv6 functionality on that interface
> +is completely disabled.

"All IPv6 functionality on that interface is completely disabled."

> +If the variable is set to
> +.Dq YES ,
> +the flag will be cleared on all of the interfaces.
> +.Pp
> +In most cases, just defining an
> +.Va ifconfig_ Ns Ao Ar interface Ac Ns _ipv6
> +for an IPv6-capable interface should be sufficient.
> +However, if an interface is added dynamically
> +.Pq by some tunneling protocols such as PPP, for example

I think a comma after "for example".

> +it is often difficult to define the variable in advance.
> +In such a case, configuring the

s/configuring/automatic setting of/

> +.Dq Li IFDISABLED
> +flag can be disabled by setting this variable to
> +.Dq YES .
> +.Pp
> +For more details of

s/$/the/

>  .Dq Li IFDISABLED
>  flag and keywords
>  .Dq Li inet6 ifdisabled ,
> @@ -1360,16 +1433,36 @@ ifconfig_ed0_ipv6="inet6 2001:db8:1::1 p
>  ifconfig_ed0_alias0="inet6 2001:db8:2::1 prefixlen 64"
>  .Ed
>  .Pp
> +Note that a link-local address will be automatically configured in
> +addition to the configured global-scope addresses because the IPv6
> +specifications require it on each link.
> +The address is calculated from the MAC address by using an algorithm
> +defined in
> +.Rs
> +.%T "RFC 4862"
> +.%O "Section 5.3"
> +.Re
> +.Pp
> +If only a link-local address is needed on the interface,
> +the following configuration can be used:
> +.Bd -literal
> +ifconfig_ed0_ipv6="inet6 auto_linklocal"
> +.Ed
> +.Pp
> +A link-local address can also be configured manually.
> +This is useful for the default router address of an IPv6 router
> +because it is not changed by replacing the network interface

I would say "so that it does not change when the network interface
card is replaced".

-Ben Kaduk


> +card, for example:
> +.Bd -literal
> +ifconfig_ed0_ipv6="inet6 fe80::1 prefixlen 64"
> +.Ed
> +.Pp
>  Interfaces that have an
>  .Dq Li inet6 accept_rtadv
>  keyword in
>  .Va ifconfig_ Ns Ao Ar interface Ac Ns _ipv6
>  setting will be automatically configured by
>  .Xr rtsol 8 .
> -Note that this automatic configuration is disabled if the
> -.Va ipv6_gateway_enable
> -is set to
> -.Dq Li YES .
>  .It Va ipv6_prefix_ Ns Aq Ar interface
>  .Pq Vt str
>  If one or more prefixes are defined in