Updated: 2022/Sep/29

Please read Privacy Policy. It's for your privacy.

BTDEVCTL(8)                 System Manager's Manual                BTDEVCTL(8)

NAME
     btdevctl - Bluetooth remote device control utility

SYNOPSIS
     btdevctl [-A | -D] [-qv] [-m mode] -a address -d device -s service

DESCRIPTION
     The btdevctl utility is used to configure bluetooth devices in the
     system.  Normally, btdevctl will perform an SDP query to the remote
     device as needed, and cache the results in the /var/db/btdevctl.plist
     file for later use.  If neither Attach nor Detach is specified, btdevctl
     will display the configuration.

     The options are:

     -A      Attach device

     -a address
             Remote device address.  The address may be given as BDADDR or a
             name.  If a name was specified, btdevctl attempts to resolve the
             name via bt_gethostbyname(3).

     -D      Detach device

     -d device
             Local device address.  May be given as BDADDR or device name.

     -m mode
             Connection link mode.  The following modes are supported:

             none     clear previously set mode.
             auth     require devices be paired, see btpin(1).
             encrypt  auth, plus enable encryption.
             secure   encryption, plus change of link key.

             When configuring the HID service, btdevctl will set `auth' by
             default, or `encrypt' for keyboard devices.  If the device cannot
             handle authentication, then the mode will need to be cleared
             manually.

     -q      Ignore any cached data and perform a SDP query for the given
             service.

     -s service
             Service to configure.  Known services are:

             HID     Human Interface Device.
             HF      Handsfree.
             HSET    Headset.

     -v      Be verbose.

     For device configurations to persist across boots, add entries to the
     /etc/bluetooth/btdevctl.conf file and ensure the rc.conf(5) variable
     bluetooth is set to YES.

FILES
     /etc/bluetooth/btdevctl.conf
     /dev/bthub
     /var/db/btdevctl.plist

EXIT STATUS
     The btdevctl utility exits 0 on success, and >0 if an error occurs.

SEE ALSO
     btpin(1), bthidev(4), bthub(4), btsco(4), rc.conf(5)

     See the Bluetooth chapter of "The NetBSD Guide" for detailed examples of
     configuring keyboards, mice, and audio headsets.

HISTORY
     Parts of the btdevctl program originated in the FreeBSD bthidcontrol
     program.

AUTHORS
     Iain Hibbert for Itronix, Inc.
     Maksim Yevmenkin <m_evmenkin@yahoo.com>

NetBSD 10.99                   December 26, 2012                  NetBSD 10.99