[deliverable/linux.git] / include / linux / device.h

/*
 * device.h - generic, centralized driver model
 *
 * Copyright (c) 2001-2003 Patrick Mochel <mochel@osdl.org>
 *
 * This file is released under the GPLv2
 *
 * See Documentation/driver-model/ for more information.
 */

#ifndef _DEVICE_H_
#define _DEVICE_H_

#include <linux/config.h>
#include <linux/ioport.h>
#include <linux/kobject.h>
#include <linux/klist.h>
#include <linux/list.h>
#include <linux/types.h>
#include <linux/module.h>
#include <linux/pm.h>
#include <asm/semaphore.h>
#include <asm/atomic.h>

#define DEVICE_NAME_SIZE	50
#define DEVICE_NAME_HALF	__stringify(20)	/* Less than half to accommodate slop */
#define DEVICE_ID_SIZE		32
#define BUS_ID_SIZE		KOBJ_NAME_LEN


enum {
	SUSPEND_NOTIFY,
	SUSPEND_SAVE_STATE,
	SUSPEND_DISABLE,
	SUSPEND_POWER_DOWN,
};

enum {
	RESUME_POWER_ON,
	RESUME_RESTORE_STATE,
	RESUME_ENABLE,
};

struct device;
struct device_driver;
struct class;
struct class_device;

struct bus_type {
	const char		* name;

	struct subsystem	subsys;
	struct kset		drivers;
	struct kset		devices;
	struct klist		klist_devices;
	struct klist		klist_drivers;

	struct bus_attribute	* bus_attrs;
	struct device_attribute	* dev_attrs;
	struct driver_attribute	* drv_attrs;

	int		(*match)(struct device * dev, struct device_driver * drv);
	int		(*hotplug) (struct device *dev, char **envp, 
				    int num_envp, char *buffer, int buffer_size);
	int		(*suspend)(struct device * dev, pm_message_t state);
	int		(*resume)(struct device * dev);
};

extern int bus_register(struct bus_type * bus);
extern void bus_unregister(struct bus_type * bus);

extern void bus_rescan_devices(struct bus_type * bus);

extern struct bus_type * get_bus(struct bus_type * bus);
extern void put_bus(struct bus_type * bus);

extern struct bus_type * find_bus(char * name);

/* iterator helpers for buses */

int bus_for_each_dev(struct bus_type * bus, struct device * start, void * data,
		     int (*fn)(struct device *, void *));
struct device * bus_find_device(struct bus_type *bus, struct device *start,
				void *data, int (*match)(struct device *, void *));

int bus_for_each_drv(struct bus_type * bus, struct device_driver * start, 
		     void * data, int (*fn)(struct device_driver *, void *));


/* driverfs interface for exporting bus attributes */

struct bus_attribute {
	struct attribute	attr;
	ssize_t (*show)(struct bus_type *, char * buf);
	ssize_t (*store)(struct bus_type *, const char * buf, size_t count);
};

#define BUS_ATTR(_name,_mode,_show,_store)	\
struct bus_attribute bus_attr_##_name = __ATTR(_name,_mode,_show,_store)

extern int bus_create_file(struct bus_type *, struct bus_attribute *);
extern void bus_remove_file(struct bus_type *, struct bus_attribute *);

struct device_driver {
	const char		* name;
	struct bus_type		* bus;

	struct completion	unloaded;
	struct kobject		kobj;
	struct klist		klist_devices;
	struct klist_node	knode_bus;

	struct module		* owner;

	int	(*probe)	(struct device * dev);
	int	(*remove)	(struct device * dev);
	void	(*shutdown)	(struct device * dev);
	int	(*suspend)	(struct device * dev, pm_message_t state, u32 level);
	int	(*resume)	(struct device * dev, u32 level);
};


extern int driver_register(struct device_driver * drv);
extern void driver_unregister(struct device_driver * drv);

extern struct device_driver * get_driver(struct device_driver * drv);
extern void put_driver(struct device_driver * drv);
extern struct device_driver *driver_find(const char *name, struct bus_type *bus);


/* driverfs interface for exporting driver attributes */

struct driver_attribute {
	struct attribute	attr;
	ssize_t (*show)(struct device_driver *, char * buf);
	ssize_t (*store)(struct device_driver *, const char * buf, size_t count);
};

#define DRIVER_ATTR(_name,_mode,_show,_store)	\
struct driver_attribute driver_attr_##_name = __ATTR(_name,_mode,_show,_store)

extern int driver_create_file(struct device_driver *, struct driver_attribute *);
extern void driver_remove_file(struct device_driver *, struct driver_attribute *);

extern int driver_for_each_device(struct device_driver * drv, struct device * start,
				  void * data, int (*fn)(struct device *, void *));
struct device * driver_find_device(struct device_driver *drv,
				   struct device *start, void *data,
				   int (*match)(struct device *, void *));


/*
 * device classes
 */
struct class {
	const char		* name;
	struct module		* owner;

	struct subsystem	subsys;
	struct list_head	children;
	struct list_head	interfaces;
	struct semaphore	sem;	/* locks both the children and interfaces lists */

	struct class_attribute		* class_attrs;
	struct class_device_attribute	* class_dev_attrs;

	int	(*hotplug)(struct class_device *dev, char **envp, 
			   int num_envp, char *buffer, int buffer_size);

	void	(*release)(struct class_device *dev);
	void	(*class_release)(struct class *class);
};

extern int class_register(struct class *);
extern void class_unregister(struct class *);

extern struct class * class_get(struct class *);
extern void class_put(struct class *);


struct class_attribute {
	struct attribute	attr;
	ssize_t (*show)(struct class *, char * buf);
	ssize_t (*store)(struct class *, const char * buf, size_t count);
};

#define CLASS_ATTR(_name,_mode,_show,_store)			\
struct class_attribute class_attr_##_name = __ATTR(_name,_mode,_show,_store) 

extern int class_create_file(struct class *, const struct class_attribute *);
extern void class_remove_file(struct class *, const struct class_attribute *);


struct class_device {
	struct list_head	node;

	struct kobject		kobj;
	struct class		* class;	/* required */
	dev_t			devt;		/* dev_t, creates the sysfs "dev" */
	struct class_device_attribute *devt_attr;
	struct device		* dev;		/* not necessary, but nice to have */
	void			* class_data;	/* class-specific data */

	char	class_id[BUS_ID_SIZE];	/* unique to this class */
};

static inline void *
class_get_devdata (struct class_device *dev)
{
	return dev->class_data;
}

static inline void
class_set_devdata (struct class_device *dev, void *data)
{
	dev->class_data = data;
}


extern int class_device_register(struct class_device *);
extern void class_device_unregister(struct class_device *);
extern void class_device_initialize(struct class_device *);
extern int class_device_add(struct class_device *);
extern void class_device_del(struct class_device *);

extern int class_device_rename(struct class_device *, char *);

extern struct class_device * class_device_get(struct class_device *);
extern void class_device_put(struct class_device *);

struct class_device_attribute {
	struct attribute	attr;
	ssize_t (*show)(struct class_device *, char * buf);
	ssize_t (*store)(struct class_device *, const char * buf, size_t count);
};

#define CLASS_DEVICE_ATTR(_name,_mode,_show,_store)		\
struct class_device_attribute class_device_attr_##_name = 	\
	__ATTR(_name,_mode,_show,_store)

extern int class_device_create_file(struct class_device *, 
				    const struct class_device_attribute *);
extern void class_device_remove_file(struct class_device *, 
				     const struct class_device_attribute *);
extern int class_device_create_bin_file(struct class_device *,
					struct bin_attribute *);
extern void class_device_remove_bin_file(struct class_device *,
					 struct bin_attribute *);

struct class_interface {
	struct list_head	node;
	struct class		*class;

	int (*add)	(struct class_device *);
	void (*remove)	(struct class_device *);
};

extern int class_interface_register(struct class_interface *);
extern void class_interface_unregister(struct class_interface *);

extern struct class *class_create(struct module *owner, char *name);
extern void class_destroy(struct class *cls);
extern struct class_device *class_device_create(struct class *cls, dev_t devt,
						struct device *device, char *fmt, ...)
					__attribute__((format(printf,4,5)));
extern void class_device_destroy(struct class *cls, dev_t devt);


struct device {
	struct klist		klist_children;
	struct klist_node	knode_parent;		/* node in sibling list */
	struct klist_node	knode_driver;
	struct klist_node	knode_bus;
	struct device 	* parent;

	struct kobject kobj;
	char	bus_id[BUS_ID_SIZE];	/* position on parent bus */

	struct semaphore	sem;	/* semaphore to synchronize calls to
					 * its driver.
					 */

	struct bus_type	* bus;		/* type of bus device is on */
	struct device_driver *driver;	/* which driver has allocated this
					   device */
	void		*driver_data;	/* data private to the driver */
	void		*platform_data;	/* Platform specific data, device
					   core doesn't touch it */
	void		*firmware_data; /* Firmware specific data (e.g. ACPI,
					   BIOS data),reserved for device core*/
	struct dev_pm_info	power;

	u64		*dma_mask;	/* dma mask (if dma'able device) */
	u64		coherent_dma_mask;/* Like dma_mask, but for
					     alloc_coherent mappings as
					     not all hardware supports
					     64 bit addresses for consistent
					     allocations such descriptors. */

	struct list_head	dma_pools;	/* dma pools (if dma'ble) */

	struct dma_coherent_mem	*dma_mem; /* internal for coherent mem
					     override */

	void	(*release)(struct device * dev);
};

static inline void *
dev_get_drvdata (struct device *dev)
{
	return dev->driver_data;
}

static inline void
dev_set_drvdata (struct device *dev, void *data)
{
	dev->driver_data = data;
}

static inline int device_is_registered(struct device *dev)
{
	return klist_node_attached(&dev->knode_bus);
}

/*
 * High level routines for use by the bus drivers
 */
extern int device_register(struct device * dev);
extern void device_unregister(struct device * dev);
extern void device_initialize(struct device * dev);
extern int device_add(struct device * dev);
extern void device_del(struct device * dev);
extern int device_for_each_child(struct device *, void *,
		     int (*fn)(struct device *, void *));

/*
 * Manual binding of a device to driver. See drivers/base/bus.c
 * for information on use.
 */
extern void device_bind_driver(struct device * dev);
extern void device_release_driver(struct device * dev);
extern int  device_attach(struct device * dev);
extern void driver_attach(struct device_driver * drv);


/* driverfs interface for exporting device attributes */

struct device_attribute {
	struct attribute	attr;
	ssize_t (*show)(struct device *dev, struct device_attribute *attr,
			char *buf);
	ssize_t (*store)(struct device *dev, struct device_attribute *attr,
			 const char *buf, size_t count);
};

#define DEVICE_ATTR(_name,_mode,_show,_store) \
struct device_attribute dev_attr_##_name = __ATTR(_name,_mode,_show,_store)


extern int device_create_file(struct device *device, struct device_attribute * entry);
extern void device_remove_file(struct device * dev, struct device_attribute * attr);

/*
 * Platform "fixup" functions - allow the platform to have their say
 * about devices and actions that the general device layer doesn't
 * know about.
 */
/* Notify platform of device discovery */
extern int (*platform_notify)(struct device * dev);

extern int (*platform_notify_remove)(struct device * dev);


/**
 * get_device - atomically increment the reference count for the device.
 *
 */
extern struct device * get_device(struct device * dev);
extern void put_device(struct device * dev);


/* drivers/base/platform.c */

struct platform_device {
	const char	* name;
	u32		id;
	struct device	dev;
	u32		num_resources;
	struct resource	* resource;
};

#define to_platform_device(x) container_of((x), struct platform_device, dev)

extern int platform_device_register(struct platform_device *);
extern void platform_device_unregister(struct platform_device *);

extern struct bus_type platform_bus_type;
extern struct device platform_bus;

extern struct resource *platform_get_resource(struct platform_device *, unsigned int, unsigned int);
extern int platform_get_irq(struct platform_device *, unsigned int);
extern struct resource *platform_get_resource_byname(struct platform_device *, unsigned int, char *);
extern int platform_get_irq_byname(struct platform_device *, char *);
extern int platform_add_devices(struct platform_device **, int);

extern struct platform_device *platform_device_register_simple(char *, unsigned int, struct resource *, unsigned int);

/* drivers/base/power.c */
extern void device_shutdown(void);


/* drivers/base/firmware.c */
extern int firmware_register(struct subsystem *);
extern void firmware_unregister(struct subsystem *);

/* debugging and troubleshooting/diagnostic helpers. */
#define dev_printk(level, dev, format, arg...)	\
	printk(level "%s %s: " format , (dev)->driver ? (dev)->driver->name : "" , (dev)->bus_id , ## arg)

#ifdef DEBUG
#define dev_dbg(dev, format, arg...)		\
	dev_printk(KERN_DEBUG , dev , format , ## arg)
#else
#define dev_dbg(dev, format, arg...) do { (void)(dev); } while (0)
#endif

#define dev_err(dev, format, arg...)		\
	dev_printk(KERN_ERR , dev , format , ## arg)
#define dev_info(dev, format, arg...)		\
	dev_printk(KERN_INFO , dev , format , ## arg)
#define dev_warn(dev, format, arg...)		\
	dev_printk(KERN_WARNING , dev , format , ## arg)

/* Create alias, so I can be autoloaded. */
#define MODULE_ALIAS_CHARDEV(major,minor) \
	MODULE_ALIAS("char-major-" __stringify(major) "-" __stringify(minor))
#define MODULE_ALIAS_CHARDEV_MAJOR(major) \
	MODULE_ALIAS("char-major-" __stringify(major) "-*")
#endif /* _DEVICE_H_ */
Commit	Line	Data
1da177e4 LT	1	/*
	2	* device.h - generic, centralized driver model
	3	*
	4	* Copyright (c) 2001-2003 Patrick Mochel <mochel@osdl.org>
	5	*
	6	* This file is released under the GPLv2
	7	*
	8	* See Documentation/driver-model/ for more information.
	9	*/
	10
	11	#ifndef _DEVICE_H_
	12	#define _DEVICE_H_
	13
	14	#include <linux/config.h>
	15	#include <linux/ioport.h>
	16	#include <linux/kobject.h>
465c7a3a	17	#include <linux/klist.h>
1da177e4 LT	18	#include <linux/list.h>
	19	#include <linux/types.h>
	20	#include <linux/module.h>
	21	#include <linux/pm.h>
	22	#include <asm/semaphore.h>
	23	#include <asm/atomic.h>
	24
	25	#define DEVICE_NAME_SIZE 50
	26	#define DEVICE_NAME_HALF __stringify(20) /* Less than half to accommodate slop */
	27	#define DEVICE_ID_SIZE 32
	28	#define BUS_ID_SIZE KOBJ_NAME_LEN
	29
	30
	31	enum {
	32	SUSPEND_NOTIFY,
	33	SUSPEND_SAVE_STATE,
	34	SUSPEND_DISABLE,
	35	SUSPEND_POWER_DOWN,
	36	};
	37
	38	enum {
	39	RESUME_POWER_ON,
	40	RESUME_RESTORE_STATE,
	41	RESUME_ENABLE,
	42	};
	43
	44	struct device;
	45	struct device_driver;
	46	struct class;
	47	struct class_device;
1da177e4 LT	48
1da177e4 LT	49	struct bus_type {
8d790d74	50	const char * name;
1da177e4 LT	51
	52	struct subsystem subsys;
	53	struct kset drivers;
	54	struct kset devices;
465c7a3a	55	struct klist klist_devices;
38fdac3c	56	struct klist klist_drivers;
1da177e4 LT	57
	58	struct bus_attribute * bus_attrs;
	59	struct device_attribute * dev_attrs;
	60	struct driver_attribute * drv_attrs;
	61
	62	int (match)(struct device dev, struct device_driver * drv);
	63	int (hotplug) (struct device dev, char **envp,
	64	int num_envp, char *buffer, int buffer_size);
	65	int (suspend)(struct device dev, pm_message_t state);
	66	int (resume)(struct device dev);
	67	};
	68
	69	extern int bus_register(struct bus_type * bus);
	70	extern void bus_unregister(struct bus_type * bus);
	71
23d3d602	72	extern void bus_rescan_devices(struct bus_type * bus);
1da177e4 LT	73
	74	extern struct bus_type * get_bus(struct bus_type * bus);
	75	extern void put_bus(struct bus_type * bus);
	76
	77	extern struct bus_type * find_bus(char * name);
	78
	79	/* iterator helpers for buses */
	80
	81	int bus_for_each_dev(struct bus_type * bus, struct device * start, void * data,
	82	int (fn)(struct device , void *));
0edb5860 CH	83	struct device * bus_find_device(struct bus_type bus, struct device start,
0edb5860 CH	84	void data, int (match)(struct device , void ));
1da177e4 LT	85
	86	int bus_for_each_drv(struct bus_type * bus, struct device_driver * start,
	87	void * data, int (fn)(struct device_driver , void *));
	88
	89
	90	/* driverfs interface for exporting bus attributes */
	91
	92	struct bus_attribute {
	93	struct attribute attr;
	94	ssize_t (show)(struct bus_type , char * buf);
	95	ssize_t (store)(struct bus_type , const char * buf, size_t count);
	96	};
	97
	98	#define BUS_ATTR(_name,_mode,_show,_store) \
	99	struct bus_attribute bus_attr_##_name = __ATTR(_name,_mode,_show,_store)
	100
	101	extern int bus_create_file(struct bus_type , struct bus_attribute );
	102	extern void bus_remove_file(struct bus_type , struct bus_attribute );
	103
	104	struct device_driver {
8d790d74	105	const char * name;
1da177e4 LT	106	struct bus_type * bus;
	107
	108	struct completion unloaded;
	109	struct kobject kobj;
94e7b1c5	110	struct klist klist_devices;
38fdac3c	111	struct klist_node knode_bus;
1da177e4	112
8d790d74	113	struct module * owner;
1da177e4 LT	114
1da177e4 LT	115	int (probe) (struct device dev);
8d790d74	116	int (remove) (struct device dev);
1da177e4 LT	117	void (shutdown) (struct device dev);
	118	int (suspend) (struct device dev, pm_message_t state, u32 level);
	119	int (resume) (struct device dev, u32 level);
	120	};
	121
	122
	123	extern int driver_register(struct device_driver * drv);
	124	extern void driver_unregister(struct device_driver * drv);
	125
	126	extern struct device_driver * get_driver(struct device_driver * drv);
	127	extern void put_driver(struct device_driver * drv);
	128	extern struct device_driver driver_find(const char name, struct bus_type *bus);
	129
	130
	131	/* driverfs interface for exporting driver attributes */
	132
	133	struct driver_attribute {
	134	struct attribute attr;
	135	ssize_t (show)(struct device_driver , char * buf);
	136	ssize_t (store)(struct device_driver , const char * buf, size_t count);
	137	};
	138
	139	#define DRIVER_ATTR(_name,_mode,_show,_store) \
	140	struct driver_attribute driver_attr_##_name = __ATTR(_name,_mode,_show,_store)
	141
	142	extern int driver_create_file(struct device_driver , struct driver_attribute );
	143	extern void driver_remove_file(struct device_driver , struct driver_attribute );
	144
fae3cd00	145	extern int driver_for_each_device(struct device_driver * drv, struct device * start,
fae3cd00	146	void * data, int (fn)(struct device , void *));
0edb5860 CH	147	struct device * driver_find_device(struct device_driver *drv,
	148	struct device start, void data,
	149	int (match)(struct device , void *));
fae3cd00	150
1da177e4 LT	151
	152	/*
	153	* device classes
	154	*/
	155	struct class {
8d790d74	156	const char * name;
e9ba6365	157	struct module * owner;
1da177e4 LT	158
	159	struct subsystem subsys;
	160	struct list_head children;
	161	struct list_head interfaces;
	162	struct semaphore sem; /* locks both the children and interfaces lists */
	163
	164	struct class_attribute * class_attrs;
	165	struct class_device_attribute * class_dev_attrs;
	166
	167	int (hotplug)(struct class_device dev, char **envp,
	168	int num_envp, char *buffer, int buffer_size);
	169
	170	void (release)(struct class_device dev);
	171	void (class_release)(struct class class);
	172	};
	173
	174	extern int class_register(struct class *);
	175	extern void class_unregister(struct class *);
	176
	177	extern struct class * class_get(struct class *);
	178	extern void class_put(struct class *);
	179
	180
	181	struct class_attribute {
	182	struct attribute attr;
	183	ssize_t (show)(struct class , char * buf);
	184	ssize_t (store)(struct class , const char * buf, size_t count);
	185	};
	186
	187	#define CLASS_ATTR(_name,_mode,_show,_store) \
	188	struct class_attribute class_attr_##_name = __ATTR(_name,_mode,_show,_store)
	189
	190	extern int class_create_file(struct class , const struct class_attribute );
	191	extern void class_remove_file(struct class , const struct class_attribute );
	192
	193
	194	struct class_device {
	195	struct list_head node;
	196
	197	struct kobject kobj;
	198	struct class * class; /* required */
	199	dev_t devt; /* dev_t, creates the sysfs "dev" */
e9ba6365	200	struct class_device_attribute *devt_attr;
1da177e4 LT	201	struct device * dev; /* not necessary, but nice to have */
	202	void * class_data; /* class-specific data */
	203
	204	char class_id[BUS_ID_SIZE]; /* unique to this class */
	205	};
	206
	207	static inline void *
	208	class_get_devdata (struct class_device *dev)
	209	{
	210	return dev->class_data;
	211	}
	212
	213	static inline void
	214	class_set_devdata (struct class_device dev, void data)
	215	{
	216	dev->class_data = data;
	217	}
	218
	219
	220	extern int class_device_register(struct class_device *);
	221	extern void class_device_unregister(struct class_device *);
	222	extern void class_device_initialize(struct class_device *);
	223	extern int class_device_add(struct class_device *);
	224	extern void class_device_del(struct class_device *);
	225
	226	extern int class_device_rename(struct class_device , char );
	227
	228	extern struct class_device * class_device_get(struct class_device *);
	229	extern void class_device_put(struct class_device *);
	230
	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);
	235	};
	236
	237	#define CLASS_DEVICE_ATTR(_name,_mode,_show,_store) \
	238	struct class_device_attribute class_device_attr_##_name = \
	239	__ATTR(_name,_mode,_show,_store)
	240
	241	extern int class_device_create_file(struct class_device *,
	242	const struct class_device_attribute *);
	243	extern void class_device_remove_file(struct class_device *,
	244	const struct class_device_attribute *);
	245	extern int class_device_create_bin_file(struct class_device *,
	246	struct bin_attribute *);
	247	extern void class_device_remove_bin_file(struct class_device *,
	248	struct bin_attribute *);
	249
	250	struct class_interface {
	251	struct list_head node;
	252	struct class *class;
	253
	254	int (add) (struct class_device );
	255	void (remove) (struct class_device );
	256	};
	257
	258	extern int class_interface_register(struct class_interface *);
	259	extern void class_interface_unregister(struct class_interface *);
	260
e9ba6365	261	extern struct class class_create(struct module owner, char *name);
	262	extern void class_destroy(struct class *cls);
	263	extern struct class_device class_device_create(struct class cls, dev_t devt,
	264	struct device device, char fmt, ...)
	265	__attribute__((format(printf,4,5)));
	266	extern void class_device_destroy(struct class *cls, dev_t devt);
	267
1da177e4 LT	268
1da177e4 LT	269	struct device {
36239577	270	struct klist klist_children;
36239577	271	struct klist_node knode_parent; /* node in sibling list */
94e7b1c5	272	struct klist_node knode_driver;
465c7a3a	273	struct klist_node knode_bus;
1da177e4 LT	274	struct device * parent;
	275
	276	struct kobject kobj;
	277	char bus_id[BUS_ID_SIZE]; /* position on parent bus */
	278
af70316a	279	struct semaphore sem; /* semaphore to synchronize calls to
	280	* its driver.
	281	*/
	282
1da177e4 LT	283	struct bus_type * bus; /* type of bus device is on */
	284	struct device_driver driver; / which driver has allocated this
	285	device */
	286	void driver_data; / data private to the driver */
4e10d12a DSL	287	void platform_data; / Platform specific data, device
	288	core doesn't touch it */
	289	void firmware_data; / Firmware specific data (e.g. ACPI,
	290	BIOS data),reserved for device core*/
1da177e4 LT	291	struct dev_pm_info power;
1da177e4 LT	292
1da177e4 LT	293	u64 dma_mask; / dma mask (if dma'able device) */
	294	u64 coherent_dma_mask;/* Like dma_mask, but for
	295	alloc_coherent mappings as
	296	not all hardware supports
	297	64 bit addresses for consistent
	298	allocations such descriptors. */
	299
	300	struct list_head dma_pools; /* dma pools (if dma'ble) */
	301
	302	struct dma_coherent_mem dma_mem; / internal for coherent mem
	303	override */
	304
	305	void (release)(struct device dev);
	306	};
	307
1da177e4 LT	308	static inline void *
	309	dev_get_drvdata (struct device *dev)
	310	{
	311	return dev->driver_data;
	312	}
	313
	314	static inline void
	315	dev_set_drvdata (struct device dev, void data)
	316	{
	317	dev->driver_data = data;
	318	}
	319
d305ef5d DR	320	static inline int device_is_registered(struct device *dev)
	321	{
	322	return klist_node_attached(&dev->knode_bus);
	323	}
	324
1da177e4 LT	325	/*
	326	* High level routines for use by the bus drivers
	327	*/
	328	extern int device_register(struct device * dev);
	329	extern void device_unregister(struct device * dev);
	330	extern void device_initialize(struct device * dev);
	331	extern int device_add(struct device * dev);
	332	extern void device_del(struct device * dev);
	333	extern int device_for_each_child(struct device , void ,
	334	int (fn)(struct device , void *));
	335
	336	/*
	337	* Manual binding of a device to driver. See drivers/base/bus.c
	338	* for information on use.
	339	*/
1da177e4 LT	340	extern void device_bind_driver(struct device * dev);
	341	extern void device_release_driver(struct device * dev);
	342	extern int device_attach(struct device * dev);
	343	extern void driver_attach(struct device_driver * drv);
	344
	345
	346	/* driverfs interface for exporting device attributes */
	347
	348	struct device_attribute {
	349	struct attribute attr;
54b6f35c YI	350	ssize_t (show)(struct device dev, struct device_attribute *attr,
	351	char *buf);
	352	ssize_t (store)(struct device dev, struct device_attribute *attr,
	353	const char *buf, size_t count);
1da177e4 LT	354	};
	355
	356	#define DEVICE_ATTR(_name,_mode,_show,_store) \
	357	struct device_attribute dev_attr_##_name = __ATTR(_name,_mode,_show,_store)
	358
	359
	360	extern int device_create_file(struct device device, struct device_attribute entry);
	361	extern void device_remove_file(struct device * dev, struct device_attribute * attr);
	362
	363	/*
	364	* Platform "fixup" functions - allow the platform to have their say
	365	* about devices and actions that the general device layer doesn't
	366	* know about.
	367	*/
	368	/* Notify platform of device discovery */
	369	extern int (platform_notify)(struct device dev);
	370
	371	extern int (platform_notify_remove)(struct device dev);
	372
	373
	374	/**
	375	* get_device - atomically increment the reference count for the device.
	376	*
	377	*/
	378	extern struct device * get_device(struct device * dev);
	379	extern void put_device(struct device * dev);
1da177e4 LT	380
	381
	382	/* drivers/base/platform.c */
	383
	384	struct platform_device {
8d790d74	385	const char * name;
1da177e4 LT	386	u32 id;
	387	struct device dev;
	388	u32 num_resources;
	389	struct resource * resource;
	390	};
	391
	392	#define to_platform_device(x) container_of((x), struct platform_device, dev)
	393
	394	extern int platform_device_register(struct platform_device *);
	395	extern void platform_device_unregister(struct platform_device *);
	396
	397	extern struct bus_type platform_bus_type;
	398	extern struct device platform_bus;
	399
	400	extern struct resource platform_get_resource(struct platform_device , unsigned int, unsigned int);
	401	extern int platform_get_irq(struct platform_device *, unsigned int);
	402	extern struct resource platform_get_resource_byname(struct platform_device , unsigned int, char *);
	403	extern int platform_get_irq_byname(struct platform_device , char );
	404	extern int platform_add_devices(struct platform_device **, int);
	405
	406	extern struct platform_device platform_device_register_simple(char , unsigned int, struct resource *, unsigned int);
	407
	408	/* drivers/base/power.c */
	409	extern void device_shutdown(void);
	410
	411
	412	/* drivers/base/firmware.c */
	413	extern int firmware_register(struct subsystem *);
	414	extern void firmware_unregister(struct subsystem *);
	415
	416	/* debugging and troubleshooting/diagnostic helpers. */
	417	#define dev_printk(level, dev, format, arg...) \
	418	printk(level "%s %s: " format , (dev)->driver ? (dev)->driver->name : "" , (dev)->bus_id , ## arg)
	419
	420	#ifdef DEBUG
	421	#define dev_dbg(dev, format, arg...) \
	422	dev_printk(KERN_DEBUG , dev , format , ## arg)
	423	#else
	424	#define dev_dbg(dev, format, arg...) do { (void)(dev); } while (0)
	425	#endif
	426
	427	#define dev_err(dev, format, arg...) \
	428	dev_printk(KERN_ERR , dev , format , ## arg)
	429	#define dev_info(dev, format, arg...) \
	430	dev_printk(KERN_INFO , dev , format , ## arg)
	431	#define dev_warn(dev, format, arg...) \
	432	dev_printk(KERN_WARNING , dev , format , ## arg)
	433
	434	/* Create alias, so I can be autoloaded. */
	435	#define MODULE_ALIAS_CHARDEV(major,minor) \
	436	MODULE_ALIAS("char-major-" __stringify(major) "-" __stringify(minor))
	437	#define MODULE_ALIAS_CHARDEV_MAJOR(major) \
	438	MODULE_ALIAS("char-major-" __stringify(major) "-*")
	439	#endif /* _DEVICE_H_ */