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 130268 2004-06-09 12:45:51Z dwmalone $
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
72.Nm
73uses the IPv6 protocol hop limit field to elicit an ICMPv6 TIME_EXCEEDED
74response from each gateway along the path to some host.
75.Pp
76The only mandatory parameter is the destination host name or IPv6 address.
77The default probe datagram carries 12 bytes of payload,
78in addition to the IPv6 header.
79The size of the payload can be specified by giving a length
80.Po in bytes
81.Pc
82after the destination host name.
83.Pp
84Other options are:
85.Bl -tag -width Ds
86.It Fl d
87Debug mode.
88.It Fl f Ar firsthop
89Specify how many hops to skip in trace.
90.It Fl g Ar gateway
--- 27 unchanged lines hidden (view full) ---
118.Ar Src
119specifies the source IPv6 address to be used.
120.It Fl v
121Be verbose.
122.It Fl w Ar waittime
123Specify the delay time between probes.
124.El
125.Pp
126This program prints the route to the given destination and the round-trip
127time to each gateway, in the same manner as traceroute.
128.Pp
129Here is a list of possible annotations after the round-trip time for each gateway:
130.Pp
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 130268 2004-06-09 12:45:51Z dwmalone $
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
72.Nm
73uses the IPv6 protocol hop limit field to elicit an ICMPv6 TIME_EXCEEDED
74response from each gateway along the path to some host.
75.Pp
76The only mandatory parameter is the destination host name or IPv6 address.
77The default probe datagram carries 12 bytes of payload,
78in addition to the IPv6 header.
79The size of the payload can be specified by giving a length
80.Po in bytes
81.Pc
82after the destination host name.
83.Pp
84Other options are:
85.Bl -tag -width Ds
86.It Fl d
87Debug mode.
88.It Fl f Ar firsthop
89Specify how many hops to skip in trace.
90.It Fl g Ar gateway
--- 27 unchanged lines hidden (view full) ---
118.Ar Src
119specifies the source IPv6 address to be used.
120.It Fl v
121Be verbose.
122.It Fl w Ar waittime
123Specify the delay time between probes.
124.El
125.Pp
126This program prints the route to the given destination and the round-trip
127time to each gateway, in the same manner as traceroute.
128.Pp
129Here is a list of possible annotations after the round-trip time for each gateway:
130.Pp
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 ---