Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages


home | help
etrace(8)		    System Manager's Manual		     etrace(8)

       etrace -	print the route	packets	take to	a network host

       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 [...]

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

       etrace has a wealth of options ranging  in  function  from  controlling
       output to the detailed construction of trace packets.


       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.


       -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.


       -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 in-
	      creases the load on the system in	general,  it  should  only  be
	      used  if	spoofing of source packets address is enabled with the
	      "-A" option.


       -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.


       -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).


       -A, --address
	      Specify the source IP address of generated packets.

       -s, --source
	      Set the source port of the generated probe packets. If  unspeci-
	      fied, 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  val-
	      ues 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.


       -v, --verbose
	      Increase output verbosity.

       -B, --debug
	      Enable debugging output.

       -n, --numeric
	      Turn off name resolution


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

       etrace -T 80

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

       etrace --udp 53 --data-file @dns

       Starts are trace	to 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

       etrace -p dns -p	fast

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

	      User specific profiles.

	      System wide profiles.

       Dave Armstrong _dave@bindshell.net_

       The latest version of etrace can	be obtained from:			  8 July 2006			     etrace(8)


Want to link to this manual page? Use this URL:

home | help