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

     btdevctl -- Bluetooth remote device control utility

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

     The btdevctl utility is used to configure bluetooth devices in the sys-
     tem.  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 dis-
     play 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

     -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.


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

     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.

     Parts of the btdevctl program originated in the FreeBSD bthidcontrol pro-

     Iain Hibbert for Itronix, Inc.
     Maksim Yevmenkin <>

NetBSD 8.1                     December 26, 2012                    NetBSD 8.1

You can also request any man page by name and (optionally) by section:


Use the DEFAULT collection to view manual pages for third-party software.

©1994 Man-cgi 1.15, Panagiotis Christias
©1996-2019 Modified for NetBSD by Kimmo Suominen