Blob: btmgmt.rst

Blob id: c5b1402a71db6b21ab1b3b55be47b9a4a7fcee43

Size: 1.6 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
======
btmgmt
======

-------------------------------------
interactive bluetooth management tool
-------------------------------------

:Version: BlueZ
:Copyright: Free use of this software is granted under the terms of the GNU
            Lesser General Public Licenses (LGPL).
:Date: July 2023
:Manual section: 1
:Manual group: Linux System Administration

SYNOPSIS
========

**btmgmt** [--options] [commands]

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

**btmgmt(1)** interactive bluetooth management tool. The tool issues commands
to the Kernel using the Bluetooth Management socket, some commands may require
net-admin capability in order to work since the Bluetooth Management interface
is considered a low-level interface meant for the likes of **bluetoothd(8)**,
it is not recommended for applications to use it directly as it may result in
unexpected behavior.

OPTIONS
=======

:-i/--index: Specify adapter index
:-m-/-monitor: Enable monitor output
:-t/--timeout: Timeout in seconds for non-interactive mode
:-v/--version: Display version
:-i/--init-script: Init script file
:-h/--help: Display help

COMMANDS
========

:main: See **bluetoothctl-mgmt(1)**
:monitor: See **bluetoothctl-monitor(1)**

AUTOMATION
==========

Two common ways to automate the tool are to pass the commands directly like in
the follow example:

.. code-block::

    btmgmt <<EOF
    list
    show
    EOF

Or create a script and pass it as init-script:

.. code-block::

    $ vi test-script.bt
    list
    show
    quit
    :wq
    $ btmgmt --init-script=test-script

RESOURCES
=========

http://www.bluez.org

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

linux-bluetooth@vger.kernel.org