Commit | Line | Data |
---|---|---|
1da177e4 LT |
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 | ||
1da177e4 | 13 | #include <linux/kernel.h> |
2add5229 | 14 | #include <linux/string.h> |
1da177e4 | 15 | #include <linux/usb.h> |
1662e3a7 | 16 | #include <linux/usb/quirks.h> |
1da177e4 LT |
17 | #include "usb.h" |
18 | ||
19 | /* Active configuration fields */ | |
20 | #define usb_actconfig_show(field, multiplier, format_string) \ | |
9251644a | 21 | static ssize_t show_##field(struct device *dev, \ |
b724ae77 | 22 | struct device_attribute *attr, char *buf) \ |
1da177e4 LT |
23 | { \ |
24 | struct usb_device *udev; \ | |
25 | struct usb_host_config *actconfig; \ | |
26 | \ | |
9251644a | 27 | udev = to_usb_device(dev); \ |
1da177e4 LT |
28 | actconfig = udev->actconfig; \ |
29 | if (actconfig) \ | |
9251644a | 30 | return sprintf(buf, format_string, \ |
1da177e4 LT |
31 | actconfig->desc.field * multiplier); \ |
32 | else \ | |
33 | return 0; \ | |
34 | } \ | |
35 | ||
36 | #define usb_actconfig_attr(field, multiplier, format_string) \ | |
37 | usb_actconfig_show(field, multiplier, format_string) \ | |
38 | static DEVICE_ATTR(field, S_IRUGO, show_##field, NULL); | |
39 | ||
9251644a ON |
40 | usb_actconfig_attr(bNumInterfaces, 1, "%2d\n") |
41 | usb_actconfig_attr(bmAttributes, 1, "%2x\n") | |
42 | usb_actconfig_attr(bMaxPower, 2, "%3dmA\n") | |
1da177e4 | 43 | |
b724ae77 AS |
44 | static ssize_t show_configuration_string(struct device *dev, |
45 | struct device_attribute *attr, char *buf) | |
1da177e4 LT |
46 | { |
47 | struct usb_device *udev; | |
48 | struct usb_host_config *actconfig; | |
1da177e4 | 49 | |
9251644a | 50 | udev = to_usb_device(dev); |
1da177e4 LT |
51 | actconfig = udev->actconfig; |
52 | if ((!actconfig) || (!actconfig->string)) | |
53 | return 0; | |
4f62efe6 | 54 | return sprintf(buf, "%s\n", actconfig->string); |
1da177e4 LT |
55 | } |
56 | static DEVICE_ATTR(configuration, S_IRUGO, show_configuration_string, NULL); | |
57 | ||
58 | /* configuration value is always present, and r/w */ | |
59 | usb_actconfig_show(bConfigurationValue, 1, "%u\n"); | |
60 | ||
61 | static ssize_t | |
9251644a | 62 | set_bConfigurationValue(struct device *dev, struct device_attribute *attr, |
b724ae77 | 63 | const char *buf, size_t count) |
1da177e4 | 64 | { |
9251644a | 65 | struct usb_device *udev = to_usb_device(dev); |
1da177e4 LT |
66 | int config, value; |
67 | ||
3f141e2a | 68 | if (sscanf(buf, "%d", &config) != 1 || config < -1 || config > 255) |
1da177e4 LT |
69 | return -EINVAL; |
70 | usb_lock_device(udev); | |
9251644a | 71 | value = usb_set_configuration(udev, config); |
1da177e4 LT |
72 | usb_unlock_device(udev); |
73 | return (value < 0) ? value : count; | |
74 | } | |
75 | ||
2c044a48 | 76 | static DEVICE_ATTR(bConfigurationValue, S_IRUGO | S_IWUSR, |
1da177e4 LT |
77 | show_bConfigurationValue, set_bConfigurationValue); |
78 | ||
79 | /* String fields */ | |
80 | #define usb_string_attr(name) \ | |
b724ae77 AS |
81 | static ssize_t show_##name(struct device *dev, \ |
82 | struct device_attribute *attr, char *buf) \ | |
1da177e4 LT |
83 | { \ |
84 | struct usb_device *udev; \ | |
da307123 | 85 | int retval; \ |
1da177e4 | 86 | \ |
9251644a | 87 | udev = to_usb_device(dev); \ |
da307123 AS |
88 | usb_lock_device(udev); \ |
89 | retval = sprintf(buf, "%s\n", udev->name); \ | |
90 | usb_unlock_device(udev); \ | |
91 | return retval; \ | |
1da177e4 LT |
92 | } \ |
93 | static DEVICE_ATTR(name, S_IRUGO, show_##name, NULL); | |
94 | ||
95 | usb_string_attr(product); | |
96 | usb_string_attr(manufacturer); | |
97 | usb_string_attr(serial); | |
98 | ||
99 | static ssize_t | |
9251644a | 100 | show_speed(struct device *dev, struct device_attribute *attr, char *buf) |
1da177e4 LT |
101 | { |
102 | struct usb_device *udev; | |
103 | char *speed; | |
104 | ||
9251644a | 105 | udev = to_usb_device(dev); |
1da177e4 LT |
106 | |
107 | switch (udev->speed) { | |
108 | case USB_SPEED_LOW: | |
109 | speed = "1.5"; | |
110 | break; | |
111 | case USB_SPEED_UNKNOWN: | |
112 | case USB_SPEED_FULL: | |
113 | speed = "12"; | |
114 | break; | |
115 | case USB_SPEED_HIGH: | |
116 | speed = "480"; | |
117 | break; | |
b132b04e GKH |
118 | case USB_SPEED_VARIABLE: |
119 | speed = "480"; | |
120 | break; | |
121 | case USB_SPEED_SUPER: | |
122 | speed = "5000"; | |
123 | break; | |
1da177e4 LT |
124 | default: |
125 | speed = "unknown"; | |
126 | } | |
9251644a | 127 | return sprintf(buf, "%s\n", speed); |
1da177e4 LT |
128 | } |
129 | static DEVICE_ATTR(speed, S_IRUGO, show_speed, NULL); | |
130 | ||
83f7d958 AS |
131 | static ssize_t |
132 | show_busnum(struct device *dev, struct device_attribute *attr, char *buf) | |
133 | { | |
134 | struct usb_device *udev; | |
135 | ||
136 | udev = to_usb_device(dev); | |
137 | return sprintf(buf, "%d\n", udev->bus->busnum); | |
138 | } | |
139 | static DEVICE_ATTR(busnum, S_IRUGO, show_busnum, NULL); | |
140 | ||
1da177e4 | 141 | static ssize_t |
9251644a | 142 | show_devnum(struct device *dev, struct device_attribute *attr, char *buf) |
1da177e4 LT |
143 | { |
144 | struct usb_device *udev; | |
145 | ||
9251644a ON |
146 | udev = to_usb_device(dev); |
147 | return sprintf(buf, "%d\n", udev->devnum); | |
1da177e4 LT |
148 | } |
149 | static DEVICE_ATTR(devnum, S_IRUGO, show_devnum, NULL); | |
150 | ||
9af23624 GKH |
151 | static ssize_t |
152 | show_devpath(struct device *dev, struct device_attribute *attr, char *buf) | |
153 | { | |
154 | struct usb_device *udev; | |
155 | ||
156 | udev = to_usb_device(dev); | |
157 | return sprintf(buf, "%s\n", udev->devpath); | |
158 | } | |
159 | static DEVICE_ATTR(devpath, S_IRUGO, show_devpath, NULL); | |
160 | ||
1da177e4 | 161 | static ssize_t |
9251644a | 162 | show_version(struct device *dev, struct device_attribute *attr, char *buf) |
1da177e4 LT |
163 | { |
164 | struct usb_device *udev; | |
165 | u16 bcdUSB; | |
166 | ||
167 | udev = to_usb_device(dev); | |
168 | bcdUSB = le16_to_cpu(udev->descriptor.bcdUSB); | |
169 | return sprintf(buf, "%2x.%02x\n", bcdUSB >> 8, bcdUSB & 0xff); | |
170 | } | |
171 | static DEVICE_ATTR(version, S_IRUGO, show_version, NULL); | |
172 | ||
173 | static ssize_t | |
9251644a | 174 | show_maxchild(struct device *dev, struct device_attribute *attr, char *buf) |
1da177e4 LT |
175 | { |
176 | struct usb_device *udev; | |
177 | ||
9251644a ON |
178 | udev = to_usb_device(dev); |
179 | return sprintf(buf, "%d\n", udev->maxchild); | |
1da177e4 LT |
180 | } |
181 | static DEVICE_ATTR(maxchild, S_IRUGO, show_maxchild, NULL); | |
182 | ||
7ceec1f1 ON |
183 | static ssize_t |
184 | show_quirks(struct device *dev, struct device_attribute *attr, char *buf) | |
185 | { | |
186 | struct usb_device *udev; | |
187 | ||
188 | udev = to_usb_device(dev); | |
189 | return sprintf(buf, "0x%x\n", udev->quirks); | |
190 | } | |
191 | static DEVICE_ATTR(quirks, S_IRUGO, show_quirks, NULL); | |
192 | ||
4d59d8a1 SS |
193 | static ssize_t |
194 | show_urbnum(struct device *dev, struct device_attribute *attr, char *buf) | |
195 | { | |
196 | struct usb_device *udev; | |
197 | ||
198 | udev = to_usb_device(dev); | |
199 | return sprintf(buf, "%d\n", atomic_read(&udev->urbnum)); | |
200 | } | |
201 | static DEVICE_ATTR(urbnum, S_IRUGO, show_urbnum, NULL); | |
202 | ||
b41a60ec | 203 | |
feccc30d | 204 | #ifdef CONFIG_PM |
b41a60ec | 205 | |
feccc30d | 206 | static const char power_group[] = "power"; |
b41a60ec AS |
207 | |
208 | static ssize_t | |
209 | show_persist(struct device *dev, struct device_attribute *attr, char *buf) | |
210 | { | |
211 | struct usb_device *udev = to_usb_device(dev); | |
212 | ||
213 | return sprintf(buf, "%d\n", udev->persist_enabled); | |
214 | } | |
215 | ||
216 | static ssize_t | |
217 | set_persist(struct device *dev, struct device_attribute *attr, | |
218 | const char *buf, size_t count) | |
219 | { | |
220 | struct usb_device *udev = to_usb_device(dev); | |
221 | int value; | |
222 | ||
223 | /* Hubs are always enabled for USB_PERSIST */ | |
224 | if (udev->descriptor.bDeviceClass == USB_CLASS_HUB) | |
225 | return -EPERM; | |
226 | ||
227 | if (sscanf(buf, "%d", &value) != 1) | |
228 | return -EINVAL; | |
229 | usb_pm_lock(udev); | |
230 | udev->persist_enabled = !!value; | |
231 | usb_pm_unlock(udev); | |
232 | return count; | |
233 | } | |
234 | ||
235 | static DEVICE_ATTR(persist, S_IRUGO | S_IWUSR, show_persist, set_persist); | |
236 | ||
237 | static int add_persist_attributes(struct device *dev) | |
238 | { | |
239 | int rc = 0; | |
240 | ||
241 | if (is_usb_device(dev)) { | |
242 | struct usb_device *udev = to_usb_device(dev); | |
243 | ||
feccc30d AS |
244 | /* Hubs are automatically enabled for USB_PERSIST, |
245 | * no point in creating the attribute file. | |
246 | */ | |
247 | if (udev->descriptor.bDeviceClass != USB_CLASS_HUB) | |
248 | rc = sysfs_add_file_to_group(&dev->kobj, | |
249 | &dev_attr_persist.attr, | |
250 | power_group); | |
b41a60ec AS |
251 | } |
252 | return rc; | |
253 | } | |
254 | ||
255 | static void remove_persist_attributes(struct device *dev) | |
256 | { | |
257 | sysfs_remove_file_from_group(&dev->kobj, | |
258 | &dev_attr_persist.attr, | |
259 | power_group); | |
260 | } | |
b41a60ec AS |
261 | #else |
262 | ||
263 | #define add_persist_attributes(dev) 0 | |
264 | #define remove_persist_attributes(dev) do {} while (0) | |
265 | ||
feccc30d | 266 | #endif /* CONFIG_PM */ |
b41a60ec | 267 | |
19c26239 AS |
268 | #ifdef CONFIG_USB_SUSPEND |
269 | ||
15123006 SS |
270 | static ssize_t |
271 | show_connected_duration(struct device *dev, struct device_attribute *attr, | |
272 | char *buf) | |
273 | { | |
274 | struct usb_device *udev = to_usb_device(dev); | |
275 | ||
276 | return sprintf(buf, "%u\n", | |
277 | jiffies_to_msecs(jiffies - udev->connect_time)); | |
278 | } | |
279 | ||
280 | static DEVICE_ATTR(connected_duration, S_IRUGO, show_connected_duration, NULL); | |
281 | ||
282 | /* | |
283 | * If the device is resumed, the last time the device was suspended has | |
284 | * been pre-subtracted from active_duration. We add the current time to | |
285 | * get the duration that the device was actually active. | |
286 | * | |
287 | * If the device is suspended, the active_duration is up-to-date. | |
288 | */ | |
289 | static ssize_t | |
290 | show_active_duration(struct device *dev, struct device_attribute *attr, | |
291 | char *buf) | |
292 | { | |
293 | struct usb_device *udev = to_usb_device(dev); | |
294 | int duration; | |
295 | ||
296 | if (udev->state != USB_STATE_SUSPENDED) | |
297 | duration = jiffies_to_msecs(jiffies + udev->active_duration); | |
298 | else | |
299 | duration = jiffies_to_msecs(udev->active_duration); | |
300 | return sprintf(buf, "%u\n", duration); | |
301 | } | |
302 | ||
303 | static DEVICE_ATTR(active_duration, S_IRUGO, show_active_duration, NULL); | |
304 | ||
19c26239 AS |
305 | static ssize_t |
306 | show_autosuspend(struct device *dev, struct device_attribute *attr, char *buf) | |
307 | { | |
308 | struct usb_device *udev = to_usb_device(dev); | |
309 | ||
eaafbc3a | 310 | return sprintf(buf, "%d\n", udev->autosuspend_delay / HZ); |
19c26239 AS |
311 | } |
312 | ||
313 | static ssize_t | |
314 | set_autosuspend(struct device *dev, struct device_attribute *attr, | |
315 | const char *buf, size_t count) | |
316 | { | |
317 | struct usb_device *udev = to_usb_device(dev); | |
eaafbc3a | 318 | int value; |
19c26239 | 319 | |
eaafbc3a AS |
320 | if (sscanf(buf, "%d", &value) != 1 || value >= INT_MAX/HZ || |
321 | value <= - INT_MAX/HZ) | |
19c26239 AS |
322 | return -EINVAL; |
323 | value *= HZ; | |
324 | ||
19c26239 | 325 | udev->autosuspend_delay = value; |
eaafbc3a | 326 | if (value >= 0) |
19c26239 | 327 | usb_try_autosuspend_device(udev); |
eaafbc3a | 328 | else { |
2add5229 AS |
329 | if (usb_autoresume_device(udev) == 0) |
330 | usb_autosuspend_device(udev); | |
eaafbc3a | 331 | } |
19c26239 AS |
332 | return count; |
333 | } | |
334 | ||
335 | static DEVICE_ATTR(autosuspend, S_IRUGO | S_IWUSR, | |
336 | show_autosuspend, set_autosuspend); | |
337 | ||
2add5229 AS |
338 | static const char on_string[] = "on"; |
339 | static const char auto_string[] = "auto"; | |
2add5229 AS |
340 | |
341 | static ssize_t | |
342 | show_level(struct device *dev, struct device_attribute *attr, char *buf) | |
343 | { | |
344 | struct usb_device *udev = to_usb_device(dev); | |
345 | const char *p = auto_string; | |
346 | ||
8e4ceb38 AS |
347 | if (udev->state != USB_STATE_SUSPENDED && udev->autosuspend_disabled) |
348 | p = on_string; | |
2add5229 AS |
349 | return sprintf(buf, "%s\n", p); |
350 | } | |
351 | ||
352 | static ssize_t | |
353 | set_level(struct device *dev, struct device_attribute *attr, | |
354 | const char *buf, size_t count) | |
355 | { | |
356 | struct usb_device *udev = to_usb_device(dev); | |
357 | int len = count; | |
358 | char *cp; | |
359 | int rc = 0; | |
8e4ceb38 | 360 | int old_autosuspend_disabled; |
2add5229 AS |
361 | |
362 | cp = memchr(buf, '\n', count); | |
363 | if (cp) | |
364 | len = cp - buf; | |
365 | ||
366 | usb_lock_device(udev); | |
dd865571 | 367 | old_autosuspend_disabled = udev->autosuspend_disabled; |
2add5229 AS |
368 | |
369 | /* Setting the flags without calling usb_pm_lock is a subject to | |
370 | * races, but who cares... | |
371 | */ | |
372 | if (len == sizeof on_string - 1 && | |
373 | strncmp(buf, on_string, len) == 0) { | |
374 | udev->autosuspend_disabled = 1; | |
65bfd296 | 375 | rc = usb_external_resume_device(udev, PMSG_USER_RESUME); |
2add5229 AS |
376 | |
377 | } else if (len == sizeof auto_string - 1 && | |
378 | strncmp(buf, auto_string, len) == 0) { | |
379 | udev->autosuspend_disabled = 0; | |
65bfd296 | 380 | rc = usb_external_resume_device(udev, PMSG_USER_RESUME); |
2add5229 | 381 | |
2add5229 AS |
382 | } else |
383 | rc = -EINVAL; | |
384 | ||
8e4ceb38 | 385 | if (rc) |
dd865571 | 386 | udev->autosuspend_disabled = old_autosuspend_disabled; |
2add5229 AS |
387 | usb_unlock_device(udev); |
388 | return (rc < 0 ? rc : count); | |
389 | } | |
390 | ||
391 | static DEVICE_ATTR(level, S_IRUGO | S_IWUSR, show_level, set_level); | |
392 | ||
19c26239 AS |
393 | static int add_power_attributes(struct device *dev) |
394 | { | |
395 | int rc = 0; | |
396 | ||
2add5229 | 397 | if (is_usb_device(dev)) { |
19c26239 AS |
398 | rc = sysfs_add_file_to_group(&dev->kobj, |
399 | &dev_attr_autosuspend.attr, | |
400 | power_group); | |
2add5229 AS |
401 | if (rc == 0) |
402 | rc = sysfs_add_file_to_group(&dev->kobj, | |
403 | &dev_attr_level.attr, | |
404 | power_group); | |
15123006 SS |
405 | if (rc == 0) |
406 | rc = sysfs_add_file_to_group(&dev->kobj, | |
407 | &dev_attr_connected_duration.attr, | |
408 | power_group); | |
409 | if (rc == 0) | |
410 | rc = sysfs_add_file_to_group(&dev->kobj, | |
411 | &dev_attr_active_duration.attr, | |
412 | power_group); | |
2add5229 | 413 | } |
19c26239 AS |
414 | return rc; |
415 | } | |
416 | ||
417 | static void remove_power_attributes(struct device *dev) | |
418 | { | |
15123006 SS |
419 | sysfs_remove_file_from_group(&dev->kobj, |
420 | &dev_attr_active_duration.attr, | |
421 | power_group); | |
422 | sysfs_remove_file_from_group(&dev->kobj, | |
423 | &dev_attr_connected_duration.attr, | |
424 | power_group); | |
2add5229 AS |
425 | sysfs_remove_file_from_group(&dev->kobj, |
426 | &dev_attr_level.attr, | |
427 | power_group); | |
19c26239 AS |
428 | sysfs_remove_file_from_group(&dev->kobj, |
429 | &dev_attr_autosuspend.attr, | |
430 | power_group); | |
431 | } | |
432 | ||
433 | #else | |
434 | ||
435 | #define add_power_attributes(dev) 0 | |
436 | #define remove_power_attributes(dev) do {} while (0) | |
437 | ||
438 | #endif /* CONFIG_USB_SUSPEND */ | |
439 | ||
b41a60ec | 440 | |
1da177e4 LT |
441 | /* Descriptor fields */ |
442 | #define usb_descriptor_attr_le16(field, format_string) \ | |
443 | static ssize_t \ | |
9251644a | 444 | show_##field(struct device *dev, struct device_attribute *attr, \ |
b724ae77 | 445 | char *buf) \ |
1da177e4 LT |
446 | { \ |
447 | struct usb_device *udev; \ | |
448 | \ | |
9251644a ON |
449 | udev = to_usb_device(dev); \ |
450 | return sprintf(buf, format_string, \ | |
1da177e4 LT |
451 | le16_to_cpu(udev->descriptor.field)); \ |
452 | } \ | |
453 | static DEVICE_ATTR(field, S_IRUGO, show_##field, NULL); | |
454 | ||
455 | usb_descriptor_attr_le16(idVendor, "%04x\n") | |
456 | usb_descriptor_attr_le16(idProduct, "%04x\n") | |
457 | usb_descriptor_attr_le16(bcdDevice, "%04x\n") | |
458 | ||
459 | #define usb_descriptor_attr(field, format_string) \ | |
460 | static ssize_t \ | |
9251644a | 461 | show_##field(struct device *dev, struct device_attribute *attr, \ |
b724ae77 | 462 | char *buf) \ |
1da177e4 LT |
463 | { \ |
464 | struct usb_device *udev; \ | |
465 | \ | |
9251644a ON |
466 | udev = to_usb_device(dev); \ |
467 | return sprintf(buf, format_string, udev->descriptor.field); \ | |
1da177e4 LT |
468 | } \ |
469 | static DEVICE_ATTR(field, S_IRUGO, show_##field, NULL); | |
470 | ||
9251644a ON |
471 | usb_descriptor_attr(bDeviceClass, "%02x\n") |
472 | usb_descriptor_attr(bDeviceSubClass, "%02x\n") | |
473 | usb_descriptor_attr(bDeviceProtocol, "%02x\n") | |
474 | usb_descriptor_attr(bNumConfigurations, "%d\n") | |
475 | usb_descriptor_attr(bMaxPacketSize0, "%d\n") | |
1da177e4 | 476 | |
e03f2e8a IPG |
477 | |
478 | ||
479 | /* show if the device is authorized (1) or not (0) */ | |
480 | static ssize_t usb_dev_authorized_show(struct device *dev, | |
481 | struct device_attribute *attr, | |
482 | char *buf) | |
483 | { | |
484 | struct usb_device *usb_dev = to_usb_device(dev); | |
485 | return snprintf(buf, PAGE_SIZE, "%u\n", usb_dev->authorized); | |
486 | } | |
487 | ||
488 | ||
489 | /* | |
490 | * Authorize a device to be used in the system | |
491 | * | |
492 | * Writing a 0 deauthorizes the device, writing a 1 authorizes it. | |
493 | */ | |
494 | static ssize_t usb_dev_authorized_store(struct device *dev, | |
495 | struct device_attribute *attr, | |
496 | const char *buf, size_t size) | |
497 | { | |
498 | ssize_t result; | |
499 | struct usb_device *usb_dev = to_usb_device(dev); | |
500 | unsigned val; | |
501 | result = sscanf(buf, "%u\n", &val); | |
502 | if (result != 1) | |
503 | result = -EINVAL; | |
504 | else if (val == 0) | |
505 | result = usb_deauthorize_device(usb_dev); | |
506 | else | |
507 | result = usb_authorize_device(usb_dev); | |
508 | return result < 0? result : size; | |
509 | } | |
510 | ||
511 | static DEVICE_ATTR(authorized, 0644, | |
512 | usb_dev_authorized_show, usb_dev_authorized_store); | |
513 | ||
253e0572 AS |
514 | /* "Safely remove a device" */ |
515 | static ssize_t usb_remove_store(struct device *dev, | |
516 | struct device_attribute *attr, | |
517 | const char *buf, size_t count) | |
518 | { | |
519 | struct usb_device *udev = to_usb_device(dev); | |
520 | int rc = 0; | |
521 | ||
522 | usb_lock_device(udev); | |
523 | if (udev->state != USB_STATE_NOTATTACHED) { | |
524 | ||
525 | /* To avoid races, first unconfigure and then remove */ | |
526 | usb_set_configuration(udev, -1); | |
527 | rc = usb_remove_device(udev); | |
528 | } | |
529 | if (rc == 0) | |
530 | rc = count; | |
531 | usb_unlock_device(udev); | |
532 | return rc; | |
533 | } | |
534 | static DEVICE_ATTR(remove, 0200, NULL, usb_remove_store); | |
535 | ||
e03f2e8a | 536 | |
1da177e4 LT |
537 | static struct attribute *dev_attrs[] = { |
538 | /* current configuration's attributes */ | |
b6eb2d84 | 539 | &dev_attr_configuration.attr, |
1da177e4 LT |
540 | &dev_attr_bNumInterfaces.attr, |
541 | &dev_attr_bConfigurationValue.attr, | |
542 | &dev_attr_bmAttributes.attr, | |
543 | &dev_attr_bMaxPower.attr, | |
544 | /* device attributes */ | |
9af23624 | 545 | &dev_attr_urbnum.attr, |
1da177e4 LT |
546 | &dev_attr_idVendor.attr, |
547 | &dev_attr_idProduct.attr, | |
548 | &dev_attr_bcdDevice.attr, | |
549 | &dev_attr_bDeviceClass.attr, | |
550 | &dev_attr_bDeviceSubClass.attr, | |
551 | &dev_attr_bDeviceProtocol.attr, | |
552 | &dev_attr_bNumConfigurations.attr, | |
cf5910bb | 553 | &dev_attr_bMaxPacketSize0.attr, |
1da177e4 | 554 | &dev_attr_speed.attr, |
83f7d958 | 555 | &dev_attr_busnum.attr, |
1da177e4 | 556 | &dev_attr_devnum.attr, |
9af23624 | 557 | &dev_attr_devpath.attr, |
1da177e4 LT |
558 | &dev_attr_version.attr, |
559 | &dev_attr_maxchild.attr, | |
7ceec1f1 | 560 | &dev_attr_quirks.attr, |
e03f2e8a | 561 | &dev_attr_authorized.attr, |
253e0572 | 562 | &dev_attr_remove.attr, |
1da177e4 LT |
563 | NULL, |
564 | }; | |
565 | static struct attribute_group dev_attr_grp = { | |
566 | .attrs = dev_attrs, | |
567 | }; | |
568 | ||
2e5f10e4 AS |
569 | /* When modifying this list, be sure to modify dev_string_attrs_are_visible() |
570 | * accordingly. | |
571 | */ | |
572 | static struct attribute *dev_string_attrs[] = { | |
573 | &dev_attr_manufacturer.attr, | |
574 | &dev_attr_product.attr, | |
575 | &dev_attr_serial.attr, | |
576 | NULL | |
577 | }; | |
578 | ||
579 | static mode_t dev_string_attrs_are_visible(struct kobject *kobj, | |
580 | struct attribute *a, int n) | |
581 | { | |
a864e3aa HS |
582 | struct device *dev = container_of(kobj, struct device, kobj); |
583 | struct usb_device *udev = to_usb_device(dev); | |
2e5f10e4 AS |
584 | |
585 | if (a == &dev_attr_manufacturer.attr) { | |
586 | if (udev->manufacturer == NULL) | |
587 | return 0; | |
588 | } else if (a == &dev_attr_product.attr) { | |
589 | if (udev->product == NULL) | |
590 | return 0; | |
591 | } else if (a == &dev_attr_serial.attr) { | |
592 | if (udev->serial == NULL) | |
593 | return 0; | |
594 | } | |
595 | return a->mode; | |
596 | } | |
597 | ||
598 | static struct attribute_group dev_string_attr_grp = { | |
599 | .attrs = dev_string_attrs, | |
600 | .is_visible = dev_string_attrs_are_visible, | |
601 | }; | |
602 | ||
a4dbd674 | 603 | const struct attribute_group *usb_device_groups[] = { |
2e5f10e4 AS |
604 | &dev_attr_grp, |
605 | &dev_string_attr_grp, | |
606 | NULL | |
607 | }; | |
608 | ||
69d42a78 AS |
609 | /* Binary descriptors */ |
610 | ||
611 | static ssize_t | |
612 | read_descriptors(struct kobject *kobj, struct bin_attribute *attr, | |
613 | char *buf, loff_t off, size_t count) | |
614 | { | |
a864e3aa HS |
615 | struct device *dev = container_of(kobj, struct device, kobj); |
616 | struct usb_device *udev = to_usb_device(dev); | |
69d42a78 AS |
617 | size_t nleft = count; |
618 | size_t srclen, n; | |
217a9081 AS |
619 | int cfgno; |
620 | void *src; | |
69d42a78 | 621 | |
217a9081 AS |
622 | /* The binary attribute begins with the device descriptor. |
623 | * Following that are the raw descriptor entries for all the | |
624 | * configurations (config plus subsidiary descriptors). | |
69d42a78 | 625 | */ |
217a9081 AS |
626 | for (cfgno = -1; cfgno < udev->descriptor.bNumConfigurations && |
627 | nleft > 0; ++cfgno) { | |
628 | if (cfgno < 0) { | |
629 | src = &udev->descriptor; | |
630 | srclen = sizeof(struct usb_device_descriptor); | |
631 | } else { | |
632 | src = udev->rawdescriptors[cfgno]; | |
633 | srclen = __le16_to_cpu(udev->config[cfgno].desc. | |
634 | wTotalLength); | |
635 | } | |
69d42a78 | 636 | if (off < srclen) { |
217a9081 AS |
637 | n = min(nleft, srclen - (size_t) off); |
638 | memcpy(buf, src + off, n); | |
69d42a78 | 639 | nleft -= n; |
217a9081 AS |
640 | buf += n; |
641 | off = 0; | |
642 | } else { | |
643 | off -= srclen; | |
69d42a78 AS |
644 | } |
645 | } | |
69d42a78 AS |
646 | return count - nleft; |
647 | } | |
648 | ||
649 | static struct bin_attribute dev_bin_attr_descriptors = { | |
650 | .attr = {.name = "descriptors", .mode = 0444}, | |
651 | .read = read_descriptors, | |
652 | .size = 18 + 65535, /* dev descr + max-size raw descriptor */ | |
653 | }; | |
654 | ||
1b21d5e1 | 655 | int usb_create_sysfs_dev_files(struct usb_device *udev) |
1da177e4 LT |
656 | { |
657 | struct device *dev = &udev->dev; | |
1b21d5e1 | 658 | int retval; |
1da177e4 | 659 | |
69d42a78 AS |
660 | retval = device_create_bin_file(dev, &dev_bin_attr_descriptors); |
661 | if (retval) | |
662 | goto error; | |
663 | ||
b41a60ec AS |
664 | retval = add_persist_attributes(dev); |
665 | if (retval) | |
666 | goto error; | |
667 | ||
19c26239 AS |
668 | retval = add_power_attributes(dev); |
669 | if (retval) | |
670 | goto error; | |
3b23dd6f | 671 | return retval; |
1b21d5e1 | 672 | error: |
aa084f3e | 673 | usb_remove_sysfs_dev_files(udev); |
1b21d5e1 | 674 | return retval; |
1da177e4 LT |
675 | } |
676 | ||
9251644a | 677 | void usb_remove_sysfs_dev_files(struct usb_device *udev) |
1da177e4 LT |
678 | { |
679 | struct device *dev = &udev->dev; | |
680 | ||
19c26239 | 681 | remove_power_attributes(dev); |
b41a60ec | 682 | remove_persist_attributes(dev); |
69d42a78 | 683 | device_remove_bin_file(dev, &dev_bin_attr_descriptors); |
1da177e4 LT |
684 | } |
685 | ||
165fe97e CN |
686 | /* Interface Accociation Descriptor fields */ |
687 | #define usb_intf_assoc_attr(field, format_string) \ | |
688 | static ssize_t \ | |
2c044a48 | 689 | show_iad_##field(struct device *dev, struct device_attribute *attr, \ |
165fe97e CN |
690 | char *buf) \ |
691 | { \ | |
2c044a48 | 692 | struct usb_interface *intf = to_usb_interface(dev); \ |
165fe97e | 693 | \ |
2c044a48 GKH |
694 | return sprintf(buf, format_string, \ |
695 | intf->intf_assoc->field); \ | |
165fe97e CN |
696 | } \ |
697 | static DEVICE_ATTR(iad_##field, S_IRUGO, show_iad_##field, NULL); | |
698 | ||
2c044a48 GKH |
699 | usb_intf_assoc_attr(bFirstInterface, "%02x\n") |
700 | usb_intf_assoc_attr(bInterfaceCount, "%02d\n") | |
701 | usb_intf_assoc_attr(bFunctionClass, "%02x\n") | |
702 | usb_intf_assoc_attr(bFunctionSubClass, "%02x\n") | |
703 | usb_intf_assoc_attr(bFunctionProtocol, "%02x\n") | |
165fe97e | 704 | |
1da177e4 LT |
705 | /* Interface fields */ |
706 | #define usb_intf_attr(field, format_string) \ | |
707 | static ssize_t \ | |
9251644a | 708 | show_##field(struct device *dev, struct device_attribute *attr, \ |
b724ae77 | 709 | char *buf) \ |
1da177e4 | 710 | { \ |
9251644a | 711 | struct usb_interface *intf = to_usb_interface(dev); \ |
1da177e4 | 712 | \ |
9251644a | 713 | return sprintf(buf, format_string, \ |
b724ae77 | 714 | intf->cur_altsetting->desc.field); \ |
1da177e4 LT |
715 | } \ |
716 | static DEVICE_ATTR(field, S_IRUGO, show_##field, NULL); | |
717 | ||
9251644a ON |
718 | usb_intf_attr(bInterfaceNumber, "%02x\n") |
719 | usb_intf_attr(bAlternateSetting, "%2d\n") | |
720 | usb_intf_attr(bNumEndpoints, "%02x\n") | |
721 | usb_intf_attr(bInterfaceClass, "%02x\n") | |
722 | usb_intf_attr(bInterfaceSubClass, "%02x\n") | |
723 | usb_intf_attr(bInterfaceProtocol, "%02x\n") | |
1da177e4 | 724 | |
b724ae77 AS |
725 | static ssize_t show_interface_string(struct device *dev, |
726 | struct device_attribute *attr, char *buf) | |
1da177e4 LT |
727 | { |
728 | struct usb_interface *intf; | |
2e5f10e4 | 729 | char *string; |
1da177e4 | 730 | |
9251644a | 731 | intf = to_usb_interface(dev); |
2e5f10e4 AS |
732 | string = intf->cur_altsetting->string; |
733 | barrier(); /* The altsetting might change! */ | |
734 | ||
735 | if (!string) | |
1da177e4 | 736 | return 0; |
2e5f10e4 | 737 | return sprintf(buf, "%s\n", string); |
1da177e4 LT |
738 | } |
739 | static DEVICE_ATTR(interface, S_IRUGO, show_interface_string, NULL); | |
740 | ||
b724ae77 AS |
741 | static ssize_t show_modalias(struct device *dev, |
742 | struct device_attribute *attr, char *buf) | |
360b52b0 GK |
743 | { |
744 | struct usb_interface *intf; | |
745 | struct usb_device *udev; | |
7521803d | 746 | struct usb_host_interface *alt; |
360b52b0 GK |
747 | |
748 | intf = to_usb_interface(dev); | |
749 | udev = interface_to_usbdev(intf); | |
7521803d GKH |
750 | alt = intf->cur_altsetting; |
751 | ||
752 | return sprintf(buf, "usb:v%04Xp%04Xd%04Xdc%02Xdsc%02Xdp%02X" | |
753 | "ic%02Xisc%02Xip%02X\n", | |
754 | le16_to_cpu(udev->descriptor.idVendor), | |
755 | le16_to_cpu(udev->descriptor.idProduct), | |
756 | le16_to_cpu(udev->descriptor.bcdDevice), | |
757 | udev->descriptor.bDeviceClass, | |
758 | udev->descriptor.bDeviceSubClass, | |
759 | udev->descriptor.bDeviceProtocol, | |
760 | alt->desc.bInterfaceClass, | |
761 | alt->desc.bInterfaceSubClass, | |
762 | alt->desc.bInterfaceProtocol); | |
360b52b0 GK |
763 | } |
764 | static DEVICE_ATTR(modalias, S_IRUGO, show_modalias, NULL); | |
765 | ||
49e7cc84 SS |
766 | static ssize_t show_supports_autosuspend(struct device *dev, |
767 | struct device_attribute *attr, char *buf) | |
768 | { | |
769 | struct usb_interface *intf; | |
770 | struct usb_device *udev; | |
771 | int ret; | |
772 | ||
773 | intf = to_usb_interface(dev); | |
774 | udev = interface_to_usbdev(intf); | |
775 | ||
776 | usb_lock_device(udev); | |
777 | /* Devices will be autosuspended even when an interface isn't claimed */ | |
778 | if (!intf->dev.driver || | |
779 | to_usb_driver(intf->dev.driver)->supports_autosuspend) | |
780 | ret = sprintf(buf, "%u\n", 1); | |
781 | else | |
782 | ret = sprintf(buf, "%u\n", 0); | |
783 | usb_unlock_device(udev); | |
784 | ||
785 | return ret; | |
786 | } | |
787 | static DEVICE_ATTR(supports_autosuspend, S_IRUGO, show_supports_autosuspend, NULL); | |
788 | ||
1da177e4 LT |
789 | static struct attribute *intf_attrs[] = { |
790 | &dev_attr_bInterfaceNumber.attr, | |
791 | &dev_attr_bAlternateSetting.attr, | |
792 | &dev_attr_bNumEndpoints.attr, | |
793 | &dev_attr_bInterfaceClass.attr, | |
794 | &dev_attr_bInterfaceSubClass.attr, | |
795 | &dev_attr_bInterfaceProtocol.attr, | |
360b52b0 | 796 | &dev_attr_modalias.attr, |
49e7cc84 | 797 | &dev_attr_supports_autosuspend.attr, |
1da177e4 LT |
798 | NULL, |
799 | }; | |
800 | static struct attribute_group intf_attr_grp = { | |
801 | .attrs = intf_attrs, | |
802 | }; | |
803 | ||
2e5f10e4 AS |
804 | static struct attribute *intf_assoc_attrs[] = { |
805 | &dev_attr_iad_bFirstInterface.attr, | |
806 | &dev_attr_iad_bInterfaceCount.attr, | |
807 | &dev_attr_iad_bFunctionClass.attr, | |
808 | &dev_attr_iad_bFunctionSubClass.attr, | |
809 | &dev_attr_iad_bFunctionProtocol.attr, | |
810 | NULL, | |
811 | }; | |
812 | ||
813 | static mode_t intf_assoc_attrs_are_visible(struct kobject *kobj, | |
814 | struct attribute *a, int n) | |
815 | { | |
a864e3aa HS |
816 | struct device *dev = container_of(kobj, struct device, kobj); |
817 | struct usb_interface *intf = to_usb_interface(dev); | |
2e5f10e4 AS |
818 | |
819 | if (intf->intf_assoc == NULL) | |
820 | return 0; | |
821 | return a->mode; | |
822 | } | |
823 | ||
824 | static struct attribute_group intf_assoc_attr_grp = { | |
825 | .attrs = intf_assoc_attrs, | |
826 | .is_visible = intf_assoc_attrs_are_visible, | |
827 | }; | |
828 | ||
a4dbd674 | 829 | const struct attribute_group *usb_interface_groups[] = { |
2e5f10e4 AS |
830 | &intf_attr_grp, |
831 | &intf_assoc_attr_grp, | |
832 | NULL | |
833 | }; | |
834 | ||
1b21d5e1 | 835 | int usb_create_sysfs_intf_files(struct usb_interface *intf) |
1da177e4 | 836 | { |
4f62efe6 AS |
837 | struct usb_device *udev = interface_to_usbdev(intf); |
838 | struct usb_host_interface *alt = intf->cur_altsetting; | |
1b21d5e1 | 839 | int retval; |
4f62efe6 | 840 | |
352d0263 | 841 | if (intf->sysfs_files_created || intf->unregistering) |
7e61559f | 842 | return 0; |
1da177e4 | 843 | |
1662e3a7 AS |
844 | if (alt->string == NULL && |
845 | !(udev->quirks & USB_QUIRK_CONFIG_INTF_STRINGS)) | |
4f62efe6 AS |
846 | alt->string = usb_cache_string(udev, alt->desc.iInterface); |
847 | if (alt->string) | |
2e5f10e4 | 848 | retval = device_create_file(&intf->dev, &dev_attr_interface); |
7e61559f | 849 | intf->sysfs_files_created = 1; |
1b21d5e1 | 850 | return 0; |
1da177e4 LT |
851 | } |
852 | ||
9251644a | 853 | void usb_remove_sysfs_intf_files(struct usb_interface *intf) |
1da177e4 | 854 | { |
7e61559f AS |
855 | if (!intf->sysfs_files_created) |
856 | return; | |
92b0da15 | 857 | |
92b0da15 | 858 | device_remove_file(&intf->dev, &dev_attr_interface); |
7e61559f | 859 | intf->sysfs_files_created = 0; |
1da177e4 | 860 | } |