| 1 | /* SPDX-License-Identifier: GPL-2.0-or-later */ | 
|---|
| 2 | #ifndef _LINUX_MEMBLOCK_H | 
|---|
| 3 | #define _LINUX_MEMBLOCK_H | 
|---|
| 4 |  | 
|---|
| 5 | /* | 
|---|
| 6 | * Logical memory blocks. | 
|---|
| 7 | * | 
|---|
| 8 | * Copyright (C) 2001 Peter Bergner, IBM Corp. | 
|---|
| 9 | */ | 
|---|
| 10 |  | 
|---|
| 11 | #include <linux/init.h> | 
|---|
| 12 | #include <linux/mm.h> | 
|---|
| 13 | #include <asm/dma.h> | 
|---|
| 14 |  | 
|---|
| 15 | extern unsigned long max_low_pfn; | 
|---|
| 16 | extern unsigned long min_low_pfn; | 
|---|
| 17 |  | 
|---|
| 18 | /* | 
|---|
| 19 | * highest page | 
|---|
| 20 | */ | 
|---|
| 21 | extern unsigned long max_pfn; | 
|---|
| 22 | /* | 
|---|
| 23 | * highest possible page | 
|---|
| 24 | */ | 
|---|
| 25 | extern unsigned long long max_possible_pfn; | 
|---|
| 26 |  | 
|---|
| 27 | /** | 
|---|
| 28 | * enum memblock_flags - definition of memory region attributes | 
|---|
| 29 | * @MEMBLOCK_NONE: no special request | 
|---|
| 30 | * @MEMBLOCK_HOTPLUG: memory region indicated in the firmware-provided memory | 
|---|
| 31 | * map during early boot as hot(un)pluggable system RAM (e.g., memory range | 
|---|
| 32 | * that might get hotunplugged later). With "movable_node" set on the kernel | 
|---|
| 33 | * commandline, try keeping this memory region hotunpluggable. Does not apply | 
|---|
| 34 | * to memblocks added ("hotplugged") after early boot. | 
|---|
| 35 | * @MEMBLOCK_MIRROR: mirrored region | 
|---|
| 36 | * @MEMBLOCK_NOMAP: don't add to kernel direct mapping and treat as | 
|---|
| 37 | * reserved in the memory map; refer to memblock_mark_nomap() description | 
|---|
| 38 | * for further details | 
|---|
| 39 | * @MEMBLOCK_DRIVER_MANAGED: memory region that is always detected and added | 
|---|
| 40 | * via a driver, and never indicated in the firmware-provided memory map as | 
|---|
| 41 | * system RAM. This corresponds to IORESOURCE_SYSRAM_DRIVER_MANAGED in the | 
|---|
| 42 | * kernel resource tree. | 
|---|
| 43 | * @MEMBLOCK_RSRV_NOINIT: reserved memory region for which struct pages are not | 
|---|
| 44 | * fully initialized. Users of this flag are responsible to properly initialize | 
|---|
| 45 | * struct pages of this region | 
|---|
| 46 | * @MEMBLOCK_RSRV_KERN: memory region that is reserved for kernel use, | 
|---|
| 47 | * either explictitly with memblock_reserve_kern() or via memblock | 
|---|
| 48 | * allocation APIs. All memblock allocations set this flag. | 
|---|
| 49 | * @MEMBLOCK_KHO_SCRATCH: memory region that kexec can pass to the next | 
|---|
| 50 | * kernel in handover mode. During early boot, we do not know about all | 
|---|
| 51 | * memory reservations yet, so we get scratch memory from the previous | 
|---|
| 52 | * kernel that we know is good to use. It is the only memory that | 
|---|
| 53 | * allocations may happen from in this phase. | 
|---|
| 54 | */ | 
|---|
| 55 | enum memblock_flags { | 
|---|
| 56 | MEMBLOCK_NONE		= 0x0,	/* No special request */ | 
|---|
| 57 | MEMBLOCK_HOTPLUG	= 0x1,	/* hotpluggable region */ | 
|---|
| 58 | MEMBLOCK_MIRROR		= 0x2,	/* mirrored region */ | 
|---|
| 59 | MEMBLOCK_NOMAP		= 0x4,	/* don't add to kernel direct mapping */ | 
|---|
| 60 | MEMBLOCK_DRIVER_MANAGED = 0x8,	/* always detected via a driver */ | 
|---|
| 61 | MEMBLOCK_RSRV_NOINIT	= 0x10,	/* don't initialize struct pages */ | 
|---|
| 62 | MEMBLOCK_RSRV_KERN	= 0x20,	/* memory reserved for kernel use */ | 
|---|
| 63 | MEMBLOCK_KHO_SCRATCH	= 0x40,	/* scratch memory for kexec handover */ | 
|---|
| 64 | }; | 
|---|
| 65 |  | 
|---|
| 66 | /** | 
|---|
| 67 | * struct memblock_region - represents a memory region | 
|---|
| 68 | * @base: base address of the region | 
|---|
| 69 | * @size: size of the region | 
|---|
| 70 | * @flags: memory region attributes | 
|---|
| 71 | * @nid: NUMA node id | 
|---|
| 72 | */ | 
|---|
| 73 | struct memblock_region { | 
|---|
| 74 | phys_addr_t base; | 
|---|
| 75 | phys_addr_t size; | 
|---|
| 76 | enum memblock_flags flags; | 
|---|
| 77 | #ifdef CONFIG_NUMA | 
|---|
| 78 | int nid; | 
|---|
| 79 | #endif | 
|---|
| 80 | }; | 
|---|
| 81 |  | 
|---|
| 82 | /** | 
|---|
| 83 | * struct memblock_type - collection of memory regions of certain type | 
|---|
| 84 | * @cnt: number of regions | 
|---|
| 85 | * @max: size of the allocated array | 
|---|
| 86 | * @total_size: size of all regions | 
|---|
| 87 | * @regions: array of regions | 
|---|
| 88 | * @name: the memory type symbolic name | 
|---|
| 89 | */ | 
|---|
| 90 | struct memblock_type { | 
|---|
| 91 | unsigned long cnt; | 
|---|
| 92 | unsigned long max; | 
|---|
| 93 | phys_addr_t total_size; | 
|---|
| 94 | struct memblock_region *regions; | 
|---|
| 95 | char *name; | 
|---|
| 96 | }; | 
|---|
| 97 |  | 
|---|
| 98 | /** | 
|---|
| 99 | * struct memblock - memblock allocator metadata | 
|---|
| 100 | * @bottom_up: is bottom up direction? | 
|---|
| 101 | * @current_limit: physical address of the current allocation limit | 
|---|
| 102 | * @memory: usable memory regions | 
|---|
| 103 | * @reserved: reserved memory regions | 
|---|
| 104 | */ | 
|---|
| 105 | struct memblock { | 
|---|
| 106 | bool bottom_up;  /* is bottom up direction? */ | 
|---|
| 107 | phys_addr_t current_limit; | 
|---|
| 108 | struct memblock_type memory; | 
|---|
| 109 | struct memblock_type reserved; | 
|---|
| 110 | }; | 
|---|
| 111 |  | 
|---|
| 112 | extern struct memblock memblock; | 
|---|
| 113 |  | 
|---|
| 114 | #ifndef CONFIG_ARCH_KEEP_MEMBLOCK | 
|---|
| 115 | #define __init_memblock __meminit | 
|---|
| 116 | #define __initdata_memblock __meminitdata | 
|---|
| 117 | void memblock_discard(void); | 
|---|
| 118 | #else | 
|---|
| 119 | #define __init_memblock | 
|---|
| 120 | #define __initdata_memblock | 
|---|
| 121 | static inline void memblock_discard(void) {} | 
|---|
| 122 | #endif | 
|---|
| 123 |  | 
|---|
| 124 | void memblock_allow_resize(void); | 
|---|
| 125 | int memblock_add_node(phys_addr_t base, phys_addr_t size, int nid, | 
|---|
| 126 | enum memblock_flags flags); | 
|---|
| 127 | int memblock_add(phys_addr_t base, phys_addr_t size); | 
|---|
| 128 | int memblock_remove(phys_addr_t base, phys_addr_t size); | 
|---|
| 129 | int memblock_phys_free(phys_addr_t base, phys_addr_t size); | 
|---|
| 130 | int __memblock_reserve(phys_addr_t base, phys_addr_t size, int nid, | 
|---|
| 131 | enum memblock_flags flags); | 
|---|
| 132 |  | 
|---|
| 133 | static __always_inline int memblock_reserve(phys_addr_t base, phys_addr_t size) | 
|---|
| 134 | { | 
|---|
| 135 | return __memblock_reserve(base, size, NUMA_NO_NODE, flags: 0); | 
|---|
| 136 | } | 
|---|
| 137 |  | 
|---|
| 138 | static __always_inline int memblock_reserve_kern(phys_addr_t base, phys_addr_t size) | 
|---|
| 139 | { | 
|---|
| 140 | return __memblock_reserve(base, size, NUMA_NO_NODE, flags: MEMBLOCK_RSRV_KERN); | 
|---|
| 141 | } | 
|---|
| 142 |  | 
|---|
| 143 | #ifdef CONFIG_HAVE_MEMBLOCK_PHYS_MAP | 
|---|
| 144 | int memblock_physmem_add(phys_addr_t base, phys_addr_t size); | 
|---|
| 145 | #endif | 
|---|
| 146 | void memblock_trim_memory(phys_addr_t align); | 
|---|
| 147 | unsigned long memblock_addrs_overlap(phys_addr_t base1, phys_addr_t size1, | 
|---|
| 148 | phys_addr_t base2, phys_addr_t size2); | 
|---|
| 149 | bool memblock_overlaps_region(struct memblock_type *type, | 
|---|
| 150 | phys_addr_t base, phys_addr_t size); | 
|---|
| 151 | bool memblock_validate_numa_coverage(unsigned long threshold_bytes); | 
|---|
| 152 | int memblock_mark_hotplug(phys_addr_t base, phys_addr_t size); | 
|---|
| 153 | int memblock_clear_hotplug(phys_addr_t base, phys_addr_t size); | 
|---|
| 154 | int memblock_mark_mirror(phys_addr_t base, phys_addr_t size); | 
|---|
| 155 | int memblock_mark_nomap(phys_addr_t base, phys_addr_t size); | 
|---|
| 156 | int memblock_clear_nomap(phys_addr_t base, phys_addr_t size); | 
|---|
| 157 | int memblock_reserved_mark_noinit(phys_addr_t base, phys_addr_t size); | 
|---|
| 158 | int memblock_mark_kho_scratch(phys_addr_t base, phys_addr_t size); | 
|---|
| 159 | int memblock_clear_kho_scratch(phys_addr_t base, phys_addr_t size); | 
|---|
| 160 |  | 
|---|
| 161 | void memblock_free(void *ptr, size_t size); | 
|---|
| 162 | void reset_all_zones_managed_pages(void); | 
|---|
| 163 |  | 
|---|
| 164 | /* Low level functions */ | 
|---|
| 165 | void __next_mem_range(u64 *idx, int nid, enum memblock_flags flags, | 
|---|
| 166 | struct memblock_type *type_a, | 
|---|
| 167 | struct memblock_type *type_b, phys_addr_t *out_start, | 
|---|
| 168 | phys_addr_t *out_end, int *out_nid); | 
|---|
| 169 |  | 
|---|
| 170 | void __next_mem_range_rev(u64 *idx, int nid, enum memblock_flags flags, | 
|---|
| 171 | struct memblock_type *type_a, | 
|---|
| 172 | struct memblock_type *type_b, phys_addr_t *out_start, | 
|---|
| 173 | phys_addr_t *out_end, int *out_nid); | 
|---|
| 174 |  | 
|---|
| 175 | void memblock_free_late(phys_addr_t base, phys_addr_t size); | 
|---|
| 176 |  | 
|---|
| 177 | #ifdef CONFIG_HAVE_MEMBLOCK_PHYS_MAP | 
|---|
| 178 | static inline void __next_physmem_range(u64 *idx, struct memblock_type *type, | 
|---|
| 179 | phys_addr_t *out_start, | 
|---|
| 180 | phys_addr_t *out_end) | 
|---|
| 181 | { | 
|---|
| 182 | extern struct memblock_type physmem; | 
|---|
| 183 |  | 
|---|
| 184 | __next_mem_range(idx, NUMA_NO_NODE, MEMBLOCK_NONE, &physmem, type, | 
|---|
| 185 | out_start, out_end, NULL); | 
|---|
| 186 | } | 
|---|
| 187 |  | 
|---|
| 188 | /** | 
|---|
| 189 | * for_each_physmem_range - iterate through physmem areas not included in type. | 
|---|
| 190 | * @i: u64 used as loop variable | 
|---|
| 191 | * @type: ptr to memblock_type which excludes from the iteration, can be %NULL | 
|---|
| 192 | * @p_start: ptr to phys_addr_t for start address of the range, can be %NULL | 
|---|
| 193 | * @p_end: ptr to phys_addr_t for end address of the range, can be %NULL | 
|---|
| 194 | */ | 
|---|
| 195 | #define for_each_physmem_range(i, type, p_start, p_end)			\ | 
|---|
| 196 | for (i = 0, __next_physmem_range(&i, type, p_start, p_end);	\ | 
|---|
| 197 | i != (u64)ULLONG_MAX;					\ | 
|---|
| 198 | __next_physmem_range(&i, type, p_start, p_end)) | 
|---|
| 199 | #endif /* CONFIG_HAVE_MEMBLOCK_PHYS_MAP */ | 
|---|
| 200 |  | 
|---|
| 201 | /** | 
|---|
| 202 | * __for_each_mem_range - iterate through memblock areas from type_a and not | 
|---|
| 203 | * included in type_b. Or just type_a if type_b is NULL. | 
|---|
| 204 | * @i: u64 used as loop variable | 
|---|
| 205 | * @type_a: ptr to memblock_type to iterate | 
|---|
| 206 | * @type_b: ptr to memblock_type which excludes from the iteration | 
|---|
| 207 | * @nid: node selector, %NUMA_NO_NODE for all nodes | 
|---|
| 208 | * @flags: pick from blocks based on memory attributes | 
|---|
| 209 | * @p_start: ptr to phys_addr_t for start address of the range, can be %NULL | 
|---|
| 210 | * @p_end: ptr to phys_addr_t for end address of the range, can be %NULL | 
|---|
| 211 | * @p_nid: ptr to int for nid of the range, can be %NULL | 
|---|
| 212 | */ | 
|---|
| 213 | #define __for_each_mem_range(i, type_a, type_b, nid, flags,		\ | 
|---|
| 214 | p_start, p_end, p_nid)			\ | 
|---|
| 215 | for (i = 0, __next_mem_range(&i, nid, flags, type_a, type_b,	\ | 
|---|
| 216 | p_start, p_end, p_nid);		\ | 
|---|
| 217 | i != (u64)ULLONG_MAX;					\ | 
|---|
| 218 | __next_mem_range(&i, nid, flags, type_a, type_b,		\ | 
|---|
| 219 | p_start, p_end, p_nid)) | 
|---|
| 220 |  | 
|---|
| 221 | /** | 
|---|
| 222 | * __for_each_mem_range_rev - reverse iterate through memblock areas from | 
|---|
| 223 | * type_a and not included in type_b. Or just type_a if type_b is NULL. | 
|---|
| 224 | * @i: u64 used as loop variable | 
|---|
| 225 | * @type_a: ptr to memblock_type to iterate | 
|---|
| 226 | * @type_b: ptr to memblock_type which excludes from the iteration | 
|---|
| 227 | * @nid: node selector, %NUMA_NO_NODE for all nodes | 
|---|
| 228 | * @flags: pick from blocks based on memory attributes | 
|---|
| 229 | * @p_start: ptr to phys_addr_t for start address of the range, can be %NULL | 
|---|
| 230 | * @p_end: ptr to phys_addr_t for end address of the range, can be %NULL | 
|---|
| 231 | * @p_nid: ptr to int for nid of the range, can be %NULL | 
|---|
| 232 | */ | 
|---|
| 233 | #define __for_each_mem_range_rev(i, type_a, type_b, nid, flags,		\ | 
|---|
| 234 | p_start, p_end, p_nid)			\ | 
|---|
| 235 | for (i = (u64)ULLONG_MAX,					\ | 
|---|
| 236 | __next_mem_range_rev(&i, nid, flags, type_a, type_b, \ | 
|---|
| 237 | p_start, p_end, p_nid);	\ | 
|---|
| 238 | i != (u64)ULLONG_MAX;					\ | 
|---|
| 239 | __next_mem_range_rev(&i, nid, flags, type_a, type_b,	\ | 
|---|
| 240 | p_start, p_end, p_nid)) | 
|---|
| 241 |  | 
|---|
| 242 | /** | 
|---|
| 243 | * for_each_mem_range - iterate through memory areas. | 
|---|
| 244 | * @i: u64 used as loop variable | 
|---|
| 245 | * @p_start: ptr to phys_addr_t for start address of the range, can be %NULL | 
|---|
| 246 | * @p_end: ptr to phys_addr_t for end address of the range, can be %NULL | 
|---|
| 247 | */ | 
|---|
| 248 | #define for_each_mem_range(i, p_start, p_end) \ | 
|---|
| 249 | __for_each_mem_range(i, &memblock.memory, NULL, NUMA_NO_NODE,	\ | 
|---|
| 250 | MEMBLOCK_HOTPLUG | MEMBLOCK_DRIVER_MANAGED, \ | 
|---|
| 251 | p_start, p_end, NULL) | 
|---|
| 252 |  | 
|---|
| 253 | /** | 
|---|
| 254 | * for_each_mem_range_rev - reverse iterate through memblock areas from | 
|---|
| 255 | * type_a and not included in type_b. Or just type_a if type_b is NULL. | 
|---|
| 256 | * @i: u64 used as loop variable | 
|---|
| 257 | * @p_start: ptr to phys_addr_t for start address of the range, can be %NULL | 
|---|
| 258 | * @p_end: ptr to phys_addr_t for end address of the range, can be %NULL | 
|---|
| 259 | */ | 
|---|
| 260 | #define for_each_mem_range_rev(i, p_start, p_end)			\ | 
|---|
| 261 | __for_each_mem_range_rev(i, &memblock.memory, NULL, NUMA_NO_NODE, \ | 
|---|
| 262 | MEMBLOCK_HOTPLUG | MEMBLOCK_DRIVER_MANAGED,\ | 
|---|
| 263 | p_start, p_end, NULL) | 
|---|
| 264 |  | 
|---|
| 265 | /** | 
|---|
| 266 | * for_each_reserved_mem_range - iterate over all reserved memblock areas | 
|---|
| 267 | * @i: u64 used as loop variable | 
|---|
| 268 | * @p_start: ptr to phys_addr_t for start address of the range, can be %NULL | 
|---|
| 269 | * @p_end: ptr to phys_addr_t for end address of the range, can be %NULL | 
|---|
| 270 | * | 
|---|
| 271 | * Walks over reserved areas of memblock. Available as soon as memblock | 
|---|
| 272 | * is initialized. | 
|---|
| 273 | */ | 
|---|
| 274 | #define for_each_reserved_mem_range(i, p_start, p_end)			\ | 
|---|
| 275 | __for_each_mem_range(i, &memblock.reserved, NULL, NUMA_NO_NODE,	\ | 
|---|
| 276 | MEMBLOCK_NONE, p_start, p_end, NULL) | 
|---|
| 277 |  | 
|---|
| 278 | static inline bool memblock_is_hotpluggable(struct memblock_region *m) | 
|---|
| 279 | { | 
|---|
| 280 | return m->flags & MEMBLOCK_HOTPLUG; | 
|---|
| 281 | } | 
|---|
| 282 |  | 
|---|
| 283 | static inline bool memblock_is_mirror(struct memblock_region *m) | 
|---|
| 284 | { | 
|---|
| 285 | return m->flags & MEMBLOCK_MIRROR; | 
|---|
| 286 | } | 
|---|
| 287 |  | 
|---|
| 288 | static inline bool memblock_is_nomap(struct memblock_region *m) | 
|---|
| 289 | { | 
|---|
| 290 | return m->flags & MEMBLOCK_NOMAP; | 
|---|
| 291 | } | 
|---|
| 292 |  | 
|---|
| 293 | static inline bool memblock_is_reserved_noinit(struct memblock_region *m) | 
|---|
| 294 | { | 
|---|
| 295 | return m->flags & MEMBLOCK_RSRV_NOINIT; | 
|---|
| 296 | } | 
|---|
| 297 |  | 
|---|
| 298 | static inline bool memblock_is_driver_managed(struct memblock_region *m) | 
|---|
| 299 | { | 
|---|
| 300 | return m->flags & MEMBLOCK_DRIVER_MANAGED; | 
|---|
| 301 | } | 
|---|
| 302 |  | 
|---|
| 303 | static inline bool memblock_is_kho_scratch(struct memblock_region *m) | 
|---|
| 304 | { | 
|---|
| 305 | return m->flags & MEMBLOCK_KHO_SCRATCH; | 
|---|
| 306 | } | 
|---|
| 307 |  | 
|---|
| 308 | int memblock_search_pfn_nid(unsigned long pfn, unsigned long *start_pfn, | 
|---|
| 309 | unsigned long  *end_pfn); | 
|---|
| 310 | void __next_mem_pfn_range(int *idx, int nid, unsigned long *out_start_pfn, | 
|---|
| 311 | unsigned long *out_end_pfn, int *out_nid); | 
|---|
| 312 |  | 
|---|
| 313 | /** | 
|---|
| 314 | * for_each_mem_pfn_range - early memory pfn range iterator | 
|---|
| 315 | * @i: an integer used as loop variable | 
|---|
| 316 | * @nid: node selector, %MAX_NUMNODES for all nodes | 
|---|
| 317 | * @p_start: ptr to ulong for start pfn of the range, can be %NULL | 
|---|
| 318 | * @p_end: ptr to ulong for end pfn of the range, can be %NULL | 
|---|
| 319 | * @p_nid: ptr to int for nid of the range, can be %NULL | 
|---|
| 320 | * | 
|---|
| 321 | * Walks over configured memory ranges. | 
|---|
| 322 | */ | 
|---|
| 323 | #define for_each_mem_pfn_range(i, nid, p_start, p_end, p_nid)		\ | 
|---|
| 324 | for (i = -1, __next_mem_pfn_range(&i, nid, p_start, p_end, p_nid); \ | 
|---|
| 325 | i >= 0; __next_mem_pfn_range(&i, nid, p_start, p_end, p_nid)) | 
|---|
| 326 |  | 
|---|
| 327 |  | 
|---|
| 328 | /** | 
|---|
| 329 | * for_each_free_mem_range - iterate through free memblock areas | 
|---|
| 330 | * @i: u64 used as loop variable | 
|---|
| 331 | * @nid: node selector, %NUMA_NO_NODE for all nodes | 
|---|
| 332 | * @flags: pick from blocks based on memory attributes | 
|---|
| 333 | * @p_start: ptr to phys_addr_t for start address of the range, can be %NULL | 
|---|
| 334 | * @p_end: ptr to phys_addr_t for end address of the range, can be %NULL | 
|---|
| 335 | * @p_nid: ptr to int for nid of the range, can be %NULL | 
|---|
| 336 | * | 
|---|
| 337 | * Walks over free (memory && !reserved) areas of memblock.  Available as | 
|---|
| 338 | * soon as memblock is initialized. | 
|---|
| 339 | */ | 
|---|
| 340 | #define for_each_free_mem_range(i, nid, flags, p_start, p_end, p_nid)	\ | 
|---|
| 341 | __for_each_mem_range(i, &memblock.memory, &memblock.reserved,	\ | 
|---|
| 342 | nid, flags, p_start, p_end, p_nid) | 
|---|
| 343 |  | 
|---|
| 344 | /** | 
|---|
| 345 | * for_each_free_mem_range_reverse - rev-iterate through free memblock areas | 
|---|
| 346 | * @i: u64 used as loop variable | 
|---|
| 347 | * @nid: node selector, %NUMA_NO_NODE for all nodes | 
|---|
| 348 | * @flags: pick from blocks based on memory attributes | 
|---|
| 349 | * @p_start: ptr to phys_addr_t for start address of the range, can be %NULL | 
|---|
| 350 | * @p_end: ptr to phys_addr_t for end address of the range, can be %NULL | 
|---|
| 351 | * @p_nid: ptr to int for nid of the range, can be %NULL | 
|---|
| 352 | * | 
|---|
| 353 | * Walks over free (memory && !reserved) areas of memblock in reverse | 
|---|
| 354 | * order.  Available as soon as memblock is initialized. | 
|---|
| 355 | */ | 
|---|
| 356 | #define for_each_free_mem_range_reverse(i, nid, flags, p_start, p_end,	\ | 
|---|
| 357 | p_nid)				\ | 
|---|
| 358 | __for_each_mem_range_rev(i, &memblock.memory, &memblock.reserved, \ | 
|---|
| 359 | nid, flags, p_start, p_end, p_nid) | 
|---|
| 360 |  | 
|---|
| 361 | int memblock_set_node(phys_addr_t base, phys_addr_t size, | 
|---|
| 362 | struct memblock_type *type, int nid); | 
|---|
| 363 |  | 
|---|
| 364 | #ifdef CONFIG_NUMA | 
|---|
| 365 | static inline void memblock_set_region_node(struct memblock_region *r, int nid) | 
|---|
| 366 | { | 
|---|
| 367 | r->nid = nid; | 
|---|
| 368 | } | 
|---|
| 369 |  | 
|---|
| 370 | static inline int memblock_get_region_node(const struct memblock_region *r) | 
|---|
| 371 | { | 
|---|
| 372 | return r->nid; | 
|---|
| 373 | } | 
|---|
| 374 | #else | 
|---|
| 375 | static inline void memblock_set_region_node(struct memblock_region *r, int nid) | 
|---|
| 376 | { | 
|---|
| 377 | } | 
|---|
| 378 |  | 
|---|
| 379 | static inline int memblock_get_region_node(const struct memblock_region *r) | 
|---|
| 380 | { | 
|---|
| 381 | return 0; | 
|---|
| 382 | } | 
|---|
| 383 | #endif /* CONFIG_NUMA */ | 
|---|
| 384 |  | 
|---|
| 385 | /* Flags for memblock allocation APIs */ | 
|---|
| 386 | #define MEMBLOCK_ALLOC_ANYWHERE	(~(phys_addr_t)0) | 
|---|
| 387 | #define MEMBLOCK_ALLOC_ACCESSIBLE	0 | 
|---|
| 388 | /* | 
|---|
| 389 | *  MEMBLOCK_ALLOC_NOLEAKTRACE avoids kmemleak tracing. It implies | 
|---|
| 390 | *  MEMBLOCK_ALLOC_ACCESSIBLE | 
|---|
| 391 | */ | 
|---|
| 392 | #define MEMBLOCK_ALLOC_NOLEAKTRACE	1 | 
|---|
| 393 |  | 
|---|
| 394 | /* We are using top down, so it is safe to use 0 here */ | 
|---|
| 395 | #define MEMBLOCK_LOW_LIMIT 0 | 
|---|
| 396 |  | 
|---|
| 397 | #ifndef ARCH_LOW_ADDRESS_LIMIT | 
|---|
| 398 | #define ARCH_LOW_ADDRESS_LIMIT  0xffffffffUL | 
|---|
| 399 | #endif | 
|---|
| 400 |  | 
|---|
| 401 | phys_addr_t memblock_phys_alloc_range(phys_addr_t size, phys_addr_t align, | 
|---|
| 402 | phys_addr_t start, phys_addr_t end); | 
|---|
| 403 | phys_addr_t memblock_alloc_range_nid(phys_addr_t size, | 
|---|
| 404 | phys_addr_t align, phys_addr_t start, | 
|---|
| 405 | phys_addr_t end, int nid, bool exact_nid); | 
|---|
| 406 | phys_addr_t memblock_phys_alloc_try_nid(phys_addr_t size, phys_addr_t align, int nid); | 
|---|
| 407 |  | 
|---|
| 408 | static __always_inline phys_addr_t memblock_phys_alloc(phys_addr_t size, | 
|---|
| 409 | phys_addr_t align) | 
|---|
| 410 | { | 
|---|
| 411 | return memblock_phys_alloc_range(size, align, start: 0, | 
|---|
| 412 | MEMBLOCK_ALLOC_ACCESSIBLE); | 
|---|
| 413 | } | 
|---|
| 414 |  | 
|---|
| 415 | void *memblock_alloc_exact_nid_raw(phys_addr_t size, phys_addr_t align, | 
|---|
| 416 | phys_addr_t min_addr, phys_addr_t max_addr, | 
|---|
| 417 | int nid); | 
|---|
| 418 | void *memblock_alloc_try_nid_raw(phys_addr_t size, phys_addr_t align, | 
|---|
| 419 | phys_addr_t min_addr, phys_addr_t max_addr, | 
|---|
| 420 | int nid); | 
|---|
| 421 | void *memblock_alloc_try_nid(phys_addr_t size, phys_addr_t align, | 
|---|
| 422 | phys_addr_t min_addr, phys_addr_t max_addr, | 
|---|
| 423 | int nid); | 
|---|
| 424 |  | 
|---|
| 425 | static __always_inline void *memblock_alloc(phys_addr_t size, phys_addr_t align) | 
|---|
| 426 | { | 
|---|
| 427 | return memblock_alloc_try_nid(size, align, MEMBLOCK_LOW_LIMIT, | 
|---|
| 428 | MEMBLOCK_ALLOC_ACCESSIBLE, NUMA_NO_NODE); | 
|---|
| 429 | } | 
|---|
| 430 |  | 
|---|
| 431 | void *__memblock_alloc_or_panic(phys_addr_t size, phys_addr_t align, | 
|---|
| 432 | const char *func); | 
|---|
| 433 |  | 
|---|
| 434 | #define memblock_alloc_or_panic(size, align)    \ | 
|---|
| 435 | __memblock_alloc_or_panic(size, align, __func__) | 
|---|
| 436 |  | 
|---|
| 437 | static inline void *memblock_alloc_raw(phys_addr_t size, | 
|---|
| 438 | phys_addr_t align) | 
|---|
| 439 | { | 
|---|
| 440 | return memblock_alloc_try_nid_raw(size, align, MEMBLOCK_LOW_LIMIT, | 
|---|
| 441 | MEMBLOCK_ALLOC_ACCESSIBLE, | 
|---|
| 442 | NUMA_NO_NODE); | 
|---|
| 443 | } | 
|---|
| 444 |  | 
|---|
| 445 | static __always_inline void *memblock_alloc_from(phys_addr_t size, | 
|---|
| 446 | phys_addr_t align, | 
|---|
| 447 | phys_addr_t min_addr) | 
|---|
| 448 | { | 
|---|
| 449 | return memblock_alloc_try_nid(size, align, min_addr, | 
|---|
| 450 | MEMBLOCK_ALLOC_ACCESSIBLE, NUMA_NO_NODE); | 
|---|
| 451 | } | 
|---|
| 452 |  | 
|---|
| 453 | static inline void *memblock_alloc_low(phys_addr_t size, | 
|---|
| 454 | phys_addr_t align) | 
|---|
| 455 | { | 
|---|
| 456 | return memblock_alloc_try_nid(size, align, MEMBLOCK_LOW_LIMIT, | 
|---|
| 457 | ARCH_LOW_ADDRESS_LIMIT, NUMA_NO_NODE); | 
|---|
| 458 | } | 
|---|
| 459 |  | 
|---|
| 460 | static inline void *memblock_alloc_node(phys_addr_t size, | 
|---|
| 461 | phys_addr_t align, int nid) | 
|---|
| 462 | { | 
|---|
| 463 | return memblock_alloc_try_nid(size, align, MEMBLOCK_LOW_LIMIT, | 
|---|
| 464 | MEMBLOCK_ALLOC_ACCESSIBLE, nid); | 
|---|
| 465 | } | 
|---|
| 466 |  | 
|---|
| 467 | /* | 
|---|
| 468 | * Set the allocation direction to bottom-up or top-down. | 
|---|
| 469 | */ | 
|---|
| 470 | static inline __init_memblock void memblock_set_bottom_up(bool enable) | 
|---|
| 471 | { | 
|---|
| 472 | memblock.bottom_up = enable; | 
|---|
| 473 | } | 
|---|
| 474 |  | 
|---|
| 475 | /* | 
|---|
| 476 | * Check if the allocation direction is bottom-up or not. | 
|---|
| 477 | * if this is true, that said, memblock will allocate memory | 
|---|
| 478 | * in bottom-up direction. | 
|---|
| 479 | */ | 
|---|
| 480 | static inline __init_memblock bool memblock_bottom_up(void) | 
|---|
| 481 | { | 
|---|
| 482 | return memblock.bottom_up; | 
|---|
| 483 | } | 
|---|
| 484 |  | 
|---|
| 485 | phys_addr_t memblock_phys_mem_size(void); | 
|---|
| 486 | phys_addr_t memblock_reserved_size(void); | 
|---|
| 487 | phys_addr_t memblock_reserved_kern_size(phys_addr_t limit, int nid); | 
|---|
| 488 | unsigned long memblock_estimated_nr_free_pages(void); | 
|---|
| 489 | phys_addr_t memblock_start_of_DRAM(void); | 
|---|
| 490 | phys_addr_t memblock_end_of_DRAM(void); | 
|---|
| 491 | void memblock_enforce_memory_limit(phys_addr_t memory_limit); | 
|---|
| 492 | void memblock_cap_memory_range(phys_addr_t base, phys_addr_t size); | 
|---|
| 493 | void memblock_mem_limit_remove_map(phys_addr_t limit); | 
|---|
| 494 | bool memblock_is_memory(phys_addr_t addr); | 
|---|
| 495 | bool memblock_is_map_memory(phys_addr_t addr); | 
|---|
| 496 | bool memblock_is_region_memory(phys_addr_t base, phys_addr_t size); | 
|---|
| 497 | bool memblock_is_reserved(phys_addr_t addr); | 
|---|
| 498 | bool memblock_is_region_reserved(phys_addr_t base, phys_addr_t size); | 
|---|
| 499 |  | 
|---|
| 500 | void memblock_dump_all(void); | 
|---|
| 501 |  | 
|---|
| 502 | /** | 
|---|
| 503 | * memblock_set_current_limit - Set the current allocation limit to allow | 
|---|
| 504 | *                         limiting allocations to what is currently | 
|---|
| 505 | *                         accessible during boot | 
|---|
| 506 | * @limit: New limit value (physical address) | 
|---|
| 507 | */ | 
|---|
| 508 | void memblock_set_current_limit(phys_addr_t limit); | 
|---|
| 509 |  | 
|---|
| 510 |  | 
|---|
| 511 | phys_addr_t memblock_get_current_limit(void); | 
|---|
| 512 |  | 
|---|
| 513 | /* | 
|---|
| 514 | * pfn conversion functions | 
|---|
| 515 | * | 
|---|
| 516 | * While the memory MEMBLOCKs should always be page aligned, the reserved | 
|---|
| 517 | * MEMBLOCKs may not be. This accessor attempt to provide a very clear | 
|---|
| 518 | * idea of what they return for such non aligned MEMBLOCKs. | 
|---|
| 519 | */ | 
|---|
| 520 |  | 
|---|
| 521 | /** | 
|---|
| 522 | * memblock_region_memory_base_pfn - get the lowest pfn of the memory region | 
|---|
| 523 | * @reg: memblock_region structure | 
|---|
| 524 | * | 
|---|
| 525 | * Return: the lowest pfn intersecting with the memory region | 
|---|
| 526 | */ | 
|---|
| 527 | static inline unsigned long memblock_region_memory_base_pfn(const struct memblock_region *reg) | 
|---|
| 528 | { | 
|---|
| 529 | return PFN_UP(reg->base); | 
|---|
| 530 | } | 
|---|
| 531 |  | 
|---|
| 532 | /** | 
|---|
| 533 | * memblock_region_memory_end_pfn - get the end pfn of the memory region | 
|---|
| 534 | * @reg: memblock_region structure | 
|---|
| 535 | * | 
|---|
| 536 | * Return: the end_pfn of the reserved region | 
|---|
| 537 | */ | 
|---|
| 538 | static inline unsigned long memblock_region_memory_end_pfn(const struct memblock_region *reg) | 
|---|
| 539 | { | 
|---|
| 540 | return PFN_DOWN(reg->base + reg->size); | 
|---|
| 541 | } | 
|---|
| 542 |  | 
|---|
| 543 | /** | 
|---|
| 544 | * memblock_region_reserved_base_pfn - get the lowest pfn of the reserved region | 
|---|
| 545 | * @reg: memblock_region structure | 
|---|
| 546 | * | 
|---|
| 547 | * Return: the lowest pfn intersecting with the reserved region | 
|---|
| 548 | */ | 
|---|
| 549 | static inline unsigned long memblock_region_reserved_base_pfn(const struct memblock_region *reg) | 
|---|
| 550 | { | 
|---|
| 551 | return PFN_DOWN(reg->base); | 
|---|
| 552 | } | 
|---|
| 553 |  | 
|---|
| 554 | /** | 
|---|
| 555 | * memblock_region_reserved_end_pfn - get the end pfn of the reserved region | 
|---|
| 556 | * @reg: memblock_region structure | 
|---|
| 557 | * | 
|---|
| 558 | * Return: the end_pfn of the reserved region | 
|---|
| 559 | */ | 
|---|
| 560 | static inline unsigned long memblock_region_reserved_end_pfn(const struct memblock_region *reg) | 
|---|
| 561 | { | 
|---|
| 562 | return PFN_UP(reg->base + reg->size); | 
|---|
| 563 | } | 
|---|
| 564 |  | 
|---|
| 565 | /** | 
|---|
| 566 | * for_each_mem_region - iterate over memory regions | 
|---|
| 567 | * @region: loop variable | 
|---|
| 568 | */ | 
|---|
| 569 | #define for_each_mem_region(region)					\ | 
|---|
| 570 | for (region = memblock.memory.regions;				\ | 
|---|
| 571 | region < (memblock.memory.regions + memblock.memory.cnt);	\ | 
|---|
| 572 | region++) | 
|---|
| 573 |  | 
|---|
| 574 | /** | 
|---|
| 575 | * for_each_reserved_mem_region - itereate over reserved memory regions | 
|---|
| 576 | * @region: loop variable | 
|---|
| 577 | */ | 
|---|
| 578 | #define for_each_reserved_mem_region(region)				\ | 
|---|
| 579 | for (region = memblock.reserved.regions;			\ | 
|---|
| 580 | region < (memblock.reserved.regions + memblock.reserved.cnt); \ | 
|---|
| 581 | region++) | 
|---|
| 582 |  | 
|---|
| 583 | extern void *alloc_large_system_hash(const char *tablename, | 
|---|
| 584 | unsigned long bucketsize, | 
|---|
| 585 | unsigned long numentries, | 
|---|
| 586 | int scale, | 
|---|
| 587 | int flags, | 
|---|
| 588 | unsigned int *_hash_shift, | 
|---|
| 589 | unsigned int *_hash_mask, | 
|---|
| 590 | unsigned long low_limit, | 
|---|
| 591 | unsigned long high_limit); | 
|---|
| 592 |  | 
|---|
| 593 | #define HASH_EARLY	0x00000001	/* Allocating during early boot? */ | 
|---|
| 594 | #define HASH_ZERO	0x00000002	/* Zero allocated hash table */ | 
|---|
| 595 |  | 
|---|
| 596 | /* Only NUMA needs hash distribution. 64bit NUMA architectures have | 
|---|
| 597 | * sufficient vmalloc space. | 
|---|
| 598 | */ | 
|---|
| 599 | #ifdef CONFIG_NUMA | 
|---|
| 600 | #define HASHDIST_DEFAULT IS_ENABLED(CONFIG_64BIT) | 
|---|
| 601 | extern int hashdist;		/* Distribute hashes across NUMA nodes? */ | 
|---|
| 602 | #else | 
|---|
| 603 | #define hashdist (0) | 
|---|
| 604 | #endif | 
|---|
| 605 |  | 
|---|
| 606 | #ifdef CONFIG_MEMTEST | 
|---|
| 607 | void early_memtest(phys_addr_t start, phys_addr_t end); | 
|---|
| 608 | void memtest_report_meminfo(struct seq_file *m); | 
|---|
| 609 | #else | 
|---|
| 610 | static inline void early_memtest(phys_addr_t start, phys_addr_t end) { } | 
|---|
| 611 | static inline void memtest_report_meminfo(struct seq_file *m) { } | 
|---|
| 612 | #endif | 
|---|
| 613 |  | 
|---|
| 614 | #ifdef CONFIG_MEMBLOCK_KHO_SCRATCH | 
|---|
| 615 | void memblock_set_kho_scratch_only(void); | 
|---|
| 616 | void memblock_clear_kho_scratch_only(void); | 
|---|
| 617 | void memmap_init_kho_scratch_pages(void); | 
|---|
| 618 | #else | 
|---|
| 619 | static inline void memblock_set_kho_scratch_only(void) { } | 
|---|
| 620 | static inline void memblock_clear_kho_scratch_only(void) { } | 
|---|
| 621 | static inline void memmap_init_kho_scratch_pages(void) {} | 
|---|
| 622 | #endif | 
|---|
| 623 |  | 
|---|
| 624 | #endif /* _LINUX_MEMBLOCK_H */ | 
|---|
| 625 |  | 
|---|