version 1, including all changes.
.
Rev |
Author |
# |
Line |
1 |
perry |
1 |
MTR |
|
|
2 |
!!!MTR |
|
|
3 |
NAME |
|
|
4 |
SYNOPSIS |
|
|
5 |
DESCRIPTION |
|
|
6 |
OPTIONS |
|
|
7 |
BUGS |
|
|
8 |
CONTACT INFORMATION |
|
|
9 |
SEE ALSO |
|
|
10 |
---- |
|
|
11 |
!!NAME |
|
|
12 |
|
|
|
13 |
|
|
|
14 |
mtr - a network diagnostic tool |
|
|
15 |
!!SYNOPSIS |
|
|
16 |
|
|
|
17 |
|
|
|
18 |
__mtr__ [[__-hvrctglsni__] [[__--help__] |
|
|
19 |
[[__--version__] [[__--report__] [[__--report-cycles |
|
|
20 |
COUNT__] [[__--curses__] [[__--split__] [[__--raw__] |
|
|
21 |
[[__--no-dns__] [[__--gtk__] [[__--address |
|
|
22 |
IP.ADD.RE.SS__] [[__--interval SECONDS__] [[__--psize |
|
|
23 |
BYTES | -p BYTES__] __HOSTNAME |
|
|
24 |
[[PACKETSIZE]__ |
|
|
25 |
!!DESCRIPTION |
|
|
26 |
|
|
|
27 |
|
|
|
28 |
__mtr__ combines the functionality of the |
|
|
29 |
__traceroute__ and __ping__ programs in a single |
|
|
30 |
network diagnostic tool. |
|
|
31 |
|
|
|
32 |
|
|
|
33 |
As __mtr__ starts, it investigates the network connection |
|
|
34 |
between the host __mtr__ runs on and __HOSTNAME__. |
|
|
35 |
After it determines the address of each network hop between |
|
|
36 |
the machines, it sends a sequence ICMP ECHO requests to each |
|
|
37 |
one to determine the quality of the link to each machine. As |
|
|
38 |
it does this, it prints running statistics about each |
|
|
39 |
machine. |
|
|
40 |
!!OPTIONS |
|
|
41 |
|
|
|
42 |
|
|
|
43 |
__-h__ |
|
|
44 |
|
|
|
45 |
|
|
|
46 |
__--help__ |
|
|
47 |
|
|
|
48 |
|
|
|
49 |
Print the summary of command line argument |
|
|
50 |
options. |
|
|
51 |
|
|
|
52 |
|
|
|
53 |
__-v__ |
|
|
54 |
|
|
|
55 |
|
|
|
56 |
__--version__ |
|
|
57 |
|
|
|
58 |
|
|
|
59 |
Print the installed version of mtr. |
|
|
60 |
|
|
|
61 |
|
|
|
62 |
__-r__ |
|
|
63 |
|
|
|
64 |
|
|
|
65 |
__--report__ |
|
|
66 |
|
|
|
67 |
|
|
|
68 |
This option puts __mtr__ into __report__ mode. When in |
|
|
69 |
this mode, __mtr__ will run for the number of cycles |
|
|
70 |
specified by the __-c__ option, and then print statistics |
|
|
71 |
and exit. |
|
|
72 |
|
|
|
73 |
|
|
|
74 |
This mode is useful for generating statistics about network |
|
|
75 |
quality. Note that each running instance of __mtr__ |
|
|
76 |
generates a significant amount of network traffic. Using |
|
|
77 |
__mtr__ to measure the quality of your network may result |
|
|
78 |
in decreased network performance. |
|
|
79 |
|
|
|
80 |
|
|
|
81 |
__-c COUNT__ |
|
|
82 |
|
|
|
83 |
|
|
|
84 |
__--report-cycles COUNT__ |
|
|
85 |
|
|
|
86 |
|
|
|
87 |
Use this option to set the number of pings sent to determine |
|
|
88 |
both the machines on the network and the reliability of |
|
|
89 |
those machines. Each cycle lasts one second. This option is |
|
|
90 |
only useful with the __-r__ option. |
|
|
91 |
|
|
|
92 |
|
|
|
93 |
__-p BYTES__ |
|
|
94 |
|
|
|
95 |
|
|
|
96 |
__--psize BYTES__ |
|
|
97 |
|
|
|
98 |
|
|
|
99 |
__PACKETSIZE__ |
|
|
100 |
|
|
|
101 |
|
|
|
102 |
These options or a trailing PACKETSIZE on the commandline |
|
|
103 |
sets the packet size used for probing. It is in bytes |
|
|
104 |
inclusive IP and ICMP headers |
|
|
105 |
|
|
|
106 |
|
|
|
107 |
__-t__ |
|
|
108 |
|
|
|
109 |
|
|
|
110 |
__--curses__ |
|
|
111 |
|
|
|
112 |
|
|
|
113 |
Use this option to force __mtr__ to use the curses based |
|
|
114 |
terminal interface (if available). |
|
|
115 |
|
|
|
116 |
|
|
|
117 |
__-n__ |
|
|
118 |
|
|
|
119 |
|
|
|
120 |
__--no-dns__ |
|
|
121 |
|
|
|
122 |
|
|
|
123 |
Use this option to force __mtr__ to display numeric IP |
|
|
124 |
numbers and not try to resolve the host names. |
|
|
125 |
|
|
|
126 |
|
|
|
127 |
__-g__ |
|
|
128 |
|
|
|
129 |
|
|
|
130 |
__--gtk__ |
|
|
131 |
|
|
|
132 |
|
|
|
133 |
Use this option to force __mtr__ to use the GTK+ based |
|
|
134 |
X11 window interface (if available). GTK+ must have been |
|
|
135 |
available on the system when __mtr__ was built for this |
|
|
136 |
to work. See the GTK+ web page at |
|
|
137 |
__http://www.gimp.org/gtk/__ for more information about |
|
|
138 |
GTK+. |
|
|
139 |
|
|
|
140 |
|
|
|
141 |
__-s__ |
|
|
142 |
|
|
|
143 |
|
|
|
144 |
__--split__ |
|
|
145 |
|
|
|
146 |
|
|
|
147 |
Use this option to set __mtr__ to spit out a format that |
|
|
148 |
is suitable for a split-user interface. |
|
|
149 |
|
|
|
150 |
|
|
|
151 |
__-l__ |
|
|
152 |
|
|
|
153 |
|
|
|
154 |
__--raw__ |
|
|
155 |
|
|
|
156 |
|
|
|
157 |
Use this option to tell __mtr__ to use the raw output |
|
|
158 |
format. This format is better suited for archival of the |
|
|
159 |
measurement results. It could be parsed to be presented into |
|
|
160 |
any of the other display methods. |
|
|
161 |
|
|
|
162 |
|
|
|
163 |
__-a IP.ADD.RE.SS__ |
|
|
164 |
|
|
|
165 |
|
|
|
166 |
__--address IP.ADD.RE.SS__ |
|
|
167 |
|
|
|
168 |
|
|
|
169 |
Use this option to bind outgoing packets' socket to specific |
|
|
170 |
interface, so that any packet will be sent through this |
|
|
171 |
interface. NOTE that this option doesn't apply to DNS |
|
|
172 |
requests (which could be and could not be what you |
|
|
173 |
want). |
|
|
174 |
|
|
|
175 |
|
|
|
176 |
__-i SECONDS__ |
|
|
177 |
|
|
|
178 |
|
|
|
179 |
__--interval SECONDS__ |
|
|
180 |
|
|
|
181 |
|
|
|
182 |
Use this option to specify the positive number of seconds |
|
|
183 |
between ICMP ECHO requests. The default value for this |
|
|
184 |
parameter is one second. |
|
|
185 |
!!BUGS |
|
|
186 |
|
|
|
187 |
|
|
|
188 |
Some modern routers give a lower priority to ICMP ECHO |
|
|
189 |
packets than to other network traffic. Consequently, the |
|
|
190 |
reliability of these routers reported by __mtr__ will be |
|
|
191 |
significantly lower than the actual reliability of these |
|
|
192 |
routers. |
|
|
193 |
!!CONTACT INFORMATION |
|
|
194 |
|
|
|
195 |
|
|
|
196 |
For the latest version, see the mtr web page at |
|
|
197 |
__http://www.bitwizard.nl/mtr/__. |
|
|
198 |
|
|
|
199 |
|
|
|
200 |
Subscribe to the mtr mailing list. All mtr related |
|
|
201 |
announcements are posted to the mtr mailing list. To |
|
|
202 |
subscribe, send email to __majordomo@lists.xmission.com__ |
|
|
203 |
with __subscribe mtr__ in the body of the message. To |
|
|
204 |
send a message to the mailing list, mail to |
|
|
205 |
__mtr@lists.xmission.com__. |
|
|
206 |
|
|
|
207 |
|
|
|
208 |
Bug reports and feature requests should be sent to the mtr |
|
|
209 |
mailing list. |
|
|
210 |
!!SEE ALSO |
|
|
211 |
|
|
|
212 |
|
|
|
213 |
traceroute(8), ping(8). |
|
|
214 |
---- |