netlink_wi 0.8.0

A library to retrieve information about wireless hardware in Linux operating system using netlink protocol.
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

//! Error types for netlink_wi operations.
//!
//! This module defines the error types used throughout the library for handling
//! netlink errors.

use std::{fmt::Display, result};

use neli::{
    consts::nl::Nlmsg,
    err::{DeError, Nlmsgerr, NlmsghdrErr, RouterError},
    genl::Genlmsghdr,
};
use nix::errno::Errno;

use crate::{attributes::Attribute, commands::Command};

pub type Result<T> = result::Result<T, NlError>;

/// The main error type for netlink_wi operations.
#[derive(Clone, Debug)]
pub struct NlError {
    /// The error message describing what went wrong.
    pub msg: String,
}

impl NlError {
    pub fn new<T: Display>(msg: T) -> NlError {
        NlError {
            msg: msg.to_string(),
        }
    }
}

impl std::fmt::Display for NlError {
    fn fmt(&self, f: &mut std::fmt::Formatter) -> std::fmt::Result {
        write!(f, "Netlink error: {}", self.msg)
    }
}

impl std::error::Error for NlError {}

impl<T, P> From<RouterError<T, P>> for NlError
where
    T: std::fmt::Debug,
    P: std::fmt::Debug,
{
    fn from(value: RouterError<T, P>) -> Self {
        match &value {
            RouterError::Nlmsgerr(err) => NlError::new(Errno::from_raw(-*err.error())),
            _ => NlError::new(value),
        }
    }
}

impl From<DeError> for NlError {
    fn from(value: DeError) -> Self {
        NlError::new(value)
    }
}

type Nl80211Msgerr = Nlmsgerr<NlmsghdrErr<Nlmsg, Genlmsghdr<Command, Attribute>>>;

impl From<Nl80211Msgerr> for NlError {
    fn from(value: Nl80211Msgerr) -> Self {
        NlError::new(Errno::from_raw(-value.error()))
    }
}