hcidump

HCIDUMP(1)                Linux System Administration               HCIDUMP(1)

NAME

       hcidump - Parse HCI data

SYNOPSIS

       hcidump [-h]
       hcidump [option [option...]] [filter]

DESCRIPTION

       hcidump  reads raw HCI data coming from and going to a Bluetooth device
       (which can be specified with the option -i, default is the first avail-
       able  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.

OPTIONS

       -h     Prints usage info and exits

       -i <hciX>
              Data  is  read from hciX, which must be the name of an installed
              Bluetooth device. If not specified, and if -r option is not set,
              data is read from the first available Bluetooth device.

       -l <len>, --snap-len=<len>
              Sets max length of processed packets to len.

       -p <psm>, --psm=<psm>
              Sets default Protocol Service Multiplexer to psm.

       -m <compid>, --manufacturer=<compid>
              Sets default company id for manufacturer to compid.

       -w <file>, --save-dump=<file>
              Parse  output  is  not printed to screen, instead data read from
              device is saved in file file.  The saved dump file can be subse-
              quently parsed with option -r.

       -r <file>, --read-dump=<file>
              Data  is  not  read from a Bluetooth device, but from file file.
              file is crated with option -w.

       -s <host>, --send-dump=<host>
              Parse output is not printed to screen, instead  data  read  from
              device is send to host host.

       -n <host>, --recv-dump=<host>
              Data is not read from a Bluetooth device, but from host host.

       -t, --timestamp
              Prepend a time stamp to every packet.

       -a, --ascii
              For  every  packet,  not  only is the packet type displayed, but
              also all data in ASCII.

       -x, --hex
              For every packet, not only is the  packet  type  displayed,  but
              also all data in hex.

       -X, --ext
              For  every  packet,  not  only is the packet type displayed, but
              also all data in hex and ASCII.

       -R, --raw
              Raw mode: do not display packet type, only data.

       -B, --bpa
              BPA mode: only display vendor specific data packets.

       -C, --cmtp
              Sets the PSM value for the CAPI Message Transport Protocol

       -H, --hcrp
              Sets the PSM value for the Hardcopy Control Channel

       -O, --obex
              Sets the RFCOMM channel value for the Object Exchange protocol

       -V, --verbose
              Enables a more verbose decoding of every packet.

FILTERS

       filter is a space-separated list of packet categories: available  cate-
       gories are hci, sco, l2cap, rfcomm, sdp, bnep, cmtp, hidp, hcrp, avdtp,
       obex and capi.  If filters are used,  only  packets  belonging  to  the
       specified categories are dumped. By default, all packets are dumped.

AUTHORS

       Written  by  Maxim  Krasnyansky <maxk@qualcomm.com> and Marcel Holtmann
       <marcel@holtmann.org>

       man page by Fabrizio Gennari <fabrizio.gennari@philips.com>



BlueZ                             Nov 12 2002                       HCIDUMP(1)