xref: /freebsd/usr.sbin/bluetooth/sdpcontrol/sdpcontrol.8 (revision aa1a8ff2d6dbc51ef058f46f3db5a8bb77967145)
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.\"
27.Dd February 7, 2015
28.Dt SDPCONTROL 8
29.Os
30.Sh NAME
31.Nm sdpcontrol
32.Nd Bluetooth Service Discovery Protocol query utility
33.Sh SYNOPSIS
34.Nm
35.Fl h
36.Nm
37.Fl a Ar address
38.Ar command
39.Op Ar parameters ...
40.Nm
41.Fl l
42.Op Fl c Ar path
43.Ar command
44.Op Ar parameters ...
45.Sh DESCRIPTION
46The
47.Nm
48utility attempts to query the specified Service Discovery Protocol (SDP) server.
49Remote SDP servers are identified by their address.
50Connection to the local SDP server is made via the control socket.
51The
52.Nm
53utility uses Service Search Attribute Requests and prints results to
54standard output and error messages to standard error.
55.Pp
56The options are as follows:
57.Bl -tag -width indent
58.It Fl a Ar address
59Connect to the remote device with the specified address.
60The address can be specified as BD_ADDR or a name.
61If a name was specified, the
62.Nm
63utility attempts to resolve the name via
64.Xr bt_gethostbyname 3 .
65.It Fl c Ar path
66Specify path to the control socket.
67The default path is
68.Pa /var/run/sdp .
69.It Fl h
70Display usage message and exit.
71.It Fl l
72Query the local SDP server via the control socket.
73.It Ar command
74One of the supported commands (see below).
75The special command
76.Cm help
77can be used to obtain a list of all supported commands.
78To get more information about a specific command, use
79.Cm help Ar command .
80.It Ar parameters
81One or more optional space separated command parameters.
82.El
83.Sh COMMANDS
84The currently supported node commands in
85.Nm
86are:
87.Pp
88.Bl -tag -width "Browse" -offset indent -compact
89.It Cm Browse
90.It Cm Search
91.El
92.Sh EXIT STATUS
93.Ex -std
94.Sh SEE ALSO
95.Xr bluetooth 3 ,
96.Xr sdp 3
97.Sh AUTHORS
98.An Maksim Yevmenkin Aq Mt m_evmenkin@yahoo.com
99.Sh CAVEATS
100The
101.Nm
102utility only implements client side functionality.
103.Pp
104The
105.Nm
106utility only requests the following attributes from the SDP server:
107.Pp
108.Bl -enum -offset indent -compact
109.It
110Service Record Handle
111.It
112Service Class ID List
113.It
114Protocol Descriptor List
115.It
116Bluetooth Profile Descriptor List
117.El
118