xref: /linux/kernel/time/tick-internal.h (revision bd628c1bed7902ec1f24ba0fe70758949146abbe)
1 /* SPDX-License-Identifier: GPL-2.0 */
2 /*
3  * tick internal variable and functions used by low/high res code
4  */
5 #include <linux/hrtimer.h>
6 #include <linux/tick.h>
7 
8 #include "timekeeping.h"
9 #include "tick-sched.h"
10 
11 #ifdef CONFIG_GENERIC_CLOCKEVENTS
12 
13 # define TICK_DO_TIMER_NONE	-1
14 # define TICK_DO_TIMER_BOOT	-2
15 
16 DECLARE_PER_CPU(struct tick_device, tick_cpu_device);
17 extern ktime_t tick_next_period;
18 extern ktime_t tick_period;
19 extern int tick_do_timer_cpu __read_mostly;
20 
21 extern void tick_setup_periodic(struct clock_event_device *dev, int broadcast);
22 extern void tick_handle_periodic(struct clock_event_device *dev);
23 extern void tick_check_new_device(struct clock_event_device *dev);
24 extern void tick_shutdown(unsigned int cpu);
25 extern void tick_suspend(void);
26 extern void tick_resume(void);
27 extern bool tick_check_replacement(struct clock_event_device *curdev,
28 				   struct clock_event_device *newdev);
29 extern void tick_install_replacement(struct clock_event_device *dev);
30 extern int tick_is_oneshot_available(void);
31 extern struct tick_device *tick_get_device(int cpu);
32 
33 extern int clockevents_tick_resume(struct clock_event_device *dev);
34 /* Check, if the device is functional or a dummy for broadcast */
35 static inline int tick_device_is_functional(struct clock_event_device *dev)
36 {
37 	return !(dev->features & CLOCK_EVT_FEAT_DUMMY);
38 }
39 
40 static inline enum clock_event_state clockevent_get_state(struct clock_event_device *dev)
41 {
42 	return dev->state_use_accessors;
43 }
44 
45 static inline void clockevent_set_state(struct clock_event_device *dev,
46 					enum clock_event_state state)
47 {
48 	dev->state_use_accessors = state;
49 }
50 
51 extern void clockevents_shutdown(struct clock_event_device *dev);
52 extern void clockevents_exchange_device(struct clock_event_device *old,
53 					struct clock_event_device *new);
54 extern void clockevents_switch_state(struct clock_event_device *dev,
55 				     enum clock_event_state state);
56 extern int clockevents_program_event(struct clock_event_device *dev,
57 				     ktime_t expires, bool force);
58 extern void clockevents_handle_noop(struct clock_event_device *dev);
59 extern int __clockevents_update_freq(struct clock_event_device *dev, u32 freq);
60 extern ssize_t sysfs_get_uname(const char *buf, char *dst, size_t cnt);
61 
62 /* Broadcasting support */
63 # ifdef CONFIG_GENERIC_CLOCKEVENTS_BROADCAST
64 extern int tick_device_uses_broadcast(struct clock_event_device *dev, int cpu);
65 extern void tick_install_broadcast_device(struct clock_event_device *dev);
66 extern int tick_is_broadcast_device(struct clock_event_device *dev);
67 extern void tick_shutdown_broadcast(unsigned int cpu);
68 extern void tick_suspend_broadcast(void);
69 extern void tick_resume_broadcast(void);
70 extern bool tick_resume_check_broadcast(void);
71 extern void tick_broadcast_init(void);
72 extern void tick_set_periodic_handler(struct clock_event_device *dev, int broadcast);
73 extern int tick_broadcast_update_freq(struct clock_event_device *dev, u32 freq);
74 extern struct tick_device *tick_get_broadcast_device(void);
75 extern struct cpumask *tick_get_broadcast_mask(void);
76 # else /* !CONFIG_GENERIC_CLOCKEVENTS_BROADCAST: */
77 static inline void tick_install_broadcast_device(struct clock_event_device *dev) { }
78 static inline int tick_is_broadcast_device(struct clock_event_device *dev) { return 0; }
79 static inline int tick_device_uses_broadcast(struct clock_event_device *dev, int cpu) { return 0; }
80 static inline void tick_do_periodic_broadcast(struct clock_event_device *d) { }
81 static inline void tick_shutdown_broadcast(unsigned int cpu) { }
82 static inline void tick_suspend_broadcast(void) { }
83 static inline void tick_resume_broadcast(void) { }
84 static inline bool tick_resume_check_broadcast(void) { return false; }
85 static inline void tick_broadcast_init(void) { }
86 static inline int tick_broadcast_update_freq(struct clock_event_device *dev, u32 freq) { return -ENODEV; }
87 
88 /* Set the periodic handler in non broadcast mode */
89 static inline void tick_set_periodic_handler(struct clock_event_device *dev, int broadcast)
90 {
91 	dev->event_handler = tick_handle_periodic;
92 }
93 # endif /* !CONFIG_GENERIC_CLOCKEVENTS_BROADCAST */
94 
95 #else /* !GENERIC_CLOCKEVENTS: */
96 static inline void tick_suspend(void) { }
97 static inline void tick_resume(void) { }
98 #endif /* !GENERIC_CLOCKEVENTS */
99 
100 /* Oneshot related functions */
101 #ifdef CONFIG_TICK_ONESHOT
102 extern void tick_setup_oneshot(struct clock_event_device *newdev,
103 			       void (*handler)(struct clock_event_device *),
104 			       ktime_t nextevt);
105 extern int tick_program_event(ktime_t expires, int force);
106 extern void tick_oneshot_notify(void);
107 extern int tick_switch_to_oneshot(void (*handler)(struct clock_event_device *));
108 extern void tick_resume_oneshot(void);
109 static inline bool tick_oneshot_possible(void) { return true; }
110 extern int tick_oneshot_mode_active(void);
111 extern void tick_clock_notify(void);
112 extern int tick_check_oneshot_change(int allow_nohz);
113 extern int tick_init_highres(void);
114 #else /* !CONFIG_TICK_ONESHOT: */
115 static inline
116 void tick_setup_oneshot(struct clock_event_device *newdev,
117 			void (*handler)(struct clock_event_device *),
118 			ktime_t nextevt) { BUG(); }
119 static inline void tick_resume_oneshot(void) { BUG(); }
120 static inline int tick_program_event(ktime_t expires, int force) { return 0; }
121 static inline void tick_oneshot_notify(void) { }
122 static inline bool tick_oneshot_possible(void) { return false; }
123 static inline int tick_oneshot_mode_active(void) { return 0; }
124 static inline void tick_clock_notify(void) { }
125 static inline int tick_check_oneshot_change(int allow_nohz) { return 0; }
126 #endif /* !CONFIG_TICK_ONESHOT */
127 
128 /* Functions related to oneshot broadcasting */
129 #if defined(CONFIG_GENERIC_CLOCKEVENTS_BROADCAST) && defined(CONFIG_TICK_ONESHOT)
130 extern void tick_broadcast_switch_to_oneshot(void);
131 extern void tick_shutdown_broadcast_oneshot(unsigned int cpu);
132 extern int tick_broadcast_oneshot_active(void);
133 extern void tick_check_oneshot_broadcast_this_cpu(void);
134 bool tick_broadcast_oneshot_available(void);
135 extern struct cpumask *tick_get_broadcast_oneshot_mask(void);
136 #else /* !(BROADCAST && ONESHOT): */
137 static inline void tick_broadcast_switch_to_oneshot(void) { }
138 static inline void tick_shutdown_broadcast_oneshot(unsigned int cpu) { }
139 static inline int tick_broadcast_oneshot_active(void) { return 0; }
140 static inline void tick_check_oneshot_broadcast_this_cpu(void) { }
141 static inline bool tick_broadcast_oneshot_available(void) { return tick_oneshot_possible(); }
142 #endif /* !(BROADCAST && ONESHOT) */
143 
144 /* NO_HZ_FULL internal */
145 #ifdef CONFIG_NO_HZ_FULL
146 extern void tick_nohz_init(void);
147 # else
148 static inline void tick_nohz_init(void) { }
149 #endif
150 
151 #ifdef CONFIG_NO_HZ_COMMON
152 extern unsigned long tick_nohz_active;
153 extern void timers_update_nohz(void);
154 # ifdef CONFIG_SMP
155 extern struct static_key_false timers_migration_enabled;
156 # endif
157 #else /* CONFIG_NO_HZ_COMMON */
158 static inline void timers_update_nohz(void) { }
159 #define tick_nohz_active (0)
160 #endif
161 
162 DECLARE_PER_CPU(struct hrtimer_cpu_base, hrtimer_bases);
163 
164 extern u64 get_next_timer_interrupt(unsigned long basej, u64 basem);
165 void timer_clear_idle(void);
166