File: btmgmt.rst

package info (click to toggle)
bluez 5.83-1~exp1
  • links: PTS, VCS
  • area: main
  • in suites: experimental
  • size: 25,664 kB
  • sloc: ansic: 471,418; python: 4,751; sh: 4,580; makefile: 1,042; xml: 126
file content (79 lines) | stat: -rw-r--r-- 1,646 bytes parent folder | download | duplicates (2)
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