.TH MTR 8 "0.96" "mtr" "مدیریت سیستم"
.SH "نام (NAME)"
mtr \- ابزار جامع عیب‌یابی و ردیابی مسیر شبکه (تلفیق traceroute و ping)
.SH "خلاصه دستور (SYNOPSIS)"
.B mtr
[\c
.BR \-4 |\c
.B \-6\c
]
[\c
.BI \-F \ FILENAME\c
]
[\c
.B \-\-report\c
]
[\c
.B \-\-report-wide\c
]
[\c
.B \-\-xml\c
]
[\c
.B \-\-gtk\c
]
[\c
.B \-\-curses\c
]
[\c
.BI \--displaymode \ MODE\c
]
[\c
.B \-\-raw\c
]
[\c
.B \-\-csv\c
]
[\c
.B \-\-json\c
]
[\c
.B \-\-split\c
]
[\c
.B \-\-no-dns\c
]
[\c
.B \-\-show-ips\c
]
[\c
.BI \-o \ FIELDS\c
]
[\c
.BI \-y \ IPINFO\c
]
[\c
.B \-\-aslookup\c
]
[\c
.BI \-\-ipinfo_provider4 \ DOMAIN\c
]
[\c
.BI \-\-ipinfo_provider6 \ DOMAIN\c
]
[\c
.BI \-i \ INTERVAL\c
]
[\c
.BI \-c \ COUNT\c
]
[\c
.BI \-s \ PACKETSIZE\c
]
[\c
.BI \-B \ BITPATTERN\c
]
[\c
.BI \-G \ GRACEPERIOD\c
]
[\c
.BI \-Q \ TOS\c
]
[\c
.B \-\-mpls\c
]
[\c
.BI \-I \ NAME\c
]
[\c
.BI \-a \ ADDRESS\c
]
[\c
.BI \-f \ FIRST\-TTL\c
]
[\c
.BI \-m \ MAX\-TTL\c
]
[\c
.BI \-U \ MAX\-UNKNOWN\c
]
[\c
.BI \-E \ MAX\-DISPLAY\-PATH\c
]
[\c
.B \-\-udp\c
]
[\c
.B \-\-tcp\c
]
[\c
.BI \-\-sctp\c
]
[\c
.BI \-P \ PORT\c
]
[\c
.BI \-L \ LOCALPORT\c
]
[\c
.BI \-Z \ TIMEOUT\c
]
[\c
.BI \-M \ MARK\c
]
.I HOSTNAME
.SH "توضیحات (DESCRIPTION)"
.B mtr
قابلیت‌های برنامه‌های
.B traceroute
و
.B ping
را در یک ابزار واحد عیب‌یابی شبکه تلفیق می‌کند.
.PP
هنگامی که
.B mtr
شروع به کار می‌کند، با ارسال بسته‌هایی با TTL (زمان حیات) عمدتاً پایین، ارتباط شبکه‌ای میان میزبانی که
.B mtr
روی آن اجرا می‌شود و
.B HOSTNAME
را بررسی می‌نماید. این ابزار به ارسال بسته‌ها با TTL پایین ادامه داده و زمان پاسخگویی مسیریاب‌های واسط را ثبت می‌کند. این سازوکار به
.B mtr
امکان می‌دهد تا درصد پاسخگویی و زمان‌های پاسخ مسیر اینترنتی به
.B HOSTNAME
را چاپ کند. افزایش ناگهانی در افت بسته (packet loss) یا زمان پاسخگویی اغلب نشان‌دهنده یک پیوند ارتباطی نامناسب (یا صرفاً بارگذاری بیش‌ازحد) است.
.PP
نتایج معمولاً به‌صورت زمان‌های پاسخ رفت‌وبرگشت (RTT) بر حسب میلی‌ثانیه و درصد بسته‌های گم‌شده (افت بسته) گزارش می‌شوند.
.SH "گزینه‌ها (OPTIONS)"
.TP
.B \-h\fR, \fB\-\-help
چاپ خلاصه‌ای از گزینه‌ها و شناسه‌های خط فرمان.
.TP
.B \-v\fR, \fB\-\-version
چاپ نسخه نصب‌شده mtr.
.TP
.B \-4
استفاده انحصاری از IPv4.
.TP
.B \-6
استفاده انحصاری از IPv6 (ممکن است برای پرس‌وجوهای DNS همچنان از IPv4 استفاده شود).
.TP
.B \-F \fIFILENAME\fR, \fB\-\-filename \fIFILENAME
خواندن فهرست نام‌های میزبان از فایل مشخص‌شده.
.TP
.B \-r\fR, \fB\-\-report
این گزینه
.B mtr
را در حالت گزارش‌گیری
.RB ( report )
قرار می‌دهد. در این حالت،
.B mtr
به تعداد چرخه‌های مشخص‌شده توسط گزینه
.B \-c
اجرا می‌شود و سپس آمار را چاپ کرده و خارج می‌گردد.
.IP
این حالت برای تولید آمار درباره کیفیت شبکه مفید است. توجه داشته باشید که هر نمونه در حال اجرای
.B mtr
حجم قابل‌توجهی از ترافیک شبکه ایجاد می‌کند. استفاده از
.B mtr
برای سنجش کیفیت شبکه ممکن است باعث کاهش عملکرد شبکه شود.
.TP
.B \-w\fR, \fB\-\-report\-wide
این گزینه
.B mtr
را در حالت گزارش عریض
.RB ( "wide report" )
قرار می‌دهد. در این حالت،
.B mtr
نام میزبان‌ها را در گزارش کوتاه یا قطع نمی‌کند.
.TP
.B \-x\fR, \fB\-\-xml
استفاده از این گزینه به
.B mtr
می‌گوید که از قالب خروجی XML استفاده کند. این قالب برای پردازش خودکار نتایج اندازه‌گیری مناسب‌تر است.
.TP
.B \-t\fR, \fB\-\-curses
استفاده از این گزینه
.B mtr
را مجبور می‌کند تا از رابط ترمینالی مبتنی بر curses استفاده کند (در صورت در دسترس بودن). در صورتی که تعداد گام‌ها (hops) از ارتفاع ترمینال شما بیشتر شود، می‌توانید از کلیدهای
.B +
و
.B -
برای پیمایش نیم‌صفحه‌ای به بالا و پایین استفاده کنید.

کلید ترکیبی
.B Ctrl\fR-\fPL
پیام‌های خطای کاذب که ممکن است بخش‌های دیگر صفحه نمایش را بپوشانند پاک می‌کند.
.TP
.B \-\-displaymode \fIMODE
انتخاب حالت نمایش اولیه: مقدار 0 (پیش‌فرض) حالت آمار را انتخاب می‌کند، مقدار 1 نمودار نواری (stripchart) بدون اطلاعات تأخیر را انتخاب می‌کند و مقدار 2 نمودار نواری همراه با اطلاعات تأخیر را انتخاب می‌نماید.
.TP
.B \-g\fR, \fB\-\-gtk
استفاده از این گزینه
.B mtr
را مجبور می‌کند تا از رابط پنجره‌ای X11 مبتنی بر +GTK استفاده کند (در صورت در دسترس بودن). برای کارکرد این قابلیت، +GTK باید در زمان کامپایل و ساخت
.B mtr
روی سیستم موجود بوده باشد. برای اطلاعات بیشتر درباره +GTK به وب‌سایت آن در
.UR https://www.gtk.org
.UE
مراجعه کنید.
.TP
.B \-l\fR, \fB\-\-raw
استفاده از قالب خروجی خام (raw). این قالب برای بایگانی نتایج اندازه‌گیری مناسب‌تر است و می‌توان آن را برای نمایش در هر یک از روش‌های دیگر تحلیل و پارس کرد.
.IP
نمونه‌ای از قالب خروجی خام:
.nf
h 0 10.1.1.1
p 0 339
h 1 46.149.16.4
p 1 530
h 2 172.31.1.16
p 2 531
h 3 82.221.168.236
p 3 1523
h 5 195.130.211.8
p 5 1603
h 6 193.4.58.17
p 6 1127
h 7 193.4.58.17
d 7 www.isnic.is
.fi
.TP
.B \-C\fR, \fB\-\-csv
استفاده از قالب خروجی مقادیر جداشده با کاما (CSV). (نکته: جداکننده در واقع نقطه-ویرگول ';' است).
.IP
نمونه‌ای از قالب خروجی CSV:
.nf
MTR.0.86+git:16e39fc0;1435562787;OK;nic.is;1;r-76520-PROD.greenqloud.internal;288
MTR.0.86+git:16e39fc0;1435562787;OK;nic.is;2;46.149.16.4;2086
MTR.0.86+git:16e39fc0;1435562787;OK;nic.is;3;172.31.1.16;600
MTR.0.86+git:16e39fc0;1435562787;OK;nic.is;4;82.221.168.236;1163
MTR.0.86+git:16e39fc0;1435562787;OK;nic.is;5;???;0
MTR.0.86+git:16e39fc0;1435562787;OK;nic.is;6;rix-k2-gw.isnic.is;1654
MTR.0.86+git:16e39fc0;1435562787;OK;nic.is;7;www.isnic.is;1036
.fi
.TP
.B \-j\fR, \fB\-\-json
استفاده از این گزینه به
.B mtr
می‌گوید که از قالب خروجی JSON استفاده کند. این قالب برای پردازش خودکار نتایج اندازه‌گیری مناسب‌تر است. برای کارکرد این قابلیت، کتابخانه Jansson باید در زمان ساخت
.B mtr
روی سیستم موجود بوده باشد.
.TP
.B \-p\fR, \fB\-\-split
تنظیم
.B mtr
برای ارائه خروجی در قالبی که برای یک رابط کاربری تفکیک‌شده (split-user interface) مناسب است.
.TP
.B \-n\fR, \fB\-\-no\-dns
این گزینه
.B mtr
را مجبور می‌کند تا فقط نشانی‌های عددی IP را نمایش دهد و تلاشی برای حل نام‌های میزبان (DNS resolution) انجام ندهد.
.TP
.B \-b\fR, \fB\-\-show\-ips
این گزینه به
.B mtr
می‌گوید که هم نام‌های میزبان و هم نشانی‌های عددی IP را نمایش دهد. در حالت تفکیک‌شده (split) این گزینه یک فیلد اضافی به خروجی می‌افزاید. در حالت گزارش‌گیری (report)، معمولاً فضای کافی برای افزودن IPها وجود ندارد و آن‌ها کوتاه می‌شوند. در حالت گزارش‌گیری، برای دیدن نشانی‌های IP از حالت گزارش عریض
.RB ( \-w )
استفاده کنید.
.TP
.B \-o \fIFIELDS\fR, \fB\-\-order \fIFIELDS
مشخص کردن این‌که کدام فیلدها و با چه ترتیبی نمایش داده شوند. می‌توانید از یک یا چند نویسه فاصله برای جداسازی فیلدها استفاده کنید.
.br
فیلدهای موجود:
.TS
center allbox tab(%);
ll.
L%نسبت افت بسته (Loss ratio)
D%بسته‌های از دست رفته (Dropped packets)
R%بسته‌های دریافت شده (Received packets)
S%بسته‌های ارسال شده (Sent Packets)
N%جدیدترین RTT بر حسب میلی‌ثانیه (Newest RTT)
B%حداقل / بهترین RTT بر حسب میلی‌ثانیه (Min/Best RTT)
A%میانگین RTT بر حسب میلی‌ثانیه (Average RTT)
W%حداکثر / بدترین RTT بر حسب میلی‌ثانیه (Max/Worst RTT)
V%انحراف معیار (Standard Deviation)
G%میانگین هندسی (Geometric Mean)
J%ژیتر فعلی (Current Jitter)
M%میانگین ژیتر (Jitter Mean/Avg.)
X%بدترین ژیتر (Worst Jitter)
I%ژیتر بین زمان ورود بسته‌ها (Interarrival Jitter)
.TE
.br

مثال:
.nf
-o "LSD NBAW  X"
.fi
.TP
.B \-y \fIn\fR, \fB\-\-ipinfo \fIn
نمایش اطلاعات درباره هر گام (hop) شبکه IP. مقادیر معتبر برای \fIn\fR عبارتند از:
.TS
tab(%);
ll.
0%نمایش شماره سامانه خودمختار (AS) (معادل \fB-z\fR)
1%نمایش پیشوند IP
2%نمایش کد کشور مربوط به AS مبدا
3%نمایش ثبت‌کننده منطقه‌ای اینترنت یا RIR (مانند ripencc، arin، ...)
4%نمایش تاریخ تخصیص پیشوند IP
.TE
.br

امکان جابه‌جایی چرخشی میان این فیلدها در زمان اجرا (با استفاده از کلید \fBy\fR) وجود دارد.
.TP
.B \-z\fR, \fB\-\-aslookup
نمایش شماره سامانه خودمختار (AS) در کنار هر گام. معادل با \fB\-\-ipinfo 0\fR.
.IP
مثال (ستون‌های سمت راست برای وضوح بیشتر حذف شده‌اند):
.nf
1. AS???   r-76520-PROD.greenqloud.internal
2. AS51969 46.149.16.4
3. AS???   172.31.1.16
4. AS30818 82.221.168.236
5. ???
6. AS???   rix-k2-gw.isnic.is
7. AS1850  www.isnic.is
.fi
.TP
.B \-\-ipinfo_provider4 \fIDOMAIN
سرویس‌دهنده برای جستجوی سامانه خودمختار (AS) در IPv4. مقدار پیش‌فرض origin.asn.cymru.com است.
.TP
.B \-\-ipinfo_provider6 \fIDOMAIN
سرویس‌دهنده برای جستجوی سامانه خودمختار (AS) در IPv6. مقدار پیش‌فرض origin6.asn.cymru.com است.
.TP
.B \-i \fISECONDS\fR, \fB\-\-interval \fISECONDS
مشخص کردن تعداد ثانیه‌های مثبت بین درخواست‌های ICMP ECHO. مقدار پیش‌فرض این پارامتر یک ثانیه است. کاربر ارشد (root) می‌تواند مقادیری بین صفر و یک را نیز انتخاب کند.
.TP
.B \-c \fICOUNT\fR, \fB\-\-report\-cycles \fICOUNT
تعیین تعداد پینگ‌های ارسالی برای شناسایی دستگاه‌های موجود در شبکه و میزان پایداری و قابلیت اطمینان آن‌ها. هر چرخه یک ثانیه طول می‌کشد.
.TP
.B \-s \fIPACKETSIZE\fR, \fB\-\-psize \fIPACKETSIZE
این گزینه اندازه بسته مورد استفاده برای کاوش را مشخص می‌کند (بر حسب بایت، شامل سرآیندهای IP و ICMP).

اگر روی یک عدد منفی تنظیم شود، در هر تکرار از یک اندازه بسته تصادفی و متفاوت تا سقف آن مقدار استفاده خواهد شد.
.TP
.B \-B \fINUM\fR, \fB\-\-bitpattern \fINUM
الگوی بیتی مورد استفاده در بار داده (payload) را مشخص می‌کند. باید در محدوده 0 تا 255 باشد. اگر
.I NUM
بزرگتر از 255 باشد، از یک الگوی تصادفی استفاده می‌شود.
.TP
.B \-G \fISECONDS\fR, \fB\-\-gracetime \fISECONDS
مشخص کردن تعداد ثانیه‌های مثبت برای انتظار دریافت پاسخ پس از ارسال آخرین درخواست. مقدار پیش‌فرض پنج ثانیه است.
.TP
.B \-Q \fINUM\fR, \fB\-\-tos \fINUM
مقدار فیلد نوع سرویس (Type of Service یا TOS) را در سرآیند IP مشخص می‌کند. باید در محدوده 0 تا 255 باشد.
.TP
.B \-e\fR, \fB\-\-mpls
این گزینه به
.B mtr
می‌گوید که اطلاعات مربوط به افزونه‌های ICMP برای MPLS (استاندارد RFC 4950) را که در بسته‌های پاسخ کدگذاری شده‌اند، نمایش دهد.
.TP
.B \-I \fINAME\fR, \fB\-\-interface \fINAME
استفاده از رابط شبکه با نام مشخص برای ارسال کاوش‌های شبکه. این گزینه زمانی مفید است که چندین رابط شبکه با مسیرهای منتهی به مقصد داشته باشید (برای مثال هم اترنت سیمی و هم وای‌فای) و بخواهید یک رابط خاص را آزمایش کنید.
.TP
.B \-a \fIADDRESS\fR, \fB\-\-address \fIADDRESS
اتصال سوکت خروجی به
.IR ADDRESS ،
به‌طوری‌که تمام بسته‌ها با
.I ADDRESS
به‌عنوان نشانی مبدا ارسال شوند. توجه داشته باشید که این گزینه برای درخواست‌های DNS اعمال نمی‌شود (که ممکن است مطابق میل شما باشد یا نباشد).
.TP
.B \-f \fINUM\fR, \fB\-\-first-ttl \fINUM
مشخص می‌کند که کاوش با چه مقدار TTL (زمان حیات) آغاز شود. مقدار پیش‌فرض 1 است.
.TP
.B \-m \fINUM\fR, \fB\-\-max-ttl \fINUM
حداکثر تعداد گام‌ها (حداکثر مقدار زمان حیات یا TTL) که ردیابی مسیر کاوش خواهد کرد را مشخص می‌کند. مقدار پیش‌فرض 30 است.
.TP
.B \-U \fINUM\fR, \fB\-\-max-unknown \fINUM
حداکثر تعداد میزبان‌های ناشناخته متوالی را مشخص می‌کند. مقدار پیش‌فرض 5 است.
.TP
.B \-E \fINUM\fR, \fB\-\-max-display-path \fINUM
حداکثر تعداد مسیرهای ECMP (چندمسیره با هزینه برابر) را برای نمایش مشخص می‌کند. مقدار پیش‌فرض 8 است.
.TP
.B \-u\fR, \fB\-\-udp
استفاده از دیتاگرام‌های UDP به‌جای درخواست‌های ICMP ECHO.
.TP
.B \-T\fR, \fB\-\-tcp
استفاده از بسته‌های TCP SYN به‌جای ICMP ECHO. شناسه
.I PACKETSIZE
نادیده گرفته می‌شود زیرا بسته‌های SYN نمی‌توانند حاوی داده باشند.
.TP
.B \-S\fR, \fB\-\-sctp
استفاده از بسته‌های پروتکل انتقال کنترل جریان (SCTP) به‌جای ICMP ECHO.
.TP
.B \-P \fIPORT\fR, \fB\-\-port \fIPORT
شماره پورت مقصد برای ردیابی‌های TCP/SCTP/UDP.
.TP
.B \-L \fILOCALPORT\fR, \fB\-\-localport \fILOCALPORT
شماره پورت مبدا برای ردیابی‌های UDP.
.TP
.B \-Z \fISECONDS\fR, \fB\-\-timeout \fISECONDS
تعداد ثانیه‌هایی که سوکت‌های کاوشگر پیش از انصراف از اتصال باز نگه داشته می‌شوند. استفاده از مقادیر بزرگ برای این گزینه، به‌ویژه در ترکیب با فواصل زمانی کوتاه، تعداد زیادی توصیف‌کننده فایل (file descriptor) را مصرف خواهد کرد.
.TP
.B \-M \fIMARK\fR, \fB\-\-mark \fIMARK
تنظیم علامت (mark) برای هر بسته ارسالی از طریق این سوکت، مشابه هدف MARK در netfilter ولی به‌صورت مبتنی بر سوکت.
.I MARK
یک عدد صحیح ۳۲ بیتی بدون علامت است. برای توضیحات کامل درباره این گزینه سوکت به
.BR socket (7)
مراجعه کنید.
.SH "محیط (ENVIRONMENT)"
برنامه
.B mtr
چند متغیر محیطی را شناسایی می‌کند.
.TP
.B MTR_OPTIONS
این متغیر محیطی امکان مشخص کردن گزینه‌ها را به همان صورت که در خط فرمان وارد می‌شوند فراهم می‌کند. این متغیر پیش از خواندن گزینه‌های واقعی خط فرمان پردازش می‌شود، بنابراین گزینه‌های مشخص‌شده در
.B MTR_OPTIONS
توسط گزینه‌های خط فرمان بازنویسی و جایگزین می‌شوند.
.IP
مثال:
.nf
\fBMTR_OPTIONS\fR="-4 -c 1" \fBmtr\fR \fI-6 localhost\fR
.fi
.IP
یک کاوش (به دلیل
.IR "-c 1" )
به سمت
.B ::1
(به دلیل
.IR -6
که بر
.I -4
تعیین‌شده در
.B MTR_OPTIONS
اولویت دارد) ارسال خواهد کرد.
.TP
.B MTR_PACKET
مسیری به فایل اجرایی
.IR mtr-packet ،
جهت استفاده برای ارسال و دریافت کاوش‌های شبکه. اگر
.B MTR_PACKET
تنظیم نشده باشد، از متغیر
.B PATH
برای یافتن فایل اجرایی
.I mtr-packet
استفاده خواهد شد.
.TP
.B DISPLAY
یک سرور X11 را برای رابط کاربری گرافیکی +GTK مشخص می‌کند.
.SH "کنترل تعاملی (INTERACTIVE CONTROL)"
.B mtr
را می‌توان در حین اجرا با استفاده از کلیدهای زیر کنترل کرد:
.PP
.nf
  ?|h     راهنما
  p       توقف موقت (مکث) (کلید فاصله برای ادامه)
  d       تغییر حالت نمایش
  e       فعال/غیرفعال کردن نمایش اطلاعات MPLS
  n       فعال/غیرفعال کردن DNS
  r       بازنشانی تمامی شمارنده‌ها
  o str   تنظیم ستون‌های نمایشی، پیش‌فرض str='LRS N BAWV'
  j       تغییر حالت آمار تأخیر (LS NABWV) / ژیتر (DR AGJMXI)
  c <n>   تعداد چرخه گزارش n، پیش‌فرض n=بی‌نهایت
  i <n>   تنظیم بازه پینگ روی n ثانیه، پیش‌فرض n=1
  f <n>   تنظیم زمان حیات (TTL) اولیه، پیش‌فرض n=1
  m <n>   تنظیم حداکثر زمان حیات، پیش‌فرض n=تعداد گام‌ها
  s <n>   تنظیم اندازه بسته به n یا تصادفی (n<0)
  b <c>   تنظیم الگوی بیتی پینگ روی c(0..255) یا تصادفی (c<0)
  Q <t>   تنظیم TOS بسته پینگ روی t
  u       جابه‌جایی بین دیتاگرام‌های ICMP ECHO و UDP
  y       تغییر اطلاعات IP
  z       فعال/غیرفعال کردن اطلاعات سامانه خودمختار (ASN)
  q       خروج
.fi
.SH "اشکالات (BUGS)"
برخی از مسیریاب‌های مدرن اولویت کمتری برای بسته‌های ICMP ECHO نسبت به سایر ترافیک‌های شبکه قائل می‌شوند. در نتیجه، پایداری و قابلیت اطمینان این مسیریاب‌ها که توسط
.B mtr
گزارش می‌شود، به‌طور چشمگیری کمتر از قابلیت اطمینان واقعی آن‌ها خواهد بود.
.SH "اطلاعات تماس (CONTACT INFORMATION)"
.PP
برای دریافت جدیدترین نسخه، به صفحه وب mtr مراجعه کنید:
.UR http://www.bitwizard.nl/mtr
.UE
.PP
جهت ارسال وصله‌ها (patches)، گزارش باگ‌ها یا درخواست قابلیت‌های جدید، لطفاً یک Issue در گیت‌هاب ایجاد کنید:
.UR https://github.com/traviscross/mtr
.UE
.PP
.SH "همچنین ببینید (SEE ALSO)"
.BR mtr-packet (8),
.BR traceroute (8),
.BR ping (8),
.BR socket (7),
TCP/IP Illustrated (Stevens, ISBN 0201633469).