| 1 | /* SPDX-License-Identifier: GPL-2.0 */ | 
|---|
| 2 | /** | 
|---|
| 3 | * struct subsys_private - structure to hold the private to the driver core portions of the bus_type/class structure. | 
|---|
| 4 | * | 
|---|
| 5 | * @subsys - the struct kset that defines this subsystem | 
|---|
| 6 | * @devices_kset - the list of devices associated | 
|---|
| 7 | * | 
|---|
| 8 | * @drivers_kset - the list of drivers associated | 
|---|
| 9 | * @klist_devices - the klist to iterate over the @devices_kset | 
|---|
| 10 | * @klist_drivers - the klist to iterate over the @drivers_kset | 
|---|
| 11 | * @bus_notifier - the bus notifier list for anything that cares about things | 
|---|
| 12 | *                 on this bus. | 
|---|
| 13 | * @bus - pointer back to the struct bus_type that this structure is associated | 
|---|
| 14 | *        with. | 
|---|
| 15 | * | 
|---|
| 16 | * @class_interfaces - list of class_interfaces associated | 
|---|
| 17 | * @glue_dirs - "glue" directory to put in-between the parent device to | 
|---|
| 18 | *              avoid namespace conflicts | 
|---|
| 19 | * @class_mutex - mutex to protect the children, devices, and interfaces lists. | 
|---|
| 20 | * @class - pointer back to the struct class that this structure is associated | 
|---|
| 21 | *          with. | 
|---|
| 22 | * | 
|---|
| 23 | * This structure is the one that is the actual kobject allowing struct | 
|---|
| 24 | * bus_type/class to be statically allocated safely.  Nothing outside of the | 
|---|
| 25 | * driver core should ever touch these fields. | 
|---|
| 26 | */ | 
|---|
| 27 | struct subsys_private { | 
|---|
| 28 | struct kset subsys; | 
|---|
| 29 | struct kset *devices_kset; | 
|---|
| 30 |  | 
|---|
| 31 | struct kset *drivers_kset; | 
|---|
| 32 | struct klist klist_devices; | 
|---|
| 33 | struct klist klist_drivers; | 
|---|
| 34 | struct blocking_notifier_head bus_notifier; | 
|---|
| 35 | unsigned int drivers_autoprobe:1; | 
|---|
| 36 | struct bus_type *bus; | 
|---|
| 37 |  | 
|---|
| 38 | struct list_head class_interfaces; | 
|---|
| 39 | struct kset glue_dirs; | 
|---|
| 40 | struct mutex class_mutex; | 
|---|
| 41 | struct class *class; | 
|---|
| 42 | }; | 
|---|
| 43 | #define to_subsys_private(obj) container_of(obj, struct subsys_private, subsys.kobj) | 
|---|
| 44 |  | 
|---|
| 45 |  | 
|---|
| 46 |  | 
|---|
| 47 | struct driver_private { | 
|---|
| 48 | struct kobject kobj; | 
|---|
| 49 | struct klist klist_devices; | 
|---|
| 50 | struct klist_node knode_bus; | 
|---|
| 51 | struct module_kobject *mkobj; | 
|---|
| 52 | struct device_driver *driver; | 
|---|
| 53 | }; | 
|---|
| 54 | #define to_driver(obj) container_of(obj, struct driver_private, kobj) | 
|---|
| 55 |  | 
|---|
| 56 | /** | 
|---|
| 57 | * struct device_private - structure to hold the private to the driver core portions of the device structure. | 
|---|
| 58 | * | 
|---|
| 59 | * @klist_children - klist containing all children of this device | 
|---|
| 60 | * @knode_parent - node in sibling list | 
|---|
| 61 | * @knode_driver - node in driver list | 
|---|
| 62 | * @knode_bus - node in bus list | 
|---|
| 63 | * @driver_data - private pointer for driver specific info.  Will turn into a | 
|---|
| 64 | * list soon. | 
|---|
| 65 | * @device - pointer back to the struct class that this structure is | 
|---|
| 66 | * associated with. | 
|---|
| 67 | * | 
|---|
| 68 | * Nothing outside of the driver core should ever touch these fields. | 
|---|
| 69 | */ | 
|---|
| 70 | struct device_private { | 
|---|
| 71 | struct klist klist_children; | 
|---|
| 72 | struct klist_node knode_parent; | 
|---|
| 73 | struct klist_node knode_driver; | 
|---|
| 74 | struct klist_node knode_bus; | 
|---|
| 75 | void *driver_data; | 
|---|
| 76 | struct device *device; | 
|---|
| 77 | }; | 
|---|
| 78 | #define to_device_private_parent(obj)   \ | 
|---|
| 79 | container_of(obj, struct device_private, knode_parent) | 
|---|
| 80 | #define to_device_private_driver(obj)   \ | 
|---|
| 81 | container_of(obj, struct device_private, knode_driver) | 
|---|
| 82 | #define to_device_private_bus(obj)      \ | 
|---|
| 83 | container_of(obj, struct device_private, knode_bus) | 
|---|
| 84 |  | 
|---|
| 85 | extern int device_private_init(struct device *dev); | 
|---|
| 86 |  | 
|---|
| 87 | /* initialisation functions */ | 
|---|
| 88 | extern int devices_init(void); | 
|---|
| 89 | extern int buses_init(void); | 
|---|
| 90 | extern int classes_init(void); | 
|---|
| 91 | extern int firmware_init(void); | 
|---|
| 92 | #ifdef CONFIG_SYS_HYPERVISOR | 
|---|
| 93 | extern int hypervisor_init(void); | 
|---|
| 94 | #else | 
|---|
| 95 | static inline int hypervisor_init(void) { return 0; } | 
|---|
| 96 | #endif | 
|---|
| 97 | extern int platform_bus_init(void); | 
|---|
| 98 | extern int system_bus_init(void); | 
|---|
| 99 | extern int cpu_dev_init(void); | 
|---|
| 100 |  | 
|---|
| 101 | extern int bus_add_device(struct device *dev); | 
|---|
| 102 | extern void bus_probe_device(struct device *dev); | 
|---|
| 103 | extern void bus_remove_device(struct device *dev); | 
|---|
| 104 |  | 
|---|
| 105 | extern int bus_add_driver(struct device_driver *drv); | 
|---|
| 106 | extern void bus_remove_driver(struct device_driver *drv); | 
|---|
| 107 |  | 
|---|
| 108 | extern void driver_detach(struct device_driver *drv); | 
|---|
| 109 | extern int driver_probe_device(struct device_driver *drv, struct device *dev); | 
|---|
| 110 | static inline int driver_match_device(struct device_driver *drv, | 
|---|
| 111 | struct device *dev) | 
|---|
| 112 | { | 
|---|
| 113 | return drv->bus->match ? drv->bus->match(dev, drv) : 1; | 
|---|
| 114 | } | 
|---|
| 115 |  | 
|---|
| 116 | extern char *make_class_name(const char *name, struct kobject *kobj); | 
|---|
| 117 |  | 
|---|
| 118 | extern int devres_release_all(struct device *dev); | 
|---|
| 119 |  | 
|---|
| 120 | extern struct kset *devices_kset; | 
|---|
| 121 |  | 
|---|
| 122 | #if defined(CONFIG_MODULES) && defined(CONFIG_SYSFS) | 
|---|
| 123 | extern void module_add_driver(struct module *mod, struct device_driver *drv); | 
|---|
| 124 | extern void module_remove_driver(struct device_driver *drv); | 
|---|
| 125 | #else | 
|---|
| 126 | static inline void module_add_driver(struct module *mod, | 
|---|
| 127 | struct device_driver *drv) { } | 
|---|
| 128 | static inline void module_remove_driver(struct device_driver *drv) { } | 
|---|
| 129 | #endif | 
|---|
| 130 |  | 
|---|
| 131 | #ifdef CONFIG_DEVTMPFS | 
|---|
| 132 | extern int devtmpfs_init(void); | 
|---|
| 133 | #else | 
|---|
| 134 | static inline int devtmpfs_init(void) { return 0; } | 
|---|
| 135 | #endif | 
|---|