Aren
/
NetBSD
1
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity

Serial comma. Bump date for previous. Sort sections. Make ready for HTML 

output.
This commit is contained in:
wiz 2006-07-30 00:15:54 +00:00
parent d8488cf5fd
commit 4076aeb801
1 changed files with 26 additions and 27 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

53
lib/libbluetooth/bluetooth.3
View File

@ -1,4 +1,4 @@
.\" $NetBSD: bluetooth.3,v 1.2 2006/07/26 11:11:04 tron Exp $
.\" $NetBSD: bluetooth.3,v 1.3 2006/07/30 00:15:54 wiz Exp $
.\"
.\" Copyright (c) 2003 Maksim Yevmenkin <m_evmenkin@yahoo.com>
.\" All rights reserved.
@ -24,10 +24,10 @@
.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
.\" SUCH DAMAGE.
.\"
.\" $Id: bluetooth.3,v 1.2 2006/07/26 11:11:04 tron Exp $
.\" $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 May 7, 2003
.Dd July 26, 2006
.Dt BLUETOOTH 3
.Os
.Sh NAME
@ -81,11 +81,10 @@
.Sh DESCRIPTION
The
.Fn bt_gethostent ,
.Fn bt_gethostbyname
.Fn bt_gethostbyname ,
and
.Fn bt_gethostbyaddr
functions
each return a pointer to an object with the
functions each return a pointer to an object with the
.Vt hostent
structure describing a Bluetooth host
referenced by name or by address, respectively.
@ -137,7 +136,7 @@ file.
.Pp
The
.Fn bt_getprotoent ,
.Fn bt_getprotobyname
.Fn bt_getprotobyname ,
and
.Fn bt_getprotobynumber
functions each return a pointer to an object with the
@ -156,7 +155,8 @@ The
.Fa proto
argument passed to
.Fn bt_getprotobynumber
should have numeric value of the desired Bluetooth Protocol Service Multiplexor.
should have numeric value of the desired Bluetooth Protocol Service
Multiplexor.
.Pp
The structure returned contains the information obtained from a line in
.Pa /etc/bluetooth/protocols
@ -206,7 +206,6 @@ or 0 if the string did not match any local device. The
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.
.Pp
.Sh FILES
.Bl -tag -width ".Pa /etc/bluetooth/hosts" -compact
.It Pa /etc/bluetooth/hosts
@ -219,19 +218,19 @@ const char *bdstr = "00:01:02:03:04:05";
bdaddr_t bd;
struct hostent *hp;
if (!bt_aton(bdstr, &bd))
if (!bt_aton(bdstr, \*[Am]bd))
errx(1, "can't parse BD_ADDR %s", bdstr);
if ((hp = bt_gethostbyaddr((const char *)&bd,
if ((hp = bt_gethostbyaddr((const char *)\*[Am]bd,
sizeof(bd), AF_BLUETOOTH)) == NULL)
errx(1, "no name associated with %s", bdstr);
printf("name associated with %s is %s\en", bdstr, hp->h_name);
printf("name associated with %s is %s\en", bdstr, hp-\*[Gt]h_name);
.Ed
.Sh DIAGNOSTICS
Error return status from
.Fn bt_gethostent ,
.Fn bt_gethostbyname
.Fn bt_gethostbyname ,
and
.Fn bt_gethostbyaddr
is indicated by return of a
@ -264,7 +263,7 @@ This is a non-recoverable error.
.Pp
The
.Fn bt_getprotoent ,
.Fn bt_getprotobyname
.Fn bt_getprotobyname ,
and
.Fn bt_getprotobynumber
return
@ -278,7 +277,19 @@ on EOF or error.
.Xr herror 3 ,
.Xr inet_aton 3 ,
.Xr inet_ntoa 3
.Sh CAVEAT
.Sh HISTORY
.Nm libbluetooth
first appeared in
.Fx
was ported to
.Nx 4.0
and extended by
.An Iain Hibbert
for Itronix, Inc.
.Sh AUTHORS
.An Maksim Yevmenkin Aq m_evmenkin@yahoo.com
.An Iain Hibbert
.Sh CAVEATS
The
.Fn bt_gethostent
function reads the next line of
@ -302,19 +313,7 @@ The
function opens and/or rewinds the
.Pa /etc/bluetooth/protocols
file.
.Sh AUTHORS
.An Maksim Yevmenkin Aq m_evmenkin@yahoo.com
.An Iain Hibbert
.Sh BUGS
These functions use static data storage;
if the data is needed for future use, it should be
copied before any subsequent calls overwrite it.
.Sh HISTORY
.Nm libbluetooth
first appeard in
.Fx
was ported to
.Nx 4.0
and extended by
.An Iain Hibbert
for Itronix, Inc.