ACPI: simplify acpi_pci_irq_add_prt() API
[linux-2.6/linux-acpi-2.6.git] / include / linux / sysdev.h
blobf395bb3fa2f2065375f25c51ea8221d27a4d3dc6
1 /**
2 * System devices follow a slightly different driver model.
3 * They don't need to do dynammic driver binding, can't be probed,
4 * and don't reside on any type of peripheral bus.
5 * So, we represent and treat them a little differently.
6 *
7 * We still have a notion of a driver for a system device, because we still
8 * want to perform basic operations on these devices.
10 * We also support auxillary drivers binding to devices of a certain class.
12 * This allows configurable drivers to register themselves for devices of
13 * a certain type. And, it allows class definitions to reside in generic
14 * code while arch-specific code can register specific drivers.
16 * Auxillary drivers registered with a NULL cls are registered as drivers
17 * for all system devices, and get notification calls for each device.
21 #ifndef _SYSDEV_H_
22 #define _SYSDEV_H_
24 #include <linux/kobject.h>
25 #include <linux/module.h>
26 #include <linux/pm.h>
29 struct sys_device;
31 struct sysdev_class {
32 const char *name;
33 struct list_head drivers;
35 /* Default operations for these types of devices */
36 int (*shutdown)(struct sys_device *);
37 int (*suspend)(struct sys_device *, pm_message_t state);
38 int (*resume)(struct sys_device *);
39 struct kset kset;
42 struct sysdev_class_attribute {
43 struct attribute attr;
44 ssize_t (*show)(struct sysdev_class *, char *);
45 ssize_t (*store)(struct sysdev_class *, const char *, size_t);
48 #define _SYSDEV_CLASS_ATTR(_name,_mode,_show,_store) \
49 { \
50 .attr = {.name = __stringify(_name), .mode = _mode }, \
51 .show = _show, \
52 .store = _store, \
55 #define SYSDEV_CLASS_ATTR(_name,_mode,_show,_store) \
56 struct sysdev_class_attribute attr_##_name = \
57 _SYSDEV_CLASS_ATTR(_name,_mode,_show,_store)
60 extern int sysdev_class_register(struct sysdev_class *);
61 extern void sysdev_class_unregister(struct sysdev_class *);
63 extern int sysdev_class_create_file(struct sysdev_class *,
64 struct sysdev_class_attribute *);
65 extern void sysdev_class_remove_file(struct sysdev_class *,
66 struct sysdev_class_attribute *);
67 /**
68 * Auxillary system device drivers.
71 struct sysdev_driver {
72 struct list_head entry;
73 int (*add)(struct sys_device *);
74 int (*remove)(struct sys_device *);
75 int (*shutdown)(struct sys_device *);
76 int (*suspend)(struct sys_device *, pm_message_t state);
77 int (*resume)(struct sys_device *);
81 extern int sysdev_driver_register(struct sysdev_class *, struct sysdev_driver *);
82 extern void sysdev_driver_unregister(struct sysdev_class *, struct sysdev_driver *);
85 /**
86 * sys_devices can be simplified a lot from regular devices, because they're
87 * simply not as versatile.
90 struct sys_device {
91 u32 id;
92 struct sysdev_class * cls;
93 struct kobject kobj;
96 extern int sysdev_register(struct sys_device *);
97 extern void sysdev_unregister(struct sys_device *);
100 struct sysdev_attribute {
101 struct attribute attr;
102 ssize_t (*show)(struct sys_device *, struct sysdev_attribute *, char *);
103 ssize_t (*store)(struct sys_device *, struct sysdev_attribute *,
104 const char *, size_t);
108 #define _SYSDEV_ATTR(_name, _mode, _show, _store) \
110 .attr = { .name = __stringify(_name), .mode = _mode }, \
111 .show = _show, \
112 .store = _store, \
115 #define SYSDEV_ATTR(_name, _mode, _show, _store) \
116 struct sysdev_attribute attr_##_name = \
117 _SYSDEV_ATTR(_name, _mode, _show, _store);
119 extern int sysdev_create_file(struct sys_device *, struct sysdev_attribute *);
120 extern void sysdev_remove_file(struct sys_device *, struct sysdev_attribute *);
122 struct sysdev_ext_attribute {
123 struct sysdev_attribute attr;
124 void *var;
128 * Support for simple variable sysdev attributes.
129 * The pointer to the variable is stored in a sysdev_ext_attribute
132 /* Add more types as needed */
134 extern ssize_t sysdev_show_ulong(struct sys_device *, struct sysdev_attribute *,
135 char *);
136 extern ssize_t sysdev_store_ulong(struct sys_device *,
137 struct sysdev_attribute *, const char *, size_t);
138 extern ssize_t sysdev_show_int(struct sys_device *, struct sysdev_attribute *,
139 char *);
140 extern ssize_t sysdev_store_int(struct sys_device *,
141 struct sysdev_attribute *, const char *, size_t);
143 #define _SYSDEV_ULONG_ATTR(_name, _mode, _var) \
144 { _SYSDEV_ATTR(_name, _mode, sysdev_show_ulong, sysdev_store_ulong), \
145 &(_var) }
146 #define SYSDEV_ULONG_ATTR(_name, _mode, _var) \
147 struct sysdev_ext_attribute attr_##_name = \
148 _SYSDEV_ULONG_ATTR(_name, _mode, _var);
149 #define _SYSDEV_INT_ATTR(_name, _mode, _var) \
150 { _SYSDEV_ATTR(_name, _mode, sysdev_show_int, sysdev_store_int), \
151 &(_var) }
152 #define SYSDEV_INT_ATTR(_name, _mode, _var) \
153 struct sysdev_ext_attribute attr_##_name = \
154 _SYSDEV_INT_ATTR(_name, _mode, _var);
156 #endif /* _SYSDEV_H_ */