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

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

     -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
     The btdevctl utility exits 0 on success, and >0 if an error occurs.

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

AUTHORS
     Iain Hibbert for Itronix, Inc.
     Maksim Yevmenkin <m_evmenkin@yahoo.com>

NetBSD 5.0_STABLE               April 10, 2007               NetBSD 5.0_STABLE
