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

use crate::{Header, UndefinedStruct};
use serde::{ser::SerializeStruct, Serialize, Serializer};
use std::fmt;

/// # OEM or Unknown Structure
///
/// Types 0 through 127 (7Fh) are reserved for and
/// defined by the DMTF SMBIOS specification.
/// Types 128 through 256 (80h to FFh) are available for
/// system- and OEM-specific information.
///
/// When a structure has a type which is not defined or
/// its type is an OEM type in the 80h to FFh range,
/// this structure is used to represent the type.
pub struct SMBiosUnknown<'a> {
    parts: &'a UndefinedStruct,
}

impl<'a> SMBiosUnknown<'a> {
    /// Creates an instance of this struct
    pub fn new(parts: &'a UndefinedStruct) -> Self {
        SMBiosUnknown { parts: parts }
    }

    /// Structure parts of this unknown structure
    ///
    /// Use this to inspect the structure in more detail.
    pub fn parts(&self) -> &'a UndefinedStruct {
        self.parts
    }
}

impl fmt::Debug for SMBiosUnknown<'_> {
    fn fmt(&self, fmt: &mut fmt::Formatter<'_>) -> fmt::Result {
        let fields = &self.parts.fields[Header::SIZE..];
        fmt.debug_struct(std::any::type_name::<SMBiosUnknown<'_>>())
            .field("header", &self.parts.header)
            .field("fields", &fields)
            .field("strings", &self.parts.strings)
            .finish()
    }
}

impl Serialize for SMBiosUnknown<'_> {
    fn serialize<S>(&self, serializer: S) -> Result<S::Ok, S::Error>
    where
        S: Serializer,
    {
        let fields = &self.parts.fields[Header::SIZE..];

        let mut state = serializer.serialize_struct("SMBiosUnknown", 3)?;
        state.serialize_field("header", &self.parts.header)?;
        state.serialize_field("fields", &fields)?;
        state.serialize_field("strings", &self.parts.strings)?;
        state.end()
    }
}

#[cfg(test)]
mod tests {
    use super::*;

    #[test]
    fn test_unknown_oem_type() {
        // For testing we've borrowed a language information type (0x0D) structure and change its type to 0x99 (> 0x7F are OEM types)
        let unknown_bytes = vec![
            0x99u8, 0x16, 0x21, 0x00, // unknown data
            0x03, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00,
            0x00, 0x00, 0x00, 0x01, // "en|US|iso8859-1"
            0x65, 0x6E, 0x7C, 0x55, 0x53, 0x7C, 0x69, 0x73, 0x6F, 0x38, 0x38, 0x35, 0x39, 0x2D,
            0x31, 0x00, // "fr|FR|iso8859-1"
            0x66, 0x72, 0x7C, 0x46, 0x52, 0x7C, 0x69, 0x73, 0x6F, 0x38, 0x38, 0x35, 0x39, 0x2D,
            0x31, 0x00, // "ja|JP|unicode"
            0x6A, 0x61, 0x7C, 0x4A, 0x50, 0x7C, 0x75, 0x6E, 0x69, 0x63, 0x6F, 0x64, 0x65, 0x00,
            // end of structure
            0x00,
        ];

        let parts = UndefinedStruct::new(&unknown_bytes);
        let unknown = SMBiosUnknown::new(&parts);

        // header tests
        assert_eq!(*unknown.parts().header.handle(), 0x0021);
        assert_eq!(unknown.parts().header.length(), 0x16);

        // debug print test
        println!("unknown structure: {:?}", unknown);
    }
}