GSP
Quick Navigator

Search Site

Unix VPS
A - Starter
B - Basic
C - Preferred
D - Commercial
MPS - Dedicated
Previous VPSs
* Sign Up! *

Support
Contact Us
Online Help
Handbooks
Domain Status
Man Pages

FAQ
Virtual Servers
Pricing
Billing
Technical

Network
Facilities
Connectivity
Topology Map

Miscellaneous
Server Agreement
Year 2038
Credits
 

USA Flag

 

 

Man Pages


Manual Reference Pages  -  ETRACE (8)

NAME

etrace - print the route packets take to a network host

CONTENTS

Synopsis
Description
Options
Examples
Files
Author
Distribution

SYNOPSIS

etrace [ -BbCcnv ] [ -p profile ] [ -F config ] [ -i interface ] [ -I icmp-type ] [ -T port ] [ -U port ] [ -P protocol ] [ -r probe-count ] [ -t timeout ] [ -1 hop ] [ -h hop ] [ -m hop ] [ -A address ] [ -s port ] [ -f flags ] [ -d data ] [ -D data-file ] [ -R count ] [ -q seq ] [ -w window ] target [...]

DESCRIPTION

etrace is a configurable static port network tracing tool, similar to traceroute, but supporting ICMP, TCP, UDP and other IP protocols.

OPTIONS

etrace has a wealth of options ranging in function from controlling output to the detailed construction of trace packets.
PROFILE OPTIONS
A profile is a pre-configured list of options stored in a shared, or user specific configuration file. By defining profiles, complex etrace option sets can be easily accessed with a single command line option.
wibbleq
-p, --profile
  Specify a profile.
-C, --clear
  Clear the current list of probes. This option can be used to allow a profile to inherit options from another profile, but specify it’s own list of probes.
-F, --config
  Specify an alternative profiles file.
INTERFACE OPTIONS
-i, --interface
  Specify interface. If unspecified, etrace will examine the routing table and select the most appropriate interface for each target address.
-c, --promisc
  Put in interface into promiscuous mode. As this option increases the load on the system in general, it should only be used if spoofing of source packets address is enabled with the "-A" option.
TRACE TYPE OPTIONS
-I, --icmp
  Specify an ICMP trace and the packet type to use. ICMP traces may use Echo (E or P), Timestamp (T or S), Netmask (N or M) or Info (I). The default trace probe is an ICMP Echo.
-T, --tcp
-U, --udp
Specify either a TCP or UDP trace and the port to use.
-P, --protocol
  Specify a protocol type other than TCP, UDP or ICMP.
TRACE OPTIONS
-1, --initial
  Specify the initial hop.
-h, --hop Specify a specific hop to investigate.
-m, --maximum
  Specify the maximum number of hops.
-r, --probes
  Set the maximum number of probes to send per hop. The default is 3.
-t, --timeout
  Set the maximum amount of time, in milli-seconds, to wait for a response to a probe. The default is 3000 (three seconds).
PACKET CONSTRUCTION OPTIONS
-A, --address
  Specify the source IP address of generated packets.
-s, --source
  Set the source port of the generated probe packets. If unspecified, etrace uses a random high port.
-f, --flags
  Specify TCP and/or IP flags. Takes a comma delimitered list of any of the following flags: RF, DF, MF, FIN, SYN, RST, PSH, ACK, URG, ECE, CWR (Default: SYN)
-d, --data Specify the data content of generated probe packets. Standard meta-characters are recognised (e.g. "\n\t") as are binary values given in octal (e.g. "\000\x00");
-D, --data-file
  Load the data content of the generated probe packets from the specified file. Filenames beginning with ’@’ a loaded from the etrace shared data directory (usually /usr/local/share/etrace). etrace currently ships with the following predfined packet data files: dns, ike.
-R, --random
  Fill the data content of the generated probe packets with the specified number of random bytes.
-b, --badcksum
  Generate and send probe packets with bad checksums.
-q, --seq Specify the TCP sequence number.
-w, --window
  Specify the TCP window size.
OUTPUT OPTIONS
-v, --verbose
  Increase output verbosity.
-B, --debug
  Enable debugging output.
-n, --numeric
  Turn off name resolution

EXAMPLES

etrace www.sample.com

Launches a trace ICMP Echo, the default, trace to www.sample.com. Specifiying the options "-I E" whould accomplish the same results.

etrace -T 80 www.sample.com

Similar to the previous example, except the trace is performed on TCP port 80.

etrace --udp 53 --data-file @dns ns.sample.com

Starts are trace to ns.sample.com on UDP port 53 with the trace packets containing data loaded from the file /usr/local/share/etrace/dns (a file supplied with etrace that contains a simple dns request to resolve 127.0.0.1).

etrace -p dns -p fast ns.sample.com

The default profiles shipped with etrace include "dns" (which equates to the options shown in the previous example) and "fast" (which decreases both timeouts and the number of probes sent for each hop, as well as disabling name resolution). Profiles are stackable, with latter options overriding those specified in earlier profiles.

FILES

~/.etrace User specific profiles.
/usr/local/share/etrace/profile System wide profiles.

AUTHOR

Dave Armstrong <dave@bindshell.net>

DISTRIBUTION

The latest version of etrace can be obtained from:

http://www.bindshell.net/tools/etrace/
Search for    or go to Top of page |  Section 8 |  Main Index


Bindshell.net ETRACE (8) 8 July 2006

Powered by GSP Visit the GSP FreeBSD Man Page Interface.
Output converted with manServer 1.07.