'\" t
.\"     Title: etwdump
.\"    Author: [see the "AUTHOR(S)" section]
.\" Generator: Asciidoctor 2.0.26
.\"      Date: 2026-09-03
.\"    Manual: \ \&
.\"    Source: \ \&
.\"  Language: English
.\"
.TH "ETWDUMP" "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)"
etwdump \- فراهم کردن واسطی برای خواندن Event Tracing for Windows (ETW)
.SH "خلاصه دستور (SYNOPSIS)"
.sp
\fBetwdump\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\-\-iue\fP=<Should\~undecidable\~events\~be\~included>\~]
[\~\fB\-\-etlfile\fP=<etl\~file>\~]
[\~\fB\-\-params\fP=<filter\~parameters>\~]
.SH "توضیحات (DESCRIPTION)"
.sp
\fBetwdump\fP یک ابزار extcap است که دسترسی به یک فایل لاگ ردگیری رویداد (event trace) یا یک نشست زندهٔ ردگیری رویداد را فراهم می‌کند.
این ابزار فقط برای نمایش ردگیری رویداد در Windows استفاده می‌شود که شامل پیام‌های متنی خوانا و پروتکل‌های مختلف (مانند بسته‌های MBIM و IP) است.
.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
\-\-iue=<Should undecidable events be included>
.RS 4
انتخاب این که آیا رویدادهای غیرقابل تصمیم‌گیری (undecidable) گنجانده شوند یا خیر.
.RE
.sp
\-\-etlfile=<Etl file>
.RS 4
انتخاب فایل etl برای نمایش در Wireshark.
.RE
.sp
\-\-params=<filter parameters>
.RS 4
ورودی دادن فیلترهای تأمین‌کنندگان (providers)، کلیدواژه و سطح (level) برای فایل etl و نشست زنده.
.RE
.SH "مثال‌ها (EXAMPLES)"
.sp
برای دیدن آرگومان‌های برنامه:
.sp
.if n .RS 4
.nf
.fam C
etwdump \-\-help
.fam
.fi
.if n .RE
.sp
برای دیدن نسخهٔ برنامه:
.sp
.if n .RS 4
.nf
.fam C
etwdump \-\-version
.fam
.fi
.if n .RE
.sp
برای دیدن رابط‌ها:
.sp
.if n .RS 4
.nf
.fam C
etwdump \-\-extcap\-interfaces
.fam
.fi
.if n .RE
.sp
.B خروجی نمونه
.br
.sp
.if n .RS 4
.nf
.fam C
interface {value=etwdump}{display=ETW reader}
.fam
.fi
.if n .RE
.sp
برای دیدن DLTهای رابط:
.sp
.if n .RS 4
.nf
.fam C
etwdump \-\-extcap\-interface=etwdump \-\-extcap\-dlts
.fam
.fi
.if n .RE
.sp
.B خروجی نمونه
.br
.sp
.if n .RS 4
.nf
.fam C
dlt {number=1}{name=etwdump}{display=DLT_ETW}
.fam
.fi
.if n .RE
.sp
برای دیدن گزینه‌های پیکربندی رابط:
.sp
.if n .RS 4
.nf
.fam C
etwdump \-\-extcap\-interface=etwdump \-\-extcap\-config
.fam
.fi
.if n .RE
.sp
.B خروجی نمونه
.br
.sp
.if n .RS 4
.nf
.fam C
arg {number=0}{call=\-\-etlfile}{display=etl file}{type=fileselect}{tooltip=Select etl file to display in Wireshark}{group=Capture}
arg {number=1}{call=\-\-params}{display=filter parameters}{type=string}{tooltip=Input providers, keyword and level filters for the etl file and live session}{group=Capture}
arg {number=2}{call=\-\-iue}{display=Should undecidable events be included}{type=boolflag}{default=false}{tooltip=Choose if the undecidable event is included}{group=Capture}
.fam
.fi
.if n .RE
.sp
برای ضبط کردن:
.sp
.if n .RS 4
.nf
.fam C
etwdump \-\-extcap\-interface etwdump \-\-fifo=/tmp/etw.pcapng \-\-capture \-\-params "\-\-p=Microsoft\-Windows\-Wmbclass\-Opn \-\-p=Microsoft\-Windows\-wmbclass \-\-k=0xff \-\-l=4"
etwdump \-\-extcap\-interface etwdump \-\-fifo=/tmp/etw.pcapng \-\-capture \-\-params "\-\-p=Microsoft\-Windows\-Wmbclass\-Opn \-\-p=Microsoft\-Windows\-NDIS\-PacketCapture"
.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
\fBetwdump\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
Odysseus Yang \c
.br
.MTO "wiresharkyyh\(atoutlook.com" "" ""