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

FreeBSD Manual Pages


home | help
MTR(8)				      mtr				MTR(8)

       mtr - a network diagnostic tool

       mtr  [-hvrctglspniu46]  [--help]	[--version] [--report] [--report-wide]
       [--report-cycles	COUNT] [--curses] [--split] [--raw] [--no-dns] [--gtk]
       [--address IP.ADD.RE.SS]	  [--interval SECONDS]	 [--psize BYTES	 |  -s

       mtr combines the	functionality of the traceroute	and ping programs in a
       single network diagnostic tool.

       As  mtr starts, it investigates the network connection between the host
       mtr runs	on and HOSTNAME.  by sending packets with purposly  low	 TTLs.
       It  continues to	send packets with low TTL, noting the response time of
       the intervening routers.	 This allows mtr to print  the	response  per-
       centage and response times of the internet route	to HOSTNAME.  A	sudden
       increase	in packetloss or response time is often	an indication of a bad
       (or simply overloaded) link.


	      Print the	summary	of command line	argument options.


	      Print the	installed version of mtr.


	      This  option  puts mtr into report mode.	When in	this mode, mtr
	      will run for the number of cycles	specified by  the  -c  option,
	      and then print statistics	and exit.

       This mode is useful for generating statistics about network quality.
	      Note  that  each running instance	of mtr generates a significant
	      amount of	network	traffic.  Using	mtr to measure the quality  of
	      your network may result in decreased network performance.


	      This  option puts	mtr into wide report mode.  When in this mode,
	      mtr will not cut hostnames in the	report.

       -c COUNT

       --report-cycles COUNT
	      Use this option to set the number	of  pings  sent	 to  determine
	      both  the	 machines  on the network and the reliability of those
	      machines.	 Each cycle lasts one second.

       -s BYTES

       --psize BYTES

	      These options or a trailing PACKETSIZE on	the  commandline  sets
	      the  packet  size	used for probing.  It is in bytes inclusive IP
	      and ICMP headers

	      If set to	a negative number, every iteration will	use a  differ-
	      ent, random packetsize upto that number.


	      Use  this	 option	 to force mtr to use the curses	based terminal
	      interface	(if available).


	      Use this option to force mtr to display numeric IP  numbers  and
	      not try to resolve the host names.

       -o fields order

       --order fields order
	      Use this option to specify the fields and	their order when load-
	      ing mtr.
	      Example: -o "LSD NBAW"


	      Use this option to force mtr to use the GTK+  based  X11	window
	      interface	 (if available).  GTK+ must have been available	on the
	      system when mtr was built	for this to work.  See	the  GTK+  web
	      page  at  for  more  information about


	      Use this option to set mtr to spit out a format that is suitable
	      for a split-user interface.


	      Use  this	 option	to tell	mtr to use the raw output format. This
	      format is	better suited for archival of the measurement results.
	      It could be parsed to be presented into any of the other display

       -a IP.ADD.RE.SS

       --address IP.ADD.RE.SS
	      Use this option to bind outgoing packets'	socket to specific in-
	      terface, so that any packet will be sent through this interface.
	      NOTE that	this option doesn't apply to DNS requests (which could
	      be and could not be what you want).

       -i SECONDS

       --interval SECONDS
	      Use  this	 option	 to specify the	positive number	of seconds be-
	      tween ICMP ECHO requests.	 The default value for this  parameter
	      is one second.

	      Use UDP datagrams	instead	of ICMP	ECHO.

	      Use IPv4 only.

	      Use IPv6 only.

       Some  modern routers give a lower priority to ICMP ECHO packets than to
       other network traffic.  Consequently, the reliability of	these  routers
       reported	by mtr will be significantly lower than	the actual reliability
       of these	routers.

       For the latest version, see the	mtr  web  page	at  http://www.bitwiz-

       Subscribe  to  the mtr mailing list.  All mtr related announcements are
       posted to the mtr mailing list.	To subscribe,  send  email  to	major-	with subscribe mtr in the body of the message.
       To send a message to the	mailing	list, mail to

       Bug reports and feature requests	should be  sent	 to  the  mtr  mailing

       traceroute(8), ping(8).

mtr				 March 4, 1999				MTR(8)


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

home | help