summaryrefslogtreecommitdiffstats
path: root/contrib/traceroute/INSTALL
diff options
context:
space:
mode:
Diffstat (limited to 'contrib/traceroute/INSTALL')
-rw-r--r--contrib/traceroute/INSTALL82
1 files changed, 82 insertions, 0 deletions
diff --git a/contrib/traceroute/INSTALL b/contrib/traceroute/INSTALL
new file mode 100644
index 0000000..6f1be4f
--- /dev/null
+++ b/contrib/traceroute/INSTALL
@@ -0,0 +1,82 @@
+@(#) $Header: INSTALL,v 1.7 96/09/18 21:09:56 leres Exp $ (LBL)
+
+Traceroute is known to build and run under SunOS 4.1.4 and Solaris 5.4.
+If you are running a really old kernel, see the instructions under the
+title "KERNEL MODIFICATIONS" further down.
+
+To build traceroute, first customize any paths in Makefile.in, then run
+"./configure" (a shell script). The configure script will determine
+your system attributes and generate an appropriate Makefile from
+Makefile.in. Next run "make". If everything goes well you can su to
+root and run "make install" and "make install-man". Note that traceroute
+must be installed setuid to root or run as root.
+
+If configure fails for some reason and decide to submit a bug report to
+traceroute@ee.lbl.gov, please include a copy of config.log.
+
+You will need an ANSI C compiler to build libpcap. The configure script
+will abort if your compiler is not ANSI compliant. If this happens, use
+the GNU C compiler, available via anonymous ftp:
+
+ ftp://prep.ai.mit.edu/pub/gnu/gcc-*.tar.gz
+
+KERNEL MODIFICATIONS
+--------------------
+If yor have a really old system, it may be necessary to modify your
+kernel before traceroute will work. If you want to hack on your kernel,
+a modified version of the routine rip_output (normally found in the
+file /sys/netinet/raw_ip.c) can be found in rip_output.c. This code may
+or may not resemble the code in your kernel. It may offer you a place
+to start but we make no promises. If you do hack your kernel, remember
+to test everything that uses raw ip sockets (e.g., ping and
+egpup/gated) & make sure they still work. We wish you the best of luck
+and you're on your own.
+
+Some older kernels forward icmp packets that have a ttl of zero. If
+your system has this bug, you might want to fix it while you're in the
+kernel. (This bug appears in all releases of BSD up to but not
+including 4.3tahoe. If your version of netinet/ip_icmp.c is any earlier
+than 7.3 (April, '87), it has the bug.) The fix is just to add the
+line:
+
+ ip->ip_ttl = MAXTTL;
+
+after the line:
+
+ ip->ip_src = t;
+
+(or anywhere before the call to icmp_send) in routine icmp_reflect.
+
+If you're running this on a pre-4.3bsd system (e.g., SunOS 3) that
+strips ip headers from icmp messages, add -DARCHAIC to CFLAGS in the
+Makefile. Also note that rip_output contains a conditional for a
+4.2/4.3 change in the location of a raw socket's protocol number. I've
+checked this under 4.3 & SunOS 3 but you should double-check your
+system to make sure the appropriate branch of the #if is taken (check
+the line that assigned to ip->ip_p in your system's original
+rip_output).
+
+
+FILES
+-----
+CHANGES - description of differences between releases
+FILES - list of files exported as part of the distribution
+INSTALL - this file
+Makefile.in - compilation rules (input to the configure script)
+README - description of distribution
+VERSION - version of this release
+acsite.m4 - autoconf macros
+config.guess - autoconf support
+config.sub - autoconf support
+configure - configure script (run this first)
+configure.in - configure script source
+install-sh - BSD style install script
+lbl/gnuc.h - gcc macros and defines
+lbl/os-*.h - os dependent defines and prototypes
+mean.awk - awk script to print out the mean time along a route
+median.awk - awk script to print out the median time along a route
+mkdep - construct Makefile dependency list
+rip_output.c - sample rip_output() from /sys/netinet/raw_ip.c
+traceroute.8 - manual entry
+traceroute.c - main program
+strerror.c - emulation routine
OpenPOWER on IntegriCloud