androiddump - manual de referência, opções, exemplos de comandos


NOME

androiddump - Fornecer interfaces para capturar de dispositivos Android

SINOPSE

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

DESCRIÇÃO

Androiddump é uma ferramenta extcap que fornece interfaces para capturar de um dispositivo Android. Existem apenas dois requisitos:

  1. Você deve ter o Android SDK e adicioná-lo à sua variável de ambiente PATH. PATH deve conter diretório com ferramentas como "adb" e "android". O Android SDK para várias plataformas está disponível em: https://developer.android.com/sdk/index.html#Other

  2. Você deve ter permissão para capturar do dispositivo Android. Alguns dispositivos Android exigem autenticação na tela.

Interfaces suportadas:

  1. Logcat Main (binário [<=Jelly Bean] ou texto)

  2. Logcat System (binário [<=Jelly Bean] ou texto)

  3. Logcat Events (binário [<=Jelly Bean] ou texto)

  4. Rádio Logcat (binário [<=Jelly Bean] ou texto)

  5. Logcat Crash (texto; de Lollipop)

  6. Bluetooth Hcidump [<=Jelly Bean]

  7. Analisador externo Bluetooth Bluedroid [Kitkat]

  8. Bluetooth BtsnoopNet [>=pirulito]

  9. WiFi tcpdump [precisa de tcpdump no telefone]

Observe que o Androiddump funcionará também para o FirefoxOS ou outros sistemas operacionais baseados no Android.

OPÇÕES

--help

Imprima os argumentos do programa.

--version

Imprimir a versão do programa.

--extcap-version

Imprima a versão extracapada.

--debug

Imprimir mensagens adicionais.

--extcap-interfaces

Liste as interfaces disponíveis.

--extcap-interface=<interface>

Use interfaces especificadas.

--extcap-dlts

Lista DLTs da interface especificada.

--extcap-config

Lista as opções de configuração da interface especificada.

--capture

Inicie a captura da interface especificada e salve-a no local especificado com --fifo.

--fifo=<path to file or pipe>

Salve o pacote capturado em um arquivo ou envie-o através do pipe.

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

Use um endereço IP do daemon ADB diferente do padrão (127.0.0.1).

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

Use uma porta TCP do daemon ADB diferente da padrão (5037).

--logcat-text=<TRUE or FALSE>

Se for TRUE, use logcat de texto em vez de binário. Esta opção só tem efeito nas interfaces do Logcat. Isso não tem efeito no Lollipop, onde não há Logcat binário disponível.

O padrão é FALSO.

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

Use outra porta TCP do servidor Bluetooth padrão no lado do Android. No Lollipop, o padrão é 8872, antes 4330.

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

Se TRUE, o soquete do lado do Android é encaminhado para o lado do host.

O padrão é FALSO.

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

Use um endereço IP diferente do padrão (127.0.0.1) no lado do host para o soquete encaminhado.

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

Especifique a porta a ser usada no lado do host para o soquete encaminhado.

EXEMPLOS

Para ver os argumentos do programa:

androiddump --help

Para ver a versão do programa:

androiddump --version

Para ver as interfaces:

androiddump --extcap-interfaces

Exemplo de saída

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 os DLTs de interface:

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

Exemplo de saída

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

Para ver as opções de configuração da interface:

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

Exemplo de saída

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

Observação: Para interromper a captura, CTRL+C/matar/encerrar o aplicativo.

VEJA TAMBÉM

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

NOTAS

Androiddump faz parte da distribuição Wireshark. A versão mais recente do Wireshark pode ser encontrada em https://www.wireshark.org.

Versões HTML das páginas man do projeto Wireshark estão disponíveis em https://www.wireshark.org/docs/man-pages.

AUTORES

Autor Original
Michal Labedzki

Contribuintes
Roland Knall