| BlueZ - Bluetooth protocol stack for Linux | |
| ****************************************** | |
| Copyright (C) 2000-2001 Qualcomm Incorporated | |
| Copyright (C) 2002-2003 Maxim Krasnyansky <maxk@qualcomm.com> | |
| Copyright (C) 2002-2010 Marcel Holtmann <marcel@holtmann.org> | |
| Compilation and installation | |
| ============================ | |
| In order to compile Bluetooth utilities you need following software packages: | |
| - GCC compiler | |
| - GLib library | |
| - D-Bus library | |
| - udev library (optional) | |
| - readline (command line clients) | |
| To configure run: | |
| ./configure --prefix=/usr --mandir=/usr/share/man \ | |
| --sysconfdir=/etc --localstatedir=/var | |
| Configure automatically searches for all required components and packages. | |
| To compile and install run: | |
| make && make install | |
| Configuration and options | |
| ========================= | |
| For a working system, certain configuration options need to be enabled: | |
| --enable-library | |
| Enable installation of Bluetooth library | |
| By default the Bluetooth library is no longer installed. | |
| The user interfaces or command line utilities do not | |
| require an installed Bluetooth library anymore. This | |
| option is provided for legacy third party applications | |
| that still depend on the library. | |
| When the library installation is enabled, it is a good | |
| idea to use a separate bluez-library or libbluetooth | |
| package for it. | |
| --disable-tools | |
| Disable support for Bluetooth utilities | |
| By default the Bluetooth utilities are built and also | |
| installed. For production systems the tools are not | |
| needed and this option allows to disable them to save | |
| build time and disk space. | |
| When the tools are selected, it is a good idea to | |
| use a separate bluez-tools package for them. | |
| --disable-cups | |
| Disable support for CUPS printer backend | |
| By default the printer backend for CUPS is build and | |
| also installed. For systems that do not require printing | |
| over Bluetooth, this options allows to disable it. | |
| When the CUPS backend is selected, it is a good idea to | |
| use a separate bluez-cups package for it. | |
| --disable-monitor | |
| Disable support for the Bluetooth monitor utility | |
| By default the monitor utility is enabled. It provides | |
| support for HCI level tracing and debugging. For systems | |
| that don't require any kind of tracing or debugging | |
| capabilities, this options allows to disable it. | |
| The monitor utility should be placed in the main package | |
| along with the daemons. It is universally useful. | |
| --disable-client | |
| Disable support for the command line client | |
| By default the command line client is enabled and uses the | |
| readline library. For specific systems where BlueZ is | |
| configured by other means, the command line client can be | |
| disabled and the dependency on readline is removed. | |
| The client should be placed in the main package along | |
| with the daemons. It is universally useful. | |
| --disable-systemd | |
| Disable integration with systemd | |
| By default the integration with systemd is enabled and | |
| installed. This gives the best integration into all | |
| distributions based on systemd. | |
| This option is provided for distributions that do not | |
| support systemd. In that case all integration with the | |
| init system is up to the package. | |
| --disable-a2dp | |
| Disable A2DP profile | |
| By default bluetoothd supports A2DP profile using a built-in | |
| plugin, this option disables it. | |
| This option is provided for distributions that do not have any | |
| audio capabilities. | |
| --disable-avrcp | |
| Disable AVRCP profile | |
| By default bluetoothd supports AVRCP profile using a built-in | |
| plugin, this option disables it. | |
| This option is provided for distributions that do not have any | |
| audio capabilities. | |
| --disable-network | |
| Disable PANU, NAP, GN profiles | |
| By default bluetoothd supports PANU, NAP and GN profile using a | |
| built-in plugin, this option disables it. | |
| This option is provided for distributions that do not have any | |
| network capabilities. | |
| --disable-hid | |
| Disable HID profile | |
| By default bluetoothd supports HID profile using a built-in | |
| plugin, this option disables it. | |
| This option is provided for distributions that do not have any | |
| input capabilities. | |
| --disable-hog | |
| Disable HoG profile | |
| By default bluetoothd supports HoG profile using a built-in | |
| plugin, this option disables it. | |
| This option is provided for distributions that do not have any | |
| input capabilities. | |
| --enable-testing | |
| Enable testing tools | |
| By default tools used only for testing emulation are disabled. | |
| This option can be used to enable them. | |
| It is not recommended to enable this option for production | |
| systems. These tools may contain tests that depend on specific | |
| environment or kernel features in development. | |
| --enable-experimental | |
| Enable experimental tools | |
| By default all tools that are still in development | |
| are disabled. This option can be used to enable them. | |
| It is not recommended to enable this option for production | |
| systems. The behavior of the experimental tools is unstable | |
| and might still change. | |
| --enable-deprecated | |
| Enable deprecated tools | |
| By defauld all tools that are no longer maintained are | |
| disabled. This option can be used to enable them. | |
| It is not recommended to enable this option for production | |
| systems. The behavior of the deprecated tools may be unstable | |
| or simply don't work anymore. | |
| --enable-nfc | |
| This option enable NFC pairing support. | |
| By default the integration with neard is disabled, this gives | |
| the option to enable it in system where neard is supported. | |
| The plugin is built into bluetoothd therefore it does not need | |
| to be package separately. | |
| --enable-sap | |
| This option enable SAP profile using sap plugin. | |
| By default sap plugin is disabled since it requires tight | |
| integration with systems and is very rarely required. | |
| The plugin is built into bluetoothd therefore it does not need | |
| to be package separately. | |
| --enable-health | |
| This option enable health profiles. | |
| By default health plugin is disabled since its profiles are | |
| target for the health industry. | |
| The plugin is built into bluetoothd therefore it does not need | |
| to be package separately. | |
| --enable-midi | |
| This option enable MIDI support via ALSA Sequencer. | |
| By default midi plugin is disabled since it still considered | |
| experimental. When bluetoothd will create a new ALSA Sequencer | |
| client and port for each device connected that supports the | |
| MIDI GATT primary service. | |
| The plugin is built into bluetoothd therefore it does not need | |
| to be package separately. | |
| Information | |
| =========== | |
| Mailing lists: | |
| linux-bluetooth@vger.kernel.org | |
| For additional information about the project visit BlueZ web site: | |
| http://www.bluez.org |