1/*-
2 * SPDX-License-Identifier: BSD-2-Clause
3 *
4 * Copyright (c) 2009 Sylvestre Gallon. 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 *
15 * THIS SOFTWARE IS PROVIDED BY THE AUTHOR AND CONTRIBUTORS ``AS IS'' AND
16 * ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
17 * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
18 * ARE DISCLAIMED.  IN NO EVENT SHALL THE AUTHOR OR CONTRIBUTORS BE LIABLE
19 * FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
20 * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
21 * OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
22 * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
23 * LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
24 * OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
25 * SUCH DAMAGE.
26 */
27
28#ifdef LIBUSB_GLOBAL_INCLUDE_FILE
29#include LIBUSB_GLOBAL_INCLUDE_FILE
30#else
31#include <stdio.h>
32#include <stdlib.h>
33#include <string.h>
34#include <time.h>
35#include <sys/queue.h>
36#endif
37
38#define	libusb_device_handle libusb20_device
39
40#include "libusb20.h"
41#include "libusb20_desc.h"
42#include "libusb20_int.h"
43#include "libusb.h"
44#include "libusb10.h"
45
46#define	N_ALIGN(n) (-((-(n)) & (-8UL)))
47
48/* USB descriptors */
49
50int
51libusb_get_device_descriptor(libusb_device *dev,
52    struct libusb_device_descriptor *desc)
53{
54	struct LIBUSB20_DEVICE_DESC_DECODED *pdesc;
55	struct libusb20_device *pdev;
56
57	if ((dev == NULL) || (desc == NULL))
58		return (LIBUSB_ERROR_INVALID_PARAM);
59
60	pdev = dev->os_priv;
61	pdesc = libusb20_dev_get_device_desc(pdev);
62
63	desc->bLength = pdesc->bLength;
64	desc->bDescriptorType = pdesc->bDescriptorType;
65	desc->bcdUSB = pdesc->bcdUSB;
66	desc->bDeviceClass = pdesc->bDeviceClass;
67	desc->bDeviceSubClass = pdesc->bDeviceSubClass;
68	desc->bDeviceProtocol = pdesc->bDeviceProtocol;
69	desc->bMaxPacketSize0 = pdesc->bMaxPacketSize0;
70	desc->idVendor = pdesc->idVendor;
71	desc->idProduct = pdesc->idProduct;
72	desc->bcdDevice = pdesc->bcdDevice;
73	desc->iManufacturer = pdesc->iManufacturer;
74	desc->iProduct = pdesc->iProduct;
75	desc->iSerialNumber = pdesc->iSerialNumber;
76	desc->bNumConfigurations = pdesc->bNumConfigurations;
77
78	return (0);
79}
80
81int
82libusb_get_active_config_descriptor(libusb_device *dev,
83    struct libusb_config_descriptor **config)
84{
85	struct libusb20_device *pdev;
86	uint8_t config_index;
87
88	pdev = dev->os_priv;
89	config_index = libusb20_dev_get_config_index(pdev);
90
91	return (libusb_get_config_descriptor(dev, config_index, config));
92}
93
94int
95libusb_get_config_descriptor(libusb_device *dev, uint8_t config_index,
96    struct libusb_config_descriptor **config)
97{
98	struct libusb20_device *pdev;
99	struct libusb20_config *pconf;
100	struct libusb20_interface *pinf;
101	struct libusb20_endpoint *pend;
102	struct libusb_config_descriptor *pconfd;
103	struct libusb_interface_descriptor *ifd;
104	struct libusb_endpoint_descriptor *endd;
105	uint8_t *pextra;
106	uint16_t nextra;
107	uint8_t nif;
108	uint8_t nep;
109	uint8_t nalt;
110	uint8_t i;
111	uint8_t j;
112	uint8_t k;
113
114	if (dev == NULL || config == NULL)
115		return (LIBUSB_ERROR_INVALID_PARAM);
116
117	*config = NULL;
118
119	pdev = dev->os_priv;
120	pconf = libusb20_dev_alloc_config(pdev, config_index);
121
122	if (pconf == NULL)
123		return (LIBUSB_ERROR_NOT_FOUND);
124
125	nalt = nif = pconf->num_interface;
126	nep = 0;
127	nextra = N_ALIGN(pconf->extra.len);
128
129	for (i = 0; i < nif; i++) {
130
131		pinf = pconf->interface + i;
132		nextra += N_ALIGN(pinf->extra.len);
133		nep += pinf->num_endpoints;
134		k = pinf->num_endpoints;
135		pend = pinf->endpoints;
136		while (k--) {
137			nextra += N_ALIGN(pend->extra.len);
138			pend++;
139		}
140
141		j = pinf->num_altsetting;
142		nalt += pinf->num_altsetting;
143		pinf = pinf->altsetting;
144		while (j--) {
145			nextra += N_ALIGN(pinf->extra.len);
146			nep += pinf->num_endpoints;
147			k = pinf->num_endpoints;
148			pend = pinf->endpoints;
149			while (k--) {
150				nextra += N_ALIGN(pend->extra.len);
151				pend++;
152			}
153			pinf++;
154		}
155	}
156
157	nextra = nextra +
158	    (1 * sizeof(libusb_config_descriptor)) +
159	    (nif * sizeof(libusb_interface)) +
160	    (nalt * sizeof(libusb_interface_descriptor)) +
161	    (nep * sizeof(libusb_endpoint_descriptor));
162
163	nextra = N_ALIGN(nextra);
164
165	pconfd = malloc(nextra);
166
167	if (pconfd == NULL) {
168		free(pconf);
169		return (LIBUSB_ERROR_NO_MEM);
170	}
171	/* make sure memory is initialised */
172	memset(pconfd, 0, nextra);
173
174	pconfd->interface = (libusb_interface *) (pconfd + 1);
175
176	ifd = (libusb_interface_descriptor *) (pconfd->interface + nif);
177	endd = (libusb_endpoint_descriptor *) (ifd + nalt);
178	pextra = (uint8_t *)(endd + nep);
179
180	/* fill in config descriptor */
181
182	pconfd->bLength = pconf->desc.bLength;
183	pconfd->bDescriptorType = pconf->desc.bDescriptorType;
184	pconfd->wTotalLength = pconf->desc.wTotalLength;
185	pconfd->bNumInterfaces = pconf->desc.bNumInterfaces;
186	pconfd->bConfigurationValue = pconf->desc.bConfigurationValue;
187	pconfd->iConfiguration = pconf->desc.iConfiguration;
188	pconfd->bmAttributes = pconf->desc.bmAttributes;
189	pconfd->MaxPower = pconf->desc.bMaxPower;
190
191	if (pconf->extra.len != 0) {
192		pconfd->extra_length = pconf->extra.len;
193		pconfd->extra = pextra;
194		memcpy(pextra, pconf->extra.ptr, pconfd->extra_length);
195		pextra += N_ALIGN(pconfd->extra_length);
196	}
197	/* setup all interface and endpoint pointers */
198
199	for (i = 0; i < nif; i++) {
200
201		pconfd->interface[i].altsetting = ifd;
202		ifd->endpoint = endd;
203		endd += pconf->interface[i].num_endpoints;
204		ifd++;
205
206		for (j = 0; j < pconf->interface[i].num_altsetting; j++) {
207			ifd->endpoint = endd;
208			endd += pconf->interface[i].altsetting[j].num_endpoints;
209			ifd++;
210		}
211	}
212
213	/* fill in all interface and endpoint data */
214
215	for (i = 0; i < nif; i++) {
216		pinf = &pconf->interface[i];
217		pconfd->interface[i].num_altsetting = pinf->num_altsetting + 1;
218		for (j = 0; j < pconfd->interface[i].num_altsetting; j++) {
219			if (j != 0)
220				pinf = &pconf->interface[i].altsetting[j - 1];
221			ifd = &pconfd->interface[i].altsetting[j];
222			ifd->bLength = pinf->desc.bLength;
223			ifd->bDescriptorType = pinf->desc.bDescriptorType;
224			ifd->bInterfaceNumber = pinf->desc.bInterfaceNumber;
225			ifd->bAlternateSetting = pinf->desc.bAlternateSetting;
226			ifd->bNumEndpoints = pinf->desc.bNumEndpoints;
227			ifd->bInterfaceClass = pinf->desc.bInterfaceClass;
228			ifd->bInterfaceSubClass = pinf->desc.bInterfaceSubClass;
229			ifd->bInterfaceProtocol = pinf->desc.bInterfaceProtocol;
230			ifd->iInterface = pinf->desc.iInterface;
231			if (pinf->extra.len != 0) {
232				ifd->extra_length = pinf->extra.len;
233				ifd->extra = pextra;
234				memcpy(pextra, pinf->extra.ptr, pinf->extra.len);
235				pextra += N_ALIGN(pinf->extra.len);
236			}
237			for (k = 0; k < pinf->num_endpoints; k++) {
238				pend = &pinf->endpoints[k];
239				endd = &ifd->endpoint[k];
240				endd->bLength = pend->desc.bLength;
241				endd->bDescriptorType = pend->desc.bDescriptorType;
242				endd->bEndpointAddress = pend->desc.bEndpointAddress;
243				endd->bmAttributes = pend->desc.bmAttributes;
244				endd->wMaxPacketSize = pend->desc.wMaxPacketSize;
245				endd->bInterval = pend->desc.bInterval;
246				endd->bRefresh = pend->desc.bRefresh;
247				endd->bSynchAddress = pend->desc.bSynchAddress;
248				if (pend->extra.len != 0) {
249					endd->extra_length = pend->extra.len;
250					endd->extra = pextra;
251					memcpy(pextra, pend->extra.ptr, pend->extra.len);
252					pextra += N_ALIGN(pend->extra.len);
253				}
254			}
255		}
256	}
257
258	free(pconf);
259
260	*config = pconfd;
261
262	return (0);			/* success */
263}
264
265int
266libusb_get_config_descriptor_by_value(libusb_device *dev,
267    uint8_t bConfigurationValue, struct libusb_config_descriptor **config)
268{
269	struct LIBUSB20_DEVICE_DESC_DECODED *pdesc;
270	struct libusb20_device *pdev;
271	int i;
272	int err;
273
274	if (dev == NULL || config == NULL)
275		return (LIBUSB_ERROR_INVALID_PARAM);
276
277	pdev = dev->os_priv;
278	pdesc = libusb20_dev_get_device_desc(pdev);
279
280	for (i = 0; i < pdesc->bNumConfigurations; i++) {
281		err = libusb_get_config_descriptor(dev, i, config);
282		if (err)
283			return (err);
284
285		if ((*config)->bConfigurationValue == bConfigurationValue)
286			return (0);	/* success */
287
288		libusb_free_config_descriptor(*config);
289	}
290
291	*config = NULL;
292
293	return (LIBUSB_ERROR_NOT_FOUND);
294}
295
296void
297libusb_free_config_descriptor(struct libusb_config_descriptor *config)
298{
299	free(config);
300}
301
302int
303libusb_get_string_descriptor(libusb_device_handle *pdev,
304    uint8_t desc_index, uint16_t langid, unsigned char *data,
305    int length)
306{
307	if (pdev == NULL || data == NULL || length < 1)
308		return (LIBUSB_ERROR_INVALID_PARAM);
309
310	if (length > 65535)
311		length = 65535;
312
313	/* put some default data into the destination buffer */
314	data[0] = 0;
315
316	return (libusb_control_transfer(pdev, LIBUSB_ENDPOINT_IN,
317	    LIBUSB_REQUEST_GET_DESCRIPTOR, (LIBUSB_DT_STRING << 8) | desc_index,
318	    langid, data, length, 1000));
319}
320
321int
322libusb_get_string_descriptor_ascii(libusb_device_handle *pdev,
323    uint8_t desc_index, unsigned char *data, int length)
324{
325	if (pdev == NULL || data == NULL || length < 1)
326		return (LIBUSB_ERROR_INVALID_PARAM);
327
328	if (length > 65535)
329		length = 65535;
330
331	/* put some default data into the destination buffer */
332	data[0] = 0;
333
334	if (libusb20_dev_req_string_simple_sync(pdev, desc_index,
335	    data, length) == 0)
336		return (strlen((char *)data));
337
338	return (LIBUSB_ERROR_OTHER);
339}
340
341int
342libusb_get_descriptor(libusb_device_handle * devh, uint8_t desc_type,
343    uint8_t desc_index, uint8_t *data, int length)
344{
345	if (devh == NULL || data == NULL || length < 1)
346		return (LIBUSB_ERROR_INVALID_PARAM);
347
348	if (length > 65535)
349		length = 65535;
350
351	return (libusb_control_transfer(devh, LIBUSB_ENDPOINT_IN,
352	    LIBUSB_REQUEST_GET_DESCRIPTOR, (desc_type << 8) | desc_index, 0, data,
353	    length, 1000));
354}
355
356int
357libusb_parse_ss_endpoint_comp(const void *buf, int len,
358    struct libusb_ss_endpoint_companion_descriptor **ep_comp)
359{
360	if (buf == NULL || ep_comp == NULL || len < 1)
361		return (LIBUSB_ERROR_INVALID_PARAM);
362
363	if (len > 65535)
364		len = 65535;
365
366	*ep_comp = NULL;
367
368	while (len != 0) {
369		uint8_t dlen;
370		uint8_t dtype;
371
372		dlen = ((const uint8_t *)buf)[0];
373		dtype = ((const uint8_t *)buf)[1];
374
375		if (dlen < 2 || dlen > len)
376			break;
377
378		if (dlen >= LIBUSB_DT_SS_ENDPOINT_COMPANION_SIZE &&
379		    dtype == LIBUSB_DT_SS_ENDPOINT_COMPANION) {
380			struct libusb_ss_endpoint_companion_descriptor *ptr;
381
382			ptr = malloc(sizeof(*ptr));
383			if (ptr == NULL)
384				return (LIBUSB_ERROR_NO_MEM);
385
386			ptr->bLength = LIBUSB_DT_SS_ENDPOINT_COMPANION_SIZE;
387			ptr->bDescriptorType = dtype;
388			ptr->bMaxBurst = ((const uint8_t *)buf)[2];
389			ptr->bmAttributes = ((const uint8_t *)buf)[3];
390			ptr->wBytesPerInterval = ((const uint8_t *)buf)[4] |
391			    (((const uint8_t *)buf)[5] << 8);
392
393			*ep_comp = ptr;
394
395			return (0);	/* success */
396		}
397
398		buf = ((const uint8_t *)buf) + dlen;
399		len -= dlen;
400	}
401	return (LIBUSB_ERROR_IO);
402}
403
404void
405libusb_free_ss_endpoint_comp(struct libusb_ss_endpoint_companion_descriptor *ep_comp)
406{
407	if (ep_comp == NULL)
408		return;
409
410	free(ep_comp);
411}
412
413int
414libusb_get_ss_endpoint_companion_descriptor(struct libusb_context *ctx,
415    const struct libusb_endpoint_descriptor *endpoint,
416    struct libusb_ss_endpoint_companion_descriptor **ep_comp)
417{
418	if (endpoint == NULL)
419		return (LIBUSB_ERROR_INVALID_PARAM);
420	return (libusb_parse_ss_endpoint_comp(endpoint->extra, endpoint->extra_length, ep_comp));
421}
422
423void
424libusb_free_ss_endpoint_companion_descriptor(struct libusb_ss_endpoint_companion_descriptor *ep_comp)
425{
426
427	libusb_free_ss_endpoint_comp(ep_comp);
428}
429
430int
431libusb_parse_bos_descriptor(const void *buf, int len,
432    struct libusb_bos_descriptor **bos)
433{
434	struct libusb_bos_descriptor *ptr;
435	struct libusb_usb_2_0_device_capability_descriptor *dcap_20 = NULL;
436	struct libusb_ss_usb_device_capability_descriptor *ss_cap = NULL;
437	uint8_t index = 0;
438
439	if (buf == NULL || bos == NULL || len < 1)
440		return (LIBUSB_ERROR_INVALID_PARAM);
441
442	if (len > 65535)
443		len = 65535;
444
445	*bos = ptr = NULL;
446
447	while (len != 0) {
448		uint8_t dlen;
449		uint8_t dtype;
450
451		dlen = ((const uint8_t *)buf)[0];
452		dtype = ((const uint8_t *)buf)[1];
453
454		if (dlen < 2 || dlen > len)
455			break;
456
457		if (dlen >= LIBUSB_DT_BOS_SIZE &&
458		    dtype == LIBUSB_DT_BOS &&
459		    ptr == NULL) {
460
461			ptr = malloc(sizeof(*ptr) + sizeof(*dcap_20) +
462			    sizeof(*ss_cap));
463
464			if (ptr == NULL)
465				return (LIBUSB_ERROR_NO_MEM);
466
467			*bos = ptr;
468
469			ptr->bLength = LIBUSB_DT_BOS_SIZE;
470			ptr->bDescriptorType = dtype;
471			ptr->wTotalLength = ((const uint8_t *)buf)[2] |
472			    (((const uint8_t *)buf)[3] << 8);
473			ptr->bNumDeviceCapabilities = ((const uint8_t *)buf)[4];
474			ptr->usb_2_0_ext_cap = NULL;
475			ptr->ss_usb_cap = NULL;
476			ptr->dev_capability = calloc(ptr->bNumDeviceCapabilities, sizeof(void *));
477			if (ptr->dev_capability == NULL) {
478				free(ptr);
479				return (LIBUSB_ERROR_NO_MEM);
480			}
481
482			dcap_20 = (void *)(ptr + 1);
483			ss_cap = (void *)(dcap_20 + 1);
484		}
485		if (dlen >= 3 &&
486		    ptr != NULL &&
487		    dtype == LIBUSB_DT_DEVICE_CAPABILITY) {
488			if (index != ptr->bNumDeviceCapabilities) {
489				ptr->dev_capability[index] = malloc(dlen);
490				if (ptr->dev_capability[index] == NULL) {
491					libusb_free_bos_descriptor(ptr);
492					return LIBUSB_ERROR_NO_MEM;
493				}
494				memcpy(ptr->dev_capability[index], buf, dlen);
495				index++;
496			}
497			switch (((const uint8_t *)buf)[2]) {
498			case LIBUSB_USB_2_0_EXTENSION_DEVICE_CAPABILITY:
499				if (ptr->usb_2_0_ext_cap != NULL || dcap_20 == NULL)
500					break;
501				if (dlen < LIBUSB_USB_2_0_EXTENSION_DEVICE_CAPABILITY_SIZE)
502					break;
503
504				ptr->usb_2_0_ext_cap = dcap_20;
505
506				dcap_20->bLength = LIBUSB_USB_2_0_EXTENSION_DEVICE_CAPABILITY_SIZE;
507				dcap_20->bDescriptorType = dtype;
508				dcap_20->bDevCapabilityType = ((const uint8_t *)buf)[2];
509				dcap_20->bmAttributes = ((const uint8_t *)buf)[3] |
510				    (((const uint8_t *)buf)[4] << 8) |
511				    (((const uint8_t *)buf)[5] << 16) |
512				    (((const uint8_t *)buf)[6] << 24);
513				break;
514
515			case LIBUSB_SS_USB_DEVICE_CAPABILITY:
516				if (ptr->ss_usb_cap != NULL || ss_cap == NULL)
517					break;
518				if (dlen < LIBUSB_SS_USB_DEVICE_CAPABILITY_SIZE)
519					break;
520
521				ptr->ss_usb_cap = ss_cap;
522
523				ss_cap->bLength = LIBUSB_SS_USB_DEVICE_CAPABILITY_SIZE;
524				ss_cap->bDescriptorType = dtype;
525				ss_cap->bDevCapabilityType = ((const uint8_t *)buf)[2];
526				ss_cap->bmAttributes = ((const uint8_t *)buf)[3];
527				ss_cap->wSpeedSupported = ((const uint8_t *)buf)[4] |
528				    (((const uint8_t *)buf)[5] << 8);
529				ss_cap->bFunctionalitySupport = ((const uint8_t *)buf)[6];
530				ss_cap->bU1DevExitLat = ((const uint8_t *)buf)[7];
531				ss_cap->wU2DevExitLat = ((const uint8_t *)buf)[8] |
532				    (((const uint8_t *)buf)[9] << 8);
533				break;
534
535			default:
536				break;
537			}
538		}
539
540		buf = ((const uint8_t *)buf) + dlen;
541		len -= dlen;
542	}
543
544	if (ptr != NULL) {
545		ptr->bNumDeviceCapabilities = index;
546		return (0);		/* success */
547	}
548
549	return (LIBUSB_ERROR_IO);
550}
551
552void
553libusb_free_bos_descriptor(struct libusb_bos_descriptor *bos)
554{
555	uint8_t i;
556
557	if (bos == NULL)
558		return;
559
560	for (i = 0; i != bos->bNumDeviceCapabilities; i++)
561		free(bos->dev_capability[i]);
562	free(bos->dev_capability);
563	free(bos);
564}
565
566int
567libusb_get_bos_descriptor(libusb_device_handle *handle,
568    struct libusb_bos_descriptor **bos)
569{
570	uint8_t bos_header[LIBUSB_DT_BOS_SIZE] = {0};
571	uint16_t wTotalLength;
572	uint8_t *bos_data;
573	int err;
574
575	err = libusb_get_descriptor(handle, LIBUSB_DT_BOS, 0,
576	    bos_header, sizeof(bos_header));
577	if (err < 0)
578		return (err);
579
580	wTotalLength = bos_header[2] | (bos_header[3] << 8);
581	if (wTotalLength < LIBUSB_DT_BOS_SIZE)
582		return (LIBUSB_ERROR_INVALID_PARAM);
583
584	bos_data = calloc(wTotalLength, 1);
585	if (bos_data == NULL)
586		return (LIBUSB_ERROR_NO_MEM);
587
588	err = libusb_get_descriptor(handle, LIBUSB_DT_BOS, 0,
589	    bos_data, wTotalLength);
590	if (err < 0)
591		goto done;
592
593	/* avoid descriptor length mismatches */
594	bos_data[2] = (wTotalLength & 0xFF);
595	bos_data[3] = (wTotalLength >> 8);
596
597	err = libusb_parse_bos_descriptor(bos_data, wTotalLength, bos);
598done:
599	free(bos_data);
600	return (err);
601}
602
603int
604libusb_get_usb_2_0_extension_descriptor(struct libusb_context *ctx,
605    struct libusb_bos_dev_capability_descriptor *dev_cap,
606    struct libusb_usb_2_0_extension_descriptor **usb_2_0_extension)
607{
608	struct libusb_usb_2_0_extension_descriptor *desc;
609
610	if (dev_cap == NULL || usb_2_0_extension == NULL ||
611	    dev_cap->bDevCapabilityType != LIBUSB_BT_USB_2_0_EXTENSION)
612		return (LIBUSB_ERROR_INVALID_PARAM);
613	if (dev_cap->bLength < LIBUSB_BT_USB_2_0_EXTENSION_SIZE)
614		return (LIBUSB_ERROR_IO);
615
616	desc = malloc(sizeof(*desc));
617	if (desc == NULL)
618		return (LIBUSB_ERROR_NO_MEM);
619
620	desc->bLength = LIBUSB_BT_USB_2_0_EXTENSION_SIZE;
621	desc->bDescriptorType = dev_cap->bDescriptorType;
622	desc->bDevCapabilityType = dev_cap->bDevCapabilityType;
623	desc->bmAttributes =
624	    (dev_cap->dev_capability_data[0]) |
625	    (dev_cap->dev_capability_data[1] << 8) |
626	    (dev_cap->dev_capability_data[2] << 16) |
627	    (dev_cap->dev_capability_data[3] << 24);
628
629	*usb_2_0_extension = desc;
630	return (0);
631}
632
633void
634libusb_free_usb_2_0_extension_descriptor(
635    struct libusb_usb_2_0_extension_descriptor *usb_2_0_extension)
636{
637
638	free(usb_2_0_extension);
639}
640
641int
642libusb_get_ss_usb_device_capability_descriptor(struct libusb_context *ctx,
643    struct libusb_bos_dev_capability_descriptor *dev_cap,
644    struct libusb_ss_usb_device_capability_descriptor **ss_usb_device_capability)
645{
646	struct libusb_ss_usb_device_capability_descriptor *desc;
647
648	if (dev_cap == NULL || ss_usb_device_capability == NULL ||
649	    dev_cap->bDevCapabilityType != LIBUSB_BT_SS_USB_DEVICE_CAPABILITY)
650		return (LIBUSB_ERROR_INVALID_PARAM);
651	if (dev_cap->bLength < LIBUSB_BT_SS_USB_DEVICE_CAPABILITY_SIZE)
652		return (LIBUSB_ERROR_IO);
653
654	desc = malloc(sizeof(*desc));
655	if (desc == NULL)
656		return (LIBUSB_ERROR_NO_MEM);
657
658	desc->bLength = LIBUSB_BT_SS_USB_DEVICE_CAPABILITY_SIZE;
659	desc->bDescriptorType = dev_cap->bDescriptorType;
660	desc->bDevCapabilityType = dev_cap->bDevCapabilityType;
661	desc->bmAttributes = dev_cap->dev_capability_data[0];
662	desc->wSpeedSupported = dev_cap->dev_capability_data[1] |
663	    (dev_cap->dev_capability_data[2] << 8);
664	desc->bFunctionalitySupport = dev_cap->dev_capability_data[3];
665	desc->bU1DevExitLat = dev_cap->dev_capability_data[4];
666	desc->wU2DevExitLat = dev_cap->dev_capability_data[5] |
667	    (dev_cap->dev_capability_data[6] << 8);
668
669	*ss_usb_device_capability = desc;
670	return (0);
671}
672
673void
674libusb_free_ss_usb_device_capability_descriptor(
675    struct libusb_ss_usb_device_capability_descriptor *ss_usb_device_capability)
676{
677
678	free(ss_usb_device_capability);
679}
680
681int
682libusb_get_container_id_descriptor(struct libusb_context *ctx,
683    struct libusb_bos_dev_capability_descriptor *dev_cap,
684    struct libusb_container_id_descriptor **container_id)
685{
686	struct libusb_container_id_descriptor *desc;
687
688	if (dev_cap == NULL || container_id == NULL ||
689	    dev_cap->bDevCapabilityType != LIBUSB_BT_CONTAINER_ID)
690		return (LIBUSB_ERROR_INVALID_PARAM);
691	if (dev_cap->bLength < LIBUSB_BT_CONTAINER_ID_SIZE)
692		return (LIBUSB_ERROR_IO);
693
694	desc = malloc(sizeof(*desc));
695	if (desc == NULL)
696		return (LIBUSB_ERROR_NO_MEM);
697
698	desc->bLength = LIBUSB_BT_CONTAINER_ID_SIZE;
699	desc->bDescriptorType = dev_cap->bDescriptorType;
700	desc->bDevCapabilityType = dev_cap->bDevCapabilityType;
701	desc->bReserved = dev_cap->dev_capability_data[0];
702	memcpy(desc->ContainerID, dev_cap->dev_capability_data + 1,
703	    sizeof(desc->ContainerID));
704
705	*container_id = desc;
706	return (0);
707}
708
709void
710libusb_free_container_id_descriptor(
711    struct libusb_container_id_descriptor *container_id)
712{
713
714	free(container_id);
715}
716