Struct DeviceOpError 

pub struct DeviceOpError {
    pub op: String,
    pub device: String,
    /* private fields */
}

A failed device operation, with enough context to pinpoint it from a log line alone: which operation (write, read, poll, ioctl CA_RESET, …), which device (the /dev/dvb/adapterN/... path, or the fd role for a from_file wrapper) and the errno. A bare Invalid argument (os error 22) from Driver::pump (seen on a DD CXD2099 during init) names none of those, and the same errno means different things per operation: the kernel’s dvb_ca_en50221 returns EINVAL from write while the slot is not yet RUNNING, from read when the buffer is smaller than the pending frame, and from CA_GET_SLOT_INFO for a slot it does not have.

It is carried as the payload of an io::Error of the same io::ErrorKind as the original, so kind()-based handling is unchanged; the errno stays reachable through errno / DeviceOpError::errno_of (a wrapped error no longer answers raw_os_error() itself).

Fields

op: String

The operation that failed, e.g. "write (17 bytes)".

device: String

The device, e.g. "/dev/dvb/adapter3/ca0".

Implementations

impl DeviceOpError

pub fn wrap(op: impl Into<String>, device: &str, source: Error) -> Error

Wrap source (an error from op on device) into an io::Error of the same kind that displays all three.

pub fn errno(&self) -> Option<i32>

The OS errno of the underlying failure, if it had one.

pub fn errno_of(err: &Error) -> Option<i32>

The OS errno of err whether or not it is wrapped in a DeviceOpError (a plain OS error answers for itself).

Trait Implementations

impl Debug for DeviceOpError

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

Formats the value using the given formatter.

impl Display for DeviceOpError

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

Formats the value using the given formatter.

impl Error for DeviceOpError

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

Returns 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.