Struct vmm_sys_util::errno::Error

pub struct Error(_);

Wrapper over errno.

The error number is an integer number set by system calls and some libc functions in case of error.

Implementations

impl Error

pub fn new(errno: i32) -> Error

Creates a new error from the given error number.

Arguments

• errno: error number used for creating the Error.

Examples

extern crate vmm_sys_util;
use vmm_sys_util::errno::Error;

let err = Error::new(libc::EIO);

pub fn last() -> Error

Returns the last occurred errno wrapped in an Error.

Calling Error::last() is the equivalent of using errno in C/C++. The result of this function only has meaning after a libc call or syscall where errno was set.

Examples

extern crate vmm_sys_util;
use vmm_sys_util::errno::Error;
// Reading from a file without permissions returns an error.
let mut path = temp_dir();
path.push("test");
let mut file = File::create(path).unwrap();
let mut buf: Vec<u8> = Vec::new();
assert!(file.read_to_end(&mut buf).is_err());

// Retrieve the error number of the previous operation using `Error::last()`:
let read_err = Error::last();
#[cfg(unix)]
assert_eq!(read_err, Error::new(libc::EBADF));
#[cfg(not(unix))]
assert_eq!(read_err, Error::new(libc::EIO));

pub fn errno(self) -> i32

Returns the raw integer value (errno) corresponding to this Error.

Examples

extern crate vmm_sys_util;
use vmm_sys_util::errno::Error;

let err = Error::new(13);
assert_eq!(err.errno(), 13);

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, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Display for Error

fn fmt(&self, f: &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(e: Error) -> Self

Performs the conversion.

impl From<Error> for Error

fn from(err: Error) -> Error

Performs the conversion.

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