Return to README CVS log

Up to [ELWIX - Embedded LightWeight unIX -] / embedaddon / mtr

Annotation of embedaddon/mtr/README, revision 1.1

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: 
        !            13:   mtr is distributed under the GNU General Public License. 
        !            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: