2002-11-16 09:43:46 +08:00
|
|
|
.TH HCIDUMP 1 "Nov 12 2002" BlueZ "Linux System Administration"
|
|
|
|
|
.SH NAME
|
|
|
|
|
hcidump \- Parse HCI data
|
|
|
|
|
.SH SYNOPSIS
|
|
|
|
|
.B hcidump [-h]
|
|
|
|
|
.br
|
|
|
|
|
.B hcidump [option [option...]] [filter]
|
|
|
|
|
|
|
|
|
|
.SH DESCRIPTION
|
|
|
|
|
.LP
|
|
|
|
|
.B
|
|
|
|
|
hcidump
|
|
|
|
|
reads raw HCI data coming from and going to a Bluetooth device (which can be
|
|
|
|
|
specified with the option
|
|
|
|
|
.BR -i ,
|
|
|
|
|
default is the first available one) and prints to screen commands, events and
|
|
|
|
|
data in a human-readable form. Optionally, the dump can be written to a file
|
|
|
|
|
rather than parsed, and the dump file can be parsed in a subsequent moment.
|
|
|
|
|
.SH OPTIONS
|
|
|
|
|
.TP
|
|
|
|
|
.BI -h
|
|
|
|
|
Prints usage info and exits
|
|
|
|
|
.TP
|
|
|
|
|
.BI -i " <hciX>"
|
|
|
|
|
Data is read from
|
|
|
|
|
.IR hciX ,
|
|
|
|
|
which must be the name of an installed Bluetooth device. If not specified,
|
|
|
|
|
and if
|
|
|
|
|
.B
|
|
|
|
|
-r
|
|
|
|
|
option is not set, data is read from the first available Bluetooth device.
|
|
|
|
|
.TP
|
2004-10-20 17:57:10 +08:00
|
|
|
.BI -l " <len>" "\fR,\fP \-\^\-snap-len=" "<len>"
|
2004-03-03 04:31:22 +08:00
|
|
|
Sets max length of processed packets to
|
|
|
|
|
.IR len .
|
|
|
|
|
.TP
|
|
|
|
|
.BI -p " <psm>" "\fR,\fP \-\^\-psm=" "<psm>"
|
|
|
|
|
Sets default Protocol Service Multiplexer to
|
|
|
|
|
.IR psm .
|
|
|
|
|
.TP
|
2004-08-27 08:03:18 +08:00
|
|
|
.BI -m " <compid>" "\fR,\fP \-\^\-manufacturer=" "<compid>"
|
|
|
|
|
Sets default company id for manufacturer to
|
|
|
|
|
.IR compid .
|
|
|
|
|
.TP
|
2004-03-03 04:31:22 +08:00
|
|
|
.BI -w " <file>" "\fR,\fP \-\^\-save-dump=" "<file>"
|
|
|
|
|
Parse output is not printed to screen, instead data read from device is saved in file
|
|
|
|
|
.IR file .
|
|
|
|
|
The saved dump file can be subsequently parsed with option
|
|
|
|
|
.BR -r .
|
|
|
|
|
.TP
|
2002-11-16 09:43:46 +08:00
|
|
|
.BI -r " <file>" "\fR,\fP \-\^\-read-dump=" "<file>"
|
|
|
|
|
Data is not read from a Bluetooth device, but from file
|
|
|
|
|
.IR file .
|
|
|
|
|
.I
|
|
|
|
|
file
|
|
|
|
|
is crated with option
|
|
|
|
|
.BR -w .
|
2004-10-20 17:57:10 +08:00
|
|
|
.TP
|
|
|
|
|
.BI -s " <host>" "\fR,\fP \-\^\-send-dump=" "<host>"
|
|
|
|
|
Parse output is not printed to screen, instead data read from device is send to host
|
|
|
|
|
.IR host .
|
|
|
|
|
.TP
|
|
|
|
|
.BI -n " <host>" "\fR,\fP \-\^\-recv-dump=" "<host>"
|
|
|
|
|
Data is not read from a Bluetooth device, but from host
|
|
|
|
|
.IR host .
|
2002-11-16 09:43:46 +08:00
|
|
|
.TP
|
2004-10-20 17:57:10 +08:00
|
|
|
.BR -t ", " "\-\^\-timestamp"
|
2004-03-03 04:31:22 +08:00
|
|
|
Prepend a time stamp to every packet.
|
2002-11-16 09:43:46 +08:00
|
|
|
.TP
|
2004-08-27 08:03:18 +08:00
|
|
|
.BR -a ", " "\-\^\-ascii"
|
|
|
|
|
For every packet, not only is the packet type displayed, but also all data in ASCII.
|
|
|
|
|
.TP
|
2002-11-16 09:43:46 +08:00
|
|
|
.BR -x ", " "\-\^\-hex"
|
|
|
|
|
For every packet, not only is the packet type displayed, but also all data in hex.
|
|
|
|
|
.TP
|
2004-08-27 08:03:18 +08:00
|
|
|
.BR -X ", " "\-\^\-ext"
|
|
|
|
|
For every packet, not only is the packet type displayed, but also all data in hex and ASCII.
|
2002-11-16 09:43:46 +08:00
|
|
|
.TP
|
|
|
|
|
.BR -R ", " "\-\^\-raw"
|
|
|
|
|
Raw mode: do not display packet type, only data.
|
2004-03-03 04:31:22 +08:00
|
|
|
.TP
|
2004-10-24 01:57:17 +08:00
|
|
|
.BR -B ", " "\-\^\-bpa"
|
|
|
|
|
BPA mode: only display vendor specific data packets.
|
|
|
|
|
.TP
|
2004-03-03 04:31:22 +08:00
|
|
|
.BR -C ", " "\-\^\-cmtp"
|
|
|
|
|
Sets the PSM value for the CAPI Message Transport Protocol
|
2004-03-03 10:59:16 +08:00
|
|
|
.TP
|
|
|
|
|
.BR -H ", " "\-\^\-hcrp"
|
2004-07-25 23:36:28 +08:00
|
|
|
Sets the PSM value for the Hardcopy Control Channel
|
2004-09-14 03:09:17 +08:00
|
|
|
.TP
|
|
|
|
|
.BR -O ", " "\-\^\-obex"
|
|
|
|
|
Sets the RFCOMM channel value for the Object Exchange protocol
|
2002-11-16 09:43:46 +08:00
|
|
|
.SH FILTERS
|
|
|
|
|
.B
|
|
|
|
|
filter
|
|
|
|
|
is a space-separated list of packet categories: available categories are
|
|
|
|
|
.IR hci ,
|
|
|
|
|
.IR sco ,
|
2004-03-03 04:31:22 +08:00
|
|
|
.IR l2cap ,
|
2002-11-16 09:43:46 +08:00
|
|
|
.IR rfcomm ,
|
|
|
|
|
.IR sdp ,
|
2004-02-24 21:17:00 +08:00
|
|
|
.IR bnep ,
|
2004-03-03 04:31:22 +08:00
|
|
|
.IR cmtp ,
|
2004-03-03 10:59:16 +08:00
|
|
|
.IR hidp ,
|
2004-06-11 03:04:11 +08:00
|
|
|
.IR hcrp ,
|
2004-09-14 03:09:17 +08:00
|
|
|
.IR avdtp ,
|
|
|
|
|
.IR obex
|
2002-11-16 09:43:46 +08:00
|
|
|
and
|
2004-03-03 04:31:22 +08:00
|
|
|
.IR capi .
|
2002-11-16 09:43:46 +08:00
|
|
|
If filters are used, only packets belonging to the specified categories are
|
|
|
|
|
dumped. By default, all packets are dumped.
|
|
|
|
|
.SH AUTHORS
|
|
|
|
|
Written by Maxim Krasnyansky <maxk@qualcomm.com>
|
2004-03-03 04:31:22 +08:00
|
|
|
and Marcel Holtmann <marcel@holtmann.org>
|
2002-11-16 09:43:46 +08:00
|
|
|
.PP
|
|
|
|
|
man page by Fabrizio Gennari <fabrizio.gennari@philips.com>
|
