Struct MemoryAvailability 

pub struct MemoryAvailability { /* private fields */ }

Provenance-preserving memory availability for the current process.

Two quantities live here and they answer different questions.

• Available (available_bytes) is free space right now: a finite cgroup-v1 or cgroup-v2 ceiling admits exactly min(host available, reclaim-aware cgroup available). A v2 literal memory.max = max remains typed as unbounded and therefore defers to the host; v1’s numeric unlimited sentinel participates exactly and likewise loses to a tighter host value. This quantity moves, and under pressure it goes to zero.
• Capacity (capacity_bytes) is how much memory this process could ever address: min(host total, the binding cgroup's hard limit). It is a property of the box and the cgroup configuration, not of the schedule, so it does not move when a sibling allocates.

The distinction is load-bearing (#2684). “Does this dense footprint fit here at all?” is a capacity question and its answer must be stationary — see process_memory_availability on why a route derived from a moving quantity is a defect. “Does this allocation fit right now?” is an availability question, and the joint ledger (MemoryGovernor::try_reserve) is the instrument for it. Reading the second where the first was meant is what let a cgroup a few pages from its limit refuse a 28,800-byte design on a host with 448 GB free.

If an active controller cannot be parsed exactly, admission fails closed with zero bytes — both available and capacity — while retaining the typed probe failure; it never silently inherits host capacity.

Implementations

impl MemoryAvailability

pub const fn host_available_bytes(&self) -> u64

pub const fn host_total_bytes(&self) -> u64

pub const fn capacity_bytes(&self) -> u64

The stationary ceiling on memory this process could ever address: min(host total, binding cgroup hard limit), or zero when the cgroup probe failed closed. Unlike Self::available_bytes this does not move when other work allocates, which is what makes it usable as a routing threshold (#2684).

pub fn capacity_bytes_usize(&self) -> usize

pub const fn cgroup(&self) -> &CgroupMemoryObservation

pub const fn available_bytes(&self) -> u64

pub fn available_bytes_usize(&self) -> usize

pub const fn limiting_source(&self) -> MemoryAvailabilitySource

Trait Implementations

impl Clone for MemoryAvailability

fn clone(&self) -> MemoryAvailability

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for MemoryAvailability

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

Formats the value using the given formatter.

impl Display for MemoryAvailability

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

Formats the value using the given formatter.

impl Eq for MemoryAvailability

impl PartialEq for MemoryAvailability

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

Equality operator ==.

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

Inequality operator !=.

impl StructuralPartialEq for MemoryAvailability