1TRACEPATH(8)                        iputils                       TRACEPATH(8)
2
3
4

NAME

6       tracepath - traces path to a network host discovering MTU along this
7       path
8

SYNOPSIS

10       tracepath [-4] [-6] [-n] [-b] [-l pktlen] [-m max_hops] [-p port] [-V]
11                 {destination}
12

DESCRIPTION

14       It traces path to destination discovering MTU along this path. It uses
15       UDP port port or some random port. It is similar to traceroute, only
16       does not require superuser privileges and has no fancy options.
17
18       tracepath -6 is good replacement for traceroute6 and classic example of
19       application of Linux error queues. The situation with IPv4 is worse,
20       because commercial IP routers do not return enough information in ICMP
21       error messages. Probably, it will change, when they will be updated.
22       For now it uses Van Jacobson's trick, sweeping a range of UDP ports to
23       maintain trace history.
24

OPTIONS

26       -4
27           Use IPv4 only..
28
29       -6
30           Use IPv6 only..
31
32       -n
33           Print primarily IP addresses numerically.
34
35       -b
36           Print both of host names and IP addresses.
37
38       -l
39           Sets the initial packet length to pktlen instead of 65535 for IPv4
40           or 128000 for IPv6.
41
42       -m
43           Set maximum hops (or maximum TTLs) to max_hops instead of 30.
44
45       -p
46           Sets the initial destination port to use.
47
48       -V
49           Print version and exit.
50

OUTPUT

52           root@mops:~ # tracepath -6 3ffe:2400:0:109::2
53            1?: [LOCALHOST]                              pmtu 1500
54            1:  dust.inr.ac.ru                   0.411ms
55            2:  dust.inr.ac.ru        asymm  1   0.390ms pmtu 1480
56            2:  3ffe:2400:0:109::2               463.514ms reached
57                Resume: pmtu 1480 hops 2 back 2
58
59
60       The first column shows TTL of the probe, followed by colon. Usually
61       value of TTL is obtained from reply from network, but sometimes reply
62       does not contain necessary information and we have to guess it. In this
63       case the number is followed by ?.
64
65       The second column shows the network hop, which replied to the probe. It
66       is either address of router or word [LOCALHOST], if the probe was not
67       sent to the network.
68
69       The rest of line shows miscellaneous information about path to the
70       corresponding network hop. As rule it contains value of RTT.
71       Additionally, it can show Path MTU, when it changes. If the path is
72       asymmetric or the probe finishes before it reach prescribed hop,
73       difference between number of hops in forward and backward direction is
74       shown following keyword async. This information is not reliable. F.e.
75       the third line shows asymmetry of 1, it is because the first probe with
76       TTL of 2 was rejected at the first hop due to Path MTU Discovery.
77
78       The last line summarizes information about all the path to the
79       destination, it shows detected Path MTU, amount of hops to the
80       destination and our guess about amount of hops from the destination to
81       us, which can be different when the path is asymmetric.
82

SEE ALSO

84       traceroute(8), traceroute6(8), ping(8).
85

AUTHOR

87       tracepath was written by Alexey Kuznetsov <kuznet@ms2.inr.ac.ru>.
88

SECURITY

90       No security issues.
91
92       This lapidary deserves to be elaborated.  tracepath is not a privileged
93       program, unlike traceroute, ping and other beasts of this kind.
94       tracepath may be executed by everyone who has some access to network,
95       enough to send UDP datagrams to investigated destination using given
96       port.
97

AVAILABILITY

99       tracepath is part of iputils package.
100
101
102
103iputils s20190515                                                 TRACEPATH(8)
Impressum