diff options
Diffstat (limited to 'drivers/base/dd.c')
| -rw-r--r-- | drivers/base/dd.c | 248 |
1 files changed, 248 insertions, 0 deletions
diff --git a/drivers/base/dd.c b/drivers/base/dd.c new file mode 100644 index 000000000000..6db3a789c54f --- /dev/null +++ b/drivers/base/dd.c | |||
| @@ -0,0 +1,248 @@ | |||
| 1 | /* | ||
| 2 | * drivers/base/dd.c - The core device/driver interactions. | ||
| 3 | * | ||
| 4 | * This file contains the (sometimes tricky) code that controls the | ||
| 5 | * interactions between devices and drivers, which primarily includes | ||
| 6 | * driver binding and unbinding. | ||
| 7 | * | ||
| 8 | * All of this code used to exist in drivers/base/bus.c, but was | ||
| 9 | * relocated to here in the name of compartmentalization (since it wasn't | ||
| 10 | * strictly code just for the 'struct bus_type'. | ||
| 11 | * | ||
| 12 | * Copyright (c) 2002-5 Patrick Mochel | ||
| 13 | * Copyright (c) 2002-3 Open Source Development Labs | ||
| 14 | * | ||
| 15 | * This file is released under the GPLv2 | ||
| 16 | */ | ||
| 17 | |||
| 18 | #include <linux/device.h> | ||
| 19 | #include <linux/module.h> | ||
| 20 | |||
| 21 | #include "base.h" | ||
| 22 | #include "power/power.h" | ||
| 23 | |||
| 24 | #define to_drv(node) container_of(node, struct device_driver, kobj.entry) | ||
| 25 | |||
| 26 | |||
| 27 | /** | ||
| 28 | * device_bind_driver - bind a driver to one device. | ||
| 29 | * @dev: device. | ||
| 30 | * | ||
| 31 | * Allow manual attachment of a driver to a device. | ||
| 32 | * Caller must have already set @dev->driver. | ||
| 33 | * | ||
| 34 | * Note that this does not modify the bus reference count | ||
| 35 | * nor take the bus's rwsem. Please verify those are accounted | ||
| 36 | * for before calling this. (It is ok to call with no other effort | ||
| 37 | * from a driver's probe() method.) | ||
| 38 | * | ||
| 39 | * This function must be called with @dev->sem held. | ||
| 40 | */ | ||
| 41 | void device_bind_driver(struct device * dev) | ||
| 42 | { | ||
| 43 | pr_debug("bound device '%s' to driver '%s'\n", | ||
| 44 | dev->bus_id, dev->driver->name); | ||
| 45 | klist_add_tail(&dev->driver->klist_devices, &dev->knode_driver); | ||
| 46 | sysfs_create_link(&dev->driver->kobj, &dev->kobj, | ||
| 47 | kobject_name(&dev->kobj)); | ||
| 48 | sysfs_create_link(&dev->kobj, &dev->driver->kobj, "driver"); | ||
| 49 | } | ||
| 50 | |||
| 51 | /** | ||
| 52 | * driver_probe_device - attempt to bind device & driver. | ||
| 53 | * @drv: driver. | ||
| 54 | * @dev: device. | ||
| 55 | * | ||
| 56 | * First, we call the bus's match function, if one present, which | ||
| 57 | * should compare the device IDs the driver supports with the | ||
| 58 | * device IDs of the device. Note we don't do this ourselves | ||
| 59 | * because we don't know the format of the ID structures, nor what | ||
| 60 | * is to be considered a match and what is not. | ||
| 61 | * | ||
| 62 | * | ||
| 63 | * This function returns 1 if a match is found, an error if one | ||
| 64 | * occurs (that is not -ENODEV or -ENXIO), and 0 otherwise. | ||
| 65 | * | ||
| 66 | * This function must be called with @dev->sem held. | ||
| 67 | */ | ||
| 68 | static int driver_probe_device(struct device_driver * drv, struct device * dev) | ||
| 69 | { | ||
| 70 | int ret = 0; | ||
| 71 | |||
| 72 | if (drv->bus->match && !drv->bus->match(dev, drv)) | ||
| 73 | goto Done; | ||
| 74 | |||
| 75 | pr_debug("%s: Matched Device %s with Driver %s\n", | ||
| 76 | drv->bus->name, dev->bus_id, drv->name); | ||
| 77 | dev->driver = drv; | ||
| 78 | if (drv->probe) { | ||
| 79 | ret = drv->probe(dev); | ||
| 80 | if (ret) { | ||
| 81 | dev->driver = NULL; | ||
| 82 | goto ProbeFailed; | ||
| 83 | } | ||
| 84 | } | ||
| 85 | device_bind_driver(dev); | ||
| 86 | ret = 1; | ||
| 87 | pr_debug("%s: Bound Device %s to Driver %s\n", | ||
| 88 | drv->bus->name, dev->bus_id, drv->name); | ||
| 89 | goto Done; | ||
| 90 | |||
| 91 | ProbeFailed: | ||
| 92 | if (ret == -ENODEV || ret == -ENXIO) { | ||
| 93 | /* Driver matched, but didn't support device | ||
| 94 | * or device not found. | ||
| 95 | * Not an error; keep going. | ||
| 96 | */ | ||
| 97 | ret = 0; | ||
| 98 | } else { | ||
| 99 | /* driver matched but the probe failed */ | ||
| 100 | printk(KERN_WARNING | ||
| 101 | "%s: probe of %s failed with error %d\n", | ||
| 102 | drv->name, dev->bus_id, ret); | ||
| 103 | } | ||
| 104 | Done: | ||
| 105 | return ret; | ||
| 106 | } | ||
| 107 | |||
| 108 | static int __device_attach(struct device_driver * drv, void * data) | ||
| 109 | { | ||
| 110 | struct device * dev = data; | ||
| 111 | return driver_probe_device(drv, dev); | ||
| 112 | } | ||
| 113 | |||
| 114 | /** | ||
| 115 | * device_attach - try to attach device to a driver. | ||
| 116 | * @dev: device. | ||
| 117 | * | ||
| 118 | * Walk the list of drivers that the bus has and call | ||
| 119 | * driver_probe_device() for each pair. If a compatible | ||
| 120 | * pair is found, break out and return. | ||
| 121 | * | ||
| 122 | * Returns 1 if the device was bound to a driver; | ||
| 123 | * 0 if no matching device was found; error code otherwise. | ||
| 124 | */ | ||
| 125 | int device_attach(struct device * dev) | ||
| 126 | { | ||
| 127 | int ret = 0; | ||
| 128 | |||
| 129 | down(&dev->sem); | ||
| 130 | if (dev->driver) { | ||
| 131 | device_bind_driver(dev); | ||
| 132 | ret = 1; | ||
| 133 | } else | ||
| 134 | ret = bus_for_each_drv(dev->bus, NULL, dev, __device_attach); | ||
| 135 | up(&dev->sem); | ||
| 136 | return ret; | ||
| 137 | } | ||
| 138 | |||
| 139 | static int __driver_attach(struct device * dev, void * data) | ||
| 140 | { | ||
| 141 | struct device_driver * drv = data; | ||
| 142 | |||
| 143 | /* | ||
| 144 | * Lock device and try to bind to it. We drop the error | ||
| 145 | * here and always return 0, because we need to keep trying | ||
| 146 | * to bind to devices and some drivers will return an error | ||
| 147 | * simply if it didn't support the device. | ||
| 148 | * | ||
| 149 | * driver_probe_device() will spit a warning if there | ||
| 150 | * is an error. | ||
| 151 | */ | ||
| 152 | |||
| 153 | down(&dev->sem); | ||
| 154 | if (!dev->driver) | ||
| 155 | driver_probe_device(drv, dev); | ||
| 156 | up(&dev->sem); | ||
| 157 | |||
| 158 | |||
| 159 | return 0; | ||
| 160 | } | ||
| 161 | |||
| 162 | /** | ||
| 163 | * driver_attach - try to bind driver to devices. | ||
| 164 | * @drv: driver. | ||
| 165 | * | ||
| 166 | * Walk the list of devices that the bus has on it and try to | ||
| 167 | * match the driver with each one. If driver_probe_device() | ||
| 168 | * returns 0 and the @dev->driver is set, we've found a | ||
| 169 | * compatible pair. | ||
| 170 | */ | ||
| 171 | void driver_attach(struct device_driver * drv) | ||
| 172 | { | ||
| 173 | bus_for_each_dev(drv->bus, NULL, drv, __driver_attach); | ||
| 174 | } | ||
| 175 | |||
| 176 | /** | ||
| 177 | * device_release_driver - manually detach device from driver. | ||
| 178 | * @dev: device. | ||
| 179 | * | ||
| 180 | * Manually detach device from driver. | ||
| 181 | * | ||
| 182 | * __device_release_driver() must be called with @dev->sem held. | ||
| 183 | */ | ||
| 184 | |||
| 185 | static void __device_release_driver(struct device * dev) | ||
| 186 | { | ||
| 187 | struct device_driver * drv; | ||
| 188 | |||
| 189 | drv = dev->driver; | ||
| 190 | if (drv) { | ||
| 191 | get_driver(drv); | ||
| 192 | sysfs_remove_link(&drv->kobj, kobject_name(&dev->kobj)); | ||
| 193 | sysfs_remove_link(&dev->kobj, "driver"); | ||
| 194 | klist_remove(&dev->knode_driver); | ||
| 195 | |||
| 196 | if (drv->remove) | ||
| 197 | drv->remove(dev); | ||
| 198 | dev->driver = NULL; | ||
| 199 | put_driver(drv); | ||
| 200 | } | ||
| 201 | } | ||
| 202 | |||
| 203 | void device_release_driver(struct device * dev) | ||
| 204 | { | ||
| 205 | /* | ||
| 206 | * If anyone calls device_release_driver() recursively from | ||
| 207 | * within their ->remove callback for the same device, they | ||
| 208 | * will deadlock right here. | ||
| 209 | */ | ||
| 210 | down(&dev->sem); | ||
| 211 | __device_release_driver(dev); | ||
| 212 | up(&dev->sem); | ||
| 213 | } | ||
| 214 | |||
| 215 | |||
| 216 | /** | ||
| 217 | * driver_detach - detach driver from all devices it controls. | ||
| 218 | * @drv: driver. | ||
| 219 | */ | ||
| 220 | void driver_detach(struct device_driver * drv) | ||
| 221 | { | ||
| 222 | struct device * dev; | ||
| 223 | |||
| 224 | for (;;) { | ||
| 225 | spin_lock_irq(&drv->klist_devices.k_lock); | ||
| 226 | if (list_empty(&drv->klist_devices.k_list)) { | ||
| 227 | spin_unlock_irq(&drv->klist_devices.k_lock); | ||
| 228 | break; | ||
| 229 | } | ||
| 230 | dev = list_entry(drv->klist_devices.k_list.prev, | ||
| 231 | struct device, knode_driver.n_node); | ||
| 232 | get_device(dev); | ||
| 233 | spin_unlock_irq(&drv->klist_devices.k_lock); | ||
| 234 | |||
| 235 | down(&dev->sem); | ||
| 236 | if (dev->driver == drv) | ||
| 237 | __device_release_driver(dev); | ||
| 238 | up(&dev->sem); | ||
| 239 | put_device(dev); | ||
| 240 | } | ||
| 241 | } | ||
| 242 | |||
| 243 | |||
| 244 | EXPORT_SYMBOL_GPL(device_bind_driver); | ||
| 245 | EXPORT_SYMBOL_GPL(device_release_driver); | ||
| 246 | EXPORT_SYMBOL_GPL(device_attach); | ||
| 247 | EXPORT_SYMBOL_GPL(driver_attach); | ||
| 248 | |||
