core.c revision acc0e90fbccbc6e4d48184cba0983ea044e131af
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 16523681e479129854305da1da32f7f1eaf635ef22cGreg Kroah-Hartman /* add the major/minor if present */ 16623681e479129854305da1da32f7f1eaf635ef22cGreg Kroah-Hartman if (MAJOR(dev->devt)) { 1677eff2e7a8b65c25920207324e56611150eb1cd9aKay Sievers add_uevent_var(env, "MAJOR=%u", MAJOR(dev->devt)); 1687eff2e7a8b65c25920207324e56611150eb1cd9aKay Sievers add_uevent_var(env, "MINOR=%u", MINOR(dev->devt)); 16923681e479129854305da1da32f7f1eaf635ef22cGreg Kroah-Hartman } 17023681e479129854305da1da32f7f1eaf635ef22cGreg Kroah-Hartman 171414264f959cf46f49f974b3510400e12ac3624a6Kay Sievers if (dev->type && dev->type->name) 1727eff2e7a8b65c25920207324e56611150eb1cd9aKay Sievers add_uevent_var(env, "DEVTYPE=%s", dev->type->name); 173414264f959cf46f49f974b3510400e12ac3624a6Kay Sievers 174239378f16aa1ab5c502e42a06359d2de4f88ebb4Kay Sievers if (dev->driver) 1757eff2e7a8b65c25920207324e56611150eb1cd9aKay Sievers add_uevent_var(env, "DRIVER=%s", dev->driver->name); 176239378f16aa1ab5c502e42a06359d2de4f88ebb4Kay Sievers 177a87cb2ac4a78c590583b52a3ed196adc6c25b6c9Kay Sievers#ifdef CONFIG_SYSFS_DEPRECATED 178239378f16aa1ab5c502e42a06359d2de4f88ebb4Kay Sievers if (dev->class) { 179239378f16aa1ab5c502e42a06359d2de4f88ebb4Kay Sievers struct device *parent = dev->parent; 180239378f16aa1ab5c502e42a06359d2de4f88ebb4Kay Sievers 181239378f16aa1ab5c502e42a06359d2de4f88ebb4Kay Sievers /* find first bus device in parent chain */ 182239378f16aa1ab5c502e42a06359d2de4f88ebb4Kay Sievers while (parent && !parent->bus) 183239378f16aa1ab5c502e42a06359d2de4f88ebb4Kay Sievers parent = parent->parent; 184239378f16aa1ab5c502e42a06359d2de4f88ebb4Kay Sievers if (parent && parent->bus) { 185239378f16aa1ab5c502e42a06359d2de4f88ebb4Kay Sievers const char *path; 186239378f16aa1ab5c502e42a06359d2de4f88ebb4Kay Sievers 187239378f16aa1ab5c502e42a06359d2de4f88ebb4Kay Sievers path = kobject_get_path(&parent->kobj, GFP_KERNEL); 1882c7afd125cc482dbdf6b0a169c42337e7e76cda5Kay Sievers if (path) { 1897eff2e7a8b65c25920207324e56611150eb1cd9aKay Sievers add_uevent_var(env, "PHYSDEVPATH=%s", path); 1902c7afd125cc482dbdf6b0a169c42337e7e76cda5Kay Sievers kfree(path); 1912c7afd125cc482dbdf6b0a169c42337e7e76cda5Kay Sievers } 192239378f16aa1ab5c502e42a06359d2de4f88ebb4Kay Sievers 1937eff2e7a8b65c25920207324e56611150eb1cd9aKay Sievers add_uevent_var(env, "PHYSDEVBUS=%s", parent->bus->name); 194239378f16aa1ab5c502e42a06359d2de4f88ebb4Kay Sievers 195239378f16aa1ab5c502e42a06359d2de4f88ebb4Kay Sievers if (parent->driver) 1967eff2e7a8b65c25920207324e56611150eb1cd9aKay Sievers add_uevent_var(env, "PHYSDEVDRIVER=%s", 1977eff2e7a8b65c25920207324e56611150eb1cd9aKay Sievers parent->driver->name); 198239378f16aa1ab5c502e42a06359d2de4f88ebb4Kay Sievers } 199239378f16aa1ab5c502e42a06359d2de4f88ebb4Kay Sievers } else if (dev->bus) { 2007eff2e7a8b65c25920207324e56611150eb1cd9aKay Sievers add_uevent_var(env, "PHYSDEVBUS=%s", dev->bus->name); 201239378f16aa1ab5c502e42a06359d2de4f88ebb4Kay Sievers 202239378f16aa1ab5c502e42a06359d2de4f88ebb4Kay Sievers if (dev->driver) 2034a3ad20ccd8f4d2a0535cf98fa83f7b561ba59a9Greg Kroah-Hartman add_uevent_var(env, "PHYSDEVDRIVER=%s", 2044a3ad20ccd8f4d2a0535cf98fa83f7b561ba59a9Greg Kroah-Hartman dev->driver->name); 205d81d9d6b9f7d0af7d4341951d48d296681878f7aKay Sievers } 206239378f16aa1ab5c502e42a06359d2de4f88ebb4Kay Sievers#endif 2071da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds 2087eff2e7a8b65c25920207324e56611150eb1cd9aKay Sievers /* have the bus specific function add its stuff */ 209312c004d36ce6c739512bac83b452f4c20ab1f62Kay Sievers if (dev->bus && dev->bus->uevent) { 2107eff2e7a8b65c25920207324e56611150eb1cd9aKay Sievers retval = dev->bus->uevent(dev, env); 211f9f852df2faf76a2667949ddb4947d4b8f99f02fKay Sievers if (retval) 2127dc72b2842381684b864750af31a5fb168dec764Greg Kroah-Hartman pr_debug("device: '%s': %s: bus uevent() returned %d\n", 2131e0b2cf933ebf32494eba3f668859ba57f06a951Kay Sievers dev_name(dev), __func__, retval); 2141da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds } 2151da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds 2167eff2e7a8b65c25920207324e56611150eb1cd9aKay Sievers /* have the class specific function add its stuff */ 2172620efef7029bb040430f50f0fc148f2d5e002adGreg Kroah-Hartman if (dev->class && dev->class->dev_uevent) { 2187eff2e7a8b65c25920207324e56611150eb1cd9aKay Sievers retval = dev->class->dev_uevent(dev, env); 219f9f852df2faf76a2667949ddb4947d4b8f99f02fKay Sievers if (retval) 2207dc72b2842381684b864750af31a5fb168dec764Greg Kroah-Hartman pr_debug("device: '%s': %s: class uevent() " 2211e0b2cf933ebf32494eba3f668859ba57f06a951Kay Sievers "returned %d\n", dev_name(dev), 2222b3a302a09735276e13421db56c20045a48eb06dHarvey Harrison __func__, retval); 223f9f852df2faf76a2667949ddb4947d4b8f99f02fKay Sievers } 224f9f852df2faf76a2667949ddb4947d4b8f99f02fKay Sievers 2257eff2e7a8b65c25920207324e56611150eb1cd9aKay Sievers /* have the device type specific fuction add its stuff */ 226f9f852df2faf76a2667949ddb4947d4b8f99f02fKay Sievers if (dev->type && dev->type->uevent) { 2277eff2e7a8b65c25920207324e56611150eb1cd9aKay Sievers retval = dev->type->uevent(dev, env); 228f9f852df2faf76a2667949ddb4947d4b8f99f02fKay Sievers if (retval) 2297dc72b2842381684b864750af31a5fb168dec764Greg Kroah-Hartman pr_debug("device: '%s': %s: dev_type uevent() " 2301e0b2cf933ebf32494eba3f668859ba57f06a951Kay Sievers "returned %d\n", dev_name(dev), 2312b3a302a09735276e13421db56c20045a48eb06dHarvey Harrison __func__, retval); 2322620efef7029bb040430f50f0fc148f2d5e002adGreg Kroah-Hartman } 2332620efef7029bb040430f50f0fc148f2d5e002adGreg Kroah-Hartman 2341da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds return retval; 2351da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds} 2361da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds 237312c004d36ce6c739512bac83b452f4c20ab1f62Kay Sieversstatic struct kset_uevent_ops device_uevent_ops = { 238312c004d36ce6c739512bac83b452f4c20ab1f62Kay Sievers .filter = dev_uevent_filter, 239312c004d36ce6c739512bac83b452f4c20ab1f62Kay Sievers .name = dev_uevent_name, 240312c004d36ce6c739512bac83b452f4c20ab1f62Kay Sievers .uevent = dev_uevent, 2411da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds}; 2421da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds 24316574dccd8f62dc1b585325f8a6a0aab10047ed8Kay Sieversstatic ssize_t show_uevent(struct device *dev, struct device_attribute *attr, 24416574dccd8f62dc1b585325f8a6a0aab10047ed8Kay Sievers char *buf) 24516574dccd8f62dc1b585325f8a6a0aab10047ed8Kay Sievers{ 24616574dccd8f62dc1b585325f8a6a0aab10047ed8Kay Sievers struct kobject *top_kobj; 24716574dccd8f62dc1b585325f8a6a0aab10047ed8Kay Sievers struct kset *kset; 2487eff2e7a8b65c25920207324e56611150eb1cd9aKay Sievers struct kobj_uevent_env *env = NULL; 24916574dccd8f62dc1b585325f8a6a0aab10047ed8Kay Sievers int i; 25016574dccd8f62dc1b585325f8a6a0aab10047ed8Kay Sievers size_t count = 0; 25116574dccd8f62dc1b585325f8a6a0aab10047ed8Kay Sievers int retval; 25216574dccd8f62dc1b585325f8a6a0aab10047ed8Kay Sievers 25316574dccd8f62dc1b585325f8a6a0aab10047ed8Kay Sievers /* search the kset, the device belongs to */ 25416574dccd8f62dc1b585325f8a6a0aab10047ed8Kay Sievers top_kobj = &dev->kobj; 2555c5daf657cb5f963a38413f2852279d7a3843144Kay Sievers while (!top_kobj->kset && top_kobj->parent) 2565c5daf657cb5f963a38413f2852279d7a3843144Kay Sievers top_kobj = top_kobj->parent; 25716574dccd8f62dc1b585325f8a6a0aab10047ed8Kay Sievers if (!top_kobj->kset) 25816574dccd8f62dc1b585325f8a6a0aab10047ed8Kay Sievers goto out; 2595c5daf657cb5f963a38413f2852279d7a3843144Kay Sievers 26016574dccd8f62dc1b585325f8a6a0aab10047ed8Kay Sievers kset = top_kobj->kset; 26116574dccd8f62dc1b585325f8a6a0aab10047ed8Kay Sievers if (!kset->uevent_ops || !kset->uevent_ops->uevent) 26216574dccd8f62dc1b585325f8a6a0aab10047ed8Kay Sievers goto out; 26316574dccd8f62dc1b585325f8a6a0aab10047ed8Kay Sievers 26416574dccd8f62dc1b585325f8a6a0aab10047ed8Kay Sievers /* respect filter */ 26516574dccd8f62dc1b585325f8a6a0aab10047ed8Kay Sievers if (kset->uevent_ops && kset->uevent_ops->filter) 26616574dccd8f62dc1b585325f8a6a0aab10047ed8Kay Sievers if (!kset->uevent_ops->filter(kset, &dev->kobj)) 26716574dccd8f62dc1b585325f8a6a0aab10047ed8Kay Sievers goto out; 26816574dccd8f62dc1b585325f8a6a0aab10047ed8Kay Sievers 2697eff2e7a8b65c25920207324e56611150eb1cd9aKay Sievers env = kzalloc(sizeof(struct kobj_uevent_env), GFP_KERNEL); 2707eff2e7a8b65c25920207324e56611150eb1cd9aKay Sievers if (!env) 271c7308c81a8220ab68eebfadde37db881a2800064Greg Kroah-Hartman return -ENOMEM; 272c7308c81a8220ab68eebfadde37db881a2800064Greg Kroah-Hartman 27316574dccd8f62dc1b585325f8a6a0aab10047ed8Kay Sievers /* let the kset specific function add its keys */ 2747eff2e7a8b65c25920207324e56611150eb1cd9aKay Sievers retval = kset->uevent_ops->uevent(kset, &dev->kobj, env); 27516574dccd8f62dc1b585325f8a6a0aab10047ed8Kay Sievers if (retval) 27616574dccd8f62dc1b585325f8a6a0aab10047ed8Kay Sievers goto out; 27716574dccd8f62dc1b585325f8a6a0aab10047ed8Kay Sievers 27816574dccd8f62dc1b585325f8a6a0aab10047ed8Kay Sievers /* copy keys to file */ 2797eff2e7a8b65c25920207324e56611150eb1cd9aKay Sievers for (i = 0; i < env->envp_idx; i++) 2807eff2e7a8b65c25920207324e56611150eb1cd9aKay Sievers count += sprintf(&buf[count], "%s\n", env->envp[i]); 28116574dccd8f62dc1b585325f8a6a0aab10047ed8Kay Sieversout: 2827eff2e7a8b65c25920207324e56611150eb1cd9aKay Sievers kfree(env); 28316574dccd8f62dc1b585325f8a6a0aab10047ed8Kay Sievers return count; 28416574dccd8f62dc1b585325f8a6a0aab10047ed8Kay Sievers} 28516574dccd8f62dc1b585325f8a6a0aab10047ed8Kay Sievers 286a7fd67062efc5b0fc9a61368c607fa92d1d57f9eKay Sieversstatic ssize_t store_uevent(struct device *dev, struct device_attribute *attr, 287a7fd67062efc5b0fc9a61368c607fa92d1d57f9eKay Sievers const char *buf, size_t count) 288a7fd67062efc5b0fc9a61368c607fa92d1d57f9eKay Sievers{ 28960a96a59569bab85571d0089682109bd3324e896Kay Sievers enum kobject_action action; 29060a96a59569bab85571d0089682109bd3324e896Kay Sievers 2915c5daf657cb5f963a38413f2852279d7a3843144Kay Sievers if (kobject_action_type(buf, count, &action) == 0) { 29260a96a59569bab85571d0089682109bd3324e896Kay Sievers kobject_uevent(&dev->kobj, action); 29360a96a59569bab85571d0089682109bd3324e896Kay Sievers goto out; 29460a96a59569bab85571d0089682109bd3324e896Kay Sievers } 29560a96a59569bab85571d0089682109bd3324e896Kay Sievers 29660a96a59569bab85571d0089682109bd3324e896Kay Sievers dev_err(dev, "uevent: unsupported action-string; this will " 29760a96a59569bab85571d0089682109bd3324e896Kay Sievers "be ignored in a future kernel version\n"); 298312c004d36ce6c739512bac83b452f4c20ab1f62Kay Sievers kobject_uevent(&dev->kobj, KOBJ_ADD); 29960a96a59569bab85571d0089682109bd3324e896Kay Sieversout: 300a7fd67062efc5b0fc9a61368c607fa92d1d57f9eKay Sievers return count; 301a7fd67062efc5b0fc9a61368c607fa92d1d57f9eKay Sievers} 302a7fd67062efc5b0fc9a61368c607fa92d1d57f9eKay Sievers 303ad6a1e1c66009ba9dcd2f5c90ffa1fb4ce72fce0Tejun Heostatic struct device_attribute uevent_attr = 304ad6a1e1c66009ba9dcd2f5c90ffa1fb4ce72fce0Tejun Heo __ATTR(uevent, S_IRUGO | S_IWUSR, show_uevent, store_uevent); 305ad6a1e1c66009ba9dcd2f5c90ffa1fb4ce72fce0Tejun Heo 306621a1672f7377e08a942f205d6742d8af1292aabDmitry Torokhovstatic int device_add_attributes(struct device *dev, 307621a1672f7377e08a942f205d6742d8af1292aabDmitry Torokhov struct device_attribute *attrs) 308de0ff00d723fd821d372496e2c084805644aa5e1Greg Kroah-Hartman{ 309621a1672f7377e08a942f205d6742d8af1292aabDmitry Torokhov int error = 0; 310de0ff00d723fd821d372496e2c084805644aa5e1Greg Kroah-Hartman int i; 311621a1672f7377e08a942f205d6742d8af1292aabDmitry Torokhov 312621a1672f7377e08a942f205d6742d8af1292aabDmitry Torokhov if (attrs) { 313621a1672f7377e08a942f205d6742d8af1292aabDmitry Torokhov for (i = 0; attr_name(attrs[i]); i++) { 314621a1672f7377e08a942f205d6742d8af1292aabDmitry Torokhov error = device_create_file(dev, &attrs[i]); 315621a1672f7377e08a942f205d6742d8af1292aabDmitry Torokhov if (error) 316621a1672f7377e08a942f205d6742d8af1292aabDmitry Torokhov break; 317621a1672f7377e08a942f205d6742d8af1292aabDmitry Torokhov } 318621a1672f7377e08a942f205d6742d8af1292aabDmitry Torokhov if (error) 319621a1672f7377e08a942f205d6742d8af1292aabDmitry Torokhov while (--i >= 0) 320621a1672f7377e08a942f205d6742d8af1292aabDmitry Torokhov device_remove_file(dev, &attrs[i]); 321621a1672f7377e08a942f205d6742d8af1292aabDmitry Torokhov } 322621a1672f7377e08a942f205d6742d8af1292aabDmitry Torokhov return error; 323621a1672f7377e08a942f205d6742d8af1292aabDmitry Torokhov} 324621a1672f7377e08a942f205d6742d8af1292aabDmitry Torokhov 325621a1672f7377e08a942f205d6742d8af1292aabDmitry Torokhovstatic void device_remove_attributes(struct device *dev, 326621a1672f7377e08a942f205d6742d8af1292aabDmitry Torokhov struct device_attribute *attrs) 327621a1672f7377e08a942f205d6742d8af1292aabDmitry Torokhov{ 328621a1672f7377e08a942f205d6742d8af1292aabDmitry Torokhov int i; 329621a1672f7377e08a942f205d6742d8af1292aabDmitry Torokhov 330621a1672f7377e08a942f205d6742d8af1292aabDmitry Torokhov if (attrs) 331621a1672f7377e08a942f205d6742d8af1292aabDmitry Torokhov for (i = 0; attr_name(attrs[i]); i++) 332621a1672f7377e08a942f205d6742d8af1292aabDmitry Torokhov device_remove_file(dev, &attrs[i]); 333621a1672f7377e08a942f205d6742d8af1292aabDmitry Torokhov} 334621a1672f7377e08a942f205d6742d8af1292aabDmitry Torokhov 335621a1672f7377e08a942f205d6742d8af1292aabDmitry Torokhovstatic int device_add_groups(struct device *dev, 336621a1672f7377e08a942f205d6742d8af1292aabDmitry Torokhov struct attribute_group **groups) 337621a1672f7377e08a942f205d6742d8af1292aabDmitry Torokhov{ 338de0ff00d723fd821d372496e2c084805644aa5e1Greg Kroah-Hartman int error = 0; 339621a1672f7377e08a942f205d6742d8af1292aabDmitry Torokhov int i; 340de0ff00d723fd821d372496e2c084805644aa5e1Greg Kroah-Hartman 341621a1672f7377e08a942f205d6742d8af1292aabDmitry Torokhov if (groups) { 342621a1672f7377e08a942f205d6742d8af1292aabDmitry Torokhov for (i = 0; groups[i]; i++) { 343621a1672f7377e08a942f205d6742d8af1292aabDmitry Torokhov error = sysfs_create_group(&dev->kobj, groups[i]); 344de0ff00d723fd821d372496e2c084805644aa5e1Greg Kroah-Hartman if (error) { 345de0ff00d723fd821d372496e2c084805644aa5e1Greg Kroah-Hartman while (--i >= 0) 3464a3ad20ccd8f4d2a0535cf98fa83f7b561ba59a9Greg Kroah-Hartman sysfs_remove_group(&dev->kobj, 3474a3ad20ccd8f4d2a0535cf98fa83f7b561ba59a9Greg Kroah-Hartman groups[i]); 348621a1672f7377e08a942f205d6742d8af1292aabDmitry Torokhov break; 349de0ff00d723fd821d372496e2c084805644aa5e1Greg Kroah-Hartman } 350de0ff00d723fd821d372496e2c084805644aa5e1Greg Kroah-Hartman } 351de0ff00d723fd821d372496e2c084805644aa5e1Greg Kroah-Hartman } 352de0ff00d723fd821d372496e2c084805644aa5e1Greg Kroah-Hartman return error; 353de0ff00d723fd821d372496e2c084805644aa5e1Greg Kroah-Hartman} 354de0ff00d723fd821d372496e2c084805644aa5e1Greg Kroah-Hartman 355621a1672f7377e08a942f205d6742d8af1292aabDmitry Torokhovstatic void device_remove_groups(struct device *dev, 356621a1672f7377e08a942f205d6742d8af1292aabDmitry Torokhov struct attribute_group **groups) 357de0ff00d723fd821d372496e2c084805644aa5e1Greg Kroah-Hartman{ 358de0ff00d723fd821d372496e2c084805644aa5e1Greg Kroah-Hartman int i; 359621a1672f7377e08a942f205d6742d8af1292aabDmitry Torokhov 360621a1672f7377e08a942f205d6742d8af1292aabDmitry Torokhov if (groups) 361621a1672f7377e08a942f205d6742d8af1292aabDmitry Torokhov for (i = 0; groups[i]; i++) 362621a1672f7377e08a942f205d6742d8af1292aabDmitry Torokhov sysfs_remove_group(&dev->kobj, groups[i]); 363de0ff00d723fd821d372496e2c084805644aa5e1Greg Kroah-Hartman} 364de0ff00d723fd821d372496e2c084805644aa5e1Greg Kroah-Hartman 3652620efef7029bb040430f50f0fc148f2d5e002adGreg Kroah-Hartmanstatic int device_add_attrs(struct device *dev) 3662620efef7029bb040430f50f0fc148f2d5e002adGreg Kroah-Hartman{ 3672620efef7029bb040430f50f0fc148f2d5e002adGreg Kroah-Hartman struct class *class = dev->class; 368f9f852df2faf76a2667949ddb4947d4b8f99f02fKay Sievers struct device_type *type = dev->type; 369621a1672f7377e08a942f205d6742d8af1292aabDmitry Torokhov int error; 3702620efef7029bb040430f50f0fc148f2d5e002adGreg Kroah-Hartman 371621a1672f7377e08a942f205d6742d8af1292aabDmitry Torokhov if (class) { 372621a1672f7377e08a942f205d6742d8af1292aabDmitry Torokhov error = device_add_attributes(dev, class->dev_attrs); 373f9f852df2faf76a2667949ddb4947d4b8f99f02fKay Sievers if (error) 374621a1672f7377e08a942f205d6742d8af1292aabDmitry Torokhov return error; 3752620efef7029bb040430f50f0fc148f2d5e002adGreg Kroah-Hartman } 376f9f852df2faf76a2667949ddb4947d4b8f99f02fKay Sievers 377621a1672f7377e08a942f205d6742d8af1292aabDmitry Torokhov if (type) { 378621a1672f7377e08a942f205d6742d8af1292aabDmitry Torokhov error = device_add_groups(dev, type->groups); 379f9f852df2faf76a2667949ddb4947d4b8f99f02fKay Sievers if (error) 380621a1672f7377e08a942f205d6742d8af1292aabDmitry Torokhov goto err_remove_class_attrs; 381f9f852df2faf76a2667949ddb4947d4b8f99f02fKay Sievers } 382f9f852df2faf76a2667949ddb4947d4b8f99f02fKay Sievers 383621a1672f7377e08a942f205d6742d8af1292aabDmitry Torokhov error = device_add_groups(dev, dev->groups); 384621a1672f7377e08a942f205d6742d8af1292aabDmitry Torokhov if (error) 385621a1672f7377e08a942f205d6742d8af1292aabDmitry Torokhov goto err_remove_type_groups; 386621a1672f7377e08a942f205d6742d8af1292aabDmitry Torokhov 387621a1672f7377e08a942f205d6742d8af1292aabDmitry Torokhov return 0; 388621a1672f7377e08a942f205d6742d8af1292aabDmitry Torokhov 389621a1672f7377e08a942f205d6742d8af1292aabDmitry Torokhov err_remove_type_groups: 390621a1672f7377e08a942f205d6742d8af1292aabDmitry Torokhov if (type) 391621a1672f7377e08a942f205d6742d8af1292aabDmitry Torokhov device_remove_groups(dev, type->groups); 392621a1672f7377e08a942f205d6742d8af1292aabDmitry Torokhov err_remove_class_attrs: 393621a1672f7377e08a942f205d6742d8af1292aabDmitry Torokhov if (class) 394621a1672f7377e08a942f205d6742d8af1292aabDmitry Torokhov device_remove_attributes(dev, class->dev_attrs); 395621a1672f7377e08a942f205d6742d8af1292aabDmitry Torokhov 3962620efef7029bb040430f50f0fc148f2d5e002adGreg Kroah-Hartman return error; 3972620efef7029bb040430f50f0fc148f2d5e002adGreg Kroah-Hartman} 3982620efef7029bb040430f50f0fc148f2d5e002adGreg Kroah-Hartman 3992620efef7029bb040430f50f0fc148f2d5e002adGreg Kroah-Hartmanstatic void device_remove_attrs(struct device *dev) 4002620efef7029bb040430f50f0fc148f2d5e002adGreg Kroah-Hartman{ 4012620efef7029bb040430f50f0fc148f2d5e002adGreg Kroah-Hartman struct class *class = dev->class; 402f9f852df2faf76a2667949ddb4947d4b8f99f02fKay Sievers struct device_type *type = dev->type; 4032620efef7029bb040430f50f0fc148f2d5e002adGreg Kroah-Hartman 404621a1672f7377e08a942f205d6742d8af1292aabDmitry Torokhov device_remove_groups(dev, dev->groups); 405f9f852df2faf76a2667949ddb4947d4b8f99f02fKay Sievers 406621a1672f7377e08a942f205d6742d8af1292aabDmitry Torokhov if (type) 407621a1672f7377e08a942f205d6742d8af1292aabDmitry Torokhov device_remove_groups(dev, type->groups); 408621a1672f7377e08a942f205d6742d8af1292aabDmitry Torokhov 409621a1672f7377e08a942f205d6742d8af1292aabDmitry Torokhov if (class) 410621a1672f7377e08a942f205d6742d8af1292aabDmitry Torokhov device_remove_attributes(dev, class->dev_attrs); 4112620efef7029bb040430f50f0fc148f2d5e002adGreg Kroah-Hartman} 4122620efef7029bb040430f50f0fc148f2d5e002adGreg Kroah-Hartman 4132620efef7029bb040430f50f0fc148f2d5e002adGreg Kroah-Hartman 41423681e479129854305da1da32f7f1eaf635ef22cGreg Kroah-Hartmanstatic ssize_t show_dev(struct device *dev, struct device_attribute *attr, 41523681e479129854305da1da32f7f1eaf635ef22cGreg Kroah-Hartman char *buf) 41623681e479129854305da1da32f7f1eaf635ef22cGreg Kroah-Hartman{ 41723681e479129854305da1da32f7f1eaf635ef22cGreg Kroah-Hartman return print_dev_t(buf, dev->devt); 41823681e479129854305da1da32f7f1eaf635ef22cGreg Kroah-Hartman} 41923681e479129854305da1da32f7f1eaf635ef22cGreg Kroah-Hartman 420ad6a1e1c66009ba9dcd2f5c90ffa1fb4ce72fce0Tejun Heostatic struct device_attribute devt_attr = 421ad6a1e1c66009ba9dcd2f5c90ffa1fb4ce72fce0Tejun Heo __ATTR(dev, S_IRUGO, show_dev, NULL); 422ad6a1e1c66009ba9dcd2f5c90ffa1fb4ce72fce0Tejun Heo 423881c6cfd7c5edfe6129006e2404654bfe5911050Greg Kroah-Hartman/* kset to create /sys/devices/ */ 424881c6cfd7c5edfe6129006e2404654bfe5911050Greg Kroah-Hartmanstruct kset *devices_kset; 4251da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds 4261da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds/** 4274a3ad20ccd8f4d2a0535cf98fa83f7b561ba59a9Greg Kroah-Hartman * device_create_file - create sysfs attribute file for device. 4284a3ad20ccd8f4d2a0535cf98fa83f7b561ba59a9Greg Kroah-Hartman * @dev: device. 4294a3ad20ccd8f4d2a0535cf98fa83f7b561ba59a9Greg Kroah-Hartman * @attr: device attribute descriptor. 4301da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds */ 4314a3ad20ccd8f4d2a0535cf98fa83f7b561ba59a9Greg Kroah-Hartmanint device_create_file(struct device *dev, struct device_attribute *attr) 4321da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds{ 4331da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds int error = 0; 4340c98b19fe571ede1f14bd95b855bcbe2cca99bcfCornelia Huck if (dev) 4351da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds error = sysfs_create_file(&dev->kobj, &attr->attr); 4361da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds return error; 4371da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds} 4381da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds 4391da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds/** 4404a3ad20ccd8f4d2a0535cf98fa83f7b561ba59a9Greg Kroah-Hartman * device_remove_file - remove sysfs attribute file. 4414a3ad20ccd8f4d2a0535cf98fa83f7b561ba59a9Greg Kroah-Hartman * @dev: device. 4424a3ad20ccd8f4d2a0535cf98fa83f7b561ba59a9Greg Kroah-Hartman * @attr: device attribute descriptor. 4431da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds */ 4444a3ad20ccd8f4d2a0535cf98fa83f7b561ba59a9Greg Kroah-Hartmanvoid device_remove_file(struct device *dev, struct device_attribute *attr) 4451da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds{ 4460c98b19fe571ede1f14bd95b855bcbe2cca99bcfCornelia Huck if (dev) 4471da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds sysfs_remove_file(&dev->kobj, &attr->attr); 4481da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds} 4491da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds 4502589f1887b0bf9f08ec3d7f3c5705ccb7c628076Greg Kroah-Hartman/** 4512589f1887b0bf9f08ec3d7f3c5705ccb7c628076Greg Kroah-Hartman * device_create_bin_file - create sysfs binary attribute file for device. 4522589f1887b0bf9f08ec3d7f3c5705ccb7c628076Greg Kroah-Hartman * @dev: device. 4532589f1887b0bf9f08ec3d7f3c5705ccb7c628076Greg Kroah-Hartman * @attr: device binary attribute descriptor. 4542589f1887b0bf9f08ec3d7f3c5705ccb7c628076Greg Kroah-Hartman */ 4552589f1887b0bf9f08ec3d7f3c5705ccb7c628076Greg Kroah-Hartmanint device_create_bin_file(struct device *dev, struct bin_attribute *attr) 4562589f1887b0bf9f08ec3d7f3c5705ccb7c628076Greg Kroah-Hartman{ 4572589f1887b0bf9f08ec3d7f3c5705ccb7c628076Greg Kroah-Hartman int error = -EINVAL; 4582589f1887b0bf9f08ec3d7f3c5705ccb7c628076Greg Kroah-Hartman if (dev) 4592589f1887b0bf9f08ec3d7f3c5705ccb7c628076Greg Kroah-Hartman error = sysfs_create_bin_file(&dev->kobj, attr); 4602589f1887b0bf9f08ec3d7f3c5705ccb7c628076Greg Kroah-Hartman return error; 4612589f1887b0bf9f08ec3d7f3c5705ccb7c628076Greg Kroah-Hartman} 4622589f1887b0bf9f08ec3d7f3c5705ccb7c628076Greg Kroah-HartmanEXPORT_SYMBOL_GPL(device_create_bin_file); 4632589f1887b0bf9f08ec3d7f3c5705ccb7c628076Greg Kroah-Hartman 4642589f1887b0bf9f08ec3d7f3c5705ccb7c628076Greg Kroah-Hartman/** 4652589f1887b0bf9f08ec3d7f3c5705ccb7c628076Greg Kroah-Hartman * device_remove_bin_file - remove sysfs binary attribute file 4662589f1887b0bf9f08ec3d7f3c5705ccb7c628076Greg Kroah-Hartman * @dev: device. 4672589f1887b0bf9f08ec3d7f3c5705ccb7c628076Greg Kroah-Hartman * @attr: device binary attribute descriptor. 4682589f1887b0bf9f08ec3d7f3c5705ccb7c628076Greg Kroah-Hartman */ 4692589f1887b0bf9f08ec3d7f3c5705ccb7c628076Greg Kroah-Hartmanvoid device_remove_bin_file(struct device *dev, struct bin_attribute *attr) 4702589f1887b0bf9f08ec3d7f3c5705ccb7c628076Greg Kroah-Hartman{ 4712589f1887b0bf9f08ec3d7f3c5705ccb7c628076Greg Kroah-Hartman if (dev) 4722589f1887b0bf9f08ec3d7f3c5705ccb7c628076Greg Kroah-Hartman sysfs_remove_bin_file(&dev->kobj, attr); 4732589f1887b0bf9f08ec3d7f3c5705ccb7c628076Greg Kroah-Hartman} 4742589f1887b0bf9f08ec3d7f3c5705ccb7c628076Greg Kroah-HartmanEXPORT_SYMBOL_GPL(device_remove_bin_file); 4752589f1887b0bf9f08ec3d7f3c5705ccb7c628076Greg Kroah-Hartman 476d9a9cdfb078d755e648d53ec25b7370f84ee5729Alan Stern/** 477523ded71de0c5e66973335bf99a80edfda9f401bAlan Stern * device_schedule_callback_owner - helper to schedule a callback for a device 478d9a9cdfb078d755e648d53ec25b7370f84ee5729Alan Stern * @dev: device. 479d9a9cdfb078d755e648d53ec25b7370f84ee5729Alan Stern * @func: callback function to invoke later. 480523ded71de0c5e66973335bf99a80edfda9f401bAlan Stern * @owner: module owning the callback routine 481d9a9cdfb078d755e648d53ec25b7370f84ee5729Alan Stern * 482d9a9cdfb078d755e648d53ec25b7370f84ee5729Alan Stern * Attribute methods must not unregister themselves or their parent device 483d9a9cdfb078d755e648d53ec25b7370f84ee5729Alan Stern * (which would amount to the same thing). Attempts to do so will deadlock, 484d9a9cdfb078d755e648d53ec25b7370f84ee5729Alan Stern * since unregistration is mutually exclusive with driver callbacks. 485d9a9cdfb078d755e648d53ec25b7370f84ee5729Alan Stern * 486d9a9cdfb078d755e648d53ec25b7370f84ee5729Alan Stern * Instead methods can call this routine, which will attempt to allocate 487d9a9cdfb078d755e648d53ec25b7370f84ee5729Alan Stern * and schedule a workqueue request to call back @func with @dev as its 488d9a9cdfb078d755e648d53ec25b7370f84ee5729Alan Stern * argument in the workqueue's process context. @dev will be pinned until 489d9a9cdfb078d755e648d53ec25b7370f84ee5729Alan Stern * @func returns. 490d9a9cdfb078d755e648d53ec25b7370f84ee5729Alan Stern * 491523ded71de0c5e66973335bf99a80edfda9f401bAlan Stern * This routine is usually called via the inline device_schedule_callback(), 492523ded71de0c5e66973335bf99a80edfda9f401bAlan Stern * which automatically sets @owner to THIS_MODULE. 493523ded71de0c5e66973335bf99a80edfda9f401bAlan Stern * 494d9a9cdfb078d755e648d53ec25b7370f84ee5729Alan Stern * Returns 0 if the request was submitted, -ENOMEM if storage could not 495523ded71de0c5e66973335bf99a80edfda9f401bAlan Stern * be allocated, -ENODEV if a reference to @owner isn't available. 496d9a9cdfb078d755e648d53ec25b7370f84ee5729Alan Stern * 497d9a9cdfb078d755e648d53ec25b7370f84ee5729Alan Stern * NOTE: This routine won't work if CONFIG_SYSFS isn't set! It uses an 498d9a9cdfb078d755e648d53ec25b7370f84ee5729Alan Stern * underlying sysfs routine (since it is intended for use by attribute 499d9a9cdfb078d755e648d53ec25b7370f84ee5729Alan Stern * methods), and if sysfs isn't available you'll get nothing but -ENOSYS. 500d9a9cdfb078d755e648d53ec25b7370f84ee5729Alan Stern */ 501523ded71de0c5e66973335bf99a80edfda9f401bAlan Sternint device_schedule_callback_owner(struct device *dev, 502523ded71de0c5e66973335bf99a80edfda9f401bAlan Stern void (*func)(struct device *), struct module *owner) 503d9a9cdfb078d755e648d53ec25b7370f84ee5729Alan Stern{ 504d9a9cdfb078d755e648d53ec25b7370f84ee5729Alan Stern return sysfs_schedule_callback(&dev->kobj, 505523ded71de0c5e66973335bf99a80edfda9f401bAlan Stern (void (*)(void *)) func, dev, owner); 506d9a9cdfb078d755e648d53ec25b7370f84ee5729Alan Stern} 507523ded71de0c5e66973335bf99a80edfda9f401bAlan SternEXPORT_SYMBOL_GPL(device_schedule_callback_owner); 508d9a9cdfb078d755e648d53ec25b7370f84ee5729Alan Stern 50934bb61f9ddabd7a7f909cbfb05592eb775f6662aJames Bottomleystatic void klist_children_get(struct klist_node *n) 51034bb61f9ddabd7a7f909cbfb05592eb775f6662aJames Bottomley{ 511f791b8c836307b58cbf62133a6a772ed1a92fb33Greg Kroah-Hartman struct device_private *p = to_device_private_parent(n); 512f791b8c836307b58cbf62133a6a772ed1a92fb33Greg Kroah-Hartman struct device *dev = p->device; 51334bb61f9ddabd7a7f909cbfb05592eb775f6662aJames Bottomley 51434bb61f9ddabd7a7f909cbfb05592eb775f6662aJames Bottomley get_device(dev); 51534bb61f9ddabd7a7f909cbfb05592eb775f6662aJames Bottomley} 51634bb61f9ddabd7a7f909cbfb05592eb775f6662aJames Bottomley 51734bb61f9ddabd7a7f909cbfb05592eb775f6662aJames Bottomleystatic void klist_children_put(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 put_device(dev); 52334bb61f9ddabd7a7f909cbfb05592eb775f6662aJames Bottomley} 52434bb61f9ddabd7a7f909cbfb05592eb775f6662aJames Bottomley 5251da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds/** 5264a3ad20ccd8f4d2a0535cf98fa83f7b561ba59a9Greg Kroah-Hartman * device_initialize - init device structure. 5274a3ad20ccd8f4d2a0535cf98fa83f7b561ba59a9Greg Kroah-Hartman * @dev: device. 5281da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds * 5295739411acbaa63a6c22c91e340fdcdbcc7d82a51Cornelia Huck * This prepares the device for use by other layers by initializing 5305739411acbaa63a6c22c91e340fdcdbcc7d82a51Cornelia Huck * its fields. 5314a3ad20ccd8f4d2a0535cf98fa83f7b561ba59a9Greg Kroah-Hartman * It is the first half of device_register(), if called by 5325739411acbaa63a6c22c91e340fdcdbcc7d82a51Cornelia Huck * that function, though it can also be called separately, so one 5335739411acbaa63a6c22c91e340fdcdbcc7d82a51Cornelia Huck * may use @dev's fields. In particular, get_device()/put_device() 5345739411acbaa63a6c22c91e340fdcdbcc7d82a51Cornelia Huck * may be used for reference counting of @dev after calling this 5355739411acbaa63a6c22c91e340fdcdbcc7d82a51Cornelia Huck * function. 5365739411acbaa63a6c22c91e340fdcdbcc7d82a51Cornelia Huck * 5375739411acbaa63a6c22c91e340fdcdbcc7d82a51Cornelia Huck * NOTE: Use put_device() to give up your reference instead of freeing 5385739411acbaa63a6c22c91e340fdcdbcc7d82a51Cornelia Huck * @dev directly once you have called this function. 5391da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds */ 5401da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvaldsvoid device_initialize(struct device *dev) 5411da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds{ 542881c6cfd7c5edfe6129006e2404654bfe5911050Greg Kroah-Hartman dev->kobj.kset = devices_kset; 543f9cb074bff8e762ef24c44678a5a7d907f82fbebGreg Kroah-Hartman kobject_init(&dev->kobj, &device_ktype); 5441da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds INIT_LIST_HEAD(&dev->dma_pools); 545af70316af182f4716cc5eec7e0d27fc731d164bdPatrick Mochel init_MUTEX(&dev->sem); 5469ac7849e35f705830f7b016ff272b0ff1f7ff759Tejun Heo spin_lock_init(&dev->devres_lock); 5479ac7849e35f705830f7b016ff272b0ff1f7ff759Tejun Heo INIT_LIST_HEAD(&dev->devres_head); 5480ac85241ebc7bf6b86ab498960cc121d53ef69aeDavid Brownell device_init_wakeup(dev, 0); 5493b98aeaf3a75f544dc945694f4fcf6e1c4bab89dAlan Stern device_pm_init(dev); 550873481367edb18a7d0d7e5a285e6728c16bb44a9Christoph Hellwig set_dev_node(dev, -1); 5511da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds} 5521da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds 55340fa54226f518a9bc97ed1d711c0016e416e3782Greg Kroah-Hartman#ifdef CONFIG_SYSFS_DEPRECATED 554da231fd5d113ab6da5dab7a2d2c38d0a540f939cKay Sieversstatic struct kobject *get_device_parent(struct device *dev, 555da231fd5d113ab6da5dab7a2d2c38d0a540f939cKay Sievers struct device *parent) 55640fa54226f518a9bc97ed1d711c0016e416e3782Greg Kroah-Hartman{ 557da231fd5d113ab6da5dab7a2d2c38d0a540f939cKay Sievers /* class devices without a parent live in /sys/class/<classname>/ */ 5583eb215de26e6e94bf5fed9cb77230c383b30e53bDmitry Torokhov if (dev->class && (!parent || parent->class != dev->class)) 5591fbfee6c6dc0f4a4c587b6b163ee79643fc9aaa7Greg Kroah-Hartman return &dev->class->p->class_subsys.kobj; 560da231fd5d113ab6da5dab7a2d2c38d0a540f939cKay Sievers /* all other devices keep their parent */ 56140fa54226f518a9bc97ed1d711c0016e416e3782Greg Kroah-Hartman else if (parent) 562c744aeae9d173a953b771a7ad5c872f91fa99decCornelia Huck return &parent->kobj; 56340fa54226f518a9bc97ed1d711c0016e416e3782Greg Kroah-Hartman 564c744aeae9d173a953b771a7ad5c872f91fa99decCornelia Huck return NULL; 56540fa54226f518a9bc97ed1d711c0016e416e3782Greg Kroah-Hartman} 566da231fd5d113ab6da5dab7a2d2c38d0a540f939cKay Sievers 567da231fd5d113ab6da5dab7a2d2c38d0a540f939cKay Sieversstatic inline void cleanup_device_parent(struct device *dev) {} 56863b6971a0876b744e2fcf3c9df15d130501e1debCornelia Huckstatic inline void cleanup_glue_dir(struct device *dev, 56963b6971a0876b744e2fcf3c9df15d130501e1debCornelia Huck struct kobject *glue_dir) {} 57040fa54226f518a9bc97ed1d711c0016e416e3782Greg Kroah-Hartman#else 571864062457a2e444227bd368ca5f2a2b740de604fKay Sieversstatic struct kobject *virtual_device_parent(struct device *dev) 572f0ee61a6cecd100301a60d99feb187776533b2a2Greg Kroah-Hartman{ 573864062457a2e444227bd368ca5f2a2b740de604fKay Sievers static struct kobject *virtual_dir = NULL; 574f0ee61a6cecd100301a60d99feb187776533b2a2Greg Kroah-Hartman 575864062457a2e444227bd368ca5f2a2b740de604fKay Sievers if (!virtual_dir) 5764ff6abff832fbc6cb1d769f6106c841bc2b09f63Greg Kroah-Hartman virtual_dir = kobject_create_and_add("virtual", 577881c6cfd7c5edfe6129006e2404654bfe5911050Greg Kroah-Hartman &devices_kset->kobj); 578f0ee61a6cecd100301a60d99feb187776533b2a2Greg Kroah-Hartman 579864062457a2e444227bd368ca5f2a2b740de604fKay Sievers return virtual_dir; 580f0ee61a6cecd100301a60d99feb187776533b2a2Greg Kroah-Hartman} 581f0ee61a6cecd100301a60d99feb187776533b2a2Greg Kroah-Hartman 582da231fd5d113ab6da5dab7a2d2c38d0a540f939cKay Sieversstatic struct kobject *get_device_parent(struct device *dev, 583da231fd5d113ab6da5dab7a2d2c38d0a540f939cKay Sievers struct device *parent) 58440fa54226f518a9bc97ed1d711c0016e416e3782Greg Kroah-Hartman{ 58543968d2f1648f4dc92437dc0363a3e88377445b3Greg Kroah-Hartman int retval; 58643968d2f1648f4dc92437dc0363a3e88377445b3Greg Kroah-Hartman 587864062457a2e444227bd368ca5f2a2b740de604fKay Sievers if (dev->class) { 588864062457a2e444227bd368ca5f2a2b740de604fKay Sievers struct kobject *kobj = NULL; 589864062457a2e444227bd368ca5f2a2b740de604fKay Sievers struct kobject *parent_kobj; 590864062457a2e444227bd368ca5f2a2b740de604fKay Sievers struct kobject *k; 591864062457a2e444227bd368ca5f2a2b740de604fKay Sievers 592864062457a2e444227bd368ca5f2a2b740de604fKay Sievers /* 593864062457a2e444227bd368ca5f2a2b740de604fKay Sievers * If we have no parent, we live in "virtual". 5940f4dafc0563c6c49e17fe14b3f5f356e4c4b8806Kay Sievers * Class-devices with a non class-device as parent, live 5950f4dafc0563c6c49e17fe14b3f5f356e4c4b8806Kay Sievers * in a "glue" directory to prevent namespace collisions. 596864062457a2e444227bd368ca5f2a2b740de604fKay Sievers */ 597864062457a2e444227bd368ca5f2a2b740de604fKay Sievers if (parent == NULL) 598864062457a2e444227bd368ca5f2a2b740de604fKay Sievers parent_kobj = virtual_device_parent(dev); 599864062457a2e444227bd368ca5f2a2b740de604fKay Sievers else if (parent->class) 600864062457a2e444227bd368ca5f2a2b740de604fKay Sievers return &parent->kobj; 601864062457a2e444227bd368ca5f2a2b740de604fKay Sievers else 602864062457a2e444227bd368ca5f2a2b740de604fKay Sievers parent_kobj = &parent->kobj; 603864062457a2e444227bd368ca5f2a2b740de604fKay Sievers 604864062457a2e444227bd368ca5f2a2b740de604fKay Sievers /* find our class-directory at the parent and reference it */ 6057c71448b8aa80123fc521563d5f7c63a099d97abGreg Kroah-Hartman spin_lock(&dev->class->p->class_dirs.list_lock); 6067c71448b8aa80123fc521563d5f7c63a099d97abGreg Kroah-Hartman list_for_each_entry(k, &dev->class->p->class_dirs.list, entry) 607864062457a2e444227bd368ca5f2a2b740de604fKay Sievers if (k->parent == parent_kobj) { 608864062457a2e444227bd368ca5f2a2b740de604fKay Sievers kobj = kobject_get(k); 609864062457a2e444227bd368ca5f2a2b740de604fKay Sievers break; 610864062457a2e444227bd368ca5f2a2b740de604fKay Sievers } 6117c71448b8aa80123fc521563d5f7c63a099d97abGreg Kroah-Hartman spin_unlock(&dev->class->p->class_dirs.list_lock); 612864062457a2e444227bd368ca5f2a2b740de604fKay Sievers if (kobj) 613864062457a2e444227bd368ca5f2a2b740de604fKay Sievers return kobj; 614864062457a2e444227bd368ca5f2a2b740de604fKay Sievers 615864062457a2e444227bd368ca5f2a2b740de604fKay Sievers /* or create a new class-directory at the parent device */ 61643968d2f1648f4dc92437dc0363a3e88377445b3Greg Kroah-Hartman k = kobject_create(); 61743968d2f1648f4dc92437dc0363a3e88377445b3Greg Kroah-Hartman if (!k) 61843968d2f1648f4dc92437dc0363a3e88377445b3Greg Kroah-Hartman return NULL; 6197c71448b8aa80123fc521563d5f7c63a099d97abGreg Kroah-Hartman k->kset = &dev->class->p->class_dirs; 620b2d6db5878a0832659ed58476357eea2db915550Greg Kroah-Hartman retval = kobject_add(k, parent_kobj, "%s", dev->class->name); 62143968d2f1648f4dc92437dc0363a3e88377445b3Greg Kroah-Hartman if (retval < 0) { 62243968d2f1648f4dc92437dc0363a3e88377445b3Greg Kroah-Hartman kobject_put(k); 62343968d2f1648f4dc92437dc0363a3e88377445b3Greg Kroah-Hartman return NULL; 62443968d2f1648f4dc92437dc0363a3e88377445b3Greg Kroah-Hartman } 6250f4dafc0563c6c49e17fe14b3f5f356e4c4b8806Kay Sievers /* do not emit an uevent for this simple "glue" directory */ 62643968d2f1648f4dc92437dc0363a3e88377445b3Greg Kroah-Hartman return k; 627864062457a2e444227bd368ca5f2a2b740de604fKay Sievers } 628864062457a2e444227bd368ca5f2a2b740de604fKay Sievers 629864062457a2e444227bd368ca5f2a2b740de604fKay Sievers if (parent) 630c744aeae9d173a953b771a7ad5c872f91fa99decCornelia Huck return &parent->kobj; 631c744aeae9d173a953b771a7ad5c872f91fa99decCornelia Huck return NULL; 632c744aeae9d173a953b771a7ad5c872f91fa99decCornelia Huck} 633da231fd5d113ab6da5dab7a2d2c38d0a540f939cKay Sievers 63463b6971a0876b744e2fcf3c9df15d130501e1debCornelia Huckstatic void cleanup_glue_dir(struct device *dev, struct kobject *glue_dir) 635da231fd5d113ab6da5dab7a2d2c38d0a540f939cKay Sievers{ 6360f4dafc0563c6c49e17fe14b3f5f356e4c4b8806Kay Sievers /* see if we live in a "glue" directory */ 637c1fe539a7e031302af1d121163e7ce68e679ba8cCornelia Huck if (!glue_dir || !dev->class || 6387c71448b8aa80123fc521563d5f7c63a099d97abGreg Kroah-Hartman glue_dir->kset != &dev->class->p->class_dirs) 639da231fd5d113ab6da5dab7a2d2c38d0a540f939cKay Sievers return; 640da231fd5d113ab6da5dab7a2d2c38d0a540f939cKay Sievers 6410f4dafc0563c6c49e17fe14b3f5f356e4c4b8806Kay Sievers kobject_put(glue_dir); 642da231fd5d113ab6da5dab7a2d2c38d0a540f939cKay Sievers} 64363b6971a0876b744e2fcf3c9df15d130501e1debCornelia Huck 64463b6971a0876b744e2fcf3c9df15d130501e1debCornelia Huckstatic void cleanup_device_parent(struct device *dev) 64563b6971a0876b744e2fcf3c9df15d130501e1debCornelia Huck{ 64663b6971a0876b744e2fcf3c9df15d130501e1debCornelia Huck cleanup_glue_dir(dev, dev->kobj.parent); 64763b6971a0876b744e2fcf3c9df15d130501e1debCornelia Huck} 648c744aeae9d173a953b771a7ad5c872f91fa99decCornelia Huck#endif 649864062457a2e444227bd368ca5f2a2b740de604fKay Sievers 65063b6971a0876b744e2fcf3c9df15d130501e1debCornelia Huckstatic void setup_parent(struct device *dev, struct device *parent) 651c744aeae9d173a953b771a7ad5c872f91fa99decCornelia Huck{ 652c744aeae9d173a953b771a7ad5c872f91fa99decCornelia Huck struct kobject *kobj; 653c744aeae9d173a953b771a7ad5c872f91fa99decCornelia Huck kobj = get_device_parent(dev, parent); 654c744aeae9d173a953b771a7ad5c872f91fa99decCornelia Huck if (kobj) 655c744aeae9d173a953b771a7ad5c872f91fa99decCornelia Huck dev->kobj.parent = kobj; 65640fa54226f518a9bc97ed1d711c0016e416e3782Greg Kroah-Hartman} 65740fa54226f518a9bc97ed1d711c0016e416e3782Greg Kroah-Hartman 6582ee97caf0a6602f749ddbfdb1449e383e1212707Cornelia Huckstatic int device_add_class_symlinks(struct device *dev) 6592ee97caf0a6602f749ddbfdb1449e383e1212707Cornelia Huck{ 6602ee97caf0a6602f749ddbfdb1449e383e1212707Cornelia Huck int error; 6612ee97caf0a6602f749ddbfdb1449e383e1212707Cornelia Huck 6622ee97caf0a6602f749ddbfdb1449e383e1212707Cornelia Huck if (!dev->class) 6632ee97caf0a6602f749ddbfdb1449e383e1212707Cornelia Huck return 0; 664da231fd5d113ab6da5dab7a2d2c38d0a540f939cKay Sievers 6651fbfee6c6dc0f4a4c587b6b163ee79643fc9aaa7Greg Kroah-Hartman error = sysfs_create_link(&dev->kobj, 6661fbfee6c6dc0f4a4c587b6b163ee79643fc9aaa7Greg Kroah-Hartman &dev->class->p->class_subsys.kobj, 6672ee97caf0a6602f749ddbfdb1449e383e1212707Cornelia Huck "subsystem"); 6682ee97caf0a6602f749ddbfdb1449e383e1212707Cornelia Huck if (error) 6692ee97caf0a6602f749ddbfdb1449e383e1212707Cornelia Huck goto out; 670da231fd5d113ab6da5dab7a2d2c38d0a540f939cKay Sievers 671da231fd5d113ab6da5dab7a2d2c38d0a540f939cKay Sievers#ifdef CONFIG_SYSFS_DEPRECATED 672da231fd5d113ab6da5dab7a2d2c38d0a540f939cKay Sievers /* stacked class devices need a symlink in the class directory */ 6731fbfee6c6dc0f4a4c587b6b163ee79643fc9aaa7Greg Kroah-Hartman if (dev->kobj.parent != &dev->class->p->class_subsys.kobj && 6744e886c29610f4374d8971ec7a248f011cc3bd73aGreg Kroah-Hartman device_is_not_partition(dev)) { 6751fbfee6c6dc0f4a4c587b6b163ee79643fc9aaa7Greg Kroah-Hartman error = sysfs_create_link(&dev->class->p->class_subsys.kobj, 6761e0b2cf933ebf32494eba3f668859ba57f06a951Kay Sievers &dev->kobj, dev_name(dev)); 6772ee97caf0a6602f749ddbfdb1449e383e1212707Cornelia Huck if (error) 6782ee97caf0a6602f749ddbfdb1449e383e1212707Cornelia Huck goto out_subsys; 6792ee97caf0a6602f749ddbfdb1449e383e1212707Cornelia Huck } 680da231fd5d113ab6da5dab7a2d2c38d0a540f939cKay Sievers 6814e886c29610f4374d8971ec7a248f011cc3bd73aGreg Kroah-Hartman if (dev->parent && device_is_not_partition(dev)) { 682da231fd5d113ab6da5dab7a2d2c38d0a540f939cKay Sievers struct device *parent = dev->parent; 683da231fd5d113ab6da5dab7a2d2c38d0a540f939cKay Sievers char *class_name; 6844f01a757e75f2a3cab2bab89c4176498963946b9Dmitry Torokhov 685da231fd5d113ab6da5dab7a2d2c38d0a540f939cKay Sievers /* 686da231fd5d113ab6da5dab7a2d2c38d0a540f939cKay Sievers * stacked class devices have the 'device' link 687da231fd5d113ab6da5dab7a2d2c38d0a540f939cKay Sievers * pointing to the bus device instead of the parent 688da231fd5d113ab6da5dab7a2d2c38d0a540f939cKay Sievers */ 689da231fd5d113ab6da5dab7a2d2c38d0a540f939cKay Sievers while (parent->class && !parent->bus && parent->parent) 690da231fd5d113ab6da5dab7a2d2c38d0a540f939cKay Sievers parent = parent->parent; 691da231fd5d113ab6da5dab7a2d2c38d0a540f939cKay Sievers 692da231fd5d113ab6da5dab7a2d2c38d0a540f939cKay Sievers error = sysfs_create_link(&dev->kobj, 693da231fd5d113ab6da5dab7a2d2c38d0a540f939cKay Sievers &parent->kobj, 6944f01a757e75f2a3cab2bab89c4176498963946b9Dmitry Torokhov "device"); 6954f01a757e75f2a3cab2bab89c4176498963946b9Dmitry Torokhov if (error) 6964f01a757e75f2a3cab2bab89c4176498963946b9Dmitry Torokhov goto out_busid; 697da231fd5d113ab6da5dab7a2d2c38d0a540f939cKay Sievers 698da231fd5d113ab6da5dab7a2d2c38d0a540f939cKay Sievers class_name = make_class_name(dev->class->name, 699da231fd5d113ab6da5dab7a2d2c38d0a540f939cKay Sievers &dev->kobj); 700da231fd5d113ab6da5dab7a2d2c38d0a540f939cKay Sievers if (class_name) 701da231fd5d113ab6da5dab7a2d2c38d0a540f939cKay Sievers error = sysfs_create_link(&dev->parent->kobj, 702da231fd5d113ab6da5dab7a2d2c38d0a540f939cKay Sievers &dev->kobj, class_name); 703da231fd5d113ab6da5dab7a2d2c38d0a540f939cKay Sievers kfree(class_name); 704da231fd5d113ab6da5dab7a2d2c38d0a540f939cKay Sievers if (error) 705da231fd5d113ab6da5dab7a2d2c38d0a540f939cKay Sievers goto out_device; 7062ee97caf0a6602f749ddbfdb1449e383e1212707Cornelia Huck } 7072ee97caf0a6602f749ddbfdb1449e383e1212707Cornelia Huck return 0; 7082ee97caf0a6602f749ddbfdb1449e383e1212707Cornelia Huck 7092ee97caf0a6602f749ddbfdb1449e383e1212707Cornelia Huckout_device: 7104e886c29610f4374d8971ec7a248f011cc3bd73aGreg Kroah-Hartman if (dev->parent && device_is_not_partition(dev)) 7112ee97caf0a6602f749ddbfdb1449e383e1212707Cornelia Huck sysfs_remove_link(&dev->kobj, "device"); 7122ee97caf0a6602f749ddbfdb1449e383e1212707Cornelia Huckout_busid: 7131fbfee6c6dc0f4a4c587b6b163ee79643fc9aaa7Greg Kroah-Hartman if (dev->kobj.parent != &dev->class->p->class_subsys.kobj && 7144e886c29610f4374d8971ec7a248f011cc3bd73aGreg Kroah-Hartman device_is_not_partition(dev)) 7151fbfee6c6dc0f4a4c587b6b163ee79643fc9aaa7Greg Kroah-Hartman sysfs_remove_link(&dev->class->p->class_subsys.kobj, 7161e0b2cf933ebf32494eba3f668859ba57f06a951Kay Sievers dev_name(dev)); 717da231fd5d113ab6da5dab7a2d2c38d0a540f939cKay Sievers#else 718da231fd5d113ab6da5dab7a2d2c38d0a540f939cKay Sievers /* link in the class directory pointing to the device */ 7191fbfee6c6dc0f4a4c587b6b163ee79643fc9aaa7Greg Kroah-Hartman error = sysfs_create_link(&dev->class->p->class_subsys.kobj, 7201e0b2cf933ebf32494eba3f668859ba57f06a951Kay Sievers &dev->kobj, dev_name(dev)); 721da231fd5d113ab6da5dab7a2d2c38d0a540f939cKay Sievers if (error) 722da231fd5d113ab6da5dab7a2d2c38d0a540f939cKay Sievers goto out_subsys; 723da231fd5d113ab6da5dab7a2d2c38d0a540f939cKay Sievers 7244e886c29610f4374d8971ec7a248f011cc3bd73aGreg Kroah-Hartman if (dev->parent && device_is_not_partition(dev)) { 725da231fd5d113ab6da5dab7a2d2c38d0a540f939cKay Sievers error = sysfs_create_link(&dev->kobj, &dev->parent->kobj, 726da231fd5d113ab6da5dab7a2d2c38d0a540f939cKay Sievers "device"); 727da231fd5d113ab6da5dab7a2d2c38d0a540f939cKay Sievers if (error) 728da231fd5d113ab6da5dab7a2d2c38d0a540f939cKay Sievers goto out_busid; 729da231fd5d113ab6da5dab7a2d2c38d0a540f939cKay Sievers } 730da231fd5d113ab6da5dab7a2d2c38d0a540f939cKay Sievers return 0; 731da231fd5d113ab6da5dab7a2d2c38d0a540f939cKay Sievers 732da231fd5d113ab6da5dab7a2d2c38d0a540f939cKay Sieversout_busid: 7331e0b2cf933ebf32494eba3f668859ba57f06a951Kay Sievers sysfs_remove_link(&dev->class->p->class_subsys.kobj, dev_name(dev)); 734da231fd5d113ab6da5dab7a2d2c38d0a540f939cKay Sievers#endif 735da231fd5d113ab6da5dab7a2d2c38d0a540f939cKay Sievers 7362ee97caf0a6602f749ddbfdb1449e383e1212707Cornelia Huckout_subsys: 7372ee97caf0a6602f749ddbfdb1449e383e1212707Cornelia Huck sysfs_remove_link(&dev->kobj, "subsystem"); 7382ee97caf0a6602f749ddbfdb1449e383e1212707Cornelia Huckout: 7392ee97caf0a6602f749ddbfdb1449e383e1212707Cornelia Huck return error; 7402ee97caf0a6602f749ddbfdb1449e383e1212707Cornelia Huck} 7412ee97caf0a6602f749ddbfdb1449e383e1212707Cornelia Huck 7422ee97caf0a6602f749ddbfdb1449e383e1212707Cornelia Huckstatic void device_remove_class_symlinks(struct device *dev) 7432ee97caf0a6602f749ddbfdb1449e383e1212707Cornelia Huck{ 7442ee97caf0a6602f749ddbfdb1449e383e1212707Cornelia Huck if (!dev->class) 7452ee97caf0a6602f749ddbfdb1449e383e1212707Cornelia Huck return; 746da231fd5d113ab6da5dab7a2d2c38d0a540f939cKay Sievers 7472ee97caf0a6602f749ddbfdb1449e383e1212707Cornelia Huck#ifdef CONFIG_SYSFS_DEPRECATED 7484e886c29610f4374d8971ec7a248f011cc3bd73aGreg Kroah-Hartman if (dev->parent && device_is_not_partition(dev)) { 7492ee97caf0a6602f749ddbfdb1449e383e1212707Cornelia Huck char *class_name; 7502ee97caf0a6602f749ddbfdb1449e383e1212707Cornelia Huck 7512ee97caf0a6602f749ddbfdb1449e383e1212707Cornelia Huck class_name = make_class_name(dev->class->name, &dev->kobj); 7522ee97caf0a6602f749ddbfdb1449e383e1212707Cornelia Huck if (class_name) { 7532ee97caf0a6602f749ddbfdb1449e383e1212707Cornelia Huck sysfs_remove_link(&dev->parent->kobj, class_name); 7542ee97caf0a6602f749ddbfdb1449e383e1212707Cornelia Huck kfree(class_name); 7552ee97caf0a6602f749ddbfdb1449e383e1212707Cornelia Huck } 7562ee97caf0a6602f749ddbfdb1449e383e1212707Cornelia Huck sysfs_remove_link(&dev->kobj, "device"); 7572ee97caf0a6602f749ddbfdb1449e383e1212707Cornelia Huck } 758da231fd5d113ab6da5dab7a2d2c38d0a540f939cKay Sievers 7591fbfee6c6dc0f4a4c587b6b163ee79643fc9aaa7Greg Kroah-Hartman if (dev->kobj.parent != &dev->class->p->class_subsys.kobj && 7604e886c29610f4374d8971ec7a248f011cc3bd73aGreg Kroah-Hartman device_is_not_partition(dev)) 7611fbfee6c6dc0f4a4c587b6b163ee79643fc9aaa7Greg Kroah-Hartman sysfs_remove_link(&dev->class->p->class_subsys.kobj, 7621e0b2cf933ebf32494eba3f668859ba57f06a951Kay Sievers dev_name(dev)); 763da231fd5d113ab6da5dab7a2d2c38d0a540f939cKay Sievers#else 7644e886c29610f4374d8971ec7a248f011cc3bd73aGreg Kroah-Hartman if (dev->parent && device_is_not_partition(dev)) 765da231fd5d113ab6da5dab7a2d2c38d0a540f939cKay Sievers sysfs_remove_link(&dev->kobj, "device"); 766da231fd5d113ab6da5dab7a2d2c38d0a540f939cKay Sievers 7671e0b2cf933ebf32494eba3f668859ba57f06a951Kay Sievers sysfs_remove_link(&dev->class->p->class_subsys.kobj, dev_name(dev)); 768da231fd5d113ab6da5dab7a2d2c38d0a540f939cKay Sievers#endif 769da231fd5d113ab6da5dab7a2d2c38d0a540f939cKay Sievers 7702ee97caf0a6602f749ddbfdb1449e383e1212707Cornelia Huck sysfs_remove_link(&dev->kobj, "subsystem"); 7712ee97caf0a6602f749ddbfdb1449e383e1212707Cornelia Huck} 7722ee97caf0a6602f749ddbfdb1449e383e1212707Cornelia Huck 7731da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds/** 774413c239fad68258157f903b3ffd9bfcc53f5e34bStephen Rothwell * dev_set_name - set a device name 775413c239fad68258157f903b3ffd9bfcc53f5e34bStephen Rothwell * @dev: device 7764623236619ff5ce233136d13ee2747c194a63591Randy Dunlap * @fmt: format string for the device's name 777413c239fad68258157f903b3ffd9bfcc53f5e34bStephen Rothwell */ 778413c239fad68258157f903b3ffd9bfcc53f5e34bStephen Rothwellint dev_set_name(struct device *dev, const char *fmt, ...) 779413c239fad68258157f903b3ffd9bfcc53f5e34bStephen Rothwell{ 780413c239fad68258157f903b3ffd9bfcc53f5e34bStephen Rothwell va_list vargs; 7811fa5ae857bb14f6046205171d98506d8112dd74eKay Sievers int err; 782413c239fad68258157f903b3ffd9bfcc53f5e34bStephen Rothwell 783413c239fad68258157f903b3ffd9bfcc53f5e34bStephen Rothwell va_start(vargs, fmt); 7841fa5ae857bb14f6046205171d98506d8112dd74eKay Sievers err = kobject_set_name_vargs(&dev->kobj, fmt, vargs); 785413c239fad68258157f903b3ffd9bfcc53f5e34bStephen Rothwell va_end(vargs); 7861fa5ae857bb14f6046205171d98506d8112dd74eKay Sievers return err; 787413c239fad68258157f903b3ffd9bfcc53f5e34bStephen Rothwell} 788413c239fad68258157f903b3ffd9bfcc53f5e34bStephen RothwellEXPORT_SYMBOL_GPL(dev_set_name); 789413c239fad68258157f903b3ffd9bfcc53f5e34bStephen Rothwell 790413c239fad68258157f903b3ffd9bfcc53f5e34bStephen Rothwell/** 791e105b8bfc769b0545b6f0f395179d1e43cbee822Dan Williams * device_to_dev_kobj - select a /sys/dev/ directory for the device 792e105b8bfc769b0545b6f0f395179d1e43cbee822Dan Williams * @dev: device 793e105b8bfc769b0545b6f0f395179d1e43cbee822Dan Williams * 794e105b8bfc769b0545b6f0f395179d1e43cbee822Dan Williams * By default we select char/ for new entries. Setting class->dev_obj 795e105b8bfc769b0545b6f0f395179d1e43cbee822Dan Williams * to NULL prevents an entry from being created. class->dev_kobj must 796e105b8bfc769b0545b6f0f395179d1e43cbee822Dan Williams * be set (or cleared) before any devices are registered to the class 797e105b8bfc769b0545b6f0f395179d1e43cbee822Dan Williams * otherwise device_create_sys_dev_entry() and 798e105b8bfc769b0545b6f0f395179d1e43cbee822Dan Williams * device_remove_sys_dev_entry() will disagree about the the presence 799e105b8bfc769b0545b6f0f395179d1e43cbee822Dan Williams * of the link. 800e105b8bfc769b0545b6f0f395179d1e43cbee822Dan Williams */ 801e105b8bfc769b0545b6f0f395179d1e43cbee822Dan Williamsstatic struct kobject *device_to_dev_kobj(struct device *dev) 802e105b8bfc769b0545b6f0f395179d1e43cbee822Dan Williams{ 803e105b8bfc769b0545b6f0f395179d1e43cbee822Dan Williams struct kobject *kobj; 804e105b8bfc769b0545b6f0f395179d1e43cbee822Dan Williams 805e105b8bfc769b0545b6f0f395179d1e43cbee822Dan Williams if (dev->class) 806e105b8bfc769b0545b6f0f395179d1e43cbee822Dan Williams kobj = dev->class->dev_kobj; 807e105b8bfc769b0545b6f0f395179d1e43cbee822Dan Williams else 808e105b8bfc769b0545b6f0f395179d1e43cbee822Dan Williams kobj = sysfs_dev_char_kobj; 809e105b8bfc769b0545b6f0f395179d1e43cbee822Dan Williams 810e105b8bfc769b0545b6f0f395179d1e43cbee822Dan Williams return kobj; 811e105b8bfc769b0545b6f0f395179d1e43cbee822Dan Williams} 812e105b8bfc769b0545b6f0f395179d1e43cbee822Dan Williams 813e105b8bfc769b0545b6f0f395179d1e43cbee822Dan Williamsstatic int device_create_sys_dev_entry(struct device *dev) 814e105b8bfc769b0545b6f0f395179d1e43cbee822Dan Williams{ 815e105b8bfc769b0545b6f0f395179d1e43cbee822Dan Williams struct kobject *kobj = device_to_dev_kobj(dev); 816e105b8bfc769b0545b6f0f395179d1e43cbee822Dan Williams int error = 0; 817e105b8bfc769b0545b6f0f395179d1e43cbee822Dan Williams char devt_str[15]; 818e105b8bfc769b0545b6f0f395179d1e43cbee822Dan Williams 819e105b8bfc769b0545b6f0f395179d1e43cbee822Dan Williams if (kobj) { 820e105b8bfc769b0545b6f0f395179d1e43cbee822Dan Williams format_dev_t(devt_str, dev->devt); 821e105b8bfc769b0545b6f0f395179d1e43cbee822Dan Williams error = sysfs_create_link(kobj, &dev->kobj, devt_str); 822e105b8bfc769b0545b6f0f395179d1e43cbee822Dan Williams } 823e105b8bfc769b0545b6f0f395179d1e43cbee822Dan Williams 824e105b8bfc769b0545b6f0f395179d1e43cbee822Dan Williams return error; 825e105b8bfc769b0545b6f0f395179d1e43cbee822Dan Williams} 826e105b8bfc769b0545b6f0f395179d1e43cbee822Dan Williams 827e105b8bfc769b0545b6f0f395179d1e43cbee822Dan Williamsstatic void device_remove_sys_dev_entry(struct device *dev) 828e105b8bfc769b0545b6f0f395179d1e43cbee822Dan Williams{ 829e105b8bfc769b0545b6f0f395179d1e43cbee822Dan Williams struct kobject *kobj = device_to_dev_kobj(dev); 830e105b8bfc769b0545b6f0f395179d1e43cbee822Dan Williams char devt_str[15]; 831e105b8bfc769b0545b6f0f395179d1e43cbee822Dan Williams 832e105b8bfc769b0545b6f0f395179d1e43cbee822Dan Williams if (kobj) { 833e105b8bfc769b0545b6f0f395179d1e43cbee822Dan Williams format_dev_t(devt_str, dev->devt); 834e105b8bfc769b0545b6f0f395179d1e43cbee822Dan Williams sysfs_remove_link(kobj, devt_str); 835e105b8bfc769b0545b6f0f395179d1e43cbee822Dan Williams } 836e105b8bfc769b0545b6f0f395179d1e43cbee822Dan Williams} 837e105b8bfc769b0545b6f0f395179d1e43cbee822Dan Williams 838e105b8bfc769b0545b6f0f395179d1e43cbee822Dan Williams/** 8394a3ad20ccd8f4d2a0535cf98fa83f7b561ba59a9Greg Kroah-Hartman * device_add - add device to device hierarchy. 8404a3ad20ccd8f4d2a0535cf98fa83f7b561ba59a9Greg Kroah-Hartman * @dev: device. 8411da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds * 8424a3ad20ccd8f4d2a0535cf98fa83f7b561ba59a9Greg Kroah-Hartman * This is part 2 of device_register(), though may be called 8434a3ad20ccd8f4d2a0535cf98fa83f7b561ba59a9Greg Kroah-Hartman * separately _iff_ device_initialize() has been called separately. 8441da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds * 8455739411acbaa63a6c22c91e340fdcdbcc7d82a51Cornelia Huck * This adds @dev to the kobject hierarchy via kobject_add(), adds it 8464a3ad20ccd8f4d2a0535cf98fa83f7b561ba59a9Greg Kroah-Hartman * to the global and sibling lists for the device, then 8474a3ad20ccd8f4d2a0535cf98fa83f7b561ba59a9Greg Kroah-Hartman * adds it to the other relevant subsystems of the driver model. 8485739411acbaa63a6c22c91e340fdcdbcc7d82a51Cornelia Huck * 8495739411acbaa63a6c22c91e340fdcdbcc7d82a51Cornelia Huck * NOTE: _Never_ directly free @dev after calling this function, even 8505739411acbaa63a6c22c91e340fdcdbcc7d82a51Cornelia Huck * if it returned an error! Always use put_device() to give up your 8515739411acbaa63a6c22c91e340fdcdbcc7d82a51Cornelia Huck * reference instead. 8521da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds */ 8531da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvaldsint device_add(struct device *dev) 8541da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds{ 8551da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds struct device *parent = NULL; 856c47ed219ba81632595e9f02e27318151fec16c9eGreg Kroah-Hartman struct class_interface *class_intf; 857c906a48adc74fc455378137ac5124b13e7030a15Greg Kroah-Hartman int error = -EINVAL; 858775b64d2b6ca37697de925f70799c710aab5849aRafael J. Wysocki 8591da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds dev = get_device(dev); 860c906a48adc74fc455378137ac5124b13e7030a15Greg Kroah-Hartman if (!dev) 861c906a48adc74fc455378137ac5124b13e7030a15Greg Kroah-Hartman goto done; 862c906a48adc74fc455378137ac5124b13e7030a15Greg Kroah-Hartman 863fb069a5d132fb926ed17af3211a114ac7cf27d7aGreg Kroah-Hartman dev->p = kzalloc(sizeof(*dev->p), GFP_KERNEL); 864fb069a5d132fb926ed17af3211a114ac7cf27d7aGreg Kroah-Hartman if (!dev->p) { 865fb069a5d132fb926ed17af3211a114ac7cf27d7aGreg Kroah-Hartman error = -ENOMEM; 866fb069a5d132fb926ed17af3211a114ac7cf27d7aGreg Kroah-Hartman goto done; 867fb069a5d132fb926ed17af3211a114ac7cf27d7aGreg Kroah-Hartman } 868fb069a5d132fb926ed17af3211a114ac7cf27d7aGreg Kroah-Hartman dev->p->device = dev; 869f791b8c836307b58cbf62133a6a772ed1a92fb33Greg Kroah-Hartman klist_init(&dev->p->klist_children, klist_children_get, 870f791b8c836307b58cbf62133a6a772ed1a92fb33Greg Kroah-Hartman klist_children_put); 871fb069a5d132fb926ed17af3211a114ac7cf27d7aGreg Kroah-Hartman 8721fa5ae857bb14f6046205171d98506d8112dd74eKay Sievers /* 8731fa5ae857bb14f6046205171d98506d8112dd74eKay Sievers * for statically allocated devices, which should all be converted 8741fa5ae857bb14f6046205171d98506d8112dd74eKay Sievers * some day, we need to initialize the name. We prevent reading back 8751fa5ae857bb14f6046205171d98506d8112dd74eKay Sievers * the name, and force the use of dev_name() 8761fa5ae857bb14f6046205171d98506d8112dd74eKay Sievers */ 8771fa5ae857bb14f6046205171d98506d8112dd74eKay Sievers if (dev->init_name) { 878acc0e90fbccbc6e4d48184cba0983ea044e131afGreg Kroah-Hartman dev_set_name(dev, "%s", dev->init_name); 8791fa5ae857bb14f6046205171d98506d8112dd74eKay Sievers dev->init_name = NULL; 8801fa5ae857bb14f6046205171d98506d8112dd74eKay Sievers } 881c906a48adc74fc455378137ac5124b13e7030a15Greg Kroah-Hartman 8821fa5ae857bb14f6046205171d98506d8112dd74eKay Sievers if (!dev_name(dev)) 8835c8563d773c0e9f0ac2a552e84806decd98ce732Kay Sievers goto name_error; 8841da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds 8851e0b2cf933ebf32494eba3f668859ba57f06a951Kay Sievers pr_debug("device: '%s': %s\n", dev_name(dev), __func__); 886c205ef4880273d2de4ee5388d4e52227ff688cc4Greg Kroah-Hartman 8871da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds parent = get_device(dev->parent); 88863b6971a0876b744e2fcf3c9df15d130501e1debCornelia Huck setup_parent(dev, parent); 8891da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds 8900d358f22f6c8f03ab215eee8d52b74f78cc3c7dbYinghai Lu /* use parent numa_node */ 8910d358f22f6c8f03ab215eee8d52b74f78cc3c7dbYinghai Lu if (parent) 8920d358f22f6c8f03ab215eee8d52b74f78cc3c7dbYinghai Lu set_dev_node(dev, dev_to_node(parent)); 8930d358f22f6c8f03ab215eee8d52b74f78cc3c7dbYinghai Lu 8941da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds /* first, register with generic layer. */ 8958a577ffc75d9194fe8cdb7479236f2081c26ca1fKay Sievers /* we require the name to be set before, and pass NULL */ 8968a577ffc75d9194fe8cdb7479236f2081c26ca1fKay Sievers error = kobject_add(&dev->kobj, dev->kobj.parent, NULL); 89740fa54226f518a9bc97ed1d711c0016e416e3782Greg Kroah-Hartman if (error) 8981da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds goto Error; 899a7fd67062efc5b0fc9a61368c607fa92d1d57f9eKay Sievers 900370226449ced358e52d198081120826ef52c166bBrian Walsh /* notify platform of device entry */ 901370226449ced358e52d198081120826ef52c166bBrian Walsh if (platform_notify) 902370226449ced358e52d198081120826ef52c166bBrian Walsh platform_notify(dev); 903370226449ced358e52d198081120826ef52c166bBrian Walsh 904ad6a1e1c66009ba9dcd2f5c90ffa1fb4ce72fce0Tejun Heo error = device_create_file(dev, &uevent_attr); 905a306eea40952e6365301e8a2f7d5ffa9c6a1921bCornelia Huck if (error) 906a306eea40952e6365301e8a2f7d5ffa9c6a1921bCornelia Huck goto attrError; 907a7fd67062efc5b0fc9a61368c607fa92d1d57f9eKay Sievers 90823681e479129854305da1da32f7f1eaf635ef22cGreg Kroah-Hartman if (MAJOR(dev->devt)) { 909ad6a1e1c66009ba9dcd2f5c90ffa1fb4ce72fce0Tejun Heo error = device_create_file(dev, &devt_attr); 910ad6a1e1c66009ba9dcd2f5c90ffa1fb4ce72fce0Tejun Heo if (error) 911a306eea40952e6365301e8a2f7d5ffa9c6a1921bCornelia Huck goto ueventattrError; 912e105b8bfc769b0545b6f0f395179d1e43cbee822Dan Williams 913e105b8bfc769b0545b6f0f395179d1e43cbee822Dan Williams error = device_create_sys_dev_entry(dev); 914e105b8bfc769b0545b6f0f395179d1e43cbee822Dan Williams if (error) 915e105b8bfc769b0545b6f0f395179d1e43cbee822Dan Williams goto devtattrError; 91623681e479129854305da1da32f7f1eaf635ef22cGreg Kroah-Hartman } 91723681e479129854305da1da32f7f1eaf635ef22cGreg Kroah-Hartman 9182ee97caf0a6602f749ddbfdb1449e383e1212707Cornelia Huck error = device_add_class_symlinks(dev); 9192ee97caf0a6602f749ddbfdb1449e383e1212707Cornelia Huck if (error) 9202ee97caf0a6602f749ddbfdb1449e383e1212707Cornelia Huck goto SymlinkError; 921dc0afa8388972a9ed7c2203cc46d8df1a4713f65Cornelia Huck error = device_add_attrs(dev); 922dc0afa8388972a9ed7c2203cc46d8df1a4713f65Cornelia Huck if (error) 9232620efef7029bb040430f50f0fc148f2d5e002adGreg Kroah-Hartman goto AttrsError; 924dc0afa8388972a9ed7c2203cc46d8df1a4713f65Cornelia Huck error = bus_add_device(dev); 925dc0afa8388972a9ed7c2203cc46d8df1a4713f65Cornelia Huck if (error) 9261da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds goto BusError; 9273b98aeaf3a75f544dc945694f4fcf6e1c4bab89dAlan Stern error = dpm_sysfs_add(dev); 92857eee3d23e8833ca18708b374c648235691942baRafael J. Wysocki if (error) 9293b98aeaf3a75f544dc945694f4fcf6e1c4bab89dAlan Stern goto DPMError; 9303b98aeaf3a75f544dc945694f4fcf6e1c4bab89dAlan Stern device_pm_add(dev); 931ec0676ee28528dc8dda13a93ee4b1f215a0c2f9dAlan Stern 932ec0676ee28528dc8dda13a93ee4b1f215a0c2f9dAlan Stern /* Notify clients of device addition. This call must come 933ec0676ee28528dc8dda13a93ee4b1f215a0c2f9dAlan Stern * after dpm_sysf_add() and before kobject_uevent(). 934ec0676ee28528dc8dda13a93ee4b1f215a0c2f9dAlan Stern */ 935ec0676ee28528dc8dda13a93ee4b1f215a0c2f9dAlan Stern if (dev->bus) 936ec0676ee28528dc8dda13a93ee4b1f215a0c2f9dAlan Stern blocking_notifier_call_chain(&dev->bus->p->bus_notifier, 937ec0676ee28528dc8dda13a93ee4b1f215a0c2f9dAlan Stern BUS_NOTIFY_ADD_DEVICE, dev); 938ec0676ee28528dc8dda13a93ee4b1f215a0c2f9dAlan Stern 93983b5fb4cce13b9f7b218ed88ee05387c3f3bdda3Cornelia Huck kobject_uevent(&dev->kobj, KOBJ_ADD); 940c6a46696f97ff260a4ecce5e287f8de4b9d7fe14Cornelia Huck bus_attach_device(dev); 9411da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds if (parent) 942f791b8c836307b58cbf62133a6a772ed1a92fb33Greg Kroah-Hartman klist_add_tail(&dev->p->knode_parent, 943f791b8c836307b58cbf62133a6a772ed1a92fb33Greg Kroah-Hartman &parent->p->klist_children); 9441da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds 9455d9fd169c9fbdaecdc430431e59bf94ff40b93d3Greg Kroah-Hartman if (dev->class) { 946f75b1c60fc1e53c4004a79ea0be071aa3318cdccDave Young mutex_lock(&dev->class->p->class_mutex); 947c47ed219ba81632595e9f02e27318151fec16c9eGreg Kroah-Hartman /* tie the class to the device */ 9485a3ceb861663040f9ef0176df4aaa494bba5e352Tejun Heo klist_add_tail(&dev->knode_class, 9495a3ceb861663040f9ef0176df4aaa494bba5e352Tejun Heo &dev->class->p->class_devices); 950c47ed219ba81632595e9f02e27318151fec16c9eGreg Kroah-Hartman 951c47ed219ba81632595e9f02e27318151fec16c9eGreg Kroah-Hartman /* notify any interfaces that the device is here */ 952184f1f779d5a2e62de4a0b34842ddf8546beca8fGreg Kroah-Hartman list_for_each_entry(class_intf, 953184f1f779d5a2e62de4a0b34842ddf8546beca8fGreg Kroah-Hartman &dev->class->p->class_interfaces, node) 954c47ed219ba81632595e9f02e27318151fec16c9eGreg Kroah-Hartman if (class_intf->add_dev) 955c47ed219ba81632595e9f02e27318151fec16c9eGreg Kroah-Hartman class_intf->add_dev(dev, class_intf); 956f75b1c60fc1e53c4004a79ea0be071aa3318cdccDave Young mutex_unlock(&dev->class->p->class_mutex); 9575d9fd169c9fbdaecdc430431e59bf94ff40b93d3Greg Kroah-Hartman } 958c906a48adc74fc455378137ac5124b13e7030a15Greg Kroah-Hartmandone: 9591da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds put_device(dev); 9601da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds return error; 9613b98aeaf3a75f544dc945694f4fcf6e1c4bab89dAlan Stern DPMError: 96257eee3d23e8833ca18708b374c648235691942baRafael J. Wysocki bus_remove_device(dev); 96357eee3d23e8833ca18708b374c648235691942baRafael J. Wysocki BusError: 96482f0cf9b7c42684c29189ddb6d0bc86eb1137fc4James Simmons device_remove_attrs(dev); 9652620efef7029bb040430f50f0fc148f2d5e002adGreg Kroah-Hartman AttrsError: 9662ee97caf0a6602f749ddbfdb1449e383e1212707Cornelia Huck device_remove_class_symlinks(dev); 9672ee97caf0a6602f749ddbfdb1449e383e1212707Cornelia Huck SymlinkError: 968ad6a1e1c66009ba9dcd2f5c90ffa1fb4ce72fce0Tejun Heo if (MAJOR(dev->devt)) 969e105b8bfc769b0545b6f0f395179d1e43cbee822Dan Williams device_remove_sys_dev_entry(dev); 970e105b8bfc769b0545b6f0f395179d1e43cbee822Dan Williams devtattrError: 971e105b8bfc769b0545b6f0f395179d1e43cbee822Dan Williams if (MAJOR(dev->devt)) 972ad6a1e1c66009ba9dcd2f5c90ffa1fb4ce72fce0Tejun Heo device_remove_file(dev, &devt_attr); 973a306eea40952e6365301e8a2f7d5ffa9c6a1921bCornelia Huck ueventattrError: 974ad6a1e1c66009ba9dcd2f5c90ffa1fb4ce72fce0Tejun Heo device_remove_file(dev, &uevent_attr); 97523681e479129854305da1da32f7f1eaf635ef22cGreg Kroah-Hartman attrError: 976312c004d36ce6c739512bac83b452f4c20ab1f62Kay Sievers kobject_uevent(&dev->kobj, KOBJ_REMOVE); 9771da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds kobject_del(&dev->kobj); 9781da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds Error: 97963b6971a0876b744e2fcf3c9df15d130501e1debCornelia Huck cleanup_device_parent(dev); 9801da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds if (parent) 9811da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds put_device(parent); 9825c8563d773c0e9f0ac2a552e84806decd98ce732Kay Sieversname_error: 9835c8563d773c0e9f0ac2a552e84806decd98ce732Kay Sievers kfree(dev->p); 9845c8563d773c0e9f0ac2a552e84806decd98ce732Kay Sievers dev->p = NULL; 985c906a48adc74fc455378137ac5124b13e7030a15Greg Kroah-Hartman goto done; 9861da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds} 9871da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds 9881da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds/** 9894a3ad20ccd8f4d2a0535cf98fa83f7b561ba59a9Greg Kroah-Hartman * device_register - register a device with the system. 9904a3ad20ccd8f4d2a0535cf98fa83f7b561ba59a9Greg Kroah-Hartman * @dev: pointer to the device structure 9911da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds * 9924a3ad20ccd8f4d2a0535cf98fa83f7b561ba59a9Greg Kroah-Hartman * This happens in two clean steps - initialize the device 9934a3ad20ccd8f4d2a0535cf98fa83f7b561ba59a9Greg Kroah-Hartman * and add it to the system. The two steps can be called 9944a3ad20ccd8f4d2a0535cf98fa83f7b561ba59a9Greg Kroah-Hartman * separately, but this is the easiest and most common. 9954a3ad20ccd8f4d2a0535cf98fa83f7b561ba59a9Greg Kroah-Hartman * I.e. you should only call the two helpers separately if 9964a3ad20ccd8f4d2a0535cf98fa83f7b561ba59a9Greg Kroah-Hartman * have a clearly defined need to use and refcount the device 9974a3ad20ccd8f4d2a0535cf98fa83f7b561ba59a9Greg Kroah-Hartman * before it is added to the hierarchy. 9985739411acbaa63a6c22c91e340fdcdbcc7d82a51Cornelia Huck * 9995739411acbaa63a6c22c91e340fdcdbcc7d82a51Cornelia Huck * NOTE: _Never_ directly free @dev after calling this function, even 10005739411acbaa63a6c22c91e340fdcdbcc7d82a51Cornelia Huck * if it returned an error! Always use put_device() to give up the 10015739411acbaa63a6c22c91e340fdcdbcc7d82a51Cornelia Huck * reference initialized in this function instead. 10021da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds */ 10031da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvaldsint device_register(struct device *dev) 10041da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds{ 10051da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds device_initialize(dev); 10061da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds return device_add(dev); 10071da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds} 10081da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds 10091da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds/** 10104a3ad20ccd8f4d2a0535cf98fa83f7b561ba59a9Greg Kroah-Hartman * get_device - increment reference count for device. 10114a3ad20ccd8f4d2a0535cf98fa83f7b561ba59a9Greg Kroah-Hartman * @dev: device. 10121da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds * 10134a3ad20ccd8f4d2a0535cf98fa83f7b561ba59a9Greg Kroah-Hartman * This simply forwards the call to kobject_get(), though 10144a3ad20ccd8f4d2a0535cf98fa83f7b561ba59a9Greg Kroah-Hartman * we do take care to provide for the case that we get a NULL 10154a3ad20ccd8f4d2a0535cf98fa83f7b561ba59a9Greg Kroah-Hartman * pointer passed in. 10161da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds */ 10174a3ad20ccd8f4d2a0535cf98fa83f7b561ba59a9Greg Kroah-Hartmanstruct device *get_device(struct device *dev) 10181da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds{ 10191da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds return dev ? to_dev(kobject_get(&dev->kobj)) : NULL; 10201da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds} 10211da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds 10221da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds/** 10234a3ad20ccd8f4d2a0535cf98fa83f7b561ba59a9Greg Kroah-Hartman * put_device - decrement reference count. 10244a3ad20ccd8f4d2a0535cf98fa83f7b561ba59a9Greg Kroah-Hartman * @dev: device in question. 10251da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds */ 10264a3ad20ccd8f4d2a0535cf98fa83f7b561ba59a9Greg Kroah-Hartmanvoid put_device(struct device *dev) 10271da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds{ 1028edfaa7c36574f1bf09c65ad602412db9da5f96bfKay Sievers /* might_sleep(); */ 10291da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds if (dev) 10301da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds kobject_put(&dev->kobj); 10311da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds} 10321da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds 10331da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds/** 10344a3ad20ccd8f4d2a0535cf98fa83f7b561ba59a9Greg Kroah-Hartman * device_del - delete device from system. 10354a3ad20ccd8f4d2a0535cf98fa83f7b561ba59a9Greg Kroah-Hartman * @dev: device. 10361da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds * 10374a3ad20ccd8f4d2a0535cf98fa83f7b561ba59a9Greg Kroah-Hartman * This is the first part of the device unregistration 10384a3ad20ccd8f4d2a0535cf98fa83f7b561ba59a9Greg Kroah-Hartman * sequence. This removes the device from the lists we control 10394a3ad20ccd8f4d2a0535cf98fa83f7b561ba59a9Greg Kroah-Hartman * from here, has it removed from the other driver model 10404a3ad20ccd8f4d2a0535cf98fa83f7b561ba59a9Greg Kroah-Hartman * subsystems it was added to in device_add(), and removes it 10414a3ad20ccd8f4d2a0535cf98fa83f7b561ba59a9Greg Kroah-Hartman * from the kobject hierarchy. 10421da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds * 10434a3ad20ccd8f4d2a0535cf98fa83f7b561ba59a9Greg Kroah-Hartman * NOTE: this should be called manually _iff_ device_add() was 10444a3ad20ccd8f4d2a0535cf98fa83f7b561ba59a9Greg Kroah-Hartman * also called manually. 10451da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds */ 10464a3ad20ccd8f4d2a0535cf98fa83f7b561ba59a9Greg Kroah-Hartmanvoid device_del(struct device *dev) 10471da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds{ 10484a3ad20ccd8f4d2a0535cf98fa83f7b561ba59a9Greg Kroah-Hartman struct device *parent = dev->parent; 1049c47ed219ba81632595e9f02e27318151fec16c9eGreg Kroah-Hartman struct class_interface *class_intf; 10501da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds 1051ec0676ee28528dc8dda13a93ee4b1f215a0c2f9dAlan Stern /* Notify clients of device removal. This call must come 1052ec0676ee28528dc8dda13a93ee4b1f215a0c2f9dAlan Stern * before dpm_sysfs_remove(). 1053ec0676ee28528dc8dda13a93ee4b1f215a0c2f9dAlan Stern */ 1054ec0676ee28528dc8dda13a93ee4b1f215a0c2f9dAlan Stern if (dev->bus) 1055ec0676ee28528dc8dda13a93ee4b1f215a0c2f9dAlan Stern blocking_notifier_call_chain(&dev->bus->p->bus_notifier, 1056ec0676ee28528dc8dda13a93ee4b1f215a0c2f9dAlan Stern BUS_NOTIFY_DEL_DEVICE, dev); 1057775b64d2b6ca37697de925f70799c710aab5849aRafael J. Wysocki device_pm_remove(dev); 10583b98aeaf3a75f544dc945694f4fcf6e1c4bab89dAlan Stern dpm_sysfs_remove(dev); 10591da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds if (parent) 1060f791b8c836307b58cbf62133a6a772ed1a92fb33Greg Kroah-Hartman klist_del(&dev->p->knode_parent); 1061e105b8bfc769b0545b6f0f395179d1e43cbee822Dan Williams if (MAJOR(dev->devt)) { 1062e105b8bfc769b0545b6f0f395179d1e43cbee822Dan Williams device_remove_sys_dev_entry(dev); 1063ad6a1e1c66009ba9dcd2f5c90ffa1fb4ce72fce0Tejun Heo device_remove_file(dev, &devt_attr); 1064e105b8bfc769b0545b6f0f395179d1e43cbee822Dan Williams } 1065b9d9c82b4d081feb464f62dfc786c8621d09ecd2Kay Sievers if (dev->class) { 1066da231fd5d113ab6da5dab7a2d2c38d0a540f939cKay Sievers device_remove_class_symlinks(dev); 106799ef3ef8d5f2f5b5312627127ad63df27c0d0d05Kay Sievers 1068f75b1c60fc1e53c4004a79ea0be071aa3318cdccDave Young mutex_lock(&dev->class->p->class_mutex); 1069c47ed219ba81632595e9f02e27318151fec16c9eGreg Kroah-Hartman /* notify any interfaces that the device is now gone */ 1070184f1f779d5a2e62de4a0b34842ddf8546beca8fGreg Kroah-Hartman list_for_each_entry(class_intf, 1071184f1f779d5a2e62de4a0b34842ddf8546beca8fGreg Kroah-Hartman &dev->class->p->class_interfaces, node) 1072c47ed219ba81632595e9f02e27318151fec16c9eGreg Kroah-Hartman if (class_intf->remove_dev) 1073c47ed219ba81632595e9f02e27318151fec16c9eGreg Kroah-Hartman class_intf->remove_dev(dev, class_intf); 1074c47ed219ba81632595e9f02e27318151fec16c9eGreg Kroah-Hartman /* remove the device from the class list */ 10755a3ceb861663040f9ef0176df4aaa494bba5e352Tejun Heo klist_del(&dev->knode_class); 1076f75b1c60fc1e53c4004a79ea0be071aa3318cdccDave Young mutex_unlock(&dev->class->p->class_mutex); 1077b9d9c82b4d081feb464f62dfc786c8621d09ecd2Kay Sievers } 1078ad6a1e1c66009ba9dcd2f5c90ffa1fb4ce72fce0Tejun Heo device_remove_file(dev, &uevent_attr); 10792620efef7029bb040430f50f0fc148f2d5e002adGreg Kroah-Hartman device_remove_attrs(dev); 1080289535334646796fe41f199718e4a731f7411a92Benjamin Herrenschmidt bus_remove_device(dev); 10811da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds 10822f8d16a996da0b9be2536994aa7a825418364471Tejun Heo /* 10832f8d16a996da0b9be2536994aa7a825418364471Tejun Heo * Some platform devices are driven without driver attached 10842f8d16a996da0b9be2536994aa7a825418364471Tejun Heo * and managed resources may have been acquired. Make sure 10852f8d16a996da0b9be2536994aa7a825418364471Tejun Heo * all resources are released. 10862f8d16a996da0b9be2536994aa7a825418364471Tejun Heo */ 10872f8d16a996da0b9be2536994aa7a825418364471Tejun Heo devres_release_all(dev); 10882f8d16a996da0b9be2536994aa7a825418364471Tejun Heo 10891da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds /* Notify the platform of the removal, in case they 10901da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds * need to do anything... 10911da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds */ 10921da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds if (platform_notify_remove) 10931da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds platform_notify_remove(dev); 1094312c004d36ce6c739512bac83b452f4c20ab1f62Kay Sievers kobject_uevent(&dev->kobj, KOBJ_REMOVE); 1095da231fd5d113ab6da5dab7a2d2c38d0a540f939cKay Sievers cleanup_device_parent(dev); 10961da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds kobject_del(&dev->kobj); 1097da231fd5d113ab6da5dab7a2d2c38d0a540f939cKay Sievers put_device(parent); 10981da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds} 10991da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds 11001da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds/** 11014a3ad20ccd8f4d2a0535cf98fa83f7b561ba59a9Greg Kroah-Hartman * device_unregister - unregister device from system. 11024a3ad20ccd8f4d2a0535cf98fa83f7b561ba59a9Greg Kroah-Hartman * @dev: device going away. 11031da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds * 11044a3ad20ccd8f4d2a0535cf98fa83f7b561ba59a9Greg Kroah-Hartman * We do this in two parts, like we do device_register(). First, 11054a3ad20ccd8f4d2a0535cf98fa83f7b561ba59a9Greg Kroah-Hartman * we remove it from all the subsystems with device_del(), then 11064a3ad20ccd8f4d2a0535cf98fa83f7b561ba59a9Greg Kroah-Hartman * we decrement the reference count via put_device(). If that 11074a3ad20ccd8f4d2a0535cf98fa83f7b561ba59a9Greg Kroah-Hartman * is the final reference count, the device will be cleaned up 11084a3ad20ccd8f4d2a0535cf98fa83f7b561ba59a9Greg Kroah-Hartman * via device_release() above. Otherwise, the structure will 11094a3ad20ccd8f4d2a0535cf98fa83f7b561ba59a9Greg Kroah-Hartman * stick around until the final reference to the device is dropped. 11101da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds */ 11114a3ad20ccd8f4d2a0535cf98fa83f7b561ba59a9Greg Kroah-Hartmanvoid device_unregister(struct device *dev) 11121da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds{ 11131e0b2cf933ebf32494eba3f668859ba57f06a951Kay Sievers pr_debug("device: '%s': %s\n", dev_name(dev), __func__); 11141da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds device_del(dev); 11151da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds put_device(dev); 11161da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds} 11171da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds 11184a3ad20ccd8f4d2a0535cf98fa83f7b561ba59a9Greg Kroah-Hartmanstatic struct device *next_device(struct klist_iter *i) 111936239577cfb6b9a7c111209536b54200b0252ebfPatrick Mochel{ 11204a3ad20ccd8f4d2a0535cf98fa83f7b561ba59a9Greg Kroah-Hartman struct klist_node *n = klist_next(i); 1121f791b8c836307b58cbf62133a6a772ed1a92fb33Greg Kroah-Hartman struct device *dev = NULL; 1122f791b8c836307b58cbf62133a6a772ed1a92fb33Greg Kroah-Hartman struct device_private *p; 1123f791b8c836307b58cbf62133a6a772ed1a92fb33Greg Kroah-Hartman 1124f791b8c836307b58cbf62133a6a772ed1a92fb33Greg Kroah-Hartman if (n) { 1125f791b8c836307b58cbf62133a6a772ed1a92fb33Greg Kroah-Hartman p = to_device_private_parent(n); 1126f791b8c836307b58cbf62133a6a772ed1a92fb33Greg Kroah-Hartman dev = p->device; 1127f791b8c836307b58cbf62133a6a772ed1a92fb33Greg Kroah-Hartman } 1128f791b8c836307b58cbf62133a6a772ed1a92fb33Greg Kroah-Hartman return dev; 112936239577cfb6b9a7c111209536b54200b0252ebfPatrick Mochel} 113036239577cfb6b9a7c111209536b54200b0252ebfPatrick Mochel 11311da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds/** 11324a3ad20ccd8f4d2a0535cf98fa83f7b561ba59a9Greg Kroah-Hartman * device_for_each_child - device child iterator. 11334a3ad20ccd8f4d2a0535cf98fa83f7b561ba59a9Greg Kroah-Hartman * @parent: parent struct device. 11344a3ad20ccd8f4d2a0535cf98fa83f7b561ba59a9Greg Kroah-Hartman * @data: data for the callback. 11354a3ad20ccd8f4d2a0535cf98fa83f7b561ba59a9Greg Kroah-Hartman * @fn: function to be called for each device. 11361da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds * 11374a3ad20ccd8f4d2a0535cf98fa83f7b561ba59a9Greg Kroah-Hartman * Iterate over @parent's child devices, and call @fn for each, 11384a3ad20ccd8f4d2a0535cf98fa83f7b561ba59a9Greg Kroah-Hartman * passing it @data. 11391da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds * 11404a3ad20ccd8f4d2a0535cf98fa83f7b561ba59a9Greg Kroah-Hartman * We check the return of @fn each time. If it returns anything 11414a3ad20ccd8f4d2a0535cf98fa83f7b561ba59a9Greg Kroah-Hartman * other than 0, we break out and return that value. 11421da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds */ 11434a3ad20ccd8f4d2a0535cf98fa83f7b561ba59a9Greg Kroah-Hartmanint device_for_each_child(struct device *parent, void *data, 11444a3ad20ccd8f4d2a0535cf98fa83f7b561ba59a9Greg Kroah-Hartman int (*fn)(struct device *dev, void *data)) 11451da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds{ 114636239577cfb6b9a7c111209536b54200b0252ebfPatrick Mochel struct klist_iter i; 11474a3ad20ccd8f4d2a0535cf98fa83f7b561ba59a9Greg Kroah-Hartman struct device *child; 11481da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds int error = 0; 11491da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds 1150014c90dbb9b63bae067afc80a7931a76c5268ae3Greg Kroah-Hartman if (!parent->p) 1151014c90dbb9b63bae067afc80a7931a76c5268ae3Greg Kroah-Hartman return 0; 1152014c90dbb9b63bae067afc80a7931a76c5268ae3Greg Kroah-Hartman 1153f791b8c836307b58cbf62133a6a772ed1a92fb33Greg Kroah-Hartman klist_iter_init(&parent->p->klist_children, &i); 115436239577cfb6b9a7c111209536b54200b0252ebfPatrick Mochel while ((child = next_device(&i)) && !error) 115536239577cfb6b9a7c111209536b54200b0252ebfPatrick Mochel error = fn(child, data); 115636239577cfb6b9a7c111209536b54200b0252ebfPatrick Mochel klist_iter_exit(&i); 11571da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds return error; 11581da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds} 11591da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds 11605ab699810d46011ad2195c5916f3cbc684bfe3eeCornelia Huck/** 11615ab699810d46011ad2195c5916f3cbc684bfe3eeCornelia Huck * device_find_child - device iterator for locating a particular device. 11625ab699810d46011ad2195c5916f3cbc684bfe3eeCornelia Huck * @parent: parent struct device 11635ab699810d46011ad2195c5916f3cbc684bfe3eeCornelia Huck * @data: Data to pass to match function 11645ab699810d46011ad2195c5916f3cbc684bfe3eeCornelia Huck * @match: Callback function to check device 11655ab699810d46011ad2195c5916f3cbc684bfe3eeCornelia Huck * 11665ab699810d46011ad2195c5916f3cbc684bfe3eeCornelia Huck * This is similar to the device_for_each_child() function above, but it 11675ab699810d46011ad2195c5916f3cbc684bfe3eeCornelia Huck * returns a reference to a device that is 'found' for later use, as 11685ab699810d46011ad2195c5916f3cbc684bfe3eeCornelia Huck * determined by the @match callback. 11695ab699810d46011ad2195c5916f3cbc684bfe3eeCornelia Huck * 11705ab699810d46011ad2195c5916f3cbc684bfe3eeCornelia Huck * The callback should return 0 if the device doesn't match and non-zero 11715ab699810d46011ad2195c5916f3cbc684bfe3eeCornelia Huck * if it does. If the callback returns non-zero and a reference to the 11725ab699810d46011ad2195c5916f3cbc684bfe3eeCornelia Huck * current device can be obtained, this function will return to the caller 11735ab699810d46011ad2195c5916f3cbc684bfe3eeCornelia Huck * and not iterate over any more devices. 11745ab699810d46011ad2195c5916f3cbc684bfe3eeCornelia Huck */ 11754a3ad20ccd8f4d2a0535cf98fa83f7b561ba59a9Greg Kroah-Hartmanstruct device *device_find_child(struct device *parent, void *data, 11764a3ad20ccd8f4d2a0535cf98fa83f7b561ba59a9Greg Kroah-Hartman int (*match)(struct device *dev, void *data)) 11775ab699810d46011ad2195c5916f3cbc684bfe3eeCornelia Huck{ 11785ab699810d46011ad2195c5916f3cbc684bfe3eeCornelia Huck struct klist_iter i; 11795ab699810d46011ad2195c5916f3cbc684bfe3eeCornelia Huck struct device *child; 11805ab699810d46011ad2195c5916f3cbc684bfe3eeCornelia Huck 11815ab699810d46011ad2195c5916f3cbc684bfe3eeCornelia Huck if (!parent) 11825ab699810d46011ad2195c5916f3cbc684bfe3eeCornelia Huck return NULL; 11835ab699810d46011ad2195c5916f3cbc684bfe3eeCornelia Huck 1184f791b8c836307b58cbf62133a6a772ed1a92fb33Greg Kroah-Hartman klist_iter_init(&parent->p->klist_children, &i); 11855ab699810d46011ad2195c5916f3cbc684bfe3eeCornelia Huck while ((child = next_device(&i))) 11865ab699810d46011ad2195c5916f3cbc684bfe3eeCornelia Huck if (match(child, data) && get_device(child)) 11875ab699810d46011ad2195c5916f3cbc684bfe3eeCornelia Huck break; 11885ab699810d46011ad2195c5916f3cbc684bfe3eeCornelia Huck klist_iter_exit(&i); 11895ab699810d46011ad2195c5916f3cbc684bfe3eeCornelia Huck return child; 11905ab699810d46011ad2195c5916f3cbc684bfe3eeCornelia Huck} 11915ab699810d46011ad2195c5916f3cbc684bfe3eeCornelia Huck 11921da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvaldsint __init devices_init(void) 11931da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds{ 1194881c6cfd7c5edfe6129006e2404654bfe5911050Greg Kroah-Hartman devices_kset = kset_create_and_add("devices", &device_uevent_ops, NULL); 1195881c6cfd7c5edfe6129006e2404654bfe5911050Greg Kroah-Hartman if (!devices_kset) 1196881c6cfd7c5edfe6129006e2404654bfe5911050Greg Kroah-Hartman return -ENOMEM; 1197e105b8bfc769b0545b6f0f395179d1e43cbee822Dan Williams dev_kobj = kobject_create_and_add("dev", NULL); 1198e105b8bfc769b0545b6f0f395179d1e43cbee822Dan Williams if (!dev_kobj) 1199e105b8bfc769b0545b6f0f395179d1e43cbee822Dan Williams goto dev_kobj_err; 1200e105b8bfc769b0545b6f0f395179d1e43cbee822Dan Williams sysfs_dev_block_kobj = kobject_create_and_add("block", dev_kobj); 1201e105b8bfc769b0545b6f0f395179d1e43cbee822Dan Williams if (!sysfs_dev_block_kobj) 1202e105b8bfc769b0545b6f0f395179d1e43cbee822Dan Williams goto block_kobj_err; 1203e105b8bfc769b0545b6f0f395179d1e43cbee822Dan Williams sysfs_dev_char_kobj = kobject_create_and_add("char", dev_kobj); 1204e105b8bfc769b0545b6f0f395179d1e43cbee822Dan Williams if (!sysfs_dev_char_kobj) 1205e105b8bfc769b0545b6f0f395179d1e43cbee822Dan Williams goto char_kobj_err; 1206e105b8bfc769b0545b6f0f395179d1e43cbee822Dan Williams 1207881c6cfd7c5edfe6129006e2404654bfe5911050Greg Kroah-Hartman return 0; 1208e105b8bfc769b0545b6f0f395179d1e43cbee822Dan Williams 1209e105b8bfc769b0545b6f0f395179d1e43cbee822Dan Williams char_kobj_err: 1210e105b8bfc769b0545b6f0f395179d1e43cbee822Dan Williams kobject_put(sysfs_dev_block_kobj); 1211e105b8bfc769b0545b6f0f395179d1e43cbee822Dan Williams block_kobj_err: 1212e105b8bfc769b0545b6f0f395179d1e43cbee822Dan Williams kobject_put(dev_kobj); 1213e105b8bfc769b0545b6f0f395179d1e43cbee822Dan Williams dev_kobj_err: 1214e105b8bfc769b0545b6f0f395179d1e43cbee822Dan Williams kset_unregister(devices_kset); 1215e105b8bfc769b0545b6f0f395179d1e43cbee822Dan Williams return -ENOMEM; 12161da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds} 12171da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds 12181da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus TorvaldsEXPORT_SYMBOL_GPL(device_for_each_child); 12195ab699810d46011ad2195c5916f3cbc684bfe3eeCornelia HuckEXPORT_SYMBOL_GPL(device_find_child); 12201da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds 12211da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus TorvaldsEXPORT_SYMBOL_GPL(device_initialize); 12221da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus TorvaldsEXPORT_SYMBOL_GPL(device_add); 12231da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus TorvaldsEXPORT_SYMBOL_GPL(device_register); 12241da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds 12251da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus TorvaldsEXPORT_SYMBOL_GPL(device_del); 12261da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus TorvaldsEXPORT_SYMBOL_GPL(device_unregister); 12271da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus TorvaldsEXPORT_SYMBOL_GPL(get_device); 12281da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus TorvaldsEXPORT_SYMBOL_GPL(put_device); 12291da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus Torvalds 12301da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus TorvaldsEXPORT_SYMBOL_GPL(device_create_file); 12311da177e4c3f41524e886b7f1b8a0c1fc7321cacLinus TorvaldsEXPORT_SYMBOL_GPL(device_remove_file); 123223681e479129854305da1da32f7f1eaf635ef22cGreg Kroah-Hartman 12330aa0dc41bfd993491c2344870eee7a3b218551fbMark McLoughlinstruct root_device 12340aa0dc41bfd993491c2344870eee7a3b218551fbMark McLoughlin{ 12350aa0dc41bfd993491c2344870eee7a3b218551fbMark McLoughlin struct device dev; 12360aa0dc41bfd993491c2344870eee7a3b218551fbMark McLoughlin struct module *owner; 12370aa0dc41bfd993491c2344870eee7a3b218551fbMark McLoughlin}; 12380aa0dc41bfd993491c2344870eee7a3b218551fbMark McLoughlin 12390aa0dc41bfd993491c2344870eee7a3b218551fbMark McLoughlin#define to_root_device(dev) container_of(dev, struct root_device, dev) 12400aa0dc41bfd993491c2344870eee7a3b218551fbMark McLoughlin 12410aa0dc41bfd993491c2344870eee7a3b218551fbMark McLoughlinstatic void root_device_release(struct device *dev) 12420aa0dc41bfd993491c2344870eee7a3b218551fbMark McLoughlin{ 12430aa0dc41bfd993491c2344870eee7a3b218551fbMark McLoughlin kfree(to_root_device(dev)); 12440aa0dc41bfd993491c2344870eee7a3b218551fbMark McLoughlin} 12450aa0dc41bfd993491c2344870eee7a3b218551fbMark McLoughlin 12460aa0dc41bfd993491c2344870eee7a3b218551fbMark McLoughlin/** 12470aa0dc41bfd993491c2344870eee7a3b218551fbMark McLoughlin * __root_device_register - allocate and register a root device 12480aa0dc41bfd993491c2344870eee7a3b218551fbMark McLoughlin * @name: root device name 12490aa0dc41bfd993491c2344870eee7a3b218551fbMark McLoughlin * @owner: owner module of the root device, usually THIS_MODULE 12500aa0dc41bfd993491c2344870eee7a3b218551fbMark McLoughlin * 12510aa0dc41bfd993491c2344870eee7a3b218551fbMark McLoughlin * This function allocates a root device and registers it 12520aa0dc41bfd993491c2344870eee7a3b218551fbMark McLoughlin * using device_register(). In order to free the returned 12530aa0dc41bfd993491c2344870eee7a3b218551fbMark McLoughlin * device, use root_device_unregister(). 12540aa0dc41bfd993491c2344870eee7a3b218551fbMark McLoughlin * 12550aa0dc41bfd993491c2344870eee7a3b218551fbMark McLoughlin * Root devices are dummy devices which allow other devices 12560aa0dc41bfd993491c2344870eee7a3b218551fbMark McLoughlin * to be grouped under /sys/devices. Use this function to 12570aa0dc41bfd993491c2344870eee7a3b218551fbMark McLoughlin * allocate a root device and then use it as the parent of 12580aa0dc41bfd993491c2344870eee7a3b218551fbMark McLoughlin * any device which should appear under /sys/devices/{name} 12590aa0dc41bfd993491c2344870eee7a3b218551fbMark McLoughlin * 12600aa0dc41bfd993491c2344870eee7a3b218551fbMark McLoughlin * The /sys/devices/{name} directory will also contain a 12610aa0dc41bfd993491c2344870eee7a3b218551fbMark McLoughlin * 'module' symlink which points to the @owner directory 12620aa0dc41bfd993491c2344870eee7a3b218551fbMark McLoughlin * in sysfs. 12630aa0dc41bfd993491c2344870eee7a3b218551fbMark McLoughlin * 12640aa0dc41bfd993491c2344870eee7a3b218551fbMark McLoughlin * Note: You probably want to use root_device_register(). 12650aa0dc41bfd993491c2344870eee7a3b218551fbMark McLoughlin */ 12660aa0dc41bfd993491c2344870eee7a3b218551fbMark McLoughlinstruct device *__root_device_register(const char *name, struct module *owner) 12670aa0dc41bfd993491c2344870eee7a3b218551fbMark McLoughlin{ 12680aa0dc41bfd993491c2344870eee7a3b218551fbMark McLoughlin struct root_device *root; 12690aa0dc41bfd993491c2344870eee7a3b218551fbMark McLoughlin int err = -ENOMEM; 12700aa0dc41bfd993491c2344870eee7a3b218551fbMark McLoughlin 12710aa0dc41bfd993491c2344870eee7a3b218551fbMark McLoughlin root = kzalloc(sizeof(struct root_device), GFP_KERNEL); 12720aa0dc41bfd993491c2344870eee7a3b218551fbMark McLoughlin if (!root) 12730aa0dc41bfd993491c2344870eee7a3b218551fbMark McLoughlin return ERR_PTR(err); 12740aa0dc41bfd993491c2344870eee7a3b218551fbMark McLoughlin 1275acc0e90fbccbc6e4d48184cba0983ea044e131afGreg Kroah-Hartman err = dev_set_name(&root->dev, "%s", name); 12760aa0dc41bfd993491c2344870eee7a3b218551fbMark McLoughlin if (err) { 12770aa0dc41bfd993491c2344870eee7a3b218551fbMark McLoughlin kfree(root); 12780aa0dc41bfd993491c2344870eee7a3b218551fbMark McLoughlin return ERR_PTR(err); 12790aa0dc41bfd993491c2344870eee7a3b218551fbMark McLoughlin } 12800aa0dc41bfd993491c2344870eee7a3b218551fbMark McLoughlin 12810aa0dc41bfd993491c2344870eee7a3b218551fbMark McLoughlin root->dev.release = root_device_release; 12820aa0dc41bfd993491c2344870eee7a3b218551fbMark McLoughlin 12830aa0dc41bfd993491c2344870eee7a3b218551fbMark McLoughlin err = device_register(&root->dev); 12840aa0dc41bfd993491c2344870eee7a3b218551fbMark McLoughlin if (err) { 12850aa0dc41bfd993491c2344870eee7a3b218551fbMark McLoughlin put_device(&root->dev); 12860aa0dc41bfd993491c2344870eee7a3b218551fbMark McLoughlin return ERR_PTR(err); 12870aa0dc41bfd993491c2344870eee7a3b218551fbMark McLoughlin } 12880aa0dc41bfd993491c2344870eee7a3b218551fbMark McLoughlin 12890aa0dc41bfd993491c2344870eee7a3b218551fbMark McLoughlin#ifdef CONFIG_MODULE /* gotta find a "cleaner" way to do this */ 12900aa0dc41bfd993491c2344870eee7a3b218551fbMark McLoughlin if (owner) { 12910aa0dc41bfd993491c2344870eee7a3b218551fbMark McLoughlin struct module_kobject *mk = &owner->mkobj; 12920aa0dc41bfd993491c2344870eee7a3b218551fbMark McLoughlin 12930aa0dc41bfd993491c2344870eee7a3b218551fbMark McLoughlin err = sysfs_create_link(&root->dev.kobj, &mk->kobj, "module"); 12940aa0dc41bfd993491c2344870eee7a3b218551fbMark McLoughlin if (err) { 12950aa0dc41bfd993491c2344870eee7a3b218551fbMark McLoughlin device_unregister(&root->dev); 12960aa0dc41bfd993491c2344870eee7a3b218551fbMark McLoughlin return ERR_PTR(err); 12970aa0dc41bfd993491c2344870eee7a3b218551fbMark McLoughlin } 12980aa0dc41bfd993491c2344870eee7a3b218551fbMark McLoughlin root->owner = owner; 12990aa0dc41bfd993491c2344870eee7a3b218551fbMark McLoughlin } 13000aa0dc41bfd993491c2344870eee7a3b218551fbMark McLoughlin#endif 13010aa0dc41bfd993491c2344870eee7a3b218551fbMark McLoughlin 13020aa0dc41bfd993491c2344870eee7a3b218551fbMark McLoughlin return &root->dev; 13030aa0dc41bfd993491c2344870eee7a3b218551fbMark McLoughlin} 13040aa0dc41bfd993491c2344870eee7a3b218551fbMark McLoughlinEXPORT_SYMBOL_GPL(__root_device_register); 13050aa0dc41bfd993491c2344870eee7a3b218551fbMark McLoughlin 13060aa0dc41bfd993491c2344870eee7a3b218551fbMark McLoughlin/** 13070aa0dc41bfd993491c2344870eee7a3b218551fbMark McLoughlin * root_device_unregister - unregister and free a root device 13087cbcf22548df1f1df7c6b0d0bda579b92efca63cRandy Dunlap * @dev: device going away 13090aa0dc41bfd993491c2344870eee7a3b218551fbMark McLoughlin * 13100aa0dc41bfd993491c2344870eee7a3b218551fbMark McLoughlin * This function unregisters and cleans up a device that was created by 13110aa0dc41bfd993491c2344870eee7a3b218551fbMark McLoughlin * root_device_register(). 13120aa0dc41bfd993491c2344870eee7a3b218551fbMark McLoughlin */ 13130aa0dc41bfd993491c2344870eee7a3b218551fbMark McLoughlinvoid root_device_unregister(struct device *dev) 13140aa0dc41bfd993491c2344870eee7a3b218551fbMark McLoughlin{ 13150aa0dc41bfd993491c2344870eee7a3b218551fbMark McLoughlin struct root_device *root = to_root_device(dev); 13160aa0dc41bfd993491c2344870eee7a3b218551fbMark McLoughlin 13170aa0dc41bfd993491c2344870eee7a3b218551fbMark McLoughlin if (root->owner) 13180aa0dc41bfd993491c2344870eee7a3b218551fbMark McLoughlin sysfs_remove_link(&root->dev.kobj, "module"); 13190aa0dc41bfd993491c2344870eee7a3b218551fbMark McLoughlin 13200aa0dc41bfd993491c2344870eee7a3b218551fbMark McLoughlin device_unregister(dev); 13210aa0dc41bfd993491c2344870eee7a3b218551fbMark McLoughlin} 13220aa0dc41bfd993491c2344870eee7a3b218551fbMark McLoughlinEXPORT_SYMBOL_GPL(root_device_unregister); 13230aa0dc41bfd993491c2344870eee7a3b218551fbMark McLoughlin 132423681e479129854305da1da32f7f1eaf635ef22cGreg Kroah-Hartman 132523681e479129854305da1da32f7f1eaf635ef22cGreg Kroah-Hartmanstatic void device_create_release(struct device *dev) 132623681e479129854305da1da32f7f1eaf635ef22cGreg Kroah-Hartman{ 13271e0b2cf933ebf32494eba3f668859ba57f06a951Kay Sievers pr_debug("device: '%s': %s\n", dev_name(dev), __func__); 132823681e479129854305da1da32f7f1eaf635ef22cGreg Kroah-Hartman kfree(dev); 132923681e479129854305da1da32f7f1eaf635ef22cGreg Kroah-Hartman} 133023681e479129854305da1da32f7f1eaf635ef22cGreg Kroah-Hartman 133123681e479129854305da1da32f7f1eaf635ef22cGreg Kroah-Hartman/** 13328882b39421bae317e3ee864edd845e994307ce16Greg Kroah-Hartman * device_create_vargs - creates a device and registers it with sysfs 133342734dafa43e453a8b6769a5ebd3a01ffc1fd116Henrik Kretzschmar * @class: pointer to the struct class that this device should be registered to 133442734dafa43e453a8b6769a5ebd3a01ffc1fd116Henrik Kretzschmar * @parent: pointer to the parent struct device of this new device, if any 133542734dafa43e453a8b6769a5ebd3a01ffc1fd116Henrik Kretzschmar * @devt: the dev_t for the char device to be added 13368882b39421bae317e3ee864edd845e994307ce16Greg Kroah-Hartman * @drvdata: the data to be added to the device for callbacks 133742734dafa43e453a8b6769a5ebd3a01ffc1fd116Henrik Kretzschmar * @fmt: string for the device's name 13388882b39421bae317e3ee864edd845e994307ce16Greg Kroah-Hartman * @args: va_list for the device's name 133942734dafa43e453a8b6769a5ebd3a01ffc1fd116Henrik Kretzschmar * 134042734dafa43e453a8b6769a5ebd3a01ffc1fd116Henrik Kretzschmar * This function can be used by char device classes. A struct device 134142734dafa43e453a8b6769a5ebd3a01ffc1fd116Henrik Kretzschmar * will be created in sysfs, registered to the specified class. 134223681e479129854305da1da32f7f1eaf635ef22cGreg Kroah-Hartman * 134323681e479129854305da1da32f7f1eaf635ef22cGreg Kroah-Hartman * A "dev" file will be created, showing the dev_t for the device, if 134423681e479129854305da1da32f7f1eaf635ef22cGreg Kroah-Hartman * the dev_t is not 0,0. 134542734dafa43e453a8b6769a5ebd3a01ffc1fd116Henrik Kretzschmar * If a pointer to a parent struct device is passed in, the newly created 134642734dafa43e453a8b6769a5ebd3a01ffc1fd116Henrik Kretzschmar * struct device will be a child of that device in sysfs. 134742734dafa43e453a8b6769a5ebd3a01ffc1fd116Henrik Kretzschmar * The pointer to the struct device will be returned from the call. 134842734dafa43e453a8b6769a5ebd3a01ffc1fd116Henrik Kretzschmar * Any further sysfs files that might be required can be created using this 134923681e479129854305da1da32f7f1eaf635ef22cGreg Kroah-Hartman * pointer. 135023681e479129854305da1da32f7f1eaf635ef22cGreg Kroah-Hartman * 135123681e479129854305da1da32f7f1eaf635ef22cGreg Kroah-Hartman * Note: the struct class passed to this function must have previously 135223681e479129854305da1da32f7f1eaf635ef22cGreg Kroah-Hartman * been created with a call to class_create(). 135323681e479129854305da1da32f7f1eaf635ef22cGreg Kroah-Hartman */ 13548882b39421bae317e3ee864edd845e994307ce16Greg Kroah-Hartmanstruct device *device_create_vargs(struct class *class, struct device *parent, 13558882b39421bae317e3ee864edd845e994307ce16Greg Kroah-Hartman dev_t devt, void *drvdata, const char *fmt, 13568882b39421bae317e3ee864edd845e994307ce16Greg Kroah-Hartman va_list args) 135723681e479129854305da1da32f7f1eaf635ef22cGreg Kroah-Hartman{ 135823681e479129854305da1da32f7f1eaf635ef22cGreg Kroah-Hartman struct device *dev = NULL; 135923681e479129854305da1da32f7f1eaf635ef22cGreg Kroah-Hartman int retval = -ENODEV; 136023681e479129854305da1da32f7f1eaf635ef22cGreg Kroah-Hartman 136123681e479129854305da1da32f7f1eaf635ef22cGreg Kroah-Hartman if (class == NULL || IS_ERR(class)) 136223681e479129854305da1da32f7f1eaf635ef22cGreg Kroah-Hartman goto error; 136323681e479129854305da1da32f7f1eaf635ef22cGreg Kroah-Hartman 136423681e479129854305da1da32f7f1eaf635ef22cGreg Kroah-Hartman dev = kzalloc(sizeof(*dev), GFP_KERNEL); 136523681e479129854305da1da32f7f1eaf635ef22cGreg Kroah-Hartman if (!dev) { 136623681e479129854305da1da32f7f1eaf635ef22cGreg Kroah-Hartman retval = -ENOMEM; 136723681e479129854305da1da32f7f1eaf635ef22cGreg Kroah-Hartman goto error; 136823681e479129854305da1da32f7f1eaf635ef22cGreg Kroah-Hartman } 136923681e479129854305da1da32f7f1eaf635ef22cGreg Kroah-Hartman 137023681e479129854305da1da32f7f1eaf635ef22cGreg Kroah-Hartman dev->devt = devt; 137123681e479129854305da1da32f7f1eaf635ef22cGreg Kroah-Hartman dev->class = class; 137223681e479129854305da1da32f7f1eaf635ef22cGreg Kroah-Hartman dev->parent = parent; 137323681e479129854305da1da32f7f1eaf635ef22cGreg Kroah-Hartman dev->release = device_create_release; 13748882b39421bae317e3ee864edd845e994307ce16Greg Kroah-Hartman dev_set_drvdata(dev, drvdata); 137523681e479129854305da1da32f7f1eaf635ef22cGreg Kroah-Hartman 13761fa5ae857bb14f6046205171d98506d8112dd74eKay Sievers retval = kobject_set_name_vargs(&dev->kobj, fmt, args); 13771fa5ae857bb14f6046205171d98506d8112dd74eKay Sievers if (retval) 13781fa5ae857bb14f6046205171d98506d8112dd74eKay Sievers goto error; 13791fa5ae857bb14f6046205171d98506d8112dd74eKay Sievers 138023681e479129854305da1da32f7f1eaf635ef22cGreg Kroah-Hartman retval = device_register(dev); 138123681e479129854305da1da32f7f1eaf635ef22cGreg Kroah-Hartman if (retval) 138223681e479129854305da1da32f7f1eaf635ef22cGreg Kroah-Hartman goto error; 138323681e479129854305da1da32f7f1eaf635ef22cGreg Kroah-Hartman 138423681e479129854305da1da32f7f1eaf635ef22cGreg Kroah-Hartman return dev; 138523681e479129854305da1da32f7f1eaf635ef22cGreg Kroah-Hartman 138623681e479129854305da1da32f7f1eaf635ef22cGreg Kroah-Hartmanerror: 1387286661b3777897220ecfcd774bccc68a34667f39Cornelia Huck put_device(dev); 138823681e479129854305da1da32f7f1eaf635ef22cGreg Kroah-Hartman return ERR_PTR(retval); 138923681e479129854305da1da32f7f1eaf635ef22cGreg Kroah-Hartman} 13908882b39421bae317e3ee864edd845e994307ce16Greg Kroah-HartmanEXPORT_SYMBOL_GPL(device_create_vargs); 13918882b39421bae317e3ee864edd845e994307ce16Greg Kroah-Hartman 13928882b39421bae317e3ee864edd845e994307ce16Greg Kroah-Hartman/** 13934e10673944a5c386378ff9d692ae37e19993f9d5Greg Kroah-Hartman * device_create - creates a device and registers it with sysfs 13948882b39421bae317e3ee864edd845e994307ce16Greg Kroah-Hartman * @class: pointer to the struct class that this device should be registered to 13958882b39421bae317e3ee864edd845e994307ce16Greg Kroah-Hartman * @parent: pointer to the parent struct device of this new device, if any 13968882b39421bae317e3ee864edd845e994307ce16Greg Kroah-Hartman * @devt: the dev_t for the char device to be added 13978882b39421bae317e3ee864edd845e994307ce16Greg Kroah-Hartman * @drvdata: the data to be added to the device for callbacks 13988882b39421bae317e3ee864edd845e994307ce16Greg Kroah-Hartman * @fmt: string for the device's name 13998882b39421bae317e3ee864edd845e994307ce16Greg Kroah-Hartman * 14008882b39421bae317e3ee864edd845e994307ce16Greg Kroah-Hartman * This function can be used by char device classes. A struct device 14018882b39421bae317e3ee864edd845e994307ce16Greg Kroah-Hartman * will be created in sysfs, registered to the specified class. 14028882b39421bae317e3ee864edd845e994307ce16Greg Kroah-Hartman * 14038882b39421bae317e3ee864edd845e994307ce16Greg Kroah-Hartman * A "dev" file will be created, showing the dev_t for the device, if 14048882b39421bae317e3ee864edd845e994307ce16Greg Kroah-Hartman * the dev_t is not 0,0. 14058882b39421bae317e3ee864edd845e994307ce16Greg Kroah-Hartman * If a pointer to a parent struct device is passed in, the newly created 14068882b39421bae317e3ee864edd845e994307ce16Greg Kroah-Hartman * struct device will be a child of that device in sysfs. 14078882b39421bae317e3ee864edd845e994307ce16Greg Kroah-Hartman * The pointer to the struct device will be returned from the call. 14088882b39421bae317e3ee864edd845e994307ce16Greg Kroah-Hartman * Any further sysfs files that might be required can be created using this 14098882b39421bae317e3ee864edd845e994307ce16Greg Kroah-Hartman * pointer. 14108882b39421bae317e3ee864edd845e994307ce16Greg Kroah-Hartman * 14118882b39421bae317e3ee864edd845e994307ce16Greg Kroah-Hartman * Note: the struct class passed to this function must have previously 14128882b39421bae317e3ee864edd845e994307ce16Greg Kroah-Hartman * been created with a call to class_create(). 14138882b39421bae317e3ee864edd845e994307ce16Greg Kroah-Hartman */ 14144e10673944a5c386378ff9d692ae37e19993f9d5Greg Kroah-Hartmanstruct device *device_create(struct class *class, struct device *parent, 14154e10673944a5c386378ff9d692ae37e19993f9d5Greg Kroah-Hartman dev_t devt, void *drvdata, const char *fmt, ...) 14168882b39421bae317e3ee864edd845e994307ce16Greg Kroah-Hartman{ 14178882b39421bae317e3ee864edd845e994307ce16Greg Kroah-Hartman va_list vargs; 14188882b39421bae317e3ee864edd845e994307ce16Greg Kroah-Hartman struct device *dev; 14198882b39421bae317e3ee864edd845e994307ce16Greg Kroah-Hartman 14208882b39421bae317e3ee864edd845e994307ce16Greg Kroah-Hartman va_start(vargs, fmt); 14218882b39421bae317e3ee864edd845e994307ce16Greg Kroah-Hartman dev = device_create_vargs(class, parent, devt, drvdata, fmt, vargs); 14228882b39421bae317e3ee864edd845e994307ce16Greg Kroah-Hartman va_end(vargs); 14238882b39421bae317e3ee864edd845e994307ce16Greg Kroah-Hartman return dev; 14248882b39421bae317e3ee864edd845e994307ce16Greg Kroah-Hartman} 14254e10673944a5c386378ff9d692ae37e19993f9d5Greg Kroah-HartmanEXPORT_SYMBOL_GPL(device_create); 14268882b39421bae317e3ee864edd845e994307ce16Greg Kroah-Hartman 1427cd35449b93ac128282c1f1f720e84c5935f9018eDave Youngstatic int __match_devt(struct device *dev, void *data) 142823681e479129854305da1da32f7f1eaf635ef22cGreg Kroah-Hartman{ 1429cd35449b93ac128282c1f1f720e84c5935f9018eDave Young dev_t *devt = data; 143023681e479129854305da1da32f7f1eaf635ef22cGreg Kroah-Hartman 1431cd35449b93ac128282c1f1f720e84c5935f9018eDave Young return dev->devt == *devt; 1432775b64d2b6ca37697de925f70799c710aab5849aRafael J. Wysocki} 1433775b64d2b6ca37697de925f70799c710aab5849aRafael J. Wysocki 1434775b64d2b6ca37697de925f70799c710aab5849aRafael J. Wysocki/** 1435775b64d2b6ca37697de925f70799c710aab5849aRafael J. Wysocki * device_destroy - removes a device that was created with device_create() 1436775b64d2b6ca37697de925f70799c710aab5849aRafael J. Wysocki * @class: pointer to the struct class that this device was registered with 1437775b64d2b6ca37697de925f70799c710aab5849aRafael J. Wysocki * @devt: the dev_t of the device that was previously registered 1438775b64d2b6ca37697de925f70799c710aab5849aRafael J. Wysocki * 1439775b64d2b6ca37697de925f70799c710aab5849aRafael J. Wysocki * This call unregisters and cleans up a device that was created with a 1440775b64d2b6ca37697de925f70799c710aab5849aRafael J. Wysocki * call to device_create(). 1441775b64d2b6ca37697de925f70799c710aab5849aRafael J. Wysocki */ 1442775b64d2b6ca37697de925f70799c710aab5849aRafael J. Wysockivoid device_destroy(struct class *class, dev_t devt) 1443775b64d2b6ca37697de925f70799c710aab5849aRafael J. Wysocki{ 1444775b64d2b6ca37697de925f70799c710aab5849aRafael J. Wysocki struct device *dev; 144523681e479129854305da1da32f7f1eaf635ef22cGreg Kroah-Hartman 1446695794ae0c5bdd9bd06e35b118801e2e9be04f9eGreg Kroah-Hartman dev = class_find_device(class, NULL, &devt, __match_devt); 1447cd35449b93ac128282c1f1f720e84c5935f9018eDave Young if (dev) { 1448cd35449b93ac128282c1f1f720e84c5935f9018eDave Young put_device(dev); 144923681e479129854305da1da32f7f1eaf635ef22cGreg Kroah-Hartman device_unregister(dev); 1450cd35449b93ac128282c1f1f720e84c5935f9018eDave Young } 145123681e479129854305da1da32f7f1eaf635ef22cGreg Kroah-Hartman} 145223681e479129854305da1da32f7f1eaf635ef22cGreg Kroah-HartmanEXPORT_SYMBOL_GPL(device_destroy); 1453a2de48cace5d0993da6cfa28b276ae724dc3569bGreg Kroah-Hartman 1454a2de48cace5d0993da6cfa28b276ae724dc3569bGreg Kroah-Hartman/** 1455a2de48cace5d0993da6cfa28b276ae724dc3569bGreg Kroah-Hartman * device_rename - renames a device 1456a2de48cace5d0993da6cfa28b276ae724dc3569bGreg Kroah-Hartman * @dev: the pointer to the struct device to be renamed 1457a2de48cace5d0993da6cfa28b276ae724dc3569bGreg Kroah-Hartman * @new_name: the new name of the device 1458030c1d2bfcc2187650fb975456ca0b61a5bb77f4Eric W. Biederman * 1459030c1d2bfcc2187650fb975456ca0b61a5bb77f4Eric W. Biederman * It is the responsibility of the caller to provide mutual 1460030c1d2bfcc2187650fb975456ca0b61a5bb77f4Eric W. Biederman * exclusion between two different calls of device_rename 1461030c1d2bfcc2187650fb975456ca0b61a5bb77f4Eric W. Biederman * on the same device to ensure that new_name is valid and 1462030c1d2bfcc2187650fb975456ca0b61a5bb77f4Eric W. Biederman * won't conflict with other devices. 1463a2de48cace5d0993da6cfa28b276ae724dc3569bGreg Kroah-Hartman */ 1464a2de48cace5d0993da6cfa28b276ae724dc3569bGreg Kroah-Hartmanint device_rename(struct device *dev, char *new_name) 1465a2de48cace5d0993da6cfa28b276ae724dc3569bGreg Kroah-Hartman{ 1466a2de48cace5d0993da6cfa28b276ae724dc3569bGreg Kroah-Hartman char *old_class_name = NULL; 1467a2de48cace5d0993da6cfa28b276ae724dc3569bGreg Kroah-Hartman char *new_class_name = NULL; 14682ee97caf0a6602f749ddbfdb1449e383e1212707Cornelia Huck char *old_device_name = NULL; 1469a2de48cace5d0993da6cfa28b276ae724dc3569bGreg Kroah-Hartman int error; 1470a2de48cace5d0993da6cfa28b276ae724dc3569bGreg Kroah-Hartman 1471a2de48cace5d0993da6cfa28b276ae724dc3569bGreg Kroah-Hartman dev = get_device(dev); 1472a2de48cace5d0993da6cfa28b276ae724dc3569bGreg Kroah-Hartman if (!dev) 1473a2de48cace5d0993da6cfa28b276ae724dc3569bGreg Kroah-Hartman return -EINVAL; 1474a2de48cace5d0993da6cfa28b276ae724dc3569bGreg Kroah-Hartman 14751e0b2cf933ebf32494eba3f668859ba57f06a951Kay Sievers pr_debug("device: '%s': %s: renaming to '%s'\n", dev_name(dev), 14762b3a302a09735276e13421db56c20045a48eb06dHarvey Harrison __func__, new_name); 1477a2de48cace5d0993da6cfa28b276ae724dc3569bGreg Kroah-Hartman 147899ef3ef8d5f2f5b5312627127ad63df27c0d0d05Kay Sievers#ifdef CONFIG_SYSFS_DEPRECATED 1479a2de48cace5d0993da6cfa28b276ae724dc3569bGreg Kroah-Hartman if ((dev->class) && (dev->parent)) 1480a2de48cace5d0993da6cfa28b276ae724dc3569bGreg Kroah-Hartman old_class_name = make_class_name(dev->class->name, &dev->kobj); 148199ef3ef8d5f2f5b5312627127ad63df27c0d0d05Kay Sievers#endif 1482a2de48cace5d0993da6cfa28b276ae724dc3569bGreg Kroah-Hartman 14831fa5ae857bb14f6046205171d98506d8112dd74eKay Sievers old_device_name = kstrdup(dev_name(dev), GFP_KERNEL); 14842ee97caf0a6602f749ddbfdb1449e383e1212707Cornelia Huck if (!old_device_name) { 14852ee97caf0a6602f749ddbfdb1449e383e1212707Cornelia Huck error = -ENOMEM; 14862ee97caf0a6602f749ddbfdb1449e383e1212707Cornelia Huck goto out; 1487a2de48cace5d0993da6cfa28b276ae724dc3569bGreg Kroah-Hartman } 1488a2de48cace5d0993da6cfa28b276ae724dc3569bGreg Kroah-Hartman 1489a2de48cace5d0993da6cfa28b276ae724dc3569bGreg Kroah-Hartman error = kobject_rename(&dev->kobj, new_name); 14901fa5ae857bb14f6046205171d98506d8112dd74eKay Sievers if (error) 14912ee97caf0a6602f749ddbfdb1449e383e1212707Cornelia Huck goto out; 1492a2de48cace5d0993da6cfa28b276ae724dc3569bGreg Kroah-Hartman 149399ef3ef8d5f2f5b5312627127ad63df27c0d0d05Kay Sievers#ifdef CONFIG_SYSFS_DEPRECATED 1494a2de48cace5d0993da6cfa28b276ae724dc3569bGreg Kroah-Hartman if (old_class_name) { 1495a2de48cace5d0993da6cfa28b276ae724dc3569bGreg Kroah-Hartman new_class_name = make_class_name(dev->class->name, &dev->kobj); 1496a2de48cace5d0993da6cfa28b276ae724dc3569bGreg Kroah-Hartman if (new_class_name) { 149736ce6dad6e3cb3f050ed41e0beac0070d2062b25Cornelia Huck error = sysfs_create_link_nowarn(&dev->parent->kobj, 149836ce6dad6e3cb3f050ed41e0beac0070d2062b25Cornelia Huck &dev->kobj, 149936ce6dad6e3cb3f050ed41e0beac0070d2062b25Cornelia Huck new_class_name); 15002ee97caf0a6602f749ddbfdb1449e383e1212707Cornelia Huck if (error) 15012ee97caf0a6602f749ddbfdb1449e383e1212707Cornelia Huck goto out; 1502a2de48cace5d0993da6cfa28b276ae724dc3569bGreg Kroah-Hartman sysfs_remove_link(&dev->parent->kobj, old_class_name); 1503a2de48cace5d0993da6cfa28b276ae724dc3569bGreg Kroah-Hartman } 1504a2de48cace5d0993da6cfa28b276ae724dc3569bGreg Kroah-Hartman } 150560b8cabd8e8a1d266aa8778957691cd925673083Kay Sievers#else 1506a2de48cace5d0993da6cfa28b276ae724dc3569bGreg Kroah-Hartman if (dev->class) { 150736ce6dad6e3cb3f050ed41e0beac0070d2062b25Cornelia Huck error = sysfs_create_link_nowarn(&dev->class->p->class_subsys.kobj, 15081e0b2cf933ebf32494eba3f668859ba57f06a951Kay Sievers &dev->kobj, dev_name(dev)); 15090599ad53fee2d084f9ba26247d7452f06a40d298Stephen Hemminger if (error) 15100599ad53fee2d084f9ba26247d7452f06a40d298Stephen Hemminger goto out; 15111fbfee6c6dc0f4a4c587b6b163ee79643fc9aaa7Greg Kroah-Hartman sysfs_remove_link(&dev->class->p->class_subsys.kobj, 15127c71448b8aa80123fc521563d5f7c63a099d97abGreg Kroah-Hartman old_device_name); 1513a2de48cace5d0993da6cfa28b276ae724dc3569bGreg Kroah-Hartman } 151460b8cabd8e8a1d266aa8778957691cd925673083Kay Sievers#endif 151560b8cabd8e8a1d266aa8778957691cd925673083Kay Sievers 15162ee97caf0a6602f749ddbfdb1449e383e1212707Cornelia Huckout: 1517a2de48cace5d0993da6cfa28b276ae724dc3569bGreg Kroah-Hartman put_device(dev); 1518a2de48cace5d0993da6cfa28b276ae724dc3569bGreg Kroah-Hartman 1519a2de48cace5d0993da6cfa28b276ae724dc3569bGreg Kroah-Hartman kfree(new_class_name); 1520952ab431cd36c7ab573f685af8679c3677cbdc29Jesper Juhl kfree(old_class_name); 15212ee97caf0a6602f749ddbfdb1449e383e1212707Cornelia Huck kfree(old_device_name); 1522a2de48cace5d0993da6cfa28b276ae724dc3569bGreg Kroah-Hartman 1523a2de48cace5d0993da6cfa28b276ae724dc3569bGreg Kroah-Hartman return error; 1524a2de48cace5d0993da6cfa28b276ae724dc3569bGreg Kroah-Hartman} 1525a2807dbcbd681e1f36e813fb26e2f24d15018b91Johannes BergEXPORT_SYMBOL_GPL(device_rename); 15268a82472f86bf693b8e91ed56c9ca4f62fbbdcfa3Cornelia Huck 15278a82472f86bf693b8e91ed56c9ca4f62fbbdcfa3Cornelia Huckstatic int device_move_class_links(struct device *dev, 15288a82472f86bf693b8e91ed56c9ca4f62fbbdcfa3Cornelia Huck struct device *old_parent, 15298a82472f86bf693b8e91ed56c9ca4f62fbbdcfa3Cornelia Huck struct device *new_parent) 15308a82472f86bf693b8e91ed56c9ca4f62fbbdcfa3Cornelia Huck{ 1531f7f3461d87536bed52bb83bc8fbe6bfd28619fb1Greg Kroah-Hartman int error = 0; 15328a82472f86bf693b8e91ed56c9ca4f62fbbdcfa3Cornelia Huck#ifdef CONFIG_SYSFS_DEPRECATED 15338a82472f86bf693b8e91ed56c9ca4f62fbbdcfa3Cornelia Huck char *class_name; 15348a82472f86bf693b8e91ed56c9ca4f62fbbdcfa3Cornelia Huck 15358a82472f86bf693b8e91ed56c9ca4f62fbbdcfa3Cornelia Huck class_name = make_class_name(dev->class->name, &dev->kobj); 15368a82472f86bf693b8e91ed56c9ca4f62fbbdcfa3Cornelia Huck if (!class_name) { 1537cb360bbf6352712310a7528137919c626a782744Cornelia Huck error = -ENOMEM; 15388a82472f86bf693b8e91ed56c9ca4f62fbbdcfa3Cornelia Huck goto out; 15398a82472f86bf693b8e91ed56c9ca4f62fbbdcfa3Cornelia Huck } 15408a82472f86bf693b8e91ed56c9ca4f62fbbdcfa3Cornelia Huck if (old_parent) { 15418a82472f86bf693b8e91ed56c9ca4f62fbbdcfa3Cornelia Huck sysfs_remove_link(&dev->kobj, "device"); 15428a82472f86bf693b8e91ed56c9ca4f62fbbdcfa3Cornelia Huck sysfs_remove_link(&old_parent->kobj, class_name); 15438a82472f86bf693b8e91ed56c9ca4f62fbbdcfa3Cornelia Huck } 1544c744aeae9d173a953b771a7ad5c872f91fa99decCornelia Huck if (new_parent) { 1545c744aeae9d173a953b771a7ad5c872f91fa99decCornelia Huck error = sysfs_create_link(&dev->kobj, &new_parent->kobj, 1546c744aeae9d173a953b771a7ad5c872f91fa99decCornelia Huck "device"); 1547c744aeae9d173a953b771a7ad5c872f91fa99decCornelia Huck if (error) 1548c744aeae9d173a953b771a7ad5c872f91fa99decCornelia Huck goto out; 1549c744aeae9d173a953b771a7ad5c872f91fa99decCornelia Huck error = sysfs_create_link(&new_parent->kobj, &dev->kobj, 1550c744aeae9d173a953b771a7ad5c872f91fa99decCornelia Huck class_name); 1551c744aeae9d173a953b771a7ad5c872f91fa99decCornelia Huck if (error) 1552c744aeae9d173a953b771a7ad5c872f91fa99decCornelia Huck sysfs_remove_link(&dev->kobj, "device"); 15534a3ad20ccd8f4d2a0535cf98fa83f7b561ba59a9Greg Kroah-Hartman } else 1554c744aeae9d173a953b771a7ad5c872f91fa99decCornelia Huck error = 0; 15558a82472f86bf693b8e91ed56c9ca4f62fbbdcfa3Cornelia Huckout: 15568a82472f86bf693b8e91ed56c9ca4f62fbbdcfa3Cornelia Huck kfree(class_name); 15578a82472f86bf693b8e91ed56c9ca4f62fbbdcfa3Cornelia Huck return error; 15588a82472f86bf693b8e91ed56c9ca4f62fbbdcfa3Cornelia Huck#else 1559f7f3461d87536bed52bb83bc8fbe6bfd28619fb1Greg Kroah-Hartman if (old_parent) 1560f7f3461d87536bed52bb83bc8fbe6bfd28619fb1Greg Kroah-Hartman sysfs_remove_link(&dev->kobj, "device"); 1561f7f3461d87536bed52bb83bc8fbe6bfd28619fb1Greg Kroah-Hartman if (new_parent) 1562f7f3461d87536bed52bb83bc8fbe6bfd28619fb1Greg Kroah-Hartman error = sysfs_create_link(&dev->kobj, &new_parent->kobj, 1563f7f3461d87536bed52bb83bc8fbe6bfd28619fb1Greg Kroah-Hartman "device"); 1564f7f3461d87536bed52bb83bc8fbe6bfd28619fb1Greg Kroah-Hartman return error; 15658a82472f86bf693b8e91ed56c9ca4f62fbbdcfa3Cornelia Huck#endif 15668a82472f86bf693b8e91ed56c9ca4f62fbbdcfa3Cornelia Huck} 15678a82472f86bf693b8e91ed56c9ca4f62fbbdcfa3Cornelia Huck 15688a82472f86bf693b8e91ed56c9ca4f62fbbdcfa3Cornelia Huck/** 15698a82472f86bf693b8e91ed56c9ca4f62fbbdcfa3Cornelia Huck * device_move - moves a device to a new parent 15708a82472f86bf693b8e91ed56c9ca4f62fbbdcfa3Cornelia Huck * @dev: the pointer to the struct device to be moved 1571c744aeae9d173a953b771a7ad5c872f91fa99decCornelia Huck * @new_parent: the new parent of the device (can by NULL) 1572ffa6a7054d172a2f57248dff2de600ca795c5656Cornelia Huck * @dpm_order: how to reorder the dpm_list 15738a82472f86bf693b8e91ed56c9ca4f62fbbdcfa3Cornelia Huck */ 1574ffa6a7054d172a2f57248dff2de600ca795c5656Cornelia Huckint device_move(struct device *dev, struct device *new_parent, 1575ffa6a7054d172a2f57248dff2de600ca795c5656Cornelia Huck enum dpm_order dpm_order) 15768a82472f86bf693b8e91ed56c9ca4f62fbbdcfa3Cornelia Huck{ 15778a82472f86bf693b8e91ed56c9ca4f62fbbdcfa3Cornelia Huck int error; 15788a82472f86bf693b8e91ed56c9ca4f62fbbdcfa3Cornelia Huck struct device *old_parent; 1579c744aeae9d173a953b771a7ad5c872f91fa99decCornelia Huck struct kobject *new_parent_kobj; 15808a82472f86bf693b8e91ed56c9ca4f62fbbdcfa3Cornelia Huck 15818a82472f86bf693b8e91ed56c9ca4f62fbbdcfa3Cornelia Huck dev = get_device(dev); 15828a82472f86bf693b8e91ed56c9ca4f62fbbdcfa3Cornelia Huck if (!dev) 15838a82472f86bf693b8e91ed56c9ca4f62fbbdcfa3Cornelia Huck return -EINVAL; 15848a82472f86bf693b8e91ed56c9ca4f62fbbdcfa3Cornelia Huck 1585ffa6a7054d172a2f57248dff2de600ca795c5656Cornelia Huck device_pm_lock(); 15868a82472f86bf693b8e91ed56c9ca4f62fbbdcfa3Cornelia Huck new_parent = get_device(new_parent); 15874a3ad20ccd8f4d2a0535cf98fa83f7b561ba59a9Greg Kroah-Hartman new_parent_kobj = get_device_parent(dev, new_parent); 158863b6971a0876b744e2fcf3c9df15d130501e1debCornelia Huck 15891e0b2cf933ebf32494eba3f668859ba57f06a951Kay Sievers pr_debug("device: '%s': %s: moving to '%s'\n", dev_name(dev), 15901e0b2cf933ebf32494eba3f668859ba57f06a951Kay Sievers __func__, new_parent ? dev_name(new_parent) : "<NULL>"); 1591c744aeae9d173a953b771a7ad5c872f91fa99decCornelia Huck error = kobject_move(&dev->kobj, new_parent_kobj); 15928a82472f86bf693b8e91ed56c9ca4f62fbbdcfa3Cornelia Huck if (error) { 159363b6971a0876b744e2fcf3c9df15d130501e1debCornelia Huck cleanup_glue_dir(dev, new_parent_kobj); 15948a82472f86bf693b8e91ed56c9ca4f62fbbdcfa3Cornelia Huck put_device(new_parent); 15958a82472f86bf693b8e91ed56c9ca4f62fbbdcfa3Cornelia Huck goto out; 15968a82472f86bf693b8e91ed56c9ca4f62fbbdcfa3Cornelia Huck } 15978a82472f86bf693b8e91ed56c9ca4f62fbbdcfa3Cornelia Huck old_parent = dev->parent; 15988a82472f86bf693b8e91ed56c9ca4f62fbbdcfa3Cornelia Huck dev->parent = new_parent; 15998a82472f86bf693b8e91ed56c9ca4f62fbbdcfa3Cornelia Huck if (old_parent) 1600f791b8c836307b58cbf62133a6a772ed1a92fb33Greg Kroah-Hartman klist_remove(&dev->p->knode_parent); 16010d358f22f6c8f03ab215eee8d52b74f78cc3c7dbYinghai Lu if (new_parent) { 1602f791b8c836307b58cbf62133a6a772ed1a92fb33Greg Kroah-Hartman klist_add_tail(&dev->p->knode_parent, 1603f791b8c836307b58cbf62133a6a772ed1a92fb33Greg Kroah-Hartman &new_parent->p->klist_children); 16040d358f22f6c8f03ab215eee8d52b74f78cc3c7dbYinghai Lu set_dev_node(dev, dev_to_node(new_parent)); 16050d358f22f6c8f03ab215eee8d52b74f78cc3c7dbYinghai Lu } 16060d358f22f6c8f03ab215eee8d52b74f78cc3c7dbYinghai Lu 16078a82472f86bf693b8e91ed56c9ca4f62fbbdcfa3Cornelia Huck if (!dev->class) 16088a82472f86bf693b8e91ed56c9ca4f62fbbdcfa3Cornelia Huck goto out_put; 16098a82472f86bf693b8e91ed56c9ca4f62fbbdcfa3Cornelia Huck error = device_move_class_links(dev, old_parent, new_parent); 16108a82472f86bf693b8e91ed56c9ca4f62fbbdcfa3Cornelia Huck if (error) { 16118a82472f86bf693b8e91ed56c9ca4f62fbbdcfa3Cornelia Huck /* We ignore errors on cleanup since we're hosed anyway... */ 16128a82472f86bf693b8e91ed56c9ca4f62fbbdcfa3Cornelia Huck device_move_class_links(dev, new_parent, old_parent); 16138a82472f86bf693b8e91ed56c9ca4f62fbbdcfa3Cornelia Huck if (!kobject_move(&dev->kobj, &old_parent->kobj)) { 1614c744aeae9d173a953b771a7ad5c872f91fa99decCornelia Huck if (new_parent) 1615f791b8c836307b58cbf62133a6a772ed1a92fb33Greg Kroah-Hartman klist_remove(&dev->p->knode_parent); 16160d358f22f6c8f03ab215eee8d52b74f78cc3c7dbYinghai Lu dev->parent = old_parent; 16170d358f22f6c8f03ab215eee8d52b74f78cc3c7dbYinghai Lu if (old_parent) { 1618f791b8c836307b58cbf62133a6a772ed1a92fb33Greg Kroah-Hartman klist_add_tail(&dev->p->knode_parent, 1619f791b8c836307b58cbf62133a6a772ed1a92fb33Greg Kroah-Hartman &old_parent->p->klist_children); 16200d358f22f6c8f03ab215eee8d52b74f78cc3c7dbYinghai Lu set_dev_node(dev, dev_to_node(old_parent)); 16210d358f22f6c8f03ab215eee8d52b74f78cc3c7dbYinghai Lu } 16228a82472f86bf693b8e91ed56c9ca4f62fbbdcfa3Cornelia Huck } 162363b6971a0876b744e2fcf3c9df15d130501e1debCornelia Huck cleanup_glue_dir(dev, new_parent_kobj); 16248a82472f86bf693b8e91ed56c9ca4f62fbbdcfa3Cornelia Huck put_device(new_parent); 16258a82472f86bf693b8e91ed56c9ca4f62fbbdcfa3Cornelia Huck goto out; 16268a82472f86bf693b8e91ed56c9ca4f62fbbdcfa3Cornelia Huck } 1627ffa6a7054d172a2f57248dff2de600ca795c5656Cornelia Huck switch (dpm_order) { 1628ffa6a7054d172a2f57248dff2de600ca795c5656Cornelia Huck case DPM_ORDER_NONE: 1629ffa6a7054d172a2f57248dff2de600ca795c5656Cornelia Huck break; 1630ffa6a7054d172a2f57248dff2de600ca795c5656Cornelia Huck case DPM_ORDER_DEV_AFTER_PARENT: 1631ffa6a7054d172a2f57248dff2de600ca795c5656Cornelia Huck device_pm_move_after(dev, new_parent); 1632ffa6a7054d172a2f57248dff2de600ca795c5656Cornelia Huck break; 1633ffa6a7054d172a2f57248dff2de600ca795c5656Cornelia Huck case DPM_ORDER_PARENT_BEFORE_DEV: 1634ffa6a7054d172a2f57248dff2de600ca795c5656Cornelia Huck device_pm_move_before(new_parent, dev); 1635ffa6a7054d172a2f57248dff2de600ca795c5656Cornelia Huck break; 1636ffa6a7054d172a2f57248dff2de600ca795c5656Cornelia Huck case DPM_ORDER_DEV_LAST: 1637ffa6a7054d172a2f57248dff2de600ca795c5656Cornelia Huck device_pm_move_last(dev); 1638ffa6a7054d172a2f57248dff2de600ca795c5656Cornelia Huck break; 1639ffa6a7054d172a2f57248dff2de600ca795c5656Cornelia Huck } 16408a82472f86bf693b8e91ed56c9ca4f62fbbdcfa3Cornelia Huckout_put: 16418a82472f86bf693b8e91ed56c9ca4f62fbbdcfa3Cornelia Huck put_device(old_parent); 16428a82472f86bf693b8e91ed56c9ca4f62fbbdcfa3Cornelia Huckout: 1643ffa6a7054d172a2f57248dff2de600ca795c5656Cornelia Huck device_pm_unlock(); 16448a82472f86bf693b8e91ed56c9ca4f62fbbdcfa3Cornelia Huck put_device(dev); 16458a82472f86bf693b8e91ed56c9ca4f62fbbdcfa3Cornelia Huck return error; 16468a82472f86bf693b8e91ed56c9ca4f62fbbdcfa3Cornelia Huck} 16478a82472f86bf693b8e91ed56c9ca4f62fbbdcfa3Cornelia HuckEXPORT_SYMBOL_GPL(device_move); 164837b0c020343080241984d978981d6caf877b278aGreg Kroah-Hartman 164937b0c020343080241984d978981d6caf877b278aGreg Kroah-Hartman/** 165037b0c020343080241984d978981d6caf877b278aGreg Kroah-Hartman * device_shutdown - call ->shutdown() on each device to shutdown. 165137b0c020343080241984d978981d6caf877b278aGreg Kroah-Hartman */ 165237b0c020343080241984d978981d6caf877b278aGreg Kroah-Hartmanvoid device_shutdown(void) 165337b0c020343080241984d978981d6caf877b278aGreg Kroah-Hartman{ 16544a3ad20ccd8f4d2a0535cf98fa83f7b561ba59a9Greg Kroah-Hartman struct device *dev, *devn; 165537b0c020343080241984d978981d6caf877b278aGreg Kroah-Hartman 165637b0c020343080241984d978981d6caf877b278aGreg Kroah-Hartman list_for_each_entry_safe_reverse(dev, devn, &devices_kset->list, 165737b0c020343080241984d978981d6caf877b278aGreg Kroah-Hartman kobj.entry) { 165837b0c020343080241984d978981d6caf877b278aGreg Kroah-Hartman if (dev->bus && dev->bus->shutdown) { 165937b0c020343080241984d978981d6caf877b278aGreg Kroah-Hartman dev_dbg(dev, "shutdown\n"); 166037b0c020343080241984d978981d6caf877b278aGreg Kroah-Hartman dev->bus->shutdown(dev); 166137b0c020343080241984d978981d6caf877b278aGreg Kroah-Hartman } else if (dev->driver && dev->driver->shutdown) { 166237b0c020343080241984d978981d6caf877b278aGreg Kroah-Hartman dev_dbg(dev, "shutdown\n"); 166337b0c020343080241984d978981d6caf877b278aGreg Kroah-Hartman dev->driver->shutdown(dev); 166437b0c020343080241984d978981d6caf877b278aGreg Kroah-Hartman } 166537b0c020343080241984d978981d6caf877b278aGreg Kroah-Hartman } 1666e105b8bfc769b0545b6f0f395179d1e43cbee822Dan Williams kobject_put(sysfs_dev_char_kobj); 1667e105b8bfc769b0545b6f0f395179d1e43cbee822Dan Williams kobject_put(sysfs_dev_block_kobj); 1668e105b8bfc769b0545b6f0f395179d1e43cbee822Dan Williams kobject_put(dev_kobj); 1669401097ea4b89846d66ac78f7f108d49c2e922d9cShaohua Li async_synchronize_full(); 167037b0c020343080241984d978981d6caf877b278aGreg Kroah-Hartman} 1671