Skip to content

numa: report real topology from getcpu and get_mempolicy - #1438

Open
gburd wants to merge 3 commits into
cloudius-systems:masterfrom
gburd:pr/numa-mempolicy
Open

numa: report real topology from getcpu and get_mempolicy#1438
gburd wants to merge 3 commits into
cloudius-systems:masterfrom
gburd:pr/numa-mempolicy

Conversation

@gburd

@gburd gburd commented Jul 13, 2026

Copy link
Copy Markdown
Contributor

What

With NUMA topology now discovered (the numa:: module from the base PR), make
the topology-query syscalls report it instead of a hardcoded single node.

How

  • sys_getcpu() now fills the node-out argument with numa::node_of_cpu() for
    the calling CPU rather than always 0.
  • get_mempolicy():
    • MPOL_F_NODE returns the calling CPU's node.
    • MPOL_F_NODE | MPOL_F_ADDR returns the node backing the given address,
      resolved via a page-table walk (virt_to_phys_pt) and
      numa::node_of_phys().
    • the allowed-nodes mask now sets a bit for every discovered node (not just
      node 0) and rejects a maxnode smaller than the node count with EINVAL.

set_mempolicy() stays a no-op: the topology is known but the physical
allocator is not yet node-aware, so a placement policy cannot be enforced. Its
comment is updated to say so; enforcement will come with the node-aware
allocator.

Adds numa::node_of_phys() to map a physical address to its node.

On a machine with no SRAT everything degrades to the previous single-node-0
behavior.

Testing

tests/tst-numa-mempolicy.cc checks getcpu's node is in range and matches
numa::node_of_cpu, get_mempolicy's MPOL_F_NODE and allowed-mask (bit count
== node count, maxnode-too-small EINVAL), and the MPOL_F_ADDR path. Verified
on OSv under KVM single-node and with a QEMU 2-node -numa config.

Note

Depends on #1418 (numa: discover NUMA topology from ACPI SRAT/SLIT). Until that
merges, this PR's diff shows both commits.

(Recreated from #1419, which GitHub auto-closed when its branch was rebased onto current master. Same change, rebased and verified on master 3aba46c.)

gburd added 3 commits July 31, 2026 08:51
OSv had no notion of NUMA: the scheduler and allocator treat memory as flat,
which leaves performance on the table on multi-socket bare-metal (the large
large multi-socket bare-metal hosts).

This is the first, discovery-only step. It adds a numa:: module that parses the
ACPI SRAT (System Resource Affinity Table) and SLIT (System Locality Distance
Information Table) at boot, right after acpi::init(), and exposes the topology:

- numa::nr_nodes() / numa::available()
- numa::node_of_cpu(cpu_id) -- resolved by correlating SRAT APIC ids with the
  APIC ids the MADT parse recorded on each sched::cpu
- numa::distance(from, to) -- from SLIT (10 == local per ACPI convention),
  defaulting to 10 local / 20 remote when no SLIT is present
- numa::memory_ranges() -- physical ranges tagged with their node

It handles the SRAT CPU-affinity, x2APIC CPU-affinity and memory-affinity
subtables, and only trusts SLIT if its locality count matches the node count
SRAT reported. On a machine with no SRAT (the common single-node VM) it reports
one flat node and available() == false; nothing changes behavior.

This intentionally does NOT yet change allocation or scheduling; it only makes
the topology available so a node-aware allocator, scheduler affinity, and
mbind/get_mempolicy can build on it.

Add tests/tst-numa.cc validating the invariants (>= 1 node, every CPU maps in
range, distance diagonal == 10 and off-diagonal >= 10, memory ranges name valid
nodes). Verified on OSv under KVM both without NUMA (reports 1 flat node) and
with a QEMU 2-node -numa config (reports 2 nodes, 3 memory ranges, available).
With NUMA topology now discovered (numa:: module), make the topology-query
syscalls report it instead of a hardcoded single node:

- sys_getcpu() now fills the node-out argument with numa::node_of_cpu() for the
  calling CPU rather than always 0.
- get_mempolicy():
  - MPOL_F_NODE returns the calling CPU's node.
  - MPOL_F_NODE | MPOL_F_ADDR returns the node backing the given address,
    resolved via a page-table walk (virt_to_phys_pt) and numa::node_of_phys().
  - the allowed-nodes mask now sets a bit for every discovered node (not just
    node 0), and rejects a maxnode smaller than the node count with EINVAL.

set_mempolicy() stays a no-op: the topology is known but the physical allocator
is not yet node-aware, so a placement policy cannot be enforced. Its comment is
updated to say so; enforcement will come with the node-aware allocator.

Adds numa::node_of_phys() to map a physical address to its node.

On a machine with no SRAT everything degrades to the previous single-node-0
behavior.

Add tests/tst-numa-mempolicy.cc checking getcpu's node is in range and matches
numa::node_of_cpu, get_mempolicy's MPOL_F_NODE and allowed-mask (bit count ==
node count, maxnode-too-small EINVAL), and the MPOL_F_ADDR path. Verified on OSv
under KVM single-node and with a QEMU 2-node -numa config.

Depends on the "numa: discover NUMA topology from ACPI SRAT/SLIT" change.
@gburd
gburd force-pushed the pr/numa-mempolicy branch from 4d30f38 to 5a98418 Compare July 31, 2026 12:51
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant