1HCIDUMP(1)                Linux System Administration               HCIDUMP(1)
2
3
4

NAME

6       hcidump - Parse HCI data
7

SYNOPSIS

9       hcidump [-h]
10       hcidump [option [option...]] [filter]
11
12

DESCRIPTION

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

OPTIONS

21       -h     Prints usage info and exits
22
23       -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
28       -l <len>, --snap-len=<len>
29              Sets max length of processed packets to len.
30
31       -p <psm>, --psm=<psm>
32              Sets default Protocol Service Multiplexer to psm.
33
34       -m <compid>, --manufacturer=<compid>
35              Sets default company id for manufacturer to compid.
36
37       -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
42       -r <file>, --read-dump=<file>
43              Data  is  not  read from a Bluetooth device, but from file file.
44              file is created with option -t, --timestamp Prepend a time stamp
45              to every packet.
46
47       -a, --ascii
48              For  every  packet,  not  only is the packet type displayed, but
49              also all data in ASCII.
50
51       -x, --hex
52              For every packet, not only is the  packet  type  displayed,  but
53              also all data in hex.
54
55       -X, --ext
56              For  every  packet,  not  only is the packet type displayed, but
57              also all data in hex and ASCII.
58
59       -R, --raw
60              For every packet, only the raw data is displayed.
61
62       -C, --cmtp=<psm>
63              Sets the PSM value for the CAPI Message Transport Protocol.
64
65       -H, --hcrp=<psm>
66              Sets the PSM value for the Hardcopy Control Channel.
67
68       -O, --obex=<channel>
69              Sets the RFCOMM channel value for the Object Exchange Protocol.
70
71       -P, --ppp=<channel>
72              Sets the RFCOMM channel value for the Point-to-Point Protocol.
73
74       -D, --pppdump=<file>
75              Extract PPP traffic with pppdump format.
76
77       -A, --audio=<file>
78              Extract SCO audio data.
79
80       -Y, --novendor
81              Don't display any vendor commands or events and don't  show  any
82              pin code or link key in plain text.
83

FILTERS

85       filter  is a space-separated list of packet categories: available cate‐
86       gories are lmp, hci, sco, l2cap, rfcomm, sdp, bnep, cmtp,  hidp,  hcrp,
87       avdtp,  avctp,  obex,  capi and ppp.  If filters are used, only packets
88       belonging to the specified categories are dumped. By default, all pack‐
89       ets are dumped.
90

AUTHORS

92       Written  by  Maxim  Krasnyansky <maxk@qualcomm.com> and Marcel Holtmann
93       <marcel@holtmann.org>
94
95       man page by Fabrizio Gennari <fabrizio.gennari@philips.com>
96
97
98
99BlueZ                             Nov 12 2002                       HCIDUMP(1)
Impressum