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