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
       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.

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.

       -s <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 sub-
	      sequently 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.

       -t, --ts
	      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.

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

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

FILTERS
       filter is a space-separated list of packet categories: available cate-
       gories are hci, sco, l2cap, rfcomm, sdp, bnep, cmtp, hidp, hcrp, avdtp
       and capi.  If filters are used, only packets belonging to  the  speci-
       fied 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)