include/linux/tick.h

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