xref: /minix/usr.sbin/traceroute6/traceroute6.8 (revision d642636d)
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
56Turn on AS# lookups and use the given server instead of the default.
57.It Fl a
58Turn on AS# lookups for each hop encountered.
59.It Fl d
60Debug mode.
61.It Fl f Ar firsthop
62Specify how many hops to skip in trace.
63.It Fl g Ar gateway
64Specify intermediate gateway
65.Po
66.Nm
67uses routing header
68.Pc .
69.It Fl I
70Use ICMP6 ECHO instead of UDP datagrams.
71.It Fl l
72Print both host hostnames and numeric addresses.
73Normally
74.Nm
75prints only hostnames if
76.Fl n
77is not specified, and only numeric addresses if
78.Fl n
79is specified.
80.It Fl m Ar hoplimit
81Specify maximum hoplimit.
82.It Fl n
83Do not resolve numeric address to hostname.
84.It Fl p Ar port
85Set UDP port number to
86.Ar port .
87.It Fl q Ar probes
88Set the number of probe per hop count to
89.Ar probes .
90.It Fl r
91Bypass the normal routing tables and send directly to
92a host on an attached network.
93If the host is not on a directly-attached network,
94an error is returned.
95This option can be used to send probes to a local host
96through 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
101specifies the source IPv6 address to be used.
102.It Fl v
103Be verbose.
104.It Fl w Ar waittime
105Specify the delay time between probes.
106.El
107.\"
108.Sh EXIT STATUS
109The
110.Nm
111command 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
119The
120.Nm
121command first appeared in WIDE hydrangea IPv6 protocol stack kit.
122