Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 1 | /* |
| 2 | * bus.c - bus driver management |
| 3 | * |
| 4 | * Copyright (c) 2002-3 Patrick Mochel |
| 5 | * Copyright (c) 2002-3 Open Source Development Labs |
Greg Kroah-Hartman | e5dd127 | 2007-11-28 15:59:15 -0800 | [diff] [blame] | 6 | * Copyright (c) 2007 Greg Kroah-Hartman <gregkh@suse.de> |
| 7 | * Copyright (c) 2007 Novell Inc. |
Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 8 | * |
| 9 | * This file is released under the GPLv2 |
| 10 | * |
| 11 | */ |
| 12 | |
Dmitry Torokhov | 765230b | 2015-03-30 16:20:04 -0700 | [diff] [blame] | 13 | #include <linux/async.h> |
Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 14 | #include <linux/device.h> |
| 15 | #include <linux/module.h> |
| 16 | #include <linux/errno.h> |
Tejun Heo | 5a0e3ad | 2010-03-24 17:04:11 +0900 | [diff] [blame] | 17 | #include <linux/slab.h> |
Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 18 | #include <linux/init.h> |
| 19 | #include <linux/string.h> |
Kay Sievers | ca22e56 | 2011-12-14 14:29:38 -0800 | [diff] [blame] | 20 | #include <linux/mutex.h> |
Greg Kroah-Hartman | 6396768 | 2013-08-27 10:24:15 -0700 | [diff] [blame] | 21 | #include <linux/sysfs.h> |
Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 22 | #include "base.h" |
| 23 | #include "power/power.h" |
| 24 | |
Kay Sievers | ca22e56 | 2011-12-14 14:29:38 -0800 | [diff] [blame] | 25 | /* /sys/devices/system */ |
H Hartley Sweeten | 97ec448 | 2012-04-16 18:14:10 -0700 | [diff] [blame] | 26 | static struct kset *system_kset; |
Kay Sievers | ca22e56 | 2011-12-14 14:29:38 -0800 | [diff] [blame] | 27 | |
Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 28 | #define to_bus_attr(_attr) container_of(_attr, struct bus_attribute, attr) |
Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 29 | |
| 30 | /* |
| 31 | * sysfs bindings for drivers |
| 32 | */ |
| 33 | |
| 34 | #define to_drv_attr(_attr) container_of(_attr, struct driver_attribute, attr) |
Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 35 | |
Daniel Vetter | 54e6f64 | 2018-12-19 13:39:09 +0100 | [diff] [blame] | 36 | #define DRIVER_ATTR_IGNORE_LOCKDEP(_name, _mode, _show, _store) \ |
| 37 | struct driver_attribute driver_attr_##_name = \ |
| 38 | __ATTR_IGNORE_LOCKDEP(_name, _mode, _show, _store) |
Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 39 | |
Kay Sievers | b8c5cec | 2007-02-16 17:33:36 +0100 | [diff] [blame] | 40 | static int __must_check bus_rescan_devices_helper(struct device *dev, |
| 41 | void *data); |
| 42 | |
Greg Kroah-Hartman | 5901d01 | 2007-09-13 02:53:13 -0700 | [diff] [blame] | 43 | static struct bus_type *bus_get(struct bus_type *bus) |
| 44 | { |
Greg Kroah-Hartman | c6f7e72 | 2007-11-01 19:41:16 -0700 | [diff] [blame] | 45 | if (bus) { |
| 46 | kset_get(&bus->p->subsys); |
| 47 | return bus; |
| 48 | } |
| 49 | return NULL; |
Greg Kroah-Hartman | 5901d01 | 2007-09-13 02:53:13 -0700 | [diff] [blame] | 50 | } |
| 51 | |
Greg Kroah-Hartman | fc1ede5 | 2007-09-13 02:53:13 -0700 | [diff] [blame] | 52 | static void bus_put(struct bus_type *bus) |
| 53 | { |
Greg Kroah-Hartman | c6f7e72 | 2007-11-01 19:41:16 -0700 | [diff] [blame] | 54 | if (bus) |
| 55 | kset_put(&bus->p->subsys); |
Greg Kroah-Hartman | fc1ede5 | 2007-09-13 02:53:13 -0700 | [diff] [blame] | 56 | } |
| 57 | |
Greg Kroah-Hartman | 4a3ad20 | 2008-01-24 22:50:12 -0800 | [diff] [blame] | 58 | static ssize_t drv_attr_show(struct kobject *kobj, struct attribute *attr, |
| 59 | char *buf) |
Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 60 | { |
Greg Kroah-Hartman | 4a3ad20 | 2008-01-24 22:50:12 -0800 | [diff] [blame] | 61 | struct driver_attribute *drv_attr = to_drv_attr(attr); |
Greg Kroah-Hartman | e5dd127 | 2007-11-28 15:59:15 -0800 | [diff] [blame] | 62 | struct driver_private *drv_priv = to_driver(kobj); |
Dmitry Torokhov | 4a0c20b | 2005-04-29 01:23:47 -0500 | [diff] [blame] | 63 | ssize_t ret = -EIO; |
Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 64 | |
| 65 | if (drv_attr->show) |
Greg Kroah-Hartman | e5dd127 | 2007-11-28 15:59:15 -0800 | [diff] [blame] | 66 | ret = drv_attr->show(drv_priv->driver, buf); |
Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 67 | return ret; |
| 68 | } |
| 69 | |
Greg Kroah-Hartman | 4a3ad20 | 2008-01-24 22:50:12 -0800 | [diff] [blame] | 70 | static ssize_t drv_attr_store(struct kobject *kobj, struct attribute *attr, |
| 71 | const char *buf, size_t count) |
Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 72 | { |
Greg Kroah-Hartman | 4a3ad20 | 2008-01-24 22:50:12 -0800 | [diff] [blame] | 73 | struct driver_attribute *drv_attr = to_drv_attr(attr); |
Greg Kroah-Hartman | e5dd127 | 2007-11-28 15:59:15 -0800 | [diff] [blame] | 74 | struct driver_private *drv_priv = to_driver(kobj); |
Dmitry Torokhov | 4a0c20b | 2005-04-29 01:23:47 -0500 | [diff] [blame] | 75 | ssize_t ret = -EIO; |
Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 76 | |
| 77 | if (drv_attr->store) |
Greg Kroah-Hartman | e5dd127 | 2007-11-28 15:59:15 -0800 | [diff] [blame] | 78 | ret = drv_attr->store(drv_priv->driver, buf, count); |
Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 79 | return ret; |
| 80 | } |
| 81 | |
Emese Revfy | 52cf25d | 2010-01-19 02:58:23 +0100 | [diff] [blame] | 82 | static const struct sysfs_ops driver_sysfs_ops = { |
Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 83 | .show = drv_attr_show, |
| 84 | .store = drv_attr_store, |
| 85 | }; |
| 86 | |
Greg Kroah-Hartman | e5dd127 | 2007-11-28 15:59:15 -0800 | [diff] [blame] | 87 | static void driver_release(struct kobject *kobj) |
Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 88 | { |
Greg Kroah-Hartman | e5dd127 | 2007-11-28 15:59:15 -0800 | [diff] [blame] | 89 | struct driver_private *drv_priv = to_driver(kobj); |
| 90 | |
Harvey Harrison | 2b3a302 | 2008-03-04 16:41:05 -0800 | [diff] [blame] | 91 | pr_debug("driver: '%s': %s\n", kobject_name(kobj), __func__); |
Greg Kroah-Hartman | e5dd127 | 2007-11-28 15:59:15 -0800 | [diff] [blame] | 92 | kfree(drv_priv); |
Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 93 | } |
| 94 | |
Greg Kroah-Hartman | a1148fb | 2007-10-11 10:47:49 -0600 | [diff] [blame] | 95 | static struct kobj_type driver_ktype = { |
Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 96 | .sysfs_ops = &driver_sysfs_ops, |
| 97 | .release = driver_release, |
| 98 | }; |
| 99 | |
Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 100 | /* |
| 101 | * sysfs bindings for buses |
| 102 | */ |
Greg Kroah-Hartman | 4a3ad20 | 2008-01-24 22:50:12 -0800 | [diff] [blame] | 103 | static ssize_t bus_attr_show(struct kobject *kobj, struct attribute *attr, |
| 104 | char *buf) |
Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 105 | { |
Greg Kroah-Hartman | 4a3ad20 | 2008-01-24 22:50:12 -0800 | [diff] [blame] | 106 | struct bus_attribute *bus_attr = to_bus_attr(attr); |
Kay Sievers | 6b6e39a | 2010-11-15 23:13:18 +0100 | [diff] [blame] | 107 | struct subsys_private *subsys_priv = to_subsys_private(kobj); |
Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 108 | ssize_t ret = 0; |
| 109 | |
| 110 | if (bus_attr->show) |
Kay Sievers | 6b6e39a | 2010-11-15 23:13:18 +0100 | [diff] [blame] | 111 | ret = bus_attr->show(subsys_priv->bus, buf); |
Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 112 | return ret; |
| 113 | } |
| 114 | |
Greg Kroah-Hartman | 4a3ad20 | 2008-01-24 22:50:12 -0800 | [diff] [blame] | 115 | static ssize_t bus_attr_store(struct kobject *kobj, struct attribute *attr, |
| 116 | const char *buf, size_t count) |
Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 117 | { |
Greg Kroah-Hartman | 4a3ad20 | 2008-01-24 22:50:12 -0800 | [diff] [blame] | 118 | struct bus_attribute *bus_attr = to_bus_attr(attr); |
Kay Sievers | 6b6e39a | 2010-11-15 23:13:18 +0100 | [diff] [blame] | 119 | struct subsys_private *subsys_priv = to_subsys_private(kobj); |
Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 120 | ssize_t ret = 0; |
| 121 | |
| 122 | if (bus_attr->store) |
Kay Sievers | 6b6e39a | 2010-11-15 23:13:18 +0100 | [diff] [blame] | 123 | ret = bus_attr->store(subsys_priv->bus, buf, count); |
Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 124 | return ret; |
| 125 | } |
| 126 | |
Emese Revfy | 52cf25d | 2010-01-19 02:58:23 +0100 | [diff] [blame] | 127 | static const struct sysfs_ops bus_sysfs_ops = { |
Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 128 | .show = bus_attr_show, |
| 129 | .store = bus_attr_store, |
| 130 | }; |
| 131 | |
Greg Kroah-Hartman | 4a3ad20 | 2008-01-24 22:50:12 -0800 | [diff] [blame] | 132 | int bus_create_file(struct bus_type *bus, struct bus_attribute *attr) |
Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 133 | { |
| 134 | int error; |
Greg Kroah-Hartman | 5901d01 | 2007-09-13 02:53:13 -0700 | [diff] [blame] | 135 | if (bus_get(bus)) { |
Greg Kroah-Hartman | c6f7e72 | 2007-11-01 19:41:16 -0700 | [diff] [blame] | 136 | error = sysfs_create_file(&bus->p->subsys.kobj, &attr->attr); |
Greg Kroah-Hartman | fc1ede5 | 2007-09-13 02:53:13 -0700 | [diff] [blame] | 137 | bus_put(bus); |
Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 138 | } else |
| 139 | error = -EINVAL; |
| 140 | return error; |
| 141 | } |
Greg Kroah-Hartman | 4a3ad20 | 2008-01-24 22:50:12 -0800 | [diff] [blame] | 142 | EXPORT_SYMBOL_GPL(bus_create_file); |
Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 143 | |
Greg Kroah-Hartman | 4a3ad20 | 2008-01-24 22:50:12 -0800 | [diff] [blame] | 144 | void bus_remove_file(struct bus_type *bus, struct bus_attribute *attr) |
Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 145 | { |
Greg Kroah-Hartman | 5901d01 | 2007-09-13 02:53:13 -0700 | [diff] [blame] | 146 | if (bus_get(bus)) { |
Greg Kroah-Hartman | c6f7e72 | 2007-11-01 19:41:16 -0700 | [diff] [blame] | 147 | sysfs_remove_file(&bus->p->subsys.kobj, &attr->attr); |
Greg Kroah-Hartman | fc1ede5 | 2007-09-13 02:53:13 -0700 | [diff] [blame] | 148 | bus_put(bus); |
Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 149 | } |
| 150 | } |
Greg Kroah-Hartman | 4a3ad20 | 2008-01-24 22:50:12 -0800 | [diff] [blame] | 151 | EXPORT_SYMBOL_GPL(bus_remove_file); |
Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 152 | |
Bart Van Assche | 174be70 | 2014-01-04 14:21:42 +0100 | [diff] [blame] | 153 | static void bus_release(struct kobject *kobj) |
| 154 | { |
Geliang Tang | 371fd7a | 2016-01-05 23:03:38 +0800 | [diff] [blame] | 155 | struct subsys_private *priv = to_subsys_private(kobj); |
Bart Van Assche | 174be70 | 2014-01-04 14:21:42 +0100 | [diff] [blame] | 156 | struct bus_type *bus = priv->bus; |
| 157 | |
| 158 | kfree(priv); |
| 159 | bus->p = NULL; |
| 160 | } |
| 161 | |
Kay Sievers | 80f03e3 | 2007-05-26 11:21:36 +0200 | [diff] [blame] | 162 | static struct kobj_type bus_ktype = { |
Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 163 | .sysfs_ops = &bus_sysfs_ops, |
Bart Van Assche | 174be70 | 2014-01-04 14:21:42 +0100 | [diff] [blame] | 164 | .release = bus_release, |
Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 165 | }; |
| 166 | |
Kay Sievers | 80f03e3 | 2007-05-26 11:21:36 +0200 | [diff] [blame] | 167 | static int bus_uevent_filter(struct kset *kset, struct kobject *kobj) |
| 168 | { |
| 169 | struct kobj_type *ktype = get_ktype(kobj); |
| 170 | |
| 171 | if (ktype == &bus_ktype) |
| 172 | return 1; |
| 173 | return 0; |
| 174 | } |
| 175 | |
Emese Revfy | 9cd4361 | 2009-12-31 14:52:51 +0100 | [diff] [blame] | 176 | static const struct kset_uevent_ops bus_uevent_ops = { |
Kay Sievers | 80f03e3 | 2007-05-26 11:21:36 +0200 | [diff] [blame] | 177 | .filter = bus_uevent_filter, |
| 178 | }; |
| 179 | |
Greg Kroah-Hartman | 59a5483 | 2007-10-29 23:22:26 -0500 | [diff] [blame] | 180 | static struct kset *bus_kset; |
Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 181 | |
Alan Stern | 2b08c8d | 2005-11-23 15:43:50 -0800 | [diff] [blame] | 182 | /* Manually detach a device from its associated driver. */ |
Greg Kroah-Hartman | 2581c9c | 2013-08-23 15:04:42 -0700 | [diff] [blame] | 183 | static ssize_t unbind_store(struct device_driver *drv, const char *buf, |
| 184 | size_t count) |
Greg Kroah-Hartman | 151ef38 | 2005-06-22 16:09:05 -0700 | [diff] [blame] | 185 | { |
Greg Kroah-Hartman | 5901d01 | 2007-09-13 02:53:13 -0700 | [diff] [blame] | 186 | struct bus_type *bus = bus_get(drv->bus); |
Greg Kroah-Hartman | 151ef38 | 2005-06-22 16:09:05 -0700 | [diff] [blame] | 187 | struct device *dev; |
| 188 | int err = -ENODEV; |
| 189 | |
Greg Kroah-Hartman | 1f9ffc0 | 2008-01-27 10:29:20 -0800 | [diff] [blame] | 190 | dev = bus_find_device_by_name(bus, NULL, buf); |
Alan Stern | 2b08c8d | 2005-11-23 15:43:50 -0800 | [diff] [blame] | 191 | if (dev && dev->driver == drv) { |
Alan Stern | bf74ad5 | 2005-11-17 16:54:12 -0500 | [diff] [blame] | 192 | if (dev->parent) /* Needed for USB */ |
Greg Kroah-Hartman | 8e9394c | 2010-02-17 10:57:05 -0800 | [diff] [blame] | 193 | device_lock(dev->parent); |
Greg Kroah-Hartman | 151ef38 | 2005-06-22 16:09:05 -0700 | [diff] [blame] | 194 | device_release_driver(dev); |
Alan Stern | bf74ad5 | 2005-11-17 16:54:12 -0500 | [diff] [blame] | 195 | if (dev->parent) |
Greg Kroah-Hartman | 8e9394c | 2010-02-17 10:57:05 -0800 | [diff] [blame] | 196 | device_unlock(dev->parent); |
Greg Kroah-Hartman | 151ef38 | 2005-06-22 16:09:05 -0700 | [diff] [blame] | 197 | err = count; |
| 198 | } |
Alan Stern | 2b08c8d | 2005-11-23 15:43:50 -0800 | [diff] [blame] | 199 | put_device(dev); |
Greg Kroah-Hartman | fc1ede5 | 2007-09-13 02:53:13 -0700 | [diff] [blame] | 200 | bus_put(bus); |
Alan Stern | 2b08c8d | 2005-11-23 15:43:50 -0800 | [diff] [blame] | 201 | return err; |
Greg Kroah-Hartman | 151ef38 | 2005-06-22 16:09:05 -0700 | [diff] [blame] | 202 | } |
Daniel Vetter | 54e6f64 | 2018-12-19 13:39:09 +0100 | [diff] [blame] | 203 | static DRIVER_ATTR_IGNORE_LOCKDEP(unbind, S_IWUSR, NULL, unbind_store); |
Greg Kroah-Hartman | 151ef38 | 2005-06-22 16:09:05 -0700 | [diff] [blame] | 204 | |
Greg Kroah-Hartman | afdce75 | 2005-06-22 16:09:05 -0700 | [diff] [blame] | 205 | /* |
| 206 | * Manually attach a device to a driver. |
| 207 | * Note: the driver must want to bind to the device, |
| 208 | * it is not possible to override the driver's id table. |
| 209 | */ |
Greg Kroah-Hartman | 2581c9c | 2013-08-23 15:04:42 -0700 | [diff] [blame] | 210 | static ssize_t bind_store(struct device_driver *drv, const char *buf, |
| 211 | size_t count) |
Greg Kroah-Hartman | afdce75 | 2005-06-22 16:09:05 -0700 | [diff] [blame] | 212 | { |
Greg Kroah-Hartman | 5901d01 | 2007-09-13 02:53:13 -0700 | [diff] [blame] | 213 | struct bus_type *bus = bus_get(drv->bus); |
Greg Kroah-Hartman | afdce75 | 2005-06-22 16:09:05 -0700 | [diff] [blame] | 214 | struct device *dev; |
| 215 | int err = -ENODEV; |
| 216 | |
Greg Kroah-Hartman | 1f9ffc0 | 2008-01-27 10:29:20 -0800 | [diff] [blame] | 217 | dev = bus_find_device_by_name(bus, NULL, buf); |
Ming Lei | 49b420a | 2009-01-21 23:27:47 +0800 | [diff] [blame] | 218 | if (dev && dev->driver == NULL && driver_match_device(drv, dev)) { |
Alan Stern | bf74ad5 | 2005-11-17 16:54:12 -0500 | [diff] [blame] | 219 | if (dev->parent) /* Needed for USB */ |
Greg Kroah-Hartman | 8e9394c | 2010-02-17 10:57:05 -0800 | [diff] [blame] | 220 | device_lock(dev->parent); |
| 221 | device_lock(dev); |
Greg Kroah-Hartman | afdce75 | 2005-06-22 16:09:05 -0700 | [diff] [blame] | 222 | err = driver_probe_device(drv, dev); |
Greg Kroah-Hartman | 8e9394c | 2010-02-17 10:57:05 -0800 | [diff] [blame] | 223 | device_unlock(dev); |
Alan Stern | bf74ad5 | 2005-11-17 16:54:12 -0500 | [diff] [blame] | 224 | if (dev->parent) |
Greg Kroah-Hartman | 8e9394c | 2010-02-17 10:57:05 -0800 | [diff] [blame] | 225 | device_unlock(dev->parent); |
Ryan Wilson | 3722540 | 2006-03-22 16:26:25 -0500 | [diff] [blame] | 226 | |
Greg Kroah-Hartman | 4a3ad20 | 2008-01-24 22:50:12 -0800 | [diff] [blame] | 227 | if (err > 0) { |
| 228 | /* success */ |
Ryan Wilson | 3722540 | 2006-03-22 16:26:25 -0500 | [diff] [blame] | 229 | err = count; |
Greg Kroah-Hartman | 4a3ad20 | 2008-01-24 22:50:12 -0800 | [diff] [blame] | 230 | } else if (err == 0) { |
| 231 | /* driver didn't accept device */ |
Ryan Wilson | 3722540 | 2006-03-22 16:26:25 -0500 | [diff] [blame] | 232 | err = -ENODEV; |
Greg Kroah-Hartman | 4a3ad20 | 2008-01-24 22:50:12 -0800 | [diff] [blame] | 233 | } |
Greg Kroah-Hartman | afdce75 | 2005-06-22 16:09:05 -0700 | [diff] [blame] | 234 | } |
Alan Stern | 2b08c8d | 2005-11-23 15:43:50 -0800 | [diff] [blame] | 235 | put_device(dev); |
Greg Kroah-Hartman | fc1ede5 | 2007-09-13 02:53:13 -0700 | [diff] [blame] | 236 | bus_put(bus); |
Alan Stern | 2b08c8d | 2005-11-23 15:43:50 -0800 | [diff] [blame] | 237 | return err; |
Greg Kroah-Hartman | afdce75 | 2005-06-22 16:09:05 -0700 | [diff] [blame] | 238 | } |
Daniel Vetter | 54e6f64 | 2018-12-19 13:39:09 +0100 | [diff] [blame] | 239 | static DRIVER_ATTR_IGNORE_LOCKDEP(bind, S_IWUSR, NULL, bind_store); |
Greg Kroah-Hartman | afdce75 | 2005-06-22 16:09:05 -0700 | [diff] [blame] | 240 | |
Kay Sievers | b8c5cec | 2007-02-16 17:33:36 +0100 | [diff] [blame] | 241 | static ssize_t show_drivers_autoprobe(struct bus_type *bus, char *buf) |
| 242 | { |
Greg Kroah-Hartman | c6f7e72 | 2007-11-01 19:41:16 -0700 | [diff] [blame] | 243 | return sprintf(buf, "%d\n", bus->p->drivers_autoprobe); |
Kay Sievers | b8c5cec | 2007-02-16 17:33:36 +0100 | [diff] [blame] | 244 | } |
| 245 | |
| 246 | static ssize_t store_drivers_autoprobe(struct bus_type *bus, |
| 247 | const char *buf, size_t count) |
| 248 | { |
| 249 | if (buf[0] == '0') |
Greg Kroah-Hartman | c6f7e72 | 2007-11-01 19:41:16 -0700 | [diff] [blame] | 250 | bus->p->drivers_autoprobe = 0; |
Kay Sievers | b8c5cec | 2007-02-16 17:33:36 +0100 | [diff] [blame] | 251 | else |
Greg Kroah-Hartman | c6f7e72 | 2007-11-01 19:41:16 -0700 | [diff] [blame] | 252 | bus->p->drivers_autoprobe = 1; |
Kay Sievers | b8c5cec | 2007-02-16 17:33:36 +0100 | [diff] [blame] | 253 | return count; |
| 254 | } |
| 255 | |
| 256 | static ssize_t store_drivers_probe(struct bus_type *bus, |
| 257 | const char *buf, size_t count) |
| 258 | { |
| 259 | struct device *dev; |
Alex Williamson | 0372ffb | 2014-10-31 11:13:07 -0600 | [diff] [blame] | 260 | int err = -EINVAL; |
Kay Sievers | b8c5cec | 2007-02-16 17:33:36 +0100 | [diff] [blame] | 261 | |
Greg Kroah-Hartman | 1f9ffc0 | 2008-01-27 10:29:20 -0800 | [diff] [blame] | 262 | dev = bus_find_device_by_name(bus, NULL, buf); |
Kay Sievers | b8c5cec | 2007-02-16 17:33:36 +0100 | [diff] [blame] | 263 | if (!dev) |
| 264 | return -ENODEV; |
Alex Williamson | 0372ffb | 2014-10-31 11:13:07 -0600 | [diff] [blame] | 265 | if (bus_rescan_devices_helper(dev, NULL) == 0) |
| 266 | err = count; |
| 267 | put_device(dev); |
| 268 | return err; |
Kay Sievers | b8c5cec | 2007-02-16 17:33:36 +0100 | [diff] [blame] | 269 | } |
Greg Kroah-Hartman | 151ef38 | 2005-06-22 16:09:05 -0700 | [diff] [blame] | 270 | |
Greg Kroah-Hartman | 4a3ad20 | 2008-01-24 22:50:12 -0800 | [diff] [blame] | 271 | static struct device *next_device(struct klist_iter *i) |
mochel@digitalimplant.org | 465c7a3 | 2005-03-21 11:49:14 -0800 | [diff] [blame] | 272 | { |
Greg Kroah-Hartman | 4a3ad20 | 2008-01-24 22:50:12 -0800 | [diff] [blame] | 273 | struct klist_node *n = klist_next(i); |
Greg Kroah-Hartman | ae1b417 | 2008-12-16 12:26:21 -0800 | [diff] [blame] | 274 | struct device *dev = NULL; |
| 275 | struct device_private *dev_prv; |
| 276 | |
| 277 | if (n) { |
| 278 | dev_prv = to_device_private_bus(n); |
| 279 | dev = dev_prv->device; |
| 280 | } |
| 281 | return dev; |
mochel@digitalimplant.org | 465c7a3 | 2005-03-21 11:49:14 -0800 | [diff] [blame] | 282 | } |
| 283 | |
Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 284 | /** |
Greg Kroah-Hartman | 4a3ad20 | 2008-01-24 22:50:12 -0800 | [diff] [blame] | 285 | * bus_for_each_dev - device iterator. |
| 286 | * @bus: bus type. |
| 287 | * @start: device to start iterating from. |
| 288 | * @data: data for the callback. |
| 289 | * @fn: function to be called for each device. |
Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 290 | * |
Greg Kroah-Hartman | 4a3ad20 | 2008-01-24 22:50:12 -0800 | [diff] [blame] | 291 | * Iterate over @bus's list of devices, and call @fn for each, |
| 292 | * passing it @data. If @start is not NULL, we use that device to |
| 293 | * begin iterating from. |
Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 294 | * |
Greg Kroah-Hartman | 4a3ad20 | 2008-01-24 22:50:12 -0800 | [diff] [blame] | 295 | * We check the return of @fn each time. If it returns anything |
| 296 | * other than 0, we break out and return that value. |
Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 297 | * |
Greg Kroah-Hartman | 4a3ad20 | 2008-01-24 22:50:12 -0800 | [diff] [blame] | 298 | * NOTE: The device that returns a non-zero value is not retained |
| 299 | * in any way, nor is its refcount incremented. If the caller needs |
Alex Chiang | 0fa1b0a | 2009-05-14 23:15:22 +0200 | [diff] [blame] | 300 | * to retain this data, it should do so, and increment the reference |
Greg Kroah-Hartman | 4a3ad20 | 2008-01-24 22:50:12 -0800 | [diff] [blame] | 301 | * count in the supplied callback. |
Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 302 | */ |
Greg Kroah-Hartman | 4a3ad20 | 2008-01-24 22:50:12 -0800 | [diff] [blame] | 303 | int bus_for_each_dev(struct bus_type *bus, struct device *start, |
| 304 | void *data, int (*fn)(struct device *, void *)) |
Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 305 | { |
mochel@digitalimplant.org | 465c7a3 | 2005-03-21 11:49:14 -0800 | [diff] [blame] | 306 | struct klist_iter i; |
Greg Kroah-Hartman | 4a3ad20 | 2008-01-24 22:50:12 -0800 | [diff] [blame] | 307 | struct device *dev; |
mochel@digitalimplant.org | 465c7a3 | 2005-03-21 11:49:14 -0800 | [diff] [blame] | 308 | int error = 0; |
Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 309 | |
Bjorn Helgaas | 4fa3e78 | 2013-01-29 16:44:27 -0700 | [diff] [blame] | 310 | if (!bus || !bus->p) |
mochel@digitalimplant.org | 465c7a3 | 2005-03-21 11:49:14 -0800 | [diff] [blame] | 311 | return -EINVAL; |
| 312 | |
Greg Kroah-Hartman | 7cd9c9b | 2012-04-19 19:17:30 -0700 | [diff] [blame] | 313 | klist_iter_init_node(&bus->p->klist_devices, &i, |
| 314 | (start ? &start->p->knode_bus : NULL)); |
| 315 | while ((dev = next_device(&i)) && !error) |
| 316 | error = fn(dev, data); |
| 317 | klist_iter_exit(&i); |
mochel@digitalimplant.org | 465c7a3 | 2005-03-21 11:49:14 -0800 | [diff] [blame] | 318 | return error; |
Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 319 | } |
Greg Kroah-Hartman | 4a3ad20 | 2008-01-24 22:50:12 -0800 | [diff] [blame] | 320 | EXPORT_SYMBOL_GPL(bus_for_each_dev); |
Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 321 | |
Cornelia Huck | 0edb586 | 2005-06-22 16:59:51 +0200 | [diff] [blame] | 322 | /** |
| 323 | * bus_find_device - device iterator for locating a particular device. |
| 324 | * @bus: bus type |
| 325 | * @start: Device to begin with |
| 326 | * @data: Data to pass to match function |
| 327 | * @match: Callback function to check device |
| 328 | * |
| 329 | * This is similar to the bus_for_each_dev() function above, but it |
| 330 | * returns a reference to a device that is 'found' for later use, as |
| 331 | * determined by the @match callback. |
| 332 | * |
| 333 | * The callback should return 0 if the device doesn't match and non-zero |
| 334 | * if it does. If the callback returns non-zero, this function will |
| 335 | * return to the caller and not iterate over any more devices. |
| 336 | */ |
Greg Kroah-Hartman | 4a3ad20 | 2008-01-24 22:50:12 -0800 | [diff] [blame] | 337 | struct device *bus_find_device(struct bus_type *bus, |
| 338 | struct device *start, void *data, |
| 339 | int (*match)(struct device *dev, void *data)) |
Cornelia Huck | 0edb586 | 2005-06-22 16:59:51 +0200 | [diff] [blame] | 340 | { |
| 341 | struct klist_iter i; |
| 342 | struct device *dev; |
| 343 | |
Bjorn Helgaas | 4fa3e78 | 2013-01-29 16:44:27 -0700 | [diff] [blame] | 344 | if (!bus || !bus->p) |
Cornelia Huck | 0edb586 | 2005-06-22 16:59:51 +0200 | [diff] [blame] | 345 | return NULL; |
| 346 | |
Greg Kroah-Hartman | 7cd9c9b | 2012-04-19 19:17:30 -0700 | [diff] [blame] | 347 | klist_iter_init_node(&bus->p->klist_devices, &i, |
| 348 | (start ? &start->p->knode_bus : NULL)); |
Cornelia Huck | 0edb586 | 2005-06-22 16:59:51 +0200 | [diff] [blame] | 349 | while ((dev = next_device(&i))) |
| 350 | if (match(dev, data) && get_device(dev)) |
| 351 | break; |
| 352 | klist_iter_exit(&i); |
| 353 | return dev; |
| 354 | } |
Greg Kroah-Hartman | 4a3ad20 | 2008-01-24 22:50:12 -0800 | [diff] [blame] | 355 | EXPORT_SYMBOL_GPL(bus_find_device); |
mochel@digitalimplant.org | 38fdac3 | 2005-03-21 12:00:18 -0800 | [diff] [blame] | 356 | |
Greg Kroah-Hartman | 1f9ffc0 | 2008-01-27 10:29:20 -0800 | [diff] [blame] | 357 | static int match_name(struct device *dev, void *data) |
| 358 | { |
| 359 | const char *name = data; |
| 360 | |
Kay Sievers | 1e0b2cf | 2008-10-30 01:36:48 +0100 | [diff] [blame] | 361 | return sysfs_streq(name, dev_name(dev)); |
Greg Kroah-Hartman | 1f9ffc0 | 2008-01-27 10:29:20 -0800 | [diff] [blame] | 362 | } |
| 363 | |
| 364 | /** |
| 365 | * bus_find_device_by_name - device iterator for locating a particular device of a specific name |
| 366 | * @bus: bus type |
| 367 | * @start: Device to begin with |
| 368 | * @name: name of the device to match |
| 369 | * |
| 370 | * This is similar to the bus_find_device() function above, but it handles |
| 371 | * searching by a name automatically, no need to write another strcmp matching |
| 372 | * function. |
| 373 | */ |
| 374 | struct device *bus_find_device_by_name(struct bus_type *bus, |
| 375 | struct device *start, const char *name) |
| 376 | { |
| 377 | return bus_find_device(bus, start, (void *)name, match_name); |
| 378 | } |
| 379 | EXPORT_SYMBOL_GPL(bus_find_device_by_name); |
| 380 | |
Kay Sievers | ca22e56 | 2011-12-14 14:29:38 -0800 | [diff] [blame] | 381 | /** |
| 382 | * subsys_find_device_by_id - find a device with a specific enumeration number |
| 383 | * @subsys: subsystem |
| 384 | * @id: index 'id' in struct device |
| 385 | * @hint: device to check first |
| 386 | * |
| 387 | * Check the hint's next object and if it is a match return it directly, |
| 388 | * otherwise, fall back to a full list search. Either way a reference for |
| 389 | * the returned object is taken. |
| 390 | */ |
| 391 | struct device *subsys_find_device_by_id(struct bus_type *subsys, unsigned int id, |
| 392 | struct device *hint) |
| 393 | { |
| 394 | struct klist_iter i; |
| 395 | struct device *dev; |
| 396 | |
| 397 | if (!subsys) |
| 398 | return NULL; |
| 399 | |
| 400 | if (hint) { |
Greg Kroah-Hartman | 7cd9c9b | 2012-04-19 19:17:30 -0700 | [diff] [blame] | 401 | klist_iter_init_node(&subsys->p->klist_devices, &i, &hint->p->knode_bus); |
Kay Sievers | ca22e56 | 2011-12-14 14:29:38 -0800 | [diff] [blame] | 402 | dev = next_device(&i); |
| 403 | if (dev && dev->id == id && get_device(dev)) { |
| 404 | klist_iter_exit(&i); |
| 405 | return dev; |
| 406 | } |
| 407 | klist_iter_exit(&i); |
| 408 | } |
| 409 | |
| 410 | klist_iter_init_node(&subsys->p->klist_devices, &i, NULL); |
| 411 | while ((dev = next_device(&i))) { |
| 412 | if (dev->id == id && get_device(dev)) { |
| 413 | klist_iter_exit(&i); |
| 414 | return dev; |
| 415 | } |
| 416 | } |
| 417 | klist_iter_exit(&i); |
| 418 | return NULL; |
| 419 | } |
| 420 | EXPORT_SYMBOL_GPL(subsys_find_device_by_id); |
| 421 | |
Greg Kroah-Hartman | 4a3ad20 | 2008-01-24 22:50:12 -0800 | [diff] [blame] | 422 | static struct device_driver *next_driver(struct klist_iter *i) |
mochel@digitalimplant.org | 38fdac3 | 2005-03-21 12:00:18 -0800 | [diff] [blame] | 423 | { |
Greg Kroah-Hartman | 4a3ad20 | 2008-01-24 22:50:12 -0800 | [diff] [blame] | 424 | struct klist_node *n = klist_next(i); |
Greg Kroah-Hartman | e5dd127 | 2007-11-28 15:59:15 -0800 | [diff] [blame] | 425 | struct driver_private *drv_priv; |
| 426 | |
| 427 | if (n) { |
| 428 | drv_priv = container_of(n, struct driver_private, knode_bus); |
| 429 | return drv_priv->driver; |
| 430 | } |
| 431 | return NULL; |
mochel@digitalimplant.org | 38fdac3 | 2005-03-21 12:00:18 -0800 | [diff] [blame] | 432 | } |
| 433 | |
Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 434 | /** |
Greg Kroah-Hartman | 4a3ad20 | 2008-01-24 22:50:12 -0800 | [diff] [blame] | 435 | * bus_for_each_drv - driver iterator |
| 436 | * @bus: bus we're dealing with. |
| 437 | * @start: driver to start iterating on. |
| 438 | * @data: data to pass to the callback. |
| 439 | * @fn: function to call for each driver. |
Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 440 | * |
Greg Kroah-Hartman | 4a3ad20 | 2008-01-24 22:50:12 -0800 | [diff] [blame] | 441 | * This is nearly identical to the device iterator above. |
| 442 | * We iterate over each driver that belongs to @bus, and call |
| 443 | * @fn for each. If @fn returns anything but 0, we break out |
| 444 | * and return it. If @start is not NULL, we use it as the head |
| 445 | * of the list. |
Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 446 | * |
Greg Kroah-Hartman | 4a3ad20 | 2008-01-24 22:50:12 -0800 | [diff] [blame] | 447 | * NOTE: we don't return the driver that returns a non-zero |
| 448 | * value, nor do we leave the reference count incremented for that |
| 449 | * driver. If the caller needs to know that info, it must set it |
| 450 | * in the callback. It must also be sure to increment the refcount |
| 451 | * so it doesn't disappear before returning to the caller. |
Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 452 | */ |
Greg Kroah-Hartman | 4a3ad20 | 2008-01-24 22:50:12 -0800 | [diff] [blame] | 453 | int bus_for_each_drv(struct bus_type *bus, struct device_driver *start, |
| 454 | void *data, int (*fn)(struct device_driver *, void *)) |
Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 455 | { |
mochel@digitalimplant.org | 38fdac3 | 2005-03-21 12:00:18 -0800 | [diff] [blame] | 456 | struct klist_iter i; |
Greg Kroah-Hartman | 4a3ad20 | 2008-01-24 22:50:12 -0800 | [diff] [blame] | 457 | struct device_driver *drv; |
mochel@digitalimplant.org | 38fdac3 | 2005-03-21 12:00:18 -0800 | [diff] [blame] | 458 | int error = 0; |
Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 459 | |
mochel@digitalimplant.org | 38fdac3 | 2005-03-21 12:00:18 -0800 | [diff] [blame] | 460 | if (!bus) |
| 461 | return -EINVAL; |
| 462 | |
Greg Kroah-Hartman | 7cd9c9b | 2012-04-19 19:17:30 -0700 | [diff] [blame] | 463 | klist_iter_init_node(&bus->p->klist_drivers, &i, |
| 464 | start ? &start->p->knode_bus : NULL); |
| 465 | while ((drv = next_driver(&i)) && !error) |
| 466 | error = fn(drv, data); |
| 467 | klist_iter_exit(&i); |
mochel@digitalimplant.org | 38fdac3 | 2005-03-21 12:00:18 -0800 | [diff] [blame] | 468 | return error; |
Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 469 | } |
Greg Kroah-Hartman | 4a3ad20 | 2008-01-24 22:50:12 -0800 | [diff] [blame] | 470 | EXPORT_SYMBOL_GPL(bus_for_each_drv); |
Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 471 | |
Andrew Morton | 4aca67e | 2007-02-13 22:39:26 -0800 | [diff] [blame] | 472 | static int device_add_attrs(struct bus_type *bus, struct device *dev) |
Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 473 | { |
| 474 | int error = 0; |
| 475 | int i; |
| 476 | |
Andrew Morton | 4aca67e | 2007-02-13 22:39:26 -0800 | [diff] [blame] | 477 | if (!bus->dev_attrs) |
| 478 | return 0; |
| 479 | |
Greg Kroah-Hartman | 3e1026b | 2013-08-22 10:25:34 -0700 | [diff] [blame] | 480 | for (i = 0; bus->dev_attrs[i].attr.name; i++) { |
Greg Kroah-Hartman | 4a3ad20 | 2008-01-24 22:50:12 -0800 | [diff] [blame] | 481 | error = device_create_file(dev, &bus->dev_attrs[i]); |
Andrew Morton | 4aca67e | 2007-02-13 22:39:26 -0800 | [diff] [blame] | 482 | if (error) { |
| 483 | while (--i >= 0) |
| 484 | device_remove_file(dev, &bus->dev_attrs[i]); |
| 485 | break; |
Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 486 | } |
| 487 | } |
Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 488 | return error; |
Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 489 | } |
| 490 | |
Greg Kroah-Hartman | 4a3ad20 | 2008-01-24 22:50:12 -0800 | [diff] [blame] | 491 | static void device_remove_attrs(struct bus_type *bus, struct device *dev) |
Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 492 | { |
| 493 | int i; |
| 494 | |
| 495 | if (bus->dev_attrs) { |
Greg Kroah-Hartman | 3e1026b | 2013-08-22 10:25:34 -0700 | [diff] [blame] | 496 | for (i = 0; bus->dev_attrs[i].attr.name; i++) |
Greg Kroah-Hartman | 4a3ad20 | 2008-01-24 22:50:12 -0800 | [diff] [blame] | 497 | device_remove_file(dev, &bus->dev_attrs[i]); |
Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 498 | } |
| 499 | } |
| 500 | |
Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 501 | /** |
Greg Kroah-Hartman | 4a3ad20 | 2008-01-24 22:50:12 -0800 | [diff] [blame] | 502 | * bus_add_device - add device to bus |
| 503 | * @dev: device being added |
Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 504 | * |
Alan Stern | 2023c61 | 2009-07-30 15:27:18 -0400 | [diff] [blame] | 505 | * - Add device's bus attributes. |
| 506 | * - Create links to device's bus. |
Greg Kroah-Hartman | 4a3ad20 | 2008-01-24 22:50:12 -0800 | [diff] [blame] | 507 | * - Add the device to its bus's list of devices. |
Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 508 | */ |
Greg Kroah-Hartman | 4a3ad20 | 2008-01-24 22:50:12 -0800 | [diff] [blame] | 509 | int bus_add_device(struct device *dev) |
Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 510 | { |
Greg Kroah-Hartman | 4a3ad20 | 2008-01-24 22:50:12 -0800 | [diff] [blame] | 511 | struct bus_type *bus = bus_get(dev->bus); |
Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 512 | int error = 0; |
| 513 | |
| 514 | if (bus) { |
Kay Sievers | 1e0b2cf | 2008-10-30 01:36:48 +0100 | [diff] [blame] | 515 | pr_debug("bus: '%s': add device %s\n", bus->name, dev_name(dev)); |
Greg Kroah-Hartman | d377e85 | 2005-06-22 16:09:05 -0700 | [diff] [blame] | 516 | error = device_add_attrs(bus, dev); |
Andrew Morton | f86db39 | 2006-08-14 22:43:20 -0700 | [diff] [blame] | 517 | if (error) |
Cornelia Huck | 513e733 | 2006-09-22 11:37:08 +0200 | [diff] [blame] | 518 | goto out_put; |
Greg Kroah-Hartman | fa6fdb3 | 2013-08-08 15:22:55 -0700 | [diff] [blame] | 519 | error = device_add_groups(dev, bus->dev_groups); |
| 520 | if (error) |
Junjie Mao | 1c34203 | 2015-01-28 10:02:44 +0800 | [diff] [blame] | 521 | goto out_id; |
Greg Kroah-Hartman | c6f7e72 | 2007-11-01 19:41:16 -0700 | [diff] [blame] | 522 | error = sysfs_create_link(&bus->p->devices_kset->kobj, |
Kay Sievers | 1e0b2cf | 2008-10-30 01:36:48 +0100 | [diff] [blame] | 523 | &dev->kobj, dev_name(dev)); |
Andrew Morton | f86db39 | 2006-08-14 22:43:20 -0700 | [diff] [blame] | 524 | if (error) |
Junjie Mao | 1c34203 | 2015-01-28 10:02:44 +0800 | [diff] [blame] | 525 | goto out_groups; |
Andrew Morton | f86db39 | 2006-08-14 22:43:20 -0700 | [diff] [blame] | 526 | error = sysfs_create_link(&dev->kobj, |
Greg Kroah-Hartman | c6f7e72 | 2007-11-01 19:41:16 -0700 | [diff] [blame] | 527 | &dev->bus->p->subsys.kobj, "subsystem"); |
Andrew Morton | f86db39 | 2006-08-14 22:43:20 -0700 | [diff] [blame] | 528 | if (error) |
Cornelia Huck | 513e733 | 2006-09-22 11:37:08 +0200 | [diff] [blame] | 529 | goto out_subsys; |
Alan Stern | 2023c61 | 2009-07-30 15:27:18 -0400 | [diff] [blame] | 530 | klist_add_tail(&dev->p->knode_bus, &bus->p->klist_devices); |
Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 531 | } |
Cornelia Huck | 513e733 | 2006-09-22 11:37:08 +0200 | [diff] [blame] | 532 | return 0; |
| 533 | |
Cornelia Huck | 513e733 | 2006-09-22 11:37:08 +0200 | [diff] [blame] | 534 | out_subsys: |
Kay Sievers | 1e0b2cf | 2008-10-30 01:36:48 +0100 | [diff] [blame] | 535 | sysfs_remove_link(&bus->p->devices_kset->kobj, dev_name(dev)); |
Greg Kroah-Hartman | fa6fdb3 | 2013-08-08 15:22:55 -0700 | [diff] [blame] | 536 | out_groups: |
| 537 | device_remove_groups(dev, bus->dev_groups); |
Cornelia Huck | 513e733 | 2006-09-22 11:37:08 +0200 | [diff] [blame] | 538 | out_id: |
| 539 | device_remove_attrs(bus, dev); |
| 540 | out_put: |
Greg Kroah-Hartman | fc1ede5 | 2007-09-13 02:53:13 -0700 | [diff] [blame] | 541 | bus_put(dev->bus); |
Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 542 | return error; |
| 543 | } |
| 544 | |
| 545 | /** |
Alan Stern | 2023c61 | 2009-07-30 15:27:18 -0400 | [diff] [blame] | 546 | * bus_probe_device - probe drivers for a new device |
| 547 | * @dev: device to probe |
Kay Sievers | 53877d0 | 2006-04-04 20:42:26 +0200 | [diff] [blame] | 548 | * |
Alan Stern | 2023c61 | 2009-07-30 15:27:18 -0400 | [diff] [blame] | 549 | * - Automatically probe for a driver if the bus allows it. |
Kay Sievers | 53877d0 | 2006-04-04 20:42:26 +0200 | [diff] [blame] | 550 | */ |
Alan Stern | 2023c61 | 2009-07-30 15:27:18 -0400 | [diff] [blame] | 551 | void bus_probe_device(struct device *dev) |
Kay Sievers | 53877d0 | 2006-04-04 20:42:26 +0200 | [diff] [blame] | 552 | { |
Andrew Morton | f86db39 | 2006-08-14 22:43:20 -0700 | [diff] [blame] | 553 | struct bus_type *bus = dev->bus; |
Kay Sievers | ca22e56 | 2011-12-14 14:29:38 -0800 | [diff] [blame] | 554 | struct subsys_interface *sif; |
Kay Sievers | 53877d0 | 2006-04-04 20:42:26 +0200 | [diff] [blame] | 555 | |
Kay Sievers | ca22e56 | 2011-12-14 14:29:38 -0800 | [diff] [blame] | 556 | if (!bus) |
| 557 | return; |
| 558 | |
Dmitry Torokhov | 765230b | 2015-03-30 16:20:04 -0700 | [diff] [blame] | 559 | if (bus->p->drivers_autoprobe) |
| 560 | device_initial_probe(dev); |
Kay Sievers | ca22e56 | 2011-12-14 14:29:38 -0800 | [diff] [blame] | 561 | |
| 562 | mutex_lock(&bus->p->mutex); |
| 563 | list_for_each_entry(sif, &bus->p->interfaces, node) |
| 564 | if (sif->add_dev) |
| 565 | sif->add_dev(dev, sif); |
| 566 | mutex_unlock(&bus->p->mutex); |
Kay Sievers | 53877d0 | 2006-04-04 20:42:26 +0200 | [diff] [blame] | 567 | } |
| 568 | |
| 569 | /** |
Greg Kroah-Hartman | 4a3ad20 | 2008-01-24 22:50:12 -0800 | [diff] [blame] | 570 | * bus_remove_device - remove device from bus |
| 571 | * @dev: device to be removed |
Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 572 | * |
Kay Sievers | ca22e56 | 2011-12-14 14:29:38 -0800 | [diff] [blame] | 573 | * - Remove device from all interfaces. |
| 574 | * - Remove symlink from bus' directory. |
Greg Kroah-Hartman | 4a3ad20 | 2008-01-24 22:50:12 -0800 | [diff] [blame] | 575 | * - Delete device from bus's list. |
| 576 | * - Detach from its driver. |
| 577 | * - Drop reference taken in bus_add_device(). |
Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 578 | */ |
Greg Kroah-Hartman | 4a3ad20 | 2008-01-24 22:50:12 -0800 | [diff] [blame] | 579 | void bus_remove_device(struct device *dev) |
Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 580 | { |
Kay Sievers | ca22e56 | 2011-12-14 14:29:38 -0800 | [diff] [blame] | 581 | struct bus_type *bus = dev->bus; |
| 582 | struct subsys_interface *sif; |
Greg Kroah-Hartman | 3f62e57 | 2008-03-13 17:07:03 -0400 | [diff] [blame] | 583 | |
Kay Sievers | ca22e56 | 2011-12-14 14:29:38 -0800 | [diff] [blame] | 584 | if (!bus) |
| 585 | return; |
| 586 | |
| 587 | mutex_lock(&bus->p->mutex); |
| 588 | list_for_each_entry(sif, &bus->p->interfaces, node) |
| 589 | if (sif->remove_dev) |
| 590 | sif->remove_dev(dev, sif); |
| 591 | mutex_unlock(&bus->p->mutex); |
| 592 | |
| 593 | sysfs_remove_link(&dev->kobj, "subsystem"); |
| 594 | sysfs_remove_link(&dev->bus->p->devices_kset->kobj, |
| 595 | dev_name(dev)); |
| 596 | device_remove_attrs(dev->bus, dev); |
Greg Kroah-Hartman | fa6fdb3 | 2013-08-08 15:22:55 -0700 | [diff] [blame] | 597 | device_remove_groups(dev, dev->bus->dev_groups); |
Kay Sievers | ca22e56 | 2011-12-14 14:29:38 -0800 | [diff] [blame] | 598 | if (klist_node_attached(&dev->p->knode_bus)) |
| 599 | klist_del(&dev->p->knode_bus); |
| 600 | |
| 601 | pr_debug("bus: '%s': remove device %s\n", |
| 602 | dev->bus->name, dev_name(dev)); |
| 603 | device_release_driver(dev); |
| 604 | bus_put(dev->bus); |
Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 605 | } |
| 606 | |
Andrew Morton | f86db39 | 2006-08-14 22:43:20 -0700 | [diff] [blame] | 607 | static int __must_check add_bind_files(struct device_driver *drv) |
Greg Kroah-Hartman | 874c624 | 2005-12-13 15:17:34 -0800 | [diff] [blame] | 608 | { |
Andrew Morton | f86db39 | 2006-08-14 22:43:20 -0700 | [diff] [blame] | 609 | int ret; |
| 610 | |
| 611 | ret = driver_create_file(drv, &driver_attr_unbind); |
| 612 | if (ret == 0) { |
| 613 | ret = driver_create_file(drv, &driver_attr_bind); |
| 614 | if (ret) |
| 615 | driver_remove_file(drv, &driver_attr_unbind); |
| 616 | } |
| 617 | return ret; |
Greg Kroah-Hartman | 874c624 | 2005-12-13 15:17:34 -0800 | [diff] [blame] | 618 | } |
| 619 | |
| 620 | static void remove_bind_files(struct device_driver *drv) |
| 621 | { |
| 622 | driver_remove_file(drv, &driver_attr_bind); |
| 623 | driver_remove_file(drv, &driver_attr_unbind); |
| 624 | } |
Kay Sievers | b8c5cec | 2007-02-16 17:33:36 +0100 | [diff] [blame] | 625 | |
Kay Sievers | 8380770 | 2007-07-30 02:28:56 +0200 | [diff] [blame] | 626 | static BUS_ATTR(drivers_probe, S_IWUSR, NULL, store_drivers_probe); |
| 627 | static BUS_ATTR(drivers_autoprobe, S_IWUSR | S_IRUGO, |
| 628 | show_drivers_autoprobe, store_drivers_autoprobe); |
| 629 | |
Kay Sievers | b8c5cec | 2007-02-16 17:33:36 +0100 | [diff] [blame] | 630 | static int add_probe_files(struct bus_type *bus) |
| 631 | { |
| 632 | int retval; |
| 633 | |
Kay Sievers | 8380770 | 2007-07-30 02:28:56 +0200 | [diff] [blame] | 634 | retval = bus_create_file(bus, &bus_attr_drivers_probe); |
Kay Sievers | b8c5cec | 2007-02-16 17:33:36 +0100 | [diff] [blame] | 635 | if (retval) |
| 636 | goto out; |
| 637 | |
Kay Sievers | 8380770 | 2007-07-30 02:28:56 +0200 | [diff] [blame] | 638 | retval = bus_create_file(bus, &bus_attr_drivers_autoprobe); |
Kay Sievers | b8c5cec | 2007-02-16 17:33:36 +0100 | [diff] [blame] | 639 | if (retval) |
Kay Sievers | 8380770 | 2007-07-30 02:28:56 +0200 | [diff] [blame] | 640 | bus_remove_file(bus, &bus_attr_drivers_probe); |
Kay Sievers | b8c5cec | 2007-02-16 17:33:36 +0100 | [diff] [blame] | 641 | out: |
| 642 | return retval; |
| 643 | } |
| 644 | |
| 645 | static void remove_probe_files(struct bus_type *bus) |
| 646 | { |
Kay Sievers | 8380770 | 2007-07-30 02:28:56 +0200 | [diff] [blame] | 647 | bus_remove_file(bus, &bus_attr_drivers_autoprobe); |
| 648 | bus_remove_file(bus, &bus_attr_drivers_probe); |
Kay Sievers | b8c5cec | 2007-02-16 17:33:36 +0100 | [diff] [blame] | 649 | } |
Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 650 | |
Greg Kroah-Hartman | 2581c9c | 2013-08-23 15:04:42 -0700 | [diff] [blame] | 651 | static ssize_t uevent_store(struct device_driver *drv, const char *buf, |
| 652 | size_t count) |
Kay Sievers | 7ac1cf4 | 2007-08-12 20:43:55 +0200 | [diff] [blame] | 653 | { |
| 654 | enum kobject_action action; |
| 655 | |
| 656 | if (kobject_action_type(buf, count, &action) == 0) |
Greg Kroah-Hartman | e5dd127 | 2007-11-28 15:59:15 -0800 | [diff] [blame] | 657 | kobject_uevent(&drv->p->kobj, action); |
Kay Sievers | 7ac1cf4 | 2007-08-12 20:43:55 +0200 | [diff] [blame] | 658 | return count; |
| 659 | } |
Greg Kroah-Hartman | 2581c9c | 2013-08-23 15:04:42 -0700 | [diff] [blame] | 660 | static DRIVER_ATTR_WO(uevent); |
Kay Sievers | 7ac1cf4 | 2007-08-12 20:43:55 +0200 | [diff] [blame] | 661 | |
Dmitry Torokhov | 765230b | 2015-03-30 16:20:04 -0700 | [diff] [blame] | 662 | static void driver_attach_async(void *_drv, async_cookie_t cookie) |
| 663 | { |
| 664 | struct device_driver *drv = _drv; |
| 665 | int ret; |
| 666 | |
| 667 | ret = driver_attach(drv); |
| 668 | |
| 669 | pr_debug("bus: '%s': driver %s async attach completed: %d\n", |
| 670 | drv->bus->name, drv->name, ret); |
| 671 | } |
| 672 | |
Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 673 | /** |
Greg Kroah-Hartman | 4a3ad20 | 2008-01-24 22:50:12 -0800 | [diff] [blame] | 674 | * bus_add_driver - Add a driver to the bus. |
| 675 | * @drv: driver. |
Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 676 | */ |
Andrew Morton | f86db39 | 2006-08-14 22:43:20 -0700 | [diff] [blame] | 677 | int bus_add_driver(struct device_driver *drv) |
Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 678 | { |
Greg Kroah-Hartman | e5dd127 | 2007-11-28 15:59:15 -0800 | [diff] [blame] | 679 | struct bus_type *bus; |
| 680 | struct driver_private *priv; |
Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 681 | int error = 0; |
| 682 | |
Greg Kroah-Hartman | e5dd127 | 2007-11-28 15:59:15 -0800 | [diff] [blame] | 683 | bus = bus_get(drv->bus); |
Jeff Garzik | d9fd4d3b3 | 2006-10-04 07:48:03 -0400 | [diff] [blame] | 684 | if (!bus) |
Greg Kroah-Hartman | 4f6e194 | 2007-04-20 11:29:52 -0700 | [diff] [blame] | 685 | return -EINVAL; |
Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 686 | |
Greg Kroah-Hartman | 7dc72b2 | 2007-11-28 23:49:41 -0800 | [diff] [blame] | 687 | pr_debug("bus: '%s': add driver %s\n", bus->name, drv->name); |
Greg Kroah-Hartman | e5dd127 | 2007-11-28 15:59:15 -0800 | [diff] [blame] | 688 | |
| 689 | priv = kzalloc(sizeof(*priv), GFP_KERNEL); |
Cornelia Huck | 0763446 | 2008-02-18 17:04:25 +0100 | [diff] [blame] | 690 | if (!priv) { |
| 691 | error = -ENOMEM; |
| 692 | goto out_put_bus; |
| 693 | } |
Greg Kroah-Hartman | e5dd127 | 2007-11-28 15:59:15 -0800 | [diff] [blame] | 694 | klist_init(&priv->klist_devices, NULL, NULL); |
| 695 | priv->driver = drv; |
| 696 | drv->p = priv; |
Greg Kroah-Hartman | c8e90d8 | 2007-12-17 15:54:39 -0400 | [diff] [blame] | 697 | priv->kobj.kset = bus->p->drivers_kset; |
| 698 | error = kobject_init_and_add(&priv->kobj, &driver_ktype, NULL, |
| 699 | "%s", drv->name); |
Cornelia Huck | dc0afa8 | 2007-07-09 11:39:18 -0700 | [diff] [blame] | 700 | if (error) |
Cornelia Huck | 0763446 | 2008-02-18 17:04:25 +0100 | [diff] [blame] | 701 | goto out_unregister; |
Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 702 | |
Ming Lei | 190888a | 2012-11-19 23:35:17 +0800 | [diff] [blame] | 703 | klist_add_tail(&priv->knode_bus, &bus->p->klist_drivers); |
Greg Kroah-Hartman | c6f7e72 | 2007-11-01 19:41:16 -0700 | [diff] [blame] | 704 | if (drv->bus->p->drivers_autoprobe) { |
Dmitry Torokhov | 765230b | 2015-03-30 16:20:04 -0700 | [diff] [blame] | 705 | if (driver_allows_async_probing(drv)) { |
| 706 | pr_debug("bus: '%s': probing driver %s asynchronously\n", |
| 707 | drv->bus->name, drv->name); |
| 708 | async_schedule(driver_attach_async, drv); |
| 709 | } else { |
| 710 | error = driver_attach(drv); |
| 711 | if (error) |
| 712 | goto out_unregister; |
| 713 | } |
Kay Sievers | b8c5cec | 2007-02-16 17:33:36 +0100 | [diff] [blame] | 714 | } |
Jeff Garzik | d9fd4d3b3 | 2006-10-04 07:48:03 -0400 | [diff] [blame] | 715 | module_add_driver(drv->owner, drv); |
| 716 | |
Kay Sievers | 7ac1cf4 | 2007-08-12 20:43:55 +0200 | [diff] [blame] | 717 | error = driver_create_file(drv, &driver_attr_uevent); |
| 718 | if (error) { |
| 719 | printk(KERN_ERR "%s: uevent attr (%s) failed\n", |
Harvey Harrison | 2b3a302 | 2008-03-04 16:41:05 -0800 | [diff] [blame] | 720 | __func__, drv->name); |
Kay Sievers | 7ac1cf4 | 2007-08-12 20:43:55 +0200 | [diff] [blame] | 721 | } |
Greg Kroah-Hartman | e18945b | 2013-09-27 21:47:21 -0700 | [diff] [blame] | 722 | error = driver_add_groups(drv, bus->drv_groups); |
Jeff Garzik | d9fd4d3b3 | 2006-10-04 07:48:03 -0400 | [diff] [blame] | 723 | if (error) { |
| 724 | /* How the hell do we get out of this pickle? Give up */ |
Greg Kroah-Hartman | ed0617b | 2013-08-08 15:22:56 -0700 | [diff] [blame] | 725 | printk(KERN_ERR "%s: driver_create_groups(%s) failed\n", |
| 726 | __func__, drv->name); |
Greg Kroah-Hartman | e18945b | 2013-09-27 21:47:21 -0700 | [diff] [blame] | 727 | } |
Dmitry Torokhov | 1a6f2a7 | 2009-10-12 20:17:41 -0700 | [diff] [blame] | 728 | |
| 729 | if (!drv->suppress_bind_attrs) { |
| 730 | error = add_bind_files(drv); |
| 731 | if (error) { |
| 732 | /* Ditto */ |
| 733 | printk(KERN_ERR "%s: add_bind_files(%s) failed\n", |
| 734 | __func__, drv->name); |
| 735 | } |
Jeff Garzik | d9fd4d3b3 | 2006-10-04 07:48:03 -0400 | [diff] [blame] | 736 | } |
| 737 | |
Kay Sievers | 5c8563d | 2009-05-28 14:24:07 -0700 | [diff] [blame] | 738 | return 0; |
Dmitry Torokhov | 1a6f2a7 | 2009-10-12 20:17:41 -0700 | [diff] [blame] | 739 | |
Andrew Morton | f86db39 | 2006-08-14 22:43:20 -0700 | [diff] [blame] | 740 | out_unregister: |
Phil Carmody | 99b28f1 | 2009-12-14 20:28:12 +0200 | [diff] [blame] | 741 | kobject_put(&priv->kobj); |
Christophe JAILLET | 5555eb9 | 2017-08-29 21:23:49 +0200 | [diff] [blame] | 742 | /* drv->p is freed in driver_release() */ |
Kay Sievers | 5c8563d | 2009-05-28 14:24:07 -0700 | [diff] [blame] | 743 | drv->p = NULL; |
Andrew Morton | f86db39 | 2006-08-14 22:43:20 -0700 | [diff] [blame] | 744 | out_put_bus: |
Greg Kroah-Hartman | fc1ede5 | 2007-09-13 02:53:13 -0700 | [diff] [blame] | 745 | bus_put(bus); |
Andrew Morton | f86db39 | 2006-08-14 22:43:20 -0700 | [diff] [blame] | 746 | return error; |
Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 747 | } |
| 748 | |
Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 749 | /** |
Greg Kroah-Hartman | 4a3ad20 | 2008-01-24 22:50:12 -0800 | [diff] [blame] | 750 | * bus_remove_driver - delete driver from bus's knowledge. |
| 751 | * @drv: driver. |
Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 752 | * |
Greg Kroah-Hartman | 4a3ad20 | 2008-01-24 22:50:12 -0800 | [diff] [blame] | 753 | * Detach the driver from the devices it controls, and remove |
| 754 | * it from its bus's list of drivers. Finally, we drop the reference |
| 755 | * to the bus we took in bus_add_driver(). |
Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 756 | */ |
Greg Kroah-Hartman | 4a3ad20 | 2008-01-24 22:50:12 -0800 | [diff] [blame] | 757 | void bus_remove_driver(struct device_driver *drv) |
Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 758 | { |
Jeff Garzik | d9fd4d3b3 | 2006-10-04 07:48:03 -0400 | [diff] [blame] | 759 | if (!drv->bus) |
| 760 | return; |
| 761 | |
Dmitry Torokhov | 1a6f2a7 | 2009-10-12 20:17:41 -0700 | [diff] [blame] | 762 | if (!drv->suppress_bind_attrs) |
| 763 | remove_bind_files(drv); |
Greg Kroah-Hartman | ed0617b | 2013-08-08 15:22:56 -0700 | [diff] [blame] | 764 | driver_remove_groups(drv, drv->bus->drv_groups); |
Kay Sievers | 7ac1cf4 | 2007-08-12 20:43:55 +0200 | [diff] [blame] | 765 | driver_remove_file(drv, &driver_attr_uevent); |
Greg Kroah-Hartman | e5dd127 | 2007-11-28 15:59:15 -0800 | [diff] [blame] | 766 | klist_remove(&drv->p->knode_bus); |
Greg Kroah-Hartman | 7dc72b2 | 2007-11-28 23:49:41 -0800 | [diff] [blame] | 767 | pr_debug("bus: '%s': remove driver %s\n", drv->bus->name, drv->name); |
Jeff Garzik | d9fd4d3b3 | 2006-10-04 07:48:03 -0400 | [diff] [blame] | 768 | driver_detach(drv); |
| 769 | module_remove_driver(drv); |
Greg Kroah-Hartman | c10997f | 2007-12-20 08:13:05 -0800 | [diff] [blame] | 770 | kobject_put(&drv->p->kobj); |
Greg Kroah-Hartman | fc1ede5 | 2007-09-13 02:53:13 -0700 | [diff] [blame] | 771 | bus_put(drv->bus); |
Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 772 | } |
| 773 | |
Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 774 | /* Helper for bus_rescan_devices's iter */ |
Andrew Morton | f86db39 | 2006-08-14 22:43:20 -0700 | [diff] [blame] | 775 | static int __must_check bus_rescan_devices_helper(struct device *dev, |
Greg Kroah-Hartman | 4a3ad20 | 2008-01-24 22:50:12 -0800 | [diff] [blame] | 776 | void *data) |
Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 777 | { |
Andrew Morton | f86db39 | 2006-08-14 22:43:20 -0700 | [diff] [blame] | 778 | int ret = 0; |
| 779 | |
Alan Stern | bf74ad5 | 2005-11-17 16:54:12 -0500 | [diff] [blame] | 780 | if (!dev->driver) { |
| 781 | if (dev->parent) /* Needed for USB */ |
Greg Kroah-Hartman | 8e9394c | 2010-02-17 10:57:05 -0800 | [diff] [blame] | 782 | device_lock(dev->parent); |
Andrew Morton | f86db39 | 2006-08-14 22:43:20 -0700 | [diff] [blame] | 783 | ret = device_attach(dev); |
Alan Stern | bf74ad5 | 2005-11-17 16:54:12 -0500 | [diff] [blame] | 784 | if (dev->parent) |
Greg Kroah-Hartman | 8e9394c | 2010-02-17 10:57:05 -0800 | [diff] [blame] | 785 | device_unlock(dev->parent); |
Alan Stern | bf74ad5 | 2005-11-17 16:54:12 -0500 | [diff] [blame] | 786 | } |
Andrew Morton | f86db39 | 2006-08-14 22:43:20 -0700 | [diff] [blame] | 787 | return ret < 0 ? ret : 0; |
Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 788 | } |
| 789 | |
Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 790 | /** |
Greg Kroah-Hartman | 23d3d60 | 2005-06-22 16:09:05 -0700 | [diff] [blame] | 791 | * bus_rescan_devices - rescan devices on the bus for possible drivers |
| 792 | * @bus: the bus to scan. |
Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 793 | * |
Greg Kroah-Hartman | 23d3d60 | 2005-06-22 16:09:05 -0700 | [diff] [blame] | 794 | * This function will look for devices on the bus with no driver |
| 795 | * attached and rescan it against existing drivers to see if it matches |
| 796 | * any by calling device_attach() for the unbound devices. |
Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 797 | */ |
Greg Kroah-Hartman | 4a3ad20 | 2008-01-24 22:50:12 -0800 | [diff] [blame] | 798 | int bus_rescan_devices(struct bus_type *bus) |
Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 799 | { |
Andrew Morton | f86db39 | 2006-08-14 22:43:20 -0700 | [diff] [blame] | 800 | return bus_for_each_dev(bus, NULL, NULL, bus_rescan_devices_helper); |
Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 801 | } |
Greg Kroah-Hartman | 4a3ad20 | 2008-01-24 22:50:12 -0800 | [diff] [blame] | 802 | EXPORT_SYMBOL_GPL(bus_rescan_devices); |
Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 803 | |
Moore, Eric | e935d5d | 2006-03-14 09:18:18 -0700 | [diff] [blame] | 804 | /** |
| 805 | * device_reprobe - remove driver for a device and probe for a new driver |
| 806 | * @dev: the device to reprobe |
| 807 | * |
| 808 | * This function detaches the attached driver (if any) for the given |
| 809 | * device and restarts the driver probing process. It is intended |
| 810 | * to use if probing criteria changed during a devices lifetime and |
| 811 | * driver attachment should change accordingly. |
| 812 | */ |
Andrew Morton | f86db39 | 2006-08-14 22:43:20 -0700 | [diff] [blame] | 813 | int device_reprobe(struct device *dev) |
Moore, Eric | e935d5d | 2006-03-14 09:18:18 -0700 | [diff] [blame] | 814 | { |
| 815 | if (dev->driver) { |
| 816 | if (dev->parent) /* Needed for USB */ |
Greg Kroah-Hartman | 8e9394c | 2010-02-17 10:57:05 -0800 | [diff] [blame] | 817 | device_lock(dev->parent); |
Moore, Eric | e935d5d | 2006-03-14 09:18:18 -0700 | [diff] [blame] | 818 | device_release_driver(dev); |
| 819 | if (dev->parent) |
Greg Kroah-Hartman | 8e9394c | 2010-02-17 10:57:05 -0800 | [diff] [blame] | 820 | device_unlock(dev->parent); |
Moore, Eric | e935d5d | 2006-03-14 09:18:18 -0700 | [diff] [blame] | 821 | } |
Andrew Morton | f86db39 | 2006-08-14 22:43:20 -0700 | [diff] [blame] | 822 | return bus_rescan_devices_helper(dev, NULL); |
Moore, Eric | e935d5d | 2006-03-14 09:18:18 -0700 | [diff] [blame] | 823 | } |
| 824 | EXPORT_SYMBOL_GPL(device_reprobe); |
Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 825 | |
Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 826 | /** |
Greg Kroah-Hartman | 4a3ad20 | 2008-01-24 22:50:12 -0800 | [diff] [blame] | 827 | * find_bus - locate bus by name. |
| 828 | * @name: name of bus. |
Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 829 | * |
Greg Kroah-Hartman | 4a3ad20 | 2008-01-24 22:50:12 -0800 | [diff] [blame] | 830 | * Call kset_find_obj() to iterate over list of buses to |
| 831 | * find a bus by name. Return bus if found. |
Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 832 | * |
Greg Kroah-Hartman | 4a3ad20 | 2008-01-24 22:50:12 -0800 | [diff] [blame] | 833 | * Note that kset_find_obj increments bus' reference count. |
Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 834 | */ |
Adrian Bunk | 7e4ef08 | 2006-06-26 22:26:56 +0200 | [diff] [blame] | 835 | #if 0 |
Greg Kroah-Hartman | 4a3ad20 | 2008-01-24 22:50:12 -0800 | [diff] [blame] | 836 | struct bus_type *find_bus(char *name) |
Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 837 | { |
Greg Kroah-Hartman | 4a3ad20 | 2008-01-24 22:50:12 -0800 | [diff] [blame] | 838 | struct kobject *k = kset_find_obj(bus_kset, name); |
Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 839 | return k ? to_bus(k) : NULL; |
| 840 | } |
Adrian Bunk | 7e4ef08 | 2006-06-26 22:26:56 +0200 | [diff] [blame] | 841 | #endif /* 0 */ |
Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 842 | |
Greg Kroah-Hartman | 12478ba | 2013-08-08 15:22:57 -0700 | [diff] [blame] | 843 | static int bus_add_groups(struct bus_type *bus, |
| 844 | const struct attribute_group **groups) |
| 845 | { |
Greg Kroah-Hartman | 3e9b2ba | 2013-08-21 13:47:50 -0700 | [diff] [blame] | 846 | return sysfs_create_groups(&bus->p->subsys.kobj, groups); |
Greg Kroah-Hartman | 12478ba | 2013-08-08 15:22:57 -0700 | [diff] [blame] | 847 | } |
| 848 | |
| 849 | static void bus_remove_groups(struct bus_type *bus, |
| 850 | const struct attribute_group **groups) |
| 851 | { |
Greg Kroah-Hartman | 3e9b2ba | 2013-08-21 13:47:50 -0700 | [diff] [blame] | 852 | sysfs_remove_groups(&bus->p->subsys.kobj, groups); |
Greg Kroah-Hartman | 12478ba | 2013-08-08 15:22:57 -0700 | [diff] [blame] | 853 | } |
| 854 | |
James Bottomley | 34bb61f | 2005-09-06 16:56:51 -0700 | [diff] [blame] | 855 | static void klist_devices_get(struct klist_node *n) |
| 856 | { |
Greg Kroah-Hartman | ae1b417 | 2008-12-16 12:26:21 -0800 | [diff] [blame] | 857 | struct device_private *dev_prv = to_device_private_bus(n); |
| 858 | struct device *dev = dev_prv->device; |
James Bottomley | 34bb61f | 2005-09-06 16:56:51 -0700 | [diff] [blame] | 859 | |
| 860 | get_device(dev); |
| 861 | } |
| 862 | |
| 863 | static void klist_devices_put(struct klist_node *n) |
| 864 | { |
Greg Kroah-Hartman | ae1b417 | 2008-12-16 12:26:21 -0800 | [diff] [blame] | 865 | struct device_private *dev_prv = to_device_private_bus(n); |
| 866 | struct device *dev = dev_prv->device; |
James Bottomley | 34bb61f | 2005-09-06 16:56:51 -0700 | [diff] [blame] | 867 | |
| 868 | put_device(dev); |
| 869 | } |
| 870 | |
Kay Sievers | 7ac1cf4 | 2007-08-12 20:43:55 +0200 | [diff] [blame] | 871 | static ssize_t bus_uevent_store(struct bus_type *bus, |
| 872 | const char *buf, size_t count) |
| 873 | { |
| 874 | enum kobject_action action; |
| 875 | |
| 876 | if (kobject_action_type(buf, count, &action) == 0) |
Greg Kroah-Hartman | c6f7e72 | 2007-11-01 19:41:16 -0700 | [diff] [blame] | 877 | kobject_uevent(&bus->p->subsys.kobj, action); |
Kay Sievers | 7ac1cf4 | 2007-08-12 20:43:55 +0200 | [diff] [blame] | 878 | return count; |
| 879 | } |
| 880 | static BUS_ATTR(uevent, S_IWUSR, NULL, bus_uevent_store); |
| 881 | |
Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 882 | /** |
Michal Hocko | be871b7 | 2013-03-12 17:21:19 +0100 | [diff] [blame] | 883 | * bus_register - register a driver-core subsystem |
Randy Dunlap | 78d7955 | 2012-01-21 11:02:28 -0800 | [diff] [blame] | 884 | * @bus: bus to register |
Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 885 | * |
Randy Dunlap | 78d7955 | 2012-01-21 11:02:28 -0800 | [diff] [blame] | 886 | * Once we have that, we register the bus with the kobject |
Greg Kroah-Hartman | 4a3ad20 | 2008-01-24 22:50:12 -0800 | [diff] [blame] | 887 | * infrastructure, then register the children subsystems it has: |
Kay Sievers | ca22e56 | 2011-12-14 14:29:38 -0800 | [diff] [blame] | 888 | * the devices and drivers that belong to the subsystem. |
Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 889 | */ |
Michal Hocko | be871b7 | 2013-03-12 17:21:19 +0100 | [diff] [blame] | 890 | int bus_register(struct bus_type *bus) |
Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 891 | { |
| 892 | int retval; |
Kay Sievers | 6b6e39a | 2010-11-15 23:13:18 +0100 | [diff] [blame] | 893 | struct subsys_private *priv; |
Michal Hocko | be871b7 | 2013-03-12 17:21:19 +0100 | [diff] [blame] | 894 | struct lock_class_key *key = &bus->lock_key; |
Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 895 | |
Kay Sievers | 6b6e39a | 2010-11-15 23:13:18 +0100 | [diff] [blame] | 896 | priv = kzalloc(sizeof(struct subsys_private), GFP_KERNEL); |
Greg Kroah-Hartman | c6f7e72 | 2007-11-01 19:41:16 -0700 | [diff] [blame] | 897 | if (!priv) |
| 898 | return -ENOMEM; |
Benjamin Herrenschmidt | 116af37 | 2006-10-25 13:44:59 +1000 | [diff] [blame] | 899 | |
Greg Kroah-Hartman | c6f7e72 | 2007-11-01 19:41:16 -0700 | [diff] [blame] | 900 | priv->bus = bus; |
| 901 | bus->p = priv; |
| 902 | |
| 903 | BLOCKING_INIT_NOTIFIER_HEAD(&priv->bus_notifier); |
| 904 | |
| 905 | retval = kobject_set_name(&priv->subsys.kobj, "%s", bus->name); |
Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 906 | if (retval) |
| 907 | goto out; |
| 908 | |
Greg Kroah-Hartman | c6f7e72 | 2007-11-01 19:41:16 -0700 | [diff] [blame] | 909 | priv->subsys.kobj.kset = bus_kset; |
| 910 | priv->subsys.kobj.ktype = &bus_ktype; |
| 911 | priv->drivers_autoprobe = 1; |
Greg Kroah-Hartman | d6b05b8 | 2007-09-12 15:06:57 -0700 | [diff] [blame] | 912 | |
Greg Kroah-Hartman | c6f7e72 | 2007-11-01 19:41:16 -0700 | [diff] [blame] | 913 | retval = kset_register(&priv->subsys); |
Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 914 | if (retval) |
| 915 | goto out; |
| 916 | |
Kay Sievers | 7ac1cf4 | 2007-08-12 20:43:55 +0200 | [diff] [blame] | 917 | retval = bus_create_file(bus, &bus_attr_uevent); |
| 918 | if (retval) |
| 919 | goto bus_uevent_fail; |
| 920 | |
Greg Kroah-Hartman | c6f7e72 | 2007-11-01 19:41:16 -0700 | [diff] [blame] | 921 | priv->devices_kset = kset_create_and_add("devices", NULL, |
| 922 | &priv->subsys.kobj); |
| 923 | if (!priv->devices_kset) { |
Greg Kroah-Hartman | 3d89959 | 2007-11-01 13:31:26 -0700 | [diff] [blame] | 924 | retval = -ENOMEM; |
Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 925 | goto bus_devices_fail; |
Greg Kroah-Hartman | 3d89959 | 2007-11-01 13:31:26 -0700 | [diff] [blame] | 926 | } |
Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 927 | |
Greg Kroah-Hartman | c6f7e72 | 2007-11-01 19:41:16 -0700 | [diff] [blame] | 928 | priv->drivers_kset = kset_create_and_add("drivers", NULL, |
| 929 | &priv->subsys.kobj); |
| 930 | if (!priv->drivers_kset) { |
Greg Kroah-Hartman | 6dcec25 | 2007-11-01 13:31:26 -0700 | [diff] [blame] | 931 | retval = -ENOMEM; |
Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 932 | goto bus_drivers_fail; |
Greg Kroah-Hartman | 6dcec25 | 2007-11-01 13:31:26 -0700 | [diff] [blame] | 933 | } |
mochel@digitalimplant.org | 465c7a3 | 2005-03-21 11:49:14 -0800 | [diff] [blame] | 934 | |
Kay Sievers | ca22e56 | 2011-12-14 14:29:38 -0800 | [diff] [blame] | 935 | INIT_LIST_HEAD(&priv->interfaces); |
| 936 | __mutex_init(&priv->mutex, "subsys mutex", key); |
Greg Kroah-Hartman | c6f7e72 | 2007-11-01 19:41:16 -0700 | [diff] [blame] | 937 | klist_init(&priv->klist_devices, klist_devices_get, klist_devices_put); |
| 938 | klist_init(&priv->klist_drivers, NULL, NULL); |
Kay Sievers | b8c5cec | 2007-02-16 17:33:36 +0100 | [diff] [blame] | 939 | |
Kay Sievers | b8c5cec | 2007-02-16 17:33:36 +0100 | [diff] [blame] | 940 | retval = add_probe_files(bus); |
| 941 | if (retval) |
| 942 | goto bus_probe_files_fail; |
| 943 | |
Greg Kroah-Hartman | 12478ba | 2013-08-08 15:22:57 -0700 | [diff] [blame] | 944 | retval = bus_add_groups(bus, bus->bus_groups); |
| 945 | if (retval) |
| 946 | goto bus_groups_fail; |
Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 947 | |
Greg Kroah-Hartman | 7dc72b2 | 2007-11-28 23:49:41 -0800 | [diff] [blame] | 948 | pr_debug("bus: '%s': registered\n", bus->name); |
Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 949 | return 0; |
| 950 | |
Greg Kroah-Hartman | 12478ba | 2013-08-08 15:22:57 -0700 | [diff] [blame] | 951 | bus_groups_fail: |
Kay Sievers | b8c5cec | 2007-02-16 17:33:36 +0100 | [diff] [blame] | 952 | remove_probe_files(bus); |
| 953 | bus_probe_files_fail: |
Greg Kroah-Hartman | c6f7e72 | 2007-11-01 19:41:16 -0700 | [diff] [blame] | 954 | kset_unregister(bus->p->drivers_kset); |
Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 955 | bus_drivers_fail: |
Greg Kroah-Hartman | c6f7e72 | 2007-11-01 19:41:16 -0700 | [diff] [blame] | 956 | kset_unregister(bus->p->devices_kset); |
Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 957 | bus_devices_fail: |
Kay Sievers | 7ac1cf4 | 2007-08-12 20:43:55 +0200 | [diff] [blame] | 958 | bus_remove_file(bus, &bus_attr_uevent); |
| 959 | bus_uevent_fail: |
Greg Kroah-Hartman | c6f7e72 | 2007-11-01 19:41:16 -0700 | [diff] [blame] | 960 | kset_unregister(&bus->p->subsys); |
Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 961 | out: |
Jike Song | 600c20f | 2010-07-15 17:43:54 +0800 | [diff] [blame] | 962 | kfree(bus->p); |
Dave Young | f48f3fe | 2009-02-14 21:23:22 +0800 | [diff] [blame] | 963 | bus->p = NULL; |
Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 964 | return retval; |
| 965 | } |
Michal Hocko | be871b7 | 2013-03-12 17:21:19 +0100 | [diff] [blame] | 966 | EXPORT_SYMBOL_GPL(bus_register); |
Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 967 | |
Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 968 | /** |
Greg Kroah-Hartman | 4a3ad20 | 2008-01-24 22:50:12 -0800 | [diff] [blame] | 969 | * bus_unregister - remove a bus from the system |
| 970 | * @bus: bus. |
Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 971 | * |
Greg Kroah-Hartman | 4a3ad20 | 2008-01-24 22:50:12 -0800 | [diff] [blame] | 972 | * Unregister the child subsystems and the bus itself. |
| 973 | * Finally, we call bus_put() to release the refcount |
Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 974 | */ |
Greg Kroah-Hartman | 4a3ad20 | 2008-01-24 22:50:12 -0800 | [diff] [blame] | 975 | void bus_unregister(struct bus_type *bus) |
Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 976 | { |
Greg Kroah-Hartman | 7dc72b2 | 2007-11-28 23:49:41 -0800 | [diff] [blame] | 977 | pr_debug("bus: '%s': unregistering\n", bus->name); |
Kay Sievers | ca22e56 | 2011-12-14 14:29:38 -0800 | [diff] [blame] | 978 | if (bus->dev_root) |
| 979 | device_unregister(bus->dev_root); |
Greg Kroah-Hartman | 12478ba | 2013-08-08 15:22:57 -0700 | [diff] [blame] | 980 | bus_remove_groups(bus, bus->bus_groups); |
Kay Sievers | b8c5cec | 2007-02-16 17:33:36 +0100 | [diff] [blame] | 981 | remove_probe_files(bus); |
Greg Kroah-Hartman | c6f7e72 | 2007-11-01 19:41:16 -0700 | [diff] [blame] | 982 | kset_unregister(bus->p->drivers_kset); |
| 983 | kset_unregister(bus->p->devices_kset); |
Kay Sievers | 7ac1cf4 | 2007-08-12 20:43:55 +0200 | [diff] [blame] | 984 | bus_remove_file(bus, &bus_attr_uevent); |
Greg Kroah-Hartman | c6f7e72 | 2007-11-01 19:41:16 -0700 | [diff] [blame] | 985 | kset_unregister(&bus->p->subsys); |
Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 986 | } |
Greg Kroah-Hartman | 4a3ad20 | 2008-01-24 22:50:12 -0800 | [diff] [blame] | 987 | EXPORT_SYMBOL_GPL(bus_unregister); |
Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 988 | |
Benjamin Herrenschmidt | 116af37 | 2006-10-25 13:44:59 +1000 | [diff] [blame] | 989 | int bus_register_notifier(struct bus_type *bus, struct notifier_block *nb) |
| 990 | { |
Greg Kroah-Hartman | c6f7e72 | 2007-11-01 19:41:16 -0700 | [diff] [blame] | 991 | return blocking_notifier_chain_register(&bus->p->bus_notifier, nb); |
Benjamin Herrenschmidt | 116af37 | 2006-10-25 13:44:59 +1000 | [diff] [blame] | 992 | } |
| 993 | EXPORT_SYMBOL_GPL(bus_register_notifier); |
| 994 | |
| 995 | int bus_unregister_notifier(struct bus_type *bus, struct notifier_block *nb) |
| 996 | { |
Greg Kroah-Hartman | c6f7e72 | 2007-11-01 19:41:16 -0700 | [diff] [blame] | 997 | return blocking_notifier_chain_unregister(&bus->p->bus_notifier, nb); |
Benjamin Herrenschmidt | 116af37 | 2006-10-25 13:44:59 +1000 | [diff] [blame] | 998 | } |
| 999 | EXPORT_SYMBOL_GPL(bus_unregister_notifier); |
| 1000 | |
Greg Kroah-Hartman | 0fed80f | 2007-11-01 19:41:16 -0700 | [diff] [blame] | 1001 | struct kset *bus_get_kset(struct bus_type *bus) |
| 1002 | { |
Greg Kroah-Hartman | c6f7e72 | 2007-11-01 19:41:16 -0700 | [diff] [blame] | 1003 | return &bus->p->subsys; |
Greg Kroah-Hartman | 0fed80f | 2007-11-01 19:41:16 -0700 | [diff] [blame] | 1004 | } |
| 1005 | EXPORT_SYMBOL_GPL(bus_get_kset); |
| 1006 | |
Greg Kroah-Hartman | b249072 | 2007-11-01 19:41:16 -0700 | [diff] [blame] | 1007 | struct klist *bus_get_device_klist(struct bus_type *bus) |
| 1008 | { |
Greg Kroah-Hartman | c6f7e72 | 2007-11-01 19:41:16 -0700 | [diff] [blame] | 1009 | return &bus->p->klist_devices; |
Greg Kroah-Hartman | b249072 | 2007-11-01 19:41:16 -0700 | [diff] [blame] | 1010 | } |
| 1011 | EXPORT_SYMBOL_GPL(bus_get_device_klist); |
| 1012 | |
Greg Kroah-Hartman | 99178b0 | 2008-08-26 11:00:57 -0500 | [diff] [blame] | 1013 | /* |
Robert P. J. Day | dca25eb | 2010-11-21 08:15:01 -0500 | [diff] [blame] | 1014 | * Yes, this forcibly breaks the klist abstraction temporarily. It |
Greg Kroah-Hartman | 99178b0 | 2008-08-26 11:00:57 -0500 | [diff] [blame] | 1015 | * just wants to sort the klist, not change reference counts and |
| 1016 | * take/drop locks rapidly in the process. It does all this while |
| 1017 | * holding the lock for the list, so objects can't otherwise be |
| 1018 | * added/removed while we're swizzling. |
| 1019 | */ |
| 1020 | static void device_insertion_sort_klist(struct device *a, struct list_head *list, |
| 1021 | int (*compare)(const struct device *a, |
| 1022 | const struct device *b)) |
| 1023 | { |
Greg Kroah-Hartman | 99178b0 | 2008-08-26 11:00:57 -0500 | [diff] [blame] | 1024 | struct klist_node *n; |
Greg Kroah-Hartman | ae1b417 | 2008-12-16 12:26:21 -0800 | [diff] [blame] | 1025 | struct device_private *dev_prv; |
Greg Kroah-Hartman | 99178b0 | 2008-08-26 11:00:57 -0500 | [diff] [blame] | 1026 | struct device *b; |
| 1027 | |
Geliang Tang | 4c62785 | 2016-01-05 23:03:37 +0800 | [diff] [blame] | 1028 | list_for_each_entry(n, list, n_node) { |
Greg Kroah-Hartman | ae1b417 | 2008-12-16 12:26:21 -0800 | [diff] [blame] | 1029 | dev_prv = to_device_private_bus(n); |
| 1030 | b = dev_prv->device; |
Greg Kroah-Hartman | 99178b0 | 2008-08-26 11:00:57 -0500 | [diff] [blame] | 1031 | if (compare(a, b) <= 0) { |
Greg Kroah-Hartman | ae1b417 | 2008-12-16 12:26:21 -0800 | [diff] [blame] | 1032 | list_move_tail(&a->p->knode_bus.n_node, |
| 1033 | &b->p->knode_bus.n_node); |
Greg Kroah-Hartman | 99178b0 | 2008-08-26 11:00:57 -0500 | [diff] [blame] | 1034 | return; |
| 1035 | } |
| 1036 | } |
Greg Kroah-Hartman | ae1b417 | 2008-12-16 12:26:21 -0800 | [diff] [blame] | 1037 | list_move_tail(&a->p->knode_bus.n_node, list); |
Greg Kroah-Hartman | 99178b0 | 2008-08-26 11:00:57 -0500 | [diff] [blame] | 1038 | } |
| 1039 | |
| 1040 | void bus_sort_breadthfirst(struct bus_type *bus, |
| 1041 | int (*compare)(const struct device *a, |
| 1042 | const struct device *b)) |
| 1043 | { |
| 1044 | LIST_HEAD(sorted_devices); |
Geliang Tang | 4c62785 | 2016-01-05 23:03:37 +0800 | [diff] [blame] | 1045 | struct klist_node *n, *tmp; |
Greg Kroah-Hartman | ae1b417 | 2008-12-16 12:26:21 -0800 | [diff] [blame] | 1046 | struct device_private *dev_prv; |
Greg Kroah-Hartman | 99178b0 | 2008-08-26 11:00:57 -0500 | [diff] [blame] | 1047 | struct device *dev; |
| 1048 | struct klist *device_klist; |
| 1049 | |
| 1050 | device_klist = bus_get_device_klist(bus); |
| 1051 | |
| 1052 | spin_lock(&device_klist->k_lock); |
Geliang Tang | 4c62785 | 2016-01-05 23:03:37 +0800 | [diff] [blame] | 1053 | list_for_each_entry_safe(n, tmp, &device_klist->k_list, n_node) { |
Greg Kroah-Hartman | ae1b417 | 2008-12-16 12:26:21 -0800 | [diff] [blame] | 1054 | dev_prv = to_device_private_bus(n); |
| 1055 | dev = dev_prv->device; |
Greg Kroah-Hartman | 99178b0 | 2008-08-26 11:00:57 -0500 | [diff] [blame] | 1056 | device_insertion_sort_klist(dev, &sorted_devices, compare); |
| 1057 | } |
| 1058 | list_splice(&sorted_devices, &device_klist->k_list); |
| 1059 | spin_unlock(&device_klist->k_lock); |
| 1060 | } |
| 1061 | EXPORT_SYMBOL_GPL(bus_sort_breadthfirst); |
| 1062 | |
Kay Sievers | ca22e56 | 2011-12-14 14:29:38 -0800 | [diff] [blame] | 1063 | /** |
| 1064 | * subsys_dev_iter_init - initialize subsys device iterator |
| 1065 | * @iter: subsys iterator to initialize |
| 1066 | * @subsys: the subsys we wanna iterate over |
| 1067 | * @start: the device to start iterating from, if any |
| 1068 | * @type: device_type of the devices to iterate over, NULL for all |
| 1069 | * |
| 1070 | * Initialize subsys iterator @iter such that it iterates over devices |
| 1071 | * of @subsys. If @start is set, the list iteration will start there, |
| 1072 | * otherwise if it is NULL, the iteration starts at the beginning of |
| 1073 | * the list. |
| 1074 | */ |
Greg Kroah-Hartman | 7cd9c9b | 2012-04-19 19:17:30 -0700 | [diff] [blame] | 1075 | void subsys_dev_iter_init(struct subsys_dev_iter *iter, struct bus_type *subsys, |
| 1076 | struct device *start, const struct device_type *type) |
Kay Sievers | ca22e56 | 2011-12-14 14:29:38 -0800 | [diff] [blame] | 1077 | { |
| 1078 | struct klist_node *start_knode = NULL; |
| 1079 | |
| 1080 | if (start) |
| 1081 | start_knode = &start->p->knode_bus; |
Greg Kroah-Hartman | 7cd9c9b | 2012-04-19 19:17:30 -0700 | [diff] [blame] | 1082 | klist_iter_init_node(&subsys->p->klist_devices, &iter->ki, start_knode); |
| 1083 | iter->type = type; |
Kay Sievers | ca22e56 | 2011-12-14 14:29:38 -0800 | [diff] [blame] | 1084 | } |
| 1085 | EXPORT_SYMBOL_GPL(subsys_dev_iter_init); |
| 1086 | |
| 1087 | /** |
| 1088 | * subsys_dev_iter_next - iterate to the next device |
| 1089 | * @iter: subsys iterator to proceed |
| 1090 | * |
| 1091 | * Proceed @iter to the next device and return it. Returns NULL if |
| 1092 | * iteration is complete. |
| 1093 | * |
| 1094 | * The returned device is referenced and won't be released till |
| 1095 | * iterator is proceed to the next device or exited. The caller is |
| 1096 | * free to do whatever it wants to do with the device including |
| 1097 | * calling back into subsys code. |
| 1098 | */ |
| 1099 | struct device *subsys_dev_iter_next(struct subsys_dev_iter *iter) |
| 1100 | { |
| 1101 | struct klist_node *knode; |
| 1102 | struct device *dev; |
| 1103 | |
| 1104 | for (;;) { |
| 1105 | knode = klist_next(&iter->ki); |
| 1106 | if (!knode) |
| 1107 | return NULL; |
Geliang Tang | 371fd7a | 2016-01-05 23:03:38 +0800 | [diff] [blame] | 1108 | dev = to_device_private_bus(knode)->device; |
Kay Sievers | ca22e56 | 2011-12-14 14:29:38 -0800 | [diff] [blame] | 1109 | if (!iter->type || iter->type == dev->type) |
| 1110 | return dev; |
| 1111 | } |
| 1112 | } |
| 1113 | EXPORT_SYMBOL_GPL(subsys_dev_iter_next); |
| 1114 | |
| 1115 | /** |
| 1116 | * subsys_dev_iter_exit - finish iteration |
| 1117 | * @iter: subsys iterator to finish |
| 1118 | * |
| 1119 | * Finish an iteration. Always call this function after iteration is |
| 1120 | * complete whether the iteration ran till the end or not. |
| 1121 | */ |
| 1122 | void subsys_dev_iter_exit(struct subsys_dev_iter *iter) |
| 1123 | { |
| 1124 | klist_iter_exit(&iter->ki); |
| 1125 | } |
| 1126 | EXPORT_SYMBOL_GPL(subsys_dev_iter_exit); |
| 1127 | |
| 1128 | int subsys_interface_register(struct subsys_interface *sif) |
| 1129 | { |
| 1130 | struct bus_type *subsys; |
| 1131 | struct subsys_dev_iter iter; |
| 1132 | struct device *dev; |
| 1133 | |
| 1134 | if (!sif || !sif->subsys) |
| 1135 | return -ENODEV; |
| 1136 | |
| 1137 | subsys = bus_get(sif->subsys); |
| 1138 | if (!subsys) |
| 1139 | return -EINVAL; |
| 1140 | |
| 1141 | mutex_lock(&subsys->p->mutex); |
| 1142 | list_add_tail(&sif->node, &subsys->p->interfaces); |
| 1143 | if (sif->add_dev) { |
| 1144 | subsys_dev_iter_init(&iter, subsys, NULL, NULL); |
| 1145 | while ((dev = subsys_dev_iter_next(&iter))) |
| 1146 | sif->add_dev(dev, sif); |
| 1147 | subsys_dev_iter_exit(&iter); |
| 1148 | } |
| 1149 | mutex_unlock(&subsys->p->mutex); |
| 1150 | |
| 1151 | return 0; |
| 1152 | } |
| 1153 | EXPORT_SYMBOL_GPL(subsys_interface_register); |
| 1154 | |
| 1155 | void subsys_interface_unregister(struct subsys_interface *sif) |
| 1156 | { |
Jonghwan Choi | 2b31594 | 2012-01-14 11:06:03 +0900 | [diff] [blame] | 1157 | struct bus_type *subsys; |
Kay Sievers | ca22e56 | 2011-12-14 14:29:38 -0800 | [diff] [blame] | 1158 | struct subsys_dev_iter iter; |
| 1159 | struct device *dev; |
| 1160 | |
Jonghwan Choi | 2b31594 | 2012-01-14 11:06:03 +0900 | [diff] [blame] | 1161 | if (!sif || !sif->subsys) |
Kay Sievers | ca22e56 | 2011-12-14 14:29:38 -0800 | [diff] [blame] | 1162 | return; |
| 1163 | |
Jonghwan Choi | 2b31594 | 2012-01-14 11:06:03 +0900 | [diff] [blame] | 1164 | subsys = sif->subsys; |
| 1165 | |
Kay Sievers | ca22e56 | 2011-12-14 14:29:38 -0800 | [diff] [blame] | 1166 | mutex_lock(&subsys->p->mutex); |
| 1167 | list_del_init(&sif->node); |
| 1168 | if (sif->remove_dev) { |
| 1169 | subsys_dev_iter_init(&iter, subsys, NULL, NULL); |
| 1170 | while ((dev = subsys_dev_iter_next(&iter))) |
| 1171 | sif->remove_dev(dev, sif); |
| 1172 | subsys_dev_iter_exit(&iter); |
| 1173 | } |
| 1174 | mutex_unlock(&subsys->p->mutex); |
| 1175 | |
| 1176 | bus_put(subsys); |
| 1177 | } |
| 1178 | EXPORT_SYMBOL_GPL(subsys_interface_unregister); |
| 1179 | |
| 1180 | static void system_root_device_release(struct device *dev) |
| 1181 | { |
| 1182 | kfree(dev); |
| 1183 | } |
Tejun Heo | d73ce00 | 2013-03-12 11:30:05 -0700 | [diff] [blame] | 1184 | |
| 1185 | static int subsys_register(struct bus_type *subsys, |
| 1186 | const struct attribute_group **groups, |
| 1187 | struct kobject *parent_of_root) |
| 1188 | { |
| 1189 | struct device *dev; |
| 1190 | int err; |
| 1191 | |
| 1192 | err = bus_register(subsys); |
| 1193 | if (err < 0) |
| 1194 | return err; |
| 1195 | |
| 1196 | dev = kzalloc(sizeof(struct device), GFP_KERNEL); |
| 1197 | if (!dev) { |
| 1198 | err = -ENOMEM; |
| 1199 | goto err_dev; |
| 1200 | } |
| 1201 | |
| 1202 | err = dev_set_name(dev, "%s", subsys->name); |
| 1203 | if (err < 0) |
| 1204 | goto err_name; |
| 1205 | |
| 1206 | dev->kobj.parent = parent_of_root; |
| 1207 | dev->groups = groups; |
| 1208 | dev->release = system_root_device_release; |
| 1209 | |
| 1210 | err = device_register(dev); |
| 1211 | if (err < 0) |
| 1212 | goto err_dev_reg; |
| 1213 | |
| 1214 | subsys->dev_root = dev; |
| 1215 | return 0; |
| 1216 | |
| 1217 | err_dev_reg: |
| 1218 | put_device(dev); |
| 1219 | dev = NULL; |
| 1220 | err_name: |
| 1221 | kfree(dev); |
| 1222 | err_dev: |
| 1223 | bus_unregister(subsys); |
| 1224 | return err; |
| 1225 | } |
| 1226 | |
Kay Sievers | ca22e56 | 2011-12-14 14:29:38 -0800 | [diff] [blame] | 1227 | /** |
| 1228 | * subsys_system_register - register a subsystem at /sys/devices/system/ |
Randy Dunlap | 78d7955 | 2012-01-21 11:02:28 -0800 | [diff] [blame] | 1229 | * @subsys: system subsystem |
| 1230 | * @groups: default attributes for the root device |
Kay Sievers | ca22e56 | 2011-12-14 14:29:38 -0800 | [diff] [blame] | 1231 | * |
| 1232 | * All 'system' subsystems have a /sys/devices/system/<name> root device |
| 1233 | * with the name of the subsystem. The root device can carry subsystem- |
| 1234 | * wide attributes. All registered devices are below this single root |
| 1235 | * device and are named after the subsystem with a simple enumeration |
Masanari Iida | e227867 | 2014-02-18 22:54:36 +0900 | [diff] [blame] | 1236 | * number appended. The registered devices are not explicitly named; |
Kay Sievers | ca22e56 | 2011-12-14 14:29:38 -0800 | [diff] [blame] | 1237 | * only 'id' in the device needs to be set. |
| 1238 | * |
| 1239 | * Do not use this interface for anything new, it exists for compatibility |
| 1240 | * with bad ideas only. New subsystems should use plain subsystems; and |
| 1241 | * add the subsystem-wide attributes should be added to the subsystem |
| 1242 | * directory itself and not some create fake root-device placed in |
| 1243 | * /sys/devices/system/<name>. |
| 1244 | */ |
| 1245 | int subsys_system_register(struct bus_type *subsys, |
| 1246 | const struct attribute_group **groups) |
| 1247 | { |
Tejun Heo | d73ce00 | 2013-03-12 11:30:05 -0700 | [diff] [blame] | 1248 | return subsys_register(subsys, groups, &system_kset->kobj); |
Kay Sievers | ca22e56 | 2011-12-14 14:29:38 -0800 | [diff] [blame] | 1249 | } |
| 1250 | EXPORT_SYMBOL_GPL(subsys_system_register); |
| 1251 | |
Tejun Heo | d73ce00 | 2013-03-12 11:30:05 -0700 | [diff] [blame] | 1252 | /** |
| 1253 | * subsys_virtual_register - register a subsystem at /sys/devices/virtual/ |
| 1254 | * @subsys: virtual subsystem |
| 1255 | * @groups: default attributes for the root device |
| 1256 | * |
| 1257 | * All 'virtual' subsystems have a /sys/devices/system/<name> root device |
| 1258 | * with the name of the subystem. The root device can carry subsystem-wide |
| 1259 | * attributes. All registered devices are below this single root device. |
| 1260 | * There's no restriction on device naming. This is for kernel software |
| 1261 | * constructs which need sysfs interface. |
| 1262 | */ |
| 1263 | int subsys_virtual_register(struct bus_type *subsys, |
| 1264 | const struct attribute_group **groups) |
| 1265 | { |
| 1266 | struct kobject *virtual_dir; |
| 1267 | |
| 1268 | virtual_dir = virtual_device_parent(NULL); |
| 1269 | if (!virtual_dir) |
| 1270 | return -ENOMEM; |
| 1271 | |
| 1272 | return subsys_register(subsys, groups, virtual_dir); |
| 1273 | } |
Greg Kroah-Hartman | 1c04fc3 | 2013-05-10 09:14:04 -0700 | [diff] [blame] | 1274 | EXPORT_SYMBOL_GPL(subsys_virtual_register); |
Tejun Heo | d73ce00 | 2013-03-12 11:30:05 -0700 | [diff] [blame] | 1275 | |
Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 1276 | int __init buses_init(void) |
| 1277 | { |
Greg Kroah-Hartman | 59a5483 | 2007-10-29 23:22:26 -0500 | [diff] [blame] | 1278 | bus_kset = kset_create_and_add("bus", &bus_uevent_ops, NULL); |
| 1279 | if (!bus_kset) |
| 1280 | return -ENOMEM; |
Kay Sievers | ca22e56 | 2011-12-14 14:29:38 -0800 | [diff] [blame] | 1281 | |
| 1282 | system_kset = kset_create_and_add("system", NULL, &devices_kset->kobj); |
| 1283 | if (!system_kset) |
| 1284 | return -ENOMEM; |
| 1285 | |
Greg Kroah-Hartman | 59a5483 | 2007-10-29 23:22:26 -0500 | [diff] [blame] | 1286 | return 0; |
Linus Torvalds | 1da177e | 2005-04-16 15:20:36 -0700 | [diff] [blame] | 1287 | } |