Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help 
BLUETOOTH-CONFIG(8)	     System Manager's Manual	     BLUETOOTH-CONFIG(8)

NAME
     bluetooth-config  --  a script to manage config files for the bluetooth sub
     system

SYNOPSIS
     bluetooth-config scan [-d device] [-n node]

DESCRIPTION
     The bluetooth-config utility is an interactive script to provide a frontend
     to the complex bluetooth sub system daemons.

     The following options are available:

     -d       Scan for a specific bluetooth device address.

     -n       Limit scan to a specific host controller.  Hint: List all netgraph
	      nodes with `/usr/sbin/ngctl list'.

     bluetooth-config will help finding and setting  up  bluetooth  controllers,
     scan  for nearby bluetooth devices in pairing mode, lookup their names, al-
     low mapping to friendly names in /etc/bluetooth/hosts, ask for  the  paring
     PIN, instrument hcsecd(8) to securely pair with new devices and, if the de-
     vice  offers HID endpoints such as mice or keyboards, configure and restart
     bthidd(8).

     bluetooth-config can bring up any interface and daemon necessary for opera-
     tion and, if a node is provided on command line, will do  so  automatically
     for that interface.

FILES
     /etc/bluetooth/hosts
     sysrc -n bthidd_config
     sysrc -n hcsecd_config

EXAMPLES
     bluetooth-config scan -n ubt0 -a 00:26:bb:7a:58:95

	   This will scan the bluetooth controller ubt0hci for a bluetooth de-
	   vice with the address 00:26:bb:7a:58:95, set up ubt0 if necessary and
	   enter an interactive dialog to pair the new device.	Since in this
	   example a mouse is paired, bluetooth-config will interact with
	   bthidd(8), enabling it if necessary and then write an HID descriptor
	   to its config.

     bluetooth-config scan

	   This will scan all bluetooth controllers on the systems for bluetooth
	   devices, prompting to bring up controllers or daemons along the way.

SEE ALSO
     bthost(1),  bthidcontrol(8),  bthidd(8),  hccontrol(8),  hcsecd(8), sdpcon-
     trol(8), sysrc(8)

HISTORY
     A bluetooth-config utility first appeared in FreeBSD 12.1.

AUTHORS
     Dirk Engling <erdgeist@erdgeist.org>

CAVEATS
     bluetooth-config can not parse entries in hcsecd(8) config  file  and  thus
     will ask the user to manually modify existing pairing PIN entries.

THANKS TO
     Lars Engels and Warren Block for suggestions, help, and testing.

FreeBSD ports 15.1		 January 7, 2019	     BLUETOOTH-CONFIG(8)

Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=bluetooth-config&manpath=FreeBSD+15.1-RELEASE+and+Ports>

home | help