نام (NAME)

udpdump - فراهم کردن یک گیرندهٔ UDP برای دریافت بسته‌ها از دستگاه‌های شبکه (مانند مسیریاب‌های Aruba) و برون‌بری آن‌ها در قالب PCAP

خلاصه دستور (SYNOPSIS)

udpdump [ --help ] [ --version ] [ --extcap-interfaces ] [ --extcap-dlts ] [ --extcap-interface=<interface> ] [ --extcap-config ] [ --capture ] [ --fifo=<path to file or pipe> ] [ --port=<port> ] [ --payload=<type> ]

توضیحات (DESCRIPTION)

udpdump یک ابزار extcap است که یک گیرندهٔ UDP را برای گوش دادن به دیتاگرام‌های صادرشده از هر مبدئی (مانند مسیریاب‌های Aruba) و برون‌بری آن‌ها در قالب PCAP فراهم می‌کند. این ابزار دو قابلیت اساسی در اختیار کاربر قرار می‌دهد: نخست، داشتن شنونده‌ای (listener) که از ارسال بستهٔ ICMP port-unreachable توسط localhost جلوگیری می‌کند. دوم، حذف لایه‌های زیرین (لایه ۲، IP و UDP) که بی‌استفاده هستند (و تنها به‌عنوان حامل برون‌بری به کار رفته‌اند). قالب دیتاگرام‌های برون‌بری‌شده EXPORTED_PDU است، همان‌طور که در نشانی زیر مشخص شده است: https://gitlab.com/wireshark/wireshark/-/raw/master/epan/exported_pdu.h

گزینه‌ها (OPTIONS)

--help

چاپ آرگومان‌های برنامه.

--version

چاپ نسخهٔ برنامه.

--extcap-interfaces

فهرست کردن رابط‌های دردسترس.

--extcap-interface=<interface>

استفاده از رابط‌های مشخص‌شده.

--extcap-dlts

فهرست کردن DLTهای رابط مشخص‌شده.

--extcap-config

فهرست کردن گزینه‌های پیکربندی رابط مشخص‌شده.

--capture

شروع ضبط از رابط مشخص‌شده و ذخیرهٔ آن در محل تعیین‌شده با --fifo.

--fifo=<path to file or pipe>;

ذخیرهٔ بسته‌های ضبط‌شده در فایل یا ارسال آن از طریق لوله (pipe).

--port=<port>

تنظیم درگاه شنونده. درگاه پیش‌فرض 5555 است.

--payload=<type>

تنظیم بار مفید (payload) در PDU برون‌بری‌شده. پیش‌فرض: data.

مثال‌ها (EXAMPLES)

برای مشاهدهٔ آرگومان‌های برنامه:

udpdump --help

برای مشاهدهٔ نسخهٔ برنامه:

udpdump --version

برای مشاهدهٔ رابط‌ها:

udpdump --extcap-interfaces

خروجی نمونه

interface {value=udpdump}{display=UDP Listener remote capture}

برای مشاهدهٔ DLTهای رابط:

udpdump --extcap-interface=udpdump --extcap-dlts

خروجی نمونه

dlt {number=252}{name=udpdump}{display=Exported PDUs}

برای مشاهدهٔ گزینه‌های پیکربندی رابط:

udpdump --extcap-interface=udpdump --extcap-config

خروجی نمونه

arg {number=0}{call=--port}{display=Listen port}{type=unsigned}{range=1,65535}{default=5555}{tooltip=The port the receiver listens on}

برای ضبط:

udpdump --extcap-interface=randpkt --fifo=/tmp/randpkt.pcapng --capture

نکته

برای متوقف کردن ضبط، کلیدهای CTRL+C را فشار دهید یا برنامه را خاتمه (kill/terminate) دهید.

همچنین ببینید (SEE ALSO)

wireshark(1), tshark(1), dumpcap(1), extcap(4)

نکات (NOTES)

udpdump بخشی از توزیع Wireshark است. آخرین نسخهٔ Wireshark را می‌توانید در نشانی زیر بیابید: https://www.wireshark.org.

نسخه‌های HTML صفحات راهنمای پروژهٔ Wireshark در نشانی زیر در دسترس هستند: https://www.wireshark.org/docs/man-pages.

نویسندگان (AUTHORS)

نویسنده اصلی
Dario Lombardo <lomato[AT]gmail.com>