| trip(1) | General Commands Manual | trip(1) |
نام (NAME)
trip - ابزاری برای عیب‌یابی و بررسی وضعیت شبکه
خلاصه دستور (SYNOPSIS)
trip [-c|--config-file] [-m|--mode] [-u|--unprivileged] [-p|--protocol] [--udp] [--tcp] [--icmp] [-F|--addr-family] [-4|--ipv4] [-6|--ipv6] [-P|--target-port] [-S|--source-port] [-A|--source-address] [-I|--interface] [-i|--min-round-duration] [-T|--max-round-duration] [-g|--grace-duration] [--initial-sequence] [-R|--multipath-strategy] [-U|--max-inflight] [-f|--first-ttl] [-t|--max-ttl] [--packet-size] [--payload-pattern] [-Q|--tos] [-e|--icmp-extensions] [--read-timeout] [-r|--dns-resolve-method] [-y|--dns-resolve-all] [--dns-timeout] [--dns-ttl] [-z|--dns-lookup-as-info] [-s|--max-samples] [--max-flows] [-a|--tui-address-mode] [--tui-as-mode] [--tui-custom-columns] [--tui-icmp-extension-mode] [--tui-geoip-mode] [-M|--tui-max-addrs] [--tui-preserve-screen] [--tui-refresh-rate] [--tui-privacy-max-ttl] [--tui-locale] [--tui-timezone] [--tui-theme-colors] [--print-tui-theme-items] [--tui-key-bindings] [--print-tui-binding-commands] [-C|--report-cycles] [-G|--geoip-mmdb-file] [--generate] [--generate-man] [--print-config-template] [--print-locales] [--log-format] [--log-filter] [--log-span-events] [-v|--verbose] [-h|--help] [-V|--version] [TARGETS]
توضیحات (DESCRIPTION)
ابزاری برای عیب‌یابی و تحلیل شبکه.
گزینه‌ها (OPTIONS)
- -c, --config-file=CONFIG_FILE
- فایل پیکربندی
- -m, --mode=MODE
- حالت خروجی
[پیش‌فرض: tui]
مقادیر ممکن:
- tui: نمایش رابط کاربری تعاملی متنی (TUI)
- stream: نمایش جریانی پیوسته از داده‌های ردیابی
- pretty: تولید گزارشی به صورت جدول متنی زیبا برای N چرخه
- markdown: تولید گزارشی به صورت جدول Markdown برای N چرخه
- csv: تولید گزارش CSV برای N چرخه
- json: تولید گزارش JSON برای N چرخه
- dot: تولید یک فایل DOT برای Graphviz به مدت N چرخه
- flows: نمایش تمام جریان‌ها (flows) برای N چرخه
- silent: عدم تولید هیچ خروجی ردیابی برای N چرخه
- -u, --unprivileged
- ردیابی بدون نیاز به دسترسی‌های ویژه در پلتفرم‌های پشتیبانی‌شده [پیش‌فرض: false]
- -p, --protocol=PROTOCOL
- پروتکل
ردیابی
[پیش‌فرض: icmp]
مقادیر ممکن:
- icmp: پروتکل پیام‌های کنترلی اینترنت (Internet Control Message Protocol)
- udp: پروتکل داده‌گرام کاربر (User Datagram Protocol)
- tcp: پروتکل کنترل انتقال (Transmission Control Protocol)
- --udp
- ردیابی با استفاده از پروتکل UDP
- --tcp
- ردیابی با استفاده از پروتکل TCP
- --icmp
- ردیابی با استفاده از پروتکل ICMP
- -F, --addr-family=ADDR_FAMILY
- خانواده
آدرس
[پیش‌فرض: ipv4-then-ipv6]
مقادیر ممکن:
- ipv4: فقط IPv4
- ipv6: فقط IPv6
- ipv6-then-ipv4: پروتکل IPv6 به همراه بازگشت به IPv4 در صورت ناموفق بودن
- ipv4-then-ipv6: پروتکل IPv4 به همراه بازگشت به IPv6 در صورت ناموفق بودن
- system: در صورت استفاده از تحلیل‌گر سیستم‌عامل، از اولین آدرس IP دریافت‌شده استفاده می‌شود؛ در غیر این صورت جستجوی IPv6 به همراه بازگشت به IPv4 انجام می‌گیرد
- -4, --ipv4
- تنها استفاده از IPv4
- -6, --ipv6
- تنها استفاده از IPv6
- -P, --target-port=TARGET_PORT
- درگاه هدف (تنها TCP و UDP) [پیش‌فرض: 80]
- -S, --source-port=SOURCE_PORT
- درگاه مبدأ (تنها TCP و UDP) [پیش‌فرض: auto]
- -A, --source-address=SOURCE_ADDRESS
- آدرس IP مبدأ [پیش‌فرض: auto]
- -I, --interface=INTERFACE
- رابط شبکه [پیش‌فرض: auto]
- -i, --min-round-duration=MIN_ROUND_DURATION
- حداقل مدت‌زمان هر دور [پیش‌فرض: 1s]
- -T, --max-round-duration=MAX_ROUND_DURATION
- حداکثر مدت‌زمان هر دور [پیش‌فرض: 1s]
- -g, --grace-duration=GRACE_DURATION
- مدت‌زمان انتظار برای پاسخ‌های اضافی ICMP پس از پاسخ دادن هدف [پیش‌فرض: 100ms]
- --initial-sequence=INITIAL_SEQUENCE
- شماره توالی اولیه [پیش‌فرض: 33434]
- -R, --multipath-strategy=MULTIPATH_STRATEGY
- راهبرد
مسیریابی
چندمسیره
هم‌هزینه
(تنها UDP)
[پیش‌فرض: classic]
مقادیر ممکن:
- classic: درگاه مبدأ یا مقصد برای ذخیره شماره توالی استفاده می‌شود
- paris: فیلد `checksum` در UDP برای ذخیره شماره توالی استفاده می‌شود
- dublin: فیلد `identifier` در IP برای ذخیره شماره توالی استفاده می‌شود
- -U, --max-inflight=MAX_INFLIGHT
- حداکثر تعداد درخواست‌های اکوی ICMP در حال تبادل [پیش‌فرض: 24]
- -f, --first-ttl=FIRST_TTL
- مقدار TTL آغازین [پیش‌فرض: 1]
- -t, --max-ttl=MAX_TTL
- حداکثر تعداد گام‌های (hops) مجاز TTL [پیش‌فرض: 64]
- --packet-size=PACKET_SIZE
- اندازه بسته IP ارسالی (سربار IP + سربار ICMP + بار داده) [پیش‌فرض: 84]
- --payload-pattern=PAYLOAD_PATTERN
- الگوی تکرارشونده در بار داده بسته ICMP [پیش‌فرض: 0]
- -Q, --tos=TOS
- مقدار TOS (یعنی DSCP+ECN) در سربار IP (تنها IPv4) [پیش‌فرض: 0]
- -e, --icmp-extensions
- تجزیه افزونه‌های ICMP
- --read-timeout=READ_TIMEOUT
- مهلت زمانی خواندن سوکت [پیش‌فرض: 10ms]
- -r, --dns-resolve-method=DNS_RESOLVE_METHOD
- روش انجام
پرس‌وجوهای
DNS [پیش‌فرض: system]
مقادیر ممکن:
- system: حل نام با استفاده از تحلیل‌گر سیستم‌عامل
- resolv: حل نام با استفاده از پیکربندی DNS در `/etc/resolv.conf`
- google: حل نام با استفاده از سرویس DNS گوگل `8.8.8.8`
- cloudflare: حل نام با استفاده از سرویس DNS کلودفلر `1.1.1.1`
- -y, --dns-resolve-all
- ردیابی به تمامی IPهای حاصل از جستجوی DNS [پیش‌فرض: false]
- --dns-timeout=DNS_TIMEOUT
- حداکثر زمان انتظار برای انجام پرس‌وجوهای DNS [پیش‌فرض: 5s]
- --dns-ttl=DNS_TTL
- زمان حیات (TTL) رکوردهای DNS [پیش‌فرض: 300s]
- -z, --dns-lookup-as-info
- جستجوی اطلاعات سیستم خودگردان (AS) هنگام پرس‌وجوهای DNS [پیش‌فرض: false]
- -s, --max-samples=MAX_SAMPLES
- حداکثر تعداد نمونه‌های ثبت‌شده به ازای هر گام [پیش‌فرض: 256]
- --max-flows=MAX_FLOWS
- حداکثر تعداد جریان‌های قابل ثبت [پیش‌فرض: 64]
- -a, --tui-address-mode=TUI_ADDRESS_MODE
- نحوه نمایش
آدرس‌ها
[پیش‌فرض: host]
مقادیر ممکن:
- ip: تنها نمایش آدرس IP.IP • 2 host: تنها نمایش نام میزبان DNS حاصل از جست‌وجوی معکوس
- both: نمایش هم‌زمان نشانی IP و نام میزبان DNS حاصل از جست‌وجوی معکوس
- --tui-as-mode=TUI_AS_MODE
- نحوه نمایش
اطلاعات
سامانه
خودگردان (AS)
[پیش‌فرض: asn]
مقدارهای ممکن:
- asn: نمایش ASN
- prefix: نمایش پیشوند AS
- country-code: نمایش کد کشور
- registry: نمایش نام ثبات (registry)
- allocated: نمایش تاریخ تخصیص
- name: نمایش نام AS
- --tui-custom-columns=TUI_CUSTOM_COLUMNS
- ستون‌های سفارشی جهت نمایش در جدول گام‌های (hops) واسط TUI [پیش‌فرض: holsravbwdt]
- --tui-icmp-extension-mode=TUI_ICMP_EXTENSION_MODE
- نحوه نمایش
افزونه‌های
ICMP [پیش‌فرض: off]
مقدارهای ممکن:
- off: افزونه‌های `icmp` نمایش داده نشوند
- mpls: تنها نمایش برچسب(های) MPLS
- full: نمایش داده‌های کامل افزونه `icmp` برای تمامی افزونه‌های شناخته‌شده
- all: نمایش داده‌های کامل افزونه `icmp` برای تمامی کلاس‌ها
- --tui-geoip-mode=TUI_GEOIP_MODE
- نحوه نمایش
اطلاعات GeoIp
[پیش‌فرض: short]
مقدارهای ممکن:
- off: عدم نمایش داده‌های GeoIp
- short: نمایش قالب کوتاه
- long: نمایش قالب بلند
- location: نمایش قالب عرض و طول جغرافیایی
- -M, --tui-max-addrs=TUI_MAX_ADDRS
- حداکثر تعداد نشانی‌ها برای نمایش در هر گام [پیش‌فرض: auto]
- --tui-preserve-screen
- حفظ محتوای صفحه در هنگام خروج [پیش‌فرض: false]
- --tui-refresh-rate=TUI_REFRESH_RATE
- نرخ تازه‌سازی TUI [پیش‌فرض: 100ms]
- --tui-privacy-max-ttl=TUI_PRIVACY_MAX_TTL
- حداکثر ttl
گام‌هایی
که جهت حفظ
حریم خصوصی
پنهان (mask)
می‌شوند
[پیش‌فرض: none]
در صورت تنظیم، نشانی IP مبدا و نام میزبان نیز پنهان خواهند شد.
- --tui-locale=TUI_LOCALE
- لوکال (locale) مورد استفاده برای TUI [پیش‌فرض: auto]
- --tui-timezone=TUI_TIMEZONE
- منطقه
زمانی مورد
استفاده
برای TUI
[پیش‌فرض: auto]
منطقه زمانی باید یک شناسه معتبر منطقه زمانی IANA باشد.
- --tui-theme-colors=TUI_THEME_COLORS
- رنگ‌های پوسته TUI [item=color,item=color,..]
- --print-tui-theme-items
- چاپ تمامی موارد پوسته TUI و خروج
- --tui-key-bindings=TUI_KEY_BINDINGS
- کلیدهای مقیدشده در TUI [command=key,command=key,..]
- --print-tui-binding-commands
- چاپ تمامی دستورهای TUI با قابلیت انتساب به کلید و خروج
- -C, --report-cycles=REPORT_CYCLES
- تعداد چرخه‌های گزارش جهت اجرا [پیش‌فرض: 10]
- -G, --geoip-mmdb-file=GEOIP_MMDB_FILE
- فایل mmdb پشتیبانی‌شده GeoIp مربوط به MaxMind یا IPinfo
- --generate=GENERATE
- تولید
تکمیل
خودکار
پوسته (shell completion)
[مقدارهای ممکن: bash, elvish, fish, powershell, zsh]
- --generate-man
- تولید صفحه راهنمای ROFF
- --print-config-template
- چاپ فایل الگوی پیکربندی toml و خروج
- --print-locales
- چاپ تمامی لوکال‌های موجود برای TUI و خروج
- --log-format=LOG_FORMAT
- قالب لاگ
اشکال‌زدایی
[پیش‌فرض: pretty]
مقدارهای ممکن:
- compact: نمایش داده‌های لاگ در قالبی فشرده
- pretty: نمایش داده‌های لاگ در قالبی زیبا (pretty)
- json: نمایش داده‌های لاگ در قالب json
- chrome: نمایش داده‌های لاگ در قالب ردگیری (trace) مرورگر Chrome
- --log-filter=LOG_FILTER
- فیلتر لاگ اشکال‌زدایی [پیش‌فرض: trippy=debug]
- --log-span-events=LOG_SPAN_EVENTS
- قالب لاگ
اشکال‌زدایی
[پیش‌فرض: off]
مقدارهای ممکن:
- off: عدم نمایش بازه‌های زمانی رویداد (event spans)
- active: نمایش بازه‌های زمانی رویدادهای ورود و خروج
- full: نمایش تمامی بازه‌های زمانی رویداد
- -v, --verbose
- فعال‌سازی ثبت دقیق لاگ‌های اشکال‌زدایی با جزئیات کامل (verbose)
- -h, --help
- چاپ راهنما (مشاهده خلاصه با '-h')
- -V, --version
- چاپ نسخه
- [TARGETS]
- فهرستی از نام‌های میزبان و IPها جداشده با فاصله برای ردیابی مسیر.SH "نسخه (VERSION)" v0.13.0
نویسندگان (AUTHORS)
FujiApple <fujiapple852@gmail.com>
| trip 0.13.0 |