summaryrefslogtreecommitdiffstats
path: root/docs
diff options
context:
space:
mode:
authorGravatar Matthias Ringwald2022-01-10 23:47:47 +0100
committerGravatar Nikias Bassen2022-05-05 19:04:56 +0200
commitbe6eca8654f9bc7c686840a85a576b6453ad012d (patch)
treee54c88dffa86e2b041cf4f5b74a275e97e70fc20 /docs
parent5b611c495910155e2c30333761adec0793313ab4 (diff)
downloadlibimobiledevice-be6eca8654f9bc7c686840a85a576b6453ad012d.tar.gz
libimobiledevice-be6eca8654f9bc7c686840a85a576b6453ad012d.tar.bz2
idevicebtlogger: add --format option for 'pcap' and 'packetlogger'
Diffstat (limited to 'docs')
-rw-r--r--docs/idevicebtlogger.114
1 files changed, 13 insertions, 1 deletions
diff --git a/docs/idevicebtlogger.1 b/docs/idevicebtlogger.1
index 24903b5..39ffff7 100644
--- a/docs/idevicebtlogger.1
+++ b/docs/idevicebtlogger.1
@@ -8,7 +8,9 @@ idevicebtlogger \- Capture HCI traffic of a connected device.
.SH DESCRIPTION
-Capture HCI traffic of a connected device. Requires Bluetooth logging profile to be installed on device.
+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.
.SH OPTIONS
.TP
@@ -18,6 +20,9 @@ target specific device by UDID
.B \-n, \-\-network
connect to network device
.TP
+.B \-f, \-\-format FORMAT
+set log format: PacketLoggger (default), or pcap
+.TP
.B \-x, \-\-exit
exit when device disconnects
.TP
@@ -37,9 +42,16 @@ Capture HCI traffic of device with UDID 00008030-0000111ABC000DEF.
.TP
.B idevicebtlogger \-x
Capture HCI traffic of device and exit when the device is unplugged.
+.TP
+.B idevicebtlogger \-f pcap
+Capture HCI traffic of device in PCAP format.
+.TP
+.B idevicebtlogger -f pcap - | wireshark -k -i -
+Capture HCI traffic and pipe it into Wireshark for live feedback.
.SH AUTHORS
Geoffrey Kruse
+Matthias Ringwald
.SH ON THE WEB
https://libimobiledevice.org