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.
- -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
set the
rc.conf(5)
variable
btdevctl
to YES.
EXIT STATUS
FILES
/etc/bluetooth/btdevctl.conf
-
/dev/bthub
-
/var/db/btdevctl.plist
-
SEE ALSO
btpin(1),
bthidev(4),
bthub(4),
btsco(4),
rc.conf(5)
HISTORY
Parts of the
btdevctl
program originated in the
FreeBSD
bthidcontrol
program.
AUTHORS
Iain Hibbert
for Itronix, Inc.
Maksim Yevmenkin <m_evmenkin@yahoo.com>