Enum hwlocality::cpu::binding::CpuBindingError

pub enum CpuBindingError {
    BadObject(CpuBoundObject),
    BadFlags(FlagsError<CpuBindingFlags>),
    BadCpuSet(CpuSet),
    UnsupportedCpuSet(CpuBoundObject, CpuSet),
}

Errors that can occur when manipulating process/thread CPU bindings

Variants

BadObject(CpuBoundObject)

Cannot query or set CPU bindings for this kind of object

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

BadFlags(FlagsError<CpuBindingFlags>)

Requested CPU binding flags are not valid in this context

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

BadCpuSet(CpuSet)

The target cpuset is invalid

CPU binding commands cannot bind processes to an empty cpuset, or a cpuset that contains invalid CPU indices for the present topology.

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

UnsupportedCpuSet(CpuBoundObject, CpuSet)

Cannot bind the requested object to the target cpuset

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

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

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

Trait Implementations

impl Clone for CpuBindingError

fn clone(&self) -> CpuBindingError

Returns a copy of the value.

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

Performs copy-assignment from source.

impl Debug for CpuBindingError

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

Formats the value using the given formatter.

impl Display for CpuBindingError

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

Formats the value using the given formatter.

impl Error for CpuBindingError

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 From<CpuBindingFlags> for CpuBindingError

fn from(value: CpuBindingFlags) -> Self

Converts to this type from the input type.

impl From<CpuBoundObject> for CpuBindingError

fn from(value: CpuBoundObject) -> Self

Converts to this type from the input type.

impl From<ParameterError<CpuBindingFlags>> for CpuBindingError

fn from(source: FlagsError<CpuBindingFlags>) -> Self

Converts to this type from the input type.

impl PartialEq for CpuBindingError

fn eq(&self, other: &CpuBindingError) -> 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 Eq for CpuBindingError

impl StructuralPartialEq for CpuBindingError