1 .\" Copyright (C) 1995, 1996, 1997, and 1998 WIDE Project.
2 .\" All rights reserved.
4 .\" Redistribution and use in source and binary forms, with or without
5 .\" modification, are permitted provided that the following conditions
7 .\" 1. Redistributions of source code must retain the above copyright
8 .\" notice, this list of conditions and the following disclaimer.
9 .\" 2. Redistributions in binary form must reproduce the above copyright
10 .\" notice, this list of conditions and the following disclaimer in the
11 .\" documentation and/or other materials provided with the distribution.
12 .\" 3. Neither the name of the project nor the names of its contributors
13 .\" may be used to endorse or promote products derived from this software
14 .\" without specific prior written permission.
16 .\" THIS SOFTWARE IS PROVIDED BY THE PROJECT AND CONTRIBUTORS ``AS IS'' AND
17 .\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
18 .\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
19 .\" ARE DISCLAIMED. IN NO EVENT SHALL THE PROJECT OR CONTRIBUTORS BE LIABLE
20 .\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
21 .\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
22 .\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
23 .\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
24 .\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
25 .\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
28 .\" $Id: prefix.8,v 1.4 2000/05/31 17:00:08 itojun Exp $
36 .Nd configure network interface prefixes
45 .Cm matchpr Ar match_prefix
46 .Cm mp_len Ar match_prefix_len
47 .Cm usepr Ar use_prefix
48 .Cm up_uselen Ar use_prefix_len
50 .Op Cm add | change | setglobal
55 .Cm matchpr Ar match_prefix
56 .Cm mp_len Ar match_prefix_len
57 .Cm usepr Ar use_prefix
58 .Cm up_uselen Ar use_prefix_uselen
60 .Op Cm add | change | setglobal
64 is used to assign an prefix
65 to a network interface and/or renumbering
66 network interface prefixes.
68 must be used at boot time to define the network prefix
69 of each interface present on a machine; it may also be used at
70 a later time to renumbering multiple interface's prefixes
71 and other prefix related parameters.
73 is router-only command, so you must do following to use it.
74 .Dl % sysctl -w net.inet6.ip6.forwarding=1
75 If net.inet6.ip6.forwarding is set to 0,
81 The following options are available:
82 .Bl -tag -width indent
88 is/are assigned or renumbered to.
89 This parameter is a string of the form
96 to a network interface.
97 .It Cm prefixlen Ar len
100 bits are reserved as identifier for IPv6 sub-networks in
104 must be integer, and for syntactical reason it must be between 0 to 128.
105 It is almost always 64 under the current IPv6 assignment rule.
106 If the parameter is ommitted, 64 is used.
107 .It Cm matchpr Ar match_prefix
110 that is used for matching with preassigned prefixes to which
111 .Cm add | change | setglobal
112 command should be applied.
113 .It Cm mp_len Ar match_prefix_len
114 Specify the starting part of
116 to be used for matching with preassigned prefixes, as decimal bit number.
117 .It Cm mp_minlen Ar match_prefix_minlen
118 Specify the minimum length of prefixes which is allowed to be matched to
120 as decimal bit number.
121 .Cm add | change | setglobal
122 is not applied to preassigned prefixes with smaller prefix len than
123 .Ar match_prefix_minlen .
124 .It Cm mp_maxlen Ar match_prefix_maxlen
125 Specify the maximum length of prefixes which is allowed to be matched to
127 as decimal bit number.
128 .Cm add | change | setglobal
129 is not applied to preassigned prefixes with bigger prefix len than
130 .Ar match_prefix_maxlen .
131 .It Cm usepr Ar use_prefix
134 that is used for prefixes to be added on
135 .Cm add | change | setglobal
137 .It Cm up_uselen Ar use_prefix_uselen
138 Specify the starting part of
140 copied to the starting part of prefixes to be added on
141 .Cm add | change | setglobal
142 command, as decimal bit number.
143 .It Cm up_keeplen Ar use_prefix_keeplen
144 Specify the midium part of
146 just next to the starting part specified by
147 .Ar use_prefix_uselen
148 , as decimal bit number.
149 Contiguous bits part in the same bit position of an existent prefix
152 is copied to the same bit position of prefixes to be added.
153 .It Cm pltime Ar time
156 as prefix preferred life time for a prefix to be added.
159 is decimal seconds number or special format as "d00h00m00s00",
160 where 00 can take any decimal number, and "d" means days, "h" means hours,
161 "m" means minutes, "s" means seconds. And alternatively, special keyword
162 "infinity" can be also be specified.
163 .It Cm vltime Ar time
166 as prefix valid life time for a prefix to be added.
172 Enable the autonomous address auto configuration for the prefix to be
175 Disable the autonomous address auto configuration for the prefix to be
178 Let the prefix to be added to have onlink nature for the assigned
181 Let the prefix to be added not to have onlink nature for the assigned
184 Enable the decrementation of the pltime.
186 Disable the decrementation of the pltime.
188 Enable the decrementation of the vltime.
190 Disable the decrementation of the vltime.
193 Messages indicating the specified interface does not exist, the
194 requested prefix is unknown, or the user is not privileged and
195 tried to alter an interface's configuration.
204 .%T Router Renumbering for IPv6
206 .%N draft-ietf-ipngwg-router-renum-05.txt
211 command first appeared in WIDE/KAME IPv6 protocol stack kit.
213 IPv6 and IPsec support based on the KAME Project (http://www.kame.net/) stack
214 was initially integrated into