Blob: hcidump.rst

Blob id: 4d7bc989d44dce6e70271928d956e6313cf188bb

Size: 3.2 KB

  1
  2
  3
  4
  5
  6
  7
  8
  9
 10
 11
 12
 13
 14
 15
 16
 17
 18
 19
 20
 21
 22
 23
 24
 25
 26
 27
 28
 29
 30
 31
 32
 33
 34
 35
 36
 37
 38
 39
 40
 41
 42
 43
 44
 45
 46
 47
 48
 49
 50
 51
 52
 53
 54
 55
 56
 57
 58
 59
 60
 61
 62
 63
 64
 65
 66
 67
 68
 69
 70
 71
 72
 73
 74
 75
 76
 77
 78
 79
 80
 81
 82
 83
 84
 85
 86
 87
 88
 89
 90
 91
 92
 93
 94
 95
 96
 97
 98
 99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
=======
hcidump
=======

--------------
Parse HCI data
--------------

:Authors: - Maxim Krasnyansky <maxk@qualcomm.com>
          - Marcel Holtmann <marcel@holtmann.org>
          - Fabrizio Gennari <fabrizio.gennari@philips.com>
:Version: BlueZ
:Copyright: Free use of this software is granted under the terms of the GNU
            Lesser General Public Licenses (LGPL).
:Date: Nov 12, 2002
:Manual section: 1
:Manual group: Linux System Administration

SYNOPSIS
========

**hcidump** -h

**hcidump** [OPTIONS ...] [FILTERS]

DESCRIPTION
===========

**hcidump(1)** 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
=======

-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*. The saved dump file can be subsequently parsed with
    option **-r**.

-r <file>, --read-dump=<file>
    Data is not read from a Bluetooth device, but from *file*. *file* is
    created with option **-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
    For every packet, only the raw data is displayed.

-C <psm>, --cmtp=<psm>
    Sets the PSM value for the CAPI Message Transport Protocol.

-H <psm>, --hcrp=<psm>
    Sets the PSM value for the Hardcopy Control Channel.

-O <channel>, --obex=<channel>
    Sets the RFCOMM channel value for the Object Exchange Protocol.

-P <channel>, --ppp=<channel>
    Sets the RFCOMM channel value for the Point-to-Point Protocol.

-D <file>, --pppdump=<file>
    Extract PPP traffic with pppdump format.

-A <file>, --audio=<file>
    Extract SCO audio data.

-Y, --novendor
    Don't display any vendor commands or events and don't show any pin code or
    link key in plain text.

-h
    Prints usage info and exits

FILTERS
=======

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

RESOURCES
=========

http://www.bluez.org

REPORTING BUGS
==============

linux-bluetooth@vger.kernel.org