blob: e05db388bd1ca9a7720af8d2053127ae2ed562d1 [file] [log] [blame]
Paul Gortmakerba331622011-05-26 18:08:35 -04001#include <linux/notifier.h>
Ben Dooksa1bdc7a2005-10-13 17:54:41 +01002
Greg Kroah-Hartmanc6f7e722007-11-01 19:41:16 -07003/**
Kay Sievers6b6e39a2010-11-15 23:13:18 +01004 * struct subsys_private - structure to hold the private to the driver core portions of the bus_type/class structure.
Greg Kroah-Hartmanc6f7e722007-11-01 19:41:16 -07005 *
Kay Sievers6b6e39a2010-11-15 23:13:18 +01006 * @subsys - the struct kset that defines this subsystem
Kay Sieversca22e562011-12-14 14:29:38 -08007 * @devices_kset - the subsystem's 'devices' directory
8 * @interfaces - list of subsystem interfaces associated
9 * @mutex - protect the devices, and interfaces lists.
Kay Sievers6b6e39a2010-11-15 23:13:18 +010010 *
11 * @drivers_kset - the list of drivers associated
Greg Kroah-Hartmanc6f7e722007-11-01 19:41:16 -070012 * @klist_devices - the klist to iterate over the @devices_kset
13 * @klist_drivers - the klist to iterate over the @drivers_kset
14 * @bus_notifier - the bus notifier list for anything that cares about things
Kay Sievers6b6e39a2010-11-15 23:13:18 +010015 * on this bus.
Greg Kroah-Hartmanc6f7e722007-11-01 19:41:16 -070016 * @bus - pointer back to the struct bus_type that this structure is associated
Kay Sievers6b6e39a2010-11-15 23:13:18 +010017 * with.
18 *
Kay Sievers6b6e39a2010-11-15 23:13:18 +010019 * @glue_dirs - "glue" directory to put in-between the parent device to
20 * avoid namespace conflicts
Kay Sievers6b6e39a2010-11-15 23:13:18 +010021 * @class - pointer back to the struct class that this structure is associated
22 * with.
Greg Kroah-Hartmanc6f7e722007-11-01 19:41:16 -070023 *
24 * This structure is the one that is the actual kobject allowing struct
Kay Sievers6b6e39a2010-11-15 23:13:18 +010025 * bus_type/class to be statically allocated safely. Nothing outside of the
26 * driver core should ever touch these fields.
Greg Kroah-Hartmanc6f7e722007-11-01 19:41:16 -070027 */
Kay Sievers6b6e39a2010-11-15 23:13:18 +010028struct subsys_private {
Greg Kroah-Hartmanc6f7e722007-11-01 19:41:16 -070029 struct kset subsys;
Greg Kroah-Hartmanc6f7e722007-11-01 19:41:16 -070030 struct kset *devices_kset;
Kay Sieversca22e562011-12-14 14:29:38 -080031 struct list_head interfaces;
32 struct mutex mutex;
Kay Sievers6b6e39a2010-11-15 23:13:18 +010033
34 struct kset *drivers_kset;
Greg Kroah-Hartmanc6f7e722007-11-01 19:41:16 -070035 struct klist klist_devices;
36 struct klist klist_drivers;
37 struct blocking_notifier_head bus_notifier;
38 unsigned int drivers_autoprobe:1;
39 struct bus_type *bus;
Kay Sievers6b6e39a2010-11-15 23:13:18 +010040
Kay Sievers6b6e39a2010-11-15 23:13:18 +010041 struct kset glue_dirs;
Kay Sievers6b6e39a2010-11-15 23:13:18 +010042 struct class *class;
Greg Kroah-Hartmanc6f7e722007-11-01 19:41:16 -070043};
Kay Sievers6b6e39a2010-11-15 23:13:18 +010044#define to_subsys_private(obj) container_of(obj, struct subsys_private, subsys.kobj)
Ben Dooksa1bdc7a2005-10-13 17:54:41 +010045
Greg Kroah-Hartmane5dd1272007-11-28 15:59:15 -080046struct driver_private {
47 struct kobject kobj;
48 struct klist klist_devices;
49 struct klist_node knode_bus;
50 struct module_kobject *mkobj;
51 struct device_driver *driver;
52};
53#define to_driver(obj) container_of(obj, struct driver_private, kobj)
Greg Kroah-Hartmanc6f7e722007-11-01 19:41:16 -070054
Greg Kroah-Hartmanfb069a52008-12-16 12:23:36 -080055/**
56 * struct device_private - structure to hold the private to the driver core portions of the device structure.
57 *
Greg Kroah-Hartmanf791b8c2008-12-16 12:24:56 -080058 * @klist_children - klist containing all children of this device
59 * @knode_parent - node in sibling list
Greg Kroah-Hartman8940b4f2008-12-16 12:25:49 -080060 * @knode_driver - node in driver list
Greg Kroah-Hartmanae1b4172008-12-16 12:26:21 -080061 * @knode_bus - node in bus list
Greg Kroah-Hartmanef8a3fd2012-03-08 12:17:22 -080062 * @deferred_probe - entry in deferred_probe_list which is used to retry the
63 * binding of drivers which were unable to get all the resources needed by
64 * the device; typically because it depends on another driver getting
65 * probed first.
Tomeu Vizoso82b2c3c2015-06-29 16:59:02 +020066 * @device - pointer back to the struct device that this structure is
Greg Kroah-Hartmanfb069a52008-12-16 12:23:36 -080067 * associated with.
68 *
69 * Nothing outside of the driver core should ever touch these fields.
70 */
71struct device_private {
Greg Kroah-Hartmanf791b8c2008-12-16 12:24:56 -080072 struct klist klist_children;
73 struct klist_node knode_parent;
Greg Kroah-Hartman8940b4f2008-12-16 12:25:49 -080074 struct klist_node knode_driver;
Greg Kroah-Hartmanae1b4172008-12-16 12:26:21 -080075 struct klist_node knode_bus;
Greg Kroah-Hartmanef8a3fd2012-03-08 12:17:22 -080076 struct list_head deferred_probe;
Greg Kroah-Hartmanfb069a52008-12-16 12:23:36 -080077 struct device *device;
78};
Greg Kroah-Hartmanf791b8c2008-12-16 12:24:56 -080079#define to_device_private_parent(obj) \
80 container_of(obj, struct device_private, knode_parent)
Greg Kroah-Hartman8940b4f2008-12-16 12:25:49 -080081#define to_device_private_driver(obj) \
82 container_of(obj, struct device_private, knode_driver)
Greg Kroah-Hartmanae1b4172008-12-16 12:26:21 -080083#define to_device_private_bus(obj) \
84 container_of(obj, struct device_private, knode_bus)
Greg Kroah-Hartmanfb069a52008-12-16 12:23:36 -080085
Greg Kroah-Hartmanb4028432009-05-11 14:16:57 -070086extern int device_private_init(struct device *dev);
87
Greg Kroah-Hartmanc6f7e722007-11-01 19:41:16 -070088/* initialisation functions */
Ben Dooksa1bdc7a2005-10-13 17:54:41 +010089extern int devices_init(void);
90extern int buses_init(void);
91extern int classes_init(void);
92extern int firmware_init(void);
Michael Holzheu40394832006-05-09 12:53:49 +020093#ifdef CONFIG_SYS_HYPERVISOR
94extern int hypervisor_init(void);
95#else
96static inline int hypervisor_init(void) { return 0; }
97#endif
Ben Dooksa1bdc7a2005-10-13 17:54:41 +010098extern int platform_bus_init(void);
Ben Hutchings024f7842012-01-10 02:59:49 +000099extern void cpu_dev_init(void);
Rafael J. Wysockicaa73ea2013-12-29 15:25:48 +0100100extern void container_dev_init(void);
Ben Dooksa1bdc7a2005-10-13 17:54:41 +0100101
Tejun Heod73ce002013-03-12 11:30:05 -0700102struct kobject *virtual_device_parent(struct device *dev);
103
Greg Kroah-Hartman4a3ad202008-01-24 22:50:12 -0800104extern int bus_add_device(struct device *dev);
Alan Stern2023c612009-07-30 15:27:18 -0400105extern void bus_probe_device(struct device *dev);
Greg Kroah-Hartman4a3ad202008-01-24 22:50:12 -0800106extern void bus_remove_device(struct device *dev);
Linus Torvalds1da177e2005-04-16 15:20:36 -0700107
Greg Kroah-Hartman4a3ad202008-01-24 22:50:12 -0800108extern int bus_add_driver(struct device_driver *drv);
109extern void bus_remove_driver(struct device_driver *drv);
Linus Torvalds1da177e2005-04-16 15:20:36 -0700110
Greg Kroah-Hartman4a3ad202008-01-24 22:50:12 -0800111extern void driver_detach(struct device_driver *drv);
112extern int driver_probe_device(struct device_driver *drv, struct device *dev);
Grant Likelyd1c34142012-03-05 08:47:41 -0700113extern void driver_deferred_probe_del(struct device *dev);
Ming Lei49b420a2009-01-21 23:27:47 +0800114static inline int driver_match_device(struct device_driver *drv,
115 struct device *dev)
116{
Ming Lei5247aec2009-03-27 21:50:00 +0800117 return drv->bus->match ? drv->bus->match(dev, drv) : 1;
Ming Lei49b420a2009-01-21 23:27:47 +0800118}
Dmitry Torokhov765230b2015-03-30 16:20:04 -0700119extern bool driver_allows_async_probing(struct device_driver *drv);
mochel@digitalimplant.org07e4a3e2005-03-21 10:52:54 -0800120
Greg Kroah-Hartmaned0617b2013-08-08 15:22:56 -0700121extern int driver_add_groups(struct device_driver *drv,
122 const struct attribute_group **groups);
123extern void driver_remove_groups(struct device_driver *drv,
124 const struct attribute_group **groups);
125
Greg Kroah-Hartmanfa6fdb32013-08-08 15:22:55 -0700126extern int device_add_groups(struct device *dev,
127 const struct attribute_group **groups);
128extern void device_remove_groups(struct device *dev,
129 const struct attribute_group **groups);
130
Greg Kroah-Hartmanaa49b912006-06-20 13:59:20 -0700131extern char *make_class_name(const char *name, struct kobject *kobj);
Linus Torvalds1da177e2005-04-16 15:20:36 -0700132
Adrian Bunk2a013452007-06-18 01:42:54 +0200133extern int devres_release_all(struct device *dev);
Strashko, Grygorii013c0742015-11-10 11:42:34 +0200134extern void device_block_probing(void);
135extern void device_unblock_probing(void);
Greg Kroah-Hartman823bccf2007-04-13 13:15:19 -0700136
Kay Sieversca22e562011-12-14 14:29:38 -0800137/* /sys/devices directory */
Greg Kroah-Hartman881c6cfd2007-11-01 09:29:06 -0600138extern struct kset *devices_kset;
Grygorii Strashko52cdbdd2015-07-27 20:43:01 +0300139extern void devices_kset_move_last(struct device *dev);
Greg Kroah-Hartmanc63469a2007-11-28 12:23:18 -0800140
Randy Dunlap92b42142007-12-31 10:05:43 -0800141#if defined(CONFIG_MODULES) && defined(CONFIG_SYSFS)
Greg Kroah-Hartmanc63469a2007-11-28 12:23:18 -0800142extern void module_add_driver(struct module *mod, struct device_driver *drv);
143extern void module_remove_driver(struct device_driver *drv);
144#else
145static inline void module_add_driver(struct module *mod,
146 struct device_driver *drv) { }
147static inline void module_remove_driver(struct device_driver *drv) { }
148#endif
Kay Sievers2b2af542009-04-30 15:23:42 +0200149
150#ifdef CONFIG_DEVTMPFS
151extern int devtmpfs_init(void);
152#else
153static inline int devtmpfs_init(void) { return 0; }
154#endif