Struct kvm_ioctls::Error

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

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<(), Error>

Formats the value using the given formatter.

impl Display for Error

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

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

fn from(e: Error) -> Error

Converts to this type from the input type.

impl PartialEq 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: &Rhs) -> bool

This method tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl Copy for Error

impl Eq for Error

impl StructuralEq for Error

impl StructuralPartialEq for Error