core.c revision 2b2af54a5bb6f7e80ccf78f20084b93c398c3a8b
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> 236188e10d38b8d7244ee7776d5f1f88c837b4b93fMatthew Wilcox#include <linux/semaphore.h> 24f75b1c60fc1e53c4004a79ea0be071aa3318cdccDave Young#include <linux/mutex.h> 25401097ea4b89846d66ac78f7f108d49c2e922d9cShaohua Li#include <linux/async.h> 261da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds 271da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds#include "base.h" 281da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds#include "power/power.h" 291da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds 304a3ad20ccd8f4d2a0535cf98fa83f7b561ba59a9Greg Kroah-Hartmanint (*platform_notify)(struct device *dev) = NULL; 314a3ad20ccd8f4d2a0535cf98fa83f7b561ba59a9Greg Kroah-Hartmanint (*platform_notify_remove)(struct device *dev) = NULL; 32e105b8bfc769b0545b6f0f395179d1e43cbee822Dan Williamsstatic struct kobject *dev_kobj; 33e105b8bfc769b0545b6f0f395179d1e43cbee822Dan Williamsstruct kobject *sysfs_dev_char_kobj; 34e105b8bfc769b0545b6f0f395179d1e43cbee822Dan Williamsstruct kobject *sysfs_dev_block_kobj; 351da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds 364e886c29610f4374d8971ec7a248f011cc3bd73aGreg Kroah-Hartman#ifdef CONFIG_BLOCK 374e886c29610f4374d8971ec7a248f011cc3bd73aGreg Kroah-Hartmanstatic inline int device_is_not_partition(struct device *dev) 384e886c29610f4374d8971ec7a248f011cc3bd73aGreg Kroah-Hartman{ 394e886c29610f4374d8971ec7a248f011cc3bd73aGreg Kroah-Hartman return !(dev->type == &part_type); 404e886c29610f4374d8971ec7a248f011cc3bd73aGreg Kroah-Hartman} 414e886c29610f4374d8971ec7a248f011cc3bd73aGreg Kroah-Hartman#else 424e886c29610f4374d8971ec7a248f011cc3bd73aGreg Kroah-Hartmanstatic inline int device_is_not_partition(struct device *dev) 434e886c29610f4374d8971ec7a248f011cc3bd73aGreg Kroah-Hartman{ 444e886c29610f4374d8971ec7a248f011cc3bd73aGreg Kroah-Hartman return 1; 454e886c29610f4374d8971ec7a248f011cc3bd73aGreg Kroah-Hartman} 464e886c29610f4374d8971ec7a248f011cc3bd73aGreg Kroah-Hartman#endif 471da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds 483e95637a48820ff8bedb33e6439def96ccff1de5Alan Stern/** 493e95637a48820ff8bedb33e6439def96ccff1de5Alan Stern * dev_driver_string - Return a device's driver name, if at all possible 503e95637a48820ff8bedb33e6439def96ccff1de5Alan Stern * @dev: struct device to get the name of 513e95637a48820ff8bedb33e6439def96ccff1de5Alan Stern * 523e95637a48820ff8bedb33e6439def96ccff1de5Alan Stern * Will return the device's driver's name if it is bound to a device. If 533e95637a48820ff8bedb33e6439def96ccff1de5Alan Stern * the device is not bound to a device, it will return the name of the bus 543e95637a48820ff8bedb33e6439def96ccff1de5Alan Stern * it is attached to. If it is not attached to a bus either, an empty 553e95637a48820ff8bedb33e6439def96ccff1de5Alan Stern * string will be returned. 563e95637a48820ff8bedb33e6439def96ccff1de5Alan Stern */ 57bf9ca69fc8d19d4034391d3df4c35dccdef9d28cJean Delvareconst char *dev_driver_string(const struct device *dev) 583e95637a48820ff8bedb33e6439def96ccff1de5Alan Stern{ 593e95637a48820ff8bedb33e6439def96ccff1de5Alan Stern return dev->driver ? dev->driver->name : 60a456b7023e0abf80bb03b0bdf5471b48878e5c49Jean Delvare (dev->bus ? dev->bus->name : 61a456b7023e0abf80bb03b0bdf5471b48878e5c49Jean Delvare (dev->class ? dev->class->name : "")); 623e95637a48820ff8bedb33e6439def96ccff1de5Alan Stern} 63310a922d4307ed38b37982a6f93b11fdf3b8dcb1Matthew WilcoxEXPORT_SYMBOL(dev_driver_string); 643e95637a48820ff8bedb33e6439def96ccff1de5Alan Stern 651da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds#define to_dev(obj) container_of(obj, struct device, kobj) 661da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds#define to_dev_attr(_attr) container_of(_attr, struct device_attribute, attr) 671da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds 684a3ad20ccd8f4d2a0535cf98fa83f7b561ba59a9Greg Kroah-Hartmanstatic ssize_t dev_attr_show(struct kobject *kobj, struct attribute *attr, 694a3ad20ccd8f4d2a0535cf98fa83f7b561ba59a9Greg Kroah-Hartman char *buf) 701da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds{ 714a3ad20ccd8f4d2a0535cf98fa83f7b561ba59a9Greg Kroah-Hartman struct device_attribute *dev_attr = to_dev_attr(attr); 724a3ad20ccd8f4d2a0535cf98fa83f7b561ba59a9Greg Kroah-Hartman struct device *dev = to_dev(kobj); 734a0c20bf8c0fe2116f8fd7d3da6122bf8a01f026Dmitry Torokhov ssize_t ret = -EIO; 741da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds 751da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds if (dev_attr->show) 7654b6f35c99974e99e64c05c2895718355123c55fYani Ioannou ret = dev_attr->show(dev, dev_attr, buf); 77815d2d50da41f28aae58f5e9b3c61c3094422749Andrew Morton if (ret >= (ssize_t)PAGE_SIZE) { 78815d2d50da41f28aae58f5e9b3c61c3094422749Andrew Morton print_symbol("dev_attr_show: %s returned bad count\n", 79815d2d50da41f28aae58f5e9b3c61c3094422749Andrew Morton (unsigned long)dev_attr->show); 80815d2d50da41f28aae58f5e9b3c61c3094422749Andrew Morton } 811da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds return ret; 821da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds} 831da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds 844a3ad20ccd8f4d2a0535cf98fa83f7b561ba59a9Greg Kroah-Hartmanstatic ssize_t dev_attr_store(struct kobject *kobj, struct attribute *attr, 854a3ad20ccd8f4d2a0535cf98fa83f7b561ba59a9Greg Kroah-Hartman const char *buf, size_t count) 861da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds{ 874a3ad20ccd8f4d2a0535cf98fa83f7b561ba59a9Greg Kroah-Hartman struct device_attribute *dev_attr = to_dev_attr(attr); 884a3ad20ccd8f4d2a0535cf98fa83f7b561ba59a9Greg Kroah-Hartman struct device *dev = to_dev(kobj); 894a0c20bf8c0fe2116f8fd7d3da6122bf8a01f026Dmitry Torokhov ssize_t ret = -EIO; 901da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds 911da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds if (dev_attr->store) 9254b6f35c99974e99e64c05c2895718355123c55fYani Ioannou ret = dev_attr->store(dev, dev_attr, buf, count); 931da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds return ret; 941da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds} 951da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds 961da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvaldsstatic struct sysfs_ops dev_sysfs_ops = { 971da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds .show = dev_attr_show, 981da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds .store = dev_attr_store, 991da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds}; 1001da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds 1011da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds 1021da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds/** 1031da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds * device_release - free device structure. 1041da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds * @kobj: device's kobject. 1051da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds * 1061da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds * This is called once the reference count for the object 1071da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds * reaches 0. We forward the call to the device's release 1081da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds * method, which should handle actually freeing the structure. 1091da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds */ 1104a3ad20ccd8f4d2a0535cf98fa83f7b561ba59a9Greg Kroah-Hartmanstatic void device_release(struct kobject *kobj) 1111da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds{ 1124a3ad20ccd8f4d2a0535cf98fa83f7b561ba59a9Greg Kroah-Hartman struct device *dev = to_dev(kobj); 113fb069a5d132fb926ed17af3211a114ac7cf27d7aGreg Kroah-Hartman struct device_private *p = dev->p; 1141da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds 1151da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds if (dev->release) 1161da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds dev->release(dev); 117f9f852df2faf76a2667949ddb4947d4b8f99f02fKay Sievers else if (dev->type && dev->type->release) 118f9f852df2faf76a2667949ddb4947d4b8f99f02fKay Sievers dev->type->release(dev); 1192620efef7029bb040430f50f0fc148f2d5e002adGreg Kroah-Hartman else if (dev->class && dev->class->dev_release) 1202620efef7029bb040430f50f0fc148f2d5e002adGreg Kroah-Hartman dev->class->dev_release(dev); 121f810a5cf28a818db96333cd23646f0227ec015b4Arjan van de Ven else 122f810a5cf28a818db96333cd23646f0227ec015b4Arjan van de Ven WARN(1, KERN_ERR "Device '%s' does not have a release() " 1234a3ad20ccd8f4d2a0535cf98fa83f7b561ba59a9Greg Kroah-Hartman "function, it is broken and must be fixed.\n", 1241e0b2cf933ebf32494eba3f668859ba57f06a951Kay Sievers dev_name(dev)); 125fb069a5d132fb926ed17af3211a114ac7cf27d7aGreg Kroah-Hartman kfree(p); 1261da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds} 1271da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds 1288f4afc410b8d2be49f34835b6bbe788f50471b02Greg Kroah-Hartmanstatic struct kobj_type device_ktype = { 1291da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds .release = device_release, 1301da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds .sysfs_ops = &dev_sysfs_ops, 1311da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds}; 1321da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds 1331da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds 134312c004d36ce6c739512bac83b452f4c20ab1f62Kay Sieversstatic int dev_uevent_filter(struct kset *kset, struct kobject *kobj) 1351da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds{ 1361da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds struct kobj_type *ktype = get_ktype(kobj); 1371da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds 1388f4afc410b8d2be49f34835b6bbe788f50471b02Greg Kroah-Hartman if (ktype == &device_ktype) { 1391da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds struct device *dev = to_dev(kobj); 1401da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds if (dev->bus) 1411da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds return 1; 14223681e479129854305da1da32f7f1eaf635ef22cGreg Kroah-Hartman if (dev->class) 14323681e479129854305da1da32f7f1eaf635ef22cGreg Kroah-Hartman return 1; 1441da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds } 1451da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds return 0; 1461da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds} 1471da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds 148312c004d36ce6c739512bac83b452f4c20ab1f62Kay Sieversstatic const char *dev_uevent_name(struct kset *kset, struct kobject *kobj) 1491da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds{ 1501da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds struct device *dev = to_dev(kobj); 1511da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds 15223681e479129854305da1da32f7f1eaf635ef22cGreg Kroah-Hartman if (dev->bus) 15323681e479129854305da1da32f7f1eaf635ef22cGreg Kroah-Hartman return dev->bus->name; 15423681e479129854305da1da32f7f1eaf635ef22cGreg Kroah-Hartman if (dev->class) 15523681e479129854305da1da32f7f1eaf635ef22cGreg Kroah-Hartman return dev->class->name; 15623681e479129854305da1da32f7f1eaf635ef22cGreg Kroah-Hartman return NULL; 1571da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds} 1581da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds 1597eff2e7a8b65c25920207324e56611150eb1cd9aKay Sieversstatic int dev_uevent(struct kset *kset, struct kobject *kobj, 1607eff2e7a8b65c25920207324e56611150eb1cd9aKay Sievers struct kobj_uevent_env *env) 1611da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds{ 1621da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds struct device *dev = to_dev(kobj); 1631da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds int retval = 0; 1641da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds 1656fcf53acccf85b4b0d0260e66c692a341760f464Kay Sievers /* add device node properties if present */ 16623681e479129854305da1da32f7f1eaf635ef22cGreg Kroah-Hartman if (MAJOR(dev->devt)) { 1676fcf53acccf85b4b0d0260e66c692a341760f464Kay Sievers const char *tmp; 1686fcf53acccf85b4b0d0260e66c692a341760f464Kay Sievers const char *name; 1696fcf53acccf85b4b0d0260e66c692a341760f464Kay Sievers 1707eff2e7a8b65c25920207324e56611150eb1cd9aKay Sievers add_uevent_var(env, "MAJOR=%u", MAJOR(dev->devt)); 1717eff2e7a8b65c25920207324e56611150eb1cd9aKay Sievers add_uevent_var(env, "MINOR=%u", MINOR(dev->devt)); 1726fcf53acccf85b4b0d0260e66c692a341760f464Kay Sievers name = device_get_nodename(dev, &tmp); 1736fcf53acccf85b4b0d0260e66c692a341760f464Kay Sievers if (name) { 1746fcf53acccf85b4b0d0260e66c692a341760f464Kay Sievers add_uevent_var(env, "DEVNAME=%s", name); 1756fcf53acccf85b4b0d0260e66c692a341760f464Kay Sievers kfree(tmp); 1766fcf53acccf85b4b0d0260e66c692a341760f464Kay Sievers } 17723681e479129854305da1da32f7f1eaf635ef22cGreg Kroah-Hartman } 17823681e479129854305da1da32f7f1eaf635ef22cGreg Kroah-Hartman 179414264f959cf46f49f974b3510400e12ac3624a6Kay Sievers if (dev->type && dev->type->name) 1807eff2e7a8b65c25920207324e56611150eb1cd9aKay Sievers add_uevent_var(env, "DEVTYPE=%s", dev->type->name); 181414264f959cf46f49f974b3510400e12ac3624a6Kay Sievers 182239378f16aa1ab5c502e42a06359d2de4f88ebb4Kay Sievers if (dev->driver) 1837eff2e7a8b65c25920207324e56611150eb1cd9aKay Sievers add_uevent_var(env, "DRIVER=%s", dev->driver->name); 184239378f16aa1ab5c502e42a06359d2de4f88ebb4Kay Sievers 185a87cb2ac4a78c590583b52a3ed196adc6c25b6c9Kay Sievers#ifdef CONFIG_SYSFS_DEPRECATED 186239378f16aa1ab5c502e42a06359d2de4f88ebb4Kay Sievers if (dev->class) { 187239378f16aa1ab5c502e42a06359d2de4f88ebb4Kay Sievers struct device *parent = dev->parent; 188239378f16aa1ab5c502e42a06359d2de4f88ebb4Kay Sievers 189239378f16aa1ab5c502e42a06359d2de4f88ebb4Kay Sievers /* find first bus device in parent chain */ 190239378f16aa1ab5c502e42a06359d2de4f88ebb4Kay Sievers while (parent && !parent->bus) 191239378f16aa1ab5c502e42a06359d2de4f88ebb4Kay Sievers parent = parent->parent; 192239378f16aa1ab5c502e42a06359d2de4f88ebb4Kay Sievers if (parent && parent->bus) { 193239378f16aa1ab5c502e42a06359d2de4f88ebb4Kay Sievers const char *path; 194239378f16aa1ab5c502e42a06359d2de4f88ebb4Kay Sievers 195239378f16aa1ab5c502e42a06359d2de4f88ebb4Kay Sievers path = kobject_get_path(&parent->kobj, GFP_KERNEL); 1962c7afd125cc482dbdf6b0a169c42337e7e76cda5Kay Sievers if (path) { 1977eff2e7a8b65c25920207324e56611150eb1cd9aKay Sievers add_uevent_var(env, "PHYSDEVPATH=%s", path); 1982c7afd125cc482dbdf6b0a169c42337e7e76cda5Kay Sievers kfree(path); 1992c7afd125cc482dbdf6b0a169c42337e7e76cda5Kay Sievers } 200239378f16aa1ab5c502e42a06359d2de4f88ebb4Kay Sievers 2017eff2e7a8b65c25920207324e56611150eb1cd9aKay Sievers add_uevent_var(env, "PHYSDEVBUS=%s", parent->bus->name); 202239378f16aa1ab5c502e42a06359d2de4f88ebb4Kay Sievers 203239378f16aa1ab5c502e42a06359d2de4f88ebb4Kay Sievers if (parent->driver) 2047eff2e7a8b65c25920207324e56611150eb1cd9aKay Sievers add_uevent_var(env, "PHYSDEVDRIVER=%s", 2057eff2e7a8b65c25920207324e56611150eb1cd9aKay Sievers parent->driver->name); 206239378f16aa1ab5c502e42a06359d2de4f88ebb4Kay Sievers } 207239378f16aa1ab5c502e42a06359d2de4f88ebb4Kay Sievers } else if (dev->bus) { 2087eff2e7a8b65c25920207324e56611150eb1cd9aKay Sievers add_uevent_var(env, "PHYSDEVBUS=%s", dev->bus->name); 209239378f16aa1ab5c502e42a06359d2de4f88ebb4Kay Sievers 210239378f16aa1ab5c502e42a06359d2de4f88ebb4Kay Sievers if (dev->driver) 2114a3ad20ccd8f4d2a0535cf98fa83f7b561ba59a9Greg Kroah-Hartman add_uevent_var(env, "PHYSDEVDRIVER=%s", 2124a3ad20ccd8f4d2a0535cf98fa83f7b561ba59a9Greg Kroah-Hartman dev->driver->name); 213d81d9d6b9f7d0af7d4341951d48d296681878f7aKay Sievers } 214239378f16aa1ab5c502e42a06359d2de4f88ebb4Kay Sievers#endif 2151da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds 2167eff2e7a8b65c25920207324e56611150eb1cd9aKay Sievers /* have the bus specific function add its stuff */ 217312c004d36ce6c739512bac83b452f4c20ab1f62Kay Sievers if (dev->bus && dev->bus->uevent) { 2187eff2e7a8b65c25920207324e56611150eb1cd9aKay Sievers retval = dev->bus->uevent(dev, env); 219f9f852df2faf76a2667949ddb4947d4b8f99f02fKay Sievers if (retval) 2207dc72b2842381684b864750af31a5fb168dec764Greg Kroah-Hartman pr_debug("device: '%s': %s: bus uevent() returned %d\n", 2211e0b2cf933ebf32494eba3f668859ba57f06a951Kay Sievers dev_name(dev), __func__, retval); 2221da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds } 2231da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds 2247eff2e7a8b65c25920207324e56611150eb1cd9aKay Sievers /* have the class specific function add its stuff */ 2252620efef7029bb040430f50f0fc148f2d5e002adGreg Kroah-Hartman if (dev->class && dev->class->dev_uevent) { 2267eff2e7a8b65c25920207324e56611150eb1cd9aKay Sievers retval = dev->class->dev_uevent(dev, env); 227f9f852df2faf76a2667949ddb4947d4b8f99f02fKay Sievers if (retval) 2287dc72b2842381684b864750af31a5fb168dec764Greg Kroah-Hartman pr_debug("device: '%s': %s: class uevent() " 2291e0b2cf933ebf32494eba3f668859ba57f06a951Kay Sievers "returned %d\n", dev_name(dev), 2302b3a302a09735276e13421db56c20045a48eb06dHarvey Harrison __func__, retval); 231f9f852df2faf76a2667949ddb4947d4b8f99f02fKay Sievers } 232f9f852df2faf76a2667949ddb4947d4b8f99f02fKay Sievers 2337eff2e7a8b65c25920207324e56611150eb1cd9aKay Sievers /* have the device type specific fuction add its stuff */ 234f9f852df2faf76a2667949ddb4947d4b8f99f02fKay Sievers if (dev->type && dev->type->uevent) { 2357eff2e7a8b65c25920207324e56611150eb1cd9aKay Sievers retval = dev->type->uevent(dev, env); 236f9f852df2faf76a2667949ddb4947d4b8f99f02fKay Sievers if (retval) 2377dc72b2842381684b864750af31a5fb168dec764Greg Kroah-Hartman pr_debug("device: '%s': %s: dev_type uevent() " 2381e0b2cf933ebf32494eba3f668859ba57f06a951Kay Sievers "returned %d\n", dev_name(dev), 2392b3a302a09735276e13421db56c20045a48eb06dHarvey Harrison __func__, retval); 2402620efef7029bb040430f50f0fc148f2d5e002adGreg Kroah-Hartman } 2412620efef7029bb040430f50f0fc148f2d5e002adGreg Kroah-Hartman 2421da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds return retval; 2431da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds} 2441da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds 245312c004d36ce6c739512bac83b452f4c20ab1f62Kay Sieversstatic struct kset_uevent_ops device_uevent_ops = { 246312c004d36ce6c739512bac83b452f4c20ab1f62Kay Sievers .filter = dev_uevent_filter, 247312c004d36ce6c739512bac83b452f4c20ab1f62Kay Sievers .name = dev_uevent_name, 248312c004d36ce6c739512bac83b452f4c20ab1f62Kay Sievers .uevent = dev_uevent, 2491da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds}; 2501da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds 25116574dccd8f62dc1b585325f8a6a0aab10047ed8Kay Sieversstatic ssize_t show_uevent(struct device *dev, struct device_attribute *attr, 25216574dccd8f62dc1b585325f8a6a0aab10047ed8Kay Sievers char *buf) 25316574dccd8f62dc1b585325f8a6a0aab10047ed8Kay Sievers{ 25416574dccd8f62dc1b585325f8a6a0aab10047ed8Kay Sievers struct kobject *top_kobj; 25516574dccd8f62dc1b585325f8a6a0aab10047ed8Kay Sievers struct kset *kset; 2567eff2e7a8b65c25920207324e56611150eb1cd9aKay Sievers struct kobj_uevent_env *env = NULL; 25716574dccd8f62dc1b585325f8a6a0aab10047ed8Kay Sievers int i; 25816574dccd8f62dc1b585325f8a6a0aab10047ed8Kay Sievers size_t count = 0; 25916574dccd8f62dc1b585325f8a6a0aab10047ed8Kay Sievers int retval; 26016574dccd8f62dc1b585325f8a6a0aab10047ed8Kay Sievers 26116574dccd8f62dc1b585325f8a6a0aab10047ed8Kay Sievers /* search the kset, the device belongs to */ 26216574dccd8f62dc1b585325f8a6a0aab10047ed8Kay Sievers top_kobj = &dev->kobj; 2635c5daf657cb5f963a38413f2852279d7a3843144Kay Sievers while (!top_kobj->kset && top_kobj->parent) 2645c5daf657cb5f963a38413f2852279d7a3843144Kay Sievers top_kobj = top_kobj->parent; 26516574dccd8f62dc1b585325f8a6a0aab10047ed8Kay Sievers if (!top_kobj->kset) 26616574dccd8f62dc1b585325f8a6a0aab10047ed8Kay Sievers goto out; 2675c5daf657cb5f963a38413f2852279d7a3843144Kay Sievers 26816574dccd8f62dc1b585325f8a6a0aab10047ed8Kay Sievers kset = top_kobj->kset; 26916574dccd8f62dc1b585325f8a6a0aab10047ed8Kay Sievers if (!kset->uevent_ops || !kset->uevent_ops->uevent) 27016574dccd8f62dc1b585325f8a6a0aab10047ed8Kay Sievers goto out; 27116574dccd8f62dc1b585325f8a6a0aab10047ed8Kay Sievers 27216574dccd8f62dc1b585325f8a6a0aab10047ed8Kay Sievers /* respect filter */ 27316574dccd8f62dc1b585325f8a6a0aab10047ed8Kay Sievers if (kset->uevent_ops && kset->uevent_ops->filter) 27416574dccd8f62dc1b585325f8a6a0aab10047ed8Kay Sievers if (!kset->uevent_ops->filter(kset, &dev->kobj)) 27516574dccd8f62dc1b585325f8a6a0aab10047ed8Kay Sievers goto out; 27616574dccd8f62dc1b585325f8a6a0aab10047ed8Kay Sievers 2777eff2e7a8b65c25920207324e56611150eb1cd9aKay Sievers env = kzalloc(sizeof(struct kobj_uevent_env), GFP_KERNEL); 2787eff2e7a8b65c25920207324e56611150eb1cd9aKay Sievers if (!env) 279c7308c81a8220ab68eebfadde37db881a2800064Greg Kroah-Hartman return -ENOMEM; 280c7308c81a8220ab68eebfadde37db881a2800064Greg Kroah-Hartman 28116574dccd8f62dc1b585325f8a6a0aab10047ed8Kay Sievers /* let the kset specific function add its keys */ 2827eff2e7a8b65c25920207324e56611150eb1cd9aKay Sievers retval = kset->uevent_ops->uevent(kset, &dev->kobj, env); 28316574dccd8f62dc1b585325f8a6a0aab10047ed8Kay Sievers if (retval) 28416574dccd8f62dc1b585325f8a6a0aab10047ed8Kay Sievers goto out; 28516574dccd8f62dc1b585325f8a6a0aab10047ed8Kay Sievers 28616574dccd8f62dc1b585325f8a6a0aab10047ed8Kay Sievers /* copy keys to file */ 2877eff2e7a8b65c25920207324e56611150eb1cd9aKay Sievers for (i = 0; i < env->envp_idx; i++) 2887eff2e7a8b65c25920207324e56611150eb1cd9aKay Sievers count += sprintf(&buf[count], "%s\n", env->envp[i]); 28916574dccd8f62dc1b585325f8a6a0aab10047ed8Kay Sieversout: 2907eff2e7a8b65c25920207324e56611150eb1cd9aKay Sievers kfree(env); 29116574dccd8f62dc1b585325f8a6a0aab10047ed8Kay Sievers return count; 29216574dccd8f62dc1b585325f8a6a0aab10047ed8Kay Sievers} 29316574dccd8f62dc1b585325f8a6a0aab10047ed8Kay Sievers 294a7fd67062efc5b0fc9a61368c607fa92d1d57f9eKay Sieversstatic ssize_t store_uevent(struct device *dev, struct device_attribute *attr, 295a7fd67062efc5b0fc9a61368c607fa92d1d57f9eKay Sievers const char *buf, size_t count) 296a7fd67062efc5b0fc9a61368c607fa92d1d57f9eKay Sievers{ 29760a96a59569bab85571d0089682109bd3324e896Kay Sievers enum kobject_action action; 29860a96a59569bab85571d0089682109bd3324e896Kay Sievers 2995c5daf657cb5f963a38413f2852279d7a3843144Kay Sievers if (kobject_action_type(buf, count, &action) == 0) { 30060a96a59569bab85571d0089682109bd3324e896Kay Sievers kobject_uevent(&dev->kobj, action); 30160a96a59569bab85571d0089682109bd3324e896Kay Sievers goto out; 30260a96a59569bab85571d0089682109bd3324e896Kay Sievers } 30360a96a59569bab85571d0089682109bd3324e896Kay Sievers 30460a96a59569bab85571d0089682109bd3324e896Kay Sievers dev_err(dev, "uevent: unsupported action-string; this will " 30560a96a59569bab85571d0089682109bd3324e896Kay Sievers "be ignored in a future kernel version\n"); 306312c004d36ce6c739512bac83b452f4c20ab1f62Kay Sievers kobject_uevent(&dev->kobj, KOBJ_ADD); 30760a96a59569bab85571d0089682109bd3324e896Kay Sieversout: 308a7fd67062efc5b0fc9a61368c607fa92d1d57f9eKay Sievers return count; 309a7fd67062efc5b0fc9a61368c607fa92d1d57f9eKay Sievers} 310a7fd67062efc5b0fc9a61368c607fa92d1d57f9eKay Sievers 311ad6a1e1c66009ba9dcd2f5c90ffa1fb4ce72fce0Tejun Heostatic struct device_attribute uevent_attr = 312ad6a1e1c66009ba9dcd2f5c90ffa1fb4ce72fce0Tejun Heo __ATTR(uevent, S_IRUGO | S_IWUSR, show_uevent, store_uevent); 313ad6a1e1c66009ba9dcd2f5c90ffa1fb4ce72fce0Tejun Heo 314621a1672f7377e08a942f205d6742d8af1292aabDmitry Torokhovstatic int device_add_attributes(struct device *dev, 315621a1672f7377e08a942f205d6742d8af1292aabDmitry Torokhov struct device_attribute *attrs) 316de0ff00d723fd821d372496e2c084805644aa5e1Greg Kroah-Hartman{ 317621a1672f7377e08a942f205d6742d8af1292aabDmitry Torokhov int error = 0; 318de0ff00d723fd821d372496e2c084805644aa5e1Greg Kroah-Hartman int i; 319621a1672f7377e08a942f205d6742d8af1292aabDmitry Torokhov 320621a1672f7377e08a942f205d6742d8af1292aabDmitry Torokhov if (attrs) { 321621a1672f7377e08a942f205d6742d8af1292aabDmitry Torokhov for (i = 0; attr_name(attrs[i]); i++) { 322621a1672f7377e08a942f205d6742d8af1292aabDmitry Torokhov error = device_create_file(dev, &attrs[i]); 323621a1672f7377e08a942f205d6742d8af1292aabDmitry Torokhov if (error) 324621a1672f7377e08a942f205d6742d8af1292aabDmitry Torokhov break; 325621a1672f7377e08a942f205d6742d8af1292aabDmitry Torokhov } 326621a1672f7377e08a942f205d6742d8af1292aabDmitry Torokhov if (error) 327621a1672f7377e08a942f205d6742d8af1292aabDmitry Torokhov while (--i >= 0) 328621a1672f7377e08a942f205d6742d8af1292aabDmitry Torokhov device_remove_file(dev, &attrs[i]); 329621a1672f7377e08a942f205d6742d8af1292aabDmitry Torokhov } 330621a1672f7377e08a942f205d6742d8af1292aabDmitry Torokhov return error; 331621a1672f7377e08a942f205d6742d8af1292aabDmitry Torokhov} 332621a1672f7377e08a942f205d6742d8af1292aabDmitry Torokhov 333621a1672f7377e08a942f205d6742d8af1292aabDmitry Torokhovstatic void device_remove_attributes(struct device *dev, 334621a1672f7377e08a942f205d6742d8af1292aabDmitry Torokhov struct device_attribute *attrs) 335621a1672f7377e08a942f205d6742d8af1292aabDmitry Torokhov{ 336621a1672f7377e08a942f205d6742d8af1292aabDmitry Torokhov int i; 337621a1672f7377e08a942f205d6742d8af1292aabDmitry Torokhov 338621a1672f7377e08a942f205d6742d8af1292aabDmitry Torokhov if (attrs) 339621a1672f7377e08a942f205d6742d8af1292aabDmitry Torokhov for (i = 0; attr_name(attrs[i]); i++) 340621a1672f7377e08a942f205d6742d8af1292aabDmitry Torokhov device_remove_file(dev, &attrs[i]); 341621a1672f7377e08a942f205d6742d8af1292aabDmitry Torokhov} 342621a1672f7377e08a942f205d6742d8af1292aabDmitry Torokhov 343621a1672f7377e08a942f205d6742d8af1292aabDmitry Torokhovstatic int device_add_groups(struct device *dev, 344a4dbd6740df0872cdf0a86841f75beec8381964dDavid Brownell const struct attribute_group **groups) 345621a1672f7377e08a942f205d6742d8af1292aabDmitry Torokhov{ 346de0ff00d723fd821d372496e2c084805644aa5e1Greg Kroah-Hartman int error = 0; 347621a1672f7377e08a942f205d6742d8af1292aabDmitry Torokhov int i; 348de0ff00d723fd821d372496e2c084805644aa5e1Greg Kroah-Hartman 349621a1672f7377e08a942f205d6742d8af1292aabDmitry Torokhov if (groups) { 350621a1672f7377e08a942f205d6742d8af1292aabDmitry Torokhov for (i = 0; groups[i]; i++) { 351621a1672f7377e08a942f205d6742d8af1292aabDmitry Torokhov error = sysfs_create_group(&dev->kobj, groups[i]); 352de0ff00d723fd821d372496e2c084805644aa5e1Greg Kroah-Hartman if (error) { 353de0ff00d723fd821d372496e2c084805644aa5e1Greg Kroah-Hartman while (--i >= 0) 3544a3ad20ccd8f4d2a0535cf98fa83f7b561ba59a9Greg Kroah-Hartman sysfs_remove_group(&dev->kobj, 3554a3ad20ccd8f4d2a0535cf98fa83f7b561ba59a9Greg Kroah-Hartman groups[i]); 356621a1672f7377e08a942f205d6742d8af1292aabDmitry Torokhov break; 357de0ff00d723fd821d372496e2c084805644aa5e1Greg Kroah-Hartman } 358de0ff00d723fd821d372496e2c084805644aa5e1Greg Kroah-Hartman } 359de0ff00d723fd821d372496e2c084805644aa5e1Greg Kroah-Hartman } 360de0ff00d723fd821d372496e2c084805644aa5e1Greg Kroah-Hartman return error; 361de0ff00d723fd821d372496e2c084805644aa5e1Greg Kroah-Hartman} 362de0ff00d723fd821d372496e2c084805644aa5e1Greg Kroah-Hartman 363621a1672f7377e08a942f205d6742d8af1292aabDmitry Torokhovstatic void device_remove_groups(struct device *dev, 364a4dbd6740df0872cdf0a86841f75beec8381964dDavid Brownell const struct attribute_group **groups) 365de0ff00d723fd821d372496e2c084805644aa5e1Greg Kroah-Hartman{ 366de0ff00d723fd821d372496e2c084805644aa5e1Greg Kroah-Hartman int i; 367621a1672f7377e08a942f205d6742d8af1292aabDmitry Torokhov 368621a1672f7377e08a942f205d6742d8af1292aabDmitry Torokhov if (groups) 369621a1672f7377e08a942f205d6742d8af1292aabDmitry Torokhov for (i = 0; groups[i]; i++) 370621a1672f7377e08a942f205d6742d8af1292aabDmitry Torokhov sysfs_remove_group(&dev->kobj, groups[i]); 371de0ff00d723fd821d372496e2c084805644aa5e1Greg Kroah-Hartman} 372de0ff00d723fd821d372496e2c084805644aa5e1Greg Kroah-Hartman 3732620efef7029bb040430f50f0fc148f2d5e002adGreg Kroah-Hartmanstatic int device_add_attrs(struct device *dev) 3742620efef7029bb040430f50f0fc148f2d5e002adGreg Kroah-Hartman{ 3752620efef7029bb040430f50f0fc148f2d5e002adGreg Kroah-Hartman struct class *class = dev->class; 376f9f852df2faf76a2667949ddb4947d4b8f99f02fKay Sievers struct device_type *type = dev->type; 377621a1672f7377e08a942f205d6742d8af1292aabDmitry Torokhov int error; 3782620efef7029bb040430f50f0fc148f2d5e002adGreg Kroah-Hartman 379621a1672f7377e08a942f205d6742d8af1292aabDmitry Torokhov if (class) { 380621a1672f7377e08a942f205d6742d8af1292aabDmitry Torokhov error = device_add_attributes(dev, class->dev_attrs); 381f9f852df2faf76a2667949ddb4947d4b8f99f02fKay Sievers if (error) 382621a1672f7377e08a942f205d6742d8af1292aabDmitry Torokhov return error; 3832620efef7029bb040430f50f0fc148f2d5e002adGreg Kroah-Hartman } 384f9f852df2faf76a2667949ddb4947d4b8f99f02fKay Sievers 385621a1672f7377e08a942f205d6742d8af1292aabDmitry Torokhov if (type) { 386621a1672f7377e08a942f205d6742d8af1292aabDmitry Torokhov error = device_add_groups(dev, type->groups); 387f9f852df2faf76a2667949ddb4947d4b8f99f02fKay Sievers if (error) 388621a1672f7377e08a942f205d6742d8af1292aabDmitry Torokhov goto err_remove_class_attrs; 389f9f852df2faf76a2667949ddb4947d4b8f99f02fKay Sievers } 390f9f852df2faf76a2667949ddb4947d4b8f99f02fKay Sievers 391621a1672f7377e08a942f205d6742d8af1292aabDmitry Torokhov error = device_add_groups(dev, dev->groups); 392621a1672f7377e08a942f205d6742d8af1292aabDmitry Torokhov if (error) 393621a1672f7377e08a942f205d6742d8af1292aabDmitry Torokhov goto err_remove_type_groups; 394621a1672f7377e08a942f205d6742d8af1292aabDmitry Torokhov 395621a1672f7377e08a942f205d6742d8af1292aabDmitry Torokhov return 0; 396621a1672f7377e08a942f205d6742d8af1292aabDmitry Torokhov 397621a1672f7377e08a942f205d6742d8af1292aabDmitry Torokhov err_remove_type_groups: 398621a1672f7377e08a942f205d6742d8af1292aabDmitry Torokhov if (type) 399621a1672f7377e08a942f205d6742d8af1292aabDmitry Torokhov device_remove_groups(dev, type->groups); 400621a1672f7377e08a942f205d6742d8af1292aabDmitry Torokhov err_remove_class_attrs: 401621a1672f7377e08a942f205d6742d8af1292aabDmitry Torokhov if (class) 402621a1672f7377e08a942f205d6742d8af1292aabDmitry Torokhov device_remove_attributes(dev, class->dev_attrs); 403621a1672f7377e08a942f205d6742d8af1292aabDmitry Torokhov 4042620efef7029bb040430f50f0fc148f2d5e002adGreg Kroah-Hartman return error; 4052620efef7029bb040430f50f0fc148f2d5e002adGreg Kroah-Hartman} 4062620efef7029bb040430f50f0fc148f2d5e002adGreg Kroah-Hartman 4072620efef7029bb040430f50f0fc148f2d5e002adGreg Kroah-Hartmanstatic void device_remove_attrs(struct device *dev) 4082620efef7029bb040430f50f0fc148f2d5e002adGreg Kroah-Hartman{ 4092620efef7029bb040430f50f0fc148f2d5e002adGreg Kroah-Hartman struct class *class = dev->class; 410f9f852df2faf76a2667949ddb4947d4b8f99f02fKay Sievers struct device_type *type = dev->type; 4112620efef7029bb040430f50f0fc148f2d5e002adGreg Kroah-Hartman 412621a1672f7377e08a942f205d6742d8af1292aabDmitry Torokhov device_remove_groups(dev, dev->groups); 413f9f852df2faf76a2667949ddb4947d4b8f99f02fKay Sievers 414621a1672f7377e08a942f205d6742d8af1292aabDmitry Torokhov if (type) 415621a1672f7377e08a942f205d6742d8af1292aabDmitry Torokhov device_remove_groups(dev, type->groups); 416621a1672f7377e08a942f205d6742d8af1292aabDmitry Torokhov 417621a1672f7377e08a942f205d6742d8af1292aabDmitry Torokhov if (class) 418621a1672f7377e08a942f205d6742d8af1292aabDmitry Torokhov device_remove_attributes(dev, class->dev_attrs); 4192620efef7029bb040430f50f0fc148f2d5e002adGreg Kroah-Hartman} 4202620efef7029bb040430f50f0fc148f2d5e002adGreg Kroah-Hartman 4212620efef7029bb040430f50f0fc148f2d5e002adGreg Kroah-Hartman 42223681e479129854305da1da32f7f1eaf635ef22cGreg Kroah-Hartmanstatic ssize_t show_dev(struct device *dev, struct device_attribute *attr, 42323681e479129854305da1da32f7f1eaf635ef22cGreg Kroah-Hartman char *buf) 42423681e479129854305da1da32f7f1eaf635ef22cGreg Kroah-Hartman{ 42523681e479129854305da1da32f7f1eaf635ef22cGreg Kroah-Hartman return print_dev_t(buf, dev->devt); 42623681e479129854305da1da32f7f1eaf635ef22cGreg Kroah-Hartman} 42723681e479129854305da1da32f7f1eaf635ef22cGreg Kroah-Hartman 428ad6a1e1c66009ba9dcd2f5c90ffa1fb4ce72fce0Tejun Heostatic struct device_attribute devt_attr = 429ad6a1e1c66009ba9dcd2f5c90ffa1fb4ce72fce0Tejun Heo __ATTR(dev, S_IRUGO, show_dev, NULL); 430ad6a1e1c66009ba9dcd2f5c90ffa1fb4ce72fce0Tejun Heo 431881c6cfd7c5edfe6129006e2404654bfe5911050Greg Kroah-Hartman/* kset to create /sys/devices/ */ 432881c6cfd7c5edfe6129006e2404654bfe5911050Greg Kroah-Hartmanstruct kset *devices_kset; 4331da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds 4341da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds/** 4354a3ad20ccd8f4d2a0535cf98fa83f7b561ba59a9Greg Kroah-Hartman * device_create_file - create sysfs attribute file for device. 4364a3ad20ccd8f4d2a0535cf98fa83f7b561ba59a9Greg Kroah-Hartman * @dev: device. 4374a3ad20ccd8f4d2a0535cf98fa83f7b561ba59a9Greg Kroah-Hartman * @attr: device attribute descriptor. 4381da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds */ 4394a3ad20ccd8f4d2a0535cf98fa83f7b561ba59a9Greg Kroah-Hartmanint device_create_file(struct device *dev, struct device_attribute *attr) 4401da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds{ 4411da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds int error = 0; 4420c98b19fe571ede1f14bd95b855bcbe2cca99bcfCornelia Huck if (dev) 4431da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds error = sysfs_create_file(&dev->kobj, &attr->attr); 4441da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds return error; 4451da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds} 4461da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds 4471da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds/** 4484a3ad20ccd8f4d2a0535cf98fa83f7b561ba59a9Greg Kroah-Hartman * device_remove_file - remove sysfs attribute file. 4494a3ad20ccd8f4d2a0535cf98fa83f7b561ba59a9Greg Kroah-Hartman * @dev: device. 4504a3ad20ccd8f4d2a0535cf98fa83f7b561ba59a9Greg Kroah-Hartman * @attr: device attribute descriptor. 4511da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds */ 4524a3ad20ccd8f4d2a0535cf98fa83f7b561ba59a9Greg Kroah-Hartmanvoid device_remove_file(struct device *dev, struct device_attribute *attr) 4531da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds{ 4540c98b19fe571ede1f14bd95b855bcbe2cca99bcfCornelia Huck if (dev) 4551da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds sysfs_remove_file(&dev->kobj, &attr->attr); 4561da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds} 4571da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds 4582589f1887b0bf9f08ec3d7f3c5705ccb7c628076Greg Kroah-Hartman/** 4592589f1887b0bf9f08ec3d7f3c5705ccb7c628076Greg Kroah-Hartman * device_create_bin_file - create sysfs binary attribute file for device. 4602589f1887b0bf9f08ec3d7f3c5705ccb7c628076Greg Kroah-Hartman * @dev: device. 4612589f1887b0bf9f08ec3d7f3c5705ccb7c628076Greg Kroah-Hartman * @attr: device binary attribute descriptor. 4622589f1887b0bf9f08ec3d7f3c5705ccb7c628076Greg Kroah-Hartman */ 4632589f1887b0bf9f08ec3d7f3c5705ccb7c628076Greg Kroah-Hartmanint device_create_bin_file(struct device *dev, struct bin_attribute *attr) 4642589f1887b0bf9f08ec3d7f3c5705ccb7c628076Greg Kroah-Hartman{ 4652589f1887b0bf9f08ec3d7f3c5705ccb7c628076Greg Kroah-Hartman int error = -EINVAL; 4662589f1887b0bf9f08ec3d7f3c5705ccb7c628076Greg Kroah-Hartman if (dev) 4672589f1887b0bf9f08ec3d7f3c5705ccb7c628076Greg Kroah-Hartman error = sysfs_create_bin_file(&dev->kobj, attr); 4682589f1887b0bf9f08ec3d7f3c5705ccb7c628076Greg Kroah-Hartman return error; 4692589f1887b0bf9f08ec3d7f3c5705ccb7c628076Greg Kroah-Hartman} 4702589f1887b0bf9f08ec3d7f3c5705ccb7c628076Greg Kroah-HartmanEXPORT_SYMBOL_GPL(device_create_bin_file); 4712589f1887b0bf9f08ec3d7f3c5705ccb7c628076Greg Kroah-Hartman 4722589f1887b0bf9f08ec3d7f3c5705ccb7c628076Greg Kroah-Hartman/** 4732589f1887b0bf9f08ec3d7f3c5705ccb7c628076Greg Kroah-Hartman * device_remove_bin_file - remove sysfs binary attribute file 4742589f1887b0bf9f08ec3d7f3c5705ccb7c628076Greg Kroah-Hartman * @dev: device. 4752589f1887b0bf9f08ec3d7f3c5705ccb7c628076Greg Kroah-Hartman * @attr: device binary attribute descriptor. 4762589f1887b0bf9f08ec3d7f3c5705ccb7c628076Greg Kroah-Hartman */ 4772589f1887b0bf9f08ec3d7f3c5705ccb7c628076Greg Kroah-Hartmanvoid device_remove_bin_file(struct device *dev, struct bin_attribute *attr) 4782589f1887b0bf9f08ec3d7f3c5705ccb7c628076Greg Kroah-Hartman{ 4792589f1887b0bf9f08ec3d7f3c5705ccb7c628076Greg Kroah-Hartman if (dev) 4802589f1887b0bf9f08ec3d7f3c5705ccb7c628076Greg Kroah-Hartman sysfs_remove_bin_file(&dev->kobj, attr); 4812589f1887b0bf9f08ec3d7f3c5705ccb7c628076Greg Kroah-Hartman} 4822589f1887b0bf9f08ec3d7f3c5705ccb7c628076Greg Kroah-HartmanEXPORT_SYMBOL_GPL(device_remove_bin_file); 4832589f1887b0bf9f08ec3d7f3c5705ccb7c628076Greg Kroah-Hartman 484d9a9cdfb078d755e648d53ec25b7370f84ee5729Alan Stern/** 485523ded71de0c5e66973335bf99a80edfda9f401bAlan Stern * device_schedule_callback_owner - helper to schedule a callback for a device 486d9a9cdfb078d755e648d53ec25b7370f84ee5729Alan Stern * @dev: device. 487d9a9cdfb078d755e648d53ec25b7370f84ee5729Alan Stern * @func: callback function to invoke later. 488523ded71de0c5e66973335bf99a80edfda9f401bAlan Stern * @owner: module owning the callback routine 489d9a9cdfb078d755e648d53ec25b7370f84ee5729Alan Stern * 490d9a9cdfb078d755e648d53ec25b7370f84ee5729Alan Stern * Attribute methods must not unregister themselves or their parent device 491d9a9cdfb078d755e648d53ec25b7370f84ee5729Alan Stern * (which would amount to the same thing). Attempts to do so will deadlock, 492d9a9cdfb078d755e648d53ec25b7370f84ee5729Alan Stern * since unregistration is mutually exclusive with driver callbacks. 493d9a9cdfb078d755e648d53ec25b7370f84ee5729Alan Stern * 494d9a9cdfb078d755e648d53ec25b7370f84ee5729Alan Stern * Instead methods can call this routine, which will attempt to allocate 495d9a9cdfb078d755e648d53ec25b7370f84ee5729Alan Stern * and schedule a workqueue request to call back @func with @dev as its 496d9a9cdfb078d755e648d53ec25b7370f84ee5729Alan Stern * argument in the workqueue's process context. @dev will be pinned until 497d9a9cdfb078d755e648d53ec25b7370f84ee5729Alan Stern * @func returns. 498d9a9cdfb078d755e648d53ec25b7370f84ee5729Alan Stern * 499523ded71de0c5e66973335bf99a80edfda9f401bAlan Stern * This routine is usually called via the inline device_schedule_callback(), 500523ded71de0c5e66973335bf99a80edfda9f401bAlan Stern * which automatically sets @owner to THIS_MODULE. 501523ded71de0c5e66973335bf99a80edfda9f401bAlan Stern * 502d9a9cdfb078d755e648d53ec25b7370f84ee5729Alan Stern * Returns 0 if the request was submitted, -ENOMEM if storage could not 503523ded71de0c5e66973335bf99a80edfda9f401bAlan Stern * be allocated, -ENODEV if a reference to @owner isn't available. 504d9a9cdfb078d755e648d53ec25b7370f84ee5729Alan Stern * 505d9a9cdfb078d755e648d53ec25b7370f84ee5729Alan Stern * NOTE: This routine won't work if CONFIG_SYSFS isn't set! It uses an 506d9a9cdfb078d755e648d53ec25b7370f84ee5729Alan Stern * underlying sysfs routine (since it is intended for use by attribute 507d9a9cdfb078d755e648d53ec25b7370f84ee5729Alan Stern * methods), and if sysfs isn't available you'll get nothing but -ENOSYS. 508d9a9cdfb078d755e648d53ec25b7370f84ee5729Alan Stern */ 509523ded71de0c5e66973335bf99a80edfda9f401bAlan Sternint device_schedule_callback_owner(struct device *dev, 510523ded71de0c5e66973335bf99a80edfda9f401bAlan Stern void (*func)(struct device *), struct module *owner) 511d9a9cdfb078d755e648d53ec25b7370f84ee5729Alan Stern{ 512d9a9cdfb078d755e648d53ec25b7370f84ee5729Alan Stern return sysfs_schedule_callback(&dev->kobj, 513523ded71de0c5e66973335bf99a80edfda9f401bAlan Stern (void (*)(void *)) func, dev, owner); 514d9a9cdfb078d755e648d53ec25b7370f84ee5729Alan Stern} 515523ded71de0c5e66973335bf99a80edfda9f401bAlan SternEXPORT_SYMBOL_GPL(device_schedule_callback_owner); 516d9a9cdfb078d755e648d53ec25b7370f84ee5729Alan Stern 51734bb61f9ddabd7a7f909cbfb05592eb775f6662aJames Bottomleystatic void klist_children_get(struct klist_node *n) 51834bb61f9ddabd7a7f909cbfb05592eb775f6662aJames Bottomley{ 519f791b8c836307b58cbf62133a6a772ed1a92fb33Greg Kroah-Hartman struct device_private *p = to_device_private_parent(n); 520f791b8c836307b58cbf62133a6a772ed1a92fb33Greg Kroah-Hartman struct device *dev = p->device; 52134bb61f9ddabd7a7f909cbfb05592eb775f6662aJames Bottomley 52234bb61f9ddabd7a7f909cbfb05592eb775f6662aJames Bottomley get_device(dev); 52334bb61f9ddabd7a7f909cbfb05592eb775f6662aJames Bottomley} 52434bb61f9ddabd7a7f909cbfb05592eb775f6662aJames Bottomley 52534bb61f9ddabd7a7f909cbfb05592eb775f6662aJames Bottomleystatic void klist_children_put(struct klist_node *n) 52634bb61f9ddabd7a7f909cbfb05592eb775f6662aJames Bottomley{ 527f791b8c836307b58cbf62133a6a772ed1a92fb33Greg Kroah-Hartman struct device_private *p = to_device_private_parent(n); 528f791b8c836307b58cbf62133a6a772ed1a92fb33Greg Kroah-Hartman struct device *dev = p->device; 52934bb61f9ddabd7a7f909cbfb05592eb775f6662aJames Bottomley 53034bb61f9ddabd7a7f909cbfb05592eb775f6662aJames Bottomley put_device(dev); 53134bb61f9ddabd7a7f909cbfb05592eb775f6662aJames Bottomley} 53234bb61f9ddabd7a7f909cbfb05592eb775f6662aJames Bottomley 5331da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds/** 5344a3ad20ccd8f4d2a0535cf98fa83f7b561ba59a9Greg Kroah-Hartman * device_initialize - init device structure. 5354a3ad20ccd8f4d2a0535cf98fa83f7b561ba59a9Greg Kroah-Hartman * @dev: device. 5361da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds * 5375739411acbaa63a6c22c91e340fdcdbcc7d82a51Cornelia Huck * This prepares the device for use by other layers by initializing 5385739411acbaa63a6c22c91e340fdcdbcc7d82a51Cornelia Huck * its fields. 5394a3ad20ccd8f4d2a0535cf98fa83f7b561ba59a9Greg Kroah-Hartman * It is the first half of device_register(), if called by 5405739411acbaa63a6c22c91e340fdcdbcc7d82a51Cornelia Huck * that function, though it can also be called separately, so one 5415739411acbaa63a6c22c91e340fdcdbcc7d82a51Cornelia Huck * may use @dev's fields. In particular, get_device()/put_device() 5425739411acbaa63a6c22c91e340fdcdbcc7d82a51Cornelia Huck * may be used for reference counting of @dev after calling this 5435739411acbaa63a6c22c91e340fdcdbcc7d82a51Cornelia Huck * function. 5445739411acbaa63a6c22c91e340fdcdbcc7d82a51Cornelia Huck * 5455739411acbaa63a6c22c91e340fdcdbcc7d82a51Cornelia Huck * NOTE: Use put_device() to give up your reference instead of freeing 5465739411acbaa63a6c22c91e340fdcdbcc7d82a51Cornelia Huck * @dev directly once you have called this function. 5471da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds */ 5481da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvaldsvoid device_initialize(struct device *dev) 5491da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds{ 550881c6cfd7c5edfe6129006e2404654bfe5911050Greg Kroah-Hartman dev->kobj.kset = devices_kset; 551f9cb074bff8e762ef24c44678a5a7d907f82fbebGreg Kroah-Hartman kobject_init(&dev->kobj, &device_ktype); 5521da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds INIT_LIST_HEAD(&dev->dma_pools); 553af70316af182f4716cc5eec7e0d27fc731d164bdPatrick Mochel init_MUTEX(&dev->sem); 5549ac7849e35f705830f7b016ff272b0ff1f7ff759Tejun Heo spin_lock_init(&dev->devres_lock); 5559ac7849e35f705830f7b016ff272b0ff1f7ff759Tejun Heo INIT_LIST_HEAD(&dev->devres_head); 5560ac85241ebc7bf6b86ab498960cc121d53ef69aeDavid Brownell device_init_wakeup(dev, 0); 5573b98aeaf3a75f544dc945694f4fcf6e1c4bab89dAlan Stern device_pm_init(dev); 558873481367edb18a7d0d7e5a285e6728c16bb44a9Christoph Hellwig set_dev_node(dev, -1); 5591da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds} 5601da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds 56140fa54226f518a9bc97ed1d711c0016e416e3782Greg Kroah-Hartman#ifdef CONFIG_SYSFS_DEPRECATED 562da231fd5d113ab6da5dab7a2d2c38d0a540f939cKay Sieversstatic struct kobject *get_device_parent(struct device *dev, 563da231fd5d113ab6da5dab7a2d2c38d0a540f939cKay Sievers struct device *parent) 56440fa54226f518a9bc97ed1d711c0016e416e3782Greg Kroah-Hartman{ 565da231fd5d113ab6da5dab7a2d2c38d0a540f939cKay Sievers /* class devices without a parent live in /sys/class/<classname>/ */ 5663eb215de26e6e94bf5fed9cb77230c383b30e53bDmitry Torokhov if (dev->class && (!parent || parent->class != dev->class)) 5671fbfee6c6dc0f4a4c587b6b163ee79643fc9aaa7Greg Kroah-Hartman return &dev->class->p->class_subsys.kobj; 568da231fd5d113ab6da5dab7a2d2c38d0a540f939cKay Sievers /* all other devices keep their parent */ 56940fa54226f518a9bc97ed1d711c0016e416e3782Greg Kroah-Hartman else if (parent) 570c744aeae9d173a953b771a7ad5c872f91fa99decCornelia Huck return &parent->kobj; 57140fa54226f518a9bc97ed1d711c0016e416e3782Greg Kroah-Hartman 572c744aeae9d173a953b771a7ad5c872f91fa99decCornelia Huck return NULL; 57340fa54226f518a9bc97ed1d711c0016e416e3782Greg Kroah-Hartman} 574da231fd5d113ab6da5dab7a2d2c38d0a540f939cKay Sievers 575da231fd5d113ab6da5dab7a2d2c38d0a540f939cKay Sieversstatic inline void cleanup_device_parent(struct device *dev) {} 57663b6971a0876b744e2fcf3c9df15d130501e1debCornelia Huckstatic inline void cleanup_glue_dir(struct device *dev, 57763b6971a0876b744e2fcf3c9df15d130501e1debCornelia Huck struct kobject *glue_dir) {} 57840fa54226f518a9bc97ed1d711c0016e416e3782Greg Kroah-Hartman#else 579864062457a2e444227bd368ca5f2a2b740de604fKay Sieversstatic struct kobject *virtual_device_parent(struct device *dev) 580f0ee61a6cecd100301a60d99feb187776533b2a2Greg Kroah-Hartman{ 581864062457a2e444227bd368ca5f2a2b740de604fKay Sievers static struct kobject *virtual_dir = NULL; 582f0ee61a6cecd100301a60d99feb187776533b2a2Greg Kroah-Hartman 583864062457a2e444227bd368ca5f2a2b740de604fKay Sievers if (!virtual_dir) 5844ff6abff832fbc6cb1d769f6106c841bc2b09f63Greg Kroah-Hartman virtual_dir = kobject_create_and_add("virtual", 585881c6cfd7c5edfe6129006e2404654bfe5911050Greg Kroah-Hartman &devices_kset->kobj); 586f0ee61a6cecd100301a60d99feb187776533b2a2Greg Kroah-Hartman 587864062457a2e444227bd368ca5f2a2b740de604fKay Sievers return virtual_dir; 588f0ee61a6cecd100301a60d99feb187776533b2a2Greg Kroah-Hartman} 589f0ee61a6cecd100301a60d99feb187776533b2a2Greg Kroah-Hartman 590da231fd5d113ab6da5dab7a2d2c38d0a540f939cKay Sieversstatic struct kobject *get_device_parent(struct device *dev, 591da231fd5d113ab6da5dab7a2d2c38d0a540f939cKay Sievers struct device *parent) 59240fa54226f518a9bc97ed1d711c0016e416e3782Greg Kroah-Hartman{ 59343968d2f1648f4dc92437dc0363a3e88377445b3Greg Kroah-Hartman int retval; 59443968d2f1648f4dc92437dc0363a3e88377445b3Greg Kroah-Hartman 595864062457a2e444227bd368ca5f2a2b740de604fKay Sievers if (dev->class) { 596864062457a2e444227bd368ca5f2a2b740de604fKay Sievers struct kobject *kobj = NULL; 597864062457a2e444227bd368ca5f2a2b740de604fKay Sievers struct kobject *parent_kobj; 598864062457a2e444227bd368ca5f2a2b740de604fKay Sievers struct kobject *k; 599864062457a2e444227bd368ca5f2a2b740de604fKay Sievers 600864062457a2e444227bd368ca5f2a2b740de604fKay Sievers /* 601864062457a2e444227bd368ca5f2a2b740de604fKay Sievers * If we have no parent, we live in "virtual". 6020f4dafc0563c6c49e17fe14b3f5f356e4c4b8806Kay Sievers * Class-devices with a non class-device as parent, live 6030f4dafc0563c6c49e17fe14b3f5f356e4c4b8806Kay Sievers * in a "glue" directory to prevent namespace collisions. 604864062457a2e444227bd368ca5f2a2b740de604fKay Sievers */ 605864062457a2e444227bd368ca5f2a2b740de604fKay Sievers if (parent == NULL) 606864062457a2e444227bd368ca5f2a2b740de604fKay Sievers parent_kobj = virtual_device_parent(dev); 607864062457a2e444227bd368ca5f2a2b740de604fKay Sievers else if (parent->class) 608864062457a2e444227bd368ca5f2a2b740de604fKay Sievers return &parent->kobj; 609864062457a2e444227bd368ca5f2a2b740de604fKay Sievers else 610864062457a2e444227bd368ca5f2a2b740de604fKay Sievers parent_kobj = &parent->kobj; 611864062457a2e444227bd368ca5f2a2b740de604fKay Sievers 612864062457a2e444227bd368ca5f2a2b740de604fKay Sievers /* find our class-directory at the parent and reference it */ 6137c71448b8aa80123fc521563d5f7c63a099d97abGreg Kroah-Hartman spin_lock(&dev->class->p->class_dirs.list_lock); 6147c71448b8aa80123fc521563d5f7c63a099d97abGreg Kroah-Hartman list_for_each_entry(k, &dev->class->p->class_dirs.list, entry) 615864062457a2e444227bd368ca5f2a2b740de604fKay Sievers if (k->parent == parent_kobj) { 616864062457a2e444227bd368ca5f2a2b740de604fKay Sievers kobj = kobject_get(k); 617864062457a2e444227bd368ca5f2a2b740de604fKay Sievers break; 618864062457a2e444227bd368ca5f2a2b740de604fKay Sievers } 6197c71448b8aa80123fc521563d5f7c63a099d97abGreg Kroah-Hartman spin_unlock(&dev->class->p->class_dirs.list_lock); 620864062457a2e444227bd368ca5f2a2b740de604fKay Sievers if (kobj) 621864062457a2e444227bd368ca5f2a2b740de604fKay Sievers return kobj; 622864062457a2e444227bd368ca5f2a2b740de604fKay Sievers 623864062457a2e444227bd368ca5f2a2b740de604fKay Sievers /* or create a new class-directory at the parent device */ 62443968d2f1648f4dc92437dc0363a3e88377445b3Greg Kroah-Hartman k = kobject_create(); 62543968d2f1648f4dc92437dc0363a3e88377445b3Greg Kroah-Hartman if (!k) 62643968d2f1648f4dc92437dc0363a3e88377445b3Greg Kroah-Hartman return NULL; 6277c71448b8aa80123fc521563d5f7c63a099d97abGreg Kroah-Hartman k->kset = &dev->class->p->class_dirs; 628b2d6db5878a0832659ed58476357eea2db915550Greg Kroah-Hartman retval = kobject_add(k, parent_kobj, "%s", dev->class->name); 62943968d2f1648f4dc92437dc0363a3e88377445b3Greg Kroah-Hartman if (retval < 0) { 63043968d2f1648f4dc92437dc0363a3e88377445b3Greg Kroah-Hartman kobject_put(k); 63143968d2f1648f4dc92437dc0363a3e88377445b3Greg Kroah-Hartman return NULL; 63243968d2f1648f4dc92437dc0363a3e88377445b3Greg Kroah-Hartman } 6330f4dafc0563c6c49e17fe14b3f5f356e4c4b8806Kay Sievers /* do not emit an uevent for this simple "glue" directory */ 63443968d2f1648f4dc92437dc0363a3e88377445b3Greg Kroah-Hartman return k; 635864062457a2e444227bd368ca5f2a2b740de604fKay Sievers } 636864062457a2e444227bd368ca5f2a2b740de604fKay Sievers 637864062457a2e444227bd368ca5f2a2b740de604fKay Sievers if (parent) 638c744aeae9d173a953b771a7ad5c872f91fa99decCornelia Huck return &parent->kobj; 639c744aeae9d173a953b771a7ad5c872f91fa99decCornelia Huck return NULL; 640c744aeae9d173a953b771a7ad5c872f91fa99decCornelia Huck} 641da231fd5d113ab6da5dab7a2d2c38d0a540f939cKay Sievers 64263b6971a0876b744e2fcf3c9df15d130501e1debCornelia Huckstatic void cleanup_glue_dir(struct device *dev, struct kobject *glue_dir) 643da231fd5d113ab6da5dab7a2d2c38d0a540f939cKay Sievers{ 6440f4dafc0563c6c49e17fe14b3f5f356e4c4b8806Kay Sievers /* see if we live in a "glue" directory */ 645c1fe539a7e031302af1d121163e7ce68e679ba8cCornelia Huck if (!glue_dir || !dev->class || 6467c71448b8aa80123fc521563d5f7c63a099d97abGreg Kroah-Hartman glue_dir->kset != &dev->class->p->class_dirs) 647da231fd5d113ab6da5dab7a2d2c38d0a540f939cKay Sievers return; 648da231fd5d113ab6da5dab7a2d2c38d0a540f939cKay Sievers 6490f4dafc0563c6c49e17fe14b3f5f356e4c4b8806Kay Sievers kobject_put(glue_dir); 650da231fd5d113ab6da5dab7a2d2c38d0a540f939cKay Sievers} 65163b6971a0876b744e2fcf3c9df15d130501e1debCornelia Huck 65263b6971a0876b744e2fcf3c9df15d130501e1debCornelia Huckstatic void cleanup_device_parent(struct device *dev) 65363b6971a0876b744e2fcf3c9df15d130501e1debCornelia Huck{ 65463b6971a0876b744e2fcf3c9df15d130501e1debCornelia Huck cleanup_glue_dir(dev, dev->kobj.parent); 65563b6971a0876b744e2fcf3c9df15d130501e1debCornelia Huck} 656c744aeae9d173a953b771a7ad5c872f91fa99decCornelia Huck#endif 657864062457a2e444227bd368ca5f2a2b740de604fKay Sievers 65863b6971a0876b744e2fcf3c9df15d130501e1debCornelia Huckstatic void setup_parent(struct device *dev, struct device *parent) 659c744aeae9d173a953b771a7ad5c872f91fa99decCornelia Huck{ 660c744aeae9d173a953b771a7ad5c872f91fa99decCornelia Huck struct kobject *kobj; 661c744aeae9d173a953b771a7ad5c872f91fa99decCornelia Huck kobj = get_device_parent(dev, parent); 662c744aeae9d173a953b771a7ad5c872f91fa99decCornelia Huck if (kobj) 663c744aeae9d173a953b771a7ad5c872f91fa99decCornelia Huck dev->kobj.parent = kobj; 66440fa54226f518a9bc97ed1d711c0016e416e3782Greg Kroah-Hartman} 66540fa54226f518a9bc97ed1d711c0016e416e3782Greg Kroah-Hartman 6662ee97caf0a6602f749ddbfdb1449e383e1212707Cornelia Huckstatic int device_add_class_symlinks(struct device *dev) 6672ee97caf0a6602f749ddbfdb1449e383e1212707Cornelia Huck{ 6682ee97caf0a6602f749ddbfdb1449e383e1212707Cornelia Huck int error; 6692ee97caf0a6602f749ddbfdb1449e383e1212707Cornelia Huck 6702ee97caf0a6602f749ddbfdb1449e383e1212707Cornelia Huck if (!dev->class) 6712ee97caf0a6602f749ddbfdb1449e383e1212707Cornelia Huck return 0; 672da231fd5d113ab6da5dab7a2d2c38d0a540f939cKay Sievers 6731fbfee6c6dc0f4a4c587b6b163ee79643fc9aaa7Greg Kroah-Hartman error = sysfs_create_link(&dev->kobj, 6741fbfee6c6dc0f4a4c587b6b163ee79643fc9aaa7Greg Kroah-Hartman &dev->class->p->class_subsys.kobj, 6752ee97caf0a6602f749ddbfdb1449e383e1212707Cornelia Huck "subsystem"); 6762ee97caf0a6602f749ddbfdb1449e383e1212707Cornelia Huck if (error) 6772ee97caf0a6602f749ddbfdb1449e383e1212707Cornelia Huck goto out; 678da231fd5d113ab6da5dab7a2d2c38d0a540f939cKay Sievers 679da231fd5d113ab6da5dab7a2d2c38d0a540f939cKay Sievers#ifdef CONFIG_SYSFS_DEPRECATED 680da231fd5d113ab6da5dab7a2d2c38d0a540f939cKay Sievers /* stacked class devices need a symlink in the class directory */ 6811fbfee6c6dc0f4a4c587b6b163ee79643fc9aaa7Greg Kroah-Hartman if (dev->kobj.parent != &dev->class->p->class_subsys.kobj && 6824e886c29610f4374d8971ec7a248f011cc3bd73aGreg Kroah-Hartman device_is_not_partition(dev)) { 6831fbfee6c6dc0f4a4c587b6b163ee79643fc9aaa7Greg Kroah-Hartman error = sysfs_create_link(&dev->class->p->class_subsys.kobj, 6841e0b2cf933ebf32494eba3f668859ba57f06a951Kay Sievers &dev->kobj, dev_name(dev)); 6852ee97caf0a6602f749ddbfdb1449e383e1212707Cornelia Huck if (error) 6862ee97caf0a6602f749ddbfdb1449e383e1212707Cornelia Huck goto out_subsys; 6872ee97caf0a6602f749ddbfdb1449e383e1212707Cornelia Huck } 688da231fd5d113ab6da5dab7a2d2c38d0a540f939cKay Sievers 6894e886c29610f4374d8971ec7a248f011cc3bd73aGreg Kroah-Hartman if (dev->parent && device_is_not_partition(dev)) { 690da231fd5d113ab6da5dab7a2d2c38d0a540f939cKay Sievers struct device *parent = dev->parent; 691da231fd5d113ab6da5dab7a2d2c38d0a540f939cKay Sievers char *class_name; 6924f01a757e75f2a3cab2bab89c4176498963946b9Dmitry Torokhov 693da231fd5d113ab6da5dab7a2d2c38d0a540f939cKay Sievers /* 694da231fd5d113ab6da5dab7a2d2c38d0a540f939cKay Sievers * stacked class devices have the 'device' link 695da231fd5d113ab6da5dab7a2d2c38d0a540f939cKay Sievers * pointing to the bus device instead of the parent 696da231fd5d113ab6da5dab7a2d2c38d0a540f939cKay Sievers */ 697da231fd5d113ab6da5dab7a2d2c38d0a540f939cKay Sievers while (parent->class && !parent->bus && parent->parent) 698da231fd5d113ab6da5dab7a2d2c38d0a540f939cKay Sievers parent = parent->parent; 699da231fd5d113ab6da5dab7a2d2c38d0a540f939cKay Sievers 700da231fd5d113ab6da5dab7a2d2c38d0a540f939cKay Sievers error = sysfs_create_link(&dev->kobj, 701da231fd5d113ab6da5dab7a2d2c38d0a540f939cKay Sievers &parent->kobj, 7024f01a757e75f2a3cab2bab89c4176498963946b9Dmitry Torokhov "device"); 7034f01a757e75f2a3cab2bab89c4176498963946b9Dmitry Torokhov if (error) 7044f01a757e75f2a3cab2bab89c4176498963946b9Dmitry Torokhov goto out_busid; 705da231fd5d113ab6da5dab7a2d2c38d0a540f939cKay Sievers 706da231fd5d113ab6da5dab7a2d2c38d0a540f939cKay Sievers class_name = make_class_name(dev->class->name, 707da231fd5d113ab6da5dab7a2d2c38d0a540f939cKay Sievers &dev->kobj); 708da231fd5d113ab6da5dab7a2d2c38d0a540f939cKay Sievers if (class_name) 709da231fd5d113ab6da5dab7a2d2c38d0a540f939cKay Sievers error = sysfs_create_link(&dev->parent->kobj, 710da231fd5d113ab6da5dab7a2d2c38d0a540f939cKay Sievers &dev->kobj, class_name); 711da231fd5d113ab6da5dab7a2d2c38d0a540f939cKay Sievers kfree(class_name); 712da231fd5d113ab6da5dab7a2d2c38d0a540f939cKay Sievers if (error) 713da231fd5d113ab6da5dab7a2d2c38d0a540f939cKay Sievers goto out_device; 7142ee97caf0a6602f749ddbfdb1449e383e1212707Cornelia Huck } 7152ee97caf0a6602f749ddbfdb1449e383e1212707Cornelia Huck return 0; 7162ee97caf0a6602f749ddbfdb1449e383e1212707Cornelia Huck 7172ee97caf0a6602f749ddbfdb1449e383e1212707Cornelia Huckout_device: 7184e886c29610f4374d8971ec7a248f011cc3bd73aGreg Kroah-Hartman if (dev->parent && device_is_not_partition(dev)) 7192ee97caf0a6602f749ddbfdb1449e383e1212707Cornelia Huck sysfs_remove_link(&dev->kobj, "device"); 7202ee97caf0a6602f749ddbfdb1449e383e1212707Cornelia Huckout_busid: 7211fbfee6c6dc0f4a4c587b6b163ee79643fc9aaa7Greg Kroah-Hartman if (dev->kobj.parent != &dev->class->p->class_subsys.kobj && 7224e886c29610f4374d8971ec7a248f011cc3bd73aGreg Kroah-Hartman device_is_not_partition(dev)) 7231fbfee6c6dc0f4a4c587b6b163ee79643fc9aaa7Greg Kroah-Hartman sysfs_remove_link(&dev->class->p->class_subsys.kobj, 7241e0b2cf933ebf32494eba3f668859ba57f06a951Kay Sievers dev_name(dev)); 725da231fd5d113ab6da5dab7a2d2c38d0a540f939cKay Sievers#else 726da231fd5d113ab6da5dab7a2d2c38d0a540f939cKay Sievers /* link in the class directory pointing to the device */ 7271fbfee6c6dc0f4a4c587b6b163ee79643fc9aaa7Greg Kroah-Hartman error = sysfs_create_link(&dev->class->p->class_subsys.kobj, 7281e0b2cf933ebf32494eba3f668859ba57f06a951Kay Sievers &dev->kobj, dev_name(dev)); 729da231fd5d113ab6da5dab7a2d2c38d0a540f939cKay Sievers if (error) 730da231fd5d113ab6da5dab7a2d2c38d0a540f939cKay Sievers goto out_subsys; 731da231fd5d113ab6da5dab7a2d2c38d0a540f939cKay Sievers 7324e886c29610f4374d8971ec7a248f011cc3bd73aGreg Kroah-Hartman if (dev->parent && device_is_not_partition(dev)) { 733da231fd5d113ab6da5dab7a2d2c38d0a540f939cKay Sievers error = sysfs_create_link(&dev->kobj, &dev->parent->kobj, 734da231fd5d113ab6da5dab7a2d2c38d0a540f939cKay Sievers "device"); 735da231fd5d113ab6da5dab7a2d2c38d0a540f939cKay Sievers if (error) 736da231fd5d113ab6da5dab7a2d2c38d0a540f939cKay Sievers goto out_busid; 737da231fd5d113ab6da5dab7a2d2c38d0a540f939cKay Sievers } 738da231fd5d113ab6da5dab7a2d2c38d0a540f939cKay Sievers return 0; 739da231fd5d113ab6da5dab7a2d2c38d0a540f939cKay Sievers 740da231fd5d113ab6da5dab7a2d2c38d0a540f939cKay Sieversout_busid: 7411e0b2cf933ebf32494eba3f668859ba57f06a951Kay Sievers sysfs_remove_link(&dev->class->p->class_subsys.kobj, dev_name(dev)); 742da231fd5d113ab6da5dab7a2d2c38d0a540f939cKay Sievers#endif 743da231fd5d113ab6da5dab7a2d2c38d0a540f939cKay Sievers 7442ee97caf0a6602f749ddbfdb1449e383e1212707Cornelia Huckout_subsys: 7452ee97caf0a6602f749ddbfdb1449e383e1212707Cornelia Huck sysfs_remove_link(&dev->kobj, "subsystem"); 7462ee97caf0a6602f749ddbfdb1449e383e1212707Cornelia Huckout: 7472ee97caf0a6602f749ddbfdb1449e383e1212707Cornelia Huck return error; 7482ee97caf0a6602f749ddbfdb1449e383e1212707Cornelia Huck} 7492ee97caf0a6602f749ddbfdb1449e383e1212707Cornelia Huck 7502ee97caf0a6602f749ddbfdb1449e383e1212707Cornelia Huckstatic void device_remove_class_symlinks(struct device *dev) 7512ee97caf0a6602f749ddbfdb1449e383e1212707Cornelia Huck{ 7522ee97caf0a6602f749ddbfdb1449e383e1212707Cornelia Huck if (!dev->class) 7532ee97caf0a6602f749ddbfdb1449e383e1212707Cornelia Huck return; 754da231fd5d113ab6da5dab7a2d2c38d0a540f939cKay Sievers 7552ee97caf0a6602f749ddbfdb1449e383e1212707Cornelia Huck#ifdef CONFIG_SYSFS_DEPRECATED 7564e886c29610f4374d8971ec7a248f011cc3bd73aGreg Kroah-Hartman if (dev->parent && device_is_not_partition(dev)) { 7572ee97caf0a6602f749ddbfdb1449e383e1212707Cornelia Huck char *class_name; 7582ee97caf0a6602f749ddbfdb1449e383e1212707Cornelia Huck 7592ee97caf0a6602f749ddbfdb1449e383e1212707Cornelia Huck class_name = make_class_name(dev->class->name, &dev->kobj); 7602ee97caf0a6602f749ddbfdb1449e383e1212707Cornelia Huck if (class_name) { 7612ee97caf0a6602f749ddbfdb1449e383e1212707Cornelia Huck sysfs_remove_link(&dev->parent->kobj, class_name); 7622ee97caf0a6602f749ddbfdb1449e383e1212707Cornelia Huck kfree(class_name); 7632ee97caf0a6602f749ddbfdb1449e383e1212707Cornelia Huck } 7642ee97caf0a6602f749ddbfdb1449e383e1212707Cornelia Huck sysfs_remove_link(&dev->kobj, "device"); 7652ee97caf0a6602f749ddbfdb1449e383e1212707Cornelia Huck } 766da231fd5d113ab6da5dab7a2d2c38d0a540f939cKay Sievers 7671fbfee6c6dc0f4a4c587b6b163ee79643fc9aaa7Greg Kroah-Hartman if (dev->kobj.parent != &dev->class->p->class_subsys.kobj && 7684e886c29610f4374d8971ec7a248f011cc3bd73aGreg Kroah-Hartman device_is_not_partition(dev)) 7691fbfee6c6dc0f4a4c587b6b163ee79643fc9aaa7Greg Kroah-Hartman sysfs_remove_link(&dev->class->p->class_subsys.kobj, 7701e0b2cf933ebf32494eba3f668859ba57f06a951Kay Sievers dev_name(dev)); 771da231fd5d113ab6da5dab7a2d2c38d0a540f939cKay Sievers#else 7724e886c29610f4374d8971ec7a248f011cc3bd73aGreg Kroah-Hartman if (dev->parent && device_is_not_partition(dev)) 773da231fd5d113ab6da5dab7a2d2c38d0a540f939cKay Sievers sysfs_remove_link(&dev->kobj, "device"); 774da231fd5d113ab6da5dab7a2d2c38d0a540f939cKay Sievers 7751e0b2cf933ebf32494eba3f668859ba57f06a951Kay Sievers sysfs_remove_link(&dev->class->p->class_subsys.kobj, dev_name(dev)); 776da231fd5d113ab6da5dab7a2d2c38d0a540f939cKay Sievers#endif 777da231fd5d113ab6da5dab7a2d2c38d0a540f939cKay Sievers 7782ee97caf0a6602f749ddbfdb1449e383e1212707Cornelia Huck sysfs_remove_link(&dev->kobj, "subsystem"); 7792ee97caf0a6602f749ddbfdb1449e383e1212707Cornelia Huck} 7802ee97caf0a6602f749ddbfdb1449e383e1212707Cornelia Huck 7811da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds/** 782413c239fad68258157f903b3ffd9bfcc53f5e34bStephen Rothwell * dev_set_name - set a device name 783413c239fad68258157f903b3ffd9bfcc53f5e34bStephen Rothwell * @dev: device 7844623236619ff5ce233136d13ee2747c194a63591Randy Dunlap * @fmt: format string for the device's name 785413c239fad68258157f903b3ffd9bfcc53f5e34bStephen Rothwell */ 786413c239fad68258157f903b3ffd9bfcc53f5e34bStephen Rothwellint dev_set_name(struct device *dev, const char *fmt, ...) 787413c239fad68258157f903b3ffd9bfcc53f5e34bStephen Rothwell{ 788413c239fad68258157f903b3ffd9bfcc53f5e34bStephen Rothwell va_list vargs; 7891fa5ae857bb14f6046205171d98506d8112dd74eKay Sievers int err; 790413c239fad68258157f903b3ffd9bfcc53f5e34bStephen Rothwell 791413c239fad68258157f903b3ffd9bfcc53f5e34bStephen Rothwell va_start(vargs, fmt); 7921fa5ae857bb14f6046205171d98506d8112dd74eKay Sievers err = kobject_set_name_vargs(&dev->kobj, fmt, vargs); 793413c239fad68258157f903b3ffd9bfcc53f5e34bStephen Rothwell va_end(vargs); 7941fa5ae857bb14f6046205171d98506d8112dd74eKay Sievers return err; 795413c239fad68258157f903b3ffd9bfcc53f5e34bStephen Rothwell} 796413c239fad68258157f903b3ffd9bfcc53f5e34bStephen RothwellEXPORT_SYMBOL_GPL(dev_set_name); 797413c239fad68258157f903b3ffd9bfcc53f5e34bStephen Rothwell 798413c239fad68258157f903b3ffd9bfcc53f5e34bStephen Rothwell/** 799e105b8bfc769b0545b6f0f395179d1e43cbee822Dan Williams * device_to_dev_kobj - select a /sys/dev/ directory for the device 800e105b8bfc769b0545b6f0f395179d1e43cbee822Dan Williams * @dev: device 801e105b8bfc769b0545b6f0f395179d1e43cbee822Dan Williams * 802e105b8bfc769b0545b6f0f395179d1e43cbee822Dan Williams * By default we select char/ for new entries. Setting class->dev_obj 803e105b8bfc769b0545b6f0f395179d1e43cbee822Dan Williams * to NULL prevents an entry from being created. class->dev_kobj must 804e105b8bfc769b0545b6f0f395179d1e43cbee822Dan Williams * be set (or cleared) before any devices are registered to the class 805e105b8bfc769b0545b6f0f395179d1e43cbee822Dan Williams * otherwise device_create_sys_dev_entry() and 806e105b8bfc769b0545b6f0f395179d1e43cbee822Dan Williams * device_remove_sys_dev_entry() will disagree about the the presence 807e105b8bfc769b0545b6f0f395179d1e43cbee822Dan Williams * of the link. 808e105b8bfc769b0545b6f0f395179d1e43cbee822Dan Williams */ 809e105b8bfc769b0545b6f0f395179d1e43cbee822Dan Williamsstatic struct kobject *device_to_dev_kobj(struct device *dev) 810e105b8bfc769b0545b6f0f395179d1e43cbee822Dan Williams{ 811e105b8bfc769b0545b6f0f395179d1e43cbee822Dan Williams struct kobject *kobj; 812e105b8bfc769b0545b6f0f395179d1e43cbee822Dan Williams 813e105b8bfc769b0545b6f0f395179d1e43cbee822Dan Williams if (dev->class) 814e105b8bfc769b0545b6f0f395179d1e43cbee822Dan Williams kobj = dev->class->dev_kobj; 815e105b8bfc769b0545b6f0f395179d1e43cbee822Dan Williams else 816e105b8bfc769b0545b6f0f395179d1e43cbee822Dan Williams kobj = sysfs_dev_char_kobj; 817e105b8bfc769b0545b6f0f395179d1e43cbee822Dan Williams 818e105b8bfc769b0545b6f0f395179d1e43cbee822Dan Williams return kobj; 819e105b8bfc769b0545b6f0f395179d1e43cbee822Dan Williams} 820e105b8bfc769b0545b6f0f395179d1e43cbee822Dan Williams 821e105b8bfc769b0545b6f0f395179d1e43cbee822Dan Williamsstatic int device_create_sys_dev_entry(struct device *dev) 822e105b8bfc769b0545b6f0f395179d1e43cbee822Dan Williams{ 823e105b8bfc769b0545b6f0f395179d1e43cbee822Dan Williams struct kobject *kobj = device_to_dev_kobj(dev); 824e105b8bfc769b0545b6f0f395179d1e43cbee822Dan Williams int error = 0; 825e105b8bfc769b0545b6f0f395179d1e43cbee822Dan Williams char devt_str[15]; 826e105b8bfc769b0545b6f0f395179d1e43cbee822Dan Williams 827e105b8bfc769b0545b6f0f395179d1e43cbee822Dan Williams if (kobj) { 828e105b8bfc769b0545b6f0f395179d1e43cbee822Dan Williams format_dev_t(devt_str, dev->devt); 829e105b8bfc769b0545b6f0f395179d1e43cbee822Dan Williams error = sysfs_create_link(kobj, &dev->kobj, devt_str); 830e105b8bfc769b0545b6f0f395179d1e43cbee822Dan Williams } 831e105b8bfc769b0545b6f0f395179d1e43cbee822Dan Williams 832e105b8bfc769b0545b6f0f395179d1e43cbee822Dan Williams return error; 833e105b8bfc769b0545b6f0f395179d1e43cbee822Dan Williams} 834e105b8bfc769b0545b6f0f395179d1e43cbee822Dan Williams 835e105b8bfc769b0545b6f0f395179d1e43cbee822Dan Williamsstatic void device_remove_sys_dev_entry(struct device *dev) 836e105b8bfc769b0545b6f0f395179d1e43cbee822Dan Williams{ 837e105b8bfc769b0545b6f0f395179d1e43cbee822Dan Williams struct kobject *kobj = device_to_dev_kobj(dev); 838e105b8bfc769b0545b6f0f395179d1e43cbee822Dan Williams char devt_str[15]; 839e105b8bfc769b0545b6f0f395179d1e43cbee822Dan Williams 840e105b8bfc769b0545b6f0f395179d1e43cbee822Dan Williams if (kobj) { 841e105b8bfc769b0545b6f0f395179d1e43cbee822Dan Williams format_dev_t(devt_str, dev->devt); 842e105b8bfc769b0545b6f0f395179d1e43cbee822Dan Williams sysfs_remove_link(kobj, devt_str); 843e105b8bfc769b0545b6f0f395179d1e43cbee822Dan Williams } 844e105b8bfc769b0545b6f0f395179d1e43cbee822Dan Williams} 845e105b8bfc769b0545b6f0f395179d1e43cbee822Dan Williams 846b4028437876866aba4747a655ede00f892089e14Greg Kroah-Hartmanint device_private_init(struct device *dev) 847b4028437876866aba4747a655ede00f892089e14Greg Kroah-Hartman{ 848b4028437876866aba4747a655ede00f892089e14Greg Kroah-Hartman dev->p = kzalloc(sizeof(*dev->p), GFP_KERNEL); 849b4028437876866aba4747a655ede00f892089e14Greg Kroah-Hartman if (!dev->p) 850b4028437876866aba4747a655ede00f892089e14Greg Kroah-Hartman return -ENOMEM; 851b4028437876866aba4747a655ede00f892089e14Greg Kroah-Hartman dev->p->device = dev; 852b4028437876866aba4747a655ede00f892089e14Greg Kroah-Hartman klist_init(&dev->p->klist_children, klist_children_get, 853b4028437876866aba4747a655ede00f892089e14Greg Kroah-Hartman klist_children_put); 854b4028437876866aba4747a655ede00f892089e14Greg Kroah-Hartman return 0; 855b4028437876866aba4747a655ede00f892089e14Greg Kroah-Hartman} 856b4028437876866aba4747a655ede00f892089e14Greg Kroah-Hartman 857e105b8bfc769b0545b6f0f395179d1e43cbee822Dan Williams/** 8584a3ad20ccd8f4d2a0535cf98fa83f7b561ba59a9Greg Kroah-Hartman * device_add - add device to device hierarchy. 8594a3ad20ccd8f4d2a0535cf98fa83f7b561ba59a9Greg Kroah-Hartman * @dev: device. 8601da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds * 8614a3ad20ccd8f4d2a0535cf98fa83f7b561ba59a9Greg Kroah-Hartman * This is part 2 of device_register(), though may be called 8624a3ad20ccd8f4d2a0535cf98fa83f7b561ba59a9Greg Kroah-Hartman * separately _iff_ device_initialize() has been called separately. 8631da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds * 8645739411acbaa63a6c22c91e340fdcdbcc7d82a51Cornelia Huck * This adds @dev to the kobject hierarchy via kobject_add(), adds it 8654a3ad20ccd8f4d2a0535cf98fa83f7b561ba59a9Greg Kroah-Hartman * to the global and sibling lists for the device, then 8664a3ad20ccd8f4d2a0535cf98fa83f7b561ba59a9Greg Kroah-Hartman * adds it to the other relevant subsystems of the driver model. 8675739411acbaa63a6c22c91e340fdcdbcc7d82a51Cornelia Huck * 8685739411acbaa63a6c22c91e340fdcdbcc7d82a51Cornelia Huck * NOTE: _Never_ directly free @dev after calling this function, even 8695739411acbaa63a6c22c91e340fdcdbcc7d82a51Cornelia Huck * if it returned an error! Always use put_device() to give up your 8705739411acbaa63a6c22c91e340fdcdbcc7d82a51Cornelia Huck * reference instead. 8711da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds */ 8721da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvaldsint device_add(struct device *dev) 8731da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds{ 8741da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds struct device *parent = NULL; 875c47ed219ba81632595e9f02e27318151fec16c9eGreg Kroah-Hartman struct class_interface *class_intf; 876c906a48adc74fc455378137ac5124b13e7030a15Greg Kroah-Hartman int error = -EINVAL; 877775b64d2b6ca37697de925f70799c710aab5849aRafael J. Wysocki 8781da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds dev = get_device(dev); 879c906a48adc74fc455378137ac5124b13e7030a15Greg Kroah-Hartman if (!dev) 880c906a48adc74fc455378137ac5124b13e7030a15Greg Kroah-Hartman goto done; 881c906a48adc74fc455378137ac5124b13e7030a15Greg Kroah-Hartman 882fb069a5d132fb926ed17af3211a114ac7cf27d7aGreg Kroah-Hartman if (!dev->p) { 883b4028437876866aba4747a655ede00f892089e14Greg Kroah-Hartman error = device_private_init(dev); 884b4028437876866aba4747a655ede00f892089e14Greg Kroah-Hartman if (error) 885b4028437876866aba4747a655ede00f892089e14Greg Kroah-Hartman goto done; 886fb069a5d132fb926ed17af3211a114ac7cf27d7aGreg Kroah-Hartman } 887fb069a5d132fb926ed17af3211a114ac7cf27d7aGreg Kroah-Hartman 8881fa5ae857bb14f6046205171d98506d8112dd74eKay Sievers /* 8891fa5ae857bb14f6046205171d98506d8112dd74eKay Sievers * for statically allocated devices, which should all be converted 8901fa5ae857bb14f6046205171d98506d8112dd74eKay Sievers * some day, we need to initialize the name. We prevent reading back 8911fa5ae857bb14f6046205171d98506d8112dd74eKay Sievers * the name, and force the use of dev_name() 8921fa5ae857bb14f6046205171d98506d8112dd74eKay Sievers */ 8931fa5ae857bb14f6046205171d98506d8112dd74eKay Sievers if (dev->init_name) { 894acc0e90fbccbc6e4d48184cba0983ea044e131afGreg Kroah-Hartman dev_set_name(dev, "%s", dev->init_name); 8951fa5ae857bb14f6046205171d98506d8112dd74eKay Sievers dev->init_name = NULL; 8961fa5ae857bb14f6046205171d98506d8112dd74eKay Sievers } 897c906a48adc74fc455378137ac5124b13e7030a15Greg Kroah-Hartman 8981fa5ae857bb14f6046205171d98506d8112dd74eKay Sievers if (!dev_name(dev)) 8995c8563d773c0e9f0ac2a552e84806decd98ce732Kay Sievers goto name_error; 9001da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds 9011e0b2cf933ebf32494eba3f668859ba57f06a951Kay Sievers pr_debug("device: '%s': %s\n", dev_name(dev), __func__); 902c205ef4880273d2de4ee5388d4e52227ff688cc4Greg Kroah-Hartman 9031da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds parent = get_device(dev->parent); 90463b6971a0876b744e2fcf3c9df15d130501e1debCornelia Huck setup_parent(dev, parent); 9051da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds 9060d358f22f6c8f03ab215eee8d52b74f78cc3c7dbYinghai Lu /* use parent numa_node */ 9070d358f22f6c8f03ab215eee8d52b74f78cc3c7dbYinghai Lu if (parent) 9080d358f22f6c8f03ab215eee8d52b74f78cc3c7dbYinghai Lu set_dev_node(dev, dev_to_node(parent)); 9090d358f22f6c8f03ab215eee8d52b74f78cc3c7dbYinghai Lu 9101da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds /* first, register with generic layer. */ 9118a577ffc75d9194fe8cdb7479236f2081c26ca1fKay Sievers /* we require the name to be set before, and pass NULL */ 9128a577ffc75d9194fe8cdb7479236f2081c26ca1fKay Sievers error = kobject_add(&dev->kobj, dev->kobj.parent, NULL); 91340fa54226f518a9bc97ed1d711c0016e416e3782Greg Kroah-Hartman if (error) 9141da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds goto Error; 915a7fd67062efc5b0fc9a61368c607fa92d1d57f9eKay Sievers 916370226449ced358e52d198081120826ef52c166bBrian Walsh /* notify platform of device entry */ 917370226449ced358e52d198081120826ef52c166bBrian Walsh if (platform_notify) 918370226449ced358e52d198081120826ef52c166bBrian Walsh platform_notify(dev); 919370226449ced358e52d198081120826ef52c166bBrian Walsh 920ad6a1e1c66009ba9dcd2f5c90ffa1fb4ce72fce0Tejun Heo error = device_create_file(dev, &uevent_attr); 921a306eea40952e6365301e8a2f7d5ffa9c6a1921bCornelia Huck if (error) 922a306eea40952e6365301e8a2f7d5ffa9c6a1921bCornelia Huck goto attrError; 923a7fd67062efc5b0fc9a61368c607fa92d1d57f9eKay Sievers 92423681e479129854305da1da32f7f1eaf635ef22cGreg Kroah-Hartman if (MAJOR(dev->devt)) { 925ad6a1e1c66009ba9dcd2f5c90ffa1fb4ce72fce0Tejun Heo error = device_create_file(dev, &devt_attr); 926ad6a1e1c66009ba9dcd2f5c90ffa1fb4ce72fce0Tejun Heo if (error) 927a306eea40952e6365301e8a2f7d5ffa9c6a1921bCornelia Huck goto ueventattrError; 928e105b8bfc769b0545b6f0f395179d1e43cbee822Dan Williams 929e105b8bfc769b0545b6f0f395179d1e43cbee822Dan Williams error = device_create_sys_dev_entry(dev); 930e105b8bfc769b0545b6f0f395179d1e43cbee822Dan Williams if (error) 931e105b8bfc769b0545b6f0f395179d1e43cbee822Dan Williams goto devtattrError; 9322b2af54a5bb6f7e80ccf78f20084b93c398c3a8bKay Sievers 9332b2af54a5bb6f7e80ccf78f20084b93c398c3a8bKay Sievers devtmpfs_create_node(dev); 93423681e479129854305da1da32f7f1eaf635ef22cGreg Kroah-Hartman } 93523681e479129854305da1da32f7f1eaf635ef22cGreg Kroah-Hartman 9362ee97caf0a6602f749ddbfdb1449e383e1212707Cornelia Huck error = device_add_class_symlinks(dev); 9372ee97caf0a6602f749ddbfdb1449e383e1212707Cornelia Huck if (error) 9382ee97caf0a6602f749ddbfdb1449e383e1212707Cornelia Huck goto SymlinkError; 939dc0afa8388972a9ed7c2203cc46d8df1a4713f65Cornelia Huck error = device_add_attrs(dev); 940dc0afa8388972a9ed7c2203cc46d8df1a4713f65Cornelia Huck if (error) 9412620efef7029bb040430f50f0fc148f2d5e002adGreg Kroah-Hartman goto AttrsError; 942dc0afa8388972a9ed7c2203cc46d8df1a4713f65Cornelia Huck error = bus_add_device(dev); 943dc0afa8388972a9ed7c2203cc46d8df1a4713f65Cornelia Huck if (error) 9441da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds goto BusError; 9453b98aeaf3a75f544dc945694f4fcf6e1c4bab89dAlan Stern error = dpm_sysfs_add(dev); 94657eee3d23e8833ca18708b374c648235691942baRafael J. Wysocki if (error) 9473b98aeaf3a75f544dc945694f4fcf6e1c4bab89dAlan Stern goto DPMError; 9483b98aeaf3a75f544dc945694f4fcf6e1c4bab89dAlan Stern device_pm_add(dev); 949ec0676ee28528dc8dda13a93ee4b1f215a0c2f9dAlan Stern 950ec0676ee28528dc8dda13a93ee4b1f215a0c2f9dAlan Stern /* Notify clients of device addition. This call must come 951ec0676ee28528dc8dda13a93ee4b1f215a0c2f9dAlan Stern * after dpm_sysf_add() and before kobject_uevent(). 952ec0676ee28528dc8dda13a93ee4b1f215a0c2f9dAlan Stern */ 953ec0676ee28528dc8dda13a93ee4b1f215a0c2f9dAlan Stern if (dev->bus) 954ec0676ee28528dc8dda13a93ee4b1f215a0c2f9dAlan Stern blocking_notifier_call_chain(&dev->bus->p->bus_notifier, 955ec0676ee28528dc8dda13a93ee4b1f215a0c2f9dAlan Stern BUS_NOTIFY_ADD_DEVICE, dev); 956ec0676ee28528dc8dda13a93ee4b1f215a0c2f9dAlan Stern 95783b5fb4cce13b9f7b218ed88ee05387c3f3bdda3Cornelia Huck kobject_uevent(&dev->kobj, KOBJ_ADD); 9582023c610dc54a4f4130b0494309a9bd668ca3df8Alan Stern bus_probe_device(dev); 9591da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds if (parent) 960f791b8c836307b58cbf62133a6a772ed1a92fb33Greg Kroah-Hartman klist_add_tail(&dev->p->knode_parent, 961f791b8c836307b58cbf62133a6a772ed1a92fb33Greg Kroah-Hartman &parent->p->klist_children); 9621da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds 9635d9fd169c9fbdaecdc430431e59bf94ff40b93d3Greg Kroah-Hartman if (dev->class) { 964f75b1c60fc1e53c4004a79ea0be071aa3318cdccDave Young mutex_lock(&dev->class->p->class_mutex); 965c47ed219ba81632595e9f02e27318151fec16c9eGreg Kroah-Hartman /* tie the class to the device */ 9665a3ceb861663040f9ef0176df4aaa494bba5e352Tejun Heo klist_add_tail(&dev->knode_class, 9675a3ceb861663040f9ef0176df4aaa494bba5e352Tejun Heo &dev->class->p->class_devices); 968c47ed219ba81632595e9f02e27318151fec16c9eGreg Kroah-Hartman 969c47ed219ba81632595e9f02e27318151fec16c9eGreg Kroah-Hartman /* notify any interfaces that the device is here */ 970184f1f779d5a2e62de4a0b34842ddf8546beca8fGreg Kroah-Hartman list_for_each_entry(class_intf, 971184f1f779d5a2e62de4a0b34842ddf8546beca8fGreg Kroah-Hartman &dev->class->p->class_interfaces, node) 972c47ed219ba81632595e9f02e27318151fec16c9eGreg Kroah-Hartman if (class_intf->add_dev) 973c47ed219ba81632595e9f02e27318151fec16c9eGreg Kroah-Hartman class_intf->add_dev(dev, class_intf); 974f75b1c60fc1e53c4004a79ea0be071aa3318cdccDave Young mutex_unlock(&dev->class->p->class_mutex); 9755d9fd169c9fbdaecdc430431e59bf94ff40b93d3Greg Kroah-Hartman } 976c906a48adc74fc455378137ac5124b13e7030a15Greg Kroah-Hartmandone: 9771da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds put_device(dev); 9781da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds return error; 9793b98aeaf3a75f544dc945694f4fcf6e1c4bab89dAlan Stern DPMError: 98057eee3d23e8833ca18708b374c648235691942baRafael J. Wysocki bus_remove_device(dev); 98157eee3d23e8833ca18708b374c648235691942baRafael J. Wysocki BusError: 98282f0cf9b7c42684c29189ddb6d0bc86eb1137fc4James Simmons device_remove_attrs(dev); 9832620efef7029bb040430f50f0fc148f2d5e002adGreg Kroah-Hartman AttrsError: 9842ee97caf0a6602f749ddbfdb1449e383e1212707Cornelia Huck device_remove_class_symlinks(dev); 9852ee97caf0a6602f749ddbfdb1449e383e1212707Cornelia Huck SymlinkError: 986ad6a1e1c66009ba9dcd2f5c90ffa1fb4ce72fce0Tejun Heo if (MAJOR(dev->devt)) 987e105b8bfc769b0545b6f0f395179d1e43cbee822Dan Williams device_remove_sys_dev_entry(dev); 988e105b8bfc769b0545b6f0f395179d1e43cbee822Dan Williams devtattrError: 989e105b8bfc769b0545b6f0f395179d1e43cbee822Dan Williams if (MAJOR(dev->devt)) 990ad6a1e1c66009ba9dcd2f5c90ffa1fb4ce72fce0Tejun Heo device_remove_file(dev, &devt_attr); 991a306eea40952e6365301e8a2f7d5ffa9c6a1921bCornelia Huck ueventattrError: 992ad6a1e1c66009ba9dcd2f5c90ffa1fb4ce72fce0Tejun Heo device_remove_file(dev, &uevent_attr); 99323681e479129854305da1da32f7f1eaf635ef22cGreg Kroah-Hartman attrError: 994312c004d36ce6c739512bac83b452f4c20ab1f62Kay Sievers kobject_uevent(&dev->kobj, KOBJ_REMOVE); 9951da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds kobject_del(&dev->kobj); 9961da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds Error: 99763b6971a0876b744e2fcf3c9df15d130501e1debCornelia Huck cleanup_device_parent(dev); 9981da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds if (parent) 9991da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds put_device(parent); 10005c8563d773c0e9f0ac2a552e84806decd98ce732Kay Sieversname_error: 10015c8563d773c0e9f0ac2a552e84806decd98ce732Kay Sievers kfree(dev->p); 10025c8563d773c0e9f0ac2a552e84806decd98ce732Kay Sievers dev->p = NULL; 1003c906a48adc74fc455378137ac5124b13e7030a15Greg Kroah-Hartman goto done; 10041da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds} 10051da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds 10061da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds/** 10074a3ad20ccd8f4d2a0535cf98fa83f7b561ba59a9Greg Kroah-Hartman * device_register - register a device with the system. 10084a3ad20ccd8f4d2a0535cf98fa83f7b561ba59a9Greg Kroah-Hartman * @dev: pointer to the device structure 10091da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds * 10104a3ad20ccd8f4d2a0535cf98fa83f7b561ba59a9Greg Kroah-Hartman * This happens in two clean steps - initialize the device 10114a3ad20ccd8f4d2a0535cf98fa83f7b561ba59a9Greg Kroah-Hartman * and add it to the system. The two steps can be called 10124a3ad20ccd8f4d2a0535cf98fa83f7b561ba59a9Greg Kroah-Hartman * separately, but this is the easiest and most common. 10134a3ad20ccd8f4d2a0535cf98fa83f7b561ba59a9Greg Kroah-Hartman * I.e. you should only call the two helpers separately if 10144a3ad20ccd8f4d2a0535cf98fa83f7b561ba59a9Greg Kroah-Hartman * have a clearly defined need to use and refcount the device 10154a3ad20ccd8f4d2a0535cf98fa83f7b561ba59a9Greg Kroah-Hartman * before it is added to the hierarchy. 10165739411acbaa63a6c22c91e340fdcdbcc7d82a51Cornelia Huck * 10175739411acbaa63a6c22c91e340fdcdbcc7d82a51Cornelia Huck * NOTE: _Never_ directly free @dev after calling this function, even 10185739411acbaa63a6c22c91e340fdcdbcc7d82a51Cornelia Huck * if it returned an error! Always use put_device() to give up the 10195739411acbaa63a6c22c91e340fdcdbcc7d82a51Cornelia Huck * reference initialized in this function instead. 10201da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds */ 10211da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvaldsint device_register(struct device *dev) 10221da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds{ 10231da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds device_initialize(dev); 10241da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds return device_add(dev); 10251da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds} 10261da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds 10271da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds/** 10284a3ad20ccd8f4d2a0535cf98fa83f7b561ba59a9Greg Kroah-Hartman * get_device - increment reference count for device. 10294a3ad20ccd8f4d2a0535cf98fa83f7b561ba59a9Greg Kroah-Hartman * @dev: device. 10301da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds * 10314a3ad20ccd8f4d2a0535cf98fa83f7b561ba59a9Greg Kroah-Hartman * This simply forwards the call to kobject_get(), though 10324a3ad20ccd8f4d2a0535cf98fa83f7b561ba59a9Greg Kroah-Hartman * we do take care to provide for the case that we get a NULL 10334a3ad20ccd8f4d2a0535cf98fa83f7b561ba59a9Greg Kroah-Hartman * pointer passed in. 10341da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds */ 10354a3ad20ccd8f4d2a0535cf98fa83f7b561ba59a9Greg Kroah-Hartmanstruct device *get_device(struct device *dev) 10361da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds{ 10371da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds return dev ? to_dev(kobject_get(&dev->kobj)) : NULL; 10381da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds} 10391da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds 10401da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds/** 10414a3ad20ccd8f4d2a0535cf98fa83f7b561ba59a9Greg Kroah-Hartman * put_device - decrement reference count. 10424a3ad20ccd8f4d2a0535cf98fa83f7b561ba59a9Greg Kroah-Hartman * @dev: device in question. 10431da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds */ 10444a3ad20ccd8f4d2a0535cf98fa83f7b561ba59a9Greg Kroah-Hartmanvoid put_device(struct device *dev) 10451da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds{ 1046edfaa7c36574f1bf09c65ad602412db9da5f96bfKay Sievers /* might_sleep(); */ 10471da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds if (dev) 10481da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds kobject_put(&dev->kobj); 10491da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds} 10501da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds 10511da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds/** 10524a3ad20ccd8f4d2a0535cf98fa83f7b561ba59a9Greg Kroah-Hartman * device_del - delete device from system. 10534a3ad20ccd8f4d2a0535cf98fa83f7b561ba59a9Greg Kroah-Hartman * @dev: device. 10541da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds * 10554a3ad20ccd8f4d2a0535cf98fa83f7b561ba59a9Greg Kroah-Hartman * This is the first part of the device unregistration 10564a3ad20ccd8f4d2a0535cf98fa83f7b561ba59a9Greg Kroah-Hartman * sequence. This removes the device from the lists we control 10574a3ad20ccd8f4d2a0535cf98fa83f7b561ba59a9Greg Kroah-Hartman * from here, has it removed from the other driver model 10584a3ad20ccd8f4d2a0535cf98fa83f7b561ba59a9Greg Kroah-Hartman * subsystems it was added to in device_add(), and removes it 10594a3ad20ccd8f4d2a0535cf98fa83f7b561ba59a9Greg Kroah-Hartman * from the kobject hierarchy. 10601da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds * 10614a3ad20ccd8f4d2a0535cf98fa83f7b561ba59a9Greg Kroah-Hartman * NOTE: this should be called manually _iff_ device_add() was 10624a3ad20ccd8f4d2a0535cf98fa83f7b561ba59a9Greg Kroah-Hartman * also called manually. 10631da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds */ 10644a3ad20ccd8f4d2a0535cf98fa83f7b561ba59a9Greg Kroah-Hartmanvoid device_del(struct device *dev) 10651da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds{ 10664a3ad20ccd8f4d2a0535cf98fa83f7b561ba59a9Greg Kroah-Hartman struct device *parent = dev->parent; 1067c47ed219ba81632595e9f02e27318151fec16c9eGreg Kroah-Hartman struct class_interface *class_intf; 10681da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds 1069ec0676ee28528dc8dda13a93ee4b1f215a0c2f9dAlan Stern /* Notify clients of device removal. This call must come 1070ec0676ee28528dc8dda13a93ee4b1f215a0c2f9dAlan Stern * before dpm_sysfs_remove(). 1071ec0676ee28528dc8dda13a93ee4b1f215a0c2f9dAlan Stern */ 1072ec0676ee28528dc8dda13a93ee4b1f215a0c2f9dAlan Stern if (dev->bus) 1073ec0676ee28528dc8dda13a93ee4b1f215a0c2f9dAlan Stern blocking_notifier_call_chain(&dev->bus->p->bus_notifier, 1074ec0676ee28528dc8dda13a93ee4b1f215a0c2f9dAlan Stern BUS_NOTIFY_DEL_DEVICE, dev); 1075775b64d2b6ca37697de925f70799c710aab5849aRafael J. Wysocki device_pm_remove(dev); 10763b98aeaf3a75f544dc945694f4fcf6e1c4bab89dAlan Stern dpm_sysfs_remove(dev); 10771da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds if (parent) 1078f791b8c836307b58cbf62133a6a772ed1a92fb33Greg Kroah-Hartman klist_del(&dev->p->knode_parent); 1079e105b8bfc769b0545b6f0f395179d1e43cbee822Dan Williams if (MAJOR(dev->devt)) { 10802b2af54a5bb6f7e80ccf78f20084b93c398c3a8bKay Sievers devtmpfs_delete_node(dev); 1081e105b8bfc769b0545b6f0f395179d1e43cbee822Dan Williams device_remove_sys_dev_entry(dev); 1082ad6a1e1c66009ba9dcd2f5c90ffa1fb4ce72fce0Tejun Heo device_remove_file(dev, &devt_attr); 1083e105b8bfc769b0545b6f0f395179d1e43cbee822Dan Williams } 1084b9d9c82b4d081feb464f62dfc786c8621d09ecd2Kay Sievers if (dev->class) { 1085da231fd5d113ab6da5dab7a2d2c38d0a540f939cKay Sievers device_remove_class_symlinks(dev); 108699ef3ef8d5f2f5b5312627127ad63df27c0d0d05Kay Sievers 1087f75b1c60fc1e53c4004a79ea0be071aa3318cdccDave Young mutex_lock(&dev->class->p->class_mutex); 1088c47ed219ba81632595e9f02e27318151fec16c9eGreg Kroah-Hartman /* notify any interfaces that the device is now gone */ 1089184f1f779d5a2e62de4a0b34842ddf8546beca8fGreg Kroah-Hartman list_for_each_entry(class_intf, 1090184f1f779d5a2e62de4a0b34842ddf8546beca8fGreg Kroah-Hartman &dev->class->p->class_interfaces, node) 1091c47ed219ba81632595e9f02e27318151fec16c9eGreg Kroah-Hartman if (class_intf->remove_dev) 1092c47ed219ba81632595e9f02e27318151fec16c9eGreg Kroah-Hartman class_intf->remove_dev(dev, class_intf); 1093c47ed219ba81632595e9f02e27318151fec16c9eGreg Kroah-Hartman /* remove the device from the class list */ 10945a3ceb861663040f9ef0176df4aaa494bba5e352Tejun Heo klist_del(&dev->knode_class); 1095f75b1c60fc1e53c4004a79ea0be071aa3318cdccDave Young mutex_unlock(&dev->class->p->class_mutex); 1096b9d9c82b4d081feb464f62dfc786c8621d09ecd2Kay Sievers } 1097ad6a1e1c66009ba9dcd2f5c90ffa1fb4ce72fce0Tejun Heo device_remove_file(dev, &uevent_attr); 10982620efef7029bb040430f50f0fc148f2d5e002adGreg Kroah-Hartman device_remove_attrs(dev); 1099289535334646796fe41f199718e4a731f7411a92Benjamin Herrenschmidt bus_remove_device(dev); 11001da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds 11012f8d16a996da0b9be2536994aa7a825418364471Tejun Heo /* 11022f8d16a996da0b9be2536994aa7a825418364471Tejun Heo * Some platform devices are driven without driver attached 11032f8d16a996da0b9be2536994aa7a825418364471Tejun Heo * and managed resources may have been acquired. Make sure 11042f8d16a996da0b9be2536994aa7a825418364471Tejun Heo * all resources are released. 11052f8d16a996da0b9be2536994aa7a825418364471Tejun Heo */ 11062f8d16a996da0b9be2536994aa7a825418364471Tejun Heo devres_release_all(dev); 11072f8d16a996da0b9be2536994aa7a825418364471Tejun Heo 11081da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds /* Notify the platform of the removal, in case they 11091da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds * need to do anything... 11101da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds */ 11111da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds if (platform_notify_remove) 11121da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds platform_notify_remove(dev); 1113312c004d36ce6c739512bac83b452f4c20ab1f62Kay Sievers kobject_uevent(&dev->kobj, KOBJ_REMOVE); 1114da231fd5d113ab6da5dab7a2d2c38d0a540f939cKay Sievers cleanup_device_parent(dev); 11151da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds kobject_del(&dev->kobj); 1116da231fd5d113ab6da5dab7a2d2c38d0a540f939cKay Sievers put_device(parent); 11171da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds} 11181da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds 11191da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds/** 11204a3ad20ccd8f4d2a0535cf98fa83f7b561ba59a9Greg Kroah-Hartman * device_unregister - unregister device from system. 11214a3ad20ccd8f4d2a0535cf98fa83f7b561ba59a9Greg Kroah-Hartman * @dev: device going away. 11221da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds * 11234a3ad20ccd8f4d2a0535cf98fa83f7b561ba59a9Greg Kroah-Hartman * We do this in two parts, like we do device_register(). First, 11244a3ad20ccd8f4d2a0535cf98fa83f7b561ba59a9Greg Kroah-Hartman * we remove it from all the subsystems with device_del(), then 11254a3ad20ccd8f4d2a0535cf98fa83f7b561ba59a9Greg Kroah-Hartman * we decrement the reference count via put_device(). If that 11264a3ad20ccd8f4d2a0535cf98fa83f7b561ba59a9Greg Kroah-Hartman * is the final reference count, the device will be cleaned up 11274a3ad20ccd8f4d2a0535cf98fa83f7b561ba59a9Greg Kroah-Hartman * via device_release() above. Otherwise, the structure will 11284a3ad20ccd8f4d2a0535cf98fa83f7b561ba59a9Greg Kroah-Hartman * stick around until the final reference to the device is dropped. 11291da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds */ 11304a3ad20ccd8f4d2a0535cf98fa83f7b561ba59a9Greg Kroah-Hartmanvoid device_unregister(struct device *dev) 11311da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds{ 11321e0b2cf933ebf32494eba3f668859ba57f06a951Kay Sievers pr_debug("device: '%s': %s\n", dev_name(dev), __func__); 11331da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds device_del(dev); 11341da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds put_device(dev); 11351da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds} 11361da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds 11374a3ad20ccd8f4d2a0535cf98fa83f7b561ba59a9Greg Kroah-Hartmanstatic struct device *next_device(struct klist_iter *i) 113836239577cfb6b9a7c111209536b54200b0252ebfPatrick Mochel{ 11394a3ad20ccd8f4d2a0535cf98fa83f7b561ba59a9Greg Kroah-Hartman struct klist_node *n = klist_next(i); 1140f791b8c836307b58cbf62133a6a772ed1a92fb33Greg Kroah-Hartman struct device *dev = NULL; 1141f791b8c836307b58cbf62133a6a772ed1a92fb33Greg Kroah-Hartman struct device_private *p; 1142f791b8c836307b58cbf62133a6a772ed1a92fb33Greg Kroah-Hartman 1143f791b8c836307b58cbf62133a6a772ed1a92fb33Greg Kroah-Hartman if (n) { 1144f791b8c836307b58cbf62133a6a772ed1a92fb33Greg Kroah-Hartman p = to_device_private_parent(n); 1145f791b8c836307b58cbf62133a6a772ed1a92fb33Greg Kroah-Hartman dev = p->device; 1146f791b8c836307b58cbf62133a6a772ed1a92fb33Greg Kroah-Hartman } 1147f791b8c836307b58cbf62133a6a772ed1a92fb33Greg Kroah-Hartman return dev; 114836239577cfb6b9a7c111209536b54200b0252ebfPatrick Mochel} 114936239577cfb6b9a7c111209536b54200b0252ebfPatrick Mochel 11501da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds/** 11516fcf53acccf85b4b0d0260e66c692a341760f464Kay Sievers * device_get_nodename - path of device node file 11526fcf53acccf85b4b0d0260e66c692a341760f464Kay Sievers * @dev: device 11536fcf53acccf85b4b0d0260e66c692a341760f464Kay Sievers * @tmp: possibly allocated string 11546fcf53acccf85b4b0d0260e66c692a341760f464Kay Sievers * 11556fcf53acccf85b4b0d0260e66c692a341760f464Kay Sievers * Return the relative path of a possible device node. 11566fcf53acccf85b4b0d0260e66c692a341760f464Kay Sievers * Non-default names may need to allocate a memory to compose 11576fcf53acccf85b4b0d0260e66c692a341760f464Kay Sievers * a name. This memory is returned in tmp and needs to be 11586fcf53acccf85b4b0d0260e66c692a341760f464Kay Sievers * freed by the caller. 11596fcf53acccf85b4b0d0260e66c692a341760f464Kay Sievers */ 11606fcf53acccf85b4b0d0260e66c692a341760f464Kay Sieversconst char *device_get_nodename(struct device *dev, const char **tmp) 11616fcf53acccf85b4b0d0260e66c692a341760f464Kay Sievers{ 11626fcf53acccf85b4b0d0260e66c692a341760f464Kay Sievers char *s; 11636fcf53acccf85b4b0d0260e66c692a341760f464Kay Sievers 11646fcf53acccf85b4b0d0260e66c692a341760f464Kay Sievers *tmp = NULL; 11656fcf53acccf85b4b0d0260e66c692a341760f464Kay Sievers 11666fcf53acccf85b4b0d0260e66c692a341760f464Kay Sievers /* the device type may provide a specific name */ 11676fcf53acccf85b4b0d0260e66c692a341760f464Kay Sievers if (dev->type && dev->type->nodename) 11686fcf53acccf85b4b0d0260e66c692a341760f464Kay Sievers *tmp = dev->type->nodename(dev); 11696fcf53acccf85b4b0d0260e66c692a341760f464Kay Sievers if (*tmp) 11706fcf53acccf85b4b0d0260e66c692a341760f464Kay Sievers return *tmp; 11716fcf53acccf85b4b0d0260e66c692a341760f464Kay Sievers 11726fcf53acccf85b4b0d0260e66c692a341760f464Kay Sievers /* the class may provide a specific name */ 11736fcf53acccf85b4b0d0260e66c692a341760f464Kay Sievers if (dev->class && dev->class->nodename) 11746fcf53acccf85b4b0d0260e66c692a341760f464Kay Sievers *tmp = dev->class->nodename(dev); 11756fcf53acccf85b4b0d0260e66c692a341760f464Kay Sievers if (*tmp) 11766fcf53acccf85b4b0d0260e66c692a341760f464Kay Sievers return *tmp; 11776fcf53acccf85b4b0d0260e66c692a341760f464Kay Sievers 11786fcf53acccf85b4b0d0260e66c692a341760f464Kay Sievers /* return name without allocation, tmp == NULL */ 11796fcf53acccf85b4b0d0260e66c692a341760f464Kay Sievers if (strchr(dev_name(dev), '!') == NULL) 11806fcf53acccf85b4b0d0260e66c692a341760f464Kay Sievers return dev_name(dev); 11816fcf53acccf85b4b0d0260e66c692a341760f464Kay Sievers 11826fcf53acccf85b4b0d0260e66c692a341760f464Kay Sievers /* replace '!' in the name with '/' */ 11836fcf53acccf85b4b0d0260e66c692a341760f464Kay Sievers *tmp = kstrdup(dev_name(dev), GFP_KERNEL); 11846fcf53acccf85b4b0d0260e66c692a341760f464Kay Sievers if (!*tmp) 11856fcf53acccf85b4b0d0260e66c692a341760f464Kay Sievers return NULL; 11866fcf53acccf85b4b0d0260e66c692a341760f464Kay Sievers while ((s = strchr(*tmp, '!'))) 11876fcf53acccf85b4b0d0260e66c692a341760f464Kay Sievers s[0] = '/'; 11886fcf53acccf85b4b0d0260e66c692a341760f464Kay Sievers return *tmp; 11896fcf53acccf85b4b0d0260e66c692a341760f464Kay Sievers} 11906fcf53acccf85b4b0d0260e66c692a341760f464Kay Sievers 11916fcf53acccf85b4b0d0260e66c692a341760f464Kay Sievers/** 11924a3ad20ccd8f4d2a0535cf98fa83f7b561ba59a9Greg Kroah-Hartman * device_for_each_child - device child iterator. 11934a3ad20ccd8f4d2a0535cf98fa83f7b561ba59a9Greg Kroah-Hartman * @parent: parent struct device. 11944a3ad20ccd8f4d2a0535cf98fa83f7b561ba59a9Greg Kroah-Hartman * @data: data for the callback. 11954a3ad20ccd8f4d2a0535cf98fa83f7b561ba59a9Greg Kroah-Hartman * @fn: function to be called for each device. 11961da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds * 11974a3ad20ccd8f4d2a0535cf98fa83f7b561ba59a9Greg Kroah-Hartman * Iterate over @parent's child devices, and call @fn for each, 11984a3ad20ccd8f4d2a0535cf98fa83f7b561ba59a9Greg Kroah-Hartman * passing it @data. 11991da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds * 12004a3ad20ccd8f4d2a0535cf98fa83f7b561ba59a9Greg Kroah-Hartman * We check the return of @fn each time. If it returns anything 12014a3ad20ccd8f4d2a0535cf98fa83f7b561ba59a9Greg Kroah-Hartman * other than 0, we break out and return that value. 12021da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds */ 12034a3ad20ccd8f4d2a0535cf98fa83f7b561ba59a9Greg Kroah-Hartmanint device_for_each_child(struct device *parent, void *data, 12044a3ad20ccd8f4d2a0535cf98fa83f7b561ba59a9Greg Kroah-Hartman int (*fn)(struct device *dev, void *data)) 12051da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds{ 120636239577cfb6b9a7c111209536b54200b0252ebfPatrick Mochel struct klist_iter i; 12074a3ad20ccd8f4d2a0535cf98fa83f7b561ba59a9Greg Kroah-Hartman struct device *child; 12081da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds int error = 0; 12091da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds 1210014c90dbb9b63bae067afc80a7931a76c5268ae3Greg Kroah-Hartman if (!parent->p) 1211014c90dbb9b63bae067afc80a7931a76c5268ae3Greg Kroah-Hartman return 0; 1212014c90dbb9b63bae067afc80a7931a76c5268ae3Greg Kroah-Hartman 1213f791b8c836307b58cbf62133a6a772ed1a92fb33Greg Kroah-Hartman klist_iter_init(&parent->p->klist_children, &i); 121436239577cfb6b9a7c111209536b54200b0252ebfPatrick Mochel while ((child = next_device(&i)) && !error) 121536239577cfb6b9a7c111209536b54200b0252ebfPatrick Mochel error = fn(child, data); 121636239577cfb6b9a7c111209536b54200b0252ebfPatrick Mochel klist_iter_exit(&i); 12171da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds return error; 12181da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds} 12191da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds 12205ab699810d46011ad2195c5916f3cbc684bfe3eeCornelia Huck/** 12215ab699810d46011ad2195c5916f3cbc684bfe3eeCornelia Huck * device_find_child - device iterator for locating a particular device. 12225ab699810d46011ad2195c5916f3cbc684bfe3eeCornelia Huck * @parent: parent struct device 12235ab699810d46011ad2195c5916f3cbc684bfe3eeCornelia Huck * @data: Data to pass to match function 12245ab699810d46011ad2195c5916f3cbc684bfe3eeCornelia Huck * @match: Callback function to check device 12255ab699810d46011ad2195c5916f3cbc684bfe3eeCornelia Huck * 12265ab699810d46011ad2195c5916f3cbc684bfe3eeCornelia Huck * This is similar to the device_for_each_child() function above, but it 12275ab699810d46011ad2195c5916f3cbc684bfe3eeCornelia Huck * returns a reference to a device that is 'found' for later use, as 12285ab699810d46011ad2195c5916f3cbc684bfe3eeCornelia Huck * determined by the @match callback. 12295ab699810d46011ad2195c5916f3cbc684bfe3eeCornelia Huck * 12305ab699810d46011ad2195c5916f3cbc684bfe3eeCornelia Huck * The callback should return 0 if the device doesn't match and non-zero 12315ab699810d46011ad2195c5916f3cbc684bfe3eeCornelia Huck * if it does. If the callback returns non-zero and a reference to the 12325ab699810d46011ad2195c5916f3cbc684bfe3eeCornelia Huck * current device can be obtained, this function will return to the caller 12335ab699810d46011ad2195c5916f3cbc684bfe3eeCornelia Huck * and not iterate over any more devices. 12345ab699810d46011ad2195c5916f3cbc684bfe3eeCornelia Huck */ 12354a3ad20ccd8f4d2a0535cf98fa83f7b561ba59a9Greg Kroah-Hartmanstruct device *device_find_child(struct device *parent, void *data, 12364a3ad20ccd8f4d2a0535cf98fa83f7b561ba59a9Greg Kroah-Hartman int (*match)(struct device *dev, void *data)) 12375ab699810d46011ad2195c5916f3cbc684bfe3eeCornelia Huck{ 12385ab699810d46011ad2195c5916f3cbc684bfe3eeCornelia Huck struct klist_iter i; 12395ab699810d46011ad2195c5916f3cbc684bfe3eeCornelia Huck struct device *child; 12405ab699810d46011ad2195c5916f3cbc684bfe3eeCornelia Huck 12415ab699810d46011ad2195c5916f3cbc684bfe3eeCornelia Huck if (!parent) 12425ab699810d46011ad2195c5916f3cbc684bfe3eeCornelia Huck return NULL; 12435ab699810d46011ad2195c5916f3cbc684bfe3eeCornelia Huck 1244f791b8c836307b58cbf62133a6a772ed1a92fb33Greg Kroah-Hartman klist_iter_init(&parent->p->klist_children, &i); 12455ab699810d46011ad2195c5916f3cbc684bfe3eeCornelia Huck while ((child = next_device(&i))) 12465ab699810d46011ad2195c5916f3cbc684bfe3eeCornelia Huck if (match(child, data) && get_device(child)) 12475ab699810d46011ad2195c5916f3cbc684bfe3eeCornelia Huck break; 12485ab699810d46011ad2195c5916f3cbc684bfe3eeCornelia Huck klist_iter_exit(&i); 12495ab699810d46011ad2195c5916f3cbc684bfe3eeCornelia Huck return child; 12505ab699810d46011ad2195c5916f3cbc684bfe3eeCornelia Huck} 12515ab699810d46011ad2195c5916f3cbc684bfe3eeCornelia Huck 12521da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvaldsint __init devices_init(void) 12531da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds{ 1254881c6cfd7c5edfe6129006e2404654bfe5911050Greg Kroah-Hartman devices_kset = kset_create_and_add("devices", &device_uevent_ops, NULL); 1255881c6cfd7c5edfe6129006e2404654bfe5911050Greg Kroah-Hartman if (!devices_kset) 1256881c6cfd7c5edfe6129006e2404654bfe5911050Greg Kroah-Hartman return -ENOMEM; 1257e105b8bfc769b0545b6f0f395179d1e43cbee822Dan Williams dev_kobj = kobject_create_and_add("dev", NULL); 1258e105b8bfc769b0545b6f0f395179d1e43cbee822Dan Williams if (!dev_kobj) 1259e105b8bfc769b0545b6f0f395179d1e43cbee822Dan Williams goto dev_kobj_err; 1260e105b8bfc769b0545b6f0f395179d1e43cbee822Dan Williams sysfs_dev_block_kobj = kobject_create_and_add("block", dev_kobj); 1261e105b8bfc769b0545b6f0f395179d1e43cbee822Dan Williams if (!sysfs_dev_block_kobj) 1262e105b8bfc769b0545b6f0f395179d1e43cbee822Dan Williams goto block_kobj_err; 1263e105b8bfc769b0545b6f0f395179d1e43cbee822Dan Williams sysfs_dev_char_kobj = kobject_create_and_add("char", dev_kobj); 1264e105b8bfc769b0545b6f0f395179d1e43cbee822Dan Williams if (!sysfs_dev_char_kobj) 1265e105b8bfc769b0545b6f0f395179d1e43cbee822Dan Williams goto char_kobj_err; 1266e105b8bfc769b0545b6f0f395179d1e43cbee822Dan Williams 1267881c6cfd7c5edfe6129006e2404654bfe5911050Greg Kroah-Hartman return 0; 1268e105b8bfc769b0545b6f0f395179d1e43cbee822Dan Williams 1269e105b8bfc769b0545b6f0f395179d1e43cbee822Dan Williams char_kobj_err: 1270e105b8bfc769b0545b6f0f395179d1e43cbee822Dan Williams kobject_put(sysfs_dev_block_kobj); 1271e105b8bfc769b0545b6f0f395179d1e43cbee822Dan Williams block_kobj_err: 1272e105b8bfc769b0545b6f0f395179d1e43cbee822Dan Williams kobject_put(dev_kobj); 1273e105b8bfc769b0545b6f0f395179d1e43cbee822Dan Williams dev_kobj_err: 1274e105b8bfc769b0545b6f0f395179d1e43cbee822Dan Williams kset_unregister(devices_kset); 1275e105b8bfc769b0545b6f0f395179d1e43cbee822Dan Williams return -ENOMEM; 12761da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds} 12771da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds 12781da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus TorvaldsEXPORT_SYMBOL_GPL(device_for_each_child); 12795ab699810d46011ad2195c5916f3cbc684bfe3eeCornelia HuckEXPORT_SYMBOL_GPL(device_find_child); 12801da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds 12811da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus TorvaldsEXPORT_SYMBOL_GPL(device_initialize); 12821da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus TorvaldsEXPORT_SYMBOL_GPL(device_add); 12831da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus TorvaldsEXPORT_SYMBOL_GPL(device_register); 12841da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds 12851da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus TorvaldsEXPORT_SYMBOL_GPL(device_del); 12861da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus TorvaldsEXPORT_SYMBOL_GPL(device_unregister); 12871da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus TorvaldsEXPORT_SYMBOL_GPL(get_device); 12881da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus TorvaldsEXPORT_SYMBOL_GPL(put_device); 12891da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds 12901da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus TorvaldsEXPORT_SYMBOL_GPL(device_create_file); 12911da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus TorvaldsEXPORT_SYMBOL_GPL(device_remove_file); 129223681e479129854305da1da32f7f1eaf635ef22cGreg Kroah-Hartman 12930aa0dc41bfd993491c2344870eee7a3b218551fbMark McLoughlinstruct root_device 12940aa0dc41bfd993491c2344870eee7a3b218551fbMark McLoughlin{ 12950aa0dc41bfd993491c2344870eee7a3b218551fbMark McLoughlin struct device dev; 12960aa0dc41bfd993491c2344870eee7a3b218551fbMark McLoughlin struct module *owner; 12970aa0dc41bfd993491c2344870eee7a3b218551fbMark McLoughlin}; 12980aa0dc41bfd993491c2344870eee7a3b218551fbMark McLoughlin 12990aa0dc41bfd993491c2344870eee7a3b218551fbMark McLoughlin#define to_root_device(dev) container_of(dev, struct root_device, dev) 13000aa0dc41bfd993491c2344870eee7a3b218551fbMark McLoughlin 13010aa0dc41bfd993491c2344870eee7a3b218551fbMark McLoughlinstatic void root_device_release(struct device *dev) 13020aa0dc41bfd993491c2344870eee7a3b218551fbMark McLoughlin{ 13030aa0dc41bfd993491c2344870eee7a3b218551fbMark McLoughlin kfree(to_root_device(dev)); 13040aa0dc41bfd993491c2344870eee7a3b218551fbMark McLoughlin} 13050aa0dc41bfd993491c2344870eee7a3b218551fbMark McLoughlin 13060aa0dc41bfd993491c2344870eee7a3b218551fbMark McLoughlin/** 13070aa0dc41bfd993491c2344870eee7a3b218551fbMark McLoughlin * __root_device_register - allocate and register a root device 13080aa0dc41bfd993491c2344870eee7a3b218551fbMark McLoughlin * @name: root device name 13090aa0dc41bfd993491c2344870eee7a3b218551fbMark McLoughlin * @owner: owner module of the root device, usually THIS_MODULE 13100aa0dc41bfd993491c2344870eee7a3b218551fbMark McLoughlin * 13110aa0dc41bfd993491c2344870eee7a3b218551fbMark McLoughlin * This function allocates a root device and registers it 13120aa0dc41bfd993491c2344870eee7a3b218551fbMark McLoughlin * using device_register(). In order to free the returned 13130aa0dc41bfd993491c2344870eee7a3b218551fbMark McLoughlin * device, use root_device_unregister(). 13140aa0dc41bfd993491c2344870eee7a3b218551fbMark McLoughlin * 13150aa0dc41bfd993491c2344870eee7a3b218551fbMark McLoughlin * Root devices are dummy devices which allow other devices 13160aa0dc41bfd993491c2344870eee7a3b218551fbMark McLoughlin * to be grouped under /sys/devices. Use this function to 13170aa0dc41bfd993491c2344870eee7a3b218551fbMark McLoughlin * allocate a root device and then use it as the parent of 13180aa0dc41bfd993491c2344870eee7a3b218551fbMark McLoughlin * any device which should appear under /sys/devices/{name} 13190aa0dc41bfd993491c2344870eee7a3b218551fbMark McLoughlin * 13200aa0dc41bfd993491c2344870eee7a3b218551fbMark McLoughlin * The /sys/devices/{name} directory will also contain a 13210aa0dc41bfd993491c2344870eee7a3b218551fbMark McLoughlin * 'module' symlink which points to the @owner directory 13220aa0dc41bfd993491c2344870eee7a3b218551fbMark McLoughlin * in sysfs. 13230aa0dc41bfd993491c2344870eee7a3b218551fbMark McLoughlin * 13240aa0dc41bfd993491c2344870eee7a3b218551fbMark McLoughlin * Note: You probably want to use root_device_register(). 13250aa0dc41bfd993491c2344870eee7a3b218551fbMark McLoughlin */ 13260aa0dc41bfd993491c2344870eee7a3b218551fbMark McLoughlinstruct device *__root_device_register(const char *name, struct module *owner) 13270aa0dc41bfd993491c2344870eee7a3b218551fbMark McLoughlin{ 13280aa0dc41bfd993491c2344870eee7a3b218551fbMark McLoughlin struct root_device *root; 13290aa0dc41bfd993491c2344870eee7a3b218551fbMark McLoughlin int err = -ENOMEM; 13300aa0dc41bfd993491c2344870eee7a3b218551fbMark McLoughlin 13310aa0dc41bfd993491c2344870eee7a3b218551fbMark McLoughlin root = kzalloc(sizeof(struct root_device), GFP_KERNEL); 13320aa0dc41bfd993491c2344870eee7a3b218551fbMark McLoughlin if (!root) 13330aa0dc41bfd993491c2344870eee7a3b218551fbMark McLoughlin return ERR_PTR(err); 13340aa0dc41bfd993491c2344870eee7a3b218551fbMark McLoughlin 1335acc0e90fbccbc6e4d48184cba0983ea044e131afGreg Kroah-Hartman err = dev_set_name(&root->dev, "%s", name); 13360aa0dc41bfd993491c2344870eee7a3b218551fbMark McLoughlin if (err) { 13370aa0dc41bfd993491c2344870eee7a3b218551fbMark McLoughlin kfree(root); 13380aa0dc41bfd993491c2344870eee7a3b218551fbMark McLoughlin return ERR_PTR(err); 13390aa0dc41bfd993491c2344870eee7a3b218551fbMark McLoughlin } 13400aa0dc41bfd993491c2344870eee7a3b218551fbMark McLoughlin 13410aa0dc41bfd993491c2344870eee7a3b218551fbMark McLoughlin root->dev.release = root_device_release; 13420aa0dc41bfd993491c2344870eee7a3b218551fbMark McLoughlin 13430aa0dc41bfd993491c2344870eee7a3b218551fbMark McLoughlin err = device_register(&root->dev); 13440aa0dc41bfd993491c2344870eee7a3b218551fbMark McLoughlin if (err) { 13450aa0dc41bfd993491c2344870eee7a3b218551fbMark McLoughlin put_device(&root->dev); 13460aa0dc41bfd993491c2344870eee7a3b218551fbMark McLoughlin return ERR_PTR(err); 13470aa0dc41bfd993491c2344870eee7a3b218551fbMark McLoughlin } 13480aa0dc41bfd993491c2344870eee7a3b218551fbMark McLoughlin 13490aa0dc41bfd993491c2344870eee7a3b218551fbMark McLoughlin#ifdef CONFIG_MODULE /* gotta find a "cleaner" way to do this */ 13500aa0dc41bfd993491c2344870eee7a3b218551fbMark McLoughlin if (owner) { 13510aa0dc41bfd993491c2344870eee7a3b218551fbMark McLoughlin struct module_kobject *mk = &owner->mkobj; 13520aa0dc41bfd993491c2344870eee7a3b218551fbMark McLoughlin 13530aa0dc41bfd993491c2344870eee7a3b218551fbMark McLoughlin err = sysfs_create_link(&root->dev.kobj, &mk->kobj, "module"); 13540aa0dc41bfd993491c2344870eee7a3b218551fbMark McLoughlin if (err) { 13550aa0dc41bfd993491c2344870eee7a3b218551fbMark McLoughlin device_unregister(&root->dev); 13560aa0dc41bfd993491c2344870eee7a3b218551fbMark McLoughlin return ERR_PTR(err); 13570aa0dc41bfd993491c2344870eee7a3b218551fbMark McLoughlin } 13580aa0dc41bfd993491c2344870eee7a3b218551fbMark McLoughlin root->owner = owner; 13590aa0dc41bfd993491c2344870eee7a3b218551fbMark McLoughlin } 13600aa0dc41bfd993491c2344870eee7a3b218551fbMark McLoughlin#endif 13610aa0dc41bfd993491c2344870eee7a3b218551fbMark McLoughlin 13620aa0dc41bfd993491c2344870eee7a3b218551fbMark McLoughlin return &root->dev; 13630aa0dc41bfd993491c2344870eee7a3b218551fbMark McLoughlin} 13640aa0dc41bfd993491c2344870eee7a3b218551fbMark McLoughlinEXPORT_SYMBOL_GPL(__root_device_register); 13650aa0dc41bfd993491c2344870eee7a3b218551fbMark McLoughlin 13660aa0dc41bfd993491c2344870eee7a3b218551fbMark McLoughlin/** 13670aa0dc41bfd993491c2344870eee7a3b218551fbMark McLoughlin * root_device_unregister - unregister and free a root device 13687cbcf22548df1f1df7c6b0d0bda579b92efca63cRandy Dunlap * @dev: device going away 13690aa0dc41bfd993491c2344870eee7a3b218551fbMark McLoughlin * 13700aa0dc41bfd993491c2344870eee7a3b218551fbMark McLoughlin * This function unregisters and cleans up a device that was created by 13710aa0dc41bfd993491c2344870eee7a3b218551fbMark McLoughlin * root_device_register(). 13720aa0dc41bfd993491c2344870eee7a3b218551fbMark McLoughlin */ 13730aa0dc41bfd993491c2344870eee7a3b218551fbMark McLoughlinvoid root_device_unregister(struct device *dev) 13740aa0dc41bfd993491c2344870eee7a3b218551fbMark McLoughlin{ 13750aa0dc41bfd993491c2344870eee7a3b218551fbMark McLoughlin struct root_device *root = to_root_device(dev); 13760aa0dc41bfd993491c2344870eee7a3b218551fbMark McLoughlin 13770aa0dc41bfd993491c2344870eee7a3b218551fbMark McLoughlin if (root->owner) 13780aa0dc41bfd993491c2344870eee7a3b218551fbMark McLoughlin sysfs_remove_link(&root->dev.kobj, "module"); 13790aa0dc41bfd993491c2344870eee7a3b218551fbMark McLoughlin 13800aa0dc41bfd993491c2344870eee7a3b218551fbMark McLoughlin device_unregister(dev); 13810aa0dc41bfd993491c2344870eee7a3b218551fbMark McLoughlin} 13820aa0dc41bfd993491c2344870eee7a3b218551fbMark McLoughlinEXPORT_SYMBOL_GPL(root_device_unregister); 13830aa0dc41bfd993491c2344870eee7a3b218551fbMark McLoughlin 138423681e479129854305da1da32f7f1eaf635ef22cGreg Kroah-Hartman 138523681e479129854305da1da32f7f1eaf635ef22cGreg Kroah-Hartmanstatic void device_create_release(struct device *dev) 138623681e479129854305da1da32f7f1eaf635ef22cGreg Kroah-Hartman{ 13871e0b2cf933ebf32494eba3f668859ba57f06a951Kay Sievers pr_debug("device: '%s': %s\n", dev_name(dev), __func__); 138823681e479129854305da1da32f7f1eaf635ef22cGreg Kroah-Hartman kfree(dev); 138923681e479129854305da1da32f7f1eaf635ef22cGreg Kroah-Hartman} 139023681e479129854305da1da32f7f1eaf635ef22cGreg Kroah-Hartman 139123681e479129854305da1da32f7f1eaf635ef22cGreg Kroah-Hartman/** 13928882b39421bae317e3ee864edd845e994307ce16Greg Kroah-Hartman * device_create_vargs - creates a device and registers it with sysfs 139342734dafa43e453a8b6769a5ebd3a01ffc1fd116Henrik Kretzschmar * @class: pointer to the struct class that this device should be registered to 139442734dafa43e453a8b6769a5ebd3a01ffc1fd116Henrik Kretzschmar * @parent: pointer to the parent struct device of this new device, if any 139542734dafa43e453a8b6769a5ebd3a01ffc1fd116Henrik Kretzschmar * @devt: the dev_t for the char device to be added 13968882b39421bae317e3ee864edd845e994307ce16Greg Kroah-Hartman * @drvdata: the data to be added to the device for callbacks 139742734dafa43e453a8b6769a5ebd3a01ffc1fd116Henrik Kretzschmar * @fmt: string for the device's name 13988882b39421bae317e3ee864edd845e994307ce16Greg Kroah-Hartman * @args: va_list for the device's name 139942734dafa43e453a8b6769a5ebd3a01ffc1fd116Henrik Kretzschmar * 140042734dafa43e453a8b6769a5ebd3a01ffc1fd116Henrik Kretzschmar * This function can be used by char device classes. A struct device 140142734dafa43e453a8b6769a5ebd3a01ffc1fd116Henrik Kretzschmar * will be created in sysfs, registered to the specified class. 140223681e479129854305da1da32f7f1eaf635ef22cGreg Kroah-Hartman * 140323681e479129854305da1da32f7f1eaf635ef22cGreg Kroah-Hartman * A "dev" file will be created, showing the dev_t for the device, if 140423681e479129854305da1da32f7f1eaf635ef22cGreg Kroah-Hartman * the dev_t is not 0,0. 140542734dafa43e453a8b6769a5ebd3a01ffc1fd116Henrik Kretzschmar * If a pointer to a parent struct device is passed in, the newly created 140642734dafa43e453a8b6769a5ebd3a01ffc1fd116Henrik Kretzschmar * struct device will be a child of that device in sysfs. 140742734dafa43e453a8b6769a5ebd3a01ffc1fd116Henrik Kretzschmar * The pointer to the struct device will be returned from the call. 140842734dafa43e453a8b6769a5ebd3a01ffc1fd116Henrik Kretzschmar * Any further sysfs files that might be required can be created using this 140923681e479129854305da1da32f7f1eaf635ef22cGreg Kroah-Hartman * pointer. 141023681e479129854305da1da32f7f1eaf635ef22cGreg Kroah-Hartman * 141123681e479129854305da1da32f7f1eaf635ef22cGreg Kroah-Hartman * Note: the struct class passed to this function must have previously 141223681e479129854305da1da32f7f1eaf635ef22cGreg Kroah-Hartman * been created with a call to class_create(). 141323681e479129854305da1da32f7f1eaf635ef22cGreg Kroah-Hartman */ 14148882b39421bae317e3ee864edd845e994307ce16Greg Kroah-Hartmanstruct device *device_create_vargs(struct class *class, struct device *parent, 14158882b39421bae317e3ee864edd845e994307ce16Greg Kroah-Hartman dev_t devt, void *drvdata, const char *fmt, 14168882b39421bae317e3ee864edd845e994307ce16Greg Kroah-Hartman va_list args) 141723681e479129854305da1da32f7f1eaf635ef22cGreg Kroah-Hartman{ 141823681e479129854305da1da32f7f1eaf635ef22cGreg Kroah-Hartman struct device *dev = NULL; 141923681e479129854305da1da32f7f1eaf635ef22cGreg Kroah-Hartman int retval = -ENODEV; 142023681e479129854305da1da32f7f1eaf635ef22cGreg Kroah-Hartman 142123681e479129854305da1da32f7f1eaf635ef22cGreg Kroah-Hartman if (class == NULL || IS_ERR(class)) 142223681e479129854305da1da32f7f1eaf635ef22cGreg Kroah-Hartman goto error; 142323681e479129854305da1da32f7f1eaf635ef22cGreg Kroah-Hartman 142423681e479129854305da1da32f7f1eaf635ef22cGreg Kroah-Hartman dev = kzalloc(sizeof(*dev), GFP_KERNEL); 142523681e479129854305da1da32f7f1eaf635ef22cGreg Kroah-Hartman if (!dev) { 142623681e479129854305da1da32f7f1eaf635ef22cGreg Kroah-Hartman retval = -ENOMEM; 142723681e479129854305da1da32f7f1eaf635ef22cGreg Kroah-Hartman goto error; 142823681e479129854305da1da32f7f1eaf635ef22cGreg Kroah-Hartman } 142923681e479129854305da1da32f7f1eaf635ef22cGreg Kroah-Hartman 143023681e479129854305da1da32f7f1eaf635ef22cGreg Kroah-Hartman dev->devt = devt; 143123681e479129854305da1da32f7f1eaf635ef22cGreg Kroah-Hartman dev->class = class; 143223681e479129854305da1da32f7f1eaf635ef22cGreg Kroah-Hartman dev->parent = parent; 143323681e479129854305da1da32f7f1eaf635ef22cGreg Kroah-Hartman dev->release = device_create_release; 14348882b39421bae317e3ee864edd845e994307ce16Greg Kroah-Hartman dev_set_drvdata(dev, drvdata); 143523681e479129854305da1da32f7f1eaf635ef22cGreg Kroah-Hartman 14361fa5ae857bb14f6046205171d98506d8112dd74eKay Sievers retval = kobject_set_name_vargs(&dev->kobj, fmt, args); 14371fa5ae857bb14f6046205171d98506d8112dd74eKay Sievers if (retval) 14381fa5ae857bb14f6046205171d98506d8112dd74eKay Sievers goto error; 14391fa5ae857bb14f6046205171d98506d8112dd74eKay Sievers 144023681e479129854305da1da32f7f1eaf635ef22cGreg Kroah-Hartman retval = device_register(dev); 144123681e479129854305da1da32f7f1eaf635ef22cGreg Kroah-Hartman if (retval) 144223681e479129854305da1da32f7f1eaf635ef22cGreg Kroah-Hartman goto error; 144323681e479129854305da1da32f7f1eaf635ef22cGreg Kroah-Hartman 144423681e479129854305da1da32f7f1eaf635ef22cGreg Kroah-Hartman return dev; 144523681e479129854305da1da32f7f1eaf635ef22cGreg Kroah-Hartman 144623681e479129854305da1da32f7f1eaf635ef22cGreg Kroah-Hartmanerror: 1447286661b3777897220ecfcd774bccc68a34667f39Cornelia Huck put_device(dev); 144823681e479129854305da1da32f7f1eaf635ef22cGreg Kroah-Hartman return ERR_PTR(retval); 144923681e479129854305da1da32f7f1eaf635ef22cGreg Kroah-Hartman} 14508882b39421bae317e3ee864edd845e994307ce16Greg Kroah-HartmanEXPORT_SYMBOL_GPL(device_create_vargs); 14518882b39421bae317e3ee864edd845e994307ce16Greg Kroah-Hartman 14528882b39421bae317e3ee864edd845e994307ce16Greg Kroah-Hartman/** 14534e10673944a5c386378ff9d692ae37e19993f9d5Greg Kroah-Hartman * device_create - creates a device and registers it with sysfs 14548882b39421bae317e3ee864edd845e994307ce16Greg Kroah-Hartman * @class: pointer to the struct class that this device should be registered to 14558882b39421bae317e3ee864edd845e994307ce16Greg Kroah-Hartman * @parent: pointer to the parent struct device of this new device, if any 14568882b39421bae317e3ee864edd845e994307ce16Greg Kroah-Hartman * @devt: the dev_t for the char device to be added 14578882b39421bae317e3ee864edd845e994307ce16Greg Kroah-Hartman * @drvdata: the data to be added to the device for callbacks 14588882b39421bae317e3ee864edd845e994307ce16Greg Kroah-Hartman * @fmt: string for the device's name 14598882b39421bae317e3ee864edd845e994307ce16Greg Kroah-Hartman * 14608882b39421bae317e3ee864edd845e994307ce16Greg Kroah-Hartman * This function can be used by char device classes. A struct device 14618882b39421bae317e3ee864edd845e994307ce16Greg Kroah-Hartman * will be created in sysfs, registered to the specified class. 14628882b39421bae317e3ee864edd845e994307ce16Greg Kroah-Hartman * 14638882b39421bae317e3ee864edd845e994307ce16Greg Kroah-Hartman * A "dev" file will be created, showing the dev_t for the device, if 14648882b39421bae317e3ee864edd845e994307ce16Greg Kroah-Hartman * the dev_t is not 0,0. 14658882b39421bae317e3ee864edd845e994307ce16Greg Kroah-Hartman * If a pointer to a parent struct device is passed in, the newly created 14668882b39421bae317e3ee864edd845e994307ce16Greg Kroah-Hartman * struct device will be a child of that device in sysfs. 14678882b39421bae317e3ee864edd845e994307ce16Greg Kroah-Hartman * The pointer to the struct device will be returned from the call. 14688882b39421bae317e3ee864edd845e994307ce16Greg Kroah-Hartman * Any further sysfs files that might be required can be created using this 14698882b39421bae317e3ee864edd845e994307ce16Greg Kroah-Hartman * pointer. 14708882b39421bae317e3ee864edd845e994307ce16Greg Kroah-Hartman * 14718882b39421bae317e3ee864edd845e994307ce16Greg Kroah-Hartman * Note: the struct class passed to this function must have previously 14728882b39421bae317e3ee864edd845e994307ce16Greg Kroah-Hartman * been created with a call to class_create(). 14738882b39421bae317e3ee864edd845e994307ce16Greg Kroah-Hartman */ 14744e10673944a5c386378ff9d692ae37e19993f9d5Greg Kroah-Hartmanstruct device *device_create(struct class *class, struct device *parent, 14754e10673944a5c386378ff9d692ae37e19993f9d5Greg Kroah-Hartman dev_t devt, void *drvdata, const char *fmt, ...) 14768882b39421bae317e3ee864edd845e994307ce16Greg Kroah-Hartman{ 14778882b39421bae317e3ee864edd845e994307ce16Greg Kroah-Hartman va_list vargs; 14788882b39421bae317e3ee864edd845e994307ce16Greg Kroah-Hartman struct device *dev; 14798882b39421bae317e3ee864edd845e994307ce16Greg Kroah-Hartman 14808882b39421bae317e3ee864edd845e994307ce16Greg Kroah-Hartman va_start(vargs, fmt); 14818882b39421bae317e3ee864edd845e994307ce16Greg Kroah-Hartman dev = device_create_vargs(class, parent, devt, drvdata, fmt, vargs); 14828882b39421bae317e3ee864edd845e994307ce16Greg Kroah-Hartman va_end(vargs); 14838882b39421bae317e3ee864edd845e994307ce16Greg Kroah-Hartman return dev; 14848882b39421bae317e3ee864edd845e994307ce16Greg Kroah-Hartman} 14854e10673944a5c386378ff9d692ae37e19993f9d5Greg Kroah-HartmanEXPORT_SYMBOL_GPL(device_create); 14868882b39421bae317e3ee864edd845e994307ce16Greg Kroah-Hartman 1487cd35449b93ac128282c1f1f720e84c5935f9018eDave Youngstatic int __match_devt(struct device *dev, void *data) 148823681e479129854305da1da32f7f1eaf635ef22cGreg Kroah-Hartman{ 1489cd35449b93ac128282c1f1f720e84c5935f9018eDave Young dev_t *devt = data; 149023681e479129854305da1da32f7f1eaf635ef22cGreg Kroah-Hartman 1491cd35449b93ac128282c1f1f720e84c5935f9018eDave Young return dev->devt == *devt; 1492775b64d2b6ca37697de925f70799c710aab5849aRafael J. Wysocki} 1493775b64d2b6ca37697de925f70799c710aab5849aRafael J. Wysocki 1494775b64d2b6ca37697de925f70799c710aab5849aRafael J. Wysocki/** 1495775b64d2b6ca37697de925f70799c710aab5849aRafael J. Wysocki * device_destroy - removes a device that was created with device_create() 1496775b64d2b6ca37697de925f70799c710aab5849aRafael J. Wysocki * @class: pointer to the struct class that this device was registered with 1497775b64d2b6ca37697de925f70799c710aab5849aRafael J. Wysocki * @devt: the dev_t of the device that was previously registered 1498775b64d2b6ca37697de925f70799c710aab5849aRafael J. Wysocki * 1499775b64d2b6ca37697de925f70799c710aab5849aRafael J. Wysocki * This call unregisters and cleans up a device that was created with a 1500775b64d2b6ca37697de925f70799c710aab5849aRafael J. Wysocki * call to device_create(). 1501775b64d2b6ca37697de925f70799c710aab5849aRafael J. Wysocki */ 1502775b64d2b6ca37697de925f70799c710aab5849aRafael J. Wysockivoid device_destroy(struct class *class, dev_t devt) 1503775b64d2b6ca37697de925f70799c710aab5849aRafael J. Wysocki{ 1504775b64d2b6ca37697de925f70799c710aab5849aRafael J. Wysocki struct device *dev; 150523681e479129854305da1da32f7f1eaf635ef22cGreg Kroah-Hartman 1506695794ae0c5bdd9bd06e35b118801e2e9be04f9eGreg Kroah-Hartman dev = class_find_device(class, NULL, &devt, __match_devt); 1507cd35449b93ac128282c1f1f720e84c5935f9018eDave Young if (dev) { 1508cd35449b93ac128282c1f1f720e84c5935f9018eDave Young put_device(dev); 150923681e479129854305da1da32f7f1eaf635ef22cGreg Kroah-Hartman device_unregister(dev); 1510cd35449b93ac128282c1f1f720e84c5935f9018eDave Young } 151123681e479129854305da1da32f7f1eaf635ef22cGreg Kroah-Hartman} 151223681e479129854305da1da32f7f1eaf635ef22cGreg Kroah-HartmanEXPORT_SYMBOL_GPL(device_destroy); 1513a2de48cace5d0993da6cfa28b276ae724dc3569bGreg Kroah-Hartman 1514a2de48cace5d0993da6cfa28b276ae724dc3569bGreg Kroah-Hartman/** 1515a2de48cace5d0993da6cfa28b276ae724dc3569bGreg Kroah-Hartman * device_rename - renames a device 1516a2de48cace5d0993da6cfa28b276ae724dc3569bGreg Kroah-Hartman * @dev: the pointer to the struct device to be renamed 1517a2de48cace5d0993da6cfa28b276ae724dc3569bGreg Kroah-Hartman * @new_name: the new name of the device 1518030c1d2bfcc2187650fb975456ca0b61a5bb77f4Eric W. Biederman * 1519030c1d2bfcc2187650fb975456ca0b61a5bb77f4Eric W. Biederman * It is the responsibility of the caller to provide mutual 1520030c1d2bfcc2187650fb975456ca0b61a5bb77f4Eric W. Biederman * exclusion between two different calls of device_rename 1521030c1d2bfcc2187650fb975456ca0b61a5bb77f4Eric W. Biederman * on the same device to ensure that new_name is valid and 1522030c1d2bfcc2187650fb975456ca0b61a5bb77f4Eric W. Biederman * won't conflict with other devices. 1523a2de48cace5d0993da6cfa28b276ae724dc3569bGreg Kroah-Hartman */ 1524a2de48cace5d0993da6cfa28b276ae724dc3569bGreg Kroah-Hartmanint device_rename(struct device *dev, char *new_name) 1525a2de48cace5d0993da6cfa28b276ae724dc3569bGreg Kroah-Hartman{ 1526a2de48cace5d0993da6cfa28b276ae724dc3569bGreg Kroah-Hartman char *old_class_name = NULL; 1527a2de48cace5d0993da6cfa28b276ae724dc3569bGreg Kroah-Hartman char *new_class_name = NULL; 15282ee97caf0a6602f749ddbfdb1449e383e1212707Cornelia Huck char *old_device_name = NULL; 1529a2de48cace5d0993da6cfa28b276ae724dc3569bGreg Kroah-Hartman int error; 1530a2de48cace5d0993da6cfa28b276ae724dc3569bGreg Kroah-Hartman 1531a2de48cace5d0993da6cfa28b276ae724dc3569bGreg Kroah-Hartman dev = get_device(dev); 1532a2de48cace5d0993da6cfa28b276ae724dc3569bGreg Kroah-Hartman if (!dev) 1533a2de48cace5d0993da6cfa28b276ae724dc3569bGreg Kroah-Hartman return -EINVAL; 1534a2de48cace5d0993da6cfa28b276ae724dc3569bGreg Kroah-Hartman 15351e0b2cf933ebf32494eba3f668859ba57f06a951Kay Sievers pr_debug("device: '%s': %s: renaming to '%s'\n", dev_name(dev), 15362b3a302a09735276e13421db56c20045a48eb06dHarvey Harrison __func__, new_name); 1537a2de48cace5d0993da6cfa28b276ae724dc3569bGreg Kroah-Hartman 153899ef3ef8d5f2f5b5312627127ad63df27c0d0d05Kay Sievers#ifdef CONFIG_SYSFS_DEPRECATED 1539a2de48cace5d0993da6cfa28b276ae724dc3569bGreg Kroah-Hartman if ((dev->class) && (dev->parent)) 1540a2de48cace5d0993da6cfa28b276ae724dc3569bGreg Kroah-Hartman old_class_name = make_class_name(dev->class->name, &dev->kobj); 154199ef3ef8d5f2f5b5312627127ad63df27c0d0d05Kay Sievers#endif 1542a2de48cace5d0993da6cfa28b276ae724dc3569bGreg Kroah-Hartman 15431fa5ae857bb14f6046205171d98506d8112dd74eKay Sievers old_device_name = kstrdup(dev_name(dev), GFP_KERNEL); 15442ee97caf0a6602f749ddbfdb1449e383e1212707Cornelia Huck if (!old_device_name) { 15452ee97caf0a6602f749ddbfdb1449e383e1212707Cornelia Huck error = -ENOMEM; 15462ee97caf0a6602f749ddbfdb1449e383e1212707Cornelia Huck goto out; 1547a2de48cace5d0993da6cfa28b276ae724dc3569bGreg Kroah-Hartman } 1548a2de48cace5d0993da6cfa28b276ae724dc3569bGreg Kroah-Hartman 1549a2de48cace5d0993da6cfa28b276ae724dc3569bGreg Kroah-Hartman error = kobject_rename(&dev->kobj, new_name); 15501fa5ae857bb14f6046205171d98506d8112dd74eKay Sievers if (error) 15512ee97caf0a6602f749ddbfdb1449e383e1212707Cornelia Huck goto out; 1552a2de48cace5d0993da6cfa28b276ae724dc3569bGreg Kroah-Hartman 155399ef3ef8d5f2f5b5312627127ad63df27c0d0d05Kay Sievers#ifdef CONFIG_SYSFS_DEPRECATED 1554a2de48cace5d0993da6cfa28b276ae724dc3569bGreg Kroah-Hartman if (old_class_name) { 1555a2de48cace5d0993da6cfa28b276ae724dc3569bGreg Kroah-Hartman new_class_name = make_class_name(dev->class->name, &dev->kobj); 1556a2de48cace5d0993da6cfa28b276ae724dc3569bGreg Kroah-Hartman if (new_class_name) { 155736ce6dad6e3cb3f050ed41e0beac0070d2062b25Cornelia Huck error = sysfs_create_link_nowarn(&dev->parent->kobj, 155836ce6dad6e3cb3f050ed41e0beac0070d2062b25Cornelia Huck &dev->kobj, 155936ce6dad6e3cb3f050ed41e0beac0070d2062b25Cornelia Huck new_class_name); 15602ee97caf0a6602f749ddbfdb1449e383e1212707Cornelia Huck if (error) 15612ee97caf0a6602f749ddbfdb1449e383e1212707Cornelia Huck goto out; 1562a2de48cace5d0993da6cfa28b276ae724dc3569bGreg Kroah-Hartman sysfs_remove_link(&dev->parent->kobj, old_class_name); 1563a2de48cace5d0993da6cfa28b276ae724dc3569bGreg Kroah-Hartman } 1564a2de48cace5d0993da6cfa28b276ae724dc3569bGreg Kroah-Hartman } 156560b8cabd8e8a1d266aa8778957691cd925673083Kay Sievers#else 1566a2de48cace5d0993da6cfa28b276ae724dc3569bGreg Kroah-Hartman if (dev->class) { 156736ce6dad6e3cb3f050ed41e0beac0070d2062b25Cornelia Huck error = sysfs_create_link_nowarn(&dev->class->p->class_subsys.kobj, 15681e0b2cf933ebf32494eba3f668859ba57f06a951Kay Sievers &dev->kobj, dev_name(dev)); 15690599ad53fee2d084f9ba26247d7452f06a40d298Stephen Hemminger if (error) 15700599ad53fee2d084f9ba26247d7452f06a40d298Stephen Hemminger goto out; 15711fbfee6c6dc0f4a4c587b6b163ee79643fc9aaa7Greg Kroah-Hartman sysfs_remove_link(&dev->class->p->class_subsys.kobj, 15727c71448b8aa80123fc521563d5f7c63a099d97abGreg Kroah-Hartman old_device_name); 1573a2de48cace5d0993da6cfa28b276ae724dc3569bGreg Kroah-Hartman } 157460b8cabd8e8a1d266aa8778957691cd925673083Kay Sievers#endif 157560b8cabd8e8a1d266aa8778957691cd925673083Kay Sievers 15762ee97caf0a6602f749ddbfdb1449e383e1212707Cornelia Huckout: 1577a2de48cace5d0993da6cfa28b276ae724dc3569bGreg Kroah-Hartman put_device(dev); 1578a2de48cace5d0993da6cfa28b276ae724dc3569bGreg Kroah-Hartman 1579a2de48cace5d0993da6cfa28b276ae724dc3569bGreg Kroah-Hartman kfree(new_class_name); 1580952ab431cd36c7ab573f685af8679c3677cbdc29Jesper Juhl kfree(old_class_name); 15812ee97caf0a6602f749ddbfdb1449e383e1212707Cornelia Huck kfree(old_device_name); 1582a2de48cace5d0993da6cfa28b276ae724dc3569bGreg Kroah-Hartman 1583a2de48cace5d0993da6cfa28b276ae724dc3569bGreg Kroah-Hartman return error; 1584a2de48cace5d0993da6cfa28b276ae724dc3569bGreg Kroah-Hartman} 1585a2807dbcbd681e1f36e813fb26e2f24d15018b91Johannes BergEXPORT_SYMBOL_GPL(device_rename); 15868a82472f86bf693b8e91ed56c9ca4f62fbbdcfa3Cornelia Huck 15878a82472f86bf693b8e91ed56c9ca4f62fbbdcfa3Cornelia Huckstatic int device_move_class_links(struct device *dev, 15888a82472f86bf693b8e91ed56c9ca4f62fbbdcfa3Cornelia Huck struct device *old_parent, 15898a82472f86bf693b8e91ed56c9ca4f62fbbdcfa3Cornelia Huck struct device *new_parent) 15908a82472f86bf693b8e91ed56c9ca4f62fbbdcfa3Cornelia Huck{ 1591f7f3461d87536bed52bb83bc8fbe6bfd28619fb1Greg Kroah-Hartman int error = 0; 15928a82472f86bf693b8e91ed56c9ca4f62fbbdcfa3Cornelia Huck#ifdef CONFIG_SYSFS_DEPRECATED 15938a82472f86bf693b8e91ed56c9ca4f62fbbdcfa3Cornelia Huck char *class_name; 15948a82472f86bf693b8e91ed56c9ca4f62fbbdcfa3Cornelia Huck 15958a82472f86bf693b8e91ed56c9ca4f62fbbdcfa3Cornelia Huck class_name = make_class_name(dev->class->name, &dev->kobj); 15968a82472f86bf693b8e91ed56c9ca4f62fbbdcfa3Cornelia Huck if (!class_name) { 1597cb360bbf6352712310a7528137919c626a782744Cornelia Huck error = -ENOMEM; 15988a82472f86bf693b8e91ed56c9ca4f62fbbdcfa3Cornelia Huck goto out; 15998a82472f86bf693b8e91ed56c9ca4f62fbbdcfa3Cornelia Huck } 16008a82472f86bf693b8e91ed56c9ca4f62fbbdcfa3Cornelia Huck if (old_parent) { 16018a82472f86bf693b8e91ed56c9ca4f62fbbdcfa3Cornelia Huck sysfs_remove_link(&dev->kobj, "device"); 16028a82472f86bf693b8e91ed56c9ca4f62fbbdcfa3Cornelia Huck sysfs_remove_link(&old_parent->kobj, class_name); 16038a82472f86bf693b8e91ed56c9ca4f62fbbdcfa3Cornelia Huck } 1604c744aeae9d173a953b771a7ad5c872f91fa99decCornelia Huck if (new_parent) { 1605c744aeae9d173a953b771a7ad5c872f91fa99decCornelia Huck error = sysfs_create_link(&dev->kobj, &new_parent->kobj, 1606c744aeae9d173a953b771a7ad5c872f91fa99decCornelia Huck "device"); 1607c744aeae9d173a953b771a7ad5c872f91fa99decCornelia Huck if (error) 1608c744aeae9d173a953b771a7ad5c872f91fa99decCornelia Huck goto out; 1609c744aeae9d173a953b771a7ad5c872f91fa99decCornelia Huck error = sysfs_create_link(&new_parent->kobj, &dev->kobj, 1610c744aeae9d173a953b771a7ad5c872f91fa99decCornelia Huck class_name); 1611c744aeae9d173a953b771a7ad5c872f91fa99decCornelia Huck if (error) 1612c744aeae9d173a953b771a7ad5c872f91fa99decCornelia Huck sysfs_remove_link(&dev->kobj, "device"); 16134a3ad20ccd8f4d2a0535cf98fa83f7b561ba59a9Greg Kroah-Hartman } else 1614c744aeae9d173a953b771a7ad5c872f91fa99decCornelia Huck error = 0; 16158a82472f86bf693b8e91ed56c9ca4f62fbbdcfa3Cornelia Huckout: 16168a82472f86bf693b8e91ed56c9ca4f62fbbdcfa3Cornelia Huck kfree(class_name); 16178a82472f86bf693b8e91ed56c9ca4f62fbbdcfa3Cornelia Huck return error; 16188a82472f86bf693b8e91ed56c9ca4f62fbbdcfa3Cornelia Huck#else 1619f7f3461d87536bed52bb83bc8fbe6bfd28619fb1Greg Kroah-Hartman if (old_parent) 1620f7f3461d87536bed52bb83bc8fbe6bfd28619fb1Greg Kroah-Hartman sysfs_remove_link(&dev->kobj, "device"); 1621f7f3461d87536bed52bb83bc8fbe6bfd28619fb1Greg Kroah-Hartman if (new_parent) 1622f7f3461d87536bed52bb83bc8fbe6bfd28619fb1Greg Kroah-Hartman error = sysfs_create_link(&dev->kobj, &new_parent->kobj, 1623f7f3461d87536bed52bb83bc8fbe6bfd28619fb1Greg Kroah-Hartman "device"); 1624f7f3461d87536bed52bb83bc8fbe6bfd28619fb1Greg Kroah-Hartman return error; 16258a82472f86bf693b8e91ed56c9ca4f62fbbdcfa3Cornelia Huck#endif 16268a82472f86bf693b8e91ed56c9ca4f62fbbdcfa3Cornelia Huck} 16278a82472f86bf693b8e91ed56c9ca4f62fbbdcfa3Cornelia Huck 16288a82472f86bf693b8e91ed56c9ca4f62fbbdcfa3Cornelia Huck/** 16298a82472f86bf693b8e91ed56c9ca4f62fbbdcfa3Cornelia Huck * device_move - moves a device to a new parent 16308a82472f86bf693b8e91ed56c9ca4f62fbbdcfa3Cornelia Huck * @dev: the pointer to the struct device to be moved 1631c744aeae9d173a953b771a7ad5c872f91fa99decCornelia Huck * @new_parent: the new parent of the device (can by NULL) 1632ffa6a7054d172a2f57248dff2de600ca795c5656Cornelia Huck * @dpm_order: how to reorder the dpm_list 16338a82472f86bf693b8e91ed56c9ca4f62fbbdcfa3Cornelia Huck */ 1634ffa6a7054d172a2f57248dff2de600ca795c5656Cornelia Huckint device_move(struct device *dev, struct device *new_parent, 1635ffa6a7054d172a2f57248dff2de600ca795c5656Cornelia Huck enum dpm_order dpm_order) 16368a82472f86bf693b8e91ed56c9ca4f62fbbdcfa3Cornelia Huck{ 16378a82472f86bf693b8e91ed56c9ca4f62fbbdcfa3Cornelia Huck int error; 16388a82472f86bf693b8e91ed56c9ca4f62fbbdcfa3Cornelia Huck struct device *old_parent; 1639c744aeae9d173a953b771a7ad5c872f91fa99decCornelia Huck struct kobject *new_parent_kobj; 16408a82472f86bf693b8e91ed56c9ca4f62fbbdcfa3Cornelia Huck 16418a82472f86bf693b8e91ed56c9ca4f62fbbdcfa3Cornelia Huck dev = get_device(dev); 16428a82472f86bf693b8e91ed56c9ca4f62fbbdcfa3Cornelia Huck if (!dev) 16438a82472f86bf693b8e91ed56c9ca4f62fbbdcfa3Cornelia Huck return -EINVAL; 16448a82472f86bf693b8e91ed56c9ca4f62fbbdcfa3Cornelia Huck 1645ffa6a7054d172a2f57248dff2de600ca795c5656Cornelia Huck device_pm_lock(); 16468a82472f86bf693b8e91ed56c9ca4f62fbbdcfa3Cornelia Huck new_parent = get_device(new_parent); 16474a3ad20ccd8f4d2a0535cf98fa83f7b561ba59a9Greg Kroah-Hartman new_parent_kobj = get_device_parent(dev, new_parent); 164863b6971a0876b744e2fcf3c9df15d130501e1debCornelia Huck 16491e0b2cf933ebf32494eba3f668859ba57f06a951Kay Sievers pr_debug("device: '%s': %s: moving to '%s'\n", dev_name(dev), 16501e0b2cf933ebf32494eba3f668859ba57f06a951Kay Sievers __func__, new_parent ? dev_name(new_parent) : "<NULL>"); 1651c744aeae9d173a953b771a7ad5c872f91fa99decCornelia Huck error = kobject_move(&dev->kobj, new_parent_kobj); 16528a82472f86bf693b8e91ed56c9ca4f62fbbdcfa3Cornelia Huck if (error) { 165363b6971a0876b744e2fcf3c9df15d130501e1debCornelia Huck cleanup_glue_dir(dev, new_parent_kobj); 16548a82472f86bf693b8e91ed56c9ca4f62fbbdcfa3Cornelia Huck put_device(new_parent); 16558a82472f86bf693b8e91ed56c9ca4f62fbbdcfa3Cornelia Huck goto out; 16568a82472f86bf693b8e91ed56c9ca4f62fbbdcfa3Cornelia Huck } 16578a82472f86bf693b8e91ed56c9ca4f62fbbdcfa3Cornelia Huck old_parent = dev->parent; 16588a82472f86bf693b8e91ed56c9ca4f62fbbdcfa3Cornelia Huck dev->parent = new_parent; 16598a82472f86bf693b8e91ed56c9ca4f62fbbdcfa3Cornelia Huck if (old_parent) 1660f791b8c836307b58cbf62133a6a772ed1a92fb33Greg Kroah-Hartman klist_remove(&dev->p->knode_parent); 16610d358f22f6c8f03ab215eee8d52b74f78cc3c7dbYinghai Lu if (new_parent) { 1662f791b8c836307b58cbf62133a6a772ed1a92fb33Greg Kroah-Hartman klist_add_tail(&dev->p->knode_parent, 1663f791b8c836307b58cbf62133a6a772ed1a92fb33Greg Kroah-Hartman &new_parent->p->klist_children); 16640d358f22f6c8f03ab215eee8d52b74f78cc3c7dbYinghai Lu set_dev_node(dev, dev_to_node(new_parent)); 16650d358f22f6c8f03ab215eee8d52b74f78cc3c7dbYinghai Lu } 16660d358f22f6c8f03ab215eee8d52b74f78cc3c7dbYinghai Lu 16678a82472f86bf693b8e91ed56c9ca4f62fbbdcfa3Cornelia Huck if (!dev->class) 16688a82472f86bf693b8e91ed56c9ca4f62fbbdcfa3Cornelia Huck goto out_put; 16698a82472f86bf693b8e91ed56c9ca4f62fbbdcfa3Cornelia Huck error = device_move_class_links(dev, old_parent, new_parent); 16708a82472f86bf693b8e91ed56c9ca4f62fbbdcfa3Cornelia Huck if (error) { 16718a82472f86bf693b8e91ed56c9ca4f62fbbdcfa3Cornelia Huck /* We ignore errors on cleanup since we're hosed anyway... */ 16728a82472f86bf693b8e91ed56c9ca4f62fbbdcfa3Cornelia Huck device_move_class_links(dev, new_parent, old_parent); 16738a82472f86bf693b8e91ed56c9ca4f62fbbdcfa3Cornelia Huck if (!kobject_move(&dev->kobj, &old_parent->kobj)) { 1674c744aeae9d173a953b771a7ad5c872f91fa99decCornelia Huck if (new_parent) 1675f791b8c836307b58cbf62133a6a772ed1a92fb33Greg Kroah-Hartman klist_remove(&dev->p->knode_parent); 16760d358f22f6c8f03ab215eee8d52b74f78cc3c7dbYinghai Lu dev->parent = old_parent; 16770d358f22f6c8f03ab215eee8d52b74f78cc3c7dbYinghai Lu if (old_parent) { 1678f791b8c836307b58cbf62133a6a772ed1a92fb33Greg Kroah-Hartman klist_add_tail(&dev->p->knode_parent, 1679f791b8c836307b58cbf62133a6a772ed1a92fb33Greg Kroah-Hartman &old_parent->p->klist_children); 16800d358f22f6c8f03ab215eee8d52b74f78cc3c7dbYinghai Lu set_dev_node(dev, dev_to_node(old_parent)); 16810d358f22f6c8f03ab215eee8d52b74f78cc3c7dbYinghai Lu } 16828a82472f86bf693b8e91ed56c9ca4f62fbbdcfa3Cornelia Huck } 168363b6971a0876b744e2fcf3c9df15d130501e1debCornelia Huck cleanup_glue_dir(dev, new_parent_kobj); 16848a82472f86bf693b8e91ed56c9ca4f62fbbdcfa3Cornelia Huck put_device(new_parent); 16858a82472f86bf693b8e91ed56c9ca4f62fbbdcfa3Cornelia Huck goto out; 16868a82472f86bf693b8e91ed56c9ca4f62fbbdcfa3Cornelia Huck } 1687ffa6a7054d172a2f57248dff2de600ca795c5656Cornelia Huck switch (dpm_order) { 1688ffa6a7054d172a2f57248dff2de600ca795c5656Cornelia Huck case DPM_ORDER_NONE: 1689ffa6a7054d172a2f57248dff2de600ca795c5656Cornelia Huck break; 1690ffa6a7054d172a2f57248dff2de600ca795c5656Cornelia Huck case DPM_ORDER_DEV_AFTER_PARENT: 1691ffa6a7054d172a2f57248dff2de600ca795c5656Cornelia Huck device_pm_move_after(dev, new_parent); 1692ffa6a7054d172a2f57248dff2de600ca795c5656Cornelia Huck break; 1693ffa6a7054d172a2f57248dff2de600ca795c5656Cornelia Huck case DPM_ORDER_PARENT_BEFORE_DEV: 1694ffa6a7054d172a2f57248dff2de600ca795c5656Cornelia Huck device_pm_move_before(new_parent, dev); 1695ffa6a7054d172a2f57248dff2de600ca795c5656Cornelia Huck break; 1696ffa6a7054d172a2f57248dff2de600ca795c5656Cornelia Huck case DPM_ORDER_DEV_LAST: 1697ffa6a7054d172a2f57248dff2de600ca795c5656Cornelia Huck device_pm_move_last(dev); 1698ffa6a7054d172a2f57248dff2de600ca795c5656Cornelia Huck break; 1699ffa6a7054d172a2f57248dff2de600ca795c5656Cornelia Huck } 17008a82472f86bf693b8e91ed56c9ca4f62fbbdcfa3Cornelia Huckout_put: 17018a82472f86bf693b8e91ed56c9ca4f62fbbdcfa3Cornelia Huck put_device(old_parent); 17028a82472f86bf693b8e91ed56c9ca4f62fbbdcfa3Cornelia Huckout: 1703ffa6a7054d172a2f57248dff2de600ca795c5656Cornelia Huck device_pm_unlock(); 17048a82472f86bf693b8e91ed56c9ca4f62fbbdcfa3Cornelia Huck put_device(dev); 17058a82472f86bf693b8e91ed56c9ca4f62fbbdcfa3Cornelia Huck return error; 17068a82472f86bf693b8e91ed56c9ca4f62fbbdcfa3Cornelia Huck} 17078a82472f86bf693b8e91ed56c9ca4f62fbbdcfa3Cornelia HuckEXPORT_SYMBOL_GPL(device_move); 170837b0c020343080241984d978981d6caf877b278aGreg Kroah-Hartman 170937b0c020343080241984d978981d6caf877b278aGreg Kroah-Hartman/** 171037b0c020343080241984d978981d6caf877b278aGreg Kroah-Hartman * device_shutdown - call ->shutdown() on each device to shutdown. 171137b0c020343080241984d978981d6caf877b278aGreg Kroah-Hartman */ 171237b0c020343080241984d978981d6caf877b278aGreg Kroah-Hartmanvoid device_shutdown(void) 171337b0c020343080241984d978981d6caf877b278aGreg Kroah-Hartman{ 17144a3ad20ccd8f4d2a0535cf98fa83f7b561ba59a9Greg Kroah-Hartman struct device *dev, *devn; 171537b0c020343080241984d978981d6caf877b278aGreg Kroah-Hartman 171637b0c020343080241984d978981d6caf877b278aGreg Kroah-Hartman list_for_each_entry_safe_reverse(dev, devn, &devices_kset->list, 171737b0c020343080241984d978981d6caf877b278aGreg Kroah-Hartman kobj.entry) { 171837b0c020343080241984d978981d6caf877b278aGreg Kroah-Hartman if (dev->bus && dev->bus->shutdown) { 171937b0c020343080241984d978981d6caf877b278aGreg Kroah-Hartman dev_dbg(dev, "shutdown\n"); 172037b0c020343080241984d978981d6caf877b278aGreg Kroah-Hartman dev->bus->shutdown(dev); 172137b0c020343080241984d978981d6caf877b278aGreg Kroah-Hartman } else if (dev->driver && dev->driver->shutdown) { 172237b0c020343080241984d978981d6caf877b278aGreg Kroah-Hartman dev_dbg(dev, "shutdown\n"); 172337b0c020343080241984d978981d6caf877b278aGreg Kroah-Hartman dev->driver->shutdown(dev); 172437b0c020343080241984d978981d6caf877b278aGreg Kroah-Hartman } 172537b0c020343080241984d978981d6caf877b278aGreg Kroah-Hartman } 1726e105b8bfc769b0545b6f0f395179d1e43cbee822Dan Williams kobject_put(sysfs_dev_char_kobj); 1727e105b8bfc769b0545b6f0f395179d1e43cbee822Dan Williams kobject_put(sysfs_dev_block_kobj); 1728e105b8bfc769b0545b6f0f395179d1e43cbee822Dan Williams kobject_put(dev_kobj); 1729401097ea4b89846d66ac78f7f108d49c2e922d9cShaohua Li async_synchronize_full(); 173037b0c020343080241984d978981d6caf877b278aGreg Kroah-Hartman} 1731