'\" t
.\"     Title: androiddump
.\"    Author: [see the "AUTHOR(S)" section]
.\" Generator: Asciidoctor 2.0.26
.\"      Date: 2026-09-03
.\"    Manual: \ \&
.\"    Source: \ \&
.\"  Language: Persian
.\"
.TH "ANDROIDDUMP" "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)"
androiddump \- فراهم کردن رابط‌هایی برای ضبط داده از دستگاه‌های اندروید
.SH "خلاصه دستور (SYNOPSIS)"
.sp
\fBandroiddump\fP
[\~\fB\-\-help\fP\~]
[\~\fB\-\-version\fP\~]
[\~\fB\-\-extcap\-version\fP\~]
[\~\fB\-\-debug\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\-\-adb\-server\-ip\fP=<IP\~address>\~]
[\~\fB\-\-adb\-server\-tcp\-port\fP=<TCP\~port>\~]
[\~\fB\-\-logcat\-text\fP=<TRUE\~or\~FALSE>\~]
[\~\fB\-\-bt\-server\-tcp\-port\fP=<TCP\~port>\~]
[\~\fB\-\-bt\-forward\-socket\fP=<TRUE\~or\~FALSE>\~]
[\~\fB\-\-bt\-local\-ip\fP=<IP\~address>\~]
[\~\fB\-\-bt\-local\-tcp\-port\fP=<TCP\~port>\~]
.sp
\fBandroiddump\fP
\fB\-\-extcap\-interfaces\fP
[\~\fB\-\-adb\-server\-ip\fP=<IP\~address>\~]
[\~\fB\-\-adb\-server\-tcp\-port\fP=<TCP\~port>\~]
.sp
\fBandroiddump\fP
\fB\-\-extcap\-interface\fP=<interface>
[\~\fB\-\-extcap\-dlts\fP\~]
.sp
\fBandroiddump\fP
\fB\-\-extcap\-interface\fP=<interface>
[\~\fB\-\-extcap\-config\fP\~]
.sp
\fBandroiddump\fP
\fB\-\-extcap\-interface\fP=<interface>
\fB\-\-fifo\fP=<path\~to\~file\~or\~pipe>
\fB\-\-capture\fP
.SH "توضیحات (DESCRIPTION)"
.sp
\fBAndroiddump\fP یک ابزار extcap است که رابط‌هایی را برای ضبط داده از
یک دستگاه اندروید فراهم می‌کند. برای این کار تنها دو پیش‌نیاز وجود دارد:
.sp
.RS 4
.ie n \{\
\h'-04' 1.\h'+01'\c
.\}
.el \{\
.  sp -1
.  IP " 1." 4.2
.\}
باید Android SDK را داشته باشید و آن را به متغیر محیطی PATH خود بیفزایید.
PATH باید شامل دایرکتوری ابزارهایی مانند "adb" و "android" باشد.
Android SDK برای پلتفرم‌های مختلف در نشانی زیر در دسترس است:
.URL "https://developer.android.com/sdk/index.html#Other" "" ""
.RE
.sp
.RS 4
.ie n \{\
\h'-04' 2.\h'+01'\c
.\}
.el \{\
.  sp -1
.  IP " 2." 4.2
.\}
باید مجوز لازم برای ضبط از دستگاه اندروید را داشته باشید.
برخی دستگاه‌های اندروید به تأیید هویت روی صفحه نمایش نیاز دارند.
.RE
.sp
رابط‌های پشتیبانی‌شده:
.sp
.RS 4
.ie n \{\
\h'-04' 1.\h'+01'\c
.\}
.el \{\
.  sp -1
.  IP " 1." 4.2
.\}
Logcat Main (باینری [<=Jelly Bean] یا متنی)
.RE
.sp
.RS 4
.ie n \{\
\h'-04' 2.\h'+01'\c
.\}
.el \{\
.  sp -1
.  IP " 2." 4.2
.\}
Logcat System (باینری [<=Jelly Bean] یا متنی)
.RE
.sp
.RS 4
.ie n \{\
\h'-04' 3.\h'+01'\c
.\}
.el \{\
.  sp -1
.  IP " 3." 4.2
.\}
Logcat Events (باینری [<=Jelly Bean] یا متنی)
.RE
.sp
.RS 4
.ie n \{\
\h'-04' 4.\h'+01'\c
.\}
.el \{\
.  sp -1
.  IP " 4." 4.2
.\}
Logcat Radio (باینری [<=Jelly Bean] یا متنی)
.RE
.sp
.RS 4
.ie n \{\
\h'-04' 5.\h'+01'\c
.\}
.el \{\
.  sp -1
.  IP " 5." 4.2
.\}
Logcat Crash (متنی؛ از Lollipop به بعد)
.RE
.sp
.RS 4
.ie n \{\
\h'-04' 6.\h'+01'\c
.\}
.el \{\
.  sp -1
.  IP " 6." 4.2
.\}
Bluetooth Hcidump [<=Jelly Bean]
.RE
.sp
.RS 4
.ie n \{\
\h'-04' 7.\h'+01'\c
.\}
.el \{\
.  sp -1
.  IP " 7." 4.2
.\}
Bluetooth Bluedroid External Parser [Kitkat]
.RE
.sp
.RS 4
.ie n \{\
\h'-04' 8.\h'+01'\c
.\}
.el \{\
.  sp -1
.  IP " 8." 4.2
.\}
Bluetooth BtsnoopNet [>=Lollipop]
.RE.sp
.RS 4
.ie n \{\
\h'-04' 9.\h'+01'\c
.\}
.el \{\
.  sp -1
.  IP " 9." 4.2
.\}
WiFi/Ethernet tcpdump [نیازمند tcpdump روی گوشی]
.RE
.sp
لطفاً توجه داشته باشید که Androiddump برای FirefoxOS یا دیگر سیستم‌عامل‌های مبتنی بر Android نیز کار می‌کند.
.SH "گزینه‌ها (OPTIONS)"
.sp
\-\-help
.RS 4
چاپ آرگومان‌های برنامه.
.RE
.sp
\-\-version
.RS 4
چاپ نسخه برنامه.
.RE
.sp
\-\-extcap\-version
.RS 4
چاپ نگارش extcapized.
.RE
.sp
\-\-debug
.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
\-\-extcap\-capture\-filter=<capture filter>
.RS 4
فیلتر ضبط. این گزینه متناظر با مقداری است که از طریق گزینه \fBtshark \-f\fP و فیلد Capture Filter در کنار فهرست رابط‌ها در واسط Wireshark ارائه می‌شود.
.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
این گزینه تنها برای ضبط Wifi/Ethernet (tcpdump) در نظر گرفته می‌شود، نه برای Bluetooth یا logcat.
.sp .5v
.RE
.RE
.sp
\-\-capture
.RS 4
شروع ضبط از رابط مشخص‌شده و ذخیره آن در مکانی که با \-\-fifo تعیین شده است.
.RE
.sp
\-\-fifo=<path to file or pipe>
.RS 4
ذخیره بسته‌های ضبط‌شده در فایل یا ارسال آن‌ها از طریق pipe.
.RE
.sp
\-\-adb\-server\-ip=<IP address>
.RS 4
استفاده از آدرس IP غیرپیش‌فرض (به‌جز 127.0.0.1) برای دیمن ADB.
.RE
.sp
\-\-adb\-server\-tcp\-port=<TCP port>
.RS 4
استفاده از درگاه TCP غیرپیش‌فرض (به‌جز 5037) برای دیمن ADB.
.RE
.sp
\-\-logcat\-text=<TRUE or FALSE>
.RS 4
.sp
در صورت تنظیم روی TRUE، به جای حالت باینری از logcat متنی استفاده می‌شود. این گزینه فقط بر روی رابط‌های Logcat تأثیر دارد. این مورد از نسخه Lollipop به بعد که هیچ Logcat باینری در دسترس نیست، هیچ تأثیری ندارد.
.sp
پیش‌فرض برابر FALSE است.
.RE
.sp
\-\-bt\-server\-tcp\-port=<TCP port>
.RS 4
.sp
استفاده از درگاه TCP سرور بلوتوث به غیر از مقدار پیش‌فرض در سمت Android.
مقدار پیش‌فرض در Lollipop برابر 8872 و در نسخه‌های پیشین 4330 است.
.RE
.sp
\-\-bt\-forward\-socket=<TRUE or FALSE>
.RS 4
.sp
در صورت تنظیم روی TRUE، سوکت از سمت Android به سمت میزبان فوروارد می‌شود.
.sp
پیش‌فرض برابر FALSE است.
.RE
.sp
\-\-bt\-local\-ip=<IP address>
.RS 4
استفاده از آدرس IP غیرپیش‌فرض (به‌جز 127.0.0.1) در سمت میزبان برای سوکت فورواردشده.
.RE
.sp
\-\-bt\-local\-tcp\-port=<TCP port>
.RS 4
تعیین درگاه مورد استفاده در سمت میزبان برای سوکت فورواردشده.
.RE.SH "مثال‌ها (EXAMPLES)"
.sp
برای مشاهده آرگومان‌های برنامه:
.sp
.if n .RS 4
.nf
.fam C
androiddump \-\-help
.fam
.fi
.if n .RE
.sp
برای مشاهده نسخه برنامه:
.sp
.if n .RS 4
.nf
.fam C
androiddump \-\-version
.fam
.fi
.if n .RE
.sp
برای مشاهده رابط‌ها:
.sp
.if n .RS 4
.nf
.fam C
androiddump \-\-extcap\-interfaces
.fam
.fi
.if n .RE
.sp
.B خروجی نمونه
.br
.sp
.if n .RS 4
.nf
.fam C
interface {display=Android Logcat Main unknown MSM7627A}{value=android\-logcat\-main\-MSM7627A}
interface {display=Android Logcat System unknown MSM7627A}{value=android\-logcat\-system\-MSM7627A}
interface {display=Android Logcat Radio unknown MSM7627A}{value=android\-logcat\-radio\-MSM7627A}
interface {display=Android Logcat Events unknown MSM7627A}{value=android\-logcat\-events\-MSM7627A}
interface {display=Android Bluetooth Hcidump unknown MSM7627A}{value=android\-bluetooth\-hcidump\-MSM7627A}
.fam
.fi
.if n .RE
.sp
نام نمایشی خوانا برای انسان رابط‌ها شامل نوع رابط است، یکی از موارد زیر:
.sp
.if n .RS 4
.nf
.fam C
android\-logcat\-main (Android Logcat Main)
android\-logcat\-system (Android Logcat System)
android\-logcat\-radio (Android Logcat Radio)
android\-logcat\-events (Android Logcat Events)
android\-logcat\-text\-main (Android Logcat Main)
android\-logcat\-text\-system (Android Logcat System)
android\-logcat\-text\-radio (Android Logcat Radio)
android\-logcat\-text\-events (Android Logcat Events)
android\-logcat\-text\-crash (Android Logcat Crash)
android\-bluetooth\-hcidump (Android Bluetooth Hcidump)
android\-bluetooth\-external\-parser (Android Bluetooth External Parser)
android\-bluetooth\-btsnoop\-net (Android Bluetooth Btsnoop Net)
android\-tcpdump (Android tcpdump)
.fam
.fi
.if n .RE
.sp
برای tcpdump، این مورد با نام دستگاه شبکه هدف (مانند \f(CReth0\fP) دنبال می‌شود.
.sp
سپس نام دستگاه Android در صورت در دسترس بودن، و در غیر این صورت \f(CRunknown\fP.
.sp
بخش پایانی آن DeviceID است \- شناسه دستگاه که توسط Android SDK ارائه می‌شود (\f(CRadb devices\fP را ببینید).
.sp
برای نمونه: \f(CRAndroid Logcat Main unknown MSM7627A\fP
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.  sp -1
.  IP \(bu 2.3
.\}
\f(CRAndroid Logcat Main\fP \- نوع کاربرپسند رابط
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.  sp -1
.  IP \(bu 2.3
.\}
\f(CRunknown\fP \- نام دستگاه Android
.RE
.sp
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.  sp -1
.  IP \(bu 2.3
.\}
\f(CRMSM7627A\fP \- شناسه دستگاه
.RE
.sp
برای مشاهده DLTهای رابط:
.sp
.if n .RS 4
.nf
.fam C
androiddump \-\-extcap\-interface=android\-bluetooth\-hcidump\-MSM7627A \-\-extcap\-dlts
.fam
.fi
.if n .RE
.sp
.B خروجی نمونه
.br
.sp
.if n .RS 4
.nf
.fam C
dlt {number=99}{name=BluetoothH4}{display=Bluetooth HCI UART transport layer plus pseudo\-header}
.fam
.fi
.if n .RE
.sp
برای مشاهده گزینه‌های پیکربندی رابط:
.sp
.if n .RS 4
.nf
.fam C
androiddump \-\-extcap\-interface=android\-bluetooth\-hcidump\-MSM7627A \-\-extcap\-config
.fam
.fi
.if n .RE
.sp
.B خروجی نمونه
.br
.sp
.if n .RS 4
.nf
.fam C
arg {number=0}{call=\-\-adb\-server\-ip}{display=ADB Server IP Address}{type=string}{default=127.0.0.1}
arg {number=1}{call=\-\-adb\-server\-tcp\-port}{display=ADB Server TCP Port}{type=integer}{range=0,65535}{default=5037}
.fam
.fi
.if n .RE
.sp
برای ضبط:
.sp
.if n .RS 4
.nf
.fam C
androiddump \-\-extcap\-interface=android\-bluetooth\-hcidump\-MSM7627A \-\-fifo=/tmp/bluetooth.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
\fBAndroiddump\fP بخشی از توزیع \fBWireshark\fP است. آخرین نسخهٔ
\fBWireshark\fP را می‌توان در نشانی زیر یافت: \c
.URL "https://www.wireshark.org" "" "."
.sp
نسخه‌های HTML صفحات راهنمای پروژهٔ Wireshark در نشانی زیر در دسترس هستند: \c
.URL "https://www.wireshark.org/docs/man\-pages" "" "."
.SH "نویسندگان (AUTHORS)"
.sp
.B نویسنده اصلی
.br
Michal Labedzki <michal.labedzki[AT]tieto.com>
.sp
.B مشارکت‌کنندگان
.br
Roland Knall <rknall[AT]gmail.com>