2 * NUMA support for s390
4 * NUMA emulation (aka fake NUMA) distributes the available memory to nodes
5 * without using real topology information about the physical memory of the
8 * It distributes the available CPUs to nodes while respecting the original
9 * machine topology information. This is done by trying to avoid to separate
10 * CPUs which reside on the same book or even on the same MC.
12 * Because the current Linux scheduler code requires a stable cpu to node
13 * mapping, cores are pinned to nodes when the first CPU thread is set online.
15 * Copyright IBM Corp. 2015
18 #define KMSG_COMPONENT "numa_emu"
19 #define pr_fmt(fmt) KMSG_COMPONENT ": " fmt
21 #include <linux/kernel.h>
22 #include <linux/cpumask.h>
23 #include <linux/memblock.h>
24 #include <linux/node.h>
25 #include <linux/memory.h>
26 #include <linux/slab.h>
28 #include <asm/topology.h>
29 #include "numa_mode.h"
32 /* Distances between the different system components */
40 /* Node distance reported to common code */
41 #define EMU_NODE_DIST 10
43 /* Node ID for free (not yet pinned) cores */
44 #define NODE_ID_FREE -1
46 /* Different levels of toptree */
47 enum toptree_level
{CORE
, MC
, BOOK
, DRAWER
, NODE
, TOPOLOGY
};
49 /* The two toptree IDs */
50 enum {TOPTREE_ID_PHYS
, TOPTREE_ID_NUMA
};
52 /* Number of NUMA nodes */
53 static int emu_nodes
= 1;
54 /* NUMA stripe size */
55 static unsigned long emu_size
;
58 * Node to core pinning information updates are protected by
59 * "sched_domains_mutex".
62 s32 to_node_id
[CONFIG_NR_CPUS
]; /* Pinned core to node mapping */
63 int total
; /* Total number of pinned cores */
64 int per_node_target
; /* Cores per node without extra cores */
65 int per_node
[MAX_NUMNODES
]; /* Number of cores pinned to node */
69 * Pin a core to a node
71 static void pin_core_to_node(int core_id
, int node_id
)
73 if (emu_cores
->to_node_id
[core_id
] == NODE_ID_FREE
) {
74 emu_cores
->per_node
[node_id
]++;
75 emu_cores
->to_node_id
[core_id
] = node_id
;
78 WARN_ON(emu_cores
->to_node_id
[core_id
] != node_id
);
83 * Number of pinned cores of a node
85 static int cores_pinned(struct toptree
*node
)
87 return emu_cores
->per_node
[node
->id
];
91 * ID of the node where the core is pinned (or NODE_ID_FREE)
93 static int core_pinned_to_node_id(struct toptree
*core
)
95 return emu_cores
->to_node_id
[core
->id
];
99 * Number of cores in the tree that are not yet pinned
101 static int cores_free(struct toptree
*tree
)
103 struct toptree
*core
;
106 toptree_for_each(core
, tree
, CORE
) {
107 if (core_pinned_to_node_id(core
) == NODE_ID_FREE
)
114 * Return node of core
116 static struct toptree
*core_node(struct toptree
*core
)
118 return core
->parent
->parent
->parent
->parent
;
122 * Return drawer of core
124 static struct toptree
*core_drawer(struct toptree
*core
)
126 return core
->parent
->parent
->parent
;
130 * Return book of core
132 static struct toptree
*core_book(struct toptree
*core
)
134 return core
->parent
->parent
;
140 static struct toptree
*core_mc(struct toptree
*core
)
146 * Distance between two cores
148 static int dist_core_to_core(struct toptree
*core1
, struct toptree
*core2
)
150 if (core_drawer(core1
)->id
!= core_drawer(core2
)->id
)
152 if (core_book(core1
)->id
!= core_book(core2
)->id
)
154 if (core_mc(core1
)->id
!= core_mc(core2
)->id
)
156 /* Same core or sibling on same MC */
161 * Distance of a node to a core
163 static int dist_node_to_core(struct toptree
*node
, struct toptree
*core
)
165 struct toptree
*core_node
;
166 int dist_min
= DIST_MAX
;
168 toptree_for_each(core_node
, node
, CORE
)
169 dist_min
= min(dist_min
, dist_core_to_core(core_node
, core
));
170 return dist_min
== DIST_MAX
? DIST_EMPTY
: dist_min
;
174 * Unify will delete empty nodes, therefore recreate nodes.
176 static void toptree_unify_tree(struct toptree
*tree
)
181 for (nid
= 0; nid
< emu_nodes
; nid
++)
182 toptree_get_child(tree
, nid
);
186 * Find the best/nearest node for a given core and ensure that no node
187 * gets more than "emu_cores->per_node_target + extra" cores.
189 static struct toptree
*node_for_core(struct toptree
*numa
, struct toptree
*core
,
192 struct toptree
*node
, *node_best
= NULL
;
193 int dist_cur
, dist_best
, cores_target
;
195 cores_target
= emu_cores
->per_node_target
+ extra
;
196 dist_best
= DIST_MAX
;
198 toptree_for_each(node
, numa
, NODE
) {
199 /* Already pinned cores must use their nodes */
200 if (core_pinned_to_node_id(core
) == node
->id
) {
204 /* Skip nodes that already have enough cores */
205 if (cores_pinned(node
) >= cores_target
)
207 dist_cur
= dist_node_to_core(node
, core
);
208 if (dist_cur
< dist_best
) {
209 dist_best
= dist_cur
;
217 * Find the best node for each core with respect to "extra" core count
219 static void toptree_to_numa_single(struct toptree
*numa
, struct toptree
*phys
,
222 struct toptree
*node
, *core
, *tmp
;
224 toptree_for_each_safe(core
, tmp
, phys
, CORE
) {
225 node
= node_for_core(numa
, core
, extra
);
228 toptree_move(core
, node
);
229 pin_core_to_node(core
->id
, node
->id
);
234 * Move structures of given level to specified NUMA node
236 static void move_level_to_numa_node(struct toptree
*node
, struct toptree
*phys
,
237 enum toptree_level level
, bool perfect
)
239 int cores_free
, cores_target
= emu_cores
->per_node_target
;
240 struct toptree
*cur
, *tmp
;
242 toptree_for_each_safe(cur
, tmp
, phys
, level
) {
243 cores_free
= cores_target
- toptree_count(node
, CORE
);
245 if (cores_free
== toptree_count(cur
, CORE
))
246 toptree_move(cur
, node
);
248 if (cores_free
>= toptree_count(cur
, CORE
))
249 toptree_move(cur
, node
);
255 * Move structures of a given level to NUMA nodes. If "perfect" is specified
256 * move only perfectly fitting structures. Otherwise move also smaller
257 * than needed structures.
259 static void move_level_to_numa(struct toptree
*numa
, struct toptree
*phys
,
260 enum toptree_level level
, bool perfect
)
262 struct toptree
*node
;
264 toptree_for_each(node
, numa
, NODE
)
265 move_level_to_numa_node(node
, phys
, level
, perfect
);
269 * For the first run try to move the big structures
271 static void toptree_to_numa_first(struct toptree
*numa
, struct toptree
*phys
)
273 struct toptree
*core
;
275 /* Always try to move perfectly fitting structures first */
276 move_level_to_numa(numa
, phys
, DRAWER
, true);
277 move_level_to_numa(numa
, phys
, DRAWER
, false);
278 move_level_to_numa(numa
, phys
, BOOK
, true);
279 move_level_to_numa(numa
, phys
, BOOK
, false);
280 move_level_to_numa(numa
, phys
, MC
, true);
281 move_level_to_numa(numa
, phys
, MC
, false);
282 /* Now pin all the moved cores */
283 toptree_for_each(core
, numa
, CORE
)
284 pin_core_to_node(core
->id
, core_node(core
)->id
);
288 * Allocate new topology and create required nodes
290 static struct toptree
*toptree_new(int id
, int nodes
)
292 struct toptree
*tree
;
295 tree
= toptree_alloc(TOPOLOGY
, id
);
298 for (nid
= 0; nid
< nodes
; nid
++) {
299 if (!toptree_get_child(tree
, nid
))
304 panic("NUMA emulation could not allocate topology");
308 * Allocate and initialize core to node mapping
310 static void create_core_to_node_map(void)
314 emu_cores
= kzalloc(sizeof(*emu_cores
), GFP_KERNEL
);
315 if (emu_cores
== NULL
)
316 panic("Could not allocate cores to node memory");
317 for (i
= 0; i
< ARRAY_SIZE(emu_cores
->to_node_id
); i
++)
318 emu_cores
->to_node_id
[i
] = NODE_ID_FREE
;
322 * Move cores from physical topology into NUMA target topology
323 * and try to keep as much of the physical topology as possible.
325 static struct toptree
*toptree_to_numa(struct toptree
*phys
)
327 static int first
= 1;
328 struct toptree
*numa
;
331 cores_total
= emu_cores
->total
+ cores_free(phys
);
332 emu_cores
->per_node_target
= cores_total
/ emu_nodes
;
333 numa
= toptree_new(TOPTREE_ID_NUMA
, emu_nodes
);
335 toptree_to_numa_first(numa
, phys
);
338 toptree_to_numa_single(numa
, phys
, 0);
339 toptree_to_numa_single(numa
, phys
, 1);
340 toptree_unify_tree(numa
);
342 WARN_ON(cpumask_weight(&phys
->mask
));
347 * Create a toptree out of the physical topology that we got from the hypervisor
349 static struct toptree
*toptree_from_topology(void)
351 struct toptree
*phys
, *node
, *drawer
, *book
, *mc
, *core
;
352 struct cpu_topology_s390
*top
;
355 phys
= toptree_new(TOPTREE_ID_PHYS
, 1);
357 for_each_online_cpu(cpu
) {
358 top
= &per_cpu(cpu_topology
, cpu
);
359 node
= toptree_get_child(phys
, 0);
360 drawer
= toptree_get_child(node
, top
->drawer_id
);
361 book
= toptree_get_child(drawer
, top
->book_id
);
362 mc
= toptree_get_child(book
, top
->socket_id
);
363 core
= toptree_get_child(mc
, top
->core_id
);
364 if (!drawer
|| !book
|| !mc
|| !core
)
365 panic("NUMA emulation could not allocate memory");
366 cpumask_set_cpu(cpu
, &core
->mask
);
367 toptree_update_mask(mc
);
373 * Add toptree core to topology and create correct CPU masks
375 static void topology_add_core(struct toptree
*core
)
377 struct cpu_topology_s390
*top
;
380 for_each_cpu(cpu
, &core
->mask
) {
381 top
= &per_cpu(cpu_topology
, cpu
);
382 cpumask_copy(&top
->thread_mask
, &core
->mask
);
383 cpumask_copy(&top
->core_mask
, &core_mc(core
)->mask
);
384 cpumask_copy(&top
->book_mask
, &core_book(core
)->mask
);
385 cpumask_copy(&top
->drawer_mask
, &core_drawer(core
)->mask
);
386 cpumask_set_cpu(cpu
, &node_to_cpumask_map
[core_node(core
)->id
]);
387 top
->node_id
= core_node(core
)->id
;
392 * Apply toptree to topology and create CPU masks
394 static void toptree_to_topology(struct toptree
*numa
)
396 struct toptree
*core
;
399 /* Clear all node masks */
400 for (i
= 0; i
< MAX_NUMNODES
; i
++)
401 cpumask_clear(&node_to_cpumask_map
[i
]);
403 /* Rebuild all masks */
404 toptree_for_each(core
, numa
, CORE
)
405 topology_add_core(core
);
409 * Show the node to core mapping
411 static void print_node_to_core_map(void)
415 if (!numa_debug_enabled
)
417 printk(KERN_DEBUG
"NUMA node to core mapping\n");
418 for (nid
= 0; nid
< emu_nodes
; nid
++) {
419 printk(KERN_DEBUG
" node %3d: ", nid
);
420 for (cid
= 0; cid
< ARRAY_SIZE(emu_cores
->to_node_id
); cid
++) {
421 if (emu_cores
->to_node_id
[cid
] == nid
)
422 printk(KERN_CONT
"%d ", cid
);
424 printk(KERN_CONT
"\n");
429 * Transfer physical topology into a NUMA topology and modify CPU masks
430 * according to the NUMA topology.
432 * Must be called with "sched_domains_mutex" lock held.
434 static void emu_update_cpu_topology(void)
436 struct toptree
*phys
, *numa
;
438 if (emu_cores
== NULL
)
439 create_core_to_node_map();
440 phys
= toptree_from_topology();
441 numa
= toptree_to_numa(phys
);
443 toptree_to_topology(numa
);
445 print_node_to_core_map();
449 * If emu_size is not set, use CONFIG_EMU_SIZE. Then round to minimum
450 * alignment (needed for memory hotplug).
452 static unsigned long emu_setup_size_adjust(unsigned long size
)
454 unsigned long size_new
;
456 size
= size
? : CONFIG_EMU_SIZE
;
457 size_new
= roundup(size
, memory_block_size_bytes());
458 if (size_new
== size
)
460 pr_warn("Increasing memory stripe size from %ld MB to %ld MB\n",
461 size
>> 20, size_new
>> 20);
466 * If we have not enough memory for the specified nodes, reduce the node count.
468 static int emu_setup_nodes_adjust(int nodes
)
472 nodes_max
= memblock
.memory
.total_size
/ emu_size
;
473 nodes_max
= max(nodes_max
, 1);
474 if (nodes_max
>= nodes
)
476 pr_warn("Not enough memory for %d nodes, reducing node count\n", nodes
);
483 static void emu_setup(void)
487 emu_size
= emu_setup_size_adjust(emu_size
);
488 emu_nodes
= emu_setup_nodes_adjust(emu_nodes
);
489 for (nid
= 0; nid
< emu_nodes
; nid
++)
490 node_set(nid
, node_possible_map
);
491 pr_info("Creating %d nodes with memory stripe size %ld MB\n",
492 emu_nodes
, emu_size
>> 20);
496 * Return node id for given page number
498 static int emu_pfn_to_nid(unsigned long pfn
)
500 return (pfn
/ (emu_size
>> PAGE_SHIFT
)) % emu_nodes
;
506 static unsigned long emu_align(void)
512 * Return distance between two nodes
514 static int emu_distance(int node1
, int node2
)
516 return (node1
!= node2
) * EMU_NODE_DIST
;
520 * Define callbacks for generic s390 NUMA infrastructure
522 const struct numa_mode numa_mode_emu
= {
525 .update_cpu_topology
= emu_update_cpu_topology
,
526 .__pfn_to_nid
= emu_pfn_to_nid
,
528 .distance
= emu_distance
,
532 * Kernel parameter: emu_nodes=<n>
534 static int __init
early_parse_emu_nodes(char *p
)
538 if (kstrtoint(p
, 0, &count
) != 0 || count
<= 0)
542 emu_nodes
= min(count
, MAX_NUMNODES
);
545 early_param("emu_nodes", early_parse_emu_nodes
);
548 * Kernel parameter: emu_size=[<n>[k|M|G|T]]
550 static int __init
early_parse_emu_size(char *p
)
552 emu_size
= memparse(p
, NULL
);
555 early_param("emu_size", early_parse_emu_size
);