xref: /netbsd/usr.sbin/traceroute6/traceroute6.8 (revision bf9ec67e)
1.\"	$NetBSD: traceroute6.8,v 1.8 2002/02/08 01:38:57 ross 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 May 17, 1998
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.Bk -words
42.Op Fl dlnrv
43.Ek
44.Bk -words
45.Op Fl f Ar firsthop
46.Ek
47.Bk -words
48.Op Fl g Ar gateway
49.Ek
50.Bk -words
51.Op Fl m Ar hoplimit
52.Ek
53.Bk -words
54.Op Fl p Ar port
55.Ek
56.Bk -words
57.Op Fl q Ar probes
58.Ek
59.Bk -words
60.Op Fl s Ar src
61.Ek
62.Bk -words
63.Op Fl w Ar waittime
64.Ek
65.Bk -words
66.Ar target
67.Op Ar datalen
68.Ek
69.\"
70.Sh DESCRIPTION
71.Bl -tag -width Ds
72.It Fl d
73Debug mode.
74.It Fl f Ar firsthop
75Specify how many hops to skip in trace.
76.It Fl g Ar gateway
77Specify intermediate gateway
78.Po
79.Nm
80uses routing header
81.Pc .
82.It Fl m Ar hoplimit
83Specify maximum hoplimit.
84.It Fl l
85Print both host hostnames and numeric addresses.
86Normally
87.Nm
88prints only hostnames if
89.Fl n
90is not specified, and only numeric addresses if
91.Fl n
92is specified.
93.It Fl n
94Do not resolve numeric address to hostname.
95.It Fl p Ar port
96Set UDP port number to
97.Ar port .
98.It Fl q Ar probes
99Set the number of probe per hop count to
100.Ar probes .
101.It Fl r
102.It Fl s Ar src
103.Ar Src
104specifies the source IPv6 address to be used.
105.It Fl v
106Be verbose.
107.It Fl w Ar waittime
108Specify the delay time between probes.
109.El
110.\"
111.Sh EXIT STATUS
112The
113.Nm
114command exits 0 on success, and \*[Gt]0 on errors.
115.\"
116.Sh SEE ALSO
117.Xr ping 8 ,
118.Xr ping6 8 ,
119.Xr traceroute 8
120.\"
121.Sh HISTORY
122The
123.Nm
124command first appeared in WIDE hydrangea IPv6 protocol stack kit.
125