projects / linux-2.6-block.git / blame
? search:
summary | shortlog | log | commit | commitdiff | tree
blob | blame (incremental) | history | HEAD
Merge remote-tracking branches 'regulator/topic/tps65218', 'regulator/topic/tps6524x...
[linux-2.6-block.git] / drivers / usb / core / config.c
CommitLineData
1da177e4 1#include <linux/usb.h>
615ae11b 2#include <linux/usb/ch9.h>
27729aad 3#include <linux/usb/hcd.h>
317149c6 4#include <linux/usb/quirks.h>
1da177e4 5#include <linux/module.h>
1da177e4
LT		 6#include <linux/slab.h>
7#include <linux/device.h>
8#include <asm/byteorder.h>
6d5e8254 9#include "usb.h"
27729aad 10
1da177e4
LT		 11
12#define USB_MAXALTSETTING 128 /* Hard limit */
13#define USB_MAXENDPOINTS 30 /* Hard limit */
14
15#define USB_MAXCONFIG 8 /* Arbitrary limit */
16
17
18static inline const char *plural(int n)
19{
20 return (n == 1 ? "" : "s");
21}
22
23static int find_next_descriptor(unsigned char *buffer, int size,
24 int dt1, int dt2, int *num_skipped)
25{
26 struct usb_descriptor_header *h;
27 int n = 0;
28 unsigned char *buffer0 = buffer;
29
30 /* Find the next descriptor of type dt1 or dt2 */
31 while (size > 0) {
32 h = (struct usb_descriptor_header *) buffer;
33 if (h->bDescriptorType == dt1 || h->bDescriptorType == dt2)
34 break;
35 buffer += h->bLength;
36 size -= h->bLength;
37 ++n;
38 }
39
40 /* Store the number of descriptors skipped and return the
41 * number of bytes skipped */
42 if (num_skipped)
43 *num_skipped = n;
44 return buffer - buffer0;
45}
46
842f1690 47static void usb_parse_ss_endpoint_companion(struct device *ddev, int cfgno,
663c30d0 48 int inum, int asnum, struct usb_host_endpoint *ep,
842f1690 49 unsigned char *buffer, int size)
663c30d0 50{
842f1690 51 struct usb_ss_ep_comp_descriptor *desc;
663c30d0 52 int max_tx;
663c30d0 53
842f1690
AS		 54 /* The SuperSpeed endpoint companion descriptor is supposed to
55 * be the first thing immediately following the endpoint descriptor.
56 */
f0058c62 57 desc = (struct usb_ss_ep_comp_descriptor *) buffer;
842f1690
AS		 58 if (desc->bDescriptorType != USB_DT_SS_ENDPOINT_COMP ||
59 size < USB_DT_SS_EP_COMP_SIZE) {
663c30d0
SS		 60 dev_warn(ddev, "No SuperSpeed endpoint companion for config %d "
61 " interface %d altsetting %d ep %d: "
62 "using minimum values\n",
63 cfgno, inum, asnum, ep->desc.bEndpointAddress);
842f1690
AS		 64
65 /* Fill in some default values.
66 * Leave bmAttributes as zero, which will mean no streams for
67 * bulk, and isoc won't support multiple bursts of packets.
68 * With bursts of only one packet, and a Mult of 1, the max
69 * amount of data moved per endpoint service interval is one
70 * packet.
663c30d0 71 */
842f1690
AS		 72 ep->ss_ep_comp.bLength = USB_DT_SS_EP_COMP_SIZE;
73 ep->ss_ep_comp.bDescriptorType = USB_DT_SS_ENDPOINT_COMP;
74 if (usb_endpoint_xfer_isoc(&ep->desc) ||
75 usb_endpoint_xfer_int(&ep->desc))
76 ep->ss_ep_comp.wBytesPerInterval =
77 ep->desc.wMaxPacketSize;
78 return;
663c30d0 79 }
663c30d0 80
842f1690 81 memcpy(&ep->ss_ep_comp, desc, USB_DT_SS_EP_COMP_SIZE);
663c30d0
SS		 82
83 /* Check the various values */
84 if (usb_endpoint_xfer_control(&ep->desc) && desc->bMaxBurst != 0) {
85 dev_warn(ddev, "Control endpoint with bMaxBurst = %d in "
86 "config %d interface %d altsetting %d ep %d: "
87 "setting to zero\n", desc->bMaxBurst,
88 cfgno, inum, asnum, ep->desc.bEndpointAddress);
842f1690
AS		 89 ep->ss_ep_comp.bMaxBurst = 0;
90 } else if (desc->bMaxBurst > 15) {
663c30d0
SS		 91 dev_warn(ddev, "Endpoint with bMaxBurst = %d in "
92 "config %d interface %d altsetting %d ep %d: "
93 "setting to 15\n", desc->bMaxBurst,
94 cfgno, inum, asnum, ep->desc.bEndpointAddress);
842f1690 95 ep->ss_ep_comp.bMaxBurst = 15;
663c30d0 96 }
842f1690
AS		 97
98 if ((usb_endpoint_xfer_control(&ep->desc) ||
99 usb_endpoint_xfer_int(&ep->desc)) &&
100 desc->bmAttributes != 0) {
663c30d0
SS		 101 dev_warn(ddev, "%s endpoint with bmAttributes = %d in "
102 "config %d interface %d altsetting %d ep %d: "
103 "setting to zero\n",
104 usb_endpoint_xfer_control(&ep->desc) ? "Control" : "Bulk",
105 desc->bmAttributes,
106 cfgno, inum, asnum, ep->desc.bEndpointAddress);
842f1690
AS		 107 ep->ss_ep_comp.bmAttributes = 0;
108 } else if (usb_endpoint_xfer_bulk(&ep->desc) &&
109 desc->bmAttributes > 16) {
663c30d0
SS		 110 dev_warn(ddev, "Bulk endpoint with more than 65536 streams in "
111 "config %d interface %d altsetting %d ep %d: "
112 "setting to max\n",
113 cfgno, inum, asnum, ep->desc.bEndpointAddress);
842f1690
AS		 114 ep->ss_ep_comp.bmAttributes = 16;
115 } else if (usb_endpoint_xfer_isoc(&ep->desc) &&
116 desc->bmAttributes > 2) {
663c30d0
SS		 117 dev_warn(ddev, "Isoc endpoint has Mult of %d in "
118 "config %d interface %d altsetting %d ep %d: "
119 "setting to 3\n", desc->bmAttributes + 1,
120 cfgno, inum, asnum, ep->desc.bEndpointAddress);
842f1690 121 ep->ss_ep_comp.bmAttributes = 2;
663c30d0 122 }
842f1690
AS		 123
124 if (usb_endpoint_xfer_isoc(&ep->desc))
7de7c7d2 125 max_tx = (desc->bMaxBurst + 1) * (desc->bmAttributes + 1) *
29cc8897 126 usb_endpoint_maxp(&ep->desc);
842f1690 127 else if (usb_endpoint_xfer_int(&ep->desc))
29cc8897 128 max_tx = usb_endpoint_maxp(&ep->desc) *
7de7c7d2 129 (desc->bMaxBurst + 1);
842f1690
AS		 130 else
131 max_tx = 999999;
64b3c304 132 if (le16_to_cpu(desc->wBytesPerInterval) > max_tx) {
663c30d0
SS		 133 dev_warn(ddev, "%s endpoint with wBytesPerInterval of %d in "
134 "config %d interface %d altsetting %d ep %d: "
135 "setting to %d\n",
136 usb_endpoint_xfer_isoc(&ep->desc) ? "Isoc" : "Int",
7de7c7d2 137 le16_to_cpu(desc->wBytesPerInterval),
663c30d0
SS		 138 cfgno, inum, asnum, ep->desc.bEndpointAddress,
139 max_tx);
7de7c7d2 140 ep->ss_ep_comp.wBytesPerInterval = cpu_to_le16(max_tx);
663c30d0 141 }
663c30d0
SS		 142}
143
1da177e4
LT		 144static int usb_parse_endpoint(struct device *ddev, int cfgno, int inum,
145 int asnum, struct usb_host_interface *ifp, int num_ep,
146 unsigned char *buffer, int size)
147{
148 unsigned char *buffer0 = buffer;
149 struct usb_endpoint_descriptor *d;
150 struct usb_host_endpoint *endpoint;
663c30d0 151 int n, i, j, retval;
1da177e4
LT		 152
153 d = (struct usb_endpoint_descriptor *) buffer;
154 buffer += d->bLength;
155 size -= d->bLength;
156
157 if (d->bLength >= USB_DT_ENDPOINT_AUDIO_SIZE)
158 n = USB_DT_ENDPOINT_AUDIO_SIZE;
159 else if (d->bLength >= USB_DT_ENDPOINT_SIZE)
160 n = USB_DT_ENDPOINT_SIZE;
161 else {
162 dev_warn(ddev, "config %d interface %d altsetting %d has an "
163 "invalid endpoint descriptor of length %d, skipping\n",
164 cfgno, inum, asnum, d->bLength);
165 goto skip_to_next_endpoint_or_interface_descriptor;
166 }
167
168 i = d->bEndpointAddress & ~USB_ENDPOINT_DIR_MASK;
169 if (i >= 16 || i == 0) {
170 dev_warn(ddev, "config %d interface %d altsetting %d has an "
171 "invalid endpoint with address 0x%X, skipping\n",
172 cfgno, inum, asnum, d->bEndpointAddress);
173 goto skip_to_next_endpoint_or_interface_descriptor;
174 }
175
176 /* Only store as many endpoints as we have room for */
177 if (ifp->desc.bNumEndpoints >= num_ep)
178 goto skip_to_next_endpoint_or_interface_descriptor;
179
180 endpoint = &ifp->endpoint[ifp->desc.bNumEndpoints];
181 ++ifp->desc.bNumEndpoints;
182
183 memcpy(&endpoint->desc, d, n);
184 INIT_LIST_HEAD(&endpoint->urb_list);
185
300871cd
LP		 186 /* Fix up bInterval values outside the legal range. Use 32 ms if no
187 * proper value can be guessed. */
615ae11b
AS		 188 i = 0; /* i = min, j = max, n = default */
189 j = 255;
190 if (usb_endpoint_xfer_int(d)) {
191 i = 1;
192 switch (to_usb_device(ddev)->speed) {
6b403b02 193 case USB_SPEED_SUPER:
615ae11b 194 case USB_SPEED_HIGH:
300871cd
LP		 195 /* Many device manufacturers are using full-speed
196 * bInterval values in high-speed interrupt endpoint
197 * descriptors. Try to fix those and fall back to a
198 * 32 ms default value otherwise. */
199 n = fls(d->bInterval*8);
200 if (n == 0)
201 n = 9; /* 32 ms = 2^(9-1) uframes */
615ae11b
AS		 202 j = 16;
203 break;
204 default: /* USB_SPEED_FULL or _LOW */
205 /* For low-speed, 10 ms is the official minimum.
206 * But some "overclocked" devices might want faster
207 * polling so we'll allow it. */
208 n = 32;
209 break;
210 }
211 } else if (usb_endpoint_xfer_isoc(d)) {
212 i = 1;
213 j = 16;
214 switch (to_usb_device(ddev)->speed) {
215 case USB_SPEED_HIGH:
216 n = 9; /* 32 ms = 2^(9-1) uframes */
217 break;
218 default: /* USB_SPEED_FULL */
219 n = 6; /* 32 ms = 2^(6-1) frames */
220 break;
221 }
222 }
223 if (d->bInterval < i || d->bInterval > j) {
224 dev_warn(ddev, "config %d interface %d altsetting %d "
225 "endpoint 0x%X has an invalid bInterval %d, "
226 "changing to %d\n",
227 cfgno, inum, asnum,
228 d->bEndpointAddress, d->bInterval, n);
229 endpoint->desc.bInterval = n;
230 }
231
60aac1ec
AS		 232 /* Some buggy low-speed devices have Bulk endpoints, which is
233 * explicitly forbidden by the USB spec. In an attempt to make
234 * them usable, we will try treating them as Interrupt endpoints.
235 */
236 if (to_usb_device(ddev)->speed == USB_SPEED_LOW &&
237 usb_endpoint_xfer_bulk(d)) {
238 dev_warn(ddev, "config %d interface %d altsetting %d "
239 "endpoint 0x%X is Bulk; changing to Interrupt\n",
240 cfgno, inum, asnum, d->bEndpointAddress);
241 endpoint->desc.bmAttributes = USB_ENDPOINT_XFER_INT;
242 endpoint->desc.bInterval = 1;
29cc8897 243 if (usb_endpoint_maxp(&endpoint->desc) > 8)
60aac1ec
AS		 244 endpoint->desc.wMaxPacketSize = cpu_to_le16(8);
245 }
246
caa9ef67
DB		 247 /*
248 * Some buggy high speed devices have bulk endpoints using
249 * maxpacket sizes other than 512. High speed HCDs may not
250 * be able to handle that particular bug, so let's warn...
251 */
252 if (to_usb_device(ddev)->speed == USB_SPEED_HIGH
253 && usb_endpoint_xfer_bulk(d)) {
254 unsigned maxp;
255
29cc8897 256 maxp = usb_endpoint_maxp(&endpoint->desc) & 0x07ff;
caa9ef67
DB		 257 if (maxp != 512)
258 dev_warn(ddev, "config %d interface %d altsetting %d "
259 "bulk endpoint 0x%X has invalid maxpacket %d\n",
260 cfgno, inum, asnum, d->bEndpointAddress,
261 maxp);
262 }
663c30d0 263
842f1690
AS		 264 /* Parse a possible SuperSpeed endpoint companion descriptor */
265 if (to_usb_device(ddev)->speed == USB_SPEED_SUPER)
266 usb_parse_ss_endpoint_companion(ddev, cfgno,
267 inum, asnum, endpoint, buffer, size);
9f8e4438 268
842f1690
AS		 269 /* Skip over any Class Specific or Vendor Specific descriptors;
270 * find the next endpoint or interface descriptor */
271 endpoint->extra = buffer;
272 i = find_next_descriptor(buffer, size, USB_DT_ENDPOINT,
273 USB_DT_INTERFACE, &n);
274 endpoint->extralen = i;
275 retval = buffer - buffer0 + i;
1da177e4
LT		 276 if (n > 0)
277 dev_dbg(ddev, "skipped %d descriptor%s after %s\n",
278 n, plural(n), "endpoint");
663c30d0 279 return retval;
1da177e4
LT		 280
281skip_to_next_endpoint_or_interface_descriptor:
282 i = find_next_descriptor(buffer, size, USB_DT_ENDPOINT,
283 USB_DT_INTERFACE, NULL);
284 return buffer - buffer0 + i;
285}
286
287void usb_release_interface_cache(struct kref *ref)
288{
289 struct usb_interface_cache *intfc = ref_to_usb_interface_cache(ref);
290 int j;
291
4f62efe6
AS		 292 for (j = 0; j < intfc->num_altsetting; j++) {
293 struct usb_host_interface *alt = &intfc->altsetting[j];
294
295 kfree(alt->endpoint);
296 kfree(alt->string);
297 }
1da177e4
LT		 298 kfree(intfc);
299}
300
301static int usb_parse_interface(struct device *ddev, int cfgno,
302 struct usb_host_config *config, unsigned char *buffer, int size,
303 u8 inums[], u8 nalts[])
304{
305 unsigned char *buffer0 = buffer;
306 struct usb_interface_descriptor *d;
307 int inum, asnum;
308 struct usb_interface_cache *intfc;
309 struct usb_host_interface *alt;
310 int i, n;
311 int len, retval;
312 int num_ep, num_ep_orig;
313
314 d = (struct usb_interface_descriptor *) buffer;
315 buffer += d->bLength;
316 size -= d->bLength;
317
318 if (d->bLength < USB_DT_INTERFACE_SIZE)
319 goto skip_to_next_interface_descriptor;
320
321 /* Which interface entry is this? */
322 intfc = NULL;
323 inum = d->bInterfaceNumber;
324 for (i = 0; i < config->desc.bNumInterfaces; ++i) {
325 if (inums[i] == inum) {
326 intfc = config->intf_cache[i];
327 break;
328 }
329 }
330 if (!intfc || intfc->num_altsetting >= nalts[i])
331 goto skip_to_next_interface_descriptor;
332
333 /* Check for duplicate altsetting entries */
334 asnum = d->bAlternateSetting;
335 for ((i = 0, alt = &intfc->altsetting[0]);
336 i < intfc->num_altsetting;
337 (++i, ++alt)) {
338 if (alt->desc.bAlternateSetting == asnum) {
339 dev_warn(ddev, "Duplicate descriptor for config %d "
340 "interface %d altsetting %d, skipping\n",
341 cfgno, inum, asnum);
342 goto skip_to_next_interface_descriptor;
343 }
344 }
345
346 ++intfc->num_altsetting;
347 memcpy(&alt->desc, d, USB_DT_INTERFACE_SIZE);
348
349 /* Skip over any Class Specific or Vendor Specific descriptors;
350 * find the first endpoint or interface descriptor */
351 alt->extra = buffer;
352 i = find_next_descriptor(buffer, size, USB_DT_ENDPOINT,
353 USB_DT_INTERFACE, &n);
354 alt->extralen = i;
355 if (n > 0)
356 dev_dbg(ddev, "skipped %d descriptor%s after %s\n",
357 n, plural(n), "interface");
358 buffer += i;
359 size -= i;
360
361 /* Allocate space for the right(?) number of endpoints */
362 num_ep = num_ep_orig = alt->desc.bNumEndpoints;
2c044a48 363 alt->desc.bNumEndpoints = 0; /* Use as a counter */
1da177e4
LT		 364 if (num_ep > USB_MAXENDPOINTS) {
365 dev_warn(ddev, "too many endpoints for config %d interface %d "
366 "altsetting %d: %d, using maximum allowed: %d\n",
367 cfgno, inum, asnum, num_ep, USB_MAXENDPOINTS);
368 num_ep = USB_MAXENDPOINTS;
369 }
370
2c044a48
GKH		 371 if (num_ep > 0) {
372 /* Can't allocate 0 bytes */
57a21c1b
AS		 373 len = sizeof(struct usb_host_endpoint) * num_ep;
374 alt->endpoint = kzalloc(len, GFP_KERNEL);
375 if (!alt->endpoint)
376 return -ENOMEM;
377 }
1da177e4
LT		 378
379 /* Parse all the endpoint descriptors */
380 n = 0;
381 while (size > 0) {
382 if (((struct usb_descriptor_header *) buffer)->bDescriptorType
383 == USB_DT_INTERFACE)
384 break;
385 retval = usb_parse_endpoint(ddev, cfgno, inum, asnum, alt,
386 num_ep, buffer, size);
387 if (retval < 0)
388 return retval;
389 ++n;
390
391 buffer += retval;
392 size -= retval;
393 }
394
395 if (n != num_ep_orig)
396 dev_warn(ddev, "config %d interface %d altsetting %d has %d "
397 "endpoint descriptor%s, different from the interface "
398 "descriptor's value: %d\n",
399 cfgno, inum, asnum, n, plural(n), num_ep_orig);
400 return buffer - buffer0;
401
402skip_to_next_interface_descriptor:
403 i = find_next_descriptor(buffer, size, USB_DT_INTERFACE,
404 USB_DT_INTERFACE, NULL);
405 return buffer - buffer0 + i;
406}
407
317149c6 408static int usb_parse_configuration(struct usb_device *dev, int cfgidx,
1da177e4
LT		 409 struct usb_host_config *config, unsigned char *buffer, int size)
410{
317149c6 411 struct device *ddev = &dev->dev;
1da177e4
LT		 412 unsigned char *buffer0 = buffer;
413 int cfgno;
414 int nintf, nintf_orig;
415 int i, j, n;
416 struct usb_interface_cache *intfc;
417 unsigned char *buffer2;
418 int size2;
419 struct usb_descriptor_header *header;
420 int len, retval;
421 u8 inums[USB_MAXINTERFACES], nalts[USB_MAXINTERFACES];
165fe97e 422 unsigned iad_num = 0;
1da177e4
LT		 423
424 memcpy(&config->desc, buffer, USB_DT_CONFIG_SIZE);
425 if (config->desc.bDescriptorType != USB_DT_CONFIG ||
b4f17a48
HG		 426 config->desc.bLength < USB_DT_CONFIG_SIZE ||
427 config->desc.bLength > size) {
1da177e4
LT		 428 dev_err(ddev, "invalid descriptor for config index %d: "
429 "type = 0x%X, length = %d\n", cfgidx,
430 config->desc.bDescriptorType, config->desc.bLength);
431 return -EINVAL;
432 }
433 cfgno = config->desc.bConfigurationValue;
434
435 buffer += config->desc.bLength;
436 size -= config->desc.bLength;
437
438 nintf = nintf_orig = config->desc.bNumInterfaces;
439 if (nintf > USB_MAXINTERFACES) {
440 dev_warn(ddev, "config %d has too many interfaces: %d, "
441 "using maximum allowed: %d\n",
442 cfgno, nintf, USB_MAXINTERFACES);
443 nintf = USB_MAXINTERFACES;
444 }
445
446 /* Go through the descriptors, checking their length and counting the
447 * number of altsettings for each interface */
448 n = 0;
449 for ((buffer2 = buffer, size2 = size);
450 size2 > 0;
451 (buffer2 += header->bLength, size2 -= header->bLength)) {
452
453 if (size2 < sizeof(struct usb_descriptor_header)) {
454 dev_warn(ddev, "config %d descriptor has %d excess "
455 "byte%s, ignoring\n",
456 cfgno, size2, plural(size2));
457 break;
458 }
459
460 header = (struct usb_descriptor_header *) buffer2;
461 if ((header->bLength > size2) || (header->bLength < 2)) {
462 dev_warn(ddev, "config %d has an invalid descriptor "
463 "of length %d, skipping remainder of the config\n",
464 cfgno, header->bLength);
465 break;
466 }
467
468 if (header->bDescriptorType == USB_DT_INTERFACE) {
469 struct usb_interface_descriptor *d;
470 int inum;
471
472 d = (struct usb_interface_descriptor *) header;
473 if (d->bLength < USB_DT_INTERFACE_SIZE) {
474 dev_warn(ddev, "config %d has an invalid "
475 "interface descriptor of length %d, "
476 "skipping\n", cfgno, d->bLength);
477 continue;
478 }
479
480 inum = d->bInterfaceNumber;
317149c6
HG		 481
482 if ((dev->quirks & USB_QUIRK_HONOR_BNUMINTERFACES) &&
483 n >= nintf_orig) {
484 dev_warn(ddev, "config %d has more interface "
485 "descriptors, than it declares in "
486 "bNumInterfaces, ignoring interface "
487 "number: %d\n", cfgno, inum);
488 continue;
489 }
490
1da177e4
LT		 491 if (inum >= nintf_orig)
492 dev_warn(ddev, "config %d has an invalid "
493 "interface number: %d but max is %d\n",
494 cfgno, inum, nintf_orig - 1);
495
496 /* Have we already encountered this interface?
497 * Count its altsettings */
498 for (i = 0; i < n; ++i) {
499 if (inums[i] == inum)
500 break;
501 }
502 if (i < n) {
503 if (nalts[i] < 255)
504 ++nalts[i];
505 } else if (n < USB_MAXINTERFACES) {
506 inums[n] = inum;
507 nalts[n] = 1;
508 ++n;
509 }
510
165fe97e
CN		 511 } else if (header->bDescriptorType ==
512 USB_DT_INTERFACE_ASSOCIATION) {
513 if (iad_num == USB_MAXIADS) {
514 dev_warn(ddev, "found more Interface "
515 "Association Descriptors "
516 "than allocated for in "
517 "configuration %d\n", cfgno);
518 } else {
519 config->intf_assoc[iad_num] =
520 (struct usb_interface_assoc_descriptor
521 *)header;
522 iad_num++;
523 }
524
1da177e4
LT		 525 } else if (header->bDescriptorType == USB_DT_DEVICE ||
526 header->bDescriptorType == USB_DT_CONFIG)
527 dev_warn(ddev, "config %d contains an unexpected "
528 "descriptor of type 0x%X, skipping\n",
529 cfgno, header->bDescriptorType);
530
531 } /* for ((buffer2 = buffer, size2 = size); ...) */
532 size = buffer2 - buffer;
533 config->desc.wTotalLength = cpu_to_le16(buffer2 - buffer0);
534
535 if (n != nintf)
536 dev_warn(ddev, "config %d has %d interface%s, different from "
537 "the descriptor's value: %d\n",
538 cfgno, n, plural(n), nintf_orig);
539 else if (n == 0)
540 dev_warn(ddev, "config %d has no interfaces?\n", cfgno);
541 config->desc.bNumInterfaces = nintf = n;
542
543 /* Check for missing interface numbers */
544 for (i = 0; i < nintf; ++i) {
545 for (j = 0; j < nintf; ++j) {
546 if (inums[j] == i)
547 break;
548 }
549 if (j >= nintf)
550 dev_warn(ddev, "config %d has no interface number "
551 "%d\n", cfgno, i);
552 }
553
554 /* Allocate the usb_interface_caches and altsetting arrays */
555 for (i = 0; i < nintf; ++i) {
556 j = nalts[i];
557 if (j > USB_MAXALTSETTING) {
558 dev_warn(ddev, "too many alternate settings for "
559 "config %d interface %d: %d, "
560 "using maximum allowed: %d\n",
561 cfgno, inums[i], j, USB_MAXALTSETTING);
562 nalts[i] = j = USB_MAXALTSETTING;
563 }
564
565 len = sizeof(*intfc) + sizeof(struct usb_host_interface) * j;
0a1ef3b5 566 config->intf_cache[i] = intfc = kzalloc(len, GFP_KERNEL);
1da177e4
LT		 567 if (!intfc)
568 return -ENOMEM;
1da177e4
LT		 569 kref_init(&intfc->ref);
570 }
571
663c30d0
SS		 572 /* FIXME: parse the BOS descriptor */
573
1da177e4
LT		 574 /* Skip over any Class Specific or Vendor Specific descriptors;
575 * find the first interface descriptor */
576 config->extra = buffer;
577 i = find_next_descriptor(buffer, size, USB_DT_INTERFACE,
578 USB_DT_INTERFACE, &n);
579 config->extralen = i;
580 if (n > 0)
581 dev_dbg(ddev, "skipped %d descriptor%s after %s\n",
582 n, plural(n), "configuration");
583 buffer += i;
584 size -= i;
585
586 /* Parse all the interface/altsetting descriptors */
587 while (size > 0) {
588 retval = usb_parse_interface(ddev, cfgno, config,
589 buffer, size, inums, nalts);
590 if (retval < 0)
591 return retval;
592
593 buffer += retval;
594 size -= retval;
595 }
596
597 /* Check for missing altsettings */
598 for (i = 0; i < nintf; ++i) {
599 intfc = config->intf_cache[i];
600 for (j = 0; j < intfc->num_altsetting; ++j) {
601 for (n = 0; n < intfc->num_altsetting; ++n) {
602 if (intfc->altsetting[n].desc.
603 bAlternateSetting == j)
604 break;
605 }
606 if (n >= intfc->num_altsetting)
607 dev_warn(ddev, "config %d interface %d has no "
608 "altsetting %d\n", cfgno, inums[i], j);
609 }
610 }
611
612 return 0;
613}
614
2c044a48
GKH		 615/* hub-only!! ... and only exported for reset/reinit path.
616 * otherwise used internally on disconnect/destroy path
617 */
1da177e4
LT		 618void usb_destroy_configuration(struct usb_device *dev)
619{
620 int c, i;
621
622 if (!dev->config)
623 return;
624
625 if (dev->rawdescriptors) {
626 for (i = 0; i < dev->descriptor.bNumConfigurations; i++)
627 kfree(dev->rawdescriptors[i]);
628
629 kfree(dev->rawdescriptors);
630 dev->rawdescriptors = NULL;
631 }
632
633 for (c = 0; c < dev->descriptor.bNumConfigurations; c++) {
634 struct usb_host_config *cf = &dev->config[c];
635
636 kfree(cf->string);
1da177e4
LT		 637 for (i = 0; i < cf->desc.bNumInterfaces; i++) {
638 if (cf->intf_cache[i])
2c044a48 639 kref_put(&cf->intf_cache[i]->ref,
1da177e4
LT		 640 usb_release_interface_cache);
641 }
642 }
643 kfree(dev->config);
644 dev->config = NULL;
645}
646
647
1145065c
IPG		 648/*
649 * Get the USB config descriptors, cache and parse'em
650 *
651 * hub-only!! ... and only in reset path, or usb_new_device()
652 * (used by real hubs and virtual root hubs)
1145065c 653 */
1da177e4
LT		 654int usb_get_configuration(struct usb_device *dev)
655{
656 struct device *ddev = &dev->dev;
657 int ncfg = dev->descriptor.bNumConfigurations;
1145065c 658 int result = 0;
1da177e4 659 unsigned int cfgno, length;
1da177e4 660 unsigned char *bigbuffer;
2c044a48 661 struct usb_config_descriptor *desc;
1da177e4 662
1145065c 663 cfgno = 0;
1145065c 664 result = -ENOMEM;
1da177e4
LT		 665 if (ncfg > USB_MAXCONFIG) {
666 dev_warn(ddev, "too many configurations: %d, "
667 "using maximum allowed: %d\n", ncfg, USB_MAXCONFIG);
668 dev->descriptor.bNumConfigurations = ncfg = USB_MAXCONFIG;
669 }
670
671 if (ncfg < 1) {
672 dev_err(ddev, "no configurations\n");
673 return -EINVAL;
674 }
675
676 length = ncfg * sizeof(struct usb_host_config);
0a1ef3b5 677 dev->config = kzalloc(length, GFP_KERNEL);
1da177e4
LT		 678 if (!dev->config)
679 goto err2;
1da177e4
LT		 680
681 length = ncfg * sizeof(char *);
0a1ef3b5 682 dev->rawdescriptors = kzalloc(length, GFP_KERNEL);
1da177e4
LT		 683 if (!dev->rawdescriptors)
684 goto err2;
1da177e4 685
e8f4af30
MN		 686 desc = kmalloc(USB_DT_CONFIG_SIZE, GFP_KERNEL);
687 if (!desc)
1da177e4 688 goto err2;
1da177e4 689
1145065c
IPG		 690 result = 0;
691 for (; cfgno < ncfg; cfgno++) {
1da177e4
LT		 692 /* We grab just the first descriptor so we know how long
693 * the whole configuration is */
694 result = usb_get_descriptor(dev, USB_DT_CONFIG, cfgno,
e8f4af30 695 desc, USB_DT_CONFIG_SIZE);
1da177e4
LT		 696 if (result < 0) {
697 dev_err(ddev, "unable to read config index %d "
1145065c 698 "descriptor/%s: %d\n", cfgno, "start", result);
3a22b872
LT		 699 if (result != -EPIPE)
700 goto err;
cb4c8fe5
IPG		 701 dev_err(ddev, "chopping to %d config(s)\n", cfgno);
702 dev->descriptor.bNumConfigurations = cfgno;
703 break;
1da177e4
LT		 704 } else if (result < 4) {
705 dev_err(ddev, "config index %d descriptor too short "
706 "(expected %i, got %i)\n", cfgno,
707 USB_DT_CONFIG_SIZE, result);
708 result = -EINVAL;
709 goto err;
710 }
711 length = max((int) le16_to_cpu(desc->wTotalLength),
712 USB_DT_CONFIG_SIZE);
713
714 /* Now that we know the length, get the whole thing */
715 bigbuffer = kmalloc(length, GFP_KERNEL);
716 if (!bigbuffer) {
717 result = -ENOMEM;
718 goto err;
719 }
d86db25e
JW		 720
721 if (dev->quirks & USB_QUIRK_DELAY_INIT)
722 msleep(100);
723
1da177e4
LT		 724 result = usb_get_descriptor(dev, USB_DT_CONFIG, cfgno,
725 bigbuffer, length);
726 if (result < 0) {
727 dev_err(ddev, "unable to read config index %d "
728 "descriptor/%s\n", cfgno, "all");
729 kfree(bigbuffer);
730 goto err;
731 }
732 if (result < length) {
733 dev_warn(ddev, "config index %d descriptor too short "
734 "(expected %i, got %i)\n", cfgno, length, result);
735 length = result;
736 }
737
738 dev->rawdescriptors[cfgno] = bigbuffer;
739
317149c6 740 result = usb_parse_configuration(dev, cfgno,
1da177e4
LT		 741 &dev->config[cfgno], bigbuffer, length);
742 if (result < 0) {
743 ++cfgno;
744 goto err;
745 }
746 }
747 result = 0;
748
749err:
e8f4af30 750 kfree(desc);
1da177e4
LT		 751 dev->descriptor.bNumConfigurations = cfgno;
752err2:
753 if (result == -ENOMEM)
754 dev_err(ddev, "out of memory\n");
755 return result;
756}
3148bf04
AX		 757
758void usb_release_bos_descriptor(struct usb_device *dev)
759{
760 if (dev->bos) {
761 kfree(dev->bos->desc);
762 kfree(dev->bos);
763 dev->bos = NULL;
764 }
765}
766
767/* Get BOS descriptor set */
768int usb_get_bos_descriptor(struct usb_device *dev)
769{
770 struct device *ddev = &dev->dev;
771 struct usb_bos_descriptor *bos;
772 struct usb_dev_cap_header *cap;
773 unsigned char *buffer;
774 int length, total_len, num, i;
775 int ret;
776
777 bos = kzalloc(sizeof(struct usb_bos_descriptor), GFP_KERNEL);
778 if (!bos)
779 return -ENOMEM;
780
781 /* Get BOS descriptor */
782 ret = usb_get_descriptor(dev, USB_DT_BOS, 0, bos, USB_DT_BOS_SIZE);
783 if (ret < USB_DT_BOS_SIZE) {
784 dev_err(ddev, "unable to get BOS descriptor\n");
785 if (ret >= 0)
786 ret = -ENOMSG;
787 kfree(bos);
788 return ret;
789 }
790
791 length = bos->bLength;
792 total_len = le16_to_cpu(bos->wTotalLength);
793 num = bos->bNumDeviceCaps;
794 kfree(bos);
795 if (total_len < length)
796 return -EINVAL;
797
798 dev->bos = kzalloc(sizeof(struct usb_host_bos), GFP_KERNEL);
799 if (!dev->bos)
800 return -ENOMEM;
801
802 /* Now let's get the whole BOS descriptor set */
803 buffer = kzalloc(total_len, GFP_KERNEL);
804 if (!buffer) {
805 ret = -ENOMEM;
806 goto err;
807 }
808 dev->bos->desc = (struct usb_bos_descriptor *)buffer;
809
810 ret = usb_get_descriptor(dev, USB_DT_BOS, 0, buffer, total_len);
811 if (ret < total_len) {
812 dev_err(ddev, "unable to get BOS descriptor set\n");
813 if (ret >= 0)
814 ret = -ENOMSG;
815 goto err;
816 }
817 total_len -= length;
818
819 for (i = 0; i < num; i++) {
820 buffer += length;
821 cap = (struct usb_dev_cap_header *)buffer;
822 length = cap->bLength;
823
824 if (total_len < length)
825 break;
826 total_len -= length;
827
828 if (cap->bDescriptorType != USB_DT_DEVICE_CAPABILITY) {
829 dev_warn(ddev, "descriptor type invalid, skip\n");
830 continue;
831 }
832
833 switch (cap->bDevCapabilityType) {
834 case USB_CAP_TYPE_WIRELESS_USB:
835 /* Wireless USB cap descriptor is handled by wusb */
836 break;
837 case USB_CAP_TYPE_EXT:
838 dev->bos->ext_cap =
839 (struct usb_ext_cap_descriptor *)buffer;
840 break;
841 case USB_SS_CAP_TYPE:
842 dev->bos->ss_cap =
843 (struct usb_ss_cap_descriptor *)buffer;
844 break;
845 case CONTAINER_ID_TYPE:
846 dev->bos->ss_id =
847 (struct usb_ss_container_id_descriptor *)buffer;
848 break;
849 default:
850 break;
851 }
852 }
853
854 return 0;
855
856err:
857 usb_release_bos_descriptor(dev);
858 return ret;
859}
Linux 6.x block layer and io_uring tree(s)