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 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 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.
-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.
For device configurations to persist across boots, add entries to the
/etc/bluetooth/btdevctl.conf file and set the
rc.conf(5) variable
btdevctl to YES.