idevicebtlogger(1)

idevicebtlogger(1) General Commands Manual idevicebtlogger(1)

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