blob: 24f424249d9b517089b82c2436042751eec3aa42 [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.
Greg Kroah-Hartmanb4028432009-05-11 14:16:57 -070066 * @driver_data - private pointer for driver specific info. Will turn into a
67 * list soon.
Greg Kroah-Hartmanfb069a52008-12-16 12:23:36 -080068 * @device - pointer back to the struct class that this structure is
69 * associated with.
70 *
71 * Nothing outside of the driver core should ever touch these fields.
72 */
73struct device_private {
Greg Kroah-Hartmanf791b8c2008-12-16 12:24:56 -080074 struct klist klist_children;
75 struct klist_node knode_parent;
Greg Kroah-Hartman8940b4f2008-12-16 12:25:49 -080076 struct klist_node knode_driver;
Greg Kroah-Hartmanae1b4172008-12-16 12:26:21 -080077 struct klist_node knode_bus;
Greg Kroah-Hartmanef8a3fd2012-03-08 12:17:22 -080078 struct list_head deferred_probe;
Greg Kroah-Hartmanb4028432009-05-11 14:16:57 -070079 void *driver_data;
Greg Kroah-Hartmanfb069a52008-12-16 12:23:36 -080080 struct device *device;
81};
Greg Kroah-Hartmanf791b8c2008-12-16 12:24:56 -080082#define to_device_private_parent(obj) \
83 container_of(obj, struct device_private, knode_parent)
Greg Kroah-Hartman8940b4f2008-12-16 12:25:49 -080084#define to_device_private_driver(obj) \
85 container_of(obj, struct device_private, knode_driver)
Greg Kroah-Hartmanae1b4172008-12-16 12:26:21 -080086#define to_device_private_bus(obj) \
87 container_of(obj, struct device_private, knode_bus)
Greg Kroah-Hartmanfb069a52008-12-16 12:23:36 -080088
Greg Kroah-Hartmanb4028432009-05-11 14:16:57 -070089extern int device_private_init(struct device *dev);
90
Greg Kroah-Hartmanc6f7e722007-11-01 19:41:16 -070091/* initialisation functions */
Ben Dooksa1bdc7a2005-10-13 17:54:41 +010092extern int devices_init(void);
93extern int buses_init(void);
94extern int classes_init(void);
95extern int firmware_init(void);
Michael Holzheu40394832006-05-09 12:53:49 +020096#ifdef CONFIG_SYS_HYPERVISOR
97extern int hypervisor_init(void);
98#else
99static inline int hypervisor_init(void) { return 0; }
100#endif
Ben Dooksa1bdc7a2005-10-13 17:54:41 +0100101extern int platform_bus_init(void);
Ben Hutchings024f7842012-01-10 02:59:49 +0000102extern void cpu_dev_init(void);
Rafael J. Wysockicaa73ea2013-12-29 15:25:48 +0100103extern void container_dev_init(void);
Ben Dooksa1bdc7a2005-10-13 17:54:41 +0100104
Tejun Heod73ce002013-03-12 11:30:05 -0700105struct kobject *virtual_device_parent(struct device *dev);
106
Greg Kroah-Hartman4a3ad202008-01-24 22:50:12 -0800107extern int bus_add_device(struct device *dev);
Alan Stern2023c612009-07-30 15:27:18 -0400108extern void bus_probe_device(struct device *dev);
Greg Kroah-Hartman4a3ad202008-01-24 22:50:12 -0800109extern void bus_remove_device(struct device *dev);
Linus Torvalds1da177e2005-04-16 15:20:36 -0700110
Greg Kroah-Hartman4a3ad202008-01-24 22:50:12 -0800111extern int bus_add_driver(struct device_driver *drv);
112extern void bus_remove_driver(struct device_driver *drv);
Linus Torvalds1da177e2005-04-16 15:20:36 -0700113
Greg Kroah-Hartman4a3ad202008-01-24 22:50:12 -0800114extern void driver_detach(struct device_driver *drv);
115extern int driver_probe_device(struct device_driver *drv, struct device *dev);
Grant Likelyd1c34142012-03-05 08:47:41 -0700116extern void driver_deferred_probe_del(struct device *dev);
Ming Lei49b420a2009-01-21 23:27:47 +0800117static inline int driver_match_device(struct device_driver *drv,
118 struct device *dev)
119{
Ming Lei5247aec2009-03-27 21:50:00 +0800120 return drv->bus->match ? drv->bus->match(dev, drv) : 1;
Ming Lei49b420a2009-01-21 23:27:47 +0800121}
mochel@digitalimplant.org07e4a3e2005-03-21 10:52:54 -0800122
Greg Kroah-Hartmaned0617b2013-08-08 15:22:56 -0700123extern int driver_add_groups(struct device_driver *drv,
124 const struct attribute_group **groups);
125extern void driver_remove_groups(struct device_driver *drv,
126 const struct attribute_group **groups);
127
Greg Kroah-Hartmanfa6fdb32013-08-08 15:22:55 -0700128extern int device_add_groups(struct device *dev,
129 const struct attribute_group **groups);
130extern void device_remove_groups(struct device *dev,
131 const struct attribute_group **groups);
132
Greg Kroah-Hartmanaa49b912006-06-20 13:59:20 -0700133extern char *make_class_name(const char *name, struct kobject *kobj);
Linus Torvalds1da177e2005-04-16 15:20:36 -0700134
Adrian Bunk2a013452007-06-18 01:42:54 +0200135extern int devres_release_all(struct device *dev);
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;
Greg Kroah-Hartmanc63469a2007-11-28 12:23:18 -0800139
Randy Dunlap92b42142007-12-31 10:05:43 -0800140#if defined(CONFIG_MODULES) && defined(CONFIG_SYSFS)
Greg Kroah-Hartmanc63469a2007-11-28 12:23:18 -0800141extern void module_add_driver(struct module *mod, struct device_driver *drv);
142extern void module_remove_driver(struct device_driver *drv);
143#else
144static inline void module_add_driver(struct module *mod,
145 struct device_driver *drv) { }
146static inline void module_remove_driver(struct device_driver *drv) { }
147#endif
Kay Sievers2b2af542009-04-30 15:23:42 +0200148
149#ifdef CONFIG_DEVTMPFS
150extern int devtmpfs_init(void);
151#else
152static inline int devtmpfs_init(void) { return 0; }
153#endif