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