1.\" $NetBSD: sdpquery.1,v 1.8 2007/02/17 09:39:11 wiz Exp $ 2.\" 3.\" Copyright (c) 2006 Itronix Inc. 4.\" All rights reserved. 5.\" 6.\" Redistribution and use in source and binary forms, with or without 7.\" modification, are permitted provided that the following conditions 8.\" are met: 9.\" 1. Redistributions of source code must retain the above copyright 10.\" notice, this list of conditions and the following disclaimer. 11.\" 2. Redistributions in binary form must reproduce the above copyright 12.\" notice, this list of conditions and the following disclaimer in the 13.\" documentation and/or other materials provided with the distribution. 14.\" 3. The name of Itronix Inc. may not be used to endorse 15.\" or promote products derived from this software without specific 16.\" prior written permission. 17.\" 18.\" THIS SOFTWARE IS PROVIDED BY ITRONIX INC. ``AS IS'' AND 19.\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED 20.\" TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR 21.\" PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL ITRONIX INC. BE LIABLE FOR ANY 22.\" DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES 23.\" (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; 24.\" LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND 25.\" ON ANY THEORY OF LIABILITY, WHETHER IN 26.\" CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) 27.\" ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE 28.\" POSSIBILITY OF SUCH DAMAGE. 29.\" 30.\" Copyright (c) 2003 Maksim Yevmenkin <m_evmenkin@yahoo.com> 31.\" All rights reserved. 32.\" 33.\" Redistribution and use in source and binary forms, with or without 34.\" modification, are permitted provided that the following conditions 35.\" are met: 36.\" 1. Redistributions of source code must retain the above copyright 37.\" notice, this list of conditions and the following disclaimer. 38.\" 2. Redistributions in binary form must reproduce the above copyright 39.\" notice, this list of conditions and the following disclaimer in the 40.\" documentation and/or other materials provided with the distribution. 41.\" 42.\" THIS SOFTWARE IS PROVIDED BY THE AUTHOR AND CONTRIBUTORS ``AS IS'' AND 43.\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE 44.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE 45.\" ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHOR OR CONTRIBUTORS BE LIABLE 46.\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL 47.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS 48.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) 49.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT 50.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY 51.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF 52.\" SUCH DAMAGE. 53.\" 54.\" $Id: sdpquery.1,v 1.8 2007/02/17 09:39:11 wiz Exp $ 55.\" $FreeBSD: src/usr.sbin/bluetooth/sdpcontrol/sdpcontrol.8,v 1.6 2005/07/09 19:04:43 markus Exp $ 56.\" 57.Dd February 17, 2007 58.Dt SDPQUERY 1 59.Os 60.Sh NAME 61.Nm sdpquery 62.Nd SDP query utility 63.Sh SYNOPSIS 64.Nm 65.Fl h 66.Nm 67.Op Fl d Ar device 68.Fl a Ar address 69.Ar command 70.Op Ar parameters ... 71.Nm 72.Op Fl c Ar path 73.Fl l 74.Ar command 75.Op Ar parameters ... 76.Sh DESCRIPTION 77The 78.Nm 79utility attempts to query the specified Service Discovery Protocol 80(SDP) server. 81Remote SDP servers are identified by their address. 82Connection to the local SDP server is made via the control socket. 83The 84.Nm 85utility uses Service Search Attribute Requests and prints results to 86standard output and error messages to standard error. 87.Pp 88The options are as follows: 89.Bl -tag -width ".Fl a Ar address" 90.It Fl a Ar address 91Connect to the remote device with the specified address. 92The address can be specified as BD_ADDR or a name. 93If a name was specified, the 94.Nm 95utility attempts to resolve the name via 96.Xr bt_gethostbyname 3 . 97If no remote address is given, 98.Nm 99attempts to contact a local SDP server via the control socket. 100.It Fl c Ar path 101Specify path to the control socket. 102The default path is 103.Pa /var/run/sdp . 104.It Fl d Ar device 105Connect from the local device with the specifed address. 106The device can be specified by BD_ADDR or device name. 107See 108.Xr btconfig 8 109for a list of devices available. 110If no device is specified, the 111.Nm 112utility will use the best available. 113.It Fl l 114Query the local SDP server via the control socket. 115.It Fl h 116Display usage message and exit. 117.El 118.Pp 119The currently supported commands in 120.Nm 121are: 122.Pp 123.Bl -tag -width ".Cm search Ar service" -compact 124.It Cm Browse Op Ar group 125Browse for services. 126The 127.Ar group 128parameter is a 16-bit UUID of the group to browse. 129If omitted, the Public Browse Group. is used. 130.Pp 131.It Cm Search Ar service 132Search for the 133.Ar service . 134The 135.Ar service 136parameter is a 16-bit UUID of the service to search for. 137For the following services it is possible to use service name 138instead of service UUID: 139.Pp 140.Bl -tag -compact -width "OPUSH" 141.It CIP 142Common ISDN Access 143.It CTP 144Cordless Telephony 145.It DUN 146DialUp Networking 147.It FAX 148Fax 149.It FTRN 150OBEX File Transfer 151.It GN 152Group ad-hoc Network 153.It HID 154Human Interface Device 155.It HF 156Handsfree 157.It HSET 158Headset 159.It LAN 160LAN Access Using PPP 161.It NAP 162Network Access Point 163.It OPUSH 164OBEX Object Push 165.It PANU 166Personal Area Networking User 167.It SP 168Serial Port 169.El 170.El 171.Sh EXIT STATUS 172.Ex -std 173.Sh SEE ALSO 174.Xr bluetooth 3 , 175.Xr sdp 3 , 176.Xr btconfig 8 , 177.Xr sdpd 8 178.Sh HISTORY 179The 180.Nm 181command first appeared in 182.Fx 5.3 183as 184.Nm sdpcontrol . 185It was ported to 186.Nx 4.0 187under its present name by 188.An Iain Hibbert 189under the sponsorship of Itronix, Inc and imported into 190.Dx 1.11 . 191.Sh AUTHORS 192.An Maksim Yevmenkin Aq m_evmenkin@yahoo.com 193.An Iain Hibbert 194for Itronix, Inc. 195.Sh CAVEATS 196The 197.Nm 198utility only requests the following attributes from the SDP server: 199.Pp 200.Bl -enum -offset indent -compact 201.It 202Service Record Handle 203.It 204Service Class ID List 205.It 206Protocol Descriptor List 207.It 208Bluetooth Profile Descriptor List 209.El 210