pciutils 0.1.1

A clone of pciutils in Rust
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111

use std::convert::From;
use std::fmt::Debug;
use std::num::ParseIntError;
use std::ops::Range;

pub type Result<T> = std::result::Result<T, Error>;

#[derive(Debug, PartialEq)]
pub enum ErrorKind {
    IntegerParseError,
    InvalidBusDeviceFunction,
    InvalidVendorDeviceClass,
    IoError(std::io::ErrorKind),
    FormatError,
    SliceParseError,
    UnknownCapabilityId,
}

#[derive(Debug, PartialEq)]
pub struct Error {
    pub error_kind: ErrorKind,
    pub message: String,
}

impl Error {
    pub fn invalid_bdf(message: &str) -> Self {
        Error {
            error_kind: ErrorKind::InvalidBusDeviceFunction,
            message: message.to_string(),
        }
    }

    pub fn invalid_vdc(message: &str) -> Self {
        Error {
            error_kind: ErrorKind::InvalidVendorDeviceClass,
            message: message.to_string(),
        }
    }

    pub fn is_file_not_found(&self) -> bool {
        if let ErrorKind::IoError(std::io::ErrorKind::NotFound) = self.error_kind {
            return true;
        }

        false
    }

    pub fn slice_parse_error(b: &[u8], r: &Range<usize>) -> Error {
        let message = format!("Index range {}:{} outside of 0:{}", r.start, r.end, b.len());
        Error {
            error_kind: ErrorKind::SliceParseError,
            message,
        }
    }

    pub fn unknown_capability(id: u8) -> Error {
        let message = format!("Unknown capability id:{}", id);
        Error {
            error_kind: ErrorKind::UnknownCapabilityId,
            message,
        }
    }
}

impl From<ParseIntError> for Error {
    fn from(value: ParseIntError) -> Self {
        Error {
            error_kind: ErrorKind::IntegerParseError,
            message: value.to_string(),
        }
    }
}

impl From<std::io::Error> for Error {
    fn from(value: std::io::Error) -> Self {
        Error {
            error_kind: ErrorKind::IoError(value.kind()),
            message: value.to_string(),
        }
    }
}

impl From<Error> for std::io::Error {
    fn from(value: Error) -> Self {
        std::io::Error::new(std::io::ErrorKind::Other, value.message)
    }
}

impl From<std::fmt::Error> for Error {
    fn from(_: std::fmt::Error) -> Self {
        Error {
            error_kind: ErrorKind::FormatError,
            message: String::new(),
        }
    }
}

impl From<Error> for std::fmt::Error {
    fn from(_: Error) -> Self {
        std::fmt::Error {}
    }
}

impl From<std::array::TryFromSliceError> for Error {
    fn from(value: std::array::TryFromSliceError) -> Self {
        Error {
            error_kind: ErrorKind::SliceParseError,
            message: value.to_string(),
        }
    }
}