Enum hwlocality::memory::binding::MemoryBindingError

pub enum MemoryBindingError<OwnedSet: OwnedSpecializedBitmap> {
    AllocationFailed,
    BadFlags(FlagsError<MemoryBindingFlags>),
    BadSet(MemoryBoundObject, OwnedSet),
    BadTarget,
    MixedResults,
    Unsupported,
    Unknown,
}

Errors that can occur when binding memory to NUMA nodes, querying bindings, or allocating (possibly bound) memory

Variants

AllocationFailed

Memory allocation failed even before trying to bind

This error may only be returned by Topology::allocate_bound_memory() and Topology::binding_allocate_memory().

BadFlags(FlagsError<MemoryBindingFlags>)

Requested memory binding flags are not valid in this context

Not all memory binding flag combinations make sense, either in isolation or in the context of a particular binding method. Please cross-check the documentation of MemoryBindingFlags and the method you were trying to call for more information.

BadSet(MemoryBoundObject, OwnedSet)

Cannot bind to the target CPU or node set

Operating systems can have various restrictions here, e.g. can only bind to NUMA node.

This error should only be reported when trying to set memory bindings.

This error might not be reported if MemoryBindingFlags::STRICT is not set. Instead, the implementation is allowed to try using a smaller or larger set to make the operation succeed.

BadTarget

Cannot get/set the memory binding of a zero-sized memory region

MixedResults

Memory policies and nodesets vary from one thread to another

This error is returned when querying a process’ memory bindings with the flags PROCESS and STRICT specified. It means that the default memory policies and nodesets are not homogeneous across all threads of the target process.

Unsupported

The system does not support the specified action or policy

For example, some systems only allow binding memory on a per-thread basis, whereas other systems only allow binding memory for all threads in a process.

This error might not be reported if MemoryBindingFlags::STRICT is not set. Instead, the implementation is allowed to try to use a slightly different operation (with side-effects, binding more objects, etc.) when the requested operation is not exactly supported.

Unknown

Available on Windows only.

An error occured, but we don’t know which one

This may only happen on Windows. On this operating system, there are multiple versions of the standard library (called the C Run-Times or CRTs), and it is very easy to end up in a situation where your program links against a different CRT than your hwloc build, which breaks errno-based error reporting among other things.

Trait Implementations

impl<OwnedSet: Clone + OwnedSpecializedBitmap> Clone for MemoryBindingError<OwnedSet>

fn clone(&self) -> MemoryBindingError<OwnedSet>

Returns a copy of the value.

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

Performs copy-assignment from source.

impl<OwnedSet: Debug + OwnedSpecializedBitmap> Debug for MemoryBindingError<OwnedSet>

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

Formats the value using the given formatter.

impl<OwnedSet> Display for MemoryBindingError<OwnedSet>

where OwnedSet: Display + OwnedSpecializedBitmap,

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

Formats the value using the given formatter.

impl<OwnedSet: OwnedSpecializedBitmap> Error for MemoryBindingError<OwnedSet>

where Self: Debug + Display,

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

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<OwnedSet: OwnedSpecializedBitmap> From<MemoryBindingFlags> for MemoryBindingError<OwnedSet>

fn from(value: MemoryBindingFlags) -> Self

Converts to this type from the input type.

impl<OwnedSet: Hash + OwnedSpecializedBitmap> Hash for MemoryBindingError<OwnedSet>

fn hash<__H: Hasher>(&self, state: &mut __H)

Feeds this value into the given Hasher.

fn hash_slice<H>(data: &[Self], state: &mut H)

where H: Hasher, Self: Sized,

Feeds a slice of this type into the given Hasher.

impl<OwnedSet: PartialEq + OwnedSpecializedBitmap> PartialEq for MemoryBindingError<OwnedSet>

fn eq(&self, other: &MemoryBindingError<OwnedSet>) -> bool

This method tests for self and other values to be equal, and is used by ==.

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

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

impl<OwnedSet: Eq + OwnedSpecializedBitmap> Eq for MemoryBindingError<OwnedSet>

impl<OwnedSet: OwnedSpecializedBitmap> StructuralPartialEq for MemoryBindingError<OwnedSet>