Struct Errno

pub struct Errno(/* private fields */);

Available on (Linux or Android) and (x86 or x86-64 or ARM or AArch64), or (target_arch="hexagon" or s390x or M68k or RISC-V RV32 or RISC-V RV64 or LoongArch LA64) and Linux, or crate feature aarch64, or crate feature arc, or crate feature arm, or crate feature arm64, or crate feature csky, or crate feature generic, or crate feature hexagon, or crate feature loongarch, or crate feature loongarch64, or crate feature m68k, or crate feature microblaze, or crate feature nios2, or crate feature openrisc, or crate feature riscv, or crate feature riscv32, or crate feature riscv64, or crate feature s390, or crate feature s390x, or crate feature sh, or crate feature um, or crate feature x86, or crate feature x86_64, or crate feature xtensa only.

Error number representation.

Implementations

impl Errno

pub fn new(num: i32) -> Self

Returns a new Errno from the given integer.

pub fn into_raw(self) -> i32

Converts Errno into the under underlining integer.

pub fn is_valid(&self) -> bool

Returns true if the error code is in valid range (lower than 4096)

pub fn from_ret(value: usize) -> Result<usize, Errno>

Returns a new Errno from a syscall’s result.

pub fn name(&self) -> Option<&'static str>

Returns the name of the error if it’s known. Generally the name of the constant.

Examples found in repository

examples/list.rs (line 9)

pub fn main() {
    for errno in Errno::iter() {
        println!(
            "{}: {}",
            errno.name().unwrap(),
            errno.description().unwrap()
        );
    }
}

pub fn description(&self) -> Option<&'static str>

Returns a description of the error if it’s known.

Examples found in repository

examples/list.rs (line 10)

pub fn main() {
    for errno in Errno::iter() {
        println!(
            "{}: {}",
            errno.name().unwrap(),
            errno.description().unwrap()
        );
    }
}

pub fn from_io_error(err: Error) -> Option<Self>

Available on crate feature std only.

Returns a new Errno if the given error is generated from a system error. None otherwise.

pub fn iter() -> ErrnoIter

Available on crate feature iter only.

Returns an iterator ErrnoIter over all the known error numbers.

Examples found in repository

examples/list.rs (line 6)

pub fn main() {
    for errno in Errno::iter() {
        println!(
            "{}: {}",
            errno.name().unwrap(),
            errno.description().unwrap()
        );
    }
}

impl Errno

pub const EPERM: Self

Operation not permitted

pub const ENOENT: Self

No such file or directory

pub const ESRCH: Self

No such process

pub const EINTR: Self

Interrupted system call

pub const EIO: Self

I/O error

pub const ENXIO: Self

No such device or address

pub const E2BIG: Self

Argument list too long

pub const ENOEXEC: Self

Exec format error

pub const EBADF: Self

Bad file number

pub const ECHILD: Self

No child processes

pub const EAGAIN: Self

Try again

pub const ENOMEM: Self

Out of memory

pub const EACCES: Self

Permission denied

pub const EFAULT: Self

Bad address

pub const ENOTBLK: Self

Block device required

pub const EBUSY: Self

Device or resource busy

pub const EEXIST: Self

File exists

pub const EXDEV: Self

Cross-device link

pub const ENODEV: Self

No such device

pub const ENOTDIR: Self

Not a directory

pub const EISDIR: Self

Is a directory

pub const EINVAL: Self

Invalid argument

pub const ENFILE: Self

File table overflow

pub const EMFILE: Self

Too many open files

pub const ENOTTY: Self

Not a typewriter

pub const ETXTBSY: Self

Text file busy

pub const EFBIG: Self

File too large

pub const ENOSPC: Self

No space left on device

pub const ESPIPE: Self

Illegal seek

pub const EROFS: Self

Read-only file system

pub const EMLINK: Self

Too many links

pub const EPIPE: Self

Broken pipe

pub const EDOM: Self

Math argument out of domain of func

pub const ERANGE: Self

Math result not representable

pub const EDEADLK: Self

Resource deadlock would occur

pub const ENAMETOOLONG: Self

File name too long

pub const ENOLCK: Self

No record locks available

pub const ENOSYS: Self

Invalid system call number

pub const ENOTEMPTY: Self

Directory not empty

pub const ELOOP: Self

Too many symbolic links encountered

pub const ENOMSG: Self

No message of desired type

pub const EIDRM: Self

Identifier removed

pub const ECHRNG: Self

Channel number out of range

pub const EL2NSYNC: Self

Level 2 not synchronized

pub const EL3HLT: Self

Level 3 halted

pub const EL3RST: Self

Level 3 reset

pub const ELNRNG: Self

Link number out of range

pub const EUNATCH: Self

Protocol driver not attached

pub const ENOCSI: Self

No CSI structure available

pub const EL2HLT: Self

Level 2 halted

pub const EBADE: Self

Invalid exchange

pub const EBADR: Self

Invalid request descriptor

pub const EXFULL: Self

Exchange full

pub const ENOANO: Self

No anode

pub const EBADRQC: Self

Invalid request code

pub const EBADSLT: Self

Invalid slot

pub const EBFONT: Self

Bad font file format

pub const ENOSTR: Self

Device not a stream

pub const ENODATA: Self

No data available

pub const ETIME: Self

Timer expired

pub const ENOSR: Self

Out of streams resources

pub const ENONET: Self

Machine is not on the network

pub const ENOPKG: Self

Package not installed

pub const EREMOTE: Self

Object is remote

pub const ENOLINK: Self

Link has been severed

pub const EADV: Self

Advertise error

pub const ESRMNT: Self

Srmount error

pub const ECOMM: Self

Communication error on send

pub const EPROTO: Self

Protocol error

pub const EMULTIHOP: Self

Multihop attempted

pub const EDOTDOT: Self

RFS specific error

pub const EBADMSG: Self

Not a data message

pub const EOVERFLOW: Self

Value too large for defined data type

pub const ENOTUNIQ: Self

Name not unique on network

pub const EBADFD: Self

File descriptor in bad state

pub const EREMCHG: Self

Remote address changed

pub const ELIBACC: Self

Can not access a needed shared library

pub const ELIBBAD: Self

Accessing a corrupted shared library

pub const ELIBSCN: Self

.lib section in a.out corrupted

pub const ELIBMAX: Self

Attempting to link in too many shared libraries

pub const ELIBEXEC: Self

Cannot exec a shared library directly

pub const EILSEQ: Self

Illegal byte sequence

pub const ERESTART: Self

Interrupted system call should be restarted

pub const ESTRPIPE: Self

Streams pipe error

pub const EUSERS: Self

Too many users

pub const ENOTSOCK: Self

Socket operation on non-socket

pub const EDESTADDRREQ: Self

Destination address required

pub const EMSGSIZE: Self

Message too long

pub const EPROTOTYPE: Self

Protocol wrong type for socket

pub const ENOPROTOOPT: Self

Protocol not available

pub const EPROTONOSUPPORT: Self

Protocol not supported

pub const ESOCKTNOSUPPORT: Self

Socket type not supported

pub const EOPNOTSUPP: Self

Operation not supported on transport endpoint

pub const EPFNOSUPPORT: Self

Protocol family not supported

pub const EAFNOSUPPORT: Self

Address family not supported by protocol

pub const EADDRINUSE: Self

Address already in use

pub const EADDRNOTAVAIL: Self

Cannot assign requested address

pub const ENETDOWN: Self

Network is down

pub const ENETUNREACH: Self

Network is unreachable

pub const ENETRESET: Self

Network dropped connection because of reset

pub const ECONNABORTED: Self

Software caused connection abort

pub const ECONNRESET: Self

Connection reset by peer

pub const ENOBUFS: Self

No buffer space available

pub const EISCONN: Self

Transport endpoint is already connected

pub const ENOTCONN: Self

Transport endpoint is not connected

pub const ESHUTDOWN: Self

Cannot send after transport endpoint shutdown

pub const ETOOMANYREFS: Self

Too many references: cannot splice

pub const ETIMEDOUT: Self

Connection timed out

pub const ECONNREFUSED: Self

Connection refused

pub const EHOSTDOWN: Self

Host is down

pub const EHOSTUNREACH: Self

No route to host

pub const EALREADY: Self

Operation already in progress

pub const EINPROGRESS: Self

Operation now in progress

pub const ESTALE: Self

Stale file handle

pub const EUCLEAN: Self

Structure needs cleaning

pub const ENOTNAM: Self

Not a XENIX named type file

pub const ENAVAIL: Self

No XENIX semaphores available

pub const EISNAM: Self

Is a named type file

pub const EREMOTEIO: Self

Remote I/O error

pub const EDQUOT: Self

Quota exceeded

pub const ENOMEDIUM: Self

No medium found

pub const EMEDIUMTYPE: Self

Wrong medium type

pub const ECANCELED: Self

Operation Canceled

pub const ENOKEY: Self

Required key not available

pub const EKEYEXPIRED: Self

Key has expired

pub const EKEYREVOKED: Self

Key has been revoked

pub const EKEYREJECTED: Self

Key was rejected by service

pub const EOWNERDEAD: Self

Owner died

pub const ENOTRECOVERABLE: Self

State not recoverable

pub const ERFKILL: Self

Operation not possible due to RF-kill

pub const EHWPOISON: Self

Memory page has hardware error

pub const ERESTARTSYS: Self

Restart syscall

pub const ERESTARTNOINTR: Self

Restart if no interrupt

pub const ERESTARTNOHAND: Self

restart if no handler..

pub const ENOIOCTLCMD: Self

No ioctl command

pub const ERESTART_RESTARTBLOCK: Self

restart by calling sys_restart_syscall

pub const EPROBE_DEFER: Self

Driver requests probe retry

pub const EOPENSTALE: Self

open found a stale dentry

pub const ENOPARAM: Self

Parameter not supported

pub const EBADHANDLE: Self

Illegal NFS file handle

pub const ENOTSYNC: Self

Update synchronization mismatch

pub const EBADCOOKIE: Self

Cookie is stale

pub const ENOTSUPP: Self

Operation is not supported

pub const ETOOSMALL: Self

Buffer or request is too small

pub const ESERVERFAULT: Self

An untranslatable error occurred

pub const EBADTYPE: Self

Type not supported by server

pub const EJUKEBOX: Self

Request initiated, but will not complete before timeout

pub const EIOCBQUEUED: Self

iocb queued, will get completion event

pub const ERECALLCONFLICT: Self

conflict with recalled state

pub const ENOGRACE: Self

NFS file lock reclaim refused

pub const EDEADLOCK: Self = Self::EDEADLK

Alias for Self::EDEADLK

pub const EWOULDBLOCK: Self = Self::EAGAIN

Alias for Self::EAGAIN

pub const MIN: i32 = 1i32

pub const MAX: i32 = 531i32

impl Errno

pub fn last_os_error() -> Self

Available on ((Linux or Android) and (x86 or x86-64 or ARM or AArch64), or (target_arch="hexagon" or s390x or PowerPC or PowerPC-64 or MIPS or MIPS-64 or M68k or RISC-V RV32 or RISC-V RV64 or target_arch="sparc" or SPARC64 or LoongArch LA64) and Linux) and crate feature libc-compat only.

Returns a new Errno from last OS error.

Trait Implementations

impl Clone for Errno

fn clone(&self) -> Errno

Returns a copy of the value.

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

Performs copy-assignment from source.

impl Debug for Errno

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

Formats the value using the given formatter.

impl Display for Errno

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

Formats the value using the given formatter.

impl Error for Errno

Available on crate feature std only.

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 Error for Errno

Available on crate feature no_std_io-compat only.

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

The lower-level source of this error, if any.

impl From<Errno> for Error

Available on crate feature std only.

fn from(value: Errno) -> Self

Converts to this type from the input type.

impl From<Errno> for Error

Available on crate feature no_std_io-compat only.

fn from(value: Errno) -> Self

Converts to this type from the input type.

impl Hash for Errno

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 Ord for Errno

fn cmp(&self, other: &Errno) -> Ordering

This method returns an [Ordering] between self and other.

fn max(self, other: Self) -> Self

where Self: Sized,

Compares and returns the maximum of two values.

fn min(self, other: Self) -> Self

where Self: Sized,

Compares and returns the minimum of two values.

fn clamp(self, min: Self, max: Self) -> Self

where Self: Sized,

Restrict a value to a certain interval.

impl PartialEq for Errno

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

fn partial_cmp(&self, other: &Errno) -> Option<Ordering>

This method returns an ordering between self and other values if one exists.

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

Tests less than (for self and other) and is used by the < operator.

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

Tests less than or equal to (for self and other) and is used by the <= operator.

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

Tests greater than (for self and other) and is used by the > operator.

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

Tests greater than or equal to (for self and other) and is used by the >= operator.

impl Copy for Errno

impl Eq for Errno

impl StructuralPartialEq for Errno