Struct CpuExecutionInfo 

pub struct CpuExecutionInfo { /* private fields */ }

Snapshot of the stable CPU execution contract and non-contractual provider diagnostics.

CpuBackendKind is the stable provider identity. The diagnostic string is intended for logs and may change between builds or releases.

Examples

use tenferro_cpu::{CpuBackend, CpuPlacement};

let info = CpuBackend::new().execution_info();
assert_eq!(info.requested_placement(), CpuPlacement::Auto);
assert!(!info.provider_diagnostic().is_empty());

Implementations

impl CpuExecutionInfo

pub fn backend_kind(&self) -> CpuBackendKind

Return the stable public provider identity.

Examples

let info = tenferro_cpu::CpuBackend::new().execution_info();
assert_eq!(info.backend_kind(), tenferro_cpu::CpuBackend::new().kind());

pub fn execution_mode(&self) -> CpuExecutionMode

Return the stable execution-ownership mode.

Examples

let mode = tenferro_cpu::CpuBackend::new()
    .execution_info()
    .execution_mode();
let _ = format!("{mode:?}");

pub fn requested_placement(&self) -> CpuPlacement

Return the placement requested by this backend handle.

Examples

let info = tenferro_cpu::CpuBackend::new().execution_info();
assert_eq!(info.requested_placement(), tenferro_cpu::CpuPlacement::Auto);

pub fn resolved_placement(&self) -> Option<&ResolvedCpuPlacement>

Return the concrete managed placement or external placement declaration.

Examples

let backend = tenferro_cpu::CpuBackend::new();
let _managed = backend.execution_info().resolved_placement();

pub fn topology(&self) -> &CpuTopology

Return the process-visible topology used for placement resolution.

Examples

let info = tenferro_cpu::CpuBackend::new().execution_info();
assert!(!info.topology().allowed_cpus().is_empty());

pub fn domain_id(&self) -> CpuDomainId

Return the coordinator-stable identity of the selected CPU domain.

Examples

let id = tenferro_cpu::CpuBackend::new().execution_info().domain_id();
let _ = id.as_u64();

pub fn domain_cpus(&self) -> Option<&CpuSet>

Return the resolved or caller-declared logical CPUs of the selected domain.

Examples

let info = tenferro_cpu::CpuBackend::new().execution_info();
if let Some(cpus) = info.domain_cpus() {
    assert!(!cpus.is_empty());
}

pub fn worker_count(&self) -> usize

Return the worker count of the selected domain executor.

Examples

let info = tenferro_cpu::CpuBackend::new().execution_info();
assert!(info.worker_count() >= 1);

pub fn thread_budget(&self) -> usize

Return the maximum number of participating threads requested for this domain.

This can be smaller than Self::worker_count for an externally supplied executor.

Examples

let info = tenferro_cpu::CpuBackend::new().execution_info();
assert!(info.thread_budget() >= 1);
assert!(info.thread_budget() <= info.worker_count());

pub fn placement_guarantee(&self) -> Option<CpuPlacementGuarantee>

Return whether the selected placement is exact or advisory.

Examples

let guarantee = tenferro_cpu::CpuBackend::new()
    .execution_info()
    .placement_guarantee();
let _ = format!("{guarantee:?}");

pub fn admission_mode(&self) -> CpuAdmissionMode

Return the selected domain’s admission contract.

Examples

use tenferro_cpu::{CpuAdmissionMode, CpuBackend};

let mode: CpuAdmissionMode = CpuBackend::new().execution_info().admission_mode();
assert_eq!(mode, CpuAdmissionMode::CooperativeCpuSet);

pub fn domain_ownership(&self) -> CpuDomainOwnership

Return whether tenferro or the application owns the selected domain.

Examples

let ownership = tenferro_cpu::CpuBackend::new()
    .execution_info()
    .domain_ownership();
let _ = format!("{ownership:?}");

pub fn executor_affinity(&self) -> CpuExecutorAffinity

Return the selected executor’s worker-affinity claim.

Examples

let affinity = tenferro_cpu::CpuBackend::new()
    .execution_info()
    .executor_affinity();
let _ = format!("{affinity:?}");

pub fn executor_shutdown(&self) -> CpuExecutorShutdown

Return who owns shutdown of the selected executor.

Examples

let shutdown = tenferro_cpu::CpuBackend::new()
    .execution_info()
    .executor_shutdown();
let _ = format!("{shutdown:?}");

pub fn provider_diagnostic(&self) -> &'static str

Return a human-readable provider description for logs.

This string is diagnostic only and is not a provider identity contract.

Examples

let diagnostic = tenferro_cpu::CpuBackend::new()
    .execution_info()
    .provider_diagnostic();
assert!(!diagnostic.is_empty());

Trait Implementations

impl Clone for CpuExecutionInfo

fn clone(&self) -> CpuExecutionInfo

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for CpuExecutionInfo

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

Formats the value using the given formatter.

impl Eq for CpuExecutionInfo

impl PartialEq for CpuExecutionInfo

fn eq(&self, other: &CpuExecutionInfo) -> bool

Tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl StructuralPartialEq for CpuExecutionInfo