diff options
author | fenner <fenner@FreeBSD.org> | 1996-09-30 19:09:55 +0000 |
---|---|---|
committer | fenner <fenner@FreeBSD.org> | 1996-09-30 19:09:55 +0000 |
commit | a140d208b5ecc0e726bc4300cd21ab1f869df7c7 (patch) | |
tree | cbd17e19e65ecb7b39e5aa03e453ce8b56e3aede /contrib/traceroute/INSTALL | |
download | FreeBSD-src-a140d208b5ecc0e726bc4300cd21ab1f869df7c7.zip FreeBSD-src-a140d208b5ecc0e726bc4300cd21ab1f869df7c7.tar.gz |
Virgin import of LBL traceroute version 1.3.2.
Obtained from: ftp://ftp.ee.lbl.gov/traceroute.tar.Z on 30-Sep-1996.
Diffstat (limited to 'contrib/traceroute/INSTALL')
-rw-r--r-- | contrib/traceroute/INSTALL | 82 |
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 |