xref: /freebsd/usr.sbin/bluetooth/sdpcontrol/sdpcontrol.8 (revision 6b3455a7665208c366849f0b2b3bc916fb97516e)
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.Pp
99.Bl -enum -offset indent -compact
100.It
101Service Record Handle
102.It
103Service Class ID List
104.It
105Protocol Descriptor List
106.It
107Bluetooth Profile Descriptor List
108.El
109.Sh DIAGNOSTICS
110.Ex -std
111.Sh SEE ALSO
112.Xr sdp 3
113.Sh AUTHORS
114.An Maksim Yevmenkin Aq m_evmenkin@yahoo.com
115