Go to file
2016-08-15 09:07:44 +02:00
android shared/btsnoop: Add support for providing cumulative drops count 2016-05-04 10:37:01 +03: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: Don't attach stdin in connect_handler() 2016-07-24 16:18:37 +03:00
doc doc/gatt-api: Mention available examples 2016-08-02 13:57:04 +03:00
emulator lib: Define HCI_PRIMARY and use it instead of HCI_BREDR 2016-07-04 19:21:44 +02:00
gdbus gdbus: Fix the ordering of signals 2016-05-04 17:50:28 +03:00
gobex gobex: Minor coding style (whitespace) fix 2015-07-08 12:38:01 +03:00
lib lib: Add identifier for Qualcomm SMD bus 2016-08-15 09:07:24 +02:00
monitor monitor/l2cap: Fix buffer overflow when printing UUIDs 2016-08-12 22:48:10 +03:00
obexd Fix obex protocol for powerpc 2016-07-29 13:58:00 +03:00
peripheral shared/att: Add ext_signed flag to be able to use external crypto 2015-05-19 16:42:43 +02:00
plugins plugins/policy: Disable other connect policies while reconnect is active 2016-07-29 14:12:49 +03:00
profiles audio/player: Fix properties being marked as experimental 2016-08-05 14:13:26 +03:00
src shared: Add identifier for Qualcomm SMD bus 2016-08-15 09:07:44 +02:00
test test/example-gatt-server: Add more comments 2016-08-02 14:30:34 +03:00
tools lib: Define HCI_PRIMARY and use it instead of HCI_BREDR 2016-07-04 19:21:44 +02:00
unit unit: Add test case for h6 link key conversation function 2016-06-06 18:41:54 +02:00
.gitignore tools: Add testing utility for Eddystone beacons 2015-07-23 00:17:50 +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: Update Szymon, Łukasz and Andrzej emails 2015-11-18 20:06:19 +01:00
bootstrap Add --automake option 2006-08-18 19:41:53 +00:00
bootstrap-configure core: Add support for basic stack backtrace helper 2015-11-08 14:44:24 +01:00
ChangeLog Release 5.41 2016-07-17 23:09:07 +02:00
configure.ac Release 5.41 2016-07-17 23:09:07 +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: Fix nit in instructions 2016-04-22 15:05:03 +03:00
INSTALL Big cleanup of CVS relics 2005-10-29 19:25:42 +00:00
Makefile.am build: Update library version 2016-07-17 22:56:55 +02:00
Makefile.obexd build: Remove unneeded includes from obexd binaries 2015-03-01 00:48:41 -08:00
Makefile.plugins build: Make old GATT plugins deprecated 2016-04-01 14:57:37 +03:00
Makefile.tools monitor: Introduce support for extended TTY header 2016-05-04 10:35:22 +03:00
NEWS Initial revision 2002-03-08 21:10:06 +00:00
README build: Remove all checks for USB library support 2013-08-28 14:15:22 -07: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.

	--enable-experimental

		Enable experimental plugins

		By default all plugins 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 APIs or behavior of the experimental plugins
		is unstable and might still change.


Information
===========

Mailing lists:
	linux-bluetooth@vger.kernel.org

For additional information about the project visit BlueZ web site:
	http://www.bluez.org