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