STING PING (SPING)
------------------

$Id: INSTALL 149 2007-10-31 04:55:43Z szander $


REQUIREMENTS
------------

We have developed and tested sping on openSUSE 11.2 and 11.4, but it
should work on any more recent Linux distros.

sping also works on FreeBSD, but currently the receive timestamps
and hence the RTTs are not as accurate on FreeBSD (SO_TIMESTAMP 
implementation is missing). Also note that under FreeBSD you must 
use -I to specify the outgoing interface (e.g. sping -I em0 <ip>).

The pcap library (lipcap) is required to get more accurate packet sent 
timestamps (enabled by default).

Use the package manager of your distro to install the libpcap-devel
package. Or download the sources from http://www.tcpdump.org
and compile libpcap yourself.

The asynchronous DNS library (libadns) is required to do reverse DNS 
lookups. sping works fine without it, but without it cannot report 
reverse DNS entries for IP addresses pinged.

Download the sources from http://www.chiark.greenend.org.uk/~ian/adns/
and compile libadns.


INSTALLATION
------------

To unpack the distribution type (replace <version> with the sping version
number you are using, e.g. 0.2 if you are using version 0.2):

cd <dir>
tar -xvzf sping-<version>.tar.gz

This will unpack the sources into the directory <dir>/sping-<version>.
To build and install the tools type:

cd <dir>/sping-<version>
./configure --prefix=<install-prefix>
make 
make install

If prefix is not specified the default is to install under /usr/local/.
Running 'make install' may require you to be root.

To run sping on PlanetLab nodes it must be build with PlanetLab support:

./configure --enable-planetlab

For a full list of all configure options run ./configure --help.


RUNNING THE TOOLS
-----------------

The sping tool uses raw sockets and pcap and therefore can only 
be run as root.

Please read the README for examples on how to use sping.


CONTACT
-------

If you have any questions or want to report any bugs please contact
Sebastian Cinder (szander@swin.edu.au).

Centre for Advanced Internet Architectures
Swinburne University of Technology
Melbourne, Australia
CRICOS number 00111D
http://www.caia.swin.edu.au