Go to file
Yunhan Wang 725d47ba57 build: use abspath for lib/bluetooth
When building from out of tree, and the top build dir was specified as
an absolute path, the linked headers in ${builddir}/lib/bluetooth were
broken.  This patch fixes it by relying on make's abspath macro as
opposed to the path concatenation.
2017-09-25 16:14:07 +03:00
android android: Add missing fall through declaration 2017-07-11 11:27:15 -07:00
attrib shared/att: Add ext_signed flag to be able to use external crypto 2015-05-19 16:42:43 +02:00
btio btio: Use local libbluetooth includes 2015-02-28 22:29:12 -08:00
client client: Use new parse_argument() instead of parse_argument_XX() 2017-09-25 15:44:02 +03:00
doc doc/gatt-api: Add server support for AcquireWrite and AcquireNotify 2017-09-22 13:50:17 +03:00
emulator emulator: Update emulated controller HCI version from 4.2 to 5.0 2017-05-09 17:27:51 +03:00
gdbus gdbus: Fix not always appending proxy to the list 2017-08-22 12:42:44 +03:00
gobex gobex: Make g_obex_apparam_encode NULL safe 2017-04-23 23:12:34 +03:00
lib mesh: Add BT SIG reserved numbers for Mesh 2017-08-21 12:40:35 +02:00
mesh gatt: Update signature of AcquireWrite and AcquireNotify 2017-09-22 13:50:17 +03:00
monitor monitor: Add support for decoding Intel buadrate command 2017-09-19 12:42:38 +02:00
obexd obexd: Add missing fall through declaration 2017-07-11 11:30:55 -07:00
peripheral shared/gatt-client: Allow multiple ready callbacks 2017-07-04 12:30:05 +03:00
plugins plugins/sixaxis: Use the same device name as the kernel 2017-08-08 13:30:17 +02:00
profiles a2dp: Remove unnecessary if statement 2017-09-14 12:34:08 +03:00
src gatt: Update signature of AcquireWrite and AcquireNotify 2017-09-22 13:50:17 +03:00
test test/example-advertisement: add LocalName to properties 2017-09-14 11:22:27 +03:00
tools tools: Only add unique entries to readline history 2017-09-20 15:28:44 +03:00
unit unit: Add missing break statement 2017-07-11 11:30:28 -07:00
.gitignore mesh: Add mesh to main bluez build 2017-08-21 12:54:11 +02:00
.mailmap Fix name in AUTHORS 2015-05-20 23:16:30 +03:00
acinclude.m4 build: Enable -Wformat -Wformat-security in maintainer mode 2015-01-02 17:59:46 +01:00
AUTHORS AUTHORS: mention Michał's contributions 2016-09-21 20:19:28 +02:00
bootstrap Add --automake option 2006-08-18 19:41:53 +00:00
bootstrap-configure mesh: Add mesh to main bluez build 2017-08-21 12:54:11 +02:00
ChangeLog Release 5.47 2017-09-14 11:43:32 +02:00
configure.ac Release 5.47 2017-09-14 11:43:32 +02:00
COPYING Remove new page characters 2008-08-14 22:56:25 +02:00
COPYING.LIB Remove new page characters 2008-08-14 22:56:25 +02:00
HACKING HACKING: Update instructions on how to run from source tree 2017-08-07 16:40:12 +03:00
INSTALL Big cleanup of CVS relics 2005-10-29 19:25:42 +00:00
Makefile.am build: use abspath for lib/bluetooth 2017-09-25 16:14:07 +03:00
Makefile.obexd build: Remove unneeded includes from obexd binaries 2015-03-01 00:48:41 -08:00
Makefile.plugins sap: Remove support for STE U8500 platform 2017-07-13 10:43:40 +02:00
Makefile.tools build: Don't install btconfig utility just yet 2017-09-14 11:32:43 +02:00
NEWS Initial revision 2002-03-08 21:10:06 +00:00
README build: Add testing config option 2017-01-17 11:27:26 +02:00
TODO TODO: Update GATT/ATT items 2016-03-14 16:42:59 +02:00

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