Struct rustix::io::Error

#[repr(transparent)]
pub struct Error(_);

The error type for rustix APIs.

This is similar to std::io::Error, but only holds an OS error code, and no extra error value.

Implementations

impl Error

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

Extract an Error value from a std::io::Error.

This isn’t a From conversion because it’s expected to be relatively uncommon.

pub const fn raw_os_error(self) -> i32

Extract the raw OS error number from this error.

pub const fn from_raw_os_error(raw: i32) -> Self

Construct an Error from a raw OS error number.

impl Error

pub const ACCESS: Self = Self::from_errno(errno::EACCES)

EACCES

pub const ADDRINUSE: Self = Self::from_errno(errno::EADDRINUSE)

EADDRINUSE

pub const ADDRNOTAVAIL: Self = Self::from_errno(errno::EADDRNOTAVAIL)

EADDRNOTAVAIL

pub const ADV: Self = Self::from_errno(errno::EADV)

EADV

pub const AFNOSUPPORT: Self = Self::from_errno(errno::EAFNOSUPPORT)

EAFNOSUPPORT

pub const AGAIN: Self = Self::from_errno(errno::EAGAIN)

EAGAIN

pub const ALREADY: Self = Self::from_errno(errno::EALREADY)

EALREADY

pub const BADE: Self = Self::from_errno(errno::EBADE)

EBADE

pub const BADF: Self = Self::from_errno(errno::EBADF)

EBADF

pub const BADFD: Self = Self::from_errno(errno::EBADFD)

EBADFD

pub const BADMSG: Self = Self::from_errno(errno::EBADMSG)

EBADMSG

pub const BADR: Self = Self::from_errno(errno::EBADR)

EBADR

pub const BADRQC: Self = Self::from_errno(errno::EBADRQC)

EBADRQC

pub const BADSLT: Self = Self::from_errno(errno::EBADSLT)

EBADSLT

pub const BFONT: Self = Self::from_errno(errno::EBFONT)

EBFONT

pub const BUSY: Self = Self::from_errno(errno::EBUSY)

EBUSY

pub const CANCELED: Self = Self::from_errno(errno::ECANCELED)

ECANCELED

pub const CHILD: Self = Self::from_errno(errno::ECHILD)

ECHILD

pub const CHRNG: Self = Self::from_errno(errno::ECHRNG)

ECHRNG

pub const COMM: Self = Self::from_errno(errno::ECOMM)

ECOMM

pub const CONNABORTED: Self = Self::from_errno(errno::ECONNABORTED)

ECONNABORTED

pub const CONNREFUSED: Self = Self::from_errno(errno::ECONNREFUSED)

ECONNREFUSED

pub const CONNRESET: Self = Self::from_errno(errno::ECONNRESET)

ECONNRESET

pub const DEADLK: Self = Self::from_errno(errno::EDEADLK)

EDEADLK

pub const DEADLOCK: Self = Self::from_errno(errno::EDEADLOCK)

EDEADLOCK

pub const DESTADDRREQ: Self = Self::from_errno(errno::EDESTADDRREQ)

EDESTADDRREQ

pub const DOM: Self = Self::from_errno(errno::EDOM)

EDOM

pub const DOTDOT: Self = Self::from_errno(errno::EDOTDOT)

EDOTDOT

pub const DQUOT: Self = Self::from_errno(errno::EDQUOT)

EDQUOT

pub const EXIST: Self = Self::from_errno(errno::EEXIST)

EEXIST

pub const FAULT: Self = Self::from_errno(errno::EFAULT)

EFAULT

pub const FBIG: Self = Self::from_errno(errno::EFBIG)

EFBIG

pub const HOSTDOWN: Self = Self::from_errno(errno::EHOSTDOWN)

EHOSTDOWN

pub const HOSTUNREACH: Self = Self::from_errno(errno::EHOSTUNREACH)

EHOSTUNREACH

pub const HWPOISON: Self = Self::from_errno(errno::EHWPOISON)

EHWPOISON

pub const IDRM: Self = Self::from_errno(errno::EIDRM)

EIDRM

pub const ILSEQ: Self = Self::from_errno(errno::EILSEQ)

EILSEQ

pub const INPROGRESS: Self = Self::from_errno(errno::EINPROGRESS)

EINPROGRESS

pub const INTR: Self = Self::from_errno(errno::EINTR)

EINTR.

For a convenient way to retry system calls that exit with INTR, use with_retrying.

pub const INVAL: Self = Self::from_errno(errno::EINVAL)

EINVAL

pub const IO: Self = Self::from_errno(errno::EIO)

EIO

pub const ISCONN: Self = Self::from_errno(errno::EISCONN)

EISCONN

pub const ISDIR: Self = Self::from_errno(errno::EISDIR)

EISDIR

pub const ISNAM: Self = Self::from_errno(errno::EISNAM)

EISNAM

pub const KEYEXPIRED: Self = Self::from_errno(errno::EKEYEXPIRED)

EKEYEXPIRED

pub const KEYREJECTED: Self = Self::from_errno(errno::EKEYREJECTED)

EKEYREJECTED

pub const KEYREVOKED: Self = Self::from_errno(errno::EKEYREVOKED)

EKEYREVOKED

pub const L2HLT: Self = Self::from_errno(errno::EL2HLT)

EL2HLT

pub const L2NSYNC: Self = Self::from_errno(errno::EL2NSYNC)

EL2NSYNC

pub const L3HLT: Self = Self::from_errno(errno::EL3HLT)

EL3HLT

pub const L3RST: Self = Self::from_errno(errno::EL3RST)

EL3RST

pub const LIBACC: Self = Self::from_errno(errno::ELIBACC)

ELIBACC

pub const LIBBAD: Self = Self::from_errno(errno::ELIBBAD)

ELIBBAD

pub const LIBEXEC: Self = Self::from_errno(errno::ELIBEXEC)

ELIBEXEC

pub const LIBMAX: Self = Self::from_errno(errno::ELIBMAX)

ELIBMAX

pub const LIBSCN: Self = Self::from_errno(errno::ELIBSCN)

ELIBSCN

pub const LNRNG: Self = Self::from_errno(errno::ELNRNG)

ELNRNG

pub const LOOP: Self = Self::from_errno(errno::ELOOP)

ELOOP

pub const MEDIUMTYPE: Self = Self::from_errno(errno::EMEDIUMTYPE)

EMEDIUMTYPE

pub const MFILE: Self = Self::from_errno(errno::EMFILE)

EMFILE

pub const MLINK: Self = Self::from_errno(errno::EMLINK)

EMLINK

pub const MSGSIZE: Self = Self::from_errno(errno::EMSGSIZE)

EMSGSIZE

pub const MULTIHOP: Self = Self::from_errno(errno::EMULTIHOP)

EMULTIHOP

pub const NAMETOOLONG: Self = Self::from_errno(errno::ENAMETOOLONG)

ENAMETOOLONG

pub const NAVAIL: Self = Self::from_errno(errno::ENAVAIL)

ENAVAIL

pub const NETDOWN: Self = Self::from_errno(errno::ENETDOWN)

ENETDOWN

pub const NETRESET: Self = Self::from_errno(errno::ENETRESET)

ENETRESET

pub const NETUNREACH: Self = Self::from_errno(errno::ENETUNREACH)

ENETUNREACH

pub const NFILE: Self = Self::from_errno(errno::ENFILE)

ENFILE

pub const NOANO: Self = Self::from_errno(errno::ENOANO)

ENOANO

pub const NOBUFS: Self = Self::from_errno(errno::ENOBUFS)

ENOBUFS

pub const NOCSI: Self = Self::from_errno(errno::ENOCSI)

ENOCSI

pub const NODATA: Self = Self::from_errno(errno::ENODATA)

ENODATA

pub const NODEV: Self = Self::from_errno(errno::ENODEV)

ENODEV

pub const NOENT: Self = Self::from_errno(errno::ENOENT)

ENOENT

pub const NOEXEC: Self = Self::from_errno(errno::ENOEXEC)

ENOEXEC

pub const NOKEY: Self = Self::from_errno(errno::ENOKEY)

ENOKEY

pub const NOLCK: Self = Self::from_errno(errno::ENOLCK)

ENOLCK

pub const NOLINK: Self = Self::from_errno(errno::ENOLINK)

ENOLINK

pub const NOMEDIUM: Self = Self::from_errno(errno::ENOMEDIUM)

ENOMEDIUM

pub const NOMEM: Self = Self::from_errno(errno::ENOMEM)

ENOMEM

pub const NOMSG: Self = Self::from_errno(errno::ENOMSG)

ENOMSG

pub const NONET: Self = Self::from_errno(errno::ENONET)

ENONET

pub const NOPKG: Self = Self::from_errno(errno::ENOPKG)

ENOPKG

pub const NOPROTOOPT: Self = Self::from_errno(errno::ENOPROTOOPT)

ENOPROTOOPT

pub const NOSPC: Self = Self::from_errno(errno::ENOSPC)

ENOSPC

pub const NOSR: Self = Self::from_errno(errno::ENOSR)

ENOSR

pub const NOSTR: Self = Self::from_errno(errno::ENOSTR)

ENOSTR

pub const NOSYS: Self = Self::from_errno(errno::ENOSYS)

ENOSYS

pub const NOTBLK: Self = Self::from_errno(errno::ENOTBLK)

ENOTBLK

pub const NOTCONN: Self = Self::from_errno(errno::ENOTCONN)

ENOTCONN

pub const NOTDIR: Self = Self::from_errno(errno::ENOTDIR)

ENOTDIR

pub const NOTEMPTY: Self = Self::from_errno(errno::ENOTEMPTY)

ENOTEMPTY

pub const NOTNAM: Self = Self::from_errno(errno::ENOTNAM)

ENOTNAM

pub const NOTRECOVERABLE: Self = Self::from_errno(errno::ENOTRECOVERABLE)

ENOTRECOVERABLE

pub const NOTSOCK: Self = Self::from_errno(errno::ENOTSOCK)

ENOTSOCK

pub const NOTSUP: Self = Self::from_errno(errno::EOPNOTSUPP)

ENOTSUP

pub const NOTTY: Self = Self::from_errno(errno::ENOTTY)

ENOTTY

pub const NOTUNIQ: Self = Self::from_errno(errno::ENOTUNIQ)

ENOTUNIQ

pub const NXIO: Self = Self::from_errno(errno::ENXIO)

ENXIO

pub const OPNOTSUPP: Self = Self::from_errno(errno::EOPNOTSUPP)

EOPNOTSUPP

pub const OVERFLOW: Self = Self::from_errno(errno::EOVERFLOW)

EOVERFLOW

pub const OWNERDEAD: Self = Self::from_errno(errno::EOWNERDEAD)

EOWNERDEAD

pub const PERM: Self = Self::from_errno(errno::EPERM)

EPERM

pub const PFNOSUPPORT: Self = Self::from_errno(errno::EPFNOSUPPORT)

EPFNOSUPPORT

pub const PIPE: Self = Self::from_errno(errno::EPIPE)

EPIPE

pub const PROTO: Self = Self::from_errno(errno::EPROTO)

EPROTO

pub const PROTONOSUPPORT: Self = Self::from_errno(errno::EPROTONOSUPPORT)

EPROTONOSUPPORT

pub const PROTOTYPE: Self = Self::from_errno(errno::EPROTOTYPE)

EPROTOTYPE

pub const RANGE: Self = Self::from_errno(errno::ERANGE)

ERANGE

pub const REMCHG: Self = Self::from_errno(errno::EREMCHG)

EREMCHG

pub const REMOTE: Self = Self::from_errno(errno::EREMOTE)

EREMOTE

pub const REMOTEIO: Self = Self::from_errno(errno::EREMOTEIO)

EREMOTEIO

pub const RESTART: Self = Self::from_errno(errno::ERESTART)

ERESTART

pub const RFKILL: Self = Self::from_errno(errno::ERFKILL)

ERFKILL

pub const ROFS: Self = Self::from_errno(errno::EROFS)

EROFS

pub const SHUTDOWN: Self = Self::from_errno(errno::ESHUTDOWN)

ESHUTDOWN

pub const SOCKTNOSUPPORT: Self = Self::from_errno(errno::ESOCKTNOSUPPORT)

ESOCKTNOSUPPORT

pub const SPIPE: Self = Self::from_errno(errno::ESPIPE)

ESPIPE

pub const SRCH: Self = Self::from_errno(errno::ESRCH)

ESRCH

pub const SRMNT: Self = Self::from_errno(errno::ESRMNT)

ESRMNT

pub const STALE: Self = Self::from_errno(errno::ESTALE)

ESTALE

pub const STRPIPE: Self = Self::from_errno(errno::ESTRPIPE)

ESTRPIPE

pub const TIME: Self = Self::from_errno(errno::ETIME)

ETIME

pub const TIMEDOUT: Self = Self::from_errno(errno::ETIMEDOUT)

ETIMEDOUT

pub const TOOBIG: Self = Self::from_errno(errno::E2BIG)

E2BIG

pub const TOOMANYREFS: Self = Self::from_errno(errno::ETOOMANYREFS)

ETOOMANYREFS

pub const TXTBSY: Self = Self::from_errno(errno::ETXTBSY)

ETXTBSY

pub const UCLEAN: Self = Self::from_errno(errno::EUCLEAN)

EUCLEAN

pub const UNATCH: Self = Self::from_errno(errno::EUNATCH)

EUNATCH

pub const USERS: Self = Self::from_errno(errno::EUSERS)

EUSERS

pub const WOULDBLOCK: Self = Self::from_errno(errno::EWOULDBLOCK)

EWOULDBLOCK

pub const XDEV: Self = Self::from_errno(errno::EXDEV)

EXDEV

pub const XFULL: Self = Self::from_errno(errno::EXFULL)

EXFULL

impl Error

pub fn kind(self) -> ErrorKind

Shorthand for std::io::Error::from(self).kind().

Trait Implementations

impl Clone for Error

fn clone(&self) -> Error

Returns a copy of the value.

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

Performs copy-assignment from source.

impl Debug for Error

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

Formats the value using the given formatter.

impl Display for Error

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

Formats the value using the given formatter.

impl Error for Error

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

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

fn backtrace(&self) -> Option<&Backtrace>

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

Returns a stack backtrace, if available, of where this error occurred.

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

impl From<Error> for Error

fn from(err: Error) -> Self

Converts to this type from the input type.

impl Hash for Error

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, 

Feeds a slice of this type into the given Hasher.

impl PartialEq<Error> for Error

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

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

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

This method tests for !=.

impl Copy for Error

impl Eq for Error

impl StructuralEq for Error

impl StructuralPartialEq for Error