packet_parser 1.2.0

A powerful and modular Rust crate for network packet parsing.
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

use std::fmt;
pub mod ethertype;
pub mod mac_addres;
pub mod oui;
pub mod vlan;
use crate::parse::data_link::DataLink;

impl fmt::Display for DataLink<'_> {
    fn fmt(&self, f: &mut fmt::Formatter<'_>) -> fmt::Result {
        write!(
            f,
            "\n    Destination MAC: {},\n    Source MAC: {},\n    Ethertype: {},\n    VLAN: {},\n    Payload Length: {}\n",
            self.destination_mac,
            self.source_mac,
            self.ethertype,
            match &self.vlan {
                Some(vlan) => vlan.to_string(),
                None => "None".to_string(),
            },
            self.payload.len()
        )
    }
}

#[cfg(test)]
mod tests {
    use crate::parse::data_link::DataLink;

    #[test]
    fn test_datalink_display_without_vlan() {
        let data_link = DataLink {
            destination_mac: "AA:BB:CC:DD:EE:FF".to_string(),
            source_mac: "11:22:33:44:55:66".to_string(),
            ethertype: "IPv4".to_string(),
            vlan: None,
            payload: &[0x01, 0x02, 0x03, 0x04],
        };

        let expected = concat!(
            "\n    Destination MAC: AA:BB:CC:DD:EE:FF,\n",
            "    Source MAC: 11:22:33:44:55:66,\n",
            "    Ethertype: IPv4,\n",
            "    VLAN: None,\n",
            "    Payload Length: 4\n"
        );

        assert_eq!(data_link.to_string(), expected);
    }

    #[test]
    fn test_datalink_display_with_empty_payload() {
        let data_link = DataLink {
            destination_mac: "FF:FF:FF:FF:FF:FF".to_string(),
            source_mac: "00:00:00:00:00:00".to_string(),
            ethertype: "ARP".to_string(),
            vlan: None,
            payload: &[],
        };

        let expected = concat!(
            "\n    Destination MAC: FF:FF:FF:FF:FF:FF,\n",
            "    Source MAC: 00:00:00:00:00:00,\n",
            "    Ethertype: ARP,\n",
            "    VLAN: None,\n",
            "    Payload Length: 0\n"
        );

        assert_eq!(data_link.to_string(), expected);
    }
}