ipmi-rs-core 0.5.0

A pure rust implementation of the core primitives of the IPMI spec
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
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133

use crate::connection::{Channel, IpmiCommand, Message, NetFn, NotEnoughData};

use super::{AuthType, PrivilegeLevel};

#[derive(Debug, Clone)]
pub struct ChannelAuthenticationCapabilities {
    pub channel_number: u8,
    pub oem_proprietary: bool,
    pub key: bool,
    pub md5: bool,
    pub md2: bool,
    pub none: bool,
    pub kg_status: bool,
    pub per_message_authentication_enabled: bool,
    pub user_level_authentication_enabled: bool,
    pub non_null_usernames_enabled: bool,
    pub null_usernames_enabled: bool,
    pub anonymous_login_enabled: bool,
    pub ipmi2_connections_supported: bool,
    pub ipmi15_connections_supported: bool,
    pub oem_id: [u8; 3],
    pub oem_auxiliary_data: u8,
}

impl ChannelAuthenticationCapabilities {
    pub fn best_auth(&self) -> Option<AuthType> {
        let auth_type = if self.md5 {
            AuthType::MD5
        } else if self.md2 {
            AuthType::MD2
        } else if self.key {
            AuthType::Key
        } else if self.none {
            AuthType::None
        } else {
            return None;
        };
        Some(auth_type)
    }
}

#[derive(Debug, Clone)]
pub struct GetChannelAuthenticationCapabilities {
    channel_number: Channel,
    privilege_level: PrivilegeLevel,
}

impl GetChannelAuthenticationCapabilities {
    pub fn new(channel_number: Channel, privilege_level: PrivilegeLevel) -> Self {
        Self {
            channel_number,
            privilege_level,
        }
    }
}

impl From<GetChannelAuthenticationCapabilities> for Message {
    fn from(value: GetChannelAuthenticationCapabilities) -> Message {
        Message::new_request(
            NetFn::App,
            0x38,
            vec![
                0x80 | value.channel_number.value(),
                value.privilege_level.into(),
            ],
        )
    }
}

impl IpmiCommand for GetChannelAuthenticationCapabilities {
    type Output = ChannelAuthenticationCapabilities;

    type Error = NotEnoughData;

    fn parse_success_response(data: &[u8]) -> Result<Self::Output, Self::Error> {
        if data.len() < 7 {
            return Err(NotEnoughData);
        }

        let channel_number = data[0];
        let ipmi2_ext_cap = (data[1] & 0x80) == 0x80;

        let oem_proprietary = (data[1] & 0x20) == 0x20;
        let key = (data[1] & 0x10) == 0x10;
        let md5 = (data[1] & 0x04) == 0x04;
        let md2 = (data[1] & 0x02) == 0x02;
        let none = (data[1] & 0x01) == 0x01;

        let pma = (data[2] & 0x10) == 0x10;
        let ula = (data[2] & 0x08) == 0x08;
        let nnue = (data[2] & 0x04) == 0x04;
        let nue = (data[2] & 0x02) == 0x02;
        let ale = (data[2] & 0x01) == 0x01;

        let (kg, v2, v15, oem_id, oem_aux) = if ipmi2_ext_cap {
            if data.len() < 8 {
                return Err(NotEnoughData);
            }

            let kg = (data[2] & 0x20) == 0x20;

            let v2 = (data[3] & 0x02) == 0x02;
            let v15 = (data[3] & 0x01) == 0x01;

            let oem_id = [data[4], data[5], data[6]];
            let oem_aux = data[7];
            (kg, v2, v15, oem_id, oem_aux)
        } else {
            let oem_id = [data[3], data[4], data[5]];
            let oem_aux = data[6];
            (false, false, false, oem_id, oem_aux)
        };

        Ok(ChannelAuthenticationCapabilities {
            channel_number,
            oem_proprietary,
            key,
            md5,
            md2,
            none,
            kg_status: kg,
            per_message_authentication_enabled: !pma,
            user_level_authentication_enabled: !ula,
            non_null_usernames_enabled: nnue,
            null_usernames_enabled: nue,
            anonymous_login_enabled: ale,
            ipmi2_connections_supported: v2,
            ipmi15_connections_supported: v15,
            oem_id,
            oem_auxiliary_data: oem_aux,
        })
    }
}