btmgmt(1)

BTMGMT(1) Linux System Administration BTMGMT(1)

NAME

btmgmt - interactive bluetooth management tool

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:

btmgmt <<EOF
list
show
EOF


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

$ 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

COPYRIGHT

Free use of this software is granted under the terms of the GNU Lesser General Public Licenses (LGPL).

July 2023 BlueZ