xref: /linux-6.15/kernel/hung_task.c (revision 5aec788a)
1 // SPDX-License-Identifier: GPL-2.0-only
2 /*
3  * Detect Hung Task
4  *
5  * kernel/hung_task.c - kernel thread for detecting tasks stuck in D state
6  *
7  */
8 
9 #include <linux/mm.h>
10 #include <linux/cpu.h>
11 #include <linux/nmi.h>
12 #include <linux/init.h>
13 #include <linux/delay.h>
14 #include <linux/freezer.h>
15 #include <linux/kthread.h>
16 #include <linux/lockdep.h>
17 #include <linux/export.h>
18 #include <linux/panic_notifier.h>
19 #include <linux/sysctl.h>
20 #include <linux/suspend.h>
21 #include <linux/utsname.h>
22 #include <linux/sched/signal.h>
23 #include <linux/sched/debug.h>
24 #include <linux/sched/sysctl.h>
25 
26 #include <trace/events/sched.h>
27 
28 /*
29  * The number of tasks checked:
30  */
31 int __read_mostly sysctl_hung_task_check_count = PID_MAX_LIMIT;
32 
33 /*
34  * Limit number of tasks checked in a batch.
35  *
36  * This value controls the preemptibility of khungtaskd since preemption
37  * is disabled during the critical section. It also controls the size of
38  * the RCU grace period. So it needs to be upper-bound.
39  */
40 #define HUNG_TASK_LOCK_BREAK (HZ / 10)
41 
42 /*
43  * Zero means infinite timeout - no checking done:
44  */
45 unsigned long __read_mostly sysctl_hung_task_timeout_secs = CONFIG_DEFAULT_HUNG_TASK_TIMEOUT;
46 
47 /*
48  * Zero (default value) means use sysctl_hung_task_timeout_secs:
49  */
50 unsigned long __read_mostly sysctl_hung_task_check_interval_secs;
51 
52 int __read_mostly sysctl_hung_task_warnings = 10;
53 
54 static int __read_mostly did_panic;
55 static bool hung_task_show_lock;
56 static bool hung_task_call_panic;
57 static bool hung_task_show_all_bt;
58 
59 static struct task_struct *watchdog_task;
60 
61 #ifdef CONFIG_SMP
62 /*
63  * Should we dump all CPUs backtraces in a hung task event?
64  * Defaults to 0, can be changed via sysctl.
65  */
66 static unsigned int __read_mostly sysctl_hung_task_all_cpu_backtrace;
67 #else
68 #define sysctl_hung_task_all_cpu_backtrace 0
69 #endif /* CONFIG_SMP */
70 
71 /*
72  * Should we panic (and reboot, if panic_timeout= is set) when a
73  * hung task is detected:
74  */
75 unsigned int __read_mostly sysctl_hung_task_panic =
76 				IS_ENABLED(CONFIG_BOOTPARAM_HUNG_TASK_PANIC);
77 
78 static int
79 hung_task_panic(struct notifier_block *this, unsigned long event, void *ptr)
80 {
81 	did_panic = 1;
82 
83 	return NOTIFY_DONE;
84 }
85 
86 static struct notifier_block panic_block = {
87 	.notifier_call = hung_task_panic,
88 };
89 
90 static void check_hung_task(struct task_struct *t, unsigned long timeout)
91 {
92 	unsigned long switch_count = t->nvcsw + t->nivcsw;
93 
94 	/*
95 	 * Ensure the task is not frozen.
96 	 * Also, skip vfork and any other user process that freezer should skip.
97 	 */
98 	if (unlikely(READ_ONCE(t->__state) & (TASK_FREEZABLE | TASK_FROZEN)))
99 		return;
100 
101 	/*
102 	 * When a freshly created task is scheduled once, changes its state to
103 	 * TASK_UNINTERRUPTIBLE without having ever been switched out once, it
104 	 * musn't be checked.
105 	 */
106 	if (unlikely(!switch_count))
107 		return;
108 
109 	if (switch_count != t->last_switch_count) {
110 		t->last_switch_count = switch_count;
111 		t->last_switch_time = jiffies;
112 		return;
113 	}
114 	if (time_is_after_jiffies(t->last_switch_time + timeout * HZ))
115 		return;
116 
117 	trace_sched_process_hang(t);
118 
119 	if (sysctl_hung_task_panic) {
120 		console_verbose();
121 		hung_task_show_lock = true;
122 		hung_task_call_panic = true;
123 	}
124 
125 	/*
126 	 * Ok, the task did not get scheduled for more than 2 minutes,
127 	 * complain:
128 	 */
129 	if (sysctl_hung_task_warnings) {
130 		if (sysctl_hung_task_warnings > 0)
131 			sysctl_hung_task_warnings--;
132 		pr_err("INFO: task %s:%d blocked for more than %ld seconds.\n",
133 		       t->comm, t->pid, (jiffies - t->last_switch_time) / HZ);
134 		pr_err("      %s %s %.*s\n",
135 			print_tainted(), init_utsname()->release,
136 			(int)strcspn(init_utsname()->version, " "),
137 			init_utsname()->version);
138 		pr_err("\"echo 0 > /proc/sys/kernel/hung_task_timeout_secs\""
139 			" disables this message.\n");
140 		sched_show_task(t);
141 		hung_task_show_lock = true;
142 
143 		if (sysctl_hung_task_all_cpu_backtrace)
144 			hung_task_show_all_bt = true;
145 	}
146 
147 	touch_nmi_watchdog();
148 }
149 
150 /*
151  * To avoid extending the RCU grace period for an unbounded amount of time,
152  * periodically exit the critical section and enter a new one.
153  *
154  * For preemptible RCU it is sufficient to call rcu_read_unlock in order
155  * to exit the grace period. For classic RCU, a reschedule is required.
156  */
157 static bool rcu_lock_break(struct task_struct *g, struct task_struct *t)
158 {
159 	bool can_cont;
160 
161 	get_task_struct(g);
162 	get_task_struct(t);
163 	rcu_read_unlock();
164 	cond_resched();
165 	rcu_read_lock();
166 	can_cont = pid_alive(g) && pid_alive(t);
167 	put_task_struct(t);
168 	put_task_struct(g);
169 
170 	return can_cont;
171 }
172 
173 /*
174  * Check whether a TASK_UNINTERRUPTIBLE does not get woken up for
175  * a really long time (120 seconds). If that happens, print out
176  * a warning.
177  */
178 static void check_hung_uninterruptible_tasks(unsigned long timeout)
179 {
180 	int max_count = sysctl_hung_task_check_count;
181 	unsigned long last_break = jiffies;
182 	struct task_struct *g, *t;
183 
184 	/*
185 	 * If the system crashed already then all bets are off,
186 	 * do not report extra hung tasks:
187 	 */
188 	if (test_taint(TAINT_DIE) || did_panic)
189 		return;
190 
191 	hung_task_show_lock = false;
192 	rcu_read_lock();
193 	for_each_process_thread(g, t) {
194 		unsigned int state;
195 
196 		if (!max_count--)
197 			goto unlock;
198 		if (time_after(jiffies, last_break + HUNG_TASK_LOCK_BREAK)) {
199 			if (!rcu_lock_break(g, t))
200 				goto unlock;
201 			last_break = jiffies;
202 		}
203 		/* skip the TASK_KILLABLE tasks -- these can be killed */
204 		state = READ_ONCE(t->__state);
205 		if ((state & TASK_UNINTERRUPTIBLE) &&
206 		    !(state & TASK_WAKEKILL))
207 			check_hung_task(t, timeout);
208 	}
209  unlock:
210 	rcu_read_unlock();
211 	if (hung_task_show_lock)
212 		debug_show_all_locks();
213 
214 	if (hung_task_show_all_bt) {
215 		hung_task_show_all_bt = false;
216 		trigger_all_cpu_backtrace();
217 	}
218 
219 	if (hung_task_call_panic)
220 		panic("hung_task: blocked tasks");
221 }
222 
223 static long hung_timeout_jiffies(unsigned long last_checked,
224 				 unsigned long timeout)
225 {
226 	/* timeout of 0 will disable the watchdog */
227 	return timeout ? last_checked - jiffies + timeout * HZ :
228 		MAX_SCHEDULE_TIMEOUT;
229 }
230 
231 #ifdef CONFIG_SYSCTL
232 /*
233  * Process updating of timeout sysctl
234  */
235 static int proc_dohung_task_timeout_secs(struct ctl_table *table, int write,
236 				  void *buffer,
237 				  size_t *lenp, loff_t *ppos)
238 {
239 	int ret;
240 
241 	ret = proc_doulongvec_minmax(table, write, buffer, lenp, ppos);
242 
243 	if (ret || !write)
244 		goto out;
245 
246 	wake_up_process(watchdog_task);
247 
248  out:
249 	return ret;
250 }
251 
252 /*
253  * This is needed for proc_doulongvec_minmax of sysctl_hung_task_timeout_secs
254  * and hung_task_check_interval_secs
255  */
256 static const unsigned long hung_task_timeout_max = (LONG_MAX / HZ);
257 static struct ctl_table hung_task_sysctls[] = {
258 #ifdef CONFIG_SMP
259 	{
260 		.procname	= "hung_task_all_cpu_backtrace",
261 		.data		= &sysctl_hung_task_all_cpu_backtrace,
262 		.maxlen		= sizeof(int),
263 		.mode		= 0644,
264 		.proc_handler	= proc_dointvec_minmax,
265 		.extra1		= SYSCTL_ZERO,
266 		.extra2		= SYSCTL_ONE,
267 	},
268 #endif /* CONFIG_SMP */
269 	{
270 		.procname	= "hung_task_panic",
271 		.data		= &sysctl_hung_task_panic,
272 		.maxlen		= sizeof(int),
273 		.mode		= 0644,
274 		.proc_handler	= proc_dointvec_minmax,
275 		.extra1		= SYSCTL_ZERO,
276 		.extra2		= SYSCTL_ONE,
277 	},
278 	{
279 		.procname	= "hung_task_check_count",
280 		.data		= &sysctl_hung_task_check_count,
281 		.maxlen		= sizeof(int),
282 		.mode		= 0644,
283 		.proc_handler	= proc_dointvec_minmax,
284 		.extra1		= SYSCTL_ZERO,
285 	},
286 	{
287 		.procname	= "hung_task_timeout_secs",
288 		.data		= &sysctl_hung_task_timeout_secs,
289 		.maxlen		= sizeof(unsigned long),
290 		.mode		= 0644,
291 		.proc_handler	= proc_dohung_task_timeout_secs,
292 		.extra2		= (void *)&hung_task_timeout_max,
293 	},
294 	{
295 		.procname	= "hung_task_check_interval_secs",
296 		.data		= &sysctl_hung_task_check_interval_secs,
297 		.maxlen		= sizeof(unsigned long),
298 		.mode		= 0644,
299 		.proc_handler	= proc_dohung_task_timeout_secs,
300 		.extra2		= (void *)&hung_task_timeout_max,
301 	},
302 	{
303 		.procname	= "hung_task_warnings",
304 		.data		= &sysctl_hung_task_warnings,
305 		.maxlen		= sizeof(int),
306 		.mode		= 0644,
307 		.proc_handler	= proc_dointvec_minmax,
308 		.extra1		= SYSCTL_NEG_ONE,
309 	},
310 	{}
311 };
312 
313 static void __init hung_task_sysctl_init(void)
314 {
315 	register_sysctl_init("kernel", hung_task_sysctls);
316 }
317 #else
318 #define hung_task_sysctl_init() do { } while (0)
319 #endif /* CONFIG_SYSCTL */
320 
321 
322 static atomic_t reset_hung_task = ATOMIC_INIT(0);
323 
324 void reset_hung_task_detector(void)
325 {
326 	atomic_set(&reset_hung_task, 1);
327 }
328 EXPORT_SYMBOL_GPL(reset_hung_task_detector);
329 
330 static bool hung_detector_suspended;
331 
332 static int hungtask_pm_notify(struct notifier_block *self,
333 			      unsigned long action, void *hcpu)
334 {
335 	switch (action) {
336 	case PM_SUSPEND_PREPARE:
337 	case PM_HIBERNATION_PREPARE:
338 	case PM_RESTORE_PREPARE:
339 		hung_detector_suspended = true;
340 		break;
341 	case PM_POST_SUSPEND:
342 	case PM_POST_HIBERNATION:
343 	case PM_POST_RESTORE:
344 		hung_detector_suspended = false;
345 		break;
346 	default:
347 		break;
348 	}
349 	return NOTIFY_OK;
350 }
351 
352 /*
353  * kthread which checks for tasks stuck in D state
354  */
355 static int watchdog(void *dummy)
356 {
357 	unsigned long hung_last_checked = jiffies;
358 
359 	set_user_nice(current, 0);
360 
361 	for ( ; ; ) {
362 		unsigned long timeout = sysctl_hung_task_timeout_secs;
363 		unsigned long interval = sysctl_hung_task_check_interval_secs;
364 		long t;
365 
366 		if (interval == 0)
367 			interval = timeout;
368 		interval = min_t(unsigned long, interval, timeout);
369 		t = hung_timeout_jiffies(hung_last_checked, interval);
370 		if (t <= 0) {
371 			if (!atomic_xchg(&reset_hung_task, 0) &&
372 			    !hung_detector_suspended)
373 				check_hung_uninterruptible_tasks(timeout);
374 			hung_last_checked = jiffies;
375 			continue;
376 		}
377 		schedule_timeout_interruptible(t);
378 	}
379 
380 	return 0;
381 }
382 
383 static int __init hung_task_init(void)
384 {
385 	atomic_notifier_chain_register(&panic_notifier_list, &panic_block);
386 
387 	/* Disable hung task detector on suspend */
388 	pm_notifier(hungtask_pm_notify, 0);
389 
390 	watchdog_task = kthread_run(watchdog, NULL, "khungtaskd");
391 	hung_task_sysctl_init();
392 
393 	return 0;
394 }
395 subsys_initcall(hung_task_init);
396