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> |
1da177e4 | 21 | |
313162d0 | 22 | struct device; |
d1cb9d1a | 23 | struct device_node; |
3d52943b | 24 | struct attribute_group; |
313162d0 | 25 | |
1da177e4 LT |
26 | struct cpu { |
27 | int node_id; /* The node which contains the CPU */ | |
72486f1f | 28 | int hotpluggable; /* creates sysfs control file if hotpluggable */ |
8a25a2fd | 29 | struct device dev; |
1da177e4 LT |
30 | }; |
31 | ||
cff7d378 TG |
32 | extern void boot_cpu_init(void); |
33 | extern void boot_cpu_state_init(void); | |
1777e463 IM |
34 | extern void cpu_init(void); |
35 | extern void trap_init(void); | |
cff7d378 | 36 | |
76b67ed9 | 37 | extern int register_cpu(struct cpu *cpu, int num); |
8a25a2fd | 38 | extern struct device *get_cpu_device(unsigned cpu); |
2987557f | 39 | extern bool cpu_is_hotpluggable(unsigned cpu); |
183912d3 | 40 | extern bool arch_match_cpu_phys_id(int cpu, u64 phys_id); |
d1cb9d1a DM |
41 | extern bool arch_find_n_match_cpu_physical_id(struct device_node *cpun, |
42 | int cpu, unsigned int *thread); | |
0344c6c5 | 43 | |
8a25a2fd KS |
44 | extern int cpu_add_dev_attr(struct device_attribute *attr); |
45 | extern void cpu_remove_dev_attr(struct device_attribute *attr); | |
0344c6c5 | 46 | |
8a25a2fd KS |
47 | extern int cpu_add_dev_attr_group(struct attribute_group *attrs); |
48 | extern void cpu_remove_dev_attr_group(struct attribute_group *attrs); | |
0344c6c5 | 49 | |
8db14860 NI |
50 | extern __printf(4, 5) |
51 | struct device *cpu_device_create(struct device *parent, void *drvdata, | |
52 | const struct attribute_group **groups, | |
53 | const char *fmt, ...); | |
1da177e4 | 54 | #ifdef CONFIG_HOTPLUG_CPU |
76b67ed9 | 55 | extern void unregister_cpu(struct cpu *cpu); |
12633e80 NF |
56 | extern ssize_t arch_cpu_probe(const char *, size_t); |
57 | extern ssize_t arch_cpu_release(const char *, size_t); | |
1da177e4 LT |
58 | #endif |
59 | struct notifier_block; | |
60 | ||
80f1ff97 AW |
61 | #define CPU_ONLINE 0x0002 /* CPU (unsigned)v is up */ |
62 | #define CPU_UP_PREPARE 0x0003 /* CPU (unsigned)v coming up */ | |
80f1ff97 | 63 | #define CPU_DEAD 0x0007 /* CPU (unsigned)v dead */ |
80f1ff97 AW |
64 | #define CPU_POST_DEAD 0x0009 /* CPU (unsigned)v dead, cpu_hotplug |
65 | * lock is dropped */ | |
27d50c7e | 66 | #define CPU_BROKEN 0x000B /* CPU (unsigned)v did not die properly, |
8038dad7 | 67 | * perhaps due to preemption. */ |
80f1ff97 AW |
68 | |
69 | /* Used for CPU hotplug events occurring while tasks are frozen due to a suspend | |
70 | * operation in progress | |
71 | */ | |
72 | #define CPU_TASKS_FROZEN 0x0010 | |
73 | ||
74 | #define CPU_ONLINE_FROZEN (CPU_ONLINE | CPU_TASKS_FROZEN) | |
75 | #define CPU_UP_PREPARE_FROZEN (CPU_UP_PREPARE | CPU_TASKS_FROZEN) | |
76 | #define CPU_UP_CANCELED_FROZEN (CPU_UP_CANCELED | CPU_TASKS_FROZEN) | |
77 | #define CPU_DOWN_PREPARE_FROZEN (CPU_DOWN_PREPARE | CPU_TASKS_FROZEN) | |
78 | #define CPU_DOWN_FAILED_FROZEN (CPU_DOWN_FAILED | CPU_TASKS_FROZEN) | |
79 | #define CPU_DEAD_FROZEN (CPU_DEAD | CPU_TASKS_FROZEN) | |
80f1ff97 | 80 | |
1da177e4 | 81 | #ifdef CONFIG_SMP |
090e77c3 | 82 | extern bool cpuhp_tasks_frozen; |
1da177e4 | 83 | int cpu_up(unsigned int cpu); |
e545a614 | 84 | void notify_cpu_starting(unsigned int cpu); |
3da1c84c ON |
85 | extern void cpu_maps_update_begin(void); |
86 | extern void cpu_maps_update_done(void); | |
d0d23b54 | 87 | |
3da1c84c | 88 | #else /* CONFIG_SMP */ |
090e77c3 | 89 | #define cpuhp_tasks_frozen 0 |
1da177e4 | 90 | |
3da1c84c ON |
91 | static inline void cpu_maps_update_begin(void) |
92 | { | |
93 | } | |
94 | ||
95 | static inline void cpu_maps_update_done(void) | |
96 | { | |
97 | } | |
98 | ||
1da177e4 | 99 | #endif /* CONFIG_SMP */ |
8a25a2fd | 100 | extern struct bus_type cpu_subsys; |
1da177e4 LT |
101 | |
102 | #ifdef CONFIG_HOTPLUG_CPU | |
8f553c49 TG |
103 | extern void cpus_write_lock(void); |
104 | extern void cpus_write_unlock(void); | |
105 | extern void cpus_read_lock(void); | |
106 | extern void cpus_read_unlock(void); | |
fc8dffd3 | 107 | extern void lockdep_assert_cpus_held(void); |
16e53dbf SB |
108 | extern void cpu_hotplug_disable(void); |
109 | extern void cpu_hotplug_enable(void); | |
cb79295e | 110 | void clear_tasks_mm_cpumask(int cpu); |
1da177e4 | 111 | int cpu_down(unsigned int cpu); |
f7dff2b1 | 112 | |
8f553c49 TG |
113 | #else /* CONFIG_HOTPLUG_CPU */ |
114 | ||
115 | static inline void cpus_write_lock(void) { } | |
116 | static inline void cpus_write_unlock(void) { } | |
117 | static inline void cpus_read_lock(void) { } | |
118 | static inline void cpus_read_unlock(void) { } | |
ade3f680 | 119 | static inline void lockdep_assert_cpus_held(void) { } |
8f553c49 TG |
120 | static inline void cpu_hotplug_disable(void) { } |
121 | static inline void cpu_hotplug_enable(void) { } | |
122 | #endif /* !CONFIG_HOTPLUG_CPU */ | |
123 | ||
124 | /* Wrappers which go away once all code is converted */ | |
125 | static inline void cpu_hotplug_begin(void) { cpus_write_lock(); } | |
126 | static inline void cpu_hotplug_done(void) { cpus_write_unlock(); } | |
127 | static inline void get_online_cpus(void) { cpus_read_lock(); } | |
128 | static inline void put_online_cpus(void) { cpus_read_unlock(); } | |
1da177e4 | 129 | |
f3de4be9 | 130 | #ifdef CONFIG_PM_SLEEP_SMP |
d391e552 JM |
131 | extern int freeze_secondary_cpus(int primary); |
132 | static inline int disable_nonboot_cpus(void) | |
133 | { | |
134 | return freeze_secondary_cpus(0); | |
135 | } | |
e3920fb4 | 136 | extern void enable_nonboot_cpus(void); |
f3de4be9 | 137 | #else /* !CONFIG_PM_SLEEP_SMP */ |
e3920fb4 RW |
138 | static inline int disable_nonboot_cpus(void) { return 0; } |
139 | static inline void enable_nonboot_cpus(void) {} | |
f3de4be9 | 140 | #endif /* !CONFIG_PM_SLEEP_SMP */ |
e3920fb4 | 141 | |
a1a04ec3 | 142 | void cpu_startup_entry(enum cpuhp_state state); |
a1a04ec3 | 143 | |
d1669912 TG |
144 | void cpu_idle_poll_ctrl(bool enable); |
145 | ||
6727ad9e CM |
146 | /* Attach to any functions which should be considered cpuidle. */ |
147 | #define __cpuidle __attribute__((__section__(".cpuidle.text"))) | |
148 | ||
149 | bool cpu_in_idle(unsigned long pc); | |
150 | ||
d1669912 TG |
151 | void arch_cpu_idle(void); |
152 | void arch_cpu_idle_prepare(void); | |
153 | void arch_cpu_idle_enter(void); | |
154 | void arch_cpu_idle_exit(void); | |
155 | void arch_cpu_idle_dead(void); | |
156 | ||
8038dad7 PM |
157 | int cpu_report_state(int cpu); |
158 | int cpu_check_up_prepare(int cpu); | |
159 | void cpu_set_state_online(int cpu); | |
c1de45ca PZ |
160 | void play_idle(unsigned long duration_ms); |
161 | ||
8038dad7 PM |
162 | #ifdef CONFIG_HOTPLUG_CPU |
163 | bool cpu_wait_death(unsigned int cpu, int seconds); | |
164 | bool cpu_report_death(void); | |
e69aab13 TG |
165 | void cpuhp_report_idle_dead(void); |
166 | #else | |
167 | static inline void cpuhp_report_idle_dead(void) { } | |
8038dad7 PM |
168 | #endif /* #ifdef CONFIG_HOTPLUG_CPU */ |
169 | ||
1da177e4 | 170 | #endif /* _LINUX_CPU_H_ */ |