1 .\" $KAME: ndp.8,v 1.28 2002/07/17 08:46:33 itojun Exp $
3 .\" Copyright (C) 1995, 1996, 1997, and 1998 WIDE Project.
4 .\" All rights reserved.
6 .\" Redistribution and use in source and binary forms, with or without
7 .\" modification, are permitted provided that the following conditions
9 .\" 1. Redistributions of source code must retain the above copyright
10 .\" notice, this list of conditions and the following disclaimer.
11 .\" 2. Redistributions in binary form must reproduce the above copyright
12 .\" notice, this list of conditions and the following disclaimer in the
13 .\" documentation and/or other materials provided with the distribution.
14 .\" 3. Neither the name of the project nor the names of its contributors
15 .\" may be used to endorse or promote products derived from this software
16 .\" without specific prior written permission.
18 .\" THIS SOFTWARE IS PROVIDED BY THE PROJECT AND CONTRIBUTORS ``AS IS'' AND
19 .\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
20 .\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
21 .\" ARE DISCLAIMED. IN NO EVENT SHALL THE PROJECT OR CONTRIBUTORS BE LIABLE
22 .\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
23 .\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
24 .\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
25 .\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
26 .\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
27 .\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
38 .Nd control/diagnose IPv6 neighbor discovery protocol
66 .Op Ar expressions ...
69 .Fl I Op Ar interface | Li delete
72 .Fl s Ar nodename etheraddr
79 utility manipulates the address mapping table
80 used by the Neighbor Discovery Protocol (NDP).
81 .Bl -tag -width indent
83 Dump the currently existing NDP entries.
84 The following information will be printed:
85 .Bl -tag -width "Neighbor"
87 IPv6 address of the neighbor.
89 Linklayer address of the neighbor.
92 when the address is not available.
94 Network interface associated with the neighbor cache entry.
96 The time until expiry of the entry.
97 The entry could become
99 in which case it will never expire.
101 State of the neighbor cache entry, as a single letter:
103 .Bl -tag -width indent -compact
119 Unknown state (should never happen).
122 Flags on the neighbor cache entry, in a single letter.
123 They are: Router, proxy neighbor advertisement
125 The field could be followed by a decimal number,
126 which means the number of NS probes the node has sent during the current state.
136 Erase all the NDP entries.
138 Delete specified NDP entry.
140 Parse the file specified by
143 Harmonize consistency between the routing table and the default router
144 list; install the top entry of the list into the kernel routing table.
146 Shows the default interface used as the default route when
147 there is no default router.
148 .It Fl I Ar interface
149 Specifies the default interface used as the default route when
150 there is no default router.
153 will be used as the default.
155 The current default interface will be deleted from the kernel.
156 .It Fl i Ar interface Op Ar expressions ...
157 View ND information for the specified interface.
158 If additional arguments
162 sets or clears the flags or variables for the interface as specified in
164 Each expression should be separated by white spaces or tab characters.
165 Possible expressions are as follows.
166 Some of the expressions can begin with the
169 which means the flag specified in the expression should be cleared.
176 .Bl -tag -width indent
178 Turn on or off NUD (Neighbor Unreachability Detection) on the
180 NUD is usually turned on by default.
182 Specify whether or not to accept Router Advertisement messages
186 .Va net.inet6.ip6.accept_rtadv
188 .It Ic auto_linklocal
189 Specify whether or not to perform automatic link-local address configuration
193 .Va net.inet6.ip6.auto_linklocal
196 Prefer addresses on the
198 as candidates of the source address for outgoing packets.
199 The default value of this flag is off.
200 For more details about the entire algorithm of source address
203 file supplied with the KAME kit.
205 Disable IPv6 operation on the interface.
206 When disabled, the interface discards any IPv6 packets
207 received on or being sent to the interface.
208 In the sending case, an error of ENETDOWN will be returned to the
210 This flag is typically set automatically in the kernel as a result of
211 a certain failure of Duplicate Address Detection.
212 If the auto_linklocal per-interface flag is set, automatic link-local
213 address configuration is performed again when this flag is cleared.
214 .It Ic basereachable Ns Li = Ns Pq Ar number
215 Specify the BaseReachbleTimer on the interface in millisecond.
216 .It Ic retrans Ns Li = Ns Pq Ar number
217 Specify the RetransTimer on the interface in millisecond.
218 .It Ic curhlim Ns Li = Ns Pq Ar number
219 Specify the Cur Hop Limit on the interface.
222 Do not try to resolve numeric addresses to hostnames.
226 Flush all the entries in the prefix list.
228 Show default router list.
230 Flush all the entries in the default router list.
232 Register an NDP entry for a node.
233 The entry will be permanent unless the word
235 is given in the command.
238 is given, this system will act as a proxy NDP server,
239 responding to requests for
241 even though the host address is not its own.
243 Print timestamp on each entry,
244 making it possible to merge output with
246 Most useful when used with
259 utility first appeared in the WIDE Hydrangea IPv6 protocol stack kit.
261 .Fl I Ar auto_linklocal
262 flag first appeared in