Annotation of embedaddon/mtr/README, revision 1.1.1.2
1.1 misho 1: WHAT IS MTR?
2:
3: mtr combines the functionality of the 'traceroute' and 'ping' programs
4: in a single network diagnostic tool.
5:
6: As mtr starts, it investigates the network connection between the host
7: mtr runs on and a user-specified destination host. After it
8: determines the address of each network hop between the machines,
9: it sends a sequence ICMP ECHO requests to each one to determine the
10: quality of the link to each machine. As it does this, it prints
11: running statistics about each machine.
12:
1.1.1.2 ! misho 13: mtr is distributed under the GNU General Public License version 2.
1.1 misho 14: See the COPYING file for details.
15:
16: INSTALLING
17:
18: If you're building this from a tarball, compiling mtr should be as
19: simple as:
20:
21: make
22:
23: It should first call the "configure" script and then run "make" again
24: with the makefile that "configure" just generated.
25:
26: If you're building from the git repository, you'll need to run:
27:
28: ./bootstrap.sh && ./configure && make
29:
30: After compiling, install:
31:
32: make install
33:
34: Note that mtr must be suid-root because it requires access to raw IP
35: sockets. See SECURITY for security information.
36:
37: Older versions used to require a non-existant path to GTK for a
38: correct build of a non-gtk version while GTK was installed. This is
39: no longer neccesary. ./configure --WITHOUT_GTK should now work.
40: If it doesn't, try "make WITHOUT_X11=YES" as the make step.
41:
42: On Solaris (and possibly other systems) the "gtk" library may be
43: installed in a directory where the dynamic linker refuses to look when
44: a binary is setuid. Roman Shterenzon reports that adding
45: -Wl,-rpath=/usr/lib
46: to the commandline will work if you are using gnu LD. He tells me that
47: you're out of luck when you use the sun LD. That's not quite true, as
48: you can move the gtk libraries to /usr/lib instead of leaving them in
49: /usr/local/lib. (when the ld tells you that /usr/local/lib is untrusted
50: and /usr/lib is trusted, and you trust hte gtk libs enough to want them
51: in a setuid program, then there is something to say for moving them
52: to the "trusted" directory.)
53:
54: On Solaris, linking usually fails to find "wattr" or something like that.
55: Somehow, I can't seem to be able to automate "configure" finding the right
56: libs on Solaris. So, the solution is that you cut-and-paste the line
57: doing the linking into a terminal window, and add "-lcurses" by hand.
58: Then it will link. Help on how to catch this in autoconf appreciated.
59:
60: On Mac OS X the nameserver8_compat.h needs to be included. I put the
61: include inside an "#if 0" section in the file "dns.c". If someone
62: knows how to make this automatic using autoconf / the configure script,
63: please tell me....
64:
65: This should now also work:
66: ./configure CFLAGS="-arch i386 -arch x86_64" LIBS="-lresolv" \
67: --without-gtk --disable-endian-check --disable-dependency-tracking
68:
69:
70:
71: WHERE CAN I GET THE LATEST VERSION OR MORE INFORMATION?
72:
73: mtr is now hosted on github.
74: https://github.com/traviscross/mtr
75:
76: See the mtr web page at
77: http://www.BitWizard.nl/mtr/
78:
79: There used to be a mailinglist, but all it got was spam. So
80: when the server was upgraded, the mailing list died.
81:
82: Bug reports and feature requests should be submitted to the
83: bug tracker at launchpad: https://launchpad.net/mtr/+bugs
84:
85: Patches can be submitted by Email to me, or submitted to the
86: bug tracker. Or you can clone the github repository and issue a pull
87: request. Please use unified diffs. Usually the diff is sort of
88: messy, so please check that the diff is clean and doesn't contain too
89: much of your local stuff (for example, I don't want/need the "configure"
90: script that /your/ automake made for you).
91:
92: -- REW
93:
FreeBSD-CVSweb <freebsd-cvsweb@FreeBSD.org>