summaryrefslogtreecommitdiff
path: root/lib/libbluetooth/bluetooth.3
diff options
context:
space:
mode:
authorplunky <plunky@NetBSD.org>2009-08-03 15:59:41 +0000
committerplunky <plunky@NetBSD.org>2009-08-03 15:59:41 +0000
commitbd42c2e8d0fecd0bc87d1a20447b52bbadff1857 (patch)
tree98f578da88f8b4c407261abd7979e947c587d4ea /lib/libbluetooth/bluetooth.3
parentd90603b57337200e55203a4a5d9f823639a226aa (diff)
Add bt_dev(3), an platform neutral API for accessing (locally configured)
Bluetooth devices, and bump libbluetooth minor version. This is a reimplementation of an API largely developed by Maksim Yevmenkin on FreeBSD to make it easier to port BlueZ/Linux programs which depend on something similar. Alas, the BlueZ/Linux API is incompatible and unportable as it depends on a 'device' being referenced by an int, but this will hopefully make it easier to port software using that. (bump libbluetooth minor version)
Diffstat (limited to 'lib/libbluetooth/bluetooth.3')
-rw-r--r--lib/libbluetooth/bluetooth.325
1 files changed, 3 insertions, 22 deletions
diff --git a/lib/libbluetooth/bluetooth.3 b/lib/libbluetooth/bluetooth.3
index 71b5514ea5d..8bd67110d71 100644
--- a/lib/libbluetooth/bluetooth.3
+++ b/lib/libbluetooth/bluetooth.3
@@ -1,4 +1,4 @@
-.\" $NetBSD: bluetooth.3,v 1.3 2006/07/30 00:15:54 wiz Exp $
+.\" $NetBSD: bluetooth.3,v 1.4 2009/08/03 15:59:42 plunky Exp $
.\"
.\" Copyright (c) 2003 Maksim Yevmenkin <m_evmenkin@yahoo.com>
.\" All rights reserved.
@@ -24,10 +24,9 @@
.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
.\" SUCH DAMAGE.
.\"
-.\" $Id: bluetooth.3,v 1.3 2006/07/30 00:15:54 wiz Exp $
.\" $FreeBSD: src/lib/libbluetooth/bluetooth.3,v 1.7 2005/01/21 10:26:11 ru Exp $
.\"
-.Dd July 26, 2006
+.Dd August 3, 2009
.Dt BLUETOOTH 3
.Os
.Sh NAME
@@ -43,9 +42,7 @@
.Nm bt_endprotoent ,
.Nm bt_aton ,
.Nm bt_ntoa ,
-.Nm bt_devaddr ,
-.Nm bt_devname ,
-.Nd Bluetooth routines
+.Nd Bluetooth host lookup routines
.Sh LIBRARY
.Lb libbluetooth
.Sh SYNOPSIS
@@ -74,10 +71,6 @@
.Fn bt_aton "const char *str" "bdaddr_t *ba"
.Ft const char *
.Fn bt_ntoa "const bdaddr_t *ba" "char *str"
-.Ft int
-.Fn bt_devaddr "const char *name" "bdaddr_t *addr"
-.Ft int
-.Fn bt_devname "char *name" "const bdaddr_t *addr"
.Sh DESCRIPTION
The
.Fn bt_gethostent ,
@@ -194,18 +187,6 @@ takes a Bluetooth address and places an
string representing the address into the buffer provided.
It is up to the caller to ensure that provided buffer has enough space.
If no buffer was provided then an internal static buffer will be used.
-.Pp
-The
-.Fn bt_devaddr
-function interprets the specified character string as the
-address or device name of a Bluetooth device on the local system, and
-places the device address in the structure provided, if any.
-It returns 1 if the string was successfully interpreted,
-or 0 if the string did not match any local device. The
-.Fn bt_devname
-function takes a Bluetooth device address and copies the local device
-name associated with that address into the buffer provided, if any.
-It returns 1 when the device was found, otherwise 0.
.Sh FILES
.Bl -tag -width ".Pa /etc/bluetooth/hosts" -compact
.It Pa /etc/bluetooth/hosts