types.cxxm File Reference

NUMA topology and allocation policy types. More...

import zxfoundation.base.types;

Include dependency graph for types.cxxm:

Data Structures
struct	zxfoundation::memory::numa::allocation_policy
	Placement policy supplied to PMM, VM, or DGP memory-contract operations. More...
struct	zxfoundation::memory::numa::node_topology
	NUMA node topology and allocator watermarks. More...
struct	zxfoundation::memory::numa::placement_result
	Result of resolving a placement policy against topology state. More...
struct	zxfoundation::memory::numa::slit_matrix
	System Locality Information Table — distance matrix for NUMA nodes. More...

Enumerations
enum class	zxfoundation::memory::numa::fallback_mode : u8 { local_first = 0 , strict_local = 1 , interleave = 2 , emergency_any = 3 }
	Allocation fallback behavior requested by a caller.
enum class	zxfoundation::memory::numa::node_state : u8 { offline = 0 , online = 1 , degraded = 2 , draining = 3 }
	Lifecycle state of a NUMA node record.
enum class	zxfoundation::memory::numa::topology_source : u8 { none = 0 , zxfl_memory_map = 1 , zxfl_cpu_map = 2 , synthetic_single_node = 3 }
	Origin of the evidence used to create or update a node record.

Functions
constexpr auto	zxfoundation::memory::numa::node_id_is_valid (u8 node_id) noexcept -> bool
	Test whether a byte value can address the fixed NUMA node table.
constexpr auto	zxfoundation::memory::numa::node_state_is_allocatable (node_state state) noexcept -> bool
	Test whether a topology state may satisfy memory placement.

Variables
constexpr u8	zxfoundation::memory::numa::MAX_NUMA_NODES = 16U
	Maximum number of NUMA nodes recorded by the initial kernel topology table.
constexpr u8	zxfoundation::memory::numa::NUMA_DRAWER_UNKNOWN = 0xFFU
	Drawer identifier used when ZXFL could not provide drawer evidence.
constexpr u8	zxfoundation::memory::numa::NUMA_NODE_ANY = 0xFFU
	Wildcard NUMA node selector used by allocation policy requests.
constexpr u8	zxfoundation::memory::numa::NUMA_NODE_BOOT = 0U
	Deterministic bootstrap fallback node.

Detailed Description

NUMA topology and allocation policy types.

SPDX-License-Identifier: Apache-2.0

Function Documentation

node_id_is_valid()

auto zxfoundation::memory::numa::node_id_is_valid ( u8 node_id ) ->bool

nodiscardconstexprexportnoexcept

Test whether a byte value can address the fixed NUMA node table.

Parameters

[in]

node_id

Candidate node identifier.

Returns

true when the node identifier is representable by the topology table.

node_state_is_allocatable()

auto zxfoundation::memory::numa::node_state_is_allocatable ( node_state state ) ->bool

nodiscardconstexprexportnoexcept

Test whether a topology state may satisfy memory placement.

Parameters

[in]

state

Node lifecycle state.

Returns

true when the node may be considered for allocation fallback.