c6a7da724eb30272ea2317ed4f44097bdb8abf36
[dragonfly.git] / usr.sbin / traceroute6 / traceroute6.8
1 .\"     $KAME: traceroute6.8,v 1.8 2000/06/12 16:29:18 itojun Exp $
2 .\"
3 .\" Copyright (C) 1995, 1996, 1997, and 1998 WIDE Project.
4 .\" All rights reserved.
5 .\"
6 .\" Redistribution and use in source and binary forms, with or without
7 .\" modification, are permitted provided that the following conditions
8 .\" are met:
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.
17 .\"
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
28 .\" SUCH DAMAGE.
29 .\"
30 .\"     $FreeBSD: src/usr.sbin/traceroute6/traceroute6.8,v 1.1.2.8 2003/03/11 22:31:34 trhodes Exp $
31 .\"     $DragonFly: src/usr.sbin/traceroute6/traceroute6.8,v 1.2 2003/06/17 04:30:03 dillon Exp $
32 .\"
33 .Dd May 17, 1998
34 .Dt TRACEROUTE6 8
35 .Os
36 .\"
37 .Sh NAME
38 .Nm traceroute6
39 .Nd "print the route IPv6 packets will take to the destination"
40 .\"
41 .Sh SYNOPSIS
42 .Nm
43 .Bk -words
44 .Op Fl dlnrv
45 .Ek
46 .Bk -words
47 .Op Fl f Ar firsthop
48 .Ek
49 .Bk -words
50 .Op Fl g Ar gateway
51 .Ek
52 .Bk -words
53 .Op Fl m Ar hoplimit
54 .Ek
55 .Bk -words
56 .Op Fl p Ar port
57 .Ek
58 .Bk -words
59 .Op Fl q Ar probes
60 .Ek
61 .Bk -words
62 .Op Fl s Ar src
63 .Ek
64 .Bk -words
65 .Op Fl w Ar waittime
66 .Ek
67 .Bk -words
68 .Ar target
69 .Op Ar datalen
70 .Ek
71 .\"
72 .Sh DESCRIPTION
73 .Bl -tag -width Ds
74 .It Fl d
75 Debug mode.
76 .It Fl f Ar firsthop
77 Specify how many hops to skip in trace.
78 .It Fl g Ar gateway
79 Specify intermediate gateway
80 .Nm (
81 uses routing header).
82 .It Fl m Ar hoplimit
83 Specify maximum hoplimit.
84 .It Fl l
85 Print both host hostnames and numeric addresses.
86 Normally
87 .Nm
88 prints only hostnames if
89 .Fl n
90 is not specified, and only numeric addresses if
91 .Fl n
92 is specified.
93 .It Fl n
94 Do not resolve numeric address to hostname.
95 .It Fl p Ar port
96 Set UDP port number to
97 .Ar port .
98 .It Fl q Ar probes
99 Set the number of probe per hop count to
100 .Ar probes .
101 .It Fl r
102 .It Fl s Ar src
103 .Ar Src
104 specifies the source IPv6 address to be used.
105 .It Fl v
106 Be verbose.
107 .It Fl w Ar waittime
108 Specify the delay time between probes.
109 .El
110 .\"
111 .Sh RETURN VALUES
112 The
113 .Nm
114 utility will exit with 0 on success, and non-zero on errors.
115 .\"
116 .Sh SEE ALSO
117 .Xr ping 8 ,
118 .Xr ping6 8 ,
119 .Xr traceroute 8
120 .\"
121 .Sh HISTORY
122 The
123 .Nm
124 utility first appeared in WIDE hydrangea IPv6 protocol stack kit.