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 
	      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 , --snap-len=
	      Sets max length of processed packets to len.

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

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

       -w , --save-dump=
	      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 , --read-dump=
	      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  and Marcel Holtmann
       

       man page by Fabrizio Gennari 



BlueZ				 Nov 12 2002			   HCIDUMP(1)

UNIX/Linux commands referenced on this page:

1. raw
2. dump
3. file
4. info
5. which
6. id
7. time
8. display
9. rfcomm
10. man