etherparse 0.20.1

A library for parsing & writing a bunch of packet based protocols (EthernetII, IPv4, IPv6, UDP, TCP ...).
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

/// A ICMPv4 timestamp or timestamp response message.
#[derive(Clone, Debug, PartialEq, Eq)]
pub struct TimestampMessage {
    pub id: u16,
    pub seq: u16,
    pub originate_timestamp: u32,
    pub receive_timestamp: u32,
    pub transmit_timestamp: u32,
}

impl TimestampMessage {
    /// Deprecated use [`TimestampMessage::LEN`] instead.
    #[deprecated(since = "0.14.0", note = "Use `TimestampMessage::LEN` instead")]
    pub const SERIALIZED_SIZE: usize = 20;

    /// The size in bytes/octets of a timestamp request or timestamp response message.
    pub const LEN: usize = 20;

    /// Decodes the timestamp message part of an ICMPv4 message.
    pub fn from_bytes(bytes: [u8; 16]) -> TimestampMessage {
        TimestampMessage {
            id: u16::from_be_bytes([bytes[0], bytes[1]]),
            seq: u16::from_be_bytes([bytes[2], bytes[3]]),
            originate_timestamp: u32::from_be_bytes([bytes[4], bytes[5], bytes[6], bytes[7]]),
            receive_timestamp: u32::from_be_bytes([bytes[8], bytes[9], bytes[10], bytes[11]]),
            transmit_timestamp: u32::from_be_bytes([bytes[12], bytes[13], bytes[14], bytes[15]]),
        }
    }
}

#[cfg(test)]
mod test {
    use crate::icmpv4::*;
    use alloc::format;
    use proptest::prelude::*;

    #[test]
    fn constants() {
        assert_eq!(20, TimestampMessage::LEN);
    }

    proptest! {
        #[test]
        fn from_bytes(bytes in any::<[u8;16]>()) {
            assert_eq!(
                TimestampMessage::from_bytes(bytes),
                TimestampMessage{
                    id: u16::from_be_bytes([bytes[0], bytes[1]]),
                    seq: u16::from_be_bytes([bytes[2], bytes[3]]),
                    originate_timestamp: u32::from_be_bytes([bytes[4], bytes[5], bytes[6], bytes[7]]),
                    receive_timestamp: u32::from_be_bytes([bytes[8], bytes[9], bytes[10], bytes[11]]),
                    transmit_timestamp: u32::from_be_bytes([bytes[12], bytes[13], bytes[14], bytes[15]]),
                }
            );
        }
    }

    #[test]
    fn clone_eq() {
        let v = TimestampMessage {
            id: 0,
            seq: 0,
            originate_timestamp: 0,
            receive_timestamp: 0,
            transmit_timestamp: 0,
        };
        assert_eq!(v.clone(), v);
    }

    #[test]
    fn debug() {
        let v = TimestampMessage {
            id: 0,
            seq: 0,
            originate_timestamp: 0,
            receive_timestamp: 0,
            transmit_timestamp: 0,
        };
        assert_eq!(
            format!("{:?}", v),
            format!(
                "TimestampMessage {{ id: {:?}, seq: {:?}, originate_timestamp: {:?}, receive_timestamp: {:?}, transmit_timestamp: {:?} }}",
                v.id,
                v.seq,
                v.originate_timestamp,
                v.receive_timestamp,
                v.transmit_timestamp,
            )
        );
    }
}