xref: /freebsd/usr.sbin/bluetooth/sdpcontrol/sdpcontrol.8 (revision 1e413cf93298b5b97441a21d9a50fdcd0ee9945e)
1.\" Copyright (c) 2003 Maksim Yevmenkin <m_evmenkin@yahoo.com>
2.\" All rights reserved.
3.\"
4.\" Redistribution and use in source and binary forms, with or without
5.\" modification, are permitted provided that the following conditions
6.\" are met:
7.\" 1. Redistributions of source code must retain the above copyright
8.\"    notice, this list of conditions and the following disclaimer.
9.\" 2. Redistributions in binary form must reproduce the above copyright
10.\"    notice, this list of conditions and the following disclaimer in the
11.\"    documentation and/or other materials provided with the distribution.
12.\"
13.\" THIS SOFTWARE IS PROVIDED BY THE AUTHOR AND CONTRIBUTORS ``AS IS'' AND
14.\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
15.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
16.\" ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHOR OR CONTRIBUTORS BE LIABLE
17.\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
18.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
19.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
20.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
21.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
22.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
23.\" SUCH DAMAGE.
24.\"
25.\" $Id: sdpcontrol.8,v 1.1 2003/09/08 02:27:27 max Exp $
26.\" $FreeBSD$
27.\"
28.Dd September 7, 2003
29.Dt SDPCONTROL 8
30.Os
31.Sh NAME
32.Nm sdpcontrol
33.Nd SDP query utility
34.Sh SYNOPSIS
35.Nm
36.Fl h
37.Nm
38.Fl a Ar address
39.Ar command
40.Op Ar parameters ...
41.Nm
42.Fl l
43.Op Fl c Ar path
44.Ar command
45.Op Ar parameters ...
46.Sh DESCRIPTION
47The
48.Nm
49utility attempts to query the specified Service Discovery Protocol (SDP) server.
50Remote SDP servers are identified by their address.
51Connection to the local SDP server is made via the control socket.
52The
53.Nm
54utility uses Service Search Attribute Requests and prints results to
55standard output and error messages to standard error.
56.Pp
57The options are as follows:
58.Bl -tag -width indent
59.It Fl a Ar address
60Connect to the remote device with the specified address.
61The address can be specified as BD_ADDR or a name.
62If a name was specified, the
63.Nm
64utility attempts to resolve the name via
65.Xr bt_gethostbyname 3 .
66.It Fl c Ar path
67Specify path to the control socket.
68The default path is
69.Pa /var/run/sdp .
70.It Fl h
71Display usage message and exit.
72.It Fl l
73Query the local SDP server via the control socket.
74.It Ar command
75One of the supported commands (see below).
76The special command
77.Cm help
78can be used to obtain a list of all supported commands.
79To get more information about a specific command, use
80.Cm help Ar command .
81.It Ar parameters
82One or more optional space separated command parameters.
83.El
84.Sh COMMANDS
85The currently supported node commands in
86.Nm
87are:
88.Pp
89.Bl -tag -offset indent -compact
90.It Cm Browse
91.It Cm Search
92.El
93.Sh CAVEATS
94The
95.Nm
96utility only implements client side functionality.
97.Pp
98The
99.Nm
100utility only requests the following attributes from the SDP server:
101.Pp
102.Bl -enum -offset indent -compact
103.It
104Service Record Handle
105.It
106Service Class ID List
107.It
108Protocol Descriptor List
109.It
110Bluetooth Profile Descriptor List
111.El
112.Sh EXIT STATUS
113.Ex -std
114.Sh SEE ALSO
115.Xr bluetooth 3 ,
116.Xr sdp 3
117.Sh AUTHORS
118.An Maksim Yevmenkin Aq m_evmenkin@yahoo.com
119