2021-10-19 23:26:37 +00:00
|
|
|
include::../docbook/attributes.adoc[]
|
2021-06-18 10:20:51 +00:00
|
|
|
= androiddump(1)
|
|
|
|
:doctype: manpage
|
|
|
|
:stylesheet: ws.css
|
|
|
|
:linkcss:
|
|
|
|
:copycss: ../docbook/{stylesheet}
|
2018-08-17 18:34:57 +00:00
|
|
|
|
2021-06-18 10:20:51 +00:00
|
|
|
== NAME
|
2015-04-08 14:09:03 +00:00
|
|
|
|
|
|
|
androiddump - Provide interfaces to capture from Android devices
|
|
|
|
|
2021-06-18 10:20:51 +00:00
|
|
|
== SYNOPSIS
|
|
|
|
|
|
|
|
[manarg]
|
|
|
|
*androiddump*
|
|
|
|
[ *--help* ]
|
|
|
|
[ *--version* ]
|
|
|
|
[ *--extcap-version* ]
|
|
|
|
[ *--debug* ]
|
|
|
|
[ *--extcap-interfaces* ]
|
|
|
|
[ *--extcap-dlts* ]
|
|
|
|
[ *--extcap-interface*=<interface> ]
|
|
|
|
[ *--extcap-config* ]
|
|
|
|
[ *--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> ]
|
|
|
|
|
|
|
|
[manarg]
|
|
|
|
*androiddump*
|
|
|
|
*--extcap-interfaces*
|
|
|
|
[ *--adb-server-ip*=<IP address> ]
|
|
|
|
[ *--adb-server-tcp-port*=<TCP port> ]
|
|
|
|
|
|
|
|
[manarg]
|
|
|
|
*androiddump*
|
|
|
|
*--extcap-interface*=<interface>
|
|
|
|
[ *--extcap-dlts* ]
|
|
|
|
|
|
|
|
[manarg]
|
|
|
|
*androiddump*
|
|
|
|
*--extcap-interface*=<interface>
|
|
|
|
[ *--extcap-config* ]
|
|
|
|
|
|
|
|
[manarg]
|
|
|
|
*androiddump*
|
|
|
|
*--extcap-interface*=<interface>
|
|
|
|
*--fifo*=<path to file or pipe>
|
|
|
|
*--capture*
|
|
|
|
|
|
|
|
== DESCRIPTION
|
|
|
|
|
|
|
|
*Androiddump* is a extcap tool that provide interfaces to capture from
|
2022-02-27 05:23:18 +00:00
|
|
|
an Android device. There are only two requirements:
|
2015-04-08 14:09:03 +00:00
|
|
|
|
2022-02-27 05:23:18 +00:00
|
|
|
1. You must have the Android SDK and add it to your PATH environment variable.
|
2015-04-08 14:09:03 +00:00
|
|
|
PATH should contain directory with tools like "adb" and "android".
|
|
|
|
Android SDK for various platform are available on:
|
|
|
|
https://developer.android.com/sdk/index.html#Other
|
|
|
|
|
2022-02-27 05:23:18 +00:00
|
|
|
2. You must have permission to capture from the Android device.
|
|
|
|
Some Android devices require on-screen authentication.
|
2015-04-08 14:09:03 +00:00
|
|
|
|
|
|
|
Supported interfaces:
|
|
|
|
|
2021-06-18 10:20:51 +00:00
|
|
|
1. Logcat Main (binary [++<=++Jelly Bean] or text)
|
|
|
|
2. Logcat System (binary [++<=++Jelly Bean] or text)
|
|
|
|
3. Logcat Events (binary [++<=++Jelly Bean] or text)
|
|
|
|
4. Logcat Radio (binary [++<=++Jelly Bean] or text)
|
|
|
|
5. Logcat Crash (text; from Lollipop)
|
|
|
|
6. Bluetooth Hcidump [++<=++Jelly Bean]
|
|
|
|
7. Bluetooth Bluedroid External Parser [Kitkat]
|
|
|
|
8. Bluetooth BtsnoopNet [>=Lollipop]
|
|
|
|
9. WiFi tcpdump [need tcpdump on phone]
|
2015-04-08 14:09:03 +00:00
|
|
|
|
2022-02-27 05:23:18 +00:00
|
|
|
Please note that Androiddump will work also for FirefoxOS or other
|
|
|
|
Android-based operating systems.
|
2015-04-08 14:09:03 +00:00
|
|
|
|
2021-06-18 10:20:51 +00:00
|
|
|
== OPTIONS
|
2015-04-08 14:09:03 +00:00
|
|
|
|
2021-06-18 10:20:51 +00:00
|
|
|
--help::
|
|
|
|
+
|
|
|
|
--
|
2015-04-08 14:09:03 +00:00
|
|
|
Print program arguments.
|
2021-06-18 10:20:51 +00:00
|
|
|
--
|
2015-04-08 14:09:03 +00:00
|
|
|
|
2021-06-18 10:20:51 +00:00
|
|
|
--version::
|
|
|
|
+
|
|
|
|
--
|
2015-04-08 14:09:03 +00:00
|
|
|
Print program version.
|
2021-06-18 10:20:51 +00:00
|
|
|
--
|
2015-04-08 14:09:03 +00:00
|
|
|
|
2021-06-18 10:20:51 +00:00
|
|
|
--extcap-version::
|
|
|
|
+
|
|
|
|
--
|
2016-10-19 11:50:26 +00:00
|
|
|
Print extcapized version.
|
2021-06-18 10:20:51 +00:00
|
|
|
--
|
2016-10-19 11:50:26 +00:00
|
|
|
|
2021-06-18 10:20:51 +00:00
|
|
|
--debug::
|
|
|
|
+
|
|
|
|
--
|
2016-10-19 11:50:26 +00:00
|
|
|
Print additional messages.
|
2021-06-18 10:20:51 +00:00
|
|
|
--
|
2016-10-19 11:50:26 +00:00
|
|
|
|
2021-06-18 10:20:51 +00:00
|
|
|
--extcap-interfaces::
|
|
|
|
+
|
|
|
|
--
|
2015-04-08 14:09:03 +00:00
|
|
|
List available interfaces.
|
2021-06-18 10:20:51 +00:00
|
|
|
--
|
2015-04-08 14:09:03 +00:00
|
|
|
|
2021-06-18 10:20:51 +00:00
|
|
|
--extcap-interface=<interface>::
|
|
|
|
+
|
|
|
|
--
|
2015-04-08 14:09:03 +00:00
|
|
|
Use specified interfaces.
|
2021-06-18 10:20:51 +00:00
|
|
|
--
|
2015-04-08 14:09:03 +00:00
|
|
|
|
2021-06-18 10:20:51 +00:00
|
|
|
--extcap-dlts::
|
|
|
|
+
|
|
|
|
--
|
2015-04-08 14:09:03 +00:00
|
|
|
List DLTs of specified interface.
|
2021-06-18 10:20:51 +00:00
|
|
|
--
|
2015-04-08 14:09:03 +00:00
|
|
|
|
2021-06-18 10:20:51 +00:00
|
|
|
--extcap-config::
|
|
|
|
+
|
|
|
|
--
|
2015-04-08 14:09:03 +00:00
|
|
|
List configuration options of specified interface.
|
2021-06-18 10:20:51 +00:00
|
|
|
--
|
2015-04-08 14:09:03 +00:00
|
|
|
|
2021-06-18 10:20:51 +00:00
|
|
|
--capture::
|
|
|
|
+
|
|
|
|
--
|
2022-02-27 05:23:18 +00:00
|
|
|
Start capturing from the specified interface and save it in the location
|
|
|
|
specified with --fifo.
|
2021-06-18 10:20:51 +00:00
|
|
|
--
|
2015-04-08 14:09:03 +00:00
|
|
|
|
2021-06-18 10:20:51 +00:00
|
|
|
--fifo=<path to file or pipe>::
|
|
|
|
+
|
|
|
|
--
|
2015-04-08 14:09:03 +00:00
|
|
|
Save captured packet to file or send it through pipe.
|
2021-06-18 10:20:51 +00:00
|
|
|
--
|
2015-04-08 14:09:03 +00:00
|
|
|
|
2021-06-18 10:20:51 +00:00
|
|
|
--adb-server-ip=<IP address>::
|
|
|
|
+
|
|
|
|
--
|
2022-02-27 05:23:18 +00:00
|
|
|
Use other than default (127.0.0.1) ADB daemon's IP address.
|
2021-06-18 10:20:51 +00:00
|
|
|
--
|
2015-04-08 14:09:03 +00:00
|
|
|
|
2021-06-18 10:20:51 +00:00
|
|
|
--adb-server-tcp-port=<TCP port>::
|
|
|
|
+
|
|
|
|
--
|
2022-02-27 05:23:18 +00:00
|
|
|
Use other than default (5037) ADB daemon's TCP port.
|
2021-06-18 10:20:51 +00:00
|
|
|
--
|
2015-04-08 14:09:03 +00:00
|
|
|
|
2021-06-18 10:20:51 +00:00
|
|
|
--logcat-text=<TRUE or FALSE>::
|
|
|
|
+
|
|
|
|
--
|
2022-02-27 05:23:18 +00:00
|
|
|
If TRUE then use text logcat rather then binary. This option only has an
|
|
|
|
effect on
|
2015-04-08 14:09:03 +00:00
|
|
|
Logcat interfaces. This have no effect from Lollipop where is no binary Logcat
|
|
|
|
available.
|
|
|
|
|
|
|
|
Defaults to FALSE.
|
2021-06-18 10:20:51 +00:00
|
|
|
--
|
2015-04-08 14:09:03 +00:00
|
|
|
|
2021-06-18 10:20:51 +00:00
|
|
|
--bt-server-tcp-port=<TCP port>::
|
|
|
|
+
|
|
|
|
--
|
2022-02-27 05:23:18 +00:00
|
|
|
Use other than default Bluetooth server TCP port on Android side.
|
2015-04-08 14:09:03 +00:00
|
|
|
On Lollipop defaults is 8872, earlier 4330.
|
2021-06-18 10:20:51 +00:00
|
|
|
--
|
2015-04-08 14:09:03 +00:00
|
|
|
|
2021-06-18 10:20:51 +00:00
|
|
|
--bt-forward-socket=<TRUE or FALSE>::
|
|
|
|
+
|
|
|
|
--
|
2015-04-08 14:09:03 +00:00
|
|
|
If TRUE then socket from Android side is forwarded to host side.
|
|
|
|
|
|
|
|
Defaults to FALSE.
|
2021-06-18 10:20:51 +00:00
|
|
|
--
|
2015-04-08 14:09:03 +00:00
|
|
|
|
2021-06-18 10:20:51 +00:00
|
|
|
--bt-local-ip=<IP address>::
|
|
|
|
+
|
|
|
|
--
|
2022-02-27 05:23:18 +00:00
|
|
|
Use other than default (127.0.0.1) IP address on host side for forwarded socket.
|
2021-06-18 10:20:51 +00:00
|
|
|
--
|
2015-04-08 14:09:03 +00:00
|
|
|
|
2021-06-18 10:20:51 +00:00
|
|
|
--bt-local-tcp-port=<TCP port>::
|
|
|
|
+
|
|
|
|
--
|
2015-04-08 14:09:03 +00:00
|
|
|
Specify port to be used on host side for forwarded socket.
|
2021-06-18 10:20:51 +00:00
|
|
|
--
|
2015-04-08 14:09:03 +00:00
|
|
|
|
2021-06-18 10:20:51 +00:00
|
|
|
== EXAMPLES
|
2015-04-08 14:09:03 +00:00
|
|
|
|
|
|
|
To see program arguments:
|
|
|
|
|
|
|
|
androiddump --help
|
|
|
|
|
|
|
|
To see program version:
|
|
|
|
|
|
|
|
androiddump --version
|
|
|
|
|
|
|
|
To see interfaces:
|
|
|
|
|
|
|
|
androiddump --extcap-interfaces
|
|
|
|
|
2021-10-01 23:36:17 +00:00
|
|
|
.Example output
|
|
|
|
----
|
|
|
|
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}
|
|
|
|
|
|
|
|
Human-readable display name of interfaces contains interface type, one of:
|
|
|
|
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-wifi-tcpdump (Android WiFi)
|
|
|
|
Then Android Device's name if available, otherwise "unknown".
|
|
|
|
Last part of it is DeviceID - the identificator of the device provided by Android SDK (see "adb devices").
|
|
|
|
|
|
|
|
For example:
|
|
|
|
"Android Logcat Main unknown MSM7627A"
|
|
|
|
|
|
|
|
"Android Logcat Main" - user-friendly type of interface
|
|
|
|
"unknown" - name of Android Device
|
|
|
|
"MSM7627A" - device ID
|
|
|
|
----
|
2015-04-08 14:09:03 +00:00
|
|
|
|
|
|
|
To see interface DLTs:
|
|
|
|
|
|
|
|
androiddump --extcap-interface=android-bluetooth-hcidump-MSM7627A --extcap-dlts
|
|
|
|
|
2021-10-01 23:36:17 +00:00
|
|
|
.Example output
|
2015-04-08 14:09:03 +00:00
|
|
|
dlt {number=99}{name=BluetoothH4}{display=Bluetooth HCI UART transport layer plus pseudo-header}
|
|
|
|
|
|
|
|
To see interface configuration options:
|
|
|
|
|
2015-10-23 08:56:29 +00:00
|
|
|
androiddump --extcap-interface=android-bluetooth-hcidump-MSM7627A --extcap-config
|
2015-04-08 14:09:03 +00:00
|
|
|
|
2021-10-01 23:36:17 +00:00
|
|
|
.Example output
|
2015-04-08 14:09:03 +00:00
|
|
|
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}
|
|
|
|
|
|
|
|
To capture:
|
|
|
|
|
|
|
|
androiddump --extcap-interface=android-bluetooth-hcidump-MSM7627A --fifo=/tmp/bluetooth.pcapng --capture
|
|
|
|
|
2022-02-27 05:23:18 +00:00
|
|
|
NOTE: To stop capturing CTRL+C/kill/terminate the application.
|
2015-04-08 14:09:03 +00:00
|
|
|
|
2021-06-18 10:20:51 +00:00
|
|
|
== SEE ALSO
|
2015-04-08 14:09:03 +00:00
|
|
|
|
2021-06-18 10:20:51 +00:00
|
|
|
xref:wireshark.html[wireshark](1), xref:tshark.html[tshark](1), xref:dumpcap.html[dumpcap](1), xref:extcap.html[extcap](4)
|
2015-04-08 14:09:03 +00:00
|
|
|
|
2021-06-18 10:20:51 +00:00
|
|
|
== NOTES
|
2015-04-08 14:09:03 +00:00
|
|
|
|
2021-06-18 10:20:51 +00:00
|
|
|
*Androiddump* is part of the *Wireshark* distribution. The latest version
|
|
|
|
of *Wireshark* can be found at https://www.wireshark.org.
|
2015-04-08 14:09:03 +00:00
|
|
|
|
2021-10-01 02:39:09 +00:00
|
|
|
HTML versions of the Wireshark project man pages are available at
|
2021-06-18 10:20:51 +00:00
|
|
|
https://www.wireshark.org/docs/man-pages.
|
2015-04-08 14:09:03 +00:00
|
|
|
|
2021-06-18 10:20:51 +00:00
|
|
|
== AUTHORS
|
2015-04-08 14:09:03 +00:00
|
|
|
|
2021-06-18 10:20:51 +00:00
|
|
|
.Original Author
|
|
|
|
[%hardbreaks]
|
|
|
|
Michal Labedzki <michal.labedzki[AT]tieto.com>
|
2015-04-08 14:09:03 +00:00
|
|
|
|
2021-06-18 10:20:51 +00:00
|
|
|
.Contributors
|
|
|
|
[%hardbreaks]
|
|
|
|
Roland Knall <rknall[AT]gmail.com>
|