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> 25af8db1508f2c9f3b6e633e2d2d906c6557c617f9Peter Chen#include <linux/pm_runtime.h> 261da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds 271da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds#include "base.h" 281da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds#include "power/power.h" 291da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds 30e52eec13cd6b7f30ab19081b387813e03e592ae5Andi Kleen#ifdef CONFIG_SYSFS_DEPRECATED 31e52eec13cd6b7f30ab19081b387813e03e592ae5Andi Kleen#ifdef CONFIG_SYSFS_DEPRECATED_V2 32e52eec13cd6b7f30ab19081b387813e03e592ae5Andi Kleenlong sysfs_deprecated = 1; 33e52eec13cd6b7f30ab19081b387813e03e592ae5Andi Kleen#else 34e52eec13cd6b7f30ab19081b387813e03e592ae5Andi Kleenlong sysfs_deprecated = 0; 35e52eec13cd6b7f30ab19081b387813e03e592ae5Andi Kleen#endif 36e52eec13cd6b7f30ab19081b387813e03e592ae5Andi Kleenstatic __init int sysfs_deprecated_setup(char *arg) 37e52eec13cd6b7f30ab19081b387813e03e592ae5Andi Kleen{ 38e52eec13cd6b7f30ab19081b387813e03e592ae5Andi Kleen return strict_strtol(arg, 10, &sysfs_deprecated); 39e52eec13cd6b7f30ab19081b387813e03e592ae5Andi Kleen} 40e52eec13cd6b7f30ab19081b387813e03e592ae5Andi Kleenearly_param("sysfs.deprecated", sysfs_deprecated_setup); 41e52eec13cd6b7f30ab19081b387813e03e592ae5Andi Kleen#endif 42e52eec13cd6b7f30ab19081b387813e03e592ae5Andi Kleen 434a3ad20ccd8f4d2a0535cf98fa83f7b561ba59a9Greg Kroah-Hartmanint (*platform_notify)(struct device *dev) = NULL; 444a3ad20ccd8f4d2a0535cf98fa83f7b561ba59a9Greg Kroah-Hartmanint (*platform_notify_remove)(struct device *dev) = NULL; 45e105b8bfc769b0545b6f0f395179d1e43cbee822Dan Williamsstatic struct kobject *dev_kobj; 46e105b8bfc769b0545b6f0f395179d1e43cbee822Dan Williamsstruct kobject *sysfs_dev_char_kobj; 47e105b8bfc769b0545b6f0f395179d1e43cbee822Dan Williamsstruct kobject *sysfs_dev_block_kobj; 481da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds 494e886c29610f4374d8971ec7a248f011cc3bd73aGreg Kroah-Hartman#ifdef CONFIG_BLOCK 504e886c29610f4374d8971ec7a248f011cc3bd73aGreg Kroah-Hartmanstatic inline int device_is_not_partition(struct device *dev) 514e886c29610f4374d8971ec7a248f011cc3bd73aGreg Kroah-Hartman{ 524e886c29610f4374d8971ec7a248f011cc3bd73aGreg Kroah-Hartman return !(dev->type == &part_type); 534e886c29610f4374d8971ec7a248f011cc3bd73aGreg Kroah-Hartman} 544e886c29610f4374d8971ec7a248f011cc3bd73aGreg Kroah-Hartman#else 554e886c29610f4374d8971ec7a248f011cc3bd73aGreg Kroah-Hartmanstatic inline int device_is_not_partition(struct device *dev) 564e886c29610f4374d8971ec7a248f011cc3bd73aGreg Kroah-Hartman{ 574e886c29610f4374d8971ec7a248f011cc3bd73aGreg Kroah-Hartman return 1; 584e886c29610f4374d8971ec7a248f011cc3bd73aGreg Kroah-Hartman} 594e886c29610f4374d8971ec7a248f011cc3bd73aGreg Kroah-Hartman#endif 601da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds 613e95637a48820ff8bedb33e6439def96ccff1de5Alan Stern/** 623e95637a48820ff8bedb33e6439def96ccff1de5Alan Stern * dev_driver_string - Return a device's driver name, if at all possible 633e95637a48820ff8bedb33e6439def96ccff1de5Alan Stern * @dev: struct device to get the name of 643e95637a48820ff8bedb33e6439def96ccff1de5Alan Stern * 653e95637a48820ff8bedb33e6439def96ccff1de5Alan Stern * Will return the device's driver's name if it is bound to a device. If 663e95637a48820ff8bedb33e6439def96ccff1de5Alan Stern * the device is not bound to a device, it will return the name of the bus 673e95637a48820ff8bedb33e6439def96ccff1de5Alan Stern * it is attached to. If it is not attached to a bus either, an empty 683e95637a48820ff8bedb33e6439def96ccff1de5Alan Stern * string will be returned. 693e95637a48820ff8bedb33e6439def96ccff1de5Alan Stern */ 70bf9ca69fc8d19d4034391d3df4c35dccdef9d28cJean Delvareconst char *dev_driver_string(const struct device *dev) 713e95637a48820ff8bedb33e6439def96ccff1de5Alan Stern{ 723589972e51fac1e02d0aaa576fa47f568cb94d40Alan Stern struct device_driver *drv; 733589972e51fac1e02d0aaa576fa47f568cb94d40Alan Stern 743589972e51fac1e02d0aaa576fa47f568cb94d40Alan Stern /* dev->driver can change to NULL underneath us because of unbinding, 753589972e51fac1e02d0aaa576fa47f568cb94d40Alan Stern * so be careful about accessing it. dev->bus and dev->class should 763589972e51fac1e02d0aaa576fa47f568cb94d40Alan Stern * never change once they are set, so they don't need special care. 773589972e51fac1e02d0aaa576fa47f568cb94d40Alan Stern */ 783589972e51fac1e02d0aaa576fa47f568cb94d40Alan Stern drv = ACCESS_ONCE(dev->driver); 793589972e51fac1e02d0aaa576fa47f568cb94d40Alan Stern return drv ? drv->name : 80a456b7023e0abf80bb03b0bdf5471b48878e5c49Jean Delvare (dev->bus ? dev->bus->name : 81a456b7023e0abf80bb03b0bdf5471b48878e5c49Jean Delvare (dev->class ? dev->class->name : "")); 823e95637a48820ff8bedb33e6439def96ccff1de5Alan Stern} 83310a922d4307ed38b37982a6f93b11fdf3b8dcb1Matthew WilcoxEXPORT_SYMBOL(dev_driver_string); 843e95637a48820ff8bedb33e6439def96ccff1de5Alan Stern 851da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds#define to_dev(obj) container_of(obj, struct device, kobj) 861da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds#define to_dev_attr(_attr) container_of(_attr, struct device_attribute, attr) 871da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds 884a3ad20ccd8f4d2a0535cf98fa83f7b561ba59a9Greg Kroah-Hartmanstatic ssize_t dev_attr_show(struct kobject *kobj, struct attribute *attr, 894a3ad20ccd8f4d2a0535cf98fa83f7b561ba59a9Greg Kroah-Hartman char *buf) 901da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds{ 914a3ad20ccd8f4d2a0535cf98fa83f7b561ba59a9Greg Kroah-Hartman struct device_attribute *dev_attr = to_dev_attr(attr); 924a3ad20ccd8f4d2a0535cf98fa83f7b561ba59a9Greg Kroah-Hartman struct device *dev = to_dev(kobj); 934a0c20bf8c0fe2116f8fd7d3da6122bf8a01f026Dmitry Torokhov ssize_t ret = -EIO; 941da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds 951da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds if (dev_attr->show) 9654b6f35c99974e99e64c05c2895718355123c55fYani Ioannou ret = dev_attr->show(dev, dev_attr, buf); 97815d2d50da41f28aae58f5e9b3c61c3094422749Andrew Morton if (ret >= (ssize_t)PAGE_SIZE) { 98815d2d50da41f28aae58f5e9b3c61c3094422749Andrew Morton print_symbol("dev_attr_show: %s returned bad count\n", 99815d2d50da41f28aae58f5e9b3c61c3094422749Andrew Morton (unsigned long)dev_attr->show); 100815d2d50da41f28aae58f5e9b3c61c3094422749Andrew Morton } 1011da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds return ret; 1021da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds} 1031da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds 1044a3ad20ccd8f4d2a0535cf98fa83f7b561ba59a9Greg Kroah-Hartmanstatic ssize_t dev_attr_store(struct kobject *kobj, struct attribute *attr, 1054a3ad20ccd8f4d2a0535cf98fa83f7b561ba59a9Greg Kroah-Hartman const char *buf, size_t count) 1061da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds{ 1074a3ad20ccd8f4d2a0535cf98fa83f7b561ba59a9Greg Kroah-Hartman struct device_attribute *dev_attr = to_dev_attr(attr); 1084a3ad20ccd8f4d2a0535cf98fa83f7b561ba59a9Greg Kroah-Hartman struct device *dev = to_dev(kobj); 1094a0c20bf8c0fe2116f8fd7d3da6122bf8a01f026Dmitry Torokhov ssize_t ret = -EIO; 1101da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds 1111da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds if (dev_attr->store) 11254b6f35c99974e99e64c05c2895718355123c55fYani Ioannou ret = dev_attr->store(dev, dev_attr, buf, count); 1131da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds return ret; 1141da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds} 1151da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds 11652cf25d0ab7f78eeecc59ac652ed5090f69b619eEmese Revfystatic const struct sysfs_ops dev_sysfs_ops = { 1171da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds .show = dev_attr_show, 1181da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds .store = dev_attr_store, 1191da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds}; 1201da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds 121ca22e56debc57b47c422b749c93217ba62644be2Kay Sievers#define to_ext_attr(x) container_of(x, struct dev_ext_attribute, attr) 122ca22e56debc57b47c422b749c93217ba62644be2Kay Sievers 123ca22e56debc57b47c422b749c93217ba62644be2Kay Sieversssize_t device_store_ulong(struct device *dev, 124ca22e56debc57b47c422b749c93217ba62644be2Kay Sievers struct device_attribute *attr, 125ca22e56debc57b47c422b749c93217ba62644be2Kay Sievers const char *buf, size_t size) 126ca22e56debc57b47c422b749c93217ba62644be2Kay Sievers{ 127ca22e56debc57b47c422b749c93217ba62644be2Kay Sievers struct dev_ext_attribute *ea = to_ext_attr(attr); 128ca22e56debc57b47c422b749c93217ba62644be2Kay Sievers char *end; 129ca22e56debc57b47c422b749c93217ba62644be2Kay Sievers unsigned long new = simple_strtoul(buf, &end, 0); 130ca22e56debc57b47c422b749c93217ba62644be2Kay Sievers if (end == buf) 131ca22e56debc57b47c422b749c93217ba62644be2Kay Sievers return -EINVAL; 132ca22e56debc57b47c422b749c93217ba62644be2Kay Sievers *(unsigned long *)(ea->var) = new; 133ca22e56debc57b47c422b749c93217ba62644be2Kay Sievers /* Always return full write size even if we didn't consume all */ 134ca22e56debc57b47c422b749c93217ba62644be2Kay Sievers return size; 135ca22e56debc57b47c422b749c93217ba62644be2Kay Sievers} 136ca22e56debc57b47c422b749c93217ba62644be2Kay SieversEXPORT_SYMBOL_GPL(device_store_ulong); 137ca22e56debc57b47c422b749c93217ba62644be2Kay Sievers 138ca22e56debc57b47c422b749c93217ba62644be2Kay Sieversssize_t device_show_ulong(struct device *dev, 139ca22e56debc57b47c422b749c93217ba62644be2Kay Sievers struct device_attribute *attr, 140ca22e56debc57b47c422b749c93217ba62644be2Kay Sievers char *buf) 141ca22e56debc57b47c422b749c93217ba62644be2Kay Sievers{ 142ca22e56debc57b47c422b749c93217ba62644be2Kay Sievers struct dev_ext_attribute *ea = to_ext_attr(attr); 143ca22e56debc57b47c422b749c93217ba62644be2Kay Sievers return snprintf(buf, PAGE_SIZE, "%lx\n", *(unsigned long *)(ea->var)); 144ca22e56debc57b47c422b749c93217ba62644be2Kay Sievers} 145ca22e56debc57b47c422b749c93217ba62644be2Kay SieversEXPORT_SYMBOL_GPL(device_show_ulong); 146ca22e56debc57b47c422b749c93217ba62644be2Kay Sievers 147ca22e56debc57b47c422b749c93217ba62644be2Kay Sieversssize_t device_store_int(struct device *dev, 148ca22e56debc57b47c422b749c93217ba62644be2Kay Sievers struct device_attribute *attr, 149ca22e56debc57b47c422b749c93217ba62644be2Kay Sievers const char *buf, size_t size) 150ca22e56debc57b47c422b749c93217ba62644be2Kay Sievers{ 151ca22e56debc57b47c422b749c93217ba62644be2Kay Sievers struct dev_ext_attribute *ea = to_ext_attr(attr); 152ca22e56debc57b47c422b749c93217ba62644be2Kay Sievers char *end; 153ca22e56debc57b47c422b749c93217ba62644be2Kay Sievers long new = simple_strtol(buf, &end, 0); 154ca22e56debc57b47c422b749c93217ba62644be2Kay Sievers if (end == buf || new > INT_MAX || new < INT_MIN) 155ca22e56debc57b47c422b749c93217ba62644be2Kay Sievers return -EINVAL; 156ca22e56debc57b47c422b749c93217ba62644be2Kay Sievers *(int *)(ea->var) = new; 157ca22e56debc57b47c422b749c93217ba62644be2Kay Sievers /* Always return full write size even if we didn't consume all */ 158ca22e56debc57b47c422b749c93217ba62644be2Kay Sievers return size; 159ca22e56debc57b47c422b749c93217ba62644be2Kay Sievers} 160ca22e56debc57b47c422b749c93217ba62644be2Kay SieversEXPORT_SYMBOL_GPL(device_store_int); 161ca22e56debc57b47c422b749c93217ba62644be2Kay Sievers 162ca22e56debc57b47c422b749c93217ba62644be2Kay Sieversssize_t device_show_int(struct device *dev, 163ca22e56debc57b47c422b749c93217ba62644be2Kay Sievers struct device_attribute *attr, 164ca22e56debc57b47c422b749c93217ba62644be2Kay Sievers char *buf) 165ca22e56debc57b47c422b749c93217ba62644be2Kay Sievers{ 166ca22e56debc57b47c422b749c93217ba62644be2Kay Sievers struct dev_ext_attribute *ea = to_ext_attr(attr); 167ca22e56debc57b47c422b749c93217ba62644be2Kay Sievers 168ca22e56debc57b47c422b749c93217ba62644be2Kay Sievers return snprintf(buf, PAGE_SIZE, "%d\n", *(int *)(ea->var)); 169ca22e56debc57b47c422b749c93217ba62644be2Kay Sievers} 170ca22e56debc57b47c422b749c93217ba62644be2Kay SieversEXPORT_SYMBOL_GPL(device_show_int); 1711da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds 1721da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds/** 1731da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds * device_release - free device structure. 1741da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds * @kobj: device's kobject. 1751da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds * 1761da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds * This is called once the reference count for the object 1771da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds * reaches 0. We forward the call to the device's release 1781da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds * method, which should handle actually freeing the structure. 1791da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds */ 1804a3ad20ccd8f4d2a0535cf98fa83f7b561ba59a9Greg Kroah-Hartmanstatic void device_release(struct kobject *kobj) 1811da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds{ 1824a3ad20ccd8f4d2a0535cf98fa83f7b561ba59a9Greg Kroah-Hartman struct device *dev = to_dev(kobj); 183fb069a5d132fb926ed17af3211a114ac7cf27d7aGreg Kroah-Hartman struct device_private *p = dev->p; 1841da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds 1851da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds if (dev->release) 1861da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds dev->release(dev); 187f9f852df2faf76a2667949ddb4947d4b8f99f02fKay Sievers else if (dev->type && dev->type->release) 188f9f852df2faf76a2667949ddb4947d4b8f99f02fKay Sievers dev->type->release(dev); 1892620efef7029bb040430f50f0fc148f2d5e002adGreg Kroah-Hartman else if (dev->class && dev->class->dev_release) 1902620efef7029bb040430f50f0fc148f2d5e002adGreg Kroah-Hartman dev->class->dev_release(dev); 191f810a5cf28a818db96333cd23646f0227ec015b4Arjan van de Ven else 192f810a5cf28a818db96333cd23646f0227ec015b4Arjan van de Ven WARN(1, KERN_ERR "Device '%s' does not have a release() " 1934a3ad20ccd8f4d2a0535cf98fa83f7b561ba59a9Greg Kroah-Hartman "function, it is broken and must be fixed.\n", 1941e0b2cf933ebf32494eba3f668859ba57f06a951Kay Sievers dev_name(dev)); 195fb069a5d132fb926ed17af3211a114ac7cf27d7aGreg Kroah-Hartman kfree(p); 1961da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds} 1971da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds 198bc451f2058238013e1cdf4acd443c01734d332f0Eric W. Biedermanstatic const void *device_namespace(struct kobject *kobj) 199bc451f2058238013e1cdf4acd443c01734d332f0Eric W. Biederman{ 200bc451f2058238013e1cdf4acd443c01734d332f0Eric W. Biederman struct device *dev = to_dev(kobj); 201bc451f2058238013e1cdf4acd443c01734d332f0Eric W. Biederman const void *ns = NULL; 202bc451f2058238013e1cdf4acd443c01734d332f0Eric W. Biederman 203bc451f2058238013e1cdf4acd443c01734d332f0Eric W. Biederman if (dev->class && dev->class->ns_type) 204bc451f2058238013e1cdf4acd443c01734d332f0Eric W. Biederman ns = dev->class->namespace(dev); 205bc451f2058238013e1cdf4acd443c01734d332f0Eric W. Biederman 206bc451f2058238013e1cdf4acd443c01734d332f0Eric W. Biederman return ns; 207bc451f2058238013e1cdf4acd443c01734d332f0Eric W. Biederman} 208bc451f2058238013e1cdf4acd443c01734d332f0Eric W. Biederman 2098f4afc410b8d2be49f34835b6bbe788f50471b02Greg Kroah-Hartmanstatic struct kobj_type device_ktype = { 2101da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds .release = device_release, 2111da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds .sysfs_ops = &dev_sysfs_ops, 212bc451f2058238013e1cdf4acd443c01734d332f0Eric W. Biederman .namespace = device_namespace, 2131da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds}; 2141da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds 2151da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds 216312c004d36ce6c739512bac83b452f4c20ab1f62Kay Sieversstatic int dev_uevent_filter(struct kset *kset, struct kobject *kobj) 2171da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds{ 2181da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds struct kobj_type *ktype = get_ktype(kobj); 2191da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds 2208f4afc410b8d2be49f34835b6bbe788f50471b02Greg Kroah-Hartman if (ktype == &device_ktype) { 2211da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds struct device *dev = to_dev(kobj); 2221da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds if (dev->bus) 2231da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds return 1; 22423681e479129854305da1da32f7f1eaf635ef22cGreg Kroah-Hartman if (dev->class) 22523681e479129854305da1da32f7f1eaf635ef22cGreg Kroah-Hartman return 1; 2261da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds } 2271da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds return 0; 2281da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds} 2291da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds 230312c004d36ce6c739512bac83b452f4c20ab1f62Kay Sieversstatic const char *dev_uevent_name(struct kset *kset, struct kobject *kobj) 2311da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds{ 2321da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds struct device *dev = to_dev(kobj); 2331da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds 23423681e479129854305da1da32f7f1eaf635ef22cGreg Kroah-Hartman if (dev->bus) 23523681e479129854305da1da32f7f1eaf635ef22cGreg Kroah-Hartman return dev->bus->name; 23623681e479129854305da1da32f7f1eaf635ef22cGreg Kroah-Hartman if (dev->class) 23723681e479129854305da1da32f7f1eaf635ef22cGreg Kroah-Hartman return dev->class->name; 23823681e479129854305da1da32f7f1eaf635ef22cGreg Kroah-Hartman return NULL; 2391da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds} 2401da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds 2417eff2e7a8b65c25920207324e56611150eb1cd9aKay Sieversstatic int dev_uevent(struct kset *kset, struct kobject *kobj, 2427eff2e7a8b65c25920207324e56611150eb1cd9aKay Sievers struct kobj_uevent_env *env) 2431da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds{ 2441da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds struct device *dev = to_dev(kobj); 2451da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds int retval = 0; 2461da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds 2476fcf53acccf85b4b0d0260e66c692a341760f464Kay Sievers /* add device node properties if present */ 24823681e479129854305da1da32f7f1eaf635ef22cGreg Kroah-Hartman if (MAJOR(dev->devt)) { 2496fcf53acccf85b4b0d0260e66c692a341760f464Kay Sievers const char *tmp; 2506fcf53acccf85b4b0d0260e66c692a341760f464Kay Sievers const char *name; 2512c9ede55ecec58099b72e4bb8eab719f32f72c31Al Viro umode_t mode = 0; 2526fcf53acccf85b4b0d0260e66c692a341760f464Kay Sievers 2537eff2e7a8b65c25920207324e56611150eb1cd9aKay Sievers add_uevent_var(env, "MAJOR=%u", MAJOR(dev->devt)); 2547eff2e7a8b65c25920207324e56611150eb1cd9aKay Sievers add_uevent_var(env, "MINOR=%u", MINOR(dev->devt)); 255e454cea20bdcff10ee698d11b8882662a0153a47Kay Sievers name = device_get_devnode(dev, &mode, &tmp); 2566fcf53acccf85b4b0d0260e66c692a341760f464Kay Sievers if (name) { 2576fcf53acccf85b4b0d0260e66c692a341760f464Kay Sievers add_uevent_var(env, "DEVNAME=%s", name); 2586fcf53acccf85b4b0d0260e66c692a341760f464Kay Sievers kfree(tmp); 259e454cea20bdcff10ee698d11b8882662a0153a47Kay Sievers if (mode) 260e454cea20bdcff10ee698d11b8882662a0153a47Kay Sievers add_uevent_var(env, "DEVMODE=%#o", mode & 0777); 2616fcf53acccf85b4b0d0260e66c692a341760f464Kay Sievers } 26223681e479129854305da1da32f7f1eaf635ef22cGreg Kroah-Hartman } 26323681e479129854305da1da32f7f1eaf635ef22cGreg Kroah-Hartman 264414264f959cf46f49f974b3510400e12ac3624a6Kay Sievers if (dev->type && dev->type->name) 2657eff2e7a8b65c25920207324e56611150eb1cd9aKay Sievers add_uevent_var(env, "DEVTYPE=%s", dev->type->name); 266414264f959cf46f49f974b3510400e12ac3624a6Kay Sievers 267239378f16aa1ab5c502e42a06359d2de4f88ebb4Kay Sievers if (dev->driver) 2687eff2e7a8b65c25920207324e56611150eb1cd9aKay Sievers add_uevent_var(env, "DRIVER=%s", dev->driver->name); 269239378f16aa1ab5c502e42a06359d2de4f88ebb4Kay Sievers 2707eff2e7a8b65c25920207324e56611150eb1cd9aKay Sievers /* have the bus specific function add its stuff */ 271312c004d36ce6c739512bac83b452f4c20ab1f62Kay Sievers if (dev->bus && dev->bus->uevent) { 2727eff2e7a8b65c25920207324e56611150eb1cd9aKay Sievers retval = dev->bus->uevent(dev, env); 273f9f852df2faf76a2667949ddb4947d4b8f99f02fKay Sievers if (retval) 2747dc72b2842381684b864750af31a5fb168dec764Greg Kroah-Hartman pr_debug("device: '%s': %s: bus uevent() returned %d\n", 2751e0b2cf933ebf32494eba3f668859ba57f06a951Kay Sievers dev_name(dev), __func__, retval); 2761da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds } 2771da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds 2787eff2e7a8b65c25920207324e56611150eb1cd9aKay Sievers /* have the class specific function add its stuff */ 2792620efef7029bb040430f50f0fc148f2d5e002adGreg Kroah-Hartman if (dev->class && dev->class->dev_uevent) { 2807eff2e7a8b65c25920207324e56611150eb1cd9aKay Sievers retval = dev->class->dev_uevent(dev, env); 281f9f852df2faf76a2667949ddb4947d4b8f99f02fKay Sievers if (retval) 2827dc72b2842381684b864750af31a5fb168dec764Greg Kroah-Hartman pr_debug("device: '%s': %s: class uevent() " 2831e0b2cf933ebf32494eba3f668859ba57f06a951Kay Sievers "returned %d\n", dev_name(dev), 2842b3a302a09735276e13421db56c20045a48eb06dHarvey Harrison __func__, retval); 285f9f852df2faf76a2667949ddb4947d4b8f99f02fKay Sievers } 286f9f852df2faf76a2667949ddb4947d4b8f99f02fKay Sievers 287eef35c2d41ddcc653c20d26b977acaa45c811e1fStefan Weil /* have the device type specific function add its stuff */ 288f9f852df2faf76a2667949ddb4947d4b8f99f02fKay Sievers if (dev->type && dev->type->uevent) { 2897eff2e7a8b65c25920207324e56611150eb1cd9aKay Sievers retval = dev->type->uevent(dev, env); 290f9f852df2faf76a2667949ddb4947d4b8f99f02fKay Sievers if (retval) 2917dc72b2842381684b864750af31a5fb168dec764Greg Kroah-Hartman pr_debug("device: '%s': %s: dev_type uevent() " 2921e0b2cf933ebf32494eba3f668859ba57f06a951Kay Sievers "returned %d\n", dev_name(dev), 2932b3a302a09735276e13421db56c20045a48eb06dHarvey Harrison __func__, retval); 2942620efef7029bb040430f50f0fc148f2d5e002adGreg Kroah-Hartman } 2952620efef7029bb040430f50f0fc148f2d5e002adGreg Kroah-Hartman 2961da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds return retval; 2971da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds} 2981da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds 2999cd43611ccfb46632bfa7d19f688924ea93f1613Emese Revfystatic const struct kset_uevent_ops device_uevent_ops = { 300312c004d36ce6c739512bac83b452f4c20ab1f62Kay Sievers .filter = dev_uevent_filter, 301312c004d36ce6c739512bac83b452f4c20ab1f62Kay Sievers .name = dev_uevent_name, 302312c004d36ce6c739512bac83b452f4c20ab1f62Kay Sievers .uevent = dev_uevent, 3031da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds}; 3041da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds 30516574dccd8f62dc1b585325f8a6a0aab10047ed8Kay Sieversstatic ssize_t show_uevent(struct device *dev, struct device_attribute *attr, 30616574dccd8f62dc1b585325f8a6a0aab10047ed8Kay Sievers char *buf) 30716574dccd8f62dc1b585325f8a6a0aab10047ed8Kay Sievers{ 30816574dccd8f62dc1b585325f8a6a0aab10047ed8Kay Sievers struct kobject *top_kobj; 30916574dccd8f62dc1b585325f8a6a0aab10047ed8Kay Sievers struct kset *kset; 3107eff2e7a8b65c25920207324e56611150eb1cd9aKay Sievers struct kobj_uevent_env *env = NULL; 31116574dccd8f62dc1b585325f8a6a0aab10047ed8Kay Sievers int i; 31216574dccd8f62dc1b585325f8a6a0aab10047ed8Kay Sievers size_t count = 0; 31316574dccd8f62dc1b585325f8a6a0aab10047ed8Kay Sievers int retval; 31416574dccd8f62dc1b585325f8a6a0aab10047ed8Kay Sievers 31516574dccd8f62dc1b585325f8a6a0aab10047ed8Kay Sievers /* search the kset, the device belongs to */ 31616574dccd8f62dc1b585325f8a6a0aab10047ed8Kay Sievers top_kobj = &dev->kobj; 3175c5daf657cb5f963a38413f2852279d7a3843144Kay Sievers while (!top_kobj->kset && top_kobj->parent) 3185c5daf657cb5f963a38413f2852279d7a3843144Kay Sievers top_kobj = top_kobj->parent; 31916574dccd8f62dc1b585325f8a6a0aab10047ed8Kay Sievers if (!top_kobj->kset) 32016574dccd8f62dc1b585325f8a6a0aab10047ed8Kay Sievers goto out; 3215c5daf657cb5f963a38413f2852279d7a3843144Kay Sievers 32216574dccd8f62dc1b585325f8a6a0aab10047ed8Kay Sievers kset = top_kobj->kset; 32316574dccd8f62dc1b585325f8a6a0aab10047ed8Kay Sievers if (!kset->uevent_ops || !kset->uevent_ops->uevent) 32416574dccd8f62dc1b585325f8a6a0aab10047ed8Kay Sievers goto out; 32516574dccd8f62dc1b585325f8a6a0aab10047ed8Kay Sievers 32616574dccd8f62dc1b585325f8a6a0aab10047ed8Kay Sievers /* respect filter */ 32716574dccd8f62dc1b585325f8a6a0aab10047ed8Kay Sievers if (kset->uevent_ops && kset->uevent_ops->filter) 32816574dccd8f62dc1b585325f8a6a0aab10047ed8Kay Sievers if (!kset->uevent_ops->filter(kset, &dev->kobj)) 32916574dccd8f62dc1b585325f8a6a0aab10047ed8Kay Sievers goto out; 33016574dccd8f62dc1b585325f8a6a0aab10047ed8Kay Sievers 3317eff2e7a8b65c25920207324e56611150eb1cd9aKay Sievers env = kzalloc(sizeof(struct kobj_uevent_env), GFP_KERNEL); 3327eff2e7a8b65c25920207324e56611150eb1cd9aKay Sievers if (!env) 333c7308c81a8220ab68eebfadde37db881a2800064Greg Kroah-Hartman return -ENOMEM; 334c7308c81a8220ab68eebfadde37db881a2800064Greg Kroah-Hartman 33516574dccd8f62dc1b585325f8a6a0aab10047ed8Kay Sievers /* let the kset specific function add its keys */ 3367eff2e7a8b65c25920207324e56611150eb1cd9aKay Sievers retval = kset->uevent_ops->uevent(kset, &dev->kobj, env); 33716574dccd8f62dc1b585325f8a6a0aab10047ed8Kay Sievers if (retval) 33816574dccd8f62dc1b585325f8a6a0aab10047ed8Kay Sievers goto out; 33916574dccd8f62dc1b585325f8a6a0aab10047ed8Kay Sievers 34016574dccd8f62dc1b585325f8a6a0aab10047ed8Kay Sievers /* copy keys to file */ 3417eff2e7a8b65c25920207324e56611150eb1cd9aKay Sievers for (i = 0; i < env->envp_idx; i++) 3427eff2e7a8b65c25920207324e56611150eb1cd9aKay Sievers count += sprintf(&buf[count], "%s\n", env->envp[i]); 34316574dccd8f62dc1b585325f8a6a0aab10047ed8Kay Sieversout: 3447eff2e7a8b65c25920207324e56611150eb1cd9aKay Sievers kfree(env); 34516574dccd8f62dc1b585325f8a6a0aab10047ed8Kay Sievers return count; 34616574dccd8f62dc1b585325f8a6a0aab10047ed8Kay Sievers} 34716574dccd8f62dc1b585325f8a6a0aab10047ed8Kay Sievers 348a7fd67062efc5b0fc9a61368c607fa92d1d57f9eKay Sieversstatic ssize_t store_uevent(struct device *dev, struct device_attribute *attr, 349a7fd67062efc5b0fc9a61368c607fa92d1d57f9eKay Sievers const char *buf, size_t count) 350a7fd67062efc5b0fc9a61368c607fa92d1d57f9eKay Sievers{ 35160a96a59569bab85571d0089682109bd3324e896Kay Sievers enum kobject_action action; 35260a96a59569bab85571d0089682109bd3324e896Kay Sievers 3533f5468c9ae293cbca43e4ffe6ca3b3235189042aKay Sievers if (kobject_action_type(buf, count, &action) == 0) 35460a96a59569bab85571d0089682109bd3324e896Kay Sievers kobject_uevent(&dev->kobj, action); 3553f5468c9ae293cbca43e4ffe6ca3b3235189042aKay Sievers else 3563f5468c9ae293cbca43e4ffe6ca3b3235189042aKay Sievers dev_err(dev, "uevent: unknown action-string\n"); 357a7fd67062efc5b0fc9a61368c607fa92d1d57f9eKay Sievers return count; 358a7fd67062efc5b0fc9a61368c607fa92d1d57f9eKay Sievers} 359a7fd67062efc5b0fc9a61368c607fa92d1d57f9eKay Sievers 360ad6a1e1c66009ba9dcd2f5c90ffa1fb4ce72fce0Tejun Heostatic struct device_attribute uevent_attr = 361ad6a1e1c66009ba9dcd2f5c90ffa1fb4ce72fce0Tejun Heo __ATTR(uevent, S_IRUGO | S_IWUSR, show_uevent, store_uevent); 362ad6a1e1c66009ba9dcd2f5c90ffa1fb4ce72fce0Tejun Heo 363621a1672f7377e08a942f205d6742d8af1292aabDmitry Torokhovstatic int device_add_attributes(struct device *dev, 364621a1672f7377e08a942f205d6742d8af1292aabDmitry Torokhov struct device_attribute *attrs) 365de0ff00d723fd821d372496e2c084805644aa5e1Greg Kroah-Hartman{ 366621a1672f7377e08a942f205d6742d8af1292aabDmitry Torokhov int error = 0; 367de0ff00d723fd821d372496e2c084805644aa5e1Greg Kroah-Hartman int i; 368621a1672f7377e08a942f205d6742d8af1292aabDmitry Torokhov 369621a1672f7377e08a942f205d6742d8af1292aabDmitry Torokhov if (attrs) { 370621a1672f7377e08a942f205d6742d8af1292aabDmitry Torokhov for (i = 0; attr_name(attrs[i]); i++) { 371621a1672f7377e08a942f205d6742d8af1292aabDmitry Torokhov error = device_create_file(dev, &attrs[i]); 372621a1672f7377e08a942f205d6742d8af1292aabDmitry Torokhov if (error) 373621a1672f7377e08a942f205d6742d8af1292aabDmitry Torokhov break; 374621a1672f7377e08a942f205d6742d8af1292aabDmitry Torokhov } 375621a1672f7377e08a942f205d6742d8af1292aabDmitry Torokhov if (error) 376621a1672f7377e08a942f205d6742d8af1292aabDmitry Torokhov while (--i >= 0) 377621a1672f7377e08a942f205d6742d8af1292aabDmitry Torokhov device_remove_file(dev, &attrs[i]); 378621a1672f7377e08a942f205d6742d8af1292aabDmitry Torokhov } 379621a1672f7377e08a942f205d6742d8af1292aabDmitry Torokhov return error; 380621a1672f7377e08a942f205d6742d8af1292aabDmitry Torokhov} 381621a1672f7377e08a942f205d6742d8af1292aabDmitry Torokhov 382621a1672f7377e08a942f205d6742d8af1292aabDmitry Torokhovstatic void device_remove_attributes(struct device *dev, 383621a1672f7377e08a942f205d6742d8af1292aabDmitry Torokhov struct device_attribute *attrs) 384621a1672f7377e08a942f205d6742d8af1292aabDmitry Torokhov{ 385621a1672f7377e08a942f205d6742d8af1292aabDmitry Torokhov int i; 386621a1672f7377e08a942f205d6742d8af1292aabDmitry Torokhov 387621a1672f7377e08a942f205d6742d8af1292aabDmitry Torokhov if (attrs) 388621a1672f7377e08a942f205d6742d8af1292aabDmitry Torokhov for (i = 0; attr_name(attrs[i]); i++) 389621a1672f7377e08a942f205d6742d8af1292aabDmitry Torokhov device_remove_file(dev, &attrs[i]); 390621a1672f7377e08a942f205d6742d8af1292aabDmitry Torokhov} 391621a1672f7377e08a942f205d6742d8af1292aabDmitry Torokhov 392c97415a72521071c235e0879f9a600014afd87b1Stefan Achatzstatic int device_add_bin_attributes(struct device *dev, 393c97415a72521071c235e0879f9a600014afd87b1Stefan Achatz struct bin_attribute *attrs) 394c97415a72521071c235e0879f9a600014afd87b1Stefan Achatz{ 395c97415a72521071c235e0879f9a600014afd87b1Stefan Achatz int error = 0; 396c97415a72521071c235e0879f9a600014afd87b1Stefan Achatz int i; 397c97415a72521071c235e0879f9a600014afd87b1Stefan Achatz 398c97415a72521071c235e0879f9a600014afd87b1Stefan Achatz if (attrs) { 399c97415a72521071c235e0879f9a600014afd87b1Stefan Achatz for (i = 0; attr_name(attrs[i]); i++) { 400c97415a72521071c235e0879f9a600014afd87b1Stefan Achatz error = device_create_bin_file(dev, &attrs[i]); 401c97415a72521071c235e0879f9a600014afd87b1Stefan Achatz if (error) 402c97415a72521071c235e0879f9a600014afd87b1Stefan Achatz break; 403c97415a72521071c235e0879f9a600014afd87b1Stefan Achatz } 404c97415a72521071c235e0879f9a600014afd87b1Stefan Achatz if (error) 405c97415a72521071c235e0879f9a600014afd87b1Stefan Achatz while (--i >= 0) 406c97415a72521071c235e0879f9a600014afd87b1Stefan Achatz device_remove_bin_file(dev, &attrs[i]); 407c97415a72521071c235e0879f9a600014afd87b1Stefan Achatz } 408c97415a72521071c235e0879f9a600014afd87b1Stefan Achatz return error; 409c97415a72521071c235e0879f9a600014afd87b1Stefan Achatz} 410c97415a72521071c235e0879f9a600014afd87b1Stefan Achatz 411c97415a72521071c235e0879f9a600014afd87b1Stefan Achatzstatic void device_remove_bin_attributes(struct device *dev, 412c97415a72521071c235e0879f9a600014afd87b1Stefan Achatz struct bin_attribute *attrs) 413c97415a72521071c235e0879f9a600014afd87b1Stefan Achatz{ 414c97415a72521071c235e0879f9a600014afd87b1Stefan Achatz int i; 415c97415a72521071c235e0879f9a600014afd87b1Stefan Achatz 416c97415a72521071c235e0879f9a600014afd87b1Stefan Achatz if (attrs) 417c97415a72521071c235e0879f9a600014afd87b1Stefan Achatz for (i = 0; attr_name(attrs[i]); i++) 418c97415a72521071c235e0879f9a600014afd87b1Stefan Achatz device_remove_bin_file(dev, &attrs[i]); 419c97415a72521071c235e0879f9a600014afd87b1Stefan Achatz} 420c97415a72521071c235e0879f9a600014afd87b1Stefan Achatz 421621a1672f7377e08a942f205d6742d8af1292aabDmitry Torokhovstatic int device_add_groups(struct device *dev, 422a4dbd6740df0872cdf0a86841f75beec8381964dDavid Brownell const struct attribute_group **groups) 423621a1672f7377e08a942f205d6742d8af1292aabDmitry Torokhov{ 424de0ff00d723fd821d372496e2c084805644aa5e1Greg Kroah-Hartman int error = 0; 425621a1672f7377e08a942f205d6742d8af1292aabDmitry Torokhov int i; 426de0ff00d723fd821d372496e2c084805644aa5e1Greg Kroah-Hartman 427621a1672f7377e08a942f205d6742d8af1292aabDmitry Torokhov if (groups) { 428621a1672f7377e08a942f205d6742d8af1292aabDmitry Torokhov for (i = 0; groups[i]; i++) { 429621a1672f7377e08a942f205d6742d8af1292aabDmitry Torokhov error = sysfs_create_group(&dev->kobj, groups[i]); 430de0ff00d723fd821d372496e2c084805644aa5e1Greg Kroah-Hartman if (error) { 431de0ff00d723fd821d372496e2c084805644aa5e1Greg Kroah-Hartman while (--i >= 0) 4324a3ad20ccd8f4d2a0535cf98fa83f7b561ba59a9Greg Kroah-Hartman sysfs_remove_group(&dev->kobj, 4334a3ad20ccd8f4d2a0535cf98fa83f7b561ba59a9Greg Kroah-Hartman groups[i]); 434621a1672f7377e08a942f205d6742d8af1292aabDmitry Torokhov break; 435de0ff00d723fd821d372496e2c084805644aa5e1Greg Kroah-Hartman } 436de0ff00d723fd821d372496e2c084805644aa5e1Greg Kroah-Hartman } 437de0ff00d723fd821d372496e2c084805644aa5e1Greg Kroah-Hartman } 438de0ff00d723fd821d372496e2c084805644aa5e1Greg Kroah-Hartman return error; 439de0ff00d723fd821d372496e2c084805644aa5e1Greg Kroah-Hartman} 440de0ff00d723fd821d372496e2c084805644aa5e1Greg Kroah-Hartman 441621a1672f7377e08a942f205d6742d8af1292aabDmitry Torokhovstatic void device_remove_groups(struct device *dev, 442a4dbd6740df0872cdf0a86841f75beec8381964dDavid Brownell const struct attribute_group **groups) 443de0ff00d723fd821d372496e2c084805644aa5e1Greg Kroah-Hartman{ 444de0ff00d723fd821d372496e2c084805644aa5e1Greg Kroah-Hartman int i; 445621a1672f7377e08a942f205d6742d8af1292aabDmitry Torokhov 446621a1672f7377e08a942f205d6742d8af1292aabDmitry Torokhov if (groups) 447621a1672f7377e08a942f205d6742d8af1292aabDmitry Torokhov for (i = 0; groups[i]; i++) 448621a1672f7377e08a942f205d6742d8af1292aabDmitry Torokhov sysfs_remove_group(&dev->kobj, groups[i]); 449de0ff00d723fd821d372496e2c084805644aa5e1Greg Kroah-Hartman} 450de0ff00d723fd821d372496e2c084805644aa5e1Greg Kroah-Hartman 4512620efef7029bb040430f50f0fc148f2d5e002adGreg Kroah-Hartmanstatic int device_add_attrs(struct device *dev) 4522620efef7029bb040430f50f0fc148f2d5e002adGreg Kroah-Hartman{ 4532620efef7029bb040430f50f0fc148f2d5e002adGreg Kroah-Hartman struct class *class = dev->class; 454aed65af1cc2f6fc9ded5a8158f1405a02cf6d2ffStephen Hemminger const struct device_type *type = dev->type; 455621a1672f7377e08a942f205d6742d8af1292aabDmitry Torokhov int error; 4562620efef7029bb040430f50f0fc148f2d5e002adGreg Kroah-Hartman 457621a1672f7377e08a942f205d6742d8af1292aabDmitry Torokhov if (class) { 458621a1672f7377e08a942f205d6742d8af1292aabDmitry Torokhov error = device_add_attributes(dev, class->dev_attrs); 459f9f852df2faf76a2667949ddb4947d4b8f99f02fKay Sievers if (error) 460621a1672f7377e08a942f205d6742d8af1292aabDmitry Torokhov return error; 461c97415a72521071c235e0879f9a600014afd87b1Stefan Achatz error = device_add_bin_attributes(dev, class->dev_bin_attrs); 462c97415a72521071c235e0879f9a600014afd87b1Stefan Achatz if (error) 463c97415a72521071c235e0879f9a600014afd87b1Stefan Achatz goto err_remove_class_attrs; 4642620efef7029bb040430f50f0fc148f2d5e002adGreg Kroah-Hartman } 465f9f852df2faf76a2667949ddb4947d4b8f99f02fKay Sievers 466621a1672f7377e08a942f205d6742d8af1292aabDmitry Torokhov if (type) { 467621a1672f7377e08a942f205d6742d8af1292aabDmitry Torokhov error = device_add_groups(dev, type->groups); 468f9f852df2faf76a2667949ddb4947d4b8f99f02fKay Sievers if (error) 469c97415a72521071c235e0879f9a600014afd87b1Stefan Achatz goto err_remove_class_bin_attrs; 470f9f852df2faf76a2667949ddb4947d4b8f99f02fKay Sievers } 471f9f852df2faf76a2667949ddb4947d4b8f99f02fKay Sievers 472621a1672f7377e08a942f205d6742d8af1292aabDmitry Torokhov error = device_add_groups(dev, dev->groups); 473621a1672f7377e08a942f205d6742d8af1292aabDmitry Torokhov if (error) 474621a1672f7377e08a942f205d6742d8af1292aabDmitry Torokhov goto err_remove_type_groups; 475621a1672f7377e08a942f205d6742d8af1292aabDmitry Torokhov 476621a1672f7377e08a942f205d6742d8af1292aabDmitry Torokhov return 0; 477621a1672f7377e08a942f205d6742d8af1292aabDmitry Torokhov 478621a1672f7377e08a942f205d6742d8af1292aabDmitry Torokhov err_remove_type_groups: 479621a1672f7377e08a942f205d6742d8af1292aabDmitry Torokhov if (type) 480621a1672f7377e08a942f205d6742d8af1292aabDmitry Torokhov device_remove_groups(dev, type->groups); 481c97415a72521071c235e0879f9a600014afd87b1Stefan Achatz err_remove_class_bin_attrs: 482c97415a72521071c235e0879f9a600014afd87b1Stefan Achatz if (class) 483c97415a72521071c235e0879f9a600014afd87b1Stefan Achatz device_remove_bin_attributes(dev, class->dev_bin_attrs); 484621a1672f7377e08a942f205d6742d8af1292aabDmitry Torokhov err_remove_class_attrs: 485621a1672f7377e08a942f205d6742d8af1292aabDmitry Torokhov if (class) 486621a1672f7377e08a942f205d6742d8af1292aabDmitry Torokhov device_remove_attributes(dev, class->dev_attrs); 487621a1672f7377e08a942f205d6742d8af1292aabDmitry Torokhov 4882620efef7029bb040430f50f0fc148f2d5e002adGreg Kroah-Hartman return error; 4892620efef7029bb040430f50f0fc148f2d5e002adGreg Kroah-Hartman} 4902620efef7029bb040430f50f0fc148f2d5e002adGreg Kroah-Hartman 4912620efef7029bb040430f50f0fc148f2d5e002adGreg Kroah-Hartmanstatic void device_remove_attrs(struct device *dev) 4922620efef7029bb040430f50f0fc148f2d5e002adGreg Kroah-Hartman{ 4932620efef7029bb040430f50f0fc148f2d5e002adGreg Kroah-Hartman struct class *class = dev->class; 494aed65af1cc2f6fc9ded5a8158f1405a02cf6d2ffStephen Hemminger const struct device_type *type = dev->type; 4952620efef7029bb040430f50f0fc148f2d5e002adGreg Kroah-Hartman 496621a1672f7377e08a942f205d6742d8af1292aabDmitry Torokhov device_remove_groups(dev, dev->groups); 497f9f852df2faf76a2667949ddb4947d4b8f99f02fKay Sievers 498621a1672f7377e08a942f205d6742d8af1292aabDmitry Torokhov if (type) 499621a1672f7377e08a942f205d6742d8af1292aabDmitry Torokhov device_remove_groups(dev, type->groups); 500621a1672f7377e08a942f205d6742d8af1292aabDmitry Torokhov 501c97415a72521071c235e0879f9a600014afd87b1Stefan Achatz if (class) { 502621a1672f7377e08a942f205d6742d8af1292aabDmitry Torokhov device_remove_attributes(dev, class->dev_attrs); 503c97415a72521071c235e0879f9a600014afd87b1Stefan Achatz device_remove_bin_attributes(dev, class->dev_bin_attrs); 504c97415a72521071c235e0879f9a600014afd87b1Stefan Achatz } 5052620efef7029bb040430f50f0fc148f2d5e002adGreg Kroah-Hartman} 5062620efef7029bb040430f50f0fc148f2d5e002adGreg Kroah-Hartman 5072620efef7029bb040430f50f0fc148f2d5e002adGreg Kroah-Hartman 50823681e479129854305da1da32f7f1eaf635ef22cGreg Kroah-Hartmanstatic ssize_t show_dev(struct device *dev, struct device_attribute *attr, 50923681e479129854305da1da32f7f1eaf635ef22cGreg Kroah-Hartman char *buf) 51023681e479129854305da1da32f7f1eaf635ef22cGreg Kroah-Hartman{ 51123681e479129854305da1da32f7f1eaf635ef22cGreg Kroah-Hartman return print_dev_t(buf, dev->devt); 51223681e479129854305da1da32f7f1eaf635ef22cGreg Kroah-Hartman} 51323681e479129854305da1da32f7f1eaf635ef22cGreg Kroah-Hartman 514ad6a1e1c66009ba9dcd2f5c90ffa1fb4ce72fce0Tejun Heostatic struct device_attribute devt_attr = 515ad6a1e1c66009ba9dcd2f5c90ffa1fb4ce72fce0Tejun Heo __ATTR(dev, S_IRUGO, show_dev, NULL); 516ad6a1e1c66009ba9dcd2f5c90ffa1fb4ce72fce0Tejun Heo 517ca22e56debc57b47c422b749c93217ba62644be2Kay Sievers/* /sys/devices/ */ 518881c6cfd7c5edfe6129006e2404654bfe5911050Greg Kroah-Hartmanstruct kset *devices_kset; 5191da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds 5201da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds/** 5214a3ad20ccd8f4d2a0535cf98fa83f7b561ba59a9Greg Kroah-Hartman * device_create_file - create sysfs attribute file for device. 5224a3ad20ccd8f4d2a0535cf98fa83f7b561ba59a9Greg Kroah-Hartman * @dev: device. 5234a3ad20ccd8f4d2a0535cf98fa83f7b561ba59a9Greg Kroah-Hartman * @attr: device attribute descriptor. 5241da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds */ 52526579ab70aa0e0ea434e6e100279d2f67c094431Phil Carmodyint device_create_file(struct device *dev, 52626579ab70aa0e0ea434e6e100279d2f67c094431Phil Carmody const struct device_attribute *attr) 5271da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds{ 5281da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds int error = 0; 5290c98b19fe571ede1f14bd95b855bcbe2cca99bcfCornelia Huck if (dev) 5301da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds error = sysfs_create_file(&dev->kobj, &attr->attr); 5311da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds return error; 5321da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds} 5331da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds 5341da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds/** 5354a3ad20ccd8f4d2a0535cf98fa83f7b561ba59a9Greg Kroah-Hartman * device_remove_file - remove sysfs attribute file. 5364a3ad20ccd8f4d2a0535cf98fa83f7b561ba59a9Greg Kroah-Hartman * @dev: device. 5374a3ad20ccd8f4d2a0535cf98fa83f7b561ba59a9Greg Kroah-Hartman * @attr: device attribute descriptor. 5381da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds */ 53926579ab70aa0e0ea434e6e100279d2f67c094431Phil Carmodyvoid device_remove_file(struct device *dev, 54026579ab70aa0e0ea434e6e100279d2f67c094431Phil Carmody const struct device_attribute *attr) 5411da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds{ 5420c98b19fe571ede1f14bd95b855bcbe2cca99bcfCornelia Huck if (dev) 5431da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds sysfs_remove_file(&dev->kobj, &attr->attr); 5441da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds} 5451da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds 5462589f1887b0bf9f08ec3d7f3c5705ccb7c628076Greg Kroah-Hartman/** 5472589f1887b0bf9f08ec3d7f3c5705ccb7c628076Greg Kroah-Hartman * device_create_bin_file - create sysfs binary attribute file for device. 5482589f1887b0bf9f08ec3d7f3c5705ccb7c628076Greg Kroah-Hartman * @dev: device. 5492589f1887b0bf9f08ec3d7f3c5705ccb7c628076Greg Kroah-Hartman * @attr: device binary attribute descriptor. 5502589f1887b0bf9f08ec3d7f3c5705ccb7c628076Greg Kroah-Hartman */ 55166ecb92be9eb579df93add22d19843e7869f168ePhil Carmodyint device_create_bin_file(struct device *dev, 55266ecb92be9eb579df93add22d19843e7869f168ePhil Carmody const struct bin_attribute *attr) 5532589f1887b0bf9f08ec3d7f3c5705ccb7c628076Greg Kroah-Hartman{ 5542589f1887b0bf9f08ec3d7f3c5705ccb7c628076Greg Kroah-Hartman int error = -EINVAL; 5552589f1887b0bf9f08ec3d7f3c5705ccb7c628076Greg Kroah-Hartman if (dev) 5562589f1887b0bf9f08ec3d7f3c5705ccb7c628076Greg Kroah-Hartman error = sysfs_create_bin_file(&dev->kobj, attr); 5572589f1887b0bf9f08ec3d7f3c5705ccb7c628076Greg Kroah-Hartman return error; 5582589f1887b0bf9f08ec3d7f3c5705ccb7c628076Greg Kroah-Hartman} 5592589f1887b0bf9f08ec3d7f3c5705ccb7c628076Greg Kroah-HartmanEXPORT_SYMBOL_GPL(device_create_bin_file); 5602589f1887b0bf9f08ec3d7f3c5705ccb7c628076Greg Kroah-Hartman 5612589f1887b0bf9f08ec3d7f3c5705ccb7c628076Greg Kroah-Hartman/** 5622589f1887b0bf9f08ec3d7f3c5705ccb7c628076Greg Kroah-Hartman * device_remove_bin_file - remove sysfs binary attribute file 5632589f1887b0bf9f08ec3d7f3c5705ccb7c628076Greg Kroah-Hartman * @dev: device. 5642589f1887b0bf9f08ec3d7f3c5705ccb7c628076Greg Kroah-Hartman * @attr: device binary attribute descriptor. 5652589f1887b0bf9f08ec3d7f3c5705ccb7c628076Greg Kroah-Hartman */ 56666ecb92be9eb579df93add22d19843e7869f168ePhil Carmodyvoid device_remove_bin_file(struct device *dev, 56766ecb92be9eb579df93add22d19843e7869f168ePhil Carmody const struct bin_attribute *attr) 5682589f1887b0bf9f08ec3d7f3c5705ccb7c628076Greg Kroah-Hartman{ 5692589f1887b0bf9f08ec3d7f3c5705ccb7c628076Greg Kroah-Hartman if (dev) 5702589f1887b0bf9f08ec3d7f3c5705ccb7c628076Greg Kroah-Hartman sysfs_remove_bin_file(&dev->kobj, attr); 5712589f1887b0bf9f08ec3d7f3c5705ccb7c628076Greg Kroah-Hartman} 5722589f1887b0bf9f08ec3d7f3c5705ccb7c628076Greg Kroah-HartmanEXPORT_SYMBOL_GPL(device_remove_bin_file); 5732589f1887b0bf9f08ec3d7f3c5705ccb7c628076Greg Kroah-Hartman 574d9a9cdfb078d755e648d53ec25b7370f84ee5729Alan Stern/** 575523ded71de0c5e66973335bf99a80edfda9f401bAlan Stern * device_schedule_callback_owner - helper to schedule a callback for a device 576d9a9cdfb078d755e648d53ec25b7370f84ee5729Alan Stern * @dev: device. 577d9a9cdfb078d755e648d53ec25b7370f84ee5729Alan Stern * @func: callback function to invoke later. 578523ded71de0c5e66973335bf99a80edfda9f401bAlan Stern * @owner: module owning the callback routine 579d9a9cdfb078d755e648d53ec25b7370f84ee5729Alan Stern * 580d9a9cdfb078d755e648d53ec25b7370f84ee5729Alan Stern * Attribute methods must not unregister themselves or their parent device 581d9a9cdfb078d755e648d53ec25b7370f84ee5729Alan Stern * (which would amount to the same thing). Attempts to do so will deadlock, 582d9a9cdfb078d755e648d53ec25b7370f84ee5729Alan Stern * since unregistration is mutually exclusive with driver callbacks. 583d9a9cdfb078d755e648d53ec25b7370f84ee5729Alan Stern * 584d9a9cdfb078d755e648d53ec25b7370f84ee5729Alan Stern * Instead methods can call this routine, which will attempt to allocate 585d9a9cdfb078d755e648d53ec25b7370f84ee5729Alan Stern * and schedule a workqueue request to call back @func with @dev as its 586d9a9cdfb078d755e648d53ec25b7370f84ee5729Alan Stern * argument in the workqueue's process context. @dev will be pinned until 587d9a9cdfb078d755e648d53ec25b7370f84ee5729Alan Stern * @func returns. 588d9a9cdfb078d755e648d53ec25b7370f84ee5729Alan Stern * 589523ded71de0c5e66973335bf99a80edfda9f401bAlan Stern * This routine is usually called via the inline device_schedule_callback(), 590523ded71de0c5e66973335bf99a80edfda9f401bAlan Stern * which automatically sets @owner to THIS_MODULE. 591523ded71de0c5e66973335bf99a80edfda9f401bAlan Stern * 592d9a9cdfb078d755e648d53ec25b7370f84ee5729Alan Stern * Returns 0 if the request was submitted, -ENOMEM if storage could not 593523ded71de0c5e66973335bf99a80edfda9f401bAlan Stern * be allocated, -ENODEV if a reference to @owner isn't available. 594d9a9cdfb078d755e648d53ec25b7370f84ee5729Alan Stern * 595d9a9cdfb078d755e648d53ec25b7370f84ee5729Alan Stern * NOTE: This routine won't work if CONFIG_SYSFS isn't set! It uses an 596d9a9cdfb078d755e648d53ec25b7370f84ee5729Alan Stern * underlying sysfs routine (since it is intended for use by attribute 597d9a9cdfb078d755e648d53ec25b7370f84ee5729Alan Stern * methods), and if sysfs isn't available you'll get nothing but -ENOSYS. 598d9a9cdfb078d755e648d53ec25b7370f84ee5729Alan Stern */ 599523ded71de0c5e66973335bf99a80edfda9f401bAlan Sternint device_schedule_callback_owner(struct device *dev, 600523ded71de0c5e66973335bf99a80edfda9f401bAlan Stern void (*func)(struct device *), struct module *owner) 601d9a9cdfb078d755e648d53ec25b7370f84ee5729Alan Stern{ 602d9a9cdfb078d755e648d53ec25b7370f84ee5729Alan Stern return sysfs_schedule_callback(&dev->kobj, 603523ded71de0c5e66973335bf99a80edfda9f401bAlan Stern (void (*)(void *)) func, dev, owner); 604d9a9cdfb078d755e648d53ec25b7370f84ee5729Alan Stern} 605523ded71de0c5e66973335bf99a80edfda9f401bAlan SternEXPORT_SYMBOL_GPL(device_schedule_callback_owner); 606d9a9cdfb078d755e648d53ec25b7370f84ee5729Alan Stern 60734bb61f9ddabd7a7f909cbfb05592eb775f6662aJames Bottomleystatic void klist_children_get(struct klist_node *n) 60834bb61f9ddabd7a7f909cbfb05592eb775f6662aJames Bottomley{ 609f791b8c836307b58cbf62133a6a772ed1a92fb33Greg Kroah-Hartman struct device_private *p = to_device_private_parent(n); 610f791b8c836307b58cbf62133a6a772ed1a92fb33Greg Kroah-Hartman struct device *dev = p->device; 61134bb61f9ddabd7a7f909cbfb05592eb775f6662aJames Bottomley 61234bb61f9ddabd7a7f909cbfb05592eb775f6662aJames Bottomley get_device(dev); 61334bb61f9ddabd7a7f909cbfb05592eb775f6662aJames Bottomley} 61434bb61f9ddabd7a7f909cbfb05592eb775f6662aJames Bottomley 61534bb61f9ddabd7a7f909cbfb05592eb775f6662aJames Bottomleystatic void klist_children_put(struct klist_node *n) 61634bb61f9ddabd7a7f909cbfb05592eb775f6662aJames Bottomley{ 617f791b8c836307b58cbf62133a6a772ed1a92fb33Greg Kroah-Hartman struct device_private *p = to_device_private_parent(n); 618f791b8c836307b58cbf62133a6a772ed1a92fb33Greg Kroah-Hartman struct device *dev = p->device; 61934bb61f9ddabd7a7f909cbfb05592eb775f6662aJames Bottomley 62034bb61f9ddabd7a7f909cbfb05592eb775f6662aJames Bottomley put_device(dev); 62134bb61f9ddabd7a7f909cbfb05592eb775f6662aJames Bottomley} 62234bb61f9ddabd7a7f909cbfb05592eb775f6662aJames Bottomley 6231da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds/** 6244a3ad20ccd8f4d2a0535cf98fa83f7b561ba59a9Greg Kroah-Hartman * device_initialize - init device structure. 6254a3ad20ccd8f4d2a0535cf98fa83f7b561ba59a9Greg Kroah-Hartman * @dev: device. 6261da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds * 6275739411acbaa63a6c22c91e340fdcdbcc7d82a51Cornelia Huck * This prepares the device for use by other layers by initializing 6285739411acbaa63a6c22c91e340fdcdbcc7d82a51Cornelia Huck * its fields. 6294a3ad20ccd8f4d2a0535cf98fa83f7b561ba59a9Greg Kroah-Hartman * It is the first half of device_register(), if called by 6305739411acbaa63a6c22c91e340fdcdbcc7d82a51Cornelia Huck * that function, though it can also be called separately, so one 6315739411acbaa63a6c22c91e340fdcdbcc7d82a51Cornelia Huck * may use @dev's fields. In particular, get_device()/put_device() 6325739411acbaa63a6c22c91e340fdcdbcc7d82a51Cornelia Huck * may be used for reference counting of @dev after calling this 6335739411acbaa63a6c22c91e340fdcdbcc7d82a51Cornelia Huck * function. 6345739411acbaa63a6c22c91e340fdcdbcc7d82a51Cornelia Huck * 635b10d5efdf7892d18b3b7d899edce2c8d9b80aea9Alan Stern * All fields in @dev must be initialized by the caller to 0, except 636b10d5efdf7892d18b3b7d899edce2c8d9b80aea9Alan Stern * for those explicitly set to some other value. The simplest 637b10d5efdf7892d18b3b7d899edce2c8d9b80aea9Alan Stern * approach is to use kzalloc() to allocate the structure containing 638b10d5efdf7892d18b3b7d899edce2c8d9b80aea9Alan Stern * @dev. 639b10d5efdf7892d18b3b7d899edce2c8d9b80aea9Alan Stern * 6405739411acbaa63a6c22c91e340fdcdbcc7d82a51Cornelia Huck * NOTE: Use put_device() to give up your reference instead of freeing 6415739411acbaa63a6c22c91e340fdcdbcc7d82a51Cornelia Huck * @dev directly once you have called this function. 6421da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds */ 6431da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvaldsvoid device_initialize(struct device *dev) 6441da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds{ 645881c6cfd7c5edfe6129006e2404654bfe5911050Greg Kroah-Hartman dev->kobj.kset = devices_kset; 646f9cb074bff8e762ef24c44678a5a7d907f82fbebGreg Kroah-Hartman kobject_init(&dev->kobj, &device_ktype); 6471da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds INIT_LIST_HEAD(&dev->dma_pools); 6483142788b7967ccfd2f1813ee9e11aeb1e1cf7de2Thomas Gleixner mutex_init(&dev->mutex); 6491704f47b50b5d9e1b825e43e1baaf2c5897baf03Peter Zijlstra lockdep_set_novalidate_class(&dev->mutex); 6509ac7849e35f705830f7b016ff272b0ff1f7ff759Tejun Heo spin_lock_init(&dev->devres_lock); 6519ac7849e35f705830f7b016ff272b0ff1f7ff759Tejun Heo INIT_LIST_HEAD(&dev->devres_head); 6523b98aeaf3a75f544dc945694f4fcf6e1c4bab89dAlan Stern device_pm_init(dev); 653873481367edb18a7d0d7e5a285e6728c16bb44a9Christoph Hellwig set_dev_node(dev, -1); 6541da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds} 6551da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds 656864062457a2e444227bd368ca5f2a2b740de604fKay Sieversstatic struct kobject *virtual_device_parent(struct device *dev) 657f0ee61a6cecd100301a60d99feb187776533b2a2Greg Kroah-Hartman{ 658864062457a2e444227bd368ca5f2a2b740de604fKay Sievers static struct kobject *virtual_dir = NULL; 659f0ee61a6cecd100301a60d99feb187776533b2a2Greg Kroah-Hartman 660864062457a2e444227bd368ca5f2a2b740de604fKay Sievers if (!virtual_dir) 6614ff6abff832fbc6cb1d769f6106c841bc2b09f63Greg Kroah-Hartman virtual_dir = kobject_create_and_add("virtual", 662881c6cfd7c5edfe6129006e2404654bfe5911050Greg Kroah-Hartman &devices_kset->kobj); 663f0ee61a6cecd100301a60d99feb187776533b2a2Greg Kroah-Hartman 664864062457a2e444227bd368ca5f2a2b740de604fKay Sievers return virtual_dir; 665f0ee61a6cecd100301a60d99feb187776533b2a2Greg Kroah-Hartman} 666f0ee61a6cecd100301a60d99feb187776533b2a2Greg Kroah-Hartman 667bc451f2058238013e1cdf4acd443c01734d332f0Eric W. Biedermanstruct class_dir { 668bc451f2058238013e1cdf4acd443c01734d332f0Eric W. Biederman struct kobject kobj; 669bc451f2058238013e1cdf4acd443c01734d332f0Eric W. Biederman struct class *class; 670bc451f2058238013e1cdf4acd443c01734d332f0Eric W. Biederman}; 671bc451f2058238013e1cdf4acd443c01734d332f0Eric W. Biederman 672bc451f2058238013e1cdf4acd443c01734d332f0Eric W. Biederman#define to_class_dir(obj) container_of(obj, struct class_dir, kobj) 673bc451f2058238013e1cdf4acd443c01734d332f0Eric W. Biederman 674bc451f2058238013e1cdf4acd443c01734d332f0Eric W. Biedermanstatic void class_dir_release(struct kobject *kobj) 675bc451f2058238013e1cdf4acd443c01734d332f0Eric W. Biederman{ 676bc451f2058238013e1cdf4acd443c01734d332f0Eric W. Biederman struct class_dir *dir = to_class_dir(kobj); 677bc451f2058238013e1cdf4acd443c01734d332f0Eric W. Biederman kfree(dir); 678bc451f2058238013e1cdf4acd443c01734d332f0Eric W. Biederman} 679bc451f2058238013e1cdf4acd443c01734d332f0Eric W. Biederman 680bc451f2058238013e1cdf4acd443c01734d332f0Eric W. Biedermanstatic const 681bc451f2058238013e1cdf4acd443c01734d332f0Eric W. Biedermanstruct kobj_ns_type_operations *class_dir_child_ns_type(struct kobject *kobj) 68240fa54226f518a9bc97ed1d711c0016e416e3782Greg Kroah-Hartman{ 683bc451f2058238013e1cdf4acd443c01734d332f0Eric W. Biederman struct class_dir *dir = to_class_dir(kobj); 684bc451f2058238013e1cdf4acd443c01734d332f0Eric W. Biederman return dir->class->ns_type; 685bc451f2058238013e1cdf4acd443c01734d332f0Eric W. Biederman} 686bc451f2058238013e1cdf4acd443c01734d332f0Eric W. Biederman 687bc451f2058238013e1cdf4acd443c01734d332f0Eric W. Biedermanstatic struct kobj_type class_dir_ktype = { 688bc451f2058238013e1cdf4acd443c01734d332f0Eric W. Biederman .release = class_dir_release, 689bc451f2058238013e1cdf4acd443c01734d332f0Eric W. Biederman .sysfs_ops = &kobj_sysfs_ops, 690bc451f2058238013e1cdf4acd443c01734d332f0Eric W. Biederman .child_ns_type = class_dir_child_ns_type 691bc451f2058238013e1cdf4acd443c01734d332f0Eric W. Biederman}; 692bc451f2058238013e1cdf4acd443c01734d332f0Eric W. Biederman 693bc451f2058238013e1cdf4acd443c01734d332f0Eric W. Biedermanstatic struct kobject * 694bc451f2058238013e1cdf4acd443c01734d332f0Eric W. Biedermanclass_dir_create_and_add(struct class *class, struct kobject *parent_kobj) 695bc451f2058238013e1cdf4acd443c01734d332f0Eric W. Biederman{ 696bc451f2058238013e1cdf4acd443c01734d332f0Eric W. Biederman struct class_dir *dir; 69743968d2f1648f4dc92437dc0363a3e88377445b3Greg Kroah-Hartman int retval; 69843968d2f1648f4dc92437dc0363a3e88377445b3Greg Kroah-Hartman 699bc451f2058238013e1cdf4acd443c01734d332f0Eric W. Biederman dir = kzalloc(sizeof(*dir), GFP_KERNEL); 700bc451f2058238013e1cdf4acd443c01734d332f0Eric W. Biederman if (!dir) 701bc451f2058238013e1cdf4acd443c01734d332f0Eric W. Biederman return NULL; 702bc451f2058238013e1cdf4acd443c01734d332f0Eric W. Biederman 703bc451f2058238013e1cdf4acd443c01734d332f0Eric W. Biederman dir->class = class; 704bc451f2058238013e1cdf4acd443c01734d332f0Eric W. Biederman kobject_init(&dir->kobj, &class_dir_ktype); 705bc451f2058238013e1cdf4acd443c01734d332f0Eric W. Biederman 7066b6e39a6a8da7234c538d14c43d3583da8875f9cKay Sievers dir->kobj.kset = &class->p->glue_dirs; 707bc451f2058238013e1cdf4acd443c01734d332f0Eric W. Biederman 708bc451f2058238013e1cdf4acd443c01734d332f0Eric W. Biederman retval = kobject_add(&dir->kobj, parent_kobj, "%s", class->name); 709bc451f2058238013e1cdf4acd443c01734d332f0Eric W. Biederman if (retval < 0) { 710bc451f2058238013e1cdf4acd443c01734d332f0Eric W. Biederman kobject_put(&dir->kobj); 711bc451f2058238013e1cdf4acd443c01734d332f0Eric W. Biederman return NULL; 712bc451f2058238013e1cdf4acd443c01734d332f0Eric W. Biederman } 713bc451f2058238013e1cdf4acd443c01734d332f0Eric W. Biederman return &dir->kobj; 714bc451f2058238013e1cdf4acd443c01734d332f0Eric W. Biederman} 715bc451f2058238013e1cdf4acd443c01734d332f0Eric W. Biederman 716bc451f2058238013e1cdf4acd443c01734d332f0Eric W. Biederman 717bc451f2058238013e1cdf4acd443c01734d332f0Eric W. Biedermanstatic struct kobject *get_device_parent(struct device *dev, 718bc451f2058238013e1cdf4acd443c01734d332f0Eric W. Biederman struct device *parent) 719bc451f2058238013e1cdf4acd443c01734d332f0Eric W. Biederman{ 720864062457a2e444227bd368ca5f2a2b740de604fKay Sievers if (dev->class) { 72177d3d7c1d561f49f755d7390f0764dff90765974Tejun Heo static DEFINE_MUTEX(gdp_mutex); 722864062457a2e444227bd368ca5f2a2b740de604fKay Sievers struct kobject *kobj = NULL; 723864062457a2e444227bd368ca5f2a2b740de604fKay Sievers struct kobject *parent_kobj; 724864062457a2e444227bd368ca5f2a2b740de604fKay Sievers struct kobject *k; 725864062457a2e444227bd368ca5f2a2b740de604fKay Sievers 726ead454feb6cbfe0fa6a1eeb30aa9abc338dacf62Randy Dunlap#ifdef CONFIG_BLOCK 72739aba963d937edb20db7d9d93e6dda5d2adfdcddKay Sievers /* block disks show up in /sys/block */ 728e52eec13cd6b7f30ab19081b387813e03e592ae5Andi Kleen if (sysfs_deprecated && dev->class == &block_class) { 72939aba963d937edb20db7d9d93e6dda5d2adfdcddKay Sievers if (parent && parent->class == &block_class) 73039aba963d937edb20db7d9d93e6dda5d2adfdcddKay Sievers return &parent->kobj; 7316b6e39a6a8da7234c538d14c43d3583da8875f9cKay Sievers return &block_class.p->subsys.kobj; 73239aba963d937edb20db7d9d93e6dda5d2adfdcddKay Sievers } 733ead454feb6cbfe0fa6a1eeb30aa9abc338dacf62Randy Dunlap#endif 734e52eec13cd6b7f30ab19081b387813e03e592ae5Andi Kleen 735864062457a2e444227bd368ca5f2a2b740de604fKay Sievers /* 736864062457a2e444227bd368ca5f2a2b740de604fKay Sievers * If we have no parent, we live in "virtual". 7370f4dafc0563c6c49e17fe14b3f5f356e4c4b8806Kay Sievers * Class-devices with a non class-device as parent, live 7380f4dafc0563c6c49e17fe14b3f5f356e4c4b8806Kay Sievers * in a "glue" directory to prevent namespace collisions. 739864062457a2e444227bd368ca5f2a2b740de604fKay Sievers */ 740864062457a2e444227bd368ca5f2a2b740de604fKay Sievers if (parent == NULL) 741864062457a2e444227bd368ca5f2a2b740de604fKay Sievers parent_kobj = virtual_device_parent(dev); 74224b1442d01ae155ea716dfb94ed21605541c317dEric W. Biederman else if (parent->class && !dev->class->ns_type) 743864062457a2e444227bd368ca5f2a2b740de604fKay Sievers return &parent->kobj; 744864062457a2e444227bd368ca5f2a2b740de604fKay Sievers else 745864062457a2e444227bd368ca5f2a2b740de604fKay Sievers parent_kobj = &parent->kobj; 746864062457a2e444227bd368ca5f2a2b740de604fKay Sievers 74777d3d7c1d561f49f755d7390f0764dff90765974Tejun Heo mutex_lock(&gdp_mutex); 74877d3d7c1d561f49f755d7390f0764dff90765974Tejun Heo 749864062457a2e444227bd368ca5f2a2b740de604fKay Sievers /* find our class-directory at the parent and reference it */ 7506b6e39a6a8da7234c538d14c43d3583da8875f9cKay Sievers spin_lock(&dev->class->p->glue_dirs.list_lock); 7516b6e39a6a8da7234c538d14c43d3583da8875f9cKay Sievers list_for_each_entry(k, &dev->class->p->glue_dirs.list, entry) 752864062457a2e444227bd368ca5f2a2b740de604fKay Sievers if (k->parent == parent_kobj) { 753864062457a2e444227bd368ca5f2a2b740de604fKay Sievers kobj = kobject_get(k); 754864062457a2e444227bd368ca5f2a2b740de604fKay Sievers break; 755864062457a2e444227bd368ca5f2a2b740de604fKay Sievers } 7566b6e39a6a8da7234c538d14c43d3583da8875f9cKay Sievers spin_unlock(&dev->class->p->glue_dirs.list_lock); 75777d3d7c1d561f49f755d7390f0764dff90765974Tejun Heo if (kobj) { 75877d3d7c1d561f49f755d7390f0764dff90765974Tejun Heo mutex_unlock(&gdp_mutex); 759864062457a2e444227bd368ca5f2a2b740de604fKay Sievers return kobj; 76077d3d7c1d561f49f755d7390f0764dff90765974Tejun Heo } 761864062457a2e444227bd368ca5f2a2b740de604fKay Sievers 762864062457a2e444227bd368ca5f2a2b740de604fKay Sievers /* or create a new class-directory at the parent device */ 763bc451f2058238013e1cdf4acd443c01734d332f0Eric W. Biederman k = class_dir_create_and_add(dev->class, parent_kobj); 7640f4dafc0563c6c49e17fe14b3f5f356e4c4b8806Kay Sievers /* do not emit an uevent for this simple "glue" directory */ 76577d3d7c1d561f49f755d7390f0764dff90765974Tejun Heo mutex_unlock(&gdp_mutex); 76643968d2f1648f4dc92437dc0363a3e88377445b3Greg Kroah-Hartman return k; 767864062457a2e444227bd368ca5f2a2b740de604fKay Sievers } 768864062457a2e444227bd368ca5f2a2b740de604fKay Sievers 769ca22e56debc57b47c422b749c93217ba62644be2Kay Sievers /* subsystems can specify a default root directory for their devices */ 770ca22e56debc57b47c422b749c93217ba62644be2Kay Sievers if (!parent && dev->bus && dev->bus->dev_root) 771ca22e56debc57b47c422b749c93217ba62644be2Kay Sievers return &dev->bus->dev_root->kobj; 772ca22e56debc57b47c422b749c93217ba62644be2Kay Sievers 773864062457a2e444227bd368ca5f2a2b740de604fKay Sievers if (parent) 774c744aeae9d173a953b771a7ad5c872f91fa99decCornelia Huck return &parent->kobj; 775c744aeae9d173a953b771a7ad5c872f91fa99decCornelia Huck return NULL; 776c744aeae9d173a953b771a7ad5c872f91fa99decCornelia Huck} 777da231fd5d113ab6da5dab7a2d2c38d0a540f939cKay Sievers 77863b6971a0876b744e2fcf3c9df15d130501e1debCornelia Huckstatic void cleanup_glue_dir(struct device *dev, struct kobject *glue_dir) 779da231fd5d113ab6da5dab7a2d2c38d0a540f939cKay Sievers{ 7800f4dafc0563c6c49e17fe14b3f5f356e4c4b8806Kay Sievers /* see if we live in a "glue" directory */ 781c1fe539a7e031302af1d121163e7ce68e679ba8cCornelia Huck if (!glue_dir || !dev->class || 7826b6e39a6a8da7234c538d14c43d3583da8875f9cKay Sievers glue_dir->kset != &dev->class->p->glue_dirs) 783da231fd5d113ab6da5dab7a2d2c38d0a540f939cKay Sievers return; 784da231fd5d113ab6da5dab7a2d2c38d0a540f939cKay Sievers 7850f4dafc0563c6c49e17fe14b3f5f356e4c4b8806Kay Sievers kobject_put(glue_dir); 786da231fd5d113ab6da5dab7a2d2c38d0a540f939cKay Sievers} 78763b6971a0876b744e2fcf3c9df15d130501e1debCornelia Huck 78863b6971a0876b744e2fcf3c9df15d130501e1debCornelia Huckstatic void cleanup_device_parent(struct device *dev) 78963b6971a0876b744e2fcf3c9df15d130501e1debCornelia Huck{ 79063b6971a0876b744e2fcf3c9df15d130501e1debCornelia Huck cleanup_glue_dir(dev, dev->kobj.parent); 79163b6971a0876b744e2fcf3c9df15d130501e1debCornelia Huck} 792864062457a2e444227bd368ca5f2a2b740de604fKay Sievers 7932ee97caf0a6602f749ddbfdb1449e383e1212707Cornelia Huckstatic int device_add_class_symlinks(struct device *dev) 7942ee97caf0a6602f749ddbfdb1449e383e1212707Cornelia Huck{ 7952ee97caf0a6602f749ddbfdb1449e383e1212707Cornelia Huck int error; 7962ee97caf0a6602f749ddbfdb1449e383e1212707Cornelia Huck 7972ee97caf0a6602f749ddbfdb1449e383e1212707Cornelia Huck if (!dev->class) 7982ee97caf0a6602f749ddbfdb1449e383e1212707Cornelia Huck return 0; 799da231fd5d113ab6da5dab7a2d2c38d0a540f939cKay Sievers 8001fbfee6c6dc0f4a4c587b6b163ee79643fc9aaa7Greg Kroah-Hartman error = sysfs_create_link(&dev->kobj, 8016b6e39a6a8da7234c538d14c43d3583da8875f9cKay Sievers &dev->class->p->subsys.kobj, 8022ee97caf0a6602f749ddbfdb1449e383e1212707Cornelia Huck "subsystem"); 8032ee97caf0a6602f749ddbfdb1449e383e1212707Cornelia Huck if (error) 8042ee97caf0a6602f749ddbfdb1449e383e1212707Cornelia Huck goto out; 805da231fd5d113ab6da5dab7a2d2c38d0a540f939cKay Sievers 8064e886c29610f4374d8971ec7a248f011cc3bd73aGreg Kroah-Hartman if (dev->parent && device_is_not_partition(dev)) { 80739aba963d937edb20db7d9d93e6dda5d2adfdcddKay Sievers error = sysfs_create_link(&dev->kobj, &dev->parent->kobj, 8084f01a757e75f2a3cab2bab89c4176498963946b9Dmitry Torokhov "device"); 8094f01a757e75f2a3cab2bab89c4176498963946b9Dmitry Torokhov if (error) 81039aba963d937edb20db7d9d93e6dda5d2adfdcddKay Sievers goto out_subsys; 8112ee97caf0a6602f749ddbfdb1449e383e1212707Cornelia Huck } 8122ee97caf0a6602f749ddbfdb1449e383e1212707Cornelia Huck 813ead454feb6cbfe0fa6a1eeb30aa9abc338dacf62Randy Dunlap#ifdef CONFIG_BLOCK 81439aba963d937edb20db7d9d93e6dda5d2adfdcddKay Sievers /* /sys/block has directories and does not need symlinks */ 815e52eec13cd6b7f30ab19081b387813e03e592ae5Andi Kleen if (sysfs_deprecated && dev->class == &block_class) 81639aba963d937edb20db7d9d93e6dda5d2adfdcddKay Sievers return 0; 817ead454feb6cbfe0fa6a1eeb30aa9abc338dacf62Randy Dunlap#endif 81839aba963d937edb20db7d9d93e6dda5d2adfdcddKay Sievers 819da231fd5d113ab6da5dab7a2d2c38d0a540f939cKay Sievers /* link in the class directory pointing to the device */ 8206b6e39a6a8da7234c538d14c43d3583da8875f9cKay Sievers error = sysfs_create_link(&dev->class->p->subsys.kobj, 8211e0b2cf933ebf32494eba3f668859ba57f06a951Kay Sievers &dev->kobj, dev_name(dev)); 822da231fd5d113ab6da5dab7a2d2c38d0a540f939cKay Sievers if (error) 82339aba963d937edb20db7d9d93e6dda5d2adfdcddKay Sievers goto out_device; 824da231fd5d113ab6da5dab7a2d2c38d0a540f939cKay Sievers 825da231fd5d113ab6da5dab7a2d2c38d0a540f939cKay Sievers return 0; 826da231fd5d113ab6da5dab7a2d2c38d0a540f939cKay Sievers 82739aba963d937edb20db7d9d93e6dda5d2adfdcddKay Sieversout_device: 82839aba963d937edb20db7d9d93e6dda5d2adfdcddKay Sievers sysfs_remove_link(&dev->kobj, "device"); 829da231fd5d113ab6da5dab7a2d2c38d0a540f939cKay Sievers 8302ee97caf0a6602f749ddbfdb1449e383e1212707Cornelia Huckout_subsys: 8312ee97caf0a6602f749ddbfdb1449e383e1212707Cornelia Huck sysfs_remove_link(&dev->kobj, "subsystem"); 8322ee97caf0a6602f749ddbfdb1449e383e1212707Cornelia Huckout: 8332ee97caf0a6602f749ddbfdb1449e383e1212707Cornelia Huck return error; 8342ee97caf0a6602f749ddbfdb1449e383e1212707Cornelia Huck} 8352ee97caf0a6602f749ddbfdb1449e383e1212707Cornelia Huck 8362ee97caf0a6602f749ddbfdb1449e383e1212707Cornelia Huckstatic void device_remove_class_symlinks(struct device *dev) 8372ee97caf0a6602f749ddbfdb1449e383e1212707Cornelia Huck{ 8382ee97caf0a6602f749ddbfdb1449e383e1212707Cornelia Huck if (!dev->class) 8392ee97caf0a6602f749ddbfdb1449e383e1212707Cornelia Huck return; 840da231fd5d113ab6da5dab7a2d2c38d0a540f939cKay Sievers 8414e886c29610f4374d8971ec7a248f011cc3bd73aGreg Kroah-Hartman if (dev->parent && device_is_not_partition(dev)) 842da231fd5d113ab6da5dab7a2d2c38d0a540f939cKay Sievers sysfs_remove_link(&dev->kobj, "device"); 8432ee97caf0a6602f749ddbfdb1449e383e1212707Cornelia Huck sysfs_remove_link(&dev->kobj, "subsystem"); 844ead454feb6cbfe0fa6a1eeb30aa9abc338dacf62Randy Dunlap#ifdef CONFIG_BLOCK 845e52eec13cd6b7f30ab19081b387813e03e592ae5Andi Kleen if (sysfs_deprecated && dev->class == &block_class) 84639aba963d937edb20db7d9d93e6dda5d2adfdcddKay Sievers return; 847ead454feb6cbfe0fa6a1eeb30aa9abc338dacf62Randy Dunlap#endif 8486b6e39a6a8da7234c538d14c43d3583da8875f9cKay Sievers sysfs_delete_link(&dev->class->p->subsys.kobj, &dev->kobj, dev_name(dev)); 8492ee97caf0a6602f749ddbfdb1449e383e1212707Cornelia Huck} 8502ee97caf0a6602f749ddbfdb1449e383e1212707Cornelia Huck 8511da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds/** 852413c239fad68258157f903b3ffd9bfcc53f5e34bStephen Rothwell * dev_set_name - set a device name 853413c239fad68258157f903b3ffd9bfcc53f5e34bStephen Rothwell * @dev: device 8544623236619ff5ce233136d13ee2747c194a63591Randy Dunlap * @fmt: format string for the device's name 855413c239fad68258157f903b3ffd9bfcc53f5e34bStephen Rothwell */ 856413c239fad68258157f903b3ffd9bfcc53f5e34bStephen Rothwellint dev_set_name(struct device *dev, const char *fmt, ...) 857413c239fad68258157f903b3ffd9bfcc53f5e34bStephen Rothwell{ 858413c239fad68258157f903b3ffd9bfcc53f5e34bStephen Rothwell va_list vargs; 8591fa5ae857bb14f6046205171d98506d8112dd74eKay Sievers int err; 860413c239fad68258157f903b3ffd9bfcc53f5e34bStephen Rothwell 861413c239fad68258157f903b3ffd9bfcc53f5e34bStephen Rothwell va_start(vargs, fmt); 8621fa5ae857bb14f6046205171d98506d8112dd74eKay Sievers err = kobject_set_name_vargs(&dev->kobj, fmt, vargs); 863413c239fad68258157f903b3ffd9bfcc53f5e34bStephen Rothwell va_end(vargs); 8641fa5ae857bb14f6046205171d98506d8112dd74eKay Sievers return err; 865413c239fad68258157f903b3ffd9bfcc53f5e34bStephen Rothwell} 866413c239fad68258157f903b3ffd9bfcc53f5e34bStephen RothwellEXPORT_SYMBOL_GPL(dev_set_name); 867413c239fad68258157f903b3ffd9bfcc53f5e34bStephen Rothwell 868413c239fad68258157f903b3ffd9bfcc53f5e34bStephen Rothwell/** 869e105b8bfc769b0545b6f0f395179d1e43cbee822Dan Williams * device_to_dev_kobj - select a /sys/dev/ directory for the device 870e105b8bfc769b0545b6f0f395179d1e43cbee822Dan Williams * @dev: device 871e105b8bfc769b0545b6f0f395179d1e43cbee822Dan Williams * 872e105b8bfc769b0545b6f0f395179d1e43cbee822Dan Williams * By default we select char/ for new entries. Setting class->dev_obj 873e105b8bfc769b0545b6f0f395179d1e43cbee822Dan Williams * to NULL prevents an entry from being created. class->dev_kobj must 874e105b8bfc769b0545b6f0f395179d1e43cbee822Dan Williams * be set (or cleared) before any devices are registered to the class 875e105b8bfc769b0545b6f0f395179d1e43cbee822Dan Williams * otherwise device_create_sys_dev_entry() and 876e105b8bfc769b0545b6f0f395179d1e43cbee822Dan Williams * device_remove_sys_dev_entry() will disagree about the the presence 877e105b8bfc769b0545b6f0f395179d1e43cbee822Dan Williams * of the link. 878e105b8bfc769b0545b6f0f395179d1e43cbee822Dan Williams */ 879e105b8bfc769b0545b6f0f395179d1e43cbee822Dan Williamsstatic struct kobject *device_to_dev_kobj(struct device *dev) 880e105b8bfc769b0545b6f0f395179d1e43cbee822Dan Williams{ 881e105b8bfc769b0545b6f0f395179d1e43cbee822Dan Williams struct kobject *kobj; 882e105b8bfc769b0545b6f0f395179d1e43cbee822Dan Williams 883e105b8bfc769b0545b6f0f395179d1e43cbee822Dan Williams if (dev->class) 884e105b8bfc769b0545b6f0f395179d1e43cbee822Dan Williams kobj = dev->class->dev_kobj; 885e105b8bfc769b0545b6f0f395179d1e43cbee822Dan Williams else 886e105b8bfc769b0545b6f0f395179d1e43cbee822Dan Williams kobj = sysfs_dev_char_kobj; 887e105b8bfc769b0545b6f0f395179d1e43cbee822Dan Williams 888e105b8bfc769b0545b6f0f395179d1e43cbee822Dan Williams return kobj; 889e105b8bfc769b0545b6f0f395179d1e43cbee822Dan Williams} 890e105b8bfc769b0545b6f0f395179d1e43cbee822Dan Williams 891e105b8bfc769b0545b6f0f395179d1e43cbee822Dan Williamsstatic int device_create_sys_dev_entry(struct device *dev) 892e105b8bfc769b0545b6f0f395179d1e43cbee822Dan Williams{ 893e105b8bfc769b0545b6f0f395179d1e43cbee822Dan Williams struct kobject *kobj = device_to_dev_kobj(dev); 894e105b8bfc769b0545b6f0f395179d1e43cbee822Dan Williams int error = 0; 895e105b8bfc769b0545b6f0f395179d1e43cbee822Dan Williams char devt_str[15]; 896e105b8bfc769b0545b6f0f395179d1e43cbee822Dan Williams 897e105b8bfc769b0545b6f0f395179d1e43cbee822Dan Williams if (kobj) { 898e105b8bfc769b0545b6f0f395179d1e43cbee822Dan Williams format_dev_t(devt_str, dev->devt); 899e105b8bfc769b0545b6f0f395179d1e43cbee822Dan Williams error = sysfs_create_link(kobj, &dev->kobj, devt_str); 900e105b8bfc769b0545b6f0f395179d1e43cbee822Dan Williams } 901e105b8bfc769b0545b6f0f395179d1e43cbee822Dan Williams 902e105b8bfc769b0545b6f0f395179d1e43cbee822Dan Williams return error; 903e105b8bfc769b0545b6f0f395179d1e43cbee822Dan Williams} 904e105b8bfc769b0545b6f0f395179d1e43cbee822Dan Williams 905e105b8bfc769b0545b6f0f395179d1e43cbee822Dan Williamsstatic void device_remove_sys_dev_entry(struct device *dev) 906e105b8bfc769b0545b6f0f395179d1e43cbee822Dan Williams{ 907e105b8bfc769b0545b6f0f395179d1e43cbee822Dan Williams struct kobject *kobj = device_to_dev_kobj(dev); 908e105b8bfc769b0545b6f0f395179d1e43cbee822Dan Williams char devt_str[15]; 909e105b8bfc769b0545b6f0f395179d1e43cbee822Dan Williams 910e105b8bfc769b0545b6f0f395179d1e43cbee822Dan Williams if (kobj) { 911e105b8bfc769b0545b6f0f395179d1e43cbee822Dan Williams format_dev_t(devt_str, dev->devt); 912e105b8bfc769b0545b6f0f395179d1e43cbee822Dan Williams sysfs_remove_link(kobj, devt_str); 913e105b8bfc769b0545b6f0f395179d1e43cbee822Dan Williams } 914e105b8bfc769b0545b6f0f395179d1e43cbee822Dan Williams} 915e105b8bfc769b0545b6f0f395179d1e43cbee822Dan Williams 916b4028437876866aba4747a655ede00f892089e14Greg Kroah-Hartmanint device_private_init(struct device *dev) 917b4028437876866aba4747a655ede00f892089e14Greg Kroah-Hartman{ 918b4028437876866aba4747a655ede00f892089e14Greg Kroah-Hartman dev->p = kzalloc(sizeof(*dev->p), GFP_KERNEL); 919b4028437876866aba4747a655ede00f892089e14Greg Kroah-Hartman if (!dev->p) 920b4028437876866aba4747a655ede00f892089e14Greg Kroah-Hartman return -ENOMEM; 921b4028437876866aba4747a655ede00f892089e14Greg Kroah-Hartman dev->p->device = dev; 922b4028437876866aba4747a655ede00f892089e14Greg Kroah-Hartman klist_init(&dev->p->klist_children, klist_children_get, 923b4028437876866aba4747a655ede00f892089e14Greg Kroah-Hartman klist_children_put); 924b4028437876866aba4747a655ede00f892089e14Greg Kroah-Hartman return 0; 925b4028437876866aba4747a655ede00f892089e14Greg Kroah-Hartman} 926b4028437876866aba4747a655ede00f892089e14Greg Kroah-Hartman 927e105b8bfc769b0545b6f0f395179d1e43cbee822Dan Williams/** 9284a3ad20ccd8f4d2a0535cf98fa83f7b561ba59a9Greg Kroah-Hartman * device_add - add device to device hierarchy. 9294a3ad20ccd8f4d2a0535cf98fa83f7b561ba59a9Greg Kroah-Hartman * @dev: device. 9301da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds * 9314a3ad20ccd8f4d2a0535cf98fa83f7b561ba59a9Greg Kroah-Hartman * This is part 2 of device_register(), though may be called 9324a3ad20ccd8f4d2a0535cf98fa83f7b561ba59a9Greg Kroah-Hartman * separately _iff_ device_initialize() has been called separately. 9331da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds * 9345739411acbaa63a6c22c91e340fdcdbcc7d82a51Cornelia Huck * This adds @dev to the kobject hierarchy via kobject_add(), adds it 9354a3ad20ccd8f4d2a0535cf98fa83f7b561ba59a9Greg Kroah-Hartman * to the global and sibling lists for the device, then 9364a3ad20ccd8f4d2a0535cf98fa83f7b561ba59a9Greg Kroah-Hartman * adds it to the other relevant subsystems of the driver model. 9375739411acbaa63a6c22c91e340fdcdbcc7d82a51Cornelia Huck * 938b10d5efdf7892d18b3b7d899edce2c8d9b80aea9Alan Stern * Do not call this routine or device_register() more than once for 939b10d5efdf7892d18b3b7d899edce2c8d9b80aea9Alan Stern * any device structure. The driver model core is not designed to work 940b10d5efdf7892d18b3b7d899edce2c8d9b80aea9Alan Stern * with devices that get unregistered and then spring back to life. 941b10d5efdf7892d18b3b7d899edce2c8d9b80aea9Alan Stern * (Among other things, it's very hard to guarantee that all references 942b10d5efdf7892d18b3b7d899edce2c8d9b80aea9Alan Stern * to the previous incarnation of @dev have been dropped.) Allocate 943b10d5efdf7892d18b3b7d899edce2c8d9b80aea9Alan Stern * and register a fresh new struct device instead. 944b10d5efdf7892d18b3b7d899edce2c8d9b80aea9Alan Stern * 9455739411acbaa63a6c22c91e340fdcdbcc7d82a51Cornelia Huck * NOTE: _Never_ directly free @dev after calling this function, even 9465739411acbaa63a6c22c91e340fdcdbcc7d82a51Cornelia Huck * if it returned an error! Always use put_device() to give up your 9475739411acbaa63a6c22c91e340fdcdbcc7d82a51Cornelia Huck * reference instead. 9481da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds */ 9491da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvaldsint device_add(struct device *dev) 9501da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds{ 9511da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds struct device *parent = NULL; 952ca22e56debc57b47c422b749c93217ba62644be2Kay Sievers struct kobject *kobj; 953c47ed219ba81632595e9f02e27318151fec16c9eGreg Kroah-Hartman struct class_interface *class_intf; 954c906a48adc74fc455378137ac5124b13e7030a15Greg Kroah-Hartman int error = -EINVAL; 955775b64d2b6ca37697de925f70799c710aab5849aRafael J. Wysocki 9561da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds dev = get_device(dev); 957c906a48adc74fc455378137ac5124b13e7030a15Greg Kroah-Hartman if (!dev) 958c906a48adc74fc455378137ac5124b13e7030a15Greg Kroah-Hartman goto done; 959c906a48adc74fc455378137ac5124b13e7030a15Greg Kroah-Hartman 960fb069a5d132fb926ed17af3211a114ac7cf27d7aGreg Kroah-Hartman if (!dev->p) { 961b4028437876866aba4747a655ede00f892089e14Greg Kroah-Hartman error = device_private_init(dev); 962b4028437876866aba4747a655ede00f892089e14Greg Kroah-Hartman if (error) 963b4028437876866aba4747a655ede00f892089e14Greg Kroah-Hartman goto done; 964fb069a5d132fb926ed17af3211a114ac7cf27d7aGreg Kroah-Hartman } 965fb069a5d132fb926ed17af3211a114ac7cf27d7aGreg Kroah-Hartman 9661fa5ae857bb14f6046205171d98506d8112dd74eKay Sievers /* 9671fa5ae857bb14f6046205171d98506d8112dd74eKay Sievers * for statically allocated devices, which should all be converted 9681fa5ae857bb14f6046205171d98506d8112dd74eKay Sievers * some day, we need to initialize the name. We prevent reading back 9691fa5ae857bb14f6046205171d98506d8112dd74eKay Sievers * the name, and force the use of dev_name() 9701fa5ae857bb14f6046205171d98506d8112dd74eKay Sievers */ 9711fa5ae857bb14f6046205171d98506d8112dd74eKay Sievers if (dev->init_name) { 972acc0e90fbccbc6e4d48184cba0983ea044e131afGreg Kroah-Hartman dev_set_name(dev, "%s", dev->init_name); 9731fa5ae857bb14f6046205171d98506d8112dd74eKay Sievers dev->init_name = NULL; 9741fa5ae857bb14f6046205171d98506d8112dd74eKay Sievers } 975c906a48adc74fc455378137ac5124b13e7030a15Greg Kroah-Hartman 976ca22e56debc57b47c422b749c93217ba62644be2Kay Sievers /* subsystems can specify simple device enumeration */ 977ca22e56debc57b47c422b749c93217ba62644be2Kay Sievers if (!dev_name(dev) && dev->bus && dev->bus->dev_name) 978ca22e56debc57b47c422b749c93217ba62644be2Kay Sievers dev_set_name(dev, "%s%u", dev->bus->dev_name, dev->id); 979ca22e56debc57b47c422b749c93217ba62644be2Kay Sievers 980e6309e7568d4b9d62298a887b10de42df11cb8c1Thomas Gleixner if (!dev_name(dev)) { 981e6309e7568d4b9d62298a887b10de42df11cb8c1Thomas Gleixner error = -EINVAL; 9825c8563d773c0e9f0ac2a552e84806decd98ce732Kay Sievers goto name_error; 983e6309e7568d4b9d62298a887b10de42df11cb8c1Thomas Gleixner } 9841da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds 9851e0b2cf933ebf32494eba3f668859ba57f06a951Kay Sievers pr_debug("device: '%s': %s\n", dev_name(dev), __func__); 986c205ef4880273d2de4ee5388d4e52227ff688cc4Greg Kroah-Hartman 9871da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds parent = get_device(dev->parent); 988ca22e56debc57b47c422b749c93217ba62644be2Kay Sievers kobj = get_device_parent(dev, parent); 989ca22e56debc57b47c422b749c93217ba62644be2Kay Sievers if (kobj) 990ca22e56debc57b47c422b749c93217ba62644be2Kay Sievers dev->kobj.parent = kobj; 9911da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds 9920d358f22f6c8f03ab215eee8d52b74f78cc3c7dbYinghai Lu /* use parent numa_node */ 9930d358f22f6c8f03ab215eee8d52b74f78cc3c7dbYinghai Lu if (parent) 9940d358f22f6c8f03ab215eee8d52b74f78cc3c7dbYinghai Lu set_dev_node(dev, dev_to_node(parent)); 9950d358f22f6c8f03ab215eee8d52b74f78cc3c7dbYinghai Lu 9961da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds /* first, register with generic layer. */ 9978a577ffc75d9194fe8cdb7479236f2081c26ca1fKay Sievers /* we require the name to be set before, and pass NULL */ 9988a577ffc75d9194fe8cdb7479236f2081c26ca1fKay Sievers error = kobject_add(&dev->kobj, dev->kobj.parent, NULL); 99940fa54226f518a9bc97ed1d711c0016e416e3782Greg Kroah-Hartman if (error) 10001da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds goto Error; 1001a7fd67062efc5b0fc9a61368c607fa92d1d57f9eKay Sievers 1002370226449ced358e52d198081120826ef52c166bBrian Walsh /* notify platform of device entry */ 1003370226449ced358e52d198081120826ef52c166bBrian Walsh if (platform_notify) 1004370226449ced358e52d198081120826ef52c166bBrian Walsh platform_notify(dev); 1005370226449ced358e52d198081120826ef52c166bBrian Walsh 1006ad6a1e1c66009ba9dcd2f5c90ffa1fb4ce72fce0Tejun Heo error = device_create_file(dev, &uevent_attr); 1007a306eea40952e6365301e8a2f7d5ffa9c6a1921bCornelia Huck if (error) 1008a306eea40952e6365301e8a2f7d5ffa9c6a1921bCornelia Huck goto attrError; 1009a7fd67062efc5b0fc9a61368c607fa92d1d57f9eKay Sievers 101023681e479129854305da1da32f7f1eaf635ef22cGreg Kroah-Hartman if (MAJOR(dev->devt)) { 1011ad6a1e1c66009ba9dcd2f5c90ffa1fb4ce72fce0Tejun Heo error = device_create_file(dev, &devt_attr); 1012ad6a1e1c66009ba9dcd2f5c90ffa1fb4ce72fce0Tejun Heo if (error) 1013a306eea40952e6365301e8a2f7d5ffa9c6a1921bCornelia Huck goto ueventattrError; 1014e105b8bfc769b0545b6f0f395179d1e43cbee822Dan Williams 1015e105b8bfc769b0545b6f0f395179d1e43cbee822Dan Williams error = device_create_sys_dev_entry(dev); 1016e105b8bfc769b0545b6f0f395179d1e43cbee822Dan Williams if (error) 1017e105b8bfc769b0545b6f0f395179d1e43cbee822Dan Williams goto devtattrError; 10182b2af54a5bb6f7e80ccf78f20084b93c398c3a8bKay Sievers 10192b2af54a5bb6f7e80ccf78f20084b93c398c3a8bKay Sievers devtmpfs_create_node(dev); 102023681e479129854305da1da32f7f1eaf635ef22cGreg Kroah-Hartman } 102123681e479129854305da1da32f7f1eaf635ef22cGreg Kroah-Hartman 10222ee97caf0a6602f749ddbfdb1449e383e1212707Cornelia Huck error = device_add_class_symlinks(dev); 10232ee97caf0a6602f749ddbfdb1449e383e1212707Cornelia Huck if (error) 10242ee97caf0a6602f749ddbfdb1449e383e1212707Cornelia Huck goto SymlinkError; 1025dc0afa8388972a9ed7c2203cc46d8df1a4713f65Cornelia Huck error = device_add_attrs(dev); 1026dc0afa8388972a9ed7c2203cc46d8df1a4713f65Cornelia Huck if (error) 10272620efef7029bb040430f50f0fc148f2d5e002adGreg Kroah-Hartman goto AttrsError; 1028dc0afa8388972a9ed7c2203cc46d8df1a4713f65Cornelia Huck error = bus_add_device(dev); 1029dc0afa8388972a9ed7c2203cc46d8df1a4713f65Cornelia Huck if (error) 10301da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds goto BusError; 10313b98aeaf3a75f544dc945694f4fcf6e1c4bab89dAlan Stern error = dpm_sysfs_add(dev); 103257eee3d23e8833ca18708b374c648235691942baRafael J. Wysocki if (error) 10333b98aeaf3a75f544dc945694f4fcf6e1c4bab89dAlan Stern goto DPMError; 10343b98aeaf3a75f544dc945694f4fcf6e1c4bab89dAlan Stern device_pm_add(dev); 1035ec0676ee28528dc8dda13a93ee4b1f215a0c2f9dAlan Stern 1036ec0676ee28528dc8dda13a93ee4b1f215a0c2f9dAlan Stern /* Notify clients of device addition. This call must come 1037268863f43629ef88763400d0cae4a66c754a0d23majianpeng * after dpm_sysfs_add() and before kobject_uevent(). 1038ec0676ee28528dc8dda13a93ee4b1f215a0c2f9dAlan Stern */ 1039ec0676ee28528dc8dda13a93ee4b1f215a0c2f9dAlan Stern if (dev->bus) 1040ec0676ee28528dc8dda13a93ee4b1f215a0c2f9dAlan Stern blocking_notifier_call_chain(&dev->bus->p->bus_notifier, 1041ec0676ee28528dc8dda13a93ee4b1f215a0c2f9dAlan Stern BUS_NOTIFY_ADD_DEVICE, dev); 1042ec0676ee28528dc8dda13a93ee4b1f215a0c2f9dAlan Stern 104383b5fb4cce13b9f7b218ed88ee05387c3f3bdda3Cornelia Huck kobject_uevent(&dev->kobj, KOBJ_ADD); 10442023c610dc54a4f4130b0494309a9bd668ca3df8Alan Stern bus_probe_device(dev); 10451da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds if (parent) 1046f791b8c836307b58cbf62133a6a772ed1a92fb33Greg Kroah-Hartman klist_add_tail(&dev->p->knode_parent, 1047f791b8c836307b58cbf62133a6a772ed1a92fb33Greg Kroah-Hartman &parent->p->klist_children); 10481da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds 10495d9fd169c9fbdaecdc430431e59bf94ff40b93d3Greg Kroah-Hartman if (dev->class) { 1050ca22e56debc57b47c422b749c93217ba62644be2Kay Sievers mutex_lock(&dev->class->p->mutex); 1051c47ed219ba81632595e9f02e27318151fec16c9eGreg Kroah-Hartman /* tie the class to the device */ 10525a3ceb861663040f9ef0176df4aaa494bba5e352Tejun Heo klist_add_tail(&dev->knode_class, 10536b6e39a6a8da7234c538d14c43d3583da8875f9cKay Sievers &dev->class->p->klist_devices); 1054c47ed219ba81632595e9f02e27318151fec16c9eGreg Kroah-Hartman 1055c47ed219ba81632595e9f02e27318151fec16c9eGreg Kroah-Hartman /* notify any interfaces that the device is here */ 1056184f1f779d5a2e62de4a0b34842ddf8546beca8fGreg Kroah-Hartman list_for_each_entry(class_intf, 1057ca22e56debc57b47c422b749c93217ba62644be2Kay Sievers &dev->class->p->interfaces, node) 1058c47ed219ba81632595e9f02e27318151fec16c9eGreg Kroah-Hartman if (class_intf->add_dev) 1059c47ed219ba81632595e9f02e27318151fec16c9eGreg Kroah-Hartman class_intf->add_dev(dev, class_intf); 1060ca22e56debc57b47c422b749c93217ba62644be2Kay Sievers mutex_unlock(&dev->class->p->mutex); 10615d9fd169c9fbdaecdc430431e59bf94ff40b93d3Greg Kroah-Hartman } 1062c906a48adc74fc455378137ac5124b13e7030a15Greg Kroah-Hartmandone: 10631da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds put_device(dev); 10641da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds return error; 10653b98aeaf3a75f544dc945694f4fcf6e1c4bab89dAlan Stern DPMError: 106657eee3d23e8833ca18708b374c648235691942baRafael J. Wysocki bus_remove_device(dev); 106757eee3d23e8833ca18708b374c648235691942baRafael J. Wysocki BusError: 106882f0cf9b7c42684c29189ddb6d0bc86eb1137fc4James Simmons device_remove_attrs(dev); 10692620efef7029bb040430f50f0fc148f2d5e002adGreg Kroah-Hartman AttrsError: 10702ee97caf0a6602f749ddbfdb1449e383e1212707Cornelia Huck device_remove_class_symlinks(dev); 10712ee97caf0a6602f749ddbfdb1449e383e1212707Cornelia Huck SymlinkError: 1072ad6a1e1c66009ba9dcd2f5c90ffa1fb4ce72fce0Tejun Heo if (MAJOR(dev->devt)) 1073ad72956df2ce83f58be1dc4e503c78c28e414c2cKay Sievers devtmpfs_delete_node(dev); 1074ad72956df2ce83f58be1dc4e503c78c28e414c2cKay Sievers if (MAJOR(dev->devt)) 1075e105b8bfc769b0545b6f0f395179d1e43cbee822Dan Williams device_remove_sys_dev_entry(dev); 1076e105b8bfc769b0545b6f0f395179d1e43cbee822Dan Williams devtattrError: 1077e105b8bfc769b0545b6f0f395179d1e43cbee822Dan Williams if (MAJOR(dev->devt)) 1078ad6a1e1c66009ba9dcd2f5c90ffa1fb4ce72fce0Tejun Heo device_remove_file(dev, &devt_attr); 1079a306eea40952e6365301e8a2f7d5ffa9c6a1921bCornelia Huck ueventattrError: 1080ad6a1e1c66009ba9dcd2f5c90ffa1fb4ce72fce0Tejun Heo device_remove_file(dev, &uevent_attr); 108123681e479129854305da1da32f7f1eaf635ef22cGreg Kroah-Hartman attrError: 1082312c004d36ce6c739512bac83b452f4c20ab1f62Kay Sievers kobject_uevent(&dev->kobj, KOBJ_REMOVE); 10831da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds kobject_del(&dev->kobj); 10841da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds Error: 108563b6971a0876b744e2fcf3c9df15d130501e1debCornelia Huck cleanup_device_parent(dev); 10861da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds if (parent) 10871da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds put_device(parent); 10885c8563d773c0e9f0ac2a552e84806decd98ce732Kay Sieversname_error: 10895c8563d773c0e9f0ac2a552e84806decd98ce732Kay Sievers kfree(dev->p); 10905c8563d773c0e9f0ac2a552e84806decd98ce732Kay Sievers dev->p = NULL; 1091c906a48adc74fc455378137ac5124b13e7030a15Greg Kroah-Hartman goto done; 10921da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds} 10931da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds 10941da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds/** 10954a3ad20ccd8f4d2a0535cf98fa83f7b561ba59a9Greg Kroah-Hartman * device_register - register a device with the system. 10964a3ad20ccd8f4d2a0535cf98fa83f7b561ba59a9Greg Kroah-Hartman * @dev: pointer to the device structure 10971da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds * 10984a3ad20ccd8f4d2a0535cf98fa83f7b561ba59a9Greg Kroah-Hartman * This happens in two clean steps - initialize the device 10994a3ad20ccd8f4d2a0535cf98fa83f7b561ba59a9Greg Kroah-Hartman * and add it to the system. The two steps can be called 11004a3ad20ccd8f4d2a0535cf98fa83f7b561ba59a9Greg Kroah-Hartman * separately, but this is the easiest and most common. 11014a3ad20ccd8f4d2a0535cf98fa83f7b561ba59a9Greg Kroah-Hartman * I.e. you should only call the two helpers separately if 11024a3ad20ccd8f4d2a0535cf98fa83f7b561ba59a9Greg Kroah-Hartman * have a clearly defined need to use and refcount the device 11034a3ad20ccd8f4d2a0535cf98fa83f7b561ba59a9Greg Kroah-Hartman * before it is added to the hierarchy. 11045739411acbaa63a6c22c91e340fdcdbcc7d82a51Cornelia Huck * 1105b10d5efdf7892d18b3b7d899edce2c8d9b80aea9Alan Stern * For more information, see the kerneldoc for device_initialize() 1106b10d5efdf7892d18b3b7d899edce2c8d9b80aea9Alan Stern * and device_add(). 1107b10d5efdf7892d18b3b7d899edce2c8d9b80aea9Alan Stern * 11085739411acbaa63a6c22c91e340fdcdbcc7d82a51Cornelia Huck * NOTE: _Never_ directly free @dev after calling this function, even 11095739411acbaa63a6c22c91e340fdcdbcc7d82a51Cornelia Huck * if it returned an error! Always use put_device() to give up the 11105739411acbaa63a6c22c91e340fdcdbcc7d82a51Cornelia Huck * reference initialized in this function instead. 11111da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds */ 11121da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvaldsint device_register(struct device *dev) 11131da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds{ 11141da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds device_initialize(dev); 11151da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds return device_add(dev); 11161da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds} 11171da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds 11181da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds/** 11194a3ad20ccd8f4d2a0535cf98fa83f7b561ba59a9Greg Kroah-Hartman * get_device - increment reference count for device. 11204a3ad20ccd8f4d2a0535cf98fa83f7b561ba59a9Greg Kroah-Hartman * @dev: device. 11211da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds * 11224a3ad20ccd8f4d2a0535cf98fa83f7b561ba59a9Greg Kroah-Hartman * This simply forwards the call to kobject_get(), though 11234a3ad20ccd8f4d2a0535cf98fa83f7b561ba59a9Greg Kroah-Hartman * we do take care to provide for the case that we get a NULL 11244a3ad20ccd8f4d2a0535cf98fa83f7b561ba59a9Greg Kroah-Hartman * pointer passed in. 11251da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds */ 11264a3ad20ccd8f4d2a0535cf98fa83f7b561ba59a9Greg Kroah-Hartmanstruct device *get_device(struct device *dev) 11271da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds{ 11281da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds return dev ? to_dev(kobject_get(&dev->kobj)) : NULL; 11291da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds} 11301da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds 11311da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds/** 11324a3ad20ccd8f4d2a0535cf98fa83f7b561ba59a9Greg Kroah-Hartman * put_device - decrement reference count. 11334a3ad20ccd8f4d2a0535cf98fa83f7b561ba59a9Greg Kroah-Hartman * @dev: device in question. 11341da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds */ 11354a3ad20ccd8f4d2a0535cf98fa83f7b561ba59a9Greg Kroah-Hartmanvoid put_device(struct device *dev) 11361da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds{ 1137edfaa7c36574f1bf09c65ad602412db9da5f96bfKay Sievers /* might_sleep(); */ 11381da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds if (dev) 11391da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds kobject_put(&dev->kobj); 11401da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds} 11411da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds 11421da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds/** 11434a3ad20ccd8f4d2a0535cf98fa83f7b561ba59a9Greg Kroah-Hartman * device_del - delete device from system. 11444a3ad20ccd8f4d2a0535cf98fa83f7b561ba59a9Greg Kroah-Hartman * @dev: device. 11451da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds * 11464a3ad20ccd8f4d2a0535cf98fa83f7b561ba59a9Greg Kroah-Hartman * This is the first part of the device unregistration 11474a3ad20ccd8f4d2a0535cf98fa83f7b561ba59a9Greg Kroah-Hartman * sequence. This removes the device from the lists we control 11484a3ad20ccd8f4d2a0535cf98fa83f7b561ba59a9Greg Kroah-Hartman * from here, has it removed from the other driver model 11494a3ad20ccd8f4d2a0535cf98fa83f7b561ba59a9Greg Kroah-Hartman * subsystems it was added to in device_add(), and removes it 11504a3ad20ccd8f4d2a0535cf98fa83f7b561ba59a9Greg Kroah-Hartman * from the kobject hierarchy. 11511da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds * 11524a3ad20ccd8f4d2a0535cf98fa83f7b561ba59a9Greg Kroah-Hartman * NOTE: this should be called manually _iff_ device_add() was 11534a3ad20ccd8f4d2a0535cf98fa83f7b561ba59a9Greg Kroah-Hartman * also called manually. 11541da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds */ 11554a3ad20ccd8f4d2a0535cf98fa83f7b561ba59a9Greg Kroah-Hartmanvoid device_del(struct device *dev) 11561da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds{ 11574a3ad20ccd8f4d2a0535cf98fa83f7b561ba59a9Greg Kroah-Hartman struct device *parent = dev->parent; 1158c47ed219ba81632595e9f02e27318151fec16c9eGreg Kroah-Hartman struct class_interface *class_intf; 11591da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds 1160ec0676ee28528dc8dda13a93ee4b1f215a0c2f9dAlan Stern /* Notify clients of device removal. This call must come 1161ec0676ee28528dc8dda13a93ee4b1f215a0c2f9dAlan Stern * before dpm_sysfs_remove(). 1162ec0676ee28528dc8dda13a93ee4b1f215a0c2f9dAlan Stern */ 1163ec0676ee28528dc8dda13a93ee4b1f215a0c2f9dAlan Stern if (dev->bus) 1164ec0676ee28528dc8dda13a93ee4b1f215a0c2f9dAlan Stern blocking_notifier_call_chain(&dev->bus->p->bus_notifier, 1165ec0676ee28528dc8dda13a93ee4b1f215a0c2f9dAlan Stern BUS_NOTIFY_DEL_DEVICE, dev); 1166775b64d2b6ca37697de925f70799c710aab5849aRafael J. Wysocki device_pm_remove(dev); 11673b98aeaf3a75f544dc945694f4fcf6e1c4bab89dAlan Stern dpm_sysfs_remove(dev); 11681da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds if (parent) 1169f791b8c836307b58cbf62133a6a772ed1a92fb33Greg Kroah-Hartman klist_del(&dev->p->knode_parent); 1170e105b8bfc769b0545b6f0f395179d1e43cbee822Dan Williams if (MAJOR(dev->devt)) { 11712b2af54a5bb6f7e80ccf78f20084b93c398c3a8bKay Sievers devtmpfs_delete_node(dev); 1172e105b8bfc769b0545b6f0f395179d1e43cbee822Dan Williams device_remove_sys_dev_entry(dev); 1173ad6a1e1c66009ba9dcd2f5c90ffa1fb4ce72fce0Tejun Heo device_remove_file(dev, &devt_attr); 1174e105b8bfc769b0545b6f0f395179d1e43cbee822Dan Williams } 1175b9d9c82b4d081feb464f62dfc786c8621d09ecd2Kay Sievers if (dev->class) { 1176da231fd5d113ab6da5dab7a2d2c38d0a540f939cKay Sievers device_remove_class_symlinks(dev); 117799ef3ef8d5f2f5b5312627127ad63df27c0d0d05Kay Sievers 1178ca22e56debc57b47c422b749c93217ba62644be2Kay Sievers mutex_lock(&dev->class->p->mutex); 1179c47ed219ba81632595e9f02e27318151fec16c9eGreg Kroah-Hartman /* notify any interfaces that the device is now gone */ 1180184f1f779d5a2e62de4a0b34842ddf8546beca8fGreg Kroah-Hartman list_for_each_entry(class_intf, 1181ca22e56debc57b47c422b749c93217ba62644be2Kay Sievers &dev->class->p->interfaces, node) 1182c47ed219ba81632595e9f02e27318151fec16c9eGreg Kroah-Hartman if (class_intf->remove_dev) 1183c47ed219ba81632595e9f02e27318151fec16c9eGreg Kroah-Hartman class_intf->remove_dev(dev, class_intf); 1184c47ed219ba81632595e9f02e27318151fec16c9eGreg Kroah-Hartman /* remove the device from the class list */ 11855a3ceb861663040f9ef0176df4aaa494bba5e352Tejun Heo klist_del(&dev->knode_class); 1186ca22e56debc57b47c422b749c93217ba62644be2Kay Sievers mutex_unlock(&dev->class->p->mutex); 1187b9d9c82b4d081feb464f62dfc786c8621d09ecd2Kay Sievers } 1188ad6a1e1c66009ba9dcd2f5c90ffa1fb4ce72fce0Tejun Heo device_remove_file(dev, &uevent_attr); 11892620efef7029bb040430f50f0fc148f2d5e002adGreg Kroah-Hartman device_remove_attrs(dev); 1190289535334646796fe41f199718e4a731f7411a92Benjamin Herrenschmidt bus_remove_device(dev); 11911da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds 11922f8d16a996da0b9be2536994aa7a825418364471Tejun Heo /* 11932f8d16a996da0b9be2536994aa7a825418364471Tejun Heo * Some platform devices are driven without driver attached 11942f8d16a996da0b9be2536994aa7a825418364471Tejun Heo * and managed resources may have been acquired. Make sure 11952f8d16a996da0b9be2536994aa7a825418364471Tejun Heo * all resources are released. 11962f8d16a996da0b9be2536994aa7a825418364471Tejun Heo */ 11972f8d16a996da0b9be2536994aa7a825418364471Tejun Heo devres_release_all(dev); 11982f8d16a996da0b9be2536994aa7a825418364471Tejun Heo 11991da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds /* Notify the platform of the removal, in case they 12001da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds * need to do anything... 12011da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds */ 12021da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds if (platform_notify_remove) 12031da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds platform_notify_remove(dev); 1204312c004d36ce6c739512bac83b452f4c20ab1f62Kay Sievers kobject_uevent(&dev->kobj, KOBJ_REMOVE); 1205da231fd5d113ab6da5dab7a2d2c38d0a540f939cKay Sievers cleanup_device_parent(dev); 12061da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds kobject_del(&dev->kobj); 1207da231fd5d113ab6da5dab7a2d2c38d0a540f939cKay Sievers put_device(parent); 12081da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds} 12091da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds 12101da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds/** 12114a3ad20ccd8f4d2a0535cf98fa83f7b561ba59a9Greg Kroah-Hartman * device_unregister - unregister device from system. 12124a3ad20ccd8f4d2a0535cf98fa83f7b561ba59a9Greg Kroah-Hartman * @dev: device going away. 12131da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds * 12144a3ad20ccd8f4d2a0535cf98fa83f7b561ba59a9Greg Kroah-Hartman * We do this in two parts, like we do device_register(). First, 12154a3ad20ccd8f4d2a0535cf98fa83f7b561ba59a9Greg Kroah-Hartman * we remove it from all the subsystems with device_del(), then 12164a3ad20ccd8f4d2a0535cf98fa83f7b561ba59a9Greg Kroah-Hartman * we decrement the reference count via put_device(). If that 12174a3ad20ccd8f4d2a0535cf98fa83f7b561ba59a9Greg Kroah-Hartman * is the final reference count, the device will be cleaned up 12184a3ad20ccd8f4d2a0535cf98fa83f7b561ba59a9Greg Kroah-Hartman * via device_release() above. Otherwise, the structure will 12194a3ad20ccd8f4d2a0535cf98fa83f7b561ba59a9Greg Kroah-Hartman * stick around until the final reference to the device is dropped. 12201da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds */ 12214a3ad20ccd8f4d2a0535cf98fa83f7b561ba59a9Greg Kroah-Hartmanvoid device_unregister(struct device *dev) 12221da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds{ 12231e0b2cf933ebf32494eba3f668859ba57f06a951Kay Sievers pr_debug("device: '%s': %s\n", dev_name(dev), __func__); 12241da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds device_del(dev); 12251da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds put_device(dev); 12261da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds} 12271da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds 12284a3ad20ccd8f4d2a0535cf98fa83f7b561ba59a9Greg Kroah-Hartmanstatic struct device *next_device(struct klist_iter *i) 122936239577cfb6b9a7c111209536b54200b0252ebfPatrick Mochel{ 12304a3ad20ccd8f4d2a0535cf98fa83f7b561ba59a9Greg Kroah-Hartman struct klist_node *n = klist_next(i); 1231f791b8c836307b58cbf62133a6a772ed1a92fb33Greg Kroah-Hartman struct device *dev = NULL; 1232f791b8c836307b58cbf62133a6a772ed1a92fb33Greg Kroah-Hartman struct device_private *p; 1233f791b8c836307b58cbf62133a6a772ed1a92fb33Greg Kroah-Hartman 1234f791b8c836307b58cbf62133a6a772ed1a92fb33Greg Kroah-Hartman if (n) { 1235f791b8c836307b58cbf62133a6a772ed1a92fb33Greg Kroah-Hartman p = to_device_private_parent(n); 1236f791b8c836307b58cbf62133a6a772ed1a92fb33Greg Kroah-Hartman dev = p->device; 1237f791b8c836307b58cbf62133a6a772ed1a92fb33Greg Kroah-Hartman } 1238f791b8c836307b58cbf62133a6a772ed1a92fb33Greg Kroah-Hartman return dev; 123936239577cfb6b9a7c111209536b54200b0252ebfPatrick Mochel} 124036239577cfb6b9a7c111209536b54200b0252ebfPatrick Mochel 12411da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds/** 1242e454cea20bdcff10ee698d11b8882662a0153a47Kay Sievers * device_get_devnode - path of device node file 12436fcf53acccf85b4b0d0260e66c692a341760f464Kay Sievers * @dev: device 1244e454cea20bdcff10ee698d11b8882662a0153a47Kay Sievers * @mode: returned file access mode 12456fcf53acccf85b4b0d0260e66c692a341760f464Kay Sievers * @tmp: possibly allocated string 12466fcf53acccf85b4b0d0260e66c692a341760f464Kay Sievers * 12476fcf53acccf85b4b0d0260e66c692a341760f464Kay Sievers * Return the relative path of a possible device node. 12486fcf53acccf85b4b0d0260e66c692a341760f464Kay Sievers * Non-default names may need to allocate a memory to compose 12496fcf53acccf85b4b0d0260e66c692a341760f464Kay Sievers * a name. This memory is returned in tmp and needs to be 12506fcf53acccf85b4b0d0260e66c692a341760f464Kay Sievers * freed by the caller. 12516fcf53acccf85b4b0d0260e66c692a341760f464Kay Sievers */ 1252e454cea20bdcff10ee698d11b8882662a0153a47Kay Sieversconst char *device_get_devnode(struct device *dev, 12532c9ede55ecec58099b72e4bb8eab719f32f72c31Al Viro umode_t *mode, const char **tmp) 12546fcf53acccf85b4b0d0260e66c692a341760f464Kay Sievers{ 12556fcf53acccf85b4b0d0260e66c692a341760f464Kay Sievers char *s; 12566fcf53acccf85b4b0d0260e66c692a341760f464Kay Sievers 12576fcf53acccf85b4b0d0260e66c692a341760f464Kay Sievers *tmp = NULL; 12586fcf53acccf85b4b0d0260e66c692a341760f464Kay Sievers 12596fcf53acccf85b4b0d0260e66c692a341760f464Kay Sievers /* the device type may provide a specific name */ 1260e454cea20bdcff10ee698d11b8882662a0153a47Kay Sievers if (dev->type && dev->type->devnode) 1261e454cea20bdcff10ee698d11b8882662a0153a47Kay Sievers *tmp = dev->type->devnode(dev, mode); 12626fcf53acccf85b4b0d0260e66c692a341760f464Kay Sievers if (*tmp) 12636fcf53acccf85b4b0d0260e66c692a341760f464Kay Sievers return *tmp; 12646fcf53acccf85b4b0d0260e66c692a341760f464Kay Sievers 12656fcf53acccf85b4b0d0260e66c692a341760f464Kay Sievers /* the class may provide a specific name */ 1266e454cea20bdcff10ee698d11b8882662a0153a47Kay Sievers if (dev->class && dev->class->devnode) 1267e454cea20bdcff10ee698d11b8882662a0153a47Kay Sievers *tmp = dev->class->devnode(dev, mode); 12686fcf53acccf85b4b0d0260e66c692a341760f464Kay Sievers if (*tmp) 12696fcf53acccf85b4b0d0260e66c692a341760f464Kay Sievers return *tmp; 12706fcf53acccf85b4b0d0260e66c692a341760f464Kay Sievers 12716fcf53acccf85b4b0d0260e66c692a341760f464Kay Sievers /* return name without allocation, tmp == NULL */ 12726fcf53acccf85b4b0d0260e66c692a341760f464Kay Sievers if (strchr(dev_name(dev), '!') == NULL) 12736fcf53acccf85b4b0d0260e66c692a341760f464Kay Sievers return dev_name(dev); 12746fcf53acccf85b4b0d0260e66c692a341760f464Kay Sievers 12756fcf53acccf85b4b0d0260e66c692a341760f464Kay Sievers /* replace '!' in the name with '/' */ 12766fcf53acccf85b4b0d0260e66c692a341760f464Kay Sievers *tmp = kstrdup(dev_name(dev), GFP_KERNEL); 12776fcf53acccf85b4b0d0260e66c692a341760f464Kay Sievers if (!*tmp) 12786fcf53acccf85b4b0d0260e66c692a341760f464Kay Sievers return NULL; 12796fcf53acccf85b4b0d0260e66c692a341760f464Kay Sievers while ((s = strchr(*tmp, '!'))) 12806fcf53acccf85b4b0d0260e66c692a341760f464Kay Sievers s[0] = '/'; 12816fcf53acccf85b4b0d0260e66c692a341760f464Kay Sievers return *tmp; 12826fcf53acccf85b4b0d0260e66c692a341760f464Kay Sievers} 12836fcf53acccf85b4b0d0260e66c692a341760f464Kay Sievers 12846fcf53acccf85b4b0d0260e66c692a341760f464Kay Sievers/** 12854a3ad20ccd8f4d2a0535cf98fa83f7b561ba59a9Greg Kroah-Hartman * device_for_each_child - device child iterator. 12864a3ad20ccd8f4d2a0535cf98fa83f7b561ba59a9Greg Kroah-Hartman * @parent: parent struct device. 12874a3ad20ccd8f4d2a0535cf98fa83f7b561ba59a9Greg Kroah-Hartman * @data: data for the callback. 12884a3ad20ccd8f4d2a0535cf98fa83f7b561ba59a9Greg Kroah-Hartman * @fn: function to be called for each device. 12891da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds * 12904a3ad20ccd8f4d2a0535cf98fa83f7b561ba59a9Greg Kroah-Hartman * Iterate over @parent's child devices, and call @fn for each, 12914a3ad20ccd8f4d2a0535cf98fa83f7b561ba59a9Greg Kroah-Hartman * passing it @data. 12921da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds * 12934a3ad20ccd8f4d2a0535cf98fa83f7b561ba59a9Greg Kroah-Hartman * We check the return of @fn each time. If it returns anything 12944a3ad20ccd8f4d2a0535cf98fa83f7b561ba59a9Greg Kroah-Hartman * other than 0, we break out and return that value. 12951da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds */ 12964a3ad20ccd8f4d2a0535cf98fa83f7b561ba59a9Greg Kroah-Hartmanint device_for_each_child(struct device *parent, void *data, 12974a3ad20ccd8f4d2a0535cf98fa83f7b561ba59a9Greg Kroah-Hartman int (*fn)(struct device *dev, void *data)) 12981da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds{ 129936239577cfb6b9a7c111209536b54200b0252ebfPatrick Mochel struct klist_iter i; 13004a3ad20ccd8f4d2a0535cf98fa83f7b561ba59a9Greg Kroah-Hartman struct device *child; 13011da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds int error = 0; 13021da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds 1303014c90dbb9b63bae067afc80a7931a76c5268ae3Greg Kroah-Hartman if (!parent->p) 1304014c90dbb9b63bae067afc80a7931a76c5268ae3Greg Kroah-Hartman return 0; 1305014c90dbb9b63bae067afc80a7931a76c5268ae3Greg Kroah-Hartman 1306f791b8c836307b58cbf62133a6a772ed1a92fb33Greg Kroah-Hartman klist_iter_init(&parent->p->klist_children, &i); 130736239577cfb6b9a7c111209536b54200b0252ebfPatrick Mochel while ((child = next_device(&i)) && !error) 130836239577cfb6b9a7c111209536b54200b0252ebfPatrick Mochel error = fn(child, data); 130936239577cfb6b9a7c111209536b54200b0252ebfPatrick Mochel klist_iter_exit(&i); 13101da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds return error; 13111da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds} 13121da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds 13135ab699810d46011ad2195c5916f3cbc684bfe3eeCornelia Huck/** 13145ab699810d46011ad2195c5916f3cbc684bfe3eeCornelia Huck * device_find_child - device iterator for locating a particular device. 13155ab699810d46011ad2195c5916f3cbc684bfe3eeCornelia Huck * @parent: parent struct device 13165ab699810d46011ad2195c5916f3cbc684bfe3eeCornelia Huck * @data: Data to pass to match function 13175ab699810d46011ad2195c5916f3cbc684bfe3eeCornelia Huck * @match: Callback function to check device 13185ab699810d46011ad2195c5916f3cbc684bfe3eeCornelia Huck * 13195ab699810d46011ad2195c5916f3cbc684bfe3eeCornelia Huck * This is similar to the device_for_each_child() function above, but it 13205ab699810d46011ad2195c5916f3cbc684bfe3eeCornelia Huck * returns a reference to a device that is 'found' for later use, as 13215ab699810d46011ad2195c5916f3cbc684bfe3eeCornelia Huck * determined by the @match callback. 13225ab699810d46011ad2195c5916f3cbc684bfe3eeCornelia Huck * 13235ab699810d46011ad2195c5916f3cbc684bfe3eeCornelia Huck * The callback should return 0 if the device doesn't match and non-zero 13245ab699810d46011ad2195c5916f3cbc684bfe3eeCornelia Huck * if it does. If the callback returns non-zero and a reference to the 13255ab699810d46011ad2195c5916f3cbc684bfe3eeCornelia Huck * current device can be obtained, this function will return to the caller 13265ab699810d46011ad2195c5916f3cbc684bfe3eeCornelia Huck * and not iterate over any more devices. 13275ab699810d46011ad2195c5916f3cbc684bfe3eeCornelia Huck */ 13284a3ad20ccd8f4d2a0535cf98fa83f7b561ba59a9Greg Kroah-Hartmanstruct device *device_find_child(struct device *parent, void *data, 13294a3ad20ccd8f4d2a0535cf98fa83f7b561ba59a9Greg Kroah-Hartman int (*match)(struct device *dev, void *data)) 13305ab699810d46011ad2195c5916f3cbc684bfe3eeCornelia Huck{ 13315ab699810d46011ad2195c5916f3cbc684bfe3eeCornelia Huck struct klist_iter i; 13325ab699810d46011ad2195c5916f3cbc684bfe3eeCornelia Huck struct device *child; 13335ab699810d46011ad2195c5916f3cbc684bfe3eeCornelia Huck 13345ab699810d46011ad2195c5916f3cbc684bfe3eeCornelia Huck if (!parent) 13355ab699810d46011ad2195c5916f3cbc684bfe3eeCornelia Huck return NULL; 13365ab699810d46011ad2195c5916f3cbc684bfe3eeCornelia Huck 1337f791b8c836307b58cbf62133a6a772ed1a92fb33Greg Kroah-Hartman klist_iter_init(&parent->p->klist_children, &i); 13385ab699810d46011ad2195c5916f3cbc684bfe3eeCornelia Huck while ((child = next_device(&i))) 13395ab699810d46011ad2195c5916f3cbc684bfe3eeCornelia Huck if (match(child, data) && get_device(child)) 13405ab699810d46011ad2195c5916f3cbc684bfe3eeCornelia Huck break; 13415ab699810d46011ad2195c5916f3cbc684bfe3eeCornelia Huck klist_iter_exit(&i); 13425ab699810d46011ad2195c5916f3cbc684bfe3eeCornelia Huck return child; 13435ab699810d46011ad2195c5916f3cbc684bfe3eeCornelia Huck} 13445ab699810d46011ad2195c5916f3cbc684bfe3eeCornelia Huck 13451da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvaldsint __init devices_init(void) 13461da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds{ 1347881c6cfd7c5edfe6129006e2404654bfe5911050Greg Kroah-Hartman devices_kset = kset_create_and_add("devices", &device_uevent_ops, NULL); 1348881c6cfd7c5edfe6129006e2404654bfe5911050Greg Kroah-Hartman if (!devices_kset) 1349881c6cfd7c5edfe6129006e2404654bfe5911050Greg Kroah-Hartman return -ENOMEM; 1350e105b8bfc769b0545b6f0f395179d1e43cbee822Dan Williams dev_kobj = kobject_create_and_add("dev", NULL); 1351e105b8bfc769b0545b6f0f395179d1e43cbee822Dan Williams if (!dev_kobj) 1352e105b8bfc769b0545b6f0f395179d1e43cbee822Dan Williams goto dev_kobj_err; 1353e105b8bfc769b0545b6f0f395179d1e43cbee822Dan Williams sysfs_dev_block_kobj = kobject_create_and_add("block", dev_kobj); 1354e105b8bfc769b0545b6f0f395179d1e43cbee822Dan Williams if (!sysfs_dev_block_kobj) 1355e105b8bfc769b0545b6f0f395179d1e43cbee822Dan Williams goto block_kobj_err; 1356e105b8bfc769b0545b6f0f395179d1e43cbee822Dan Williams sysfs_dev_char_kobj = kobject_create_and_add("char", dev_kobj); 1357e105b8bfc769b0545b6f0f395179d1e43cbee822Dan Williams if (!sysfs_dev_char_kobj) 1358e105b8bfc769b0545b6f0f395179d1e43cbee822Dan Williams goto char_kobj_err; 1359e105b8bfc769b0545b6f0f395179d1e43cbee822Dan Williams 1360881c6cfd7c5edfe6129006e2404654bfe5911050Greg Kroah-Hartman return 0; 1361e105b8bfc769b0545b6f0f395179d1e43cbee822Dan Williams 1362e105b8bfc769b0545b6f0f395179d1e43cbee822Dan Williams char_kobj_err: 1363e105b8bfc769b0545b6f0f395179d1e43cbee822Dan Williams kobject_put(sysfs_dev_block_kobj); 1364e105b8bfc769b0545b6f0f395179d1e43cbee822Dan Williams block_kobj_err: 1365e105b8bfc769b0545b6f0f395179d1e43cbee822Dan Williams kobject_put(dev_kobj); 1366e105b8bfc769b0545b6f0f395179d1e43cbee822Dan Williams dev_kobj_err: 1367e105b8bfc769b0545b6f0f395179d1e43cbee822Dan Williams kset_unregister(devices_kset); 1368e105b8bfc769b0545b6f0f395179d1e43cbee822Dan Williams return -ENOMEM; 13691da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds} 13701da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds 13711da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus TorvaldsEXPORT_SYMBOL_GPL(device_for_each_child); 13725ab699810d46011ad2195c5916f3cbc684bfe3eeCornelia HuckEXPORT_SYMBOL_GPL(device_find_child); 13731da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds 13741da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus TorvaldsEXPORT_SYMBOL_GPL(device_initialize); 13751da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus TorvaldsEXPORT_SYMBOL_GPL(device_add); 13761da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus TorvaldsEXPORT_SYMBOL_GPL(device_register); 13771da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds 13781da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus TorvaldsEXPORT_SYMBOL_GPL(device_del); 13791da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus TorvaldsEXPORT_SYMBOL_GPL(device_unregister); 13801da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus TorvaldsEXPORT_SYMBOL_GPL(get_device); 13811da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus TorvaldsEXPORT_SYMBOL_GPL(put_device); 13821da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds 13831da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus TorvaldsEXPORT_SYMBOL_GPL(device_create_file); 13841da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus TorvaldsEXPORT_SYMBOL_GPL(device_remove_file); 138523681e479129854305da1da32f7f1eaf635ef22cGreg Kroah-Hartman 13867f100d1566d6ee353a43be92599511fc438ec281Karthigan Srinivasanstruct root_device { 13870aa0dc41bfd993491c2344870eee7a3b218551fbMark McLoughlin struct device dev; 13880aa0dc41bfd993491c2344870eee7a3b218551fbMark McLoughlin struct module *owner; 13890aa0dc41bfd993491c2344870eee7a3b218551fbMark McLoughlin}; 13900aa0dc41bfd993491c2344870eee7a3b218551fbMark McLoughlin 1391481e20799bdcf98fd5a1d829d187239a90b15395Ferenc Wagnerinline struct root_device *to_root_device(struct device *d) 1392481e20799bdcf98fd5a1d829d187239a90b15395Ferenc Wagner{ 1393481e20799bdcf98fd5a1d829d187239a90b15395Ferenc Wagner return container_of(d, struct root_device, dev); 1394481e20799bdcf98fd5a1d829d187239a90b15395Ferenc Wagner} 13950aa0dc41bfd993491c2344870eee7a3b218551fbMark McLoughlin 13960aa0dc41bfd993491c2344870eee7a3b218551fbMark McLoughlinstatic void root_device_release(struct device *dev) 13970aa0dc41bfd993491c2344870eee7a3b218551fbMark McLoughlin{ 13980aa0dc41bfd993491c2344870eee7a3b218551fbMark McLoughlin kfree(to_root_device(dev)); 13990aa0dc41bfd993491c2344870eee7a3b218551fbMark McLoughlin} 14000aa0dc41bfd993491c2344870eee7a3b218551fbMark McLoughlin 14010aa0dc41bfd993491c2344870eee7a3b218551fbMark McLoughlin/** 14020aa0dc41bfd993491c2344870eee7a3b218551fbMark McLoughlin * __root_device_register - allocate and register a root device 14030aa0dc41bfd993491c2344870eee7a3b218551fbMark McLoughlin * @name: root device name 14040aa0dc41bfd993491c2344870eee7a3b218551fbMark McLoughlin * @owner: owner module of the root device, usually THIS_MODULE 14050aa0dc41bfd993491c2344870eee7a3b218551fbMark McLoughlin * 14060aa0dc41bfd993491c2344870eee7a3b218551fbMark McLoughlin * This function allocates a root device and registers it 14070aa0dc41bfd993491c2344870eee7a3b218551fbMark McLoughlin * using device_register(). In order to free the returned 14080aa0dc41bfd993491c2344870eee7a3b218551fbMark McLoughlin * device, use root_device_unregister(). 14090aa0dc41bfd993491c2344870eee7a3b218551fbMark McLoughlin * 14100aa0dc41bfd993491c2344870eee7a3b218551fbMark McLoughlin * Root devices are dummy devices which allow other devices 14110aa0dc41bfd993491c2344870eee7a3b218551fbMark McLoughlin * to be grouped under /sys/devices. Use this function to 14120aa0dc41bfd993491c2344870eee7a3b218551fbMark McLoughlin * allocate a root device and then use it as the parent of 14130aa0dc41bfd993491c2344870eee7a3b218551fbMark McLoughlin * any device which should appear under /sys/devices/{name} 14140aa0dc41bfd993491c2344870eee7a3b218551fbMark McLoughlin * 14150aa0dc41bfd993491c2344870eee7a3b218551fbMark McLoughlin * The /sys/devices/{name} directory will also contain a 14160aa0dc41bfd993491c2344870eee7a3b218551fbMark McLoughlin * 'module' symlink which points to the @owner directory 14170aa0dc41bfd993491c2344870eee7a3b218551fbMark McLoughlin * in sysfs. 14180aa0dc41bfd993491c2344870eee7a3b218551fbMark McLoughlin * 1419f0eae0ed3b7d4182a6b4dd03540a738518ea3163Jani Nikula * Returns &struct device pointer on success, or ERR_PTR() on error. 1420f0eae0ed3b7d4182a6b4dd03540a738518ea3163Jani Nikula * 14210aa0dc41bfd993491c2344870eee7a3b218551fbMark McLoughlin * Note: You probably want to use root_device_register(). 14220aa0dc41bfd993491c2344870eee7a3b218551fbMark McLoughlin */ 14230aa0dc41bfd993491c2344870eee7a3b218551fbMark McLoughlinstruct device *__root_device_register(const char *name, struct module *owner) 14240aa0dc41bfd993491c2344870eee7a3b218551fbMark McLoughlin{ 14250aa0dc41bfd993491c2344870eee7a3b218551fbMark McLoughlin struct root_device *root; 14260aa0dc41bfd993491c2344870eee7a3b218551fbMark McLoughlin int err = -ENOMEM; 14270aa0dc41bfd993491c2344870eee7a3b218551fbMark McLoughlin 14280aa0dc41bfd993491c2344870eee7a3b218551fbMark McLoughlin root = kzalloc(sizeof(struct root_device), GFP_KERNEL); 14290aa0dc41bfd993491c2344870eee7a3b218551fbMark McLoughlin if (!root) 14300aa0dc41bfd993491c2344870eee7a3b218551fbMark McLoughlin return ERR_PTR(err); 14310aa0dc41bfd993491c2344870eee7a3b218551fbMark McLoughlin 1432acc0e90fbccbc6e4d48184cba0983ea044e131afGreg Kroah-Hartman err = dev_set_name(&root->dev, "%s", name); 14330aa0dc41bfd993491c2344870eee7a3b218551fbMark McLoughlin if (err) { 14340aa0dc41bfd993491c2344870eee7a3b218551fbMark McLoughlin kfree(root); 14350aa0dc41bfd993491c2344870eee7a3b218551fbMark McLoughlin return ERR_PTR(err); 14360aa0dc41bfd993491c2344870eee7a3b218551fbMark McLoughlin } 14370aa0dc41bfd993491c2344870eee7a3b218551fbMark McLoughlin 14380aa0dc41bfd993491c2344870eee7a3b218551fbMark McLoughlin root->dev.release = root_device_release; 14390aa0dc41bfd993491c2344870eee7a3b218551fbMark McLoughlin 14400aa0dc41bfd993491c2344870eee7a3b218551fbMark McLoughlin err = device_register(&root->dev); 14410aa0dc41bfd993491c2344870eee7a3b218551fbMark McLoughlin if (err) { 14420aa0dc41bfd993491c2344870eee7a3b218551fbMark McLoughlin put_device(&root->dev); 14430aa0dc41bfd993491c2344870eee7a3b218551fbMark McLoughlin return ERR_PTR(err); 14440aa0dc41bfd993491c2344870eee7a3b218551fbMark McLoughlin } 14450aa0dc41bfd993491c2344870eee7a3b218551fbMark McLoughlin 14461d9e882ba4971f31473dd812da64909f30a6c242Christoph Egger#ifdef CONFIG_MODULES /* gotta find a "cleaner" way to do this */ 14470aa0dc41bfd993491c2344870eee7a3b218551fbMark McLoughlin if (owner) { 14480aa0dc41bfd993491c2344870eee7a3b218551fbMark McLoughlin struct module_kobject *mk = &owner->mkobj; 14490aa0dc41bfd993491c2344870eee7a3b218551fbMark McLoughlin 14500aa0dc41bfd993491c2344870eee7a3b218551fbMark McLoughlin err = sysfs_create_link(&root->dev.kobj, &mk->kobj, "module"); 14510aa0dc41bfd993491c2344870eee7a3b218551fbMark McLoughlin if (err) { 14520aa0dc41bfd993491c2344870eee7a3b218551fbMark McLoughlin device_unregister(&root->dev); 14530aa0dc41bfd993491c2344870eee7a3b218551fbMark McLoughlin return ERR_PTR(err); 14540aa0dc41bfd993491c2344870eee7a3b218551fbMark McLoughlin } 14550aa0dc41bfd993491c2344870eee7a3b218551fbMark McLoughlin root->owner = owner; 14560aa0dc41bfd993491c2344870eee7a3b218551fbMark McLoughlin } 14570aa0dc41bfd993491c2344870eee7a3b218551fbMark McLoughlin#endif 14580aa0dc41bfd993491c2344870eee7a3b218551fbMark McLoughlin 14590aa0dc41bfd993491c2344870eee7a3b218551fbMark McLoughlin return &root->dev; 14600aa0dc41bfd993491c2344870eee7a3b218551fbMark McLoughlin} 14610aa0dc41bfd993491c2344870eee7a3b218551fbMark McLoughlinEXPORT_SYMBOL_GPL(__root_device_register); 14620aa0dc41bfd993491c2344870eee7a3b218551fbMark McLoughlin 14630aa0dc41bfd993491c2344870eee7a3b218551fbMark McLoughlin/** 14640aa0dc41bfd993491c2344870eee7a3b218551fbMark McLoughlin * root_device_unregister - unregister and free a root device 14657cbcf22548df1f1df7c6b0d0bda579b92efca63cRandy Dunlap * @dev: device going away 14660aa0dc41bfd993491c2344870eee7a3b218551fbMark McLoughlin * 14670aa0dc41bfd993491c2344870eee7a3b218551fbMark McLoughlin * This function unregisters and cleans up a device that was created by 14680aa0dc41bfd993491c2344870eee7a3b218551fbMark McLoughlin * root_device_register(). 14690aa0dc41bfd993491c2344870eee7a3b218551fbMark McLoughlin */ 14700aa0dc41bfd993491c2344870eee7a3b218551fbMark McLoughlinvoid root_device_unregister(struct device *dev) 14710aa0dc41bfd993491c2344870eee7a3b218551fbMark McLoughlin{ 14720aa0dc41bfd993491c2344870eee7a3b218551fbMark McLoughlin struct root_device *root = to_root_device(dev); 14730aa0dc41bfd993491c2344870eee7a3b218551fbMark McLoughlin 14740aa0dc41bfd993491c2344870eee7a3b218551fbMark McLoughlin if (root->owner) 14750aa0dc41bfd993491c2344870eee7a3b218551fbMark McLoughlin sysfs_remove_link(&root->dev.kobj, "module"); 14760aa0dc41bfd993491c2344870eee7a3b218551fbMark McLoughlin 14770aa0dc41bfd993491c2344870eee7a3b218551fbMark McLoughlin device_unregister(dev); 14780aa0dc41bfd993491c2344870eee7a3b218551fbMark McLoughlin} 14790aa0dc41bfd993491c2344870eee7a3b218551fbMark McLoughlinEXPORT_SYMBOL_GPL(root_device_unregister); 14800aa0dc41bfd993491c2344870eee7a3b218551fbMark McLoughlin 148123681e479129854305da1da32f7f1eaf635ef22cGreg Kroah-Hartman 148223681e479129854305da1da32f7f1eaf635ef22cGreg Kroah-Hartmanstatic void device_create_release(struct device *dev) 148323681e479129854305da1da32f7f1eaf635ef22cGreg Kroah-Hartman{ 14841e0b2cf933ebf32494eba3f668859ba57f06a951Kay Sievers pr_debug("device: '%s': %s\n", dev_name(dev), __func__); 148523681e479129854305da1da32f7f1eaf635ef22cGreg Kroah-Hartman kfree(dev); 148623681e479129854305da1da32f7f1eaf635ef22cGreg Kroah-Hartman} 148723681e479129854305da1da32f7f1eaf635ef22cGreg Kroah-Hartman 148823681e479129854305da1da32f7f1eaf635ef22cGreg Kroah-Hartman/** 14898882b39421bae317e3ee864edd845e994307ce16Greg Kroah-Hartman * device_create_vargs - creates a device and registers it with sysfs 149042734dafa43e453a8b6769a5ebd3a01ffc1fd116Henrik Kretzschmar * @class: pointer to the struct class that this device should be registered to 149142734dafa43e453a8b6769a5ebd3a01ffc1fd116Henrik Kretzschmar * @parent: pointer to the parent struct device of this new device, if any 149242734dafa43e453a8b6769a5ebd3a01ffc1fd116Henrik Kretzschmar * @devt: the dev_t for the char device to be added 14938882b39421bae317e3ee864edd845e994307ce16Greg Kroah-Hartman * @drvdata: the data to be added to the device for callbacks 149442734dafa43e453a8b6769a5ebd3a01ffc1fd116Henrik Kretzschmar * @fmt: string for the device's name 14958882b39421bae317e3ee864edd845e994307ce16Greg Kroah-Hartman * @args: va_list for the device's name 149642734dafa43e453a8b6769a5ebd3a01ffc1fd116Henrik Kretzschmar * 149742734dafa43e453a8b6769a5ebd3a01ffc1fd116Henrik Kretzschmar * This function can be used by char device classes. A struct device 149842734dafa43e453a8b6769a5ebd3a01ffc1fd116Henrik Kretzschmar * will be created in sysfs, registered to the specified class. 149923681e479129854305da1da32f7f1eaf635ef22cGreg Kroah-Hartman * 150023681e479129854305da1da32f7f1eaf635ef22cGreg Kroah-Hartman * A "dev" file will be created, showing the dev_t for the device, if 150123681e479129854305da1da32f7f1eaf635ef22cGreg Kroah-Hartman * the dev_t is not 0,0. 150242734dafa43e453a8b6769a5ebd3a01ffc1fd116Henrik Kretzschmar * If a pointer to a parent struct device is passed in, the newly created 150342734dafa43e453a8b6769a5ebd3a01ffc1fd116Henrik Kretzschmar * struct device will be a child of that device in sysfs. 150442734dafa43e453a8b6769a5ebd3a01ffc1fd116Henrik Kretzschmar * The pointer to the struct device will be returned from the call. 150542734dafa43e453a8b6769a5ebd3a01ffc1fd116Henrik Kretzschmar * Any further sysfs files that might be required can be created using this 150623681e479129854305da1da32f7f1eaf635ef22cGreg Kroah-Hartman * pointer. 150723681e479129854305da1da32f7f1eaf635ef22cGreg Kroah-Hartman * 1508f0eae0ed3b7d4182a6b4dd03540a738518ea3163Jani Nikula * Returns &struct device pointer on success, or ERR_PTR() on error. 1509f0eae0ed3b7d4182a6b4dd03540a738518ea3163Jani Nikula * 151023681e479129854305da1da32f7f1eaf635ef22cGreg Kroah-Hartman * Note: the struct class passed to this function must have previously 151123681e479129854305da1da32f7f1eaf635ef22cGreg Kroah-Hartman * been created with a call to class_create(). 151223681e479129854305da1da32f7f1eaf635ef22cGreg Kroah-Hartman */ 15138882b39421bae317e3ee864edd845e994307ce16Greg Kroah-Hartmanstruct device *device_create_vargs(struct class *class, struct device *parent, 15148882b39421bae317e3ee864edd845e994307ce16Greg Kroah-Hartman dev_t devt, void *drvdata, const char *fmt, 15158882b39421bae317e3ee864edd845e994307ce16Greg Kroah-Hartman va_list args) 151623681e479129854305da1da32f7f1eaf635ef22cGreg Kroah-Hartman{ 151723681e479129854305da1da32f7f1eaf635ef22cGreg Kroah-Hartman struct device *dev = NULL; 151823681e479129854305da1da32f7f1eaf635ef22cGreg Kroah-Hartman int retval = -ENODEV; 151923681e479129854305da1da32f7f1eaf635ef22cGreg Kroah-Hartman 152023681e479129854305da1da32f7f1eaf635ef22cGreg Kroah-Hartman if (class == NULL || IS_ERR(class)) 152123681e479129854305da1da32f7f1eaf635ef22cGreg Kroah-Hartman goto error; 152223681e479129854305da1da32f7f1eaf635ef22cGreg Kroah-Hartman 152323681e479129854305da1da32f7f1eaf635ef22cGreg Kroah-Hartman dev = kzalloc(sizeof(*dev), GFP_KERNEL); 152423681e479129854305da1da32f7f1eaf635ef22cGreg Kroah-Hartman if (!dev) { 152523681e479129854305da1da32f7f1eaf635ef22cGreg Kroah-Hartman retval = -ENOMEM; 152623681e479129854305da1da32f7f1eaf635ef22cGreg Kroah-Hartman goto error; 152723681e479129854305da1da32f7f1eaf635ef22cGreg Kroah-Hartman } 152823681e479129854305da1da32f7f1eaf635ef22cGreg Kroah-Hartman 152923681e479129854305da1da32f7f1eaf635ef22cGreg Kroah-Hartman dev->devt = devt; 153023681e479129854305da1da32f7f1eaf635ef22cGreg Kroah-Hartman dev->class = class; 153123681e479129854305da1da32f7f1eaf635ef22cGreg Kroah-Hartman dev->parent = parent; 153223681e479129854305da1da32f7f1eaf635ef22cGreg Kroah-Hartman dev->release = device_create_release; 15338882b39421bae317e3ee864edd845e994307ce16Greg Kroah-Hartman dev_set_drvdata(dev, drvdata); 153423681e479129854305da1da32f7f1eaf635ef22cGreg Kroah-Hartman 15351fa5ae857bb14f6046205171d98506d8112dd74eKay Sievers retval = kobject_set_name_vargs(&dev->kobj, fmt, args); 15361fa5ae857bb14f6046205171d98506d8112dd74eKay Sievers if (retval) 15371fa5ae857bb14f6046205171d98506d8112dd74eKay Sievers goto error; 15381fa5ae857bb14f6046205171d98506d8112dd74eKay Sievers 153923681e479129854305da1da32f7f1eaf635ef22cGreg Kroah-Hartman retval = device_register(dev); 154023681e479129854305da1da32f7f1eaf635ef22cGreg Kroah-Hartman if (retval) 154123681e479129854305da1da32f7f1eaf635ef22cGreg Kroah-Hartman goto error; 154223681e479129854305da1da32f7f1eaf635ef22cGreg Kroah-Hartman 154323681e479129854305da1da32f7f1eaf635ef22cGreg Kroah-Hartman return dev; 154423681e479129854305da1da32f7f1eaf635ef22cGreg Kroah-Hartman 154523681e479129854305da1da32f7f1eaf635ef22cGreg Kroah-Hartmanerror: 1546286661b3777897220ecfcd774bccc68a34667f39Cornelia Huck put_device(dev); 154723681e479129854305da1da32f7f1eaf635ef22cGreg Kroah-Hartman return ERR_PTR(retval); 154823681e479129854305da1da32f7f1eaf635ef22cGreg Kroah-Hartman} 15498882b39421bae317e3ee864edd845e994307ce16Greg Kroah-HartmanEXPORT_SYMBOL_GPL(device_create_vargs); 15508882b39421bae317e3ee864edd845e994307ce16Greg Kroah-Hartman 15518882b39421bae317e3ee864edd845e994307ce16Greg Kroah-Hartman/** 15524e10673944a5c386378ff9d692ae37e19993f9d5Greg Kroah-Hartman * device_create - creates a device and registers it with sysfs 15538882b39421bae317e3ee864edd845e994307ce16Greg Kroah-Hartman * @class: pointer to the struct class that this device should be registered to 15548882b39421bae317e3ee864edd845e994307ce16Greg Kroah-Hartman * @parent: pointer to the parent struct device of this new device, if any 15558882b39421bae317e3ee864edd845e994307ce16Greg Kroah-Hartman * @devt: the dev_t for the char device to be added 15568882b39421bae317e3ee864edd845e994307ce16Greg Kroah-Hartman * @drvdata: the data to be added to the device for callbacks 15578882b39421bae317e3ee864edd845e994307ce16Greg Kroah-Hartman * @fmt: string for the device's name 15588882b39421bae317e3ee864edd845e994307ce16Greg Kroah-Hartman * 15598882b39421bae317e3ee864edd845e994307ce16Greg Kroah-Hartman * This function can be used by char device classes. A struct device 15608882b39421bae317e3ee864edd845e994307ce16Greg Kroah-Hartman * will be created in sysfs, registered to the specified class. 15618882b39421bae317e3ee864edd845e994307ce16Greg Kroah-Hartman * 15628882b39421bae317e3ee864edd845e994307ce16Greg Kroah-Hartman * A "dev" file will be created, showing the dev_t for the device, if 15638882b39421bae317e3ee864edd845e994307ce16Greg Kroah-Hartman * the dev_t is not 0,0. 15648882b39421bae317e3ee864edd845e994307ce16Greg Kroah-Hartman * If a pointer to a parent struct device is passed in, the newly created 15658882b39421bae317e3ee864edd845e994307ce16Greg Kroah-Hartman * struct device will be a child of that device in sysfs. 15668882b39421bae317e3ee864edd845e994307ce16Greg Kroah-Hartman * The pointer to the struct device will be returned from the call. 15678882b39421bae317e3ee864edd845e994307ce16Greg Kroah-Hartman * Any further sysfs files that might be required can be created using this 15688882b39421bae317e3ee864edd845e994307ce16Greg Kroah-Hartman * pointer. 15698882b39421bae317e3ee864edd845e994307ce16Greg Kroah-Hartman * 1570f0eae0ed3b7d4182a6b4dd03540a738518ea3163Jani Nikula * Returns &struct device pointer on success, or ERR_PTR() on error. 1571f0eae0ed3b7d4182a6b4dd03540a738518ea3163Jani Nikula * 15728882b39421bae317e3ee864edd845e994307ce16Greg Kroah-Hartman * Note: the struct class passed to this function must have previously 15738882b39421bae317e3ee864edd845e994307ce16Greg Kroah-Hartman * been created with a call to class_create(). 15748882b39421bae317e3ee864edd845e994307ce16Greg Kroah-Hartman */ 15754e10673944a5c386378ff9d692ae37e19993f9d5Greg Kroah-Hartmanstruct device *device_create(struct class *class, struct device *parent, 15764e10673944a5c386378ff9d692ae37e19993f9d5Greg Kroah-Hartman dev_t devt, void *drvdata, const char *fmt, ...) 15778882b39421bae317e3ee864edd845e994307ce16Greg Kroah-Hartman{ 15788882b39421bae317e3ee864edd845e994307ce16Greg Kroah-Hartman va_list vargs; 15798882b39421bae317e3ee864edd845e994307ce16Greg Kroah-Hartman struct device *dev; 15808882b39421bae317e3ee864edd845e994307ce16Greg Kroah-Hartman 15818882b39421bae317e3ee864edd845e994307ce16Greg Kroah-Hartman va_start(vargs, fmt); 15828882b39421bae317e3ee864edd845e994307ce16Greg Kroah-Hartman dev = device_create_vargs(class, parent, devt, drvdata, fmt, vargs); 15838882b39421bae317e3ee864edd845e994307ce16Greg Kroah-Hartman va_end(vargs); 15848882b39421bae317e3ee864edd845e994307ce16Greg Kroah-Hartman return dev; 15858882b39421bae317e3ee864edd845e994307ce16Greg Kroah-Hartman} 15864e10673944a5c386378ff9d692ae37e19993f9d5Greg Kroah-HartmanEXPORT_SYMBOL_GPL(device_create); 15878882b39421bae317e3ee864edd845e994307ce16Greg Kroah-Hartman 1588cd35449b93ac128282c1f1f720e84c5935f9018eDave Youngstatic int __match_devt(struct device *dev, void *data) 158923681e479129854305da1da32f7f1eaf635ef22cGreg Kroah-Hartman{ 1590cd35449b93ac128282c1f1f720e84c5935f9018eDave Young dev_t *devt = data; 159123681e479129854305da1da32f7f1eaf635ef22cGreg Kroah-Hartman 1592cd35449b93ac128282c1f1f720e84c5935f9018eDave Young return dev->devt == *devt; 1593775b64d2b6ca37697de925f70799c710aab5849aRafael J. Wysocki} 1594775b64d2b6ca37697de925f70799c710aab5849aRafael J. Wysocki 1595775b64d2b6ca37697de925f70799c710aab5849aRafael J. Wysocki/** 1596775b64d2b6ca37697de925f70799c710aab5849aRafael J. Wysocki * device_destroy - removes a device that was created with device_create() 1597775b64d2b6ca37697de925f70799c710aab5849aRafael J. Wysocki * @class: pointer to the struct class that this device was registered with 1598775b64d2b6ca37697de925f70799c710aab5849aRafael J. Wysocki * @devt: the dev_t of the device that was previously registered 1599775b64d2b6ca37697de925f70799c710aab5849aRafael J. Wysocki * 1600775b64d2b6ca37697de925f70799c710aab5849aRafael J. Wysocki * This call unregisters and cleans up a device that was created with a 1601775b64d2b6ca37697de925f70799c710aab5849aRafael J. Wysocki * call to device_create(). 1602775b64d2b6ca37697de925f70799c710aab5849aRafael J. Wysocki */ 1603775b64d2b6ca37697de925f70799c710aab5849aRafael J. Wysockivoid device_destroy(struct class *class, dev_t devt) 1604775b64d2b6ca37697de925f70799c710aab5849aRafael J. Wysocki{ 1605775b64d2b6ca37697de925f70799c710aab5849aRafael J. Wysocki struct device *dev; 160623681e479129854305da1da32f7f1eaf635ef22cGreg Kroah-Hartman 1607695794ae0c5bdd9bd06e35b118801e2e9be04f9eGreg Kroah-Hartman dev = class_find_device(class, NULL, &devt, __match_devt); 1608cd35449b93ac128282c1f1f720e84c5935f9018eDave Young if (dev) { 1609cd35449b93ac128282c1f1f720e84c5935f9018eDave Young put_device(dev); 161023681e479129854305da1da32f7f1eaf635ef22cGreg Kroah-Hartman device_unregister(dev); 1611cd35449b93ac128282c1f1f720e84c5935f9018eDave Young } 161223681e479129854305da1da32f7f1eaf635ef22cGreg Kroah-Hartman} 161323681e479129854305da1da32f7f1eaf635ef22cGreg Kroah-HartmanEXPORT_SYMBOL_GPL(device_destroy); 1614a2de48cace5d0993da6cfa28b276ae724dc3569bGreg Kroah-Hartman 1615a2de48cace5d0993da6cfa28b276ae724dc3569bGreg Kroah-Hartman/** 1616a2de48cace5d0993da6cfa28b276ae724dc3569bGreg Kroah-Hartman * device_rename - renames a device 1617a2de48cace5d0993da6cfa28b276ae724dc3569bGreg Kroah-Hartman * @dev: the pointer to the struct device to be renamed 1618a2de48cace5d0993da6cfa28b276ae724dc3569bGreg Kroah-Hartman * @new_name: the new name of the device 1619030c1d2bfcc2187650fb975456ca0b61a5bb77f4Eric W. Biederman * 1620030c1d2bfcc2187650fb975456ca0b61a5bb77f4Eric W. Biederman * It is the responsibility of the caller to provide mutual 1621030c1d2bfcc2187650fb975456ca0b61a5bb77f4Eric W. Biederman * exclusion between two different calls of device_rename 1622030c1d2bfcc2187650fb975456ca0b61a5bb77f4Eric W. Biederman * on the same device to ensure that new_name is valid and 1623030c1d2bfcc2187650fb975456ca0b61a5bb77f4Eric W. Biederman * won't conflict with other devices. 1624c6c0ac664c86ff6408fadbed4913938c8a732e26Michael Ellerman * 1625a5462516aa9942bd68c8769d4bcefa8a7c718300Timur Tabi * Note: Don't call this function. Currently, the networking layer calls this 1626a5462516aa9942bd68c8769d4bcefa8a7c718300Timur Tabi * function, but that will change. The following text from Kay Sievers offers 1627a5462516aa9942bd68c8769d4bcefa8a7c718300Timur Tabi * some insight: 1628a5462516aa9942bd68c8769d4bcefa8a7c718300Timur Tabi * 1629a5462516aa9942bd68c8769d4bcefa8a7c718300Timur Tabi * Renaming devices is racy at many levels, symlinks and other stuff are not 1630a5462516aa9942bd68c8769d4bcefa8a7c718300Timur Tabi * replaced atomically, and you get a "move" uevent, but it's not easy to 1631a5462516aa9942bd68c8769d4bcefa8a7c718300Timur Tabi * connect the event to the old and new device. Device nodes are not renamed at 1632a5462516aa9942bd68c8769d4bcefa8a7c718300Timur Tabi * all, there isn't even support for that in the kernel now. 1633a5462516aa9942bd68c8769d4bcefa8a7c718300Timur Tabi * 1634a5462516aa9942bd68c8769d4bcefa8a7c718300Timur Tabi * In the meantime, during renaming, your target name might be taken by another 1635a5462516aa9942bd68c8769d4bcefa8a7c718300Timur Tabi * driver, creating conflicts. Or the old name is taken directly after you 1636a5462516aa9942bd68c8769d4bcefa8a7c718300Timur Tabi * renamed it -- then you get events for the same DEVPATH, before you even see 1637a5462516aa9942bd68c8769d4bcefa8a7c718300Timur Tabi * the "move" event. It's just a mess, and nothing new should ever rely on 1638a5462516aa9942bd68c8769d4bcefa8a7c718300Timur Tabi * kernel device renaming. Besides that, it's not even implemented now for 1639a5462516aa9942bd68c8769d4bcefa8a7c718300Timur Tabi * other things than (driver-core wise very simple) network devices. 1640a5462516aa9942bd68c8769d4bcefa8a7c718300Timur Tabi * 1641a5462516aa9942bd68c8769d4bcefa8a7c718300Timur Tabi * We are currently about to change network renaming in udev to completely 1642a5462516aa9942bd68c8769d4bcefa8a7c718300Timur Tabi * disallow renaming of devices in the same namespace as the kernel uses, 1643a5462516aa9942bd68c8769d4bcefa8a7c718300Timur Tabi * because we can't solve the problems properly, that arise with swapping names 1644a5462516aa9942bd68c8769d4bcefa8a7c718300Timur Tabi * of multiple interfaces without races. Means, renaming of eth[0-9]* will only 1645a5462516aa9942bd68c8769d4bcefa8a7c718300Timur Tabi * be allowed to some other name than eth[0-9]*, for the aforementioned 1646a5462516aa9942bd68c8769d4bcefa8a7c718300Timur Tabi * reasons. 1647a5462516aa9942bd68c8769d4bcefa8a7c718300Timur Tabi * 1648a5462516aa9942bd68c8769d4bcefa8a7c718300Timur Tabi * Make up a "real" name in the driver before you register anything, or add 1649a5462516aa9942bd68c8769d4bcefa8a7c718300Timur Tabi * some other attributes for userspace to find the device, or use udev to add 1650a5462516aa9942bd68c8769d4bcefa8a7c718300Timur Tabi * symlinks -- but never rename kernel devices later, it's a complete mess. We 1651a5462516aa9942bd68c8769d4bcefa8a7c718300Timur Tabi * don't even want to get into that and try to implement the missing pieces in 1652a5462516aa9942bd68c8769d4bcefa8a7c718300Timur Tabi * the core. We really have other pieces to fix in the driver core mess. :) 1653a2de48cace5d0993da6cfa28b276ae724dc3569bGreg Kroah-Hartman */ 16546937e8f8c0135f2325194c372ada6dc655499992Johannes Bergint device_rename(struct device *dev, const char *new_name) 1655a2de48cace5d0993da6cfa28b276ae724dc3569bGreg Kroah-Hartman{ 1656a2de48cace5d0993da6cfa28b276ae724dc3569bGreg Kroah-Hartman char *old_class_name = NULL; 1657a2de48cace5d0993da6cfa28b276ae724dc3569bGreg Kroah-Hartman char *new_class_name = NULL; 16582ee97caf0a6602f749ddbfdb1449e383e1212707Cornelia Huck char *old_device_name = NULL; 1659a2de48cace5d0993da6cfa28b276ae724dc3569bGreg Kroah-Hartman int error; 1660a2de48cace5d0993da6cfa28b276ae724dc3569bGreg Kroah-Hartman 1661a2de48cace5d0993da6cfa28b276ae724dc3569bGreg Kroah-Hartman dev = get_device(dev); 1662a2de48cace5d0993da6cfa28b276ae724dc3569bGreg Kroah-Hartman if (!dev) 1663a2de48cace5d0993da6cfa28b276ae724dc3569bGreg Kroah-Hartman return -EINVAL; 1664a2de48cace5d0993da6cfa28b276ae724dc3569bGreg Kroah-Hartman 16651e0b2cf933ebf32494eba3f668859ba57f06a951Kay Sievers pr_debug("device: '%s': %s: renaming to '%s'\n", dev_name(dev), 16662b3a302a09735276e13421db56c20045a48eb06dHarvey Harrison __func__, new_name); 1667a2de48cace5d0993da6cfa28b276ae724dc3569bGreg Kroah-Hartman 16681fa5ae857bb14f6046205171d98506d8112dd74eKay Sievers old_device_name = kstrdup(dev_name(dev), GFP_KERNEL); 16692ee97caf0a6602f749ddbfdb1449e383e1212707Cornelia Huck if (!old_device_name) { 16702ee97caf0a6602f749ddbfdb1449e383e1212707Cornelia Huck error = -ENOMEM; 16712ee97caf0a6602f749ddbfdb1449e383e1212707Cornelia Huck goto out; 1672a2de48cace5d0993da6cfa28b276ae724dc3569bGreg Kroah-Hartman } 1673a2de48cace5d0993da6cfa28b276ae724dc3569bGreg Kroah-Hartman 1674f349cf34731c3b3eddbcd63cb04489aee2c405bdEric W. Biederman if (dev->class) { 16756b6e39a6a8da7234c538d14c43d3583da8875f9cKay Sievers error = sysfs_rename_link(&dev->class->p->subsys.kobj, 1676f349cf34731c3b3eddbcd63cb04489aee2c405bdEric W. Biederman &dev->kobj, old_device_name, new_name); 1677f349cf34731c3b3eddbcd63cb04489aee2c405bdEric W. Biederman if (error) 1678f349cf34731c3b3eddbcd63cb04489aee2c405bdEric W. Biederman goto out; 1679f349cf34731c3b3eddbcd63cb04489aee2c405bdEric W. Biederman } 168039aba963d937edb20db7d9d93e6dda5d2adfdcddKay Sievers 1681a2de48cace5d0993da6cfa28b276ae724dc3569bGreg Kroah-Hartman error = kobject_rename(&dev->kobj, new_name); 16821fa5ae857bb14f6046205171d98506d8112dd74eKay Sievers if (error) 16832ee97caf0a6602f749ddbfdb1449e383e1212707Cornelia Huck goto out; 1684a2de48cace5d0993da6cfa28b276ae724dc3569bGreg Kroah-Hartman 16852ee97caf0a6602f749ddbfdb1449e383e1212707Cornelia Huckout: 1686a2de48cace5d0993da6cfa28b276ae724dc3569bGreg Kroah-Hartman put_device(dev); 1687a2de48cace5d0993da6cfa28b276ae724dc3569bGreg Kroah-Hartman 1688a2de48cace5d0993da6cfa28b276ae724dc3569bGreg Kroah-Hartman kfree(new_class_name); 1689952ab431cd36c7ab573f685af8679c3677cbdc29Jesper Juhl kfree(old_class_name); 16902ee97caf0a6602f749ddbfdb1449e383e1212707Cornelia Huck kfree(old_device_name); 1691a2de48cace5d0993da6cfa28b276ae724dc3569bGreg Kroah-Hartman 1692a2de48cace5d0993da6cfa28b276ae724dc3569bGreg Kroah-Hartman return error; 1693a2de48cace5d0993da6cfa28b276ae724dc3569bGreg Kroah-Hartman} 1694a2807dbcbd681e1f36e813fb26e2f24d15018b91Johannes BergEXPORT_SYMBOL_GPL(device_rename); 16958a82472f86bf693b8e91ed56c9ca4f62fbbdcfa3Cornelia Huck 16968a82472f86bf693b8e91ed56c9ca4f62fbbdcfa3Cornelia Huckstatic int device_move_class_links(struct device *dev, 16978a82472f86bf693b8e91ed56c9ca4f62fbbdcfa3Cornelia Huck struct device *old_parent, 16988a82472f86bf693b8e91ed56c9ca4f62fbbdcfa3Cornelia Huck struct device *new_parent) 16998a82472f86bf693b8e91ed56c9ca4f62fbbdcfa3Cornelia Huck{ 1700f7f3461d87536bed52bb83bc8fbe6bfd28619fb1Greg Kroah-Hartman int error = 0; 17018a82472f86bf693b8e91ed56c9ca4f62fbbdcfa3Cornelia Huck 1702f7f3461d87536bed52bb83bc8fbe6bfd28619fb1Greg Kroah-Hartman if (old_parent) 1703f7f3461d87536bed52bb83bc8fbe6bfd28619fb1Greg Kroah-Hartman sysfs_remove_link(&dev->kobj, "device"); 1704f7f3461d87536bed52bb83bc8fbe6bfd28619fb1Greg Kroah-Hartman if (new_parent) 1705f7f3461d87536bed52bb83bc8fbe6bfd28619fb1Greg Kroah-Hartman error = sysfs_create_link(&dev->kobj, &new_parent->kobj, 1706f7f3461d87536bed52bb83bc8fbe6bfd28619fb1Greg Kroah-Hartman "device"); 1707f7f3461d87536bed52bb83bc8fbe6bfd28619fb1Greg Kroah-Hartman return error; 17088a82472f86bf693b8e91ed56c9ca4f62fbbdcfa3Cornelia Huck} 17098a82472f86bf693b8e91ed56c9ca4f62fbbdcfa3Cornelia Huck 17108a82472f86bf693b8e91ed56c9ca4f62fbbdcfa3Cornelia Huck/** 17118a82472f86bf693b8e91ed56c9ca4f62fbbdcfa3Cornelia Huck * device_move - moves a device to a new parent 17128a82472f86bf693b8e91ed56c9ca4f62fbbdcfa3Cornelia Huck * @dev: the pointer to the struct device to be moved 1713c744aeae9d173a953b771a7ad5c872f91fa99decCornelia Huck * @new_parent: the new parent of the device (can by NULL) 1714ffa6a7054d172a2f57248dff2de600ca795c5656Cornelia Huck * @dpm_order: how to reorder the dpm_list 17158a82472f86bf693b8e91ed56c9ca4f62fbbdcfa3Cornelia Huck */ 1716ffa6a7054d172a2f57248dff2de600ca795c5656Cornelia Huckint device_move(struct device *dev, struct device *new_parent, 1717ffa6a7054d172a2f57248dff2de600ca795c5656Cornelia Huck enum dpm_order dpm_order) 17188a82472f86bf693b8e91ed56c9ca4f62fbbdcfa3Cornelia Huck{ 17198a82472f86bf693b8e91ed56c9ca4f62fbbdcfa3Cornelia Huck int error; 17208a82472f86bf693b8e91ed56c9ca4f62fbbdcfa3Cornelia Huck struct device *old_parent; 1721c744aeae9d173a953b771a7ad5c872f91fa99decCornelia Huck struct kobject *new_parent_kobj; 17228a82472f86bf693b8e91ed56c9ca4f62fbbdcfa3Cornelia Huck 17238a82472f86bf693b8e91ed56c9ca4f62fbbdcfa3Cornelia Huck dev = get_device(dev); 17248a82472f86bf693b8e91ed56c9ca4f62fbbdcfa3Cornelia Huck if (!dev) 17258a82472f86bf693b8e91ed56c9ca4f62fbbdcfa3Cornelia Huck return -EINVAL; 17268a82472f86bf693b8e91ed56c9ca4f62fbbdcfa3Cornelia Huck 1727ffa6a7054d172a2f57248dff2de600ca795c5656Cornelia Huck device_pm_lock(); 17288a82472f86bf693b8e91ed56c9ca4f62fbbdcfa3Cornelia Huck new_parent = get_device(new_parent); 17294a3ad20ccd8f4d2a0535cf98fa83f7b561ba59a9Greg Kroah-Hartman new_parent_kobj = get_device_parent(dev, new_parent); 173063b6971a0876b744e2fcf3c9df15d130501e1debCornelia Huck 17311e0b2cf933ebf32494eba3f668859ba57f06a951Kay Sievers pr_debug("device: '%s': %s: moving to '%s'\n", dev_name(dev), 17321e0b2cf933ebf32494eba3f668859ba57f06a951Kay Sievers __func__, new_parent ? dev_name(new_parent) : "<NULL>"); 1733c744aeae9d173a953b771a7ad5c872f91fa99decCornelia Huck error = kobject_move(&dev->kobj, new_parent_kobj); 17348a82472f86bf693b8e91ed56c9ca4f62fbbdcfa3Cornelia Huck if (error) { 173563b6971a0876b744e2fcf3c9df15d130501e1debCornelia Huck cleanup_glue_dir(dev, new_parent_kobj); 17368a82472f86bf693b8e91ed56c9ca4f62fbbdcfa3Cornelia Huck put_device(new_parent); 17378a82472f86bf693b8e91ed56c9ca4f62fbbdcfa3Cornelia Huck goto out; 17388a82472f86bf693b8e91ed56c9ca4f62fbbdcfa3Cornelia Huck } 17398a82472f86bf693b8e91ed56c9ca4f62fbbdcfa3Cornelia Huck old_parent = dev->parent; 17408a82472f86bf693b8e91ed56c9ca4f62fbbdcfa3Cornelia Huck dev->parent = new_parent; 17418a82472f86bf693b8e91ed56c9ca4f62fbbdcfa3Cornelia Huck if (old_parent) 1742f791b8c836307b58cbf62133a6a772ed1a92fb33Greg Kroah-Hartman klist_remove(&dev->p->knode_parent); 17430d358f22f6c8f03ab215eee8d52b74f78cc3c7dbYinghai Lu if (new_parent) { 1744f791b8c836307b58cbf62133a6a772ed1a92fb33Greg Kroah-Hartman klist_add_tail(&dev->p->knode_parent, 1745f791b8c836307b58cbf62133a6a772ed1a92fb33Greg Kroah-Hartman &new_parent->p->klist_children); 17460d358f22f6c8f03ab215eee8d52b74f78cc3c7dbYinghai Lu set_dev_node(dev, dev_to_node(new_parent)); 17470d358f22f6c8f03ab215eee8d52b74f78cc3c7dbYinghai Lu } 17480d358f22f6c8f03ab215eee8d52b74f78cc3c7dbYinghai Lu 17498a82472f86bf693b8e91ed56c9ca4f62fbbdcfa3Cornelia Huck if (!dev->class) 17508a82472f86bf693b8e91ed56c9ca4f62fbbdcfa3Cornelia Huck goto out_put; 17518a82472f86bf693b8e91ed56c9ca4f62fbbdcfa3Cornelia Huck error = device_move_class_links(dev, old_parent, new_parent); 17528a82472f86bf693b8e91ed56c9ca4f62fbbdcfa3Cornelia Huck if (error) { 17538a82472f86bf693b8e91ed56c9ca4f62fbbdcfa3Cornelia Huck /* We ignore errors on cleanup since we're hosed anyway... */ 17548a82472f86bf693b8e91ed56c9ca4f62fbbdcfa3Cornelia Huck device_move_class_links(dev, new_parent, old_parent); 17558a82472f86bf693b8e91ed56c9ca4f62fbbdcfa3Cornelia Huck if (!kobject_move(&dev->kobj, &old_parent->kobj)) { 1756c744aeae9d173a953b771a7ad5c872f91fa99decCornelia Huck if (new_parent) 1757f791b8c836307b58cbf62133a6a772ed1a92fb33Greg Kroah-Hartman klist_remove(&dev->p->knode_parent); 17580d358f22f6c8f03ab215eee8d52b74f78cc3c7dbYinghai Lu dev->parent = old_parent; 17590d358f22f6c8f03ab215eee8d52b74f78cc3c7dbYinghai Lu if (old_parent) { 1760f791b8c836307b58cbf62133a6a772ed1a92fb33Greg Kroah-Hartman klist_add_tail(&dev->p->knode_parent, 1761f791b8c836307b58cbf62133a6a772ed1a92fb33Greg Kroah-Hartman &old_parent->p->klist_children); 17620d358f22f6c8f03ab215eee8d52b74f78cc3c7dbYinghai Lu set_dev_node(dev, dev_to_node(old_parent)); 17630d358f22f6c8f03ab215eee8d52b74f78cc3c7dbYinghai Lu } 17648a82472f86bf693b8e91ed56c9ca4f62fbbdcfa3Cornelia Huck } 176563b6971a0876b744e2fcf3c9df15d130501e1debCornelia Huck cleanup_glue_dir(dev, new_parent_kobj); 17668a82472f86bf693b8e91ed56c9ca4f62fbbdcfa3Cornelia Huck put_device(new_parent); 17678a82472f86bf693b8e91ed56c9ca4f62fbbdcfa3Cornelia Huck goto out; 17688a82472f86bf693b8e91ed56c9ca4f62fbbdcfa3Cornelia Huck } 1769ffa6a7054d172a2f57248dff2de600ca795c5656Cornelia Huck switch (dpm_order) { 1770ffa6a7054d172a2f57248dff2de600ca795c5656Cornelia Huck case DPM_ORDER_NONE: 1771ffa6a7054d172a2f57248dff2de600ca795c5656Cornelia Huck break; 1772ffa6a7054d172a2f57248dff2de600ca795c5656Cornelia Huck case DPM_ORDER_DEV_AFTER_PARENT: 1773ffa6a7054d172a2f57248dff2de600ca795c5656Cornelia Huck device_pm_move_after(dev, new_parent); 1774ffa6a7054d172a2f57248dff2de600ca795c5656Cornelia Huck break; 1775ffa6a7054d172a2f57248dff2de600ca795c5656Cornelia Huck case DPM_ORDER_PARENT_BEFORE_DEV: 1776ffa6a7054d172a2f57248dff2de600ca795c5656Cornelia Huck device_pm_move_before(new_parent, dev); 1777ffa6a7054d172a2f57248dff2de600ca795c5656Cornelia Huck break; 1778ffa6a7054d172a2f57248dff2de600ca795c5656Cornelia Huck case DPM_ORDER_DEV_LAST: 1779ffa6a7054d172a2f57248dff2de600ca795c5656Cornelia Huck device_pm_move_last(dev); 1780ffa6a7054d172a2f57248dff2de600ca795c5656Cornelia Huck break; 1781ffa6a7054d172a2f57248dff2de600ca795c5656Cornelia Huck } 17828a82472f86bf693b8e91ed56c9ca4f62fbbdcfa3Cornelia Huckout_put: 17838a82472f86bf693b8e91ed56c9ca4f62fbbdcfa3Cornelia Huck put_device(old_parent); 17848a82472f86bf693b8e91ed56c9ca4f62fbbdcfa3Cornelia Huckout: 1785ffa6a7054d172a2f57248dff2de600ca795c5656Cornelia Huck device_pm_unlock(); 17868a82472f86bf693b8e91ed56c9ca4f62fbbdcfa3Cornelia Huck put_device(dev); 17878a82472f86bf693b8e91ed56c9ca4f62fbbdcfa3Cornelia Huck return error; 17888a82472f86bf693b8e91ed56c9ca4f62fbbdcfa3Cornelia Huck} 17898a82472f86bf693b8e91ed56c9ca4f62fbbdcfa3Cornelia HuckEXPORT_SYMBOL_GPL(device_move); 179037b0c020343080241984d978981d6caf877b278aGreg Kroah-Hartman 179137b0c020343080241984d978981d6caf877b278aGreg Kroah-Hartman/** 179237b0c020343080241984d978981d6caf877b278aGreg Kroah-Hartman * device_shutdown - call ->shutdown() on each device to shutdown. 179337b0c020343080241984d978981d6caf877b278aGreg Kroah-Hartman */ 179437b0c020343080241984d978981d6caf877b278aGreg Kroah-Hartmanvoid device_shutdown(void) 179537b0c020343080241984d978981d6caf877b278aGreg Kroah-Hartman{ 17966245838fe4d2ce4aab52f543224f7d1212d9155cHugh Daschbach struct device *dev; 17976245838fe4d2ce4aab52f543224f7d1212d9155cHugh Daschbach 17986245838fe4d2ce4aab52f543224f7d1212d9155cHugh Daschbach spin_lock(&devices_kset->list_lock); 17996245838fe4d2ce4aab52f543224f7d1212d9155cHugh Daschbach /* 18006245838fe4d2ce4aab52f543224f7d1212d9155cHugh Daschbach * Walk the devices list backward, shutting down each in turn. 18016245838fe4d2ce4aab52f543224f7d1212d9155cHugh Daschbach * Beware that device unplug events may also start pulling 18026245838fe4d2ce4aab52f543224f7d1212d9155cHugh Daschbach * devices offline, even as the system is shutting down. 18036245838fe4d2ce4aab52f543224f7d1212d9155cHugh Daschbach */ 18046245838fe4d2ce4aab52f543224f7d1212d9155cHugh Daschbach while (!list_empty(&devices_kset->list)) { 18056245838fe4d2ce4aab52f543224f7d1212d9155cHugh Daschbach dev = list_entry(devices_kset->list.prev, struct device, 18066245838fe4d2ce4aab52f543224f7d1212d9155cHugh Daschbach kobj.entry); 18076245838fe4d2ce4aab52f543224f7d1212d9155cHugh Daschbach get_device(dev); 18086245838fe4d2ce4aab52f543224f7d1212d9155cHugh Daschbach /* 18096245838fe4d2ce4aab52f543224f7d1212d9155cHugh Daschbach * Make sure the device is off the kset list, in the 18106245838fe4d2ce4aab52f543224f7d1212d9155cHugh Daschbach * event that dev->*->shutdown() doesn't remove it. 18116245838fe4d2ce4aab52f543224f7d1212d9155cHugh Daschbach */ 18126245838fe4d2ce4aab52f543224f7d1212d9155cHugh Daschbach list_del_init(&dev->kobj.entry); 18136245838fe4d2ce4aab52f543224f7d1212d9155cHugh Daschbach spin_unlock(&devices_kset->list_lock); 1814fe6b91f47080eb17d21cbf2a39311877d57f6938Alan Stern 1815fe6b91f47080eb17d21cbf2a39311877d57f6938Alan Stern /* Don't allow any more runtime suspends */ 1816fe6b91f47080eb17d21cbf2a39311877d57f6938Alan Stern pm_runtime_get_noresume(dev); 1817fe6b91f47080eb17d21cbf2a39311877d57f6938Alan Stern pm_runtime_barrier(dev); 181837b0c020343080241984d978981d6caf877b278aGreg Kroah-Hartman 181937b0c020343080241984d978981d6caf877b278aGreg Kroah-Hartman if (dev->bus && dev->bus->shutdown) { 182037b0c020343080241984d978981d6caf877b278aGreg Kroah-Hartman dev_dbg(dev, "shutdown\n"); 182137b0c020343080241984d978981d6caf877b278aGreg Kroah-Hartman dev->bus->shutdown(dev); 182237b0c020343080241984d978981d6caf877b278aGreg Kroah-Hartman } else if (dev->driver && dev->driver->shutdown) { 182337b0c020343080241984d978981d6caf877b278aGreg Kroah-Hartman dev_dbg(dev, "shutdown\n"); 182437b0c020343080241984d978981d6caf877b278aGreg Kroah-Hartman dev->driver->shutdown(dev); 182537b0c020343080241984d978981d6caf877b278aGreg Kroah-Hartman } 18266245838fe4d2ce4aab52f543224f7d1212d9155cHugh Daschbach put_device(dev); 18276245838fe4d2ce4aab52f543224f7d1212d9155cHugh Daschbach 18286245838fe4d2ce4aab52f543224f7d1212d9155cHugh Daschbach spin_lock(&devices_kset->list_lock); 182937b0c020343080241984d978981d6caf877b278aGreg Kroah-Hartman } 18306245838fe4d2ce4aab52f543224f7d1212d9155cHugh Daschbach spin_unlock(&devices_kset->list_lock); 1831401097ea4b89846d66ac78f7f108d49c2e922d9cShaohua Li async_synchronize_full(); 183237b0c020343080241984d978981d6caf877b278aGreg Kroah-Hartman} 183399bcf217183e02ebae46373896fba7f12d588001Joe Perches 183499bcf217183e02ebae46373896fba7f12d588001Joe Perches/* 183599bcf217183e02ebae46373896fba7f12d588001Joe Perches * Device logging functions 183699bcf217183e02ebae46373896fba7f12d588001Joe Perches */ 183799bcf217183e02ebae46373896fba7f12d588001Joe Perches 183899bcf217183e02ebae46373896fba7f12d588001Joe Perches#ifdef CONFIG_PRINTK 183999bcf217183e02ebae46373896fba7f12d588001Joe Perches 1840cbc4663552ee476f57933920d782222d94878e7eJoe Perchesint __dev_printk(const char *level, const struct device *dev, 1841cbc4663552ee476f57933920d782222d94878e7eJoe Perches struct va_format *vaf) 184299bcf217183e02ebae46373896fba7f12d588001Joe Perches{ 184399bcf217183e02ebae46373896fba7f12d588001Joe Perches if (!dev) 184499bcf217183e02ebae46373896fba7f12d588001Joe Perches return printk("%s(NULL device *): %pV", level, vaf); 184599bcf217183e02ebae46373896fba7f12d588001Joe Perches 184699bcf217183e02ebae46373896fba7f12d588001Joe Perches return printk("%s%s %s: %pV", 184799bcf217183e02ebae46373896fba7f12d588001Joe Perches level, dev_driver_string(dev), dev_name(dev), vaf); 184899bcf217183e02ebae46373896fba7f12d588001Joe Perches} 1849cbc4663552ee476f57933920d782222d94878e7eJoe PerchesEXPORT_SYMBOL(__dev_printk); 185099bcf217183e02ebae46373896fba7f12d588001Joe Perches 185199bcf217183e02ebae46373896fba7f12d588001Joe Perchesint dev_printk(const char *level, const struct device *dev, 185299bcf217183e02ebae46373896fba7f12d588001Joe Perches const char *fmt, ...) 185399bcf217183e02ebae46373896fba7f12d588001Joe Perches{ 185499bcf217183e02ebae46373896fba7f12d588001Joe Perches struct va_format vaf; 185599bcf217183e02ebae46373896fba7f12d588001Joe Perches va_list args; 185699bcf217183e02ebae46373896fba7f12d588001Joe Perches int r; 185799bcf217183e02ebae46373896fba7f12d588001Joe Perches 185899bcf217183e02ebae46373896fba7f12d588001Joe Perches va_start(args, fmt); 185999bcf217183e02ebae46373896fba7f12d588001Joe Perches 186099bcf217183e02ebae46373896fba7f12d588001Joe Perches vaf.fmt = fmt; 186199bcf217183e02ebae46373896fba7f12d588001Joe Perches vaf.va = &args; 186299bcf217183e02ebae46373896fba7f12d588001Joe Perches 186399bcf217183e02ebae46373896fba7f12d588001Joe Perches r = __dev_printk(level, dev, &vaf); 186499bcf217183e02ebae46373896fba7f12d588001Joe Perches va_end(args); 186599bcf217183e02ebae46373896fba7f12d588001Joe Perches 186699bcf217183e02ebae46373896fba7f12d588001Joe Perches return r; 186799bcf217183e02ebae46373896fba7f12d588001Joe Perches} 186899bcf217183e02ebae46373896fba7f12d588001Joe PerchesEXPORT_SYMBOL(dev_printk); 186999bcf217183e02ebae46373896fba7f12d588001Joe Perches 187099bcf217183e02ebae46373896fba7f12d588001Joe Perches#define define_dev_printk_level(func, kern_level) \ 187199bcf217183e02ebae46373896fba7f12d588001Joe Perchesint func(const struct device *dev, const char *fmt, ...) \ 187299bcf217183e02ebae46373896fba7f12d588001Joe Perches{ \ 187399bcf217183e02ebae46373896fba7f12d588001Joe Perches struct va_format vaf; \ 187499bcf217183e02ebae46373896fba7f12d588001Joe Perches va_list args; \ 187599bcf217183e02ebae46373896fba7f12d588001Joe Perches int r; \ 187699bcf217183e02ebae46373896fba7f12d588001Joe Perches \ 187799bcf217183e02ebae46373896fba7f12d588001Joe Perches va_start(args, fmt); \ 187899bcf217183e02ebae46373896fba7f12d588001Joe Perches \ 187999bcf217183e02ebae46373896fba7f12d588001Joe Perches vaf.fmt = fmt; \ 188099bcf217183e02ebae46373896fba7f12d588001Joe Perches vaf.va = &args; \ 188199bcf217183e02ebae46373896fba7f12d588001Joe Perches \ 188299bcf217183e02ebae46373896fba7f12d588001Joe Perches r = __dev_printk(kern_level, dev, &vaf); \ 188399bcf217183e02ebae46373896fba7f12d588001Joe Perches va_end(args); \ 188499bcf217183e02ebae46373896fba7f12d588001Joe Perches \ 188599bcf217183e02ebae46373896fba7f12d588001Joe Perches return r; \ 188699bcf217183e02ebae46373896fba7f12d588001Joe Perches} \ 188799bcf217183e02ebae46373896fba7f12d588001Joe PerchesEXPORT_SYMBOL(func); 188899bcf217183e02ebae46373896fba7f12d588001Joe Perches 188999bcf217183e02ebae46373896fba7f12d588001Joe Perchesdefine_dev_printk_level(dev_emerg, KERN_EMERG); 189099bcf217183e02ebae46373896fba7f12d588001Joe Perchesdefine_dev_printk_level(dev_alert, KERN_ALERT); 189199bcf217183e02ebae46373896fba7f12d588001Joe Perchesdefine_dev_printk_level(dev_crit, KERN_CRIT); 189299bcf217183e02ebae46373896fba7f12d588001Joe Perchesdefine_dev_printk_level(dev_err, KERN_ERR); 189399bcf217183e02ebae46373896fba7f12d588001Joe Perchesdefine_dev_printk_level(dev_warn, KERN_WARNING); 189499bcf217183e02ebae46373896fba7f12d588001Joe Perchesdefine_dev_printk_level(dev_notice, KERN_NOTICE); 189599bcf217183e02ebae46373896fba7f12d588001Joe Perchesdefine_dev_printk_level(_dev_info, KERN_INFO); 189699bcf217183e02ebae46373896fba7f12d588001Joe Perches 189799bcf217183e02ebae46373896fba7f12d588001Joe Perches#endif 1898