|
version 1.1.1.2, 2021/03/17 00:07:30
|
version 1.1.1.3, 2023/09/27 11:18:58
|
|
Line 114 mtr \- a network diagnostic tool
|
Line 114 mtr \- a network diagnostic tool
|
| ] |
] |
| .I HOSTNAME |
.I HOSTNAME |
| .SH DESCRIPTION |
.SH DESCRIPTION |
| .B mtr | .B mtr |
| combines the functionality of the | combines the functionality of the |
| .B traceroute |
.B traceroute |
| and | and |
| .B ping |
.B ping |
| programs in a single network diagnostic tool. |
programs in a single network diagnostic tool. |
| .PP |
.PP |
| As | As |
| .B mtr | |
| starts, it investigates the network connection between the host | |
| .B mtr |
.B mtr |
| runs on and | starts, it investigates the network connection between the host |
| | .B mtr |
| | runs on and |
| .BR HOSTNAME |
.BR HOSTNAME |
| by sending packets with purposely low TTLs. It continues to send |
by sending packets with purposely low TTLs. It continues to send |
| packets with low TTL, noting the response time of the intervening |
packets with low TTL, noting the response time of the intervening |
| routers. This allows | routers. This allows |
| .B mtr | .B mtr |
| to print the response percentage and response times of the internet |
to print the response percentage and response times of the internet |
| route to | route to |
| .BR HOSTNAME . | .BR HOSTNAME . |
| A sudden increase in packet loss or response time is often an indication |
A sudden increase in packet loss or response time is often an indication |
| of a bad (or simply overloaded) link. | of a bad (or simply overloaded) link. |
| .PP |
.PP |
| The results are usually reported as round-trip-response times in milliseconds |
The results are usually reported as round-trip-response times in milliseconds |
| and the percentage of packet loss. | and the percentage of packet loss. |
| .SH OPTIONS |
.SH OPTIONS |
| .TP |
.TP |
| .B \-h\fR, \fB\-\-help |
.B \-h\fR, \fB\-\-help |
| Print the summary of command line argument options. |
Print the summary of command line argument options. |
| .TP |
.TP |
| .B \-v\fR, \fB\-\-version |
.B \-v\fR, \fB\-\-version |
| Print the installed version of mtr. | Print the installed version of mtr. |
| .TP |
.TP |
| .B \-4 |
.B \-4 |
| Use IPv4 only. |
Use IPv4 only. |
|
Line 157 Use IPv6 only. (IPV4 may be used for DNS lookups.)
|
Line 157 Use IPv6 only. (IPV4 may be used for DNS lookups.)
|
| Reads the list of hostnames from the specified file. |
Reads the list of hostnames from the specified file. |
| .TP |
.TP |
| .B \-r\fR, \fB\-\-report |
.B \-r\fR, \fB\-\-report |
| This option puts | This option puts |
| .B mtr |
.B mtr |
| into | into |
| .B report |
.B report |
| mode. When in this mode, |
mode. When in this mode, |
| .B mtr |
.B mtr |
| will run for the number of cycles specified by the | will run for the number of cycles specified by the |
| .B \-c |
.B \-c |
| option, and then print statistics and exit. | option, and then print statistics and exit. |
| .TP |
.TP |
| \c |
\c |
| This mode is useful for generating statistics about network quality. | This mode is useful for generating statistics about network quality. |
| Note that each running instance of | Note that each running instance of |
| .B mtr |
.B mtr |
| generates a significant amount of network traffic. Using | generates a significant amount of network traffic. Using |
| .B mtr |
.B mtr |
| to measure the quality of your network may result in decreased |
to measure the quality of your network may result in decreased |
| network performance. | network performance. |
| .TP |
.TP |
| .B \-w\fR, \fB\-\-report\-wide |
.B \-w\fR, \fB\-\-report\-wide |
| This option puts | This option puts |
| .B mtr |
.B mtr |
| into | into |
| .B wide report |
.B wide report |
| mode. When in this mode, |
mode. When in this mode, |
| .B mtr |
.B mtr |
| will not cut hostnames in the report. | will not cut hostnames in the report. |
| .TP |
.TP |
| .B \-x\fR, \fB\-\-xml |
.B \-x\fR, \fB\-\-xml |
| Use this option to tell |
Use this option to tell |
|
Line 192 to use the xml output format. This format is better s
|
Line 192 to use the xml output format. This format is better s
|
| automated processing of the measurement results. |
automated processing of the measurement results. |
| .TP |
.TP |
| .B \-t\fR, \fB\-\-curses |
.B \-t\fR, \fB\-\-curses |
| Use this option to force | Use this option to force |
| .B mtr | .B mtr |
| to use the curses based terminal |
to use the curses based terminal |
| interface (if available). |
interface (if available). |
| In case the list of hops exceeds the | In case the list of hops exceeds the |
| height of your terminal, you can use the | height of your terminal, you can use the |
| .B + |
.B + |
| and |
and |
| .B - |
.B - |
|
Line 215 information.
|
Line 215 information.
|
| .TP |
.TP |
| .B \-g\fR, \fB\-\-gtk |
.B \-g\fR, \fB\-\-gtk |
| Use this option to force |
Use this option to force |
| .B mtr | .B mtr |
| to use the GTK+ based X11 window interface (if available). | to use the GTK+ based X11 window interface (if available). |
| GTK+ must have been available on the system when | GTK+ must have been available on the system when |
| .B mtr | .B mtr |
| was built for this to work. See the GTK+ web page at | was built for this to work. See the GTK+ web page at |
| .UR http://\:www.\:gtk.\:org/ |
.UR http://\:www.\:gtk.\:org/ |
| .UE |
.UE |
| for more information about GTK+. |
for more information about GTK+. |
| .TP |
.TP |
| .B \-l\fR, \fB\-\-raw |
.B \-l\fR, \fB\-\-raw |
| Use the raw output format. This format is better suited for |
Use the raw output format. This format is better suited for |
| archival of the measurement results. It could be parsed to | archival of the measurement results. It could be parsed to |
| be presented into any of the other display methods. | be presented into any of the other display methods. |
| .IP |
.IP |
| Example of the raw output format: |
Example of the raw output format: |
| .nf |
.nf |
|
Line 273 was built for this to work.
|
Line 273 was built for this to work.
|
| .TP |
.TP |
| .B \-p\fR, \fB\-\-split |
.B \-p\fR, \fB\-\-split |
| Use this option to set |
Use this option to set |
| .B mtr | .B mtr |
| to spit out a format that is suitable for a split-user interface. |
to spit out a format that is suitable for a split-user interface. |
| .TP |
.TP |
| .B \-n\fR, \fB\-\-no\-dns |
.B \-n\fR, \fB\-\-no\-dns |
| Use this option to force | Use this option to force |
| .B mtr | .B mtr |
| to display numeric IP numbers and not try to resolve the |
to display numeric IP numbers and not try to resolve the |
| host names. | host names. |
| .TP |
.TP |
| .B \-b\fR, \fB\-\-show\-ips |
.B \-b\fR, \fB\-\-show\-ips |
| Use this option to tell |
Use this option to tell |
|
Line 288 Use this option to tell
|
Line 288 Use this option to tell
|
| to display both the host names and numeric IP numbers. In split mode |
to display both the host names and numeric IP numbers. In split mode |
| this adds an extra field to the output. In report mode, there is usually |
this adds an extra field to the output. In report mode, there is usually |
| too little space to add the IPs, and they will be truncated. Use the |
too little space to add the IPs, and they will be truncated. Use the |
| wide report (-w) mode to see the IPs in report mode. | wide report (-w) mode to see the IPs in report mode. |
| .TP |
.TP |
| .B \-o \fIFIELDS\fR, \fB\-\-order \fIFIELDS |
.B \-o \fIFIELDS\fR, \fB\-\-order \fIFIELDS |
| Use this option to specify which fields to display and in which order. |
Use this option to specify which fields to display and in which order. |
|
Line 354 root user may choose values between zero and one.
|
Line 354 root user may choose values between zero and one.
|
| .TP |
.TP |
| .B \-c \fICOUNT\fR, \fB\-\-report\-cycles \fICOUNT |
.B \-c \fICOUNT\fR, \fB\-\-report\-cycles \fICOUNT |
| Use this option to set the number of pings sent to determine |
Use this option to set the number of pings sent to determine |
| both the machines on the network and the reliability of | both the machines on the network and the reliability of |
| those machines. Each cycle lasts one second. |
those machines. Each cycle lasts one second. |
| .TP |
.TP |
| .B \-s \fIPACKETSIZE\fR, \fB\-\-psize \fIPACKETSIZE |
.B \-s \fIPACKETSIZE\fR, \fB\-\-psize \fIPACKETSIZE |
|
Line 378 Specifies value for type of service field in IP header
|
Line 378 Specifies value for type of service field in IP header
|
| - 255. |
- 255. |
| .TP |
.TP |
| .B \-e\fR, \fB\-\-mpls |
.B \-e\fR, \fB\-\-mpls |
| Use this option to tell | Use this option to tell |
| .B mtr | .B mtr |
| to display information from ICMP extensions for MPLS (RFC 4950) |
to display information from ICMP extensions for MPLS (RFC 4950) |
| that are encoded in the response packets. |
that are encoded in the response packets. |
| .TP |
.TP |
|
Line 501 can be controlled while it is running with the followi
|
Line 501 can be controlled while it is running with the followi
|
| z toggle ASN info on/off |
z toggle ASN info on/off |
| q exit |
q exit |
| .SH BUGS |
.SH BUGS |
| Some modern routers give a lower priority to ICMP ECHO packets than | Some modern routers give a lower priority to ICMP ECHO packets than |
| to other network traffic. Consequently, the reliability of these |
to other network traffic. Consequently, the reliability of these |
| routers reported by | routers reported by |
| .B mtr |
.B mtr |
| will be significantly lower than the actual reliability of | will be significantly lower than the actual reliability of |
| these routers. | these routers. |
| .SH CONTACT INFORMATION |
.SH CONTACT INFORMATION |
| .PP |
.PP |
| For the latest version, see the mtr web page at | For the latest version, see the mtr web page at |
| .UR http://\:www.\:bitwizard.\:nl/\:mtr/ |
.UR http://\:www.\:bitwizard.\:nl/\:mtr/ |
| .UE |
.UE |
| .PP |
.PP |
![[BACK]](/icons/cvsweb/back.gif){kind=icon}
Return to mtr.8.in CVS log ![[TXT]](/icons/cvsweb/text.gif){kind=icon}
![[DIR]](/icons/cvsweb/dir.gif){kind=icon}
Up to [ELWIX - Embedded LightWeight unIX -] / embedaddon / mtr / man