1.\" $KAME: traceroute6.8,v 1.10 2004/06/06 12:35:15 suz 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:
--- 13 unchanged lines hidden (view full) ---
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: head/usr.sbin/traceroute6/traceroute6.8 131754 2004-07-07 19:57:16Z ru $
31.\"
32.Dd May 17, 1998
33.Dt TRACEROUTE6 8
34.Os
35.\"
36.Sh NAME
37.Nm traceroute6
38.Nd "print the route IPv6 packets will take to a network node"
--- 25 unchanged lines hidden (view full) ---
64.Op Fl w Ar waittime
65.Ek
66.Bk -words
67.Ar target
68.Op Ar datalen
69.Ek
70.\"
71.Sh DESCRIPTION
72The
73.Nm
74utility
75uses the IPv6 protocol hop limit field to elicit an ICMPv6 TIME_EXCEEDED
76response from each gateway along the path to some host.
77.Pp
78The only mandatory parameter is the destination host name or IPv6 address.
79The default probe datagram carries 12 bytes of payload,
80in addition to the IPv6 header.
81The size of the payload can be specified by giving a length
82(in bytes)
83after the destination host name.
84.Pp
85Other options are:
86.Bl -tag -width Ds
87.It Fl d
88Debug mode.
89.It Fl f Ar firsthop
90Specify how many hops to skip in trace.
91.It Fl g Ar gateway
--- 27 unchanged lines hidden (view full) ---
119.Ar Src
120specifies the source IPv6 address to be used.
121.It Fl v
122Be verbose.
123.It Fl w Ar waittime
124Specify the delay time between probes.
125.El
126.Pp
127This program prints the route to the given destination and the round-trip
128time to each gateway, in the same manner as traceroute.
129.Pp
130Here is a list of possible annotations after the round-trip time for each gateway:
131.Bl -hang -offset indent
132.It !N
133Destination Unreachable - No Route to Host.
134.It !P
135Destination Unreachable - Administratively Prohibited.
136.It !S
137Destination Unreachable - Not a Neighbour.
138.It !A
139Destination Unreachable - Address Unreachable.
140.It !\&
141This is printed if the hop limit is <= 1 on a port unreachable message.
142This means that the packet got to the destination,
143but that the reply had a hop limit that was just large enough to
144allow it to get back to the source of the traceroute6.
145This was more interesting in the IPv4 case,
146where some IP stack bugs could be identified by this behaviour.
147.El
148.\"
--- 14 unchanged lines hidden ---
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:
--- 13 unchanged lines hidden (view full) ---
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: head/usr.sbin/traceroute6/traceroute6.8 131754 2004-07-07 19:57:16Z ru $
31.\"
32.Dd May 17, 1998
33.Dt TRACEROUTE6 8
34.Os
35.\"
36.Sh NAME
37.Nm traceroute6
38.Nd "print the route IPv6 packets will take to a network node"
--- 25 unchanged lines hidden (view full) ---
64.Op Fl w Ar waittime
65.Ek
66.Bk -words
67.Ar target
68.Op Ar datalen
69.Ek
70.\"
71.Sh DESCRIPTION
72The
73.Nm
74utility
75uses the IPv6 protocol hop limit field to elicit an ICMPv6 TIME_EXCEEDED
76response from each gateway along the path to some host.
77.Pp
78The only mandatory parameter is the destination host name or IPv6 address.
79The default probe datagram carries 12 bytes of payload,
80in addition to the IPv6 header.
81The size of the payload can be specified by giving a length
82(in bytes)
83after the destination host name.
84.Pp
85Other options are:
86.Bl -tag -width Ds
87.It Fl d
88Debug mode.
89.It Fl f Ar firsthop
90Specify how many hops to skip in trace.
91.It Fl g Ar gateway
--- 27 unchanged lines hidden (view full) ---
119.Ar Src
120specifies the source IPv6 address to be used.
121.It Fl v
122Be verbose.
123.It Fl w Ar waittime
124Specify the delay time between probes.
125.El
126.Pp
127This program prints the route to the given destination and the round-trip
128time to each gateway, in the same manner as traceroute.
129.Pp
130Here is a list of possible annotations after the round-trip time for each gateway:
131.Bl -hang -offset indent
132.It !N
133Destination Unreachable - No Route to Host.
134.It !P
135Destination Unreachable - Administratively Prohibited.
136.It !S
137Destination Unreachable - Not a Neighbour.
138.It !A
139Destination Unreachable - Address Unreachable.
140.It !\&
141This is printed if the hop limit is <= 1 on a port unreachable message.
142This means that the packet got to the destination,
143but that the reply had a hop limit that was just large enough to
144allow it to get back to the source of the traceroute6.
145This was more interesting in the IPv4 case,
146where some IP stack bugs could be identified by this behaviour.
147.El
148.\"
--- 14 unchanged lines hidden ---