drivers/usb/core/sysfs.c

   1 /*
   2  * drivers/usb/core/sysfs.c
   3  *
   4  * (C) Copyright 2002 David Brownell
   5  * (C) Copyright 2002,2004 Greg Kroah-Hartman
   6  * (C) Copyright 2002,2004 IBM Corp.
   7  *
   8  * All of the sysfs file attributes for usb devices and interfaces.
   9  *
  10  */
  11
  12
  13 #include <linux/kernel.h>
  14 #include <linux/string.h>
  15 #include <linux/usb.h>
  16 #include <linux/usb/quirks.h>
  17 #include "usb.h"
  18
  19 /* Active configuration fields */
  20 #define usb_actconfig_show(field, format_string)                        \
  21 static ssize_t field##_show(struct device *dev,                         \
  22                             struct device_attribute *attr, char *buf)   \
  23 {                                                                       \
  24         struct usb_device *udev;                                        \
  25         struct usb_host_config *actconfig;                              \
  26         ssize_t rc = 0;                                                 \
  27                                                                         \
  28         udev = to_usb_device(dev);                                      \
  29         usb_lock_device(udev);                                          \
  30         actconfig = udev->actconfig;                                    \
  31         if (actconfig)                                                  \
  32                 rc = sprintf(buf, format_string,                        \
  33                                 actconfig->desc.field);                 \
  34         usb_unlock_device(udev);                                        \
  35         return rc;                                                      \
  36 }                                                                       \
  37
  38 #define usb_actconfig_attr(field, format_string)                \
  39         usb_actconfig_show(field, format_string)                \
  40         static DEVICE_ATTR_RO(field)
  41
  42 usb_actconfig_attr(bNumInterfaces, "%2d\n");
  43 usb_actconfig_attr(bmAttributes, "%2x\n");
  44
  45 static ssize_t bMaxPower_show(struct device *dev,
  46                 struct device_attribute *attr, char *buf)
  47 {
  48         struct usb_device *udev;
  49         struct usb_host_config *actconfig;
  50         ssize_t rc = 0;
  51
  52         udev = to_usb_device(dev);
  53         usb_lock_device(udev);
  54         actconfig = udev->actconfig;
  55         if (actconfig)
  56                 rc = sprintf(buf, "%dmA\n", usb_get_max_power(udev, actconfig));
  57         usb_unlock_device(udev);
  58         return rc;
  59 }
  60 static DEVICE_ATTR_RO(bMaxPower);
  61
  62 static ssize_t configuration_show(struct device *dev,
  63                 struct device_attribute *attr, char *buf)
  64 {
  65         struct usb_device *udev;
  66         struct usb_host_config *actconfig;
  67         ssize_t rc = 0;
  68
  69         udev = to_usb_device(dev);
  70         usb_lock_device(udev);
  71         actconfig = udev->actconfig;
  72         if (actconfig && actconfig->string)
  73                 rc = sprintf(buf, "%s\n", actconfig->string);
  74         usb_unlock_device(udev);
  75         return rc;
  76 }
  77 static DEVICE_ATTR_RO(configuration);
  78
  79 /* configuration value is always present, and r/w */
  80 usb_actconfig_show(bConfigurationValue, "%u\n");
  81
  82 static ssize_t bConfigurationValue_store(struct device *dev,
  83                                          struct device_attribute *attr,
  84                                          const char *buf, size_t count)
  85 {
  86         struct usb_device       *udev = to_usb_device(dev);
  87         int                     config, value;
  88
  89         if (sscanf(buf, "%d", &config) != 1 || config < -1 || config > 255)
  90                 return -EINVAL;
  91         usb_lock_device(udev);
  92         value = usb_set_configuration(udev, config);
  93         usb_unlock_device(udev);
  94         return (value < 0) ? value : count;
  95 }
  96 static DEVICE_ATTR_IGNORE_LOCKDEP(bConfigurationValue, S_IRUGO | S_IWUSR,
  97                 bConfigurationValue_show, bConfigurationValue_store);
  98
  99 /* String fields */
 100 #define usb_string_attr(name)                                           \
 101 static ssize_t  name##_show(struct device *dev,                         \
 102                 struct device_attribute *attr, char *buf)               \
 103 {                                                                       \
 104         struct usb_device *udev;                                        \
 105         int retval;                                                     \
 106                                                                         \
 107         udev = to_usb_device(dev);                                      \
 108         usb_lock_device(udev);                                          \
 109         retval = sprintf(buf, "%s\n", udev->name);                      \
 110         usb_unlock_device(udev);                                        \
 111         return retval;                                                  \
 112 }                                                                       \
 113 static DEVICE_ATTR_RO(name)
 114
 115 usb_string_attr(product);
 116 usb_string_attr(manufacturer);
 117 usb_string_attr(serial);
 118
 119 static ssize_t speed_show(struct device *dev, struct device_attribute *attr,
 120                           char *buf)
 121 {
 122         struct usb_device *udev;
 123         char *speed;
 124
 125         udev = to_usb_device(dev);
 126
 127         switch (udev->speed) {
 128         case USB_SPEED_LOW:
 129                 speed = "1.5";
 130                 break;
 131         case USB_SPEED_UNKNOWN:
 132         case USB_SPEED_FULL:
 133                 speed = "12";
 134                 break;
 135         case USB_SPEED_HIGH:
 136                 speed = "480";
 137                 break;
 138         case USB_SPEED_WIRELESS:
 139                 speed = "480";
 140                 break;
 141         case USB_SPEED_SUPER:
 142                 speed = "5000";
 143                 break;
 144         default:
 145                 speed = "unknown";
 146         }
 147         return sprintf(buf, "%s\n", speed);
 148 }
 149 static DEVICE_ATTR_RO(speed);
 150
 151 static ssize_t busnum_show(struct device *dev, struct device_attribute *attr,
 152                            char *buf)
 153 {
 154         struct usb_device *udev;
 155
 156         udev = to_usb_device(dev);
 157         return sprintf(buf, "%d\n", udev->bus->busnum);
 158 }
 159 static DEVICE_ATTR_RO(busnum);
 160
 161 static ssize_t devnum_show(struct device *dev, struct device_attribute *attr,
 162                            char *buf)
 163 {
 164         struct usb_device *udev;
 165
 166         udev = to_usb_device(dev);
 167         return sprintf(buf, "%d\n", udev->devnum);
 168 }
 169 static DEVICE_ATTR_RO(devnum);
 170
 171 static ssize_t devpath_show(struct device *dev, struct device_attribute *attr,
 172                             char *buf)
 173 {
 174         struct usb_device *udev;
 175
 176         udev = to_usb_device(dev);
 177         return sprintf(buf, "%s\n", udev->devpath);
 178 }
 179 static DEVICE_ATTR_RO(devpath);
 180
 181 static ssize_t version_show(struct device *dev, struct device_attribute *attr,
 182                             char *buf)
 183 {
 184         struct usb_device *udev;
 185         u16 bcdUSB;
 186
 187         udev = to_usb_device(dev);
 188         bcdUSB = le16_to_cpu(udev->descriptor.bcdUSB);
 189         return sprintf(buf, "%2x.%02x\n", bcdUSB >> 8, bcdUSB & 0xff);
 190 }
 191 static DEVICE_ATTR_RO(version);
 192
 193 static ssize_t maxchild_show(struct device *dev, struct device_attribute *attr,
 194                              char *buf)
 195 {
 196         struct usb_device *udev;
 197
 198         udev = to_usb_device(dev);
 199         return sprintf(buf, "%d\n", udev->maxchild);
 200 }
 201 static DEVICE_ATTR_RO(maxchild);
 202
 203 static ssize_t quirks_show(struct device *dev, struct device_attribute *attr,
 204                            char *buf)
 205 {
 206         struct usb_device *udev;
 207
 208         udev = to_usb_device(dev);
 209         return sprintf(buf, "0x%x\n", udev->quirks);
 210 }
 211 static DEVICE_ATTR_RO(quirks);
 212
 213 static ssize_t avoid_reset_quirk_show(struct device *dev,
 214                                       struct device_attribute *attr, char *buf)
 215 {
 216         struct usb_device *udev;
 217
 218         udev = to_usb_device(dev);
 219         return sprintf(buf, "%d\n", !!(udev->quirks & USB_QUIRK_RESET));
 220 }
 221
 222 static ssize_t avoid_reset_quirk_store(struct device *dev,
 223                                       struct device_attribute *attr,
 224                                       const char *buf, size_t count)
 225 {
 226         struct usb_device       *udev = to_usb_device(dev);
 227         int                     val;
 228
 229         if (sscanf(buf, "%d", &val) != 1 || val < 0 || val > 1)
 230                 return -EINVAL;
 231         usb_lock_device(udev);
 232         if (val)
 233                 udev->quirks |= USB_QUIRK_RESET;
 234         else
 235                 udev->quirks &= ~USB_QUIRK_RESET;
 236         usb_unlock_device(udev);
 237         return count;
 238 }
 239 static DEVICE_ATTR_RW(avoid_reset_quirk);
 240
 241 static ssize_t urbnum_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", atomic_read(&udev->urbnum));
 248 }
 249 static DEVICE_ATTR_RO(urbnum);
 250
 251 static ssize_t removable_show(struct device *dev, struct device_attribute *attr,
 252                               char *buf)
 253 {
 254         struct usb_device *udev;
 255         char *state;
 256
 257         udev = to_usb_device(dev);
 258
 259         switch (udev->removable) {
 260         case USB_DEVICE_REMOVABLE:
 261                 state = "removable";
 262                 break;
 263         case USB_DEVICE_FIXED:
 264                 state = "fixed";
 265                 break;
 266         default:
 267                 state = "unknown";
 268         }
 269
 270         return sprintf(buf, "%s\n", state);
 271 }
 272 static DEVICE_ATTR_RO(removable);
 273
 274 static ssize_t ltm_capable_show(struct device *dev,
 275                                 struct device_attribute *attr, char *buf)
 276 {
 277         if (usb_device_supports_ltm(to_usb_device(dev)))
 278                 return sprintf(buf, "%s\n", "yes");
 279         return sprintf(buf, "%s\n", "no");
 280 }
 281 static DEVICE_ATTR_RO(ltm_capable);
 282
 283 #ifdef  CONFIG_PM
 284
 285 static ssize_t persist_show(struct device *dev, struct device_attribute *attr,
 286                             char *buf)
 287 {
 288         struct usb_device *udev = to_usb_device(dev);
 289
 290         return sprintf(buf, "%d\n", udev->persist_enabled);
 291 }
 292
 293 static ssize_t persist_store(struct device *dev, struct device_attribute *attr,
 294                              const char *buf, size_t count)
 295 {
 296         struct usb_device *udev = to_usb_device(dev);
 297         int value;
 298
 299         /* Hubs are always enabled for USB_PERSIST */
 300         if (udev->descriptor.bDeviceClass == USB_CLASS_HUB)
 301                 return -EPERM;
 302
 303         if (sscanf(buf, "%d", &value) != 1)
 304                 return -EINVAL;
 305
 306         usb_lock_device(udev);
 307         udev->persist_enabled = !!value;
 308         usb_unlock_device(udev);
 309         return count;
 310 }
 311 static DEVICE_ATTR_RW(persist);
 312
 313 static int add_persist_attributes(struct device *dev)
 314 {
 315         int rc = 0;
 316
 317         if (is_usb_device(dev)) {
 318                 struct usb_device *udev = to_usb_device(dev);
 319
 320                 /* Hubs are automatically enabled for USB_PERSIST,
 321                  * no point in creating the attribute file.
 322                  */
 323                 if (udev->descriptor.bDeviceClass != USB_CLASS_HUB)
 324                         rc = sysfs_add_file_to_group(&dev->kobj,
 325                                         &dev_attr_persist.attr,
 326                                         power_group_name);
 327         }
 328         return rc;
 329 }
 330
 331 static void remove_persist_attributes(struct device *dev)
 332 {
 333         sysfs_remove_file_from_group(&dev->kobj,
 334                         &dev_attr_persist.attr,
 335                         power_group_name);
 336 }
 337 #else
 338
 339 #define add_persist_attributes(dev)     0
 340 #define remove_persist_attributes(dev)  do {} while (0)
 341
 342 #endif  /* CONFIG_PM */
 343
 344 #ifdef  CONFIG_PM_RUNTIME
 345
 346 static ssize_t connected_duration_show(struct device *dev,
 347                                        struct device_attribute *attr, char *buf)
 348 {
 349         struct usb_device *udev = to_usb_device(dev);
 350
 351         return sprintf(buf, "%u\n",
 352                         jiffies_to_msecs(jiffies - udev->connect_time));
 353 }
 354 static DEVICE_ATTR_RO(connected_duration);
 355
 356 /*
 357  * If the device is resumed, the last time the device was suspended has
 358  * been pre-subtracted from active_duration.  We add the current time to
 359  * get the duration that the device was actually active.
 360  *
 361  * If the device is suspended, the active_duration is up-to-date.
 362  */
 363 static ssize_t active_duration_show(struct device *dev,
 364                                     struct device_attribute *attr, char *buf)
 365 {
 366         struct usb_device *udev = to_usb_device(dev);
 367         int duration;
 368
 369         if (udev->state != USB_STATE_SUSPENDED)
 370                 duration = jiffies_to_msecs(jiffies + udev->active_duration);
 371         else
 372                 duration = jiffies_to_msecs(udev->active_duration);
 373         return sprintf(buf, "%u\n", duration);
 374 }
 375 static DEVICE_ATTR_RO(active_duration);
 376
 377 static ssize_t autosuspend_show(struct device *dev,
 378                                 struct device_attribute *attr, char *buf)
 379 {
 380         return sprintf(buf, "%d\n", dev->power.autosuspend_delay / 1000);
 381 }
 382
 383 static ssize_t autosuspend_store(struct device *dev,
 384                                  struct device_attribute *attr, const char *buf,
 385                                  size_t count)
 386 {
 387         int value;
 388
 389         if (sscanf(buf, "%d", &value) != 1 || value >= INT_MAX/1000 ||
 390                         value <= -INT_MAX/1000)
 391                 return -EINVAL;
 392
 393         pm_runtime_set_autosuspend_delay(dev, value * 1000);
 394         return count;
 395 }
 396 static DEVICE_ATTR_RW(autosuspend);
 397
 398 static const char on_string[] = "on";
 399 static const char auto_string[] = "auto";
 400
 401 static void warn_level(void)
 402 {
 403         static int level_warned;
 404
 405         if (!level_warned) {
 406                 level_warned = 1;
 407                 printk(KERN_WARNING "WARNING! power/level is deprecated; "
 408                                 "use power/control instead\n");
 409         }
 410 }
 411
 412 static ssize_t level_show(struct device *dev, struct device_attribute *attr,
 413                           char *buf)
 414 {
 415         struct usb_device *udev = to_usb_device(dev);
 416         const char *p = auto_string;
 417
 418         warn_level();
 419         if (udev->state != USB_STATE_SUSPENDED && !udev->dev.power.runtime_auto)
 420                 p = on_string;
 421         return sprintf(buf, "%s\n", p);
 422 }
 423
 424 static ssize_t level_store(struct device *dev, struct device_attribute *attr,
 425                            const char *buf, size_t count)
 426 {
 427         struct usb_device *udev = to_usb_device(dev);
 428         int len = count;
 429         char *cp;
 430         int rc = count;
 431
 432         warn_level();
 433         cp = memchr(buf, '\n', count);
 434         if (cp)
 435                 len = cp - buf;
 436
 437         usb_lock_device(udev);
 438
 439         if (len == sizeof on_string - 1 &&
 440                         strncmp(buf, on_string, len) == 0)
 441                 usb_disable_autosuspend(udev);
 442
 443         else if (len == sizeof auto_string - 1 &&
 444                         strncmp(buf, auto_string, len) == 0)
 445                 usb_enable_autosuspend(udev);
 446
 447         else
 448                 rc = -EINVAL;
 449
 450         usb_unlock_device(udev);
 451         return rc;
 452 }
 453 static DEVICE_ATTR_RW(level);
 454
 455 static ssize_t usb2_hardware_lpm_show(struct device *dev,
 456                                       struct device_attribute *attr, char *buf)
 457 {
 458         struct usb_device *udev = to_usb_device(dev);
 459         const char *p;
 460
 461         if (udev->usb2_hw_lpm_allowed == 1)
 462                 p = "enabled";
 463         else
 464                 p = "disabled";
 465
 466         return sprintf(buf, "%s\n", p);
 467 }
 468
 469 static ssize_t usb2_hardware_lpm_store(struct device *dev,
 470                                        struct device_attribute *attr,
 471                                        const char *buf, size_t count)
 472 {
 473         struct usb_device *udev = to_usb_device(dev);
 474         bool value;
 475         int ret;
 476
 477         usb_lock_device(udev);
 478
 479         ret = strtobool(buf, &value);
 480
 481         if (!ret) {
 482                 udev->usb2_hw_lpm_allowed = value;
 483                 ret = usb_set_usb2_hardware_lpm(udev, value);
 484         }
 485
 486         usb_unlock_device(udev);
 487
 488         if (!ret)
 489                 return count;
 490
 491         return ret;
 492 }
 493 static DEVICE_ATTR_RW(usb2_hardware_lpm);
 494
 495 static ssize_t usb2_lpm_l1_timeout_show(struct device *dev,
 496                                         struct device_attribute *attr,
 497                                         char *buf)
 498 {
 499         struct usb_device *udev = to_usb_device(dev);
 500         return sprintf(buf, "%d\n", udev->l1_params.timeout);
 501 }
 502
 503 static ssize_t usb2_lpm_l1_timeout_store(struct device *dev,
 504                                          struct device_attribute *attr,
 505                                          const char *buf, size_t count)
 506 {
 507         struct usb_device *udev = to_usb_device(dev);
 508         u16 timeout;
 509
 510         if (kstrtou16(buf, 0, &timeout))
 511                 return -EINVAL;
 512
 513         udev->l1_params.timeout = timeout;
 514
 515         return count;
 516 }
 517 static DEVICE_ATTR_RW(usb2_lpm_l1_timeout);
 518
 519 static ssize_t usb2_lpm_besl_show(struct device *dev,
 520                                   struct device_attribute *attr, char *buf)
 521 {
 522         struct usb_device *udev = to_usb_device(dev);
 523         return sprintf(buf, "%d\n", udev->l1_params.besl);
 524 }
 525
 526 static ssize_t usb2_lpm_besl_store(struct device *dev,
 527                                    struct device_attribute *attr,
 528                                    const char *buf, size_t count)
 529 {
 530         struct usb_device *udev = to_usb_device(dev);
 531         u8 besl;
 532
 533         if (kstrtou8(buf, 0, &besl) || besl > 15)
 534                 return -EINVAL;
 535
 536         udev->l1_params.besl = besl;
 537
 538         return count;
 539 }
 540 static DEVICE_ATTR_RW(usb2_lpm_besl);
 541
 542 static struct attribute *usb2_hardware_lpm_attr[] = {
 543         &dev_attr_usb2_hardware_lpm.attr,
 544         &dev_attr_usb2_lpm_l1_timeout.attr,
 545         &dev_attr_usb2_lpm_besl.attr,
 546         NULL,
 547 };
 548 static struct attribute_group usb2_hardware_lpm_attr_group = {
 549         .name   = power_group_name,
 550         .attrs  = usb2_hardware_lpm_attr,
 551 };
 552
 553 static struct attribute *power_attrs[] = {
 554         &dev_attr_autosuspend.attr,
 555         &dev_attr_level.attr,
 556         &dev_attr_connected_duration.attr,
 557         &dev_attr_active_duration.attr,
 558         NULL,
 559 };
 560 static struct attribute_group power_attr_group = {
 561         .name   = power_group_name,
 562         .attrs  = power_attrs,
 563 };
 564
 565 static int add_power_attributes(struct device *dev)
 566 {
 567         int rc = 0;
 568
 569         if (is_usb_device(dev)) {
 570                 struct usb_device *udev = to_usb_device(dev);
 571                 rc = sysfs_merge_group(&dev->kobj, &power_attr_group);
 572                 if (udev->usb2_hw_lpm_capable == 1)
 573                         rc = sysfs_merge_group(&dev->kobj,
 574                                         &usb2_hardware_lpm_attr_group);
 575         }
 576
 577         return rc;
 578 }
 579
 580 static void remove_power_attributes(struct device *dev)
 581 {
 582         sysfs_unmerge_group(&dev->kobj, &usb2_hardware_lpm_attr_group);
 583         sysfs_unmerge_group(&dev->kobj, &power_attr_group);
 584 }
 585
 586 #else
 587
 588 #define add_power_attributes(dev)       0
 589 #define remove_power_attributes(dev)    do {} while (0)
 590
 591 #endif  /* CONFIG_PM_RUNTIME */
 592
 593
 594 /* Descriptor fields */
 595 #define usb_descriptor_attr_le16(field, format_string)                  \
 596 static ssize_t                                                          \
 597 field##_show(struct device *dev, struct device_attribute *attr, \
 598                 char *buf)                                              \
 599 {                                                                       \
 600         struct usb_device *udev;                                        \
 601                                                                         \
 602         udev = to_usb_device(dev);                                      \
 603         return sprintf(buf, format_string,                              \
 604                         le16_to_cpu(udev->descriptor.field));           \
 605 }                                                                       \
 606 static DEVICE_ATTR_RO(field)
 607
 608 usb_descriptor_attr_le16(idVendor, "%04x\n");
 609 usb_descriptor_attr_le16(idProduct, "%04x\n");
 610 usb_descriptor_attr_le16(bcdDevice, "%04x\n");
 611
 612 #define usb_descriptor_attr(field, format_string)                       \
 613 static ssize_t                                                          \
 614 field##_show(struct device *dev, struct device_attribute *attr, \
 615                 char *buf)                                              \
 616 {                                                                       \
 617         struct usb_device *udev;                                        \
 618                                                                         \
 619         udev = to_usb_device(dev);                                      \
 620         return sprintf(buf, format_string, udev->descriptor.field);     \
 621 }                                                                       \
 622 static DEVICE_ATTR_RO(field)
 623
 624 usb_descriptor_attr(bDeviceClass, "%02x\n");
 625 usb_descriptor_attr(bDeviceSubClass, "%02x\n");
 626 usb_descriptor_attr(bDeviceProtocol, "%02x\n");
 627 usb_descriptor_attr(bNumConfigurations, "%d\n");
 628 usb_descriptor_attr(bMaxPacketSize0, "%d\n");
 629
 630
 631 /* show if the device is authorized (1) or not (0) */
 632 static ssize_t authorized_show(struct device *dev,
 633                                struct device_attribute *attr, char *buf)
 634 {
 635         struct usb_device *usb_dev = to_usb_device(dev);
 636         return snprintf(buf, PAGE_SIZE, "%u\n", usb_dev->authorized);
 637 }
 638
 639 /*
 640  * Authorize a device to be used in the system
 641  *
 642  * Writing a 0 deauthorizes the device, writing a 1 authorizes it.
 643  */
 644 static ssize_t authorized_store(struct device *dev,
 645                                 struct device_attribute *attr, const char *buf,
 646                                 size_t size)
 647 {
 648         ssize_t result;
 649         struct usb_device *usb_dev = to_usb_device(dev);
 650         unsigned val;
 651         result = sscanf(buf, "%u\n", &val);
 652         if (result != 1)
 653                 result = -EINVAL;
 654         else if (val == 0)
 655                 result = usb_deauthorize_device(usb_dev);
 656         else
 657                 result = usb_authorize_device(usb_dev);
 658         return result < 0 ? result : size;
 659 }
 660 static DEVICE_ATTR_IGNORE_LOCKDEP(authorized, S_IRUGO | S_IWUSR,
 661                                   authorized_show, authorized_store);
 662
 663 /* "Safely remove a device" */
 664 static ssize_t remove_store(struct device *dev, struct device_attribute *attr,
 665                             const char *buf, size_t count)
 666 {
 667         struct usb_device *udev = to_usb_device(dev);
 668         int rc = 0;
 669
 670         usb_lock_device(udev);
 671         if (udev->state != USB_STATE_NOTATTACHED) {
 672
 673                 /* To avoid races, first unconfigure and then remove */
 674                 usb_set_configuration(udev, -1);
 675                 rc = usb_remove_device(udev);
 676         }
 677         if (rc == 0)
 678                 rc = count;
 679         usb_unlock_device(udev);
 680         return rc;
 681 }
 682 static DEVICE_ATTR_IGNORE_LOCKDEP(remove, S_IWUSR, NULL, remove_store);
 683
 684
 685 static struct attribute *dev_attrs[] = {
 686         /* current configuration's attributes */
 687         &dev_attr_configuration.attr,
 688         &dev_attr_bNumInterfaces.attr,
 689         &dev_attr_bConfigurationValue.attr,
 690         &dev_attr_bmAttributes.attr,
 691         &dev_attr_bMaxPower.attr,
 692         /* device attributes */
 693         &dev_attr_urbnum.attr,
 694         &dev_attr_idVendor.attr,
 695         &dev_attr_idProduct.attr,
 696         &dev_attr_bcdDevice.attr,
 697         &dev_attr_bDeviceClass.attr,
 698         &dev_attr_bDeviceSubClass.attr,
 699         &dev_attr_bDeviceProtocol.attr,
 700         &dev_attr_bNumConfigurations.attr,
 701         &dev_attr_bMaxPacketSize0.attr,
 702         &dev_attr_speed.attr,
 703         &dev_attr_busnum.attr,
 704         &dev_attr_devnum.attr,
 705         &dev_attr_devpath.attr,
 706         &dev_attr_version.attr,
 707         &dev_attr_maxchild.attr,
 708         &dev_attr_quirks.attr,
 709         &dev_attr_avoid_reset_quirk.attr,
 710         &dev_attr_authorized.attr,
 711         &dev_attr_remove.attr,
 712         &dev_attr_removable.attr,
 713         &dev_attr_ltm_capable.attr,
 714         NULL,
 715 };
 716 static struct attribute_group dev_attr_grp = {
 717         .attrs = dev_attrs,
 718 };
 719
 720 /* When modifying this list, be sure to modify dev_string_attrs_are_visible()
 721  * accordingly.
 722  */
 723 static struct attribute *dev_string_attrs[] = {
 724         &dev_attr_manufacturer.attr,
 725         &dev_attr_product.attr,
 726         &dev_attr_serial.attr,
 727         NULL
 728 };
 729
 730 static umode_t dev_string_attrs_are_visible(struct kobject *kobj,
 731                 struct attribute *a, int n)
 732 {
 733         struct device *dev = container_of(kobj, struct device, kobj);
 734         struct usb_device *udev = to_usb_device(dev);
 735
 736         if (a == &dev_attr_manufacturer.attr) {
 737                 if (udev->manufacturer == NULL)
 738                         return 0;
 739         } else if (a == &dev_attr_product.attr) {
 740                 if (udev->product == NULL)
 741                         return 0;
 742         } else if (a == &dev_attr_serial.attr) {
 743                 if (udev->serial == NULL)
 744                         return 0;
 745         }
 746         return a->mode;
 747 }
 748
 749 static struct attribute_group dev_string_attr_grp = {
 750         .attrs =        dev_string_attrs,
 751         .is_visible =   dev_string_attrs_are_visible,
 752 };
 753
 754 const struct attribute_group *usb_device_groups[] = {
 755         &dev_attr_grp,
 756         &dev_string_attr_grp,
 757         NULL
 758 };
 759
 760 /* Binary descriptors */
 761
 762 static ssize_t
 763 read_descriptors(struct file *filp, struct kobject *kobj,
 764                 struct bin_attribute *attr,
 765                 char *buf, loff_t off, size_t count)
 766 {
 767         struct device *dev = container_of(kobj, struct device, kobj);
 768         struct usb_device *udev = to_usb_device(dev);
 769         size_t nleft = count;
 770         size_t srclen, n;
 771         int cfgno;
 772         void *src;
 773
 774         /* The binary attribute begins with the device descriptor.
 775          * Following that are the raw descriptor entries for all the
 776          * configurations (config plus subsidiary descriptors).
 777          */
 778         usb_lock_device(udev);
 779         for (cfgno = -1; cfgno < udev->descriptor.bNumConfigurations &&
 780                         nleft > 0; ++cfgno) {
 781                 if (cfgno < 0) {
 782                         src = &udev->descriptor;
 783                         srclen = sizeof(struct usb_device_descriptor);
 784                 } else {
 785                         src = udev->rawdescriptors[cfgno];
 786                         srclen = __le16_to_cpu(udev->config[cfgno].desc.
 787                                         wTotalLength);
 788                 }
 789                 if (off < srclen) {
 790                         n = min(nleft, srclen - (size_t) off);
 791                         memcpy(buf, src + off, n);
 792                         nleft -= n;
 793                         buf += n;
 794                         off = 0;
 795                 } else {
 796                         off -= srclen;
 797                 }
 798         }
 799         usb_unlock_device(udev);
 800         return count - nleft;
 801 }
 802
 803 static struct bin_attribute dev_bin_attr_descriptors = {
 804         .attr = {.name = "descriptors", .mode = 0444},
 805         .read = read_descriptors,
 806         .size = 18 + 65535,     /* dev descr + max-size raw descriptor */
 807 };
 808
 809 int usb_create_sysfs_dev_files(struct usb_device *udev)
 810 {
 811         struct device *dev = &udev->dev;
 812         int retval;
 813
 814         retval = device_create_bin_file(dev, &dev_bin_attr_descriptors);
 815         if (retval)
 816                 goto error;
 817
 818         retval = add_persist_attributes(dev);
 819         if (retval)
 820                 goto error;
 821
 822         retval = add_power_attributes(dev);
 823         if (retval)
 824                 goto error;
 825         return retval;
 826 error:
 827         usb_remove_sysfs_dev_files(udev);
 828         return retval;
 829 }
 830
 831 void usb_remove_sysfs_dev_files(struct usb_device *udev)
 832 {
 833         struct device *dev = &udev->dev;
 834
 835         remove_power_attributes(dev);
 836         remove_persist_attributes(dev);
 837         device_remove_bin_file(dev, &dev_bin_attr_descriptors);
 838 }
 839
 840 /* Interface Association Descriptor fields */
 841 #define usb_intf_assoc_attr(field, format_string)                       \
 842 static ssize_t                                                          \
 843 iad_##field##_show(struct device *dev, struct device_attribute *attr,   \
 844                 char *buf)                                              \
 845 {                                                                       \
 846         struct usb_interface *intf = to_usb_interface(dev);             \
 847                                                                         \
 848         return sprintf(buf, format_string,                              \
 849                         intf->intf_assoc->field);                       \
 850 }                                                                       \
 851 static DEVICE_ATTR_RO(iad_##field)
 852
 853 usb_intf_assoc_attr(bFirstInterface, "%02x\n");
 854 usb_intf_assoc_attr(bInterfaceCount, "%02d\n");
 855 usb_intf_assoc_attr(bFunctionClass, "%02x\n");
 856 usb_intf_assoc_attr(bFunctionSubClass, "%02x\n");
 857 usb_intf_assoc_attr(bFunctionProtocol, "%02x\n");
 858
 859 /* Interface fields */
 860 #define usb_intf_attr(field, format_string)                             \
 861 static ssize_t                                                          \
 862 field##_show(struct device *dev, struct device_attribute *attr,         \
 863                 char *buf)                                              \
 864 {                                                                       \
 865         struct usb_interface *intf = to_usb_interface(dev);             \
 866                                                                         \
 867         return sprintf(buf, format_string,                              \
 868                         intf->cur_altsetting->desc.field);              \
 869 }                                                                       \
 870 static DEVICE_ATTR_RO(field)
 871
 872 usb_intf_attr(bInterfaceNumber, "%02x\n");
 873 usb_intf_attr(bAlternateSetting, "%2d\n");
 874 usb_intf_attr(bNumEndpoints, "%02x\n");
 875 usb_intf_attr(bInterfaceClass, "%02x\n");
 876 usb_intf_attr(bInterfaceSubClass, "%02x\n");
 877 usb_intf_attr(bInterfaceProtocol, "%02x\n");
 878
 879 static ssize_t interface_show(struct device *dev, struct device_attribute *attr,
 880                               char *buf)
 881 {
 882         struct usb_interface *intf;
 883         char *string;
 884
 885         intf = to_usb_interface(dev);
 886         string = ACCESS_ONCE(intf->cur_altsetting->string);
 887         if (!string)
 888                 return 0;
 889         return sprintf(buf, "%s\n", string);
 890 }
 891 static DEVICE_ATTR_RO(interface);
 892
 893 static ssize_t modalias_show(struct device *dev, struct device_attribute *attr,
 894                              char *buf)
 895 {
 896         struct usb_interface *intf;
 897         struct usb_device *udev;
 898         struct usb_host_interface *alt;
 899
 900         intf = to_usb_interface(dev);
 901         udev = interface_to_usbdev(intf);
 902         alt = ACCESS_ONCE(intf->cur_altsetting);
 903
 904         return sprintf(buf, "usb:v%04Xp%04Xd%04Xdc%02Xdsc%02Xdp%02X"
 905                         "ic%02Xisc%02Xip%02Xin%02X\n",
 906                         le16_to_cpu(udev->descriptor.idVendor),
 907                         le16_to_cpu(udev->descriptor.idProduct),
 908                         le16_to_cpu(udev->descriptor.bcdDevice),
 909                         udev->descriptor.bDeviceClass,
 910                         udev->descriptor.bDeviceSubClass,
 911                         udev->descriptor.bDeviceProtocol,
 912                         alt->desc.bInterfaceClass,
 913                         alt->desc.bInterfaceSubClass,
 914                         alt->desc.bInterfaceProtocol,
 915                         alt->desc.bInterfaceNumber);
 916 }
 917 static DEVICE_ATTR_RO(modalias);
 918
 919 static ssize_t supports_autosuspend_show(struct device *dev,
 920                                          struct device_attribute *attr,
 921                                          char *buf)
 922 {
 923         int s;
 924
 925         device_lock(dev);
 926         /* Devices will be autosuspended even when an interface isn't claimed */
 927         s = (!dev->driver || to_usb_driver(dev->driver)->supports_autosuspend);
 928         device_unlock(dev);
 929
 930         return sprintf(buf, "%u\n", s);
 931 }
 932 static DEVICE_ATTR_RO(supports_autosuspend);
 933
 934 static struct attribute *intf_attrs[] = {
 935         &dev_attr_bInterfaceNumber.attr,
 936         &dev_attr_bAlternateSetting.attr,
 937         &dev_attr_bNumEndpoints.attr,
 938         &dev_attr_bInterfaceClass.attr,
 939         &dev_attr_bInterfaceSubClass.attr,
 940         &dev_attr_bInterfaceProtocol.attr,
 941         &dev_attr_modalias.attr,
 942         &dev_attr_supports_autosuspend.attr,
 943         NULL,
 944 };
 945 static struct attribute_group intf_attr_grp = {
 946         .attrs = intf_attrs,
 947 };
 948
 949 static struct attribute *intf_assoc_attrs[] = {
 950         &dev_attr_iad_bFirstInterface.attr,
 951         &dev_attr_iad_bInterfaceCount.attr,
 952         &dev_attr_iad_bFunctionClass.attr,
 953         &dev_attr_iad_bFunctionSubClass.attr,
 954         &dev_attr_iad_bFunctionProtocol.attr,
 955         NULL,
 956 };
 957
 958 static umode_t intf_assoc_attrs_are_visible(struct kobject *kobj,
 959                 struct attribute *a, int n)
 960 {
 961         struct device *dev = container_of(kobj, struct device, kobj);
 962         struct usb_interface *intf = to_usb_interface(dev);
 963
 964         if (intf->intf_assoc == NULL)
 965                 return 0;
 966         return a->mode;
 967 }
 968
 969 static struct attribute_group intf_assoc_attr_grp = {
 970         .attrs =        intf_assoc_attrs,
 971         .is_visible =   intf_assoc_attrs_are_visible,
 972 };
 973
 974 const struct attribute_group *usb_interface_groups[] = {
 975         &intf_attr_grp,
 976         &intf_assoc_attr_grp,
 977         NULL
 978 };
 979
 980 void usb_create_sysfs_intf_files(struct usb_interface *intf)
 981 {
 982         struct usb_device *udev = interface_to_usbdev(intf);
 983         struct usb_host_interface *alt = intf->cur_altsetting;
 984
 985         if (intf->sysfs_files_created || intf->unregistering)
 986                 return;
 987
 988         if (!alt->string && !(udev->quirks & USB_QUIRK_CONFIG_INTF_STRINGS))
 989                 alt->string = usb_cache_string(udev, alt->desc.iInterface);
 990         if (alt->string && device_create_file(&intf->dev, &dev_attr_interface))
 991                 ;       /* We don't actually care if the function fails. */
 992         intf->sysfs_files_created = 1;
 993 }
 994
 995 void usb_remove_sysfs_intf_files(struct usb_interface *intf)
 996 {
 997         if (!intf->sysfs_files_created)
 998                 return;
 999
1000         device_remove_file(&intf->dev, &dev_attr_interface);
1001         intf->sysfs_files_created = 0;
1002 }