]>
Commit | Line | Data |
---|---|---|
1 | /* SPDX-License-Identifier: GPL-2.0 */ | |
2 | #ifndef __LINUX_MEMORY_HOTPLUG_H | |
3 | #define __LINUX_MEMORY_HOTPLUG_H | |
4 | ||
5 | #include <linux/mmzone.h> | |
6 | #include <linux/spinlock.h> | |
7 | #include <linux/notifier.h> | |
8 | #include <linux/bug.h> | |
9 | ||
10 | struct page; | |
11 | struct zone; | |
12 | struct pglist_data; | |
13 | struct mem_section; | |
14 | struct memory_block; | |
15 | struct resource; | |
16 | ||
17 | #ifdef CONFIG_MEMORY_HOTPLUG | |
18 | /* | |
19 | * Return page for the valid pfn only if the page is online. All pfn | |
20 | * walkers which rely on the fully initialized page->flags and others | |
21 | * should use this rather than pfn_valid && pfn_to_page | |
22 | */ | |
23 | #define pfn_to_online_page(pfn) \ | |
24 | ({ \ | |
25 | struct page *___page = NULL; \ | |
26 | unsigned long ___nr = pfn_to_section_nr(pfn); \ | |
27 | \ | |
28 | if (___nr < NR_MEM_SECTIONS && online_section_nr(___nr))\ | |
29 | ___page = pfn_to_page(pfn); \ | |
30 | ___page; \ | |
31 | }) | |
32 | ||
33 | /* | |
34 | * Types for free bootmem stored in page->lru.next. These have to be in | |
35 | * some random range in unsigned long space for debugging purposes. | |
36 | */ | |
37 | enum { | |
38 | MEMORY_HOTPLUG_MIN_BOOTMEM_TYPE = 12, | |
39 | SECTION_INFO = MEMORY_HOTPLUG_MIN_BOOTMEM_TYPE, | |
40 | MIX_SECTION_INFO, | |
41 | NODE_INFO, | |
42 | MEMORY_HOTPLUG_MAX_BOOTMEM_TYPE = NODE_INFO, | |
43 | }; | |
44 | ||
45 | /* Types for control the zone type of onlined and offlined memory */ | |
46 | enum { | |
47 | MMOP_OFFLINE = -1, | |
48 | MMOP_ONLINE_KEEP, | |
49 | MMOP_ONLINE_KERNEL, | |
50 | MMOP_ONLINE_MOVABLE, | |
51 | }; | |
52 | ||
53 | /* | |
54 | * pgdat resizing functions | |
55 | */ | |
56 | static inline | |
57 | void pgdat_resize_lock(struct pglist_data *pgdat, unsigned long *flags) | |
58 | { | |
59 | spin_lock_irqsave(&pgdat->node_size_lock, *flags); | |
60 | } | |
61 | static inline | |
62 | void pgdat_resize_unlock(struct pglist_data *pgdat, unsigned long *flags) | |
63 | { | |
64 | spin_unlock_irqrestore(&pgdat->node_size_lock, *flags); | |
65 | } | |
66 | static inline | |
67 | void pgdat_resize_init(struct pglist_data *pgdat) | |
68 | { | |
69 | spin_lock_init(&pgdat->node_size_lock); | |
70 | } | |
71 | /* | |
72 | * Zone resizing functions | |
73 | * | |
74 | * Note: any attempt to resize a zone should has pgdat_resize_lock() | |
75 | * zone_span_writelock() both held. This ensure the size of a zone | |
76 | * can't be changed while pgdat_resize_lock() held. | |
77 | */ | |
78 | static inline unsigned zone_span_seqbegin(struct zone *zone) | |
79 | { | |
80 | return read_seqbegin(&zone->span_seqlock); | |
81 | } | |
82 | static inline int zone_span_seqretry(struct zone *zone, unsigned iv) | |
83 | { | |
84 | return read_seqretry(&zone->span_seqlock, iv); | |
85 | } | |
86 | static inline void zone_span_writelock(struct zone *zone) | |
87 | { | |
88 | write_seqlock(&zone->span_seqlock); | |
89 | } | |
90 | static inline void zone_span_writeunlock(struct zone *zone) | |
91 | { | |
92 | write_sequnlock(&zone->span_seqlock); | |
93 | } | |
94 | static inline void zone_seqlock_init(struct zone *zone) | |
95 | { | |
96 | seqlock_init(&zone->span_seqlock); | |
97 | } | |
98 | extern int zone_grow_free_lists(struct zone *zone, unsigned long new_nr_pages); | |
99 | extern int zone_grow_waitqueues(struct zone *zone, unsigned long nr_pages); | |
100 | extern int add_one_highpage(struct page *page, int pfn, int bad_ppro); | |
101 | /* VM interface that may be used by firmware interface */ | |
102 | extern int online_pages(unsigned long, unsigned long, int); | |
103 | extern int test_pages_in_a_zone(unsigned long start_pfn, unsigned long end_pfn, | |
104 | unsigned long *valid_start, unsigned long *valid_end); | |
105 | extern void __offline_isolated_pages(unsigned long, unsigned long); | |
106 | ||
107 | typedef void (*online_page_callback_t)(struct page *page); | |
108 | ||
109 | extern int set_online_page_callback(online_page_callback_t callback); | |
110 | extern int restore_online_page_callback(online_page_callback_t callback); | |
111 | ||
112 | extern void __online_page_set_limits(struct page *page); | |
113 | extern void __online_page_increment_counters(struct page *page); | |
114 | extern void __online_page_free(struct page *page); | |
115 | ||
116 | extern int try_online_node(int nid); | |
117 | ||
118 | extern bool memhp_auto_online; | |
119 | /* If movable_node boot option specified */ | |
120 | extern bool movable_node_enabled; | |
121 | static inline bool movable_node_is_enabled(void) | |
122 | { | |
123 | return movable_node_enabled; | |
124 | } | |
125 | ||
126 | #ifdef CONFIG_MEMORY_HOTREMOVE | |
127 | extern bool is_pageblock_removable_nolock(struct page *page); | |
128 | extern int arch_remove_memory(u64 start, u64 size); | |
129 | extern int __remove_pages(struct zone *zone, unsigned long start_pfn, | |
130 | unsigned long nr_pages); | |
131 | #endif /* CONFIG_MEMORY_HOTREMOVE */ | |
132 | ||
133 | /* reasonably generic interface to expand the physical pages */ | |
134 | extern int __add_pages(int nid, unsigned long start_pfn, | |
135 | unsigned long nr_pages, bool want_memblock); | |
136 | ||
137 | #ifndef CONFIG_ARCH_HAS_ADD_PAGES | |
138 | static inline int add_pages(int nid, unsigned long start_pfn, | |
139 | unsigned long nr_pages, bool want_memblock) | |
140 | { | |
141 | return __add_pages(nid, start_pfn, nr_pages, want_memblock); | |
142 | } | |
143 | #else /* ARCH_HAS_ADD_PAGES */ | |
144 | int add_pages(int nid, unsigned long start_pfn, | |
145 | unsigned long nr_pages, bool want_memblock); | |
146 | #endif /* ARCH_HAS_ADD_PAGES */ | |
147 | ||
148 | #ifdef CONFIG_NUMA | |
149 | extern int memory_add_physaddr_to_nid(u64 start); | |
150 | #else | |
151 | static inline int memory_add_physaddr_to_nid(u64 start) | |
152 | { | |
153 | return 0; | |
154 | } | |
155 | #endif | |
156 | ||
157 | #ifdef CONFIG_HAVE_ARCH_NODEDATA_EXTENSION | |
158 | /* | |
159 | * For supporting node-hotadd, we have to allocate a new pgdat. | |
160 | * | |
161 | * If an arch has generic style NODE_DATA(), | |
162 | * node_data[nid] = kzalloc() works well. But it depends on the architecture. | |
163 | * | |
164 | * In general, generic_alloc_nodedata() is used. | |
165 | * Now, arch_free_nodedata() is just defined for error path of node_hot_add. | |
166 | * | |
167 | */ | |
168 | extern pg_data_t *arch_alloc_nodedata(int nid); | |
169 | extern void arch_free_nodedata(pg_data_t *pgdat); | |
170 | extern void arch_refresh_nodedata(int nid, pg_data_t *pgdat); | |
171 | ||
172 | #else /* CONFIG_HAVE_ARCH_NODEDATA_EXTENSION */ | |
173 | ||
174 | #define arch_alloc_nodedata(nid) generic_alloc_nodedata(nid) | |
175 | #define arch_free_nodedata(pgdat) generic_free_nodedata(pgdat) | |
176 | ||
177 | #ifdef CONFIG_NUMA | |
178 | /* | |
179 | * If ARCH_HAS_NODEDATA_EXTENSION=n, this func is used to allocate pgdat. | |
180 | * XXX: kmalloc_node() can't work well to get new node's memory at this time. | |
181 | * Because, pgdat for the new node is not allocated/initialized yet itself. | |
182 | * To use new node's memory, more consideration will be necessary. | |
183 | */ | |
184 | #define generic_alloc_nodedata(nid) \ | |
185 | ({ \ | |
186 | kzalloc(sizeof(pg_data_t), GFP_KERNEL); \ | |
187 | }) | |
188 | /* | |
189 | * This definition is just for error path in node hotadd. | |
190 | * For node hotremove, we have to replace this. | |
191 | */ | |
192 | #define generic_free_nodedata(pgdat) kfree(pgdat) | |
193 | ||
194 | extern pg_data_t *node_data[]; | |
195 | static inline void arch_refresh_nodedata(int nid, pg_data_t *pgdat) | |
196 | { | |
197 | node_data[nid] = pgdat; | |
198 | } | |
199 | ||
200 | #else /* !CONFIG_NUMA */ | |
201 | ||
202 | /* never called */ | |
203 | static inline pg_data_t *generic_alloc_nodedata(int nid) | |
204 | { | |
205 | BUG(); | |
206 | return NULL; | |
207 | } | |
208 | static inline void generic_free_nodedata(pg_data_t *pgdat) | |
209 | { | |
210 | } | |
211 | static inline void arch_refresh_nodedata(int nid, pg_data_t *pgdat) | |
212 | { | |
213 | } | |
214 | #endif /* CONFIG_NUMA */ | |
215 | #endif /* CONFIG_HAVE_ARCH_NODEDATA_EXTENSION */ | |
216 | ||
217 | #ifdef CONFIG_HAVE_BOOTMEM_INFO_NODE | |
218 | extern void __init register_page_bootmem_info_node(struct pglist_data *pgdat); | |
219 | #else | |
220 | static inline void register_page_bootmem_info_node(struct pglist_data *pgdat) | |
221 | { | |
222 | } | |
223 | #endif | |
224 | extern void put_page_bootmem(struct page *page); | |
225 | extern void get_page_bootmem(unsigned long ingo, struct page *page, | |
226 | unsigned long type); | |
227 | ||
228 | void get_online_mems(void); | |
229 | void put_online_mems(void); | |
230 | ||
231 | void mem_hotplug_begin(void); | |
232 | void mem_hotplug_done(void); | |
233 | ||
234 | void set_default_mem_hotplug_zone(enum zone_type zone); | |
235 | ||
236 | extern void set_zone_contiguous(struct zone *zone); | |
237 | extern void clear_zone_contiguous(struct zone *zone); | |
238 | ||
239 | #else /* ! CONFIG_MEMORY_HOTPLUG */ | |
240 | #define pfn_to_online_page(pfn) \ | |
241 | ({ \ | |
242 | struct page *___page = NULL; \ | |
243 | if (pfn_valid(pfn)) \ | |
244 | ___page = pfn_to_page(pfn); \ | |
245 | ___page; \ | |
246 | }) | |
247 | ||
248 | /* | |
249 | * Stub functions for when hotplug is off | |
250 | */ | |
251 | static inline void pgdat_resize_lock(struct pglist_data *p, unsigned long *f) {} | |
252 | static inline void pgdat_resize_unlock(struct pglist_data *p, unsigned long *f) {} | |
253 | static inline void pgdat_resize_init(struct pglist_data *pgdat) {} | |
254 | ||
255 | static inline unsigned zone_span_seqbegin(struct zone *zone) | |
256 | { | |
257 | return 0; | |
258 | } | |
259 | static inline int zone_span_seqretry(struct zone *zone, unsigned iv) | |
260 | { | |
261 | return 0; | |
262 | } | |
263 | static inline void zone_span_writelock(struct zone *zone) {} | |
264 | static inline void zone_span_writeunlock(struct zone *zone) {} | |
265 | static inline void zone_seqlock_init(struct zone *zone) {} | |
266 | ||
267 | static inline int mhp_notimplemented(const char *func) | |
268 | { | |
269 | printk(KERN_WARNING "%s() called, with CONFIG_MEMORY_HOTPLUG disabled\n", func); | |
270 | dump_stack(); | |
271 | return -ENOSYS; | |
272 | } | |
273 | ||
274 | static inline void register_page_bootmem_info_node(struct pglist_data *pgdat) | |
275 | { | |
276 | } | |
277 | ||
278 | static inline int try_online_node(int nid) | |
279 | { | |
280 | return 0; | |
281 | } | |
282 | ||
283 | static inline void get_online_mems(void) {} | |
284 | static inline void put_online_mems(void) {} | |
285 | ||
286 | static inline void mem_hotplug_begin(void) {} | |
287 | static inline void mem_hotplug_done(void) {} | |
288 | ||
289 | static inline void set_default_mem_hotplug_zone(enum zone_type zone) {} | |
290 | ||
291 | static inline bool movable_node_is_enabled(void) | |
292 | { | |
293 | return false; | |
294 | } | |
295 | #endif /* ! CONFIG_MEMORY_HOTPLUG */ | |
296 | ||
297 | #ifdef CONFIG_MEMORY_HOTREMOVE | |
298 | ||
299 | extern bool is_mem_section_removable(unsigned long pfn, unsigned long nr_pages); | |
300 | extern void try_offline_node(int nid); | |
301 | extern int offline_pages(unsigned long start_pfn, unsigned long nr_pages); | |
302 | extern void remove_memory(int nid, u64 start, u64 size); | |
303 | ||
304 | #else | |
305 | static inline bool is_mem_section_removable(unsigned long pfn, | |
306 | unsigned long nr_pages) | |
307 | { | |
308 | return false; | |
309 | } | |
310 | ||
311 | static inline void try_offline_node(int nid) {} | |
312 | ||
313 | static inline int offline_pages(unsigned long start_pfn, unsigned long nr_pages) | |
314 | { | |
315 | return -EINVAL; | |
316 | } | |
317 | ||
318 | static inline void remove_memory(int nid, u64 start, u64 size) {} | |
319 | #endif /* CONFIG_MEMORY_HOTREMOVE */ | |
320 | ||
321 | extern int walk_memory_range(unsigned long start_pfn, unsigned long end_pfn, | |
322 | void *arg, int (*func)(struct memory_block *, void *)); | |
323 | extern int add_memory(int nid, u64 start, u64 size); | |
324 | extern int add_memory_resource(int nid, struct resource *resource, bool online); | |
325 | extern int arch_add_memory(int nid, u64 start, u64 size, bool want_memblock); | |
326 | extern void move_pfn_range_to_zone(struct zone *zone, unsigned long start_pfn, | |
327 | unsigned long nr_pages); | |
328 | extern int offline_pages(unsigned long start_pfn, unsigned long nr_pages); | |
329 | extern bool is_memblock_offlined(struct memory_block *mem); | |
330 | extern void remove_memory(int nid, u64 start, u64 size); | |
331 | extern int sparse_add_one_section(struct pglist_data *pgdat, unsigned long start_pfn); | |
332 | extern void sparse_remove_one_section(struct zone *zone, struct mem_section *ms, | |
333 | unsigned long map_offset); | |
334 | extern struct page *sparse_decode_mem_map(unsigned long coded_mem_map, | |
335 | unsigned long pnum); | |
336 | extern bool allow_online_pfn_range(int nid, unsigned long pfn, unsigned long nr_pages, | |
337 | int online_type); | |
338 | extern struct zone *zone_for_pfn_range(int online_type, int nid, unsigned start_pfn, | |
339 | unsigned long nr_pages); | |
340 | #endif /* __LINUX_MEMORY_HOTPLUG_H */ |