1 // SPDX-License-Identifier: GPL-2.0-or-later
3 * acpi_numa.c - ACPI NUMA support
8 #define pr_fmt(fmt) "ACPI: " fmt
10 #include <linux/module.h>
11 #include <linux/init.h>
12 #include <linux/kernel.h>
13 #include <linux/types.h>
14 #include <linux/errno.h>
15 #include <linux/acpi.h>
16 #include <linux/memblock.h>
17 #include <linux/numa.h>
18 #include <linux/nodemask.h>
19 #include <linux/topology.h>
21 static nodemask_t nodes_found_map = NODE_MASK_NONE;
23 /* maps to convert between proximity domain and logical node ID */
24 static int pxm_to_node_map[MAX_PXM_DOMAINS]
25 = { [0 ... MAX_PXM_DOMAINS - 1] = NUMA_NO_NODE };
26 static int node_to_pxm_map[MAX_NUMNODES]
27 = { [0 ... MAX_NUMNODES - 1] = PXM_INVAL };
29 unsigned char acpi_srat_revision __initdata;
30 int acpi_numa __initdata;
32 int pxm_to_node(int pxm)
36 return pxm_to_node_map[pxm];
39 int node_to_pxm(int node)
43 return node_to_pxm_map[node];
46 static void __acpi_map_pxm_to_node(int pxm, int node)
48 if (pxm_to_node_map[pxm] == NUMA_NO_NODE || node < pxm_to_node_map[pxm])
49 pxm_to_node_map[pxm] = node;
50 if (node_to_pxm_map[node] == PXM_INVAL || pxm < node_to_pxm_map[node])
51 node_to_pxm_map[node] = pxm;
54 int acpi_map_pxm_to_node(int pxm)
58 if (pxm < 0 || pxm >= MAX_PXM_DOMAINS || numa_off)
61 node = pxm_to_node_map[pxm];
63 if (node == NUMA_NO_NODE) {
64 if (nodes_weight(nodes_found_map) >= MAX_NUMNODES)
66 node = first_unset_node(nodes_found_map);
67 __acpi_map_pxm_to_node(pxm, node);
68 node_set(node, nodes_found_map);
73 EXPORT_SYMBOL(acpi_map_pxm_to_node);
76 * acpi_map_pxm_to_online_node - Map proximity ID to online node
77 * @pxm: ACPI proximity ID
79 * This is similar to acpi_map_pxm_to_node(), but always returns an online
80 * node. When the mapped node from a given proximity ID is offline, it
81 * looks up the node distance table and returns the nearest online node.
83 * ACPI device drivers, which are called after the NUMA initialization has
84 * completed in the kernel, can call this interface to obtain their device
85 * NUMA topology from ACPI tables. Such drivers do not have to deal with
86 * offline nodes. A node may be offline when a device proximity ID is
87 * unique, SRAT memory entry does not exist, or NUMA is disabled, ex.
90 int acpi_map_pxm_to_online_node(int pxm)
94 node = acpi_map_pxm_to_node(pxm);
96 if (node == NUMA_NO_NODE)
100 if (!node_online(node)) {
101 int min_dist = INT_MAX, dist, n;
103 for_each_online_node(n) {
104 dist = node_distance(node, n);
105 if (dist < min_dist) {
114 EXPORT_SYMBOL(acpi_map_pxm_to_online_node);
117 acpi_table_print_srat_entry(struct acpi_subtable_header *header)
119 switch (header->type) {
120 case ACPI_SRAT_TYPE_CPU_AFFINITY:
122 struct acpi_srat_cpu_affinity *p =
123 (struct acpi_srat_cpu_affinity *)header;
124 pr_debug("SRAT Processor (id[0x%02x] eid[0x%02x]) in proximity domain %d %s\n",
125 p->apic_id, p->local_sapic_eid,
126 p->proximity_domain_lo,
127 (p->flags & ACPI_SRAT_CPU_ENABLED) ?
128 "enabled" : "disabled");
132 case ACPI_SRAT_TYPE_MEMORY_AFFINITY:
134 struct acpi_srat_mem_affinity *p =
135 (struct acpi_srat_mem_affinity *)header;
136 pr_debug("SRAT Memory (0x%llx length 0x%llx) in proximity domain %d %s%s%s\n",
137 (unsigned long long)p->base_address,
138 (unsigned long long)p->length,
140 (p->flags & ACPI_SRAT_MEM_ENABLED) ?
141 "enabled" : "disabled",
142 (p->flags & ACPI_SRAT_MEM_HOT_PLUGGABLE) ?
143 " hot-pluggable" : "",
144 (p->flags & ACPI_SRAT_MEM_NON_VOLATILE) ?
145 " non-volatile" : "");
149 case ACPI_SRAT_TYPE_X2APIC_CPU_AFFINITY:
151 struct acpi_srat_x2apic_cpu_affinity *p =
152 (struct acpi_srat_x2apic_cpu_affinity *)header;
153 pr_debug("SRAT Processor (x2apicid[0x%08x]) in proximity domain %d %s\n",
156 (p->flags & ACPI_SRAT_CPU_ENABLED) ?
157 "enabled" : "disabled");
161 case ACPI_SRAT_TYPE_GICC_AFFINITY:
163 struct acpi_srat_gicc_affinity *p =
164 (struct acpi_srat_gicc_affinity *)header;
165 pr_debug("SRAT Processor (acpi id[0x%04x]) in proximity domain %d %s\n",
166 p->acpi_processor_uid,
168 (p->flags & ACPI_SRAT_GICC_ENABLED) ?
169 "enabled" : "disabled");
174 pr_warn("Found unsupported SRAT entry (type = 0x%x)\n",
181 * A lot of BIOS fill in 10 (= no distance) everywhere. This messes
182 * up the NUMA heuristics which wants the local node to have a smaller
183 * distance than the others.
184 * Do some quick checks here and only use the SLIT if it passes.
186 static int __init slit_valid(struct acpi_table_slit *slit)
189 int d = slit->locality_count;
190 for (i = 0; i < d; i++) {
191 for (j = 0; j < d; j++) {
192 u8 val = slit->entry[d*i + j];
194 if (val != LOCAL_DISTANCE)
196 } else if (val <= LOCAL_DISTANCE)
203 void __init bad_srat(void)
205 pr_err("SRAT: SRAT not used.\n");
209 int __init srat_disabled(void)
211 return acpi_numa < 0;
214 #if defined(CONFIG_X86) || defined(CONFIG_ARM64)
216 * Callback for SLIT parsing. pxm_to_node() returns NUMA_NO_NODE for
217 * I/O localities since SRAT does not list them. I/O localities are
218 * not supported at this point.
220 void __init acpi_numa_slit_init(struct acpi_table_slit *slit)
224 for (i = 0; i < slit->locality_count; i++) {
225 const int from_node = pxm_to_node(i);
227 if (from_node == NUMA_NO_NODE)
230 for (j = 0; j < slit->locality_count; j++) {
231 const int to_node = pxm_to_node(j);
233 if (to_node == NUMA_NO_NODE)
236 numa_set_distance(from_node, to_node,
237 slit->entry[slit->locality_count * i + j]);
243 * Default callback for parsing of the Proximity Domain <-> Memory
247 acpi_numa_memory_affinity_init(struct acpi_srat_mem_affinity *ma)
255 if (ma->header.length < sizeof(struct acpi_srat_mem_affinity)) {
256 pr_err("SRAT: Unexpected header length: %d\n",
258 goto out_err_bad_srat;
260 if ((ma->flags & ACPI_SRAT_MEM_ENABLED) == 0)
262 hotpluggable = ma->flags & ACPI_SRAT_MEM_HOT_PLUGGABLE;
263 if (hotpluggable && !IS_ENABLED(CONFIG_MEMORY_HOTPLUG))
266 start = ma->base_address;
267 end = start + ma->length;
268 pxm = ma->proximity_domain;
269 if (acpi_srat_revision <= 1)
272 node = acpi_map_pxm_to_node(pxm);
273 if (node == NUMA_NO_NODE || node >= MAX_NUMNODES) {
274 pr_err("SRAT: Too many proximity domains.\n");
275 goto out_err_bad_srat;
278 if (numa_add_memblk(node, start, end) < 0) {
279 pr_err("SRAT: Failed to add memblk to node %u [mem %#010Lx-%#010Lx]\n",
280 node, (unsigned long long) start,
281 (unsigned long long) end - 1);
282 goto out_err_bad_srat;
285 node_set(node, numa_nodes_parsed);
287 pr_info("SRAT: Node %u PXM %u [mem %#010Lx-%#010Lx]%s%s\n",
289 (unsigned long long) start, (unsigned long long) end - 1,
290 hotpluggable ? " hotplug" : "",
291 ma->flags & ACPI_SRAT_MEM_NON_VOLATILE ? " non-volatile" : "");
293 /* Mark hotplug range in memblock. */
294 if (hotpluggable && memblock_mark_hotplug(start, ma->length))
295 pr_warn("SRAT: Failed to mark hotplug range [mem %#010Lx-%#010Lx] in memblock\n",
296 (unsigned long long)start, (unsigned long long)end - 1);
298 max_possible_pfn = max(max_possible_pfn, PFN_UP(end - 1));
306 #endif /* defined(CONFIG_X86) || defined (CONFIG_ARM64) */
308 static int __init acpi_parse_slit(struct acpi_table_header *table)
310 struct acpi_table_slit *slit = (struct acpi_table_slit *)table;
312 if (!slit_valid(slit)) {
313 pr_info("SLIT table looks invalid. Not used.\n");
316 acpi_numa_slit_init(slit);
322 acpi_numa_x2apic_affinity_init(struct acpi_srat_x2apic_cpu_affinity *pa)
324 pr_warn("Found unsupported x2apic [0x%08x] SRAT entry\n", pa->apic_id);
328 acpi_parse_x2apic_affinity(union acpi_subtable_headers *header,
329 const unsigned long end)
331 struct acpi_srat_x2apic_cpu_affinity *processor_affinity;
333 processor_affinity = (struct acpi_srat_x2apic_cpu_affinity *)header;
334 if (!processor_affinity)
337 acpi_table_print_srat_entry(&header->common);
339 /* let architecture-dependent part to do it */
340 acpi_numa_x2apic_affinity_init(processor_affinity);
346 acpi_parse_processor_affinity(union acpi_subtable_headers *header,
347 const unsigned long end)
349 struct acpi_srat_cpu_affinity *processor_affinity;
351 processor_affinity = (struct acpi_srat_cpu_affinity *)header;
352 if (!processor_affinity)
355 acpi_table_print_srat_entry(&header->common);
357 /* let architecture-dependent part to do it */
358 acpi_numa_processor_affinity_init(processor_affinity);
364 acpi_parse_gicc_affinity(union acpi_subtable_headers *header,
365 const unsigned long end)
367 struct acpi_srat_gicc_affinity *processor_affinity;
369 processor_affinity = (struct acpi_srat_gicc_affinity *)header;
370 if (!processor_affinity)
373 acpi_table_print_srat_entry(&header->common);
375 /* let architecture-dependent part to do it */
376 acpi_numa_gicc_affinity_init(processor_affinity);
381 static int __initdata parsed_numa_memblks;
384 acpi_parse_memory_affinity(union acpi_subtable_headers * header,
385 const unsigned long end)
387 struct acpi_srat_mem_affinity *memory_affinity;
389 memory_affinity = (struct acpi_srat_mem_affinity *)header;
390 if (!memory_affinity)
393 acpi_table_print_srat_entry(&header->common);
395 /* let architecture-dependent part to do it */
396 if (!acpi_numa_memory_affinity_init(memory_affinity))
397 parsed_numa_memblks++;
401 static int __init acpi_parse_srat(struct acpi_table_header *table)
403 struct acpi_table_srat *srat = (struct acpi_table_srat *)table;
405 acpi_srat_revision = srat->header.revision;
407 /* Real work done in acpi_table_parse_srat below. */
413 acpi_table_parse_srat(enum acpi_srat_type id,
414 acpi_tbl_entry_handler handler, unsigned int max_entries)
416 return acpi_table_parse_entries(ACPI_SIG_SRAT,
417 sizeof(struct acpi_table_srat), id,
418 handler, max_entries);
421 int __init acpi_numa_init(void)
429 * Should not limit number with cpu num that is from NR_CPUS or nr_cpus=
430 * SRAT cpu entries could have different order with that in MADT.
431 * So go over all cpu entries in SRAT to get apicid to node mapping.
434 /* SRAT: System Resource Affinity Table */
435 if (!acpi_table_parse(ACPI_SIG_SRAT, acpi_parse_srat)) {
436 struct acpi_subtable_proc srat_proc[3];
438 memset(srat_proc, 0, sizeof(srat_proc));
439 srat_proc[0].id = ACPI_SRAT_TYPE_CPU_AFFINITY;
440 srat_proc[0].handler = acpi_parse_processor_affinity;
441 srat_proc[1].id = ACPI_SRAT_TYPE_X2APIC_CPU_AFFINITY;
442 srat_proc[1].handler = acpi_parse_x2apic_affinity;
443 srat_proc[2].id = ACPI_SRAT_TYPE_GICC_AFFINITY;
444 srat_proc[2].handler = acpi_parse_gicc_affinity;
446 acpi_table_parse_entries_array(ACPI_SIG_SRAT,
447 sizeof(struct acpi_table_srat),
448 srat_proc, ARRAY_SIZE(srat_proc), 0);
450 cnt = acpi_table_parse_srat(ACPI_SRAT_TYPE_MEMORY_AFFINITY,
451 acpi_parse_memory_affinity, 0);
454 /* SLIT: System Locality Information Table */
455 acpi_table_parse(ACPI_SIG_SLIT, acpi_parse_slit);
459 else if (!parsed_numa_memblks)
464 static int acpi_get_pxm(acpi_handle h)
466 unsigned long long pxm;
469 acpi_handle phandle = h;
473 status = acpi_evaluate_integer(handle, "_PXM", NULL, &pxm);
474 if (ACPI_SUCCESS(status))
476 status = acpi_get_parent(handle, &phandle);
477 } while (ACPI_SUCCESS(status));
481 int acpi_get_node(acpi_handle handle)
485 pxm = acpi_get_pxm(handle);
487 return acpi_map_pxm_to_node(pxm);
489 EXPORT_SYMBOL(acpi_get_node);