bus.c 24 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458459460461462463464465466467468469470471472473474475476477478479480481482483484485486487488489490491492493494495496497498499500501502503504505506507508509510511512513514515516517518519520521522523524525526527528529530531532533534535536537538539540541542543544545546547548549550551552553554555556557558559560561562563564565566567568569570571572573574575576577578579580581582583584585586587588589590591592593594595596597598599600601602603604605606607608609610611612613614615616617618619620621622623624625626627628629630631632633634635636637638639640641642643644645646647648649650651652653654655656657658659660661662663664665666667668669670671672673674675676677678679680681682683684685686687688689690691692693694695696697698699700701702703704705706707708709710711712713714715716717718719720721722723724725726727728729730731732733734735736737738739740741742743744745746747748749750751752753754755756757758759760761762763764765766767768769770771772773774775776777778779780781782783784785786787788789790791792793794795796797798799800801802803804805806807808809810811812813814815816817818819820821822823824825826827828829830831832833834835836837838839840841842843844845846847848849850851852853854855856857858859860861862863864865866867868869870871872873874875876877878879880881882883884885886887888889890891892893894895896897898899900901902903904905906907908909910911912913914915916917918919920921922923924925926927928929930931932933934935936937938939940941942943944945946947948949950951952953954955956957958959960961962963964965966967968969970971972973974975976977978979980981982983984985986987988989
  1. /*
  2. * bus.c - bus driver management
  3. *
  4. * Copyright (c) 2002-3 Patrick Mochel
  5. * Copyright (c) 2002-3 Open Source Development Labs
  6. * Copyright (c) 2007 Greg Kroah-Hartman <gregkh@suse.de>
  7. * Copyright (c) 2007 Novell Inc.
  8. *
  9. * This file is released under the GPLv2
  10. *
  11. */
  12. #include <linux/device.h>
  13. #include <linux/module.h>
  14. #include <linux/errno.h>
  15. #include <linux/init.h>
  16. #include <linux/string.h>
  17. #include "base.h"
  18. #include "power/power.h"
  19. #define to_bus_attr(_attr) container_of(_attr, struct bus_attribute, attr)
  20. #define to_bus(obj) container_of(obj, struct bus_type_private, subsys.kobj)
  21. /*
  22. * sysfs bindings for drivers
  23. */
  24. #define to_drv_attr(_attr) container_of(_attr, struct driver_attribute, attr)
  25. static int __must_check bus_rescan_devices_helper(struct device *dev,
  26. void *data);
  27. static struct bus_type *bus_get(struct bus_type *bus)
  28. {
  29. if (bus) {
  30. kset_get(&bus->p->subsys);
  31. return bus;
  32. }
  33. return NULL;
  34. }
  35. static void bus_put(struct bus_type *bus)
  36. {
  37. if (bus)
  38. kset_put(&bus->p->subsys);
  39. }
  40. static ssize_t drv_attr_show(struct kobject *kobj, struct attribute *attr,
  41. char *buf)
  42. {
  43. struct driver_attribute *drv_attr = to_drv_attr(attr);
  44. struct driver_private *drv_priv = to_driver(kobj);
  45. ssize_t ret = -EIO;
  46. if (drv_attr->show)
  47. ret = drv_attr->show(drv_priv->driver, buf);
  48. return ret;
  49. }
  50. static ssize_t drv_attr_store(struct kobject *kobj, struct attribute *attr,
  51. const char *buf, size_t count)
  52. {
  53. struct driver_attribute *drv_attr = to_drv_attr(attr);
  54. struct driver_private *drv_priv = to_driver(kobj);
  55. ssize_t ret = -EIO;
  56. if (drv_attr->store)
  57. ret = drv_attr->store(drv_priv->driver, buf, count);
  58. return ret;
  59. }
  60. static struct sysfs_ops driver_sysfs_ops = {
  61. .show = drv_attr_show,
  62. .store = drv_attr_store,
  63. };
  64. static void driver_release(struct kobject *kobj)
  65. {
  66. struct driver_private *drv_priv = to_driver(kobj);
  67. pr_debug("driver: '%s': %s\n", kobject_name(kobj), __func__);
  68. kfree(drv_priv);
  69. }
  70. static struct kobj_type driver_ktype = {
  71. .sysfs_ops = &driver_sysfs_ops,
  72. .release = driver_release,
  73. };
  74. /*
  75. * sysfs bindings for buses
  76. */
  77. static ssize_t bus_attr_show(struct kobject *kobj, struct attribute *attr,
  78. char *buf)
  79. {
  80. struct bus_attribute *bus_attr = to_bus_attr(attr);
  81. struct bus_type_private *bus_priv = to_bus(kobj);
  82. ssize_t ret = 0;
  83. if (bus_attr->show)
  84. ret = bus_attr->show(bus_priv->bus, buf);
  85. return ret;
  86. }
  87. static ssize_t bus_attr_store(struct kobject *kobj, struct attribute *attr,
  88. const char *buf, size_t count)
  89. {
  90. struct bus_attribute *bus_attr = to_bus_attr(attr);
  91. struct bus_type_private *bus_priv = to_bus(kobj);
  92. ssize_t ret = 0;
  93. if (bus_attr->store)
  94. ret = bus_attr->store(bus_priv->bus, buf, count);
  95. return ret;
  96. }
  97. static struct sysfs_ops bus_sysfs_ops = {
  98. .show = bus_attr_show,
  99. .store = bus_attr_store,
  100. };
  101. int bus_create_file(struct bus_type *bus, struct bus_attribute *attr)
  102. {
  103. int error;
  104. if (bus_get(bus)) {
  105. error = sysfs_create_file(&bus->p->subsys.kobj, &attr->attr);
  106. bus_put(bus);
  107. } else
  108. error = -EINVAL;
  109. return error;
  110. }
  111. EXPORT_SYMBOL_GPL(bus_create_file);
  112. void bus_remove_file(struct bus_type *bus, struct bus_attribute *attr)
  113. {
  114. if (bus_get(bus)) {
  115. sysfs_remove_file(&bus->p->subsys.kobj, &attr->attr);
  116. bus_put(bus);
  117. }
  118. }
  119. EXPORT_SYMBOL_GPL(bus_remove_file);
  120. static struct kobj_type bus_ktype = {
  121. .sysfs_ops = &bus_sysfs_ops,
  122. };
  123. static int bus_uevent_filter(struct kset *kset, struct kobject *kobj)
  124. {
  125. struct kobj_type *ktype = get_ktype(kobj);
  126. if (ktype == &bus_ktype)
  127. return 1;
  128. return 0;
  129. }
  130. static struct kset_uevent_ops bus_uevent_ops = {
  131. .filter = bus_uevent_filter,
  132. };
  133. static struct kset *bus_kset;
  134. #ifdef CONFIG_HOTPLUG
  135. /* Manually detach a device from its associated driver. */
  136. static ssize_t driver_unbind(struct device_driver *drv,
  137. const char *buf, size_t count)
  138. {
  139. struct bus_type *bus = bus_get(drv->bus);
  140. struct device *dev;
  141. int err = -ENODEV;
  142. dev = bus_find_device_by_name(bus, NULL, buf);
  143. if (dev && dev->driver == drv) {
  144. if (dev->parent) /* Needed for USB */
  145. down(&dev->parent->sem);
  146. device_release_driver(dev);
  147. if (dev->parent)
  148. up(&dev->parent->sem);
  149. err = count;
  150. }
  151. put_device(dev);
  152. bus_put(bus);
  153. return err;
  154. }
  155. static DRIVER_ATTR(unbind, S_IWUSR, NULL, driver_unbind);
  156. /*
  157. * Manually attach a device to a driver.
  158. * Note: the driver must want to bind to the device,
  159. * it is not possible to override the driver's id table.
  160. */
  161. static ssize_t driver_bind(struct device_driver *drv,
  162. const char *buf, size_t count)
  163. {
  164. struct bus_type *bus = bus_get(drv->bus);
  165. struct device *dev;
  166. int err = -ENODEV;
  167. dev = bus_find_device_by_name(bus, NULL, buf);
  168. if (dev && dev->driver == NULL) {
  169. if (dev->parent) /* Needed for USB */
  170. down(&dev->parent->sem);
  171. down(&dev->sem);
  172. err = driver_probe_device(drv, dev);
  173. up(&dev->sem);
  174. if (dev->parent)
  175. up(&dev->parent->sem);
  176. if (err > 0) {
  177. /* success */
  178. err = count;
  179. } else if (err == 0) {
  180. /* driver didn't accept device */
  181. err = -ENODEV;
  182. }
  183. }
  184. put_device(dev);
  185. bus_put(bus);
  186. return err;
  187. }
  188. static DRIVER_ATTR(bind, S_IWUSR, NULL, driver_bind);
  189. static ssize_t show_drivers_autoprobe(struct bus_type *bus, char *buf)
  190. {
  191. return sprintf(buf, "%d\n", bus->p->drivers_autoprobe);
  192. }
  193. static ssize_t store_drivers_autoprobe(struct bus_type *bus,
  194. const char *buf, size_t count)
  195. {
  196. if (buf[0] == '0')
  197. bus->p->drivers_autoprobe = 0;
  198. else
  199. bus->p->drivers_autoprobe = 1;
  200. return count;
  201. }
  202. static ssize_t store_drivers_probe(struct bus_type *bus,
  203. const char *buf, size_t count)
  204. {
  205. struct device *dev;
  206. dev = bus_find_device_by_name(bus, NULL, buf);
  207. if (!dev)
  208. return -ENODEV;
  209. if (bus_rescan_devices_helper(dev, NULL) != 0)
  210. return -EINVAL;
  211. return count;
  212. }
  213. #endif
  214. static struct device *next_device(struct klist_iter *i)
  215. {
  216. struct klist_node *n = klist_next(i);
  217. return n ? container_of(n, struct device, knode_bus) : NULL;
  218. }
  219. /**
  220. * bus_for_each_dev - device iterator.
  221. * @bus: bus type.
  222. * @start: device to start iterating from.
  223. * @data: data for the callback.
  224. * @fn: function to be called for each device.
  225. *
  226. * Iterate over @bus's list of devices, and call @fn for each,
  227. * passing it @data. If @start is not NULL, we use that device to
  228. * begin iterating from.
  229. *
  230. * We check the return of @fn each time. If it returns anything
  231. * other than 0, we break out and return that value.
  232. *
  233. * NOTE: The device that returns a non-zero value is not retained
  234. * in any way, nor is its refcount incremented. If the caller needs
  235. * to retain this data, it should do, and increment the reference
  236. * count in the supplied callback.
  237. */
  238. int bus_for_each_dev(struct bus_type *bus, struct device *start,
  239. void *data, int (*fn)(struct device *, void *))
  240. {
  241. struct klist_iter i;
  242. struct device *dev;
  243. int error = 0;
  244. if (!bus)
  245. return -EINVAL;
  246. klist_iter_init_node(&bus->p->klist_devices, &i,
  247. (start ? &start->knode_bus : NULL));
  248. while ((dev = next_device(&i)) && !error)
  249. error = fn(dev, data);
  250. klist_iter_exit(&i);
  251. return error;
  252. }
  253. EXPORT_SYMBOL_GPL(bus_for_each_dev);
  254. /**
  255. * bus_find_device - device iterator for locating a particular device.
  256. * @bus: bus type
  257. * @start: Device to begin with
  258. * @data: Data to pass to match function
  259. * @match: Callback function to check device
  260. *
  261. * This is similar to the bus_for_each_dev() function above, but it
  262. * returns a reference to a device that is 'found' for later use, as
  263. * determined by the @match callback.
  264. *
  265. * The callback should return 0 if the device doesn't match and non-zero
  266. * if it does. If the callback returns non-zero, this function will
  267. * return to the caller and not iterate over any more devices.
  268. */
  269. struct device *bus_find_device(struct bus_type *bus,
  270. struct device *start, void *data,
  271. int (*match)(struct device *dev, void *data))
  272. {
  273. struct klist_iter i;
  274. struct device *dev;
  275. if (!bus)
  276. return NULL;
  277. klist_iter_init_node(&bus->p->klist_devices, &i,
  278. (start ? &start->knode_bus : NULL));
  279. while ((dev = next_device(&i)))
  280. if (match(dev, data) && get_device(dev))
  281. break;
  282. klist_iter_exit(&i);
  283. return dev;
  284. }
  285. EXPORT_SYMBOL_GPL(bus_find_device);
  286. static int match_name(struct device *dev, void *data)
  287. {
  288. const char *name = data;
  289. return sysfs_streq(name, dev->bus_id);
  290. }
  291. /**
  292. * bus_find_device_by_name - device iterator for locating a particular device of a specific name
  293. * @bus: bus type
  294. * @start: Device to begin with
  295. * @name: name of the device to match
  296. *
  297. * This is similar to the bus_find_device() function above, but it handles
  298. * searching by a name automatically, no need to write another strcmp matching
  299. * function.
  300. */
  301. struct device *bus_find_device_by_name(struct bus_type *bus,
  302. struct device *start, const char *name)
  303. {
  304. return bus_find_device(bus, start, (void *)name, match_name);
  305. }
  306. EXPORT_SYMBOL_GPL(bus_find_device_by_name);
  307. static struct device_driver *next_driver(struct klist_iter *i)
  308. {
  309. struct klist_node *n = klist_next(i);
  310. struct driver_private *drv_priv;
  311. if (n) {
  312. drv_priv = container_of(n, struct driver_private, knode_bus);
  313. return drv_priv->driver;
  314. }
  315. return NULL;
  316. }
  317. /**
  318. * bus_for_each_drv - driver iterator
  319. * @bus: bus we're dealing with.
  320. * @start: driver to start iterating on.
  321. * @data: data to pass to the callback.
  322. * @fn: function to call for each driver.
  323. *
  324. * This is nearly identical to the device iterator above.
  325. * We iterate over each driver that belongs to @bus, and call
  326. * @fn for each. If @fn returns anything but 0, we break out
  327. * and return it. If @start is not NULL, we use it as the head
  328. * of the list.
  329. *
  330. * NOTE: we don't return the driver that returns a non-zero
  331. * value, nor do we leave the reference count incremented for that
  332. * driver. If the caller needs to know that info, it must set it
  333. * in the callback. It must also be sure to increment the refcount
  334. * so it doesn't disappear before returning to the caller.
  335. */
  336. int bus_for_each_drv(struct bus_type *bus, struct device_driver *start,
  337. void *data, int (*fn)(struct device_driver *, void *))
  338. {
  339. struct klist_iter i;
  340. struct device_driver *drv;
  341. int error = 0;
  342. if (!bus)
  343. return -EINVAL;
  344. klist_iter_init_node(&bus->p->klist_drivers, &i,
  345. start ? &start->p->knode_bus : NULL);
  346. while ((drv = next_driver(&i)) && !error)
  347. error = fn(drv, data);
  348. klist_iter_exit(&i);
  349. return error;
  350. }
  351. EXPORT_SYMBOL_GPL(bus_for_each_drv);
  352. static int device_add_attrs(struct bus_type *bus, struct device *dev)
  353. {
  354. int error = 0;
  355. int i;
  356. if (!bus->dev_attrs)
  357. return 0;
  358. for (i = 0; attr_name(bus->dev_attrs[i]); i++) {
  359. error = device_create_file(dev, &bus->dev_attrs[i]);
  360. if (error) {
  361. while (--i >= 0)
  362. device_remove_file(dev, &bus->dev_attrs[i]);
  363. break;
  364. }
  365. }
  366. return error;
  367. }
  368. static void device_remove_attrs(struct bus_type *bus, struct device *dev)
  369. {
  370. int i;
  371. if (bus->dev_attrs) {
  372. for (i = 0; attr_name(bus->dev_attrs[i]); i++)
  373. device_remove_file(dev, &bus->dev_attrs[i]);
  374. }
  375. }
  376. #ifdef CONFIG_SYSFS_DEPRECATED
  377. static int make_deprecated_bus_links(struct device *dev)
  378. {
  379. return sysfs_create_link(&dev->kobj,
  380. &dev->bus->p->subsys.kobj, "bus");
  381. }
  382. static void remove_deprecated_bus_links(struct device *dev)
  383. {
  384. sysfs_remove_link(&dev->kobj, "bus");
  385. }
  386. #else
  387. static inline int make_deprecated_bus_links(struct device *dev) { return 0; }
  388. static inline void remove_deprecated_bus_links(struct device *dev) { }
  389. #endif
  390. /**
  391. * bus_add_device - add device to bus
  392. * @dev: device being added
  393. *
  394. * - Add the device to its bus's list of devices.
  395. * - Create link to device's bus.
  396. */
  397. int bus_add_device(struct device *dev)
  398. {
  399. struct bus_type *bus = bus_get(dev->bus);
  400. int error = 0;
  401. if (bus) {
  402. pr_debug("bus: '%s': add device %s\n", bus->name, dev->bus_id);
  403. error = device_add_attrs(bus, dev);
  404. if (error)
  405. goto out_put;
  406. error = sysfs_create_link(&bus->p->devices_kset->kobj,
  407. &dev->kobj, dev->bus_id);
  408. if (error)
  409. goto out_id;
  410. error = sysfs_create_link(&dev->kobj,
  411. &dev->bus->p->subsys.kobj, "subsystem");
  412. if (error)
  413. goto out_subsys;
  414. error = make_deprecated_bus_links(dev);
  415. if (error)
  416. goto out_deprecated;
  417. }
  418. return 0;
  419. out_deprecated:
  420. sysfs_remove_link(&dev->kobj, "subsystem");
  421. out_subsys:
  422. sysfs_remove_link(&bus->p->devices_kset->kobj, dev->bus_id);
  423. out_id:
  424. device_remove_attrs(bus, dev);
  425. out_put:
  426. bus_put(dev->bus);
  427. return error;
  428. }
  429. /**
  430. * bus_attach_device - add device to bus
  431. * @dev: device tried to attach to a driver
  432. *
  433. * - Add device to bus's list of devices.
  434. * - Try to attach to driver.
  435. */
  436. void bus_attach_device(struct device *dev)
  437. {
  438. struct bus_type *bus = dev->bus;
  439. int ret = 0;
  440. if (bus) {
  441. if (bus->p->drivers_autoprobe)
  442. ret = device_attach(dev);
  443. WARN_ON(ret < 0);
  444. if (ret >= 0)
  445. klist_add_tail(&dev->knode_bus, &bus->p->klist_devices);
  446. }
  447. }
  448. /**
  449. * bus_remove_device - remove device from bus
  450. * @dev: device to be removed
  451. *
  452. * - Remove symlink from bus's directory.
  453. * - Delete device from bus's list.
  454. * - Detach from its driver.
  455. * - Drop reference taken in bus_add_device().
  456. */
  457. void bus_remove_device(struct device *dev)
  458. {
  459. if (dev->bus) {
  460. sysfs_remove_link(&dev->kobj, "subsystem");
  461. remove_deprecated_bus_links(dev);
  462. sysfs_remove_link(&dev->bus->p->devices_kset->kobj,
  463. dev->bus_id);
  464. device_remove_attrs(dev->bus, dev);
  465. if (klist_node_attached(&dev->knode_bus))
  466. klist_del(&dev->knode_bus);
  467. pr_debug("bus: '%s': remove device %s\n",
  468. dev->bus->name, dev->bus_id);
  469. device_release_driver(dev);
  470. bus_put(dev->bus);
  471. }
  472. }
  473. static int driver_add_attrs(struct bus_type *bus, struct device_driver *drv)
  474. {
  475. int error = 0;
  476. int i;
  477. if (bus->drv_attrs) {
  478. for (i = 0; attr_name(bus->drv_attrs[i]); i++) {
  479. error = driver_create_file(drv, &bus->drv_attrs[i]);
  480. if (error)
  481. goto err;
  482. }
  483. }
  484. done:
  485. return error;
  486. err:
  487. while (--i >= 0)
  488. driver_remove_file(drv, &bus->drv_attrs[i]);
  489. goto done;
  490. }
  491. static void driver_remove_attrs(struct bus_type *bus,
  492. struct device_driver *drv)
  493. {
  494. int i;
  495. if (bus->drv_attrs) {
  496. for (i = 0; attr_name(bus->drv_attrs[i]); i++)
  497. driver_remove_file(drv, &bus->drv_attrs[i]);
  498. }
  499. }
  500. #ifdef CONFIG_HOTPLUG
  501. /*
  502. * Thanks to drivers making their tables __devinit, we can't allow manual
  503. * bind and unbind from userspace unless CONFIG_HOTPLUG is enabled.
  504. */
  505. static int __must_check add_bind_files(struct device_driver *drv)
  506. {
  507. int ret;
  508. ret = driver_create_file(drv, &driver_attr_unbind);
  509. if (ret == 0) {
  510. ret = driver_create_file(drv, &driver_attr_bind);
  511. if (ret)
  512. driver_remove_file(drv, &driver_attr_unbind);
  513. }
  514. return ret;
  515. }
  516. static void remove_bind_files(struct device_driver *drv)
  517. {
  518. driver_remove_file(drv, &driver_attr_bind);
  519. driver_remove_file(drv, &driver_attr_unbind);
  520. }
  521. static BUS_ATTR(drivers_probe, S_IWUSR, NULL, store_drivers_probe);
  522. static BUS_ATTR(drivers_autoprobe, S_IWUSR | S_IRUGO,
  523. show_drivers_autoprobe, store_drivers_autoprobe);
  524. static int add_probe_files(struct bus_type *bus)
  525. {
  526. int retval;
  527. retval = bus_create_file(bus, &bus_attr_drivers_probe);
  528. if (retval)
  529. goto out;
  530. retval = bus_create_file(bus, &bus_attr_drivers_autoprobe);
  531. if (retval)
  532. bus_remove_file(bus, &bus_attr_drivers_probe);
  533. out:
  534. return retval;
  535. }
  536. static void remove_probe_files(struct bus_type *bus)
  537. {
  538. bus_remove_file(bus, &bus_attr_drivers_autoprobe);
  539. bus_remove_file(bus, &bus_attr_drivers_probe);
  540. }
  541. #else
  542. static inline int add_bind_files(struct device_driver *drv) { return 0; }
  543. static inline void remove_bind_files(struct device_driver *drv) {}
  544. static inline int add_probe_files(struct bus_type *bus) { return 0; }
  545. static inline void remove_probe_files(struct bus_type *bus) {}
  546. #endif
  547. static ssize_t driver_uevent_store(struct device_driver *drv,
  548. const char *buf, size_t count)
  549. {
  550. enum kobject_action action;
  551. if (kobject_action_type(buf, count, &action) == 0)
  552. kobject_uevent(&drv->p->kobj, action);
  553. return count;
  554. }
  555. static DRIVER_ATTR(uevent, S_IWUSR, NULL, driver_uevent_store);
  556. /**
  557. * bus_add_driver - Add a driver to the bus.
  558. * @drv: driver.
  559. */
  560. int bus_add_driver(struct device_driver *drv)
  561. {
  562. struct bus_type *bus;
  563. struct driver_private *priv;
  564. int error = 0;
  565. bus = bus_get(drv->bus);
  566. if (!bus)
  567. return -EINVAL;
  568. pr_debug("bus: '%s': add driver %s\n", bus->name, drv->name);
  569. priv = kzalloc(sizeof(*priv), GFP_KERNEL);
  570. if (!priv) {
  571. error = -ENOMEM;
  572. goto out_put_bus;
  573. }
  574. klist_init(&priv->klist_devices, NULL, NULL);
  575. priv->driver = drv;
  576. drv->p = priv;
  577. priv->kobj.kset = bus->p->drivers_kset;
  578. error = kobject_init_and_add(&priv->kobj, &driver_ktype, NULL,
  579. "%s", drv->name);
  580. if (error)
  581. goto out_unregister;
  582. if (drv->bus->p->drivers_autoprobe) {
  583. error = driver_attach(drv);
  584. if (error)
  585. goto out_unregister;
  586. }
  587. klist_add_tail(&priv->knode_bus, &bus->p->klist_drivers);
  588. module_add_driver(drv->owner, drv);
  589. error = driver_create_file(drv, &driver_attr_uevent);
  590. if (error) {
  591. printk(KERN_ERR "%s: uevent attr (%s) failed\n",
  592. __func__, drv->name);
  593. }
  594. error = driver_add_attrs(bus, drv);
  595. if (error) {
  596. /* How the hell do we get out of this pickle? Give up */
  597. printk(KERN_ERR "%s: driver_add_attrs(%s) failed\n",
  598. __func__, drv->name);
  599. }
  600. error = add_bind_files(drv);
  601. if (error) {
  602. /* Ditto */
  603. printk(KERN_ERR "%s: add_bind_files(%s) failed\n",
  604. __func__, drv->name);
  605. }
  606. kobject_uevent(&priv->kobj, KOBJ_ADD);
  607. return error;
  608. out_unregister:
  609. kobject_put(&priv->kobj);
  610. out_put_bus:
  611. bus_put(bus);
  612. return error;
  613. }
  614. /**
  615. * bus_remove_driver - delete driver from bus's knowledge.
  616. * @drv: driver.
  617. *
  618. * Detach the driver from the devices it controls, and remove
  619. * it from its bus's list of drivers. Finally, we drop the reference
  620. * to the bus we took in bus_add_driver().
  621. */
  622. void bus_remove_driver(struct device_driver *drv)
  623. {
  624. if (!drv->bus)
  625. return;
  626. remove_bind_files(drv);
  627. driver_remove_attrs(drv->bus, drv);
  628. driver_remove_file(drv, &driver_attr_uevent);
  629. klist_remove(&drv->p->knode_bus);
  630. pr_debug("bus: '%s': remove driver %s\n", drv->bus->name, drv->name);
  631. driver_detach(drv);
  632. module_remove_driver(drv);
  633. kobject_put(&drv->p->kobj);
  634. bus_put(drv->bus);
  635. }
  636. /* Helper for bus_rescan_devices's iter */
  637. static int __must_check bus_rescan_devices_helper(struct device *dev,
  638. void *data)
  639. {
  640. int ret = 0;
  641. if (!dev->driver) {
  642. if (dev->parent) /* Needed for USB */
  643. down(&dev->parent->sem);
  644. ret = device_attach(dev);
  645. if (dev->parent)
  646. up(&dev->parent->sem);
  647. }
  648. return ret < 0 ? ret : 0;
  649. }
  650. /**
  651. * bus_rescan_devices - rescan devices on the bus for possible drivers
  652. * @bus: the bus to scan.
  653. *
  654. * This function will look for devices on the bus with no driver
  655. * attached and rescan it against existing drivers to see if it matches
  656. * any by calling device_attach() for the unbound devices.
  657. */
  658. int bus_rescan_devices(struct bus_type *bus)
  659. {
  660. return bus_for_each_dev(bus, NULL, NULL, bus_rescan_devices_helper);
  661. }
  662. EXPORT_SYMBOL_GPL(bus_rescan_devices);
  663. /**
  664. * device_reprobe - remove driver for a device and probe for a new driver
  665. * @dev: the device to reprobe
  666. *
  667. * This function detaches the attached driver (if any) for the given
  668. * device and restarts the driver probing process. It is intended
  669. * to use if probing criteria changed during a devices lifetime and
  670. * driver attachment should change accordingly.
  671. */
  672. int device_reprobe(struct device *dev)
  673. {
  674. if (dev->driver) {
  675. if (dev->parent) /* Needed for USB */
  676. down(&dev->parent->sem);
  677. device_release_driver(dev);
  678. if (dev->parent)
  679. up(&dev->parent->sem);
  680. }
  681. return bus_rescan_devices_helper(dev, NULL);
  682. }
  683. EXPORT_SYMBOL_GPL(device_reprobe);
  684. /**
  685. * find_bus - locate bus by name.
  686. * @name: name of bus.
  687. *
  688. * Call kset_find_obj() to iterate over list of buses to
  689. * find a bus by name. Return bus if found.
  690. *
  691. * Note that kset_find_obj increments bus' reference count.
  692. */
  693. #if 0
  694. struct bus_type *find_bus(char *name)
  695. {
  696. struct kobject *k = kset_find_obj(bus_kset, name);
  697. return k ? to_bus(k) : NULL;
  698. }
  699. #endif /* 0 */
  700. /**
  701. * bus_add_attrs - Add default attributes for this bus.
  702. * @bus: Bus that has just been registered.
  703. */
  704. static int bus_add_attrs(struct bus_type *bus)
  705. {
  706. int error = 0;
  707. int i;
  708. if (bus->bus_attrs) {
  709. for (i = 0; attr_name(bus->bus_attrs[i]); i++) {
  710. error = bus_create_file(bus, &bus->bus_attrs[i]);
  711. if (error)
  712. goto err;
  713. }
  714. }
  715. done:
  716. return error;
  717. err:
  718. while (--i >= 0)
  719. bus_remove_file(bus, &bus->bus_attrs[i]);
  720. goto done;
  721. }
  722. static void bus_remove_attrs(struct bus_type *bus)
  723. {
  724. int i;
  725. if (bus->bus_attrs) {
  726. for (i = 0; attr_name(bus->bus_attrs[i]); i++)
  727. bus_remove_file(bus, &bus->bus_attrs[i]);
  728. }
  729. }
  730. static void klist_devices_get(struct klist_node *n)
  731. {
  732. struct device *dev = container_of(n, struct device, knode_bus);
  733. get_device(dev);
  734. }
  735. static void klist_devices_put(struct klist_node *n)
  736. {
  737. struct device *dev = container_of(n, struct device, knode_bus);
  738. put_device(dev);
  739. }
  740. static ssize_t bus_uevent_store(struct bus_type *bus,
  741. const char *buf, size_t count)
  742. {
  743. enum kobject_action action;
  744. if (kobject_action_type(buf, count, &action) == 0)
  745. kobject_uevent(&bus->p->subsys.kobj, action);
  746. return count;
  747. }
  748. static BUS_ATTR(uevent, S_IWUSR, NULL, bus_uevent_store);
  749. /**
  750. * bus_register - register a bus with the system.
  751. * @bus: bus.
  752. *
  753. * Once we have that, we registered the bus with the kobject
  754. * infrastructure, then register the children subsystems it has:
  755. * the devices and drivers that belong to the bus.
  756. */
  757. int bus_register(struct bus_type *bus)
  758. {
  759. int retval;
  760. struct bus_type_private *priv;
  761. priv = kzalloc(sizeof(struct bus_type_private), GFP_KERNEL);
  762. if (!priv)
  763. return -ENOMEM;
  764. priv->bus = bus;
  765. bus->p = priv;
  766. BLOCKING_INIT_NOTIFIER_HEAD(&priv->bus_notifier);
  767. retval = kobject_set_name(&priv->subsys.kobj, "%s", bus->name);
  768. if (retval)
  769. goto out;
  770. priv->subsys.kobj.kset = bus_kset;
  771. priv->subsys.kobj.ktype = &bus_ktype;
  772. priv->drivers_autoprobe = 1;
  773. retval = kset_register(&priv->subsys);
  774. if (retval)
  775. goto out;
  776. retval = bus_create_file(bus, &bus_attr_uevent);
  777. if (retval)
  778. goto bus_uevent_fail;
  779. priv->devices_kset = kset_create_and_add("devices", NULL,
  780. &priv->subsys.kobj);
  781. if (!priv->devices_kset) {
  782. retval = -ENOMEM;
  783. goto bus_devices_fail;
  784. }
  785. priv->drivers_kset = kset_create_and_add("drivers", NULL,
  786. &priv->subsys.kobj);
  787. if (!priv->drivers_kset) {
  788. retval = -ENOMEM;
  789. goto bus_drivers_fail;
  790. }
  791. klist_init(&priv->klist_devices, klist_devices_get, klist_devices_put);
  792. klist_init(&priv->klist_drivers, NULL, NULL);
  793. retval = add_probe_files(bus);
  794. if (retval)
  795. goto bus_probe_files_fail;
  796. retval = bus_add_attrs(bus);
  797. if (retval)
  798. goto bus_attrs_fail;
  799. pr_debug("bus: '%s': registered\n", bus->name);
  800. return 0;
  801. bus_attrs_fail:
  802. remove_probe_files(bus);
  803. bus_probe_files_fail:
  804. kset_unregister(bus->p->drivers_kset);
  805. bus_drivers_fail:
  806. kset_unregister(bus->p->devices_kset);
  807. bus_devices_fail:
  808. bus_remove_file(bus, &bus_attr_uevent);
  809. bus_uevent_fail:
  810. kset_unregister(&bus->p->subsys);
  811. kfree(bus->p);
  812. out:
  813. return retval;
  814. }
  815. EXPORT_SYMBOL_GPL(bus_register);
  816. /**
  817. * bus_unregister - remove a bus from the system
  818. * @bus: bus.
  819. *
  820. * Unregister the child subsystems and the bus itself.
  821. * Finally, we call bus_put() to release the refcount
  822. */
  823. void bus_unregister(struct bus_type *bus)
  824. {
  825. pr_debug("bus: '%s': unregistering\n", bus->name);
  826. bus_remove_attrs(bus);
  827. remove_probe_files(bus);
  828. kset_unregister(bus->p->drivers_kset);
  829. kset_unregister(bus->p->devices_kset);
  830. bus_remove_file(bus, &bus_attr_uevent);
  831. kset_unregister(&bus->p->subsys);
  832. kfree(bus->p);
  833. }
  834. EXPORT_SYMBOL_GPL(bus_unregister);
  835. int bus_register_notifier(struct bus_type *bus, struct notifier_block *nb)
  836. {
  837. return blocking_notifier_chain_register(&bus->p->bus_notifier, nb);
  838. }
  839. EXPORT_SYMBOL_GPL(bus_register_notifier);
  840. int bus_unregister_notifier(struct bus_type *bus, struct notifier_block *nb)
  841. {
  842. return blocking_notifier_chain_unregister(&bus->p->bus_notifier, nb);
  843. }
  844. EXPORT_SYMBOL_GPL(bus_unregister_notifier);
  845. struct kset *bus_get_kset(struct bus_type *bus)
  846. {
  847. return &bus->p->subsys;
  848. }
  849. EXPORT_SYMBOL_GPL(bus_get_kset);
  850. struct klist *bus_get_device_klist(struct bus_type *bus)
  851. {
  852. return &bus->p->klist_devices;
  853. }
  854. EXPORT_SYMBOL_GPL(bus_get_device_klist);
  855. int __init buses_init(void)
  856. {
  857. bus_kset = kset_create_and_add("bus", &bus_uevent_ops, NULL);
  858. if (!bus_kset)
  859. return -ENOMEM;
  860. return 0;
  861. }