driver core/platform_device_add_resources: free resource before overwriting
[deliverable/linux.git] / include / linux / device.h
CommitLineData
1da177e4
LT
1/*
2 * device.h - generic, centralized driver model
3 *
4 * Copyright (c) 2001-2003 Patrick Mochel <mochel@osdl.org>
b4028437
GKH
5 * Copyright (c) 2004-2009 Greg Kroah-Hartman <gregkh@suse.de>
6 * Copyright (c) 2008-2009 Novell Inc.
1da177e4
LT
7 *
8 * This file is released under the GPLv2
9 *
10 * See Documentation/driver-model/ for more information.
11 */
12
13#ifndef _DEVICE_H_
14#define _DEVICE_H_
15
1da177e4
LT
16#include <linux/ioport.h>
17#include <linux/kobject.h>
465c7a3a 18#include <linux/klist.h>
1da177e4 19#include <linux/list.h>
d2a3b914 20#include <linux/lockdep.h>
4a7fb636 21#include <linux/compiler.h>
1da177e4
LT
22#include <linux/types.h>
23#include <linux/module.h>
24#include <linux/pm.h>
1da177e4 25#include <asm/atomic.h>
c6dbaef2 26#include <asm/device.h>
1da177e4 27
1da177e4 28struct device;
fb069a5d 29struct device_private;
1da177e4 30struct device_driver;
e5dd1278 31struct driver_private;
1da177e4 32struct class;
6b6e39a6 33struct subsys_private;
b8c5cec2 34struct bus_type;
d706c1b0 35struct device_node;
b8c5cec2
KS
36
37struct bus_attribute {
38 struct attribute attr;
d462943a
GKH
39 ssize_t (*show)(struct bus_type *bus, char *buf);
40 ssize_t (*store)(struct bus_type *bus, const char *buf, size_t count);
b8c5cec2
KS
41};
42
d462943a
GKH
43#define BUS_ATTR(_name, _mode, _show, _store) \
44struct bus_attribute bus_attr_##_name = __ATTR(_name, _mode, _show, _store)
b8c5cec2
KS
45
46extern int __must_check bus_create_file(struct bus_type *,
47 struct bus_attribute *);
48extern void bus_remove_file(struct bus_type *, struct bus_attribute *);
1da177e4
LT
49
50struct bus_type {
d462943a
GKH
51 const char *name;
52 struct bus_attribute *bus_attrs;
53 struct device_attribute *dev_attrs;
54 struct driver_attribute *drv_attrs;
55
56 int (*match)(struct device *dev, struct device_driver *drv);
57 int (*uevent)(struct device *dev, struct kobj_uevent_env *env);
58 int (*probe)(struct device *dev);
59 int (*remove)(struct device *dev);
60 void (*shutdown)(struct device *dev);
61
62 int (*suspend)(struct device *dev, pm_message_t state);
d462943a 63 int (*resume)(struct device *dev);
b8c5cec2 64
8150f32b 65 const struct dev_pm_ops *pm;
1eede070 66
6b6e39a6 67 struct subsys_private *p;
1da177e4
LT
68};
69
d462943a
GKH
70extern int __must_check bus_register(struct bus_type *bus);
71extern void bus_unregister(struct bus_type *bus);
1da177e4 72
d462943a 73extern int __must_check bus_rescan_devices(struct bus_type *bus);
1da177e4 74
1da177e4
LT
75/* iterator helpers for buses */
76
d462943a
GKH
77int bus_for_each_dev(struct bus_type *bus, struct device *start, void *data,
78 int (*fn)(struct device *dev, void *data));
79struct device *bus_find_device(struct bus_type *bus, struct device *start,
80 void *data,
81 int (*match)(struct device *dev, void *data));
1f9ffc04
GKH
82struct device *bus_find_device_by_name(struct bus_type *bus,
83 struct device *start,
84 const char *name);
1da177e4 85
cc7447a5
JD
86int bus_for_each_drv(struct bus_type *bus, struct device_driver *start,
87 void *data, int (*fn)(struct device_driver *, void *));
1da177e4 88
99178b03
GKH
89void bus_sort_breadthfirst(struct bus_type *bus,
90 int (*compare)(const struct device *a,
91 const struct device *b));
116af378
BH
92/*
93 * Bus notifiers: Get notified of addition/removal of devices
94 * and binding/unbinding of drivers to devices.
95 * In the long run, it should be a replacement for the platform
96 * notify hooks.
97 */
98struct notifier_block;
99
100extern int bus_register_notifier(struct bus_type *bus,
101 struct notifier_block *nb);
102extern int bus_unregister_notifier(struct bus_type *bus,
103 struct notifier_block *nb);
104
105/* All 4 notifers below get called with the target struct device *
106 * as an argument. Note that those functions are likely to be called
8e9394ce 107 * with the device lock held in the core, so be careful.
116af378
BH
108 */
109#define BUS_NOTIFY_ADD_DEVICE 0x00000001 /* device added */
110#define BUS_NOTIFY_DEL_DEVICE 0x00000002 /* device removed */
45daef0f
MD
111#define BUS_NOTIFY_BIND_DRIVER 0x00000003 /* driver about to be
112 bound */
113#define BUS_NOTIFY_BOUND_DRIVER 0x00000004 /* driver bound to device */
114#define BUS_NOTIFY_UNBIND_DRIVER 0x00000005 /* driver about to be
116af378 115 unbound */
45daef0f 116#define BUS_NOTIFY_UNBOUND_DRIVER 0x00000006 /* driver is unbound
309b7d60 117 from the device */
116af378 118
0fed80f7 119extern struct kset *bus_get_kset(struct bus_type *bus);
b249072e 120extern struct klist *bus_get_device_klist(struct bus_type *bus);
0fed80f7 121
1da177e4 122struct device_driver {
e5dd1278
GKH
123 const char *name;
124 struct bus_type *bus;
1da177e4 125
e5dd1278 126 struct module *owner;
1a6f2a75
DT
127 const char *mod_name; /* used for built-in modules */
128
129 bool suppress_bind_attrs; /* disables bind/unbind via sysfs */
1da177e4 130
597b9d1e 131 const struct of_device_id *of_match_table;
597b9d1e 132
d462943a
GKH
133 int (*probe) (struct device *dev);
134 int (*remove) (struct device *dev);
135 void (*shutdown) (struct device *dev);
136 int (*suspend) (struct device *dev, pm_message_t state);
137 int (*resume) (struct device *dev);
a4dbd674 138 const struct attribute_group **groups;
e5dd1278 139
8150f32b 140 const struct dev_pm_ops *pm;
1eede070 141
e5dd1278 142 struct driver_private *p;
1da177e4
LT
143};
144
145
d462943a
GKH
146extern int __must_check driver_register(struct device_driver *drv);
147extern void driver_unregister(struct device_driver *drv);
1da177e4 148
d462943a
GKH
149extern struct device_driver *get_driver(struct device_driver *drv);
150extern void put_driver(struct device_driver *drv);
151extern struct device_driver *driver_find(const char *name,
152 struct bus_type *bus);
d779249e 153extern int driver_probe_done(void);
b23530eb 154extern void wait_for_device_probe(void);
216773a7 155
1da177e4 156
405ae7d3 157/* sysfs interface for exporting driver attributes */
1da177e4
LT
158
159struct driver_attribute {
d462943a
GKH
160 struct attribute attr;
161 ssize_t (*show)(struct device_driver *driver, char *buf);
162 ssize_t (*store)(struct device_driver *driver, const char *buf,
163 size_t count);
1da177e4
LT
164};
165
d462943a
GKH
166#define DRIVER_ATTR(_name, _mode, _show, _store) \
167struct driver_attribute driver_attr_##_name = \
168 __ATTR(_name, _mode, _show, _store)
1da177e4 169
d462943a 170extern int __must_check driver_create_file(struct device_driver *driver,
099c2f21 171 const struct driver_attribute *attr);
d462943a 172extern void driver_remove_file(struct device_driver *driver,
099c2f21 173 const struct driver_attribute *attr);
1da177e4 174
cbe9c595
GKH
175extern int __must_check driver_add_kobj(struct device_driver *drv,
176 struct kobject *kobj,
177 const char *fmt, ...);
178
d462943a
GKH
179extern int __must_check driver_for_each_device(struct device_driver *drv,
180 struct device *start,
181 void *data,
182 int (*fn)(struct device *dev,
183 void *));
184struct device *driver_find_device(struct device_driver *drv,
185 struct device *start, void *data,
186 int (*match)(struct device *dev, void *data));
fae3cd00 187
1da177e4
LT
188/*
189 * device classes
190 */
191struct class {
d462943a
GKH
192 const char *name;
193 struct module *owner;
1da177e4 194
d462943a 195 struct class_attribute *class_attrs;
d462943a 196 struct device_attribute *dev_attrs;
c97415a7 197 struct bin_attribute *dev_bin_attrs;
e105b8bf 198 struct kobject *dev_kobj;
1da177e4 199
d462943a 200 int (*dev_uevent)(struct device *dev, struct kobj_uevent_env *env);
e454cea2 201 char *(*devnode)(struct device *dev, mode_t *mode);
1da177e4 202
d462943a
GKH
203 void (*class_release)(struct class *class);
204 void (*dev_release)(struct device *dev);
7c8265f5 205
d462943a
GKH
206 int (*suspend)(struct device *dev, pm_message_t state);
207 int (*resume)(struct device *dev);
1eede070 208
bc451f20
EB
209 const struct kobj_ns_type_operations *ns_type;
210 const void *(*namespace)(struct device *dev);
211
8150f32b
DT
212 const struct dev_pm_ops *pm;
213
6b6e39a6 214 struct subsys_private *p;
1da177e4
LT
215};
216
5a3ceb86
TH
217struct class_dev_iter {
218 struct klist_iter ki;
219 const struct device_type *type;
220};
221
e105b8bf
DW
222extern struct kobject *sysfs_dev_block_kobj;
223extern struct kobject *sysfs_dev_char_kobj;
d2a3b914
MW
224extern int __must_check __class_register(struct class *class,
225 struct lock_class_key *key);
d462943a 226extern void class_unregister(struct class *class);
d2a3b914
MW
227
228/* This is a #define to keep the compiler from merging different
229 * instances of the __key variable */
230#define class_register(class) \
231({ \
232 static struct lock_class_key __key; \
233 __class_register(class, &__key); \
234})
235
46227094
JD
236struct class_compat;
237struct class_compat *class_compat_register(const char *name);
238void class_compat_unregister(struct class_compat *cls);
239int class_compat_create_link(struct class_compat *cls, struct device *dev,
240 struct device *device_link);
241void class_compat_remove_link(struct class_compat *cls, struct device *dev,
242 struct device *device_link);
243
5a3ceb86
TH
244extern void class_dev_iter_init(struct class_dev_iter *iter,
245 struct class *class,
246 struct device *start,
247 const struct device_type *type);
248extern struct device *class_dev_iter_next(struct class_dev_iter *iter);
249extern void class_dev_iter_exit(struct class_dev_iter *iter);
250
93562b53
GKH
251extern int class_for_each_device(struct class *class, struct device *start,
252 void *data,
fd04897b 253 int (*fn)(struct device *dev, void *data));
695794ae
GKH
254extern struct device *class_find_device(struct class *class,
255 struct device *start, void *data,
fd04897b 256 int (*match)(struct device *, void *));
1da177e4
LT
257
258struct class_attribute {
d462943a 259 struct attribute attr;
28812fe1
AK
260 ssize_t (*show)(struct class *class, struct class_attribute *attr,
261 char *buf);
262 ssize_t (*store)(struct class *class, struct class_attribute *attr,
263 const char *buf, size_t count);
1da177e4
LT
264};
265
d462943a
GKH
266#define CLASS_ATTR(_name, _mode, _show, _store) \
267struct class_attribute class_attr_##_name = __ATTR(_name, _mode, _show, _store)
1da177e4 268
d462943a
GKH
269extern int __must_check class_create_file(struct class *class,
270 const struct class_attribute *attr);
271extern void class_remove_file(struct class *class,
272 const struct class_attribute *attr);
1da177e4 273
869dfc87
AK
274/* Simple class attribute that is just a static string */
275
276struct class_attribute_string {
277 struct class_attribute attr;
278 char *str;
279};
280
281/* Currently read-only only */
282#define _CLASS_ATTR_STRING(_name, _mode, _str) \
283 { __ATTR(_name, _mode, show_class_attr_string, NULL), _str }
284#define CLASS_ATTR_STRING(_name, _mode, _str) \
285 struct class_attribute_string class_attr_##_name = \
286 _CLASS_ATTR_STRING(_name, _mode, _str)
287
288extern ssize_t show_class_attr_string(struct class *class, struct class_attribute *attr,
289 char *buf);
290
1da177e4
LT
291struct class_interface {
292 struct list_head node;
293 struct class *class;
294
c47ed219
GKH
295 int (*add_dev) (struct device *, struct class_interface *);
296 void (*remove_dev) (struct device *, struct class_interface *);
1da177e4
LT
297};
298
4a7fb636 299extern int __must_check class_interface_register(struct class_interface *);
1da177e4
LT
300extern void class_interface_unregister(struct class_interface *);
301
d2a3b914
MW
302extern struct class * __must_check __class_create(struct module *owner,
303 const char *name,
304 struct lock_class_key *key);
e9ba6365 305extern void class_destroy(struct class *cls);
e9ba6365 306
d2a3b914
MW
307/* This is a #define to keep the compiler from merging different
308 * instances of the __key variable */
309#define class_create(owner, name) \
310({ \
311 static struct lock_class_key __key; \
312 __class_create(owner, name, &__key); \
313})
314
414264f9
KS
315/*
316 * The type of device, "struct device" is embedded in. A class
317 * or bus can contain devices of different types
318 * like "partitions" and "disks", "mouse" and "event".
319 * This identifies the device type and carries type-specific
320 * information, equivalent to the kobj_type of a kobject.
321 * If "name" is specified, the uevent will contain it in
322 * the DEVTYPE variable.
323 */
f9f852df 324struct device_type {
414264f9 325 const char *name;
a4dbd674 326 const struct attribute_group **groups;
7eff2e7a 327 int (*uevent)(struct device *dev, struct kobj_uevent_env *env);
e454cea2 328 char *(*devnode)(struct device *dev, mode_t *mode);
f9f852df 329 void (*release)(struct device *dev);
1eede070 330
8150f32b 331 const struct dev_pm_ops *pm;
f9f852df
KS
332};
333
a7fd6706
KS
334/* interface for exporting device attributes */
335struct device_attribute {
336 struct attribute attr;
337 ssize_t (*show)(struct device *dev, struct device_attribute *attr,
338 char *buf);
339 ssize_t (*store)(struct device *dev, struct device_attribute *attr,
340 const char *buf, size_t count);
341};
342
d462943a
GKH
343#define DEVICE_ATTR(_name, _mode, _show, _store) \
344struct device_attribute dev_attr_##_name = __ATTR(_name, _mode, _show, _store)
a7fd6706 345
4a7fb636 346extern int __must_check device_create_file(struct device *device,
66ecb92b 347 const struct device_attribute *entry);
d462943a 348extern void device_remove_file(struct device *dev,
26579ab7 349 const struct device_attribute *attr);
2589f188 350extern int __must_check device_create_bin_file(struct device *dev,
66ecb92b 351 const struct bin_attribute *attr);
2589f188 352extern void device_remove_bin_file(struct device *dev,
66ecb92b 353 const struct bin_attribute *attr);
523ded71 354extern int device_schedule_callback_owner(struct device *dev,
d462943a 355 void (*func)(struct device *dev), struct module *owner);
523ded71
AS
356
357/* This is a macro to avoid include problems with THIS_MODULE */
358#define device_schedule_callback(dev, func) \
359 device_schedule_callback_owner(dev, func, THIS_MODULE)
9ac7849e
TH
360
361/* device resource management */
362typedef void (*dr_release_t)(struct device *dev, void *res);
363typedef int (*dr_match_t)(struct device *dev, void *res, void *match_data);
364
365#ifdef CONFIG_DEBUG_DEVRES
d462943a 366extern void *__devres_alloc(dr_release_t release, size_t size, gfp_t gfp,
9ac7849e
TH
367 const char *name);
368#define devres_alloc(release, size, gfp) \
369 __devres_alloc(release, size, gfp, #release)
370#else
d462943a 371extern void *devres_alloc(dr_release_t release, size_t size, gfp_t gfp);
9ac7849e
TH
372#endif
373extern void devres_free(void *res);
374extern void devres_add(struct device *dev, void *res);
d462943a 375extern void *devres_find(struct device *dev, dr_release_t release,
9ac7849e 376 dr_match_t match, void *match_data);
d462943a
GKH
377extern void *devres_get(struct device *dev, void *new_res,
378 dr_match_t match, void *match_data);
379extern void *devres_remove(struct device *dev, dr_release_t release,
380 dr_match_t match, void *match_data);
9ac7849e
TH
381extern int devres_destroy(struct device *dev, dr_release_t release,
382 dr_match_t match, void *match_data);
383
384/* devres group */
385extern void * __must_check devres_open_group(struct device *dev, void *id,
386 gfp_t gfp);
387extern void devres_close_group(struct device *dev, void *id);
388extern void devres_remove_group(struct device *dev, void *id);
389extern int devres_release_group(struct device *dev, void *id);
390
391/* managed kzalloc/kfree for device drivers, no kmalloc, always use kzalloc */
392extern void *devm_kzalloc(struct device *dev, size_t size, gfp_t gfp);
393extern void devm_kfree(struct device *dev, void *p);
394
6b7b6510
FT
395struct device_dma_parameters {
396 /*
397 * a low level driver may set these to teach IOMMU code about
398 * sg limitations.
399 */
400 unsigned int max_segment_size;
401 unsigned long segment_boundary_mask;
402};
403
1da177e4 404struct device {
49a4ec18 405 struct device *parent;
1da177e4 406
fb069a5d
GKH
407 struct device_private *p;
408
1da177e4 409 struct kobject kobj;
c906a48a 410 const char *init_name; /* initial name of the device */
aed65af1 411 const struct device_type *type;
1da177e4 412
3142788b 413 struct mutex mutex; /* mutex to synchronize calls to
af70316a 414 * its driver.
415 */
416
d462943a 417 struct bus_type *bus; /* type of bus device is on */
1da177e4
LT
418 struct device_driver *driver; /* which driver has allocated this
419 device */
e67c8562
GKH
420 void *platform_data; /* Platform specific data, device
421 core doesn't touch it */
1da177e4 422 struct dev_pm_info power;
7538e3db 423 struct dev_power_domain *pwr_domain;
1da177e4 424
87348136
CH
425#ifdef CONFIG_NUMA
426 int numa_node; /* NUMA node this device is close to */
427#endif
1da177e4
LT
428 u64 *dma_mask; /* dma mask (if dma'able device) */
429 u64 coherent_dma_mask;/* Like dma_mask, but for
430 alloc_coherent mappings as
431 not all hardware supports
432 64 bit addresses for consistent
433 allocations such descriptors. */
434
6b7b6510
FT
435 struct device_dma_parameters *dma_parms;
436
1da177e4
LT
437 struct list_head dma_pools; /* dma pools (if dma'ble) */
438
439 struct dma_coherent_mem *dma_mem; /* internal for coherent mem
440 override */
c6dbaef2
BH
441 /* arch specific additions */
442 struct dev_archdata archdata;
c9e358df
GL
443
444 struct device_node *of_node; /* associated device tree node */
b826291c 445 const struct of_device_id *of_match; /* matching of_device_id from driver */
1da177e4 446
929d2fa5
MW
447 dev_t devt; /* dev_t, creates the sysfs "dev" */
448
9ac7849e
TH
449 spinlock_t devres_lock;
450 struct list_head devres_head;
451
5a3ceb86 452 struct klist_node knode_class;
b7a3e813 453 struct class *class;
a4dbd674 454 const struct attribute_group **groups; /* optional groups */
23681e47 455
d462943a 456 void (*release)(struct device *dev);
1da177e4
LT
457};
458
9a3df1f7
AS
459/* Get the wakeup routines, which depend on struct device */
460#include <linux/pm_wakeup.h>
461
bf9ca69f 462static inline const char *dev_name(const struct device *dev)
06916639 463{
a636ee7f
PM
464 /* Use the init name until the kobject becomes available */
465 if (dev->init_name)
466 return dev->init_name;
467
1fa5ae85 468 return kobject_name(&dev->kobj);
06916639
KS
469}
470
413c239f
SR
471extern int dev_set_name(struct device *dev, const char *name, ...)
472 __attribute__((format(printf, 2, 3)));
473
87348136
CH
474#ifdef CONFIG_NUMA
475static inline int dev_to_node(struct device *dev)
476{
477 return dev->numa_node;
478}
479static inline void set_dev_node(struct device *dev, int node)
480{
481 dev->numa_node = node;
482}
483#else
484static inline int dev_to_node(struct device *dev)
485{
486 return -1;
487}
488static inline void set_dev_node(struct device *dev, int node)
489{
490}
491#endif
492
f67f129e
ML
493static inline unsigned int dev_get_uevent_suppress(const struct device *dev)
494{
495 return dev->kobj.uevent_suppress;
496}
497
498static inline void dev_set_uevent_suppress(struct device *dev, int val)
499{
500 dev->kobj.uevent_suppress = val;
501}
502
d305ef5d
DR
503static inline int device_is_registered(struct device *dev)
504{
3f62e570 505 return dev->kobj.state_in_sysfs;
d305ef5d
DR
506}
507
5af84b82
RW
508static inline void device_enable_async_suspend(struct device *dev)
509{
b8c76f6a 510 if (!dev->power.in_suspend)
5af84b82
RW
511 dev->power.async_suspend = true;
512}
513
5a2eb858
RW
514static inline void device_disable_async_suspend(struct device *dev)
515{
b8c76f6a 516 if (!dev->power.in_suspend)
5a2eb858
RW
517 dev->power.async_suspend = false;
518}
519
520static inline bool device_async_suspend_enabled(struct device *dev)
521{
522 return !!dev->power.async_suspend;
523}
524
8e9394ce
GKH
525static inline void device_lock(struct device *dev)
526{
3142788b 527 mutex_lock(&dev->mutex);
8e9394ce
GKH
528}
529
530static inline int device_trylock(struct device *dev)
531{
3142788b 532 return mutex_trylock(&dev->mutex);
8e9394ce
GKH
533}
534
535static inline void device_unlock(struct device *dev)
536{
3142788b 537 mutex_unlock(&dev->mutex);
8e9394ce
GKH
538}
539
1f21782e
AB
540void driver_init(void);
541
1da177e4
LT
542/*
543 * High level routines for use by the bus drivers
544 */
d462943a
GKH
545extern int __must_check device_register(struct device *dev);
546extern void device_unregister(struct device *dev);
547extern void device_initialize(struct device *dev);
548extern int __must_check device_add(struct device *dev);
549extern void device_del(struct device *dev);
550extern int device_for_each_child(struct device *dev, void *data,
551 int (*fn)(struct device *dev, void *data));
552extern struct device *device_find_child(struct device *dev, void *data,
553 int (*match)(struct device *dev, void *data));
6937e8f8 554extern int device_rename(struct device *dev, const char *new_name);
ffa6a705
CH
555extern int device_move(struct device *dev, struct device *new_parent,
556 enum dpm_order dpm_order);
e454cea2
KS
557extern const char *device_get_devnode(struct device *dev,
558 mode_t *mode, const char **tmp);
b4028437
GKH
559extern void *dev_get_drvdata(const struct device *dev);
560extern void dev_set_drvdata(struct device *dev, void *data);
1da177e4 561
0aa0dc41
MM
562/*
563 * Root device objects for grouping under /sys/devices
564 */
565extern struct device *__root_device_register(const char *name,
566 struct module *owner);
567static inline struct device *root_device_register(const char *name)
568{
569 return __root_device_register(name, THIS_MODULE);
570}
571extern void root_device_unregister(struct device *root);
572
a5b8b1ad
MB
573static inline void *dev_get_platdata(const struct device *dev)
574{
575 return dev->platform_data;
576}
577
1da177e4
LT
578/*
579 * Manual binding of a device to driver. See drivers/base/bus.c
580 * for information on use.
581 */
f86db396 582extern int __must_check device_bind_driver(struct device *dev);
d462943a
GKH
583extern void device_release_driver(struct device *dev);
584extern int __must_check device_attach(struct device *dev);
f86db396
AM
585extern int __must_check driver_attach(struct device_driver *drv);
586extern int __must_check device_reprobe(struct device *dev);
1da177e4 587
23681e47
GKH
588/*
589 * Easy functions for dynamically creating devices on the fly
590 */
8882b394
GKH
591extern struct device *device_create_vargs(struct class *cls,
592 struct device *parent,
593 dev_t devt,
594 void *drvdata,
595 const char *fmt,
596 va_list vargs);
4e106739
GKH
597extern struct device *device_create(struct class *cls, struct device *parent,
598 dev_t devt, void *drvdata,
599 const char *fmt, ...)
8882b394 600 __attribute__((format(printf, 5, 6)));
23681e47 601extern void device_destroy(struct class *cls, dev_t devt);
1da177e4 602
1da177e4
LT
603/*
604 * Platform "fixup" functions - allow the platform to have their say
605 * about devices and actions that the general device layer doesn't
606 * know about.
607 */
608/* Notify platform of device discovery */
d462943a 609extern int (*platform_notify)(struct device *dev);
1da177e4 610
d462943a 611extern int (*platform_notify_remove)(struct device *dev);
1da177e4
LT
612
613
614/**
615 * get_device - atomically increment the reference count for the device.
616 *
617 */
d462943a
GKH
618extern struct device *get_device(struct device *dev);
619extern void put_device(struct device *dev);
1da177e4 620
d4d5291c 621extern void wait_for_device_probe(void);
1da177e4 622
2b2af54a
KS
623#ifdef CONFIG_DEVTMPFS
624extern int devtmpfs_create_node(struct device *dev);
625extern int devtmpfs_delete_node(struct device *dev);
073120cc 626extern int devtmpfs_mount(const char *mntdir);
2b2af54a
KS
627#else
628static inline int devtmpfs_create_node(struct device *dev) { return 0; }
629static inline int devtmpfs_delete_node(struct device *dev) { return 0; }
630static inline int devtmpfs_mount(const char *mountpoint) { return 0; }
631#endif
632
116f232b 633/* drivers/base/power/shutdown.c */
1da177e4
LT
634extern void device_shutdown(void);
635
d47d81c0 636#ifndef CONFIG_ARCH_NO_SYSDEV_OPS
58b3b71d
RW
637/* drivers/base/sys.c */
638extern void sysdev_shutdown(void);
d47d81c0
RW
639#else
640static inline void sysdev_shutdown(void) { }
641#endif
58b3b71d 642
1da177e4 643/* debugging and troubleshooting/diagnostic helpers. */
bf9ca69f 644extern const char *dev_driver_string(const struct device *dev);
99bcf217
JP
645
646
647#ifdef CONFIG_PRINTK
648
649extern int dev_printk(const char *level, const struct device *dev,
650 const char *fmt, ...)
651 __attribute__ ((format (printf, 3, 4)));
652extern int dev_emerg(const struct device *dev, const char *fmt, ...)
653 __attribute__ ((format (printf, 2, 3)));
654extern int dev_alert(const struct device *dev, const char *fmt, ...)
655 __attribute__ ((format (printf, 2, 3)));
656extern int dev_crit(const struct device *dev, const char *fmt, ...)
657 __attribute__ ((format (printf, 2, 3)));
658extern int dev_err(const struct device *dev, const char *fmt, ...)
659 __attribute__ ((format (printf, 2, 3)));
660extern int dev_warn(const struct device *dev, const char *fmt, ...)
661 __attribute__ ((format (printf, 2, 3)));
662extern int dev_notice(const struct device *dev, const char *fmt, ...)
663 __attribute__ ((format (printf, 2, 3)));
664extern int _dev_info(const struct device *dev, const char *fmt, ...)
665 __attribute__ ((format (printf, 2, 3)));
666
667#else
668
669static inline int dev_printk(const char *level, const struct device *dev,
670 const char *fmt, ...)
671 __attribute__ ((format (printf, 3, 4)));
672static inline int dev_printk(const char *level, const struct device *dev,
673 const char *fmt, ...)
674 { return 0; }
675
676static inline int dev_emerg(const struct device *dev, const char *fmt, ...)
677 __attribute__ ((format (printf, 2, 3)));
678static inline int dev_emerg(const struct device *dev, const char *fmt, ...)
679 { return 0; }
680static inline int dev_crit(const struct device *dev, const char *fmt, ...)
681 __attribute__ ((format (printf, 2, 3)));
682static inline int dev_crit(const struct device *dev, const char *fmt, ...)
683 { return 0; }
684static inline int dev_alert(const struct device *dev, const char *fmt, ...)
685 __attribute__ ((format (printf, 2, 3)));
686static inline int dev_alert(const struct device *dev, const char *fmt, ...)
687 { return 0; }
688static inline int dev_err(const struct device *dev, const char *fmt, ...)
689 __attribute__ ((format (printf, 2, 3)));
690static inline int dev_err(const struct device *dev, const char *fmt, ...)
691 { return 0; }
692static inline int dev_warn(const struct device *dev, const char *fmt, ...)
693 __attribute__ ((format (printf, 2, 3)));
694static inline int dev_warn(const struct device *dev, const char *fmt, ...)
695 { return 0; }
696static inline int dev_notice(const struct device *dev, const char *fmt, ...)
697 __attribute__ ((format (printf, 2, 3)));
698static inline int dev_notice(const struct device *dev, const char *fmt, ...)
699 { return 0; }
700static inline int _dev_info(const struct device *dev, const char *fmt, ...)
701 __attribute__ ((format (printf, 2, 3)));
702static inline int _dev_info(const struct device *dev, const char *fmt, ...)
703 { return 0; }
704
705#endif
706
707/*
708 * Stupid hackaround for existing uses of non-printk uses dev_info
709 *
710 * Note that the definition of dev_info below is actually _dev_info
711 * and a macro is used to avoid redefining dev_info
712 */
713
714#define dev_info(dev, fmt, arg...) _dev_info(dev, fmt, ##arg)
7b8712e5 715
d0d85ff9
CH
716#if defined(DEBUG)
717#define dev_dbg(dev, format, arg...) \
99bcf217 718 dev_printk(KERN_DEBUG, dev, format, ##arg)
e9d376f0 719#elif defined(CONFIG_DYNAMIC_DEBUG)
99bcf217
JP
720#define dev_dbg(dev, format, ...) \
721do { \
346e15be 722 dynamic_dev_dbg(dev, format, ##__VA_ARGS__); \
99bcf217 723} while (0)
1da177e4 724#else
99bcf217
JP
725#define dev_dbg(dev, format, arg...) \
726({ \
727 if (0) \
728 dev_printk(KERN_DEBUG, dev, format, ##arg); \
729 0; \
730})
1da177e4
LT
731#endif
732
aebdc3b4
DB
733#ifdef VERBOSE_DEBUG
734#define dev_vdbg dev_dbg
735#else
99bcf217
JP
736#define dev_vdbg(dev, format, arg...) \
737({ \
738 if (0) \
739 dev_printk(KERN_DEBUG, dev, format, ##arg); \
740 0; \
741})
aebdc3b4
DB
742#endif
743
e6139662 744/*
bcdd323b 745 * dev_WARN*() acts like dev_printk(), but with the key difference
e6139662
AV
746 * of using a WARN/WARN_ON to get the message out, including the
747 * file/line information and a backtrace.
748 */
749#define dev_WARN(dev, format, arg...) \
750 WARN(1, "Device: %s\n" format, dev_driver_string(dev), ## arg);
751
bcdd323b
FB
752#define dev_WARN_ONCE(dev, condition, format, arg...) \
753 WARN_ONCE(condition, "Device %s\n" format, \
754 dev_driver_string(dev), ## arg)
755
1da177e4
LT
756/* Create alias, so I can be autoloaded. */
757#define MODULE_ALIAS_CHARDEV(major,minor) \
758 MODULE_ALIAS("char-major-" __stringify(major) "-" __stringify(minor))
759#define MODULE_ALIAS_CHARDEV_MAJOR(major) \
760 MODULE_ALIAS("char-major-" __stringify(major) "-*")
e52eec13
AK
761
762#ifdef CONFIG_SYSFS_DEPRECATED
763extern long sysfs_deprecated;
764#else
765#define sysfs_deprecated 0
766#endif
767
1da177e4 768#endif /* _DEVICE_H_ */
This page took 0.820285 seconds and 5 git commands to generate.