1HCIDUMP(8) Linux System Administration HCIDUMP(8)
2
6 hcidump - Parse HCI data
7
9 hcidump [-h]
10 hcidump [option [option...]] [filter]
11
14 hcidump reads raw HCI data coming from and going to a Bluetooth device
15 (which can be specified with the option -i, default is the first avail‐
16 able one) and prints to screen commands, events and data in a human-
17 readable form. Optionally, the dump can be written to a file rather
18 than parsed, and the dump file can be parsed in a subsequent moment.
19
21 -h Prints usage info and exits
22 -i <hciX>
24 Data is read from hciX, which must be the name of an installed
25 Bluetooth device. If not specified, and if -r option is not set,
26 data is read from the first available Bluetooth device.
27 -l <len>, --snap-len=<len>
29 Sets max length of processed packets to len.
30 -p <psm>, --psm=<psm>
32 Sets default Protocol Service Multiplexer to psm.
33 -m <compid>, --manufacturer=<compid>
35 Sets default company id for manufacturer to compid.
36 -w <file>, --save-dump=<file>
38 Parse output is not printed to screen, instead data read from
39 device is saved in file file. The saved dump file can be subse‐
40 quently parsed with option -r.
41 -r <file>, --read-dump=<file>
43 Data is not read from a Bluetooth device, but from file file.
44 file is created with option -w.
45 -s <host>, --send-dump=<host>
47 Parse output is not printed to screen, instead data read from
48 device is sent to host host.
49 -n <host>, --recv-dump=<host>
51 Data is not read from a Bluetooth device, but from host host.
52 -d <host>, --wait-dump=<host>
54 Data is read from a Bluetooth device, but then send to host for
55 processing. No data is read if no host is connected.
56 -t, --timestamp
58 Prepend a time stamp to every packet.
59 -a, --ascii
61 For every packet, not only is the packet type displayed, but
62 also all data in ASCII.
63 -x, --hex
65 For every packet, not only is the packet type displayed, but
66 also all data in hex.
67 -X, --ext
69 For every packet, not only is the packet type displayed, but
70 also all data in hex and ASCII.
71 -R, --raw
73 For every packet, only the raw data is displayed.
74 -C, --cmtp=<psm>
76 Sets the PSM value for the CAPI Message Transport Protocol.
77 -H, --hcrp=<psm>
79 Sets the PSM value for the Hardcopy Control Channel.
80 -O, --obex=<channel>
82 Sets the RFCOMM channel value for the Object Exchange Protocol.
83 -P, --ppp=<channel>
85 Sets the RFCOMM channel value for the Point-to-Point Protocol.
86 -D, --pppdump=<file>
88 Extract PPP traffic with pppdump format.
89 -A, --audio=<file>
91 Extract SCO audio data.
92 -Y, --novendor
94 Don't display any vendor commands or events and don't show any
95 pin code or link key in plain text.
96 -4, --ipv4
98 Use IPv4 when sending information over the network
99 -6, --ipv6
101 Use IPv6 when sending information over the network
102
104 filter is a space-separated list of packet categories: available cate‐
105 gories are lmp, hci, sco, l2cap, rfcomm, sdp, bnep, cmtp, hidp, hcrp,
106 avdtp, avctp, obex, capi and ppp. If filters are used, only packets
107 belonging to the specified categories are dumped. By default, all pack‐
108 ets are dumped.
109
111 Written by Maxim Krasnyansky <maxk@qualcomm.com> and Marcel Holtmann
112 <marcel@holtmann.org>
113 man page by Fabrizio Gennari <fabrizio.gennari@philips.com>
115BlueZ Nov 12 2002 HCIDUMP(8)