bluetooth.device.conf(5)
NAME
bluetooth.device.conf - Bluetooth device configuration file
DESCRIPTION
- Bluetooth device configuration framework provides ability to
- adjust certain Bluetooth device parameters on per-device basis.
- Bluetooth device configuration files are plain text files
- that should
conform to basic sh(1) syntax. Even though Bluetooth device - are not
exactly shell scripts, they are parsed and passed through - shell eval command. This makes it possible to use various shell tricks in
- the Bluetooth device configuration files.
- The /etc/rc.d/bluetooth script is used to start and stop
- Bluetooth
devices. This script is not executed by default when system - boots. It
is called by devd(8) in response to Bluetooth device arrival - and departure events. It is possible to execute this script by hand
- if required.
The script accepts Bluetooth device driver name as an extra - parameter.
- The system wide Bluetooth device configuration file is
- called
/etc/defaults/bluetooth.device.conf. Configuration parame - ters set in the
system wide Bluetooth device configuration file apply to ev - ery Bluetooth
device connected to the system. - Configuration parameters overrides for the specific Blue
- tooth device
should be placed in the - /etc/bluetooth/DEVICE_DRIVER_NAME.conf file. Where DEVICE_DRIVER_NAME is the device driver name of the
- Bluetooth
device. - The following list provides a name and short description for
- each variable that can be set in a Bluetooth device configuration
- file.
- authentication_enable
- (bool) The authentication_enable parameter con
- trols if the
device requires to authenticate the remote de - vice at connection setup. If set to ``YES'', the device will
- try to
authenticate the other device at connection set - up. Bluetooth
authentication requests are handled by hcsecd(8) - daemon.
- class (str) The class parameter is used to indicate
- the capabili
- ties of the device to other devices. For more
- details see
https://www.bluetooth.org/foundry/assign - numb/document/baseband.
- connectable
- (bool) The connectable parameter controls
- whether or not the
device should periodically scan for page at - tempts from other
devices. If set to ``YES'', the device will pe - riodically
scan for page attempts from other devices. - discoverable
- (bool) The discoverable parameter controls
- whether or not the
device should periodically scan for inquiry re - quests from
other devices. If set to ``YES'', the device - will periodically scan for inquiry requests from other de
- vices.
- encryption_mode
- (str) The encryption_mode parameter controls if
- the device
requires encryption to the remote device at con - nection setup.
At connection setup, only the devices with the
authentication_enable parameter enabled and - encryption_mode
parameter enabled will try to encrypt the con - nection to the
other device. Possible values are ``NONE'' en - cryption disabled, ``P2P'' encryption for only point-to
- point packets, or
``ALL'' encryption for both point-to-point and - broadcast
packets. - hci_debug_level
- (int) HCI node debug level. Higher values mean
- more verbose
output. - l2cap_debug_level
- (int) L2CAP node debug level. Higher values
- mean more verbose output.
- local_name (str) The local_name parameter provides the
- ability to modify
- the user friendly name for the device.
- role_switch
- (bool) The role_switch parameter controls
- whether the local
device should perform role switch. By default, - if role
switch is supported, the local device will try - to perform
role switch and become Master on incoming con - nection. Some
devices do not support role switch and thus in - coming connections from such devices will fail. If role
- switch is disabled then accepting device will remain Slave.
EXAMPLES
- /etc/bluetooth/ubt0.conf file should be used to specify
- configura
- tion parameters overrides for
- the first USB
Bluetooth device (device driv - er name is
ubt0). - /etc/bluetooth/ubt1.conf file should be used to specify
- configura
- tion parameters overrides for
- the second
USB Bluetooth device.
FILES
/etc/defaults/bluetooth.device.conf
/etc/rc.d/bluetooth
SEE ALSO
- ng_bt3c(4), ng_h4(4), ng_hci(4), ng_l2cap(4), ng_ubt(4), de
- vd(8),
hccontrol(8), hcsecd(8), l2control(8)
AUTHORS
- Maksim Yevmenkin <m_evmenkin@yahoo.com>
- BSD Dec 1, 2005