rustix/io/
errno.rs

1//! The `Errno` type, which is a minimal wrapper around an error code.
2//!
3//! We define the error constants as individual `const`s instead of an enum
4//! because we may not know about all of the host's error values and we don't
5//! want unrecognized values to create undefined behavior.
6
7use crate::backend;
8use core::{fmt, result};
9#[cfg(feature = "std")]
10use std::error;
11
12/// A specialized [`Result`] type for `rustix` APIs.
13pub type Result<T> = result::Result<T, Errno>;
14
15pub use backend::io::errno::Errno;
16
17impl Errno {
18    /// Shorthand for `std::io::Error::from(self).kind()`.
19    #[cfg(feature = "std")]
20    #[inline]
21    pub fn kind(self) -> std::io::ErrorKind {
22        std::io::Error::from(self).kind()
23    }
24}
25
26impl fmt::Display for Errno {
27    fn fmt(&self, f: &mut fmt::Formatter<'_>) -> fmt::Result {
28        #[cfg(feature = "std")]
29        {
30            std::io::Error::from(*self).fmt(f)
31        }
32        #[cfg(not(feature = "std"))]
33        {
34            write!(f, "os error {}", self.raw_os_error())
35        }
36    }
37}
38
39impl fmt::Debug for Errno {
40    fn fmt(&self, f: &mut fmt::Formatter<'_>) -> fmt::Result {
41        #[cfg(feature = "std")]
42        {
43            std::io::Error::from(*self).fmt(f)
44        }
45        #[cfg(not(feature = "std"))]
46        {
47            write!(f, "os error {}", self.raw_os_error())
48        }
49    }
50}
51
52#[cfg(feature = "std")]
53impl error::Error for Errno {}
54
55#[cfg(feature = "std")]
56impl From<Errno> for std::io::Error {
57    #[inline]
58    fn from(err: Errno) -> Self {
59        Self::from_raw_os_error(err.raw_os_error() as _)
60    }
61}
62
63/// Call `f` until it either succeeds or fails other than [`Errno::INTR`].
64#[inline]
65pub fn retry_on_intr<T, F: FnMut() -> Result<T>>(mut f: F) -> Result<T> {
66    loop {
67        match f() {
68            Err(Errno::INTR) => (),
69            result => return result,
70        }
71    }
72}
rustix/io/errno.rs

rustix/io/
errno.rs
