Annotation of embedaddon/mtr/mtr.8, revision 1.1
1.1 ! misho 1: .TH MTR 8 "March 4, 1999" "mtr" "mtr"
! 2:
! 3:
! 4: .SH NAME
! 5: mtr \- a network diagnostic tool
! 6:
! 7:
! 8: .SH SYNOPSIS
! 9: .B mtr
! 10: [\c
! 11: .B \-hvrctglspeniuTP46\c
! 12: ]
! 13: [\c
! 14: .B \-\-help\c
! 15: ]
! 16: [\c
! 17: .B \-\-version\c
! 18: ]
! 19: [\c
! 20: .B \-\-report\c
! 21: ]
! 22: [\c
! 23: .B \-\-report-wide\c
! 24: ]
! 25: [\c
! 26: .B \-\-report\-cycles\ COUNT\c
! 27: ]
! 28: [\c
! 29: .B \-\-curses\c
! 30: ]
! 31: [\c
! 32: .B \-\-split\c
! 33: ]
! 34: [\c
! 35: .B \-\-raw\c
! 36: ]
! 37: [\c
! 38: .B \-\-mpls\c
! 39: ]
! 40: [\c
! 41: .B \-\-no-dns\c
! 42: ]
! 43: [\c
! 44: .B \-\-show-ips\c
! 45: ]
! 46: [\c
! 47: .B \-\-gtk\c
! 48: ]
! 49: [\c
! 50: .B \-\-address\ IP.ADD.RE.SS\c
! 51: ]
! 52: [\c
! 53: .B \-\-interval\ SECONDS\c
! 54: ]
! 55: [\c
! 56: .B \-\-psize\ BYTES | -s BYTES\c
! 57: ]
! 58: [\c
! 59: .B \-\-tcp\c
! 60: ]
! 61: [\c
! 62: .B \-\-port\ PORT\c
! 63: ]
! 64: [\c
! 65: .B \-\-timeout\ SECONDS\c
! 66: ]
! 67: .B HOSTNAME [PACKETSIZE]
! 68:
! 69:
! 70: .SH DESCRIPTION
! 71:
! 72: .B mtr
! 73: combines the functionality of the
! 74: .B traceroute
! 75: and
! 76: .B ping
! 77: programs in a single network diagnostic tool.
! 78:
! 79: .PP
! 80: As
! 81: .B mtr
! 82: starts, it investigates the network connection between the host
! 83: .B mtr
! 84: runs on and
! 85: .BR HOSTNAME .
! 86: by sending packets with purposely low TTLs. It continues to send
! 87: packets with low TTL, noting the response time of the intervening
! 88: routers. This allows
! 89: .B mtr
! 90: to print the response percentage and response times of the internet
! 91: route to
! 92: .BR HOSTNAME .
! 93: A sudden increase in packet loss or response time is often an indication
! 94: of a bad (or simply overloaded) link.
! 95:
! 96: .PP
! 97: The results are usually reported as round-trip-response times in miliseconds
! 98: and the percentage of packetloss.
! 99:
! 100: .SH OPTIONS
! 101:
! 102: .TP
! 103: .B \-h
! 104: .TP
! 105: .B \-\-help
! 106: .br
! 107: Print the summary of command line argument options.
! 108:
! 109: .TP
! 110: .B \-v
! 111: .TP
! 112: .B \-\-version
! 113: .br
! 114: Print the installed version of mtr.
! 115:
! 116: .TP
! 117: .B \-r
! 118: .TP
! 119: .B \-\-report
! 120: .br
! 121: This option puts
! 122: .B mtr
! 123: into
! 124: .B report
! 125: mode. When in this mode,
! 126: .B mtr
! 127: will run for the number of cycles specified by the
! 128: .B \-c
! 129: option, and then print statistics and exit.
! 130: .TP
! 131: \c
! 132: This mode is useful for generating statistics about network quality.
! 133: Note that each running instance of
! 134: .B mtr
! 135: generates a significant amount of network traffic. Using
! 136: .B mtr
! 137: to measure the quality of your network may result in decreased
! 138: network performance.
! 139:
! 140: .TP
! 141: .B \-w
! 142: .TP
! 143: .B \-\-report-wide
! 144: .br
! 145: This option puts
! 146: .B mtr
! 147: into
! 148: .B wide report
! 149: mode. When in this mode,
! 150: .B mtr
! 151: will not cut hostnames in the report.
! 152:
! 153: .TP
! 154: .B \-c\ COUNT
! 155: .TP
! 156: .B \-\-report\-cycles\ COUNT
! 157: Use this option to set the number of pings sent to determine
! 158: both the machines on the network and the reliability of
! 159: those machines. Each cycle lasts one second.
! 160:
! 161: .TP
! 162: .B \-s\ BYTES
! 163: .TP
! 164: .B \-\-psize\ BYTES
! 165: .TP
! 166: .B PACKETSIZE
! 167: These options or a trailing PACKETSIZE on the command line sets
! 168: the packet size used for probing.
! 169: It is in bytes inclusive IP and ICMP headers
! 170:
! 171: If set to a negative number, every iteration will use a different, random
! 172: packet size upto that number.
! 173: .TP
! 174: .B \-t
! 175: .TP
! 176: .B \-\-curses
! 177: .br
! 178: Use this option to force
! 179: .B mtr
! 180: to use the curses based terminal
! 181: interface (if available).
! 182:
! 183: .TP
! 184: .B \-e
! 185: .TP
! 186: .B \-\-mpls
! 187: .br
! 188: Use this option to tell
! 189: .B mtr
! 190: to display information from ICMP extensions for MPLS (RFC 4950)
! 191: that are encoded in the response packets.
! 192:
! 193: .TP
! 194: .B \-n
! 195: .TP
! 196: .B \-\-no-dns
! 197: .br
! 198: Use this option to force
! 199: .B mtr
! 200: to display numeric IP numbers and not try to resolve the
! 201: host names.
! 202:
! 203: .TP
! 204: .B \-b
! 205: .TP
! 206: .B \-\-show-ips
! 207: .br
! 208: Use this option to tell
! 209: .B mtr
! 210: to display both the host names and numeric IP numbers. In split mode
! 211: this adds an extra field to the output. In report mode, there is usually
! 212: too little space to add the IPs, and they will be truncated. Use the
! 213: wide report (-w) mode to see the IPs in report mode.
! 214:
! 215: .TP
! 216: .B \-o\ fields\ order
! 217: .TP
! 218: .B \-\-order\ fields\ order
! 219: .br
! 220: Use this option to specify the fields and their order when loading mtr.
! 221: .br
! 222: Available fields:
! 223: .TS
! 224: center allbox tab(%);
! 225: ll.
! 226: L%Loss ratio
! 227: D%Dropped packets
! 228: R%Received packets
! 229: S%Sent Packets
! 230: N%Newest RTT(ms)
! 231: B%Min/Best RTT(ms)
! 232: A%Average RTT(ms)
! 233: W%Max/Worst RTT(ms)
! 234: V%Standard Deviation
! 235: G%Geometric Mean
! 236: J%Current Jitter
! 237: M%Jitter Mean/Avg.
! 238: X%Worst Jitter
! 239: I%Interarrival Jitter
! 240: .TE
! 241: .br
! 242:
! 243: Example:
! 244: -o "LSD NBAW"
! 245: .TP
! 246: .B \-g
! 247: .TP
! 248: .B \-\-gtk
! 249: .br
! 250: Use this option to force
! 251: .B mtr
! 252: to use the GTK+ based X11 window interface (if available).
! 253: GTK+ must have been available on the system when
! 254: .B mtr
! 255: was built for this to work. See the GTK+ web page at
! 256: .B http://www.gtk.org/
! 257: for more information about GTK+.
! 258:
! 259: .TP
! 260: .B \-p
! 261: .TP
! 262: .B \-\-split
! 263: .br
! 264: Use this option to set
! 265: .B mtr
! 266: to spit out a format that is suitable for a split-user interface.
! 267:
! 268: .TP
! 269: .B \-l
! 270: .TP
! 271: .B \-\-raw
! 272: .br
! 273: Use this option to tell
! 274: .B mtr
! 275: to use the raw output format. This format is better suited for
! 276: archival of the measurement results. It could be parsed to
! 277: be presented into any of the other display methods.
! 278:
! 279: .TP
! 280: .B \-a\ IP.ADD.RE.SS
! 281: .TP
! 282: .B \-\-address\ IP.ADD.RE.SS
! 283: .br
! 284: Use this option to bind outgoing packets' socket to specific interface,
! 285: so that any packet will be sent through this interface. NOTE that this
! 286: option doesn't apply to DNS requests (which could be and could not be
! 287: what you want).
! 288:
! 289: .TP
! 290: .B \-i\ SECONDS
! 291: .TP
! 292: .B \-\-interval\ SECONDS
! 293: .br
! 294: Use this option to specify the positive number of seconds between ICMP
! 295: ECHO requests. The default value for this parameter is one second.
! 296:
! 297: .TP
! 298: .B \-u
! 299: .br
! 300: Use UDP datagrams instead of ICMP ECHO.
! 301:
! 302: .TP
! 303: .B \-T
! 304: .TP
! 305: .B \-\-tcp
! 306: .br
! 307: Use TCP SYN packets instead of ICMP ECHO. PACKETSIZE is ignored, since
! 308: SYN packets can not contain data.
! 309:
! 310: .TP
! 311: .B \-P\ PORT
! 312: .TP
! 313: .B \-\-port\ PORT
! 314: .br
! 315: The target port number for TCP traces.
! 316:
! 317: .TP
! 318: .B \-\-timeout\ SECONDS
! 319: .br
! 320: The number of seconds to keep the TCP socket open before giving up on
! 321: the connection. This will only affect the final hop. Using large values
! 322: for this, especially combined with a short interval, will use up a lot
! 323: of file descriptors.
! 324:
! 325: .TP
! 326: .B \-4
! 327: .br
! 328: Use IPv4 only.
! 329:
! 330: .TP
! 331: .B \-6
! 332: .br
! 333: Use IPv6 only.
! 334:
! 335: .SH BUGS
! 336:
! 337: Some modern routers give a lower priority to ICMP ECHO packets than
! 338: to other network traffic. Consequently, the reliability of these
! 339: routers reported by
! 340: .B mtr
! 341: will be significantly lower than the actual reliability of
! 342: these routers.
! 343:
! 344:
! 345: .SH CONTACT INFORMATION
! 346:
! 347: .PP
! 348: For the latest version, see the mtr web page at
! 349: .BR http://www.bitwizard.nl/mtr/ .
! 350:
! 351: .PP
! 352: The mtr mailinglist was little used and is no longer active.
! 353:
! 354: .PP
! 355: Bug reports and feature requests should be submitted to the
! 356: launchpad mtr bugtracker.
! 357:
! 358: .SH "SEE ALSO"
! 359:
! 360: traceroute(8),
! 361: ping(8)
! 362: TCP/IP Illustrated (Stevens, ISBN 0201633469).
FreeBSD-CVSweb <freebsd-cvsweb@FreeBSD.org>
![[BACK]](/icons/cvsweb/back.gif){kind=icon}
Return to mtr.8 CVS log ![[TXT]](/icons/cvsweb/text.gif){kind=icon}
![[DIR]](/icons/cvsweb/dir.gif){kind=icon}
Up to [ELWIX - Embedded LightWeight unIX -] / embedaddon / mtr