summaryrefslogtreecommitdiffstats
path: root/usr.sbin/traceroute/traceroute.8
diff options
context:
space:
mode:
authorjmc <jmc@openbsd.org>2016-10-20 20:00:01 +0000
committerjmc <jmc@openbsd.org>2016-10-20 20:00:01 +0000
commita36937c554894c34cd3f2a38ea59323e0f7c4e35 (patch)
tree4829d8ba1c35c5097cc0224de601ebf66da09037 /usr.sbin/traceroute/traceroute.8
parentspread the Xr! as a bonus, typo fix in switchd.conf.5 too; (diff)
downloadwireguard-openbsd-a36937c554894c34cd3f2a38ea59323e0f7c4e35.tar.xz
wireguard-openbsd-a36937c554894c34cd3f2a38ea59323e0f7c4e35.zip
try to make DESCRIPTION read like it was written for one program, not two;
ok florian
Diffstat (limited to 'usr.sbin/traceroute/traceroute.8')
-rw-r--r--usr.sbin/traceroute/traceroute.835
1 files changed, 18 insertions, 17 deletions
diff --git a/usr.sbin/traceroute/traceroute.8 b/usr.sbin/traceroute/traceroute.8
index 21eeadf0016..b1a370d05bc 100644
--- a/usr.sbin/traceroute/traceroute.8
+++ b/usr.sbin/traceroute/traceroute.8
@@ -1,4 +1,4 @@
-.\" $OpenBSD: traceroute.8,v 1.63 2015/09/14 20:06:59 schwarze Exp $
+.\" $OpenBSD: traceroute.8,v 1.64 2016/10/20 20:00:01 jmc Exp $
.\" $NetBSD: traceroute.8,v 1.6 1995/10/12 03:05:50 mycroft Exp $
.\"
.\" Copyright (c) 1990, 1991, 1993
@@ -33,7 +33,7 @@
.\"
.\" @(#)traceroute.8 8.1 (Berkeley) 6/6/93
.\"
-.Dd $Mdocdate: September 14 2015 $
+.Dd $Mdocdate: October 20 2016 $
.Dt TRACEROUTE 8
.Os
.Sh NAME
@@ -72,23 +72,17 @@ network hardware, connected together by gateways.
Tracking the route packets follow (or finding the miscreant
gateway that's discarding packets) can be difficult.
.Nm
-utilizes the IPv4 protocol time to live (TTL) field
-and attempts to elicit an ICMP
-.Dv TIME_EXCEEDED
-response from each gateway along the path to some
-host.
+and
.Nm traceroute6
-does the same for the IPv6 protocol,
-instead using hop limits and ICMPv6
+attempt to elicit
.Dv TIME_EXCEEDED
-responses.
-.Pp
-The only mandatory parameter is the destination host name or IP number.
-The default probe datagram length is 40 bytes for IPv4 UDP and 60
-bytes for ICMP, IPv6 UDP and ICMP6.
-This may be increased by
-.Ar datalen
-bytes.
+responses from each gateway along the path to
+.Ar host ,
+in order to determine their route.
+.Nm
+is used for IPv4 networks and
+.Nm traceroute6
+for IPv6.
.Pp
The options are as follows:
.Bl -tag -width Ds
@@ -223,6 +217,13 @@ Set the time (in seconds) to wait for a response to a probe (default 5).
.It Fl x
Print the ICMP extended headers if available.
This option is not available for IPv6.
+.It Ar host
+The destination host,
+specified as a host name or numeric IP address.
+.It Ar datalen
+The probe datagram length.
+The default is 40 bytes for IPv4 UDP
+and 60 bytes for ICMP, IPv6 UDP and ICMP6.
.El
.Pp
This program attempts to trace the route an IP packet would follow to some