Loading...
1/*
2 * drivers/usb/core/sysfs.c
3 *
4 * (C) Copyright 2002 David Brownell
5 * (C) Copyright 2002,2004 Greg Kroah-Hartman
6 * (C) Copyright 2002,2004 IBM Corp.
7 *
8 * All of the sysfs file attributes for usb devices and interfaces.
9 *
10 */
11
12
13#include <linux/kernel.h>
14#include <linux/string.h>
15#include <linux/usb.h>
16#include <linux/usb/quirks.h>
17#include "usb.h"
18
19/* Active configuration fields */
20#define usb_actconfig_show(field, format_string) \
21static ssize_t field##_show(struct device *dev, \
22 struct device_attribute *attr, char *buf) \
23{ \
24 struct usb_device *udev; \
25 struct usb_host_config *actconfig; \
26 ssize_t rc; \
27 \
28 udev = to_usb_device(dev); \
29 rc = usb_lock_device_interruptible(udev); \
30 if (rc < 0) \
31 return -EINTR; \
32 actconfig = udev->actconfig; \
33 if (actconfig) \
34 rc = sprintf(buf, format_string, \
35 actconfig->desc.field); \
36 usb_unlock_device(udev); \
37 return rc; \
38} \
39
40#define usb_actconfig_attr(field, format_string) \
41 usb_actconfig_show(field, format_string) \
42 static DEVICE_ATTR_RO(field)
43
44usb_actconfig_attr(bNumInterfaces, "%2d\n");
45usb_actconfig_attr(bmAttributes, "%2x\n");
46
47static ssize_t bMaxPower_show(struct device *dev,
48 struct device_attribute *attr, char *buf)
49{
50 struct usb_device *udev;
51 struct usb_host_config *actconfig;
52 ssize_t rc;
53
54 udev = to_usb_device(dev);
55 rc = usb_lock_device_interruptible(udev);
56 if (rc < 0)
57 return -EINTR;
58 actconfig = udev->actconfig;
59 if (actconfig)
60 rc = sprintf(buf, "%dmA\n", usb_get_max_power(udev, actconfig));
61 usb_unlock_device(udev);
62 return rc;
63}
64static DEVICE_ATTR_RO(bMaxPower);
65
66static ssize_t configuration_show(struct device *dev,
67 struct device_attribute *attr, char *buf)
68{
69 struct usb_device *udev;
70 struct usb_host_config *actconfig;
71 ssize_t rc;
72
73 udev = to_usb_device(dev);
74 rc = usb_lock_device_interruptible(udev);
75 if (rc < 0)
76 return -EINTR;
77 actconfig = udev->actconfig;
78 if (actconfig && actconfig->string)
79 rc = sprintf(buf, "%s\n", actconfig->string);
80 usb_unlock_device(udev);
81 return rc;
82}
83static DEVICE_ATTR_RO(configuration);
84
85/* configuration value is always present, and r/w */
86usb_actconfig_show(bConfigurationValue, "%u\n");
87
88static ssize_t bConfigurationValue_store(struct device *dev,
89 struct device_attribute *attr,
90 const char *buf, size_t count)
91{
92 struct usb_device *udev = to_usb_device(dev);
93 int config, value, rc;
94
95 if (sscanf(buf, "%d", &config) != 1 || config < -1 || config > 255)
96 return -EINVAL;
97 rc = usb_lock_device_interruptible(udev);
98 if (rc < 0)
99 return -EINTR;
100 value = usb_set_configuration(udev, config);
101 usb_unlock_device(udev);
102 return (value < 0) ? value : count;
103}
104static DEVICE_ATTR_IGNORE_LOCKDEP(bConfigurationValue, S_IRUGO | S_IWUSR,
105 bConfigurationValue_show, bConfigurationValue_store);
106
107/* String fields */
108#define usb_string_attr(name) \
109static ssize_t name##_show(struct device *dev, \
110 struct device_attribute *attr, char *buf) \
111{ \
112 struct usb_device *udev; \
113 int retval; \
114 \
115 udev = to_usb_device(dev); \
116 retval = usb_lock_device_interruptible(udev); \
117 if (retval < 0) \
118 return -EINTR; \
119 retval = sprintf(buf, "%s\n", udev->name); \
120 usb_unlock_device(udev); \
121 return retval; \
122} \
123static DEVICE_ATTR_RO(name)
124
125usb_string_attr(product);
126usb_string_attr(manufacturer);
127usb_string_attr(serial);
128
129static ssize_t speed_show(struct device *dev, struct device_attribute *attr,
130 char *buf)
131{
132 struct usb_device *udev;
133 char *speed;
134
135 udev = to_usb_device(dev);
136
137 switch (udev->speed) {
138 case USB_SPEED_LOW:
139 speed = "1.5";
140 break;
141 case USB_SPEED_UNKNOWN:
142 case USB_SPEED_FULL:
143 speed = "12";
144 break;
145 case USB_SPEED_HIGH:
146 speed = "480";
147 break;
148 case USB_SPEED_WIRELESS:
149 speed = "480";
150 break;
151 case USB_SPEED_SUPER:
152 speed = "5000";
153 break;
154 case USB_SPEED_SUPER_PLUS:
155 speed = "10000";
156 break;
157 default:
158 speed = "unknown";
159 }
160 return sprintf(buf, "%s\n", speed);
161}
162static DEVICE_ATTR_RO(speed);
163
164static ssize_t busnum_show(struct device *dev, struct device_attribute *attr,
165 char *buf)
166{
167 struct usb_device *udev;
168
169 udev = to_usb_device(dev);
170 return sprintf(buf, "%d\n", udev->bus->busnum);
171}
172static DEVICE_ATTR_RO(busnum);
173
174static ssize_t devnum_show(struct device *dev, struct device_attribute *attr,
175 char *buf)
176{
177 struct usb_device *udev;
178
179 udev = to_usb_device(dev);
180 return sprintf(buf, "%d\n", udev->devnum);
181}
182static DEVICE_ATTR_RO(devnum);
183
184static ssize_t devpath_show(struct device *dev, struct device_attribute *attr,
185 char *buf)
186{
187 struct usb_device *udev;
188
189 udev = to_usb_device(dev);
190 return sprintf(buf, "%s\n", udev->devpath);
191}
192static DEVICE_ATTR_RO(devpath);
193
194static ssize_t version_show(struct device *dev, struct device_attribute *attr,
195 char *buf)
196{
197 struct usb_device *udev;
198 u16 bcdUSB;
199
200 udev = to_usb_device(dev);
201 bcdUSB = le16_to_cpu(udev->descriptor.bcdUSB);
202 return sprintf(buf, "%2x.%02x\n", bcdUSB >> 8, bcdUSB & 0xff);
203}
204static DEVICE_ATTR_RO(version);
205
206static ssize_t maxchild_show(struct device *dev, struct device_attribute *attr,
207 char *buf)
208{
209 struct usb_device *udev;
210
211 udev = to_usb_device(dev);
212 return sprintf(buf, "%d\n", udev->maxchild);
213}
214static DEVICE_ATTR_RO(maxchild);
215
216static ssize_t quirks_show(struct device *dev, struct device_attribute *attr,
217 char *buf)
218{
219 struct usb_device *udev;
220
221 udev = to_usb_device(dev);
222 return sprintf(buf, "0x%x\n", udev->quirks);
223}
224static DEVICE_ATTR_RO(quirks);
225
226static ssize_t avoid_reset_quirk_show(struct device *dev,
227 struct device_attribute *attr, char *buf)
228{
229 struct usb_device *udev;
230
231 udev = to_usb_device(dev);
232 return sprintf(buf, "%d\n", !!(udev->quirks & USB_QUIRK_RESET));
233}
234
235static ssize_t avoid_reset_quirk_store(struct device *dev,
236 struct device_attribute *attr,
237 const char *buf, size_t count)
238{
239 struct usb_device *udev = to_usb_device(dev);
240 int val, rc;
241
242 if (sscanf(buf, "%d", &val) != 1 || val < 0 || val > 1)
243 return -EINVAL;
244 rc = usb_lock_device_interruptible(udev);
245 if (rc < 0)
246 return -EINTR;
247 if (val)
248 udev->quirks |= USB_QUIRK_RESET;
249 else
250 udev->quirks &= ~USB_QUIRK_RESET;
251 usb_unlock_device(udev);
252 return count;
253}
254static DEVICE_ATTR_RW(avoid_reset_quirk);
255
256static ssize_t urbnum_show(struct device *dev, struct device_attribute *attr,
257 char *buf)
258{
259 struct usb_device *udev;
260
261 udev = to_usb_device(dev);
262 return sprintf(buf, "%d\n", atomic_read(&udev->urbnum));
263}
264static DEVICE_ATTR_RO(urbnum);
265
266static ssize_t removable_show(struct device *dev, struct device_attribute *attr,
267 char *buf)
268{
269 struct usb_device *udev;
270 char *state;
271
272 udev = to_usb_device(dev);
273
274 switch (udev->removable) {
275 case USB_DEVICE_REMOVABLE:
276 state = "removable";
277 break;
278 case USB_DEVICE_FIXED:
279 state = "fixed";
280 break;
281 default:
282 state = "unknown";
283 }
284
285 return sprintf(buf, "%s\n", state);
286}
287static DEVICE_ATTR_RO(removable);
288
289static ssize_t ltm_capable_show(struct device *dev,
290 struct device_attribute *attr, char *buf)
291{
292 if (usb_device_supports_ltm(to_usb_device(dev)))
293 return sprintf(buf, "%s\n", "yes");
294 return sprintf(buf, "%s\n", "no");
295}
296static DEVICE_ATTR_RO(ltm_capable);
297
298#ifdef CONFIG_PM
299
300static ssize_t persist_show(struct device *dev, struct device_attribute *attr,
301 char *buf)
302{
303 struct usb_device *udev = to_usb_device(dev);
304
305 return sprintf(buf, "%d\n", udev->persist_enabled);
306}
307
308static ssize_t persist_store(struct device *dev, struct device_attribute *attr,
309 const char *buf, size_t count)
310{
311 struct usb_device *udev = to_usb_device(dev);
312 int value, rc;
313
314 /* Hubs are always enabled for USB_PERSIST */
315 if (udev->descriptor.bDeviceClass == USB_CLASS_HUB)
316 return -EPERM;
317
318 if (sscanf(buf, "%d", &value) != 1)
319 return -EINVAL;
320
321 rc = usb_lock_device_interruptible(udev);
322 if (rc < 0)
323 return -EINTR;
324 udev->persist_enabled = !!value;
325 usb_unlock_device(udev);
326 return count;
327}
328static DEVICE_ATTR_RW(persist);
329
330static int add_persist_attributes(struct device *dev)
331{
332 int rc = 0;
333
334 if (is_usb_device(dev)) {
335 struct usb_device *udev = to_usb_device(dev);
336
337 /* Hubs are automatically enabled for USB_PERSIST,
338 * no point in creating the attribute file.
339 */
340 if (udev->descriptor.bDeviceClass != USB_CLASS_HUB)
341 rc = sysfs_add_file_to_group(&dev->kobj,
342 &dev_attr_persist.attr,
343 power_group_name);
344 }
345 return rc;
346}
347
348static void remove_persist_attributes(struct device *dev)
349{
350 sysfs_remove_file_from_group(&dev->kobj,
351 &dev_attr_persist.attr,
352 power_group_name);
353}
354
355static ssize_t connected_duration_show(struct device *dev,
356 struct device_attribute *attr, char *buf)
357{
358 struct usb_device *udev = to_usb_device(dev);
359
360 return sprintf(buf, "%u\n",
361 jiffies_to_msecs(jiffies - udev->connect_time));
362}
363static DEVICE_ATTR_RO(connected_duration);
364
365/*
366 * If the device is resumed, the last time the device was suspended has
367 * been pre-subtracted from active_duration. We add the current time to
368 * get the duration that the device was actually active.
369 *
370 * If the device is suspended, the active_duration is up-to-date.
371 */
372static ssize_t active_duration_show(struct device *dev,
373 struct device_attribute *attr, char *buf)
374{
375 struct usb_device *udev = to_usb_device(dev);
376 int duration;
377
378 if (udev->state != USB_STATE_SUSPENDED)
379 duration = jiffies_to_msecs(jiffies + udev->active_duration);
380 else
381 duration = jiffies_to_msecs(udev->active_duration);
382 return sprintf(buf, "%u\n", duration);
383}
384static DEVICE_ATTR_RO(active_duration);
385
386static ssize_t autosuspend_show(struct device *dev,
387 struct device_attribute *attr, char *buf)
388{
389 return sprintf(buf, "%d\n", dev->power.autosuspend_delay / 1000);
390}
391
392static ssize_t autosuspend_store(struct device *dev,
393 struct device_attribute *attr, const char *buf,
394 size_t count)
395{
396 int value;
397
398 if (sscanf(buf, "%d", &value) != 1 || value >= INT_MAX/1000 ||
399 value <= -INT_MAX/1000)
400 return -EINVAL;
401
402 pm_runtime_set_autosuspend_delay(dev, value * 1000);
403 return count;
404}
405static DEVICE_ATTR_RW(autosuspend);
406
407static const char on_string[] = "on";
408static const char auto_string[] = "auto";
409
410static void warn_level(void)
411{
412 static int level_warned;
413
414 if (!level_warned) {
415 level_warned = 1;
416 printk(KERN_WARNING "WARNING! power/level is deprecated; "
417 "use power/control instead\n");
418 }
419}
420
421static ssize_t level_show(struct device *dev, struct device_attribute *attr,
422 char *buf)
423{
424 struct usb_device *udev = to_usb_device(dev);
425 const char *p = auto_string;
426
427 warn_level();
428 if (udev->state != USB_STATE_SUSPENDED && !udev->dev.power.runtime_auto)
429 p = on_string;
430 return sprintf(buf, "%s\n", p);
431}
432
433static ssize_t level_store(struct device *dev, struct device_attribute *attr,
434 const char *buf, size_t count)
435{
436 struct usb_device *udev = to_usb_device(dev);
437 int len = count;
438 char *cp;
439 int rc = count;
440 int rv;
441
442 warn_level();
443 cp = memchr(buf, '\n', count);
444 if (cp)
445 len = cp - buf;
446
447 rv = usb_lock_device_interruptible(udev);
448 if (rv < 0)
449 return -EINTR;
450
451 if (len == sizeof on_string - 1 &&
452 strncmp(buf, on_string, len) == 0)
453 usb_disable_autosuspend(udev);
454
455 else if (len == sizeof auto_string - 1 &&
456 strncmp(buf, auto_string, len) == 0)
457 usb_enable_autosuspend(udev);
458
459 else
460 rc = -EINVAL;
461
462 usb_unlock_device(udev);
463 return rc;
464}
465static DEVICE_ATTR_RW(level);
466
467static ssize_t usb2_hardware_lpm_show(struct device *dev,
468 struct device_attribute *attr, char *buf)
469{
470 struct usb_device *udev = to_usb_device(dev);
471 const char *p;
472
473 if (udev->usb2_hw_lpm_allowed == 1)
474 p = "enabled";
475 else
476 p = "disabled";
477
478 return sprintf(buf, "%s\n", p);
479}
480
481static ssize_t usb2_hardware_lpm_store(struct device *dev,
482 struct device_attribute *attr,
483 const char *buf, size_t count)
484{
485 struct usb_device *udev = to_usb_device(dev);
486 bool value;
487 int ret;
488
489 ret = usb_lock_device_interruptible(udev);
490 if (ret < 0)
491 return -EINTR;
492
493 ret = strtobool(buf, &value);
494
495 if (!ret) {
496 udev->usb2_hw_lpm_allowed = value;
497 ret = usb_set_usb2_hardware_lpm(udev, value);
498 }
499
500 usb_unlock_device(udev);
501
502 if (!ret)
503 return count;
504
505 return ret;
506}
507static DEVICE_ATTR_RW(usb2_hardware_lpm);
508
509static ssize_t usb2_lpm_l1_timeout_show(struct device *dev,
510 struct device_attribute *attr,
511 char *buf)
512{
513 struct usb_device *udev = to_usb_device(dev);
514 return sprintf(buf, "%d\n", udev->l1_params.timeout);
515}
516
517static ssize_t usb2_lpm_l1_timeout_store(struct device *dev,
518 struct device_attribute *attr,
519 const char *buf, size_t count)
520{
521 struct usb_device *udev = to_usb_device(dev);
522 u16 timeout;
523
524 if (kstrtou16(buf, 0, &timeout))
525 return -EINVAL;
526
527 udev->l1_params.timeout = timeout;
528
529 return count;
530}
531static DEVICE_ATTR_RW(usb2_lpm_l1_timeout);
532
533static ssize_t usb2_lpm_besl_show(struct device *dev,
534 struct device_attribute *attr, char *buf)
535{
536 struct usb_device *udev = to_usb_device(dev);
537 return sprintf(buf, "%d\n", udev->l1_params.besl);
538}
539
540static ssize_t usb2_lpm_besl_store(struct device *dev,
541 struct device_attribute *attr,
542 const char *buf, size_t count)
543{
544 struct usb_device *udev = to_usb_device(dev);
545 u8 besl;
546
547 if (kstrtou8(buf, 0, &besl) || besl > 15)
548 return -EINVAL;
549
550 udev->l1_params.besl = besl;
551
552 return count;
553}
554static DEVICE_ATTR_RW(usb2_lpm_besl);
555
556static ssize_t usb3_hardware_lpm_u1_show(struct device *dev,
557 struct device_attribute *attr, char *buf)
558{
559 struct usb_device *udev = to_usb_device(dev);
560 const char *p;
561 int rc;
562
563 rc = usb_lock_device_interruptible(udev);
564 if (rc < 0)
565 return -EINTR;
566
567 if (udev->usb3_lpm_u1_enabled)
568 p = "enabled";
569 else
570 p = "disabled";
571
572 usb_unlock_device(udev);
573
574 return sprintf(buf, "%s\n", p);
575}
576static DEVICE_ATTR_RO(usb3_hardware_lpm_u1);
577
578static ssize_t usb3_hardware_lpm_u2_show(struct device *dev,
579 struct device_attribute *attr, char *buf)
580{
581 struct usb_device *udev = to_usb_device(dev);
582 const char *p;
583 int rc;
584
585 rc = usb_lock_device_interruptible(udev);
586 if (rc < 0)
587 return -EINTR;
588
589 if (udev->usb3_lpm_u2_enabled)
590 p = "enabled";
591 else
592 p = "disabled";
593
594 usb_unlock_device(udev);
595
596 return sprintf(buf, "%s\n", p);
597}
598static DEVICE_ATTR_RO(usb3_hardware_lpm_u2);
599
600static struct attribute *usb2_hardware_lpm_attr[] = {
601 &dev_attr_usb2_hardware_lpm.attr,
602 &dev_attr_usb2_lpm_l1_timeout.attr,
603 &dev_attr_usb2_lpm_besl.attr,
604 NULL,
605};
606static struct attribute_group usb2_hardware_lpm_attr_group = {
607 .name = power_group_name,
608 .attrs = usb2_hardware_lpm_attr,
609};
610
611static struct attribute *usb3_hardware_lpm_attr[] = {
612 &dev_attr_usb3_hardware_lpm_u1.attr,
613 &dev_attr_usb3_hardware_lpm_u2.attr,
614 NULL,
615};
616static struct attribute_group usb3_hardware_lpm_attr_group = {
617 .name = power_group_name,
618 .attrs = usb3_hardware_lpm_attr,
619};
620
621static struct attribute *power_attrs[] = {
622 &dev_attr_autosuspend.attr,
623 &dev_attr_level.attr,
624 &dev_attr_connected_duration.attr,
625 &dev_attr_active_duration.attr,
626 NULL,
627};
628static struct attribute_group power_attr_group = {
629 .name = power_group_name,
630 .attrs = power_attrs,
631};
632
633static int add_power_attributes(struct device *dev)
634{
635 int rc = 0;
636
637 if (is_usb_device(dev)) {
638 struct usb_device *udev = to_usb_device(dev);
639 rc = sysfs_merge_group(&dev->kobj, &power_attr_group);
640 if (udev->usb2_hw_lpm_capable == 1)
641 rc = sysfs_merge_group(&dev->kobj,
642 &usb2_hardware_lpm_attr_group);
643 if (udev->speed == USB_SPEED_SUPER &&
644 udev->lpm_capable == 1)
645 rc = sysfs_merge_group(&dev->kobj,
646 &usb3_hardware_lpm_attr_group);
647 }
648
649 return rc;
650}
651
652static void remove_power_attributes(struct device *dev)
653{
654 sysfs_unmerge_group(&dev->kobj, &usb2_hardware_lpm_attr_group);
655 sysfs_unmerge_group(&dev->kobj, &power_attr_group);
656}
657
658#else
659
660#define add_persist_attributes(dev) 0
661#define remove_persist_attributes(dev) do {} while (0)
662
663#define add_power_attributes(dev) 0
664#define remove_power_attributes(dev) do {} while (0)
665
666#endif /* CONFIG_PM */
667
668
669/* Descriptor fields */
670#define usb_descriptor_attr_le16(field, format_string) \
671static ssize_t \
672field##_show(struct device *dev, struct device_attribute *attr, \
673 char *buf) \
674{ \
675 struct usb_device *udev; \
676 \
677 udev = to_usb_device(dev); \
678 return sprintf(buf, format_string, \
679 le16_to_cpu(udev->descriptor.field)); \
680} \
681static DEVICE_ATTR_RO(field)
682
683usb_descriptor_attr_le16(idVendor, "%04x\n");
684usb_descriptor_attr_le16(idProduct, "%04x\n");
685usb_descriptor_attr_le16(bcdDevice, "%04x\n");
686
687#define usb_descriptor_attr(field, format_string) \
688static ssize_t \
689field##_show(struct device *dev, struct device_attribute *attr, \
690 char *buf) \
691{ \
692 struct usb_device *udev; \
693 \
694 udev = to_usb_device(dev); \
695 return sprintf(buf, format_string, udev->descriptor.field); \
696} \
697static DEVICE_ATTR_RO(field)
698
699usb_descriptor_attr(bDeviceClass, "%02x\n");
700usb_descriptor_attr(bDeviceSubClass, "%02x\n");
701usb_descriptor_attr(bDeviceProtocol, "%02x\n");
702usb_descriptor_attr(bNumConfigurations, "%d\n");
703usb_descriptor_attr(bMaxPacketSize0, "%d\n");
704
705
706/* show if the device is authorized (1) or not (0) */
707static ssize_t authorized_show(struct device *dev,
708 struct device_attribute *attr, char *buf)
709{
710 struct usb_device *usb_dev = to_usb_device(dev);
711 return snprintf(buf, PAGE_SIZE, "%u\n", usb_dev->authorized);
712}
713
714/*
715 * Authorize a device to be used in the system
716 *
717 * Writing a 0 deauthorizes the device, writing a 1 authorizes it.
718 */
719static ssize_t authorized_store(struct device *dev,
720 struct device_attribute *attr, const char *buf,
721 size_t size)
722{
723 ssize_t result;
724 struct usb_device *usb_dev = to_usb_device(dev);
725 unsigned val;
726 result = sscanf(buf, "%u\n", &val);
727 if (result != 1)
728 result = -EINVAL;
729 else if (val == 0)
730 result = usb_deauthorize_device(usb_dev);
731 else
732 result = usb_authorize_device(usb_dev);
733 return result < 0 ? result : size;
734}
735static DEVICE_ATTR_IGNORE_LOCKDEP(authorized, S_IRUGO | S_IWUSR,
736 authorized_show, authorized_store);
737
738/* "Safely remove a device" */
739static ssize_t remove_store(struct device *dev, struct device_attribute *attr,
740 const char *buf, size_t count)
741{
742 struct usb_device *udev = to_usb_device(dev);
743 int rc = 0;
744
745 usb_lock_device(udev);
746 if (udev->state != USB_STATE_NOTATTACHED) {
747
748 /* To avoid races, first unconfigure and then remove */
749 usb_set_configuration(udev, -1);
750 rc = usb_remove_device(udev);
751 }
752 if (rc == 0)
753 rc = count;
754 usb_unlock_device(udev);
755 return rc;
756}
757static DEVICE_ATTR_IGNORE_LOCKDEP(remove, S_IWUSR, NULL, remove_store);
758
759
760static struct attribute *dev_attrs[] = {
761 /* current configuration's attributes */
762 &dev_attr_configuration.attr,
763 &dev_attr_bNumInterfaces.attr,
764 &dev_attr_bConfigurationValue.attr,
765 &dev_attr_bmAttributes.attr,
766 &dev_attr_bMaxPower.attr,
767 /* device attributes */
768 &dev_attr_urbnum.attr,
769 &dev_attr_idVendor.attr,
770 &dev_attr_idProduct.attr,
771 &dev_attr_bcdDevice.attr,
772 &dev_attr_bDeviceClass.attr,
773 &dev_attr_bDeviceSubClass.attr,
774 &dev_attr_bDeviceProtocol.attr,
775 &dev_attr_bNumConfigurations.attr,
776 &dev_attr_bMaxPacketSize0.attr,
777 &dev_attr_speed.attr,
778 &dev_attr_busnum.attr,
779 &dev_attr_devnum.attr,
780 &dev_attr_devpath.attr,
781 &dev_attr_version.attr,
782 &dev_attr_maxchild.attr,
783 &dev_attr_quirks.attr,
784 &dev_attr_avoid_reset_quirk.attr,
785 &dev_attr_authorized.attr,
786 &dev_attr_remove.attr,
787 &dev_attr_removable.attr,
788 &dev_attr_ltm_capable.attr,
789 NULL,
790};
791static struct attribute_group dev_attr_grp = {
792 .attrs = dev_attrs,
793};
794
795/* When modifying this list, be sure to modify dev_string_attrs_are_visible()
796 * accordingly.
797 */
798static struct attribute *dev_string_attrs[] = {
799 &dev_attr_manufacturer.attr,
800 &dev_attr_product.attr,
801 &dev_attr_serial.attr,
802 NULL
803};
804
805static umode_t dev_string_attrs_are_visible(struct kobject *kobj,
806 struct attribute *a, int n)
807{
808 struct device *dev = container_of(kobj, struct device, kobj);
809 struct usb_device *udev = to_usb_device(dev);
810
811 if (a == &dev_attr_manufacturer.attr) {
812 if (udev->manufacturer == NULL)
813 return 0;
814 } else if (a == &dev_attr_product.attr) {
815 if (udev->product == NULL)
816 return 0;
817 } else if (a == &dev_attr_serial.attr) {
818 if (udev->serial == NULL)
819 return 0;
820 }
821 return a->mode;
822}
823
824static struct attribute_group dev_string_attr_grp = {
825 .attrs = dev_string_attrs,
826 .is_visible = dev_string_attrs_are_visible,
827};
828
829const struct attribute_group *usb_device_groups[] = {
830 &dev_attr_grp,
831 &dev_string_attr_grp,
832 NULL
833};
834
835/* Binary descriptors */
836
837static ssize_t
838read_descriptors(struct file *filp, struct kobject *kobj,
839 struct bin_attribute *attr,
840 char *buf, loff_t off, size_t count)
841{
842 struct device *dev = container_of(kobj, struct device, kobj);
843 struct usb_device *udev = to_usb_device(dev);
844 size_t nleft = count;
845 size_t srclen, n;
846 int cfgno;
847 void *src;
848
849 /* The binary attribute begins with the device descriptor.
850 * Following that are the raw descriptor entries for all the
851 * configurations (config plus subsidiary descriptors).
852 */
853 for (cfgno = -1; cfgno < udev->descriptor.bNumConfigurations &&
854 nleft > 0; ++cfgno) {
855 if (cfgno < 0) {
856 src = &udev->descriptor;
857 srclen = sizeof(struct usb_device_descriptor);
858 } else {
859 src = udev->rawdescriptors[cfgno];
860 srclen = __le16_to_cpu(udev->config[cfgno].desc.
861 wTotalLength);
862 }
863 if (off < srclen) {
864 n = min(nleft, srclen - (size_t) off);
865 memcpy(buf, src + off, n);
866 nleft -= n;
867 buf += n;
868 off = 0;
869 } else {
870 off -= srclen;
871 }
872 }
873 return count - nleft;
874}
875
876static struct bin_attribute dev_bin_attr_descriptors = {
877 .attr = {.name = "descriptors", .mode = 0444},
878 .read = read_descriptors,
879 .size = 18 + 65535, /* dev descr + max-size raw descriptor */
880};
881
882int usb_create_sysfs_dev_files(struct usb_device *udev)
883{
884 struct device *dev = &udev->dev;
885 int retval;
886
887 retval = device_create_bin_file(dev, &dev_bin_attr_descriptors);
888 if (retval)
889 goto error;
890
891 retval = add_persist_attributes(dev);
892 if (retval)
893 goto error;
894
895 retval = add_power_attributes(dev);
896 if (retval)
897 goto error;
898 return retval;
899error:
900 usb_remove_sysfs_dev_files(udev);
901 return retval;
902}
903
904void usb_remove_sysfs_dev_files(struct usb_device *udev)
905{
906 struct device *dev = &udev->dev;
907
908 remove_power_attributes(dev);
909 remove_persist_attributes(dev);
910 device_remove_bin_file(dev, &dev_bin_attr_descriptors);
911}
912
913/* Interface Association Descriptor fields */
914#define usb_intf_assoc_attr(field, format_string) \
915static ssize_t \
916iad_##field##_show(struct device *dev, struct device_attribute *attr, \
917 char *buf) \
918{ \
919 struct usb_interface *intf = to_usb_interface(dev); \
920 \
921 return sprintf(buf, format_string, \
922 intf->intf_assoc->field); \
923} \
924static DEVICE_ATTR_RO(iad_##field)
925
926usb_intf_assoc_attr(bFirstInterface, "%02x\n");
927usb_intf_assoc_attr(bInterfaceCount, "%02d\n");
928usb_intf_assoc_attr(bFunctionClass, "%02x\n");
929usb_intf_assoc_attr(bFunctionSubClass, "%02x\n");
930usb_intf_assoc_attr(bFunctionProtocol, "%02x\n");
931
932/* Interface fields */
933#define usb_intf_attr(field, format_string) \
934static ssize_t \
935field##_show(struct device *dev, struct device_attribute *attr, \
936 char *buf) \
937{ \
938 struct usb_interface *intf = to_usb_interface(dev); \
939 \
940 return sprintf(buf, format_string, \
941 intf->cur_altsetting->desc.field); \
942} \
943static DEVICE_ATTR_RO(field)
944
945usb_intf_attr(bInterfaceNumber, "%02x\n");
946usb_intf_attr(bAlternateSetting, "%2d\n");
947usb_intf_attr(bNumEndpoints, "%02x\n");
948usb_intf_attr(bInterfaceClass, "%02x\n");
949usb_intf_attr(bInterfaceSubClass, "%02x\n");
950usb_intf_attr(bInterfaceProtocol, "%02x\n");
951
952static ssize_t interface_show(struct device *dev, struct device_attribute *attr,
953 char *buf)
954{
955 struct usb_interface *intf;
956 char *string;
957
958 intf = to_usb_interface(dev);
959 string = ACCESS_ONCE(intf->cur_altsetting->string);
960 if (!string)
961 return 0;
962 return sprintf(buf, "%s\n", string);
963}
964static DEVICE_ATTR_RO(interface);
965
966static ssize_t modalias_show(struct device *dev, struct device_attribute *attr,
967 char *buf)
968{
969 struct usb_interface *intf;
970 struct usb_device *udev;
971 struct usb_host_interface *alt;
972
973 intf = to_usb_interface(dev);
974 udev = interface_to_usbdev(intf);
975 alt = ACCESS_ONCE(intf->cur_altsetting);
976
977 return sprintf(buf, "usb:v%04Xp%04Xd%04Xdc%02Xdsc%02Xdp%02X"
978 "ic%02Xisc%02Xip%02Xin%02X\n",
979 le16_to_cpu(udev->descriptor.idVendor),
980 le16_to_cpu(udev->descriptor.idProduct),
981 le16_to_cpu(udev->descriptor.bcdDevice),
982 udev->descriptor.bDeviceClass,
983 udev->descriptor.bDeviceSubClass,
984 udev->descriptor.bDeviceProtocol,
985 alt->desc.bInterfaceClass,
986 alt->desc.bInterfaceSubClass,
987 alt->desc.bInterfaceProtocol,
988 alt->desc.bInterfaceNumber);
989}
990static DEVICE_ATTR_RO(modalias);
991
992static ssize_t supports_autosuspend_show(struct device *dev,
993 struct device_attribute *attr,
994 char *buf)
995{
996 int s;
997
998 s = device_lock_interruptible(dev);
999 if (s < 0)
1000 return -EINTR;
1001 /* Devices will be autosuspended even when an interface isn't claimed */
1002 s = (!dev->driver || to_usb_driver(dev->driver)->supports_autosuspend);
1003 device_unlock(dev);
1004
1005 return sprintf(buf, "%u\n", s);
1006}
1007static DEVICE_ATTR_RO(supports_autosuspend);
1008
1009/*
1010 * interface_authorized_show - show authorization status of an USB interface
1011 * 1 is authorized, 0 is deauthorized
1012 */
1013static ssize_t interface_authorized_show(struct device *dev,
1014 struct device_attribute *attr, char *buf)
1015{
1016 struct usb_interface *intf = to_usb_interface(dev);
1017
1018 return sprintf(buf, "%u\n", intf->authorized);
1019}
1020
1021/*
1022 * interface_authorized_store - authorize or deauthorize an USB interface
1023 */
1024static ssize_t interface_authorized_store(struct device *dev,
1025 struct device_attribute *attr, const char *buf, size_t count)
1026{
1027 struct usb_interface *intf = to_usb_interface(dev);
1028 bool val;
1029
1030 if (strtobool(buf, &val) != 0)
1031 return -EINVAL;
1032
1033 if (val)
1034 usb_authorize_interface(intf);
1035 else
1036 usb_deauthorize_interface(intf);
1037
1038 return count;
1039}
1040static struct device_attribute dev_attr_interface_authorized =
1041 __ATTR(authorized, S_IRUGO | S_IWUSR,
1042 interface_authorized_show, interface_authorized_store);
1043
1044static struct attribute *intf_attrs[] = {
1045 &dev_attr_bInterfaceNumber.attr,
1046 &dev_attr_bAlternateSetting.attr,
1047 &dev_attr_bNumEndpoints.attr,
1048 &dev_attr_bInterfaceClass.attr,
1049 &dev_attr_bInterfaceSubClass.attr,
1050 &dev_attr_bInterfaceProtocol.attr,
1051 &dev_attr_modalias.attr,
1052 &dev_attr_supports_autosuspend.attr,
1053 &dev_attr_interface_authorized.attr,
1054 NULL,
1055};
1056static struct attribute_group intf_attr_grp = {
1057 .attrs = intf_attrs,
1058};
1059
1060static struct attribute *intf_assoc_attrs[] = {
1061 &dev_attr_iad_bFirstInterface.attr,
1062 &dev_attr_iad_bInterfaceCount.attr,
1063 &dev_attr_iad_bFunctionClass.attr,
1064 &dev_attr_iad_bFunctionSubClass.attr,
1065 &dev_attr_iad_bFunctionProtocol.attr,
1066 NULL,
1067};
1068
1069static umode_t intf_assoc_attrs_are_visible(struct kobject *kobj,
1070 struct attribute *a, int n)
1071{
1072 struct device *dev = container_of(kobj, struct device, kobj);
1073 struct usb_interface *intf = to_usb_interface(dev);
1074
1075 if (intf->intf_assoc == NULL)
1076 return 0;
1077 return a->mode;
1078}
1079
1080static struct attribute_group intf_assoc_attr_grp = {
1081 .attrs = intf_assoc_attrs,
1082 .is_visible = intf_assoc_attrs_are_visible,
1083};
1084
1085const struct attribute_group *usb_interface_groups[] = {
1086 &intf_attr_grp,
1087 &intf_assoc_attr_grp,
1088 NULL
1089};
1090
1091void usb_create_sysfs_intf_files(struct usb_interface *intf)
1092{
1093 struct usb_device *udev = interface_to_usbdev(intf);
1094 struct usb_host_interface *alt = intf->cur_altsetting;
1095
1096 if (intf->sysfs_files_created || intf->unregistering)
1097 return;
1098
1099 if (!alt->string && !(udev->quirks & USB_QUIRK_CONFIG_INTF_STRINGS))
1100 alt->string = usb_cache_string(udev, alt->desc.iInterface);
1101 if (alt->string && device_create_file(&intf->dev, &dev_attr_interface))
1102 ; /* We don't actually care if the function fails. */
1103 intf->sysfs_files_created = 1;
1104}
1105
1106void usb_remove_sysfs_intf_files(struct usb_interface *intf)
1107{
1108 if (!intf->sysfs_files_created)
1109 return;
1110
1111 device_remove_file(&intf->dev, &dev_attr_interface);
1112 intf->sysfs_files_created = 0;
1113}
1// SPDX-License-Identifier: GPL-2.0
2/*
3 * drivers/usb/core/sysfs.c
4 *
5 * (C) Copyright 2002 David Brownell
6 * (C) Copyright 2002,2004 Greg Kroah-Hartman
7 * (C) Copyright 2002,2004 IBM Corp.
8 *
9 * All of the sysfs file attributes for usb devices and interfaces.
10 *
11 * Released under the GPLv2 only.
12 */
13
14
15#include <linux/kernel.h>
16#include <linux/string.h>
17#include <linux/usb.h>
18#include <linux/usb/hcd.h>
19#include <linux/usb/quirks.h>
20#include <linux/of.h>
21#include "usb.h"
22
23/* Active configuration fields */
24#define usb_actconfig_show(field, format_string) \
25static ssize_t field##_show(struct device *dev, \
26 struct device_attribute *attr, char *buf) \
27{ \
28 struct usb_device *udev; \
29 struct usb_host_config *actconfig; \
30 ssize_t rc; \
31 \
32 udev = to_usb_device(dev); \
33 rc = usb_lock_device_interruptible(udev); \
34 if (rc < 0) \
35 return -EINTR; \
36 actconfig = udev->actconfig; \
37 if (actconfig) \
38 rc = sprintf(buf, format_string, \
39 actconfig->desc.field); \
40 usb_unlock_device(udev); \
41 return rc; \
42} \
43
44#define usb_actconfig_attr(field, format_string) \
45 usb_actconfig_show(field, format_string) \
46 static DEVICE_ATTR_RO(field)
47
48usb_actconfig_attr(bNumInterfaces, "%2d\n");
49usb_actconfig_attr(bmAttributes, "%2x\n");
50
51static ssize_t bMaxPower_show(struct device *dev,
52 struct device_attribute *attr, char *buf)
53{
54 struct usb_device *udev;
55 struct usb_host_config *actconfig;
56 ssize_t rc;
57
58 udev = to_usb_device(dev);
59 rc = usb_lock_device_interruptible(udev);
60 if (rc < 0)
61 return -EINTR;
62 actconfig = udev->actconfig;
63 if (actconfig)
64 rc = sprintf(buf, "%dmA\n", usb_get_max_power(udev, actconfig));
65 usb_unlock_device(udev);
66 return rc;
67}
68static DEVICE_ATTR_RO(bMaxPower);
69
70static ssize_t configuration_show(struct device *dev,
71 struct device_attribute *attr, char *buf)
72{
73 struct usb_device *udev;
74 struct usb_host_config *actconfig;
75 ssize_t rc;
76
77 udev = to_usb_device(dev);
78 rc = usb_lock_device_interruptible(udev);
79 if (rc < 0)
80 return -EINTR;
81 actconfig = udev->actconfig;
82 if (actconfig && actconfig->string)
83 rc = sprintf(buf, "%s\n", actconfig->string);
84 usb_unlock_device(udev);
85 return rc;
86}
87static DEVICE_ATTR_RO(configuration);
88
89/* configuration value is always present, and r/w */
90usb_actconfig_show(bConfigurationValue, "%u\n");
91
92static ssize_t bConfigurationValue_store(struct device *dev,
93 struct device_attribute *attr,
94 const char *buf, size_t count)
95{
96 struct usb_device *udev = to_usb_device(dev);
97 int config, value, rc;
98
99 if (sscanf(buf, "%d", &config) != 1 || config < -1 || config > 255)
100 return -EINVAL;
101 rc = usb_lock_device_interruptible(udev);
102 if (rc < 0)
103 return -EINTR;
104 value = usb_set_configuration(udev, config);
105 usb_unlock_device(udev);
106 return (value < 0) ? value : count;
107}
108static DEVICE_ATTR_IGNORE_LOCKDEP(bConfigurationValue, S_IRUGO | S_IWUSR,
109 bConfigurationValue_show, bConfigurationValue_store);
110
111#ifdef CONFIG_OF
112static ssize_t devspec_show(struct device *dev, struct device_attribute *attr,
113 char *buf)
114{
115 struct device_node *of_node = dev->of_node;
116
117 return sprintf(buf, "%pOF\n", of_node);
118}
119static DEVICE_ATTR_RO(devspec);
120#endif
121
122/* String fields */
123#define usb_string_attr(name) \
124static ssize_t name##_show(struct device *dev, \
125 struct device_attribute *attr, char *buf) \
126{ \
127 struct usb_device *udev; \
128 int retval; \
129 \
130 udev = to_usb_device(dev); \
131 retval = usb_lock_device_interruptible(udev); \
132 if (retval < 0) \
133 return -EINTR; \
134 retval = sprintf(buf, "%s\n", udev->name); \
135 usb_unlock_device(udev); \
136 return retval; \
137} \
138static DEVICE_ATTR_RO(name)
139
140usb_string_attr(product);
141usb_string_attr(manufacturer);
142usb_string_attr(serial);
143
144static ssize_t speed_show(struct device *dev, struct device_attribute *attr,
145 char *buf)
146{
147 struct usb_device *udev;
148 char *speed;
149
150 udev = to_usb_device(dev);
151
152 switch (udev->speed) {
153 case USB_SPEED_LOW:
154 speed = "1.5";
155 break;
156 case USB_SPEED_UNKNOWN:
157 case USB_SPEED_FULL:
158 speed = "12";
159 break;
160 case USB_SPEED_HIGH:
161 speed = "480";
162 break;
163 case USB_SPEED_WIRELESS:
164 speed = "480";
165 break;
166 case USB_SPEED_SUPER:
167 speed = "5000";
168 break;
169 case USB_SPEED_SUPER_PLUS:
170 speed = "10000";
171 break;
172 default:
173 speed = "unknown";
174 }
175 return sprintf(buf, "%s\n", speed);
176}
177static DEVICE_ATTR_RO(speed);
178
179static ssize_t rx_lanes_show(struct device *dev, struct device_attribute *attr,
180 char *buf)
181{
182 struct usb_device *udev;
183
184 udev = to_usb_device(dev);
185 return sprintf(buf, "%d\n", udev->rx_lanes);
186}
187static DEVICE_ATTR_RO(rx_lanes);
188
189static ssize_t tx_lanes_show(struct device *dev, struct device_attribute *attr,
190 char *buf)
191{
192 struct usb_device *udev;
193
194 udev = to_usb_device(dev);
195 return sprintf(buf, "%d\n", udev->tx_lanes);
196}
197static DEVICE_ATTR_RO(tx_lanes);
198
199static ssize_t busnum_show(struct device *dev, struct device_attribute *attr,
200 char *buf)
201{
202 struct usb_device *udev;
203
204 udev = to_usb_device(dev);
205 return sprintf(buf, "%d\n", udev->bus->busnum);
206}
207static DEVICE_ATTR_RO(busnum);
208
209static ssize_t devnum_show(struct device *dev, struct device_attribute *attr,
210 char *buf)
211{
212 struct usb_device *udev;
213
214 udev = to_usb_device(dev);
215 return sprintf(buf, "%d\n", udev->devnum);
216}
217static DEVICE_ATTR_RO(devnum);
218
219static ssize_t devpath_show(struct device *dev, struct device_attribute *attr,
220 char *buf)
221{
222 struct usb_device *udev;
223
224 udev = to_usb_device(dev);
225 return sprintf(buf, "%s\n", udev->devpath);
226}
227static DEVICE_ATTR_RO(devpath);
228
229static ssize_t version_show(struct device *dev, struct device_attribute *attr,
230 char *buf)
231{
232 struct usb_device *udev;
233 u16 bcdUSB;
234
235 udev = to_usb_device(dev);
236 bcdUSB = le16_to_cpu(udev->descriptor.bcdUSB);
237 return sprintf(buf, "%2x.%02x\n", bcdUSB >> 8, bcdUSB & 0xff);
238}
239static DEVICE_ATTR_RO(version);
240
241static ssize_t maxchild_show(struct device *dev, struct device_attribute *attr,
242 char *buf)
243{
244 struct usb_device *udev;
245
246 udev = to_usb_device(dev);
247 return sprintf(buf, "%d\n", udev->maxchild);
248}
249static DEVICE_ATTR_RO(maxchild);
250
251static ssize_t quirks_show(struct device *dev, struct device_attribute *attr,
252 char *buf)
253{
254 struct usb_device *udev;
255
256 udev = to_usb_device(dev);
257 return sprintf(buf, "0x%x\n", udev->quirks);
258}
259static DEVICE_ATTR_RO(quirks);
260
261static ssize_t avoid_reset_quirk_show(struct device *dev,
262 struct device_attribute *attr, char *buf)
263{
264 struct usb_device *udev;
265
266 udev = to_usb_device(dev);
267 return sprintf(buf, "%d\n", !!(udev->quirks & USB_QUIRK_RESET));
268}
269
270static ssize_t avoid_reset_quirk_store(struct device *dev,
271 struct device_attribute *attr,
272 const char *buf, size_t count)
273{
274 struct usb_device *udev = to_usb_device(dev);
275 int val, rc;
276
277 if (sscanf(buf, "%d", &val) != 1 || val < 0 || val > 1)
278 return -EINVAL;
279 rc = usb_lock_device_interruptible(udev);
280 if (rc < 0)
281 return -EINTR;
282 if (val)
283 udev->quirks |= USB_QUIRK_RESET;
284 else
285 udev->quirks &= ~USB_QUIRK_RESET;
286 usb_unlock_device(udev);
287 return count;
288}
289static DEVICE_ATTR_RW(avoid_reset_quirk);
290
291static ssize_t urbnum_show(struct device *dev, struct device_attribute *attr,
292 char *buf)
293{
294 struct usb_device *udev;
295
296 udev = to_usb_device(dev);
297 return sprintf(buf, "%d\n", atomic_read(&udev->urbnum));
298}
299static DEVICE_ATTR_RO(urbnum);
300
301static ssize_t removable_show(struct device *dev, struct device_attribute *attr,
302 char *buf)
303{
304 struct usb_device *udev;
305 char *state;
306
307 udev = to_usb_device(dev);
308
309 switch (udev->removable) {
310 case USB_DEVICE_REMOVABLE:
311 state = "removable";
312 break;
313 case USB_DEVICE_FIXED:
314 state = "fixed";
315 break;
316 default:
317 state = "unknown";
318 }
319
320 return sprintf(buf, "%s\n", state);
321}
322static DEVICE_ATTR_RO(removable);
323
324static ssize_t ltm_capable_show(struct device *dev,
325 struct device_attribute *attr, char *buf)
326{
327 if (usb_device_supports_ltm(to_usb_device(dev)))
328 return sprintf(buf, "%s\n", "yes");
329 return sprintf(buf, "%s\n", "no");
330}
331static DEVICE_ATTR_RO(ltm_capable);
332
333#ifdef CONFIG_PM
334
335static ssize_t persist_show(struct device *dev, struct device_attribute *attr,
336 char *buf)
337{
338 struct usb_device *udev = to_usb_device(dev);
339
340 return sprintf(buf, "%d\n", udev->persist_enabled);
341}
342
343static ssize_t persist_store(struct device *dev, struct device_attribute *attr,
344 const char *buf, size_t count)
345{
346 struct usb_device *udev = to_usb_device(dev);
347 int value, rc;
348
349 /* Hubs are always enabled for USB_PERSIST */
350 if (udev->descriptor.bDeviceClass == USB_CLASS_HUB)
351 return -EPERM;
352
353 if (sscanf(buf, "%d", &value) != 1)
354 return -EINVAL;
355
356 rc = usb_lock_device_interruptible(udev);
357 if (rc < 0)
358 return -EINTR;
359 udev->persist_enabled = !!value;
360 usb_unlock_device(udev);
361 return count;
362}
363static DEVICE_ATTR_RW(persist);
364
365static int add_persist_attributes(struct device *dev)
366{
367 int rc = 0;
368
369 if (is_usb_device(dev)) {
370 struct usb_device *udev = to_usb_device(dev);
371
372 /* Hubs are automatically enabled for USB_PERSIST,
373 * no point in creating the attribute file.
374 */
375 if (udev->descriptor.bDeviceClass != USB_CLASS_HUB)
376 rc = sysfs_add_file_to_group(&dev->kobj,
377 &dev_attr_persist.attr,
378 power_group_name);
379 }
380 return rc;
381}
382
383static void remove_persist_attributes(struct device *dev)
384{
385 sysfs_remove_file_from_group(&dev->kobj,
386 &dev_attr_persist.attr,
387 power_group_name);
388}
389
390static ssize_t connected_duration_show(struct device *dev,
391 struct device_attribute *attr, char *buf)
392{
393 struct usb_device *udev = to_usb_device(dev);
394
395 return sprintf(buf, "%u\n",
396 jiffies_to_msecs(jiffies - udev->connect_time));
397}
398static DEVICE_ATTR_RO(connected_duration);
399
400/*
401 * If the device is resumed, the last time the device was suspended has
402 * been pre-subtracted from active_duration. We add the current time to
403 * get the duration that the device was actually active.
404 *
405 * If the device is suspended, the active_duration is up-to-date.
406 */
407static ssize_t active_duration_show(struct device *dev,
408 struct device_attribute *attr, char *buf)
409{
410 struct usb_device *udev = to_usb_device(dev);
411 int duration;
412
413 if (udev->state != USB_STATE_SUSPENDED)
414 duration = jiffies_to_msecs(jiffies + udev->active_duration);
415 else
416 duration = jiffies_to_msecs(udev->active_duration);
417 return sprintf(buf, "%u\n", duration);
418}
419static DEVICE_ATTR_RO(active_duration);
420
421static ssize_t autosuspend_show(struct device *dev,
422 struct device_attribute *attr, char *buf)
423{
424 return sprintf(buf, "%d\n", dev->power.autosuspend_delay / 1000);
425}
426
427static ssize_t autosuspend_store(struct device *dev,
428 struct device_attribute *attr, const char *buf,
429 size_t count)
430{
431 int value;
432
433 if (sscanf(buf, "%d", &value) != 1 || value >= INT_MAX/1000 ||
434 value <= -INT_MAX/1000)
435 return -EINVAL;
436
437 pm_runtime_set_autosuspend_delay(dev, value * 1000);
438 return count;
439}
440static DEVICE_ATTR_RW(autosuspend);
441
442static const char on_string[] = "on";
443static const char auto_string[] = "auto";
444
445static void warn_level(void)
446{
447 static int level_warned;
448
449 if (!level_warned) {
450 level_warned = 1;
451 printk(KERN_WARNING "WARNING! power/level is deprecated; "
452 "use power/control instead\n");
453 }
454}
455
456static ssize_t level_show(struct device *dev, struct device_attribute *attr,
457 char *buf)
458{
459 struct usb_device *udev = to_usb_device(dev);
460 const char *p = auto_string;
461
462 warn_level();
463 if (udev->state != USB_STATE_SUSPENDED && !udev->dev.power.runtime_auto)
464 p = on_string;
465 return sprintf(buf, "%s\n", p);
466}
467
468static ssize_t level_store(struct device *dev, struct device_attribute *attr,
469 const char *buf, size_t count)
470{
471 struct usb_device *udev = to_usb_device(dev);
472 int len = count;
473 char *cp;
474 int rc = count;
475 int rv;
476
477 warn_level();
478 cp = memchr(buf, '\n', count);
479 if (cp)
480 len = cp - buf;
481
482 rv = usb_lock_device_interruptible(udev);
483 if (rv < 0)
484 return -EINTR;
485
486 if (len == sizeof on_string - 1 &&
487 strncmp(buf, on_string, len) == 0)
488 usb_disable_autosuspend(udev);
489
490 else if (len == sizeof auto_string - 1 &&
491 strncmp(buf, auto_string, len) == 0)
492 usb_enable_autosuspend(udev);
493
494 else
495 rc = -EINVAL;
496
497 usb_unlock_device(udev);
498 return rc;
499}
500static DEVICE_ATTR_RW(level);
501
502static ssize_t usb2_hardware_lpm_show(struct device *dev,
503 struct device_attribute *attr, char *buf)
504{
505 struct usb_device *udev = to_usb_device(dev);
506 const char *p;
507
508 if (udev->usb2_hw_lpm_allowed == 1)
509 p = "enabled";
510 else
511 p = "disabled";
512
513 return sprintf(buf, "%s\n", p);
514}
515
516static ssize_t usb2_hardware_lpm_store(struct device *dev,
517 struct device_attribute *attr,
518 const char *buf, size_t count)
519{
520 struct usb_device *udev = to_usb_device(dev);
521 bool value;
522 int ret;
523
524 ret = usb_lock_device_interruptible(udev);
525 if (ret < 0)
526 return -EINTR;
527
528 ret = strtobool(buf, &value);
529
530 if (!ret) {
531 udev->usb2_hw_lpm_allowed = value;
532 if (value)
533 ret = usb_enable_usb2_hardware_lpm(udev);
534 else
535 ret = usb_disable_usb2_hardware_lpm(udev);
536 }
537
538 usb_unlock_device(udev);
539
540 if (!ret)
541 return count;
542
543 return ret;
544}
545static DEVICE_ATTR_RW(usb2_hardware_lpm);
546
547static ssize_t usb2_lpm_l1_timeout_show(struct device *dev,
548 struct device_attribute *attr,
549 char *buf)
550{
551 struct usb_device *udev = to_usb_device(dev);
552 return sprintf(buf, "%d\n", udev->l1_params.timeout);
553}
554
555static ssize_t usb2_lpm_l1_timeout_store(struct device *dev,
556 struct device_attribute *attr,
557 const char *buf, size_t count)
558{
559 struct usb_device *udev = to_usb_device(dev);
560 u16 timeout;
561
562 if (kstrtou16(buf, 0, &timeout))
563 return -EINVAL;
564
565 udev->l1_params.timeout = timeout;
566
567 return count;
568}
569static DEVICE_ATTR_RW(usb2_lpm_l1_timeout);
570
571static ssize_t usb2_lpm_besl_show(struct device *dev,
572 struct device_attribute *attr, char *buf)
573{
574 struct usb_device *udev = to_usb_device(dev);
575 return sprintf(buf, "%d\n", udev->l1_params.besl);
576}
577
578static ssize_t usb2_lpm_besl_store(struct device *dev,
579 struct device_attribute *attr,
580 const char *buf, size_t count)
581{
582 struct usb_device *udev = to_usb_device(dev);
583 u8 besl;
584
585 if (kstrtou8(buf, 0, &besl) || besl > 15)
586 return -EINVAL;
587
588 udev->l1_params.besl = besl;
589
590 return count;
591}
592static DEVICE_ATTR_RW(usb2_lpm_besl);
593
594static ssize_t usb3_hardware_lpm_u1_show(struct device *dev,
595 struct device_attribute *attr, char *buf)
596{
597 struct usb_device *udev = to_usb_device(dev);
598 const char *p;
599 int rc;
600
601 rc = usb_lock_device_interruptible(udev);
602 if (rc < 0)
603 return -EINTR;
604
605 if (udev->usb3_lpm_u1_enabled)
606 p = "enabled";
607 else
608 p = "disabled";
609
610 usb_unlock_device(udev);
611
612 return sprintf(buf, "%s\n", p);
613}
614static DEVICE_ATTR_RO(usb3_hardware_lpm_u1);
615
616static ssize_t usb3_hardware_lpm_u2_show(struct device *dev,
617 struct device_attribute *attr, char *buf)
618{
619 struct usb_device *udev = to_usb_device(dev);
620 const char *p;
621 int rc;
622
623 rc = usb_lock_device_interruptible(udev);
624 if (rc < 0)
625 return -EINTR;
626
627 if (udev->usb3_lpm_u2_enabled)
628 p = "enabled";
629 else
630 p = "disabled";
631
632 usb_unlock_device(udev);
633
634 return sprintf(buf, "%s\n", p);
635}
636static DEVICE_ATTR_RO(usb3_hardware_lpm_u2);
637
638static struct attribute *usb2_hardware_lpm_attr[] = {
639 &dev_attr_usb2_hardware_lpm.attr,
640 &dev_attr_usb2_lpm_l1_timeout.attr,
641 &dev_attr_usb2_lpm_besl.attr,
642 NULL,
643};
644static struct attribute_group usb2_hardware_lpm_attr_group = {
645 .name = power_group_name,
646 .attrs = usb2_hardware_lpm_attr,
647};
648
649static struct attribute *usb3_hardware_lpm_attr[] = {
650 &dev_attr_usb3_hardware_lpm_u1.attr,
651 &dev_attr_usb3_hardware_lpm_u2.attr,
652 NULL,
653};
654static struct attribute_group usb3_hardware_lpm_attr_group = {
655 .name = power_group_name,
656 .attrs = usb3_hardware_lpm_attr,
657};
658
659static struct attribute *power_attrs[] = {
660 &dev_attr_autosuspend.attr,
661 &dev_attr_level.attr,
662 &dev_attr_connected_duration.attr,
663 &dev_attr_active_duration.attr,
664 NULL,
665};
666static struct attribute_group power_attr_group = {
667 .name = power_group_name,
668 .attrs = power_attrs,
669};
670
671static int add_power_attributes(struct device *dev)
672{
673 int rc = 0;
674
675 if (is_usb_device(dev)) {
676 struct usb_device *udev = to_usb_device(dev);
677 rc = sysfs_merge_group(&dev->kobj, &power_attr_group);
678 if (udev->usb2_hw_lpm_capable == 1)
679 rc = sysfs_merge_group(&dev->kobj,
680 &usb2_hardware_lpm_attr_group);
681 if ((udev->speed == USB_SPEED_SUPER ||
682 udev->speed == USB_SPEED_SUPER_PLUS) &&
683 udev->lpm_capable == 1)
684 rc = sysfs_merge_group(&dev->kobj,
685 &usb3_hardware_lpm_attr_group);
686 }
687
688 return rc;
689}
690
691static void remove_power_attributes(struct device *dev)
692{
693 sysfs_unmerge_group(&dev->kobj, &usb2_hardware_lpm_attr_group);
694 sysfs_unmerge_group(&dev->kobj, &power_attr_group);
695}
696
697#else
698
699#define add_persist_attributes(dev) 0
700#define remove_persist_attributes(dev) do {} while (0)
701
702#define add_power_attributes(dev) 0
703#define remove_power_attributes(dev) do {} while (0)
704
705#endif /* CONFIG_PM */
706
707
708/* Descriptor fields */
709#define usb_descriptor_attr_le16(field, format_string) \
710static ssize_t \
711field##_show(struct device *dev, struct device_attribute *attr, \
712 char *buf) \
713{ \
714 struct usb_device *udev; \
715 \
716 udev = to_usb_device(dev); \
717 return sprintf(buf, format_string, \
718 le16_to_cpu(udev->descriptor.field)); \
719} \
720static DEVICE_ATTR_RO(field)
721
722usb_descriptor_attr_le16(idVendor, "%04x\n");
723usb_descriptor_attr_le16(idProduct, "%04x\n");
724usb_descriptor_attr_le16(bcdDevice, "%04x\n");
725
726#define usb_descriptor_attr(field, format_string) \
727static ssize_t \
728field##_show(struct device *dev, struct device_attribute *attr, \
729 char *buf) \
730{ \
731 struct usb_device *udev; \
732 \
733 udev = to_usb_device(dev); \
734 return sprintf(buf, format_string, udev->descriptor.field); \
735} \
736static DEVICE_ATTR_RO(field)
737
738usb_descriptor_attr(bDeviceClass, "%02x\n");
739usb_descriptor_attr(bDeviceSubClass, "%02x\n");
740usb_descriptor_attr(bDeviceProtocol, "%02x\n");
741usb_descriptor_attr(bNumConfigurations, "%d\n");
742usb_descriptor_attr(bMaxPacketSize0, "%d\n");
743
744
745/* show if the device is authorized (1) or not (0) */
746static ssize_t authorized_show(struct device *dev,
747 struct device_attribute *attr, char *buf)
748{
749 struct usb_device *usb_dev = to_usb_device(dev);
750 return snprintf(buf, PAGE_SIZE, "%u\n", usb_dev->authorized);
751}
752
753/*
754 * Authorize a device to be used in the system
755 *
756 * Writing a 0 deauthorizes the device, writing a 1 authorizes it.
757 */
758static ssize_t authorized_store(struct device *dev,
759 struct device_attribute *attr, const char *buf,
760 size_t size)
761{
762 ssize_t result;
763 struct usb_device *usb_dev = to_usb_device(dev);
764 unsigned val;
765 result = sscanf(buf, "%u\n", &val);
766 if (result != 1)
767 result = -EINVAL;
768 else if (val == 0)
769 result = usb_deauthorize_device(usb_dev);
770 else
771 result = usb_authorize_device(usb_dev);
772 return result < 0 ? result : size;
773}
774static DEVICE_ATTR_IGNORE_LOCKDEP(authorized, S_IRUGO | S_IWUSR,
775 authorized_show, authorized_store);
776
777/* "Safely remove a device" */
778static ssize_t remove_store(struct device *dev, struct device_attribute *attr,
779 const char *buf, size_t count)
780{
781 struct usb_device *udev = to_usb_device(dev);
782 int rc = 0;
783
784 usb_lock_device(udev);
785 if (udev->state != USB_STATE_NOTATTACHED) {
786
787 /* To avoid races, first unconfigure and then remove */
788 usb_set_configuration(udev, -1);
789 rc = usb_remove_device(udev);
790 }
791 if (rc == 0)
792 rc = count;
793 usb_unlock_device(udev);
794 return rc;
795}
796static DEVICE_ATTR_IGNORE_LOCKDEP(remove, S_IWUSR, NULL, remove_store);
797
798
799static struct attribute *dev_attrs[] = {
800 /* current configuration's attributes */
801 &dev_attr_configuration.attr,
802 &dev_attr_bNumInterfaces.attr,
803 &dev_attr_bConfigurationValue.attr,
804 &dev_attr_bmAttributes.attr,
805 &dev_attr_bMaxPower.attr,
806 /* device attributes */
807 &dev_attr_urbnum.attr,
808 &dev_attr_idVendor.attr,
809 &dev_attr_idProduct.attr,
810 &dev_attr_bcdDevice.attr,
811 &dev_attr_bDeviceClass.attr,
812 &dev_attr_bDeviceSubClass.attr,
813 &dev_attr_bDeviceProtocol.attr,
814 &dev_attr_bNumConfigurations.attr,
815 &dev_attr_bMaxPacketSize0.attr,
816 &dev_attr_speed.attr,
817 &dev_attr_rx_lanes.attr,
818 &dev_attr_tx_lanes.attr,
819 &dev_attr_busnum.attr,
820 &dev_attr_devnum.attr,
821 &dev_attr_devpath.attr,
822 &dev_attr_version.attr,
823 &dev_attr_maxchild.attr,
824 &dev_attr_quirks.attr,
825 &dev_attr_avoid_reset_quirk.attr,
826 &dev_attr_authorized.attr,
827 &dev_attr_remove.attr,
828 &dev_attr_removable.attr,
829 &dev_attr_ltm_capable.attr,
830#ifdef CONFIG_OF
831 &dev_attr_devspec.attr,
832#endif
833 NULL,
834};
835static struct attribute_group dev_attr_grp = {
836 .attrs = dev_attrs,
837};
838
839/* When modifying this list, be sure to modify dev_string_attrs_are_visible()
840 * accordingly.
841 */
842static struct attribute *dev_string_attrs[] = {
843 &dev_attr_manufacturer.attr,
844 &dev_attr_product.attr,
845 &dev_attr_serial.attr,
846 NULL
847};
848
849static umode_t dev_string_attrs_are_visible(struct kobject *kobj,
850 struct attribute *a, int n)
851{
852 struct device *dev = kobj_to_dev(kobj);
853 struct usb_device *udev = to_usb_device(dev);
854
855 if (a == &dev_attr_manufacturer.attr) {
856 if (udev->manufacturer == NULL)
857 return 0;
858 } else if (a == &dev_attr_product.attr) {
859 if (udev->product == NULL)
860 return 0;
861 } else if (a == &dev_attr_serial.attr) {
862 if (udev->serial == NULL)
863 return 0;
864 }
865 return a->mode;
866}
867
868static struct attribute_group dev_string_attr_grp = {
869 .attrs = dev_string_attrs,
870 .is_visible = dev_string_attrs_are_visible,
871};
872
873const struct attribute_group *usb_device_groups[] = {
874 &dev_attr_grp,
875 &dev_string_attr_grp,
876 NULL
877};
878
879/* Binary descriptors */
880
881static ssize_t
882read_descriptors(struct file *filp, struct kobject *kobj,
883 struct bin_attribute *attr,
884 char *buf, loff_t off, size_t count)
885{
886 struct device *dev = kobj_to_dev(kobj);
887 struct usb_device *udev = to_usb_device(dev);
888 size_t nleft = count;
889 size_t srclen, n;
890 int cfgno;
891 void *src;
892 int retval;
893
894 retval = usb_lock_device_interruptible(udev);
895 if (retval < 0)
896 return -EINTR;
897 /* The binary attribute begins with the device descriptor.
898 * Following that are the raw descriptor entries for all the
899 * configurations (config plus subsidiary descriptors).
900 */
901 for (cfgno = -1; cfgno < udev->descriptor.bNumConfigurations &&
902 nleft > 0; ++cfgno) {
903 if (cfgno < 0) {
904 src = &udev->descriptor;
905 srclen = sizeof(struct usb_device_descriptor);
906 } else {
907 src = udev->rawdescriptors[cfgno];
908 srclen = __le16_to_cpu(udev->config[cfgno].desc.
909 wTotalLength);
910 }
911 if (off < srclen) {
912 n = min(nleft, srclen - (size_t) off);
913 memcpy(buf, src + off, n);
914 nleft -= n;
915 buf += n;
916 off = 0;
917 } else {
918 off -= srclen;
919 }
920 }
921 usb_unlock_device(udev);
922 return count - nleft;
923}
924
925static struct bin_attribute dev_bin_attr_descriptors = {
926 .attr = {.name = "descriptors", .mode = 0444},
927 .read = read_descriptors,
928 .size = 18 + 65535, /* dev descr + max-size raw descriptor */
929};
930
931/*
932 * Show & store the current value of authorized_default
933 */
934static ssize_t authorized_default_show(struct device *dev,
935 struct device_attribute *attr, char *buf)
936{
937 struct usb_device *rh_usb_dev = to_usb_device(dev);
938 struct usb_bus *usb_bus = rh_usb_dev->bus;
939 struct usb_hcd *hcd;
940
941 hcd = bus_to_hcd(usb_bus);
942 return snprintf(buf, PAGE_SIZE, "%u\n", hcd->dev_policy);
943}
944
945static ssize_t authorized_default_store(struct device *dev,
946 struct device_attribute *attr,
947 const char *buf, size_t size)
948{
949 ssize_t result;
950 unsigned int val;
951 struct usb_device *rh_usb_dev = to_usb_device(dev);
952 struct usb_bus *usb_bus = rh_usb_dev->bus;
953 struct usb_hcd *hcd;
954
955 hcd = bus_to_hcd(usb_bus);
956 result = sscanf(buf, "%u\n", &val);
957 if (result == 1) {
958 hcd->dev_policy = val <= USB_DEVICE_AUTHORIZE_INTERNAL ?
959 val : USB_DEVICE_AUTHORIZE_ALL;
960 result = size;
961 } else {
962 result = -EINVAL;
963 }
964 return result;
965}
966static DEVICE_ATTR_RW(authorized_default);
967
968/*
969 * interface_authorized_default_show - show default authorization status
970 * for USB interfaces
971 *
972 * note: interface_authorized_default is the default value
973 * for initializing the authorized attribute of interfaces
974 */
975static ssize_t interface_authorized_default_show(struct device *dev,
976 struct device_attribute *attr, char *buf)
977{
978 struct usb_device *usb_dev = to_usb_device(dev);
979 struct usb_hcd *hcd = bus_to_hcd(usb_dev->bus);
980
981 return sprintf(buf, "%u\n", !!HCD_INTF_AUTHORIZED(hcd));
982}
983
984/*
985 * interface_authorized_default_store - store default authorization status
986 * for USB interfaces
987 *
988 * note: interface_authorized_default is the default value
989 * for initializing the authorized attribute of interfaces
990 */
991static ssize_t interface_authorized_default_store(struct device *dev,
992 struct device_attribute *attr, const char *buf, size_t count)
993{
994 struct usb_device *usb_dev = to_usb_device(dev);
995 struct usb_hcd *hcd = bus_to_hcd(usb_dev->bus);
996 int rc = count;
997 bool val;
998
999 if (strtobool(buf, &val) != 0)
1000 return -EINVAL;
1001
1002 if (val)
1003 set_bit(HCD_FLAG_INTF_AUTHORIZED, &hcd->flags);
1004 else
1005 clear_bit(HCD_FLAG_INTF_AUTHORIZED, &hcd->flags);
1006
1007 return rc;
1008}
1009static DEVICE_ATTR_RW(interface_authorized_default);
1010
1011/* Group all the USB bus attributes */
1012static struct attribute *usb_bus_attrs[] = {
1013 &dev_attr_authorized_default.attr,
1014 &dev_attr_interface_authorized_default.attr,
1015 NULL,
1016};
1017
1018static const struct attribute_group usb_bus_attr_group = {
1019 .name = NULL, /* we want them in the same directory */
1020 .attrs = usb_bus_attrs,
1021};
1022
1023
1024static int add_default_authorized_attributes(struct device *dev)
1025{
1026 int rc = 0;
1027
1028 if (is_usb_device(dev))
1029 rc = sysfs_create_group(&dev->kobj, &usb_bus_attr_group);
1030
1031 return rc;
1032}
1033
1034static void remove_default_authorized_attributes(struct device *dev)
1035{
1036 if (is_usb_device(dev)) {
1037 sysfs_remove_group(&dev->kobj, &usb_bus_attr_group);
1038 }
1039}
1040
1041int usb_create_sysfs_dev_files(struct usb_device *udev)
1042{
1043 struct device *dev = &udev->dev;
1044 int retval;
1045
1046 retval = device_create_bin_file(dev, &dev_bin_attr_descriptors);
1047 if (retval)
1048 goto error;
1049
1050 retval = add_persist_attributes(dev);
1051 if (retval)
1052 goto error;
1053
1054 retval = add_power_attributes(dev);
1055 if (retval)
1056 goto error;
1057
1058 if (is_root_hub(udev)) {
1059 retval = add_default_authorized_attributes(dev);
1060 if (retval)
1061 goto error;
1062 }
1063 return retval;
1064
1065error:
1066 usb_remove_sysfs_dev_files(udev);
1067 return retval;
1068}
1069
1070void usb_remove_sysfs_dev_files(struct usb_device *udev)
1071{
1072 struct device *dev = &udev->dev;
1073
1074 if (is_root_hub(udev))
1075 remove_default_authorized_attributes(dev);
1076
1077 remove_power_attributes(dev);
1078 remove_persist_attributes(dev);
1079 device_remove_bin_file(dev, &dev_bin_attr_descriptors);
1080}
1081
1082/* Interface Association Descriptor fields */
1083#define usb_intf_assoc_attr(field, format_string) \
1084static ssize_t \
1085iad_##field##_show(struct device *dev, struct device_attribute *attr, \
1086 char *buf) \
1087{ \
1088 struct usb_interface *intf = to_usb_interface(dev); \
1089 \
1090 return sprintf(buf, format_string, \
1091 intf->intf_assoc->field); \
1092} \
1093static DEVICE_ATTR_RO(iad_##field)
1094
1095usb_intf_assoc_attr(bFirstInterface, "%02x\n");
1096usb_intf_assoc_attr(bInterfaceCount, "%02d\n");
1097usb_intf_assoc_attr(bFunctionClass, "%02x\n");
1098usb_intf_assoc_attr(bFunctionSubClass, "%02x\n");
1099usb_intf_assoc_attr(bFunctionProtocol, "%02x\n");
1100
1101/* Interface fields */
1102#define usb_intf_attr(field, format_string) \
1103static ssize_t \
1104field##_show(struct device *dev, struct device_attribute *attr, \
1105 char *buf) \
1106{ \
1107 struct usb_interface *intf = to_usb_interface(dev); \
1108 \
1109 return sprintf(buf, format_string, \
1110 intf->cur_altsetting->desc.field); \
1111} \
1112static DEVICE_ATTR_RO(field)
1113
1114usb_intf_attr(bInterfaceNumber, "%02x\n");
1115usb_intf_attr(bAlternateSetting, "%2d\n");
1116usb_intf_attr(bNumEndpoints, "%02x\n");
1117usb_intf_attr(bInterfaceClass, "%02x\n");
1118usb_intf_attr(bInterfaceSubClass, "%02x\n");
1119usb_intf_attr(bInterfaceProtocol, "%02x\n");
1120
1121static ssize_t interface_show(struct device *dev, struct device_attribute *attr,
1122 char *buf)
1123{
1124 struct usb_interface *intf;
1125 char *string;
1126
1127 intf = to_usb_interface(dev);
1128 string = READ_ONCE(intf->cur_altsetting->string);
1129 if (!string)
1130 return 0;
1131 return sprintf(buf, "%s\n", string);
1132}
1133static DEVICE_ATTR_RO(interface);
1134
1135static ssize_t modalias_show(struct device *dev, struct device_attribute *attr,
1136 char *buf)
1137{
1138 struct usb_interface *intf;
1139 struct usb_device *udev;
1140 struct usb_host_interface *alt;
1141
1142 intf = to_usb_interface(dev);
1143 udev = interface_to_usbdev(intf);
1144 alt = READ_ONCE(intf->cur_altsetting);
1145
1146 return sprintf(buf, "usb:v%04Xp%04Xd%04Xdc%02Xdsc%02Xdp%02X"
1147 "ic%02Xisc%02Xip%02Xin%02X\n",
1148 le16_to_cpu(udev->descriptor.idVendor),
1149 le16_to_cpu(udev->descriptor.idProduct),
1150 le16_to_cpu(udev->descriptor.bcdDevice),
1151 udev->descriptor.bDeviceClass,
1152 udev->descriptor.bDeviceSubClass,
1153 udev->descriptor.bDeviceProtocol,
1154 alt->desc.bInterfaceClass,
1155 alt->desc.bInterfaceSubClass,
1156 alt->desc.bInterfaceProtocol,
1157 alt->desc.bInterfaceNumber);
1158}
1159static DEVICE_ATTR_RO(modalias);
1160
1161static ssize_t supports_autosuspend_show(struct device *dev,
1162 struct device_attribute *attr,
1163 char *buf)
1164{
1165 int s;
1166
1167 s = device_lock_interruptible(dev);
1168 if (s < 0)
1169 return -EINTR;
1170 /* Devices will be autosuspended even when an interface isn't claimed */
1171 s = (!dev->driver || to_usb_driver(dev->driver)->supports_autosuspend);
1172 device_unlock(dev);
1173
1174 return sprintf(buf, "%u\n", s);
1175}
1176static DEVICE_ATTR_RO(supports_autosuspend);
1177
1178/*
1179 * interface_authorized_show - show authorization status of an USB interface
1180 * 1 is authorized, 0 is deauthorized
1181 */
1182static ssize_t interface_authorized_show(struct device *dev,
1183 struct device_attribute *attr, char *buf)
1184{
1185 struct usb_interface *intf = to_usb_interface(dev);
1186
1187 return sprintf(buf, "%u\n", intf->authorized);
1188}
1189
1190/*
1191 * interface_authorized_store - authorize or deauthorize an USB interface
1192 */
1193static ssize_t interface_authorized_store(struct device *dev,
1194 struct device_attribute *attr, const char *buf, size_t count)
1195{
1196 struct usb_interface *intf = to_usb_interface(dev);
1197 bool val;
1198
1199 if (strtobool(buf, &val) != 0)
1200 return -EINVAL;
1201
1202 if (val)
1203 usb_authorize_interface(intf);
1204 else
1205 usb_deauthorize_interface(intf);
1206
1207 return count;
1208}
1209static struct device_attribute dev_attr_interface_authorized =
1210 __ATTR(authorized, S_IRUGO | S_IWUSR,
1211 interface_authorized_show, interface_authorized_store);
1212
1213static struct attribute *intf_attrs[] = {
1214 &dev_attr_bInterfaceNumber.attr,
1215 &dev_attr_bAlternateSetting.attr,
1216 &dev_attr_bNumEndpoints.attr,
1217 &dev_attr_bInterfaceClass.attr,
1218 &dev_attr_bInterfaceSubClass.attr,
1219 &dev_attr_bInterfaceProtocol.attr,
1220 &dev_attr_modalias.attr,
1221 &dev_attr_supports_autosuspend.attr,
1222 &dev_attr_interface_authorized.attr,
1223 NULL,
1224};
1225static struct attribute_group intf_attr_grp = {
1226 .attrs = intf_attrs,
1227};
1228
1229static struct attribute *intf_assoc_attrs[] = {
1230 &dev_attr_iad_bFirstInterface.attr,
1231 &dev_attr_iad_bInterfaceCount.attr,
1232 &dev_attr_iad_bFunctionClass.attr,
1233 &dev_attr_iad_bFunctionSubClass.attr,
1234 &dev_attr_iad_bFunctionProtocol.attr,
1235 NULL,
1236};
1237
1238static umode_t intf_assoc_attrs_are_visible(struct kobject *kobj,
1239 struct attribute *a, int n)
1240{
1241 struct device *dev = kobj_to_dev(kobj);
1242 struct usb_interface *intf = to_usb_interface(dev);
1243
1244 if (intf->intf_assoc == NULL)
1245 return 0;
1246 return a->mode;
1247}
1248
1249static struct attribute_group intf_assoc_attr_grp = {
1250 .attrs = intf_assoc_attrs,
1251 .is_visible = intf_assoc_attrs_are_visible,
1252};
1253
1254const struct attribute_group *usb_interface_groups[] = {
1255 &intf_attr_grp,
1256 &intf_assoc_attr_grp,
1257 NULL
1258};
1259
1260void usb_create_sysfs_intf_files(struct usb_interface *intf)
1261{
1262 struct usb_device *udev = interface_to_usbdev(intf);
1263 struct usb_host_interface *alt = intf->cur_altsetting;
1264
1265 if (intf->sysfs_files_created || intf->unregistering)
1266 return;
1267
1268 if (!alt->string && !(udev->quirks & USB_QUIRK_CONFIG_INTF_STRINGS))
1269 alt->string = usb_cache_string(udev, alt->desc.iInterface);
1270 if (alt->string && device_create_file(&intf->dev, &dev_attr_interface)) {
1271 /* This is not a serious error */
1272 dev_dbg(&intf->dev, "interface string descriptor file not created\n");
1273 }
1274 intf->sysfs_files_created = 1;
1275}
1276
1277void usb_remove_sysfs_intf_files(struct usb_interface *intf)
1278{
1279 if (!intf->sysfs_files_created)
1280 return;
1281
1282 device_remove_file(&intf->dev, &dev_attr_interface);
1283 intf->sysfs_files_created = 0;
1284}