From d98b25897dbc3fea0fc19d416aa4de57ce2417d2 Mon Sep 17 00:00:00 2001 From: ume Date: Fri, 1 Mar 2002 08:45:24 +0000 Subject: Sync with latest KAME's manpage of prefix(8). Obtained from: KAME MFC After: 1 week --- usr.sbin/prefix/prefix.8 | 177 +++++------------------------------------------ 1 file changed, 19 insertions(+), 158 deletions(-) (limited to 'usr.sbin/prefix') diff --git a/usr.sbin/prefix/prefix.8 b/usr.sbin/prefix/prefix.8 index 5cb42b2..b5b2e2f 100644 --- a/usr.sbin/prefix/prefix.8 +++ b/usr.sbin/prefix/prefix.8 @@ -1,3 +1,5 @@ +.\" $KAME: prefix.8,v 1.6 2001/02/04 05:20:48 jinmei Exp $ +.\" .\" Copyright (C) 1995, 1996, 1997, and 1998 WIDE Project. .\" All rights reserved. .\" @@ -25,7 +27,6 @@ .\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF .\" SUCH DAMAGE. .\" -.\" $Id: prefix.8,v 1.4 2000/05/31 17:00:08 itojun Exp $ .\" $FreeBSD$ .\" .Dd October 10, 1998 @@ -38,177 +39,37 @@ .Nm .Bk -words .Ar interface prefix -.Op Ar parameters +.Ek +.Bk -words .Op Cm set | delete -.Nm -.Ar interface -.Cm matchpr Ar match_prefix -.Cm mp_len Ar match_prefix_len -.Cm usepr Ar use_prefix -.Cm up_uselen Ar use_prefix_len -.Op Ar parameters -.Op Cm add | change | setglobal -.Nm -.Fl a -.Op Fl d -.Op Fl u -.Cm matchpr Ar match_prefix -.Cm mp_len Ar match_prefix_len -.Cm usepr Ar use_prefix -.Cm up_uselen Ar use_prefix_uselen -.Op Ar parameters -.Op Cm add | change | setglobal .Ek .Sh DESCRIPTION .Nm is used to assign an prefix -to a network interface and/or renumbering -network interface prefixes. -.Nm -must be used at boot time to define the network prefix -of each interface present on a machine; it may also be used at -a later time to renumbering multiple interface's prefixes -and other prefix related parameters. -.Nm -is router-only command, so you must do following to use it. -.Dl "sysctl net.inet6.ip6.forwarding=1" -If net.inet6.ip6.forwarding is set to 0, -.Nm -command fails by -.Er EPERM -error. -.Pp -The following options are available: -.Bl -tag -width indent -.It Ar interface -Specify an -.Ar interface -for which -.Ar prefix -is/are assigned or renumbered to. -This parameter is a string of the form -.Dq name unit , -for example, -.Dq en0 . -.It Ar prefix -Assign/Delete an -.Ar prefix to a network interface. -.It Cm prefixlen Ar len -Specify that -.Ar len -bits are reserved as identifier for IPv6 sub-networks in -.Ar prefix . -The -.Ar len -must be integer, and for syntactical reason it must be between 0 to 128. -It is almost always 64 under the current IPv6 assignment rule. -If the parameter is ommitted, 64 is used. -.It Cm matchpr Ar match_prefix -Specify -.Ar match_prefix -that is used for matching with preassigned prefixes to which -.Cm add | change | setglobal -command should be applied. -.It Cm mp_len Ar match_prefix_len -Specify the starting part of -.Ar match_prefix -to be used for matching with preassigned prefixes, as decimal bit number. -.It Cm mp_minlen Ar match_prefix_minlen -Specify the minimum length of prefixes which is allowed to be matched to -.Ar match_prefix , -as decimal bit number. -.Cm add | change | setglobal -is not applied to preassigned prefixes with smaller prefix len than -.Ar match_prefix_minlen . -.It Cm mp_maxlen Ar match_prefix_maxlen -Specify the maximum length of prefixes which is allowed to be matched to -.Ar match_prefix , -as decimal bit number. -.Cm add | change | setglobal -is not applied to preassigned prefixes with bigger prefix len than -.Ar match_prefix_maxlen . -.It Cm usepr Ar use_prefix -Specify -.Ar use_prefix -that is used for prefixes to be added on -.Cm add | change | setglobal -command. -.It Cm up_uselen Ar use_prefix_uselen -Specify the starting part of -.Ar use_prefix -copied to the starting part of prefixes to be added on -.Cm add | change | setglobal -command, as decimal bit number. -.It Cm up_keeplen Ar use_prefix_keeplen -Specify the midium part of -.Ar use_prefix -just next to the starting part specified by -.Ar use_prefix_uselen , -as decimal bit number. -Contiguous bits part in the same bit position of an existent prefix -matched with -.Ar match_prefix -is copied to the same bit position of prefixes to be added. -.It Cm pltime Ar time -Assign an -.Ar time -as prefix preferred life time for a prefix to be added. -Valid value for -.Ar time -is decimal seconds number or special format as "d00h00m00s00", -where 00 can take any decimal number, and "d" means days, "h" means hours, -"m" means minutes, "s" means seconds. And alternatively, special keyword -"infinity" can be also be specified. -.It Cm vltime Ar time -Assign an -.Ar time -as prefix valid life time for a prefix to be added. -Valid value for -.Ar time -is same as for -.Cm pltime . -.It Cm raf_auto -Enable the autonomous address auto configuration for the prefix to be -added. -.It Fl raf_auto -Disable the autonomous address auto configuration for the prefix to be -added. -.It Cm raf_onlink -Let the prefix to be added to have onlink nature for the assigned -interface. -.It Fl raf_onlink -Let the prefix to be added not to have onlink nature for the assigned -interface. -.It Cm rrf_decrprefd -Enable the decrementation of the pltime. -.It Fl rrf_decrprefd -Disable the decrementation of the pltime. -.It Cm rrf_decrvalid -Enable the decrementation of the vltime. -.It Fl rrf_decrvalid -Disable the decrementation of the vltime. -.El -.Sh DIAGNOSTICS -Messages indicating the specified interface does not exist, the -requested prefix is unknown, or the user is not privileged and -tried to alter an interface's configuration. +This command is currently just a frontend of +.Xr ifconfig 8 , +and is not recommended to be used. .Sh SEE ALSO .Xr netstat 1 , .Xr netintro 4 , .Xr ifconfig 8 , -.Xr rc 8 , -.Xr routed 8 -.Rs -.%A M. Crawford -.%T Router Renumbering for IPv6 -.%R internet-draft -.%N draft-ietf-ipngwg-router-renum-05.txt -.Re +.Xr rc 8 .Sh HISTORY The .Nm command first appeared in WIDE/KAME IPv6 protocol stack kit. +Previously, this command was used to manipulate prefixes separately +from interface identifiers, intending to be used for prefix +renumbering. +However, it had been known that the manipulation mechanism was not +friendly with traditional address management engine in the kernel. +Thus, the KAME developers decided to invalidate the prefix +manipulation mechanism, and to clarify the entire address/prefix +manipulation in February 2001. +Since then, this command has almost been obsoleted. +All users should now use +.Xr ifconfig 8 . .Pp IPv6 and IPsec support based on the KAME Project (http://www.kame.net/) stack was initially integrated into -- cgit v1.1