Go to file
Arman Uguray a46ef6105d doc/gatt-api.txt: New ObjectManager requirements
After some discussion it was decided to require an ObjectManager
interface implementation on a per-service basis to reduce the
overhead of heaving to process and cache potentially many non-GATT
related objects. This patch updates the documentation to reflect this.
2015-02-27 14:41:05 +02:00
android android/bluetooth: Fix not marking device as bonded 2015-02-27 09:49:18 +01:00
attrib attrib: Add explicit include for lib/bluetooth.h 2015-02-18 06:23:56 +01:00
btio btio: List all enum values in switch 2014-12-08 14:00:28 +01:00
client client/display: Fix compilation warning on Android 2015-02-13 21:58:44 +02:00
doc doc/gatt-api.txt: New ObjectManager requirements 2015-02-27 14:41:05 +02:00
emulator emulator/bthost: Fix calling RFCOMM callback for zero-length data 2015-02-27 13:22:46 +02:00
gdbus gdbus/client: Allow specifying ObjectManager path 2015-02-27 14:40:43 +02:00
gobex gobex: List all enum values in switch 2014-12-08 14:00:28 +01:00
lib mgmt: Update code to match updated New CSRK specification 2015-02-27 10:20:33 +02:00
monitor mgmt: Update code to match updated New CSRK specification 2015-02-27 10:20:33 +02:00
obexd obexd: Add explicit include for lib/bluetooth.h 2015-02-18 06:24:23 +01:00
plugins plugins: Add explicit include for lib/bluetooth.h 2015-02-18 06:23:45 +01:00
profiles audio/avdtp: Fix session list handling 2015-02-23 16:17:32 +02:00
src shared/att: Emulate security level 2015-02-27 12:50:46 +02:00
test test/pbap-client: Add support to fetch spd,fav PB 2015-02-05 12:31:01 +02:00
tools tools/rfcomm-tester: Shorted unnecessarily long variable names 2015-02-27 12:59:52 +02:00
unit unit/test-gatt: Add /TP/GAW/CL/BV-02-C/seclevel test 2015-02-27 12:50:45 +02:00
.gitignore tools: Add testing utility for OOB pairing via mgmt API 2015-01-30 23:18:50 -08:00
.mailmap mailmap: Add Martin due to one commit with incomplete name 2013-07-20 23:33:02 +03:00
acinclude.m4 build: Enable -Wformat -Wformat-security in maintainer mode 2015-01-02 17:59:46 +01:00
AUTHORS AUTHORS: Mention Alex's contributions 2014-11-07 21:53:15 +01:00
bootstrap Add --automake option 2006-08-18 19:41:53 +00:00
bootstrap-configure build: Add configure option for generating manual pages 2014-07-12 23:44:22 +02:00
ChangeLog Release 5.28 2015-02-02 09:32:49 +01:00
configure.ac Release 5.28 2015-02-02 09:32:49 +01: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 build: Add initial HACKING 2014-09-05 10:31:52 +03:00
INSTALL Big cleanup of CVS relics 2005-10-29 19:25:42 +00:00
Makefile.am core: Introduce btd_gatt_database 2015-02-17 13:46:17 +02:00
Makefile.obexd build-sys: Add missing $(AM_CFLAGS) to obexd_src_obexd_CFLAGS 2013-10-04 14:16:35 +03:00
Makefile.plugins profiles/gatt: Rename profile to gap 2014-12-19 18:49:25 -02:00
Makefile.tools tools/btmgmt: Add initial readline support 2015-02-11 21:04:18 +02: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 items. 2015-02-18 15:03:05 +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