Linux Audio

Check our new training course

Loading...
v6.8
  1// SPDX-License-Identifier: GPL-2.0+
  2/*
  3 *	SoftDog:	A Software Watchdog Device
  4 *
  5 *	(c) Copyright 1996 Alan Cox <alan@lxorguk.ukuu.org.uk>,
  6 *							All Rights Reserved.
  7 *
  8 *	Neither Alan Cox nor CymruNet Ltd. admit liability nor provide
  9 *	warranty for any of this software. This material is provided
 10 *	"AS-IS" and at no charge.
 11 *
 12 *	(c) Copyright 1995    Alan Cox <alan@lxorguk.ukuu.org.uk>
 13 *
 14 *	Software only watchdog driver. Unlike its big brother the WDT501P
 15 *	driver this won't always recover a failed machine.
 16 */
 17
 18#define pr_fmt(fmt) KBUILD_MODNAME ": " fmt
 19
 20#include <linux/hrtimer.h>
 21#include <linux/init.h>
 22#include <linux/kernel.h>
 23#include <linux/kthread.h>
 24#include <linux/module.h>
 25#include <linux/moduleparam.h>
 26#include <linux/reboot.h>
 27#include <linux/types.h>
 28#include <linux/watchdog.h>
 29#include <linux/workqueue.h>
 30
 31#define TIMER_MARGIN	60		/* Default is 60 seconds */
 32static unsigned int soft_margin = TIMER_MARGIN;	/* in seconds */
 33module_param(soft_margin, uint, 0);
 34MODULE_PARM_DESC(soft_margin,
 35	"Watchdog soft_margin in seconds. (0 < soft_margin < 65536, default="
 36					__MODULE_STRING(TIMER_MARGIN) ")");
 37
 38static bool nowayout = WATCHDOG_NOWAYOUT;
 39module_param(nowayout, bool, 0);
 40MODULE_PARM_DESC(nowayout,
 41		"Watchdog cannot be stopped once started (default="
 42				__MODULE_STRING(WATCHDOG_NOWAYOUT) ")");
 43
 44static int soft_noboot;
 45module_param(soft_noboot, int, 0);
 46MODULE_PARM_DESC(soft_noboot,
 47	"Softdog action, set to 1 to ignore reboots, 0 to reboot (default=0)");
 48
 49static int soft_panic;
 50module_param(soft_panic, int, 0);
 51MODULE_PARM_DESC(soft_panic,
 52	"Softdog action, set to 1 to panic, 0 to reboot (default=0)");
 53
 54static char *soft_reboot_cmd;
 55module_param(soft_reboot_cmd, charp, 0000);
 56MODULE_PARM_DESC(soft_reboot_cmd,
 57	"Set reboot command. Emergency reboot takes place if unset");
 58
 59static bool soft_active_on_boot;
 60module_param(soft_active_on_boot, bool, 0000);
 61MODULE_PARM_DESC(soft_active_on_boot,
 62	"Set to true to active Softdog on boot (default=false)");
 63
 64static struct hrtimer softdog_ticktock;
 65static struct hrtimer softdog_preticktock;
 66
 67static int reboot_kthread_fn(void *data)
 68{
 69	kernel_restart(soft_reboot_cmd);
 70	return -EPERM; /* Should not reach here */
 71}
 72
 73static void reboot_work_fn(struct work_struct *unused)
 74{
 75	kthread_run(reboot_kthread_fn, NULL, "softdog_reboot");
 76}
 77
 78static enum hrtimer_restart softdog_fire(struct hrtimer *timer)
 79{
 80	static bool soft_reboot_fired;
 81
 82	module_put(THIS_MODULE);
 83	if (soft_noboot) {
 84		pr_crit("Triggered - Reboot ignored\n");
 85	} else if (soft_panic) {
 86		pr_crit("Initiating panic\n");
 87		panic("Software Watchdog Timer expired");
 88	} else {
 89		pr_crit("Initiating system reboot\n");
 90		if (!soft_reboot_fired && soft_reboot_cmd != NULL) {
 91			static DECLARE_WORK(reboot_work, reboot_work_fn);
 92			/*
 93			 * The 'kernel_restart' is a 'might-sleep' operation.
 94			 * Also, executing it in system-wide workqueues blocks
 95			 * any driver from using the same workqueue in its
 96			 * shutdown callback function. Thus, we should execute
 97			 * the 'kernel_restart' in a standalone kernel thread.
 98			 * But since starting a kernel thread is also a
 99			 * 'might-sleep' operation, so the 'reboot_work' is
100			 * required as a launcher of the kernel thread.
101			 *
102			 * After request the reboot, restart the timer to
103			 * schedule an 'emergency_restart' reboot after
104			 * 'TIMER_MARGIN' seconds. It's because if the softdog
105			 * hangs, it might be because of scheduling issues. And
106			 * if that is the case, both 'schedule_work' and
107			 * 'kernel_restart' may possibly be malfunctional at the
108			 * same time.
109			 */
110			soft_reboot_fired = true;
111			schedule_work(&reboot_work);
112			hrtimer_add_expires_ns(timer,
113					(u64)TIMER_MARGIN * NSEC_PER_SEC);
114
115			return HRTIMER_RESTART;
116		}
117		emergency_restart();
118		pr_crit("Reboot didn't ?????\n");
119	}
120
121	return HRTIMER_NORESTART;
122}
123
124static struct watchdog_device softdog_dev;
125
126static enum hrtimer_restart softdog_pretimeout(struct hrtimer *timer)
127{
128	watchdog_notify_pretimeout(&softdog_dev);
129
130	return HRTIMER_NORESTART;
131}
132
133static int softdog_ping(struct watchdog_device *w)
134{
135	if (!hrtimer_active(&softdog_ticktock))
136		__module_get(THIS_MODULE);
137	hrtimer_start(&softdog_ticktock, ktime_set(w->timeout, 0),
138		      HRTIMER_MODE_REL);
139
140	if (IS_ENABLED(CONFIG_SOFT_WATCHDOG_PRETIMEOUT)) {
141		if (w->pretimeout)
142			hrtimer_start(&softdog_preticktock,
143				      ktime_set(w->timeout - w->pretimeout, 0),
144				      HRTIMER_MODE_REL);
145		else
146			hrtimer_cancel(&softdog_preticktock);
147	}
148
149	return 0;
150}
151
152static int softdog_stop(struct watchdog_device *w)
153{
154	if (hrtimer_cancel(&softdog_ticktock))
155		module_put(THIS_MODULE);
156
157	if (IS_ENABLED(CONFIG_SOFT_WATCHDOG_PRETIMEOUT))
158		hrtimer_cancel(&softdog_preticktock);
159
160	return 0;
161}
162
163static struct watchdog_info softdog_info = {
164	.identity = "Software Watchdog",
165	.options = WDIOF_SETTIMEOUT | WDIOF_KEEPALIVEPING | WDIOF_MAGICCLOSE,
166};
167
168static const struct watchdog_ops softdog_ops = {
169	.owner = THIS_MODULE,
170	.start = softdog_ping,
171	.stop = softdog_stop,
172};
173
174static struct watchdog_device softdog_dev = {
175	.info = &softdog_info,
176	.ops = &softdog_ops,
177	.min_timeout = 1,
178	.max_timeout = 65535,
179	.timeout = TIMER_MARGIN,
180};
181
182static int __init softdog_init(void)
183{
184	int ret;
185
186	watchdog_init_timeout(&softdog_dev, soft_margin, NULL);
187	watchdog_set_nowayout(&softdog_dev, nowayout);
188	watchdog_stop_on_reboot(&softdog_dev);
189
190	hrtimer_init(&softdog_ticktock, CLOCK_MONOTONIC, HRTIMER_MODE_REL);
191	softdog_ticktock.function = softdog_fire;
192
193	if (IS_ENABLED(CONFIG_SOFT_WATCHDOG_PRETIMEOUT)) {
194		softdog_info.options |= WDIOF_PRETIMEOUT;
195		hrtimer_init(&softdog_preticktock, CLOCK_MONOTONIC,
196			     HRTIMER_MODE_REL);
197		softdog_preticktock.function = softdog_pretimeout;
198	}
199
200	if (soft_active_on_boot)
201		softdog_ping(&softdog_dev);
202
203	ret = watchdog_register_device(&softdog_dev);
204	if (ret)
205		return ret;
206
207	pr_info("initialized. soft_noboot=%d soft_margin=%d sec soft_panic=%d (nowayout=%d)\n",
208		soft_noboot, softdog_dev.timeout, soft_panic, nowayout);
209	pr_info("             soft_reboot_cmd=%s soft_active_on_boot=%d\n",
210		soft_reboot_cmd ?: "<not set>", soft_active_on_boot);
211
212	return 0;
213}
214module_init(softdog_init);
215
216static void __exit softdog_exit(void)
217{
218	watchdog_unregister_device(&softdog_dev);
219}
220module_exit(softdog_exit);
221
222MODULE_AUTHOR("Alan Cox");
223MODULE_DESCRIPTION("Software Watchdog Device Driver");
224MODULE_LICENSE("GPL");
v5.4
  1// SPDX-License-Identifier: GPL-2.0+
  2/*
  3 *	SoftDog:	A Software Watchdog Device
  4 *
  5 *	(c) Copyright 1996 Alan Cox <alan@lxorguk.ukuu.org.uk>,
  6 *							All Rights Reserved.
  7 *
  8 *	Neither Alan Cox nor CymruNet Ltd. admit liability nor provide
  9 *	warranty for any of this software. This material is provided
 10 *	"AS-IS" and at no charge.
 11 *
 12 *	(c) Copyright 1995    Alan Cox <alan@lxorguk.ukuu.org.uk>
 13 *
 14 *	Software only watchdog driver. Unlike its big brother the WDT501P
 15 *	driver this won't always recover a failed machine.
 16 */
 17
 18#define pr_fmt(fmt) KBUILD_MODNAME ": " fmt
 19
 20#include <linux/hrtimer.h>
 21#include <linux/init.h>
 22#include <linux/kernel.h>
 
 23#include <linux/module.h>
 24#include <linux/moduleparam.h>
 25#include <linux/reboot.h>
 26#include <linux/types.h>
 27#include <linux/watchdog.h>
 
 28
 29#define TIMER_MARGIN	60		/* Default is 60 seconds */
 30static unsigned int soft_margin = TIMER_MARGIN;	/* in seconds */
 31module_param(soft_margin, uint, 0);
 32MODULE_PARM_DESC(soft_margin,
 33	"Watchdog soft_margin in seconds. (0 < soft_margin < 65536, default="
 34					__MODULE_STRING(TIMER_MARGIN) ")");
 35
 36static bool nowayout = WATCHDOG_NOWAYOUT;
 37module_param(nowayout, bool, 0);
 38MODULE_PARM_DESC(nowayout,
 39		"Watchdog cannot be stopped once started (default="
 40				__MODULE_STRING(WATCHDOG_NOWAYOUT) ")");
 41
 42static int soft_noboot;
 43module_param(soft_noboot, int, 0);
 44MODULE_PARM_DESC(soft_noboot,
 45	"Softdog action, set to 1 to ignore reboots, 0 to reboot (default=0)");
 46
 47static int soft_panic;
 48module_param(soft_panic, int, 0);
 49MODULE_PARM_DESC(soft_panic,
 50	"Softdog action, set to 1 to panic, 0 to reboot (default=0)");
 51
 
 
 
 
 
 
 
 
 
 
 52static struct hrtimer softdog_ticktock;
 53static struct hrtimer softdog_preticktock;
 54
 
 
 
 
 
 
 
 
 
 
 
 55static enum hrtimer_restart softdog_fire(struct hrtimer *timer)
 56{
 
 
 57	module_put(THIS_MODULE);
 58	if (soft_noboot) {
 59		pr_crit("Triggered - Reboot ignored\n");
 60	} else if (soft_panic) {
 61		pr_crit("Initiating panic\n");
 62		panic("Software Watchdog Timer expired");
 63	} else {
 64		pr_crit("Initiating system reboot\n");
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 65		emergency_restart();
 66		pr_crit("Reboot didn't ?????\n");
 67	}
 68
 69	return HRTIMER_NORESTART;
 70}
 71
 72static struct watchdog_device softdog_dev;
 73
 74static enum hrtimer_restart softdog_pretimeout(struct hrtimer *timer)
 75{
 76	watchdog_notify_pretimeout(&softdog_dev);
 77
 78	return HRTIMER_NORESTART;
 79}
 80
 81static int softdog_ping(struct watchdog_device *w)
 82{
 83	if (!hrtimer_active(&softdog_ticktock))
 84		__module_get(THIS_MODULE);
 85	hrtimer_start(&softdog_ticktock, ktime_set(w->timeout, 0),
 86		      HRTIMER_MODE_REL);
 87
 88	if (IS_ENABLED(CONFIG_SOFT_WATCHDOG_PRETIMEOUT)) {
 89		if (w->pretimeout)
 90			hrtimer_start(&softdog_preticktock,
 91				      ktime_set(w->timeout - w->pretimeout, 0),
 92				      HRTIMER_MODE_REL);
 93		else
 94			hrtimer_cancel(&softdog_preticktock);
 95	}
 96
 97	return 0;
 98}
 99
100static int softdog_stop(struct watchdog_device *w)
101{
102	if (hrtimer_cancel(&softdog_ticktock))
103		module_put(THIS_MODULE);
104
105	if (IS_ENABLED(CONFIG_SOFT_WATCHDOG_PRETIMEOUT))
106		hrtimer_cancel(&softdog_preticktock);
107
108	return 0;
109}
110
111static struct watchdog_info softdog_info = {
112	.identity = "Software Watchdog",
113	.options = WDIOF_SETTIMEOUT | WDIOF_KEEPALIVEPING | WDIOF_MAGICCLOSE,
114};
115
116static const struct watchdog_ops softdog_ops = {
117	.owner = THIS_MODULE,
118	.start = softdog_ping,
119	.stop = softdog_stop,
120};
121
122static struct watchdog_device softdog_dev = {
123	.info = &softdog_info,
124	.ops = &softdog_ops,
125	.min_timeout = 1,
126	.max_timeout = 65535,
127	.timeout = TIMER_MARGIN,
128};
129
130static int __init softdog_init(void)
131{
132	int ret;
133
134	watchdog_init_timeout(&softdog_dev, soft_margin, NULL);
135	watchdog_set_nowayout(&softdog_dev, nowayout);
136	watchdog_stop_on_reboot(&softdog_dev);
137
138	hrtimer_init(&softdog_ticktock, CLOCK_MONOTONIC, HRTIMER_MODE_REL);
139	softdog_ticktock.function = softdog_fire;
140
141	if (IS_ENABLED(CONFIG_SOFT_WATCHDOG_PRETIMEOUT)) {
142		softdog_info.options |= WDIOF_PRETIMEOUT;
143		hrtimer_init(&softdog_preticktock, CLOCK_MONOTONIC,
144			     HRTIMER_MODE_REL);
145		softdog_preticktock.function = softdog_pretimeout;
146	}
147
 
 
 
148	ret = watchdog_register_device(&softdog_dev);
149	if (ret)
150		return ret;
151
152	pr_info("initialized. soft_noboot=%d soft_margin=%d sec soft_panic=%d (nowayout=%d)\n",
153		soft_noboot, softdog_dev.timeout, soft_panic, nowayout);
 
 
154
155	return 0;
156}
157module_init(softdog_init);
158
159static void __exit softdog_exit(void)
160{
161	watchdog_unregister_device(&softdog_dev);
162}
163module_exit(softdog_exit);
164
165MODULE_AUTHOR("Alan Cox");
166MODULE_DESCRIPTION("Software Watchdog Device Driver");
167MODULE_LICENSE("GPL");