NAME¶

idevicebtlogger - Capture HCI traffic of a connected device.

SYNOPSIS¶

idevicebtlogger [OPTIONS] <FILE>

DESCRIPTION¶

Capture HCI traffic of a connected device. Requires Bluetooth logging profile to be installed on device with iOS 13 or higher. See https://www.bluetooth.com/blog/a-new-way-to-debug-iosbluetooth-applications/ for iOS device configuration.

The HCI traffic can be stored in Apple's native PacketLogger format or converted into PCAP format for live feedback in Wireshark.

OPTIONS¶

-u, --udid UDID

target specific device by UDID

-n, --network

connect to network device

-f, --format FORMAT

set log format: PacketLogger (default), or pcap

-x, --exit

exit when device disconnects

-d, --debug

enable communication debugging

-h, --help

prints usage information

-v, --version

prints version information.

EXAMPLES¶

idevicebtlogger -u 00008030-0000111ABC000DEF

Capture HCI traffic of device with UDID 00008030-0000111ABC000DEF.

idevicebtlogger -x

Capture HCI traffic of device and exit when the device is unplugged.

idevicebtlogger -f pcap

Capture HCI traffic of device in PCAP format.

idevicebtlogger -f pcap - | wireshark -k -i -

Capture HCI traffic and pipe it into Wireshark for live feedback.

AUTHORS¶

Geoffrey Kruse

Matthias Ringwald

ON THE WEB¶

https://libimobiledevice.org

https://github.com/libimobiledevice/libimobiledevice