NAME
btdevctl —
Bluetooth remote device control
utility
SYNOPSIS
btdevctl |
[-A | -D]
[-qv] [-m
mode] -a
address -d
device -s
service |
DESCRIPTION
Thebtdevctl 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
-aaddress- Remote device address. The address may be given as
BDADDR or a name. If a name was specified,
btdevctlattempts to resolve the name via bt_gethostbyname(3). -D- Detach device
-ddevice- Local device address. May be given as BDADDR or device name.
-mmode- 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,
btdevctlwill 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.
-sservice- 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>