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>
34 #include <linux/uaccess.h>
36 #define MAX_CMDLEN 240
37 #define DEFAULT_CMD "SYSTEM RESTART"
39 #define MIN_INTERVAL 15 /* Minimal time supported by diag88 */
40 #define MAX_INTERVAL 3600 /* One hour should be enough - pure estimation */
42 #define WDT_DEFAULT_TIMEOUT 30
44 /* Function codes - init, change, cancel */
45 #define WDT_FUNC_INIT 0
46 #define WDT_FUNC_CHANGE 1
47 #define WDT_FUNC_CANCEL 2
48 #define WDT_FUNC_CONCEAL 0x80000000
50 /* Action codes for LPAR watchdog */
51 #define LPARWDT_RESTART 0
53 static char wdt_cmd
[MAX_CMDLEN
] = DEFAULT_CMD
;
54 static bool conceal_on
;
55 static bool nowayout_info
= WATCHDOG_NOWAYOUT
;
57 MODULE_LICENSE("GPL");
58 MODULE_AUTHOR("Arnd Bergmann <arndb@de.ibm.com>");
59 MODULE_AUTHOR("Philipp Hachtmann <phacht@de.ibm.com>");
61 MODULE_DESCRIPTION("System z diag288 Watchdog Timer");
63 module_param_string(cmd
, wdt_cmd
, MAX_CMDLEN
, 0644);
64 MODULE_PARM_DESC(cmd
, "CP command that is run when the watchdog triggers (z/VM only)");
66 module_param_named(conceal
, conceal_on
, bool, 0644);
67 MODULE_PARM_DESC(conceal
, "Enable the CONCEAL CP option while the watchdog is active (z/VM only)");
69 module_param_named(nowayout
, nowayout_info
, bool, 0444);
70 MODULE_PARM_DESC(nowayout
, "Watchdog cannot be stopped once started (default = CONFIG_WATCHDOG_NOWAYOUT)");
72 MODULE_ALIAS_MISCDEV(WATCHDOG_MINOR
);
73 MODULE_ALIAS("vmwatchdog");
75 static int __diag288(unsigned int func
, unsigned int timeout
,
76 unsigned long action
, unsigned int len
)
78 register unsigned long __func
asm("2") = func
;
79 register unsigned long __timeout
asm("3") = timeout
;
80 register unsigned long __action
asm("4") = action
;
81 register unsigned long __len
asm("5") = len
;
86 " diag %1, %3, 0x288\n"
90 : "+d" (err
) : "d"(__func
), "d"(__timeout
),
91 "d"(__action
), "d"(__len
) : "1", "cc");
95 static int __diag288_vm(unsigned int func
, unsigned int timeout
,
96 char *cmd
, size_t len
)
98 diag_stat_inc(DIAG_STAT_X288
);
99 return __diag288(func
, timeout
, virt_to_phys(cmd
), len
);
102 static int __diag288_lpar(unsigned int func
, unsigned int timeout
,
103 unsigned long action
)
105 diag_stat_inc(DIAG_STAT_X288
);
106 return __diag288(func
, timeout
, action
, 0);
109 static unsigned long wdt_status
;
111 #define DIAG_WDOG_BUSY 0
113 static int wdt_start(struct watchdog_device
*dev
)
120 if (test_and_set_bit(DIAG_WDOG_BUSY
, &wdt_status
))
126 ebc_cmd
= kmalloc(MAX_CMDLEN
, GFP_KERNEL
);
128 clear_bit(DIAG_WDOG_BUSY
, &wdt_status
);
131 len
= strlcpy(ebc_cmd
, wdt_cmd
, MAX_CMDLEN
);
132 ASCEBC(ebc_cmd
, MAX_CMDLEN
);
133 EBC_TOUPPER(ebc_cmd
, MAX_CMDLEN
);
135 func
= conceal_on
? (WDT_FUNC_INIT
| WDT_FUNC_CONCEAL
)
137 ret
= __diag288_vm(func
, dev
->timeout
, ebc_cmd
, len
);
141 ret
= __diag288_lpar(WDT_FUNC_INIT
,
142 dev
->timeout
, LPARWDT_RESTART
);
146 pr_err("The watchdog cannot be activated\n");
147 clear_bit(DIAG_WDOG_BUSY
, &wdt_status
);
153 static int wdt_stop(struct watchdog_device
*dev
)
157 diag_stat_inc(DIAG_STAT_X288
);
158 ret
= __diag288(WDT_FUNC_CANCEL
, 0, 0, 0);
160 clear_bit(DIAG_WDOG_BUSY
, &wdt_status
);
165 static int wdt_ping(struct watchdog_device
*dev
)
175 ebc_cmd
= kmalloc(MAX_CMDLEN
, GFP_KERNEL
);
178 len
= strlcpy(ebc_cmd
, wdt_cmd
, MAX_CMDLEN
);
179 ASCEBC(ebc_cmd
, MAX_CMDLEN
);
180 EBC_TOUPPER(ebc_cmd
, MAX_CMDLEN
);
183 * It seems to be ok to z/VM to use the init function to
184 * retrigger the watchdog. On LPAR WDT_FUNC_CHANGE must
185 * be used when the watchdog is running.
187 func
= conceal_on
? (WDT_FUNC_INIT
| WDT_FUNC_CONCEAL
)
190 ret
= __diag288_vm(func
, dev
->timeout
, ebc_cmd
, len
);
194 ret
= __diag288_lpar(WDT_FUNC_CHANGE
, dev
->timeout
, 0);
198 pr_err("The watchdog timer cannot be started or reset\n");
202 static int wdt_set_timeout(struct watchdog_device
* dev
, unsigned int new_to
)
204 dev
->timeout
= new_to
;
205 return wdt_ping(dev
);
208 static const struct watchdog_ops wdt_ops
= {
209 .owner
= THIS_MODULE
,
213 .set_timeout
= wdt_set_timeout
,
216 static const struct watchdog_info wdt_info
= {
217 .options
= WDIOF_SETTIMEOUT
| WDIOF_KEEPALIVEPING
| WDIOF_MAGICCLOSE
,
218 .firmware_version
= 0,
219 .identity
= "z Watchdog",
222 static struct watchdog_device wdt_dev
= {
227 .timeout
= WDT_DEFAULT_TIMEOUT
,
228 .min_timeout
= MIN_INTERVAL
,
229 .max_timeout
= MAX_INTERVAL
,
233 * It makes no sense to go into suspend while the watchdog is running.
234 * Depending on the memory size, the watchdog might trigger, while we
235 * are still saving the memory.
237 static int wdt_suspend(void)
239 if (test_and_set_bit(DIAG_WDOG_BUSY
, &wdt_status
)) {
240 pr_err("Linux cannot be suspended while the watchdog is in use\n");
241 return notifier_from_errno(-EBUSY
);
246 static int wdt_resume(void)
248 clear_bit(DIAG_WDOG_BUSY
, &wdt_status
);
252 static int wdt_power_event(struct notifier_block
*this, unsigned long event
,
256 case PM_POST_HIBERNATION
:
257 case PM_POST_SUSPEND
:
259 case PM_HIBERNATION_PREPARE
:
260 case PM_SUSPEND_PREPARE
:
261 return wdt_suspend();
267 static struct notifier_block wdt_power_notifier
= {
268 .notifier_call
= wdt_power_event
,
271 static int __init
diag288_init(void)
275 194, 197, 199, 201, 213
278 watchdog_set_nowayout(&wdt_dev
, nowayout_info
);
281 if (__diag288_vm(WDT_FUNC_INIT
, 15,
282 ebc_begin
, sizeof(ebc_begin
)) != 0) {
283 pr_err("The watchdog cannot be initialized\n");
287 if (__diag288_lpar(WDT_FUNC_INIT
, 30, LPARWDT_RESTART
)) {
288 pr_err("The watchdog cannot be initialized\n");
293 if (__diag288_lpar(WDT_FUNC_CANCEL
, 0, 0)) {
294 pr_err("The watchdog cannot be deactivated\n");
298 ret
= register_pm_notifier(&wdt_power_notifier
);
302 ret
= watchdog_register_device(&wdt_dev
);
304 unregister_pm_notifier(&wdt_power_notifier
);
309 static void __exit
diag288_exit(void)
311 watchdog_unregister_device(&wdt_dev
);
312 unregister_pm_notifier(&wdt_power_notifier
);
315 module_init(diag288_init
);
316 module_exit(diag288_exit
);