home *** CD-ROM | disk | FTP | other *** search
/ ftp.muug.mb.ca / 2014.06.ftp.muug.mb.ca.tar / ftp.muug.mb.ca / pub / src / traceroute / README < prev    next >
Text File  |  1989-11-23  |  4KB  |  89 lines

  1.  
  2. This README file outlines what each file in this collection is.
  3. Last updated: 11/24/89
  4.  
  5. Traceroute is a utility written by Van Jacobson that traces the exact
  6. network route that packets take while being routed from your machine
  7. to any specified remote host.  This is an extremely useful debugging
  8. tool for network managers.
  9.  
  10. This collection of files is my attempt to put together in one easy
  11. place all the files and info needed to enable traceroute on a Sun 3,
  12. 3x, or 4 machine running SunOS 4.0.x.  This collection includes the
  13. following:
  14.  
  15. -- Source code for three kernel files (raw_ip.c, ip_icmp.c, and
  16.    ip_icmp.h) on which the necessary kernel modifications have been
  17.    performed.  These files came from Bill Nowicki of Sun
  18.    <nowicki@sun.com>, who made the actual modifications.  They are the
  19.    definitive version of these files for Sun 3, 3x, and 4 machines,
  20.    and I can vouch that they work.  (I don't have any 386i machines,
  21.    so I can't vouch for whether these files will work on a 386i or
  22.    not.) 
  23.  
  24. -- A traceroute.c file that has been patched with Matt Mathis'
  25.    <mathis@fornax.ece.cmu.edu> modifications for supporting IP LSRR
  26.    (Loose Source Record Route).  This allows you to find out how
  27.     somebody else (at a site other than your own machine, that is)
  28.     would reach a particular target.
  29.  
  30. -- A man page for traceroute that includes a description of the IP
  31.    LSRR feature.  From Paul Pomes <paul@uxc.cso.uiuc.edu>.
  32.  
  33. -- A Makefile that will help automate the installation of the necessary
  34.    binaries.  From Manavendra K. Thakur <thakur@zerkalo.harvard.edu>.
  35.  
  36. My thanks to Robert M. Enger <enger@sccgate.scc.com> and Edward
  37. Vielmetti <emv@math.lsa.umich.edu> for forwarding to me the bulk of
  38. the pieces that comprise this collection.
  39.  
  40.  
  41. Here is a summary of all the files and subdirectories:
  42.  
  43. README            This file -- For more info on this collection
  44.             of files, please contact Manavendra K. Thakur
  45.             <thakur@zerkalo.harvard.edu>.  For more info on
  46.             the traceroute code,itself, please contact the
  47.             appropriate authors.
  48.  
  49. Makefile        Makefile to compile and install ip_icmp.o,
  50.             raw_ip.o, and traceroute.  Note that you still
  51.             have to recompile and reinstall your kernel
  52.             after running the Makefile.
  53.  
  54. ip_icmp.c, ip_icmp.h    Source code for the kernel modules that need
  55. raw_ip.c        recompiling in order to run traceroute.  From
  56.             Bill Nowicki of Sun Microsystems <nowicki@sun.com>.
  57.  
  58. traceroute.c        Source code for the actual traceroute executable. 
  59.             From Van Jacobson <van@helios.ee.lbl.gov> and
  60.             Matt Mathis <mathis@fornvax.ece.cmu.edu>.
  61.  
  62. traceroute.8        Man page for traceroute.  Includes documentation
  63.             of the IP LSRR feature.  From Paul Pomes
  64.             <paul@uxc.cso.uiuc.edu>.
  65.  
  66. vj_traceroute         Directory with original traceroute code from 
  67.             Van Jacobson.  This directory comes from the
  68.             traceroute.tar.Z file on ftp.ee.lbl.gov.  If you
  69.             should want to create the source code and binaries
  70.             from scratch for any reason, you should begin
  71.             with these files.  If you want the Loose
  72.             Source Record Route option, then apply the
  73.             patches contained in LSRR.patches file in the
  74.             vj_traceroute directory.  Consult the README and
  75.             LSRR.patches files in the vj_traceroute directory
  76.             for more information.
  77.  
  78. vj_traceroute/LSRR.patches
  79.             Matt Mathis' patches to Van Jacobson's traceroute.
  80.             These patches enable LSRR (source level routing).
  81.  
  82. bin            This directory contains pre-compiled versions of all
  83.             the binaries that would be created by running the
  84.             Makefile, for both Sun 3 and Sun 4 machines.  (The
  85.             Sun 3 binaries will also work on a Sun 3x machine.)
  86.             See the README file in the bin directory for more
  87.             information.
  88.  
  89.