home *** CD-ROM | disk | FTP | other *** search
/ ARM Club 1 / ARM_CLUB_CD.iso / contents / apps / comms / a / freenet / !FreeNet_Docs_Traceroute < prev    next >
Encoding:
Text File  |  1995-05-13  |  10.3 KB  |  255 lines
  1. TRACEROUTE                                             "February 28, 1989"
  2.  
  3.  Copyright (c) 1988 The Regents of the University of California.
  4.  All rights reserved.
  5.  
  6.  Redistribution and use in source and binary forms are permitted
  7.  provided that the above copyright notice and this paragraph are
  8.  duplicated in all such forms and that any documentation,
  9.  advertising materials, and other materials related to such
  10.  distribution and use acknowledge that the software was developed
  11.  by the University of California, Berkeley.  The name of the
  12.  University may not be used to endorse or promote products derived
  13.  from this software without specific prior written permission.
  14.  THIS SOFTWARE IS PROVIDED ``AS IS'' AND WITHOUT ANY EXPRESS OR
  15.  IMPLIED WARRANTIES, INCLUDING, WITHOUT LIMITATION, THE IMPLIED
  16.  WARRANTIES OF MERCHANTIBILITY AND FITNESS FOR A PARTICULAR PURPOSE.
  17.  
  18.  
  19. traceroute - print the route packets take to network host
  20.  
  21. SYNOPSIS
  22. traceroute [-m max_ttl] [-n] [-p port] [-q nqueries] [-r]
  23.            [-s src_addr] [-g addr] [-t tos] [-w waittime] host [packetsize]
  24.  
  25. DESCRIPTION
  26.  
  27. The Internet is a large and complex aggregation of network hardware,
  28. connected together by gateways. Tracking the route one's packets follow
  29. (or finding the miscreant gateway that's discarding your packets) can be
  30. difficult.
  31.  
  32. Traceroute utilizes the IP protocol `time to live' field and attempts to
  33. elicit an ICMP TIME_EXCEEDED response from each gateway along the path
  34. to some host.
  35.  
  36. The only mandatory parameter is the destination host name or IP number.
  37. The default probe datagram length is 38 bytes, but this may be increased
  38. by specifying a packet size (in bytes) after the destination host name.
  39.  
  40. Other options are:
  41.  
  42. -m  n    Set the max time-to-live (max number of hops) used in outgoing
  43.     probe packets to n hops. The default is 30 hops (the same
  44.     default used for TCP connections).
  45.  
  46. -n    Print hop addresses numerically rather than symbolically and
  47.     numerically (saves a nameserver address-to-name lookup for each
  48.     gateway found on the path).
  49.  
  50. -p n    Set the base UDP port number used in probes to n (default is
  51.     33434).
  52.  
  53.     Traceroute hopes that nothing is listening on UDP ports. I base
  54.     to base+nhops-1 at the destination host (so an ICMP
  55.     PORT_UNREACHABLE message will be returned to terminate the route
  56.     tracing). If something is listening on a port in the default
  57.     range, this option can be used to pick an unused port range.
  58.  
  59. -r    Bypass the normal routing tables and send directly to a host on
  60.     an attached network. If the host is not on a directly-attached
  61.     network, an error is returned. This option can be used to ping a
  62.     local host through an interface that has no route through it
  63.     (e.g., after the interface was dropped by routed).
  64.  
  65. -s a    Use a as the IP address (which must be given as an IP number,
  66.     not a hostname) as the source address in outgoing probe packets.
  67.     On hosts with more than one IP address, this option can be used
  68.     to force the source address to be something other than the IP
  69.     address of the interface the probe packet is sent on.
  70.  
  71.     If the IP address is not one of this machine's interface
  72.     addresses, an error is returned and nothing is sent.
  73.  
  74. -g a    Enable the IP LSRR (Loose Source Record Route) option in
  75.     addition to the TTL tests. This is useful for asking how
  76.     somebody else, at IP address a, reaches a particular target.
  77.  
  78. -t tos    Set the type-of-service in probe packets to the following value
  79.     (default zero). The value must be a decimal integer in the range
  80.     0 to 255. This option can be used to see if different
  81.     types-of-service result in different paths.
  82.  
  83.     (If you are not running 4.4bsd, this may be academic since the
  84.     normal network services like telnet and ftp don't let you
  85.     control the TOS). Not all values of TOS are legal or meaningful
  86.     - see the IP spec for definitions.
  87.  
  88.     Useful values are probably `-t 16' (low delay) and `-t 8' (high
  89.     throughput).
  90.  
  91. -u    Enable MTU discovery. If a packetsize is also given, the
  92.     packetsize sets the starting size when this option is used.
  93.     (New to the Acorn RISC OS version)
  94.  
  95. -v    Verbose output. Received ICMP packets other than TIME_EXCEEDED
  96.     and UNREACHABLEs are listed.
  97.  
  98. -w n    Set the time to wait for a response to a probe to n seconds
  99.     (default 3 sec.).
  100.  
  101.  
  102. This program attempts to trace the route an IP packet would follow to
  103. some internet host by launching UDP probe packets with a small ttl (time
  104. to live) then listening for an ICMP "time exceeded" reply from a
  105. gateway. We start our probes with a ttl of one and increase by one until
  106. we get an ICMP "port unreachable" (which means we got to "host") or hit
  107. a max (which defaults to 30 hops & can be changed with the -m flag).
  108.  
  109. Three probes (change with -q flag) are sent at each ttl setting and a
  110. line is printed showing the ttl, address of the gateway and round trip
  111. time of each probe. If the probe answers come from different gateways,
  112. the address of each responding system will be printed.
  113.  
  114. If there is no response within a 3 sec. timeout interval (changed with
  115. the -w flag), a "*" is printed for that probe.
  116.  
  117.  
  118. We don't want the destination host to process the UDP probe packets so
  119. the destination port is set to an unlikely value (if some clod on the
  120. destination is using that value, it can be changed with the -p flag).
  121.  
  122. A sample use and output might be:
  123.  
  124. [yak 71]% traceroute nis.nsf.net.
  125. traceroute to nis.nsf.net (35.1.1.48), 30 hops max, 56 byte packet
  126.  1  helios.ee.lbl.gov (128.3.112.1)  19 ms  19 ms  0 ms
  127.  2  lilac-dmc.Berkeley.EDU (128.32.216.1)  39 ms  39 ms  19 ms
  128.  3  lilac-dmc.Berkeley.EDU (128.32.216.1)  39 ms  39 ms  19 ms
  129.  4  ccngw-ner-cc.Berkeley.EDU (128.32.136.23)  39 ms  40 ms  39 ms
  130.  5  ccn-nerif22.Berkeley.EDU (128.32.168.22)  39 ms  39 ms  39 ms
  131.  6  128.32.197.4 (128.32.197.4)  40 ms  59 ms  59 ms
  132.  7  131.119.2.5 (131.119.2.5)  59 ms  59 ms  59 ms
  133.  8  129.140.70.13 (129.140.70.13)  99 ms  99 ms  80 ms
  134.  9  129.140.71.6 (129.140.71.6)  139 ms  239 ms  319 ms
  135. 10  129.140.81.7 (129.140.81.7)  220 ms  199 ms  199 ms
  136. 11  nic.merit.edu (35.1.1.48)  239 ms  239 ms  239 ms
  137.  
  138. Note that lines 2 & 3 are the same. This is due to a buggy kernel on the
  139. 2nd hop system - lbl-csam.arpa - that forwards packets with a zero ttl
  140. (a bug in the distributed version of 4.3BSD).
  141.  
  142.  
  143. A more interesting example is:
  144.  
  145. [yak 72]% traceroute allspice.lcs.mit.edu.
  146. traceroute to allspice.lcs.mit.edu (18.26.0.115), 30 hops max
  147.  1  helios.ee.lbl.gov (128.3.112.1)  0 ms  0 ms  0 ms
  148.  2  lilac-dmc.Berkeley.EDU (128.32.216.1)  19 ms  19 ms  19 ms
  149.  3  lilac-dmc.Berkeley.EDU (128.32.216.1)  39 ms  19 ms  19 ms
  150.  4  ccngw-ner-cc.Berkeley.EDU (128.32.136.23)  19 ms  39 ms  39 ms
  151.  5  ccn-nerif22.Berkeley.EDU (128.32.168.22)  20 ms  39 ms  39 ms
  152.  6  128.32.197.4 (128.32.197.4)  59 ms  119 ms  39 ms
  153.  7  131.119.2.5 (131.119.2.5)  59 ms  59 ms  39 ms
  154.  8  129.140.70.13 (129.140.70.13)  80 ms  79 ms  99 ms
  155.  9  129.140.71.6 (129.140.71.6)  139 ms  139 ms  159 ms
  156. 10  129.140.81.7 (129.140.81.7)  199 ms  180 ms  300 ms
  157. 11  129.140.72.17 (129.140.72.17)  300 ms  239 ms  239 ms
  158. 12  * * *
  159. 13  128.121.54.72 (128.121.54.72)  259 ms  499 ms  279 ms
  160. 14  * * *
  161. 15  * * *
  162. 16  * * *
  163. 17  * * *
  164. 18  ALLSPICE.LCS.MIT.EDU (18.26.0.115)  339 ms  279 ms  279 ms
  165.  
  166.  
  167. Note that the gateways 12, 14, 15, 16 & 17 hops away either don't send
  168. ICMP "time exceeded" messages or send them with a ttl too small to reach
  169. us. 14 - 17 are running the MIT C Gateway code that doesn't send "time
  170. exceeded"s. God only knows what's going on with 12.
  171.  
  172. The silent gateway 12 in the above may be the result of a bug in the
  173. 4.[23]BSD network code (and its derivatives):  4.x (x <= 3) sends an
  174. unreachable message using whatever ttl remains in the original datagram.
  175.  
  176. Since, for gateways, the remaining ttl is zero, the ICMP "time exceeded"
  177. is guaranteed to not make it back to us. The behavior of this bug is
  178. slightly more interesting when it appears on the destination system:
  179.  
  180.  1  helios.ee.lbl.gov (128.3.112.1)  0 ms  0 ms  0 ms
  181.  2  lilac-dmc.Berkeley.EDU (128.32.216.1)  39 ms  19 ms  39 ms
  182.  3  lilac-dmc.Berkeley.EDU (128.32.216.1)  19 ms  39 ms  19 ms
  183.  4  ccngw-ner-cc.Berkeley.EDU (128.32.136.23)  39 ms  40 ms  19 ms
  184.  5  ccn-nerif35.Berkeley.EDU (128.32.168.35)  39 ms  39 ms  39 ms
  185.  6  csgw.Berkeley.EDU (128.32.133.254)  39 ms  59 ms  39 ms
  186.  7  * * *
  187.  8  * * *
  188.  9  * * *
  189. 10  * * *
  190. 11  * * *
  191. 12  * * *
  192. 13  rip.Berkeley.EDU (128.32.131.22)  59 ms !  39 ms !  39 ms !
  193.  
  194. Notice that there are 12 "gateways" (13 is the final destination) and
  195. exactly the last half of them are "missing". What's really happening is
  196. that rip (a Sun-3 running Sun OS3.5) is using the ttl from our arriving
  197. datagram as the ttl in its ICMP reply.
  198.  
  199. So, the reply will time out on the return path (with no notice sent to
  200. anyone since ICMP's aren't sent for ICMP's) until we probe with a ttl
  201. that's at least twice the path length.
  202.  
  203. I.e., rip is really only 7 hops away. A reply that returns with a ttl of
  204. 1 is a clue this problem exists.
  205.  
  206.  
  207. Traceroute prints a "!" after the time if the ttl is <= 1. Since vendors
  208. ship a lot of obsolete (DEC's Ultrix, Sun 3.x) or non-standard (HPUX)
  209. software, expect to see this problem frequently and/or take care picking
  210. the target host of your probes.
  211.  
  212. Other possible annotations after the time are:
  213. !H, !N, !P (got a host, network or protocol unreachable, respectively),
  214. !S or !F (source route failed or fragmentation needed \- neither of
  215. these should ever occur and the associated gateway is busted if you see
  216. one).
  217.  
  218. If almost all the probes result in some kind of unreachable, traceroute
  219. will give up and exit.
  220.  
  221.  
  222. traceroute -g 10.3.0.5 128.182.0.0
  223.  
  224. will show the path from the Cambridge Mailbridge to PSC while
  225.  
  226.  
  227. traceroute \-g 192.5.146.4 \-g 10.3.0.5 35.0.0.0
  228.  
  229. shows how the Cambridge Mailbrige reaches Merit, by using PSC to reach
  230. the Mailbridge.
  231.  
  232.  
  233. This program is intended for use in network testing, measurement and
  234. management. It should be used primarily for manual fault isolation.
  235. Because of the load it could impose on the network, it is unwise to use
  236. traceroute during normal operations or from automated scripts.
  237.  
  238.  
  239. AUTHOR
  240. Implemented by Van Jacobson from a suggestion by Steve Deering.
  241. Debugged by a cast of thousands with particularly cogent suggestions
  242. or fixes from C. Philip Wood, Tim Seaver and Ken Adelman.
  243.  
  244.  
  245. SEE ALSO
  246. netstat
  247. ping
  248.  
  249. --------------------------------------------------------------------------------
  250.  
  251. This version ported to RISC OS for FreeNet from the NetBSD 4.4 source
  252. by Tom Hughes in April 1995. The path MTU discovery code and code for
  253. gettimeofday() are taken from the previous RISC OS port done by Adam
  254. Goodfellow on 3rd December 1994.
  255.