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>