1 /* SPDX-License-Identifier: GPL-2.0 */ 2 /* 3 * Tick related global functions 4 */ 5 #ifndef _LINUX_TICK_H 6 #define _LINUX_TICK_H 7 8 #include <linux/clockchips.h> 9 #include <linux/irqflags.h> 10 #include <linux/percpu.h> 11 #include <linux/context_tracking_state.h> 12 #include <linux/cpumask.h> 13 #include <linux/sched.h> 14 #include <linux/rcupdate.h> 15 16 #ifdef CONFIG_GENERIC_CLOCKEVENTS 17 extern void __init tick_init(void); 18 /* Should be core only, but ARM BL switcher requires it */ 19 extern void tick_suspend_local(void); 20 /* Should be core only, but XEN resume magic and ARM BL switcher require it */ 21 extern void tick_resume_local(void); 22 extern void tick_handover_do_timer(void); 23 extern void tick_cleanup_dead_cpu(int cpu); 24 #else /* CONFIG_GENERIC_CLOCKEVENTS */ 25 static inline void tick_init(void) { } 26 static inline void tick_suspend_local(void) { } 27 static inline void tick_resume_local(void) { } 28 static inline void tick_handover_do_timer(void) { } 29 static inline void tick_cleanup_dead_cpu(int cpu) { } 30 #endif /* !CONFIG_GENERIC_CLOCKEVENTS */ 31 32 #if defined(CONFIG_GENERIC_CLOCKEVENTS) && defined(CONFIG_SUSPEND) 33 extern void tick_freeze(void); 34 extern void tick_unfreeze(void); 35 #else 36 static inline void tick_freeze(void) { } 37 static inline void tick_unfreeze(void) { } 38 #endif 39 40 #ifdef CONFIG_TICK_ONESHOT 41 extern void tick_irq_enter(void); 42 # ifndef arch_needs_cpu 43 # define arch_needs_cpu() (0) 44 # endif 45 # else 46 static inline void tick_irq_enter(void) { } 47 #endif 48 49 #if defined(CONFIG_GENERIC_CLOCKEVENTS_BROADCAST) && defined(CONFIG_TICK_ONESHOT) 50 extern void hotplug_cpu__broadcast_tick_pull(int dead_cpu); 51 #else 52 static inline void hotplug_cpu__broadcast_tick_pull(int dead_cpu) { } 53 #endif 54 55 enum tick_broadcast_mode { 56 TICK_BROADCAST_OFF, 57 TICK_BROADCAST_ON, 58 TICK_BROADCAST_FORCE, 59 }; 60 61 enum tick_broadcast_state { 62 TICK_BROADCAST_EXIT, 63 TICK_BROADCAST_ENTER, 64 }; 65 66 #ifdef CONFIG_GENERIC_CLOCKEVENTS_BROADCAST 67 extern void tick_broadcast_control(enum tick_broadcast_mode mode); 68 #else 69 static inline void tick_broadcast_control(enum tick_broadcast_mode mode) { } 70 #endif /* BROADCAST */ 71 72 #if defined(CONFIG_GENERIC_CLOCKEVENTS_BROADCAST) && defined(CONFIG_HOTPLUG_CPU) 73 extern void tick_offline_cpu(unsigned int cpu); 74 #else 75 static inline void tick_offline_cpu(unsigned int cpu) { } 76 #endif 77 78 #ifdef CONFIG_GENERIC_CLOCKEVENTS 79 extern int tick_broadcast_oneshot_control(enum tick_broadcast_state state); 80 #else 81 static inline int tick_broadcast_oneshot_control(enum tick_broadcast_state state) 82 { 83 return 0; 84 } 85 #endif 86 87 static inline void tick_broadcast_enable(void) 88 { 89 tick_broadcast_control(TICK_BROADCAST_ON); 90 } 91 static inline void tick_broadcast_disable(void) 92 { 93 tick_broadcast_control(TICK_BROADCAST_OFF); 94 } 95 static inline void tick_broadcast_force(void) 96 { 97 tick_broadcast_control(TICK_BROADCAST_FORCE); 98 } 99 static inline int tick_broadcast_enter(void) 100 { 101 return tick_broadcast_oneshot_control(TICK_BROADCAST_ENTER); 102 } 103 static inline void tick_broadcast_exit(void) 104 { 105 tick_broadcast_oneshot_control(TICK_BROADCAST_EXIT); 106 } 107 108 enum tick_dep_bits { 109 TICK_DEP_BIT_POSIX_TIMER = 0, 110 TICK_DEP_BIT_PERF_EVENTS = 1, 111 TICK_DEP_BIT_SCHED = 2, 112 TICK_DEP_BIT_CLOCK_UNSTABLE = 3, 113 TICK_DEP_BIT_RCU = 4, 114 TICK_DEP_BIT_RCU_EXP = 5 115 }; 116 #define TICK_DEP_BIT_MAX TICK_DEP_BIT_RCU_EXP 117 118 #define TICK_DEP_MASK_NONE 0 119 #define TICK_DEP_MASK_POSIX_TIMER (1 << TICK_DEP_BIT_POSIX_TIMER) 120 #define TICK_DEP_MASK_PERF_EVENTS (1 << TICK_DEP_BIT_PERF_EVENTS) 121 #define TICK_DEP_MASK_SCHED (1 << TICK_DEP_BIT_SCHED) 122 #define TICK_DEP_MASK_CLOCK_UNSTABLE (1 << TICK_DEP_BIT_CLOCK_UNSTABLE) 123 #define TICK_DEP_MASK_RCU (1 << TICK_DEP_BIT_RCU) 124 #define TICK_DEP_MASK_RCU_EXP (1 << TICK_DEP_BIT_RCU_EXP) 125 126 #ifdef CONFIG_NO_HZ_COMMON 127 extern bool tick_nohz_enabled; 128 extern bool tick_nohz_tick_stopped(void); 129 extern bool tick_nohz_tick_stopped_cpu(int cpu); 130 extern void tick_nohz_idle_stop_tick(void); 131 extern void tick_nohz_idle_retain_tick(void); 132 extern void tick_nohz_idle_restart_tick(void); 133 extern void tick_nohz_idle_enter(void); 134 extern void tick_nohz_idle_exit(void); 135 extern void tick_nohz_irq_exit(void); 136 extern bool tick_nohz_idle_got_tick(void); 137 extern ktime_t tick_nohz_get_next_hrtimer(void); 138 extern ktime_t tick_nohz_get_sleep_length(ktime_t *delta_next); 139 extern unsigned long tick_nohz_get_idle_calls(void); 140 extern unsigned long tick_nohz_get_idle_calls_cpu(int cpu); 141 extern u64 get_cpu_idle_time_us(int cpu, u64 *last_update_time); 142 extern u64 get_cpu_iowait_time_us(int cpu, u64 *last_update_time); 143 #else /* !CONFIG_NO_HZ_COMMON */ 144 #define tick_nohz_enabled (0) 145 static inline int tick_nohz_tick_stopped(void) { return 0; } 146 static inline int tick_nohz_tick_stopped_cpu(int cpu) { return 0; } 147 static inline void tick_nohz_idle_stop_tick(void) { } 148 static inline void tick_nohz_idle_retain_tick(void) { } 149 static inline void tick_nohz_idle_restart_tick(void) { } 150 static inline void tick_nohz_idle_enter(void) { } 151 static inline void tick_nohz_idle_exit(void) { } 152 static inline bool tick_nohz_idle_got_tick(void) { return false; } 153 static inline ktime_t tick_nohz_get_next_hrtimer(void) 154 { 155 /* Next wake up is the tick period, assume it starts now */ 156 return ktime_add(ktime_get(), TICK_NSEC); 157 } 158 static inline ktime_t tick_nohz_get_sleep_length(ktime_t *delta_next) 159 { 160 *delta_next = TICK_NSEC; 161 return *delta_next; 162 } 163 static inline u64 get_cpu_idle_time_us(int cpu, u64 *unused) { return -1; } 164 static inline u64 get_cpu_iowait_time_us(int cpu, u64 *unused) { return -1; } 165 #endif /* !CONFIG_NO_HZ_COMMON */ 166 167 #ifdef CONFIG_NO_HZ_FULL 168 extern bool tick_nohz_full_running; 169 extern cpumask_var_t tick_nohz_full_mask; 170 171 static inline bool tick_nohz_full_enabled(void) 172 { 173 if (!context_tracking_enabled()) 174 return false; 175 176 return tick_nohz_full_running; 177 } 178 179 /* 180 * Check if a CPU is part of the nohz_full subset. Arrange for evaluating 181 * the cpu expression (typically smp_processor_id()) _after_ the static 182 * key. 183 */ 184 #define tick_nohz_full_cpu(_cpu) ({ \ 185 bool __ret = false; \ 186 if (tick_nohz_full_enabled()) \ 187 __ret = cpumask_test_cpu((_cpu), tick_nohz_full_mask); \ 188 __ret; \ 189 }) 190 191 static inline void tick_nohz_full_add_cpus_to(struct cpumask *mask) 192 { 193 if (tick_nohz_full_enabled()) 194 cpumask_or(mask, mask, tick_nohz_full_mask); 195 } 196 197 extern void tick_nohz_dep_set(enum tick_dep_bits bit); 198 extern void tick_nohz_dep_clear(enum tick_dep_bits bit); 199 extern void tick_nohz_dep_set_cpu(int cpu, enum tick_dep_bits bit); 200 extern void tick_nohz_dep_clear_cpu(int cpu, enum tick_dep_bits bit); 201 extern void tick_nohz_dep_set_task(struct task_struct *tsk, 202 enum tick_dep_bits bit); 203 extern void tick_nohz_dep_clear_task(struct task_struct *tsk, 204 enum tick_dep_bits bit); 205 extern void tick_nohz_dep_set_signal(struct task_struct *tsk, 206 enum tick_dep_bits bit); 207 extern void tick_nohz_dep_clear_signal(struct signal_struct *signal, 208 enum tick_dep_bits bit); 209 extern bool tick_nohz_cpu_hotpluggable(unsigned int cpu); 210 211 /* 212 * The below are tick_nohz_[set,clear]_dep() wrappers that optimize off-cases 213 * on top of static keys. 214 */ 215 static inline void tick_dep_set(enum tick_dep_bits bit) 216 { 217 if (tick_nohz_full_enabled()) 218 tick_nohz_dep_set(bit); 219 } 220 221 static inline void tick_dep_clear(enum tick_dep_bits bit) 222 { 223 if (tick_nohz_full_enabled()) 224 tick_nohz_dep_clear(bit); 225 } 226 227 static inline void tick_dep_set_cpu(int cpu, enum tick_dep_bits bit) 228 { 229 if (tick_nohz_full_cpu(cpu)) 230 tick_nohz_dep_set_cpu(cpu, bit); 231 } 232 233 static inline void tick_dep_clear_cpu(int cpu, enum tick_dep_bits bit) 234 { 235 if (tick_nohz_full_cpu(cpu)) 236 tick_nohz_dep_clear_cpu(cpu, bit); 237 } 238 239 static inline void tick_dep_set_task(struct task_struct *tsk, 240 enum tick_dep_bits bit) 241 { 242 if (tick_nohz_full_enabled()) 243 tick_nohz_dep_set_task(tsk, bit); 244 } 245 static inline void tick_dep_clear_task(struct task_struct *tsk, 246 enum tick_dep_bits bit) 247 { 248 if (tick_nohz_full_enabled()) 249 tick_nohz_dep_clear_task(tsk, bit); 250 } 251 static inline void tick_dep_set_signal(struct task_struct *tsk, 252 enum tick_dep_bits bit) 253 { 254 if (tick_nohz_full_enabled()) 255 tick_nohz_dep_set_signal(tsk, bit); 256 } 257 static inline void tick_dep_clear_signal(struct signal_struct *signal, 258 enum tick_dep_bits bit) 259 { 260 if (tick_nohz_full_enabled()) 261 tick_nohz_dep_clear_signal(signal, bit); 262 } 263 264 extern void tick_nohz_full_kick_cpu(int cpu); 265 extern void __tick_nohz_task_switch(void); 266 extern void __init tick_nohz_full_setup(cpumask_var_t cpumask); 267 #else 268 static inline bool tick_nohz_full_enabled(void) { return false; } 269 static inline bool tick_nohz_full_cpu(int cpu) { return false; } 270 static inline void tick_nohz_full_add_cpus_to(struct cpumask *mask) { } 271 272 static inline void tick_nohz_dep_set_cpu(int cpu, enum tick_dep_bits bit) { } 273 static inline void tick_nohz_dep_clear_cpu(int cpu, enum tick_dep_bits bit) { } 274 static inline bool tick_nohz_cpu_hotpluggable(unsigned int cpu) { return true; } 275 276 static inline void tick_dep_set(enum tick_dep_bits bit) { } 277 static inline void tick_dep_clear(enum tick_dep_bits bit) { } 278 static inline void tick_dep_set_cpu(int cpu, enum tick_dep_bits bit) { } 279 static inline void tick_dep_clear_cpu(int cpu, enum tick_dep_bits bit) { } 280 static inline void tick_dep_set_task(struct task_struct *tsk, 281 enum tick_dep_bits bit) { } 282 static inline void tick_dep_clear_task(struct task_struct *tsk, 283 enum tick_dep_bits bit) { } 284 static inline void tick_dep_set_signal(struct task_struct *tsk, 285 enum tick_dep_bits bit) { } 286 static inline void tick_dep_clear_signal(struct signal_struct *signal, 287 enum tick_dep_bits bit) { } 288 289 static inline void tick_nohz_full_kick_cpu(int cpu) { } 290 static inline void __tick_nohz_task_switch(void) { } 291 static inline void tick_nohz_full_setup(cpumask_var_t cpumask) { } 292 #endif 293 294 static inline void tick_nohz_task_switch(void) 295 { 296 if (tick_nohz_full_enabled()) 297 __tick_nohz_task_switch(); 298 } 299 300 static inline void tick_nohz_user_enter_prepare(void) 301 { 302 if (tick_nohz_full_cpu(smp_processor_id())) 303 rcu_nocb_flush_deferred_wakeup(); 304 } 305 306 #endif 307