'\" t
.TH TRACEPATH 8 "" "iputils" "iputils"
.\" -----------------------------------------------------------------
.\" * Define some portability stuff
.\" -----------------------------------------------------------------
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.\" http://bugs.debian.org/507673
.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.ie \n(.g .ds Aq \(aq
.el       .ds Aq '
.\" -----------------------------------------------------------------
.\" * set default formatting
.\" -----------------------------------------------------------------
.\" disable hyphenation
.nh
.\" disable justification (adjust text to left margin only)
.ad l
.\" -----------------------------------------------------------------
.\" * MAIN CONTENT STARTS HERE *
.\" -----------------------------------------------------------------
.SH "نام (NAME)"
tracepath \- ردیابی مسیر به سمت مقصد شبکه همراه با کشف MTU مسیر
.SH "خلاصه دستور (SYNOPSIS)"
.HP \w'\fBtracepath\fR\ 'u
\fBtracepath\fR [\fB\-4\fR] [\fB\-6\fR] [\fB\-n\fR] [\fB\-b\fR] [\fB\-l\ \fR\fB\fIpktlen\fR\fR] [\fB\-m\ \fR\fB\fImax_hops\fR\fR] [\fB\-p\ \fR\fB\fIport\fR\fR] [\fB\-V\fR] {destination}
.SH "توضیحات (DESCRIPTION)"
.PP
مسیر شبکه را تا
\fIdestination\fR
ردیابی کرده و مقدار MTU را در طول این مسیر کشف می‌کند\&. این ابزار از پورت UDP
\fIport\fR
یا یک پورت تصادفی استفاده می‌کند\&. عملکرد آن مشابه
\fBtraceroute\fR
است؛ با این حال، به دسترسی‌های کاربر ارشد نیازی ندارد و فاقد گزینه‌های پیچیده است\&.
.PP
\fBtracepath \-6\fR
جایگزین مناسبی برای
\fBtraceroute6\fR
و یک نمونه کلاسیک از کاربرد صف‌های خطای لینوکس (Linux error queues) است\&. وضعیت در مورد IPv4 نامناسب‌تر است، چرا که مسیریاب‌های تجاری IP اطلاعات کافی را در پیام‌های خطای ICMP بازنمی‌گردانند\&. احتمالاً با به‌روزرسانی آن‌ها این وضعیت تغییر خواهد کرد\&. در حال حاضر، این ابزار از ترفند ون جاکوبسون (Van Jacobson) استفاده می‌کند که با پیمایش محدوده‌ای از پورت‌های UDP تاریخچه ردیابی را حفظ می‌نماید\&.
.SH "گزینهها (OPTIONS)"
.PP
\fB\-4\fR
.RS 4
فقط استفاده از IPv4\&.
.RE
.PP
\fB\-6\fR
.RS 4
فقط استفاده از IPv6\&.
.RE
.PP
\fB\-n\fR
.RS 4
چاپ آدرس‌های IP فقط به‌صورت عددی\&.
.RE
.PP
\fB\-b\fR
.RS 4
چاپ هر دو مورد: نام میزبان و آدرس‌های IP\&.
.RE
.PP
\fB\-l\fR
.RS 4
تنظیم طول اولیه بسته روی
\fIpktlen\fR
به‌جای ۶۵۵۳۵ برای
\fBIPv4\fR
یا ۱۲۸۰۰۰ برای
\fBIPv6\fR\&.
.RE
.PP
\fB\-m\fR
.RS 4
تنظیم حداکثر تعداد جهش‌ها (یا حداکثر TTL) روی
\fImax_hops\fR
به‌جای ۳۰\&.
.RE
.PP
\fB\-p\fR
.RS 4
تنظیم پورت مقصد اولیه برای استفاده\&.
.RE
.PP
\fB\-V\fR
.RS 4
نمایش نسخه برنامه و خروج\&.
.RE
.SH "خروجی (OUTPUT)"
.sp
.if n \{\
.RS 4
.\}
.nf
root@mops:~ # tracepath \-6 3ffe:2400:0:109::2
 1?: [LOCALHOST]                              pmtu 1500
 1:  dust\&.inr\&.ac\&.ru                   0\&.411ms
 2:  dust\&.inr\&.ac\&.ru        asymm  1   0\&.390ms pmtu 1480
 2:  3ffe:2400:0:109::2               463\&.514ms reached
     Resume: pmtu 1480 hops 2 back 2
    
.fi
.if n \{\
.RE
.\}
.PP
ستون اول، TTL بسته آزمایشی (پروب) را به همراه دونقطه نشان می‌دهد\&. معمولاً مقدار TTL از پاسخ دریافتی از شبکه به دست می‌آید، اما گاهی اوقات حاوی اطلاعات لازم نیست و ناچار به حدس زدن آن هستیم\&. در این حالت پس از عدد، علامت ? قرار می‌گیرد\&.
.PP
ستون دوم، جهش شبکه‌ای (hop) را نشان می‌دهد که به بسته آزمایشی پاسخ داده است\&. این مقدار یا آدرس مسیریاب است یا در صورتی که بسته آزمایشی به شبکه ارسال نشده باشد، عبارت [LOCALHOST] نمایش داده می‌شود\&.
.PP
بقیه خط، اطلاعات گوناگونی درباره مسیر منتهی به جهش شبکه مربوطه را نشان می‌دهد\&. این بخش شامل مقدار RTT است و علاوه بر آن در صورت تغییر Path MTU، مقدار آن را نیز نشان می‌دهد\&. اگر مسیر نامتقارن باشد یا پروب پیش از رسیدن به جهش مشخص‌شده خاتمه یابد، تعداد جهش‌ها در جهت بازگشت در کنار کلمه کلیدی "asymm" نشان داده می‌شود\&. این اطلاعات کاملاً قابل اطمینان نیستند؛ برای نمونه خط سوم عدم‌تقارن ۱ را نشان می‌دهد، زیرا اولین بسته آزمایشی با TTL برابر با ۲ به دلیل فرآیند کشف Path MTU در اولین جهش رد شد\&.
.PP
خط آخر خلاصه‌ای از اطلاعات مربوط به تمام مسیرها به سمت مقصد را نمایش می‌دهد\&. این خط مقدار Path MTU کشف‌شده، تعداد جهش‌ها تا مقصد و حدس ما درباره تعداد جهش‌ها از مقصد تا مبدا را نشان می‌دهد که در صورت نامتقارن بودن مسیر می‌تواند متفاوت باشد\&.
.SH "مدیریت خطاها (HANDLING ERRORS)"
.PP
در صورت بروز خطا،
\fBtracepath\fR
کد خطای کوتاهی را چاپ می‌کند\&.
.TS
allbox tab(:);
lB lB lB.
T{
خروجی
T}:T{
کد
T}:T{
مفهوم
T}
.T&
lB lB lB
lB lB lB
lB lB lB
lB lB lB
lB lB lB
lB lB lB
lB lB lB
lB lB lB.
T{
!A
T}:T{
EACCES
T}:T{
ارتباط به دلایل مدیریتی مسدود شده است (Communication administratively prohibited)
T}
T{
!H
T}:T{
EHOSTUNREACH
T}:T{
میزبان مقصد در دسترس نیست (Destination host unreachable)
T}
T{
!N
T}:T{
ENETUNREACH
T}:T{
شبکه مقصد در دسترس نیست (Destination network unreachable)
T}
T{
!P
T}:T{
EPROTO
T}:T{
پروتکل مقصد در دسترس نیست (Destination protocol unreachable)
T}
T{
pmtu N
T}:T{
EMSGSIZE
T}:T{
پیام بیش از حد طولانی است (Message too long)
T}
T{
reached
T}:T{
ECONNREFUSED
T}:T{
اتصال رد شد (Connection refused)
T}
T{
\ \&
T}:T{
ETIMEDOUT
T}:T{
مهلت اتصال به پایان رسید (Connection timed out)
T}
T{
NET ERROR N
T}:T{
\ \&
T}:T{
هر خطای دیگر
T}
.TE
.sp 1
.SH "همچنین ببینید (SEE ALSO)"
.PP
\fBtraceroute\fR(8),
\fBtraceroute6\fR(8),
\fBping\fR(8)\&.
.SH "نویسنده (AUTHOR)"
.PP
\fBtracepath\fR
توسط Alexey Kuznetsov <kuznet@ms2\&.inr\&.ac\&.ru> نوشته شده است\&.
.SH "امنیت (SECURITY)"
.PP
فاقد هرگونه مشکل امنیتی شناخته‌شده\&.
.PP
این گزاره موجز شایسته توضیح بیشتری است\&.
\fBtracepath\fR
برخلاف ابزارهایی مانند
\fBtraceroute\fR\c
،
\fBping\fR
و سایر برنامه‌های مشابه، برنامه‌ای با دسترسی ویژه یا ممتاز نیست\&.
\fBtracepath\fR
می‌تواند توسط هر کاربری که دسترسی لازم به شبکه برای ارسال دیتاگرام‌های UDP به مقصد موردنظر با استفاده از پورت مشخص‌شده را دارد، اجرا شود\&.
.SH "در دسترس بودن (AVAILABILITY)"
.PP
\fBtracepath\fR
بخشی از بسته
\fIiputils\fR
است\&.