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 | |
51 | * setting up a state by using CPUHP_PREPARE_DYN or CPUHP_PREPARE_ONLINE | |
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, |
148b9e2a | 69 | CPUHP_X86_APB_DEAD, |
0e285d36 | 70 | CPUHP_X86_MCE_DEAD, |
8017c279 | 71 | CPUHP_VIRT_NET_DEAD, |
a96a87bf | 72 | CPUHP_SLUB_DEAD, |
88451f2c | 73 | CPUHP_DEBUG_OBJ_DEAD, |
1d7ac6ae | 74 | CPUHP_MM_WRITEBACK_DEAD, |
a6a0251c HY |
75 | /* Must be after CPUHP_MM_VMSTAT_DEAD */ |
76 | CPUHP_MM_DEMOTION_DEAD, | |
5438da97 | 77 | CPUHP_MM_VMSTAT_DEAD, |
c4544dbc | 78 | CPUHP_SOFTIRQ_DEAD, |
84a3f4db | 79 | CPUHP_NET_MVNETA_DEAD, |
529351fd | 80 | CPUHP_CPUIDLE_DEAD, |
c23a7266 | 81 | CPUHP_ARM64_FPSIMD_DEAD, |
a4fa9cc2 | 82 | CPUHP_ARM_OMAP_WAKE_DEAD, |
75e12ed6 | 83 | CPUHP_IRQ_POLL_DEAD, |
9a659f43 | 84 | CPUHP_BLOCK_SOFTIRQ_DEAD, |
be4d234d | 85 | CPUHP_BIO_DEAD, |
64f3bf2f | 86 | CPUHP_ACPI_CPUDRV_DEAD, |
84c9ceef | 87 | CPUHP_S390_PFAULT_DEAD, |
e2a738f7 | 88 | CPUHP_BLK_MQ_DEAD, |
fc4d24c9 | 89 | CPUHP_FS_BUFF_DEAD, |
90b14889 | 90 | CPUHP_PRINTK_DEAD, |
308167fc | 91 | CPUHP_MM_MEMCQ_DEAD, |
f1653c2e | 92 | CPUHP_XFS_DEAD, |
5588f5af | 93 | CPUHP_PERCPU_CNT_DEAD, |
d544abd5 | 94 | CPUHP_RADIX_DEAD, |
04f8cfea | 95 | CPUHP_PAGE_ALLOC, |
f0bf90de | 96 | CPUHP_NET_DEV_DEAD, |
9c248f88 | 97 | CPUHP_PCI_XGENE_DEAD, |
f598a497 | 98 | CPUHP_IOMMU_IOVA_DEAD, |
7b737965 | 99 | CPUHP_LUSTRE_CFS_DEAD, |
55de8877 | 100 | CPUHP_AP_ARM_CACHE_B15_RAC_DEAD, |
894c9ef9 | 101 | CPUHP_PADATA_DEAD, |
4570ddda | 102 | CPUHP_AP_DTPM_CPU_DEAD, |
7ee681b2 | 103 | CPUHP_WORKQUEUE_PREP, |
bdab88e0 | 104 | CPUHP_POWER_NUMA_PREPARE, |
27590dc1 | 105 | CPUHP_HRTIMERS_PREPARE, |
e722d8da | 106 | CPUHP_PROFILE_PREPARE, |
6b2c2847 | 107 | CPUHP_X2APIC_PREPARE, |
31487f83 | 108 | CPUHP_SMPCFD_PREPARE, |
e6d4989a | 109 | CPUHP_RELAY_PREPARE, |
6731d4f1 | 110 | CPUHP_SLAB_PREPARE, |
29c6d1bb | 111 | CPUHP_MD_RAID5_PREPARE, |
4df83742 | 112 | CPUHP_RCUTREE_PREP, |
dfc616d8 | 113 | CPUHP_CPUIDLE_COUPLED_PREPARE, |
68e694dc | 114 | CPUHP_POWERPC_PMAC_PREPARE, |
da3ed651 | 115 | CPUHP_POWERPC_MMU_CTX_PREPARE, |
4d737042 | 116 | CPUHP_XEN_PREPARE, |
c8761e20 | 117 | CPUHP_XEN_EVTCHN_PREPARE, |
657ebf7a | 118 | CPUHP_ARM_SHMOBILE_SCU_PREPARE, |
51533233 | 119 | CPUHP_SH_SH3X_PREPARE, |
a4fc1bfc | 120 | CPUHP_NET_FLOW_PREPARE, |
38643a0e | 121 | CPUHP_TOPOLOGY_PREPARE, |
38b48292 | 122 | CPUHP_NET_IUCV_PREPARE, |
a3c9b14f | 123 | CPUHP_ARM_BL_PREPARE, |
b32614c0 | 124 | CPUHP_TRACE_RB_PREPARE, |
215c89d0 | 125 | CPUHP_MM_ZS_PREPARE, |
ad7ed770 | 126 | CPUHP_MM_ZSWP_MEM_PREPARE, |
cab7a7e5 | 127 | CPUHP_MM_ZSWP_POOL_PREPARE, |
3f7cd919 | 128 | CPUHP_KVM_PPC_BOOK3S_PREPARE, |
1dd6c834 | 129 | CPUHP_ZCOMP_PREPARE, |
26456f87 | 130 | CPUHP_TIMERS_PREPARE, |
dd6d7c6f | 131 | CPUHP_MIPS_SOC_PREPARE, |
4205e478 TG |
132 | CPUHP_BP_PREPARE_DYN, |
133 | CPUHP_BP_PREPARE_DYN_END = CPUHP_BP_PREPARE_DYN + 20, | |
cff7d378 | 134 | CPUHP_BRINGUP_CPU, |
c9871c80 TG |
135 | |
136 | /* | |
137 | * STARTING section invoked on the hotplugged CPU in low level | |
138 | * bringup and teardown code. | |
139 | */ | |
e69aab13 | 140 | CPUHP_AP_IDLE_DEAD, |
4baa0afc | 141 | CPUHP_AP_OFFLINE, |
9cf7243d | 142 | CPUHP_AP_SCHED_STARTING, |
4df83742 | 143 | CPUHP_AP_RCUTREE_DYING, |
9c6ceecb | 144 | CPUHP_AP_CPU_PM_STARTING, |
93131f7a | 145 | CPUHP_AP_IRQ_GIC_STARTING, |
6c034d17 | 146 | CPUHP_AP_IRQ_HIP04_STARTING, |
76cde263 | 147 | CPUHP_AP_IRQ_APPLE_AIC_STARTING, |
cb5ff2d2 | 148 | CPUHP_AP_IRQ_ARMADA_XP_STARTING, |
7ca04bc2 | 149 | CPUHP_AP_IRQ_BCM2836_STARTING, |
da61fcf9 | 150 | CPUHP_AP_IRQ_MIPS_GIC_STARTING, |
6b7ce892 | 151 | CPUHP_AP_IRQ_RISCV_STARTING, |
ccbe80ba | 152 | CPUHP_AP_IRQ_SIFIVE_PLIC_STARTING, |
7fbbaebf | 153 | CPUHP_AP_ARM_MVEBU_COHERENCY, |
78f4e932 | 154 | CPUHP_AP_MICROCODE_LOADER, |
96b2bd38 | 155 | CPUHP_AP_PERF_X86_AMD_UNCORE_STARTING, |
95ca792c | 156 | CPUHP_AP_PERF_X86_STARTING, |
9744f7b7 | 157 | CPUHP_AP_PERF_X86_AMD_IBS_STARTING, |
f0704827 | 158 | CPUHP_AP_PERF_X86_CQM_STARTING, |
77c34ef1 | 159 | CPUHP_AP_PERF_X86_CSTATE_STARTING, |
25a77b55 | 160 | CPUHP_AP_PERF_XTENSA_STARTING, |
65264e3b | 161 | CPUHP_AP_MIPS_OP_LOONGSON3_STARTING, |
da351827 | 162 | CPUHP_AP_ARM_SDEI_STARTING, |
e5b61baf | 163 | CPUHP_AP_ARM_VFP_STARTING, |
e937dd57 | 164 | CPUHP_AP_ARM64_DEBUG_MONITORS_STARTING, |
d7a83d12 | 165 | CPUHP_AP_PERF_ARM_HW_BREAKPOINT_STARTING, |
45736a72 | 166 | CPUHP_AP_PERF_ARM_ACPI_STARTING, |
7d88eb69 | 167 | CPUHP_AP_PERF_ARM_STARTING, |
9eeb2264 | 168 | CPUHP_AP_ARM_L2X0_STARTING, |
6282edb7 | 169 | CPUHP_AP_EXYNOS4_MCT_TIMER_STARTING, |
7e86e8bd | 170 | CPUHP_AP_ARM_ARCH_TIMER_STARTING, |
b8a12296 | 171 | CPUHP_AP_ARM_GLOBAL_TIMER_STARTING, |
9995f4f1 | 172 | CPUHP_AP_JCORE_TIMER_STARTING, |
26b87688 | 173 | CPUHP_AP_ARM_TWD_STARTING, |
b0404165 | 174 | CPUHP_AP_QCOM_TIMER_STARTING, |
b4822dc7 | 175 | CPUHP_AP_TEGRA_TIMER_STARTING, |
2c48fef7 | 176 | CPUHP_AP_ARMADA_TIMER_STARTING, |
eb0a9d8c | 177 | CPUHP_AP_MARCO_TIMER_STARTING, |
2dab9093 | 178 | CPUHP_AP_MIPS_GIC_TIMER_STARTING, |
ecd8081f | 179 | CPUHP_AP_ARC_TIMER_STARTING, |
62b01943 | 180 | CPUHP_AP_RISCV_TIMER_STARTING, |
2ac6795f | 181 | CPUHP_AP_CLINT_TIMER_STARTING, |
a7ad38b0 | 182 | CPUHP_AP_CSKY_TIMER_STARTING, |
25de4ce5 | 183 | CPUHP_AP_TI_GP_TIMER_STARTING, |
4df4cb9e | 184 | CPUHP_AP_HYPERV_TIMER_STARTING, |
8c18b2d2 | 185 | CPUHP_AP_KVM_STARTING, |
15d7e3d3 | 186 | CPUHP_AP_KVM_ARM_VGIC_INIT_STARTING, |
42ec50b5 | 187 | CPUHP_AP_KVM_ARM_VGIC_STARTING, |
b3c9950a | 188 | CPUHP_AP_KVM_ARM_TIMER_STARTING, |
9bf11ecc TG |
189 | /* Must be the last timer callback */ |
190 | CPUHP_AP_DUMMY_TIMER_STARTING, | |
4761adb6 | 191 | CPUHP_AP_ARM_XEN_STARTING, |
2b5283d1 | 192 | CPUHP_AP_ARM_CORESIGHT_STARTING, |
e9b88058 | 193 | CPUHP_AP_ARM_CORESIGHT_CTI_STARTING, |
27c01a8c | 194 | CPUHP_AP_ARM64_ISNDEP_STARTING, |
31487f83 | 195 | CPUHP_AP_SMPCFD_DYING, |
ae6a8a2e | 196 | CPUHP_AP_X86_TBOOT_DYING, |
55de8877 | 197 | CPUHP_AP_ARM_CACHE_B15_RAC_DYING, |
4baa0afc TG |
198 | CPUHP_AP_ONLINE, |
199 | CPUHP_TEARDOWN_CPU, | |
c9871c80 TG |
200 | |
201 | /* Online section invoked on the hotplugged CPU from the hotplug thread */ | |
fc6d73d6 | 202 | CPUHP_AP_ONLINE_IDLE, |
1cf12e08 | 203 | CPUHP_AP_SCHED_WAIT_EMPTY, |
1cf4f629 | 204 | CPUHP_AP_SMPBOOT_THREADS, |
07d36c9e | 205 | CPUHP_AP_X86_VDSO_VMA_ONLINE, |
c5cb83bb | 206 | CPUHP_AP_IRQ_AFFINITY_ONLINE, |
bf0beec0 | 207 | CPUHP_AP_BLK_MQ_ONLINE, |
77bc8c28 | 208 | CPUHP_AP_ARM_MVEBU_SYNC_CLOCKS, |
5861381d | 209 | CPUHP_AP_X86_INTEL_EPB_ONLINE, |
00e16c3d | 210 | CPUHP_AP_PERF_ONLINE, |
95ca792c | 211 | CPUHP_AP_PERF_X86_ONLINE, |
1a246b9f | 212 | CPUHP_AP_PERF_X86_UNCORE_ONLINE, |
96b2bd38 | 213 | CPUHP_AP_PERF_X86_AMD_UNCORE_ONLINE, |
c6a84daa | 214 | CPUHP_AP_PERF_X86_AMD_POWER_ONLINE, |
8b5b773d | 215 | CPUHP_AP_PERF_X86_RAPL_ONLINE, |
f0704827 | 216 | CPUHP_AP_PERF_X86_CQM_ONLINE, |
77c34ef1 | 217 | CPUHP_AP_PERF_X86_CSTATE_ONLINE, |
81dd4d4d | 218 | CPUHP_AP_PERF_X86_IDXD_ONLINE, |
4f0f8217 | 219 | CPUHP_AP_PERF_S390_CF_ONLINE, |
e3d617fe | 220 | CPUHP_AP_PERF_S390_SF_ONLINE, |
28c94843 | 221 | CPUHP_AP_PERF_ARM_CCI_ONLINE, |
fdc15a36 | 222 | CPUHP_AP_PERF_ARM_CCN_ONLINE, |
904dcf03 | 223 | CPUHP_AP_PERF_ARM_HISI_DDRC_ONLINE, |
2bab3cf9 | 224 | CPUHP_AP_PERF_ARM_HISI_HHA_ONLINE, |
2940bc43 | 225 | CPUHP_AP_PERF_ARM_HISI_L3_ONLINE, |
a0ab25cd | 226 | CPUHP_AP_PERF_ARM_HISI_PA_ONLINE, |
3bf30882 | 227 | CPUHP_AP_PERF_ARM_HISI_SLLC_ONLINE, |
b828f960 | 228 | CPUHP_AP_PERF_ARM_L2X0_ONLINE, |
21bdbb71 | 229 | CPUHP_AP_PERF_ARM_QCOM_L2_ONLINE, |
3071f13d | 230 | CPUHP_AP_PERF_ARM_QCOM_L3_ONLINE, |
cbb72a3c | 231 | CPUHP_AP_PERF_ARM_APM_XGENE_ONLINE, |
69c32972 | 232 | CPUHP_AP_PERF_ARM_CAVIUM_TX2_UNCORE_ONLINE, |
885dcd70 | 233 | CPUHP_AP_PERF_POWERPC_NEST_IMC_ONLINE, |
39a846db | 234 | CPUHP_AP_PERF_POWERPC_CORE_IMC_ONLINE, |
f74c89bd | 235 | CPUHP_AP_PERF_POWERPC_THREAD_IMC_ONLINE, |
72c69dcd | 236 | CPUHP_AP_PERF_POWERPC_TRACE_IMC_ONLINE, |
1a8f0886 | 237 | CPUHP_AP_PERF_POWERPC_HV_24x7_ONLINE, |
dcb5cdf6 | 238 | CPUHP_AP_PERF_POWERPC_HV_GPCI_ONLINE, |
398cb924 | 239 | CPUHP_AP_PERF_CSKY_ONLINE, |
9cf57731 | 240 | CPUHP_AP_WATCHDOG_ONLINE, |
7ee681b2 | 241 | CPUHP_AP_WORKQUEUE_ONLINE, |
4df83742 | 242 | CPUHP_AP_RCUTREE_ONLINE, |
83b44fe3 | 243 | CPUHP_AP_BASE_CACHEINFO_ONLINE, |
1cf4f629 TG |
244 | CPUHP_AP_ONLINE_DYN, |
245 | CPUHP_AP_ONLINE_DYN_END = CPUHP_AP_ONLINE_DYN + 30, | |
a6a0251c HY |
246 | /* Must be after CPUHP_AP_ONLINE_DYN for node_states[N_CPU] update */ |
247 | CPUHP_AP_MM_DEMOTION_ONLINE, | |
48d7f6c7 | 248 | CPUHP_AP_X86_HPET_ONLINE, |
251a5fd6 | 249 | CPUHP_AP_X86_KVM_CLK_ONLINE, |
aaddd7d1 | 250 | CPUHP_AP_ACTIVE, |
cff7d378 TG |
251 | CPUHP_ONLINE, |
252 | }; | |
253 | ||
5b7aa87e TG |
254 | int __cpuhp_setup_state(enum cpuhp_state state, const char *name, bool invoke, |
255 | int (*startup)(unsigned int cpu), | |
cf392d10 | 256 | int (*teardown)(unsigned int cpu), bool multi_instance); |
5b7aa87e | 257 | |
71def423 SAS |
258 | int __cpuhp_setup_state_cpuslocked(enum cpuhp_state state, const char *name, |
259 | bool invoke, | |
260 | int (*startup)(unsigned int cpu), | |
261 | int (*teardown)(unsigned int cpu), | |
262 | bool multi_instance); | |
5b7aa87e | 263 | /** |
c9871c80 TG |
264 | * cpuhp_setup_state - Setup hotplug state callbacks with calling the @startup |
265 | * callback | |
5b7aa87e TG |
266 | * @state: The state for which the calls are installed |
267 | * @name: Name of the callback (will be used in debug output) | |
c9871c80 TG |
268 | * @startup: startup callback function or NULL if not required |
269 | * @teardown: teardown callback function or NULL if not required | |
5b7aa87e | 270 | * |
c9871c80 TG |
271 | * Installs the callback functions and invokes the @startup callback on |
272 | * the online cpus which have already reached the @state. | |
5b7aa87e TG |
273 | */ |
274 | static inline int cpuhp_setup_state(enum cpuhp_state state, | |
275 | const char *name, | |
276 | int (*startup)(unsigned int cpu), | |
277 | int (*teardown)(unsigned int cpu)) | |
278 | { | |
cf392d10 | 279 | return __cpuhp_setup_state(state, name, true, startup, teardown, false); |
5b7aa87e TG |
280 | } |
281 | ||
c9871c80 TG |
282 | /** |
283 | * cpuhp_setup_state_cpuslocked - Setup hotplug state callbacks with calling | |
284 | * @startup callback from a cpus_read_lock() | |
285 | * held region | |
286 | * @state: The state for which the calls are installed | |
287 | * @name: Name of the callback (will be used in debug output) | |
288 | * @startup: startup callback function or NULL if not required | |
289 | * @teardown: teardown callback function or NULL if not required | |
290 | * | |
291 | * Same as cpuhp_setup_state() except that it must be invoked from within a | |
292 | * cpus_read_lock() held region. | |
293 | */ | |
71def423 SAS |
294 | static inline int cpuhp_setup_state_cpuslocked(enum cpuhp_state state, |
295 | const char *name, | |
296 | int (*startup)(unsigned int cpu), | |
297 | int (*teardown)(unsigned int cpu)) | |
298 | { | |
299 | return __cpuhp_setup_state_cpuslocked(state, name, true, startup, | |
300 | teardown, false); | |
301 | } | |
302 | ||
5b7aa87e TG |
303 | /** |
304 | * cpuhp_setup_state_nocalls - Setup hotplug state callbacks without calling the | |
c9871c80 | 305 | * @startup callback |
5b7aa87e TG |
306 | * @state: The state for which the calls are installed |
307 | * @name: Name of the callback. | |
c9871c80 TG |
308 | * @startup: startup callback function or NULL if not required |
309 | * @teardown: teardown callback function or NULL if not required | |
5b7aa87e | 310 | * |
c9871c80 TG |
311 | * Same as cpuhp_setup_state() except that the @startup callback is not |
312 | * invoked during installation. NOP if SMP=n or HOTPLUG_CPU=n. | |
5b7aa87e TG |
313 | */ |
314 | static inline int cpuhp_setup_state_nocalls(enum cpuhp_state state, | |
315 | const char *name, | |
316 | int (*startup)(unsigned int cpu), | |
317 | int (*teardown)(unsigned int cpu)) | |
318 | { | |
cf392d10 TG |
319 | return __cpuhp_setup_state(state, name, false, startup, teardown, |
320 | false); | |
321 | } | |
322 | ||
c9871c80 TG |
323 | /** |
324 | * cpuhp_setup_state_nocalls_cpuslocked - Setup hotplug state callbacks without | |
325 | * invoking the @startup callback from | |
326 | * a cpus_read_lock() held region | |
327 | * callbacks | |
328 | * @state: The state for which the calls are installed | |
329 | * @name: Name of the callback. | |
330 | * @startup: startup callback function or NULL if not required | |
331 | * @teardown: teardown callback function or NULL if not required | |
332 | * | |
333 | * Same as cpuhp_setup_state_nocalls() except that it must be invoked from | |
334 | * within a cpus_read_lock() held region. | |
335 | */ | |
71def423 SAS |
336 | static inline int cpuhp_setup_state_nocalls_cpuslocked(enum cpuhp_state state, |
337 | const char *name, | |
338 | int (*startup)(unsigned int cpu), | |
339 | int (*teardown)(unsigned int cpu)) | |
340 | { | |
341 | return __cpuhp_setup_state_cpuslocked(state, name, false, startup, | |
342 | teardown, false); | |
343 | } | |
344 | ||
cf392d10 TG |
345 | /** |
346 | * cpuhp_setup_state_multi - Add callbacks for multi state | |
347 | * @state: The state for which the calls are installed | |
348 | * @name: Name of the callback. | |
c9871c80 TG |
349 | * @startup: startup callback function or NULL if not required |
350 | * @teardown: teardown callback function or NULL if not required | |
cf392d10 TG |
351 | * |
352 | * Sets the internal multi_instance flag and prepares a state to work as a multi | |
353 | * instance callback. No callbacks are invoked at this point. The callbacks are | |
354 | * invoked once an instance for this state are registered via | |
c9871c80 | 355 | * cpuhp_state_add_instance() or cpuhp_state_add_instance_nocalls() |
cf392d10 TG |
356 | */ |
357 | static inline int cpuhp_setup_state_multi(enum cpuhp_state state, | |
358 | const char *name, | |
359 | int (*startup)(unsigned int cpu, | |
360 | struct hlist_node *node), | |
361 | int (*teardown)(unsigned int cpu, | |
362 | struct hlist_node *node)) | |
363 | { | |
364 | return __cpuhp_setup_state(state, name, false, | |
365 | (void *) startup, | |
366 | (void *) teardown, true); | |
367 | } | |
368 | ||
369 | int __cpuhp_state_add_instance(enum cpuhp_state state, struct hlist_node *node, | |
370 | bool invoke); | |
9805c673 TG |
371 | int __cpuhp_state_add_instance_cpuslocked(enum cpuhp_state state, |
372 | struct hlist_node *node, bool invoke); | |
cf392d10 TG |
373 | |
374 | /** | |
375 | * cpuhp_state_add_instance - Add an instance for a state and invoke startup | |
376 | * callback. | |
377 | * @state: The state for which the instance is installed | |
378 | * @node: The node for this individual state. | |
379 | * | |
c9871c80 TG |
380 | * Installs the instance for the @state and invokes the registered startup |
381 | * callback on the online cpus which have already reached the @state. The | |
382 | * @state must have been earlier marked as multi-instance by | |
383 | * cpuhp_setup_state_multi(). | |
cf392d10 TG |
384 | */ |
385 | static inline int cpuhp_state_add_instance(enum cpuhp_state state, | |
386 | struct hlist_node *node) | |
387 | { | |
388 | return __cpuhp_state_add_instance(state, node, true); | |
389 | } | |
390 | ||
391 | /** | |
392 | * cpuhp_state_add_instance_nocalls - Add an instance for a state without | |
393 | * invoking the startup callback. | |
394 | * @state: The state for which the instance is installed | |
395 | * @node: The node for this individual state. | |
396 | * | |
c9871c80 TG |
397 | * Installs the instance for the @state. The @state must have been earlier |
398 | * marked as multi-instance by cpuhp_setup_state_multi. NOP if SMP=n or | |
399 | * HOTPLUG_CPU=n. | |
cf392d10 TG |
400 | */ |
401 | static inline int cpuhp_state_add_instance_nocalls(enum cpuhp_state state, | |
402 | struct hlist_node *node) | |
403 | { | |
404 | return __cpuhp_state_add_instance(state, node, false); | |
5b7aa87e TG |
405 | } |
406 | ||
c9871c80 TG |
407 | /** |
408 | * cpuhp_state_add_instance_nocalls_cpuslocked - Add an instance for a state | |
409 | * without invoking the startup | |
410 | * callback from a cpus_read_lock() | |
411 | * held region. | |
412 | * @state: The state for which the instance is installed | |
413 | * @node: The node for this individual state. | |
414 | * | |
415 | * Same as cpuhp_state_add_instance_nocalls() except that it must be | |
416 | * invoked from within a cpus_read_lock() held region. | |
417 | */ | |
9805c673 TG |
418 | static inline int |
419 | cpuhp_state_add_instance_nocalls_cpuslocked(enum cpuhp_state state, | |
420 | struct hlist_node *node) | |
421 | { | |
422 | return __cpuhp_state_add_instance_cpuslocked(state, node, false); | |
423 | } | |
424 | ||
5b7aa87e | 425 | void __cpuhp_remove_state(enum cpuhp_state state, bool invoke); |
71def423 | 426 | void __cpuhp_remove_state_cpuslocked(enum cpuhp_state state, bool invoke); |
5b7aa87e TG |
427 | |
428 | /** | |
429 | * cpuhp_remove_state - Remove hotplug state callbacks and invoke the teardown | |
430 | * @state: The state for which the calls are removed | |
431 | * | |
432 | * Removes the callback functions and invokes the teardown callback on | |
c9871c80 | 433 | * the online cpus which have already reached the @state. |
5b7aa87e TG |
434 | */ |
435 | static inline void cpuhp_remove_state(enum cpuhp_state state) | |
436 | { | |
437 | __cpuhp_remove_state(state, true); | |
438 | } | |
439 | ||
440 | /** | |
441 | * cpuhp_remove_state_nocalls - Remove hotplug state callbacks without invoking | |
c9871c80 | 442 | * the teardown callback |
5b7aa87e TG |
443 | * @state: The state for which the calls are removed |
444 | */ | |
445 | static inline void cpuhp_remove_state_nocalls(enum cpuhp_state state) | |
446 | { | |
447 | __cpuhp_remove_state(state, false); | |
448 | } | |
449 | ||
c9871c80 TG |
450 | /** |
451 | * cpuhp_remove_state_nocalls_cpuslocked - Remove hotplug state callbacks without invoking | |
452 | * teardown from a cpus_read_lock() held region. | |
453 | * @state: The state for which the calls are removed | |
454 | * | |
455 | * Same as cpuhp_remove_state nocalls() except that it must be invoked | |
456 | * from within a cpus_read_lock() held region. | |
457 | */ | |
71def423 SAS |
458 | static inline void cpuhp_remove_state_nocalls_cpuslocked(enum cpuhp_state state) |
459 | { | |
460 | __cpuhp_remove_state_cpuslocked(state, false); | |
461 | } | |
462 | ||
cf392d10 TG |
463 | /** |
464 | * cpuhp_remove_multi_state - Remove hotplug multi state callback | |
465 | * @state: The state for which the calls are removed | |
466 | * | |
467 | * Removes the callback functions from a multi state. This is the reverse of | |
468 | * cpuhp_setup_state_multi(). All instances should have been removed before | |
469 | * invoking this function. | |
470 | */ | |
471 | static inline void cpuhp_remove_multi_state(enum cpuhp_state state) | |
472 | { | |
473 | __cpuhp_remove_state(state, false); | |
474 | } | |
475 | ||
476 | int __cpuhp_state_remove_instance(enum cpuhp_state state, | |
477 | struct hlist_node *node, bool invoke); | |
478 | ||
479 | /** | |
480 | * cpuhp_state_remove_instance - Remove hotplug instance from state and invoke | |
481 | * the teardown callback | |
482 | * @state: The state from which the instance is removed | |
483 | * @node: The node for this individual state. | |
484 | * | |
c9871c80 TG |
485 | * Removes the instance and invokes the teardown callback on the online cpus |
486 | * which have already reached @state. | |
cf392d10 TG |
487 | */ |
488 | static inline int cpuhp_state_remove_instance(enum cpuhp_state state, | |
489 | struct hlist_node *node) | |
490 | { | |
491 | return __cpuhp_state_remove_instance(state, node, true); | |
492 | } | |
493 | ||
494 | /** | |
495 | * cpuhp_state_remove_instance_nocalls - Remove hotplug instance from state | |
c91eb283 | 496 | * without invoking the teardown callback |
cf392d10 TG |
497 | * @state: The state from which the instance is removed |
498 | * @node: The node for this individual state. | |
499 | * | |
500 | * Removes the instance without invoking the teardown callback. | |
501 | */ | |
502 | static inline int cpuhp_state_remove_instance_nocalls(enum cpuhp_state state, | |
503 | struct hlist_node *node) | |
504 | { | |
505 | return __cpuhp_state_remove_instance(state, node, false); | |
506 | } | |
507 | ||
8df3e07e TG |
508 | #ifdef CONFIG_SMP |
509 | void cpuhp_online_idle(enum cpuhp_state state); | |
510 | #else | |
511 | static inline void cpuhp_online_idle(enum cpuhp_state state) { } | |
512 | #endif | |
513 | ||
cff7d378 | 514 | #endif |