2 * Detect hard and soft lockups on a system
4 * started by Don Zickus, Copyright (C) 2010 Red Hat, Inc.
6 * Note: Most of this code is borrowed heavily from the original softlockup
7 * detector, so thanks to Ingo for the initial implementation.
8 * Some chunks also taken from the old x86-specific nmi watchdog code, thanks
9 * to those contributors as well.
12 #define pr_fmt(fmt) "NMI watchdog: " fmt
15 #include <linux/cpu.h>
16 #include <linux/nmi.h>
17 #include <linux/init.h>
18 #include <linux/delay.h>
19 #include <linux/freezer.h>
20 #include <linux/kthread.h>
21 #include <linux/lockdep.h>
22 #include <linux/notifier.h>
23 #include <linux/module.h>
24 #include <linux/sysctl.h>
26 #include <asm/irq_regs.h>
27 #include <linux/kvm_para.h>
28 #include <linux/perf_event.h>
30 int watchdog_enabled
= 1;
31 int __read_mostly watchdog_thresh
= 10;
33 static DEFINE_PER_CPU(unsigned long, watchdog_touch_ts
);
34 static DEFINE_PER_CPU(struct task_struct
*, softlockup_watchdog
);
35 static DEFINE_PER_CPU(struct hrtimer
, watchdog_hrtimer
);
36 static DEFINE_PER_CPU(bool, softlockup_touch_sync
);
37 static DEFINE_PER_CPU(bool, soft_watchdog_warn
);
38 #ifdef CONFIG_HARDLOCKUP_DETECTOR
39 static DEFINE_PER_CPU(bool, hard_watchdog_warn
);
40 static DEFINE_PER_CPU(bool, watchdog_nmi_touch
);
41 static DEFINE_PER_CPU(unsigned long, hrtimer_interrupts
);
42 static DEFINE_PER_CPU(unsigned long, hrtimer_interrupts_saved
);
43 static DEFINE_PER_CPU(struct perf_event
*, watchdog_ev
);
48 * Should we panic when a soft-lockup or hard-lockup occurs:
50 #ifdef CONFIG_HARDLOCKUP_DETECTOR
51 static int hardlockup_panic
=
52 CONFIG_BOOTPARAM_HARDLOCKUP_PANIC_VALUE
;
54 static int __init
hardlockup_panic_setup(char *str
)
56 if (!strncmp(str
, "panic", 5))
58 else if (!strncmp(str
, "nopanic", 7))
60 else if (!strncmp(str
, "0", 1))
64 __setup("nmi_watchdog=", hardlockup_panic_setup
);
67 unsigned int __read_mostly softlockup_panic
=
68 CONFIG_BOOTPARAM_SOFTLOCKUP_PANIC_VALUE
;
70 static int __init
softlockup_panic_setup(char *str
)
72 softlockup_panic
= simple_strtoul(str
, NULL
, 0);
76 __setup("softlockup_panic=", softlockup_panic_setup
);
78 static int __init
nowatchdog_setup(char *str
)
83 __setup("nowatchdog", nowatchdog_setup
);
86 static int __init
nosoftlockup_setup(char *str
)
91 __setup("nosoftlockup", nosoftlockup_setup
);
95 * Hard-lockup warnings should be triggered after just a few seconds. Soft-
96 * lockups can have false positives under extreme conditions. So we generally
97 * want a higher threshold for soft lockups than for hard lockups. So we couple
98 * the thresholds with a factor: we make the soft threshold twice the amount of
99 * time the hard threshold is.
101 static int get_softlockup_thresh(void)
103 return watchdog_thresh
* 2;
107 * Returns seconds, approximately. We don't need nanosecond
108 * resolution, and we don't need to waste time with a big divide when
111 static unsigned long get_timestamp(int this_cpu
)
113 return cpu_clock(this_cpu
) >> 30LL; /* 2^30 ~= 10^9 */
116 static unsigned long get_sample_period(void)
119 * convert watchdog_thresh from seconds to ns
120 * the divide by 5 is to give hrtimer several chances (two
121 * or three with the current relation between the soft
122 * and hard thresholds) to increment before the
123 * hardlockup detector generates a warning
125 return get_softlockup_thresh() * (NSEC_PER_SEC
/ 5);
128 /* Commands for resetting the watchdog */
129 static void __touch_watchdog(void)
131 int this_cpu
= smp_processor_id();
133 __this_cpu_write(watchdog_touch_ts
, get_timestamp(this_cpu
));
136 void touch_softlockup_watchdog(void)
138 __this_cpu_write(watchdog_touch_ts
, 0);
140 EXPORT_SYMBOL(touch_softlockup_watchdog
);
142 void touch_all_softlockup_watchdogs(void)
147 * this is done lockless
148 * do we care if a 0 races with a timestamp?
149 * all it means is the softlock check starts one cycle later
151 for_each_online_cpu(cpu
)
152 per_cpu(watchdog_touch_ts
, cpu
) = 0;
155 #ifdef CONFIG_HARDLOCKUP_DETECTOR
156 void touch_nmi_watchdog(void)
158 if (watchdog_enabled
) {
161 for_each_present_cpu(cpu
) {
162 if (per_cpu(watchdog_nmi_touch
, cpu
) != true)
163 per_cpu(watchdog_nmi_touch
, cpu
) = true;
166 touch_softlockup_watchdog();
168 EXPORT_SYMBOL(touch_nmi_watchdog
);
172 void touch_softlockup_watchdog_sync(void)
174 __raw_get_cpu_var(softlockup_touch_sync
) = true;
175 __raw_get_cpu_var(watchdog_touch_ts
) = 0;
178 #ifdef CONFIG_HARDLOCKUP_DETECTOR
179 /* watchdog detector functions */
180 static int is_hardlockup(void)
182 unsigned long hrint
= __this_cpu_read(hrtimer_interrupts
);
184 if (__this_cpu_read(hrtimer_interrupts_saved
) == hrint
)
187 __this_cpu_write(hrtimer_interrupts_saved
, hrint
);
192 static int is_softlockup(unsigned long touch_ts
)
194 unsigned long now
= get_timestamp(smp_processor_id());
196 /* Warn about unreasonable delays: */
197 if (time_after(now
, touch_ts
+ get_softlockup_thresh()))
198 return now
- touch_ts
;
203 #ifdef CONFIG_HARDLOCKUP_DETECTOR
205 static struct perf_event_attr wd_hw_attr
= {
206 .type
= PERF_TYPE_HARDWARE
,
207 .config
= PERF_COUNT_HW_CPU_CYCLES
,
208 .size
= sizeof(struct perf_event_attr
),
213 /* Callback function for perf event subsystem */
214 static void watchdog_overflow_callback(struct perf_event
*event
,
215 struct perf_sample_data
*data
,
216 struct pt_regs
*regs
)
218 /* Ensure the watchdog never gets throttled */
219 event
->hw
.interrupts
= 0;
221 if (__this_cpu_read(watchdog_nmi_touch
) == true) {
222 __this_cpu_write(watchdog_nmi_touch
, false);
226 /* check for a hardlockup
227 * This is done by making sure our timer interrupt
228 * is incrementing. The timer interrupt should have
229 * fired multiple times before we overflow'd. If it hasn't
230 * then this is a good indication the cpu is stuck
232 if (is_hardlockup()) {
233 int this_cpu
= smp_processor_id();
235 /* only print hardlockups once */
236 if (__this_cpu_read(hard_watchdog_warn
) == true)
239 if (hardlockup_panic
)
240 panic("Watchdog detected hard LOCKUP on cpu %d", this_cpu
);
242 WARN(1, "Watchdog detected hard LOCKUP on cpu %d", this_cpu
);
244 __this_cpu_write(hard_watchdog_warn
, true);
248 __this_cpu_write(hard_watchdog_warn
, false);
251 static void watchdog_interrupt_count(void)
253 __this_cpu_inc(hrtimer_interrupts
);
256 static inline void watchdog_interrupt_count(void) { return; }
257 #endif /* CONFIG_HARDLOCKUP_DETECTOR */
259 /* watchdog kicker functions */
260 static enum hrtimer_restart
watchdog_timer_fn(struct hrtimer
*hrtimer
)
262 unsigned long touch_ts
= __this_cpu_read(watchdog_touch_ts
);
263 struct pt_regs
*regs
= get_irq_regs();
266 /* kick the hardlockup detector */
267 watchdog_interrupt_count();
269 /* kick the softlockup detector */
270 wake_up_process(__this_cpu_read(softlockup_watchdog
));
273 hrtimer_forward_now(hrtimer
, ns_to_ktime(get_sample_period()));
276 if (unlikely(__this_cpu_read(softlockup_touch_sync
))) {
278 * If the time stamp was touched atomically
279 * make sure the scheduler tick is up to date.
281 __this_cpu_write(softlockup_touch_sync
, false);
285 /* Clear the guest paused flag on watchdog reset */
286 kvm_check_and_clear_guest_paused();
288 return HRTIMER_RESTART
;
291 /* check for a softlockup
292 * This is done by making sure a high priority task is
293 * being scheduled. The task touches the watchdog to
294 * indicate it is getting cpu time. If it hasn't then
295 * this is a good indication some task is hogging the cpu
297 duration
= is_softlockup(touch_ts
);
298 if (unlikely(duration
)) {
300 * If a virtual machine is stopped by the host it can look to
301 * the watchdog like a soft lockup, check to see if the host
302 * stopped the vm before we issue the warning
304 if (kvm_check_and_clear_guest_paused())
305 return HRTIMER_RESTART
;
308 if (__this_cpu_read(soft_watchdog_warn
) == true)
309 return HRTIMER_RESTART
;
311 printk(KERN_EMERG
"BUG: soft lockup - CPU#%d stuck for %us! [%s:%d]\n",
312 smp_processor_id(), duration
,
313 current
->comm
, task_pid_nr(current
));
315 print_irqtrace_events(current
);
321 if (softlockup_panic
)
322 panic("softlockup: hung tasks");
323 __this_cpu_write(soft_watchdog_warn
, true);
325 __this_cpu_write(soft_watchdog_warn
, false);
327 return HRTIMER_RESTART
;
332 * The watchdog thread - touches the timestamp.
334 static int watchdog(void *unused
)
336 struct sched_param param
= { .sched_priority
= 0 };
337 struct hrtimer
*hrtimer
= &__raw_get_cpu_var(watchdog_hrtimer
);
339 /* initialize timestamp */
342 /* kick off the timer for the hardlockup detector */
343 /* done here because hrtimer_start can only pin to smp_processor_id() */
344 hrtimer_start(hrtimer
, ns_to_ktime(get_sample_period()),
345 HRTIMER_MODE_REL_PINNED
);
347 set_current_state(TASK_INTERRUPTIBLE
);
349 * Run briefly (kicked by the hrtimer callback function) once every
350 * get_sample_period() seconds (4 seconds by default) to reset the
351 * softlockup timestamp. If this gets delayed for more than
352 * 2*watchdog_thresh seconds then the debug-printout triggers in
353 * watchdog_timer_fn().
355 while (!kthread_should_stop()) {
359 if (kthread_should_stop())
362 set_current_state(TASK_INTERRUPTIBLE
);
365 * Drop the policy/priority elevation during thread exit to avoid a
366 * scheduling latency spike.
368 __set_current_state(TASK_RUNNING
);
369 sched_setscheduler(current
, SCHED_NORMAL
, ¶m
);
374 #ifdef CONFIG_HARDLOCKUP_DETECTOR
376 * People like the simple clean cpu node info on boot.
377 * Reduce the watchdog noise by only printing messages
378 * that are different from what cpu0 displayed.
380 static unsigned long cpu0_err
;
382 static int watchdog_nmi_enable(int cpu
)
384 struct perf_event_attr
*wd_attr
;
385 struct perf_event
*event
= per_cpu(watchdog_ev
, cpu
);
387 /* is it already setup and enabled? */
388 if (event
&& event
->state
> PERF_EVENT_STATE_OFF
)
391 /* it is setup but not enabled */
395 wd_attr
= &wd_hw_attr
;
396 wd_attr
->sample_period
= hw_nmi_get_sample_period(watchdog_thresh
);
398 /* Try to register using hardware perf events */
399 event
= perf_event_create_kernel_counter(wd_attr
, cpu
, NULL
, watchdog_overflow_callback
, NULL
);
401 /* save cpu0 error for future comparision */
402 if (cpu
== 0 && IS_ERR(event
))
403 cpu0_err
= PTR_ERR(event
);
405 if (!IS_ERR(event
)) {
406 /* only print for cpu0 or different than cpu0 */
407 if (cpu
== 0 || cpu0_err
)
408 pr_info("enabled on all CPUs, permanently consumes one hw-PMU counter.\n");
412 /* skip displaying the same error again */
413 if (cpu
> 0 && (PTR_ERR(event
) == cpu0_err
))
414 return PTR_ERR(event
);
416 /* vary the KERN level based on the returned errno */
417 if (PTR_ERR(event
) == -EOPNOTSUPP
)
418 pr_info("disabled (cpu%i): not supported (no LAPIC?)\n", cpu
);
419 else if (PTR_ERR(event
) == -ENOENT
)
420 pr_warning("disabled (cpu%i): hardware events not enabled\n",
423 pr_err("disabled (cpu%i): unable to create perf event: %ld\n",
424 cpu
, PTR_ERR(event
));
425 return PTR_ERR(event
);
429 per_cpu(watchdog_ev
, cpu
) = event
;
431 perf_event_enable(per_cpu(watchdog_ev
, cpu
));
436 static void watchdog_nmi_disable(int cpu
)
438 struct perf_event
*event
= per_cpu(watchdog_ev
, cpu
);
441 perf_event_disable(event
);
442 per_cpu(watchdog_ev
, cpu
) = NULL
;
444 /* should be in cleanup, but blocks oprofile */
445 perf_event_release_kernel(event
);
450 static int watchdog_nmi_enable(int cpu
) { return 0; }
451 static void watchdog_nmi_disable(int cpu
) { return; }
452 #endif /* CONFIG_HARDLOCKUP_DETECTOR */
454 /* prepare/enable/disable routines */
455 static void watchdog_prepare_cpu(int cpu
)
457 struct hrtimer
*hrtimer
= &per_cpu(watchdog_hrtimer
, cpu
);
459 WARN_ON(per_cpu(softlockup_watchdog
, cpu
));
460 hrtimer_init(hrtimer
, CLOCK_MONOTONIC
, HRTIMER_MODE_REL
);
461 hrtimer
->function
= watchdog_timer_fn
;
464 static int watchdog_enable(int cpu
)
466 struct task_struct
*p
= per_cpu(softlockup_watchdog
, cpu
);
469 /* enable the perf event */
470 err
= watchdog_nmi_enable(cpu
);
472 /* Regardless of err above, fall through and start softlockup */
474 /* create the watchdog thread */
476 struct sched_param param
= { .sched_priority
= MAX_RT_PRIO
-1 };
477 p
= kthread_create_on_node(watchdog
, NULL
, cpu_to_node(cpu
), "watchdog/%d", cpu
);
479 pr_err("softlockup watchdog for %i failed\n", cpu
);
481 /* if hardlockup hasn't already set this */
483 /* and disable the perf event */
484 watchdog_nmi_disable(cpu
);
488 sched_setscheduler(p
, SCHED_FIFO
, ¶m
);
489 kthread_bind(p
, cpu
);
490 per_cpu(watchdog_touch_ts
, cpu
) = 0;
491 per_cpu(softlockup_watchdog
, cpu
) = p
;
499 static void watchdog_disable(int cpu
)
501 struct task_struct
*p
= per_cpu(softlockup_watchdog
, cpu
);
502 struct hrtimer
*hrtimer
= &per_cpu(watchdog_hrtimer
, cpu
);
505 * cancel the timer first to stop incrementing the stats
506 * and waking up the kthread
508 hrtimer_cancel(hrtimer
);
510 /* disable the perf event */
511 watchdog_nmi_disable(cpu
);
513 /* stop the watchdog thread */
515 per_cpu(softlockup_watchdog
, cpu
) = NULL
;
520 /* sysctl functions */
522 static void watchdog_enable_all_cpus(void)
526 watchdog_enabled
= 0;
528 for_each_online_cpu(cpu
)
529 if (!watchdog_enable(cpu
))
530 /* if any cpu succeeds, watchdog is considered
531 enabled for the system */
532 watchdog_enabled
= 1;
534 if (!watchdog_enabled
)
535 pr_err("failed to be enabled on some cpus\n");
539 static void watchdog_disable_all_cpus(void)
543 for_each_online_cpu(cpu
)
544 watchdog_disable(cpu
);
546 /* if all watchdogs are disabled, then they are disabled for the system */
547 watchdog_enabled
= 0;
552 * proc handler for /proc/sys/kernel/nmi_watchdog,watchdog_thresh
555 int proc_dowatchdog(struct ctl_table
*table
, int write
,
556 void __user
*buffer
, size_t *lenp
, loff_t
*ppos
)
560 ret
= proc_dointvec_minmax(table
, write
, buffer
, lenp
, ppos
);
564 if (watchdog_enabled
&& watchdog_thresh
)
565 watchdog_enable_all_cpus();
567 watchdog_disable_all_cpus();
572 #endif /* CONFIG_SYSCTL */
576 * Create/destroy watchdog threads as CPUs come and go:
579 cpu_callback(struct notifier_block
*nfb
, unsigned long action
, void *hcpu
)
581 int hotcpu
= (unsigned long)hcpu
;
585 case CPU_UP_PREPARE_FROZEN
:
586 watchdog_prepare_cpu(hotcpu
);
589 case CPU_ONLINE_FROZEN
:
590 if (watchdog_enabled
)
591 watchdog_enable(hotcpu
);
593 #ifdef CONFIG_HOTPLUG_CPU
594 case CPU_UP_CANCELED
:
595 case CPU_UP_CANCELED_FROZEN
:
596 watchdog_disable(hotcpu
);
599 case CPU_DEAD_FROZEN
:
600 watchdog_disable(hotcpu
);
602 #endif /* CONFIG_HOTPLUG_CPU */
606 * hardlockup and softlockup are not important enough
607 * to block cpu bring up. Just always succeed and
608 * rely on printk output to flag problems.
613 static struct notifier_block cpu_nfb
= {
614 .notifier_call
= cpu_callback
617 #ifdef CONFIG_SUSPEND
619 * On exit from suspend we force an offline->online transition on the boot CPU
620 * so that the PMU state that was lost while in suspended state gets set up
621 * properly for the boot CPU. This information is required for restarting the
624 void lockup_detector_bootcpu_resume(void)
626 void *cpu
= (void *)(long)smp_processor_id();
628 cpu_callback(&cpu_nfb
, CPU_DEAD_FROZEN
, cpu
);
629 cpu_callback(&cpu_nfb
, CPU_UP_PREPARE_FROZEN
, cpu
);
630 cpu_callback(&cpu_nfb
, CPU_ONLINE_FROZEN
, cpu
);
634 void __init
lockup_detector_init(void)
636 void *cpu
= (void *)(long)smp_processor_id();
639 err
= cpu_callback(&cpu_nfb
, CPU_UP_PREPARE
, cpu
);
640 WARN_ON(notifier_to_errno(err
));
642 cpu_callback(&cpu_nfb
, CPU_ONLINE
, cpu
);
643 register_cpu_notifier(&cpu_nfb
);