1 .\" $KAME: traceroute6.8,v 1.10 2004/06/06 12:35:15 suz 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 "print the route IPv6 packets will take to a network node"
81 uses the IPv6 protocol hop limit field to elicit an ICMPv6 TIME_EXCEEDED
82 response from each gateway along the path to some host.
84 The only mandatory parameter is the destination host name or IPv6 address.
85 The default probe datagram carries 20 bytes of payload,
86 in addition to the IPv6 header.
87 The size of the payload can be specified by giving a length
89 after the destination host name.
94 Turn on AS# lookups for each hop encountered.
96 Turn on AS# lookups and use the given server instead of the default.
100 Specify how many hops to skip in trace.
102 Specify intermediate gateway.
105 tries to use routing headers.
107 Use ICMP6 ECHO instead of UDP datagrams.
109 Print both host hostnames and numeric addresses.
112 prints only hostnames if
114 is not specified, and only numeric addresses if
118 Specify maximum hoplimit, up to 255.
119 The default is the value of the
120 .Va net.inet6.ip6.hlim
122 (the same default used for TCP connections).
124 Do not resolve numeric address to hostname.
126 Use a packet with no upper layer header for the probes,
127 instead of UDP datagrams.
129 Set SCTP/TCP/UDP port number to
132 Set the number of probe per hop count to
135 Bypass the normal routing tables and send directly to a host
136 on an attached network.
137 If the host is not on a directly-connected network,
138 an error is returned.
139 This option corresponds to the
142 it can be used to ping a local host through an interface
143 that has no route through it
144 (e.g., after the interface was dropped by a routing daemon).
147 specifies the source IPv6 address to be used.
149 Use SCTP packets for the probes.
150 The size of probe packets must be a multiple of 4.
153 is up to 28, probe packets consist of a SHUTDOWN-ACK chunk possibly bundled
155 For larger probe packets, an INIT chunk is used.
160 used when sending probe packets.
161 The value must be a decimal integer in the range 0 to 255.
164 Use TCP segments for the probes.
166 Use UDP datagrams for the probes.
171 Specify the delay time between probes.
174 This program prints the route to the given destination and the round-trip
175 time to each gateway, in the same manner as traceroute.
177 Here is a list of possible annotations after the round-trip time for each gateway:
178 .Bl -hang -offset indent
180 Destination Unreachable - No Route to Host.
182 Destination Unreachable - Administratively Prohibited.
184 Destination Unreachable - Not a Neighbour.
186 Destination Unreachable - Address Unreachable.
188 Parameter Problem - Unrecognized Next Header Type.
190 This is printed if the hop limit is <= 1 on a port unreachable message.
191 This means that the packet got to the destination,
192 but that the reply had a hop limit that was just large enough to
193 allow it to get back to the source of the traceroute6.
194 This was more interesting in the IPv4 case,
195 where some IP stack bugs could be identified by this behaviour.
201 utility will exit with 0 on success, and non-zero on errors.
210 utility first appeared in WIDE hydrangea IPv6 protocol stack kit.