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

NAME

6       hcidump - Parse HCI data
7

SYNOPSIS

9       hcidump -h
10
11       hcidump [OPTIONS ...] [FILTERS]
12

DESCRIPTION

14       hcidump(1)  reads raw HCI data coming from and going to a Bluetooth de‐
15       vice (which can be specified with the option -i, default is  the  first
16       available  one) and prints to screen commands, events and data in a hu‐
17       man-readable form.  Optionally, the dump  can  be  written  to  a  file
18       rather than parsed, and the dump file can be parsed in a subsequent mo‐
19       ment.
20

OPTIONS

22       -i <hciX>
23              Data is read from hciX, which must be the name of  an  installed
24              Bluetooth device. If not specified, and if -r option is not set,
25              data is read from the first available Bluetooth device.
26
27       -l <len>, --snap-len=<len>
28              Sets max length of processed packets to len.
29
30       -p <psm>, --psm=<psm>
31              Sets default Protocol Service Multiplexer to psm.
32
33       -m <compid>, --manufacturer=<compid>
34              Sets default company id for manufacturer to compid.
35
36       -w <file>, --save-dump=<file>
37              Parse output is not printed to screen, instead  data  read  from
38              device is saved in file. The saved dump file can be subsequently
39              parsed with option -r.
40
41       -r <file>, --read-dump=<file>
42              Data is not read from a Bluetooth device, but from file. file is
43              created  with option -t, --timestamp prepend a time stamp to ev‐
44              ery packet.
45
46       -a, --ascii
47              For every packet, not only is the  packet  type  displayed,  but
48              also all data in ASCII.
49
50       -x, --hex
51              For  every  packet,  not  only is the packet type displayed, but
52              also all data in hex.
53
54       -X, --ext
55              For every packet, not only is the  packet  type  displayed,  but
56              also all data in hex and ASCII.
57
58       -R, --raw
59              For every packet, only the raw data is displayed.
60
61       -C <psm>, --cmtp=<psm>
62              Sets the PSM value for the CAPI Message Transport Protocol.
63
64       -H <psm>, --hcrp=<psm>
65              Sets the PSM value for the Hardcopy Control Channel.
66
67       -O <channel>, --obex=<channel>
68              Sets the RFCOMM channel value for the Object Exchange Protocol.
69
70       -P <channel>, --ppp=<channel>
71              Sets the RFCOMM channel value for the Point-to-Point Protocol.
72
73       -D <file>, --pppdump=<file>
74              Extract PPP traffic with pppdump format.
75
76       -A <file>, --audio=<file>
77              Extract SCO audio data.
78
79       -Y, --novendor
80              Don't  display  any vendor commands or events and don't show any
81              pin code or link key in plain text.
82
83       -h     Prints usage info and exits
84

FILTERS

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

RESOURCES

93       http://www.bluez.org
94

REPORTING BUGS

96       linux-bluetooth@vger.kernel.org
97

AUTHOR

99       Maxim Krasnyansky <maxk@qualcomm.com>,  Marcel  Holtmann  <marcel@holt‐
100       mann.org>, Fabrizio Gennari <fabrizio.gennari@philips.com>
101

103       Free use of this software is granted under ther terms of the GNU Lesser
104       General Public Licenses (LGPL).
105
106
107
108
109BlueZ                            Nov 12, 2002                       HCIDUMP(1)
Impressum