2 * Watchdog driver for z/VM and LPAR using the diag 288 interface.
4 * Under z/VM, expiration of the watchdog will send a "system restart" command
7 * The command can be altered using the module parameter "cmd". This is
8 * not recommended because it's only supported on z/VM but not whith LPAR.
10 * On LPAR, the watchdog will always trigger a system restart. the module
11 * paramter cmd is meaningless here.
14 * Copyright IBM Corp. 2004, 2013
15 * Author(s): Arnd Bergmann (arndb@de.ibm.com)
16 * Philipp Hachtmann (phacht@de.ibm.com)
20 #define KMSG_COMPONENT "diag288_wdt"
21 #define pr_fmt(fmt) KMSG_COMPONENT ": " fmt
23 #include <linux/init.h>
24 #include <linux/kernel.h>
25 #include <linux/module.h>
26 #include <linux/moduleparam.h>
27 #include <linux/slab.h>
28 #include <linux/miscdevice.h>
29 #include <linux/watchdog.h>
30 #include <linux/suspend.h>
31 #include <asm/ebcdic.h>
33 #include <linux/uaccess.h>
35 #define MAX_CMDLEN 240
36 #define DEFAULT_CMD "SYSTEM RESTART"
38 #define MIN_INTERVAL 15 /* Minimal time supported by diag88 */
39 #define MAX_INTERVAL 3600 /* One hour should be enough - pure estimation */
41 #define WDT_DEFAULT_TIMEOUT 30
43 /* Function codes - init, change, cancel */
44 #define WDT_FUNC_INIT 0
45 #define WDT_FUNC_CHANGE 1
46 #define WDT_FUNC_CANCEL 2
47 #define WDT_FUNC_CONCEAL 0x80000000
49 /* Action codes for LPAR watchdog */
50 #define LPARWDT_RESTART 0
52 static char wdt_cmd
[MAX_CMDLEN
] = DEFAULT_CMD
;
53 static bool conceal_on
;
54 static bool nowayout_info
= WATCHDOG_NOWAYOUT
;
56 MODULE_LICENSE("GPL");
57 MODULE_AUTHOR("Arnd Bergmann <arndb@de.ibm.com>");
58 MODULE_AUTHOR("Philipp Hachtmann <phacht@de.ibm.com>");
60 MODULE_DESCRIPTION("System z diag288 Watchdog Timer");
62 module_param_string(cmd
, wdt_cmd
, MAX_CMDLEN
, 0644);
63 MODULE_PARM_DESC(cmd
, "CP command that is run when the watchdog triggers (z/VM only)");
65 module_param_named(conceal
, conceal_on
, bool, 0644);
66 MODULE_PARM_DESC(conceal
, "Enable the CONCEAL CP option while the watchdog is active (z/VM only)");
68 module_param_named(nowayout
, nowayout_info
, bool, 0444);
69 MODULE_PARM_DESC(nowayout
, "Watchdog cannot be stopped once started (default = CONFIG_WATCHDOG_NOWAYOUT)");
71 MODULE_ALIAS_MISCDEV(WATCHDOG_MINOR
);
72 MODULE_ALIAS("vmwatchdog");
74 static int __diag288(unsigned int func
, unsigned int timeout
,
75 unsigned long action
, unsigned int len
)
77 register unsigned long __func
asm("2") = func
;
78 register unsigned long __timeout
asm("3") = timeout
;
79 register unsigned long __action
asm("4") = action
;
80 register unsigned long __len
asm("5") = len
;
85 " diag %1, %3, 0x288\n"
89 : "+d" (err
) : "d"(__func
), "d"(__timeout
),
90 "d"(__action
), "d"(__len
) : "1", "cc");
94 static int __diag288_vm(unsigned int func
, unsigned int timeout
,
95 char *cmd
, size_t len
)
97 return __diag288(func
, timeout
, virt_to_phys(cmd
), len
);
100 static int __diag288_lpar(unsigned int func
, unsigned int timeout
,
101 unsigned long action
)
103 return __diag288(func
, timeout
, action
, 0);
106 static int wdt_start(struct watchdog_device
*dev
)
116 ebc_cmd
= kmalloc(MAX_CMDLEN
, GFP_KERNEL
);
119 len
= strlcpy(ebc_cmd
, wdt_cmd
, MAX_CMDLEN
);
120 ASCEBC(ebc_cmd
, MAX_CMDLEN
);
121 EBC_TOUPPER(ebc_cmd
, MAX_CMDLEN
);
123 func
= conceal_on
? (WDT_FUNC_INIT
| WDT_FUNC_CONCEAL
)
125 ret
= __diag288_vm(func
, dev
->timeout
, ebc_cmd
, len
);
129 ret
= __diag288_lpar(WDT_FUNC_INIT
,
130 dev
->timeout
, LPARWDT_RESTART
);
134 pr_err("The watchdog cannot be activated\n");
140 static int wdt_stop(struct watchdog_device
*dev
)
144 ret
= __diag288(WDT_FUNC_CANCEL
, 0, 0, 0);
148 static int wdt_ping(struct watchdog_device
*dev
)
158 ebc_cmd
= kmalloc(MAX_CMDLEN
, GFP_KERNEL
);
161 len
= strlcpy(ebc_cmd
, wdt_cmd
, MAX_CMDLEN
);
162 ASCEBC(ebc_cmd
, MAX_CMDLEN
);
163 EBC_TOUPPER(ebc_cmd
, MAX_CMDLEN
);
166 * It seems to be ok to z/VM to use the init function to
167 * retrigger the watchdog. On LPAR WDT_FUNC_CHANGE must
168 * be used when the watchdog is running.
170 func
= conceal_on
? (WDT_FUNC_INIT
| WDT_FUNC_CONCEAL
)
173 ret
= __diag288_vm(func
, dev
->timeout
, ebc_cmd
, len
);
177 ret
= __diag288_lpar(WDT_FUNC_CHANGE
, dev
->timeout
, 0);
181 pr_err("The watchdog timer cannot be started or reset\n");
185 static int wdt_set_timeout(struct watchdog_device
* dev
, unsigned int new_to
)
187 dev
->timeout
= new_to
;
188 return wdt_ping(dev
);
191 static struct watchdog_ops wdt_ops
= {
192 .owner
= THIS_MODULE
,
196 .set_timeout
= wdt_set_timeout
,
199 static struct watchdog_info wdt_info
= {
200 .options
= WDIOF_SETTIMEOUT
| WDIOF_KEEPALIVEPING
| WDIOF_MAGICCLOSE
,
201 .firmware_version
= 0,
202 .identity
= "z Watchdog",
205 static struct watchdog_device wdt_dev
= {
210 .timeout
= WDT_DEFAULT_TIMEOUT
,
211 .min_timeout
= MIN_INTERVAL
,
212 .max_timeout
= MAX_INTERVAL
,
216 * It makes no sense to go into suspend while the watchdog is running.
217 * Depending on the memory size, the watchdog might trigger, while we
218 * are still saving the memory.
219 * We reuse the open flag to ensure that suspend and watchdog open are
220 * exclusive operations
222 static int wdt_suspend(void)
224 if (test_and_set_bit(WDOG_DEV_OPEN
, &wdt_dev
.status
)) {
225 pr_err("Linux cannot be suspended while the watchdog is in use\n");
226 return notifier_from_errno(-EBUSY
);
228 if (test_bit(WDOG_ACTIVE
, &wdt_dev
.status
)) {
229 clear_bit(WDOG_DEV_OPEN
, &wdt_dev
.status
);
230 pr_err("Linux cannot be suspended while the watchdog is in use\n");
231 return notifier_from_errno(-EBUSY
);
236 static int wdt_resume(void)
238 clear_bit(WDOG_DEV_OPEN
, &wdt_dev
.status
);
242 static int wdt_power_event(struct notifier_block
*this, unsigned long event
,
246 case PM_POST_HIBERNATION
:
247 case PM_POST_SUSPEND
:
249 case PM_HIBERNATION_PREPARE
:
250 case PM_SUSPEND_PREPARE
:
251 return wdt_suspend();
257 static struct notifier_block wdt_power_notifier
= {
258 .notifier_call
= wdt_power_event
,
261 static int __init
diag288_init(void)
265 194, 197, 199, 201, 213
268 watchdog_set_nowayout(&wdt_dev
, nowayout_info
);
271 if (__diag288_vm(WDT_FUNC_INIT
, 15,
272 ebc_begin
, sizeof(ebc_begin
)) != 0) {
273 pr_err("The watchdog cannot be initialized\n");
277 if (__diag288_lpar(WDT_FUNC_INIT
, 30, LPARWDT_RESTART
)) {
278 pr_err("The watchdog cannot be initialized\n");
283 if (__diag288_lpar(WDT_FUNC_CANCEL
, 0, 0)) {
284 pr_err("The watchdog cannot be deactivated\n");
288 ret
= register_pm_notifier(&wdt_power_notifier
);
292 ret
= watchdog_register_device(&wdt_dev
);
294 unregister_pm_notifier(&wdt_power_notifier
);
299 static void __exit
diag288_exit(void)
301 watchdog_unregister_device(&wdt_dev
);
302 unregister_pm_notifier(&wdt_power_notifier
);
305 module_init(diag288_init
);
306 module_exit(diag288_exit
);