freebsd-dev/usr.sbin/prefix/prefix.8

.\"	$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.
.\"
.\" Redistribution and use in source and binary forms, with or without
.\" modification, are permitted provided that the following conditions
.\" are met:
.\" 1. Redistributions of source code must retain the above copyright
.\"    notice, this list of conditions and the following disclaimer.
.\" 2. Redistributions in binary form must reproduce the above copyright
.\"    notice, this list of conditions and the following disclaimer in the
.\"    documentation and/or other materials provided with the distribution.
.\" 3. Neither the name of the project nor the names of its contributors
.\"    may be used to endorse or promote products derived from this software
.\"    without specific prior written permission.
.\"
.\" THIS SOFTWARE IS PROVIDED BY THE PROJECT AND CONTRIBUTORS ``AS IS'' AND
.\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
.\" ARE DISCLAIMED.  IN NO EVENT SHALL THE PROJECT OR CONTRIBUTORS BE LIABLE
.\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
.\" SUCH DAMAGE.
.\"
.\"	$FreeBSD$
.\"
.Dd October 10, 1998
.Dt PREFIX 8
.Os
.Sh NAME
.Nm prefix
.Nd configure network interface prefixes
.Sh SYNOPSIS
.Nm
.Bk -words
.Ar interface prefix
.Ek
.Bk -words
.Op Cm set | delete
.Ek
.Sh DESCRIPTION
.Nm
is used to assign an prefix
to a network interface.
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
.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
.Fx 4.0
Sync with latest KAME's manpage of prefix(8). Obtained from: KAME MFC After: 1 week 2002-03-01 08:45:24 +00:00			`.\" $KAME: prefix.8,v 1.6 2001/02/04 05:20:48 jinmei Exp $`
			`.\"`
Getaddrinfo(), getnameinfo(), and etc support in libc/net. Several udp and raw apps IPv6 support. Reviewed by: freebsd-arch, cvs-committers Obtained from: KAME project 1999-12-28 02:37:14 +00:00			`.\" Copyright (C) 1995, 1996, 1997, and 1998 WIDE Project.`
			`.\" All rights reserved.`
Remove whitespace at EOL. 2001-07-15 08:06:20 +00:00			`.\"`
Getaddrinfo(), getnameinfo(), and etc support in libc/net. Several udp and raw apps IPv6 support. Reviewed by: freebsd-arch, cvs-committers Obtained from: KAME project 1999-12-28 02:37:14 +00:00			`.\" Redistribution and use in source and binary forms, with or without`
			`.\" modification, are permitted provided that the following conditions`
			`.\" are met:`
			`.\" 1. Redistributions of source code must retain the above copyright`
			`.\" notice, this list of conditions and the following disclaimer.`
			`.\" 2. Redistributions in binary form must reproduce the above copyright`
			`.\" notice, this list of conditions and the following disclaimer in the`
			`.\" documentation and/or other materials provided with the distribution.`
			`.\" 3. Neither the name of the project nor the names of its contributors`
			`.\" may be used to endorse or promote products derived from this software`
			`.\" without specific prior written permission.`
Remove whitespace at EOL. 2001-07-15 08:06:20 +00:00			`.\"`
Getaddrinfo(), getnameinfo(), and etc support in libc/net. Several udp and raw apps IPv6 support. Reviewed by: freebsd-arch, cvs-committers Obtained from: KAME project 1999-12-28 02:37:14 +00:00			.\" THIS SOFTWARE IS PROVIDED BY THE PROJECT AND CONTRIBUTORS ``AS IS'' AND
			`.\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE`
			`.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE`
			`.\" ARE DISCLAIMED. IN NO EVENT SHALL THE PROJECT OR CONTRIBUTORS BE LIABLE`
			`.\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL`
			`.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS`
			`.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)`
			`.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT`
			`.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY`
			`.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF`
			`.\" SUCH DAMAGE.`
			`.\"`
			`.\" $FreeBSD$`
			`.\"`
			`.Dd October 10, 1998`
			`.Dt PREFIX 8`
. clear `.Os' macro value since this tool is not KAME-only anymore . correctly use .Cm macro . don't use duplicated arguments for .Nm macro . use .Er macro for error names . correctly declare paper reference in SEE ALSO section . sort Xr's in SEE ALSO section . add integration note 2000-05-06 14:03:26 +00:00			`.Os`
Getaddrinfo(), getnameinfo(), and etc support in libc/net. Several udp and raw apps IPv6 support. Reviewed by: freebsd-arch, cvs-committers Obtained from: KAME project 1999-12-28 02:37:14 +00:00			`.Sh NAME`
			`.Nm prefix`
			`.Nd configure network interface prefixes`
			`.Sh SYNOPSIS`
mdoc(7) police: use the new features of the Nm macro. 2000-11-20 20:10:44 +00:00			`.Nm`
Sync with latest KAME Obtained from: KAME 2000-07-07 07:25:56 +00:00			`.Bk -words`
Getaddrinfo(), getnameinfo(), and etc support in libc/net. Several udp and raw apps IPv6 support. Reviewed by: freebsd-arch, cvs-committers Obtained from: KAME project 1999-12-28 02:37:14 +00:00			`.Ar interface prefix`
Sync with latest KAME's manpage of prefix(8). Obtained from: KAME MFC After: 1 week 2002-03-01 08:45:24 +00:00			`.Ek`
			`.Bk -words`
. clear `.Os' macro value since this tool is not KAME-only anymore . correctly use .Cm macro . don't use duplicated arguments for .Nm macro . use .Er macro for error names . correctly declare paper reference in SEE ALSO section . sort Xr's in SEE ALSO section . add integration note 2000-05-06 14:03:26 +00:00			`.Op Cm set \| delete`
Sync with latest KAME Obtained from: KAME 2000-07-07 07:25:56 +00:00			`.Ek`
Getaddrinfo(), getnameinfo(), and etc support in libc/net. Several udp and raw apps IPv6 support. Reviewed by: freebsd-arch, cvs-committers Obtained from: KAME project 1999-12-28 02:37:14 +00:00			`.Sh DESCRIPTION`
Sync with latest KAME Obtained from: KAME 2000-07-07 07:25:56 +00:00			`.Nm`
Getaddrinfo(), getnameinfo(), and etc support in libc/net. Several udp and raw apps IPv6 support. Reviewed by: freebsd-arch, cvs-committers Obtained from: KAME project 1999-12-28 02:37:14 +00:00			`is used to assign an prefix`
			`to a network interface.`
Sync with latest KAME's manpage of prefix(8). Obtained from: KAME MFC After: 1 week 2002-03-01 08:45:24 +00:00			`This command is currently just a frontend of`
			`.Xr ifconfig 8 ,`
			`and is not recommended to be used.`
Getaddrinfo(), getnameinfo(), and etc support in libc/net. Several udp and raw apps IPv6 support. Reviewed by: freebsd-arch, cvs-committers Obtained from: KAME project 1999-12-28 02:37:14 +00:00			`.Sh SEE ALSO`
			`.Xr netstat 1 ,`
			`.Xr netintro 4 ,`
. clear `.Os' macro value since this tool is not KAME-only anymore . correctly use .Cm macro . don't use duplicated arguments for .Nm macro . use .Er macro for error names . correctly declare paper reference in SEE ALSO section . sort Xr's in SEE ALSO section . add integration note 2000-05-06 14:03:26 +00:00			`.Xr ifconfig 8 ,`
Sync with latest KAME's manpage of prefix(8). Obtained from: KAME MFC After: 1 week 2002-03-01 08:45:24 +00:00			`.Xr rc 8`
Getaddrinfo(), getnameinfo(), and etc support in libc/net. Several udp and raw apps IPv6 support. Reviewed by: freebsd-arch, cvs-committers Obtained from: KAME project 1999-12-28 02:37:14 +00:00			`.Sh HISTORY`
			`The`
			`.Nm`
			`command first appeared in WIDE/KAME IPv6 protocol stack kit.`
Sync with latest KAME's manpage of prefix(8). Obtained from: KAME MFC After: 1 week 2002-03-01 08:45:24 +00:00			`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 .`
. clear `.Os' macro value since this tool is not KAME-only anymore . correctly use .Cm macro . don't use duplicated arguments for .Nm macro . use .Er macro for error names . correctly declare paper reference in SEE ALSO section . sort Xr's in SEE ALSO section . add integration note 2000-05-06 14:03:26 +00:00			`.Pp`
			`IPv6 and IPsec support based on the KAME Project (http://www.kame.net/) stack`
			`was initially integrated into`
			`.Fx 4.0`