bt-adapter(1)

bt-adapter1

A bluetooth adapter manager

Usage

bt-adapter [OPTION ...]

Help Options: -h, --help

Application {Options: -l, --list -a, --adapter=<name | mac> -i, --info -d, --discover --set <property> <value>}

Overview

This utility is used to manage Bluetooth adapters. You can list all available adapters, show information about adapter, change adapter properties or discover remote devices.

Options

-h, --help
Show help

-l, --list
List all available adapters

-a, --adapter <name|mac>
Specify adapter to use by his Name or MAC address
(if this option does not defined - default adapter used)

-i, --info
Show information about adapter (returns all properties)

-d, --discover
Discover remote devices (with remote device name resolving)

--set <property> <value>
Change adapter properties (see ADAPTER PROPERTIES section for list
of available properties)

Adapter properties

string Address [ro]
The Bluetooth adapter address (MAC).

string Alias [rw]
The Bluetooth adapter friendly name.

uint32 Class [ro]
The Bluetooth class of device.

boolean Powered [rw]
Switch an adapter on or off. This will also set the
appropiate connectable state.

boolean Discoverable [rw]
Switch an adapter to discoverable or non-discoverable
to either make it visible or hide it.

        If the DiscoverableTimeout is set to a non-zero
        value then the system will set this value back to
        false after the timer expired.
        In case the adapter is switched off, setting this
        value will fail.

boolean Pairable [rw]
Switch an adapter to pairable or non-pairable.

        Note that this property only affects incoming pairing
        requests.

uint32 PaireableTimeout [rw]
The pairable timeout in seconds. A value of zero
means that the timeout is disabled and it will stay in
pareable mode forever.

uint32 DiscoverableTimeout [rw]
The discoverable timeout in seconds. A value of zero
means that the timeout is disabled and it will stay in
discoverable/limited mode forever.

        The default value for the discoverable timeout should
        be 180 seconds (3 minutes).

boolean Discovering [ro]
Indicates that a device discovery procedure is active.

list UUIDs [ro]
List of 128-bit UUIDs that represents the available local
services.

Releases

8 releases since Debian 7 (Wheezy); the text changed 1 time.

  1. 7
  2. 8–Arch

Author

Alexander Orlenko <[email protected]>.

From bluez-tools 0.2.0-6 in Arch Linux 2026-11-01. Parsed by carta from the page's man source.