a283298ce3
automatic link-local address configuration: - Convert a sysctl net.inet6.ip6.accept_rtadv to one for the default value of a per-IF flag ND6_IFF_ACCEPT_RTADV, not a global knob. The default value of the sysctl is 0. - Add a new per-IF flag ND6_IFF_AUTO_LINKLOCAL and convert a sysctl net.inet6.ip6.auto_linklocal to one for its default value. The default value of the sysctl is 1. - Make ND6_IFF_IFDISABLED more robust. It can be used to disable IPv6 functionality of an interface now. - Receiving RA is allowed if ip6_forwarding==0 *and* ND6_IFF_ACCEPT_RTADV is set on that interface. The former condition will be revisited later to support a "host + router" box like IPv6 CPE router. The current behavior is compatible with the older releases of FreeBSD. - The ifconfig(8) now supports these ND6 flags as well as "nud", "prefer_source", and "disabled" in ndp(8). The ndp(8) now supports "auto_linklocal". Discussed with: bz and jinmei Reviewed by: bz MFC after: 3 days
267 lines
6.9 KiB
Groff
267 lines
6.9 KiB
Groff
.\" $KAME: ndp.8,v 1.28 2002/07/17 08:46:33 itojun 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 September 2, 2009
|
|
.Dt NDP 8
|
|
.Os
|
|
.\"
|
|
.Sh NAME
|
|
.Nm ndp
|
|
.Nd control/diagnose IPv6 neighbor discovery protocol
|
|
.\"
|
|
.Sh SYNOPSIS
|
|
.Nm
|
|
.Op Fl nt
|
|
.Ar hostname
|
|
.Nm
|
|
.Op Fl nt
|
|
.Fl a | c | p
|
|
.Nm
|
|
.Op Fl nt
|
|
.Fl r
|
|
.Nm
|
|
.Op Fl nt
|
|
.Fl H | P | R
|
|
.Nm
|
|
.Op Fl nt
|
|
.Fl A Ar wait
|
|
.Nm
|
|
.Op Fl nt
|
|
.Fl d Ar hostname
|
|
.Nm
|
|
.Op Fl nt
|
|
.Fl f Ar filename
|
|
.Nm
|
|
.Op Fl nt
|
|
.Fl i
|
|
.Ar interface
|
|
.Op Ar expressions ...
|
|
.Nm
|
|
.Op Fl nt
|
|
.Fl I Op Ar interface | Li delete
|
|
.Nm
|
|
.Op Fl nt
|
|
.Fl s Ar nodename etheraddr
|
|
.Op Li temp
|
|
.Op Li proxy
|
|
.\"
|
|
.Sh DESCRIPTION
|
|
The
|
|
.Nm
|
|
utility manipulates the address mapping table
|
|
used by the Neighbor Discovery Protocol (NDP).
|
|
.Bl -tag -width indent
|
|
.It Fl a
|
|
Dump the currently existing NDP entries.
|
|
The following information will be printed:
|
|
.Bl -tag -width "Neighbor"
|
|
.It Neighbor
|
|
IPv6 address of the neighbor.
|
|
.It Linklayer Address
|
|
Linklayer address of the neighbor.
|
|
It could be
|
|
.Dq Li (incomplete)
|
|
when the address is not available.
|
|
.It Netif
|
|
Network interface associated with the neighbor cache entry.
|
|
.It Expire
|
|
The time until expiry of the entry.
|
|
The entry could become
|
|
.Dq Li permanent ,
|
|
in which case it will never expire.
|
|
.It S
|
|
State of the neighbor cache entry, as a single letter:
|
|
.Pp
|
|
.Bl -tag -width indent -compact
|
|
.It N
|
|
Nostate
|
|
.It W
|
|
Waitdelete
|
|
.It I
|
|
Incomplete
|
|
.It R
|
|
Reachable
|
|
.It S
|
|
Stale
|
|
.It D
|
|
Delay
|
|
.It P
|
|
Probe
|
|
.It ?\&
|
|
Unknown state (should never happen).
|
|
.El
|
|
.It Flags
|
|
Flags on the neighbor cache entry, in a single letter.
|
|
They are: Router, proxy neighbor advertisement
|
|
.Pq Dq p .
|
|
The field could be followed by a decimal number,
|
|
which means the number of NS probes the node has sent during the current state.
|
|
.El
|
|
.It Fl A Ar wait
|
|
Repeat
|
|
.Fl a
|
|
(dump NDP entries)
|
|
every
|
|
.Ar wait
|
|
seconds.
|
|
.It Fl c
|
|
Erase all the NDP entries.
|
|
.It Fl d
|
|
Delete specified NDP entry.
|
|
.It Fl f
|
|
Parse the file specified by
|
|
.Ar filename .
|
|
.It Fl H
|
|
Harmonize consistency between the routing table and the default router
|
|
list; install the top entry of the list into the kernel routing table.
|
|
.It Fl I
|
|
Shows the default interface used as the default route when
|
|
there is no default router.
|
|
.It Fl I Ar interface
|
|
Specifies the default interface used as the default route when
|
|
there is no default router.
|
|
The
|
|
.Ar interface
|
|
will be used as the default.
|
|
.It Fl I Li delete
|
|
The current default interface will be deleted from the kernel.
|
|
.It Fl i Ar interface Op Ar expressions ...
|
|
View ND information for the specified interface.
|
|
If additional arguments
|
|
.Ar expressions
|
|
are given,
|
|
.Nm
|
|
sets or clears the flags or variables for the interface as specified in
|
|
the expression.
|
|
Each expression should be separated by white spaces or tab characters.
|
|
Possible expressions are as follows.
|
|
Some of the expressions can begin with the
|
|
special character
|
|
.Ql - ,
|
|
which means the flag specified in the expression should be cleared.
|
|
Note that you need
|
|
.Fl -
|
|
before
|
|
.Fl foo
|
|
in this case.
|
|
.\"
|
|
.Bl -tag -width indent
|
|
.It Ic nud
|
|
Turn on or off NUD (Neighbor Unreachability Detection) on the
|
|
interface.
|
|
NUD is usually turned on by default.
|
|
.It Ic accept_rtadv
|
|
Specify whether or not to accept Router Advertisement messages
|
|
received on the
|
|
.Ar interface .
|
|
This flag is set by
|
|
.Va net.inet6.ip6.accept_rtadv
|
|
sysctl variable.
|
|
.It Ic auto_linklocal
|
|
Specify whether or not to perform automatic link-local address configuration
|
|
on
|
|
.Ar interface .
|
|
This flag is set by
|
|
.Va net.inet6.ip6.auto_linklocal
|
|
sysctl variable.
|
|
.It Ic prefer_source
|
|
Prefer addresses on the
|
|
.Ar interface
|
|
as candidates of the source address for outgoing packets.
|
|
The default value of this flag is off.
|
|
For more details about the entire algorithm of source address
|
|
selection, see the
|
|
.Pa IMPLEMENTATION
|
|
file supplied with the KAME kit.
|
|
.It Ic disabled
|
|
Disable IPv6 operation on the interface.
|
|
When disabled, the interface discards any IPv6 packets
|
|
received on or being sent to the interface.
|
|
In the sending case, an error of ENETDOWN will be returned to the
|
|
application.
|
|
This flag is typically set automatically in the kernel as a result of
|
|
a certain failure of Duplicate Address Detection.
|
|
If the auto_linklocal per-interface flag is set, automatic link-local
|
|
address configuration is performed again when this flag is cleared.
|
|
.It Ic basereachable Ns Li = Ns Pq Ar number
|
|
Specify the BaseReachbleTimer on the interface in millisecond.
|
|
.It Ic retrans Ns Li = Ns Pq Ar number
|
|
Specify the RetransTimer on the interface in millisecond.
|
|
.It Ic curhlim Ns Li = Ns Pq Ar number
|
|
Specify the Cur Hop Limit on the interface.
|
|
.El
|
|
.It Fl n
|
|
Do not try to resolve numeric addresses to hostnames.
|
|
.It Fl p
|
|
Show prefix list.
|
|
.It Fl P
|
|
Flush all the entries in the prefix list.
|
|
.It Fl r
|
|
Show default router list.
|
|
.It Fl R
|
|
Flush all the entries in the default router list.
|
|
.It Fl s
|
|
Register an NDP entry for a node.
|
|
The entry will be permanent unless the word
|
|
.Li temp
|
|
is given in the command.
|
|
If the word
|
|
.Li proxy
|
|
is given, this system will act as a proxy NDP server,
|
|
responding to requests for
|
|
.Ar hostname
|
|
even though the host address is not its own.
|
|
.It Fl t
|
|
Print timestamp on each entry,
|
|
making it possible to merge output with
|
|
.Xr tcpdump 1 .
|
|
Most useful when used with
|
|
.Fl A .
|
|
.El
|
|
.\"
|
|
.Sh EXIT STATUS
|
|
.Ex -std
|
|
.\"
|
|
.Sh SEE ALSO
|
|
.Xr arp 8
|
|
.\"
|
|
.Sh HISTORY
|
|
The
|
|
.Nm
|
|
utility first appeared in the WIDE Hydrangea IPv6 protocol stack kit.
|
|
The
|
|
.Fl I Ar auto_linklocal
|
|
flag first appeared in
|
|
.Fx 8.0 .
|
|
.\"
|
|
.\" .Sh BUGS
|
|
.\" (to be written)
|