Struct Capabilities 

pub struct Capabilities {
    pub strict_memory_binding: bool,
    pub strict_cpu_affinity: bool,
    pub memory_locking: bool,
    pub numa_balancing_disabled: bool,
    pub numa_node_count: usize,
}

Detected system capabilities for NUMA operations.

This struct provides information about what NUMA features are available on the current system, including kernel capabilities, system settings, and hardware topology.

Example

use numaperf_core::Capabilities;

let caps = Capabilities::detect();
println!("System capabilities: {}", caps.summary());

if caps.supports_hard_mode() {
    println!("Hard mode is fully supported");
} else {
    println!("Missing capabilities:");
    for cap in caps.missing_for_hard_mode() {
        println!("  - {}", cap);
    }
}

Fields

strict_memory_binding: bool

Has CAP_SYS_ADMIN (for strict memory binding with MPOL_BIND).

strict_cpu_affinity: bool

Has CAP_SYS_NICE (for strict CPU affinity with realtime scheduling).

memory_locking: bool

Has CAP_IPC_LOCK (for memory locking with mlock).

numa_balancing_disabled: bool

Kernel NUMA balancing is disabled (kernel.numa_balancing=0).

numa_node_count: usize

Number of NUMA nodes detected on the system.

Implementations

impl Capabilities

pub fn detect() -> Self

Detect current system capabilities.

This reads from /proc and /sys filesystems to determine what NUMA features are available.

pub fn supports_hard_mode(&self) -> bool

Check if all hard mode requirements are met.

Hard mode requires:

• CAP_SYS_ADMIN for strict memory binding
• CAP_SYS_NICE for strict CPU affinity
• NUMA balancing disabled to prevent kernel migration

pub fn missing_for_hard_mode(&self) -> Vec<&'static str>

Get a list of missing capabilities required for hard mode.

Returns an empty list if supports_hard_mode() returns true.

pub fn is_numa_system(&self) -> bool

Check if this is a NUMA system (more than one node).

pub fn summary(&self) -> String

Generate a human-readable summary of detected capabilities.

Trait Implementations

impl Clone for Capabilities

fn clone(&self) -> Capabilities

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for Capabilities

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Display for Capabilities

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.