Introduction to BlueZ

The BlueZ package contains the Bluetooth protocol stack for Linux.

This package is known to build using an LFS 7.5 platform but has not been tested.

Package Information

Additional Downloads

BlueZ Dependencies


D-Bus-1.8.0, GLib-2.40.0, and libical-1.0

User Notes:

Kernel Configuration

Enable the following options in the kernel configuration and recompile the kernel if necessary:

[*] Networking support --->
  <*> or <M> Bluetooth subsystem support --->
    <*> or <M> RFCOMM protocol support
    [*] RFCOMM TTY support
    <*> or <M> BNEP protocol support
    [*] Multicast filter support
    [*] Protocol filter support
    <*> or <M> HIDP protocol support

    Bluetooth device drivers --->

Select the appropriate drivers for your Bluetooth hardware.

Installation of BlueZ

If you are going to use BlueZ with gnome-bluetooth and/or kde bluedevil, apply the following patch:

patch -Np1 -i ../bluez-5.18-obexd_without_systemd-1.patch

Install BlueZ by running the following commands:

./configure --prefix=/usr         \
            --sysconfdir=/etc     \
            --localstatedir=/var  \
            --enable-library      \
            --disable-systemd     &&

This package does not come with a test suite.

Now, as the root user:

make install

Install the main configuration file as the root user:

install -v -dm755 /etc/bluetooth &&
install -v -m644 src/main.conf /etc/bluetooth/main.conf

If desired, install the API documentation as the root user:

install -v -dm755 /usr/share/doc/bluez-5.18 &&
install -v -m644 doc/*.txt /usr/share/doc/bluez-5.18

Command Explanations

--enable-library: This switch enables building of the BlueZ 4 compatibility library which is required by some applications.

--disable-systemd: This switch is needed because systemd is not part of LFS/BLFS. If you are using systemd, remove this switch.

Configuring BlueZ

Config Files


Boot Script

To automatically start the bluetoothd daemon when the system is rebooted, install the /etc/rc.d/init.d/bluetooth bootscript from the blfs-bootscripts-20140329 package.

make install-bluetooth


Installed Programs: bccmd, bluemoon, bluetoothctl, bluetoothd, btmon, ciptool, hciattach, hciconfig, hcidump, hcitool, hid2hci, l2ping, l2test, obexd, rctest, rfcomm, and sdptool
Installed Library:
Installed Directories: /etc/bluetooth, /usr/include/bluetooth, /usr/libexec/bluetooth, and /usr/share/doc/bluez-5.18

Short Descriptions


is used to issue BlueCore commands to Cambridge Silicon Radio devices.


is the Bluetooth daemon.


is used to set up, maintain, and inspect the CIP configuration of the Bluetooth subsystem in the Linux kernel.


is used to attach a serial UART to the Bluetooth stack as HCI transport interface.


is used to configure Bluetooth devices.


is used to configure Bluetooth connections and send some special command to Bluetooth devices.


is used to set up switch supported Bluetooth devices into the HCI mode and back.


is used to send a L2CAP echo request to the Bluetooth MAC address given in dotted hex notation.


is used to test RFCOMM communications on the Bluetooth stack.


is used to set up, maintain, and inspect the RFCOMM configuration of the Bluetooth subsystem in the Linux kernel.


is used to perform SDP queries on Bluetooth devices.

contains the BlueZ 4 API functions.

Last updated on 2014-04-13 20:51:20 +0000