Enum MlockError 

pub enum MlockError {
    PermissionDenied,
    ResourceLimit,
    InvalidArgument,
    WouldBlock,
    Unknown(i32),
}

Error type for memory locking operations.

Each variant includes remediation guidance in its Display implementation.

Variants

PermissionDenied

Permission denied (EPERM).

The process lacks the CAP_IPC_LOCK capability.

Remediation

• Run as root: sudo ./daemon
• Add capability: sudo setcap cap_ipc_lock=+ep ./daemon
• Docker: docker run --cap-add=IPC_LOCK ...

ResourceLimit

Resource limit exceeded (ENOMEM).

Either:

• RLIMIT_MEMLOCK is too low
• Insufficient physical memory available
• Kernel cannot allocate tracking structures

Remediation

• Raise limit: ulimit -l unlimited
• Docker: docker run --ulimit memlock=-1:-1 ...
• Systemd: LimitMEMLOCK=infinity in unit file

InvalidArgument

Invalid argument (EINVAL).

Shouldn’t occur with this library unless using experimental flags on unsupported kernels.

WouldBlock

Operation would block (EAGAIN).

Some pages could not be locked. Typically occurs on macOS.

Unknown(i32)

Unknown error with errno value.

Contains the raw errno for debugging.

Implementations

impl MlockError

pub const fn from_errno(errno: i32) -> Self

Create an error from a raw errno value.

pub const fn errno(&self) -> Option<i32>

Get the raw errno value, if available.

pub const fn is_permission_error(&self) -> bool

Check if this error indicates a permission issue.

pub const fn is_resource_limit(&self) -> bool

Check if this error indicates a resource limit issue.

Trait Implementations

impl Clone for MlockError

fn clone(&self) -> MlockError

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for MlockError

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

Formats the value using the given formatter.

impl Display for MlockError

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

Formats the value using the given formatter.

impl Error for MlockError

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 MlockError

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

impl Eq for MlockError

impl StructuralPartialEq for MlockError