.ie \n(.g .ds Aq \(aq
.el .ds Aq '
.TH trip 1  "trip 0.13.0" 
.SH "نام (NAME)"
trip \- ابزاری برای عیب‌یابی و بررسی وضعیت شبکه
.SH "خلاصه دستور (SYNOPSIS)"
\fBtrip\fR [\fB\-c\fR|\fB\-\-config\-file\fR] [\fB\-m\fR|\fB\-\-mode\fR] [\fB\-u\fR|\fB\-\-unprivileged\fR] [\fB\-p\fR|\fB\-\-protocol\fR] [\fB\-\-udp\fR] [\fB\-\-tcp\fR] [\fB\-\-icmp\fR] [\fB\-F\fR|\fB\-\-addr\-family\fR] [\fB\-4\fR|\fB\-\-ipv4\fR] [\fB\-6\fR|\fB\-\-ipv6\fR] [\fB\-P\fR|\fB\-\-target\-port\fR] [\fB\-S\fR|\fB\-\-source\-port\fR] [\fB\-A\fR|\fB\-\-source\-address\fR] [\fB\-I\fR|\fB\-\-interface\fR] [\fB\-i\fR|\fB\-\-min\-round\-duration\fR] [\fB\-T\fR|\fB\-\-max\-round\-duration\fR] [\fB\-g\fR|\fB\-\-grace\-duration\fR] [\fB\-\-initial\-sequence\fR] [\fB\-R\fR|\fB\-\-multipath\-strategy\fR] [\fB\-U\fR|\fB\-\-max\-inflight\fR] [\fB\-f\fR|\fB\-\-first\-ttl\fR] [\fB\-t\fR|\fB\-\-max\-ttl\fR] [\fB\-\-packet\-size\fR] [\fB\-\-payload\-pattern\fR] [\fB\-Q\fR|\fB\-\-tos\fR] [\fB\-e\fR|\fB\-\-icmp\-extensions\fR] [\fB\-\-read\-timeout\fR] [\fB\-r\fR|\fB\-\-dns\-resolve\-method\fR] [\fB\-y\fR|\fB\-\-dns\-resolve\-all\fR] [\fB\-\-dns\-timeout\fR] [\fB\-\-dns\-ttl\fR] [\fB\-z\fR|\fB\-\-dns\-lookup\-as\-info\fR] [\fB\-s\fR|\fB\-\-max\-samples\fR] [\fB\-\-max\-flows\fR] [\fB\-a\fR|\fB\-\-tui\-address\-mode\fR] [\fB\-\-tui\-as\-mode\fR] [\fB\-\-tui\-custom\-columns\fR] [\fB\-\-tui\-icmp\-extension\-mode\fR] [\fB\-\-tui\-geoip\-mode\fR] [\fB\-M\fR|\fB\-\-tui\-max\-addrs\fR] [\fB\-\-tui\-preserve\-screen\fR] [\fB\-\-tui\-refresh\-rate\fR] [\fB\-\-tui\-privacy\-max\-ttl\fR] [\fB\-\-tui\-locale\fR] [\fB\-\-tui\-timezone\fR] [\fB\-\-tui\-theme\-colors\fR] [\fB\-\-print\-tui\-theme\-items\fR] [\fB\-\-tui\-key\-bindings\fR] [\fB\-\-print\-tui\-binding\-commands\fR] [\fB\-C\fR|\fB\-\-report\-cycles\fR] [\fB\-G\fR|\fB\-\-geoip\-mmdb\-file\fR] [\fB\-\-generate\fR] [\fB\-\-generate\-man\fR] [\fB\-\-print\-config\-template\fR] [\fB\-\-print\-locales\fR] [\fB\-\-log\-format\fR] [\fB\-\-log\-filter\fR] [\fB\-\-log\-span\-events\fR] [\fB\-v\fR|\fB\-\-verbose\fR] [\fB\-h\fR|\fB\-\-help\fR] [\fB\-V\fR|\fB\-\-version\fR] [\fITARGETS\fR] 
.SH "توضیحات (DESCRIPTION)"
ابزاری برای عیب‌یابی و تحلیل شبکه.
.SH "گزینه‌ها (OPTIONS)"
.TP
\fB\-c\fR, \fB\-\-config\-file\fR=\fICONFIG_FILE\fR
فایل پیکربندی
.TP
\fB\-m\fR, \fB\-\-mode\fR=\fIMODE\fR
حالت خروجی [پیش‌فرض: tui]
.br

.br
\fIمقادیر ممکن:\fR
.RS 14
.IP \(bu 2
tui: نمایش رابط کاربری تعاملی متنی (TUI)
.IP \(bu 2
stream: نمایش جریانی پیوسته از داده‌های ردیابی
.IP \(bu 2
pretty: تولید گزارشی به صورت جدول متنی زیبا برای N چرخه
.IP \(bu 2
markdown: تولید گزارشی به صورت جدول Markdown برای N چرخه
.IP \(bu 2
csv: تولید گزارش CSV برای N چرخه
.IP \(bu 2
json: تولید گزارش JSON برای N چرخه
.IP \(bu 2
dot: تولید یک فایل DOT برای Graphviz به مدت N چرخه
.IP \(bu 2
flows: نمایش تمام جریان‌ها (flows) برای N چرخه
.IP \(bu 2
silent: عدم تولید هیچ خروجی ردیابی برای N چرخه
.RE
.TP
\fB\-u\fR, \fB\-\-unprivileged\fR
ردیابی بدون نیاز به دسترسی‌های ویژه در پلتفرم‌های پشتیبانی‌شده [پیش‌فرض: false]
.TP
\fB\-p\fR, \fB\-\-protocol\fR=\fIPROTOCOL\fR
پروتکل ردیابی [پیش‌فرض: icmp]
.br

.br
\fIمقادیر ممکن:\fR
.RS 14
.IP \(bu 2
icmp: پروتکل پیام‌های کنترلی اینترنت (Internet Control Message Protocol)
.IP \(bu 2
udp: پروتکل داده‌گرام کاربر (User Datagram Protocol)
.IP \(bu 2
tcp: پروتکل کنترل انتقال (Transmission Control Protocol)
.RE
.TP
\fB\-\-udp\fR
ردیابی با استفاده از پروتکل UDP
.TP
\fB\-\-tcp\fR
ردیابی با استفاده از پروتکل TCP
.TP
\fB\-\-icmp\fR
ردیابی با استفاده از پروتکل ICMP
.TP
\fB\-F\fR, \fB\-\-addr\-family\fR=\fIADDR_FAMILY\fR
خانواده آدرس [پیش‌فرض: ipv4\-then\-ipv6]
.br

.br
\fIمقادیر ممکن:\fR
.RS 14
.IP \(bu 2
ipv4: فقط IPv4
.IP \(bu 2
ipv6: فقط IPv6
.IP \(bu 2
ipv6\-then\-ipv4: پروتکل IPv6 به همراه بازگشت به IPv4 در صورت ناموفق بودن
.IP \(bu 2
ipv4\-then\-ipv6: پروتکل IPv4 به همراه بازگشت به IPv6 در صورت ناموفق بودن
.IP \(bu 2
system: در صورت استفاده از تحلیل‌گر سیستم‌عامل، از اولین آدرس IP دریافت‌شده استفاده می‌شود؛ در غیر این صورت جستجوی IPv6 به همراه بازگشت به IPv4 انجام می‌گیرد
.RE
.TP
\fB\-4\fR, \fB\-\-ipv4\fR
تنها استفاده از IPv4
.TP
\fB\-6\fR, \fB\-\-ipv6\fR
تنها استفاده از IPv6
.TP
\fB\-P\fR, \fB\-\-target\-port\fR=\fITARGET_PORT\fR
درگاه هدف (تنها TCP و UDP) [پیش‌فرض: 80]
.TP
\fB\-S\fR, \fB\-\-source\-port\fR=\fISOURCE_PORT\fR
درگاه مبدأ (تنها TCP و UDP) [پیش‌فرض: auto]
.TP
\fB\-A\fR, \fB\-\-source\-address\fR=\fISOURCE_ADDRESS\fR
آدرس IP مبدأ [پیش‌فرض: auto]
.TP
\fB\-I\fR, \fB\-\-interface\fR=\fIINTERFACE\fR
رابط شبکه [پیش‌فرض: auto]
.TP
\fB\-i\fR, \fB\-\-min\-round\-duration\fR=\fIMIN_ROUND_DURATION\fR
حداقل مدت‌زمان هر دور [پیش‌فرض: 1s]
.TP
\fB\-T\fR, \fB\-\-max\-round\-duration\fR=\fIMAX_ROUND_DURATION\fR
حداکثر مدت‌زمان هر دور [پیش‌فرض: 1s]
.TP
\fB\-g\fR, \fB\-\-grace\-duration\fR=\fIGRACE_DURATION\fR
مدت‌زمان انتظار برای پاسخ‌های اضافی ICMP پس از پاسخ دادن هدف [پیش‌فرض: 100ms]
.TP
\fB\-\-initial\-sequence\fR=\fIINITIAL_SEQUENCE\fR
شماره توالی اولیه [پیش‌فرض: 33434]
.TP
\fB\-R\fR, \fB\-\-multipath\-strategy\fR=\fIMULTIPATH_STRATEGY\fR
راهبرد مسیریابی چندمسیره هم‌هزینه (تنها UDP) [پیش‌فرض: classic]
.br

.br
\fIمقادیر ممکن:\fR
.RS 14
.IP \(bu 2
classic: درگاه مبدأ یا مقصد برای ذخیره شماره توالی استفاده می‌شود
.IP \(bu 2
paris: فیلد `checksum` در UDP برای ذخیره شماره توالی استفاده می‌شود
.IP \(bu 2
dublin: فیلد `identifier` در IP برای ذخیره شماره توالی استفاده می‌شود
.RE
.TP
\fB\-U\fR, \fB\-\-max\-inflight\fR=\fIMAX_INFLIGHT\fR
حداکثر تعداد درخواست‌های اکوی ICMP در حال تبادل [پیش‌فرض: 24]
.TP
\fB\-f\fR, \fB\-\-first\-ttl\fR=\fIFIRST_TTL\fR
مقدار TTL آغازین [پیش‌فرض: 1]
.TP
\fB\-t\fR, \fB\-\-max\-ttl\fR=\fIMAX_TTL\fR
حداکثر تعداد گام‌های (hops) مجاز TTL [پیش‌فرض: 64]
.TP
\fB\-\-packet\-size\fR=\fIPACKET_SIZE\fR
اندازه بسته IP ارسالی (سربار IP + سربار ICMP + بار داده) [پیش‌فرض: 84]
.TP
\fB\-\-payload\-pattern\fR=\fIPAYLOAD_PATTERN\fR
الگوی تکرارشونده در بار داده بسته ICMP [پیش‌فرض: 0]
.TP
\fB\-Q\fR, \fB\-\-tos\fR=\fITOS\fR
مقدار TOS (یعنی DSCP+ECN) در سربار IP (تنها IPv4) [پیش‌فرض: 0]
.TP
\fB\-e\fR, \fB\-\-icmp\-extensions\fR
تجزیه افزونه‌های ICMP
.TP
\fB\-\-read\-timeout\fR=\fIREAD_TIMEOUT\fR
مهلت زمانی خواندن سوکت [پیش‌فرض: 10ms]
.TP
\fB\-r\fR, \fB\-\-dns\-resolve\-method\fR=\fIDNS_RESOLVE_METHOD\fR
روش انجام پرس‌وجوهای DNS [پیش‌فرض: system]
.br

.br
\fIمقادیر ممکن:\fR
.RS 14
.IP \(bu 2
system: حل نام با استفاده از تحلیل‌گر سیستم‌عامل
.IP \(bu 2
resolv: حل نام با استفاده از پیکربندی DNS در `/etc/resolv.conf`
.IP \(bu 2
google: حل نام با استفاده از سرویس DNS گوگل `8.8.8.8`
.IP \(bu 2
cloudflare: حل نام با استفاده از سرویس DNS کلودفلر `1.1.1.1`
.RE
.TP
\fB\-y\fR, \fB\-\-dns\-resolve\-all\fR
ردیابی به تمامی IPهای حاصل از جستجوی DNS [پیش‌فرض: false]
.TP
\fB\-\-dns\-timeout\fR=\fIDNS_TIMEOUT\fR
حداکثر زمان انتظار برای انجام پرس‌وجوهای DNS [پیش‌فرض: 5s]
.TP
\fB\-\-dns\-ttl\fR=\fIDNS_TTL\fR
زمان حیات (TTL) رکوردهای DNS [پیش‌فرض: 300s]
.TP
\fB\-z\fR, \fB\-\-dns\-lookup\-as\-info\fR
جستجوی اطلاعات سیستم خودگردان (AS) هنگام پرس‌وجوهای DNS [پیش‌فرض: false]
.TP
\fB\-s\fR, \fB\-\-max\-samples\fR=\fIMAX_SAMPLES\fR
حداکثر تعداد نمونه‌های ثبت‌شده به ازای هر گام [پیش‌فرض: 256]
.TP
\fB\-\-max\-flows\fR=\fIMAX_FLOWS\fR
حداکثر تعداد جریان‌های قابل ثبت [پیش‌فرض: 64]
.TP
\fB\-a\fR, \fB\-\-tui\-address\-mode\fR=\fITUI_ADDRESS_MODE\fR
نحوه نمایش آدرس‌ها [پیش‌فرض: host]
.br

.br
\fIمقادیر ممکن:\fR
.RS 14
.IP \(bu 2
ip: تنها نمایش آدرس IP.IP \(bu 2
host: تنها نمایش نام میزبان DNS حاصل از جست‌وجوی معکوس
.IP \(bu 2
both: نمایش هم‌زمان نشانی IP و نام میزبان DNS حاصل از جست‌وجوی معکوس
.RE
.TP
\fB\-\-tui\-as\-mode\fR=\fITUI_AS_MODE\fR
نحوه نمایش اطلاعات سامانه خودگردان (AS) [پیش‌فرض: asn]
.br

.br
\fIمقدارهای ممکن:\fR
.RS 14
.IP \(bu 2
asn: نمایش ASN
.IP \(bu 2
prefix: نمایش پیشوند AS
.IP \(bu 2
country\-code: نمایش کد کشور
.IP \(bu 2
registry: نمایش نام ثبات (registry)
.IP \(bu 2
allocated: نمایش تاریخ تخصیص
.IP \(bu 2
name: نمایش نام AS
.RE
.TP
\fB\-\-tui\-custom\-columns\fR=\fITUI_CUSTOM_COLUMNS\fR
ستون‌های سفارشی جهت نمایش در جدول گام‌های (hops) واسط TUI [پیش‌فرض: holsravbwdt]
.TP
\fB\-\-tui\-icmp\-extension\-mode\fR=\fITUI_ICMP_EXTENSION_MODE\fR
نحوه نمایش افزونه‌های ICMP [پیش‌فرض: off]
.br

.br
\fIمقدارهای ممکن:\fR
.RS 14
.IP \(bu 2
off: افزونه‌های `icmp` نمایش داده نشوند
.IP \(bu 2
mpls: تنها نمایش برچسب(های) MPLS
.IP \(bu 2
full: نمایش داده‌های کامل افزونه `icmp` برای تمامی افزونه‌های شناخته‌شده
.IP \(bu 2
all: نمایش داده‌های کامل افزونه `icmp` برای تمامی کلاس‌ها
.RE
.TP
\fB\-\-tui\-geoip\-mode\fR=\fITUI_GEOIP_MODE\fR
نحوه نمایش اطلاعات GeoIp [پیش‌فرض: short]
.br

.br
\fIمقدارهای ممکن:\fR
.RS 14
.IP \(bu 2
off: عدم نمایش داده‌های GeoIp
.IP \(bu 2
short: نمایش قالب کوتاه
.IP \(bu 2
long: نمایش قالب بلند
.IP \(bu 2
location: نمایش قالب عرض و طول جغرافیایی
.RE
.TP
\fB\-M\fR, \fB\-\-tui\-max\-addrs\fR=\fITUI_MAX_ADDRS\fR
حداکثر تعداد نشانی‌ها برای نمایش در هر گام [پیش‌فرض: auto]
.TP
\fB\-\-tui\-preserve\-screen\fR
حفظ محتوای صفحه در هنگام خروج [پیش‌فرض: false]
.TP
\fB\-\-tui\-refresh\-rate\fR=\fITUI_REFRESH_RATE\fR
نرخ تازه‌سازی TUI [پیش‌فرض: 100ms]
.TP
\fB\-\-tui\-privacy\-max\-ttl\fR=\fITUI_PRIVACY_MAX_TTL\fR
حداکثر ttl گام‌هایی که جهت حفظ حریم خصوصی پنهان (mask) می‌شوند [پیش‌فرض: none]

در صورت تنظیم، نشانی IP مبدا و نام میزبان نیز پنهان خواهند شد.
.TP
\fB\-\-tui\-locale\fR=\fITUI_LOCALE\fR
لوکال (locale) مورد استفاده برای TUI [پیش‌فرض: auto]
.TP
\fB\-\-tui\-timezone\fR=\fITUI_TIMEZONE\fR
منطقه زمانی مورد استفاده برای TUI [پیش‌فرض: auto]

منطقه زمانی باید یک شناسه معتبر منطقه‌ زمانی IANA باشد.
.TP
\fB\-\-tui\-theme\-colors\fR=\fITUI_THEME_COLORS\fR
رنگ‌های پوسته TUI [item=color,item=color,..]
.TP
\fB\-\-print\-tui\-theme\-items\fR
چاپ تمامی موارد پوسته TUI و خروج
.TP
\fB\-\-tui\-key\-bindings\fR=\fITUI_KEY_BINDINGS\fR
کلیدهای مقیدشده در TUI [command=key,command=key,..]
.TP
\fB\-\-print\-tui\-binding\-commands\fR
چاپ تمامی دستورهای TUI با قابلیت انتساب به کلید و خروج
.TP
\fB\-C\fR, \fB\-\-report\-cycles\fR=\fIREPORT_CYCLES\fR
تعداد چرخه‌های گزارش جهت اجرا [پیش‌فرض: 10]
.TP
\fB\-G\fR, \fB\-\-geoip\-mmdb\-file\fR=\fIGEOIP_MMDB_FILE\fR
فایل mmdb پشتیبانی‌شده GeoIp مربوط به MaxMind یا IPinfo
.TP
\fB\-\-generate\fR=\fIGENERATE\fR
تولید تکمیل خودکار پوسته (shell completion)
.br

.br
[\fIمقدارهای ممکن: \fRbash, elvish, fish, powershell, zsh]
.TP
\fB\-\-generate\-man\fR
تولید صفحه راهنمای ROFF
.TP
\fB\-\-print\-config\-template\fR
چاپ فایل الگوی پیکربندی toml و خروج
.TP
\fB\-\-print\-locales\fR
چاپ تمامی لوکال‌های موجود برای TUI و خروج
.TP
\fB\-\-log\-format\fR=\fILOG_FORMAT\fR
قالب لاگ اشکال‌زدایی [پیش‌فرض: pretty]
.br

.br
\fIمقدارهای ممکن:\fR
.RS 14
.IP \(bu 2
compact: نمایش داده‌های لاگ در قالبی فشرده
.IP \(bu 2
pretty: نمایش داده‌های لاگ در قالبی زیبا (pretty)
.IP \(bu 2
json: نمایش داده‌های لاگ در قالب json
.IP \(bu 2
chrome: نمایش داده‌های لاگ در قالب ردگیری (trace) مرورگر Chrome
.RE
.TP
\fB\-\-log\-filter\fR=\fILOG_FILTER\fR
فیلتر لاگ اشکال‌زدایی [پیش‌فرض: trippy=debug]
.TP
\fB\-\-log\-span\-events\fR=\fILOG_SPAN_EVENTS\fR
قالب لاگ اشکال‌زدایی [پیش‌فرض: off]
.br

.br
\fIمقدارهای ممکن:\fR
.RS 14
.IP \(bu 2
off: عدم نمایش بازه‌های زمانی رویداد (event spans)
.IP \(bu 2
active: نمایش بازه‌های زمانی رویدادهای ورود و خروج
.IP \(bu 2
full: نمایش تمامی بازه‌های زمانی رویداد
.RE
.TP
\fB\-v\fR, \fB\-\-verbose\fR
فعال‌سازی ثبت دقیق لاگ‌های اشکال‌زدایی با جزئیات کامل (verbose)
.TP
\fB\-h\fR, \fB\-\-help\fR
چاپ راهنما (مشاهده خلاصه با \*(Aq\-h\*(Aq)
.TP
\fB\-V\fR, \fB\-\-version\fR
چاپ نسخه
.TP
[\fITARGETS\fR]
فهرستی از نام‌های میزبان و IPها جداشده با فاصله برای ردیابی مسیر.SH "نسخه (VERSION)"
v0.13.0
.SH "نویسندگان (AUTHORS)"
FujiApple <fujiapple852@gmail.com>