Enum InstallMemoryPoolsError 

pub enum InstallMemoryPoolsError {
    PoolsInUse {
        bytes_in_use: u64,
    },
    StreamUnavailable,
    Unsupported,
    InvalidLayout {
        reason: String,
    },
}

Why installing a pool layout did not take effect.

The distinction a caller needs is transient or permanent: a refused rebuild is worth retrying once whatever holds the pools drains, while a backend with no configurable pools refuses forever. Treating the two alike either gives up on a layout that would have installed, or repeats an expensive measurement that can never succeed.

Variants

PoolsInUse

The pools being rebuilt still hold live allocations, so the previous layout was kept. Transient.

Fields

bytes_in_use: u64

Bytes still live in those pools.

StreamUnavailable

The calling stream is already in an error state, so its pools were not rebuilt. The layout still applies to streams created afterwards, and the underlying failure surfaces at the next flush or sync.

Unsupported

This backend has no configurable dynamic pools. Permanent.

InvalidLayout

The layout itself cannot be honoured, so the previous one was kept: an empty pool list, a zero size, a slice larger than its page, an unusable cap, or a pool shape this build has none of. Permanent — what has to change is the layout, not the moment it is installed at.

Fields

reason: String

What the backend objected to, in its own words.

Trait Implementations

impl Clone for InstallMemoryPoolsError

fn clone(&self) -> InstallMemoryPoolsError

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for InstallMemoryPoolsError

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

Formats the value using the given formatter.

impl Display for InstallMemoryPoolsError

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

Formats the value using the given formatter.

impl Eq for InstallMemoryPoolsError

impl Error for InstallMemoryPoolsError

fn source(&self) -> Option<&(dyn Error + 'static)>

Returns the lower-level source of this error, if any.

fn description(&self) -> &str

👎Deprecated since 1.42.0:

use the Display impl or to_string()

fn cause(&self) -> Option<&dyn Error>

👎Deprecated since 1.33.0:

replaced by Error::source, which can support downcasting

fn provide<'a>(&'a self, request: &mut Request<'a>)

🔬This is a nightly-only experimental API. (error_generic_member_access)

Provides type-based access to context intended for error reports.

impl PartialEq for InstallMemoryPoolsError

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

Equality operator ==.

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

Inequality operator !=.

impl StructuralPartialEq for InstallMemoryPoolsError