NAME

sdpquery — Service Discovery Protocol query utility

SYNOPSIS

sdpquery

[-NRX] [-d device] -a address command [parameters ...]

sdpquery

[-NRX] [-c path] -l command [parameters ...]

DESCRIPTION

The sdpquery utility attempts to query the specified Service Discovery Protocol (SDP) server. Remote SDP servers are identified by their address. Connection to the local SDP server is made via the control socket. The sdpquery utility retrieves complete Service Records as directed and prints each record's attribute ID/value list to standard output and error messages to standard error.

The options are as follows:

-a address

Connect to the remote device with the specified address. The address can be specified as BD_ADDR or a name. If a name was specified, the sdpquery utility attempts to resolve the name via bt_gethostbyname(3). If no remote address is given, sdpquery attempts to contact a local SDP server via the control socket.

-c path

Specify path to the control socket. The default path is /var/run/sdp.

-d device

Connect from the local device with the specified address. The device can be specified by BD_ADDR or device name. See btconfig(8) for a list of devices available. If no device is specified, the sdpquery utility will use the best available.

-l

Query the local SDP server via the control socket.

-N

Additionally display numerical values.

-R

Display service attributes in raw (uninterpreted) format.

-X

Display service attribute values in hex.

The currently supported commands in sdpquery are:

Browse [group]

Browse for services. The group parameter is the UUID of the group to browse. If omitted, the "Public Browse Group" is used.

Record handle [handle...]

Retrieve the Service Record with the given handle. Multiple handles can be given.

Search uuid [uuid...]

Search for records matching the list of UUIDs which can be given in numerical form, or the following aliases are known:

A2DP

Advanced Audio Distribution Profile

BNEP

Bluetooth Network Encapsulation Protocol

CIP

Common ISDN Access Service

CTP

Cordless Telephony Service

DUN

Dialup Networking Service

FAX

Fax Service

FTRN

File Transfer Service

GN

Group ad-hoc Network Service

HID

Human Interface Device Service

HF

Handsfree Service

HSET

Headset Service

L2CAP

Logical Link Control and Adaptation Protocol

LAN

LAN Access Using PPP Service

NAP

Network Access Point Service

OBEX

Object Exchange Protocol

OPUSH

Object Push Service

PANU

Personal Area Networking User Service

PNP

Plug'n'Play Information Service

RFCOMM

RFCOMM Protocol

SDP

Service Discovery Protocol

SP

Serial Port Service

SYNC

IrMC Sync Client Service

Note that in order for a record to match, it must contain all the UUIDs in the ServiceSearchPattern and the maximum number is 12.

EXIT STATUS

The sdpquery utility exits 0 on success, and >0 if an error occurs.

SEE ALSO

bluetooth(3), sdp(3), btconfig(8), sdpd(8)

HISTORY

The sdpquery command first appeared in FreeBSD 5.3 as sdpcontrol. It was ported to NetBSD 4.0 under its present name by Iain Hibbert under the sponsorship of Itronix, Inc.

AUTHORS

Maksim Yevmenkin <m_evmenkin@yahoo.com> Iain Hibbert for Itronix, Inc.