2 * device.h - generic, centralized driver model
4 * Copyright (c) 2001-2003 Patrick Mochel <mochel@osdl.org>
5 * Copyright (c) 2004-2007 Greg Kroah-Hartman <gregkh@suse.de>
7 * This file is released under the GPLv2
9 * See Documentation/driver-model/ for more information.
15 #include <linux/ioport.h>
16 #include <linux/kobject.h>
17 #include <linux/klist.h>
18 #include <linux/list.h>
19 #include <linux/compiler.h>
20 #include <linux/types.h>
21 #include <linux/module.h>
23 #include <asm/semaphore.h>
24 #include <asm/atomic.h>
25 #include <asm/device.h>
27 #define DEVICE_NAME_SIZE 50
28 /* DEVICE_NAME_HALF is really less than half to accommodate slop */
29 #define DEVICE_NAME_HALF __stringify(20)
30 #define DEVICE_ID_SIZE 32
31 #define BUS_ID_SIZE KOBJ_NAME_LEN
36 struct driver_private
;
40 struct bus_type_private
;
42 struct bus_attribute
{
43 struct attribute attr
;
44 ssize_t (*show
)(struct bus_type
*bus
, char *buf
);
45 ssize_t (*store
)(struct bus_type
*bus
, const char *buf
, size_t count
);
48 #define BUS_ATTR(_name, _mode, _show, _store) \
49 struct bus_attribute bus_attr_##_name = __ATTR(_name, _mode, _show, _store)
51 extern int __must_check
bus_create_file(struct bus_type
*,
52 struct bus_attribute
*);
53 extern void bus_remove_file(struct bus_type
*, struct bus_attribute
*);
57 struct bus_attribute
*bus_attrs
;
58 struct device_attribute
*dev_attrs
;
59 struct driver_attribute
*drv_attrs
;
61 int (*match
)(struct device
*dev
, struct device_driver
*drv
);
62 int (*uevent
)(struct device
*dev
, struct kobj_uevent_env
*env
);
63 int (*probe
)(struct device
*dev
);
64 int (*remove
)(struct device
*dev
);
65 void (*shutdown
)(struct device
*dev
);
67 int (*suspend
)(struct device
*dev
, pm_message_t state
);
68 int (*suspend_late
)(struct device
*dev
, pm_message_t state
);
69 int (*resume_early
)(struct device
*dev
);
70 int (*resume
)(struct device
*dev
);
72 struct bus_type_private
*p
;
75 extern int __must_check
bus_register(struct bus_type
*bus
);
76 extern void bus_unregister(struct bus_type
*bus
);
78 extern int __must_check
bus_rescan_devices(struct bus_type
*bus
);
80 /* iterator helpers for buses */
82 int bus_for_each_dev(struct bus_type
*bus
, struct device
*start
, void *data
,
83 int (*fn
)(struct device
*dev
, void *data
));
84 struct device
*bus_find_device(struct bus_type
*bus
, struct device
*start
,
86 int (*match
)(struct device
*dev
, void *data
));
87 struct device
*bus_find_device_by_name(struct bus_type
*bus
,
91 int __must_check
bus_for_each_drv(struct bus_type
*bus
,
92 struct device_driver
*start
, void *data
,
93 int (*fn
)(struct device_driver
*, void *));
96 * Bus notifiers: Get notified of addition/removal of devices
97 * and binding/unbinding of drivers to devices.
98 * In the long run, it should be a replacement for the platform
101 struct notifier_block
;
103 extern int bus_register_notifier(struct bus_type
*bus
,
104 struct notifier_block
*nb
);
105 extern int bus_unregister_notifier(struct bus_type
*bus
,
106 struct notifier_block
*nb
);
108 /* All 4 notifers below get called with the target struct device *
109 * as an argument. Note that those functions are likely to be called
110 * with the device semaphore held in the core, so be careful.
112 #define BUS_NOTIFY_ADD_DEVICE 0x00000001 /* device added */
113 #define BUS_NOTIFY_DEL_DEVICE 0x00000002 /* device removed */
114 #define BUS_NOTIFY_BOUND_DRIVER 0x00000003 /* driver bound to device */
115 #define BUS_NOTIFY_UNBIND_DRIVER 0x00000004 /* driver about to be
118 extern struct kset
*bus_get_kset(struct bus_type
*bus
);
119 extern struct klist
*bus_get_device_klist(struct bus_type
*bus
);
121 struct device_driver
{
123 struct bus_type
*bus
;
125 struct module
*owner
;
126 const char *mod_name
; /* used for built-in modules */
128 int (*probe
) (struct device
*dev
);
129 int (*remove
) (struct device
*dev
);
130 void (*shutdown
) (struct device
*dev
);
131 int (*suspend
) (struct device
*dev
, pm_message_t state
);
132 int (*resume
) (struct device
*dev
);
133 struct attribute_group
**groups
;
135 struct driver_private
*p
;
139 extern int __must_check
driver_register(struct device_driver
*drv
);
140 extern void driver_unregister(struct device_driver
*drv
);
142 extern struct device_driver
*get_driver(struct device_driver
*drv
);
143 extern void put_driver(struct device_driver
*drv
);
144 extern struct device_driver
*driver_find(const char *name
,
145 struct bus_type
*bus
);
146 extern int driver_probe_done(void);
148 /* sysfs interface for exporting driver attributes */
150 struct driver_attribute
{
151 struct attribute attr
;
152 ssize_t (*show
)(struct device_driver
*driver
, char *buf
);
153 ssize_t (*store
)(struct device_driver
*driver
, const char *buf
,
157 #define DRIVER_ATTR(_name, _mode, _show, _store) \
158 struct driver_attribute driver_attr_##_name = \
159 __ATTR(_name, _mode, _show, _store)
161 extern int __must_check
driver_create_file(struct device_driver
*driver
,
162 struct driver_attribute
*attr
);
163 extern void driver_remove_file(struct device_driver
*driver
,
164 struct driver_attribute
*attr
);
166 extern int __must_check
driver_add_kobj(struct device_driver
*drv
,
167 struct kobject
*kobj
,
168 const char *fmt
, ...);
170 extern int __must_check
driver_for_each_device(struct device_driver
*drv
,
171 struct device
*start
,
173 int (*fn
)(struct device
*dev
,
175 struct device
*driver_find_device(struct device_driver
*drv
,
176 struct device
*start
, void *data
,
177 int (*match
)(struct device
*dev
, void *data
));
184 struct module
*owner
;
187 struct list_head children
;
188 struct list_head devices
;
189 struct list_head interfaces
;
190 struct kset class_dirs
;
191 struct semaphore sem
; /* locks children, devices, interfaces */
192 struct class_attribute
*class_attrs
;
193 struct class_device_attribute
*class_dev_attrs
;
194 struct device_attribute
*dev_attrs
;
196 int (*uevent
)(struct class_device
*dev
, struct kobj_uevent_env
*env
);
197 int (*dev_uevent
)(struct device
*dev
, struct kobj_uevent_env
*env
);
199 void (*release
)(struct class_device
*dev
);
200 void (*class_release
)(struct class *class);
201 void (*dev_release
)(struct device
*dev
);
203 int (*suspend
)(struct device
*dev
, pm_message_t state
);
204 int (*resume
)(struct device
*dev
);
207 extern int __must_check
class_register(struct class *class);
208 extern void class_unregister(struct class *class);
209 extern int class_for_each_device(struct class *class, void *data
,
210 int (*fn
)(struct device
*dev
, void *data
));
211 extern struct device
*class_find_device(struct class *class, void *data
,
212 int (*match
)(struct device
*, void *));
213 extern struct class_device
*class_find_child(struct class *class, void *data
,
214 int (*match
)(struct class_device
*, void *));
217 struct class_attribute
{
218 struct attribute attr
;
219 ssize_t (*show
)(struct class *class, char *buf
);
220 ssize_t (*store
)(struct class *class, const char *buf
, size_t count
);
223 #define CLASS_ATTR(_name, _mode, _show, _store) \
224 struct class_attribute class_attr_##_name = __ATTR(_name, _mode, _show, _store)
226 extern int __must_check
class_create_file(struct class *class,
227 const struct class_attribute
*attr
);
228 extern void class_remove_file(struct class *class,
229 const struct class_attribute
*attr
);
231 struct class_device_attribute
{
232 struct attribute attr
;
233 ssize_t (*show
)(struct class_device
*, char *buf
);
234 ssize_t (*store
)(struct class_device
*, const char *buf
, size_t count
);
237 #define CLASS_DEVICE_ATTR(_name, _mode, _show, _store) \
238 struct class_device_attribute class_device_attr_##_name = \
239 __ATTR(_name, _mode, _show, _store)
241 extern int __must_check
class_device_create_file(struct class_device
*,
242 const struct class_device_attribute
*);
245 * struct class_device - class devices
246 * @class: pointer to the parent class for this class device. This is required.
247 * @devt: for internal use by the driver core only.
248 * @node: for internal use by the driver core only.
249 * @kobj: for internal use by the driver core only.
250 * @groups: optional additional groups to be created
251 * @dev: if set, a symlink to the struct device is created in the sysfs
252 * directory for this struct class device.
253 * @class_data: pointer to whatever you want to store here for this struct
254 * class_device. Use class_get_devdata() and class_set_devdata() to get and
256 * @parent: pointer to a struct class_device that is the parent of this struct
257 * class_device. If NULL, this class_device will show up at the root of the
258 * struct class in sysfs (which is probably what you want to have happen.)
259 * @release: pointer to a release function for this struct class_device. If
260 * set, this will be called instead of the class specific release function.
261 * Only use this if you want to override the default release function, like
262 * when you are nesting class_device structures.
263 * @uevent: pointer to a uevent function for this struct class_device. If
264 * set, this will be called instead of the class specific uevent function.
265 * Only use this if you want to override the default uevent function, like
266 * when you are nesting class_device structures.
268 struct class_device
{
269 struct list_head node
;
276 struct class_device
*parent
;
277 struct attribute_group
**groups
;
279 void (*release
)(struct class_device
*dev
);
280 int (*uevent
)(struct class_device
*dev
, struct kobj_uevent_env
*env
);
281 char class_id
[BUS_ID_SIZE
];
284 static inline void *class_get_devdata(struct class_device
*dev
)
286 return dev
->class_data
;
289 static inline void class_set_devdata(struct class_device
*dev
, void *data
)
291 dev
->class_data
= data
;
295 extern int __must_check
class_device_register(struct class_device
*);
296 extern void class_device_unregister(struct class_device
*);
297 extern void class_device_initialize(struct class_device
*);
298 extern int __must_check
class_device_add(struct class_device
*);
299 extern void class_device_del(struct class_device
*);
301 extern struct class_device
*class_device_get(struct class_device
*);
302 extern void class_device_put(struct class_device
*);
304 extern void class_device_remove_file(struct class_device
*,
305 const struct class_device_attribute
*);
306 extern int __must_check
class_device_create_bin_file(struct class_device
*,
307 struct bin_attribute
*);
308 extern void class_device_remove_bin_file(struct class_device
*,
309 struct bin_attribute
*);
311 struct class_interface
{
312 struct list_head node
;
315 int (*add
) (struct class_device
*, struct class_interface
*);
316 void (*remove
) (struct class_device
*, struct class_interface
*);
317 int (*add_dev
) (struct device
*, struct class_interface
*);
318 void (*remove_dev
) (struct device
*, struct class_interface
*);
321 extern int __must_check
class_interface_register(struct class_interface
*);
322 extern void class_interface_unregister(struct class_interface
*);
324 extern struct class *class_create(struct module
*owner
, const char *name
);
325 extern void class_destroy(struct class *cls
);
326 extern struct class_device
*class_device_create(struct class *cls
,
327 struct class_device
*parent
,
329 struct device
*device
,
330 const char *fmt
, ...)
331 __attribute__((format(printf
, 5, 6)));
332 extern void class_device_destroy(struct class *cls
, dev_t devt
);
335 * The type of device, "struct device" is embedded in. A class
336 * or bus can contain devices of different types
337 * like "partitions" and "disks", "mouse" and "event".
338 * This identifies the device type and carries type-specific
339 * information, equivalent to the kobj_type of a kobject.
340 * If "name" is specified, the uevent will contain it in
341 * the DEVTYPE variable.
345 struct attribute_group
**groups
;
346 int (*uevent
)(struct device
*dev
, struct kobj_uevent_env
*env
);
347 void (*release
)(struct device
*dev
);
348 int (*suspend
)(struct device
*dev
, pm_message_t state
);
349 int (*resume
)(struct device
*dev
);
352 /* interface for exporting device attributes */
353 struct device_attribute
{
354 struct attribute attr
;
355 ssize_t (*show
)(struct device
*dev
, struct device_attribute
*attr
,
357 ssize_t (*store
)(struct device
*dev
, struct device_attribute
*attr
,
358 const char *buf
, size_t count
);
361 #define DEVICE_ATTR(_name, _mode, _show, _store) \
362 struct device_attribute dev_attr_##_name = __ATTR(_name, _mode, _show, _store)
364 extern int __must_check
device_create_file(struct device
*device
,
365 struct device_attribute
*entry
);
366 extern void device_remove_file(struct device
*dev
,
367 struct device_attribute
*attr
);
368 extern int __must_check
device_create_bin_file(struct device
*dev
,
369 struct bin_attribute
*attr
);
370 extern void device_remove_bin_file(struct device
*dev
,
371 struct bin_attribute
*attr
);
372 extern int device_schedule_callback_owner(struct device
*dev
,
373 void (*func
)(struct device
*dev
), struct module
*owner
);
375 /* This is a macro to avoid include problems with THIS_MODULE */
376 #define device_schedule_callback(dev, func) \
377 device_schedule_callback_owner(dev, func, THIS_MODULE)
379 /* device resource management */
380 typedef void (*dr_release_t
)(struct device
*dev
, void *res
);
381 typedef int (*dr_match_t
)(struct device
*dev
, void *res
, void *match_data
);
383 #ifdef CONFIG_DEBUG_DEVRES
384 extern void *__devres_alloc(dr_release_t release
, size_t size
, gfp_t gfp
,
386 #define devres_alloc(release, size, gfp) \
387 __devres_alloc(release, size, gfp, #release)
389 extern void *devres_alloc(dr_release_t release
, size_t size
, gfp_t gfp
);
391 extern void devres_free(void *res
);
392 extern void devres_add(struct device
*dev
, void *res
);
393 extern void *devres_find(struct device
*dev
, dr_release_t release
,
394 dr_match_t match
, void *match_data
);
395 extern void *devres_get(struct device
*dev
, void *new_res
,
396 dr_match_t match
, void *match_data
);
397 extern void *devres_remove(struct device
*dev
, dr_release_t release
,
398 dr_match_t match
, void *match_data
);
399 extern int devres_destroy(struct device
*dev
, dr_release_t release
,
400 dr_match_t match
, void *match_data
);
403 extern void * __must_check
devres_open_group(struct device
*dev
, void *id
,
405 extern void devres_close_group(struct device
*dev
, void *id
);
406 extern void devres_remove_group(struct device
*dev
, void *id
);
407 extern int devres_release_group(struct device
*dev
, void *id
);
409 /* managed kzalloc/kfree for device drivers, no kmalloc, always use kzalloc */
410 extern void *devm_kzalloc(struct device
*dev
, size_t size
, gfp_t gfp
);
411 extern void devm_kfree(struct device
*dev
, void *p
);
413 struct device_dma_parameters
{
415 * a low level driver may set these to teach IOMMU code about
418 unsigned int max_segment_size
;
419 unsigned long segment_boundary_mask
;
423 struct klist klist_children
;
424 struct klist_node knode_parent
; /* node in sibling list */
425 struct klist_node knode_driver
;
426 struct klist_node knode_bus
;
427 struct device
*parent
;
430 char bus_id
[BUS_ID_SIZE
]; /* position on parent bus */
431 struct device_type
*type
;
432 unsigned is_registered
:1;
433 unsigned uevent_suppress
:1;
435 struct semaphore sem
; /* semaphore to synchronize calls to
439 struct bus_type
*bus
; /* type of bus device is on */
440 struct device_driver
*driver
; /* which driver has allocated this
442 void *driver_data
; /* data private to the driver */
443 void *platform_data
; /* Platform specific data, device
444 core doesn't touch it */
445 struct dev_pm_info power
;
448 int numa_node
; /* NUMA node this device is close to */
450 u64
*dma_mask
; /* dma mask (if dma'able device) */
451 u64 coherent_dma_mask
;/* Like dma_mask, but for
452 alloc_coherent mappings as
453 not all hardware supports
454 64 bit addresses for consistent
455 allocations such descriptors. */
457 struct device_dma_parameters
*dma_parms
;
459 struct list_head dma_pools
; /* dma pools (if dma'ble) */
461 struct dma_coherent_mem
*dma_mem
; /* internal for coherent mem
463 /* arch specific additions */
464 struct dev_archdata archdata
;
466 spinlock_t devres_lock
;
467 struct list_head devres_head
;
469 /* class_device migration path */
470 struct list_head node
;
472 dev_t devt
; /* dev_t, creates the sysfs "dev" */
473 struct attribute_group
**groups
; /* optional groups */
475 void (*release
)(struct device
*dev
);
479 static inline int dev_to_node(struct device
*dev
)
481 return dev
->numa_node
;
483 static inline void set_dev_node(struct device
*dev
, int node
)
485 dev
->numa_node
= node
;
488 static inline int dev_to_node(struct device
*dev
)
492 static inline void set_dev_node(struct device
*dev
, int node
)
497 static inline void *dev_get_drvdata(struct device
*dev
)
499 return dev
->driver_data
;
502 static inline void dev_set_drvdata(struct device
*dev
, void *data
)
504 dev
->driver_data
= data
;
507 static inline int device_is_registered(struct device
*dev
)
509 return dev
->is_registered
;
512 void driver_init(void);
515 * High level routines for use by the bus drivers
517 extern int __must_check
device_register(struct device
*dev
);
518 extern void device_unregister(struct device
*dev
);
519 extern void device_initialize(struct device
*dev
);
520 extern int __must_check
device_add(struct device
*dev
);
521 extern void device_del(struct device
*dev
);
522 extern int device_for_each_child(struct device
*dev
, void *data
,
523 int (*fn
)(struct device
*dev
, void *data
));
524 extern struct device
*device_find_child(struct device
*dev
, void *data
,
525 int (*match
)(struct device
*dev
, void *data
));
526 extern int device_rename(struct device
*dev
, char *new_name
);
527 extern int device_move(struct device
*dev
, struct device
*new_parent
);
530 * Manual binding of a device to driver. See drivers/base/bus.c
531 * for information on use.
533 extern int __must_check
device_bind_driver(struct device
*dev
);
534 extern void device_release_driver(struct device
*dev
);
535 extern int __must_check
device_attach(struct device
*dev
);
536 extern int __must_check
driver_attach(struct device_driver
*drv
);
537 extern int __must_check
device_reprobe(struct device
*dev
);
540 * Easy functions for dynamically creating devices on the fly
542 extern struct device
*device_create(struct class *cls
, struct device
*parent
,
543 dev_t devt
, const char *fmt
, ...)
544 __attribute__((format(printf
, 4, 5)));
545 extern void device_destroy(struct class *cls
, dev_t devt
);
546 #ifdef CONFIG_PM_SLEEP
547 extern void destroy_suspended_device(struct class *cls
, dev_t devt
);
548 extern void device_pm_schedule_removal(struct device
*);
549 #else /* !CONFIG_PM_SLEEP */
550 static inline void destroy_suspended_device(struct class *cls
, dev_t devt
)
552 device_destroy(cls
, devt
);
555 static inline void device_pm_schedule_removal(struct device
*dev
)
557 device_unregister(dev
);
559 #endif /* !CONFIG_PM_SLEEP */
562 * Platform "fixup" functions - allow the platform to have their say
563 * about devices and actions that the general device layer doesn't
566 /* Notify platform of device discovery */
567 extern int (*platform_notify
)(struct device
*dev
);
569 extern int (*platform_notify_remove
)(struct device
*dev
);
573 * get_device - atomically increment the reference count for the device.
576 extern struct device
*get_device(struct device
*dev
);
577 extern void put_device(struct device
*dev
);
580 /* drivers/base/power/shutdown.c */
581 extern void device_shutdown(void);
583 /* drivers/base/sys.c */
584 extern void sysdev_shutdown(void);
586 /* debugging and troubleshooting/diagnostic helpers. */
587 extern const char *dev_driver_string(struct device
*dev
);
588 #define dev_printk(level, dev, format, arg...) \
589 printk(level "%s %s: " format , dev_driver_string(dev) , \
590 (dev)->bus_id , ## arg)
592 #define dev_emerg(dev, format, arg...) \
593 dev_printk(KERN_EMERG , dev , format , ## arg)
594 #define dev_alert(dev, format, arg...) \
595 dev_printk(KERN_ALERT , dev , format , ## arg)
596 #define dev_crit(dev, format, arg...) \
597 dev_printk(KERN_CRIT , dev , format , ## arg)
598 #define dev_err(dev, format, arg...) \
599 dev_printk(KERN_ERR , dev , format , ## arg)
600 #define dev_warn(dev, format, arg...) \
601 dev_printk(KERN_WARNING , dev , format , ## arg)
602 #define dev_notice(dev, format, arg...) \
603 dev_printk(KERN_NOTICE , dev , format , ## arg)
604 #define dev_info(dev, format, arg...) \
605 dev_printk(KERN_INFO , dev , format , ## arg)
608 #define dev_dbg(dev, format, arg...) \
609 dev_printk(KERN_DEBUG , dev , format , ## arg)
611 #define dev_dbg(dev, format, arg...) \
612 ({ if (0) dev_printk(KERN_DEBUG, dev, format, ##arg); 0; })
616 #define dev_vdbg dev_dbg
619 #define dev_vdbg(dev, format, arg...) \
620 ({ if (0) dev_printk(KERN_DEBUG, dev, format, ##arg); 0; })
623 /* Create alias, so I can be autoloaded. */
624 #define MODULE_ALIAS_CHARDEV(major,minor) \
625 MODULE_ALIAS("char-major-" __stringify(major) "-" __stringify(minor))
626 #define MODULE_ALIAS_CHARDEV_MAJOR(major) \
627 MODULE_ALIAS("char-major-" __stringify(major) "-*")
628 #endif /* _DEVICE_H_ */