XTRACEROUTE(1)

NAME
xtraceroute - graphical (X11) traceroute

SYNOPSIS
xtraceroute [options] hostname ...

DESCRIPTION
This manual page documents briefly the xtraceroute, command. This manual page was written for the Debian GNU/Linux distribution because the original program does not have a manual page.

xtraceroute is a graphical version of the traceroute program, which traces the route your IP packets travel to their destination.

On the display:
* Green dots have good location information,
* Yellow ones has been guessed from the sites' suffix,
* Red ones are unknown.
You can select dots by clicking on them both on the globe and in the list.

ARGUMENTS
hostnames are the names (or IP addresses) of the hosts you are interested in.

OPTIONS
The program follow the usual GNU command line syntax, with long options starting with two dashes (`-').

--version
    Show version number

-h, --help
    Display a brief help text.

-T, --texture texture-name.tiff
    Use a custom texture (map). It must be a TIFF file. There are a few really good textures on http://www.radcyberzine.com/xglobe/ (Meant for use with Xglobe, but if you convert them to TIFF, they'll work fine.)

--LOD number
    Set the level-of-detail for the sphere. (The default is 3, 0-4 is realistic values.)

--stdio
    Makes the program read data from stdin instead of calling traceroute(8) (Mainly useful for debugging)

CAVEATS
xtraceroute tries hard to guess the location of machines, but it is just software, it doesn't know everything.

FILES

/usr/pkg/share/xtraceroute/site_hosts.cache
    System-wide hosts file

/usr/pkg/share/xtraceroute/site_networks.cache
    System-wide networks file

The two files above are filled in by hand, following the model of /usr/lib/xtraceroute *.cache files.

$HOME/.xt/user_hosts.cache
    Your personal hosts file

$HOME/.xt/user_networks.cache
    Your personal networks file

$HOME/.xt/user_generic.cache
    Your personal base of regular expressions

These three personal files are typically filled in via the Database menu.

SEE ALSO
More information is in /usr/doc/xtraceroute.

AUTHOR
This manual page was written by Stephane Bortzmeyer <bortzmeyer@debian.org>, for the Debian GNU/Linux system (but may be used by others).