xref: /freebsd/usr.sbin/bluetooth/sdpcontrol/sdpcontrol.8 (revision e1656a881067832534dab2f7a04ad7bdd2439cc6)
10986ab12SMaksim Yevmenkin.\" Copyright (c) 2003 Maksim Yevmenkin <m_evmenkin@yahoo.com>
20986ab12SMaksim Yevmenkin.\" All rights reserved.
30986ab12SMaksim Yevmenkin.\"
40986ab12SMaksim Yevmenkin.\" Redistribution and use in source and binary forms, with or without
50986ab12SMaksim Yevmenkin.\" modification, are permitted provided that the following conditions
60986ab12SMaksim Yevmenkin.\" are met:
70986ab12SMaksim Yevmenkin.\" 1. Redistributions of source code must retain the above copyright
80986ab12SMaksim Yevmenkin.\"    notice, this list of conditions and the following disclaimer.
90986ab12SMaksim Yevmenkin.\" 2. Redistributions in binary form must reproduce the above copyright
100986ab12SMaksim Yevmenkin.\"    notice, this list of conditions and the following disclaimer in the
110986ab12SMaksim Yevmenkin.\"    documentation and/or other materials provided with the distribution.
120986ab12SMaksim Yevmenkin.\"
130986ab12SMaksim Yevmenkin.\" THIS SOFTWARE IS PROVIDED BY THE AUTHOR AND CONTRIBUTORS ``AS IS'' AND
140986ab12SMaksim Yevmenkin.\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
150986ab12SMaksim Yevmenkin.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
160986ab12SMaksim Yevmenkin.\" ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHOR OR CONTRIBUTORS BE LIABLE
170986ab12SMaksim Yevmenkin.\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
180986ab12SMaksim Yevmenkin.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
190986ab12SMaksim Yevmenkin.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
200986ab12SMaksim Yevmenkin.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
210986ab12SMaksim Yevmenkin.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
220986ab12SMaksim Yevmenkin.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
230986ab12SMaksim Yevmenkin.\" SUCH DAMAGE.
240986ab12SMaksim Yevmenkin.\"
250986ab12SMaksim Yevmenkin.\" $Id: sdpcontrol.8,v 1.1 2003/09/08 02:27:27 max Exp $
260986ab12SMaksim Yevmenkin.\" $FreeBSD$
270986ab12SMaksim Yevmenkin.\"
280986ab12SMaksim Yevmenkin.Dd September 7, 2003
290986ab12SMaksim Yevmenkin.Dt SDPCONTROL 8
300986ab12SMaksim Yevmenkin.Os
310986ab12SMaksim Yevmenkin.Sh NAME
3249490a17SMarkus Brueffer.Nm sdpcontrol
33a4b187faSMaksim Yevmenkin.Nd SDP query utility
340986ab12SMaksim Yevmenkin.Sh SYNOPSIS
350986ab12SMaksim Yevmenkin.Nm
36a4b187faSMaksim Yevmenkin.Fl h
37a4b187faSMaksim Yevmenkin.Nm
382aa65cf7SMaksim Yevmenkin.Fl a Ar address
390986ab12SMaksim Yevmenkin.Ar command
400986ab12SMaksim Yevmenkin.Op Ar parameters ...
41a4b187faSMaksim Yevmenkin.Nm
42a4b187faSMaksim Yevmenkin.Fl l
43a4b187faSMaksim Yevmenkin.Op Fl c Ar path
44a4b187faSMaksim Yevmenkin.Ar command
45a4b187faSMaksim Yevmenkin.Op Ar parameters ...
460986ab12SMaksim Yevmenkin.Sh DESCRIPTION
470986ab12SMaksim YevmenkinThe
480986ab12SMaksim Yevmenkin.Nm
4949490a17SMarkus Bruefferutility attempts to query the specified Service Discovery Protocol (SDP) server.
502aa65cf7SMaksim YevmenkinRemote SDP servers are identified by their address.
5149490a17SMarkus BruefferConnection to the local SDP server is made via the control socket.
520986ab12SMaksim YevmenkinThe
530986ab12SMaksim Yevmenkin.Nm
5449490a17SMarkus Bruefferutility uses Service Search Attribute Requests and prints results to
5549490a17SMarkus Bruefferstandard output and error messages to standard error.
560986ab12SMaksim Yevmenkin.Pp
570986ab12SMaksim YevmenkinThe options are as follows:
580986ab12SMaksim Yevmenkin.Bl -tag -width indent
592aa65cf7SMaksim Yevmenkin.It Fl a Ar address
602aa65cf7SMaksim YevmenkinConnect to the remote device with the specified address.
6149490a17SMarkus BruefferThe address can be specified as BD_ADDR or a name.
6249490a17SMarkus BruefferIf a name was specified, the
632aa65cf7SMaksim Yevmenkin.Nm
6449490a17SMarkus Bruefferutility attempts to resolve the name via
652aa65cf7SMaksim Yevmenkin.Xr bt_gethostbyname 3 .
66a4b187faSMaksim Yevmenkin.It Fl c Ar path
67a4b187faSMaksim YevmenkinSpecify path to the control socket.
68a4b187faSMaksim YevmenkinThe default path is
69a4b187faSMaksim Yevmenkin.Pa /var/run/sdp .
700986ab12SMaksim Yevmenkin.It Fl h
710986ab12SMaksim YevmenkinDisplay usage message and exit.
72a4b187faSMaksim Yevmenkin.It Fl l
73a4b187faSMaksim YevmenkinQuery the local SDP server via the control socket.
740986ab12SMaksim Yevmenkin.It Ar command
750986ab12SMaksim YevmenkinOne of the supported commands (see below).
7649490a17SMarkus BruefferThe special command
770986ab12SMaksim Yevmenkin.Cm help
7849490a17SMarkus Brueffercan be used to obtain a list of all supported commands.
7949490a17SMarkus BruefferTo get more information about a specific command, use
800986ab12SMaksim Yevmenkin.Cm help Ar command .
810986ab12SMaksim Yevmenkin.It Ar parameters
820986ab12SMaksim YevmenkinOne or more optional space separated command parameters.
830986ab12SMaksim Yevmenkin.El
840986ab12SMaksim Yevmenkin.Sh COMMANDS
850986ab12SMaksim YevmenkinThe currently supported node commands in
860986ab12SMaksim Yevmenkin.Nm
870986ab12SMaksim Yevmenkinare:
880986ab12SMaksim Yevmenkin.Pp
89*e1656a88SJoel Dahl.Bl -tag -width "Browse" -offset indent -compact
900986ab12SMaksim Yevmenkin.It Cm Browse
910986ab12SMaksim Yevmenkin.It Cm Search
920986ab12SMaksim Yevmenkin.El
930b31f1f7SUlrich Spörlein.Sh EXIT STATUS
940b31f1f7SUlrich Spörlein.Ex -std
950b31f1f7SUlrich Spörlein.Sh SEE ALSO
960b31f1f7SUlrich Spörlein.Xr bluetooth 3 ,
970b31f1f7SUlrich Spörlein.Xr sdp 3
980b31f1f7SUlrich Spörlein.Sh AUTHORS
990b31f1f7SUlrich Spörlein.An Maksim Yevmenkin Aq m_evmenkin@yahoo.com
10049490a17SMarkus Brueffer.Sh CAVEATS
101a4b187faSMaksim YevmenkinThe
1020986ab12SMaksim Yevmenkin.Nm
1030986ab12SMaksim Yevmenkinutility only implements client side functionality.
1040986ab12SMaksim Yevmenkin.Pp
1050986ab12SMaksim YevmenkinThe
1060986ab12SMaksim Yevmenkin.Nm
107a4b187faSMaksim Yevmenkinutility only requests the following attributes from the SDP server:
1089cdb6ee1SRuslan Ermilov.Pp
1090986ab12SMaksim Yevmenkin.Bl -enum -offset indent -compact
1100986ab12SMaksim Yevmenkin.It
1110986ab12SMaksim YevmenkinService Record Handle
1120986ab12SMaksim Yevmenkin.It
1130986ab12SMaksim YevmenkinService Class ID List
1140986ab12SMaksim Yevmenkin.It
1150986ab12SMaksim YevmenkinProtocol Descriptor List
1160986ab12SMaksim Yevmenkin.It
1170986ab12SMaksim YevmenkinBluetooth Profile Descriptor List
1180986ab12SMaksim Yevmenkin.El
119