core.c revision c97415a72521071c235e0879f9a600014afd87b1
11da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds/*
21da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds * drivers/base/core.c - core driver model code (device registration, etc)
31da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds *
41da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds * Copyright (c) 2002-3 Patrick Mochel
51da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds * Copyright (c) 2002-3 Open Source Development Labs
664bb5d2c116478dba7501d2acf078ed74ba30c1fGreg Kroah-Hartman * Copyright (c) 2006 Greg Kroah-Hartman <gregkh@suse.de>
764bb5d2c116478dba7501d2acf078ed74ba30c1fGreg Kroah-Hartman * Copyright (c) 2006 Novell, Inc.
81da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds *
91da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds * This file is released under the GPLv2
101da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds *
111da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds */
121da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds
131da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds#include <linux/device.h>
141da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds#include <linux/err.h>
151da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds#include <linux/init.h>
161da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds#include <linux/module.h>
171da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds#include <linux/slab.h>
181da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds#include <linux/string.h>
1923681e479129854305da1da32f7f1eaf635ef22cGreg Kroah-Hartman#include <linux/kdev_t.h>
20116af378201ef793424cd10508ccf18b06d8a021Benjamin Herrenschmidt#include <linux/notifier.h>
21da231fd5d113ab6da5dab7a2d2c38d0a540f939cKay Sievers#include <linux/genhd.h>
22815d2d50da41f28aae58f5e9b3c61c3094422749Andrew Morton#include <linux/kallsyms.h>
23f75b1c60fc1e53c4004a79ea0be071aa3318cdccDave Young#include <linux/mutex.h>
24401097ea4b89846d66ac78f7f108d49c2e922d9cShaohua Li#include <linux/async.h>
251da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds
261da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds#include "base.h"
271da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds#include "power/power.h"
281da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds
29e52eec13cd6b7f30ab19081b387813e03e592ae5Andi Kleen#ifdef CONFIG_SYSFS_DEPRECATED
30e52eec13cd6b7f30ab19081b387813e03e592ae5Andi Kleen#ifdef CONFIG_SYSFS_DEPRECATED_V2
31e52eec13cd6b7f30ab19081b387813e03e592ae5Andi Kleenlong sysfs_deprecated = 1;
32e52eec13cd6b7f30ab19081b387813e03e592ae5Andi Kleen#else
33e52eec13cd6b7f30ab19081b387813e03e592ae5Andi Kleenlong sysfs_deprecated = 0;
34e52eec13cd6b7f30ab19081b387813e03e592ae5Andi Kleen#endif
35e52eec13cd6b7f30ab19081b387813e03e592ae5Andi Kleenstatic __init int sysfs_deprecated_setup(char *arg)
36e52eec13cd6b7f30ab19081b387813e03e592ae5Andi Kleen{
37e52eec13cd6b7f30ab19081b387813e03e592ae5Andi Kleen	return strict_strtol(arg, 10, &sysfs_deprecated);
38e52eec13cd6b7f30ab19081b387813e03e592ae5Andi Kleen}
39e52eec13cd6b7f30ab19081b387813e03e592ae5Andi Kleenearly_param("sysfs.deprecated", sysfs_deprecated_setup);
40e52eec13cd6b7f30ab19081b387813e03e592ae5Andi Kleen#endif
41e52eec13cd6b7f30ab19081b387813e03e592ae5Andi Kleen
424a3ad20ccd8f4d2a0535cf98fa83f7b561ba59a9Greg Kroah-Hartmanint (*platform_notify)(struct device *dev) = NULL;
434a3ad20ccd8f4d2a0535cf98fa83f7b561ba59a9Greg Kroah-Hartmanint (*platform_notify_remove)(struct device *dev) = NULL;
44e105b8bfc769b0545b6f0f395179d1e43cbee822Dan Williamsstatic struct kobject *dev_kobj;
45e105b8bfc769b0545b6f0f395179d1e43cbee822Dan Williamsstruct kobject *sysfs_dev_char_kobj;
46e105b8bfc769b0545b6f0f395179d1e43cbee822Dan Williamsstruct kobject *sysfs_dev_block_kobj;
471da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds
484e886c29610f4374d8971ec7a248f011cc3bd73aGreg Kroah-Hartman#ifdef CONFIG_BLOCK
494e886c29610f4374d8971ec7a248f011cc3bd73aGreg Kroah-Hartmanstatic inline int device_is_not_partition(struct device *dev)
504e886c29610f4374d8971ec7a248f011cc3bd73aGreg Kroah-Hartman{
514e886c29610f4374d8971ec7a248f011cc3bd73aGreg Kroah-Hartman	return !(dev->type == &part_type);
524e886c29610f4374d8971ec7a248f011cc3bd73aGreg Kroah-Hartman}
534e886c29610f4374d8971ec7a248f011cc3bd73aGreg Kroah-Hartman#else
544e886c29610f4374d8971ec7a248f011cc3bd73aGreg Kroah-Hartmanstatic inline int device_is_not_partition(struct device *dev)
554e886c29610f4374d8971ec7a248f011cc3bd73aGreg Kroah-Hartman{
564e886c29610f4374d8971ec7a248f011cc3bd73aGreg Kroah-Hartman	return 1;
574e886c29610f4374d8971ec7a248f011cc3bd73aGreg Kroah-Hartman}
584e886c29610f4374d8971ec7a248f011cc3bd73aGreg Kroah-Hartman#endif
591da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds
603e95637a48820ff8bedb33e6439def96ccff1de5Alan Stern/**
613e95637a48820ff8bedb33e6439def96ccff1de5Alan Stern * dev_driver_string - Return a device's driver name, if at all possible
623e95637a48820ff8bedb33e6439def96ccff1de5Alan Stern * @dev: struct device to get the name of
633e95637a48820ff8bedb33e6439def96ccff1de5Alan Stern *
643e95637a48820ff8bedb33e6439def96ccff1de5Alan Stern * Will return the device's driver's name if it is bound to a device.  If
653e95637a48820ff8bedb33e6439def96ccff1de5Alan Stern * the device is not bound to a device, it will return the name of the bus
663e95637a48820ff8bedb33e6439def96ccff1de5Alan Stern * it is attached to.  If it is not attached to a bus either, an empty
673e95637a48820ff8bedb33e6439def96ccff1de5Alan Stern * string will be returned.
683e95637a48820ff8bedb33e6439def96ccff1de5Alan Stern */
69bf9ca69fc8d19d4034391d3df4c35dccdef9d28cJean Delvareconst char *dev_driver_string(const struct device *dev)
703e95637a48820ff8bedb33e6439def96ccff1de5Alan Stern{
713589972e51fac1e02d0aaa576fa47f568cb94d40Alan Stern	struct device_driver *drv;
723589972e51fac1e02d0aaa576fa47f568cb94d40Alan Stern
733589972e51fac1e02d0aaa576fa47f568cb94d40Alan Stern	/* dev->driver can change to NULL underneath us because of unbinding,
743589972e51fac1e02d0aaa576fa47f568cb94d40Alan Stern	 * so be careful about accessing it.  dev->bus and dev->class should
753589972e51fac1e02d0aaa576fa47f568cb94d40Alan Stern	 * never change once they are set, so they don't need special care.
763589972e51fac1e02d0aaa576fa47f568cb94d40Alan Stern	 */
773589972e51fac1e02d0aaa576fa47f568cb94d40Alan Stern	drv = ACCESS_ONCE(dev->driver);
783589972e51fac1e02d0aaa576fa47f568cb94d40Alan Stern	return drv ? drv->name :
79a456b7023e0abf80bb03b0bdf5471b48878e5c49Jean Delvare			(dev->bus ? dev->bus->name :
80a456b7023e0abf80bb03b0bdf5471b48878e5c49Jean Delvare			(dev->class ? dev->class->name : ""));
813e95637a48820ff8bedb33e6439def96ccff1de5Alan Stern}
82310a922d4307ed38b37982a6f93b11fdf3b8dcb1Matthew WilcoxEXPORT_SYMBOL(dev_driver_string);
833e95637a48820ff8bedb33e6439def96ccff1de5Alan Stern
841da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds#define to_dev(obj) container_of(obj, struct device, kobj)
851da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds#define to_dev_attr(_attr) container_of(_attr, struct device_attribute, attr)
861da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds
874a3ad20ccd8f4d2a0535cf98fa83f7b561ba59a9Greg Kroah-Hartmanstatic ssize_t dev_attr_show(struct kobject *kobj, struct attribute *attr,
884a3ad20ccd8f4d2a0535cf98fa83f7b561ba59a9Greg Kroah-Hartman			     char *buf)
891da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds{
904a3ad20ccd8f4d2a0535cf98fa83f7b561ba59a9Greg Kroah-Hartman	struct device_attribute *dev_attr = to_dev_attr(attr);
914a3ad20ccd8f4d2a0535cf98fa83f7b561ba59a9Greg Kroah-Hartman	struct device *dev = to_dev(kobj);
924a0c20bf8c0fe2116f8fd7d3da6122bf8a01f026Dmitry Torokhov	ssize_t ret = -EIO;
931da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds
941da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds	if (dev_attr->show)
9554b6f35c99974e99e64c05c2895718355123c55fYani Ioannou		ret = dev_attr->show(dev, dev_attr, buf);
96815d2d50da41f28aae58f5e9b3c61c3094422749Andrew Morton	if (ret >= (ssize_t)PAGE_SIZE) {
97815d2d50da41f28aae58f5e9b3c61c3094422749Andrew Morton		print_symbol("dev_attr_show: %s returned bad count\n",
98815d2d50da41f28aae58f5e9b3c61c3094422749Andrew Morton				(unsigned long)dev_attr->show);
99815d2d50da41f28aae58f5e9b3c61c3094422749Andrew Morton	}
1001da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds	return ret;
1011da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds}
1021da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds
1034a3ad20ccd8f4d2a0535cf98fa83f7b561ba59a9Greg Kroah-Hartmanstatic ssize_t dev_attr_store(struct kobject *kobj, struct attribute *attr,
1044a3ad20ccd8f4d2a0535cf98fa83f7b561ba59a9Greg Kroah-Hartman			      const char *buf, size_t count)
1051da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds{
1064a3ad20ccd8f4d2a0535cf98fa83f7b561ba59a9Greg Kroah-Hartman	struct device_attribute *dev_attr = to_dev_attr(attr);
1074a3ad20ccd8f4d2a0535cf98fa83f7b561ba59a9Greg Kroah-Hartman	struct device *dev = to_dev(kobj);
1084a0c20bf8c0fe2116f8fd7d3da6122bf8a01f026Dmitry Torokhov	ssize_t ret = -EIO;
1091da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds
1101da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds	if (dev_attr->store)
11154b6f35c99974e99e64c05c2895718355123c55fYani Ioannou		ret = dev_attr->store(dev, dev_attr, buf, count);
1121da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds	return ret;
1131da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds}
1141da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds
11552cf25d0ab7f78eeecc59ac652ed5090f69b619eEmese Revfystatic const struct sysfs_ops dev_sysfs_ops = {
1161da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds	.show	= dev_attr_show,
1171da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds	.store	= dev_attr_store,
1181da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds};
1191da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds
1201da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds
1211da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds/**
1221da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds *	device_release - free device structure.
1231da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds *	@kobj:	device's kobject.
1241da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds *
1251da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds *	This is called once the reference count for the object
1261da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds *	reaches 0. We forward the call to the device's release
1271da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds *	method, which should handle actually freeing the structure.
1281da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds */
1294a3ad20ccd8f4d2a0535cf98fa83f7b561ba59a9Greg Kroah-Hartmanstatic void device_release(struct kobject *kobj)
1301da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds{
1314a3ad20ccd8f4d2a0535cf98fa83f7b561ba59a9Greg Kroah-Hartman	struct device *dev = to_dev(kobj);
132fb069a5d132fb926ed17af3211a114ac7cf27d7aGreg Kroah-Hartman	struct device_private *p = dev->p;
1331da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds
1341da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds	if (dev->release)
1351da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds		dev->release(dev);
136f9f852df2faf76a2667949ddb4947d4b8f99f02fKay Sievers	else if (dev->type && dev->type->release)
137f9f852df2faf76a2667949ddb4947d4b8f99f02fKay Sievers		dev->type->release(dev);
1382620efef7029bb040430f50f0fc148f2d5e002adGreg Kroah-Hartman	else if (dev->class && dev->class->dev_release)
1392620efef7029bb040430f50f0fc148f2d5e002adGreg Kroah-Hartman		dev->class->dev_release(dev);
140f810a5cf28a818db96333cd23646f0227ec015b4Arjan van de Ven	else
141f810a5cf28a818db96333cd23646f0227ec015b4Arjan van de Ven		WARN(1, KERN_ERR "Device '%s' does not have a release() "
1424a3ad20ccd8f4d2a0535cf98fa83f7b561ba59a9Greg Kroah-Hartman			"function, it is broken and must be fixed.\n",
1431e0b2cf933ebf32494eba3f668859ba57f06a951Kay Sievers			dev_name(dev));
144fb069a5d132fb926ed17af3211a114ac7cf27d7aGreg Kroah-Hartman	kfree(p);
1451da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds}
1461da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds
147bc451f2058238013e1cdf4acd443c01734d332f0Eric W. Biedermanstatic const void *device_namespace(struct kobject *kobj)
148bc451f2058238013e1cdf4acd443c01734d332f0Eric W. Biederman{
149bc451f2058238013e1cdf4acd443c01734d332f0Eric W. Biederman	struct device *dev = to_dev(kobj);
150bc451f2058238013e1cdf4acd443c01734d332f0Eric W. Biederman	const void *ns = NULL;
151bc451f2058238013e1cdf4acd443c01734d332f0Eric W. Biederman
152bc451f2058238013e1cdf4acd443c01734d332f0Eric W. Biederman	if (dev->class && dev->class->ns_type)
153bc451f2058238013e1cdf4acd443c01734d332f0Eric W. Biederman		ns = dev->class->namespace(dev);
154bc451f2058238013e1cdf4acd443c01734d332f0Eric W. Biederman
155bc451f2058238013e1cdf4acd443c01734d332f0Eric W. Biederman	return ns;
156bc451f2058238013e1cdf4acd443c01734d332f0Eric W. Biederman}
157bc451f2058238013e1cdf4acd443c01734d332f0Eric W. Biederman
1588f4afc410b8d2be49f34835b6bbe788f50471b02Greg Kroah-Hartmanstatic struct kobj_type device_ktype = {
1591da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds	.release	= device_release,
1601da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds	.sysfs_ops	= &dev_sysfs_ops,
161bc451f2058238013e1cdf4acd443c01734d332f0Eric W. Biederman	.namespace	= device_namespace,
1621da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds};
1631da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds
1641da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds
165312c004d36ce6c739512bac83b452f4c20ab1f62Kay Sieversstatic int dev_uevent_filter(struct kset *kset, struct kobject *kobj)
1661da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds{
1671da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds	struct kobj_type *ktype = get_ktype(kobj);
1681da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds
1698f4afc410b8d2be49f34835b6bbe788f50471b02Greg Kroah-Hartman	if (ktype == &device_ktype) {
1701da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds		struct device *dev = to_dev(kobj);
1711da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds		if (dev->bus)
1721da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds			return 1;
17323681e479129854305da1da32f7f1eaf635ef22cGreg Kroah-Hartman		if (dev->class)
17423681e479129854305da1da32f7f1eaf635ef22cGreg Kroah-Hartman			return 1;
1751da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds	}
1761da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds	return 0;
1771da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds}
1781da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds
179312c004d36ce6c739512bac83b452f4c20ab1f62Kay Sieversstatic const char *dev_uevent_name(struct kset *kset, struct kobject *kobj)
1801da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds{
1811da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds	struct device *dev = to_dev(kobj);
1821da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds
18323681e479129854305da1da32f7f1eaf635ef22cGreg Kroah-Hartman	if (dev->bus)
18423681e479129854305da1da32f7f1eaf635ef22cGreg Kroah-Hartman		return dev->bus->name;
18523681e479129854305da1da32f7f1eaf635ef22cGreg Kroah-Hartman	if (dev->class)
18623681e479129854305da1da32f7f1eaf635ef22cGreg Kroah-Hartman		return dev->class->name;
18723681e479129854305da1da32f7f1eaf635ef22cGreg Kroah-Hartman	return NULL;
1881da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds}
1891da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds
1907eff2e7a8b65c25920207324e56611150eb1cd9aKay Sieversstatic int dev_uevent(struct kset *kset, struct kobject *kobj,
1917eff2e7a8b65c25920207324e56611150eb1cd9aKay Sievers		      struct kobj_uevent_env *env)
1921da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds{
1931da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds	struct device *dev = to_dev(kobj);
1941da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds	int retval = 0;
1951da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds
1966fcf53acccf85b4b0d0260e66c692a341760f464Kay Sievers	/* add device node properties if present */
19723681e479129854305da1da32f7f1eaf635ef22cGreg Kroah-Hartman	if (MAJOR(dev->devt)) {
1986fcf53acccf85b4b0d0260e66c692a341760f464Kay Sievers		const char *tmp;
1996fcf53acccf85b4b0d0260e66c692a341760f464Kay Sievers		const char *name;
200e454cea20bdcff10ee698d11b8882662a0153a47Kay Sievers		mode_t mode = 0;
2016fcf53acccf85b4b0d0260e66c692a341760f464Kay Sievers
2027eff2e7a8b65c25920207324e56611150eb1cd9aKay Sievers		add_uevent_var(env, "MAJOR=%u", MAJOR(dev->devt));
2037eff2e7a8b65c25920207324e56611150eb1cd9aKay Sievers		add_uevent_var(env, "MINOR=%u", MINOR(dev->devt));
204e454cea20bdcff10ee698d11b8882662a0153a47Kay Sievers		name = device_get_devnode(dev, &mode, &tmp);
2056fcf53acccf85b4b0d0260e66c692a341760f464Kay Sievers		if (name) {
2066fcf53acccf85b4b0d0260e66c692a341760f464Kay Sievers			add_uevent_var(env, "DEVNAME=%s", name);
2076fcf53acccf85b4b0d0260e66c692a341760f464Kay Sievers			kfree(tmp);
208e454cea20bdcff10ee698d11b8882662a0153a47Kay Sievers			if (mode)
209e454cea20bdcff10ee698d11b8882662a0153a47Kay Sievers				add_uevent_var(env, "DEVMODE=%#o", mode & 0777);
2106fcf53acccf85b4b0d0260e66c692a341760f464Kay Sievers		}
21123681e479129854305da1da32f7f1eaf635ef22cGreg Kroah-Hartman	}
21223681e479129854305da1da32f7f1eaf635ef22cGreg Kroah-Hartman
213414264f959cf46f49f974b3510400e12ac3624a6Kay Sievers	if (dev->type && dev->type->name)
2147eff2e7a8b65c25920207324e56611150eb1cd9aKay Sievers		add_uevent_var(env, "DEVTYPE=%s", dev->type->name);
215414264f959cf46f49f974b3510400e12ac3624a6Kay Sievers
216239378f16aa1ab5c502e42a06359d2de4f88ebb4Kay Sievers	if (dev->driver)
2177eff2e7a8b65c25920207324e56611150eb1cd9aKay Sievers		add_uevent_var(env, "DRIVER=%s", dev->driver->name);
218239378f16aa1ab5c502e42a06359d2de4f88ebb4Kay Sievers
2197eff2e7a8b65c25920207324e56611150eb1cd9aKay Sievers	/* have the bus specific function add its stuff */
220312c004d36ce6c739512bac83b452f4c20ab1f62Kay Sievers	if (dev->bus && dev->bus->uevent) {
2217eff2e7a8b65c25920207324e56611150eb1cd9aKay Sievers		retval = dev->bus->uevent(dev, env);
222f9f852df2faf76a2667949ddb4947d4b8f99f02fKay Sievers		if (retval)
2237dc72b2842381684b864750af31a5fb168dec764Greg Kroah-Hartman			pr_debug("device: '%s': %s: bus uevent() returned %d\n",
2241e0b2cf933ebf32494eba3f668859ba57f06a951Kay Sievers				 dev_name(dev), __func__, retval);
2251da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds	}
2261da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds
2277eff2e7a8b65c25920207324e56611150eb1cd9aKay Sievers	/* have the class specific function add its stuff */
2282620efef7029bb040430f50f0fc148f2d5e002adGreg Kroah-Hartman	if (dev->class && dev->class->dev_uevent) {
2297eff2e7a8b65c25920207324e56611150eb1cd9aKay Sievers		retval = dev->class->dev_uevent(dev, env);
230f9f852df2faf76a2667949ddb4947d4b8f99f02fKay Sievers		if (retval)
2317dc72b2842381684b864750af31a5fb168dec764Greg Kroah-Hartman			pr_debug("device: '%s': %s: class uevent() "
2321e0b2cf933ebf32494eba3f668859ba57f06a951Kay Sievers				 "returned %d\n", dev_name(dev),
2332b3a302a09735276e13421db56c20045a48eb06dHarvey Harrison				 __func__, retval);
234f9f852df2faf76a2667949ddb4947d4b8f99f02fKay Sievers	}
235f9f852df2faf76a2667949ddb4947d4b8f99f02fKay Sievers
236eef35c2d41ddcc653c20d26b977acaa45c811e1fStefan Weil	/* have the device type specific function add its stuff */
237f9f852df2faf76a2667949ddb4947d4b8f99f02fKay Sievers	if (dev->type && dev->type->uevent) {
2387eff2e7a8b65c25920207324e56611150eb1cd9aKay Sievers		retval = dev->type->uevent(dev, env);
239f9f852df2faf76a2667949ddb4947d4b8f99f02fKay Sievers		if (retval)
2407dc72b2842381684b864750af31a5fb168dec764Greg Kroah-Hartman			pr_debug("device: '%s': %s: dev_type uevent() "
2411e0b2cf933ebf32494eba3f668859ba57f06a951Kay Sievers				 "returned %d\n", dev_name(dev),
2422b3a302a09735276e13421db56c20045a48eb06dHarvey Harrison				 __func__, retval);
2432620efef7029bb040430f50f0fc148f2d5e002adGreg Kroah-Hartman	}
2442620efef7029bb040430f50f0fc148f2d5e002adGreg Kroah-Hartman
2451da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds	return retval;
2461da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds}
2471da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds
2489cd43611ccfb46632bfa7d19f688924ea93f1613Emese Revfystatic const struct kset_uevent_ops device_uevent_ops = {
249312c004d36ce6c739512bac83b452f4c20ab1f62Kay Sievers	.filter =	dev_uevent_filter,
250312c004d36ce6c739512bac83b452f4c20ab1f62Kay Sievers	.name =		dev_uevent_name,
251312c004d36ce6c739512bac83b452f4c20ab1f62Kay Sievers	.uevent =	dev_uevent,
2521da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds};
2531da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds
25416574dccd8f62dc1b585325f8a6a0aab10047ed8Kay Sieversstatic ssize_t show_uevent(struct device *dev, struct device_attribute *attr,
25516574dccd8f62dc1b585325f8a6a0aab10047ed8Kay Sievers			   char *buf)
25616574dccd8f62dc1b585325f8a6a0aab10047ed8Kay Sievers{
25716574dccd8f62dc1b585325f8a6a0aab10047ed8Kay Sievers	struct kobject *top_kobj;
25816574dccd8f62dc1b585325f8a6a0aab10047ed8Kay Sievers	struct kset *kset;
2597eff2e7a8b65c25920207324e56611150eb1cd9aKay Sievers	struct kobj_uevent_env *env = NULL;
26016574dccd8f62dc1b585325f8a6a0aab10047ed8Kay Sievers	int i;
26116574dccd8f62dc1b585325f8a6a0aab10047ed8Kay Sievers	size_t count = 0;
26216574dccd8f62dc1b585325f8a6a0aab10047ed8Kay Sievers	int retval;
26316574dccd8f62dc1b585325f8a6a0aab10047ed8Kay Sievers
26416574dccd8f62dc1b585325f8a6a0aab10047ed8Kay Sievers	/* search the kset, the device belongs to */
26516574dccd8f62dc1b585325f8a6a0aab10047ed8Kay Sievers	top_kobj = &dev->kobj;
2665c5daf657cb5f963a38413f2852279d7a3843144Kay Sievers	while (!top_kobj->kset && top_kobj->parent)
2675c5daf657cb5f963a38413f2852279d7a3843144Kay Sievers		top_kobj = top_kobj->parent;
26816574dccd8f62dc1b585325f8a6a0aab10047ed8Kay Sievers	if (!top_kobj->kset)
26916574dccd8f62dc1b585325f8a6a0aab10047ed8Kay Sievers		goto out;
2705c5daf657cb5f963a38413f2852279d7a3843144Kay Sievers
27116574dccd8f62dc1b585325f8a6a0aab10047ed8Kay Sievers	kset = top_kobj->kset;
27216574dccd8f62dc1b585325f8a6a0aab10047ed8Kay Sievers	if (!kset->uevent_ops || !kset->uevent_ops->uevent)
27316574dccd8f62dc1b585325f8a6a0aab10047ed8Kay Sievers		goto out;
27416574dccd8f62dc1b585325f8a6a0aab10047ed8Kay Sievers
27516574dccd8f62dc1b585325f8a6a0aab10047ed8Kay Sievers	/* respect filter */
27616574dccd8f62dc1b585325f8a6a0aab10047ed8Kay Sievers	if (kset->uevent_ops && kset->uevent_ops->filter)
27716574dccd8f62dc1b585325f8a6a0aab10047ed8Kay Sievers		if (!kset->uevent_ops->filter(kset, &dev->kobj))
27816574dccd8f62dc1b585325f8a6a0aab10047ed8Kay Sievers			goto out;
27916574dccd8f62dc1b585325f8a6a0aab10047ed8Kay Sievers
2807eff2e7a8b65c25920207324e56611150eb1cd9aKay Sievers	env = kzalloc(sizeof(struct kobj_uevent_env), GFP_KERNEL);
2817eff2e7a8b65c25920207324e56611150eb1cd9aKay Sievers	if (!env)
282c7308c81a8220ab68eebfadde37db881a2800064Greg Kroah-Hartman		return -ENOMEM;
283c7308c81a8220ab68eebfadde37db881a2800064Greg Kroah-Hartman
28416574dccd8f62dc1b585325f8a6a0aab10047ed8Kay Sievers	/* let the kset specific function add its keys */
2857eff2e7a8b65c25920207324e56611150eb1cd9aKay Sievers	retval = kset->uevent_ops->uevent(kset, &dev->kobj, env);
28616574dccd8f62dc1b585325f8a6a0aab10047ed8Kay Sievers	if (retval)
28716574dccd8f62dc1b585325f8a6a0aab10047ed8Kay Sievers		goto out;
28816574dccd8f62dc1b585325f8a6a0aab10047ed8Kay Sievers
28916574dccd8f62dc1b585325f8a6a0aab10047ed8Kay Sievers	/* copy keys to file */
2907eff2e7a8b65c25920207324e56611150eb1cd9aKay Sievers	for (i = 0; i < env->envp_idx; i++)
2917eff2e7a8b65c25920207324e56611150eb1cd9aKay Sievers		count += sprintf(&buf[count], "%s\n", env->envp[i]);
29216574dccd8f62dc1b585325f8a6a0aab10047ed8Kay Sieversout:
2937eff2e7a8b65c25920207324e56611150eb1cd9aKay Sievers	kfree(env);
29416574dccd8f62dc1b585325f8a6a0aab10047ed8Kay Sievers	return count;
29516574dccd8f62dc1b585325f8a6a0aab10047ed8Kay Sievers}
29616574dccd8f62dc1b585325f8a6a0aab10047ed8Kay Sievers
297a7fd67062efc5b0fc9a61368c607fa92d1d57f9eKay Sieversstatic ssize_t store_uevent(struct device *dev, struct device_attribute *attr,
298a7fd67062efc5b0fc9a61368c607fa92d1d57f9eKay Sievers			    const char *buf, size_t count)
299a7fd67062efc5b0fc9a61368c607fa92d1d57f9eKay Sievers{
30060a96a59569bab85571d0089682109bd3324e896Kay Sievers	enum kobject_action action;
30160a96a59569bab85571d0089682109bd3324e896Kay Sievers
3023f5468c9ae293cbca43e4ffe6ca3b3235189042aKay Sievers	if (kobject_action_type(buf, count, &action) == 0)
30360a96a59569bab85571d0089682109bd3324e896Kay Sievers		kobject_uevent(&dev->kobj, action);
3043f5468c9ae293cbca43e4ffe6ca3b3235189042aKay Sievers	else
3053f5468c9ae293cbca43e4ffe6ca3b3235189042aKay Sievers		dev_err(dev, "uevent: unknown action-string\n");
306a7fd67062efc5b0fc9a61368c607fa92d1d57f9eKay Sievers	return count;
307a7fd67062efc5b0fc9a61368c607fa92d1d57f9eKay Sievers}
308a7fd67062efc5b0fc9a61368c607fa92d1d57f9eKay Sievers
309ad6a1e1c66009ba9dcd2f5c90ffa1fb4ce72fce0Tejun Heostatic struct device_attribute uevent_attr =
310ad6a1e1c66009ba9dcd2f5c90ffa1fb4ce72fce0Tejun Heo	__ATTR(uevent, S_IRUGO | S_IWUSR, show_uevent, store_uevent);
311ad6a1e1c66009ba9dcd2f5c90ffa1fb4ce72fce0Tejun Heo
312621a1672f7377e08a942f205d6742d8af1292aabDmitry Torokhovstatic int device_add_attributes(struct device *dev,
313621a1672f7377e08a942f205d6742d8af1292aabDmitry Torokhov				 struct device_attribute *attrs)
314de0ff00d723fd821d372496e2c084805644aa5e1Greg Kroah-Hartman{
315621a1672f7377e08a942f205d6742d8af1292aabDmitry Torokhov	int error = 0;
316de0ff00d723fd821d372496e2c084805644aa5e1Greg Kroah-Hartman	int i;
317621a1672f7377e08a942f205d6742d8af1292aabDmitry Torokhov
318621a1672f7377e08a942f205d6742d8af1292aabDmitry Torokhov	if (attrs) {
319621a1672f7377e08a942f205d6742d8af1292aabDmitry Torokhov		for (i = 0; attr_name(attrs[i]); i++) {
320621a1672f7377e08a942f205d6742d8af1292aabDmitry Torokhov			error = device_create_file(dev, &attrs[i]);
321621a1672f7377e08a942f205d6742d8af1292aabDmitry Torokhov			if (error)
322621a1672f7377e08a942f205d6742d8af1292aabDmitry Torokhov				break;
323621a1672f7377e08a942f205d6742d8af1292aabDmitry Torokhov		}
324621a1672f7377e08a942f205d6742d8af1292aabDmitry Torokhov		if (error)
325621a1672f7377e08a942f205d6742d8af1292aabDmitry Torokhov			while (--i >= 0)
326621a1672f7377e08a942f205d6742d8af1292aabDmitry Torokhov				device_remove_file(dev, &attrs[i]);
327621a1672f7377e08a942f205d6742d8af1292aabDmitry Torokhov	}
328621a1672f7377e08a942f205d6742d8af1292aabDmitry Torokhov	return error;
329621a1672f7377e08a942f205d6742d8af1292aabDmitry Torokhov}
330621a1672f7377e08a942f205d6742d8af1292aabDmitry Torokhov
331621a1672f7377e08a942f205d6742d8af1292aabDmitry Torokhovstatic void device_remove_attributes(struct device *dev,
332621a1672f7377e08a942f205d6742d8af1292aabDmitry Torokhov				     struct device_attribute *attrs)
333621a1672f7377e08a942f205d6742d8af1292aabDmitry Torokhov{
334621a1672f7377e08a942f205d6742d8af1292aabDmitry Torokhov	int i;
335621a1672f7377e08a942f205d6742d8af1292aabDmitry Torokhov
336621a1672f7377e08a942f205d6742d8af1292aabDmitry Torokhov	if (attrs)
337621a1672f7377e08a942f205d6742d8af1292aabDmitry Torokhov		for (i = 0; attr_name(attrs[i]); i++)
338621a1672f7377e08a942f205d6742d8af1292aabDmitry Torokhov			device_remove_file(dev, &attrs[i]);
339621a1672f7377e08a942f205d6742d8af1292aabDmitry Torokhov}
340621a1672f7377e08a942f205d6742d8af1292aabDmitry Torokhov
341c97415a72521071c235e0879f9a600014afd87b1Stefan Achatzstatic int device_add_bin_attributes(struct device *dev,
342c97415a72521071c235e0879f9a600014afd87b1Stefan Achatz				     struct bin_attribute *attrs)
343c97415a72521071c235e0879f9a600014afd87b1Stefan Achatz{
344c97415a72521071c235e0879f9a600014afd87b1Stefan Achatz	int error = 0;
345c97415a72521071c235e0879f9a600014afd87b1Stefan Achatz	int i;
346c97415a72521071c235e0879f9a600014afd87b1Stefan Achatz
347c97415a72521071c235e0879f9a600014afd87b1Stefan Achatz	if (attrs) {
348c97415a72521071c235e0879f9a600014afd87b1Stefan Achatz		for (i = 0; attr_name(attrs[i]); i++) {
349c97415a72521071c235e0879f9a600014afd87b1Stefan Achatz			error = device_create_bin_file(dev, &attrs[i]);
350c97415a72521071c235e0879f9a600014afd87b1Stefan Achatz			if (error)
351c97415a72521071c235e0879f9a600014afd87b1Stefan Achatz				break;
352c97415a72521071c235e0879f9a600014afd87b1Stefan Achatz		}
353c97415a72521071c235e0879f9a600014afd87b1Stefan Achatz		if (error)
354c97415a72521071c235e0879f9a600014afd87b1Stefan Achatz			while (--i >= 0)
355c97415a72521071c235e0879f9a600014afd87b1Stefan Achatz				device_remove_bin_file(dev, &attrs[i]);
356c97415a72521071c235e0879f9a600014afd87b1Stefan Achatz	}
357c97415a72521071c235e0879f9a600014afd87b1Stefan Achatz	return error;
358c97415a72521071c235e0879f9a600014afd87b1Stefan Achatz}
359c97415a72521071c235e0879f9a600014afd87b1Stefan Achatz
360c97415a72521071c235e0879f9a600014afd87b1Stefan Achatzstatic void device_remove_bin_attributes(struct device *dev,
361c97415a72521071c235e0879f9a600014afd87b1Stefan Achatz					 struct bin_attribute *attrs)
362c97415a72521071c235e0879f9a600014afd87b1Stefan Achatz{
363c97415a72521071c235e0879f9a600014afd87b1Stefan Achatz	int i;
364c97415a72521071c235e0879f9a600014afd87b1Stefan Achatz
365c97415a72521071c235e0879f9a600014afd87b1Stefan Achatz	if (attrs)
366c97415a72521071c235e0879f9a600014afd87b1Stefan Achatz		for (i = 0; attr_name(attrs[i]); i++)
367c97415a72521071c235e0879f9a600014afd87b1Stefan Achatz			device_remove_bin_file(dev, &attrs[i]);
368c97415a72521071c235e0879f9a600014afd87b1Stefan Achatz}
369c97415a72521071c235e0879f9a600014afd87b1Stefan Achatz
370621a1672f7377e08a942f205d6742d8af1292aabDmitry Torokhovstatic int device_add_groups(struct device *dev,
371a4dbd6740df0872cdf0a86841f75beec8381964dDavid Brownell			     const struct attribute_group **groups)
372621a1672f7377e08a942f205d6742d8af1292aabDmitry Torokhov{
373de0ff00d723fd821d372496e2c084805644aa5e1Greg Kroah-Hartman	int error = 0;
374621a1672f7377e08a942f205d6742d8af1292aabDmitry Torokhov	int i;
375de0ff00d723fd821d372496e2c084805644aa5e1Greg Kroah-Hartman
376621a1672f7377e08a942f205d6742d8af1292aabDmitry Torokhov	if (groups) {
377621a1672f7377e08a942f205d6742d8af1292aabDmitry Torokhov		for (i = 0; groups[i]; i++) {
378621a1672f7377e08a942f205d6742d8af1292aabDmitry Torokhov			error = sysfs_create_group(&dev->kobj, groups[i]);
379de0ff00d723fd821d372496e2c084805644aa5e1Greg Kroah-Hartman			if (error) {
380de0ff00d723fd821d372496e2c084805644aa5e1Greg Kroah-Hartman				while (--i >= 0)
3814a3ad20ccd8f4d2a0535cf98fa83f7b561ba59a9Greg Kroah-Hartman					sysfs_remove_group(&dev->kobj,
3824a3ad20ccd8f4d2a0535cf98fa83f7b561ba59a9Greg Kroah-Hartman							   groups[i]);
383621a1672f7377e08a942f205d6742d8af1292aabDmitry Torokhov				break;
384de0ff00d723fd821d372496e2c084805644aa5e1Greg Kroah-Hartman			}
385de0ff00d723fd821d372496e2c084805644aa5e1Greg Kroah-Hartman		}
386de0ff00d723fd821d372496e2c084805644aa5e1Greg Kroah-Hartman	}
387de0ff00d723fd821d372496e2c084805644aa5e1Greg Kroah-Hartman	return error;
388de0ff00d723fd821d372496e2c084805644aa5e1Greg Kroah-Hartman}
389de0ff00d723fd821d372496e2c084805644aa5e1Greg Kroah-Hartman
390621a1672f7377e08a942f205d6742d8af1292aabDmitry Torokhovstatic void device_remove_groups(struct device *dev,
391a4dbd6740df0872cdf0a86841f75beec8381964dDavid Brownell				 const struct attribute_group **groups)
392de0ff00d723fd821d372496e2c084805644aa5e1Greg Kroah-Hartman{
393de0ff00d723fd821d372496e2c084805644aa5e1Greg Kroah-Hartman	int i;
394621a1672f7377e08a942f205d6742d8af1292aabDmitry Torokhov
395621a1672f7377e08a942f205d6742d8af1292aabDmitry Torokhov	if (groups)
396621a1672f7377e08a942f205d6742d8af1292aabDmitry Torokhov		for (i = 0; groups[i]; i++)
397621a1672f7377e08a942f205d6742d8af1292aabDmitry Torokhov			sysfs_remove_group(&dev->kobj, groups[i]);
398de0ff00d723fd821d372496e2c084805644aa5e1Greg Kroah-Hartman}
399de0ff00d723fd821d372496e2c084805644aa5e1Greg Kroah-Hartman
4002620efef7029bb040430f50f0fc148f2d5e002adGreg Kroah-Hartmanstatic int device_add_attrs(struct device *dev)
4012620efef7029bb040430f50f0fc148f2d5e002adGreg Kroah-Hartman{
4022620efef7029bb040430f50f0fc148f2d5e002adGreg Kroah-Hartman	struct class *class = dev->class;
403f9f852df2faf76a2667949ddb4947d4b8f99f02fKay Sievers	struct device_type *type = dev->type;
404621a1672f7377e08a942f205d6742d8af1292aabDmitry Torokhov	int error;
4052620efef7029bb040430f50f0fc148f2d5e002adGreg Kroah-Hartman
406621a1672f7377e08a942f205d6742d8af1292aabDmitry Torokhov	if (class) {
407621a1672f7377e08a942f205d6742d8af1292aabDmitry Torokhov		error = device_add_attributes(dev, class->dev_attrs);
408f9f852df2faf76a2667949ddb4947d4b8f99f02fKay Sievers		if (error)
409621a1672f7377e08a942f205d6742d8af1292aabDmitry Torokhov			return error;
410c97415a72521071c235e0879f9a600014afd87b1Stefan Achatz		error = device_add_bin_attributes(dev, class->dev_bin_attrs);
411c97415a72521071c235e0879f9a600014afd87b1Stefan Achatz		if (error)
412c97415a72521071c235e0879f9a600014afd87b1Stefan Achatz			goto err_remove_class_attrs;
4132620efef7029bb040430f50f0fc148f2d5e002adGreg Kroah-Hartman	}
414f9f852df2faf76a2667949ddb4947d4b8f99f02fKay Sievers
415621a1672f7377e08a942f205d6742d8af1292aabDmitry Torokhov	if (type) {
416621a1672f7377e08a942f205d6742d8af1292aabDmitry Torokhov		error = device_add_groups(dev, type->groups);
417f9f852df2faf76a2667949ddb4947d4b8f99f02fKay Sievers		if (error)
418c97415a72521071c235e0879f9a600014afd87b1Stefan Achatz			goto err_remove_class_bin_attrs;
419f9f852df2faf76a2667949ddb4947d4b8f99f02fKay Sievers	}
420f9f852df2faf76a2667949ddb4947d4b8f99f02fKay Sievers
421621a1672f7377e08a942f205d6742d8af1292aabDmitry Torokhov	error = device_add_groups(dev, dev->groups);
422621a1672f7377e08a942f205d6742d8af1292aabDmitry Torokhov	if (error)
423621a1672f7377e08a942f205d6742d8af1292aabDmitry Torokhov		goto err_remove_type_groups;
424621a1672f7377e08a942f205d6742d8af1292aabDmitry Torokhov
425621a1672f7377e08a942f205d6742d8af1292aabDmitry Torokhov	return 0;
426621a1672f7377e08a942f205d6742d8af1292aabDmitry Torokhov
427621a1672f7377e08a942f205d6742d8af1292aabDmitry Torokhov err_remove_type_groups:
428621a1672f7377e08a942f205d6742d8af1292aabDmitry Torokhov	if (type)
429621a1672f7377e08a942f205d6742d8af1292aabDmitry Torokhov		device_remove_groups(dev, type->groups);
430c97415a72521071c235e0879f9a600014afd87b1Stefan Achatz err_remove_class_bin_attrs:
431c97415a72521071c235e0879f9a600014afd87b1Stefan Achatz	if (class)
432c97415a72521071c235e0879f9a600014afd87b1Stefan Achatz		device_remove_bin_attributes(dev, class->dev_bin_attrs);
433621a1672f7377e08a942f205d6742d8af1292aabDmitry Torokhov err_remove_class_attrs:
434621a1672f7377e08a942f205d6742d8af1292aabDmitry Torokhov	if (class)
435621a1672f7377e08a942f205d6742d8af1292aabDmitry Torokhov		device_remove_attributes(dev, class->dev_attrs);
436621a1672f7377e08a942f205d6742d8af1292aabDmitry Torokhov
4372620efef7029bb040430f50f0fc148f2d5e002adGreg Kroah-Hartman	return error;
4382620efef7029bb040430f50f0fc148f2d5e002adGreg Kroah-Hartman}
4392620efef7029bb040430f50f0fc148f2d5e002adGreg Kroah-Hartman
4402620efef7029bb040430f50f0fc148f2d5e002adGreg Kroah-Hartmanstatic void device_remove_attrs(struct device *dev)
4412620efef7029bb040430f50f0fc148f2d5e002adGreg Kroah-Hartman{
4422620efef7029bb040430f50f0fc148f2d5e002adGreg Kroah-Hartman	struct class *class = dev->class;
443f9f852df2faf76a2667949ddb4947d4b8f99f02fKay Sievers	struct device_type *type = dev->type;
4442620efef7029bb040430f50f0fc148f2d5e002adGreg Kroah-Hartman
445621a1672f7377e08a942f205d6742d8af1292aabDmitry Torokhov	device_remove_groups(dev, dev->groups);
446f9f852df2faf76a2667949ddb4947d4b8f99f02fKay Sievers
447621a1672f7377e08a942f205d6742d8af1292aabDmitry Torokhov	if (type)
448621a1672f7377e08a942f205d6742d8af1292aabDmitry Torokhov		device_remove_groups(dev, type->groups);
449621a1672f7377e08a942f205d6742d8af1292aabDmitry Torokhov
450c97415a72521071c235e0879f9a600014afd87b1Stefan Achatz	if (class) {
451621a1672f7377e08a942f205d6742d8af1292aabDmitry Torokhov		device_remove_attributes(dev, class->dev_attrs);
452c97415a72521071c235e0879f9a600014afd87b1Stefan Achatz		device_remove_bin_attributes(dev, class->dev_bin_attrs);
453c97415a72521071c235e0879f9a600014afd87b1Stefan Achatz	}
4542620efef7029bb040430f50f0fc148f2d5e002adGreg Kroah-Hartman}
4552620efef7029bb040430f50f0fc148f2d5e002adGreg Kroah-Hartman
4562620efef7029bb040430f50f0fc148f2d5e002adGreg Kroah-Hartman
45723681e479129854305da1da32f7f1eaf635ef22cGreg Kroah-Hartmanstatic ssize_t show_dev(struct device *dev, struct device_attribute *attr,
45823681e479129854305da1da32f7f1eaf635ef22cGreg Kroah-Hartman			char *buf)
45923681e479129854305da1da32f7f1eaf635ef22cGreg Kroah-Hartman{
46023681e479129854305da1da32f7f1eaf635ef22cGreg Kroah-Hartman	return print_dev_t(buf, dev->devt);
46123681e479129854305da1da32f7f1eaf635ef22cGreg Kroah-Hartman}
46223681e479129854305da1da32f7f1eaf635ef22cGreg Kroah-Hartman
463ad6a1e1c66009ba9dcd2f5c90ffa1fb4ce72fce0Tejun Heostatic struct device_attribute devt_attr =
464ad6a1e1c66009ba9dcd2f5c90ffa1fb4ce72fce0Tejun Heo	__ATTR(dev, S_IRUGO, show_dev, NULL);
465ad6a1e1c66009ba9dcd2f5c90ffa1fb4ce72fce0Tejun Heo
466881c6cfd7c5edfe6129006e2404654bfe5911050Greg Kroah-Hartman/* kset to create /sys/devices/  */
467881c6cfd7c5edfe6129006e2404654bfe5911050Greg Kroah-Hartmanstruct kset *devices_kset;
4681da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds
4691da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds/**
4704a3ad20ccd8f4d2a0535cf98fa83f7b561ba59a9Greg Kroah-Hartman * device_create_file - create sysfs attribute file for device.
4714a3ad20ccd8f4d2a0535cf98fa83f7b561ba59a9Greg Kroah-Hartman * @dev: device.
4724a3ad20ccd8f4d2a0535cf98fa83f7b561ba59a9Greg Kroah-Hartman * @attr: device attribute descriptor.
4731da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds */
47426579ab70aa0e0ea434e6e100279d2f67c094431Phil Carmodyint device_create_file(struct device *dev,
47526579ab70aa0e0ea434e6e100279d2f67c094431Phil Carmody		       const struct device_attribute *attr)
4761da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds{
4771da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds	int error = 0;
4780c98b19fe571ede1f14bd95b855bcbe2cca99bcfCornelia Huck	if (dev)
4791da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds		error = sysfs_create_file(&dev->kobj, &attr->attr);
4801da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds	return error;
4811da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds}
4821da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds
4831da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds/**
4844a3ad20ccd8f4d2a0535cf98fa83f7b561ba59a9Greg Kroah-Hartman * device_remove_file - remove sysfs attribute file.
4854a3ad20ccd8f4d2a0535cf98fa83f7b561ba59a9Greg Kroah-Hartman * @dev: device.
4864a3ad20ccd8f4d2a0535cf98fa83f7b561ba59a9Greg Kroah-Hartman * @attr: device attribute descriptor.
4871da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds */
48826579ab70aa0e0ea434e6e100279d2f67c094431Phil Carmodyvoid device_remove_file(struct device *dev,
48926579ab70aa0e0ea434e6e100279d2f67c094431Phil Carmody			const struct device_attribute *attr)
4901da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds{
4910c98b19fe571ede1f14bd95b855bcbe2cca99bcfCornelia Huck	if (dev)
4921da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds		sysfs_remove_file(&dev->kobj, &attr->attr);
4931da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds}
4941da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds
4952589f1887b0bf9f08ec3d7f3c5705ccb7c628076Greg Kroah-Hartman/**
4962589f1887b0bf9f08ec3d7f3c5705ccb7c628076Greg Kroah-Hartman * device_create_bin_file - create sysfs binary attribute file for device.
4972589f1887b0bf9f08ec3d7f3c5705ccb7c628076Greg Kroah-Hartman * @dev: device.
4982589f1887b0bf9f08ec3d7f3c5705ccb7c628076Greg Kroah-Hartman * @attr: device binary attribute descriptor.
4992589f1887b0bf9f08ec3d7f3c5705ccb7c628076Greg Kroah-Hartman */
50066ecb92be9eb579df93add22d19843e7869f168ePhil Carmodyint device_create_bin_file(struct device *dev,
50166ecb92be9eb579df93add22d19843e7869f168ePhil Carmody			   const struct bin_attribute *attr)
5022589f1887b0bf9f08ec3d7f3c5705ccb7c628076Greg Kroah-Hartman{
5032589f1887b0bf9f08ec3d7f3c5705ccb7c628076Greg Kroah-Hartman	int error = -EINVAL;
5042589f1887b0bf9f08ec3d7f3c5705ccb7c628076Greg Kroah-Hartman	if (dev)
5052589f1887b0bf9f08ec3d7f3c5705ccb7c628076Greg Kroah-Hartman		error = sysfs_create_bin_file(&dev->kobj, attr);
5062589f1887b0bf9f08ec3d7f3c5705ccb7c628076Greg Kroah-Hartman	return error;
5072589f1887b0bf9f08ec3d7f3c5705ccb7c628076Greg Kroah-Hartman}
5082589f1887b0bf9f08ec3d7f3c5705ccb7c628076Greg Kroah-HartmanEXPORT_SYMBOL_GPL(device_create_bin_file);
5092589f1887b0bf9f08ec3d7f3c5705ccb7c628076Greg Kroah-Hartman
5102589f1887b0bf9f08ec3d7f3c5705ccb7c628076Greg Kroah-Hartman/**
5112589f1887b0bf9f08ec3d7f3c5705ccb7c628076Greg Kroah-Hartman * device_remove_bin_file - remove sysfs binary attribute file
5122589f1887b0bf9f08ec3d7f3c5705ccb7c628076Greg Kroah-Hartman * @dev: device.
5132589f1887b0bf9f08ec3d7f3c5705ccb7c628076Greg Kroah-Hartman * @attr: device binary attribute descriptor.
5142589f1887b0bf9f08ec3d7f3c5705ccb7c628076Greg Kroah-Hartman */
51566ecb92be9eb579df93add22d19843e7869f168ePhil Carmodyvoid device_remove_bin_file(struct device *dev,
51666ecb92be9eb579df93add22d19843e7869f168ePhil Carmody			    const struct bin_attribute *attr)
5172589f1887b0bf9f08ec3d7f3c5705ccb7c628076Greg Kroah-Hartman{
5182589f1887b0bf9f08ec3d7f3c5705ccb7c628076Greg Kroah-Hartman	if (dev)
5192589f1887b0bf9f08ec3d7f3c5705ccb7c628076Greg Kroah-Hartman		sysfs_remove_bin_file(&dev->kobj, attr);
5202589f1887b0bf9f08ec3d7f3c5705ccb7c628076Greg Kroah-Hartman}
5212589f1887b0bf9f08ec3d7f3c5705ccb7c628076Greg Kroah-HartmanEXPORT_SYMBOL_GPL(device_remove_bin_file);
5222589f1887b0bf9f08ec3d7f3c5705ccb7c628076Greg Kroah-Hartman
523d9a9cdfb078d755e648d53ec25b7370f84ee5729Alan Stern/**
524523ded71de0c5e66973335bf99a80edfda9f401bAlan Stern * device_schedule_callback_owner - helper to schedule a callback for a device
525d9a9cdfb078d755e648d53ec25b7370f84ee5729Alan Stern * @dev: device.
526d9a9cdfb078d755e648d53ec25b7370f84ee5729Alan Stern * @func: callback function to invoke later.
527523ded71de0c5e66973335bf99a80edfda9f401bAlan Stern * @owner: module owning the callback routine
528d9a9cdfb078d755e648d53ec25b7370f84ee5729Alan Stern *
529d9a9cdfb078d755e648d53ec25b7370f84ee5729Alan Stern * Attribute methods must not unregister themselves or their parent device
530d9a9cdfb078d755e648d53ec25b7370f84ee5729Alan Stern * (which would amount to the same thing).  Attempts to do so will deadlock,
531d9a9cdfb078d755e648d53ec25b7370f84ee5729Alan Stern * since unregistration is mutually exclusive with driver callbacks.
532d9a9cdfb078d755e648d53ec25b7370f84ee5729Alan Stern *
533d9a9cdfb078d755e648d53ec25b7370f84ee5729Alan Stern * Instead methods can call this routine, which will attempt to allocate
534d9a9cdfb078d755e648d53ec25b7370f84ee5729Alan Stern * and schedule a workqueue request to call back @func with @dev as its
535d9a9cdfb078d755e648d53ec25b7370f84ee5729Alan Stern * argument in the workqueue's process context.  @dev will be pinned until
536d9a9cdfb078d755e648d53ec25b7370f84ee5729Alan Stern * @func returns.
537d9a9cdfb078d755e648d53ec25b7370f84ee5729Alan Stern *
538523ded71de0c5e66973335bf99a80edfda9f401bAlan Stern * This routine is usually called via the inline device_schedule_callback(),
539523ded71de0c5e66973335bf99a80edfda9f401bAlan Stern * which automatically sets @owner to THIS_MODULE.
540523ded71de0c5e66973335bf99a80edfda9f401bAlan Stern *
541d9a9cdfb078d755e648d53ec25b7370f84ee5729Alan Stern * Returns 0 if the request was submitted, -ENOMEM if storage could not
542523ded71de0c5e66973335bf99a80edfda9f401bAlan Stern * be allocated, -ENODEV if a reference to @owner isn't available.
543d9a9cdfb078d755e648d53ec25b7370f84ee5729Alan Stern *
544d9a9cdfb078d755e648d53ec25b7370f84ee5729Alan Stern * NOTE: This routine won't work if CONFIG_SYSFS isn't set!  It uses an
545d9a9cdfb078d755e648d53ec25b7370f84ee5729Alan Stern * underlying sysfs routine (since it is intended for use by attribute
546d9a9cdfb078d755e648d53ec25b7370f84ee5729Alan Stern * methods), and if sysfs isn't available you'll get nothing but -ENOSYS.
547d9a9cdfb078d755e648d53ec25b7370f84ee5729Alan Stern */
548523ded71de0c5e66973335bf99a80edfda9f401bAlan Sternint device_schedule_callback_owner(struct device *dev,
549523ded71de0c5e66973335bf99a80edfda9f401bAlan Stern		void (*func)(struct device *), struct module *owner)
550d9a9cdfb078d755e648d53ec25b7370f84ee5729Alan Stern{
551d9a9cdfb078d755e648d53ec25b7370f84ee5729Alan Stern	return sysfs_schedule_callback(&dev->kobj,
552523ded71de0c5e66973335bf99a80edfda9f401bAlan Stern			(void (*)(void *)) func, dev, owner);
553d9a9cdfb078d755e648d53ec25b7370f84ee5729Alan Stern}
554523ded71de0c5e66973335bf99a80edfda9f401bAlan SternEXPORT_SYMBOL_GPL(device_schedule_callback_owner);
555d9a9cdfb078d755e648d53ec25b7370f84ee5729Alan Stern
55634bb61f9ddabd7a7f909cbfb05592eb775f6662aJames Bottomleystatic void klist_children_get(struct klist_node *n)
55734bb61f9ddabd7a7f909cbfb05592eb775f6662aJames Bottomley{
558f791b8c836307b58cbf62133a6a772ed1a92fb33Greg Kroah-Hartman	struct device_private *p = to_device_private_parent(n);
559f791b8c836307b58cbf62133a6a772ed1a92fb33Greg Kroah-Hartman	struct device *dev = p->device;
56034bb61f9ddabd7a7f909cbfb05592eb775f6662aJames Bottomley
56134bb61f9ddabd7a7f909cbfb05592eb775f6662aJames Bottomley	get_device(dev);
56234bb61f9ddabd7a7f909cbfb05592eb775f6662aJames Bottomley}
56334bb61f9ddabd7a7f909cbfb05592eb775f6662aJames Bottomley
56434bb61f9ddabd7a7f909cbfb05592eb775f6662aJames Bottomleystatic void klist_children_put(struct klist_node *n)
56534bb61f9ddabd7a7f909cbfb05592eb775f6662aJames Bottomley{
566f791b8c836307b58cbf62133a6a772ed1a92fb33Greg Kroah-Hartman	struct device_private *p = to_device_private_parent(n);
567f791b8c836307b58cbf62133a6a772ed1a92fb33Greg Kroah-Hartman	struct device *dev = p->device;
56834bb61f9ddabd7a7f909cbfb05592eb775f6662aJames Bottomley
56934bb61f9ddabd7a7f909cbfb05592eb775f6662aJames Bottomley	put_device(dev);
57034bb61f9ddabd7a7f909cbfb05592eb775f6662aJames Bottomley}
57134bb61f9ddabd7a7f909cbfb05592eb775f6662aJames Bottomley
5721da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds/**
5734a3ad20ccd8f4d2a0535cf98fa83f7b561ba59a9Greg Kroah-Hartman * device_initialize - init device structure.
5744a3ad20ccd8f4d2a0535cf98fa83f7b561ba59a9Greg Kroah-Hartman * @dev: device.
5751da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds *
5765739411acbaa63a6c22c91e340fdcdbcc7d82a51Cornelia Huck * This prepares the device for use by other layers by initializing
5775739411acbaa63a6c22c91e340fdcdbcc7d82a51Cornelia Huck * its fields.
5784a3ad20ccd8f4d2a0535cf98fa83f7b561ba59a9Greg Kroah-Hartman * It is the first half of device_register(), if called by
5795739411acbaa63a6c22c91e340fdcdbcc7d82a51Cornelia Huck * that function, though it can also be called separately, so one
5805739411acbaa63a6c22c91e340fdcdbcc7d82a51Cornelia Huck * may use @dev's fields. In particular, get_device()/put_device()
5815739411acbaa63a6c22c91e340fdcdbcc7d82a51Cornelia Huck * may be used for reference counting of @dev after calling this
5825739411acbaa63a6c22c91e340fdcdbcc7d82a51Cornelia Huck * function.
5835739411acbaa63a6c22c91e340fdcdbcc7d82a51Cornelia Huck *
5845739411acbaa63a6c22c91e340fdcdbcc7d82a51Cornelia Huck * NOTE: Use put_device() to give up your reference instead of freeing
5855739411acbaa63a6c22c91e340fdcdbcc7d82a51Cornelia Huck * @dev directly once you have called this function.
5861da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds */
5871da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvaldsvoid device_initialize(struct device *dev)
5881da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds{
589881c6cfd7c5edfe6129006e2404654bfe5911050Greg Kroah-Hartman	dev->kobj.kset = devices_kset;
590f9cb074bff8e762ef24c44678a5a7d907f82fbebGreg Kroah-Hartman	kobject_init(&dev->kobj, &device_ktype);
5911da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds	INIT_LIST_HEAD(&dev->dma_pools);
5923142788b7967ccfd2f1813ee9e11aeb1e1cf7de2Thomas Gleixner	mutex_init(&dev->mutex);
5931704f47b50b5d9e1b825e43e1baaf2c5897baf03Peter Zijlstra	lockdep_set_novalidate_class(&dev->mutex);
5949ac7849e35f705830f7b016ff272b0ff1f7ff759Tejun Heo	spin_lock_init(&dev->devres_lock);
5959ac7849e35f705830f7b016ff272b0ff1f7ff759Tejun Heo	INIT_LIST_HEAD(&dev->devres_head);
5963b98aeaf3a75f544dc945694f4fcf6e1c4bab89dAlan Stern	device_pm_init(dev);
597873481367edb18a7d0d7e5a285e6728c16bb44a9Christoph Hellwig	set_dev_node(dev, -1);
5981da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds}
5991da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds
600864062457a2e444227bd368ca5f2a2b740de604fKay Sieversstatic struct kobject *virtual_device_parent(struct device *dev)
601f0ee61a6cecd100301a60d99feb187776533b2a2Greg Kroah-Hartman{
602864062457a2e444227bd368ca5f2a2b740de604fKay Sievers	static struct kobject *virtual_dir = NULL;
603f0ee61a6cecd100301a60d99feb187776533b2a2Greg Kroah-Hartman
604864062457a2e444227bd368ca5f2a2b740de604fKay Sievers	if (!virtual_dir)
6054ff6abff832fbc6cb1d769f6106c841bc2b09f63Greg Kroah-Hartman		virtual_dir = kobject_create_and_add("virtual",
606881c6cfd7c5edfe6129006e2404654bfe5911050Greg Kroah-Hartman						     &devices_kset->kobj);
607f0ee61a6cecd100301a60d99feb187776533b2a2Greg Kroah-Hartman
608864062457a2e444227bd368ca5f2a2b740de604fKay Sievers	return virtual_dir;
609f0ee61a6cecd100301a60d99feb187776533b2a2Greg Kroah-Hartman}
610f0ee61a6cecd100301a60d99feb187776533b2a2Greg Kroah-Hartman
611bc451f2058238013e1cdf4acd443c01734d332f0Eric W. Biedermanstruct class_dir {
612bc451f2058238013e1cdf4acd443c01734d332f0Eric W. Biederman	struct kobject kobj;
613bc451f2058238013e1cdf4acd443c01734d332f0Eric W. Biederman	struct class *class;
614bc451f2058238013e1cdf4acd443c01734d332f0Eric W. Biederman};
615bc451f2058238013e1cdf4acd443c01734d332f0Eric W. Biederman
616bc451f2058238013e1cdf4acd443c01734d332f0Eric W. Biederman#define to_class_dir(obj) container_of(obj, struct class_dir, kobj)
617bc451f2058238013e1cdf4acd443c01734d332f0Eric W. Biederman
618bc451f2058238013e1cdf4acd443c01734d332f0Eric W. Biedermanstatic void class_dir_release(struct kobject *kobj)
619bc451f2058238013e1cdf4acd443c01734d332f0Eric W. Biederman{
620bc451f2058238013e1cdf4acd443c01734d332f0Eric W. Biederman	struct class_dir *dir = to_class_dir(kobj);
621bc451f2058238013e1cdf4acd443c01734d332f0Eric W. Biederman	kfree(dir);
622bc451f2058238013e1cdf4acd443c01734d332f0Eric W. Biederman}
623bc451f2058238013e1cdf4acd443c01734d332f0Eric W. Biederman
624bc451f2058238013e1cdf4acd443c01734d332f0Eric W. Biedermanstatic const
625bc451f2058238013e1cdf4acd443c01734d332f0Eric W. Biedermanstruct kobj_ns_type_operations *class_dir_child_ns_type(struct kobject *kobj)
62640fa54226f518a9bc97ed1d711c0016e416e3782Greg Kroah-Hartman{
627bc451f2058238013e1cdf4acd443c01734d332f0Eric W. Biederman	struct class_dir *dir = to_class_dir(kobj);
628bc451f2058238013e1cdf4acd443c01734d332f0Eric W. Biederman	return dir->class->ns_type;
629bc451f2058238013e1cdf4acd443c01734d332f0Eric W. Biederman}
630bc451f2058238013e1cdf4acd443c01734d332f0Eric W. Biederman
631bc451f2058238013e1cdf4acd443c01734d332f0Eric W. Biedermanstatic struct kobj_type class_dir_ktype = {
632bc451f2058238013e1cdf4acd443c01734d332f0Eric W. Biederman	.release	= class_dir_release,
633bc451f2058238013e1cdf4acd443c01734d332f0Eric W. Biederman	.sysfs_ops	= &kobj_sysfs_ops,
634bc451f2058238013e1cdf4acd443c01734d332f0Eric W. Biederman	.child_ns_type	= class_dir_child_ns_type
635bc451f2058238013e1cdf4acd443c01734d332f0Eric W. Biederman};
636bc451f2058238013e1cdf4acd443c01734d332f0Eric W. Biederman
637bc451f2058238013e1cdf4acd443c01734d332f0Eric W. Biedermanstatic struct kobject *
638bc451f2058238013e1cdf4acd443c01734d332f0Eric W. Biedermanclass_dir_create_and_add(struct class *class, struct kobject *parent_kobj)
639bc451f2058238013e1cdf4acd443c01734d332f0Eric W. Biederman{
640bc451f2058238013e1cdf4acd443c01734d332f0Eric W. Biederman	struct class_dir *dir;
64143968d2f1648f4dc92437dc0363a3e88377445b3Greg Kroah-Hartman	int retval;
64243968d2f1648f4dc92437dc0363a3e88377445b3Greg Kroah-Hartman
643bc451f2058238013e1cdf4acd443c01734d332f0Eric W. Biederman	dir = kzalloc(sizeof(*dir), GFP_KERNEL);
644bc451f2058238013e1cdf4acd443c01734d332f0Eric W. Biederman	if (!dir)
645bc451f2058238013e1cdf4acd443c01734d332f0Eric W. Biederman		return NULL;
646bc451f2058238013e1cdf4acd443c01734d332f0Eric W. Biederman
647bc451f2058238013e1cdf4acd443c01734d332f0Eric W. Biederman	dir->class = class;
648bc451f2058238013e1cdf4acd443c01734d332f0Eric W. Biederman	kobject_init(&dir->kobj, &class_dir_ktype);
649bc451f2058238013e1cdf4acd443c01734d332f0Eric W. Biederman
650bc451f2058238013e1cdf4acd443c01734d332f0Eric W. Biederman	dir->kobj.kset = &class->p->class_dirs;
651bc451f2058238013e1cdf4acd443c01734d332f0Eric W. Biederman
652bc451f2058238013e1cdf4acd443c01734d332f0Eric W. Biederman	retval = kobject_add(&dir->kobj, parent_kobj, "%s", class->name);
653bc451f2058238013e1cdf4acd443c01734d332f0Eric W. Biederman	if (retval < 0) {
654bc451f2058238013e1cdf4acd443c01734d332f0Eric W. Biederman		kobject_put(&dir->kobj);
655bc451f2058238013e1cdf4acd443c01734d332f0Eric W. Biederman		return NULL;
656bc451f2058238013e1cdf4acd443c01734d332f0Eric W. Biederman	}
657bc451f2058238013e1cdf4acd443c01734d332f0Eric W. Biederman	return &dir->kobj;
658bc451f2058238013e1cdf4acd443c01734d332f0Eric W. Biederman}
659bc451f2058238013e1cdf4acd443c01734d332f0Eric W. Biederman
660bc451f2058238013e1cdf4acd443c01734d332f0Eric W. Biederman
661bc451f2058238013e1cdf4acd443c01734d332f0Eric W. Biedermanstatic struct kobject *get_device_parent(struct device *dev,
662bc451f2058238013e1cdf4acd443c01734d332f0Eric W. Biederman					 struct device *parent)
663bc451f2058238013e1cdf4acd443c01734d332f0Eric W. Biederman{
664864062457a2e444227bd368ca5f2a2b740de604fKay Sievers	if (dev->class) {
66577d3d7c1d561f49f755d7390f0764dff90765974Tejun Heo		static DEFINE_MUTEX(gdp_mutex);
666864062457a2e444227bd368ca5f2a2b740de604fKay Sievers		struct kobject *kobj = NULL;
667864062457a2e444227bd368ca5f2a2b740de604fKay Sievers		struct kobject *parent_kobj;
668864062457a2e444227bd368ca5f2a2b740de604fKay Sievers		struct kobject *k;
669864062457a2e444227bd368ca5f2a2b740de604fKay Sievers
670ead454feb6cbfe0fa6a1eeb30aa9abc338dacf62Randy Dunlap#ifdef CONFIG_BLOCK
67139aba963d937edb20db7d9d93e6dda5d2adfdcddKay Sievers		/* block disks show up in /sys/block */
672e52eec13cd6b7f30ab19081b387813e03e592ae5Andi Kleen		if (sysfs_deprecated && dev->class == &block_class) {
67339aba963d937edb20db7d9d93e6dda5d2adfdcddKay Sievers			if (parent && parent->class == &block_class)
67439aba963d937edb20db7d9d93e6dda5d2adfdcddKay Sievers				return &parent->kobj;
67539aba963d937edb20db7d9d93e6dda5d2adfdcddKay Sievers			return &block_class.p->class_subsys.kobj;
67639aba963d937edb20db7d9d93e6dda5d2adfdcddKay Sievers		}
677ead454feb6cbfe0fa6a1eeb30aa9abc338dacf62Randy Dunlap#endif
678e52eec13cd6b7f30ab19081b387813e03e592ae5Andi Kleen
679864062457a2e444227bd368ca5f2a2b740de604fKay Sievers		/*
680864062457a2e444227bd368ca5f2a2b740de604fKay Sievers		 * If we have no parent, we live in "virtual".
6810f4dafc0563c6c49e17fe14b3f5f356e4c4b8806Kay Sievers		 * Class-devices with a non class-device as parent, live
6820f4dafc0563c6c49e17fe14b3f5f356e4c4b8806Kay Sievers		 * in a "glue" directory to prevent namespace collisions.
683864062457a2e444227bd368ca5f2a2b740de604fKay Sievers		 */
684864062457a2e444227bd368ca5f2a2b740de604fKay Sievers		if (parent == NULL)
685864062457a2e444227bd368ca5f2a2b740de604fKay Sievers			parent_kobj = virtual_device_parent(dev);
68624b1442d01ae155ea716dfb94ed21605541c317dEric W. Biederman		else if (parent->class && !dev->class->ns_type)
687864062457a2e444227bd368ca5f2a2b740de604fKay Sievers			return &parent->kobj;
688864062457a2e444227bd368ca5f2a2b740de604fKay Sievers		else
689864062457a2e444227bd368ca5f2a2b740de604fKay Sievers			parent_kobj = &parent->kobj;
690864062457a2e444227bd368ca5f2a2b740de604fKay Sievers
69177d3d7c1d561f49f755d7390f0764dff90765974Tejun Heo		mutex_lock(&gdp_mutex);
69277d3d7c1d561f49f755d7390f0764dff90765974Tejun Heo
693864062457a2e444227bd368ca5f2a2b740de604fKay Sievers		/* find our class-directory at the parent and reference it */
6947c71448b8aa80123fc521563d5f7c63a099d97abGreg Kroah-Hartman		spin_lock(&dev->class->p->class_dirs.list_lock);
6957c71448b8aa80123fc521563d5f7c63a099d97abGreg Kroah-Hartman		list_for_each_entry(k, &dev->class->p->class_dirs.list, entry)
696864062457a2e444227bd368ca5f2a2b740de604fKay Sievers			if (k->parent == parent_kobj) {
697864062457a2e444227bd368ca5f2a2b740de604fKay Sievers				kobj = kobject_get(k);
698864062457a2e444227bd368ca5f2a2b740de604fKay Sievers				break;
699864062457a2e444227bd368ca5f2a2b740de604fKay Sievers			}
7007c71448b8aa80123fc521563d5f7c63a099d97abGreg Kroah-Hartman		spin_unlock(&dev->class->p->class_dirs.list_lock);
70177d3d7c1d561f49f755d7390f0764dff90765974Tejun Heo		if (kobj) {
70277d3d7c1d561f49f755d7390f0764dff90765974Tejun Heo			mutex_unlock(&gdp_mutex);
703864062457a2e444227bd368ca5f2a2b740de604fKay Sievers			return kobj;
70477d3d7c1d561f49f755d7390f0764dff90765974Tejun Heo		}
705864062457a2e444227bd368ca5f2a2b740de604fKay Sievers
706864062457a2e444227bd368ca5f2a2b740de604fKay Sievers		/* or create a new class-directory at the parent device */
707bc451f2058238013e1cdf4acd443c01734d332f0Eric W. Biederman		k = class_dir_create_and_add(dev->class, parent_kobj);
7080f4dafc0563c6c49e17fe14b3f5f356e4c4b8806Kay Sievers		/* do not emit an uevent for this simple "glue" directory */
70977d3d7c1d561f49f755d7390f0764dff90765974Tejun Heo		mutex_unlock(&gdp_mutex);
71043968d2f1648f4dc92437dc0363a3e88377445b3Greg Kroah-Hartman		return k;
711864062457a2e444227bd368ca5f2a2b740de604fKay Sievers	}
712864062457a2e444227bd368ca5f2a2b740de604fKay Sievers
713864062457a2e444227bd368ca5f2a2b740de604fKay Sievers	if (parent)
714c744aeae9d173a953b771a7ad5c872f91fa99decCornelia Huck		return &parent->kobj;
715c744aeae9d173a953b771a7ad5c872f91fa99decCornelia Huck	return NULL;
716c744aeae9d173a953b771a7ad5c872f91fa99decCornelia Huck}
717da231fd5d113ab6da5dab7a2d2c38d0a540f939cKay Sievers
71863b6971a0876b744e2fcf3c9df15d130501e1debCornelia Huckstatic void cleanup_glue_dir(struct device *dev, struct kobject *glue_dir)
719da231fd5d113ab6da5dab7a2d2c38d0a540f939cKay Sievers{
7200f4dafc0563c6c49e17fe14b3f5f356e4c4b8806Kay Sievers	/* see if we live in a "glue" directory */
721c1fe539a7e031302af1d121163e7ce68e679ba8cCornelia Huck	if (!glue_dir || !dev->class ||
7227c71448b8aa80123fc521563d5f7c63a099d97abGreg Kroah-Hartman	    glue_dir->kset != &dev->class->p->class_dirs)
723da231fd5d113ab6da5dab7a2d2c38d0a540f939cKay Sievers		return;
724da231fd5d113ab6da5dab7a2d2c38d0a540f939cKay Sievers
7250f4dafc0563c6c49e17fe14b3f5f356e4c4b8806Kay Sievers	kobject_put(glue_dir);
726da231fd5d113ab6da5dab7a2d2c38d0a540f939cKay Sievers}
72763b6971a0876b744e2fcf3c9df15d130501e1debCornelia Huck
72863b6971a0876b744e2fcf3c9df15d130501e1debCornelia Huckstatic void cleanup_device_parent(struct device *dev)
72963b6971a0876b744e2fcf3c9df15d130501e1debCornelia Huck{
73063b6971a0876b744e2fcf3c9df15d130501e1debCornelia Huck	cleanup_glue_dir(dev, dev->kobj.parent);
73163b6971a0876b744e2fcf3c9df15d130501e1debCornelia Huck}
732864062457a2e444227bd368ca5f2a2b740de604fKay Sievers
73363b6971a0876b744e2fcf3c9df15d130501e1debCornelia Huckstatic void setup_parent(struct device *dev, struct device *parent)
734c744aeae9d173a953b771a7ad5c872f91fa99decCornelia Huck{
735c744aeae9d173a953b771a7ad5c872f91fa99decCornelia Huck	struct kobject *kobj;
736c744aeae9d173a953b771a7ad5c872f91fa99decCornelia Huck	kobj = get_device_parent(dev, parent);
737c744aeae9d173a953b771a7ad5c872f91fa99decCornelia Huck	if (kobj)
738c744aeae9d173a953b771a7ad5c872f91fa99decCornelia Huck		dev->kobj.parent = kobj;
73940fa54226f518a9bc97ed1d711c0016e416e3782Greg Kroah-Hartman}
74040fa54226f518a9bc97ed1d711c0016e416e3782Greg Kroah-Hartman
7412ee97caf0a6602f749ddbfdb1449e383e1212707Cornelia Huckstatic int device_add_class_symlinks(struct device *dev)
7422ee97caf0a6602f749ddbfdb1449e383e1212707Cornelia Huck{
7432ee97caf0a6602f749ddbfdb1449e383e1212707Cornelia Huck	int error;
7442ee97caf0a6602f749ddbfdb1449e383e1212707Cornelia Huck
7452ee97caf0a6602f749ddbfdb1449e383e1212707Cornelia Huck	if (!dev->class)
7462ee97caf0a6602f749ddbfdb1449e383e1212707Cornelia Huck		return 0;
747da231fd5d113ab6da5dab7a2d2c38d0a540f939cKay Sievers
7481fbfee6c6dc0f4a4c587b6b163ee79643fc9aaa7Greg Kroah-Hartman	error = sysfs_create_link(&dev->kobj,
7491fbfee6c6dc0f4a4c587b6b163ee79643fc9aaa7Greg Kroah-Hartman				  &dev->class->p->class_subsys.kobj,
7502ee97caf0a6602f749ddbfdb1449e383e1212707Cornelia Huck				  "subsystem");
7512ee97caf0a6602f749ddbfdb1449e383e1212707Cornelia Huck	if (error)
7522ee97caf0a6602f749ddbfdb1449e383e1212707Cornelia Huck		goto out;
753da231fd5d113ab6da5dab7a2d2c38d0a540f939cKay Sievers
7544e886c29610f4374d8971ec7a248f011cc3bd73aGreg Kroah-Hartman	if (dev->parent && device_is_not_partition(dev)) {
75539aba963d937edb20db7d9d93e6dda5d2adfdcddKay Sievers		error = sysfs_create_link(&dev->kobj, &dev->parent->kobj,
7564f01a757e75f2a3cab2bab89c4176498963946b9Dmitry Torokhov					  "device");
7574f01a757e75f2a3cab2bab89c4176498963946b9Dmitry Torokhov		if (error)
75839aba963d937edb20db7d9d93e6dda5d2adfdcddKay Sievers			goto out_subsys;
7592ee97caf0a6602f749ddbfdb1449e383e1212707Cornelia Huck	}
7602ee97caf0a6602f749ddbfdb1449e383e1212707Cornelia Huck
761ead454feb6cbfe0fa6a1eeb30aa9abc338dacf62Randy Dunlap#ifdef CONFIG_BLOCK
76239aba963d937edb20db7d9d93e6dda5d2adfdcddKay Sievers	/* /sys/block has directories and does not need symlinks */
763e52eec13cd6b7f30ab19081b387813e03e592ae5Andi Kleen	if (sysfs_deprecated && dev->class == &block_class)
76439aba963d937edb20db7d9d93e6dda5d2adfdcddKay Sievers		return 0;
765ead454feb6cbfe0fa6a1eeb30aa9abc338dacf62Randy Dunlap#endif
76639aba963d937edb20db7d9d93e6dda5d2adfdcddKay Sievers
767da231fd5d113ab6da5dab7a2d2c38d0a540f939cKay Sievers	/* link in the class directory pointing to the device */
7681fbfee6c6dc0f4a4c587b6b163ee79643fc9aaa7Greg Kroah-Hartman	error = sysfs_create_link(&dev->class->p->class_subsys.kobj,
7691e0b2cf933ebf32494eba3f668859ba57f06a951Kay Sievers				  &dev->kobj, dev_name(dev));
770da231fd5d113ab6da5dab7a2d2c38d0a540f939cKay Sievers	if (error)
77139aba963d937edb20db7d9d93e6dda5d2adfdcddKay Sievers		goto out_device;
772da231fd5d113ab6da5dab7a2d2c38d0a540f939cKay Sievers
773da231fd5d113ab6da5dab7a2d2c38d0a540f939cKay Sievers	return 0;
774da231fd5d113ab6da5dab7a2d2c38d0a540f939cKay Sievers
77539aba963d937edb20db7d9d93e6dda5d2adfdcddKay Sieversout_device:
77639aba963d937edb20db7d9d93e6dda5d2adfdcddKay Sievers	sysfs_remove_link(&dev->kobj, "device");
777da231fd5d113ab6da5dab7a2d2c38d0a540f939cKay Sievers
7782ee97caf0a6602f749ddbfdb1449e383e1212707Cornelia Huckout_subsys:
7792ee97caf0a6602f749ddbfdb1449e383e1212707Cornelia Huck	sysfs_remove_link(&dev->kobj, "subsystem");
7802ee97caf0a6602f749ddbfdb1449e383e1212707Cornelia Huckout:
7812ee97caf0a6602f749ddbfdb1449e383e1212707Cornelia Huck	return error;
7822ee97caf0a6602f749ddbfdb1449e383e1212707Cornelia Huck}
7832ee97caf0a6602f749ddbfdb1449e383e1212707Cornelia Huck
7842ee97caf0a6602f749ddbfdb1449e383e1212707Cornelia Huckstatic void device_remove_class_symlinks(struct device *dev)
7852ee97caf0a6602f749ddbfdb1449e383e1212707Cornelia Huck{
7862ee97caf0a6602f749ddbfdb1449e383e1212707Cornelia Huck	if (!dev->class)
7872ee97caf0a6602f749ddbfdb1449e383e1212707Cornelia Huck		return;
788da231fd5d113ab6da5dab7a2d2c38d0a540f939cKay Sievers
7894e886c29610f4374d8971ec7a248f011cc3bd73aGreg Kroah-Hartman	if (dev->parent && device_is_not_partition(dev))
790da231fd5d113ab6da5dab7a2d2c38d0a540f939cKay Sievers		sysfs_remove_link(&dev->kobj, "device");
7912ee97caf0a6602f749ddbfdb1449e383e1212707Cornelia Huck	sysfs_remove_link(&dev->kobj, "subsystem");
792ead454feb6cbfe0fa6a1eeb30aa9abc338dacf62Randy Dunlap#ifdef CONFIG_BLOCK
793e52eec13cd6b7f30ab19081b387813e03e592ae5Andi Kleen	if (sysfs_deprecated && dev->class == &block_class)
79439aba963d937edb20db7d9d93e6dda5d2adfdcddKay Sievers		return;
795ead454feb6cbfe0fa6a1eeb30aa9abc338dacf62Randy Dunlap#endif
79639aba963d937edb20db7d9d93e6dda5d2adfdcddKay Sievers	sysfs_delete_link(&dev->class->p->class_subsys.kobj, &dev->kobj, dev_name(dev));
7972ee97caf0a6602f749ddbfdb1449e383e1212707Cornelia Huck}
7982ee97caf0a6602f749ddbfdb1449e383e1212707Cornelia Huck
7991da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds/**
800413c239fad68258157f903b3ffd9bfcc53f5e34bStephen Rothwell * dev_set_name - set a device name
801413c239fad68258157f903b3ffd9bfcc53f5e34bStephen Rothwell * @dev: device
8024623236619ff5ce233136d13ee2747c194a63591Randy Dunlap * @fmt: format string for the device's name
803413c239fad68258157f903b3ffd9bfcc53f5e34bStephen Rothwell */
804413c239fad68258157f903b3ffd9bfcc53f5e34bStephen Rothwellint dev_set_name(struct device *dev, const char *fmt, ...)
805413c239fad68258157f903b3ffd9bfcc53f5e34bStephen Rothwell{
806413c239fad68258157f903b3ffd9bfcc53f5e34bStephen Rothwell	va_list vargs;
8071fa5ae857bb14f6046205171d98506d8112dd74eKay Sievers	int err;
808413c239fad68258157f903b3ffd9bfcc53f5e34bStephen Rothwell
809413c239fad68258157f903b3ffd9bfcc53f5e34bStephen Rothwell	va_start(vargs, fmt);
8101fa5ae857bb14f6046205171d98506d8112dd74eKay Sievers	err = kobject_set_name_vargs(&dev->kobj, fmt, vargs);
811413c239fad68258157f903b3ffd9bfcc53f5e34bStephen Rothwell	va_end(vargs);
8121fa5ae857bb14f6046205171d98506d8112dd74eKay Sievers	return err;
813413c239fad68258157f903b3ffd9bfcc53f5e34bStephen Rothwell}
814413c239fad68258157f903b3ffd9bfcc53f5e34bStephen RothwellEXPORT_SYMBOL_GPL(dev_set_name);
815413c239fad68258157f903b3ffd9bfcc53f5e34bStephen Rothwell
816413c239fad68258157f903b3ffd9bfcc53f5e34bStephen Rothwell/**
817e105b8bfc769b0545b6f0f395179d1e43cbee822Dan Williams * device_to_dev_kobj - select a /sys/dev/ directory for the device
818e105b8bfc769b0545b6f0f395179d1e43cbee822Dan Williams * @dev: device
819e105b8bfc769b0545b6f0f395179d1e43cbee822Dan Williams *
820e105b8bfc769b0545b6f0f395179d1e43cbee822Dan Williams * By default we select char/ for new entries.  Setting class->dev_obj
821e105b8bfc769b0545b6f0f395179d1e43cbee822Dan Williams * to NULL prevents an entry from being created.  class->dev_kobj must
822e105b8bfc769b0545b6f0f395179d1e43cbee822Dan Williams * be set (or cleared) before any devices are registered to the class
823e105b8bfc769b0545b6f0f395179d1e43cbee822Dan Williams * otherwise device_create_sys_dev_entry() and
824e105b8bfc769b0545b6f0f395179d1e43cbee822Dan Williams * device_remove_sys_dev_entry() will disagree about the the presence
825e105b8bfc769b0545b6f0f395179d1e43cbee822Dan Williams * of the link.
826e105b8bfc769b0545b6f0f395179d1e43cbee822Dan Williams */
827e105b8bfc769b0545b6f0f395179d1e43cbee822Dan Williamsstatic struct kobject *device_to_dev_kobj(struct device *dev)
828e105b8bfc769b0545b6f0f395179d1e43cbee822Dan Williams{
829e105b8bfc769b0545b6f0f395179d1e43cbee822Dan Williams	struct kobject *kobj;
830e105b8bfc769b0545b6f0f395179d1e43cbee822Dan Williams
831e105b8bfc769b0545b6f0f395179d1e43cbee822Dan Williams	if (dev->class)
832e105b8bfc769b0545b6f0f395179d1e43cbee822Dan Williams		kobj = dev->class->dev_kobj;
833e105b8bfc769b0545b6f0f395179d1e43cbee822Dan Williams	else
834e105b8bfc769b0545b6f0f395179d1e43cbee822Dan Williams		kobj = sysfs_dev_char_kobj;
835e105b8bfc769b0545b6f0f395179d1e43cbee822Dan Williams
836e105b8bfc769b0545b6f0f395179d1e43cbee822Dan Williams	return kobj;
837e105b8bfc769b0545b6f0f395179d1e43cbee822Dan Williams}
838e105b8bfc769b0545b6f0f395179d1e43cbee822Dan Williams
839e105b8bfc769b0545b6f0f395179d1e43cbee822Dan Williamsstatic int device_create_sys_dev_entry(struct device *dev)
840e105b8bfc769b0545b6f0f395179d1e43cbee822Dan Williams{
841e105b8bfc769b0545b6f0f395179d1e43cbee822Dan Williams	struct kobject *kobj = device_to_dev_kobj(dev);
842e105b8bfc769b0545b6f0f395179d1e43cbee822Dan Williams	int error = 0;
843e105b8bfc769b0545b6f0f395179d1e43cbee822Dan Williams	char devt_str[15];
844e105b8bfc769b0545b6f0f395179d1e43cbee822Dan Williams
845e105b8bfc769b0545b6f0f395179d1e43cbee822Dan Williams	if (kobj) {
846e105b8bfc769b0545b6f0f395179d1e43cbee822Dan Williams		format_dev_t(devt_str, dev->devt);
847e105b8bfc769b0545b6f0f395179d1e43cbee822Dan Williams		error = sysfs_create_link(kobj, &dev->kobj, devt_str);
848e105b8bfc769b0545b6f0f395179d1e43cbee822Dan Williams	}
849e105b8bfc769b0545b6f0f395179d1e43cbee822Dan Williams
850e105b8bfc769b0545b6f0f395179d1e43cbee822Dan Williams	return error;
851e105b8bfc769b0545b6f0f395179d1e43cbee822Dan Williams}
852e105b8bfc769b0545b6f0f395179d1e43cbee822Dan Williams
853e105b8bfc769b0545b6f0f395179d1e43cbee822Dan Williamsstatic void device_remove_sys_dev_entry(struct device *dev)
854e105b8bfc769b0545b6f0f395179d1e43cbee822Dan Williams{
855e105b8bfc769b0545b6f0f395179d1e43cbee822Dan Williams	struct kobject *kobj = device_to_dev_kobj(dev);
856e105b8bfc769b0545b6f0f395179d1e43cbee822Dan Williams	char devt_str[15];
857e105b8bfc769b0545b6f0f395179d1e43cbee822Dan Williams
858e105b8bfc769b0545b6f0f395179d1e43cbee822Dan Williams	if (kobj) {
859e105b8bfc769b0545b6f0f395179d1e43cbee822Dan Williams		format_dev_t(devt_str, dev->devt);
860e105b8bfc769b0545b6f0f395179d1e43cbee822Dan Williams		sysfs_remove_link(kobj, devt_str);
861e105b8bfc769b0545b6f0f395179d1e43cbee822Dan Williams	}
862e105b8bfc769b0545b6f0f395179d1e43cbee822Dan Williams}
863e105b8bfc769b0545b6f0f395179d1e43cbee822Dan Williams
864b4028437876866aba4747a655ede00f892089e14Greg Kroah-Hartmanint device_private_init(struct device *dev)
865b4028437876866aba4747a655ede00f892089e14Greg Kroah-Hartman{
866b4028437876866aba4747a655ede00f892089e14Greg Kroah-Hartman	dev->p = kzalloc(sizeof(*dev->p), GFP_KERNEL);
867b4028437876866aba4747a655ede00f892089e14Greg Kroah-Hartman	if (!dev->p)
868b4028437876866aba4747a655ede00f892089e14Greg Kroah-Hartman		return -ENOMEM;
869b4028437876866aba4747a655ede00f892089e14Greg Kroah-Hartman	dev->p->device = dev;
870b4028437876866aba4747a655ede00f892089e14Greg Kroah-Hartman	klist_init(&dev->p->klist_children, klist_children_get,
871b4028437876866aba4747a655ede00f892089e14Greg Kroah-Hartman		   klist_children_put);
872b4028437876866aba4747a655ede00f892089e14Greg Kroah-Hartman	return 0;
873b4028437876866aba4747a655ede00f892089e14Greg Kroah-Hartman}
874b4028437876866aba4747a655ede00f892089e14Greg Kroah-Hartman
875e105b8bfc769b0545b6f0f395179d1e43cbee822Dan Williams/**
8764a3ad20ccd8f4d2a0535cf98fa83f7b561ba59a9Greg Kroah-Hartman * device_add - add device to device hierarchy.
8774a3ad20ccd8f4d2a0535cf98fa83f7b561ba59a9Greg Kroah-Hartman * @dev: device.
8781da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds *
8794a3ad20ccd8f4d2a0535cf98fa83f7b561ba59a9Greg Kroah-Hartman * This is part 2 of device_register(), though may be called
8804a3ad20ccd8f4d2a0535cf98fa83f7b561ba59a9Greg Kroah-Hartman * separately _iff_ device_initialize() has been called separately.
8811da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds *
8825739411acbaa63a6c22c91e340fdcdbcc7d82a51Cornelia Huck * This adds @dev to the kobject hierarchy via kobject_add(), adds it
8834a3ad20ccd8f4d2a0535cf98fa83f7b561ba59a9Greg Kroah-Hartman * to the global and sibling lists for the device, then
8844a3ad20ccd8f4d2a0535cf98fa83f7b561ba59a9Greg Kroah-Hartman * adds it to the other relevant subsystems of the driver model.
8855739411acbaa63a6c22c91e340fdcdbcc7d82a51Cornelia Huck *
8865739411acbaa63a6c22c91e340fdcdbcc7d82a51Cornelia Huck * NOTE: _Never_ directly free @dev after calling this function, even
8875739411acbaa63a6c22c91e340fdcdbcc7d82a51Cornelia Huck * if it returned an error! Always use put_device() to give up your
8885739411acbaa63a6c22c91e340fdcdbcc7d82a51Cornelia Huck * reference instead.
8891da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds */
8901da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvaldsint device_add(struct device *dev)
8911da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds{
8921da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds	struct device *parent = NULL;
893c47ed219ba81632595e9f02e27318151fec16c9eGreg Kroah-Hartman	struct class_interface *class_intf;
894c906a48adc74fc455378137ac5124b13e7030a15Greg Kroah-Hartman	int error = -EINVAL;
895775b64d2b6ca37697de925f70799c710aab5849aRafael J. Wysocki
8961da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds	dev = get_device(dev);
897c906a48adc74fc455378137ac5124b13e7030a15Greg Kroah-Hartman	if (!dev)
898c906a48adc74fc455378137ac5124b13e7030a15Greg Kroah-Hartman		goto done;
899c906a48adc74fc455378137ac5124b13e7030a15Greg Kroah-Hartman
900fb069a5d132fb926ed17af3211a114ac7cf27d7aGreg Kroah-Hartman	if (!dev->p) {
901b4028437876866aba4747a655ede00f892089e14Greg Kroah-Hartman		error = device_private_init(dev);
902b4028437876866aba4747a655ede00f892089e14Greg Kroah-Hartman		if (error)
903b4028437876866aba4747a655ede00f892089e14Greg Kroah-Hartman			goto done;
904fb069a5d132fb926ed17af3211a114ac7cf27d7aGreg Kroah-Hartman	}
905fb069a5d132fb926ed17af3211a114ac7cf27d7aGreg Kroah-Hartman
9061fa5ae857bb14f6046205171d98506d8112dd74eKay Sievers	/*
9071fa5ae857bb14f6046205171d98506d8112dd74eKay Sievers	 * for statically allocated devices, which should all be converted
9081fa5ae857bb14f6046205171d98506d8112dd74eKay Sievers	 * some day, we need to initialize the name. We prevent reading back
9091fa5ae857bb14f6046205171d98506d8112dd74eKay Sievers	 * the name, and force the use of dev_name()
9101fa5ae857bb14f6046205171d98506d8112dd74eKay Sievers	 */
9111fa5ae857bb14f6046205171d98506d8112dd74eKay Sievers	if (dev->init_name) {
912acc0e90fbccbc6e4d48184cba0983ea044e131afGreg Kroah-Hartman		dev_set_name(dev, "%s", dev->init_name);
9131fa5ae857bb14f6046205171d98506d8112dd74eKay Sievers		dev->init_name = NULL;
9141fa5ae857bb14f6046205171d98506d8112dd74eKay Sievers	}
915c906a48adc74fc455378137ac5124b13e7030a15Greg Kroah-Hartman
916e6309e7568d4b9d62298a887b10de42df11cb8c1Thomas Gleixner	if (!dev_name(dev)) {
917e6309e7568d4b9d62298a887b10de42df11cb8c1Thomas Gleixner		error = -EINVAL;
9185c8563d773c0e9f0ac2a552e84806decd98ce732Kay Sievers		goto name_error;
919e6309e7568d4b9d62298a887b10de42df11cb8c1Thomas Gleixner	}
9201da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds
9211e0b2cf933ebf32494eba3f668859ba57f06a951Kay Sievers	pr_debug("device: '%s': %s\n", dev_name(dev), __func__);
922c205ef4880273d2de4ee5388d4e52227ff688cc4Greg Kroah-Hartman
9231da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds	parent = get_device(dev->parent);
92463b6971a0876b744e2fcf3c9df15d130501e1debCornelia Huck	setup_parent(dev, parent);
9251da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds
9260d358f22f6c8f03ab215eee8d52b74f78cc3c7dbYinghai Lu	/* use parent numa_node */
9270d358f22f6c8f03ab215eee8d52b74f78cc3c7dbYinghai Lu	if (parent)
9280d358f22f6c8f03ab215eee8d52b74f78cc3c7dbYinghai Lu		set_dev_node(dev, dev_to_node(parent));
9290d358f22f6c8f03ab215eee8d52b74f78cc3c7dbYinghai Lu
9301da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds	/* first, register with generic layer. */
9318a577ffc75d9194fe8cdb7479236f2081c26ca1fKay Sievers	/* we require the name to be set before, and pass NULL */
9328a577ffc75d9194fe8cdb7479236f2081c26ca1fKay Sievers	error = kobject_add(&dev->kobj, dev->kobj.parent, NULL);
93340fa54226f518a9bc97ed1d711c0016e416e3782Greg Kroah-Hartman	if (error)
9341da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds		goto Error;
935a7fd67062efc5b0fc9a61368c607fa92d1d57f9eKay Sievers
936370226449ced358e52d198081120826ef52c166bBrian Walsh	/* notify platform of device entry */
937370226449ced358e52d198081120826ef52c166bBrian Walsh	if (platform_notify)
938370226449ced358e52d198081120826ef52c166bBrian Walsh		platform_notify(dev);
939370226449ced358e52d198081120826ef52c166bBrian Walsh
940ad6a1e1c66009ba9dcd2f5c90ffa1fb4ce72fce0Tejun Heo	error = device_create_file(dev, &uevent_attr);
941a306eea40952e6365301e8a2f7d5ffa9c6a1921bCornelia Huck	if (error)
942a306eea40952e6365301e8a2f7d5ffa9c6a1921bCornelia Huck		goto attrError;
943a7fd67062efc5b0fc9a61368c607fa92d1d57f9eKay Sievers
94423681e479129854305da1da32f7f1eaf635ef22cGreg Kroah-Hartman	if (MAJOR(dev->devt)) {
945ad6a1e1c66009ba9dcd2f5c90ffa1fb4ce72fce0Tejun Heo		error = device_create_file(dev, &devt_attr);
946ad6a1e1c66009ba9dcd2f5c90ffa1fb4ce72fce0Tejun Heo		if (error)
947a306eea40952e6365301e8a2f7d5ffa9c6a1921bCornelia Huck			goto ueventattrError;
948e105b8bfc769b0545b6f0f395179d1e43cbee822Dan Williams
949e105b8bfc769b0545b6f0f395179d1e43cbee822Dan Williams		error = device_create_sys_dev_entry(dev);
950e105b8bfc769b0545b6f0f395179d1e43cbee822Dan Williams		if (error)
951e105b8bfc769b0545b6f0f395179d1e43cbee822Dan Williams			goto devtattrError;
9522b2af54a5bb6f7e80ccf78f20084b93c398c3a8bKay Sievers
9532b2af54a5bb6f7e80ccf78f20084b93c398c3a8bKay Sievers		devtmpfs_create_node(dev);
95423681e479129854305da1da32f7f1eaf635ef22cGreg Kroah-Hartman	}
95523681e479129854305da1da32f7f1eaf635ef22cGreg Kroah-Hartman
9562ee97caf0a6602f749ddbfdb1449e383e1212707Cornelia Huck	error = device_add_class_symlinks(dev);
9572ee97caf0a6602f749ddbfdb1449e383e1212707Cornelia Huck	if (error)
9582ee97caf0a6602f749ddbfdb1449e383e1212707Cornelia Huck		goto SymlinkError;
959dc0afa8388972a9ed7c2203cc46d8df1a4713f65Cornelia Huck	error = device_add_attrs(dev);
960dc0afa8388972a9ed7c2203cc46d8df1a4713f65Cornelia Huck	if (error)
9612620efef7029bb040430f50f0fc148f2d5e002adGreg Kroah-Hartman		goto AttrsError;
962dc0afa8388972a9ed7c2203cc46d8df1a4713f65Cornelia Huck	error = bus_add_device(dev);
963dc0afa8388972a9ed7c2203cc46d8df1a4713f65Cornelia Huck	if (error)
9641da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds		goto BusError;
9653b98aeaf3a75f544dc945694f4fcf6e1c4bab89dAlan Stern	error = dpm_sysfs_add(dev);
96657eee3d23e8833ca18708b374c648235691942baRafael J. Wysocki	if (error)
9673b98aeaf3a75f544dc945694f4fcf6e1c4bab89dAlan Stern		goto DPMError;
9683b98aeaf3a75f544dc945694f4fcf6e1c4bab89dAlan Stern	device_pm_add(dev);
969ec0676ee28528dc8dda13a93ee4b1f215a0c2f9dAlan Stern
970ec0676ee28528dc8dda13a93ee4b1f215a0c2f9dAlan Stern	/* Notify clients of device addition.  This call must come
971ec0676ee28528dc8dda13a93ee4b1f215a0c2f9dAlan Stern	 * after dpm_sysf_add() and before kobject_uevent().
972ec0676ee28528dc8dda13a93ee4b1f215a0c2f9dAlan Stern	 */
973ec0676ee28528dc8dda13a93ee4b1f215a0c2f9dAlan Stern	if (dev->bus)
974ec0676ee28528dc8dda13a93ee4b1f215a0c2f9dAlan Stern		blocking_notifier_call_chain(&dev->bus->p->bus_notifier,
975ec0676ee28528dc8dda13a93ee4b1f215a0c2f9dAlan Stern					     BUS_NOTIFY_ADD_DEVICE, dev);
976ec0676ee28528dc8dda13a93ee4b1f215a0c2f9dAlan Stern
97783b5fb4cce13b9f7b218ed88ee05387c3f3bdda3Cornelia Huck	kobject_uevent(&dev->kobj, KOBJ_ADD);
9782023c610dc54a4f4130b0494309a9bd668ca3df8Alan Stern	bus_probe_device(dev);
9791da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds	if (parent)
980f791b8c836307b58cbf62133a6a772ed1a92fb33Greg Kroah-Hartman		klist_add_tail(&dev->p->knode_parent,
981f791b8c836307b58cbf62133a6a772ed1a92fb33Greg Kroah-Hartman			       &parent->p->klist_children);
9821da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds
9835d9fd169c9fbdaecdc430431e59bf94ff40b93d3Greg Kroah-Hartman	if (dev->class) {
984f75b1c60fc1e53c4004a79ea0be071aa3318cdccDave Young		mutex_lock(&dev->class->p->class_mutex);
985c47ed219ba81632595e9f02e27318151fec16c9eGreg Kroah-Hartman		/* tie the class to the device */
9865a3ceb861663040f9ef0176df4aaa494bba5e352Tejun Heo		klist_add_tail(&dev->knode_class,
9875a3ceb861663040f9ef0176df4aaa494bba5e352Tejun Heo			       &dev->class->p->class_devices);
988c47ed219ba81632595e9f02e27318151fec16c9eGreg Kroah-Hartman
989c47ed219ba81632595e9f02e27318151fec16c9eGreg Kroah-Hartman		/* notify any interfaces that the device is here */
990184f1f779d5a2e62de4a0b34842ddf8546beca8fGreg Kroah-Hartman		list_for_each_entry(class_intf,
991184f1f779d5a2e62de4a0b34842ddf8546beca8fGreg Kroah-Hartman				    &dev->class->p->class_interfaces, node)
992c47ed219ba81632595e9f02e27318151fec16c9eGreg Kroah-Hartman			if (class_intf->add_dev)
993c47ed219ba81632595e9f02e27318151fec16c9eGreg Kroah-Hartman				class_intf->add_dev(dev, class_intf);
994f75b1c60fc1e53c4004a79ea0be071aa3318cdccDave Young		mutex_unlock(&dev->class->p->class_mutex);
9955d9fd169c9fbdaecdc430431e59bf94ff40b93d3Greg Kroah-Hartman	}
996c906a48adc74fc455378137ac5124b13e7030a15Greg Kroah-Hartmandone:
9971da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds	put_device(dev);
9981da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds	return error;
9993b98aeaf3a75f544dc945694f4fcf6e1c4bab89dAlan Stern DPMError:
100057eee3d23e8833ca18708b374c648235691942baRafael J. Wysocki	bus_remove_device(dev);
100157eee3d23e8833ca18708b374c648235691942baRafael J. Wysocki BusError:
100282f0cf9b7c42684c29189ddb6d0bc86eb1137fc4James Simmons	device_remove_attrs(dev);
10032620efef7029bb040430f50f0fc148f2d5e002adGreg Kroah-Hartman AttrsError:
10042ee97caf0a6602f749ddbfdb1449e383e1212707Cornelia Huck	device_remove_class_symlinks(dev);
10052ee97caf0a6602f749ddbfdb1449e383e1212707Cornelia Huck SymlinkError:
1006ad6a1e1c66009ba9dcd2f5c90ffa1fb4ce72fce0Tejun Heo	if (MAJOR(dev->devt))
1007ad72956df2ce83f58be1dc4e503c78c28e414c2cKay Sievers		devtmpfs_delete_node(dev);
1008ad72956df2ce83f58be1dc4e503c78c28e414c2cKay Sievers	if (MAJOR(dev->devt))
1009e105b8bfc769b0545b6f0f395179d1e43cbee822Dan Williams		device_remove_sys_dev_entry(dev);
1010e105b8bfc769b0545b6f0f395179d1e43cbee822Dan Williams devtattrError:
1011e105b8bfc769b0545b6f0f395179d1e43cbee822Dan Williams	if (MAJOR(dev->devt))
1012ad6a1e1c66009ba9dcd2f5c90ffa1fb4ce72fce0Tejun Heo		device_remove_file(dev, &devt_attr);
1013a306eea40952e6365301e8a2f7d5ffa9c6a1921bCornelia Huck ueventattrError:
1014ad6a1e1c66009ba9dcd2f5c90ffa1fb4ce72fce0Tejun Heo	device_remove_file(dev, &uevent_attr);
101523681e479129854305da1da32f7f1eaf635ef22cGreg Kroah-Hartman attrError:
1016312c004d36ce6c739512bac83b452f4c20ab1f62Kay Sievers	kobject_uevent(&dev->kobj, KOBJ_REMOVE);
10171da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds	kobject_del(&dev->kobj);
10181da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds Error:
101963b6971a0876b744e2fcf3c9df15d130501e1debCornelia Huck	cleanup_device_parent(dev);
10201da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds	if (parent)
10211da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds		put_device(parent);
10225c8563d773c0e9f0ac2a552e84806decd98ce732Kay Sieversname_error:
10235c8563d773c0e9f0ac2a552e84806decd98ce732Kay Sievers	kfree(dev->p);
10245c8563d773c0e9f0ac2a552e84806decd98ce732Kay Sievers	dev->p = NULL;
1025c906a48adc74fc455378137ac5124b13e7030a15Greg Kroah-Hartman	goto done;
10261da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds}
10271da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds
10281da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds/**
10294a3ad20ccd8f4d2a0535cf98fa83f7b561ba59a9Greg Kroah-Hartman * device_register - register a device with the system.
10304a3ad20ccd8f4d2a0535cf98fa83f7b561ba59a9Greg Kroah-Hartman * @dev: pointer to the device structure
10311da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds *
10324a3ad20ccd8f4d2a0535cf98fa83f7b561ba59a9Greg Kroah-Hartman * This happens in two clean steps - initialize the device
10334a3ad20ccd8f4d2a0535cf98fa83f7b561ba59a9Greg Kroah-Hartman * and add it to the system. The two steps can be called
10344a3ad20ccd8f4d2a0535cf98fa83f7b561ba59a9Greg Kroah-Hartman * separately, but this is the easiest and most common.
10354a3ad20ccd8f4d2a0535cf98fa83f7b561ba59a9Greg Kroah-Hartman * I.e. you should only call the two helpers separately if
10364a3ad20ccd8f4d2a0535cf98fa83f7b561ba59a9Greg Kroah-Hartman * have a clearly defined need to use and refcount the device
10374a3ad20ccd8f4d2a0535cf98fa83f7b561ba59a9Greg Kroah-Hartman * before it is added to the hierarchy.
10385739411acbaa63a6c22c91e340fdcdbcc7d82a51Cornelia Huck *
10395739411acbaa63a6c22c91e340fdcdbcc7d82a51Cornelia Huck * NOTE: _Never_ directly free @dev after calling this function, even
10405739411acbaa63a6c22c91e340fdcdbcc7d82a51Cornelia Huck * if it returned an error! Always use put_device() to give up the
10415739411acbaa63a6c22c91e340fdcdbcc7d82a51Cornelia Huck * reference initialized in this function instead.
10421da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds */
10431da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvaldsint device_register(struct device *dev)
10441da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds{
10451da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds	device_initialize(dev);
10461da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds	return device_add(dev);
10471da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds}
10481da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds
10491da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds/**
10504a3ad20ccd8f4d2a0535cf98fa83f7b561ba59a9Greg Kroah-Hartman * get_device - increment reference count for device.
10514a3ad20ccd8f4d2a0535cf98fa83f7b561ba59a9Greg Kroah-Hartman * @dev: device.
10521da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds *
10534a3ad20ccd8f4d2a0535cf98fa83f7b561ba59a9Greg Kroah-Hartman * This simply forwards the call to kobject_get(), though
10544a3ad20ccd8f4d2a0535cf98fa83f7b561ba59a9Greg Kroah-Hartman * we do take care to provide for the case that we get a NULL
10554a3ad20ccd8f4d2a0535cf98fa83f7b561ba59a9Greg Kroah-Hartman * pointer passed in.
10561da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds */
10574a3ad20ccd8f4d2a0535cf98fa83f7b561ba59a9Greg Kroah-Hartmanstruct device *get_device(struct device *dev)
10581da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds{
10591da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds	return dev ? to_dev(kobject_get(&dev->kobj)) : NULL;
10601da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds}
10611da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds
10621da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds/**
10634a3ad20ccd8f4d2a0535cf98fa83f7b561ba59a9Greg Kroah-Hartman * put_device - decrement reference count.
10644a3ad20ccd8f4d2a0535cf98fa83f7b561ba59a9Greg Kroah-Hartman * @dev: device in question.
10651da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds */
10664a3ad20ccd8f4d2a0535cf98fa83f7b561ba59a9Greg Kroah-Hartmanvoid put_device(struct device *dev)
10671da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds{
1068edfaa7c36574f1bf09c65ad602412db9da5f96bfKay Sievers	/* might_sleep(); */
10691da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds	if (dev)
10701da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds		kobject_put(&dev->kobj);
10711da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds}
10721da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds
10731da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds/**
10744a3ad20ccd8f4d2a0535cf98fa83f7b561ba59a9Greg Kroah-Hartman * device_del - delete device from system.
10754a3ad20ccd8f4d2a0535cf98fa83f7b561ba59a9Greg Kroah-Hartman * @dev: device.
10761da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds *
10774a3ad20ccd8f4d2a0535cf98fa83f7b561ba59a9Greg Kroah-Hartman * This is the first part of the device unregistration
10784a3ad20ccd8f4d2a0535cf98fa83f7b561ba59a9Greg Kroah-Hartman * sequence. This removes the device from the lists we control
10794a3ad20ccd8f4d2a0535cf98fa83f7b561ba59a9Greg Kroah-Hartman * from here, has it removed from the other driver model
10804a3ad20ccd8f4d2a0535cf98fa83f7b561ba59a9Greg Kroah-Hartman * subsystems it was added to in device_add(), and removes it
10814a3ad20ccd8f4d2a0535cf98fa83f7b561ba59a9Greg Kroah-Hartman * from the kobject hierarchy.
10821da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds *
10834a3ad20ccd8f4d2a0535cf98fa83f7b561ba59a9Greg Kroah-Hartman * NOTE: this should be called manually _iff_ device_add() was
10844a3ad20ccd8f4d2a0535cf98fa83f7b561ba59a9Greg Kroah-Hartman * also called manually.
10851da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds */
10864a3ad20ccd8f4d2a0535cf98fa83f7b561ba59a9Greg Kroah-Hartmanvoid device_del(struct device *dev)
10871da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds{
10884a3ad20ccd8f4d2a0535cf98fa83f7b561ba59a9Greg Kroah-Hartman	struct device *parent = dev->parent;
1089c47ed219ba81632595e9f02e27318151fec16c9eGreg Kroah-Hartman	struct class_interface *class_intf;
10901da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds
1091ec0676ee28528dc8dda13a93ee4b1f215a0c2f9dAlan Stern	/* Notify clients of device removal.  This call must come
1092ec0676ee28528dc8dda13a93ee4b1f215a0c2f9dAlan Stern	 * before dpm_sysfs_remove().
1093ec0676ee28528dc8dda13a93ee4b1f215a0c2f9dAlan Stern	 */
1094ec0676ee28528dc8dda13a93ee4b1f215a0c2f9dAlan Stern	if (dev->bus)
1095ec0676ee28528dc8dda13a93ee4b1f215a0c2f9dAlan Stern		blocking_notifier_call_chain(&dev->bus->p->bus_notifier,
1096ec0676ee28528dc8dda13a93ee4b1f215a0c2f9dAlan Stern					     BUS_NOTIFY_DEL_DEVICE, dev);
1097775b64d2b6ca37697de925f70799c710aab5849aRafael J. Wysocki	device_pm_remove(dev);
10983b98aeaf3a75f544dc945694f4fcf6e1c4bab89dAlan Stern	dpm_sysfs_remove(dev);
10991da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds	if (parent)
1100f791b8c836307b58cbf62133a6a772ed1a92fb33Greg Kroah-Hartman		klist_del(&dev->p->knode_parent);
1101e105b8bfc769b0545b6f0f395179d1e43cbee822Dan Williams	if (MAJOR(dev->devt)) {
11022b2af54a5bb6f7e80ccf78f20084b93c398c3a8bKay Sievers		devtmpfs_delete_node(dev);
1103e105b8bfc769b0545b6f0f395179d1e43cbee822Dan Williams		device_remove_sys_dev_entry(dev);
1104ad6a1e1c66009ba9dcd2f5c90ffa1fb4ce72fce0Tejun Heo		device_remove_file(dev, &devt_attr);
1105e105b8bfc769b0545b6f0f395179d1e43cbee822Dan Williams	}
1106b9d9c82b4d081feb464f62dfc786c8621d09ecd2Kay Sievers	if (dev->class) {
1107da231fd5d113ab6da5dab7a2d2c38d0a540f939cKay Sievers		device_remove_class_symlinks(dev);
110899ef3ef8d5f2f5b5312627127ad63df27c0d0d05Kay Sievers
1109f75b1c60fc1e53c4004a79ea0be071aa3318cdccDave Young		mutex_lock(&dev->class->p->class_mutex);
1110c47ed219ba81632595e9f02e27318151fec16c9eGreg Kroah-Hartman		/* notify any interfaces that the device is now gone */
1111184f1f779d5a2e62de4a0b34842ddf8546beca8fGreg Kroah-Hartman		list_for_each_entry(class_intf,
1112184f1f779d5a2e62de4a0b34842ddf8546beca8fGreg Kroah-Hartman				    &dev->class->p->class_interfaces, node)
1113c47ed219ba81632595e9f02e27318151fec16c9eGreg Kroah-Hartman			if (class_intf->remove_dev)
1114c47ed219ba81632595e9f02e27318151fec16c9eGreg Kroah-Hartman				class_intf->remove_dev(dev, class_intf);
1115c47ed219ba81632595e9f02e27318151fec16c9eGreg Kroah-Hartman		/* remove the device from the class list */
11165a3ceb861663040f9ef0176df4aaa494bba5e352Tejun Heo		klist_del(&dev->knode_class);
1117f75b1c60fc1e53c4004a79ea0be071aa3318cdccDave Young		mutex_unlock(&dev->class->p->class_mutex);
1118b9d9c82b4d081feb464f62dfc786c8621d09ecd2Kay Sievers	}
1119ad6a1e1c66009ba9dcd2f5c90ffa1fb4ce72fce0Tejun Heo	device_remove_file(dev, &uevent_attr);
11202620efef7029bb040430f50f0fc148f2d5e002adGreg Kroah-Hartman	device_remove_attrs(dev);
1121289535334646796fe41f199718e4a731f7411a92Benjamin Herrenschmidt	bus_remove_device(dev);
11221da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds
11232f8d16a996da0b9be2536994aa7a825418364471Tejun Heo	/*
11242f8d16a996da0b9be2536994aa7a825418364471Tejun Heo	 * Some platform devices are driven without driver attached
11252f8d16a996da0b9be2536994aa7a825418364471Tejun Heo	 * and managed resources may have been acquired.  Make sure
11262f8d16a996da0b9be2536994aa7a825418364471Tejun Heo	 * all resources are released.
11272f8d16a996da0b9be2536994aa7a825418364471Tejun Heo	 */
11282f8d16a996da0b9be2536994aa7a825418364471Tejun Heo	devres_release_all(dev);
11292f8d16a996da0b9be2536994aa7a825418364471Tejun Heo
11301da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds	/* Notify the platform of the removal, in case they
11311da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds	 * need to do anything...
11321da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds	 */
11331da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds	if (platform_notify_remove)
11341da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds		platform_notify_remove(dev);
1135312c004d36ce6c739512bac83b452f4c20ab1f62Kay Sievers	kobject_uevent(&dev->kobj, KOBJ_REMOVE);
1136da231fd5d113ab6da5dab7a2d2c38d0a540f939cKay Sievers	cleanup_device_parent(dev);
11371da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds	kobject_del(&dev->kobj);
1138da231fd5d113ab6da5dab7a2d2c38d0a540f939cKay Sievers	put_device(parent);
11391da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds}
11401da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds
11411da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds/**
11424a3ad20ccd8f4d2a0535cf98fa83f7b561ba59a9Greg Kroah-Hartman * device_unregister - unregister device from system.
11434a3ad20ccd8f4d2a0535cf98fa83f7b561ba59a9Greg Kroah-Hartman * @dev: device going away.
11441da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds *
11454a3ad20ccd8f4d2a0535cf98fa83f7b561ba59a9Greg Kroah-Hartman * We do this in two parts, like we do device_register(). First,
11464a3ad20ccd8f4d2a0535cf98fa83f7b561ba59a9Greg Kroah-Hartman * we remove it from all the subsystems with device_del(), then
11474a3ad20ccd8f4d2a0535cf98fa83f7b561ba59a9Greg Kroah-Hartman * we decrement the reference count via put_device(). If that
11484a3ad20ccd8f4d2a0535cf98fa83f7b561ba59a9Greg Kroah-Hartman * is the final reference count, the device will be cleaned up
11494a3ad20ccd8f4d2a0535cf98fa83f7b561ba59a9Greg Kroah-Hartman * via device_release() above. Otherwise, the structure will
11504a3ad20ccd8f4d2a0535cf98fa83f7b561ba59a9Greg Kroah-Hartman * stick around until the final reference to the device is dropped.
11511da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds */
11524a3ad20ccd8f4d2a0535cf98fa83f7b561ba59a9Greg Kroah-Hartmanvoid device_unregister(struct device *dev)
11531da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds{
11541e0b2cf933ebf32494eba3f668859ba57f06a951Kay Sievers	pr_debug("device: '%s': %s\n", dev_name(dev), __func__);
11551da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds	device_del(dev);
11561da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds	put_device(dev);
11571da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds}
11581da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds
11594a3ad20ccd8f4d2a0535cf98fa83f7b561ba59a9Greg Kroah-Hartmanstatic struct device *next_device(struct klist_iter *i)
116036239577cfb6b9a7c111209536b54200b0252ebfPatrick Mochel{
11614a3ad20ccd8f4d2a0535cf98fa83f7b561ba59a9Greg Kroah-Hartman	struct klist_node *n = klist_next(i);
1162f791b8c836307b58cbf62133a6a772ed1a92fb33Greg Kroah-Hartman	struct device *dev = NULL;
1163f791b8c836307b58cbf62133a6a772ed1a92fb33Greg Kroah-Hartman	struct device_private *p;
1164f791b8c836307b58cbf62133a6a772ed1a92fb33Greg Kroah-Hartman
1165f791b8c836307b58cbf62133a6a772ed1a92fb33Greg Kroah-Hartman	if (n) {
1166f791b8c836307b58cbf62133a6a772ed1a92fb33Greg Kroah-Hartman		p = to_device_private_parent(n);
1167f791b8c836307b58cbf62133a6a772ed1a92fb33Greg Kroah-Hartman		dev = p->device;
1168f791b8c836307b58cbf62133a6a772ed1a92fb33Greg Kroah-Hartman	}
1169f791b8c836307b58cbf62133a6a772ed1a92fb33Greg Kroah-Hartman	return dev;
117036239577cfb6b9a7c111209536b54200b0252ebfPatrick Mochel}
117136239577cfb6b9a7c111209536b54200b0252ebfPatrick Mochel
11721da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds/**
1173e454cea20bdcff10ee698d11b8882662a0153a47Kay Sievers * device_get_devnode - path of device node file
11746fcf53acccf85b4b0d0260e66c692a341760f464Kay Sievers * @dev: device
1175e454cea20bdcff10ee698d11b8882662a0153a47Kay Sievers * @mode: returned file access mode
11766fcf53acccf85b4b0d0260e66c692a341760f464Kay Sievers * @tmp: possibly allocated string
11776fcf53acccf85b4b0d0260e66c692a341760f464Kay Sievers *
11786fcf53acccf85b4b0d0260e66c692a341760f464Kay Sievers * Return the relative path of a possible device node.
11796fcf53acccf85b4b0d0260e66c692a341760f464Kay Sievers * Non-default names may need to allocate a memory to compose
11806fcf53acccf85b4b0d0260e66c692a341760f464Kay Sievers * a name. This memory is returned in tmp and needs to be
11816fcf53acccf85b4b0d0260e66c692a341760f464Kay Sievers * freed by the caller.
11826fcf53acccf85b4b0d0260e66c692a341760f464Kay Sievers */
1183e454cea20bdcff10ee698d11b8882662a0153a47Kay Sieversconst char *device_get_devnode(struct device *dev,
1184e454cea20bdcff10ee698d11b8882662a0153a47Kay Sievers			       mode_t *mode, const char **tmp)
11856fcf53acccf85b4b0d0260e66c692a341760f464Kay Sievers{
11866fcf53acccf85b4b0d0260e66c692a341760f464Kay Sievers	char *s;
11876fcf53acccf85b4b0d0260e66c692a341760f464Kay Sievers
11886fcf53acccf85b4b0d0260e66c692a341760f464Kay Sievers	*tmp = NULL;
11896fcf53acccf85b4b0d0260e66c692a341760f464Kay Sievers
11906fcf53acccf85b4b0d0260e66c692a341760f464Kay Sievers	/* the device type may provide a specific name */
1191e454cea20bdcff10ee698d11b8882662a0153a47Kay Sievers	if (dev->type && dev->type->devnode)
1192e454cea20bdcff10ee698d11b8882662a0153a47Kay Sievers		*tmp = dev->type->devnode(dev, mode);
11936fcf53acccf85b4b0d0260e66c692a341760f464Kay Sievers	if (*tmp)
11946fcf53acccf85b4b0d0260e66c692a341760f464Kay Sievers		return *tmp;
11956fcf53acccf85b4b0d0260e66c692a341760f464Kay Sievers
11966fcf53acccf85b4b0d0260e66c692a341760f464Kay Sievers	/* the class may provide a specific name */
1197e454cea20bdcff10ee698d11b8882662a0153a47Kay Sievers	if (dev->class && dev->class->devnode)
1198e454cea20bdcff10ee698d11b8882662a0153a47Kay Sievers		*tmp = dev->class->devnode(dev, mode);
11996fcf53acccf85b4b0d0260e66c692a341760f464Kay Sievers	if (*tmp)
12006fcf53acccf85b4b0d0260e66c692a341760f464Kay Sievers		return *tmp;
12016fcf53acccf85b4b0d0260e66c692a341760f464Kay Sievers
12026fcf53acccf85b4b0d0260e66c692a341760f464Kay Sievers	/* return name without allocation, tmp == NULL */
12036fcf53acccf85b4b0d0260e66c692a341760f464Kay Sievers	if (strchr(dev_name(dev), '!') == NULL)
12046fcf53acccf85b4b0d0260e66c692a341760f464Kay Sievers		return dev_name(dev);
12056fcf53acccf85b4b0d0260e66c692a341760f464Kay Sievers
12066fcf53acccf85b4b0d0260e66c692a341760f464Kay Sievers	/* replace '!' in the name with '/' */
12076fcf53acccf85b4b0d0260e66c692a341760f464Kay Sievers	*tmp = kstrdup(dev_name(dev), GFP_KERNEL);
12086fcf53acccf85b4b0d0260e66c692a341760f464Kay Sievers	if (!*tmp)
12096fcf53acccf85b4b0d0260e66c692a341760f464Kay Sievers		return NULL;
12106fcf53acccf85b4b0d0260e66c692a341760f464Kay Sievers	while ((s = strchr(*tmp, '!')))
12116fcf53acccf85b4b0d0260e66c692a341760f464Kay Sievers		s[0] = '/';
12126fcf53acccf85b4b0d0260e66c692a341760f464Kay Sievers	return *tmp;
12136fcf53acccf85b4b0d0260e66c692a341760f464Kay Sievers}
12146fcf53acccf85b4b0d0260e66c692a341760f464Kay Sievers
12156fcf53acccf85b4b0d0260e66c692a341760f464Kay Sievers/**
12164a3ad20ccd8f4d2a0535cf98fa83f7b561ba59a9Greg Kroah-Hartman * device_for_each_child - device child iterator.
12174a3ad20ccd8f4d2a0535cf98fa83f7b561ba59a9Greg Kroah-Hartman * @parent: parent struct device.
12184a3ad20ccd8f4d2a0535cf98fa83f7b561ba59a9Greg Kroah-Hartman * @data: data for the callback.
12194a3ad20ccd8f4d2a0535cf98fa83f7b561ba59a9Greg Kroah-Hartman * @fn: function to be called for each device.
12201da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds *
12214a3ad20ccd8f4d2a0535cf98fa83f7b561ba59a9Greg Kroah-Hartman * Iterate over @parent's child devices, and call @fn for each,
12224a3ad20ccd8f4d2a0535cf98fa83f7b561ba59a9Greg Kroah-Hartman * passing it @data.
12231da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds *
12244a3ad20ccd8f4d2a0535cf98fa83f7b561ba59a9Greg Kroah-Hartman * We check the return of @fn each time. If it returns anything
12254a3ad20ccd8f4d2a0535cf98fa83f7b561ba59a9Greg Kroah-Hartman * other than 0, we break out and return that value.
12261da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds */
12274a3ad20ccd8f4d2a0535cf98fa83f7b561ba59a9Greg Kroah-Hartmanint device_for_each_child(struct device *parent, void *data,
12284a3ad20ccd8f4d2a0535cf98fa83f7b561ba59a9Greg Kroah-Hartman			  int (*fn)(struct device *dev, void *data))
12291da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds{
123036239577cfb6b9a7c111209536b54200b0252ebfPatrick Mochel	struct klist_iter i;
12314a3ad20ccd8f4d2a0535cf98fa83f7b561ba59a9Greg Kroah-Hartman	struct device *child;
12321da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds	int error = 0;
12331da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds
1234014c90dbb9b63bae067afc80a7931a76c5268ae3Greg Kroah-Hartman	if (!parent->p)
1235014c90dbb9b63bae067afc80a7931a76c5268ae3Greg Kroah-Hartman		return 0;
1236014c90dbb9b63bae067afc80a7931a76c5268ae3Greg Kroah-Hartman
1237f791b8c836307b58cbf62133a6a772ed1a92fb33Greg Kroah-Hartman	klist_iter_init(&parent->p->klist_children, &i);
123836239577cfb6b9a7c111209536b54200b0252ebfPatrick Mochel	while ((child = next_device(&i)) && !error)
123936239577cfb6b9a7c111209536b54200b0252ebfPatrick Mochel		error = fn(child, data);
124036239577cfb6b9a7c111209536b54200b0252ebfPatrick Mochel	klist_iter_exit(&i);
12411da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds	return error;
12421da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds}
12431da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds
12445ab699810d46011ad2195c5916f3cbc684bfe3eeCornelia Huck/**
12455ab699810d46011ad2195c5916f3cbc684bfe3eeCornelia Huck * device_find_child - device iterator for locating a particular device.
12465ab699810d46011ad2195c5916f3cbc684bfe3eeCornelia Huck * @parent: parent struct device
12475ab699810d46011ad2195c5916f3cbc684bfe3eeCornelia Huck * @data: Data to pass to match function
12485ab699810d46011ad2195c5916f3cbc684bfe3eeCornelia Huck * @match: Callback function to check device
12495ab699810d46011ad2195c5916f3cbc684bfe3eeCornelia Huck *
12505ab699810d46011ad2195c5916f3cbc684bfe3eeCornelia Huck * This is similar to the device_for_each_child() function above, but it
12515ab699810d46011ad2195c5916f3cbc684bfe3eeCornelia Huck * returns a reference to a device that is 'found' for later use, as
12525ab699810d46011ad2195c5916f3cbc684bfe3eeCornelia Huck * determined by the @match callback.
12535ab699810d46011ad2195c5916f3cbc684bfe3eeCornelia Huck *
12545ab699810d46011ad2195c5916f3cbc684bfe3eeCornelia Huck * The callback should return 0 if the device doesn't match and non-zero
12555ab699810d46011ad2195c5916f3cbc684bfe3eeCornelia Huck * if it does.  If the callback returns non-zero and a reference to the
12565ab699810d46011ad2195c5916f3cbc684bfe3eeCornelia Huck * current device can be obtained, this function will return to the caller
12575ab699810d46011ad2195c5916f3cbc684bfe3eeCornelia Huck * and not iterate over any more devices.
12585ab699810d46011ad2195c5916f3cbc684bfe3eeCornelia Huck */
12594a3ad20ccd8f4d2a0535cf98fa83f7b561ba59a9Greg Kroah-Hartmanstruct device *device_find_child(struct device *parent, void *data,
12604a3ad20ccd8f4d2a0535cf98fa83f7b561ba59a9Greg Kroah-Hartman				 int (*match)(struct device *dev, void *data))
12615ab699810d46011ad2195c5916f3cbc684bfe3eeCornelia Huck{
12625ab699810d46011ad2195c5916f3cbc684bfe3eeCornelia Huck	struct klist_iter i;
12635ab699810d46011ad2195c5916f3cbc684bfe3eeCornelia Huck	struct device *child;
12645ab699810d46011ad2195c5916f3cbc684bfe3eeCornelia Huck
12655ab699810d46011ad2195c5916f3cbc684bfe3eeCornelia Huck	if (!parent)
12665ab699810d46011ad2195c5916f3cbc684bfe3eeCornelia Huck		return NULL;
12675ab699810d46011ad2195c5916f3cbc684bfe3eeCornelia Huck
1268f791b8c836307b58cbf62133a6a772ed1a92fb33Greg Kroah-Hartman	klist_iter_init(&parent->p->klist_children, &i);
12695ab699810d46011ad2195c5916f3cbc684bfe3eeCornelia Huck	while ((child = next_device(&i)))
12705ab699810d46011ad2195c5916f3cbc684bfe3eeCornelia Huck		if (match(child, data) && get_device(child))
12715ab699810d46011ad2195c5916f3cbc684bfe3eeCornelia Huck			break;
12725ab699810d46011ad2195c5916f3cbc684bfe3eeCornelia Huck	klist_iter_exit(&i);
12735ab699810d46011ad2195c5916f3cbc684bfe3eeCornelia Huck	return child;
12745ab699810d46011ad2195c5916f3cbc684bfe3eeCornelia Huck}
12755ab699810d46011ad2195c5916f3cbc684bfe3eeCornelia Huck
12761da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvaldsint __init devices_init(void)
12771da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds{
1278881c6cfd7c5edfe6129006e2404654bfe5911050Greg Kroah-Hartman	devices_kset = kset_create_and_add("devices", &device_uevent_ops, NULL);
1279881c6cfd7c5edfe6129006e2404654bfe5911050Greg Kroah-Hartman	if (!devices_kset)
1280881c6cfd7c5edfe6129006e2404654bfe5911050Greg Kroah-Hartman		return -ENOMEM;
1281e105b8bfc769b0545b6f0f395179d1e43cbee822Dan Williams	dev_kobj = kobject_create_and_add("dev", NULL);
1282e105b8bfc769b0545b6f0f395179d1e43cbee822Dan Williams	if (!dev_kobj)
1283e105b8bfc769b0545b6f0f395179d1e43cbee822Dan Williams		goto dev_kobj_err;
1284e105b8bfc769b0545b6f0f395179d1e43cbee822Dan Williams	sysfs_dev_block_kobj = kobject_create_and_add("block", dev_kobj);
1285e105b8bfc769b0545b6f0f395179d1e43cbee822Dan Williams	if (!sysfs_dev_block_kobj)
1286e105b8bfc769b0545b6f0f395179d1e43cbee822Dan Williams		goto block_kobj_err;
1287e105b8bfc769b0545b6f0f395179d1e43cbee822Dan Williams	sysfs_dev_char_kobj = kobject_create_and_add("char", dev_kobj);
1288e105b8bfc769b0545b6f0f395179d1e43cbee822Dan Williams	if (!sysfs_dev_char_kobj)
1289e105b8bfc769b0545b6f0f395179d1e43cbee822Dan Williams		goto char_kobj_err;
1290e105b8bfc769b0545b6f0f395179d1e43cbee822Dan Williams
1291881c6cfd7c5edfe6129006e2404654bfe5911050Greg Kroah-Hartman	return 0;
1292e105b8bfc769b0545b6f0f395179d1e43cbee822Dan Williams
1293e105b8bfc769b0545b6f0f395179d1e43cbee822Dan Williams char_kobj_err:
1294e105b8bfc769b0545b6f0f395179d1e43cbee822Dan Williams	kobject_put(sysfs_dev_block_kobj);
1295e105b8bfc769b0545b6f0f395179d1e43cbee822Dan Williams block_kobj_err:
1296e105b8bfc769b0545b6f0f395179d1e43cbee822Dan Williams	kobject_put(dev_kobj);
1297e105b8bfc769b0545b6f0f395179d1e43cbee822Dan Williams dev_kobj_err:
1298e105b8bfc769b0545b6f0f395179d1e43cbee822Dan Williams	kset_unregister(devices_kset);
1299e105b8bfc769b0545b6f0f395179d1e43cbee822Dan Williams	return -ENOMEM;
13001da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds}
13011da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds
13021da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus TorvaldsEXPORT_SYMBOL_GPL(device_for_each_child);
13035ab699810d46011ad2195c5916f3cbc684bfe3eeCornelia HuckEXPORT_SYMBOL_GPL(device_find_child);
13041da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds
13051da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus TorvaldsEXPORT_SYMBOL_GPL(device_initialize);
13061da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus TorvaldsEXPORT_SYMBOL_GPL(device_add);
13071da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus TorvaldsEXPORT_SYMBOL_GPL(device_register);
13081da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds
13091da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus TorvaldsEXPORT_SYMBOL_GPL(device_del);
13101da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus TorvaldsEXPORT_SYMBOL_GPL(device_unregister);
13111da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus TorvaldsEXPORT_SYMBOL_GPL(get_device);
13121da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus TorvaldsEXPORT_SYMBOL_GPL(put_device);
13131da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds
13141da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus TorvaldsEXPORT_SYMBOL_GPL(device_create_file);
13151da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus TorvaldsEXPORT_SYMBOL_GPL(device_remove_file);
131623681e479129854305da1da32f7f1eaf635ef22cGreg Kroah-Hartman
13170aa0dc41bfd993491c2344870eee7a3b218551fbMark McLoughlinstruct root_device
13180aa0dc41bfd993491c2344870eee7a3b218551fbMark McLoughlin{
13190aa0dc41bfd993491c2344870eee7a3b218551fbMark McLoughlin	struct device dev;
13200aa0dc41bfd993491c2344870eee7a3b218551fbMark McLoughlin	struct module *owner;
13210aa0dc41bfd993491c2344870eee7a3b218551fbMark McLoughlin};
13220aa0dc41bfd993491c2344870eee7a3b218551fbMark McLoughlin
13230aa0dc41bfd993491c2344870eee7a3b218551fbMark McLoughlin#define to_root_device(dev) container_of(dev, struct root_device, dev)
13240aa0dc41bfd993491c2344870eee7a3b218551fbMark McLoughlin
13250aa0dc41bfd993491c2344870eee7a3b218551fbMark McLoughlinstatic void root_device_release(struct device *dev)
13260aa0dc41bfd993491c2344870eee7a3b218551fbMark McLoughlin{
13270aa0dc41bfd993491c2344870eee7a3b218551fbMark McLoughlin	kfree(to_root_device(dev));
13280aa0dc41bfd993491c2344870eee7a3b218551fbMark McLoughlin}
13290aa0dc41bfd993491c2344870eee7a3b218551fbMark McLoughlin
13300aa0dc41bfd993491c2344870eee7a3b218551fbMark McLoughlin/**
13310aa0dc41bfd993491c2344870eee7a3b218551fbMark McLoughlin * __root_device_register - allocate and register a root device
13320aa0dc41bfd993491c2344870eee7a3b218551fbMark McLoughlin * @name: root device name
13330aa0dc41bfd993491c2344870eee7a3b218551fbMark McLoughlin * @owner: owner module of the root device, usually THIS_MODULE
13340aa0dc41bfd993491c2344870eee7a3b218551fbMark McLoughlin *
13350aa0dc41bfd993491c2344870eee7a3b218551fbMark McLoughlin * This function allocates a root device and registers it
13360aa0dc41bfd993491c2344870eee7a3b218551fbMark McLoughlin * using device_register(). In order to free the returned
13370aa0dc41bfd993491c2344870eee7a3b218551fbMark McLoughlin * device, use root_device_unregister().
13380aa0dc41bfd993491c2344870eee7a3b218551fbMark McLoughlin *
13390aa0dc41bfd993491c2344870eee7a3b218551fbMark McLoughlin * Root devices are dummy devices which allow other devices
13400aa0dc41bfd993491c2344870eee7a3b218551fbMark McLoughlin * to be grouped under /sys/devices. Use this function to
13410aa0dc41bfd993491c2344870eee7a3b218551fbMark McLoughlin * allocate a root device and then use it as the parent of
13420aa0dc41bfd993491c2344870eee7a3b218551fbMark McLoughlin * any device which should appear under /sys/devices/{name}
13430aa0dc41bfd993491c2344870eee7a3b218551fbMark McLoughlin *
13440aa0dc41bfd993491c2344870eee7a3b218551fbMark McLoughlin * The /sys/devices/{name} directory will also contain a
13450aa0dc41bfd993491c2344870eee7a3b218551fbMark McLoughlin * 'module' symlink which points to the @owner directory
13460aa0dc41bfd993491c2344870eee7a3b218551fbMark McLoughlin * in sysfs.
13470aa0dc41bfd993491c2344870eee7a3b218551fbMark McLoughlin *
1348f0eae0ed3b7d4182a6b4dd03540a738518ea3163Jani Nikula * Returns &struct device pointer on success, or ERR_PTR() on error.
1349f0eae0ed3b7d4182a6b4dd03540a738518ea3163Jani Nikula *
13500aa0dc41bfd993491c2344870eee7a3b218551fbMark McLoughlin * Note: You probably want to use root_device_register().
13510aa0dc41bfd993491c2344870eee7a3b218551fbMark McLoughlin */
13520aa0dc41bfd993491c2344870eee7a3b218551fbMark McLoughlinstruct device *__root_device_register(const char *name, struct module *owner)
13530aa0dc41bfd993491c2344870eee7a3b218551fbMark McLoughlin{
13540aa0dc41bfd993491c2344870eee7a3b218551fbMark McLoughlin	struct root_device *root;
13550aa0dc41bfd993491c2344870eee7a3b218551fbMark McLoughlin	int err = -ENOMEM;
13560aa0dc41bfd993491c2344870eee7a3b218551fbMark McLoughlin
13570aa0dc41bfd993491c2344870eee7a3b218551fbMark McLoughlin	root = kzalloc(sizeof(struct root_device), GFP_KERNEL);
13580aa0dc41bfd993491c2344870eee7a3b218551fbMark McLoughlin	if (!root)
13590aa0dc41bfd993491c2344870eee7a3b218551fbMark McLoughlin		return ERR_PTR(err);
13600aa0dc41bfd993491c2344870eee7a3b218551fbMark McLoughlin
1361acc0e90fbccbc6e4d48184cba0983ea044e131afGreg Kroah-Hartman	err = dev_set_name(&root->dev, "%s", name);
13620aa0dc41bfd993491c2344870eee7a3b218551fbMark McLoughlin	if (err) {
13630aa0dc41bfd993491c2344870eee7a3b218551fbMark McLoughlin		kfree(root);
13640aa0dc41bfd993491c2344870eee7a3b218551fbMark McLoughlin		return ERR_PTR(err);
13650aa0dc41bfd993491c2344870eee7a3b218551fbMark McLoughlin	}
13660aa0dc41bfd993491c2344870eee7a3b218551fbMark McLoughlin
13670aa0dc41bfd993491c2344870eee7a3b218551fbMark McLoughlin	root->dev.release = root_device_release;
13680aa0dc41bfd993491c2344870eee7a3b218551fbMark McLoughlin
13690aa0dc41bfd993491c2344870eee7a3b218551fbMark McLoughlin	err = device_register(&root->dev);
13700aa0dc41bfd993491c2344870eee7a3b218551fbMark McLoughlin	if (err) {
13710aa0dc41bfd993491c2344870eee7a3b218551fbMark McLoughlin		put_device(&root->dev);
13720aa0dc41bfd993491c2344870eee7a3b218551fbMark McLoughlin		return ERR_PTR(err);
13730aa0dc41bfd993491c2344870eee7a3b218551fbMark McLoughlin	}
13740aa0dc41bfd993491c2344870eee7a3b218551fbMark McLoughlin
13751d9e882ba4971f31473dd812da64909f30a6c242Christoph Egger#ifdef CONFIG_MODULES	/* gotta find a "cleaner" way to do this */
13760aa0dc41bfd993491c2344870eee7a3b218551fbMark McLoughlin	if (owner) {
13770aa0dc41bfd993491c2344870eee7a3b218551fbMark McLoughlin		struct module_kobject *mk = &owner->mkobj;
13780aa0dc41bfd993491c2344870eee7a3b218551fbMark McLoughlin
13790aa0dc41bfd993491c2344870eee7a3b218551fbMark McLoughlin		err = sysfs_create_link(&root->dev.kobj, &mk->kobj, "module");
13800aa0dc41bfd993491c2344870eee7a3b218551fbMark McLoughlin		if (err) {
13810aa0dc41bfd993491c2344870eee7a3b218551fbMark McLoughlin			device_unregister(&root->dev);
13820aa0dc41bfd993491c2344870eee7a3b218551fbMark McLoughlin			return ERR_PTR(err);
13830aa0dc41bfd993491c2344870eee7a3b218551fbMark McLoughlin		}
13840aa0dc41bfd993491c2344870eee7a3b218551fbMark McLoughlin		root->owner = owner;
13850aa0dc41bfd993491c2344870eee7a3b218551fbMark McLoughlin	}
13860aa0dc41bfd993491c2344870eee7a3b218551fbMark McLoughlin#endif
13870aa0dc41bfd993491c2344870eee7a3b218551fbMark McLoughlin
13880aa0dc41bfd993491c2344870eee7a3b218551fbMark McLoughlin	return &root->dev;
13890aa0dc41bfd993491c2344870eee7a3b218551fbMark McLoughlin}
13900aa0dc41bfd993491c2344870eee7a3b218551fbMark McLoughlinEXPORT_SYMBOL_GPL(__root_device_register);
13910aa0dc41bfd993491c2344870eee7a3b218551fbMark McLoughlin
13920aa0dc41bfd993491c2344870eee7a3b218551fbMark McLoughlin/**
13930aa0dc41bfd993491c2344870eee7a3b218551fbMark McLoughlin * root_device_unregister - unregister and free a root device
13947cbcf22548df1f1df7c6b0d0bda579b92efca63cRandy Dunlap * @dev: device going away
13950aa0dc41bfd993491c2344870eee7a3b218551fbMark McLoughlin *
13960aa0dc41bfd993491c2344870eee7a3b218551fbMark McLoughlin * This function unregisters and cleans up a device that was created by
13970aa0dc41bfd993491c2344870eee7a3b218551fbMark McLoughlin * root_device_register().
13980aa0dc41bfd993491c2344870eee7a3b218551fbMark McLoughlin */
13990aa0dc41bfd993491c2344870eee7a3b218551fbMark McLoughlinvoid root_device_unregister(struct device *dev)
14000aa0dc41bfd993491c2344870eee7a3b218551fbMark McLoughlin{
14010aa0dc41bfd993491c2344870eee7a3b218551fbMark McLoughlin	struct root_device *root = to_root_device(dev);
14020aa0dc41bfd993491c2344870eee7a3b218551fbMark McLoughlin
14030aa0dc41bfd993491c2344870eee7a3b218551fbMark McLoughlin	if (root->owner)
14040aa0dc41bfd993491c2344870eee7a3b218551fbMark McLoughlin		sysfs_remove_link(&root->dev.kobj, "module");
14050aa0dc41bfd993491c2344870eee7a3b218551fbMark McLoughlin
14060aa0dc41bfd993491c2344870eee7a3b218551fbMark McLoughlin	device_unregister(dev);
14070aa0dc41bfd993491c2344870eee7a3b218551fbMark McLoughlin}
14080aa0dc41bfd993491c2344870eee7a3b218551fbMark McLoughlinEXPORT_SYMBOL_GPL(root_device_unregister);
14090aa0dc41bfd993491c2344870eee7a3b218551fbMark McLoughlin
141023681e479129854305da1da32f7f1eaf635ef22cGreg Kroah-Hartman
141123681e479129854305da1da32f7f1eaf635ef22cGreg Kroah-Hartmanstatic void device_create_release(struct device *dev)
141223681e479129854305da1da32f7f1eaf635ef22cGreg Kroah-Hartman{
14131e0b2cf933ebf32494eba3f668859ba57f06a951Kay Sievers	pr_debug("device: '%s': %s\n", dev_name(dev), __func__);
141423681e479129854305da1da32f7f1eaf635ef22cGreg Kroah-Hartman	kfree(dev);
141523681e479129854305da1da32f7f1eaf635ef22cGreg Kroah-Hartman}
141623681e479129854305da1da32f7f1eaf635ef22cGreg Kroah-Hartman
141723681e479129854305da1da32f7f1eaf635ef22cGreg Kroah-Hartman/**
14188882b39421bae317e3ee864edd845e994307ce16Greg Kroah-Hartman * device_create_vargs - creates a device and registers it with sysfs
141942734dafa43e453a8b6769a5ebd3a01ffc1fd116Henrik Kretzschmar * @class: pointer to the struct class that this device should be registered to
142042734dafa43e453a8b6769a5ebd3a01ffc1fd116Henrik Kretzschmar * @parent: pointer to the parent struct device of this new device, if any
142142734dafa43e453a8b6769a5ebd3a01ffc1fd116Henrik Kretzschmar * @devt: the dev_t for the char device to be added
14228882b39421bae317e3ee864edd845e994307ce16Greg Kroah-Hartman * @drvdata: the data to be added to the device for callbacks
142342734dafa43e453a8b6769a5ebd3a01ffc1fd116Henrik Kretzschmar * @fmt: string for the device's name
14248882b39421bae317e3ee864edd845e994307ce16Greg Kroah-Hartman * @args: va_list for the device's name
142542734dafa43e453a8b6769a5ebd3a01ffc1fd116Henrik Kretzschmar *
142642734dafa43e453a8b6769a5ebd3a01ffc1fd116Henrik Kretzschmar * This function can be used by char device classes.  A struct device
142742734dafa43e453a8b6769a5ebd3a01ffc1fd116Henrik Kretzschmar * will be created in sysfs, registered to the specified class.
142823681e479129854305da1da32f7f1eaf635ef22cGreg Kroah-Hartman *
142923681e479129854305da1da32f7f1eaf635ef22cGreg Kroah-Hartman * A "dev" file will be created, showing the dev_t for the device, if
143023681e479129854305da1da32f7f1eaf635ef22cGreg Kroah-Hartman * the dev_t is not 0,0.
143142734dafa43e453a8b6769a5ebd3a01ffc1fd116Henrik Kretzschmar * If a pointer to a parent struct device is passed in, the newly created
143242734dafa43e453a8b6769a5ebd3a01ffc1fd116Henrik Kretzschmar * struct device will be a child of that device in sysfs.
143342734dafa43e453a8b6769a5ebd3a01ffc1fd116Henrik Kretzschmar * The pointer to the struct device will be returned from the call.
143442734dafa43e453a8b6769a5ebd3a01ffc1fd116Henrik Kretzschmar * Any further sysfs files that might be required can be created using this
143523681e479129854305da1da32f7f1eaf635ef22cGreg Kroah-Hartman * pointer.
143623681e479129854305da1da32f7f1eaf635ef22cGreg Kroah-Hartman *
1437f0eae0ed3b7d4182a6b4dd03540a738518ea3163Jani Nikula * Returns &struct device pointer on success, or ERR_PTR() on error.
1438f0eae0ed3b7d4182a6b4dd03540a738518ea3163Jani Nikula *
143923681e479129854305da1da32f7f1eaf635ef22cGreg Kroah-Hartman * Note: the struct class passed to this function must have previously
144023681e479129854305da1da32f7f1eaf635ef22cGreg Kroah-Hartman * been created with a call to class_create().
144123681e479129854305da1da32f7f1eaf635ef22cGreg Kroah-Hartman */
14428882b39421bae317e3ee864edd845e994307ce16Greg Kroah-Hartmanstruct device *device_create_vargs(struct class *class, struct device *parent,
14438882b39421bae317e3ee864edd845e994307ce16Greg Kroah-Hartman				   dev_t devt, void *drvdata, const char *fmt,
14448882b39421bae317e3ee864edd845e994307ce16Greg Kroah-Hartman				   va_list args)
144523681e479129854305da1da32f7f1eaf635ef22cGreg Kroah-Hartman{
144623681e479129854305da1da32f7f1eaf635ef22cGreg Kroah-Hartman	struct device *dev = NULL;
144723681e479129854305da1da32f7f1eaf635ef22cGreg Kroah-Hartman	int retval = -ENODEV;
144823681e479129854305da1da32f7f1eaf635ef22cGreg Kroah-Hartman
144923681e479129854305da1da32f7f1eaf635ef22cGreg Kroah-Hartman	if (class == NULL || IS_ERR(class))
145023681e479129854305da1da32f7f1eaf635ef22cGreg Kroah-Hartman		goto error;
145123681e479129854305da1da32f7f1eaf635ef22cGreg Kroah-Hartman
145223681e479129854305da1da32f7f1eaf635ef22cGreg Kroah-Hartman	dev = kzalloc(sizeof(*dev), GFP_KERNEL);
145323681e479129854305da1da32f7f1eaf635ef22cGreg Kroah-Hartman	if (!dev) {
145423681e479129854305da1da32f7f1eaf635ef22cGreg Kroah-Hartman		retval = -ENOMEM;
145523681e479129854305da1da32f7f1eaf635ef22cGreg Kroah-Hartman		goto error;
145623681e479129854305da1da32f7f1eaf635ef22cGreg Kroah-Hartman	}
145723681e479129854305da1da32f7f1eaf635ef22cGreg Kroah-Hartman
145823681e479129854305da1da32f7f1eaf635ef22cGreg Kroah-Hartman	dev->devt = devt;
145923681e479129854305da1da32f7f1eaf635ef22cGreg Kroah-Hartman	dev->class = class;
146023681e479129854305da1da32f7f1eaf635ef22cGreg Kroah-Hartman	dev->parent = parent;
146123681e479129854305da1da32f7f1eaf635ef22cGreg Kroah-Hartman	dev->release = device_create_release;
14628882b39421bae317e3ee864edd845e994307ce16Greg Kroah-Hartman	dev_set_drvdata(dev, drvdata);
146323681e479129854305da1da32f7f1eaf635ef22cGreg Kroah-Hartman
14641fa5ae857bb14f6046205171d98506d8112dd74eKay Sievers	retval = kobject_set_name_vargs(&dev->kobj, fmt, args);
14651fa5ae857bb14f6046205171d98506d8112dd74eKay Sievers	if (retval)
14661fa5ae857bb14f6046205171d98506d8112dd74eKay Sievers		goto error;
14671fa5ae857bb14f6046205171d98506d8112dd74eKay Sievers
146823681e479129854305da1da32f7f1eaf635ef22cGreg Kroah-Hartman	retval = device_register(dev);
146923681e479129854305da1da32f7f1eaf635ef22cGreg Kroah-Hartman	if (retval)
147023681e479129854305da1da32f7f1eaf635ef22cGreg Kroah-Hartman		goto error;
147123681e479129854305da1da32f7f1eaf635ef22cGreg Kroah-Hartman
147223681e479129854305da1da32f7f1eaf635ef22cGreg Kroah-Hartman	return dev;
147323681e479129854305da1da32f7f1eaf635ef22cGreg Kroah-Hartman
147423681e479129854305da1da32f7f1eaf635ef22cGreg Kroah-Hartmanerror:
1475286661b3777897220ecfcd774bccc68a34667f39Cornelia Huck	put_device(dev);
147623681e479129854305da1da32f7f1eaf635ef22cGreg Kroah-Hartman	return ERR_PTR(retval);
147723681e479129854305da1da32f7f1eaf635ef22cGreg Kroah-Hartman}
14788882b39421bae317e3ee864edd845e994307ce16Greg Kroah-HartmanEXPORT_SYMBOL_GPL(device_create_vargs);
14798882b39421bae317e3ee864edd845e994307ce16Greg Kroah-Hartman
14808882b39421bae317e3ee864edd845e994307ce16Greg Kroah-Hartman/**
14814e10673944a5c386378ff9d692ae37e19993f9d5Greg Kroah-Hartman * device_create - creates a device and registers it with sysfs
14828882b39421bae317e3ee864edd845e994307ce16Greg Kroah-Hartman * @class: pointer to the struct class that this device should be registered to
14838882b39421bae317e3ee864edd845e994307ce16Greg Kroah-Hartman * @parent: pointer to the parent struct device of this new device, if any
14848882b39421bae317e3ee864edd845e994307ce16Greg Kroah-Hartman * @devt: the dev_t for the char device to be added
14858882b39421bae317e3ee864edd845e994307ce16Greg Kroah-Hartman * @drvdata: the data to be added to the device for callbacks
14868882b39421bae317e3ee864edd845e994307ce16Greg Kroah-Hartman * @fmt: string for the device's name
14878882b39421bae317e3ee864edd845e994307ce16Greg Kroah-Hartman *
14888882b39421bae317e3ee864edd845e994307ce16Greg Kroah-Hartman * This function can be used by char device classes.  A struct device
14898882b39421bae317e3ee864edd845e994307ce16Greg Kroah-Hartman * will be created in sysfs, registered to the specified class.
14908882b39421bae317e3ee864edd845e994307ce16Greg Kroah-Hartman *
14918882b39421bae317e3ee864edd845e994307ce16Greg Kroah-Hartman * A "dev" file will be created, showing the dev_t for the device, if
14928882b39421bae317e3ee864edd845e994307ce16Greg Kroah-Hartman * the dev_t is not 0,0.
14938882b39421bae317e3ee864edd845e994307ce16Greg Kroah-Hartman * If a pointer to a parent struct device is passed in, the newly created
14948882b39421bae317e3ee864edd845e994307ce16Greg Kroah-Hartman * struct device will be a child of that device in sysfs.
14958882b39421bae317e3ee864edd845e994307ce16Greg Kroah-Hartman * The pointer to the struct device will be returned from the call.
14968882b39421bae317e3ee864edd845e994307ce16Greg Kroah-Hartman * Any further sysfs files that might be required can be created using this
14978882b39421bae317e3ee864edd845e994307ce16Greg Kroah-Hartman * pointer.
14988882b39421bae317e3ee864edd845e994307ce16Greg Kroah-Hartman *
1499f0eae0ed3b7d4182a6b4dd03540a738518ea3163Jani Nikula * Returns &struct device pointer on success, or ERR_PTR() on error.
1500f0eae0ed3b7d4182a6b4dd03540a738518ea3163Jani Nikula *
15018882b39421bae317e3ee864edd845e994307ce16Greg Kroah-Hartman * Note: the struct class passed to this function must have previously
15028882b39421bae317e3ee864edd845e994307ce16Greg Kroah-Hartman * been created with a call to class_create().
15038882b39421bae317e3ee864edd845e994307ce16Greg Kroah-Hartman */
15044e10673944a5c386378ff9d692ae37e19993f9d5Greg Kroah-Hartmanstruct device *device_create(struct class *class, struct device *parent,
15054e10673944a5c386378ff9d692ae37e19993f9d5Greg Kroah-Hartman			     dev_t devt, void *drvdata, const char *fmt, ...)
15068882b39421bae317e3ee864edd845e994307ce16Greg Kroah-Hartman{
15078882b39421bae317e3ee864edd845e994307ce16Greg Kroah-Hartman	va_list vargs;
15088882b39421bae317e3ee864edd845e994307ce16Greg Kroah-Hartman	struct device *dev;
15098882b39421bae317e3ee864edd845e994307ce16Greg Kroah-Hartman
15108882b39421bae317e3ee864edd845e994307ce16Greg Kroah-Hartman	va_start(vargs, fmt);
15118882b39421bae317e3ee864edd845e994307ce16Greg Kroah-Hartman	dev = device_create_vargs(class, parent, devt, drvdata, fmt, vargs);
15128882b39421bae317e3ee864edd845e994307ce16Greg Kroah-Hartman	va_end(vargs);
15138882b39421bae317e3ee864edd845e994307ce16Greg Kroah-Hartman	return dev;
15148882b39421bae317e3ee864edd845e994307ce16Greg Kroah-Hartman}
15154e10673944a5c386378ff9d692ae37e19993f9d5Greg Kroah-HartmanEXPORT_SYMBOL_GPL(device_create);
15168882b39421bae317e3ee864edd845e994307ce16Greg Kroah-Hartman
1517cd35449b93ac128282c1f1f720e84c5935f9018eDave Youngstatic int __match_devt(struct device *dev, void *data)
151823681e479129854305da1da32f7f1eaf635ef22cGreg Kroah-Hartman{
1519cd35449b93ac128282c1f1f720e84c5935f9018eDave Young	dev_t *devt = data;
152023681e479129854305da1da32f7f1eaf635ef22cGreg Kroah-Hartman
1521cd35449b93ac128282c1f1f720e84c5935f9018eDave Young	return dev->devt == *devt;
1522775b64d2b6ca37697de925f70799c710aab5849aRafael J. Wysocki}
1523775b64d2b6ca37697de925f70799c710aab5849aRafael J. Wysocki
1524775b64d2b6ca37697de925f70799c710aab5849aRafael J. Wysocki/**
1525775b64d2b6ca37697de925f70799c710aab5849aRafael J. Wysocki * device_destroy - removes a device that was created with device_create()
1526775b64d2b6ca37697de925f70799c710aab5849aRafael J. Wysocki * @class: pointer to the struct class that this device was registered with
1527775b64d2b6ca37697de925f70799c710aab5849aRafael J. Wysocki * @devt: the dev_t of the device that was previously registered
1528775b64d2b6ca37697de925f70799c710aab5849aRafael J. Wysocki *
1529775b64d2b6ca37697de925f70799c710aab5849aRafael J. Wysocki * This call unregisters and cleans up a device that was created with a
1530775b64d2b6ca37697de925f70799c710aab5849aRafael J. Wysocki * call to device_create().
1531775b64d2b6ca37697de925f70799c710aab5849aRafael J. Wysocki */
1532775b64d2b6ca37697de925f70799c710aab5849aRafael J. Wysockivoid device_destroy(struct class *class, dev_t devt)
1533775b64d2b6ca37697de925f70799c710aab5849aRafael J. Wysocki{
1534775b64d2b6ca37697de925f70799c710aab5849aRafael J. Wysocki	struct device *dev;
153523681e479129854305da1da32f7f1eaf635ef22cGreg Kroah-Hartman
1536695794ae0c5bdd9bd06e35b118801e2e9be04f9eGreg Kroah-Hartman	dev = class_find_device(class, NULL, &devt, __match_devt);
1537cd35449b93ac128282c1f1f720e84c5935f9018eDave Young	if (dev) {
1538cd35449b93ac128282c1f1f720e84c5935f9018eDave Young		put_device(dev);
153923681e479129854305da1da32f7f1eaf635ef22cGreg Kroah-Hartman		device_unregister(dev);
1540cd35449b93ac128282c1f1f720e84c5935f9018eDave Young	}
154123681e479129854305da1da32f7f1eaf635ef22cGreg Kroah-Hartman}
154223681e479129854305da1da32f7f1eaf635ef22cGreg Kroah-HartmanEXPORT_SYMBOL_GPL(device_destroy);
1543a2de48cace5d0993da6cfa28b276ae724dc3569bGreg Kroah-Hartman
1544a2de48cace5d0993da6cfa28b276ae724dc3569bGreg Kroah-Hartman/**
1545a2de48cace5d0993da6cfa28b276ae724dc3569bGreg Kroah-Hartman * device_rename - renames a device
1546a2de48cace5d0993da6cfa28b276ae724dc3569bGreg Kroah-Hartman * @dev: the pointer to the struct device to be renamed
1547a2de48cace5d0993da6cfa28b276ae724dc3569bGreg Kroah-Hartman * @new_name: the new name of the device
1548030c1d2bfcc2187650fb975456ca0b61a5bb77f4Eric W. Biederman *
1549030c1d2bfcc2187650fb975456ca0b61a5bb77f4Eric W. Biederman * It is the responsibility of the caller to provide mutual
1550030c1d2bfcc2187650fb975456ca0b61a5bb77f4Eric W. Biederman * exclusion between two different calls of device_rename
1551030c1d2bfcc2187650fb975456ca0b61a5bb77f4Eric W. Biederman * on the same device to ensure that new_name is valid and
1552030c1d2bfcc2187650fb975456ca0b61a5bb77f4Eric W. Biederman * won't conflict with other devices.
1553a2de48cace5d0993da6cfa28b276ae724dc3569bGreg Kroah-Hartman */
15546937e8f8c0135f2325194c372ada6dc655499992Johannes Bergint device_rename(struct device *dev, const char *new_name)
1555a2de48cace5d0993da6cfa28b276ae724dc3569bGreg Kroah-Hartman{
1556a2de48cace5d0993da6cfa28b276ae724dc3569bGreg Kroah-Hartman	char *old_class_name = NULL;
1557a2de48cace5d0993da6cfa28b276ae724dc3569bGreg Kroah-Hartman	char *new_class_name = NULL;
15582ee97caf0a6602f749ddbfdb1449e383e1212707Cornelia Huck	char *old_device_name = NULL;
1559a2de48cace5d0993da6cfa28b276ae724dc3569bGreg Kroah-Hartman	int error;
1560a2de48cace5d0993da6cfa28b276ae724dc3569bGreg Kroah-Hartman
1561a2de48cace5d0993da6cfa28b276ae724dc3569bGreg Kroah-Hartman	dev = get_device(dev);
1562a2de48cace5d0993da6cfa28b276ae724dc3569bGreg Kroah-Hartman	if (!dev)
1563a2de48cace5d0993da6cfa28b276ae724dc3569bGreg Kroah-Hartman		return -EINVAL;
1564a2de48cace5d0993da6cfa28b276ae724dc3569bGreg Kroah-Hartman
15651e0b2cf933ebf32494eba3f668859ba57f06a951Kay Sievers	pr_debug("device: '%s': %s: renaming to '%s'\n", dev_name(dev),
15662b3a302a09735276e13421db56c20045a48eb06dHarvey Harrison		 __func__, new_name);
1567a2de48cace5d0993da6cfa28b276ae724dc3569bGreg Kroah-Hartman
15681fa5ae857bb14f6046205171d98506d8112dd74eKay Sievers	old_device_name = kstrdup(dev_name(dev), GFP_KERNEL);
15692ee97caf0a6602f749ddbfdb1449e383e1212707Cornelia Huck	if (!old_device_name) {
15702ee97caf0a6602f749ddbfdb1449e383e1212707Cornelia Huck		error = -ENOMEM;
15712ee97caf0a6602f749ddbfdb1449e383e1212707Cornelia Huck		goto out;
1572a2de48cace5d0993da6cfa28b276ae724dc3569bGreg Kroah-Hartman	}
1573a2de48cace5d0993da6cfa28b276ae724dc3569bGreg Kroah-Hartman
1574f349cf34731c3b3eddbcd63cb04489aee2c405bdEric W. Biederman	if (dev->class) {
1575f349cf34731c3b3eddbcd63cb04489aee2c405bdEric W. Biederman		error = sysfs_rename_link(&dev->class->p->class_subsys.kobj,
1576f349cf34731c3b3eddbcd63cb04489aee2c405bdEric W. Biederman			&dev->kobj, old_device_name, new_name);
1577f349cf34731c3b3eddbcd63cb04489aee2c405bdEric W. Biederman		if (error)
1578f349cf34731c3b3eddbcd63cb04489aee2c405bdEric W. Biederman			goto out;
1579f349cf34731c3b3eddbcd63cb04489aee2c405bdEric W. Biederman	}
158039aba963d937edb20db7d9d93e6dda5d2adfdcddKay Sievers
1581a2de48cace5d0993da6cfa28b276ae724dc3569bGreg Kroah-Hartman	error = kobject_rename(&dev->kobj, new_name);
15821fa5ae857bb14f6046205171d98506d8112dd74eKay Sievers	if (error)
15832ee97caf0a6602f749ddbfdb1449e383e1212707Cornelia Huck		goto out;
1584a2de48cace5d0993da6cfa28b276ae724dc3569bGreg Kroah-Hartman
15852ee97caf0a6602f749ddbfdb1449e383e1212707Cornelia Huckout:
1586a2de48cace5d0993da6cfa28b276ae724dc3569bGreg Kroah-Hartman	put_device(dev);
1587a2de48cace5d0993da6cfa28b276ae724dc3569bGreg Kroah-Hartman
1588a2de48cace5d0993da6cfa28b276ae724dc3569bGreg Kroah-Hartman	kfree(new_class_name);
1589952ab431cd36c7ab573f685af8679c3677cbdc29Jesper Juhl	kfree(old_class_name);
15902ee97caf0a6602f749ddbfdb1449e383e1212707Cornelia Huck	kfree(old_device_name);
1591a2de48cace5d0993da6cfa28b276ae724dc3569bGreg Kroah-Hartman
1592a2de48cace5d0993da6cfa28b276ae724dc3569bGreg Kroah-Hartman	return error;
1593a2de48cace5d0993da6cfa28b276ae724dc3569bGreg Kroah-Hartman}
1594a2807dbcbd681e1f36e813fb26e2f24d15018b91Johannes BergEXPORT_SYMBOL_GPL(device_rename);
15958a82472f86bf693b8e91ed56c9ca4f62fbbdcfa3Cornelia Huck
15968a82472f86bf693b8e91ed56c9ca4f62fbbdcfa3Cornelia Huckstatic int device_move_class_links(struct device *dev,
15978a82472f86bf693b8e91ed56c9ca4f62fbbdcfa3Cornelia Huck				   struct device *old_parent,
15988a82472f86bf693b8e91ed56c9ca4f62fbbdcfa3Cornelia Huck				   struct device *new_parent)
15998a82472f86bf693b8e91ed56c9ca4f62fbbdcfa3Cornelia Huck{
1600f7f3461d87536bed52bb83bc8fbe6bfd28619fb1Greg Kroah-Hartman	int error = 0;
16018a82472f86bf693b8e91ed56c9ca4f62fbbdcfa3Cornelia Huck
1602f7f3461d87536bed52bb83bc8fbe6bfd28619fb1Greg Kroah-Hartman	if (old_parent)
1603f7f3461d87536bed52bb83bc8fbe6bfd28619fb1Greg Kroah-Hartman		sysfs_remove_link(&dev->kobj, "device");
1604f7f3461d87536bed52bb83bc8fbe6bfd28619fb1Greg Kroah-Hartman	if (new_parent)
1605f7f3461d87536bed52bb83bc8fbe6bfd28619fb1Greg Kroah-Hartman		error = sysfs_create_link(&dev->kobj, &new_parent->kobj,
1606f7f3461d87536bed52bb83bc8fbe6bfd28619fb1Greg Kroah-Hartman					  "device");
1607f7f3461d87536bed52bb83bc8fbe6bfd28619fb1Greg Kroah-Hartman	return error;
16088a82472f86bf693b8e91ed56c9ca4f62fbbdcfa3Cornelia Huck}
16098a82472f86bf693b8e91ed56c9ca4f62fbbdcfa3Cornelia Huck
16108a82472f86bf693b8e91ed56c9ca4f62fbbdcfa3Cornelia Huck/**
16118a82472f86bf693b8e91ed56c9ca4f62fbbdcfa3Cornelia Huck * device_move - moves a device to a new parent
16128a82472f86bf693b8e91ed56c9ca4f62fbbdcfa3Cornelia Huck * @dev: the pointer to the struct device to be moved
1613c744aeae9d173a953b771a7ad5c872f91fa99decCornelia Huck * @new_parent: the new parent of the device (can by NULL)
1614ffa6a7054d172a2f57248dff2de600ca795c5656Cornelia Huck * @dpm_order: how to reorder the dpm_list
16158a82472f86bf693b8e91ed56c9ca4f62fbbdcfa3Cornelia Huck */
1616ffa6a7054d172a2f57248dff2de600ca795c5656Cornelia Huckint device_move(struct device *dev, struct device *new_parent,
1617ffa6a7054d172a2f57248dff2de600ca795c5656Cornelia Huck		enum dpm_order dpm_order)
16188a82472f86bf693b8e91ed56c9ca4f62fbbdcfa3Cornelia Huck{
16198a82472f86bf693b8e91ed56c9ca4f62fbbdcfa3Cornelia Huck	int error;
16208a82472f86bf693b8e91ed56c9ca4f62fbbdcfa3Cornelia Huck	struct device *old_parent;
1621c744aeae9d173a953b771a7ad5c872f91fa99decCornelia Huck	struct kobject *new_parent_kobj;
16228a82472f86bf693b8e91ed56c9ca4f62fbbdcfa3Cornelia Huck
16238a82472f86bf693b8e91ed56c9ca4f62fbbdcfa3Cornelia Huck	dev = get_device(dev);
16248a82472f86bf693b8e91ed56c9ca4f62fbbdcfa3Cornelia Huck	if (!dev)
16258a82472f86bf693b8e91ed56c9ca4f62fbbdcfa3Cornelia Huck		return -EINVAL;
16268a82472f86bf693b8e91ed56c9ca4f62fbbdcfa3Cornelia Huck
1627ffa6a7054d172a2f57248dff2de600ca795c5656Cornelia Huck	device_pm_lock();
16288a82472f86bf693b8e91ed56c9ca4f62fbbdcfa3Cornelia Huck	new_parent = get_device(new_parent);
16294a3ad20ccd8f4d2a0535cf98fa83f7b561ba59a9Greg Kroah-Hartman	new_parent_kobj = get_device_parent(dev, new_parent);
163063b6971a0876b744e2fcf3c9df15d130501e1debCornelia Huck
16311e0b2cf933ebf32494eba3f668859ba57f06a951Kay Sievers	pr_debug("device: '%s': %s: moving to '%s'\n", dev_name(dev),
16321e0b2cf933ebf32494eba3f668859ba57f06a951Kay Sievers		 __func__, new_parent ? dev_name(new_parent) : "<NULL>");
1633c744aeae9d173a953b771a7ad5c872f91fa99decCornelia Huck	error = kobject_move(&dev->kobj, new_parent_kobj);
16348a82472f86bf693b8e91ed56c9ca4f62fbbdcfa3Cornelia Huck	if (error) {
163563b6971a0876b744e2fcf3c9df15d130501e1debCornelia Huck		cleanup_glue_dir(dev, new_parent_kobj);
16368a82472f86bf693b8e91ed56c9ca4f62fbbdcfa3Cornelia Huck		put_device(new_parent);
16378a82472f86bf693b8e91ed56c9ca4f62fbbdcfa3Cornelia Huck		goto out;
16388a82472f86bf693b8e91ed56c9ca4f62fbbdcfa3Cornelia Huck	}
16398a82472f86bf693b8e91ed56c9ca4f62fbbdcfa3Cornelia Huck	old_parent = dev->parent;
16408a82472f86bf693b8e91ed56c9ca4f62fbbdcfa3Cornelia Huck	dev->parent = new_parent;
16418a82472f86bf693b8e91ed56c9ca4f62fbbdcfa3Cornelia Huck	if (old_parent)
1642f791b8c836307b58cbf62133a6a772ed1a92fb33Greg Kroah-Hartman		klist_remove(&dev->p->knode_parent);
16430d358f22f6c8f03ab215eee8d52b74f78cc3c7dbYinghai Lu	if (new_parent) {
1644f791b8c836307b58cbf62133a6a772ed1a92fb33Greg Kroah-Hartman		klist_add_tail(&dev->p->knode_parent,
1645f791b8c836307b58cbf62133a6a772ed1a92fb33Greg Kroah-Hartman			       &new_parent->p->klist_children);
16460d358f22f6c8f03ab215eee8d52b74f78cc3c7dbYinghai Lu		set_dev_node(dev, dev_to_node(new_parent));
16470d358f22f6c8f03ab215eee8d52b74f78cc3c7dbYinghai Lu	}
16480d358f22f6c8f03ab215eee8d52b74f78cc3c7dbYinghai Lu
16498a82472f86bf693b8e91ed56c9ca4f62fbbdcfa3Cornelia Huck	if (!dev->class)
16508a82472f86bf693b8e91ed56c9ca4f62fbbdcfa3Cornelia Huck		goto out_put;
16518a82472f86bf693b8e91ed56c9ca4f62fbbdcfa3Cornelia Huck	error = device_move_class_links(dev, old_parent, new_parent);
16528a82472f86bf693b8e91ed56c9ca4f62fbbdcfa3Cornelia Huck	if (error) {
16538a82472f86bf693b8e91ed56c9ca4f62fbbdcfa3Cornelia Huck		/* We ignore errors on cleanup since we're hosed anyway... */
16548a82472f86bf693b8e91ed56c9ca4f62fbbdcfa3Cornelia Huck		device_move_class_links(dev, new_parent, old_parent);
16558a82472f86bf693b8e91ed56c9ca4f62fbbdcfa3Cornelia Huck		if (!kobject_move(&dev->kobj, &old_parent->kobj)) {
1656c744aeae9d173a953b771a7ad5c872f91fa99decCornelia Huck			if (new_parent)
1657f791b8c836307b58cbf62133a6a772ed1a92fb33Greg Kroah-Hartman				klist_remove(&dev->p->knode_parent);
16580d358f22f6c8f03ab215eee8d52b74f78cc3c7dbYinghai Lu			dev->parent = old_parent;
16590d358f22f6c8f03ab215eee8d52b74f78cc3c7dbYinghai Lu			if (old_parent) {
1660f791b8c836307b58cbf62133a6a772ed1a92fb33Greg Kroah-Hartman				klist_add_tail(&dev->p->knode_parent,
1661f791b8c836307b58cbf62133a6a772ed1a92fb33Greg Kroah-Hartman					       &old_parent->p->klist_children);
16620d358f22f6c8f03ab215eee8d52b74f78cc3c7dbYinghai Lu				set_dev_node(dev, dev_to_node(old_parent));
16630d358f22f6c8f03ab215eee8d52b74f78cc3c7dbYinghai Lu			}
16648a82472f86bf693b8e91ed56c9ca4f62fbbdcfa3Cornelia Huck		}
166563b6971a0876b744e2fcf3c9df15d130501e1debCornelia Huck		cleanup_glue_dir(dev, new_parent_kobj);
16668a82472f86bf693b8e91ed56c9ca4f62fbbdcfa3Cornelia Huck		put_device(new_parent);
16678a82472f86bf693b8e91ed56c9ca4f62fbbdcfa3Cornelia Huck		goto out;
16688a82472f86bf693b8e91ed56c9ca4f62fbbdcfa3Cornelia Huck	}
1669ffa6a7054d172a2f57248dff2de600ca795c5656Cornelia Huck	switch (dpm_order) {
1670ffa6a7054d172a2f57248dff2de600ca795c5656Cornelia Huck	case DPM_ORDER_NONE:
1671ffa6a7054d172a2f57248dff2de600ca795c5656Cornelia Huck		break;
1672ffa6a7054d172a2f57248dff2de600ca795c5656Cornelia Huck	case DPM_ORDER_DEV_AFTER_PARENT:
1673ffa6a7054d172a2f57248dff2de600ca795c5656Cornelia Huck		device_pm_move_after(dev, new_parent);
1674ffa6a7054d172a2f57248dff2de600ca795c5656Cornelia Huck		break;
1675ffa6a7054d172a2f57248dff2de600ca795c5656Cornelia Huck	case DPM_ORDER_PARENT_BEFORE_DEV:
1676ffa6a7054d172a2f57248dff2de600ca795c5656Cornelia Huck		device_pm_move_before(new_parent, dev);
1677ffa6a7054d172a2f57248dff2de600ca795c5656Cornelia Huck		break;
1678ffa6a7054d172a2f57248dff2de600ca795c5656Cornelia Huck	case DPM_ORDER_DEV_LAST:
1679ffa6a7054d172a2f57248dff2de600ca795c5656Cornelia Huck		device_pm_move_last(dev);
1680ffa6a7054d172a2f57248dff2de600ca795c5656Cornelia Huck		break;
1681ffa6a7054d172a2f57248dff2de600ca795c5656Cornelia Huck	}
16828a82472f86bf693b8e91ed56c9ca4f62fbbdcfa3Cornelia Huckout_put:
16838a82472f86bf693b8e91ed56c9ca4f62fbbdcfa3Cornelia Huck	put_device(old_parent);
16848a82472f86bf693b8e91ed56c9ca4f62fbbdcfa3Cornelia Huckout:
1685ffa6a7054d172a2f57248dff2de600ca795c5656Cornelia Huck	device_pm_unlock();
16868a82472f86bf693b8e91ed56c9ca4f62fbbdcfa3Cornelia Huck	put_device(dev);
16878a82472f86bf693b8e91ed56c9ca4f62fbbdcfa3Cornelia Huck	return error;
16888a82472f86bf693b8e91ed56c9ca4f62fbbdcfa3Cornelia Huck}
16898a82472f86bf693b8e91ed56c9ca4f62fbbdcfa3Cornelia HuckEXPORT_SYMBOL_GPL(device_move);
169037b0c020343080241984d978981d6caf877b278aGreg Kroah-Hartman
169137b0c020343080241984d978981d6caf877b278aGreg Kroah-Hartman/**
169237b0c020343080241984d978981d6caf877b278aGreg Kroah-Hartman * device_shutdown - call ->shutdown() on each device to shutdown.
169337b0c020343080241984d978981d6caf877b278aGreg Kroah-Hartman */
169437b0c020343080241984d978981d6caf877b278aGreg Kroah-Hartmanvoid device_shutdown(void)
169537b0c020343080241984d978981d6caf877b278aGreg Kroah-Hartman{
16966245838fe4d2ce4aab52f543224f7d1212d9155cHugh Daschbach	struct device *dev;
16976245838fe4d2ce4aab52f543224f7d1212d9155cHugh Daschbach
16986245838fe4d2ce4aab52f543224f7d1212d9155cHugh Daschbach	spin_lock(&devices_kset->list_lock);
16996245838fe4d2ce4aab52f543224f7d1212d9155cHugh Daschbach	/*
17006245838fe4d2ce4aab52f543224f7d1212d9155cHugh Daschbach	 * Walk the devices list backward, shutting down each in turn.
17016245838fe4d2ce4aab52f543224f7d1212d9155cHugh Daschbach	 * Beware that device unplug events may also start pulling
17026245838fe4d2ce4aab52f543224f7d1212d9155cHugh Daschbach	 * devices offline, even as the system is shutting down.
17036245838fe4d2ce4aab52f543224f7d1212d9155cHugh Daschbach	 */
17046245838fe4d2ce4aab52f543224f7d1212d9155cHugh Daschbach	while (!list_empty(&devices_kset->list)) {
17056245838fe4d2ce4aab52f543224f7d1212d9155cHugh Daschbach		dev = list_entry(devices_kset->list.prev, struct device,
17066245838fe4d2ce4aab52f543224f7d1212d9155cHugh Daschbach				kobj.entry);
17076245838fe4d2ce4aab52f543224f7d1212d9155cHugh Daschbach		get_device(dev);
17086245838fe4d2ce4aab52f543224f7d1212d9155cHugh Daschbach		/*
17096245838fe4d2ce4aab52f543224f7d1212d9155cHugh Daschbach		 * Make sure the device is off the kset list, in the
17106245838fe4d2ce4aab52f543224f7d1212d9155cHugh Daschbach		 * event that dev->*->shutdown() doesn't remove it.
17116245838fe4d2ce4aab52f543224f7d1212d9155cHugh Daschbach		 */
17126245838fe4d2ce4aab52f543224f7d1212d9155cHugh Daschbach		list_del_init(&dev->kobj.entry);
17136245838fe4d2ce4aab52f543224f7d1212d9155cHugh Daschbach		spin_unlock(&devices_kset->list_lock);
171437b0c020343080241984d978981d6caf877b278aGreg Kroah-Hartman
171537b0c020343080241984d978981d6caf877b278aGreg Kroah-Hartman		if (dev->bus && dev->bus->shutdown) {
171637b0c020343080241984d978981d6caf877b278aGreg Kroah-Hartman			dev_dbg(dev, "shutdown\n");
171737b0c020343080241984d978981d6caf877b278aGreg Kroah-Hartman			dev->bus->shutdown(dev);
171837b0c020343080241984d978981d6caf877b278aGreg Kroah-Hartman		} else if (dev->driver && dev->driver->shutdown) {
171937b0c020343080241984d978981d6caf877b278aGreg Kroah-Hartman			dev_dbg(dev, "shutdown\n");
172037b0c020343080241984d978981d6caf877b278aGreg Kroah-Hartman			dev->driver->shutdown(dev);
172137b0c020343080241984d978981d6caf877b278aGreg Kroah-Hartman		}
17226245838fe4d2ce4aab52f543224f7d1212d9155cHugh Daschbach		put_device(dev);
17236245838fe4d2ce4aab52f543224f7d1212d9155cHugh Daschbach
17246245838fe4d2ce4aab52f543224f7d1212d9155cHugh Daschbach		spin_lock(&devices_kset->list_lock);
172537b0c020343080241984d978981d6caf877b278aGreg Kroah-Hartman	}
17266245838fe4d2ce4aab52f543224f7d1212d9155cHugh Daschbach	spin_unlock(&devices_kset->list_lock);
1727401097ea4b89846d66ac78f7f108d49c2e922d9cShaohua Li	async_synchronize_full();
172837b0c020343080241984d978981d6caf877b278aGreg Kroah-Hartman}
172999bcf217183e02ebae46373896fba7f12d588001Joe Perches
173099bcf217183e02ebae46373896fba7f12d588001Joe Perches/*
173199bcf217183e02ebae46373896fba7f12d588001Joe Perches * Device logging functions
173299bcf217183e02ebae46373896fba7f12d588001Joe Perches */
173399bcf217183e02ebae46373896fba7f12d588001Joe Perches
173499bcf217183e02ebae46373896fba7f12d588001Joe Perches#ifdef CONFIG_PRINTK
173599bcf217183e02ebae46373896fba7f12d588001Joe Perches
173699bcf217183e02ebae46373896fba7f12d588001Joe Perchesstatic int __dev_printk(const char *level, const struct device *dev,
173799bcf217183e02ebae46373896fba7f12d588001Joe Perches			struct va_format *vaf)
173899bcf217183e02ebae46373896fba7f12d588001Joe Perches{
173999bcf217183e02ebae46373896fba7f12d588001Joe Perches	if (!dev)
174099bcf217183e02ebae46373896fba7f12d588001Joe Perches		return printk("%s(NULL device *): %pV", level, vaf);
174199bcf217183e02ebae46373896fba7f12d588001Joe Perches
174299bcf217183e02ebae46373896fba7f12d588001Joe Perches	return printk("%s%s %s: %pV",
174399bcf217183e02ebae46373896fba7f12d588001Joe Perches		      level, dev_driver_string(dev), dev_name(dev), vaf);
174499bcf217183e02ebae46373896fba7f12d588001Joe Perches}
174599bcf217183e02ebae46373896fba7f12d588001Joe Perches
174699bcf217183e02ebae46373896fba7f12d588001Joe Perchesint dev_printk(const char *level, const struct device *dev,
174799bcf217183e02ebae46373896fba7f12d588001Joe Perches	       const char *fmt, ...)
174899bcf217183e02ebae46373896fba7f12d588001Joe Perches{
174999bcf217183e02ebae46373896fba7f12d588001Joe Perches	struct va_format vaf;
175099bcf217183e02ebae46373896fba7f12d588001Joe Perches	va_list args;
175199bcf217183e02ebae46373896fba7f12d588001Joe Perches	int r;
175299bcf217183e02ebae46373896fba7f12d588001Joe Perches
175399bcf217183e02ebae46373896fba7f12d588001Joe Perches	va_start(args, fmt);
175499bcf217183e02ebae46373896fba7f12d588001Joe Perches
175599bcf217183e02ebae46373896fba7f12d588001Joe Perches	vaf.fmt = fmt;
175699bcf217183e02ebae46373896fba7f12d588001Joe Perches	vaf.va = &args;
175799bcf217183e02ebae46373896fba7f12d588001Joe Perches
175899bcf217183e02ebae46373896fba7f12d588001Joe Perches	r = __dev_printk(level, dev, &vaf);
175999bcf217183e02ebae46373896fba7f12d588001Joe Perches	va_end(args);
176099bcf217183e02ebae46373896fba7f12d588001Joe Perches
176199bcf217183e02ebae46373896fba7f12d588001Joe Perches	return r;
176299bcf217183e02ebae46373896fba7f12d588001Joe Perches}
176399bcf217183e02ebae46373896fba7f12d588001Joe PerchesEXPORT_SYMBOL(dev_printk);
176499bcf217183e02ebae46373896fba7f12d588001Joe Perches
176599bcf217183e02ebae46373896fba7f12d588001Joe Perches#define define_dev_printk_level(func, kern_level)		\
176699bcf217183e02ebae46373896fba7f12d588001Joe Perchesint func(const struct device *dev, const char *fmt, ...)	\
176799bcf217183e02ebae46373896fba7f12d588001Joe Perches{								\
176899bcf217183e02ebae46373896fba7f12d588001Joe Perches	struct va_format vaf;					\
176999bcf217183e02ebae46373896fba7f12d588001Joe Perches	va_list args;						\
177099bcf217183e02ebae46373896fba7f12d588001Joe Perches	int r;							\
177199bcf217183e02ebae46373896fba7f12d588001Joe Perches								\
177299bcf217183e02ebae46373896fba7f12d588001Joe Perches	va_start(args, fmt);					\
177399bcf217183e02ebae46373896fba7f12d588001Joe Perches								\
177499bcf217183e02ebae46373896fba7f12d588001Joe Perches	vaf.fmt = fmt;						\
177599bcf217183e02ebae46373896fba7f12d588001Joe Perches	vaf.va = &args;						\
177699bcf217183e02ebae46373896fba7f12d588001Joe Perches								\
177799bcf217183e02ebae46373896fba7f12d588001Joe Perches	r = __dev_printk(kern_level, dev, &vaf);		\
177899bcf217183e02ebae46373896fba7f12d588001Joe Perches	va_end(args);						\
177999bcf217183e02ebae46373896fba7f12d588001Joe Perches								\
178099bcf217183e02ebae46373896fba7f12d588001Joe Perches	return r;						\
178199bcf217183e02ebae46373896fba7f12d588001Joe Perches}								\
178299bcf217183e02ebae46373896fba7f12d588001Joe PerchesEXPORT_SYMBOL(func);
178399bcf217183e02ebae46373896fba7f12d588001Joe Perches
178499bcf217183e02ebae46373896fba7f12d588001Joe Perchesdefine_dev_printk_level(dev_emerg, KERN_EMERG);
178599bcf217183e02ebae46373896fba7f12d588001Joe Perchesdefine_dev_printk_level(dev_alert, KERN_ALERT);
178699bcf217183e02ebae46373896fba7f12d588001Joe Perchesdefine_dev_printk_level(dev_crit, KERN_CRIT);
178799bcf217183e02ebae46373896fba7f12d588001Joe Perchesdefine_dev_printk_level(dev_err, KERN_ERR);
178899bcf217183e02ebae46373896fba7f12d588001Joe Perchesdefine_dev_printk_level(dev_warn, KERN_WARNING);
178999bcf217183e02ebae46373896fba7f12d588001Joe Perchesdefine_dev_printk_level(dev_notice, KERN_NOTICE);
179099bcf217183e02ebae46373896fba7f12d588001Joe Perchesdefine_dev_printk_level(_dev_info, KERN_INFO);
179199bcf217183e02ebae46373896fba7f12d588001Joe Perches
179299bcf217183e02ebae46373896fba7f12d588001Joe Perches#endif
1793