.TH MTR-PACKET 8 "0.96" "mtr-packet" "System Administration"
.HP 7
.SH "نام (NAME)"
mtr-packet \- ابزار ارسال و ردیابی بسته‌های شبکه برای MTR
.SH "توضیحات (DESCRIPTION)"
.B mtr-packet
ابزاری برای ارسال بسته‌های کاوش شبکه جهت سنجش اتصال و عملکرد شبکه است. چندین بسته کاوش شبکه را می‌توان به صورت همزمان توسط یک فرآیند منفرد از
.B mtr-packet
ارسال کرد و بسته‌های کاوش بیشتری را می‌توان توسط نمونه‌ای از
.B mtr-packet
که در حال حاضر کاوش‌های شبکه‌ای در حال ارسال دارد، تولید نمود. این ابزار برای استفاده توسط برنامه‌هایی طراحی شده است که آن را به همراه پایپ‌های یونیکس متصل به جریان‌های ورودی و خروجی استاندارد اجرا می‌کنند.
.LP
.B mtr-packet
درخواست‌های دستور را از
.IR stdin ،
که هر کدام با یک نویسه خط جدید از هم جدا شده‌اند، می‌خواند و پاسخ‌های دستور را به
.IR stdout ،
که آن‌ها نیز با نویسه خط جدید جدا شده‌اند، ارسال می‌کند. ساختار نحوی درخواست‌ها و پاسخ‌ها یکسان است. قالب زیر استفاده می‌شود:
.LP
.RS
.I TOKEN
.I COMMAND
[\c
.I ARGUMENT-NAME
.I ARGUMENT-VALUE
\&...]
.RE
.LP
.I TOKEN
یک مقدار عددی صحیح و یکتا است. همان مقدار به عنوان
.I TOKEN
برای پاسخ استفاده خواهد شد. این کار برای پیوند دادن پاسخ‌ها با درخواست‌ها ضروری است، زیرا دستورات ممکن است با ترتیبی متفاوت از ترتیب درخواستشان تکمیل شوند. فراخوان‌کننده
.B mtr-packet
باید همیشه از مقدار
.I TOKEN
برای تعیین اینکه کدام درخواست دستور تکمیل شده است استفاده کند.
.LP
.I COMMAND
رشته‌ای است که نوع درخواست دستور را مشخص می‌کند. یک دستور متداول
.BR send-probe
است که یک بسته کاوش شبکه را ارسال می‌کند.
.LP
رشته‌های
.I ARGUMENT-NAME
و رشته‌های
.I ARGUMENT-VALUE
همیشه به صورت جفت می‌آیند. ارائه یک
.I ARGUMENT-NAME
بدون
.IR ARGUMENT-VALUE
متناظر، یک خطای نحوی است. رشته‌های معتبر
.I ARGUMENT-NAME
به
.I COMMAND
مورد استفاده بستگی دارند.
.SH "درخواست‌ها (REQUESTS)"
.TP
.B send-probe
ارسال یک بسته کاوش شبکه به یک آدرس IP مشخص. باید یکی از آرگومان‌های
.B ip-4
یا
.B ip-6
ارائه شود. یک دستور معتبر
.B send-probe
با یکی از پاسخ‌های
.BR reply ،
.BR no-reply
یا
.BR ttl-expired
پاسخ می‌دهد.
.IP
آرگومان‌های زیر را می‌توان استفاده کرد:
.IP
.B ip-4
.I IP-ADDRESS
.HP 14
.IP
آدرس پروتکل اینترنت نسخه ۴ برای کاوش.
.HP 7
.IP
.B ip-6
.I IP-ADDRESS
.HP 14
.IP
آدرس پروتکل اینترنت نسخه ۶ برای کاوش.
.HP 7
.IP
.B protocol
.I PROTOCOL
.HP 14
.IP
پروتکل مورد استفاده برای کاوش شبکه. پروتکل‌های
.BR icmp ،
.BR sctp ،
.BR tcp
و
.B udp
قابل استفاده هستند. پروتکل پیش‌فرض
.B icmp
است.
.HP 7
.IP
.B port
.I PORT-NUMBER
.HP 14
.IP
پورت مقصد مورد استفاده برای کاوش‌های
.BR sctp ،
.BR tcp
یا
.BR udp .
.HP 7
.IP
.B local-ip-4
.I IP-ADDRESS
.HP 14
.IP
آدرس محلی پروتکل اینترنت نسخه ۴ برای استفاده هنگام ارسال کاوش‌ها.
.HP 7
.IP
.B local-ip-6
.I IP-ADDRESS
.HP 14
.IP
آدرس محلی پروتکل اینترنت نسخه ۶ برای استفاده هنگام ارسال کاوش‌ها.
.HP 7
.IP
.B local-port
.I PORT-NUMBER
.HP 14
.IP
برای کاوش‌های
.BR udp ،
شماره پورت محلی که کاوش‌ها از آن ارسال می‌شوند.
.HP 7
.IP
.B timeout
.I TIMEOUT-SECONDS
.HP 14
.IP
تعداد ثانیه‌های انتظار برای دریافت پاسخ کاوش پیش از نادیده گرفتن آن به عنوان مفقود شده و تولید پاسخ دستور
.BR no-reply .
.HP 7
.IP
.B ttl
.I TIME-TO-LIVE
.HP 14
.IP
مقدار زمان بقا (time-to-live) برای هدر بسته پروتکل اینترنت که در ساخت کاوش استفاده می‌شود. این مقدار تعداد پرش‌های شبکه (hops) را مشخص می‌کند که کاوش پیش از تولید پاسخ توسط یک میزبان واسط شبکه، از میان آن‌ها عبور خواهد کرد.
.HP 7
.IP
.B size
.I PACKET-SIZE
.HP 14
.IP
اندازه بسته مورد استفاده برای ارسال کاوش، به بایت، شامل هدر پروتکل اینترنت و هدر پروتکل انتقال.
.HP 7
.IP
.B bit-pattern
.I PATTERN-VALUE
.HP 14
.IP
بار مفید بسته (payload) با بایت‌هایی با مقدار مشخص‌شده پر می‌شود. مقادیر الگوی معتبر در محدوده ۰ تا ۲۵۵ هستند.
.HP 7
.IP
.IP
.B tos
.I TYPE-OF-SERVICE
.HP 14
.IP
در مورد IPv4، فیلد «نوع سرویس» (type of service) در هدر IP روی این مقدار تنظیم می‌شود. در مورد IPv6، فیلد «کلاس ترافیک» (traffic class) تنظیم می‌گردد.
.HP 7
.IP
.B mark
.I ROUTING-MARK
.HP 14
.IP
مقدار نشان بسته برای استفاده در مسیریابی مبتنی بر علامت (mark-based routing). (فقط در لینوکس موجود است.)
.HP 7
.TP
.B check-support
بررسی پشتیبانی از یک ویژگی خاص در این نسخه از
.B mtr-packet
و در این محیط عملیاتی خاص. دستور
.B check-support
با
.BR feature-supported
پاسخ خواهد داد. آرگومان
.B feature
الزامی است.
.HP 7
.IP
.B feature
.I FEATURE-NAME
.HP 14
.IP
نام ویژگی درخواست‌شده.
.HP 7
.IP
برخی از ویژگی‌هایی که می‌توان بررسی کرد عبارتند از:
.BR send-probe ،
.BR ip-4 ،
.BR ip-6 ،
.BR icmp ،
.BR sctp ،
.BR tcp ،
.BR udp
و
.BR mark .
ویژگی
.B version
را می‌توان برای بازیابی نسخه
.B mtr-packet
بررسی کرد.
.SH "پاسخ‌ها (REPLIES)"
.TP
.B reply
میزبان مقصد کاوش
.B send-probe
را دریافت کرد و پاسخ داد. آرگومان‌های
.B reply
عبارتند از:
.HP 7
.IP
.B ip-4
.I IP-ADDRESS
.HP 14
.IP
آدرس پروتکل اینترنت نسخه ۴ میزبانی که به کاوش پاسخ داد.
.HP 7
.IP
.B ip-6
.I IP-ADDRESS
.HP 14
.IP
آدرس پروتکل اینترنت نسخه ۶ میزبانی که به کاوش پاسخ داد.
.HP 7
.IP
.B round-trip-time
.I TIME
.HP 14
.IP
مدت زمانی که میان ارسال کاوش و پاسخ آن سپری شد. این زمان به صورت یک عدد صحیح بر حسب میکروثانیه سپری‌شده ارائه می‌شود.
.HP 7
.TP
.B no-reply
پیش از اتمام مهلت زمانی (timeout)، هیچ پاسخی برای درخواست کاوش دریافت نشد.
.TP
.B ttl-expired
مقدار زمان بقا (time-to-live) برای کاوش ارسال‌شده پیش از رسیدن کاوش به مقصد مورد نظر به پایان رسید. آرگومان‌های
.B ttl-expired
عبارتند از:
.HP 7
.IP
.B ip-4
.I IP-ADDRESS
.HP 14
.IP
آدرس پروتکل اینترنت نسخه ۴ میزبانی که مقدار زمان بقا در آن به پایان رسید.
.HP 7
.IP
.B ip-6
.I IP-ADDRESS
.HP 14
.IP
آدرس پروتکل اینترنت نسخه ۶ میزبانی که مقدار زمان بقا در آن به پایان رسید.
.HP 7
.IP
.B round-trip-time
.I TIME
.HP 14
.IP
مدت زمانی که میان ارسال کاوش و پاسخ آن سپری شد. این زمان به صورت یک عدد صحیح بر حسب میکروثانیه سپری‌شده ارائه می‌شود.
.HP 7
.IP
.B mpls
.I MPLS-LABEL-LIST
.HP 14
.IP
فهرستی از مقادیر سوئیچینگ برچسب چندپروتکلی (MPLS) بازگردانده شده با پاسخ کاوش. اگر آرگومان
.B mpls
حاضر باشد، یک یا چند برچسب MPLS با یک فهرست جدا شده با کاما از مقادیر نمایش داده می‌شوند. مقادیر در گروه‌های چهارتایی ارائه می‌شوند. چهار مقدار نخست در فهرست مربوط به اولین برچسب MPLS، چهار مقدار بعدی مربوط به دومین برچسب MPLS و به همین ترتیب خواهند بود. مقادیر به این ترتیب ارائه می‌شوند:
.IR label ،
.IR traffic-class ،
.IR bottom-of-stack ،
.IR ttl .
.HP 7
.TP
.B no-route-network
.B no-route-host
هیچ مسیری به شبکه یا خود میزبان برای درخواست
.B send-probe
که برای رسیدن به میزبان استفاده شده بود وجود نداشت.
.TP
.B network-down
کاوش ارسال نشد زیرا شبکه قطع است.
.TP
.B host-down
کاوش ارسال نشد زیرا میزبان از کار افتاده است.
.TP
.B probes-exhausted
کاوش ارسال نشد زیرا در حال حاضر تعداد بسیار زیادی کاوش تعیین‌تکلیف‌نشده در حال ارسال وجود دارند.
.TP
.B permission-denied
سیستم‌عامل اجازه ارسال کاوش با گزینه‌های مشخص‌شده را نداد.
.TP
.B invalid-argument
درخواست دستور حاوی آرگومان‌های نامعتبر بود.
.TP
.B feature-support
پاسخی ارائه شده به
.B check-support
که نشان‌دهنده در دسترس بودن یک ویژگی خاص است. آرگومان ارائه‌شده عبارت است از:
.HP 7
.IP
.B support
.I PRESENT
.HP 14
.IP
در اکثر موارد، مقدار
.I PRESENT
یا
.BR ok
(نشان‌دهنده پشتیبانی از ویژگی) یا
.BR no
(نشان‌دهنده عدم پشتیبانی از ویژگی) خواهد بود.
.IP
در صورتی که
.B version
نام ویژگی درخواست‌شده
.RI ( FEATURE-NAME )
باشد، نسخه
.B mtr-packet
به عنوان مقدار
.I PRESENT
ارائه می‌شود.
.HP 7
.IP
.SH "مثال‌ها (EXAMPLES)"
یک برنامه کنترل‌کننده ممکن است
.B mtr-packet
را به عنوان یک فرآیند فرزند شروع کند و دستور زیر را روی
.IR stdin
صادر کند:
.LP
.RS
42 send-probe ip-4 127.0.0.1
.RE
.LP
این دستور یک کاوش شبکه را به رابط لوپ‌بک ارسال می‌کند. هنگامی که کاوش تکمیل شود،
.B mtr-packet
پاسخی مانند زیر را روی
.I stdout
ارائه خواهد داد:
.LP
.RS
42 reply ip-4 127.0.0.1 round-trip-time 126
.RE
.LP
این نشان می‌دهد که آدرس لوپ‌بک به کاوش پاسخ داد و زمان رفت و برگشت کاوش ۱۲۶ میکروثانیه بود.
.LP
به منظور ردیابی مسیر تا یک میزبان راه دور، از چندین دستور
.B send-probe
که هر یک دارای مقدار
.B ttl
متفاوتی هستند استفاده می‌شود.
.LP
.RS
11 send-probe ip-4 8.8.8.8 ttl 1
.RS 0
12 send-probe ip-4 8.8.8.8 ttl 2
.RS 0
13 send-probe ip-4 8.8.8.8 ttl 3
.RS 0
\&...
.RE 0
.LP
هر میزبان میانی با یک پیام
.B ttl-expired
پاسخ می‌دهد و میزبان مقصد با یک
.BR reply
پاسخ خواهد داد:
.LP
.RS
11 ttl-expired ip-4 192.168.254.254 round-trip-time 1634
.RS 0
12 ttl-expired ip-4 184.19.243.240 round-trip-time 7609
.RS 0
13 ttl-expired ip-4 172.76.20.169 round-trip-time 8643
.RS 0
14 ttl-expired ip-4 74.40.1.101 round-trip-time 9755
.RS 0
15 ttl-expired ip-4 74.40.5.126 round-trip-time 10695
.RS 0
17 ttl-expired ip-4 108.170.245.97 round-trip-time 14077
.RS 0
16 ttl-expired ip-4 74.40.26.131 round-trip-time 15253
.RS 0
18 ttl-expired ip-4 209.85.245.101 round-trip-time 17080
.RS 0
19 reply ip-4 8.8.8.8 round-trip-time 17039
.RE 0
.LP
توجه داشته باشید که پاسخ‌ها در این مثال بدون ترتیب چاپ شده‌اند.
(پاسخ به کاوش ۱۷ پیش از پاسخ به کاوش ۱۶ می‌رسد.)
به همین دلیل مهم است که دستورات با مقادیر توکن یکتا ارسال شوند و از آن مقادیر توکن برای تطبیق پاسخ‌ها با دستورات مبدأ آن‌ها استفاده گردد.
.SH "پیوندهای زبانی (LANGUAGE BINDINGS)"
.PP
یک بسته پایتون 3.x برای ارسال ناهمگام بسته‌های کاوش شبکه با استفاده از mtr-packet در دسترس است. ببینید:
.UR https://\:pypi.\:org/\:project/\:mtrpacket
.UE
.SH "اطلاعات تماس (CONTACT INFORMATION)"
.PP
برای جدیدترین نسخه، صفحه وب mtr را ببینید:
.UR http://\:www.\:bitwizard.\:nl/\:mtr
.UE
.PP
برای وصله‌ها، گزارش‌های اشکال یا درخواست‌های ویژگی، لطفاً یک گزارش موضوع (issue) در گیت‌هاب باز کنید:
.UR https://\:github\:.com/\:traviscross/\:mtr
.UE .
.SH "همچنین ببینید (SEE ALSO)"
.BR mtr (8),
.BR icmp (7),
.BR tcp (7),
.BR udp (7),
TCP/IP Illustrated (Stevens, ISBN 0201633469).