Commit | Line | Data |
---|---|---|
b2441318 | 1 | /* SPDX-License-Identifier: GPL-2.0 */ |
cff7d378 TG |
2 | #ifndef __CPUHOTPLUG_H |
3 | #define __CPUHOTPLUG_H | |
4 | ||
6cfeaf51 PB |
5 | #include <linux/types.h> |
6 | ||
fac1c204 PZ |
7 | /* |
8 | * CPU-up CPU-down | |
9 | * | |
10 | * BP AP BP AP | |
11 | * | |
12 | * OFFLINE OFFLINE | |
13 | * | ^ | |
14 | * v | | |
15 | * BRINGUP_CPU->AP_OFFLINE BRINGUP_CPU <- AP_IDLE_DEAD (idle thread/play_dead) | |
16 | * | AP_OFFLINE | |
17 | * v (IRQ-off) ,---------------^ | |
18 | * AP_ONLNE | (stop_machine) | |
19 | * | TEARDOWN_CPU <- AP_ONLINE_IDLE | |
20 | * | ^ | |
21 | * v | | |
22 | * AP_ACTIVE AP_ACTIVE | |
23 | */ | |
24 | ||
c9871c80 TG |
25 | /* |
26 | * CPU hotplug states. The state machine invokes the installed state | |
27 | * startup callbacks sequentially from CPUHP_OFFLINE + 1 to CPUHP_ONLINE | |
28 | * during a CPU online operation. During a CPU offline operation the | |
29 | * installed teardown callbacks are invoked in the reverse order from | |
30 | * CPU_ONLINE - 1 down to CPUHP_OFFLINE. | |
31 | * | |
32 | * The state space has three sections: PREPARE, STARTING and ONLINE. | |
33 | * | |
34 | * PREPARE: The callbacks are invoked on a control CPU before the | |
35 | * hotplugged CPU is started up or after the hotplugged CPU has died. | |
36 | * | |
37 | * STARTING: The callbacks are invoked on the hotplugged CPU from the low level | |
38 | * hotplug startup/teardown code with interrupts disabled. | |
39 | * | |
40 | * ONLINE: The callbacks are invoked on the hotplugged CPU from the per CPU | |
41 | * hotplug thread with interrupts and preemption enabled. | |
42 | * | |
43 | * Adding explicit states to this enum is only necessary when: | |
44 | * | |
45 | * 1) The state is within the STARTING section | |
46 | * | |
47 | * 2) The state has ordering constraints vs. other states in the | |
48 | * same section. | |
49 | * | |
50 | * If neither #1 nor #2 apply, please use the dynamic state space when | |
e0a99a83 | 51 | * setting up a state by using CPUHP_BP_PREPARE_DYN or CPUHP_AP_ONLINE_DYN |
c9871c80 TG |
52 | * for the @state argument of the setup function. |
53 | * | |
54 | * See Documentation/core-api/cpu_hotplug.rst for further information and | |
55 | * examples. | |
56 | */ | |
cff7d378 | 57 | enum cpuhp_state { |
1db49484 | 58 | CPUHP_INVALID = -1, |
c9871c80 TG |
59 | |
60 | /* PREPARE section invoked on a control CPU */ | |
1db49484 | 61 | CPUHP_OFFLINE = 0, |
cff7d378 | 62 | CPUHP_CREATE_THREADS, |
00e16c3d | 63 | CPUHP_PERF_PREPARE, |
95ca792c | 64 | CPUHP_PERF_X86_PREPARE, |
96b2bd38 | 65 | CPUHP_PERF_X86_AMD_UNCORE_PREP, |
57ecde42 | 66 | CPUHP_PERF_POWER, |
e3cfce17 | 67 | CPUHP_PERF_SUPERH, |
48d7f6c7 | 68 | CPUHP_X86_HPET_DEAD, |
0e285d36 | 69 | CPUHP_X86_MCE_DEAD, |
8017c279 | 70 | CPUHP_VIRT_NET_DEAD, |
92125c3a | 71 | CPUHP_IBMVNIC_DEAD, |
a96a87bf | 72 | CPUHP_SLUB_DEAD, |
88451f2c | 73 | CPUHP_DEBUG_OBJ_DEAD, |
1d7ac6ae | 74 | CPUHP_MM_WRITEBACK_DEAD, |
5438da97 | 75 | CPUHP_MM_VMSTAT_DEAD, |
c4544dbc | 76 | CPUHP_SOFTIRQ_DEAD, |
84a3f4db | 77 | CPUHP_NET_MVNETA_DEAD, |
529351fd | 78 | CPUHP_CPUIDLE_DEAD, |
c23a7266 | 79 | CPUHP_ARM64_FPSIMD_DEAD, |
a4fa9cc2 | 80 | CPUHP_ARM_OMAP_WAKE_DEAD, |
75e12ed6 | 81 | CPUHP_IRQ_POLL_DEAD, |
9a659f43 | 82 | CPUHP_BLOCK_SOFTIRQ_DEAD, |
be4d234d | 83 | CPUHP_BIO_DEAD, |
64f3bf2f | 84 | CPUHP_ACPI_CPUDRV_DEAD, |
84c9ceef | 85 | CPUHP_S390_PFAULT_DEAD, |
e2a738f7 | 86 | CPUHP_BLK_MQ_DEAD, |
fc4d24c9 | 87 | CPUHP_FS_BUFF_DEAD, |
90b14889 | 88 | CPUHP_PRINTK_DEAD, |
308167fc | 89 | CPUHP_MM_MEMCQ_DEAD, |
5588f5af | 90 | CPUHP_PERCPU_CNT_DEAD, |
d544abd5 | 91 | CPUHP_RADIX_DEAD, |
04f8cfea | 92 | CPUHP_PAGE_ALLOC, |
f0bf90de | 93 | CPUHP_NET_DEV_DEAD, |
9c248f88 | 94 | CPUHP_PCI_XGENE_DEAD, |
f598a497 | 95 | CPUHP_IOMMU_IOVA_DEAD, |
55de8877 | 96 | CPUHP_AP_ARM_CACHE_B15_RAC_DEAD, |
894c9ef9 | 97 | CPUHP_PADATA_DEAD, |
4570ddda | 98 | CPUHP_AP_DTPM_CPU_DEAD, |
3191dd5a | 99 | CPUHP_RANDOM_PREPARE, |
7ee681b2 | 100 | CPUHP_WORKQUEUE_PREP, |
bdab88e0 | 101 | CPUHP_POWER_NUMA_PREPARE, |
27590dc1 | 102 | CPUHP_HRTIMERS_PREPARE, |
e722d8da | 103 | CPUHP_PROFILE_PREPARE, |
6b2c2847 | 104 | CPUHP_X2APIC_PREPARE, |
31487f83 | 105 | CPUHP_SMPCFD_PREPARE, |
e6d4989a | 106 | CPUHP_RELAY_PREPARE, |
29c6d1bb | 107 | CPUHP_MD_RAID5_PREPARE, |
4df83742 | 108 | CPUHP_RCUTREE_PREP, |
dfc616d8 | 109 | CPUHP_CPUIDLE_COUPLED_PREPARE, |
68e694dc | 110 | CPUHP_POWERPC_PMAC_PREPARE, |
da3ed651 | 111 | CPUHP_POWERPC_MMU_CTX_PREPARE, |
4d737042 | 112 | CPUHP_XEN_PREPARE, |
c8761e20 | 113 | CPUHP_XEN_EVTCHN_PREPARE, |
657ebf7a | 114 | CPUHP_ARM_SHMOBILE_SCU_PREPARE, |
51533233 | 115 | CPUHP_SH_SH3X_PREPARE, |
38643a0e | 116 | CPUHP_TOPOLOGY_PREPARE, |
38b48292 | 117 | CPUHP_NET_IUCV_PREPARE, |
a3c9b14f | 118 | CPUHP_ARM_BL_PREPARE, |
b32614c0 | 119 | CPUHP_TRACE_RB_PREPARE, |
215c89d0 | 120 | CPUHP_MM_ZS_PREPARE, |
cab7a7e5 | 121 | CPUHP_MM_ZSWP_POOL_PREPARE, |
3f7cd919 | 122 | CPUHP_KVM_PPC_BOOK3S_PREPARE, |
1dd6c834 | 123 | CPUHP_ZCOMP_PREPARE, |
26456f87 | 124 | CPUHP_TIMERS_PREPARE, |
dd6d7c6f | 125 | CPUHP_MIPS_SOC_PREPARE, |
4205e478 TG |
126 | CPUHP_BP_PREPARE_DYN, |
127 | CPUHP_BP_PREPARE_DYN_END = CPUHP_BP_PREPARE_DYN + 20, | |
a631be92 | 128 | CPUHP_BP_KICK_AP, |
cff7d378 | 129 | CPUHP_BRINGUP_CPU, |
c9871c80 TG |
130 | |
131 | /* | |
132 | * STARTING section invoked on the hotplugged CPU in low level | |
133 | * bringup and teardown code. | |
134 | */ | |
e69aab13 | 135 | CPUHP_AP_IDLE_DEAD, |
4baa0afc | 136 | CPUHP_AP_OFFLINE, |
30f89e52 | 137 | CPUHP_AP_CACHECTRL_STARTING, |
9cf7243d | 138 | CPUHP_AP_SCHED_STARTING, |
4df83742 | 139 | CPUHP_AP_RCUTREE_DYING, |
9c6ceecb | 140 | CPUHP_AP_CPU_PM_STARTING, |
93131f7a | 141 | CPUHP_AP_IRQ_GIC_STARTING, |
6c034d17 | 142 | CPUHP_AP_IRQ_HIP04_STARTING, |
76cde263 | 143 | CPUHP_AP_IRQ_APPLE_AIC_STARTING, |
cb5ff2d2 | 144 | CPUHP_AP_IRQ_ARMADA_XP_STARTING, |
7ca04bc2 | 145 | CPUHP_AP_IRQ_BCM2836_STARTING, |
da61fcf9 | 146 | CPUHP_AP_IRQ_MIPS_GIC_STARTING, |
dd281e1a | 147 | CPUHP_AP_IRQ_LOONGARCH_STARTING, |
ccbe80ba | 148 | CPUHP_AP_IRQ_SIFIVE_PLIC_STARTING, |
7fbbaebf | 149 | CPUHP_AP_ARM_MVEBU_COHERENCY, |
96b2bd38 | 150 | CPUHP_AP_PERF_X86_AMD_UNCORE_STARTING, |
95ca792c | 151 | CPUHP_AP_PERF_X86_STARTING, |
9744f7b7 | 152 | CPUHP_AP_PERF_X86_AMD_IBS_STARTING, |
77c34ef1 | 153 | CPUHP_AP_PERF_X86_CSTATE_STARTING, |
25a77b55 | 154 | CPUHP_AP_PERF_XTENSA_STARTING, |
e5b61baf | 155 | CPUHP_AP_ARM_VFP_STARTING, |
e937dd57 | 156 | CPUHP_AP_ARM64_DEBUG_MONITORS_STARTING, |
d7a83d12 | 157 | CPUHP_AP_PERF_ARM_HW_BREAKPOINT_STARTING, |
45736a72 | 158 | CPUHP_AP_PERF_ARM_ACPI_STARTING, |
7d88eb69 | 159 | CPUHP_AP_PERF_ARM_STARTING, |
e9991434 | 160 | CPUHP_AP_PERF_RISCV_STARTING, |
9eeb2264 | 161 | CPUHP_AP_ARM_L2X0_STARTING, |
6282edb7 | 162 | CPUHP_AP_EXYNOS4_MCT_TIMER_STARTING, |
7e86e8bd | 163 | CPUHP_AP_ARM_ARCH_TIMER_STARTING, |
166b76a0 | 164 | CPUHP_AP_ARM_ARCH_TIMER_EVTSTRM_STARTING, |
b8a12296 | 165 | CPUHP_AP_ARM_GLOBAL_TIMER_STARTING, |
9995f4f1 | 166 | CPUHP_AP_JCORE_TIMER_STARTING, |
26b87688 | 167 | CPUHP_AP_ARM_TWD_STARTING, |
b0404165 | 168 | CPUHP_AP_QCOM_TIMER_STARTING, |
b4822dc7 | 169 | CPUHP_AP_TEGRA_TIMER_STARTING, |
2c48fef7 | 170 | CPUHP_AP_ARMADA_TIMER_STARTING, |
2dab9093 | 171 | CPUHP_AP_MIPS_GIC_TIMER_STARTING, |
ecd8081f | 172 | CPUHP_AP_ARC_TIMER_STARTING, |
62b01943 | 173 | CPUHP_AP_RISCV_TIMER_STARTING, |
2ac6795f | 174 | CPUHP_AP_CLINT_TIMER_STARTING, |
a7ad38b0 | 175 | CPUHP_AP_CSKY_TIMER_STARTING, |
25de4ce5 | 176 | CPUHP_AP_TI_GP_TIMER_STARTING, |
4df4cb9e | 177 | CPUHP_AP_HYPERV_TIMER_STARTING, |
9bf11ecc TG |
178 | /* Must be the last timer callback */ |
179 | CPUHP_AP_DUMMY_TIMER_STARTING, | |
4761adb6 | 180 | CPUHP_AP_ARM_XEN_STARTING, |
20f3b8ea | 181 | CPUHP_AP_ARM_XEN_RUNSTATE_STARTING, |
2b5283d1 | 182 | CPUHP_AP_ARM_CORESIGHT_STARTING, |
e9b88058 | 183 | CPUHP_AP_ARM_CORESIGHT_CTI_STARTING, |
27c01a8c | 184 | CPUHP_AP_ARM64_ISNDEP_STARTING, |
31487f83 | 185 | CPUHP_AP_SMPCFD_DYING, |
5c0930cc | 186 | CPUHP_AP_HRTIMERS_DYING, |
3ad6eb06 | 187 | CPUHP_AP_TICK_DYING, |
ae6a8a2e | 188 | CPUHP_AP_X86_TBOOT_DYING, |
55de8877 | 189 | CPUHP_AP_ARM_CACHE_B15_RAC_DYING, |
4baa0afc TG |
190 | CPUHP_AP_ONLINE, |
191 | CPUHP_TEARDOWN_CPU, | |
c9871c80 TG |
192 | |
193 | /* Online section invoked on the hotplugged CPU from the hotplug thread */ | |
fc6d73d6 | 194 | CPUHP_AP_ONLINE_IDLE, |
9636be85 | 195 | CPUHP_AP_HYPERV_ONLINE, |
aaf12a7b | 196 | CPUHP_AP_KVM_ONLINE, |
1cf12e08 | 197 | CPUHP_AP_SCHED_WAIT_EMPTY, |
1cf4f629 | 198 | CPUHP_AP_SMPBOOT_THREADS, |
c5cb83bb | 199 | CPUHP_AP_IRQ_AFFINITY_ONLINE, |
bf0beec0 | 200 | CPUHP_AP_BLK_MQ_ONLINE, |
77bc8c28 | 201 | CPUHP_AP_ARM_MVEBU_SYNC_CLOCKS, |
5861381d | 202 | CPUHP_AP_X86_INTEL_EPB_ONLINE, |
00e16c3d | 203 | CPUHP_AP_PERF_ONLINE, |
95ca792c | 204 | CPUHP_AP_PERF_X86_ONLINE, |
1a246b9f | 205 | CPUHP_AP_PERF_X86_UNCORE_ONLINE, |
96b2bd38 | 206 | CPUHP_AP_PERF_X86_AMD_UNCORE_ONLINE, |
c6a84daa | 207 | CPUHP_AP_PERF_X86_AMD_POWER_ONLINE, |
8b5b773d | 208 | CPUHP_AP_PERF_X86_RAPL_ONLINE, |
77c34ef1 | 209 | CPUHP_AP_PERF_X86_CSTATE_ONLINE, |
4f0f8217 | 210 | CPUHP_AP_PERF_S390_CF_ONLINE, |
e3d617fe | 211 | CPUHP_AP_PERF_S390_SF_ONLINE, |
28c94843 | 212 | CPUHP_AP_PERF_ARM_CCI_ONLINE, |
fdc15a36 | 213 | CPUHP_AP_PERF_ARM_CCN_ONLINE, |
6b79738b | 214 | CPUHP_AP_PERF_ARM_HISI_CPA_ONLINE, |
904dcf03 | 215 | CPUHP_AP_PERF_ARM_HISI_DDRC_ONLINE, |
2bab3cf9 | 216 | CPUHP_AP_PERF_ARM_HISI_HHA_ONLINE, |
2940bc43 | 217 | CPUHP_AP_PERF_ARM_HISI_L3_ONLINE, |
a0ab25cd | 218 | CPUHP_AP_PERF_ARM_HISI_PA_ONLINE, |
3bf30882 | 219 | CPUHP_AP_PERF_ARM_HISI_SLLC_ONLINE, |
8404b0fb | 220 | CPUHP_AP_PERF_ARM_HISI_PCIE_PMU_ONLINE, |
66637ab1 | 221 | CPUHP_AP_PERF_ARM_HNS3_PMU_ONLINE, |
b828f960 | 222 | CPUHP_AP_PERF_ARM_L2X0_ONLINE, |
21bdbb71 | 223 | CPUHP_AP_PERF_ARM_QCOM_L2_ONLINE, |
3071f13d | 224 | CPUHP_AP_PERF_ARM_QCOM_L3_ONLINE, |
cbb72a3c | 225 | CPUHP_AP_PERF_ARM_APM_XGENE_ONLINE, |
69c32972 | 226 | CPUHP_AP_PERF_ARM_CAVIUM_TX2_UNCORE_ONLINE, |
68fa55f0 | 227 | CPUHP_AP_PERF_ARM_MARVELL_CN10K_DDR_ONLINE, |
885dcd70 | 228 | CPUHP_AP_PERF_POWERPC_NEST_IMC_ONLINE, |
39a846db | 229 | CPUHP_AP_PERF_POWERPC_CORE_IMC_ONLINE, |
f74c89bd | 230 | CPUHP_AP_PERF_POWERPC_THREAD_IMC_ONLINE, |
72c69dcd | 231 | CPUHP_AP_PERF_POWERPC_TRACE_IMC_ONLINE, |
1a8f0886 | 232 | CPUHP_AP_PERF_POWERPC_HV_24x7_ONLINE, |
dcb5cdf6 | 233 | CPUHP_AP_PERF_POWERPC_HV_GPCI_ONLINE, |
398cb924 | 234 | CPUHP_AP_PERF_CSKY_ONLINE, |
7ee98877 | 235 | CPUHP_AP_TMIGR_ONLINE, |
9cf57731 | 236 | CPUHP_AP_WATCHDOG_ONLINE, |
7ee681b2 | 237 | CPUHP_AP_WORKQUEUE_ONLINE, |
3191dd5a | 238 | CPUHP_AP_RANDOM_ONLINE, |
4df83742 | 239 | CPUHP_AP_RCUTREE_ONLINE, |
83b44fe3 | 240 | CPUHP_AP_BASE_CACHEINFO_ONLINE, |
1cf4f629 | 241 | CPUHP_AP_ONLINE_DYN, |
fe22944c | 242 | CPUHP_AP_ONLINE_DYN_END = CPUHP_AP_ONLINE_DYN + 40, |
48d7f6c7 | 243 | CPUHP_AP_X86_HPET_ONLINE, |
251a5fd6 | 244 | CPUHP_AP_X86_KVM_CLK_ONLINE, |
aaddd7d1 | 245 | CPUHP_AP_ACTIVE, |
cff7d378 TG |
246 | CPUHP_ONLINE, |
247 | }; | |
248 | ||
5b7aa87e TG |
249 | int __cpuhp_setup_state(enum cpuhp_state state, const char *name, bool invoke, |
250 | int (*startup)(unsigned int cpu), | |
cf392d10 | 251 | int (*teardown)(unsigned int cpu), bool multi_instance); |
5b7aa87e | 252 | |
71def423 SAS |
253 | int __cpuhp_setup_state_cpuslocked(enum cpuhp_state state, const char *name, |
254 | bool invoke, | |
255 | int (*startup)(unsigned int cpu), | |
256 | int (*teardown)(unsigned int cpu), | |
257 | bool multi_instance); | |
5b7aa87e | 258 | /** |
c9871c80 TG |
259 | * cpuhp_setup_state - Setup hotplug state callbacks with calling the @startup |
260 | * callback | |
5b7aa87e TG |
261 | * @state: The state for which the calls are installed |
262 | * @name: Name of the callback (will be used in debug output) | |
c9871c80 TG |
263 | * @startup: startup callback function or NULL if not required |
264 | * @teardown: teardown callback function or NULL if not required | |
5b7aa87e | 265 | * |
c9871c80 TG |
266 | * Installs the callback functions and invokes the @startup callback on |
267 | * the online cpus which have already reached the @state. | |
5b7aa87e TG |
268 | */ |
269 | static inline int cpuhp_setup_state(enum cpuhp_state state, | |
270 | const char *name, | |
271 | int (*startup)(unsigned int cpu), | |
272 | int (*teardown)(unsigned int cpu)) | |
273 | { | |
cf392d10 | 274 | return __cpuhp_setup_state(state, name, true, startup, teardown, false); |
5b7aa87e TG |
275 | } |
276 | ||
c9871c80 TG |
277 | /** |
278 | * cpuhp_setup_state_cpuslocked - Setup hotplug state callbacks with calling | |
279 | * @startup callback from a cpus_read_lock() | |
280 | * held region | |
281 | * @state: The state for which the calls are installed | |
282 | * @name: Name of the callback (will be used in debug output) | |
283 | * @startup: startup callback function or NULL if not required | |
284 | * @teardown: teardown callback function or NULL if not required | |
285 | * | |
286 | * Same as cpuhp_setup_state() except that it must be invoked from within a | |
287 | * cpus_read_lock() held region. | |
288 | */ | |
71def423 SAS |
289 | static inline int cpuhp_setup_state_cpuslocked(enum cpuhp_state state, |
290 | const char *name, | |
291 | int (*startup)(unsigned int cpu), | |
292 | int (*teardown)(unsigned int cpu)) | |
293 | { | |
294 | return __cpuhp_setup_state_cpuslocked(state, name, true, startup, | |
295 | teardown, false); | |
296 | } | |
297 | ||
5b7aa87e TG |
298 | /** |
299 | * cpuhp_setup_state_nocalls - Setup hotplug state callbacks without calling the | |
c9871c80 | 300 | * @startup callback |
5b7aa87e TG |
301 | * @state: The state for which the calls are installed |
302 | * @name: Name of the callback. | |
c9871c80 TG |
303 | * @startup: startup callback function or NULL if not required |
304 | * @teardown: teardown callback function or NULL if not required | |
5b7aa87e | 305 | * |
c9871c80 TG |
306 | * Same as cpuhp_setup_state() except that the @startup callback is not |
307 | * invoked during installation. NOP if SMP=n or HOTPLUG_CPU=n. | |
5b7aa87e TG |
308 | */ |
309 | static inline int cpuhp_setup_state_nocalls(enum cpuhp_state state, | |
310 | const char *name, | |
311 | int (*startup)(unsigned int cpu), | |
312 | int (*teardown)(unsigned int cpu)) | |
313 | { | |
cf392d10 TG |
314 | return __cpuhp_setup_state(state, name, false, startup, teardown, |
315 | false); | |
316 | } | |
317 | ||
c9871c80 TG |
318 | /** |
319 | * cpuhp_setup_state_nocalls_cpuslocked - Setup hotplug state callbacks without | |
320 | * invoking the @startup callback from | |
321 | * a cpus_read_lock() held region | |
322 | * callbacks | |
323 | * @state: The state for which the calls are installed | |
324 | * @name: Name of the callback. | |
325 | * @startup: startup callback function or NULL if not required | |
326 | * @teardown: teardown callback function or NULL if not required | |
327 | * | |
328 | * Same as cpuhp_setup_state_nocalls() except that it must be invoked from | |
329 | * within a cpus_read_lock() held region. | |
330 | */ | |
71def423 SAS |
331 | static inline int cpuhp_setup_state_nocalls_cpuslocked(enum cpuhp_state state, |
332 | const char *name, | |
333 | int (*startup)(unsigned int cpu), | |
334 | int (*teardown)(unsigned int cpu)) | |
335 | { | |
336 | return __cpuhp_setup_state_cpuslocked(state, name, false, startup, | |
337 | teardown, false); | |
338 | } | |
339 | ||
cf392d10 TG |
340 | /** |
341 | * cpuhp_setup_state_multi - Add callbacks for multi state | |
342 | * @state: The state for which the calls are installed | |
343 | * @name: Name of the callback. | |
c9871c80 TG |
344 | * @startup: startup callback function or NULL if not required |
345 | * @teardown: teardown callback function or NULL if not required | |
cf392d10 TG |
346 | * |
347 | * Sets the internal multi_instance flag and prepares a state to work as a multi | |
348 | * instance callback. No callbacks are invoked at this point. The callbacks are | |
349 | * invoked once an instance for this state are registered via | |
c9871c80 | 350 | * cpuhp_state_add_instance() or cpuhp_state_add_instance_nocalls() |
cf392d10 TG |
351 | */ |
352 | static inline int cpuhp_setup_state_multi(enum cpuhp_state state, | |
353 | const char *name, | |
354 | int (*startup)(unsigned int cpu, | |
355 | struct hlist_node *node), | |
356 | int (*teardown)(unsigned int cpu, | |
357 | struct hlist_node *node)) | |
358 | { | |
359 | return __cpuhp_setup_state(state, name, false, | |
360 | (void *) startup, | |
361 | (void *) teardown, true); | |
362 | } | |
363 | ||
364 | int __cpuhp_state_add_instance(enum cpuhp_state state, struct hlist_node *node, | |
365 | bool invoke); | |
9805c673 TG |
366 | int __cpuhp_state_add_instance_cpuslocked(enum cpuhp_state state, |
367 | struct hlist_node *node, bool invoke); | |
cf392d10 TG |
368 | |
369 | /** | |
370 | * cpuhp_state_add_instance - Add an instance for a state and invoke startup | |
371 | * callback. | |
372 | * @state: The state for which the instance is installed | |
373 | * @node: The node for this individual state. | |
374 | * | |
c9871c80 TG |
375 | * Installs the instance for the @state and invokes the registered startup |
376 | * callback on the online cpus which have already reached the @state. The | |
377 | * @state must have been earlier marked as multi-instance by | |
378 | * cpuhp_setup_state_multi(). | |
cf392d10 TG |
379 | */ |
380 | static inline int cpuhp_state_add_instance(enum cpuhp_state state, | |
381 | struct hlist_node *node) | |
382 | { | |
383 | return __cpuhp_state_add_instance(state, node, true); | |
384 | } | |
385 | ||
386 | /** | |
387 | * cpuhp_state_add_instance_nocalls - Add an instance for a state without | |
388 | * invoking the startup callback. | |
389 | * @state: The state for which the instance is installed | |
390 | * @node: The node for this individual state. | |
391 | * | |
c9871c80 TG |
392 | * Installs the instance for the @state. The @state must have been earlier |
393 | * marked as multi-instance by cpuhp_setup_state_multi. NOP if SMP=n or | |
394 | * HOTPLUG_CPU=n. | |
cf392d10 TG |
395 | */ |
396 | static inline int cpuhp_state_add_instance_nocalls(enum cpuhp_state state, | |
397 | struct hlist_node *node) | |
398 | { | |
399 | return __cpuhp_state_add_instance(state, node, false); | |
5b7aa87e TG |
400 | } |
401 | ||
c9871c80 TG |
402 | /** |
403 | * cpuhp_state_add_instance_nocalls_cpuslocked - Add an instance for a state | |
404 | * without invoking the startup | |
405 | * callback from a cpus_read_lock() | |
406 | * held region. | |
407 | * @state: The state for which the instance is installed | |
408 | * @node: The node for this individual state. | |
409 | * | |
410 | * Same as cpuhp_state_add_instance_nocalls() except that it must be | |
411 | * invoked from within a cpus_read_lock() held region. | |
412 | */ | |
9805c673 TG |
413 | static inline int |
414 | cpuhp_state_add_instance_nocalls_cpuslocked(enum cpuhp_state state, | |
415 | struct hlist_node *node) | |
416 | { | |
417 | return __cpuhp_state_add_instance_cpuslocked(state, node, false); | |
418 | } | |
419 | ||
5b7aa87e | 420 | void __cpuhp_remove_state(enum cpuhp_state state, bool invoke); |
71def423 | 421 | void __cpuhp_remove_state_cpuslocked(enum cpuhp_state state, bool invoke); |
5b7aa87e TG |
422 | |
423 | /** | |
424 | * cpuhp_remove_state - Remove hotplug state callbacks and invoke the teardown | |
425 | * @state: The state for which the calls are removed | |
426 | * | |
427 | * Removes the callback functions and invokes the teardown callback on | |
c9871c80 | 428 | * the online cpus which have already reached the @state. |
5b7aa87e TG |
429 | */ |
430 | static inline void cpuhp_remove_state(enum cpuhp_state state) | |
431 | { | |
432 | __cpuhp_remove_state(state, true); | |
433 | } | |
434 | ||
435 | /** | |
436 | * cpuhp_remove_state_nocalls - Remove hotplug state callbacks without invoking | |
c9871c80 | 437 | * the teardown callback |
5b7aa87e TG |
438 | * @state: The state for which the calls are removed |
439 | */ | |
440 | static inline void cpuhp_remove_state_nocalls(enum cpuhp_state state) | |
441 | { | |
442 | __cpuhp_remove_state(state, false); | |
443 | } | |
444 | ||
c9871c80 TG |
445 | /** |
446 | * cpuhp_remove_state_nocalls_cpuslocked - Remove hotplug state callbacks without invoking | |
447 | * teardown from a cpus_read_lock() held region. | |
448 | * @state: The state for which the calls are removed | |
449 | * | |
450 | * Same as cpuhp_remove_state nocalls() except that it must be invoked | |
451 | * from within a cpus_read_lock() held region. | |
452 | */ | |
71def423 SAS |
453 | static inline void cpuhp_remove_state_nocalls_cpuslocked(enum cpuhp_state state) |
454 | { | |
455 | __cpuhp_remove_state_cpuslocked(state, false); | |
456 | } | |
457 | ||
cf392d10 TG |
458 | /** |
459 | * cpuhp_remove_multi_state - Remove hotplug multi state callback | |
460 | * @state: The state for which the calls are removed | |
461 | * | |
462 | * Removes the callback functions from a multi state. This is the reverse of | |
463 | * cpuhp_setup_state_multi(). All instances should have been removed before | |
464 | * invoking this function. | |
465 | */ | |
466 | static inline void cpuhp_remove_multi_state(enum cpuhp_state state) | |
467 | { | |
468 | __cpuhp_remove_state(state, false); | |
469 | } | |
470 | ||
471 | int __cpuhp_state_remove_instance(enum cpuhp_state state, | |
472 | struct hlist_node *node, bool invoke); | |
473 | ||
474 | /** | |
475 | * cpuhp_state_remove_instance - Remove hotplug instance from state and invoke | |
476 | * the teardown callback | |
477 | * @state: The state from which the instance is removed | |
478 | * @node: The node for this individual state. | |
479 | * | |
c9871c80 TG |
480 | * Removes the instance and invokes the teardown callback on the online cpus |
481 | * which have already reached @state. | |
cf392d10 TG |
482 | */ |
483 | static inline int cpuhp_state_remove_instance(enum cpuhp_state state, | |
484 | struct hlist_node *node) | |
485 | { | |
486 | return __cpuhp_state_remove_instance(state, node, true); | |
487 | } | |
488 | ||
489 | /** | |
490 | * cpuhp_state_remove_instance_nocalls - Remove hotplug instance from state | |
c91eb283 | 491 | * without invoking the teardown callback |
cf392d10 TG |
492 | * @state: The state from which the instance is removed |
493 | * @node: The node for this individual state. | |
494 | * | |
495 | * Removes the instance without invoking the teardown callback. | |
496 | */ | |
497 | static inline int cpuhp_state_remove_instance_nocalls(enum cpuhp_state state, | |
498 | struct hlist_node *node) | |
499 | { | |
500 | return __cpuhp_state_remove_instance(state, node, false); | |
501 | } | |
502 | ||
8df3e07e TG |
503 | #ifdef CONFIG_SMP |
504 | void cpuhp_online_idle(enum cpuhp_state state); | |
505 | #else | |
506 | static inline void cpuhp_online_idle(enum cpuhp_state state) { } | |
507 | #endif | |
508 | ||
a631be92 TG |
509 | struct task_struct; |
510 | ||
6f062123 TG |
511 | void cpuhp_ap_sync_alive(void); |
512 | void arch_cpuhp_sync_state_poll(void); | |
513 | void arch_cpuhp_cleanup_kick_cpu(unsigned int cpu); | |
a631be92 | 514 | int arch_cpuhp_kick_ap_alive(unsigned int cpu, struct task_struct *tidle); |
18415f33 | 515 | bool arch_cpuhp_init_parallel_bringup(void); |
6f062123 TG |
516 | |
517 | #ifdef CONFIG_HOTPLUG_CORE_SYNC_DEAD | |
518 | void cpuhp_ap_report_dead(void); | |
519 | void arch_cpuhp_cleanup_dead_cpu(unsigned int cpu); | |
520 | #else | |
521 | static inline void cpuhp_ap_report_dead(void) { } | |
522 | static inline void arch_cpuhp_cleanup_dead_cpu(unsigned int cpu) { } | |
523 | #endif | |
524 | ||
cff7d378 | 525 | #endif |