Commit | Line | Data |
---|---|---|
b2441318 | 1 | /* SPDX-License-Identifier: GPL-2.0 */ |
1da177e4 LT |
2 | /* |
3 | * include/linux/cpu.h - generic cpu definition | |
4 | * | |
5 | * This is mainly for topological representation. We define the | |
6 | * basic 'struct cpu' here, which can be embedded in per-arch | |
7 | * definitions of processors. | |
8 | * | |
9 | * Basic handling of the devices is done in drivers/base/cpu.c | |
1da177e4 | 10 | * |
611a75e1 | 11 | * CPUs are exported via sysfs in the devices/system/cpu |
1da177e4 | 12 | * directory. |
1da177e4 LT |
13 | */ |
14 | #ifndef _LINUX_CPU_H_ | |
15 | #define _LINUX_CPU_H_ | |
16 | ||
1da177e4 LT |
17 | #include <linux/node.h> |
18 | #include <linux/compiler.h> | |
19 | #include <linux/cpumask.h> | |
cff7d378 | 20 | #include <linux/cpuhotplug.h> |
3f916919 | 21 | #include <linux/cpu_smt.h> |
1da177e4 | 22 | |
313162d0 | 23 | struct device; |
d1cb9d1a | 24 | struct device_node; |
3d52943b | 25 | struct attribute_group; |
313162d0 | 26 | |
1da177e4 LT |
27 | struct cpu { |
28 | int node_id; /* The node which contains the CPU */ | |
72486f1f | 29 | int hotpluggable; /* creates sysfs control file if hotpluggable */ |
8a25a2fd | 30 | struct device dev; |
1da177e4 LT |
31 | }; |
32 | ||
cff7d378 | 33 | extern void boot_cpu_init(void); |
b5b1404d | 34 | extern void boot_cpu_hotplug_init(void); |
1777e463 IM |
35 | extern void cpu_init(void); |
36 | extern void trap_init(void); | |
cff7d378 | 37 | |
76b67ed9 | 38 | extern int register_cpu(struct cpu *cpu, int num); |
8a25a2fd | 39 | extern struct device *get_cpu_device(unsigned cpu); |
2987557f | 40 | extern bool cpu_is_hotpluggable(unsigned cpu); |
183912d3 | 41 | extern bool arch_match_cpu_phys_id(int cpu, u64 phys_id); |
d1cb9d1a DM |
42 | extern bool arch_find_n_match_cpu_physical_id(struct device_node *cpun, |
43 | int cpu, unsigned int *thread); | |
0344c6c5 | 44 | |
8a25a2fd KS |
45 | extern int cpu_add_dev_attr(struct device_attribute *attr); |
46 | extern void cpu_remove_dev_attr(struct device_attribute *attr); | |
0344c6c5 | 47 | |
8a25a2fd KS |
48 | extern int cpu_add_dev_attr_group(struct attribute_group *attrs); |
49 | extern void cpu_remove_dev_attr_group(struct attribute_group *attrs); | |
0344c6c5 | 50 | |
87590ce6 TG |
51 | extern ssize_t cpu_show_meltdown(struct device *dev, |
52 | struct device_attribute *attr, char *buf); | |
53 | extern ssize_t cpu_show_spectre_v1(struct device *dev, | |
54 | struct device_attribute *attr, char *buf); | |
55 | extern ssize_t cpu_show_spectre_v2(struct device *dev, | |
56 | struct device_attribute *attr, char *buf); | |
c456442c KRW |
57 | extern ssize_t cpu_show_spec_store_bypass(struct device *dev, |
58 | struct device_attribute *attr, char *buf); | |
17dbca11 AK |
59 | extern ssize_t cpu_show_l1tf(struct device *dev, |
60 | struct device_attribute *attr, char *buf); | |
8a4b06d3 TG |
61 | extern ssize_t cpu_show_mds(struct device *dev, |
62 | struct device_attribute *attr, char *buf); | |
6608b45a PG |
63 | extern ssize_t cpu_show_tsx_async_abort(struct device *dev, |
64 | struct device_attribute *attr, | |
65 | char *buf); | |
db4d30fb VT |
66 | extern ssize_t cpu_show_itlb_multihit(struct device *dev, |
67 | struct device_attribute *attr, char *buf); | |
2accfa69 | 68 | extern ssize_t cpu_show_srbds(struct device *dev, struct device_attribute *attr, char *buf); |
8d50cdf8 PG |
69 | extern ssize_t cpu_show_mmio_stale_data(struct device *dev, |
70 | struct device_attribute *attr, | |
71 | char *buf); | |
6b80b59b AC |
72 | extern ssize_t cpu_show_retbleed(struct device *dev, |
73 | struct device_attribute *attr, char *buf); | |
fb3bd914 BPA |
74 | extern ssize_t cpu_show_spec_rstack_overflow(struct device *dev, |
75 | struct device_attribute *attr, char *buf); | |
a57c27c7 AB |
76 | extern ssize_t cpu_show_gds(struct device *dev, |
77 | struct device_attribute *attr, char *buf); | |
8076fcde PG |
78 | extern ssize_t cpu_show_reg_file_data_sampling(struct device *dev, |
79 | struct device_attribute *attr, char *buf); | |
87590ce6 | 80 | |
8db14860 NI |
81 | extern __printf(4, 5) |
82 | struct device *cpu_device_create(struct device *parent, void *drvdata, | |
83 | const struct attribute_group **groups, | |
84 | const char *fmt, ...); | |
bb5e44fb | 85 | extern bool arch_cpu_is_hotpluggable(int cpu); |
c4dd854f RKO |
86 | extern int arch_register_cpu(int cpu); |
87 | extern void arch_unregister_cpu(int cpu); | |
1da177e4 | 88 | #ifdef CONFIG_HOTPLUG_CPU |
76b67ed9 | 89 | extern void unregister_cpu(struct cpu *cpu); |
12633e80 NF |
90 | extern ssize_t arch_cpu_probe(const char *, size_t); |
91 | extern ssize_t arch_cpu_release(const char *, size_t); | |
1da177e4 | 92 | #endif |
1da177e4 | 93 | |
0949dd96 JM |
94 | #ifdef CONFIG_GENERIC_CPU_DEVICES |
95 | DECLARE_PER_CPU(struct cpu, cpu_devices); | |
96 | #endif | |
97 | ||
f4c09f87 TG |
98 | /* |
99 | * These states are not related to the core CPU hotplug mechanism. They are | |
100 | * used by various (sub)architectures to track internal state | |
80f1ff97 | 101 | */ |
f4c09f87 TG |
102 | #define CPU_ONLINE 0x0002 /* CPU is up */ |
103 | #define CPU_UP_PREPARE 0x0003 /* CPU coming up */ | |
104 | #define CPU_DEAD 0x0007 /* CPU dead */ | |
105 | #define CPU_DEAD_FROZEN 0x0008 /* CPU timed out on unplug */ | |
106 | #define CPU_POST_DEAD 0x0009 /* CPU successfully unplugged */ | |
107 | #define CPU_BROKEN 0x000B /* CPU did not die properly */ | |
80f1ff97 | 108 | |
1da177e4 | 109 | #ifdef CONFIG_SMP |
090e77c3 | 110 | extern bool cpuhp_tasks_frozen; |
93ef1429 | 111 | int add_cpu(unsigned int cpu); |
33c3736e | 112 | int cpu_device_up(struct device *dev); |
e545a614 | 113 | void notify_cpu_starting(unsigned int cpu); |
3da1c84c ON |
114 | extern void cpu_maps_update_begin(void); |
115 | extern void cpu_maps_update_done(void); | |
d720f986 | 116 | int bringup_hibernate_cpu(unsigned int sleep_cpu); |
4c8a4985 | 117 | void bringup_nonboot_cpus(unsigned int max_cpus); |
d0d23b54 | 118 | |
3da1c84c | 119 | #else /* CONFIG_SMP */ |
090e77c3 | 120 | #define cpuhp_tasks_frozen 0 |
1da177e4 | 121 | |
3da1c84c ON |
122 | static inline void cpu_maps_update_begin(void) |
123 | { | |
124 | } | |
125 | ||
126 | static inline void cpu_maps_update_done(void) | |
127 | { | |
128 | } | |
129 | ||
51f24030 SL |
130 | static inline int add_cpu(unsigned int cpu) { return 0;} |
131 | ||
1da177e4 | 132 | #endif /* CONFIG_SMP */ |
3a480d4b | 133 | extern const struct bus_type cpu_subsys; |
1da177e4 | 134 | |
43759fe5 FW |
135 | extern int lockdep_is_cpus_held(void); |
136 | ||
1da177e4 | 137 | #ifdef CONFIG_HOTPLUG_CPU |
8f553c49 TG |
138 | extern void cpus_write_lock(void); |
139 | extern void cpus_write_unlock(void); | |
140 | extern void cpus_read_lock(void); | |
141 | extern void cpus_read_unlock(void); | |
6f4ceee9 | 142 | extern int cpus_read_trylock(void); |
fc8dffd3 | 143 | extern void lockdep_assert_cpus_held(void); |
16e53dbf SB |
144 | extern void cpu_hotplug_disable(void); |
145 | extern void cpu_hotplug_enable(void); | |
cb79295e | 146 | void clear_tasks_mm_cpumask(int cpu); |
93ef1429 | 147 | int remove_cpu(unsigned int cpu); |
33c3736e | 148 | int cpu_device_down(struct device *dev); |
0441a559 | 149 | extern void smp_shutdown_nonboot_cpus(unsigned int primary_cpu); |
f7dff2b1 | 150 | |
8f553c49 TG |
151 | #else /* CONFIG_HOTPLUG_CPU */ |
152 | ||
153 | static inline void cpus_write_lock(void) { } | |
154 | static inline void cpus_write_unlock(void) { } | |
155 | static inline void cpus_read_lock(void) { } | |
156 | static inline void cpus_read_unlock(void) { } | |
6f4ceee9 | 157 | static inline int cpus_read_trylock(void) { return true; } |
ade3f680 | 158 | static inline void lockdep_assert_cpus_held(void) { } |
8f553c49 TG |
159 | static inline void cpu_hotplug_disable(void) { } |
160 | static inline void cpu_hotplug_enable(void) { } | |
51f24030 | 161 | static inline int remove_cpu(unsigned int cpu) { return -EPERM; } |
0441a559 | 162 | static inline void smp_shutdown_nonboot_cpus(unsigned int primary_cpu) { } |
8f553c49 TG |
163 | #endif /* !CONFIG_HOTPLUG_CPU */ |
164 | ||
6fb45460 PZ |
165 | DEFINE_LOCK_GUARD_0(cpus_read_lock, cpus_read_lock(), cpus_read_unlock()) |
166 | ||
f3de4be9 | 167 | #ifdef CONFIG_PM_SLEEP_SMP |
fb7fb84a | 168 | extern int freeze_secondary_cpus(int primary); |
56555855 | 169 | extern void thaw_secondary_cpus(void); |
2f1a6fbb NP |
170 | |
171 | static inline int suspend_disable_secondary_cpus(void) | |
172 | { | |
9ca12ac0 NP |
173 | int cpu = 0; |
174 | ||
175 | if (IS_ENABLED(CONFIG_PM_SLEEP_SMP_NONZERO_CPU)) | |
176 | cpu = -1; | |
177 | ||
178 | return freeze_secondary_cpus(cpu); | |
2f1a6fbb NP |
179 | } |
180 | static inline void suspend_enable_secondary_cpus(void) | |
181 | { | |
56555855 | 182 | return thaw_secondary_cpus(); |
2f1a6fbb NP |
183 | } |
184 | ||
f3de4be9 | 185 | #else /* !CONFIG_PM_SLEEP_SMP */ |
56555855 | 186 | static inline void thaw_secondary_cpus(void) {} |
2f1a6fbb NP |
187 | static inline int suspend_disable_secondary_cpus(void) { return 0; } |
188 | static inline void suspend_enable_secondary_cpus(void) { } | |
f3de4be9 | 189 | #endif /* !CONFIG_PM_SLEEP_SMP */ |
e3920fb4 | 190 | |
d4e5268a | 191 | void __noreturn cpu_startup_entry(enum cpuhp_state state); |
a1a04ec3 | 192 | |
d1669912 TG |
193 | void cpu_idle_poll_ctrl(bool enable); |
194 | ||
6727ad9e CM |
195 | bool cpu_in_idle(unsigned long pc); |
196 | ||
d1669912 TG |
197 | void arch_cpu_idle(void); |
198 | void arch_cpu_idle_prepare(void); | |
199 | void arch_cpu_idle_enter(void); | |
200 | void arch_cpu_idle_exit(void); | |
2be2a197 TG |
201 | void arch_tick_broadcast_enter(void); |
202 | void arch_tick_broadcast_exit(void); | |
071c44e4 | 203 | void __noreturn arch_cpu_idle_dead(void); |
d1669912 | 204 | |
7725acaa TG |
205 | #ifdef CONFIG_ARCH_HAS_CPU_FINALIZE_INIT |
206 | void arch_cpu_finalize_init(void); | |
207 | #else | |
208 | static inline void arch_cpu_finalize_init(void) { } | |
209 | #endif | |
210 | ||
c55b51a0 DL |
211 | void play_idle_precise(u64 duration_ns, u64 latency_ns); |
212 | ||
213 | static inline void play_idle(unsigned long duration_us) | |
214 | { | |
215 | play_idle_precise(duration_us * NSEC_PER_USEC, U64_MAX); | |
216 | } | |
c1de45ca | 217 | |
8038dad7 | 218 | #ifdef CONFIG_HOTPLUG_CPU |
e69aab13 TG |
219 | void cpuhp_report_idle_dead(void); |
220 | #else | |
221 | static inline void cpuhp_report_idle_dead(void) { } | |
8038dad7 PM |
222 | #endif /* #ifdef CONFIG_HOTPLUG_CPU */ |
223 | ||
731dc9df TH |
224 | extern bool cpu_mitigations_off(void); |
225 | extern bool cpu_mitigations_auto_nosmt(void); | |
98af8452 | 226 | |
1da177e4 | 227 | #endif /* _LINUX_CPU_H_ */ |