xref: /netbsd/lib/libbluetooth/sdp.h (revision abd1934e)
1 /*	$NetBSD: sdp.h,v 1.3 2022/04/19 20:32:14 rillig Exp $	*/
2 
3 /*-
4  * Copyright (c) 2006 Itronix Inc.
5  * All rights reserved.
6  *
7  * Written by Iain Hibbert for Itronix Inc.
8  *
9  * Redistribution and use in source and binary forms, with or without
10  * modification, are permitted provided that the following conditions
11  * are met:
12  * 1. Redistributions of source code must retain the above copyright
13  *    notice, this list of conditions and the following disclaimer.
14  * 2. Redistributions in binary form must reproduce the above copyright
15  *    notice, this list of conditions and the following disclaimer in the
16  *    documentation and/or other materials provided with the distribution.
17  * 3. The name of Itronix Inc. may not be used to endorse
18  *    or promote products derived from this software without specific
19  *    prior written permission.
20  *
21  * THIS SOFTWARE IS PROVIDED BY ITRONIX INC. ``AS IS'' AND
22  * ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED
23  * TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
24  * PURPOSE ARE DISCLAIMED.  IN NO EVENT SHALL ITRONIX INC. BE LIABLE FOR ANY
25  * DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES
26  * (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES;
27  * LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND
28  * ON ANY THEORY OF LIABILITY, WHETHER IN
29  * CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
30  * ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
31  * POSSIBILITY OF SUCH DAMAGE.
32  */
33 /*
34  * Copyright (c) 2001-2003, 2008 Maksim Yevmenkin <m_evmenkin@yahoo.com>
35  * All rights reserved.
36  *
37  * Redistribution and use in source and binary forms, with or without
38  * modification, are permitted provided that the following conditions
39  * are met:
40  * 1. Redistributions of source code must retain the above copyright
41  *    notice, this list of conditions and the following disclaimer.
42  * 2. Redistributions in binary form must reproduce the above copyright
43  *    notice, this list of conditions and the following disclaimer in the
44  *    documentation and/or other materials provided with the distribution.
45  *
46  * THIS SOFTWARE IS PROVIDED BY THE AUTHOR AND CONTRIBUTORS ``AS IS'' AND
47  * ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
48  * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
49  * ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHOR OR CONTRIBUTORS BE LIABLE
50  * FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
51  * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
52  * OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
53  * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
54  * LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
55  * OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
56  * SUCH DAMAGE.
57  *
58  * $FreeBSD: src/lib/libsdp/sdp.h,v 1.5 2005/05/27 19:11:33 emax Exp $
59  */
60 
61 #ifndef _SDP_H_
62 #define _SDP_H_
63 
64 #include <stdbool.h>
65 #include <uuid.h>
66 
67 #include <bluetooth.h>
68 
69 /*
70  * SDP Data Element types
71  */
72 
73 #define SDP_DATA_TYPE(b)	((b) & 0xf8)
74 #define SDP_DATA_SIZE(b)	((b) & 0x07)
75 
76 /* data size descriptors */
77 #define SDP_DATA_8		0x00
78 #define SDP_DATA_16		0x01
79 #define SDP_DATA_32		0x02
80 #define SDP_DATA_64		0x03
81 #define SDP_DATA_128		0x04
82 #define SDP_DATA_EXT8		0x05
83 #define SDP_DATA_EXT16		0x06
84 #define SDP_DATA_EXT32		0x07
85 
86 /* data type descriptors */
87 #define SDP_DATA_NIL		0x00
88 #define SDP_DATA_UINT		0x08
89 #define SDP_DATA_INT		0x10
90 #define SDP_DATA_UUID		0x18
91 #define SDP_DATA_STR		0x20
92 #define SDP_DATA_BOOL		0x28
93 #define SDP_DATA_SEQ		0x30
94 #define SDP_DATA_ALT		0x38
95 #define SDP_DATA_URL		0x40
96 
97 /* Unsigned integer */
98 #define SDP_DATA_UINT8		(SDP_DATA_UINT | SDP_DATA_8)
99 #define SDP_DATA_UINT16		(SDP_DATA_UINT | SDP_DATA_16)
100 #define SDP_DATA_UINT32		(SDP_DATA_UINT | SDP_DATA_32)
101 #define SDP_DATA_UINT64		(SDP_DATA_UINT | SDP_DATA_64)
102 #define SDP_DATA_UINT128	(SDP_DATA_UINT | SDP_DATA_128)
103 
104 /* Signed two's-complement integer */
105 #define SDP_DATA_INT8		(SDP_DATA_INT | SDP_DATA_8)
106 #define SDP_DATA_INT16		(SDP_DATA_INT | SDP_DATA_16)
107 #define SDP_DATA_INT32		(SDP_DATA_INT | SDP_DATA_32)
108 #define SDP_DATA_INT64		(SDP_DATA_INT | SDP_DATA_64)
109 #define SDP_DATA_INT128		(SDP_DATA_INT | SDP_DATA_128)
110 
111 /* UUID, a universally unique identifier */
112 #define SDP_DATA_UUID16		(SDP_DATA_UUID | SDP_DATA_16)
113 #define SDP_DATA_UUID32		(SDP_DATA_UUID | SDP_DATA_32)
114 #define SDP_DATA_UUID128	(SDP_DATA_UUID | SDP_DATA_128)
115 
116 /* Text string */
117 #define SDP_DATA_STR8		(SDP_DATA_STR | SDP_DATA_EXT8)
118 #define SDP_DATA_STR16		(SDP_DATA_STR | SDP_DATA_EXT16)
119 #define SDP_DATA_STR32		(SDP_DATA_STR | SDP_DATA_EXT32)
120 
121 /* Data element sequence */
122 #define SDP_DATA_SEQ8		(SDP_DATA_SEQ | SDP_DATA_EXT8)
123 #define SDP_DATA_SEQ16		(SDP_DATA_SEQ | SDP_DATA_EXT16)
124 #define SDP_DATA_SEQ32		(SDP_DATA_SEQ | SDP_DATA_EXT32)
125 
126 /* Data element alternative */
127 #define SDP_DATA_ALT8		(SDP_DATA_ALT | SDP_DATA_EXT8)
128 #define SDP_DATA_ALT16		(SDP_DATA_ALT | SDP_DATA_EXT16)
129 #define SDP_DATA_ALT32		(SDP_DATA_ALT | SDP_DATA_EXT32)
130 
131 /* URL, a uniform resource locator */
132 #define SDP_DATA_URL8		(SDP_DATA_URL | SDP_DATA_EXT8)
133 #define SDP_DATA_URL16		(SDP_DATA_URL | SDP_DATA_EXT16)
134 #define SDP_DATA_URL32		(SDP_DATA_URL | SDP_DATA_EXT32)
135 
136 /*
137  * Protocol UUIDs (short alias version)
138  *
139  * BLUETOOTH BASE UUID 00000000-0000-1000-8000-00805F9B34FB
140  */
141 #define SDP_UUID_PROTOCOL_SDP				0x0001
142 #define SDP_UUID_PROTOCOL_UDP				0x0002
143 #define SDP_UUID_PROTOCOL_RFCOMM			0x0003
144 #define SDP_UUID_PROTOCOL_TCP				0x0004
145 #define SDP_UUID_PROTOCOL_TCS_BIN			0x0005
146 #define SDP_UUID_PROTOCOL_TCS_AT			0x0006
147 #define SDP_UUID_PROTOCOL_OBEX				0x0008
148 #define SDP_UUID_PROTOCOL_IP				0x0009
149 #define SDP_UUID_PROTOCOL_FTP				0x000A
150 #define SDP_UUID_PROTOCOL_HTTP				0x000C
151 #define SDP_UUID_PROTOCOL_WSP				0x000E
152 #define SDP_UUID_PROTOCOL_BNEP				0x000F
153 #define SDP_UUID_PROTOCOL_UPNP				0x0010
154 #define SDP_UUID_PROTOCOL_HIDP				0x0011
155 #define SDP_UUID_PROTOCOL_HARDCOPY_CONTROL_CHANNEL	0x0012
156 #define SDP_UUID_PROTOCOL_HARDCOPY_DATA_CHANNEL		0x0014
157 #define SDP_UUID_PROTOCOL_HARDCOPY_NOTIFICATION		0x0016
158 #define SDP_UUID_PROTOCOL_AVCTP				0x0017
159 #define SDP_UUID_PROTOCOL_AVDTP				0x0019
160 #define SDP_UUID_PROTOCOL_CMPT				0x001B
161 #define SDP_UUID_PROTOCOL_UDI_C_PLANE			0x001D
162 #define SDP_UUID_PROTOCOL_MCAP_CONTROL_CHANNEL		0x001E
163 #define SDP_UUID_PROTOCOL_MCAP_DATA_CHANNEL		0x001F
164 #define SDP_UUID_PROTOCOL_L2CAP				0x0100
165 
166 /*
167  * Service Class IDs
168  */
169 #define SDP_SERVICE_CLASS_SERVICE_DISCOVERY_SERVER	0x1000
170 #define SDP_SERVICE_CLASS_BROWSE_GROUP_DESCRIPTOR	0x1001
171 #define SDP_SERVICE_CLASS_PUBLIC_BROWSE_GROUP		0x1002
172 #define SDP_SERVICE_CLASS_SERIAL_PORT			0x1101
173 #define SDP_SERVICE_CLASS_LAN_ACCESS_USING_PPP		0x1102
174 #define SDP_SERVICE_CLASS_DIALUP_NETWORKING		0x1103
175 #define SDP_SERVICE_CLASS_IR_MC_SYNC			0x1104
176 #define SDP_SERVICE_CLASS_OBEX_OBJECT_PUSH		0x1105
177 #define SDP_SERVICE_CLASS_OBEX_FILE_TRANSFER		0x1106
178 #define SDP_SERVICE_CLASS_IR_MC_SYNC_COMMAND		0x1107
179 #define SDP_SERVICE_CLASS_HEADSET			0x1108
180 #define SDP_SERVICE_CLASS_CORDLESS_TELEPHONY		0x1109
181 #define SDP_SERVICE_CLASS_AUDIO_SOURCE			0x110A
182 #define SDP_SERVICE_CLASS_AUDIO_SINK			0x110B
183 #define SDP_SERVICE_CLASS_AV_REMOTE_CONTROL_TARGET	0x110C
184 #define SDP_SERVICE_CLASS_ADVANCED_AUDIO_DISTRIBUTION	0x110D
185 #define SDP_SERVICE_CLASS_AV_REMOTE_CONTROL		0x110E
186 #define SDP_SERVICE_CLASS_VIDEO_CONFERENCING		0x110F
187 #define SDP_SERVICE_CLASS_INTERCOM			0x1110
188 #define SDP_SERVICE_CLASS_FAX				0x1111
189 #define SDP_SERVICE_CLASS_HEADSET_AUDIO_GATEWAY		0x1112
190 #define SDP_SERVICE_CLASS_WAP				0x1113
191 #define SDP_SERVICE_CLASS_WAP_CLIENT			0x1114
192 #define SDP_SERVICE_CLASS_PANU				0x1115
193 #define SDP_SERVICE_CLASS_NAP				0x1116
194 #define SDP_SERVICE_CLASS_GN				0x1117
195 #define SDP_SERVICE_CLASS_DIRECT_PRINTING		0x1118
196 #define SDP_SERVICE_CLASS_REFERENCE_PRINTING		0x1119
197 #define SDP_SERVICE_CLASS_IMAGING			0x111A
198 #define SDP_SERVICE_CLASS_IMAGING_RESPONDER		0x111B
199 #define SDP_SERVICE_CLASS_IMAGING_AUTOMATIC_ARCHIVE	0x111C
200 #define SDP_SERVICE_CLASS_IMAGING_REFERENCED_OBJECTS	0x111D
201 #define SDP_SERVICE_CLASS_HANDSFREE			0x111E
202 #define SDP_SERVICE_CLASS_HANDSFREE_AUDIO_GATEWAY	0x111F
203 #define SDP_SERVICE_CLASS_DIRECT_PRINTING_REFERENCE_OBJECTS	0x1120
204 #define SDP_SERVICE_CLASS_REFLECTED_UI			0x1121
205 #define SDP_SERVICE_CLASS_BASIC_PRINTING		0x1122
206 #define SDP_SERVICE_CLASS_PRINTING_STATUS		0x1123
207 #define SDP_SERVICE_CLASS_HUMAN_INTERFACE_DEVICE	0x1124
208 #define SDP_SERVICE_CLASS_HARDCOPY_CABLE_REPLACEMENT	0x1125
209 #define SDP_SERVICE_CLASS_HCR_PRINT			0x1126
210 #define SDP_SERVICE_CLASS_HCR_SCAN			0x1127
211 #define SDP_SERVICE_CLASS_COMMON_ISDN_ACCESS		0x1128
212 #define SDP_SERVICE_CLASS_VIDEO_CONFERENCING_GW		0x1129
213 #define SDP_SERVICE_CLASS_UDI_MT			0x112A
214 #define SDP_SERVICE_CLASS_UDI_TA			0x112B
215 #define SDP_SERVICE_CLASS_AUDIO_VIDEO			0x112C
216 #define SDP_SERVICE_CLASS_SIM_ACCESS			0x112D
217 #define SDP_SERVICE_CLASS_PHONEBOOK_ACCESS_PCE		0x112E
218 #define SDP_SERVICE_CLASS_PHONEBOOK_ACCESS_PSE		0x112F
219 #define SDP_SERVICE_CLASS_PHONEBOOK_ACCESS		0x1130
220 #define SDP_SERVICE_CLASS_HEADSET_HS			0x1131
221 #define SDP_SERVICE_CLASS_MESSAGE_ACCESS_SERVER		0x1132
222 #define SDP_SERVICE_CLASS_MESSAGE_NOTIFICATION_SERVER	0x1133
223 #define SDP_SERVICE_CLASS_MESSAGE_ACCESS_PROFILE	0x1134
224 #define SDP_SERVICE_CLASS_PNP_INFORMATION		0x1200
225 #define SDP_SERVICE_CLASS_GENERIC_NETWORKING		0x1201
226 #define SDP_SERVICE_CLASS_GENERIC_FILE_TRANSFER		0x1202
227 #define SDP_SERVICE_CLASS_GENERIC_AUDIO			0x1203
228 #define SDP_SERVICE_CLASS_GENERIC_TELEPHONY		0x1204
229 #define SDP_SERVICE_CLASS_UPNP				0x1205
230 #define SDP_SERVICE_CLASS_UPNP_IP			0x1206
231 #define SDP_SERVICE_CLASS_ESDP_UPNP_IP_PAN		0x1300
232 #define SDP_SERVICE_CLASS_ESDP_UPNP_IP_LAP		0x1301
233 #define SDP_SERVICE_CLASS_ESDP_UPNP_L2CAP		0x1302
234 #define SDP_SERVICE_CLASS_VIDEO_SOURCE			0x1303
235 #define SDP_SERVICE_CLASS_VIDEO_SINK			0x1304
236 #define SDP_SERVICE_CLASS_VIDEO_DISTRIBUTION		0x1305
237 #define SDP_SERVICE_CLASS_HDP				0x1400
238 #define SDP_SERVICE_CLASS_HDP_SOURCE			0x1401
239 #define SDP_SERVICE_CLASS_HDP_SINK			0x1402
240 
241 /*
242  * Universal Attribute definitions valid in all service classes
243  */
244 #define SDP_ATTR_SERVICE_RECORD_HANDLE			0x0000
245 #define SDP_ATTR_SERVICE_CLASS_ID_LIST			0x0001
246 #define SDP_ATTR_SERVICE_RECORD_STATE			0x0002
247 #define SDP_ATTR_SERVICE_ID				0x0003
248 #define SDP_ATTR_PROTOCOL_DESCRIPTOR_LIST		0x0004
249 #define SDP_ATTR_BROWSE_GROUP_LIST			0x0005
250 #define SDP_ATTR_LANGUAGE_BASE_ATTRIBUTE_ID_LIST	0x0006
251 #define SDP_ATTR_SERVICE_INFO_TIME_TO_LIVE		0x0007
252 #define SDP_ATTR_SERVICE_AVAILABILITY			0x0008
253 #define SDP_ATTR_BLUETOOTH_PROFILE_DESCRIPTOR_LIST	0x0009
254 #define SDP_ATTR_DOCUMENTATION_URL			0x000A
255 #define SDP_ATTR_CLIENT_EXECUTABLE_URL			0x000B
256 #define SDP_ATTR_ICON_URL				0x000C
257 #define SDP_ATTR_ADDITIONAL_PROTOCOL_DESCRIPTOR_LISTS	0x000D
258 /* 0x000E-0x01ff are reserved */
259 
260 /*
261  * The offset must be added to the attribute ID base (contained in the
262  * LANGUAGE_BASE_ATTRIBUTE_ID_LIST attribute value) in order to compute
263  * the attribute ID for these attributes.
264  * The primary language base is always 0x0100.
265  */
266 #define SDP_ATTR_PRIMARY_LANGUAGE_BASE_ID		0x0100
267 #define SDP_ATTR_SERVICE_NAME_OFFSET			0x0000
268 #define SDP_ATTR_SERVICE_DESCRIPTION_OFFSET		0x0001
269 #define SDP_ATTR_PROVIDER_NAME_OFFSET			0x0002
270 
271 /* ServiceDiscoveryServer profile attribute definitions */
272 #define SDP_ATTR_VERSION_NUMBER_LIST			0x0200
273 #define SDP_ATTR_SERVICE_DATABASE_STATE			0x0201
274 
275 /* BrowseGroupDescriptor profile attribute definitions */
276 #define SDP_ATTR_GROUP_ID				0x0200
277 
278 /* Other profile attribute definitions */
279 #define SDP_ATTR_IP_SUBNET				0x0200
280 #define SDP_ATTR_SUPPORT_FEATURES_LIST			0x0200
281 #define SDP_ATTR_SERVICE_VERSION			0x0300
282 #define SDP_ATTR_DATA_EXCHANGE_SPECIFICATION		0x0301
283 #define SDP_ATTR_EXTERNAL_NETWORK			0x0301
284 #define SDP_ATTR_NETWORK				0x0301
285 #define SDP_ATTR_SUPPORTED_DATA_STORES_LIST		0x0301
286 #define SDP_ATTR_FAX_CLASS1_SUPPORT			0x0302
287 #define SDP_ATTR_REMOTE_AUDIO_VOLUME_CONTROL		0x0302
288 #define SDP_ATTR_MCAP_SUPPORTED_PROCEDURES		0x0302
289 #define SDP_ATTR_FAX_CLASS20_SUPPORT			0x0303
290 #define SDP_ATTR_SUPPORTED_FORMATS_LIST			0x0303
291 #define SDP_ATTR_FAX_CLASS2_SUPPORT			0x0304
292 #define SDP_ATTR_AUDIO_FEEDBACK_SUPPORT			0x0305
293 #define SDP_ATTR_NETWORK_ADDRESS			0x0306
294 #define SDP_ATTR_WAP_GATEWAY				0x0307
295 #define SDP_ATTR_HOME_PAGE_URL				0x0308
296 #define SDP_ATTR_WAP_STACK_TYPE				0x0309
297 #define SDP_ATTR_SECURITY_DESCRIPTION			0x030A
298 #define SDP_ATTR_NET_ACCESS_TYPE			0x030B
299 #define SDP_ATTR_MAX_NET_ACCESS_RATE			0x030C
300 #define SDP_ATTR_IPV4_SUBNET				0x030D
301 #define SDP_ATTR_IPV6_SUBNET				0x030E
302 #define SDP_ATTR_SUPPORTED_CAPABALITIES			0x0310
303 #define SDP_ATTR_SUPPORTED_FEATURES			0x0311
304 #define SDP_ATTR_SUPPORTED_FUNCTIONS			0x0312
305 #define SDP_ATTR_TOTAL_IMAGING_DATA_CAPACITY		0x0313
306 #define SDP_ATTR_SUPPORTED_REPOSITORIES			0x0314
307 #define SDP_ATTR_MAS_INSTANCE_ID			0x0315
308 #define SDP_ATTR_SUPPORTED_MESSAGE_TYPES		0x0316
309 
310 /*
311  * Protocol Data Unit (PDU) header format
312  */
313 
314 typedef struct {
315 	uint8_t		pid;	/* PDU ID - SDP_PDU_xxx */
316 	uint16_t	tid;	/* transaction ID */
317 	uint16_t	len;	/* parameters length (in bytes) */
318 } __packed sdp_pdu_t;
319 
320 /* PDU IDs */
321 #define SDP_PDU_ERROR_RESPONSE				0x01
322 #define SDP_PDU_SERVICE_SEARCH_REQUEST			0x02
323 #define SDP_PDU_SERVICE_SEARCH_RESPONSE			0x03
324 #define SDP_PDU_SERVICE_ATTRIBUTE_REQUEST		0x04
325 #define SDP_PDU_SERVICE_ATTRIBUTE_RESPONSE		0x05
326 #define SDP_PDU_SERVICE_SEARCH_ATTRIBUTE_REQUEST	0x06
327 #define SDP_PDU_SERVICE_SEARCH_ATTRIBUTE_RESPONSE	0x07
328 
329 /* Error codes for SDP_PDU_ERROR_RESPONSE */
330 #define SDP_ERROR_CODE_INVALID_SDP_VERSION		0x0001
331 #define SDP_ERROR_CODE_INVALID_SERVICE_RECORD_HANDLE	0x0002
332 #define SDP_ERROR_CODE_INVALID_REQUEST_SYNTAX		0x0003
333 #define SDP_ERROR_CODE_INVALID_PDU_SIZE			0x0004
334 #define SDP_ERROR_CODE_INVALID_CONTINUATION_STATE	0x0005
335 #define SDP_ERROR_CODE_INSUFFICIENT_RESOURCES		0x0006
336 
337 
338 /*****************************************************************************
339  *	sdpd(8) interface
340  */
341 
342 #define SDP_LOCAL_PATH	"/var/run/sdp"
343 #define SDP_LOCAL_MTU	L2CAP_MTU_DEFAULT
344 
345 /*
346  * These are NOT defined in spec and the requests are only accepted
347  * by sdpd(8) on the control socket. The response will be an Error
348  * Response with an ErrorCode of 0x0000 indicating success.
349  */
350 #define SDP_PDU_RECORD_INSERT_REQUEST			0x84
351 #define SDP_PDU_RECORD_UPDATE_REQUEST			0x86
352 #define SDP_PDU_RECORD_REMOVE_REQUEST			0x82
353 
354 
355 /******************************************************************************
356  *	Service Discovery API in libbluetooth(3)
357  */
358 
359 typedef struct {
360 	uint8_t *next;
361 	uint8_t *end;
362 } sdp_data_t;
363 
364 typedef struct sdp_session *sdp_session_t;
365 
366 /* sdp_uuid.c */
367 extern const uuid_t BLUETOOTH_BASE_UUID;
368 
369 #ifndef SDP_COMPAT
370 /* sdp_session.c */
371 sdp_session_t sdp_open(const bdaddr_t *, const bdaddr_t *) __RENAME(_sdp_open);
372 sdp_session_t sdp_open_local(const char *) __RENAME(_sdp_open_local);
373 void sdp_close(sdp_session_t) __RENAME(_sdp_close);
374 
375 /* sdp_record.c */
376 bool sdp_record_insert(sdp_session_t, bdaddr_t *, uint32_t *, const sdp_data_t *);
377 bool sdp_record_update(sdp_session_t, uint32_t, const sdp_data_t *);
378 bool sdp_record_remove(sdp_session_t, uint32_t);
379 
380 /* sdp_service.c */
381 bool sdp_service_search(sdp_session_t, const sdp_data_t *, uint32_t *, int *);
382 bool sdp_service_attribute(sdp_session_t, uint32_t, const sdp_data_t *, sdp_data_t *);
383 bool sdp_service_search_attribute(sdp_session_t, const sdp_data_t *, const sdp_data_t *, sdp_data_t *);
384 #endif
385 
386 /* sdp_match.c */
387 bool sdp_match_uuid16(sdp_data_t *, uint16_t);
388 
389 /* sdp_get.c */
390 bool sdp_get_data(sdp_data_t *, sdp_data_t *);
391 bool sdp_get_attr(sdp_data_t *, uint16_t *, sdp_data_t *);
392 bool sdp_get_uuid(sdp_data_t *, uuid_t *);
393 bool sdp_get_bool(sdp_data_t *, bool *);
394 bool sdp_get_seq(sdp_data_t *, sdp_data_t *);
395 bool sdp_get_alt(sdp_data_t *, sdp_data_t *);
396 bool sdp_get_uint(sdp_data_t *, uintmax_t *);
397 bool sdp_get_int(sdp_data_t *, intmax_t *);
398 bool sdp_get_str(sdp_data_t *, char **, size_t *);
399 bool sdp_get_url(sdp_data_t *, char **, size_t *);
400 
401 /* sdp_put.c */
402 bool sdp_put_data(sdp_data_t *, sdp_data_t *);
403 bool sdp_put_attr(sdp_data_t *, uint16_t, sdp_data_t *);
404 bool sdp_put_uuid(sdp_data_t *, const uuid_t *);
405 bool sdp_put_uuid16(sdp_data_t *, uint16_t);
406 bool sdp_put_uuid32(sdp_data_t *, uint32_t);
407 bool sdp_put_uuid128(sdp_data_t *, const uuid_t *);
408 bool sdp_put_bool(sdp_data_t *, bool);
409 bool sdp_put_uint(sdp_data_t *, uintmax_t);
410 bool sdp_put_uint8(sdp_data_t *, uint8_t);
411 bool sdp_put_uint16(sdp_data_t *, uint16_t);
412 bool sdp_put_uint32(sdp_data_t *, uint32_t);
413 bool sdp_put_uint64(sdp_data_t *, uint64_t);
414 bool sdp_put_int(sdp_data_t *, intmax_t);
415 bool sdp_put_int8(sdp_data_t *, int8_t);
416 bool sdp_put_int16(sdp_data_t *, int16_t);
417 bool sdp_put_int32(sdp_data_t *, int32_t);
418 bool sdp_put_int64(sdp_data_t *, int64_t);
419 bool sdp_put_seq(sdp_data_t *, ssize_t);
420 bool sdp_put_alt(sdp_data_t *, ssize_t);
421 bool sdp_put_str(sdp_data_t *, const char *, ssize_t);
422 bool sdp_put_url(sdp_data_t *, const char *, ssize_t);
423 
424 /* sdp_set.c */
425 bool sdp_set_bool(const sdp_data_t *, bool);
426 bool sdp_set_uint(const sdp_data_t *, uintmax_t);
427 bool sdp_set_int(const sdp_data_t *, intmax_t);
428 bool sdp_set_seq(const sdp_data_t *, ssize_t);
429 bool sdp_set_alt(const sdp_data_t *, ssize_t);
430 
431 /* sdp_data.c */
432 ssize_t sdp_data_size(const sdp_data_t *);
433 int sdp_data_type(const sdp_data_t *);
434 bool sdp_data_valid(const sdp_data_t *);
435 void sdp_data_print(const sdp_data_t *, int);
436 
437 /******************************************************************************
438  *
439  *	Source level compatibility with old API
440  *
441  * enable with -DSDP_COMPAT but it will be removed eventually
442  *
443  ******************************************************************************/
444 
445 #ifdef SDP_COMPAT
446 #include <strings.h>
447 
448 typedef sdp_pdu_t *sdp_pdu_p;
449 
450 #define SDP_PDU_SERVICE_REGISTER_REQUEST		0x81
451 #define SDP_PDU_SERVICE_UNREGISTER_REQUEST		0x82
452 #define SDP_PDU_SERVICE_CHANGE_REQUEST			0x83
453 
454 /*
455  * SDP int128/uint128 parameter
456  */
457 
458 struct int128 {
459 	int8_t	b[16];
460 };
461 typedef struct int128	int128_t;
462 typedef struct int128	uint128_t;
463 
464 /*
465  * SDP attribute
466  */
467 
468 struct sdp_attr {
469 	uint16_t	 flags;
470 #define SDP_ATTR_OK		(0 << 0)
471 #define SDP_ATTR_INVALID	(1 << 0)
472 #define SDP_ATTR_TRUNCATED	(1 << 1)
473 	uint16_t	 attr;  /* SDP_ATTR_xxx */
474 	uint32_t	 vlen;	/* length of the value[] in bytes */
475 	uint8_t		*value;	/* base pointer */
476 };
477 typedef struct sdp_attr		sdp_attr_t;
478 typedef struct sdp_attr *	sdp_attr_p;
479 
480 #define SDP_ATTR_RANGE(lo, hi) \
481 	(uint32_t)(((uint16_t)(lo) << 16) | ((uint16_t)(hi)))
482 
483 /* sdp_compat.c */
484 void *sdp_open(bdaddr_t const *, bdaddr_t const *);
485 void *sdp_open_local(char const *);
486 int32_t sdp_close(void *);
487 int32_t sdp_error(void *);
488 int32_t sdp_search(void *, uint32_t, uint16_t const *, uint32_t, uint32_t const *, uint32_t, sdp_attr_t *);
489 int32_t	sdp_register_service(void *, uint16_t, bdaddr_t *, uint8_t *, uint32_t, uint32_t *);
490 int32_t	sdp_unregister_service(void *, uint32_t);
491 int32_t	sdp_change_service(void *, uint32_t, uint8_t *, uint32_t);
492 const char *sdp_attr2desc(uint16_t);
493 const char *sdp_uuid2desc(uint16_t);
494 void sdp_print(uint32_t, uint8_t *, uint8_t const *);
495 
496 /* Inline versions of get/put byte/short/long. Pointer is advanced */
497 #define SDP_GET8(b, cp)		do {			\
498 	(b) = *(const uint8_t *)(cp);			\
499 	(cp) += sizeof(uint8_t);			\
500 } while (0)
501 
502 #define SDP_GET16(s, cp)	do {			\
503 	(s) = be16dec(cp);				\
504 	(cp) += sizeof(uint16_t);			\
505 } while (0)
506 
507 #define SDP_GET32(l, cp)	do {			\
508 	(l) = be32dec(cp);				\
509 	(cp) += sizeof(uint32_t);			\
510 } while (0)
511 
512 #define SDP_GET64(l, cp)	do {			\
513 	(l) = be64dec(cp);				\
514 	(cp) += sizeof(uint64_t);			\
515 } while (0)
516 
517 #if BYTE_ORDER == LITTLE_ENDIAN
518 #define SDP_GET128(l, cp)	do {			\
519 	register const uint8_t *t_cp = (const uint8_t *)(cp);	\
520 	(l)->b[15] = *t_cp++;				\
521 	(l)->b[14] = *t_cp++;				\
522 	(l)->b[13] = *t_cp++;				\
523 	(l)->b[12] = *t_cp++;				\
524 	(l)->b[11] = *t_cp++;				\
525 	(l)->b[10] = *t_cp++;				\
526 	(l)->b[9]  = *t_cp++;				\
527 	(l)->b[8]  = *t_cp++;				\
528 	(l)->b[7]  = *t_cp++;				\
529 	(l)->b[6]  = *t_cp++;				\
530 	(l)->b[5]  = *t_cp++;				\
531 	(l)->b[4]  = *t_cp++;				\
532 	(l)->b[3]  = *t_cp++;				\
533 	(l)->b[2]  = *t_cp++;				\
534 	(l)->b[1]  = *t_cp++;				\
535 	(l)->b[0]  = *t_cp++;				\
536 	(cp) += 16;					\
537 } while (0)
538 
539 #define SDP_GET_UUID128(l, cp)	do {			\
540 	memcpy(&((l)->b), (cp), 16);			\
541 	(cp) += 16;					\
542 } while (0)
543 #elif BYTE_ORDER == BIG_ENDIAN
544 #define SDP_GET128(l, cp)	do {			\
545 	memcpy(&((l)->b), (cp), 16);			\
546 	(cp) += 16;					\
547 } while (0)
548 
549 #define SDP_GET_UUID128(l, cp)	SDP_GET128(l, cp)
550 #else
551 #error	"Unsupported BYTE_ORDER"
552 #endif /* BYTE_ORDER */
553 
554 #define SDP_PUT8(b, cp)		do {			\
555 	*(uint8_t *)(cp) = (b);				\
556 	(cp) += sizeof(uint8_t);			\
557 } while (0)
558 
559 #define SDP_PUT16(s, cp)	do {			\
560 	be16enc((cp), (s));				\
561 	(cp) += sizeof(uint16_t);			\
562 } while (0)
563 
564 #define SDP_PUT32(s, cp)	do {			\
565 	be32enc((cp), (s));				\
566 	(cp) += sizeof(uint32_t);			\
567 } while (0)
568 
569 #define SDP_PUT64(s, cp)	do {			\
570 	be64enc((cp), (s));				\
571 	(cp) += sizeof(uint64_t);			\
572 } while (0)
573 
574 #if BYTE_ORDER == LITTLE_ENDIAN
575 #define SDP_PUT128(l, cp)	do {			\
576 	register const uint8_t *t_cp = (const uint8_t *)(cp);	\
577 	*t_cp++ = (l)->b[15];				\
578 	*t_cp++ = (l)->b[14];				\
579 	*t_cp++ = (l)->b[13];				\
580 	*t_cp++ = (l)->b[12];				\
581 	*t_cp++ = (l)->b[11];				\
582 	*t_cp++ = (l)->b[10];				\
583 	*t_cp++ = (l)->b[9];				\
584 	*t_cp++ = (l)->b[8];				\
585 	*t_cp++ = (l)->b[7];				\
586 	*t_cp++ = (l)->b[6];				\
587 	*t_cp++ = (l)->b[5];				\
588 	*t_cp++ = (l)->b[4];				\
589 	*t_cp++ = (l)->b[3];				\
590 	*t_cp++ = (l)->b[2];				\
591 	*t_cp++ = (l)->b[1];				\
592 	*t_cp   = (l)->b[0];				\
593 	(cp) += 16;					\
594 } while (0)
595 
596 #define SDP_PUT_UUID128(l, cp)	do {			\
597 	memcpy((cp), &((l)->b), 16);			\
598 	(cp) += 16;					\
599 } while (0)
600 #elif BYTE_ORDER == BIG_ENDIAN
601 #define SDP_PUT128(l, cp)	do {			\
602 	memcpy((cp), &((l)->b), 16);			\
603 	(cp) += 16;					\
604 } while (0)
605 
606 #define SDP_PUT_UUID128(l, cp)	SDP_PUT128(l, cp)
607 #else
608 #error	"Unsupported BYTE_ORDER"
609 #endif /* BYTE_ORDER */
610 
611 struct sdp_dun_profile
612 {
613 	uint8_t	server_channel;
614 	uint8_t	audio_feedback_support;
615 	uint8_t	reserved[2];
616 };
617 typedef struct sdp_dun_profile		sdp_dun_profile_t;
618 typedef struct sdp_dun_profile *	sdp_dun_profile_p;
619 
620 struct sdp_ftrn_profile
621 {
622 	uint8_t	server_channel;
623 	uint8_t	reserved[3];
624 };
625 typedef struct sdp_ftrn_profile		sdp_ftrn_profile_t;
626 typedef struct sdp_ftrn_profile *	sdp_ftrn_profile_p;
627 
628 struct sdp_hset_profile
629 {
630 	uint8_t server_channel;
631 	uint8_t	reserved[3];
632 };
633 typedef struct sdp_hset_profile		sdp_hset_profile_t;
634 typedef struct sdp_hset_profile *	sdp_hset_profile_p;
635 
636 struct sdp_hf_profile
637 {
638 	uint8_t server_channel;
639 	uint16_t supported_features;
640 };
641 typedef struct sdp_hf_profile		sdp_hf_profile_t;
642 typedef struct sdp_hf_profile *		sdp_hf_profile_p;
643 
644 /* Keep this in sync with sdp_opush_profile */
645 struct sdp_irmc_profile
646 {
647 	uint8_t	server_channel;
648 	uint8_t	supported_formats_size;
649 	uint8_t	supported_formats[30];
650 };
651 typedef struct sdp_irmc_profile		sdp_irmc_profile_t;
652 typedef struct sdp_irmc_profile *	sdp_irmc_profile_p;
653 
654 struct sdp_irmc_command_profile
655 {
656 	uint8_t	server_channel;
657 	uint8_t	reserved[3];
658 };
659 typedef struct sdp_irmc_command_profile		sdp_irmc_command_profile_t;
660 typedef struct sdp_irmc_command_profile *	sdp_irmc_command_profile_p;
661 
662 struct sdp_lan_profile
663 {
664 	uint8_t		server_channel;
665 	uint8_t		load_factor;
666 	uint8_t		reserved;
667 	uint8_t		ip_subnet_radius;
668 	uint32_t	ip_subnet;
669 };
670 typedef struct sdp_lan_profile		sdp_lan_profile_t;
671 typedef struct sdp_lan_profile *	sdp_lan_profile_p;
672 
673 /* Keep this in sync with sdp_irmc_profile */
674 struct sdp_opush_profile
675 {
676 	uint8_t	server_channel;
677 	uint8_t	supported_formats_size;
678 	uint8_t	supported_formats[30];
679 };
680 typedef struct sdp_opush_profile	sdp_opush_profile_t;
681 typedef struct sdp_opush_profile *	sdp_opush_profile_p;
682 
683 struct sdp_sp_profile
684 {
685 	uint8_t	server_channel;
686 	uint8_t	reserved[3];
687 };
688 typedef struct sdp_sp_profile	sdp_sp_profile_t;
689 typedef struct sdp_sp_profile *	sdp_sp_profile_p;
690 
691 struct sdp_nap_profile
692 {
693 	uint8_t		reserved;
694 	uint8_t		load_factor;
695 	uint16_t	psm;
696 	uint16_t	security_description;
697 	uint16_t	net_access_type;
698 	uint32_t	max_net_access_rate;
699 };
700 typedef struct sdp_nap_profile		sdp_nap_profile_t;
701 typedef struct sdp_nap_profile *	sdp_nap_profile_p;
702 
703 struct sdp_gn_profile
704 {
705 	uint8_t		reserved;
706 	uint8_t		load_factor;
707 	uint16_t	psm;
708 	uint16_t	security_description;
709 	uint16_t	reserved2;
710 	uint32_t	reserved3;
711 };
712 typedef struct sdp_gn_profile		sdp_gn_profile_t;
713 typedef struct sdp_gn_profile *		sdp_gn_profile_p;
714 
715 struct sdp_panu_profile
716 {
717 	uint8_t		reserved;
718 	uint8_t		load_factor;
719 	uint16_t	psm;
720 	uint16_t	security_description;
721 	uint16_t	reserved2;
722 	uint32_t	reserved3;
723 };
724 typedef struct sdp_panu_profile		sdp_panu_profile_t;
725 typedef struct sdp_panu_profile *	sdp_panu_profile_p;
726 
727 #endif /* SDP_COMPAT */
728 
729 #endif /* _SDP_H_ */
730