'\" t
.\"     Title: udpdump
.\"    Author: [see the "AUTHOR(S)" section]
.\" Generator: Asciidoctor 2.0.26
.\"      Date: 2026-09-03
.\"    Manual: \ \&
.\"    Source: \ \&
.\"  Language: English
.\"
.TH "UDPDUMP" "1" "2026-09-03" "\ \&" "\ \&"
.ie \n(.g .ds Aq \(aq
.el       .ds Aq '
.ss \n[.ss] 0
.nh
.ad l
.de URL
\fI\\$2\fP <\\$1>\\$3
..
.als MTO URL
.if \n[.g] \{\
.  mso www.tmac
.  am URL
.    ad l
.  .
.  am MTO
.    ad l
.  .
.  LINKSTYLE blue R < >
.\}
.SH "نام (NAME)"
udpdump \- فراهم کردن یک گیرندهٔ UDP برای دریافت بسته‌ها از دستگاه‌های شبکه (مانند مسیریاب‌های Aruba) و برون‌بری آن‌ها در قالب PCAP
.SH "خلاصه دستور (SYNOPSIS)"
.sp
\fBudpdump\fP
[\~\fB\-\-help\fP\~]
[\~\fB\-\-version\fP\~]
[\~\fB\-\-extcap\-interfaces\fP\~]
[\~\fB\-\-extcap\-dlts\fP\~]
[\~\fB\-\-extcap\-interface\fP=<interface>\~]
[\~\fB\-\-extcap\-config\fP\~]
[\~\fB\-\-capture\fP\~]
[\~\fB\-\-fifo\fP=<path\~to\~file\~or\~pipe>\~]
[\~\fB\-\-port\fP=<port>\~]
[\~\fB\-\-payload\fP=<type>\~]
.SH "توضیحات (DESCRIPTION)"
.sp
\fBudpdump\fP یک ابزار extcap است که یک گیرندهٔ UDP را برای گوش دادن به دیتاگرام‌های صادرشده از هر مبدئی (مانند مسیریاب‌های Aruba) و برون‌بری آن‌ها در قالب PCAP فراهم می‌کند. این ابزار دو قابلیت اساسی در اختیار کاربر قرار می‌دهد: نخست، داشتن شنونده‌ای (listener) که از ارسال بستهٔ ICMP port\-unreachable توسط localhost جلوگیری می‌کند. دوم، حذف لایه‌های زیرین (لایه ۲، IP و UDP) که بی‌استفاده هستند (و تنها به‌عنوان حامل برون‌بری به کار رفته‌اند). قالب دیتاگرام‌های برون‌بری‌شده EXPORTED_PDU است، همان‌طور که در نشانی زیر مشخص شده است:
.URL "https://gitlab.com/wireshark/wireshark/\-/raw/master/epan/exported_pdu.h" "" ""
.SH "گزینه‌ها (OPTIONS)"
.sp
\-\-help
.RS 4
چاپ آرگومان‌های برنامه.
.RE
.sp
\-\-version
.RS 4
چاپ نسخهٔ برنامه.
.RE
.sp
\-\-extcap\-interfaces
.RS 4
فهرست کردن رابط‌های دردسترس.
.RE
.sp
\-\-extcap\-interface=<interface>
.RS 4
استفاده از رابط‌های مشخص‌شده.
.RE
.sp
\-\-extcap\-dlts
.RS 4
فهرست کردن DLTهای رابط مشخص‌شده.
.RE
.sp
\-\-extcap\-config
.RS 4
فهرست کردن گزینه‌های پیکربندی رابط مشخص‌شده.
.RE
.sp
\-\-capture
.RS 4
شروع ضبط از رابط مشخص‌شده و ذخیرهٔ آن در محل تعیین‌شده با \-\-fifo.
.RE
.sp
\-\-fifo=<path to file or pipe>
.RS 4
ذخیرهٔ بسته‌های ضبط‌شده در فایل یا ارسال آن از طریق لوله (pipe).
.RE
.sp
\-\-port=<port>
.RS 4
تنظیم درگاه شنونده. درگاه پیش‌فرض 5555 است.
.RE
.sp
\-\-payload=<type>
.RS 4
تنظیم بار مفید (payload) در PDU برون‌بری‌شده. پیش‌فرض: data.
.RE
.SH "مثال‌ها (EXAMPLES)"
.sp
برای مشاهدهٔ آرگومان‌های برنامه:
.sp
.if n .RS 4
.nf
.fam C
udpdump \-\-help
.fam
.fi
.if n .RE
.sp
برای مشاهدهٔ نسخهٔ برنامه:
.sp
.if n .RS 4
.nf
.fam C
udpdump \-\-version
.fam
.fi
.if n .RE
.sp
برای مشاهدهٔ رابط‌ها:
.sp
.if n .RS 4
.nf
.fam C
udpdump \-\-extcap\-interfaces
.fam
.fi
.if n .RE
.sp
.B خروجی نمونه
.br
.sp
.if n .RS 4
.nf
.fam C
interface {value=udpdump}{display=UDP Listener remote capture}
.fam
.fi
.if n .RE
.sp
برای مشاهدهٔ DLTهای رابط:
.sp
.if n .RS 4
.nf
.fam C
udpdump \-\-extcap\-interface=udpdump \-\-extcap\-dlts
.fam
.fi
.if n .RE
.sp
.B خروجی نمونه
.br
.sp
.if n .RS 4
.nf
.fam C
dlt {number=252}{name=udpdump}{display=Exported PDUs}
.fam
.fi
.if n .RE
.sp
برای مشاهدهٔ گزینه‌های پیکربندی رابط:
.sp
.if n .RS 4
.nf
.fam C
udpdump \-\-extcap\-interface=udpdump \-\-extcap\-config
.fam
.fi
.if n .RE
.sp
.B خروجی نمونه
.br
.sp
.if n .RS 4
.nf
.fam C
arg {number=0}{call=\-\-port}{display=Listen port}{type=unsigned}{range=1,65535}{default=5555}{tooltip=The port the receiver listens on}
.fam
.fi
.if n .RE
.sp
برای ضبط:
.sp
.if n .RS 4
.nf
.fam C
udpdump \-\-extcap\-interface=randpkt \-\-fifo=/tmp/randpkt.pcapng \-\-capture
.fam
.fi
.if n .RE
.if n .sp
.RS 4
.it 1 an-trap
.nr an-no-space-flag 1
.nr an-break-flag 1
.br
.ps +1
.B نکته
.ps -1
.br
.sp
برای متوقف کردن ضبط، کلیدهای CTRL+C را فشار دهید یا برنامه را خاتمه (kill/terminate) دهید.
.sp .5v
.RE
.SH "همچنین ببینید (SEE ALSO)"
.sp
wireshark(1), tshark(1), dumpcap(1), extcap(4)
.SH "نکات (NOTES)"
.sp
\fBudpdump\fP بخشی از توزیع \fBWireshark\fP است. آخرین نسخهٔ
\fBWireshark\fP را می‌توانید در نشانی زیر بیابید: \c
.URL "https://www.wireshark.org" "" "."
.sp
نسخه‌های HTML صفحات راهنمای پروژهٔ Wireshark در نشانی زیر در دسترس هستند:
.URL "https://www.wireshark.org/docs/man\-pages" "" "."
.SH "نویسندگان (AUTHORS)"
.sp
.B نویسنده اصلی
.br
Dario Lombardo <lomato[AT]gmail.com>