summaryrefslogtreecommitdiffstats
path: root/docs/idevicebtlogger.1
blob: 98a723f941dccb4710b3432a3c19924f16951765 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
.TH "idevicebtlogger" 1
.SH NAME
idevicebtlogger \- Capture HCI traffic of a connected device.
.SH SYNOPSIS
.B idevicebtlogger
[OPTIONS]
<FILE>

.SH 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. 

.SH OPTIONS
.TP
.B \-u, \-\-udid UDID
target specific device by UDID
.TP
.B \-n, \-\-network
connect to network device
.TP
.B \-f, \-\-format FORMAT
set log format: PacketLogger (default), or pcap
.TP
.B \-x, \-\-exit
exit when device disconnects
.TP
.B \-d, \-\-debug
enable communication debugging
.TP
.B \-h, \-\-help
prints usage information
.TP
.B \-v, \-\-version
prints version information.

.SH EXAMPLES
.TP
.B idevicebtlogger \-u 00008030\-0000111ABC000DEF
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

https://github.com/libimobiledevice/libimobiledevice