Commit 7e192b9c authored by Wim Van Sebroeck's avatar Wim Van Sebroeck

watchdog: WatchDog Timer Driver Core - Add nowayout feature

Add support for the nowayout feature to the
WatchDog Timer Driver Core framework.
This feature prevents the watchdog timer from being
stopped.
Signed-off-by: default avatarAlan Cox <alan@lxorguk.ukuu.org.uk>
Signed-off-by: default avatarWim Van Sebroeck <wim@iguana.be>
Acked-by: default avatarArnd Bergmann <arnd@arndb.de>
Acked-by: default avatarWolfram Sang <w.sang@pengutronix.de>
parent 017cf080
...@@ -59,8 +59,8 @@ It contains following fields: ...@@ -59,8 +59,8 @@ It contains following fields:
watchdog_get_drvdata routines. watchdog_get_drvdata routines.
* status: this field contains a number of status bits that give extra * status: this field contains a number of status bits that give extra
information about the status of the device (Like: is the watchdog timer information about the status of the device (Like: is the watchdog timer
running/active, is the device opened via the /dev/watchdog interface or not, running/active, is the nowayout bit set, is the device opened via
...). the /dev/watchdog interface or not, ...).
The list of watchdog operations is defined as: The list of watchdog operations is defined as:
...@@ -130,10 +130,13 @@ bit-operations. The status bits that are defined are: ...@@ -130,10 +130,13 @@ bit-operations. The status bits that are defined are:
* WDOG_ALLOW_RELEASE: this bit stores whether or not the magic close character * WDOG_ALLOW_RELEASE: this bit stores whether or not the magic close character
has been sent (so that we can support the magic close feature). has been sent (so that we can support the magic close feature).
(This bit should only be used by the WatchDog Timer Driver Core). (This bit should only be used by the WatchDog Timer Driver Core).
* WDOG_NO_WAY_OUT: this bit stores the nowayout setting for the watchdog.
If this bit is set then the watchdog timer will not be able to stop.
Note: The WatchDog Timer Driver Core supports the magic close feature. To use Note: The WatchDog Timer Driver Core supports the magic close feature and
the magic close feature you must set the WDIOF_MAGICCLOSE bit in the options the nowayout feature. To use the magic close feature you must set the
field of the watchdog's info structure. WDIOF_MAGICCLOSE bit in the options field of the watchdog's info structure.
The nowayout feature will overrule the magic close feature.
To get or set driver specific data the following two helper functions should be To get or set driver specific data the following two helper functions should be
used: used:
......
...@@ -98,11 +98,18 @@ static int watchdog_start(struct watchdog_device *wddev) ...@@ -98,11 +98,18 @@ static int watchdog_start(struct watchdog_device *wddev)
* Stop the watchdog if it is still active and unmark it active. * Stop the watchdog if it is still active and unmark it active.
* This function returns zero on success or a negative errno code for * This function returns zero on success or a negative errno code for
* failure. * failure.
* If the 'nowayout' feature was set, the watchdog cannot be stopped.
*/ */
static int watchdog_stop(struct watchdog_device *wddev) static int watchdog_stop(struct watchdog_device *wddev)
{ {
int err; int err = -EBUSY;
if (test_bit(WDOG_NO_WAY_OUT, &wdd->status)) {
pr_info("%s: nowayout prevents watchdog to be stopped!\n",
wdd->info->identity);
return err;
}
if (test_bit(WDOG_ACTIVE, &wdd->status)) { if (test_bit(WDOG_ACTIVE, &wdd->status)) {
err = wddev->ops->stop(wddev); err = wddev->ops->stop(wddev);
...@@ -123,7 +130,7 @@ static int watchdog_stop(struct watchdog_device *wddev) ...@@ -123,7 +130,7 @@ static int watchdog_stop(struct watchdog_device *wddev)
* *
* A write to a watchdog device is defined as a keepalive ping. * A write to a watchdog device is defined as a keepalive ping.
* Writing the magic 'V' sequence allows the next close to turn * Writing the magic 'V' sequence allows the next close to turn
* off the watchdog. * off the watchdog (if 'nowayout' is not set).
*/ */
static ssize_t watchdog_write(struct file *file, const char __user *data, static ssize_t watchdog_write(struct file *file, const char __user *data,
...@@ -271,8 +278,8 @@ static int watchdog_open(struct inode *inode, struct file *file) ...@@ -271,8 +278,8 @@ static int watchdog_open(struct inode *inode, struct file *file)
* @file: file handle to device * @file: file handle to device
* *
* This is the code for when /dev/watchdog gets closed. We will only * This is the code for when /dev/watchdog gets closed. We will only
* stop the watchdog when we have received the magic char, else the * stop the watchdog when we have received the magic char (and nowayout
* watchdog will keep running. * was not set), else the watchdog will keep running.
*/ */
static int watchdog_release(struct inode *inode, struct file *file) static int watchdog_release(struct inode *inode, struct file *file)
...@@ -281,7 +288,8 @@ static int watchdog_release(struct inode *inode, struct file *file) ...@@ -281,7 +288,8 @@ static int watchdog_release(struct inode *inode, struct file *file)
/* /*
* We only stop the watchdog if we received the magic character * We only stop the watchdog if we received the magic character
* or if WDIOF_MAGICCLOSE is not set * or if WDIOF_MAGICCLOSE is not set. If nowayout was set then
* watchdog_stop will fail.
*/ */
if (test_and_clear_bit(WDOG_ALLOW_RELEASE, &wdd->status) || if (test_and_clear_bit(WDOG_ALLOW_RELEASE, &wdd->status) ||
!(wdd->info->options & WDIOF_MAGICCLOSE)) !(wdd->info->options & WDIOF_MAGICCLOSE))
......
...@@ -113,6 +113,7 @@ struct watchdog_device { ...@@ -113,6 +113,7 @@ struct watchdog_device {
#define WDOG_ACTIVE 0 /* Is the watchdog running/active */ #define WDOG_ACTIVE 0 /* Is the watchdog running/active */
#define WDOG_DEV_OPEN 1 /* Opened via /dev/watchdog ? */ #define WDOG_DEV_OPEN 1 /* Opened via /dev/watchdog ? */
#define WDOG_ALLOW_RELEASE 2 /* Did we receive the magic char ? */ #define WDOG_ALLOW_RELEASE 2 /* Did we receive the magic char ? */
#define WDOG_NO_WAY_OUT 3 /* Is 'nowayout' feature set ? */
}; };
/* Use the following functions to manipulate watchdog driver specific data */ /* Use the following functions to manipulate watchdog driver specific data */
......
Markdown is supported
0%
or
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment