sysfs.c 21.1 KB
Newer Older
L
Linus Torvalds 已提交
1 2 3 4 5 6 7 8 9 10 11 12 13
/*
 * drivers/usb/core/sysfs.c
 *
 * (C) Copyright 2002 David Brownell
 * (C) Copyright 2002,2004 Greg Kroah-Hartman
 * (C) Copyright 2002,2004 IBM Corp.
 *
 * All of the sysfs file attributes for usb devices and interfaces.
 *
 */


#include <linux/kernel.h>
14
#include <linux/string.h>
L
Linus Torvalds 已提交
15 16 17 18 19
#include <linux/usb.h>
#include "usb.h"

/* Active configuration fields */
#define usb_actconfig_show(field, multiplier, format_string)		\
20
static ssize_t  show_##field(struct device *dev,			\
21
		struct device_attribute *attr, char *buf)		\
L
Linus Torvalds 已提交
22 23 24 25
{									\
	struct usb_device *udev;					\
	struct usb_host_config *actconfig;				\
									\
26
	udev = to_usb_device(dev);					\
L
Linus Torvalds 已提交
27 28
	actconfig = udev->actconfig;					\
	if (actconfig)							\
29
		return sprintf(buf, format_string,			\
L
Linus Torvalds 已提交
30 31 32 33 34 35 36 37 38
				actconfig->desc.field * multiplier);	\
	else								\
		return 0;						\
}									\

#define usb_actconfig_attr(field, multiplier, format_string)		\
usb_actconfig_show(field, multiplier, format_string)			\
static DEVICE_ATTR(field, S_IRUGO, show_##field, NULL);

39 40 41
usb_actconfig_attr(bNumInterfaces, 1, "%2d\n")
usb_actconfig_attr(bmAttributes, 1, "%2x\n")
usb_actconfig_attr(bMaxPower, 2, "%3dmA\n")
L
Linus Torvalds 已提交
42

43 44
static ssize_t show_configuration_string(struct device *dev,
		struct device_attribute *attr, char *buf)
L
Linus Torvalds 已提交
45 46 47 48
{
	struct usb_device *udev;
	struct usb_host_config *actconfig;

49
	udev = to_usb_device(dev);
L
Linus Torvalds 已提交
50 51 52
	actconfig = udev->actconfig;
	if ((!actconfig) || (!actconfig->string))
		return 0;
53
	return sprintf(buf, "%s\n", actconfig->string);
L
Linus Torvalds 已提交
54 55 56 57 58 59 60
}
static DEVICE_ATTR(configuration, S_IRUGO, show_configuration_string, NULL);

/* configuration value is always present, and r/w */
usb_actconfig_show(bConfigurationValue, 1, "%u\n");

static ssize_t
61
set_bConfigurationValue(struct device *dev, struct device_attribute *attr,
62
		const char *buf, size_t count)
L
Linus Torvalds 已提交
63
{
64
	struct usb_device	*udev = to_usb_device(dev);
L
Linus Torvalds 已提交
65 66
	int			config, value;

67
	if (sscanf(buf, "%d", &config) != 1 || config < -1 || config > 255)
L
Linus Torvalds 已提交
68 69
		return -EINVAL;
	usb_lock_device(udev);
70
	value = usb_set_configuration(udev, config);
L
Linus Torvalds 已提交
71 72 73 74
	usb_unlock_device(udev);
	return (value < 0) ? value : count;
}

75
static DEVICE_ATTR(bConfigurationValue, S_IRUGO | S_IWUSR,
L
Linus Torvalds 已提交
76 77 78 79
		show_bConfigurationValue, set_bConfigurationValue);

/* String fields */
#define usb_string_attr(name)						\
80 81
static ssize_t  show_##name(struct device *dev,				\
		struct device_attribute *attr, char *buf)		\
L
Linus Torvalds 已提交
82 83 84
{									\
	struct usb_device *udev;					\
									\
85
	udev = to_usb_device(dev);					\
86
	return sprintf(buf, "%s\n", udev->name);			\
L
Linus Torvalds 已提交
87 88 89 90 91 92 93 94
}									\
static DEVICE_ATTR(name, S_IRUGO, show_##name, NULL);

usb_string_attr(product);
usb_string_attr(manufacturer);
usb_string_attr(serial);

static ssize_t
95
show_speed(struct device *dev, struct device_attribute *attr, char *buf)
L
Linus Torvalds 已提交
96 97 98 99
{
	struct usb_device *udev;
	char *speed;

100
	udev = to_usb_device(dev);
L
Linus Torvalds 已提交
101 102 103 104 105 106 107 108 109 110 111 112 113 114 115

	switch (udev->speed) {
	case USB_SPEED_LOW:
		speed = "1.5";
		break;
	case USB_SPEED_UNKNOWN:
	case USB_SPEED_FULL:
		speed = "12";
		break;
	case USB_SPEED_HIGH:
		speed = "480";
		break;
	default:
		speed = "unknown";
	}
116
	return sprintf(buf, "%s\n", speed);
L
Linus Torvalds 已提交
117 118 119
}
static DEVICE_ATTR(speed, S_IRUGO, show_speed, NULL);

120 121 122 123 124 125 126 127 128 129
static ssize_t
show_busnum(struct device *dev, struct device_attribute *attr, char *buf)
{
	struct usb_device *udev;

	udev = to_usb_device(dev);
	return sprintf(buf, "%d\n", udev->bus->busnum);
}
static DEVICE_ATTR(busnum, S_IRUGO, show_busnum, NULL);

L
Linus Torvalds 已提交
130
static ssize_t
131
show_devnum(struct device *dev, struct device_attribute *attr, char *buf)
L
Linus Torvalds 已提交
132 133 134
{
	struct usb_device *udev;

135 136
	udev = to_usb_device(dev);
	return sprintf(buf, "%d\n", udev->devnum);
L
Linus Torvalds 已提交
137 138 139 140
}
static DEVICE_ATTR(devnum, S_IRUGO, show_devnum, NULL);

static ssize_t
141
show_version(struct device *dev, struct device_attribute *attr, char *buf)
L
Linus Torvalds 已提交
142 143 144 145 146 147 148 149 150 151 152
{
	struct usb_device *udev;
	u16 bcdUSB;

	udev = to_usb_device(dev);
	bcdUSB = le16_to_cpu(udev->descriptor.bcdUSB);
	return sprintf(buf, "%2x.%02x\n", bcdUSB >> 8, bcdUSB & 0xff);
}
static DEVICE_ATTR(version, S_IRUGO, show_version, NULL);

static ssize_t
153
show_maxchild(struct device *dev, struct device_attribute *attr, char *buf)
L
Linus Torvalds 已提交
154 155 156
{
	struct usb_device *udev;

157 158
	udev = to_usb_device(dev);
	return sprintf(buf, "%d\n", udev->maxchild);
L
Linus Torvalds 已提交
159 160 161
}
static DEVICE_ATTR(maxchild, S_IRUGO, show_maxchild, NULL);

162 163 164 165 166 167 168 169 170 171
static ssize_t
show_quirks(struct device *dev, struct device_attribute *attr, char *buf)
{
	struct usb_device *udev;

	udev = to_usb_device(dev);
	return sprintf(buf, "0x%x\n", udev->quirks);
}
static DEVICE_ATTR(quirks, S_IRUGO, show_quirks, NULL);

172 173 174 175 176 177 178 179 180 181
static ssize_t
show_urbnum(struct device *dev, struct device_attribute *attr, char *buf)
{
	struct usb_device *udev;

	udev = to_usb_device(dev);
	return sprintf(buf, "%d\n", atomic_read(&udev->urbnum));
}
static DEVICE_ATTR(urbnum, S_IRUGO, show_urbnum, NULL);

182 183 184 185 186 187 188 189 190 191 192 193 194 195 196 197 198 199 200 201 202 203 204 205 206 207 208 209 210 211 212 213 214 215 216 217 218 219 220 221 222 223 224 225 226 227 228 229 230 231 232 233 234 235 236 237 238 239 240 241 242 243 244 245 246 247 248

#if defined(CONFIG_USB_PERSIST) || defined(CONFIG_USB_SUSPEND)
static const char power_group[] = "power";
#endif

#ifdef	CONFIG_USB_PERSIST

static ssize_t
show_persist(struct device *dev, struct device_attribute *attr, char *buf)
{
	struct usb_device *udev = to_usb_device(dev);

	return sprintf(buf, "%d\n", udev->persist_enabled);
}

static ssize_t
set_persist(struct device *dev, struct device_attribute *attr,
		const char *buf, size_t count)
{
	struct usb_device *udev = to_usb_device(dev);
	int value;

	/* Hubs are always enabled for USB_PERSIST */
	if (udev->descriptor.bDeviceClass == USB_CLASS_HUB)
		return -EPERM;

	if (sscanf(buf, "%d", &value) != 1)
		return -EINVAL;
	usb_pm_lock(udev);
	udev->persist_enabled = !!value;
	usb_pm_unlock(udev);
	return count;
}

static DEVICE_ATTR(persist, S_IRUGO | S_IWUSR, show_persist, set_persist);

static int add_persist_attributes(struct device *dev)
{
	int rc = 0;

	if (is_usb_device(dev)) {
		struct usb_device *udev = to_usb_device(dev);

		/* Hubs are automatically enabled for USB_PERSIST */
		if (udev->descriptor.bDeviceClass == USB_CLASS_HUB)
			udev->persist_enabled = 1;
		rc = sysfs_add_file_to_group(&dev->kobj,
				&dev_attr_persist.attr,
				power_group);
	}
	return rc;
}

static void remove_persist_attributes(struct device *dev)
{
	sysfs_remove_file_from_group(&dev->kobj,
			&dev_attr_persist.attr,
			power_group);
}

#else

#define add_persist_attributes(dev)	0
#define remove_persist_attributes(dev)	do {} while (0)

#endif	/* CONFIG_USB_PERSIST */

249 250
#ifdef	CONFIG_USB_SUSPEND

S
Sarah Sharp 已提交
251 252 253 254 255 256 257 258 259 260 261 262 263 264 265 266 267 268 269 270 271 272 273 274 275 276 277 278 279 280 281 282 283 284 285
static ssize_t
show_connected_duration(struct device *dev, struct device_attribute *attr,
		char *buf)
{
	struct usb_device *udev = to_usb_device(dev);

	return sprintf(buf, "%u\n",
			jiffies_to_msecs(jiffies - udev->connect_time));
}

static DEVICE_ATTR(connected_duration, S_IRUGO, show_connected_duration, NULL);

/*
 * If the device is resumed, the last time the device was suspended has
 * been pre-subtracted from active_duration.  We add the current time to
 * get the duration that the device was actually active.
 *
 * If the device is suspended, the active_duration is up-to-date.
 */
static ssize_t
show_active_duration(struct device *dev, struct device_attribute *attr,
		char *buf)
{
	struct usb_device *udev = to_usb_device(dev);
	int duration;

	if (udev->state != USB_STATE_SUSPENDED)
		duration = jiffies_to_msecs(jiffies + udev->active_duration);
	else
		duration = jiffies_to_msecs(udev->active_duration);
	return sprintf(buf, "%u\n", duration);
}

static DEVICE_ATTR(active_duration, S_IRUGO, show_active_duration, NULL);

286 287 288 289 290
static ssize_t
show_autosuspend(struct device *dev, struct device_attribute *attr, char *buf)
{
	struct usb_device *udev = to_usb_device(dev);

291
	return sprintf(buf, "%d\n", udev->autosuspend_delay / HZ);
292 293 294 295 296 297 298
}

static ssize_t
set_autosuspend(struct device *dev, struct device_attribute *attr,
		const char *buf, size_t count)
{
	struct usb_device *udev = to_usb_device(dev);
299
	int value;
300

301 302
	if (sscanf(buf, "%d", &value) != 1 || value >= INT_MAX/HZ ||
			value <= - INT_MAX/HZ)
303 304 305 306
		return -EINVAL;
	value *= HZ;

	udev->autosuspend_delay = value;
307
	if (value >= 0)
308
		usb_try_autosuspend_device(udev);
309
	else {
310 311
		if (usb_autoresume_device(udev) == 0)
			usb_autosuspend_device(udev);
312
	}
313 314 315 316 317 318
	return count;
}

static DEVICE_ATTR(autosuspend, S_IRUGO | S_IWUSR,
		show_autosuspend, set_autosuspend);

319 320 321 322 323 324 325 326 327 328 329 330 331 332 333 334 335 336 337 338 339 340 341 342 343 344 345 346
static const char on_string[] = "on";
static const char auto_string[] = "auto";
static const char suspend_string[] = "suspend";

static ssize_t
show_level(struct device *dev, struct device_attribute *attr, char *buf)
{
	struct usb_device *udev = to_usb_device(dev);
	const char *p = auto_string;

	if (udev->state == USB_STATE_SUSPENDED) {
		if (udev->autoresume_disabled)
			p = suspend_string;
	} else {
		if (udev->autosuspend_disabled)
			p = on_string;
	}
	return sprintf(buf, "%s\n", p);
}

static ssize_t
set_level(struct device *dev, struct device_attribute *attr,
		const char *buf, size_t count)
{
	struct usb_device *udev = to_usb_device(dev);
	int len = count;
	char *cp;
	int rc = 0;
347
	int old_autosuspend_disabled, old_autoresume_disabled;
348 349 350 351 352 353

	cp = memchr(buf, '\n', count);
	if (cp)
		len = cp - buf;

	usb_lock_device(udev);
354 355
	old_autosuspend_disabled = udev->autosuspend_disabled;
	old_autoresume_disabled = udev->autoresume_disabled;
356 357 358 359 360 361 362 363 364 365 366 367 368 369 370 371 372 373 374 375 376 377 378 379 380

	/* Setting the flags without calling usb_pm_lock is a subject to
	 * races, but who cares...
	 */
	if (len == sizeof on_string - 1 &&
			strncmp(buf, on_string, len) == 0) {
		udev->autosuspend_disabled = 1;
		udev->autoresume_disabled = 0;
		rc = usb_external_resume_device(udev);

	} else if (len == sizeof auto_string - 1 &&
			strncmp(buf, auto_string, len) == 0) {
		udev->autosuspend_disabled = 0;
		udev->autoresume_disabled = 0;
		rc = usb_external_resume_device(udev);

	} else if (len == sizeof suspend_string - 1 &&
			strncmp(buf, suspend_string, len) == 0) {
		udev->autosuspend_disabled = 0;
		udev->autoresume_disabled = 1;
		rc = usb_external_suspend_device(udev, PMSG_SUSPEND);

	} else
		rc = -EINVAL;

381 382 383 384
	if (rc) {
		udev->autosuspend_disabled = old_autosuspend_disabled;
		udev->autoresume_disabled = old_autoresume_disabled;
	}
385 386 387 388 389 390
	usb_unlock_device(udev);
	return (rc < 0 ? rc : count);
}

static DEVICE_ATTR(level, S_IRUGO | S_IWUSR, show_level, set_level);

391 392 393 394
static int add_power_attributes(struct device *dev)
{
	int rc = 0;

395
	if (is_usb_device(dev)) {
396 397 398
		rc = sysfs_add_file_to_group(&dev->kobj,
				&dev_attr_autosuspend.attr,
				power_group);
399 400 401 402
		if (rc == 0)
			rc = sysfs_add_file_to_group(&dev->kobj,
					&dev_attr_level.attr,
					power_group);
S
Sarah Sharp 已提交
403 404 405 406 407 408 409 410
		if (rc == 0)
			rc = sysfs_add_file_to_group(&dev->kobj,
					&dev_attr_connected_duration.attr,
					power_group);
		if (rc == 0)
			rc = sysfs_add_file_to_group(&dev->kobj,
					&dev_attr_active_duration.attr,
					power_group);
411
	}
412 413 414 415 416
	return rc;
}

static void remove_power_attributes(struct device *dev)
{
S
Sarah Sharp 已提交
417 418 419 420 421 422
	sysfs_remove_file_from_group(&dev->kobj,
			&dev_attr_active_duration.attr,
			power_group);
	sysfs_remove_file_from_group(&dev->kobj,
			&dev_attr_connected_duration.attr,
			power_group);
423 424 425
	sysfs_remove_file_from_group(&dev->kobj,
			&dev_attr_level.attr,
			power_group);
426 427 428 429 430 431 432 433 434 435 436 437
	sysfs_remove_file_from_group(&dev->kobj,
			&dev_attr_autosuspend.attr,
			power_group);
}

#else

#define add_power_attributes(dev)	0
#define remove_power_attributes(dev)	do {} while (0)

#endif	/* CONFIG_USB_SUSPEND */

438

L
Linus Torvalds 已提交
439 440 441
/* Descriptor fields */
#define usb_descriptor_attr_le16(field, format_string)			\
static ssize_t								\
442
show_##field(struct device *dev, struct device_attribute *attr,	\
443
		char *buf)						\
L
Linus Torvalds 已提交
444 445 446
{									\
	struct usb_device *udev;					\
									\
447 448
	udev = to_usb_device(dev);					\
	return sprintf(buf, format_string, 				\
L
Linus Torvalds 已提交
449 450 451 452 453 454 455 456 457 458
			le16_to_cpu(udev->descriptor.field));		\
}									\
static DEVICE_ATTR(field, S_IRUGO, show_##field, NULL);

usb_descriptor_attr_le16(idVendor, "%04x\n")
usb_descriptor_attr_le16(idProduct, "%04x\n")
usb_descriptor_attr_le16(bcdDevice, "%04x\n")

#define usb_descriptor_attr(field, format_string)			\
static ssize_t								\
459
show_##field(struct device *dev, struct device_attribute *attr,	\
460
		char *buf)						\
L
Linus Torvalds 已提交
461 462 463
{									\
	struct usb_device *udev;					\
									\
464 465
	udev = to_usb_device(dev);					\
	return sprintf(buf, format_string, udev->descriptor.field);	\
L
Linus Torvalds 已提交
466 467 468
}									\
static DEVICE_ATTR(field, S_IRUGO, show_##field, NULL);

469 470 471 472 473
usb_descriptor_attr(bDeviceClass, "%02x\n")
usb_descriptor_attr(bDeviceSubClass, "%02x\n")
usb_descriptor_attr(bDeviceProtocol, "%02x\n")
usb_descriptor_attr(bNumConfigurations, "%d\n")
usb_descriptor_attr(bMaxPacketSize0, "%d\n")
L
Linus Torvalds 已提交
474

475 476 477 478 479 480 481 482 483 484 485 486 487 488 489 490 491 492 493 494 495 496 497 498 499 500 501 502 503 504 505 506 507 508 509 510 511 512


/* show if the device is authorized (1) or not (0) */
static ssize_t usb_dev_authorized_show(struct device *dev,
				       struct device_attribute *attr,
				       char *buf)
{
	struct usb_device *usb_dev = to_usb_device(dev);
	return snprintf(buf, PAGE_SIZE, "%u\n", usb_dev->authorized);
}


/*
 * Authorize a device to be used in the system
 *
 * Writing a 0 deauthorizes the device, writing a 1 authorizes it.
 */
static ssize_t usb_dev_authorized_store(struct device *dev,
					struct device_attribute *attr,
					const char *buf, size_t size)
{
	ssize_t result;
	struct usb_device *usb_dev = to_usb_device(dev);
	unsigned val;
	result = sscanf(buf, "%u\n", &val);
	if (result != 1)
		result = -EINVAL;
	else if (val == 0)
		result = usb_deauthorize_device(usb_dev);
	else
		result = usb_authorize_device(usb_dev);
	return result < 0? result : size;
}

static DEVICE_ATTR(authorized, 0644,
	    usb_dev_authorized_show, usb_dev_authorized_store);


L
Linus Torvalds 已提交
513 514
static struct attribute *dev_attrs[] = {
	/* current configuration's attributes */
515
	&dev_attr_configuration.attr,
L
Linus Torvalds 已提交
516 517 518 519
	&dev_attr_bNumInterfaces.attr,
	&dev_attr_bConfigurationValue.attr,
	&dev_attr_bmAttributes.attr,
	&dev_attr_bMaxPower.attr,
520
	&dev_attr_urbnum.attr,
L
Linus Torvalds 已提交
521 522 523 524 525 526 527 528
	/* device attributes */
	&dev_attr_idVendor.attr,
	&dev_attr_idProduct.attr,
	&dev_attr_bcdDevice.attr,
	&dev_attr_bDeviceClass.attr,
	&dev_attr_bDeviceSubClass.attr,
	&dev_attr_bDeviceProtocol.attr,
	&dev_attr_bNumConfigurations.attr,
529
	&dev_attr_bMaxPacketSize0.attr,
L
Linus Torvalds 已提交
530
	&dev_attr_speed.attr,
531
	&dev_attr_busnum.attr,
L
Linus Torvalds 已提交
532 533 534
	&dev_attr_devnum.attr,
	&dev_attr_version.attr,
	&dev_attr_maxchild.attr,
535
	&dev_attr_quirks.attr,
536
	&dev_attr_authorized.attr,
L
Linus Torvalds 已提交
537 538 539 540 541 542
	NULL,
};
static struct attribute_group dev_attr_grp = {
	.attrs = dev_attrs,
};

543 544 545 546 547 548 549 550 551 552 553 554 555 556 557 558 559 560 561 562 563 564 565 566 567 568 569 570 571 572 573 574 575 576 577 578 579 580 581 582 583 584 585 586 587 588 589 590
/* Binary descriptors */

static ssize_t
read_descriptors(struct kobject *kobj, struct bin_attribute *attr,
		char *buf, loff_t off, size_t count)
{
	struct usb_device *udev = to_usb_device(
			container_of(kobj, struct device, kobj));
	size_t nleft = count;
	size_t srclen, n;

	usb_lock_device(udev);

	/* The binary attribute begins with the device descriptor */
	srclen = sizeof(struct usb_device_descriptor);
	if (off < srclen) {
		n = min_t(size_t, nleft, srclen - off);
		memcpy(buf, off + (char *) &udev->descriptor, n);
		nleft -= n;
		buf += n;
		off = 0;
	} else {
		off -= srclen;
	}

	/* Then follows the raw descriptor entry for the current
	 * configuration (config plus subsidiary descriptors).
	 */
	if (udev->actconfig) {
		int cfgno = udev->actconfig - udev->config;

		srclen = __le16_to_cpu(udev->actconfig->desc.wTotalLength);
		if (off < srclen) {
			n = min_t(size_t, nleft, srclen - off);
			memcpy(buf, off + udev->rawdescriptors[cfgno], n);
			nleft -= n;
		}
	}
	usb_unlock_device(udev);
	return count - nleft;
}

static struct bin_attribute dev_bin_attr_descriptors = {
	.attr = {.name = "descriptors", .mode = 0444},
	.read = read_descriptors,
	.size = 18 + 65535,	/* dev descr + max-size raw descriptor */
};

591
int usb_create_sysfs_dev_files(struct usb_device *udev)
L
Linus Torvalds 已提交
592 593
{
	struct device *dev = &udev->dev;
594
	int retval;
L
Linus Torvalds 已提交
595

596 597 598
	retval = sysfs_create_group(&dev->kobj, &dev_attr_grp);
	if (retval)
		return retval;
L
Linus Torvalds 已提交
599

600 601 602 603
	retval = device_create_bin_file(dev, &dev_bin_attr_descriptors);
	if (retval)
		goto error;

604 605 606 607
	retval = add_persist_attributes(dev);
	if (retval)
		goto error;

608 609 610 611
	retval = add_power_attributes(dev);
	if (retval)
		goto error;

612
	if (udev->manufacturer) {
613
		retval = device_create_file(dev, &dev_attr_manufacturer);
614 615 616 617
		if (retval)
			goto error;
	}
	if (udev->product) {
618
		retval = device_create_file(dev, &dev_attr_product);
619 620 621 622
		if (retval)
			goto error;
	}
	if (udev->serial) {
623
		retval = device_create_file(dev, &dev_attr_serial);
624 625 626 627 628 629 630 631
		if (retval)
			goto error;
	}
	retval = usb_create_ep_files(dev, &udev->ep0, udev);
	if (retval)
		goto error;
	return 0;
error:
A
Alan Stern 已提交
632
	usb_remove_sysfs_dev_files(udev);
633
	return retval;
L
Linus Torvalds 已提交
634 635
}

636
void usb_remove_sysfs_dev_files(struct usb_device *udev)
L
Linus Torvalds 已提交
637 638 639
{
	struct device *dev = &udev->dev;

640
	usb_remove_ep_files(&udev->ep0);
A
Alan Stern 已提交
641 642 643
	device_remove_file(dev, &dev_attr_manufacturer);
	device_remove_file(dev, &dev_attr_product);
	device_remove_file(dev, &dev_attr_serial);
644
	remove_power_attributes(dev);
645
	remove_persist_attributes(dev);
646
	device_remove_bin_file(dev, &dev_bin_attr_descriptors);
L
Linus Torvalds 已提交
647 648 649
	sysfs_remove_group(&dev->kobj, &dev_attr_grp);
}

650 651 652
/* Interface Accociation Descriptor fields */
#define usb_intf_assoc_attr(field, format_string)			\
static ssize_t								\
653
show_iad_##field(struct device *dev, struct device_attribute *attr,	\
654 655
		char *buf)						\
{									\
656
	struct usb_interface *intf = to_usb_interface(dev);		\
657
									\
658 659
	return sprintf(buf, format_string,				\
			intf->intf_assoc->field); 			\
660 661 662
}									\
static DEVICE_ATTR(iad_##field, S_IRUGO, show_iad_##field, NULL);

663 664 665 666 667
usb_intf_assoc_attr(bFirstInterface, "%02x\n")
usb_intf_assoc_attr(bInterfaceCount, "%02d\n")
usb_intf_assoc_attr(bFunctionClass, "%02x\n")
usb_intf_assoc_attr(bFunctionSubClass, "%02x\n")
usb_intf_assoc_attr(bFunctionProtocol, "%02x\n")
668

L
Linus Torvalds 已提交
669 670 671
/* Interface fields */
#define usb_intf_attr(field, format_string)				\
static ssize_t								\
672
show_##field(struct device *dev, struct device_attribute *attr,	\
673
		char *buf)						\
L
Linus Torvalds 已提交
674
{									\
675
	struct usb_interface *intf = to_usb_interface(dev);		\
L
Linus Torvalds 已提交
676
									\
677
	return sprintf(buf, format_string,				\
678
			intf->cur_altsetting->desc.field); 		\
L
Linus Torvalds 已提交
679 680 681
}									\
static DEVICE_ATTR(field, S_IRUGO, show_##field, NULL);

682 683 684 685 686 687
usb_intf_attr(bInterfaceNumber, "%02x\n")
usb_intf_attr(bAlternateSetting, "%2d\n")
usb_intf_attr(bNumEndpoints, "%02x\n")
usb_intf_attr(bInterfaceClass, "%02x\n")
usb_intf_attr(bInterfaceSubClass, "%02x\n")
usb_intf_attr(bInterfaceProtocol, "%02x\n")
L
Linus Torvalds 已提交
688

689 690
static ssize_t show_interface_string(struct device *dev,
		struct device_attribute *attr, char *buf)
L
Linus Torvalds 已提交
691 692 693 694 695
{
	struct usb_interface *intf;
	struct usb_device *udev;
	int len;

696 697
	intf = to_usb_interface(dev);
	udev = interface_to_usbdev(intf);
L
Linus Torvalds 已提交
698 699 700 701 702 703 704 705 706
	len = snprintf(buf, 256, "%s", intf->cur_altsetting->string);
	if (len < 0)
		return 0;
	buf[len] = '\n';
	buf[len+1] = 0;
	return len+1;
}
static DEVICE_ATTR(interface, S_IRUGO, show_interface_string, NULL);

707 708
static ssize_t show_modalias(struct device *dev,
		struct device_attribute *attr, char *buf)
709 710 711
{
	struct usb_interface *intf;
	struct usb_device *udev;
712
	struct usb_host_interface *alt;
713 714 715

	intf = to_usb_interface(dev);
	udev = interface_to_usbdev(intf);
716 717 718 719 720 721 722 723 724 725 726 727 728
	alt = intf->cur_altsetting;

	return sprintf(buf, "usb:v%04Xp%04Xd%04Xdc%02Xdsc%02Xdp%02X"
			"ic%02Xisc%02Xip%02X\n",
			le16_to_cpu(udev->descriptor.idVendor),
			le16_to_cpu(udev->descriptor.idProduct),
			le16_to_cpu(udev->descriptor.bcdDevice),
			udev->descriptor.bDeviceClass,
			udev->descriptor.bDeviceSubClass,
			udev->descriptor.bDeviceProtocol,
			alt->desc.bInterfaceClass,
			alt->desc.bInterfaceSubClass,
			alt->desc.bInterfaceProtocol);
729 730 731
}
static DEVICE_ATTR(modalias, S_IRUGO, show_modalias, NULL);

732 733 734 735 736 737 738 739 740 741 742 743
static struct attribute *intf_assoc_attrs[] = {
	&dev_attr_iad_bFirstInterface.attr,
	&dev_attr_iad_bInterfaceCount.attr,
	&dev_attr_iad_bFunctionClass.attr,
	&dev_attr_iad_bFunctionSubClass.attr,
	&dev_attr_iad_bFunctionProtocol.attr,
	NULL,
};
static struct attribute_group intf_assoc_attr_grp = {
	.attrs = intf_assoc_attrs,
};

L
Linus Torvalds 已提交
744 745 746 747 748 749 750
static struct attribute *intf_attrs[] = {
	&dev_attr_bInterfaceNumber.attr,
	&dev_attr_bAlternateSetting.attr,
	&dev_attr_bNumEndpoints.attr,
	&dev_attr_bInterfaceClass.attr,
	&dev_attr_bInterfaceSubClass.attr,
	&dev_attr_bInterfaceProtocol.attr,
751
	&dev_attr_modalias.attr,
L
Linus Torvalds 已提交
752 753 754 755 756 757
	NULL,
};
static struct attribute_group intf_attr_grp = {
	.attrs = intf_attrs,
};

758 759
static inline void usb_create_intf_ep_files(struct usb_interface *intf,
		struct usb_device *udev)
760 761 762 763 764 765
{
	struct usb_host_interface *iface_desc;
	int i;

	iface_desc = intf->cur_altsetting;
	for (i = 0; i < iface_desc->desc.bNumEndpoints; ++i)
766
		usb_create_ep_files(&intf->dev, &iface_desc->endpoint[i],
767
				udev);
768 769
}

770
static inline void usb_remove_intf_ep_files(struct usb_interface *intf)
771 772 773 774 775 776
{
	struct usb_host_interface *iface_desc;
	int i;

	iface_desc = intf->cur_altsetting;
	for (i = 0; i < iface_desc->desc.bNumEndpoints; ++i)
777
		usb_remove_ep_files(&iface_desc->endpoint[i]);
778 779
}

780
int usb_create_sysfs_intf_files(struct usb_interface *intf)
L
Linus Torvalds 已提交
781
{
A
Alan Stern 已提交
782
	struct device *dev = &intf->dev;
783 784
	struct usb_device *udev = interface_to_usbdev(intf);
	struct usb_host_interface *alt = intf->cur_altsetting;
785
	int retval;
786

787 788
	if (intf->sysfs_files_created)
		return 0;
A
Alan Stern 已提交
789
	retval = sysfs_create_group(&dev->kobj, &intf_attr_grp);
790
	if (retval)
A
Alan Stern 已提交
791
		return retval;
L
Linus Torvalds 已提交
792

793 794 795
	if (alt->string == NULL)
		alt->string = usb_cache_string(udev, alt->desc.iInterface);
	if (alt->string)
A
Alan Stern 已提交
796
		retval = device_create_file(dev, &dev_attr_interface);
797 798
	if (intf->intf_assoc)
		retval = sysfs_create_group(&dev->kobj, &intf_assoc_attr_grp);
799
	usb_create_intf_ep_files(intf, udev);
800
	intf->sysfs_files_created = 1;
801
	return 0;
L
Linus Torvalds 已提交
802 803
}

804
void usb_remove_sysfs_intf_files(struct usb_interface *intf)
L
Linus Torvalds 已提交
805
{
A
Alan Stern 已提交
806
	struct device *dev = &intf->dev;
L
Linus Torvalds 已提交
807

808 809
	if (!intf->sysfs_files_created)
		return;
A
Alan Stern 已提交
810 811 812
	usb_remove_intf_ep_files(intf);
	device_remove_file(dev, &dev_attr_interface);
	sysfs_remove_group(&dev->kobj, &intf_attr_grp);
813
	sysfs_remove_group(&intf->dev.kobj, &intf_assoc_attr_grp);
814
	intf->sysfs_files_created = 0;
L
Linus Torvalds 已提交
815
}