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