2 * drivers/usb/core/sysfs.c
4 * (C) Copyright 2002 David Brownell
5 * (C) Copyright 2002,2004 Greg Kroah-Hartman
6 * (C) Copyright 2002,2004 IBM Corp.
8 * All of the sysfs file attributes for usb devices and interfaces.
10 * Released under the GPLv2 only.
11 * SPDX-License-Identifier: GPL-2.0
15 #include <linux/kernel.h>
16 #include <linux/string.h>
17 #include <linux/usb.h>
18 #include <linux/usb/quirks.h>
22 /* Active configuration fields */
23 #define usb_actconfig_show(field, format_string) \
24 static ssize_t field##_show(struct device *dev, \
25 struct device_attribute *attr, char *buf) \
27 struct usb_device *udev; \
28 struct usb_host_config *actconfig; \
31 udev = to_usb_device(dev); \
32 rc = usb_lock_device_interruptible(udev); \
35 actconfig = udev->actconfig; \
37 rc = sprintf(buf, format_string, \
38 actconfig->desc.field); \
39 usb_unlock_device(udev); \
43 #define usb_actconfig_attr(field, format_string) \
44 usb_actconfig_show(field, format_string) \
45 static DEVICE_ATTR_RO(field)
47 usb_actconfig_attr(bNumInterfaces, "%2d\n");
48 usb_actconfig_attr(bmAttributes, "%2x\n");
50 static ssize_t bMaxPower_show(struct device *dev,
51 struct device_attribute *attr, char *buf)
53 struct usb_device *udev;
54 struct usb_host_config *actconfig;
57 udev = to_usb_device(dev);
58 rc = usb_lock_device_interruptible(udev);
61 actconfig = udev->actconfig;
63 rc = sprintf(buf, "%dmA\n", usb_get_max_power(udev, actconfig));
64 usb_unlock_device(udev);
67 static DEVICE_ATTR_RO(bMaxPower);
69 static ssize_t configuration_show(struct device *dev,
70 struct device_attribute *attr, char *buf)
72 struct usb_device *udev;
73 struct usb_host_config *actconfig;
76 udev = to_usb_device(dev);
77 rc = usb_lock_device_interruptible(udev);
80 actconfig = udev->actconfig;
81 if (actconfig && actconfig->string)
82 rc = sprintf(buf, "%s\n", actconfig->string);
83 usb_unlock_device(udev);
86 static DEVICE_ATTR_RO(configuration);
88 /* configuration value is always present, and r/w */
89 usb_actconfig_show(bConfigurationValue, "%u\n");
91 static ssize_t bConfigurationValue_store(struct device *dev,
92 struct device_attribute *attr,
93 const char *buf, size_t count)
95 struct usb_device *udev = to_usb_device(dev);
96 int config, value, rc;
98 if (sscanf(buf, "%d", &config) != 1 || config < -1 || config > 255)
100 rc = usb_lock_device_interruptible(udev);
103 value = usb_set_configuration(udev, config);
104 usb_unlock_device(udev);
105 return (value < 0) ? value : count;
107 static DEVICE_ATTR_IGNORE_LOCKDEP(bConfigurationValue, S_IRUGO | S_IWUSR,
108 bConfigurationValue_show, bConfigurationValue_store);
111 static ssize_t devspec_show(struct device *dev, struct device_attribute *attr,
114 struct device_node *of_node = dev->of_node;
116 return sprintf(buf, "%pOF\n", of_node);
118 static DEVICE_ATTR_RO(devspec);
122 #define usb_string_attr(name) \
123 static ssize_t name##_show(struct device *dev, \
124 struct device_attribute *attr, char *buf) \
126 struct usb_device *udev; \
129 udev = to_usb_device(dev); \
130 retval = usb_lock_device_interruptible(udev); \
133 retval = sprintf(buf, "%s\n", udev->name); \
134 usb_unlock_device(udev); \
137 static DEVICE_ATTR_RO(name)
139 usb_string_attr(product);
140 usb_string_attr(manufacturer);
141 usb_string_attr(serial);
143 static ssize_t speed_show(struct device *dev, struct device_attribute *attr,
146 struct usb_device *udev;
149 udev = to_usb_device(dev);
151 switch (udev->speed) {
155 case USB_SPEED_UNKNOWN:
162 case USB_SPEED_WIRELESS:
165 case USB_SPEED_SUPER:
168 case USB_SPEED_SUPER_PLUS:
174 return sprintf(buf, "%s\n", speed);
176 static DEVICE_ATTR_RO(speed);
178 static ssize_t busnum_show(struct device *dev, struct device_attribute *attr,
181 struct usb_device *udev;
183 udev = to_usb_device(dev);
184 return sprintf(buf, "%d\n", udev->bus->busnum);
186 static DEVICE_ATTR_RO(busnum);
188 static ssize_t devnum_show(struct device *dev, struct device_attribute *attr,
191 struct usb_device *udev;
193 udev = to_usb_device(dev);
194 return sprintf(buf, "%d\n", udev->devnum);
196 static DEVICE_ATTR_RO(devnum);
198 static ssize_t devpath_show(struct device *dev, struct device_attribute *attr,
201 struct usb_device *udev;
203 udev = to_usb_device(dev);
204 return sprintf(buf, "%s\n", udev->devpath);
206 static DEVICE_ATTR_RO(devpath);
208 static ssize_t version_show(struct device *dev, struct device_attribute *attr,
211 struct usb_device *udev;
214 udev = to_usb_device(dev);
215 bcdUSB = le16_to_cpu(udev->descriptor.bcdUSB);
216 return sprintf(buf, "%2x.%02x\n", bcdUSB >> 8, bcdUSB & 0xff);
218 static DEVICE_ATTR_RO(version);
220 static ssize_t maxchild_show(struct device *dev, struct device_attribute *attr,
223 struct usb_device *udev;
225 udev = to_usb_device(dev);
226 return sprintf(buf, "%d\n", udev->maxchild);
228 static DEVICE_ATTR_RO(maxchild);
230 static ssize_t quirks_show(struct device *dev, struct device_attribute *attr,
233 struct usb_device *udev;
235 udev = to_usb_device(dev);
236 return sprintf(buf, "0x%x\n", udev->quirks);
238 static DEVICE_ATTR_RO(quirks);
240 static ssize_t avoid_reset_quirk_show(struct device *dev,
241 struct device_attribute *attr, char *buf)
243 struct usb_device *udev;
245 udev = to_usb_device(dev);
246 return sprintf(buf, "%d\n", !!(udev->quirks & USB_QUIRK_RESET));
249 static ssize_t avoid_reset_quirk_store(struct device *dev,
250 struct device_attribute *attr,
251 const char *buf, size_t count)
253 struct usb_device *udev = to_usb_device(dev);
256 if (sscanf(buf, "%d", &val) != 1 || val < 0 || val > 1)
258 rc = usb_lock_device_interruptible(udev);
262 udev->quirks |= USB_QUIRK_RESET;
264 udev->quirks &= ~USB_QUIRK_RESET;
265 usb_unlock_device(udev);
268 static DEVICE_ATTR_RW(avoid_reset_quirk);
270 static ssize_t urbnum_show(struct device *dev, struct device_attribute *attr,
273 struct usb_device *udev;
275 udev = to_usb_device(dev);
276 return sprintf(buf, "%d\n", atomic_read(&udev->urbnum));
278 static DEVICE_ATTR_RO(urbnum);
280 static ssize_t removable_show(struct device *dev, struct device_attribute *attr,
283 struct usb_device *udev;
286 udev = to_usb_device(dev);
288 switch (udev->removable) {
289 case USB_DEVICE_REMOVABLE:
292 case USB_DEVICE_FIXED:
299 return sprintf(buf, "%s\n", state);
301 static DEVICE_ATTR_RO(removable);
303 static ssize_t ltm_capable_show(struct device *dev,
304 struct device_attribute *attr, char *buf)
306 if (usb_device_supports_ltm(to_usb_device(dev)))
307 return sprintf(buf, "%s\n", "yes");
308 return sprintf(buf, "%s\n", "no");
310 static DEVICE_ATTR_RO(ltm_capable);
314 static ssize_t persist_show(struct device *dev, struct device_attribute *attr,
317 struct usb_device *udev = to_usb_device(dev);
319 return sprintf(buf, "%d\n", udev->persist_enabled);
322 static ssize_t persist_store(struct device *dev, struct device_attribute *attr,
323 const char *buf, size_t count)
325 struct usb_device *udev = to_usb_device(dev);
328 /* Hubs are always enabled for USB_PERSIST */
329 if (udev->descriptor.bDeviceClass == USB_CLASS_HUB)
332 if (sscanf(buf, "%d", &value) != 1)
335 rc = usb_lock_device_interruptible(udev);
338 udev->persist_enabled = !!value;
339 usb_unlock_device(udev);
342 static DEVICE_ATTR_RW(persist);
344 static int add_persist_attributes(struct device *dev)
348 if (is_usb_device(dev)) {
349 struct usb_device *udev = to_usb_device(dev);
351 /* Hubs are automatically enabled for USB_PERSIST,
352 * no point in creating the attribute file.
354 if (udev->descriptor.bDeviceClass != USB_CLASS_HUB)
355 rc = sysfs_add_file_to_group(&dev->kobj,
356 &dev_attr_persist.attr,
362 static void remove_persist_attributes(struct device *dev)
364 sysfs_remove_file_from_group(&dev->kobj,
365 &dev_attr_persist.attr,
369 static ssize_t connected_duration_show(struct device *dev,
370 struct device_attribute *attr, char *buf)
372 struct usb_device *udev = to_usb_device(dev);
374 return sprintf(buf, "%u\n",
375 jiffies_to_msecs(jiffies - udev->connect_time));
377 static DEVICE_ATTR_RO(connected_duration);
380 * If the device is resumed, the last time the device was suspended has
381 * been pre-subtracted from active_duration. We add the current time to
382 * get the duration that the device was actually active.
384 * If the device is suspended, the active_duration is up-to-date.
386 static ssize_t active_duration_show(struct device *dev,
387 struct device_attribute *attr, char *buf)
389 struct usb_device *udev = to_usb_device(dev);
392 if (udev->state != USB_STATE_SUSPENDED)
393 duration = jiffies_to_msecs(jiffies + udev->active_duration);
395 duration = jiffies_to_msecs(udev->active_duration);
396 return sprintf(buf, "%u\n", duration);
398 static DEVICE_ATTR_RO(active_duration);
400 static ssize_t autosuspend_show(struct device *dev,
401 struct device_attribute *attr, char *buf)
403 return sprintf(buf, "%d\n", dev->power.autosuspend_delay / 1000);
406 static ssize_t autosuspend_store(struct device *dev,
407 struct device_attribute *attr, const char *buf,
412 if (sscanf(buf, "%d", &value) != 1 || value >= INT_MAX/1000 ||
413 value <= -INT_MAX/1000)
416 pm_runtime_set_autosuspend_delay(dev, value * 1000);
419 static DEVICE_ATTR_RW(autosuspend);
421 static const char on_string[] = "on";
422 static const char auto_string[] = "auto";
424 static void warn_level(void)
426 static int level_warned;
430 printk(KERN_WARNING "WARNING! power/level is deprecated; "
431 "use power/control instead\n");
435 static ssize_t level_show(struct device *dev, struct device_attribute *attr,
438 struct usb_device *udev = to_usb_device(dev);
439 const char *p = auto_string;
442 if (udev->state != USB_STATE_SUSPENDED && !udev->dev.power.runtime_auto)
444 return sprintf(buf, "%s\n", p);
447 static ssize_t level_store(struct device *dev, struct device_attribute *attr,
448 const char *buf, size_t count)
450 struct usb_device *udev = to_usb_device(dev);
457 cp = memchr(buf, '\n', count);
461 rv = usb_lock_device_interruptible(udev);
465 if (len == sizeof on_string - 1 &&
466 strncmp(buf, on_string, len) == 0)
467 usb_disable_autosuspend(udev);
469 else if (len == sizeof auto_string - 1 &&
470 strncmp(buf, auto_string, len) == 0)
471 usb_enable_autosuspend(udev);
476 usb_unlock_device(udev);
479 static DEVICE_ATTR_RW(level);
481 static ssize_t usb2_hardware_lpm_show(struct device *dev,
482 struct device_attribute *attr, char *buf)
484 struct usb_device *udev = to_usb_device(dev);
487 if (udev->usb2_hw_lpm_allowed == 1)
492 return sprintf(buf, "%s\n", p);
495 static ssize_t usb2_hardware_lpm_store(struct device *dev,
496 struct device_attribute *attr,
497 const char *buf, size_t count)
499 struct usb_device *udev = to_usb_device(dev);
503 ret = usb_lock_device_interruptible(udev);
507 ret = strtobool(buf, &value);
510 udev->usb2_hw_lpm_allowed = value;
511 ret = usb_set_usb2_hardware_lpm(udev, value);
514 usb_unlock_device(udev);
521 static DEVICE_ATTR_RW(usb2_hardware_lpm);
523 static ssize_t usb2_lpm_l1_timeout_show(struct device *dev,
524 struct device_attribute *attr,
527 struct usb_device *udev = to_usb_device(dev);
528 return sprintf(buf, "%d\n", udev->l1_params.timeout);
531 static ssize_t usb2_lpm_l1_timeout_store(struct device *dev,
532 struct device_attribute *attr,
533 const char *buf, size_t count)
535 struct usb_device *udev = to_usb_device(dev);
538 if (kstrtou16(buf, 0, &timeout))
541 udev->l1_params.timeout = timeout;
545 static DEVICE_ATTR_RW(usb2_lpm_l1_timeout);
547 static ssize_t usb2_lpm_besl_show(struct device *dev,
548 struct device_attribute *attr, char *buf)
550 struct usb_device *udev = to_usb_device(dev);
551 return sprintf(buf, "%d\n", udev->l1_params.besl);
554 static ssize_t usb2_lpm_besl_store(struct device *dev,
555 struct device_attribute *attr,
556 const char *buf, size_t count)
558 struct usb_device *udev = to_usb_device(dev);
561 if (kstrtou8(buf, 0, &besl) || besl > 15)
564 udev->l1_params.besl = besl;
568 static DEVICE_ATTR_RW(usb2_lpm_besl);
570 static ssize_t usb3_hardware_lpm_u1_show(struct device *dev,
571 struct device_attribute *attr, char *buf)
573 struct usb_device *udev = to_usb_device(dev);
577 rc = usb_lock_device_interruptible(udev);
581 if (udev->usb3_lpm_u1_enabled)
586 usb_unlock_device(udev);
588 return sprintf(buf, "%s\n", p);
590 static DEVICE_ATTR_RO(usb3_hardware_lpm_u1);
592 static ssize_t usb3_hardware_lpm_u2_show(struct device *dev,
593 struct device_attribute *attr, char *buf)
595 struct usb_device *udev = to_usb_device(dev);
599 rc = usb_lock_device_interruptible(udev);
603 if (udev->usb3_lpm_u2_enabled)
608 usb_unlock_device(udev);
610 return sprintf(buf, "%s\n", p);
612 static DEVICE_ATTR_RO(usb3_hardware_lpm_u2);
614 static struct attribute *usb2_hardware_lpm_attr[] = {
615 &dev_attr_usb2_hardware_lpm.attr,
616 &dev_attr_usb2_lpm_l1_timeout.attr,
617 &dev_attr_usb2_lpm_besl.attr,
620 static struct attribute_group usb2_hardware_lpm_attr_group = {
621 .name = power_group_name,
622 .attrs = usb2_hardware_lpm_attr,
625 static struct attribute *usb3_hardware_lpm_attr[] = {
626 &dev_attr_usb3_hardware_lpm_u1.attr,
627 &dev_attr_usb3_hardware_lpm_u2.attr,
630 static struct attribute_group usb3_hardware_lpm_attr_group = {
631 .name = power_group_name,
632 .attrs = usb3_hardware_lpm_attr,
635 static struct attribute *power_attrs[] = {
636 &dev_attr_autosuspend.attr,
637 &dev_attr_level.attr,
638 &dev_attr_connected_duration.attr,
639 &dev_attr_active_duration.attr,
642 static struct attribute_group power_attr_group = {
643 .name = power_group_name,
644 .attrs = power_attrs,
647 static int add_power_attributes(struct device *dev)
651 if (is_usb_device(dev)) {
652 struct usb_device *udev = to_usb_device(dev);
653 rc = sysfs_merge_group(&dev->kobj, &power_attr_group);
654 if (udev->usb2_hw_lpm_capable == 1)
655 rc = sysfs_merge_group(&dev->kobj,
656 &usb2_hardware_lpm_attr_group);
657 if (udev->speed == USB_SPEED_SUPER &&
658 udev->lpm_capable == 1)
659 rc = sysfs_merge_group(&dev->kobj,
660 &usb3_hardware_lpm_attr_group);
666 static void remove_power_attributes(struct device *dev)
668 sysfs_unmerge_group(&dev->kobj, &usb2_hardware_lpm_attr_group);
669 sysfs_unmerge_group(&dev->kobj, &power_attr_group);
674 #define add_persist_attributes(dev) 0
675 #define remove_persist_attributes(dev) do {} while (0)
677 #define add_power_attributes(dev) 0
678 #define remove_power_attributes(dev) do {} while (0)
680 #endif /* CONFIG_PM */
683 /* Descriptor fields */
684 #define usb_descriptor_attr_le16(field, format_string) \
686 field##_show(struct device *dev, struct device_attribute *attr, \
689 struct usb_device *udev; \
691 udev = to_usb_device(dev); \
692 return sprintf(buf, format_string, \
693 le16_to_cpu(udev->descriptor.field)); \
695 static DEVICE_ATTR_RO(field)
697 usb_descriptor_attr_le16(idVendor, "%04x\n");
698 usb_descriptor_attr_le16(idProduct, "%04x\n");
699 usb_descriptor_attr_le16(bcdDevice, "%04x\n");
701 #define usb_descriptor_attr(field, format_string) \
703 field##_show(struct device *dev, struct device_attribute *attr, \
706 struct usb_device *udev; \
708 udev = to_usb_device(dev); \
709 return sprintf(buf, format_string, udev->descriptor.field); \
711 static DEVICE_ATTR_RO(field)
713 usb_descriptor_attr(bDeviceClass, "%02x\n");
714 usb_descriptor_attr(bDeviceSubClass, "%02x\n");
715 usb_descriptor_attr(bDeviceProtocol, "%02x\n");
716 usb_descriptor_attr(bNumConfigurations, "%d\n");
717 usb_descriptor_attr(bMaxPacketSize0, "%d\n");
720 /* show if the device is authorized (1) or not (0) */
721 static ssize_t authorized_show(struct device *dev,
722 struct device_attribute *attr, char *buf)
724 struct usb_device *usb_dev = to_usb_device(dev);
725 return snprintf(buf, PAGE_SIZE, "%u\n", usb_dev->authorized);
729 * Authorize a device to be used in the system
731 * Writing a 0 deauthorizes the device, writing a 1 authorizes it.
733 static ssize_t authorized_store(struct device *dev,
734 struct device_attribute *attr, const char *buf,
738 struct usb_device *usb_dev = to_usb_device(dev);
740 result = sscanf(buf, "%u\n", &val);
744 result = usb_deauthorize_device(usb_dev);
746 result = usb_authorize_device(usb_dev);
747 return result < 0 ? result : size;
749 static DEVICE_ATTR_IGNORE_LOCKDEP(authorized, S_IRUGO | S_IWUSR,
750 authorized_show, authorized_store);
752 /* "Safely remove a device" */
753 static ssize_t remove_store(struct device *dev, struct device_attribute *attr,
754 const char *buf, size_t count)
756 struct usb_device *udev = to_usb_device(dev);
759 usb_lock_device(udev);
760 if (udev->state != USB_STATE_NOTATTACHED) {
762 /* To avoid races, first unconfigure and then remove */
763 usb_set_configuration(udev, -1);
764 rc = usb_remove_device(udev);
768 usb_unlock_device(udev);
771 static DEVICE_ATTR_IGNORE_LOCKDEP(remove, S_IWUSR, NULL, remove_store);
774 static struct attribute *dev_attrs[] = {
775 /* current configuration's attributes */
776 &dev_attr_configuration.attr,
777 &dev_attr_bNumInterfaces.attr,
778 &dev_attr_bConfigurationValue.attr,
779 &dev_attr_bmAttributes.attr,
780 &dev_attr_bMaxPower.attr,
781 /* device attributes */
782 &dev_attr_urbnum.attr,
783 &dev_attr_idVendor.attr,
784 &dev_attr_idProduct.attr,
785 &dev_attr_bcdDevice.attr,
786 &dev_attr_bDeviceClass.attr,
787 &dev_attr_bDeviceSubClass.attr,
788 &dev_attr_bDeviceProtocol.attr,
789 &dev_attr_bNumConfigurations.attr,
790 &dev_attr_bMaxPacketSize0.attr,
791 &dev_attr_speed.attr,
792 &dev_attr_busnum.attr,
793 &dev_attr_devnum.attr,
794 &dev_attr_devpath.attr,
795 &dev_attr_version.attr,
796 &dev_attr_maxchild.attr,
797 &dev_attr_quirks.attr,
798 &dev_attr_avoid_reset_quirk.attr,
799 &dev_attr_authorized.attr,
800 &dev_attr_remove.attr,
801 &dev_attr_removable.attr,
802 &dev_attr_ltm_capable.attr,
804 &dev_attr_devspec.attr,
808 static struct attribute_group dev_attr_grp = {
812 /* When modifying this list, be sure to modify dev_string_attrs_are_visible()
815 static struct attribute *dev_string_attrs[] = {
816 &dev_attr_manufacturer.attr,
817 &dev_attr_product.attr,
818 &dev_attr_serial.attr,
822 static umode_t dev_string_attrs_are_visible(struct kobject *kobj,
823 struct attribute *a, int n)
825 struct device *dev = container_of(kobj, struct device, kobj);
826 struct usb_device *udev = to_usb_device(dev);
828 if (a == &dev_attr_manufacturer.attr) {
829 if (udev->manufacturer == NULL)
831 } else if (a == &dev_attr_product.attr) {
832 if (udev->product == NULL)
834 } else if (a == &dev_attr_serial.attr) {
835 if (udev->serial == NULL)
841 static struct attribute_group dev_string_attr_grp = {
842 .attrs = dev_string_attrs,
843 .is_visible = dev_string_attrs_are_visible,
846 const struct attribute_group *usb_device_groups[] = {
848 &dev_string_attr_grp,
852 /* Binary descriptors */
855 read_descriptors(struct file *filp, struct kobject *kobj,
856 struct bin_attribute *attr,
857 char *buf, loff_t off, size_t count)
859 struct device *dev = container_of(kobj, struct device, kobj);
860 struct usb_device *udev = to_usb_device(dev);
861 size_t nleft = count;
866 /* The binary attribute begins with the device descriptor.
867 * Following that are the raw descriptor entries for all the
868 * configurations (config plus subsidiary descriptors).
870 for (cfgno = -1; cfgno < udev->descriptor.bNumConfigurations &&
871 nleft > 0; ++cfgno) {
873 src = &udev->descriptor;
874 srclen = sizeof(struct usb_device_descriptor);
876 src = udev->rawdescriptors[cfgno];
877 srclen = __le16_to_cpu(udev->config[cfgno].desc.
881 n = min(nleft, srclen - (size_t) off);
882 memcpy(buf, src + off, n);
890 return count - nleft;
893 static struct bin_attribute dev_bin_attr_descriptors = {
894 .attr = {.name = "descriptors", .mode = 0444},
895 .read = read_descriptors,
896 .size = 18 + 65535, /* dev descr + max-size raw descriptor */
899 int usb_create_sysfs_dev_files(struct usb_device *udev)
901 struct device *dev = &udev->dev;
904 retval = device_create_bin_file(dev, &dev_bin_attr_descriptors);
908 retval = add_persist_attributes(dev);
912 retval = add_power_attributes(dev);
917 usb_remove_sysfs_dev_files(udev);
921 void usb_remove_sysfs_dev_files(struct usb_device *udev)
923 struct device *dev = &udev->dev;
925 remove_power_attributes(dev);
926 remove_persist_attributes(dev);
927 device_remove_bin_file(dev, &dev_bin_attr_descriptors);
930 /* Interface Association Descriptor fields */
931 #define usb_intf_assoc_attr(field, format_string) \
933 iad_##field##_show(struct device *dev, struct device_attribute *attr, \
936 struct usb_interface *intf = to_usb_interface(dev); \
938 return sprintf(buf, format_string, \
939 intf->intf_assoc->field); \
941 static DEVICE_ATTR_RO(iad_##field)
943 usb_intf_assoc_attr(bFirstInterface, "%02x\n");
944 usb_intf_assoc_attr(bInterfaceCount, "%02d\n");
945 usb_intf_assoc_attr(bFunctionClass, "%02x\n");
946 usb_intf_assoc_attr(bFunctionSubClass, "%02x\n");
947 usb_intf_assoc_attr(bFunctionProtocol, "%02x\n");
949 /* Interface fields */
950 #define usb_intf_attr(field, format_string) \
952 field##_show(struct device *dev, struct device_attribute *attr, \
955 struct usb_interface *intf = to_usb_interface(dev); \
957 return sprintf(buf, format_string, \
958 intf->cur_altsetting->desc.field); \
960 static DEVICE_ATTR_RO(field)
962 usb_intf_attr(bInterfaceNumber, "%02x\n");
963 usb_intf_attr(bAlternateSetting, "%2d\n");
964 usb_intf_attr(bNumEndpoints, "%02x\n");
965 usb_intf_attr(bInterfaceClass, "%02x\n");
966 usb_intf_attr(bInterfaceSubClass, "%02x\n");
967 usb_intf_attr(bInterfaceProtocol, "%02x\n");
969 static ssize_t interface_show(struct device *dev, struct device_attribute *attr,
972 struct usb_interface *intf;
975 intf = to_usb_interface(dev);
976 string = ACCESS_ONCE(intf->cur_altsetting->string);
979 return sprintf(buf, "%s\n", string);
981 static DEVICE_ATTR_RO(interface);
983 static ssize_t modalias_show(struct device *dev, struct device_attribute *attr,
986 struct usb_interface *intf;
987 struct usb_device *udev;
988 struct usb_host_interface *alt;
990 intf = to_usb_interface(dev);
991 udev = interface_to_usbdev(intf);
992 alt = ACCESS_ONCE(intf->cur_altsetting);
994 return sprintf(buf, "usb:v%04Xp%04Xd%04Xdc%02Xdsc%02Xdp%02X"
995 "ic%02Xisc%02Xip%02Xin%02X\n",
996 le16_to_cpu(udev->descriptor.idVendor),
997 le16_to_cpu(udev->descriptor.idProduct),
998 le16_to_cpu(udev->descriptor.bcdDevice),
999 udev->descriptor.bDeviceClass,
1000 udev->descriptor.bDeviceSubClass,
1001 udev->descriptor.bDeviceProtocol,
1002 alt->desc.bInterfaceClass,
1003 alt->desc.bInterfaceSubClass,
1004 alt->desc.bInterfaceProtocol,
1005 alt->desc.bInterfaceNumber);
1007 static DEVICE_ATTR_RO(modalias);
1009 static ssize_t supports_autosuspend_show(struct device *dev,
1010 struct device_attribute *attr,
1015 s = device_lock_interruptible(dev);
1018 /* Devices will be autosuspended even when an interface isn't claimed */
1019 s = (!dev->driver || to_usb_driver(dev->driver)->supports_autosuspend);
1022 return sprintf(buf, "%u\n", s);
1024 static DEVICE_ATTR_RO(supports_autosuspend);
1027 * interface_authorized_show - show authorization status of an USB interface
1028 * 1 is authorized, 0 is deauthorized
1030 static ssize_t interface_authorized_show(struct device *dev,
1031 struct device_attribute *attr, char *buf)
1033 struct usb_interface *intf = to_usb_interface(dev);
1035 return sprintf(buf, "%u\n", intf->authorized);
1039 * interface_authorized_store - authorize or deauthorize an USB interface
1041 static ssize_t interface_authorized_store(struct device *dev,
1042 struct device_attribute *attr, const char *buf, size_t count)
1044 struct usb_interface *intf = to_usb_interface(dev);
1047 if (strtobool(buf, &val) != 0)
1051 usb_authorize_interface(intf);
1053 usb_deauthorize_interface(intf);
1057 static struct device_attribute dev_attr_interface_authorized =
1058 __ATTR(authorized, S_IRUGO | S_IWUSR,
1059 interface_authorized_show, interface_authorized_store);
1061 static struct attribute *intf_attrs[] = {
1062 &dev_attr_bInterfaceNumber.attr,
1063 &dev_attr_bAlternateSetting.attr,
1064 &dev_attr_bNumEndpoints.attr,
1065 &dev_attr_bInterfaceClass.attr,
1066 &dev_attr_bInterfaceSubClass.attr,
1067 &dev_attr_bInterfaceProtocol.attr,
1068 &dev_attr_modalias.attr,
1069 &dev_attr_supports_autosuspend.attr,
1070 &dev_attr_interface_authorized.attr,
1073 static struct attribute_group intf_attr_grp = {
1074 .attrs = intf_attrs,
1077 static struct attribute *intf_assoc_attrs[] = {
1078 &dev_attr_iad_bFirstInterface.attr,
1079 &dev_attr_iad_bInterfaceCount.attr,
1080 &dev_attr_iad_bFunctionClass.attr,
1081 &dev_attr_iad_bFunctionSubClass.attr,
1082 &dev_attr_iad_bFunctionProtocol.attr,
1086 static umode_t intf_assoc_attrs_are_visible(struct kobject *kobj,
1087 struct attribute *a, int n)
1089 struct device *dev = container_of(kobj, struct device, kobj);
1090 struct usb_interface *intf = to_usb_interface(dev);
1092 if (intf->intf_assoc == NULL)
1097 static struct attribute_group intf_assoc_attr_grp = {
1098 .attrs = intf_assoc_attrs,
1099 .is_visible = intf_assoc_attrs_are_visible,
1102 const struct attribute_group *usb_interface_groups[] = {
1104 &intf_assoc_attr_grp,
1108 void usb_create_sysfs_intf_files(struct usb_interface *intf)
1110 struct usb_device *udev = interface_to_usbdev(intf);
1111 struct usb_host_interface *alt = intf->cur_altsetting;
1113 if (intf->sysfs_files_created || intf->unregistering)
1116 if (!alt->string && !(udev->quirks & USB_QUIRK_CONFIG_INTF_STRINGS))
1117 alt->string = usb_cache_string(udev, alt->desc.iInterface);
1118 if (alt->string && device_create_file(&intf->dev, &dev_attr_interface))
1119 ; /* We don't actually care if the function fails. */
1120 intf->sysfs_files_created = 1;
1123 void usb_remove_sysfs_intf_files(struct usb_interface *intf)
1125 if (!intf->sysfs_files_created)
1128 device_remove_file(&intf->dev, &dev_attr_interface);
1129 intf->sysfs_files_created = 0;