'\" t
.\"     Title: wifidump
.\"    Author: [see the "AUTHOR(S)" section]
.\" Generator: Asciidoctor 2.0.26
.\"      Date: 2026-09-03
.\"    Manual: \ \&
.\"    Source: \ \&
.\"  Language: Persian
.\"
.TH "WIFIDUMP" "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)"
wifidump \- رابطی برای ضبط فریم‌های Wi\-Fi از یک میزبان دوردست از طریق SSH ارائه می‌دهد.
.SH "خلاصه دستور (SYNOPSIS)"
.sp
\fBwifidump\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\-\-extcap\-capture\-filter\fP=<capture\~filter>\~]
[\~\fB\-\-capture\fP\~]
[\~\fB\-\-fifo\fP=<path\~to\~file\~or\~pipe>\~]
[\~\fB\-\-remote\-host\fP=<IP\~address>\~]
[\~\fB\-\-remote\-port\fP=<TCP\~port>\~]
[\~\fB\-\-remote\-username\fP=<username>\~]
[\~\fB\-\-remote\-password\fP=<password>\~]
[\~\fB\-\-sshkey\fP=<public\~key\~path>\~]
[\~\fB\-\-remote\-interface\fP=<interface>\~]
[\~\fB\-\-remote\-channel\-frequency\fP=<channel\~frequency>\~]
[\~\fB\-\-remote\-channel\-width\fP=<channel\~width>\~]
.sp
\fBwifidump\fP
\fB\-\-extcap\-interfaces\fP
.sp
\fBwifidump\fP
\fB\-\-extcap\-interface\fP=<interface>
\fB\-\-extcap\-dlts\fP
.sp
\fBwifidump\fP
\fB\-\-extcap\-interface\fP=<interface>
\fB\-\-extcap\-config\fP
.sp
\fBwifidump\fP
\fB\-\-extcap\-interface\fP=<interface>
\fB\-\-fifo\fP=<path\~to\~file\~or\~pipe>
\fB\-\-capture\fP
\fB\-\-remote\-host=myremotehost\fP
\fB\-\-remote\-port=22\fP
\fB\-\-remote\-username=user\fP
\fB\-\-remote\-interface=eth2\fP
\fB\-\-remote\-channel\-frequency=5180\fP
\fB\-\-remote\-channel\-width=40\fP
.SH "توضیحات (DESCRIPTION)"
.sp
ابزار \fBWifidump\fP یک ابزار extcap است که به شما امکان می‌دهد ترافیک Wi\-Fi را از یک میزبان دوردست بر بستر یک اتصال SSH با استفاده از \fBtcpdump\fP ضبط کنید. پیش‌نیاز ضبط فریم‌های Wi\-Fi این است که میزبان دوردست باید برنامه‌های باینری لازم برای مدیریت و قرار دادن رابط مورد نظر در حالت monitor را داشته باشد. این باینری‌ها شامل \fBip\fP، \fBiw\fP و \fBiwconfig\fP هستند. همچنین، از آنجا که استفاده از حالت monitor و مدیریت رابط Wi\-Fi نیازمند دسترسی‌های ریشه (root) است، سیستم باید به گونه‌ای پیکربندی شود که به کاربر مورد نظر اجازه دهد این باینری‌ها را با استفاده از sudo بدون وارد کردن گذرواژه اجرا کند.
.sp
معمولاً wifidump به‌طور مستقیم فراخوانی نمی‌شود؛ در عوض، می‌توان آن را از طریق رابط گرافیکی کاربر Wireshark یا خط فرمان آن پیکربندی کرد. دستور زیر Wireshark را اجرا کرده و ضبط را از میزبان \fBremotehost\fP آغاز می‌کند:
.sp
.if n .RS 4
.nf
.fam C
$ wireshark \*(Aq\-oextcap.wifidump.remotehost:remotehost\*(Aq \-i wifidump \-k
.fam
.fi
.if n .RE
.sp
برای کنترل صریح دستور ضبط از راه دور:
.sp
.if n .RS 4
.nf
.fam C
$ wireshark \*(Aq\-oextcap.wifidump.remotehost:remotehost\*(Aq \(rs
            \*(Aq\-oextcap.wifidump.remotechannelfrequency:5180\*(Aq \(rs
            \*(Aq\-oextcap.wifidump.remotechannelwidth:40\*(Aq \(rs
            \-i wifidump \-k
.fam
.fi
.if n .RE
.sp
رابط‌های پشتیبانی‌شده:
.sp
.RS 4
.ie n \{\
\h'-04' 1.\h'+01'\c
.\}
.el \{\
.  sp -1
.  IP " 1." 4.2
.\}
wifidump
.RE.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
\-\-remote\-host=<remote host>
.RS 4
نشانی میزبان دوردست برای ضبط.
.RE
.sp
\-\-remote\-port=<remote port>
.RS 4
درگاه SSH میزبان دوردست.
.RE
.sp
\-\-remote\-username=<username>
.RS 4
نام کاربری برای احراز هویت ssh.
.RE
.sp
\-\-remote\-password=<password>
.RS 4
گذرواژه مورد استفاده (در صورتی که از ssh\-agent و pubkey استفاده نشود). هشدار: گذرواژه‌ها به صورت متن خام (plaintext) ذخیره شده و برای تمام کاربران این سیستم قابل مشاهده هستند. توصیه می‌شود از فایل‌های کلید به همراه یک SSH agent استفاده شود.
.RE
.sp
\-\-sshkey=<SSH private key path>
.RS 4
مسیر کلید خصوصی برای احراز هویت.
.RE
.sp
\-\-remote\-interface=<remote interface>
.RS 4
رابط شبکه دوردست برای ضبط از آن.
.RE
.sp
\-\-remote\-channel\-frequency=<channel frequency>
.RS 4
فرکانس کانال دوردست بر حسب مگاهرتز (MHz).
.RE
.sp
\-\-remote\-channel\-width=<channel width>
.RS 4
پهنای کانال دوردست بر حسب مگاهرتز (MHz).
.RE
.sp
\-\-extcap\-capture\-filter=<capture filter>
.RS 4
فیلتر ضبط. این فیلتر متناظر با مقداری است که از طریق گزینه \fBtshark \-f\fP ارائه می‌شود، و همچنین فیلد Capture Filter در کنار فهرست رابط‌ها در واسط کاربری Wireshark.
.RE.SH "مثال‌ها (EXAMPLES)"
.sp
برای مشاهده آرگومان‌های برنامه:
.sp
.if n .RS 4
.nf
.fam C
wifidump \-\-help
.fam
.fi
.if n .RE
.sp
برای مشاهده نسخه برنامه:
.sp
.if n .RS 4
.nf
.fam C
wifidump \-\-version
.fam
.fi
.if n .RE
.sp
برای مشاهده رابط‌ها:
.sp
.if n .RS 4
.nf
.fam C
wifidump \-\-extcap\-interfaces
.fam
.fi
.if n .RE
.sp
تنها از یک رابط (wifidump) پشتیبانی می‌شود.
.sp
.B خروجی نمونه
.br
.sp
.if n .RS 4
.nf
.fam C
interface {value=wifidump}{display=Wi\-Fi remote capture}
.fam
.fi
.if n .RE
.sp
برای مشاهده DLTهای رابط:
.sp
.if n .RS 4
.nf
.fam C
wifidump \-\-extcap\-interface=wifidump \-\-extcap\-dlts
.fam
.fi
.if n .RE
.sp
.B خروجی نمونه
.br
.sp
.if n .RS 4
.nf
.fam C
dlt {number=147}{name=wifidump}{display=Remote capture dependent DLT}
.fam
.fi
.if n .RE
.sp
برای مشاهده گزینه‌های پیکربندی رابط:
.sp
.if n .RS 4
.nf
.fam C
wifidump \-\-extcap\-interface=wifidump \-\-extcap\-config
.fam
.fi
.if n .RE
.sp
.B خروجی نمونه
.br
.sp
.if n .RS 4
.nf
.fam C
arg {number=0}{call=\-\-remote\-host}{display=Remote SSH server address}{type=string}
    {tooltip=The remote SSH host. It can be both an IP address or a hostname}{required=true}{group=Server}
arg {number=1}{call=\-\-remote\-port}{display=Remote SSH server port}{type=unsigned}
    {tooltip=The remote SSH host port (1\-65535)}{range=1,65535}{group=Server}
arg {number=2}{call=\-\-remote\-username}{display=Remote SSH server username}{type=string}
    {tooltip=The remote SSH username. If not provided, the current user will be used}{group=Authentication}
arg {number=3}{call=\-\-remote\-password}{display=Remote SSH server password}{type=password}
    {tooltip=The SSH password, used when other methods (SSH agent or key files) are unavailable.}{group=Authentication}
arg {number=4}{call=\-\-sshkey}{display=Path to SSH private key}{type=fileselect}
    {tooltip=The path on the local filesystem of the private ssh key}{mustexist=true}{group=Authentication}
arg {number=5}{call=\-\-sshkey\-passphrase}{display=SSH key passphrase}{type=password}
    {tooltip=Passphrase to unlock the SSH private key}{group=Authentication}
arg {number=6}{call=\-\-remote\-interface}{display=Remote interface}{type=string}
    {tooltip=The remote network interface used to capture}{default=auto}{group=Capture}
arg {number=7}{call=\-\-remote\-channel\-frequency}{display=Remote channel}{type=selector}
    {tooltip=The remote channel used to capture}{group=Capture}
arg {number=8}{call=\-\-remote\-channel\-width}{display=Remote channel width}{type=selector}
    {tooltip=The remote channel width used to capture}{group=Capture}
arg {number=9}{call=\-\-remote\-filter}{display=Remote capture filter}{type=string}
    {tooltip=The remote capture filter}{group=Capture}
arg {number=10}{call=\-\-remote\-count}{display=Packets to capture}{type=unsigned}
    {tooltip=The number of remote packets to capture.}{group=Capture}
arg {number=11}{call=\-\-log\-level}{display=Set the log level}{type=selector}
    {tooltip=Set the log level}{required=false}{group=Debug}
arg {number=12}{call=\-\-log\-file}{display=Use a file for logging}{type=fileselect}
    {tooltip=Set a file where log messages are written}{required=false}{group=Debug}
.fam
.fi
.if n .RE
.sp
برای ضبط:
.sp
.if n .RS 4
.nf
.fam C
wifidump \-\-extcap\-interface=wifidump \-\-fifo=/tmp/wifidump.pcap \-\-capture \-\-remote\-host 192.168.1.10 \-\-remote\-username user \-\-remote\-channel\-frequency 5180 \-\-remote\-channel\-width 40
.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 یا خاتمه دادن به برنامه استفاده کنید.
.sp .5v
.RE
.sp
فایل اجرایی wifidump را می‌توان برای پشتیبانی از چندین نمونه تغییر نام داد. برای مثال اگر بخواهیم wifidump دو بار در wireshark نمایش داده شود (مثلاً برای مدیریت چندین نمایه)، می‌توانیم wifidump را به wifidump\-host1 و wifidump\-host2 کپی کنیم. هر فایل اجرایی، نام رابطی هم‌نام با نام فایل اجرایی خود نشان خواهد داد. فایل‌های اجرایی که نام آن‌ها "wifidump" نباشد، در بخش توضیحات رابط با عنوان "custom version" نمایش داده خواهند شد..SH "همچنین ببینید (SEE ALSO)"
.sp
wireshark(1), tshark(1), extcap(4), tcpdump(1)
.SH "نکات (NOTES)"
.sp
\fBWifidump\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
Adrian Granados <adrian[AT]intuitibits.com>