//! The `Errno` type, which is a minimal wrapper around an error code. //! //! We define the error constants as individual `const`s instead of an enum //! because we may not know about all of the host's error values and we don't //! want unrecognized values to create undefined behavior. use crate::backend; use core::{fmt, result}; #[cfg(feature = "std")] use std::error; /// A specialized [`Result`] type for `rustix` APIs. pub type Result = result::Result; pub use backend::io::errno::Errno; impl Errno { /// Shorthand for `std::io::Error::from(self).kind()`. #[cfg(feature = "std")] #[inline] pub fn kind(self) -> std::io::ErrorKind { std::io::Error::from(self).kind() } } impl fmt::Display for Errno { fn fmt(&self, fmt: &mut fmt::Formatter<'_>) -> fmt::Result { #[cfg(feature = "std")] { std::io::Error::from(*self).fmt(fmt) } #[cfg(not(feature = "std"))] { write!(fmt, "os error {}", self.raw_os_error()) } } } impl fmt::Debug for Errno { fn fmt(&self, fmt: &mut fmt::Formatter<'_>) -> fmt::Result { #[cfg(feature = "std")] { std::io::Error::from(*self).fmt(fmt) } #[cfg(not(feature = "std"))] { write!(fmt, "os error {}", self.raw_os_error()) } } } #[cfg(feature = "std")] impl error::Error for Errno {} #[cfg(feature = "std")] impl From for std::io::Error { #[inline] fn from(err: Errno) -> Self { Self::from_raw_os_error(err.raw_os_error() as _) } } /// Call `f` until it either succeeds or fails other than [`Errno::INTR`]. #[inline] pub fn retry_on_intr Result>(mut f: F) -> Result { loop { match f() { Err(Errno::INTR) => (), result => return result, } } }