- NetBSD Manual Pages
BTDEVCTL(8) NetBSD System Manager's Manual BTDEVCTL(8)
Powered by man-cgi (2021-06-01).
Maintained for NetBSD
by Kimmo Suominen.
Based on man-cgi by Panagiotis Christias.
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
-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.
-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 <email@example.com>
NetBSD 9.3 December 26, 2012 NetBSD 9.3