xref: /freebsd/usr.sbin/bluetooth/sdpcontrol/sdpcontrol.8 (revision b077aed33b7b6aefca7b17ddb250cf521f938613)
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 February 7, 2015
29.Dt SDPCONTROL 8
30.Os
31.Sh NAME
32.Nm sdpcontrol
33.Nd Bluetooth Service Discovery Protocol 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 -width "Browse" -offset indent -compact
90.It Cm Browse
91.It Cm Search
92.El
93.Sh EXIT STATUS
94.Ex -std
95.Sh SEE ALSO
96.Xr bluetooth 3 ,
97.Xr sdp 3
98.Sh AUTHORS
99.An Maksim Yevmenkin Aq Mt m_evmenkin@yahoo.com
100.Sh CAVEATS
101The
102.Nm
103utility only implements client side functionality.
104.Pp
105The
106.Nm
107utility only requests the following attributes from the SDP server:
108.Pp
109.Bl -enum -offset indent -compact
110.It
111Service Record Handle
112.It
113Service Class ID List
114.It
115Protocol Descriptor List
116.It
117Bluetooth Profile Descriptor List
118.El
119