xref: /freebsd/usr.sbin/bluetooth/sdpcontrol/sdpcontrol.8 (revision a4b187fa33f1856b9c0293b900d36b4c797b459d)
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 spdcontrol
33.Nd SDP query utility
34.Sh SYNOPSIS
35.Nm
36.Fl h
37.Nm
38.Fl a Ar BD_ADDR
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 specified Service Discovery Protocol (SDP) server.
50Remote SDP servers are identified by their BD_ADDRs.
51Connection to the local SDP server is made via control socket.
52The
53.Nm
54utility will use Service Search Attribute Request and will print results to
55the standard output and error messages to the standard error.
56.Pp
57The options are as follows:
58.Bl -tag -width indent
59.It Fl a Ar BD_ADDR
60Connect to the remote device with the specified BD_ADDR.
61Example:
62.Fl a Li 00:01:02:03:04:05 .
63.It Fl c Ar path
64Specify path to the control socket.
65The default path is
66.Pa /var/run/sdp .
67.It Fl h
68Display usage message and exit.
69.It Fl l
70Query the local SDP server via the control socket.
71.It Ar command
72One of the supported commands (see below).
73Special command
74.Cm help
75can be used to obtain the list of all supported commands.
76To get more information about specific command use
77.Cm help Ar command .
78.It Ar parameters
79One or more optional space separated command parameters.
80.El
81.Sh COMMANDS
82The currently supported node commands in
83.Nm
84are:
85.Pp
86.Bl -tag -offset indent -compact
87.It Cm Browse
88.It Cm Search
89.El
90.Sh CAVEAT
91The
92.Nm
93utility only implements client side functionality.
94.Pp
95The
96.Nm
97utility only requests the following attributes from the SDP server:
98.Bl -enum -offset indent -compact
99.It
100Service Record Handle
101.It
102Service Class ID List
103.It
104Protocol Descriptor List
105.It
106Bluetooth Profile Descriptor List
107.El
108.Sh DIAGNOSTICS
109.Ex -std
110.Sh SEE ALSO
111.Xr sdp 3
112.Sh AUTHORS
113.An Maksim Yevmenkin Aq m_evmenkin@yahoo.com
114