ANDROIDDUMP(1)   ANDROIDDUMP(1)

androiddump - فراهم کردن رابط‌هایی برای ضبط داده از دستگاه‌های اندروید

androiddump [ --help ] [ --version ] [ --extcap-version ] [ --debug ] [ --extcap-interfaces ] [ --extcap-dlts ] [ --extcap-interface=<interface> ] [ --extcap-config ] [ --extcap-capture-filter=<capture filter> ] [ --capture ] [ --fifo=<path to file or pipe> ] [ --adb-server-ip=<IP address> ] [ --adb-server-tcp-port=<TCP port> ] [ --logcat-text=<TRUE or FALSE> ] [ --bt-server-tcp-port=<TCP port> ] [ --bt-forward-socket=<TRUE or FALSE> ] [ --bt-local-ip=<IP address> ] [ --bt-local-tcp-port=<TCP port> ]

androiddump --extcap-interfaces [ --adb-server-ip=<IP address> ] [ --adb-server-tcp-port=<TCP port> ]

androiddump --extcap-interface=<interface> [ --extcap-dlts ]

androiddump --extcap-interface=<interface> [ --extcap-config ]

androiddump --extcap-interface=<interface> --fifo=<path to file or pipe> --capture

Androiddump یک ابزار extcap است که رابط‌هایی را برای ضبط داده از یک دستگاه اندروید فراهم می‌کند. برای این کار تنها دو پیش‌نیاز وجود دارد:

1.باید Android SDK را داشته باشید و آن را به متغیر محیطی PATH خود بیفزایید. PATH باید شامل دایرکتوری ابزارهایی مانند "adb" و "android" باشد. Android SDK برای پلتفرم‌های مختلف در نشانی زیر در دسترس است: https://developer.android.com/sdk/index.html#Other
2.باید مجوز لازم برای ضبط از دستگاه اندروید را داشته باشید. برخی دستگاه‌های اندروید به تأیید هویت روی صفحه نمایش نیاز دارند.

رابط‌های پشتیبانی‌شده:

1.Logcat Main (باینری [<=Jelly Bean] یا متنی)
2.Logcat System (باینری [<=Jelly Bean] یا متنی)
3.Logcat Events (باینری [<=Jelly Bean] یا متنی)
4.Logcat Radio (باینری [<=Jelly Bean] یا متنی)
5.Logcat Crash (متنی؛ از Lollipop به بعد)
6.Bluetooth Hcidump [<=Jelly Bean]
7.Bluetooth Bluedroid External Parser [Kitkat]
8.Bluetooth BtsnoopNet [>=Lollipop]
9.WiFi/Ethernet tcpdump [نیازمند tcpdump روی گوشی]

لطفاً توجه داشته باشید که Androiddump برای FirefoxOS یا دیگر سیستم‌عامل‌های مبتنی بر Android نیز کار می‌کند.

--help

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

--version

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

--extcap-version

چاپ نگارش extcapized.

--debug

چاپ پیام‌های اضافی (اشکال‌زدایی).

--extcap-interfaces

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

--extcap-interface=<interface>

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

--extcap-dlts

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

--extcap-config

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

--extcap-capture-filter=<capture filter>;

فیلتر ضبط. این گزینه متناظر با مقداری است که از طریق گزینه tshark -f و فیلد Capture Filter در کنار فهرست رابط‌ها در واسط Wireshark ارائه می‌شود.

نکته

این گزینه تنها برای ضبط Wifi/Ethernet (tcpdump) در نظر گرفته می‌شود، نه برای Bluetooth یا logcat.

--capture

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

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

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

--adb-server-ip=<IP address>;

استفاده از آدرس IP غیرپیش‌فرض (به‌جز 127.0.0.1) برای دیمن ADB.

--adb-server-tcp-port=<TCP port>;

استفاده از درگاه TCP غیرپیش‌فرض (به‌جز 5037) برای دیمن ADB.

--logcat-text=<TRUE or FALSE>;

در صورت تنظیم روی TRUE، به جای حالت باینری از logcat متنی استفاده می‌شود. این گزینه فقط بر روی رابط‌های Logcat تأثیر دارد. این مورد از نسخه Lollipop به بعد که هیچ Logcat باینری در دسترس نیست، هیچ تأثیری ندارد.

پیش‌فرض برابر FALSE است.

--bt-server-tcp-port=<TCP port>;

استفاده از درگاه TCP سرور بلوتوث به غیر از مقدار پیش‌فرض در سمت Android. مقدار پیش‌فرض در Lollipop برابر 8872 و در نسخه‌های پیشین 4330 است.

--bt-forward-socket=<TRUE or FALSE>;

در صورت تنظیم روی TRUE، سوکت از سمت Android به سمت میزبان فوروارد می‌شود.

پیش‌فرض برابر FALSE است.

--bt-local-ip=<IP address>;

استفاده از آدرس IP غیرپیش‌فرض (به‌جز 127.0.0.1) در سمت میزبان برای سوکت فورواردشده.

--bt-local-tcp-port=<TCP port>;

تعیین درگاه مورد استفاده در سمت میزبان برای سوکت فورواردشده.

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

androiddump --help

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

androiddump --version

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

androiddump --extcap-interfaces

خروجی نمونه

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}

نام نمایشی خوانا برای انسان رابط‌ها شامل نوع رابط است، یکی از موارد زیر:

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)

برای tcpdump، این مورد با نام دستگاه شبکه هدف (مانند eth0) دنبال می‌شود.

سپس نام دستگاه Android در صورت در دسترس بودن، و در غیر این صورت unknown.

بخش پایانی آن DeviceID است - شناسه دستگاه که توسط Android SDK ارائه می‌شود (adb devices را ببینید).

برای نمونه: Android Logcat Main unknown MSM7627A

•Android Logcat Main - نوع کاربرپسند رابط
•unknown - نام دستگاه Android
•MSM7627A - شناسه دستگاه

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

androiddump --extcap-interface=android-bluetooth-hcidump-MSM7627A --extcap-dlts

خروجی نمونه

dlt {number=99}{name=BluetoothH4}{display=Bluetooth HCI UART transport layer plus pseudo-header}

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

androiddump --extcap-interface=android-bluetooth-hcidump-MSM7627A --extcap-config

خروجی نمونه

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}

برای ضبط:

androiddump --extcap-interface=android-bluetooth-hcidump-MSM7627A --fifo=/tmp/bluetooth.pcapng --capture

نکته

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

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

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

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

نویسنده اصلی
Michal Labedzki <michal.labedzki[AT]tieto.com>

مشارکت‌کنندگان
Roland Knall <rknall[AT]gmail.com>

2026-09-03