| blob | 2dae22b9c09e355f1ea53440c20a8da67393029f |
1 .\" $NetBSD: traceroute6.8,v 1.13 2011/05/12 08:42:24 wiz Exp $
2 .\" $KAME: traceroute6.8,v 1.8 2000/06/12 16:29:18 itojun Exp $
3 .\"
4 .\" Copyright (C) 1995, 1996, 1997, and 1998 WIDE Project.
5 .\" All rights reserved.
6 .\"
7 .\" Redistribution and use in source and binary forms, with or without
8 .\" modification, are permitted provided that the following conditions
9 .\" are met:
10 .\" 1. Redistributions of source code must retain the above copyright
11 .\" notice, this list of conditions and the following disclaimer.
12 .\" 2. Redistributions in binary form must reproduce the above copyright
13 .\" notice, this list of conditions and the following disclaimer in the
14 .\" documentation and/or other materials provided with the distribution.
15 .\" 3. Neither the name of the project nor the names of its contributors
16 .\" may be used to endorse or promote products derived from this software
17 .\" without specific prior written permission.
18 .\"
19 .\" THIS SOFTWARE IS PROVIDED BY THE PROJECT AND CONTRIBUTORS ``AS IS'' AND
20 .\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
21 .\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
22 .\" ARE DISCLAIMED. IN NO EVENT SHALL THE PROJECT OR CONTRIBUTORS BE LIABLE
23 .\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
24 .\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
25 .\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
26 .\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
27 .\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
28 .\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
29 .\" SUCH DAMAGE.
30 .\"
31 .Dd September 17, 2005
32 .Dt TRACEROUTE6 8
33 .Os
34 .\"
35 .Sh NAME
36 .Nm traceroute6
37 .Nd print the route IPv6 packets will take to the destination
38 .\"
39 .Sh SYNOPSIS
40 .Nm traceroute6
41 .Op Fl adIlnrv
42 .Op Fl A Ar as_server
43 .Op Fl f Ar firsthop
44 .Op Fl g Ar gateway
45 .Op Fl m Ar hoplimit
46 .Op Fl p Ar port
47 .Op Fl q Ar probes
48 .Op Fl s Ar src
49 .Op Fl w Ar waittime
50 .Ar target
51 .Op Ar datalen
52 .\"
53 .Sh DESCRIPTION
54 .Bl -tag -width Ds
55 .It Fl A
56 Turn on AS# lookups and use the given server instead of the default.
57 .It Fl a
58 Turn on AS# lookups for each hop encountered.
59 .It Fl d
60 Debug mode.
61 .It Fl f Ar firsthop
62 Specify how many hops to skip in trace.
63 .It Fl g Ar gateway
64 Specify intermediate gateway
65 .Po
66 .Nm
67 uses routing header
68 .Pc .
69 .It Fl I
70 Use ICMP6 ECHO instead of UDP datagrams.
71 .It Fl l
72 Print both host hostnames and numeric addresses.
73 Normally
74 .Nm
75 prints only hostnames if
76 .Fl n
77 is not specified, and only numeric addresses if
78 .Fl n
79 is specified.
80 .It Fl m Ar hoplimit
81 Specify maximum hoplimit.
82 .It Fl n
83 Do not resolve numeric address to hostname.
84 .It Fl p Ar port
85 Set UDP port number to
86 .Ar port .
87 .It Fl q Ar probes
88 Set the number of probe per hop count to
89 .Ar probes .
90 .It Fl r
91 Bypass the normal routing tables and send directly to
92 a host on an attached network.
93 If the host is not on a directly-attached network,
94 an error is returned.
95 This option can be used to send probes to a local host
96 through an interface that has no route through it
97 (e.g., after the interface was dropped by
98 .Xr route6d 8 ) .
99 .It Fl s Ar src
100 .Ar Src
101 specifies the source IPv6 address to be used.
102 .It Fl v
103 Be verbose.
104 .It Fl w Ar waittime
105 Specify the delay time between probes.
106 .El
107 .\"
108 .Sh EXIT STATUS
109 The
110 .Nm
111 command exits 0 on success, and \*[Gt]0 on errors.
112 .\"
113 .Sh SEE ALSO
114 .Xr ping 8 ,
115 .Xr ping6 8 ,
116 .Xr traceroute 8
117 .\"
118 .Sh HISTORY
119 The
120 .Nm
121 command first appeared in WIDE hydrangea IPv6 protocol stack kit.