summaryrefslogtreecommitdiff
path: root/tools/sdptool.rst
blob: a4f416cd362a50124b8c89b6ab4d6a3b8e4495dd (plain)
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
=======
sdptool
=======

-----------------------------------
control and interrogate SDP servers
-----------------------------------

:Authors: - Maxim Krasnyansky <maxk@qualcomm.com>
          - Edd Dumbill <ejad@debian.org>
:Version: BlueZ
:Copyright: Free use of this software is granted under ther terms of the GNU
            Lesser General Public Licenses (LGPL).
:Manual section: 1
:Manual group: Linux System Administration

SYNOPSIS
========

**sdptool** [*OPTIONS*] [*COMMAND* [*PARAMETERS*]]

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

**sdptool(1)** provides the interface for performing SDP queries on Bluetooth
devices, and administering a local SDP database.

COMMANDS
========

The following commands are available.  In all cases **bdaddr** specifies the
device to search or browse.  If *local* is used for **bdaddr**, then the local
SDP database is searched.

Services are identified and manipulated with a 4-byte **record_handle** (NOT
the service name). To find a service's **record_handle**, look for the
"Service RecHandle" line in the **search** or **browse** results

search [--bdaddr bdaddr] [--tree] [--raw] [--xml] service_name
    Search for services..

    Known  service  names  are  **DID**, **SP**, **DUN**, **LAN**, **FAX**,
    **OPUSH**, **FTP**, **HS**, **HF**, **HFAG**, **SAP**, **NAP**, **GN**,
    **PANU**, **HCRP**, **HID**, **CIP**, **A2SRC**, **A2SNK**, **AVRCT**,
    **AVRTG**, **UDIUE**, **UDITE** and **SYNCML**.

browse [--tree] [--raw] [--xml] [bdaddr]
    Browse all available services on the device specified by a Bluetooth
    address as a parameter.

records [--tree] [--raw] [--xml] bdaddr
    Retrieve all possible service records.

add [ --handle=N --channel=N ]
    Add a service to the local SDP database.

    You can specify a handle for this record using the **--handle** option.

    You can specify a channel to add the service on using the **--channel**
    option.

    NOTE: Local adapters configuration will not be updated and this command
    should  be used only for SDP testing.

del record_handle
    Remove a service from the local SDP database.

    NOTE: Local adapters configuration will not be updated and this command
    should be used only for SDP testing.

get [--tree] [--raw] [--xml] [--bdaddr bdaddr] record_handle
    Retrieve a service from the local SDP database.

setattr record_handle attrib_id attrib_value
    Set or add an attribute to an SDP record.

setseq record_handle attrib_id attrib_values
    Set or add an attribute sequence to an SDP record.

OPTIONS
=======

--help      Displays help on using sdptool.

EXAMPLES
========

.. code-block::

   $ sdptool browse 00:80:98:24:15:6D
   $ sdptool browse local
   $ sdptool add DUN
   $ sdptool del 0x10000

RESOURCES
=========

http://www.bluez.org

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

linux-bluetooth@vger.kernel.org