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