Thomas Gleixner | 457c899 | 2019-05-19 13:08:55 +0100 | [diff] [blame] | 1 | // SPDX-License-Identifier: GPL-2.0-only |
Matt Helsley | 8174f15 | 2008-10-18 20:27:19 -0700 | [diff] [blame] | 2 | /* |
| 3 | * kernel/freezer.c - Function to freeze a process |
| 4 | * |
| 5 | * Originally from kernel/power/process.c |
| 6 | */ |
| 7 | |
| 8 | #include <linux/interrupt.h> |
| 9 | #include <linux/suspend.h> |
Paul Gortmaker | 9984de1 | 2011-05-23 14:51:41 -0400 | [diff] [blame] | 10 | #include <linux/export.h> |
Matt Helsley | 8174f15 | 2008-10-18 20:27:19 -0700 | [diff] [blame] | 11 | #include <linux/syscalls.h> |
| 12 | #include <linux/freezer.h> |
Tejun Heo | 8a32c44 | 2011-11-21 12:32:23 -0800 | [diff] [blame] | 13 | #include <linux/kthread.h> |
Matt Helsley | 8174f15 | 2008-10-18 20:27:19 -0700 | [diff] [blame] | 14 | |
Tejun Heo | a320122 | 2011-11-21 12:32:25 -0800 | [diff] [blame] | 15 | /* total number of freezing conditions in effect */ |
Peter Zijlstra | f5d39b0 | 2022-08-22 13:18:22 +0200 | [diff] [blame] | 16 | DEFINE_STATIC_KEY_FALSE(freezer_active); |
| 17 | EXPORT_SYMBOL(freezer_active); |
Tejun Heo | a320122 | 2011-11-21 12:32:25 -0800 | [diff] [blame] | 18 | |
Peter Zijlstra | f5d39b0 | 2022-08-22 13:18:22 +0200 | [diff] [blame] | 19 | /* |
| 20 | * indicate whether PM freezing is in effect, protected by |
Pingfan Liu | 55f2503 | 2018-07-31 16:51:32 +0800 | [diff] [blame] | 21 | * system_transition_mutex |
| 22 | */ |
Tejun Heo | a320122 | 2011-11-21 12:32:25 -0800 | [diff] [blame] | 23 | bool pm_freezing; |
| 24 | bool pm_nosig_freezing; |
| 25 | |
Tejun Heo | 0c9af09 | 2011-11-21 12:32:24 -0800 | [diff] [blame] | 26 | /* protects freezing and frozen transitions */ |
| 27 | static DEFINE_SPINLOCK(freezer_lock); |
Matt Helsley | 8174f15 | 2008-10-18 20:27:19 -0700 | [diff] [blame] | 28 | |
Tejun Heo | a320122 | 2011-11-21 12:32:25 -0800 | [diff] [blame] | 29 | /** |
| 30 | * freezing_slow_path - slow path for testing whether a task needs to be frozen |
| 31 | * @p: task to be tested |
| 32 | * |
Peter Zijlstra | f5d39b0 | 2022-08-22 13:18:22 +0200 | [diff] [blame] | 33 | * This function is called by freezing() if freezer_active isn't zero |
Tejun Heo | a320122 | 2011-11-21 12:32:25 -0800 | [diff] [blame] | 34 | * and tests whether @p needs to enter and stay in frozen state. Can be |
| 35 | * called under any context. The freezers are responsible for ensuring the |
| 36 | * target tasks see the updated state. |
| 37 | */ |
| 38 | bool freezing_slow_path(struct task_struct *p) |
| 39 | { |
Colin Cross | 2b44c4d | 2013-07-24 17:41:33 -0700 | [diff] [blame] | 40 | if (p->flags & (PF_NOFREEZE | PF_SUSPEND_TASK)) |
Tejun Heo | a320122 | 2011-11-21 12:32:25 -0800 | [diff] [blame] | 41 | return false; |
| 42 | |
Michal Hocko | a34c80a | 2016-07-28 15:45:16 -0700 | [diff] [blame] | 43 | if (test_tsk_thread_flag(p, TIF_MEMDIE)) |
Cong Wang | 51fae6da | 2014-10-21 09:27:12 +0200 | [diff] [blame] | 44 | return false; |
| 45 | |
Tejun Heo | a320122 | 2011-11-21 12:32:25 -0800 | [diff] [blame] | 46 | if (pm_nosig_freezing || cgroup_freezing(p)) |
| 47 | return true; |
| 48 | |
Tejun Heo | 34b087e | 2011-11-23 09:28:17 -0800 | [diff] [blame] | 49 | if (pm_freezing && !(p->flags & PF_KTHREAD)) |
Tejun Heo | a320122 | 2011-11-21 12:32:25 -0800 | [diff] [blame] | 50 | return true; |
| 51 | |
| 52 | return false; |
| 53 | } |
| 54 | EXPORT_SYMBOL(freezing_slow_path); |
| 55 | |
Peter Zijlstra | f5d39b0 | 2022-08-22 13:18:22 +0200 | [diff] [blame] | 56 | bool frozen(struct task_struct *p) |
| 57 | { |
| 58 | return READ_ONCE(p->__state) & TASK_FROZEN; |
| 59 | } |
| 60 | |
Matt Helsley | 8174f15 | 2008-10-18 20:27:19 -0700 | [diff] [blame] | 61 | /* Refrigerator is place where frozen processes are stored :-). */ |
Tejun Heo | 8a32c44 | 2011-11-21 12:32:23 -0800 | [diff] [blame] | 62 | bool __refrigerator(bool check_kthr_stop) |
Matt Helsley | 8174f15 | 2008-10-18 20:27:19 -0700 | [diff] [blame] | 63 | { |
Peter Zijlstra | f5d39b0 | 2022-08-22 13:18:22 +0200 | [diff] [blame] | 64 | unsigned int state = get_current_state(); |
Tejun Heo | a0acae0 | 2011-11-21 12:32:22 -0800 | [diff] [blame] | 65 | bool was_frozen = false; |
Matt Helsley | 8174f15 | 2008-10-18 20:27:19 -0700 | [diff] [blame] | 66 | |
Matt Helsley | 8174f15 | 2008-10-18 20:27:19 -0700 | [diff] [blame] | 67 | pr_debug("%s entered refrigerator\n", current->comm); |
| 68 | |
Peter Zijlstra | f5d39b0 | 2022-08-22 13:18:22 +0200 | [diff] [blame] | 69 | WARN_ON_ONCE(state && !(state & TASK_NORMAL)); |
| 70 | |
Matt Helsley | 8174f15 | 2008-10-18 20:27:19 -0700 | [diff] [blame] | 71 | for (;;) { |
Peter Zijlstra | f5d39b0 | 2022-08-22 13:18:22 +0200 | [diff] [blame] | 72 | bool freeze; |
| 73 | |
| 74 | set_current_state(TASK_FROZEN); |
Tejun Heo | 5ece3ea | 2011-11-21 12:32:26 -0800 | [diff] [blame] | 75 | |
| 76 | spin_lock_irq(&freezer_lock); |
Peter Zijlstra | f5d39b0 | 2022-08-22 13:18:22 +0200 | [diff] [blame] | 77 | freeze = freezing(current) && !(check_kthr_stop && kthread_should_stop()); |
Tejun Heo | 5ece3ea | 2011-11-21 12:32:26 -0800 | [diff] [blame] | 78 | spin_unlock_irq(&freezer_lock); |
| 79 | |
Peter Zijlstra | f5d39b0 | 2022-08-22 13:18:22 +0200 | [diff] [blame] | 80 | if (!freeze) |
Matt Helsley | 8174f15 | 2008-10-18 20:27:19 -0700 | [diff] [blame] | 81 | break; |
Peter Zijlstra | f5d39b0 | 2022-08-22 13:18:22 +0200 | [diff] [blame] | 82 | |
Tejun Heo | a0acae0 | 2011-11-21 12:32:22 -0800 | [diff] [blame] | 83 | was_frozen = true; |
Matt Helsley | 8174f15 | 2008-10-18 20:27:19 -0700 | [diff] [blame] | 84 | schedule(); |
| 85 | } |
Peter Zijlstra | f5d39b0 | 2022-08-22 13:18:22 +0200 | [diff] [blame] | 86 | __set_current_state(TASK_RUNNING); |
Thomas Gleixner | 6301cb9 | 2009-07-17 14:15:47 +0200 | [diff] [blame] | 87 | |
Matt Helsley | 8174f15 | 2008-10-18 20:27:19 -0700 | [diff] [blame] | 88 | pr_debug("%s left refrigerator\n", current->comm); |
Tejun Heo | 50fb4f7f | 2011-11-21 12:32:22 -0800 | [diff] [blame] | 89 | |
Tejun Heo | a0acae0 | 2011-11-21 12:32:22 -0800 | [diff] [blame] | 90 | return was_frozen; |
Matt Helsley | 8174f15 | 2008-10-18 20:27:19 -0700 | [diff] [blame] | 91 | } |
Tejun Heo | a0acae0 | 2011-11-21 12:32:22 -0800 | [diff] [blame] | 92 | EXPORT_SYMBOL(__refrigerator); |
Matt Helsley | 8174f15 | 2008-10-18 20:27:19 -0700 | [diff] [blame] | 93 | |
| 94 | static void fake_signal_wake_up(struct task_struct *p) |
| 95 | { |
| 96 | unsigned long flags; |
| 97 | |
Tejun Heo | 37ad8ac | 2011-11-21 12:32:26 -0800 | [diff] [blame] | 98 | if (lock_task_sighand(p, &flags)) { |
| 99 | signal_wake_up(p, 0); |
| 100 | unlock_task_sighand(p, &flags); |
| 101 | } |
Matt Helsley | 8174f15 | 2008-10-18 20:27:19 -0700 | [diff] [blame] | 102 | } |
| 103 | |
Peter Zijlstra | f5d39b0 | 2022-08-22 13:18:22 +0200 | [diff] [blame] | 104 | static int __set_task_frozen(struct task_struct *p, void *arg) |
| 105 | { |
| 106 | unsigned int state = READ_ONCE(p->__state); |
| 107 | |
| 108 | if (p->on_rq) |
| 109 | return 0; |
| 110 | |
| 111 | if (p != current && task_curr(p)) |
| 112 | return 0; |
| 113 | |
| 114 | if (!(state & (TASK_FREEZABLE | __TASK_STOPPED | __TASK_TRACED))) |
| 115 | return 0; |
| 116 | |
| 117 | /* |
| 118 | * Only TASK_NORMAL can be augmented with TASK_FREEZABLE, since they |
| 119 | * can suffer spurious wakeups. |
| 120 | */ |
| 121 | if (state & TASK_FREEZABLE) |
| 122 | WARN_ON_ONCE(!(state & TASK_NORMAL)); |
| 123 | |
| 124 | #ifdef CONFIG_LOCKDEP |
| 125 | /* |
| 126 | * It's dangerous to freeze with locks held; there be dragons there. |
| 127 | */ |
| 128 | if (!(state & __TASK_FREEZABLE_UNSAFE)) |
| 129 | WARN_ON_ONCE(debug_locks && p->lockdep_depth); |
| 130 | #endif |
| 131 | |
| 132 | WRITE_ONCE(p->__state, TASK_FROZEN); |
| 133 | return TASK_FROZEN; |
| 134 | } |
| 135 | |
| 136 | static bool __freeze_task(struct task_struct *p) |
| 137 | { |
| 138 | /* TASK_FREEZABLE|TASK_STOPPED|TASK_TRACED -> TASK_FROZEN */ |
| 139 | return task_call_func(p, __set_task_frozen, NULL); |
| 140 | } |
| 141 | |
Matt Helsley | 8174f15 | 2008-10-18 20:27:19 -0700 | [diff] [blame] | 142 | /** |
Tejun Heo | 839e340 | 2011-11-21 12:32:26 -0800 | [diff] [blame] | 143 | * freeze_task - send a freeze request to given task |
| 144 | * @p: task to send the request to |
Matt Helsley | 8174f15 | 2008-10-18 20:27:19 -0700 | [diff] [blame] | 145 | * |
Marcos Paulo de Souza | 37f08be | 2012-02-21 23:57:47 +0100 | [diff] [blame] | 146 | * If @p is freezing, the freeze request is sent either by sending a fake |
| 147 | * signal (if it's not a kernel thread) or waking it up (if it's a kernel |
| 148 | * thread). |
Tejun Heo | 839e340 | 2011-11-21 12:32:26 -0800 | [diff] [blame] | 149 | * |
| 150 | * RETURNS: |
| 151 | * %false, if @p is not freezing or already frozen; %true, otherwise |
Matt Helsley | 8174f15 | 2008-10-18 20:27:19 -0700 | [diff] [blame] | 152 | */ |
Tejun Heo | 839e340 | 2011-11-21 12:32:26 -0800 | [diff] [blame] | 153 | bool freeze_task(struct task_struct *p) |
Matt Helsley | 8174f15 | 2008-10-18 20:27:19 -0700 | [diff] [blame] | 154 | { |
Tejun Heo | 0c9af09 | 2011-11-21 12:32:24 -0800 | [diff] [blame] | 155 | unsigned long flags; |
Matt Helsley | 8174f15 | 2008-10-18 20:27:19 -0700 | [diff] [blame] | 156 | |
Tejun Heo | 0c9af09 | 2011-11-21 12:32:24 -0800 | [diff] [blame] | 157 | spin_lock_irqsave(&freezer_lock, flags); |
Peter Zijlstra | f5d39b0 | 2022-08-22 13:18:22 +0200 | [diff] [blame] | 158 | if (!freezing(p) || frozen(p) || __freeze_task(p)) { |
Tejun Heo | a320122 | 2011-11-21 12:32:25 -0800 | [diff] [blame] | 159 | spin_unlock_irqrestore(&freezer_lock, flags); |
| 160 | return false; |
| 161 | } |
Matt Helsley | 8174f15 | 2008-10-18 20:27:19 -0700 | [diff] [blame] | 162 | |
Jens Axboe | d3dc04c | 2021-03-25 18:22:11 -0600 | [diff] [blame] | 163 | if (!(p->flags & PF_KTHREAD)) |
Tejun Heo | 8cfe400 | 2010-11-26 23:07:27 +0100 | [diff] [blame] | 164 | fake_signal_wake_up(p); |
Oleg Nesterov | 5d8f72b | 2012-10-26 19:46:06 +0200 | [diff] [blame] | 165 | else |
Peter Zijlstra | f5d39b0 | 2022-08-22 13:18:22 +0200 | [diff] [blame] | 166 | wake_up_state(p, TASK_NORMAL); |
Tejun Heo | a320122 | 2011-11-21 12:32:25 -0800 | [diff] [blame] | 167 | |
Tejun Heo | 0c9af09 | 2011-11-21 12:32:24 -0800 | [diff] [blame] | 168 | spin_unlock_irqrestore(&freezer_lock, flags); |
Tejun Heo | a320122 | 2011-11-21 12:32:25 -0800 | [diff] [blame] | 169 | return true; |
Matt Helsley | 8174f15 | 2008-10-18 20:27:19 -0700 | [diff] [blame] | 170 | } |
| 171 | |
Peter Zijlstra | f5d39b0 | 2022-08-22 13:18:22 +0200 | [diff] [blame] | 172 | /* |
| 173 | * The special task states (TASK_STOPPED, TASK_TRACED) keep their canonical |
| 174 | * state in p->jobctl. If either of them got a wakeup that was missed because |
| 175 | * TASK_FROZEN, then their canonical state reflects that and the below will |
| 176 | * refuse to restore the special state and instead issue the wakeup. |
| 177 | */ |
| 178 | static int __set_task_special(struct task_struct *p, void *arg) |
| 179 | { |
| 180 | unsigned int state = 0; |
| 181 | |
| 182 | if (p->jobctl & JOBCTL_TRACED) |
| 183 | state = TASK_TRACED; |
| 184 | |
| 185 | else if (p->jobctl & JOBCTL_STOPPED) |
| 186 | state = TASK_STOPPED; |
| 187 | |
| 188 | if (state) |
| 189 | WRITE_ONCE(p->__state, state); |
| 190 | |
| 191 | return state; |
| 192 | } |
| 193 | |
Tejun Heo | a5be2d0 | 2011-11-21 12:32:23 -0800 | [diff] [blame] | 194 | void __thaw_task(struct task_struct *p) |
Matt Helsley | dc52ddc | 2008-10-18 20:27:21 -0700 | [diff] [blame] | 195 | { |
Peter Zijlstra | f5d39b0 | 2022-08-22 13:18:22 +0200 | [diff] [blame] | 196 | unsigned long flags, flags2; |
Tejun Heo | a5be2d0 | 2011-11-21 12:32:23 -0800 | [diff] [blame] | 197 | |
Tejun Heo | 0c9af09 | 2011-11-21 12:32:24 -0800 | [diff] [blame] | 198 | spin_lock_irqsave(&freezer_lock, flags); |
Peter Zijlstra | f5d39b0 | 2022-08-22 13:18:22 +0200 | [diff] [blame] | 199 | if (WARN_ON_ONCE(freezing(p))) |
| 200 | goto unlock; |
| 201 | |
| 202 | if (lock_task_sighand(p, &flags2)) { |
| 203 | /* TASK_FROZEN -> TASK_{STOPPED,TRACED} */ |
| 204 | bool ret = task_call_func(p, __set_task_special, NULL); |
| 205 | unlock_task_sighand(p, &flags2); |
| 206 | if (ret) |
| 207 | goto unlock; |
| 208 | } |
| 209 | |
| 210 | wake_up_state(p, TASK_FROZEN); |
| 211 | unlock: |
Tejun Heo | 0c9af09 | 2011-11-21 12:32:24 -0800 | [diff] [blame] | 212 | spin_unlock_irqrestore(&freezer_lock, flags); |
Matt Helsley | dc52ddc | 2008-10-18 20:27:21 -0700 | [diff] [blame] | 213 | } |
Tejun Heo | 96ee6d8 | 2011-11-21 12:32:25 -0800 | [diff] [blame] | 214 | |
| 215 | /** |
Tejun Heo | 34b087e | 2011-11-23 09:28:17 -0800 | [diff] [blame] | 216 | * set_freezable - make %current freezable |
Tejun Heo | 96ee6d8 | 2011-11-21 12:32:25 -0800 | [diff] [blame] | 217 | * |
| 218 | * Mark %current freezable and enter refrigerator if necessary. |
| 219 | */ |
Tejun Heo | 34b087e | 2011-11-23 09:28:17 -0800 | [diff] [blame] | 220 | bool set_freezable(void) |
Tejun Heo | 96ee6d8 | 2011-11-21 12:32:25 -0800 | [diff] [blame] | 221 | { |
| 222 | might_sleep(); |
| 223 | |
| 224 | /* |
| 225 | * Modify flags while holding freezer_lock. This ensures the |
| 226 | * freezer notices that we aren't frozen yet or the freezing |
| 227 | * condition is visible to try_to_freeze() below. |
| 228 | */ |
| 229 | spin_lock_irq(&freezer_lock); |
| 230 | current->flags &= ~PF_NOFREEZE; |
Tejun Heo | 96ee6d8 | 2011-11-21 12:32:25 -0800 | [diff] [blame] | 231 | spin_unlock_irq(&freezer_lock); |
| 232 | |
| 233 | return try_to_freeze(); |
| 234 | } |
Tejun Heo | 34b087e | 2011-11-23 09:28:17 -0800 | [diff] [blame] | 235 | EXPORT_SYMBOL(set_freezable); |