xref: /netbsd/usr.sbin/traceroute6/traceroute6.8 (revision c4a72b64)
1.\"	$NetBSD: traceroute6.8,v 1.9 2002/08/30 03:57:20 onoe 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 dIlnrv
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 I
83Use ICMP6 ECHO instead of UDP datagrams.
84.It Fl l
85Print both host hostnames and numeric addresses.
86Normally
87.Nm
88prints only hostnames if
89.It Fl m Ar hoplimit
90Specify maximum hoplimit.
91.Fl n
92is not specified, and only numeric addresses if
93.Fl n
94is specified.
95.It Fl n
96Do not resolve numeric address to hostname.
97.It Fl p Ar port
98Set UDP port number to
99.Ar port .
100.It Fl q Ar probes
101Set the number of probe per hop count to
102.Ar probes .
103.It Fl r
104.It Fl s Ar src
105.Ar Src
106specifies the source IPv6 address to be used.
107.It Fl v
108Be verbose.
109.It Fl w Ar waittime
110Specify the delay time between probes.
111.El
112.\"
113.Sh EXIT STATUS
114The
115.Nm
116command exits 0 on success, and \*[Gt]0 on errors.
117.\"
118.Sh SEE ALSO
119.Xr ping 8 ,
120.Xr ping6 8 ,
121.Xr traceroute 8
122.\"
123.Sh HISTORY
124The
125.Nm
126command first appeared in WIDE hydrangea IPv6 protocol stack kit.
127