[mirror_ubuntu-artful-kernel.git] / include / linux / watchdog.h

/*
 *	Generic watchdog defines. Derived from..
 *
 * Berkshire PC Watchdog Defines
 * by Ken Hollis <khollis@bitgate.com>
 *
 */

#ifndef _LINUX_WATCHDOG_H
#define _LINUX_WATCHDOG_H

#include <linux/ioctl.h>
#include <linux/types.h>

#define	WATCHDOG_IOCTL_BASE	'W'

struct watchdog_info {
	__u32 options;		/* Options the card/driver supports */
	__u32 firmware_version;	/* Firmware version of the card */
	__u8  identity[32];	/* Identity of the board */
};

#define	WDIOC_GETSUPPORT	_IOR(WATCHDOG_IOCTL_BASE, 0, struct watchdog_info)
#define	WDIOC_GETSTATUS		_IOR(WATCHDOG_IOCTL_BASE, 1, int)
#define	WDIOC_GETBOOTSTATUS	_IOR(WATCHDOG_IOCTL_BASE, 2, int)
#define	WDIOC_GETTEMP		_IOR(WATCHDOG_IOCTL_BASE, 3, int)
#define	WDIOC_SETOPTIONS	_IOR(WATCHDOG_IOCTL_BASE, 4, int)
#define	WDIOC_KEEPALIVE		_IOR(WATCHDOG_IOCTL_BASE, 5, int)
#define	WDIOC_SETTIMEOUT        _IOWR(WATCHDOG_IOCTL_BASE, 6, int)
#define	WDIOC_GETTIMEOUT        _IOR(WATCHDOG_IOCTL_BASE, 7, int)
#define	WDIOC_SETPRETIMEOUT	_IOWR(WATCHDOG_IOCTL_BASE, 8, int)
#define	WDIOC_GETPRETIMEOUT	_IOR(WATCHDOG_IOCTL_BASE, 9, int)
#define	WDIOC_GETTIMELEFT	_IOR(WATCHDOG_IOCTL_BASE, 10, int)

#define	WDIOF_UNKNOWN		-1	/* Unknown flag error */
#define	WDIOS_UNKNOWN		-1	/* Unknown status error */

#define	WDIOF_OVERHEAT		0x0001	/* Reset due to CPU overheat */
#define	WDIOF_FANFAULT		0x0002	/* Fan failed */
#define	WDIOF_EXTERN1		0x0004	/* External relay 1 */
#define	WDIOF_EXTERN2		0x0008	/* External relay 2 */
#define	WDIOF_POWERUNDER	0x0010	/* Power bad/power fault */
#define	WDIOF_CARDRESET		0x0020	/* Card previously reset the CPU */
#define	WDIOF_POWEROVER		0x0040	/* Power over voltage */
#define	WDIOF_SETTIMEOUT	0x0080  /* Set timeout (in seconds) */
#define	WDIOF_MAGICCLOSE	0x0100	/* Supports magic close char */
#define	WDIOF_PRETIMEOUT	0x0200  /* Pretimeout (in seconds), get/set */
#define	WDIOF_ALARMONLY		0x0400	/* Watchdog triggers a management or
					   other external alarm not a reboot */
#define	WDIOF_KEEPALIVEPING	0x8000	/* Keep alive ping reply */

#define	WDIOS_DISABLECARD	0x0001	/* Turn off the watchdog timer */
#define	WDIOS_ENABLECARD	0x0002	/* Turn on the watchdog timer */
#define	WDIOS_TEMPPANIC		0x0004	/* Kernel panic on temperature trip */

#ifdef __KERNEL__

#include <linux/bitops.h>
#include <linux/device.h>
#include <linux/cdev.h>

struct watchdog_ops;
struct watchdog_device;

/** struct watchdog_ops - The watchdog-devices operations
 *
 * @owner:	The module owner.
 * @start:	The routine for starting the watchdog device.
 * @stop:	The routine for stopping the watchdog device.
 * @ping:	The routine that sends a keepalive ping to the watchdog device.
 * @status:	The routine that shows the status of the watchdog device.
 * @set_timeout:The routine for setting the watchdog devices timeout value.
 * @get_timeleft:The routine that get's the time that's left before a reset.
 * @ioctl:	The routines that handles extra ioctl calls.
 *
 * The watchdog_ops structure contains a list of low-level operations
 * that control a watchdog device. It also contains the module that owns
 * these operations. The start and stop function are mandatory, all other
 * functions are optonal.
 */
struct watchdog_ops {
	struct module *owner;
	/* mandatory operations */
	int (*start)(struct watchdog_device *);
	int (*stop)(struct watchdog_device *);
	/* optional operations */
	int (*ping)(struct watchdog_device *);
	unsigned int (*status)(struct watchdog_device *);
	int (*set_timeout)(struct watchdog_device *, unsigned int);
	unsigned int (*get_timeleft)(struct watchdog_device *);
	long (*ioctl)(struct watchdog_device *, unsigned int, unsigned long);
};

/** struct watchdog_device - The structure that defines a watchdog device
 *
 * @id:		The watchdog's ID. (Allocated by watchdog_register_device)
 * @cdev:	The watchdog's Character device.
 * @dev:	The device for our watchdog
 * @parent:	The parent bus device
 * @info:	Pointer to a watchdog_info structure.
 * @ops:	Pointer to the list of watchdog operations.
 * @bootstatus:	Status of the watchdog device at boot.
 * @timeout:	The watchdog devices timeout value.
 * @min_timeout:The watchdog devices minimum timeout value.
 * @max_timeout:The watchdog devices maximum timeout value.
 * @driver-data:Pointer to the drivers private data.
 * @status:	Field that contains the devices internal status bits.
 *
 * The watchdog_device structure contains all information about a
 * watchdog timer device.
 *
 * The driver-data field may not be accessed directly. It must be accessed
 * via the watchdog_set_drvdata and watchdog_get_drvdata helpers.
 */
struct watchdog_device {
	int id;
	struct cdev cdev;
	struct device *dev;
	struct device *parent;
	const struct watchdog_info *info;
	const struct watchdog_ops *ops;
	unsigned int bootstatus;
	unsigned int timeout;
	unsigned int min_timeout;
	unsigned int max_timeout;
	void *driver_data;
	unsigned long status;
/* Bit numbers for status flags */
#define WDOG_ACTIVE		0	/* Is the watchdog running/active */
#define WDOG_DEV_OPEN		1	/* Opened via /dev/watchdog ? */
#define WDOG_ALLOW_RELEASE	2	/* Did we receive the magic char ? */
#define WDOG_NO_WAY_OUT		3	/* Is 'nowayout' feature set ? */
};

#ifdef CONFIG_WATCHDOG_NOWAYOUT
#define WATCHDOG_NOWAYOUT		1
#define WATCHDOG_NOWAYOUT_INIT_STATUS	(1 << WDOG_NO_WAY_OUT)
#else
#define WATCHDOG_NOWAYOUT		0
#define WATCHDOG_NOWAYOUT_INIT_STATUS	0
#endif

/* Use the following function to check wether or not the watchdog is active */
static inline bool watchdog_active(struct watchdog_device *wdd)
{
	return test_bit(WDOG_ACTIVE, &wdd->status);
}

/* Use the following function to set the nowayout feature */
static inline void watchdog_set_nowayout(struct watchdog_device *wdd, bool nowayout)
{
	if (nowayout)
		set_bit(WDOG_NO_WAY_OUT, &wdd->status);
}

/* Use the following functions to manipulate watchdog driver specific data */
static inline void watchdog_set_drvdata(struct watchdog_device *wdd, void *data)
{
	wdd->driver_data = data;
}

static inline void *watchdog_get_drvdata(struct watchdog_device *wdd)
{
	return wdd->driver_data;
}

/* drivers/watchdog/core/watchdog_core.c */
extern int watchdog_register_device(struct watchdog_device *);
extern void watchdog_unregister_device(struct watchdog_device *);

#endif	/* __KERNEL__ */

#endif  /* ifndef _LINUX_WATCHDOG_H */
Commit	Line	Data
1da177e4 LT	1	/*
	2	* Generic watchdog defines. Derived from..
	3	*
	4	* Berkshire PC Watchdog Defines
	5	* by Ken Hollis <khollis@bitgate.com>
	6	*
	7	*/
	8
	9	#ifndef _LINUX_WATCHDOG_H
	10	#define _LINUX_WATCHDOG_H
	11
	12	#include <linux/ioctl.h>
	13	#include <linux/types.h>
	14
	15	#define WATCHDOG_IOCTL_BASE 'W'
	16
	17	struct watchdog_info {
	18	__u32 options; /* Options the card/driver supports */
	19	__u32 firmware_version; /* Firmware version of the card */
	20	__u8 identity[32]; /* Identity of the board */
	21	};
	22
	23	#define WDIOC_GETSUPPORT _IOR(WATCHDOG_IOCTL_BASE, 0, struct watchdog_info)
	24	#define WDIOC_GETSTATUS _IOR(WATCHDOG_IOCTL_BASE, 1, int)
	25	#define WDIOC_GETBOOTSTATUS _IOR(WATCHDOG_IOCTL_BASE, 2, int)
	26	#define WDIOC_GETTEMP _IOR(WATCHDOG_IOCTL_BASE, 3, int)
	27	#define WDIOC_SETOPTIONS _IOR(WATCHDOG_IOCTL_BASE, 4, int)
	28	#define WDIOC_KEEPALIVE _IOR(WATCHDOG_IOCTL_BASE, 5, int)
	29	#define WDIOC_SETTIMEOUT _IOWR(WATCHDOG_IOCTL_BASE, 6, int)
	30	#define WDIOC_GETTIMEOUT _IOR(WATCHDOG_IOCTL_BASE, 7, int)
e05b59fe CM	31	#define WDIOC_SETPRETIMEOUT _IOWR(WATCHDOG_IOCTL_BASE, 8, int)
e05b59fe CM	32	#define WDIOC_GETPRETIMEOUT _IOR(WATCHDOG_IOCTL_BASE, 9, int)
58b519f3	33	#define WDIOC_GETTIMELEFT _IOR(WATCHDOG_IOCTL_BASE, 10, int)
1da177e4 LT	34
	35	#define WDIOF_UNKNOWN -1 /* Unknown flag error */
	36	#define WDIOS_UNKNOWN -1 /* Unknown status error */
	37
	38	#define WDIOF_OVERHEAT 0x0001 /* Reset due to CPU overheat */
	39	#define WDIOF_FANFAULT 0x0002 /* Fan failed */
	40	#define WDIOF_EXTERN1 0x0004 /* External relay 1 */
	41	#define WDIOF_EXTERN2 0x0008 /* External relay 2 */
	42	#define WDIOF_POWERUNDER 0x0010 /* Power bad/power fault */
	43	#define WDIOF_CARDRESET 0x0020 /* Card previously reset the CPU */
58b519f3 WVS	44	#define WDIOF_POWEROVER 0x0040 /* Power over voltage */
	45	#define WDIOF_SETTIMEOUT 0x0080 /* Set timeout (in seconds) */
	46	#define WDIOF_MAGICCLOSE 0x0100 /* Supports magic close char */
e05b59fe	47	#define WDIOF_PRETIMEOUT 0x0200 /* Pretimeout (in seconds), get/set */
2bbeed01 AC	48	#define WDIOF_ALARMONLY 0x0400 /* Watchdog triggers a management or
2bbeed01 AC	49	other external alarm not a reboot */
1da177e4 LT	50	#define WDIOF_KEEPALIVEPING 0x8000 /* Keep alive ping reply */
	51
	52	#define WDIOS_DISABLECARD 0x0001 /* Turn off the watchdog timer */
	53	#define WDIOS_ENABLECARD 0x0002 /* Turn on the watchdog timer */
	54	#define WDIOS_TEMPPANIC 0x0004 /* Kernel panic on temperature trip */
	55
4bfdf378 AP	56	#ifdef __KERNEL__
4bfdf378 AP	57
ff0b3cd4	58	#include <linux/bitops.h>
45f5fed3 AC	59	#include <linux/device.h>
45f5fed3 AC	60	#include <linux/cdev.h>
4bfdf378	61
43316044 WVS	62	struct watchdog_ops;
	63	struct watchdog_device;
	64
	65	/** struct watchdog_ops - The watchdog-devices operations
	66	*
	67	* @owner: The module owner.
	68	* @start: The routine for starting the watchdog device.
	69	* @stop: The routine for stopping the watchdog device.
	70	* @ping: The routine that sends a keepalive ping to the watchdog device.
2fa03560	71	* @status: The routine that shows the status of the watchdog device.
014d694e	72	* @set_timeout:The routine for setting the watchdog devices timeout value.
fd7b673c	73	* @get_timeleft:The routine that get's the time that's left before a reset.
78d88fc0	74	* @ioctl: The routines that handles extra ioctl calls.
43316044 WVS	75	*
	76	* The watchdog_ops structure contains a list of low-level operations
	77	* that control a watchdog device. It also contains the module that owns
	78	* these operations. The start and stop function are mandatory, all other
	79	* functions are optonal.
	80	*/
	81	struct watchdog_ops {
	82	struct module *owner;
	83	/* mandatory operations */
	84	int (start)(struct watchdog_device );
	85	int (stop)(struct watchdog_device );
	86	/* optional operations */
	87	int (ping)(struct watchdog_device );
2fa03560	88	unsigned int (status)(struct watchdog_device );
014d694e	89	int (set_timeout)(struct watchdog_device , unsigned int);
fd7b673c	90	unsigned int (get_timeleft)(struct watchdog_device );
78d88fc0	91	long (ioctl)(struct watchdog_device , unsigned int, unsigned long);
43316044 WVS	92	};
	93
	94	/** struct watchdog_device - The structure that defines a watchdog device
	95	*
45f5fed3 AC	96	* @id: The watchdog's ID. (Allocated by watchdog_register_device)
45f5fed3 AC	97	* @cdev: The watchdog's Character device.
d6b469d9 AC	98	* @dev: The device for our watchdog
d6b469d9 AC	99	* @parent: The parent bus device
43316044 WVS	100	* @info: Pointer to a watchdog_info structure.
43316044 WVS	101	* @ops: Pointer to the list of watchdog operations.
2fa03560	102	* @bootstatus: Status of the watchdog device at boot.
014d694e	103	* @timeout: The watchdog devices timeout value.
3f43f68e WVS	104	* @min_timeout:The watchdog devices minimum timeout value.
3f43f68e WVS	105	* @max_timeout:The watchdog devices maximum timeout value.
43316044 WVS	106	* @driver-data:Pointer to the drivers private data.
	107	* @status: Field that contains the devices internal status bits.
	108	*
	109	* The watchdog_device structure contains all information about a
	110	* watchdog timer device.
	111	*
	112	* The driver-data field may not be accessed directly. It must be accessed
	113	* via the watchdog_set_drvdata and watchdog_get_drvdata helpers.
	114	*/
	115	struct watchdog_device {
45f5fed3 AC	116	int id;
45f5fed3 AC	117	struct cdev cdev;
d6b469d9 AC	118	struct device *dev;
d6b469d9 AC	119	struct device *parent;
43316044 WVS	120	const struct watchdog_info *info;
43316044 WVS	121	const struct watchdog_ops *ops;
2fa03560	122	unsigned int bootstatus;
014d694e	123	unsigned int timeout;
3f43f68e WVS	124	unsigned int min_timeout;
3f43f68e WVS	125	unsigned int max_timeout;
43316044 WVS	126	void *driver_data;
	127	unsigned long status;
	128	/* Bit numbers for status flags */
234445b4	129	#define WDOG_ACTIVE 0 /* Is the watchdog running/active */
43316044	130	#define WDOG_DEV_OPEN 1 /* Opened via /dev/watchdog ? */
017cf080	131	#define WDOG_ALLOW_RELEASE 2 /* Did we receive the magic char ? */
7e192b9c	132	#define WDOG_NO_WAY_OUT 3 /* Is 'nowayout' feature set ? */
43316044 WVS	133	};
43316044 WVS	134
ff0b3cd4 WVS	135	#ifdef CONFIG_WATCHDOG_NOWAYOUT
	136	#define WATCHDOG_NOWAYOUT 1
	137	#define WATCHDOG_NOWAYOUT_INIT_STATUS (1 << WDOG_NO_WAY_OUT)
	138	#else
	139	#define WATCHDOG_NOWAYOUT 0
	140	#define WATCHDOG_NOWAYOUT_INIT_STATUS 0
	141	#endif
	142
257f8c4a VK	143	/* Use the following function to check wether or not the watchdog is active */
	144	static inline bool watchdog_active(struct watchdog_device *wdd)
	145	{
	146	return test_bit(WDOG_ACTIVE, &wdd->status);
	147	}
	148
ff0b3cd4	149	/* Use the following function to set the nowayout feature */
86a1e189	150	static inline void watchdog_set_nowayout(struct watchdog_device *wdd, bool nowayout)
ff0b3cd4 WVS	151	{
	152	if (nowayout)
	153	set_bit(WDOG_NO_WAY_OUT, &wdd->status);
	154	}
	155
43316044 WVS	156	/* Use the following functions to manipulate watchdog driver specific data */
	157	static inline void watchdog_set_drvdata(struct watchdog_device wdd, void data)
	158	{
	159	wdd->driver_data = data;
	160	}
	161
	162	static inline void watchdog_get_drvdata(struct watchdog_device wdd)
	163	{
	164	return wdd->driver_data;
	165	}
	166
	167	/* drivers/watchdog/core/watchdog_core.c */
	168	extern int watchdog_register_device(struct watchdog_device *);
	169	extern void watchdog_unregister_device(struct watchdog_device *);
	170
4bfdf378 AP	171	#endif /* __KERNEL__ */
4bfdf378 AP	172
1da177e4	173	#endif /* ifndef _LINUX_WATCHDOG_H */