androiddump - manual de referencia, opciones, ejemplos de comandos


NOMBRE

androiddump - Proporcionar interfaces para capturar desde dispositivos Android

SINOPSIS

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> ]
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

DESCRIPCIÓN

Androiddump es una herramienta extcap que proporciona interfaces para capturar desde un dispositivo Android. Solo hay dos requisitos:

  1. Debe tener el SDK de Android y agregarlo a su variable de entorno PATH. PATH debe contener un directorio con herramientas como "adb" y "android". El SDK de Android para varias plataformas está disponible en: https://developer.android.com/sdk/index.html#Other

  2. Debe tener permiso para capturar desde el dispositivo Android. Algunos dispositivos Android requieren autenticación en pantalla.

Interfaces compatibles:

  1. Logcat Main (binario [<=Jelly Bean] o texto)

  2. Sistema Logcat (binario [<=Jelly Bean] o texto)

  3. Eventos de Logcat (binario [<=Jelly Bean] o texto)

  4. Logcat Radio (binario [<=Jelly Bean] o texto)

  5. Logcat Crash (texto; de Lollipop)

  6. Bluetooth Hcidump [<=Jelly Bean]

  7. Analizador externo Bluetooth Bluedroid [Kitkat]

  8. Bluetooth BtsnoopNet [>=Lollipop]

  9. WiFi tcpdump [necesita tcpdump en el teléfono]

Tenga en cuenta que Androiddump también funcionará para FirefoxOS u otros sistemas operativos basados en Android.

OPCIONES

--help

Imprimir argumentos del programa.

--version

Imprimir la versión del programa.

--extcap-version

Imprimir versión extcapized.

--debug

Imprimir mensajes adicionales.

--extcap-interfaces

Lista de interfaces disponibles.

--extcap-interface=<interface>

Utilice las interfaces especificadas.

--extcap-dlts

Muestra las DLT de la interfaz especificada.

--extcap-config

Muestra las opciones de configuración de la interfaz especificada.

--capture

Comience a capturar desde la interfaz especificada y guárdelo en la ubicación especificada con --fifo.

--fifo=<path to file or pipe>

Guarde el paquete capturado en un archivo o envíelo a través de una tubería.

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

Utilice una dirección IP distinta a la predeterminada (127.0.0.1) del demonio ADB.

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

Utilice un puerto TCP del daemon ADB que no sea el predeterminado (5037).

--logcat-text=<TRUE or FALSE>

Si es VERDADERO, use logcat de texto en lugar de binario. Esta opción solo tiene efecto en las interfaces de Logcat. Esto no tiene efecto en Lollipop, donde no hay Logcat binario disponible.

El valor predeterminado es FALSO.

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

Use otro puerto TCP del servidor Bluetooth predeterminado en el lado de Android. El valor predeterminado de Lollipop es 8872, antes 4330.

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

Si es VERDADERO, el socket del lado de Android se reenvía al lado del host.

El valor predeterminado es FALSO.

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

Use una dirección IP diferente a la predeterminada (127.0.0.1) en el lado del host para el socket reenviado.

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

Especifique el puerto que se usará en el lado del host para el socket reenviado.

EJEMPLOS

Para ver los argumentos del programa:

androiddump --help

Para ver la versión del programa:

androiddump --version

Para ver las interfaces:

androiddump --extcap-interfaces

Ejemplo de salida

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 Devices 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

Para ver las DLT de la interfaz:

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

Ejemplo de salida

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

Para ver las opciones de configuración de la interfaz:

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

Ejemplo de salida

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}

Capturar:

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

Nota: Para dejar de capturar CTRL+C/matar/terminar la aplicación.

VER TAMBIÉN

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

NOTAS

Androiddump es parte de la distribución Wireshark. La última versión de Wireshark se puede encontrar en https://www.wireshark.org.

Las versiones HTML de las páginas man del proyecto Wireshark están disponibles en https://www.wireshark.org/docs/man-pages.

AUTORES

Autor original
Michal Labedzki

Contribuidores
Roland Knall