1 /// Layers on which an error can occur.
2 #[derive(Copy, Clone, Debug, Eq, PartialEq, Ord, PartialOrd, Hash)]
3 pub enum Layer {
4     /// Error occurred in the Linux Cooked Capture v1 (SLL) header.
5     LinuxSllHeader,
6     /// Error occurred in the ethernet 2 header.
7     Ethernet2Header,
8     /// Payload identified by an ether type number (e.g. after an ethernet 2 header).
9     EtherPayload,
10     /// Error occurred in the vlan header.
11     VlanHeader,
12     /// Error occurred when decoding an IP header (v4 or v6).
13     IpHeader,
14     /// Error occurred in the IPv4 layer.
15     Ipv4Header,
16     /// Error occurred verifying the total length of an IPv4 packet.
17     Ipv4Packet,
18     /// Error occurred in the IP Authentication header.
19     IpAuthHeader,
20     /// Error occurred in the IPv6 layer.
21     Ipv6Header,
22     /// Error occurred verifying the payload length of an IPv6 packet.
23     Ipv6Packet,
24     /// Error occurred while decoding a generic IPv6 extension header.
25     Ipv6ExtHeader,
26     /// Error occurred while decoding "IPv6 Hop-by-Hop Option" extension header.
27     Ipv6HopByHopHeader,
28     /// Error occurred while decoding "IPv6 Destination Options" extension header.
29     Ipv6DestOptionsHeader,
30     /// Error occurred while decoding "IPv6 Routing" extension header.
31     Ipv6RouteHeader,
32     /// Error occurred while decoding an IPv6 fragment header.
33     Ipv6FragHeader,
34     /// Error occurred while decoding an UDP header.
35     UdpHeader,
36     /// Error occurred verifying the length of the UDP payload.
37     UdpPayload,
38     /// Error occurred while decoding a TCP header.
39     TcpHeader,
40     /// Error occurred while parsing an ICMP packet.
41     Icmpv4,
42     /// Error occurred while parsing an ICMP timestamp packet.
43     Icmpv4Timestamp,
44     /// Error occurred while parsing an ICMP timestamp reply packet.
45     Icmpv4TimestampReply,
46     /// Error occurred while parsing an ICMPv6 packet.
47     Icmpv6,
48 }
49 
50 impl Layer {
51     /// String that is used as a title for the error.
error_title(&self) -> &'static str52     pub fn error_title(&self) -> &'static str {
53         use Layer::*;
54         match self {
55             LinuxSllHeader => "Linux Cooked Capture v1 Error",
56             Ethernet2Header => "Ethernet 2 Header Error",
57             EtherPayload => "Payload with Ether Type Error",
58             VlanHeader => "VLAN Header Error",
59             IpHeader => "IP Header Error",
60             Ipv4Header => "IPv4 Header Error",
61             Ipv4Packet => "IPv4 Packet Error",
62             IpAuthHeader => "IP Authentication Header Error",
63             Ipv6Header => "IPv6 Header Error",
64             Ipv6Packet => "IPv6 Packet Error",
65             Ipv6ExtHeader => "IPv6 Extension Header Error",
66             Ipv6HopByHopHeader => "IPv6 Hop-by-Hop Option Header Error",
67             Ipv6DestOptionsHeader => "IPv6 Destination Options Header Error",
68             Ipv6RouteHeader => "IPv6 Routing Header Error",
69             Ipv6FragHeader => "IPv6 Fragment Header Error",
70             UdpHeader => "UDP Header Error",
71             UdpPayload => "UDP Payload Error",
72             TcpHeader => "TCP Header Error",
73             Icmpv4 => "ICMP Packet Error",
74             Icmpv4Timestamp => "ICMP Timestamp Error",
75             Icmpv4TimestampReply => "ICMP Timestamp Reply Error",
76             Icmpv6 => "ICMPv6 Packet Error",
77         }
78     }
79 }
80 
81 impl core::fmt::Display for Layer {
fmt(&self, f: &mut core::fmt::Formatter<'_>) -> core::fmt::Result82     fn fmt(&self, f: &mut core::fmt::Formatter<'_>) -> core::fmt::Result {
83         use Layer::*;
84         match self {
85             LinuxSllHeader => write!(f, "Linux Cooked Capture v1 header"),
86             Ethernet2Header => write!(f, "Ethernet 2 header"),
87             EtherPayload => write!(f, "Ether type payload"),
88             VlanHeader => write!(f, "VLAN header"),
89             IpHeader => write!(f, "IP header"),
90             Ipv4Header => write!(f, "IPv4 header"),
91             Ipv4Packet => write!(f, "IPv4 packet"),
92             IpAuthHeader => write!(f, "IP Authentication header"),
93             Ipv6Header => write!(f, "IPv6 header"),
94             Ipv6Packet => write!(f, "IPv6 packet"),
95             Ipv6ExtHeader => write!(f, "IPv6 extension header"),
96             Ipv6HopByHopHeader => write!(f, "IPv6 hop-by-hop option header"),
97             Ipv6DestOptionsHeader => write!(f, "IPv6 destination options header"),
98             Ipv6RouteHeader => write!(f, "IPv6 routing header"),
99             Ipv6FragHeader => write!(f, "IPv6 fragment header"),
100             UdpHeader => write!(f, "UDP header"),
101             UdpPayload => write!(f, "UDP payload"),
102             TcpHeader => write!(f, "TCP header"),
103             Icmpv4 => write!(f, "ICMP packet"),
104             Icmpv4Timestamp => write!(f, "ICMP timestamp message"),
105             Icmpv4TimestampReply => write!(f, "ICMP timestamp reply message"),
106             Icmpv6 => write!(f, "ICMPv6 packet"),
107         }
108     }
109 }
110 
111 #[cfg(test)]
112 mod test {
113     use super::Layer::*;
114     use alloc::format;
115     use std::{
116         cmp::Ordering,
117         collections::hash_map::DefaultHasher,
118         hash::{Hash, Hasher},
119     };
120 
121     #[test]
debug()122     fn debug() {
123         assert_eq!("Ethernet2Header", format!("{:?}", Ethernet2Header));
124     }
125 
126     #[test]
clone_eq_hash_ord()127     fn clone_eq_hash_ord() {
128         let layer = Ethernet2Header;
129         assert_eq!(layer, layer.clone());
130         let hash_a = {
131             let mut hasher = DefaultHasher::new();
132             layer.hash(&mut hasher);
133             hasher.finish()
134         };
135         let hash_b = {
136             let mut hasher = DefaultHasher::new();
137             layer.clone().hash(&mut hasher);
138             hasher.finish()
139         };
140         assert_eq!(hash_a, hash_b);
141         assert_eq!(Ordering::Equal, layer.cmp(&layer));
142         assert_eq!(Some(Ordering::Equal), layer.partial_cmp(&layer));
143     }
144 
145     #[test]
error_title()146     fn error_title() {
147         let tests = [
148             (Ethernet2Header, "Ethernet 2 Header Error"),
149             (VlanHeader, "VLAN Header Error"),
150             (IpHeader, "IP Header Error"),
151             (Ipv4Header, "IPv4 Header Error"),
152             (Ipv4Packet, "IPv4 Packet Error"),
153             (IpAuthHeader, "IP Authentication Header Error"),
154             (Ipv6Header, "IPv6 Header Error"),
155             (Ipv6Packet, "IPv6 Packet Error"),
156             (Ipv6ExtHeader, "IPv6 Extension Header Error"),
157             (Ipv6HopByHopHeader, "IPv6 Hop-by-Hop Option Header Error"),
158             (
159                 Ipv6DestOptionsHeader,
160                 "IPv6 Destination Options Header Error",
161             ),
162             (Ipv6RouteHeader, "IPv6 Routing Header Error"),
163             (Ipv6FragHeader, "IPv6 Fragment Header Error"),
164             (UdpHeader, "UDP Header Error"),
165             (UdpPayload, "UDP Payload Error"),
166             (TcpHeader, "TCP Header Error"),
167             (Icmpv4, "ICMP Packet Error"),
168             (Icmpv4Timestamp, "ICMP Timestamp Error"),
169             (Icmpv4TimestampReply, "ICMP Timestamp Reply Error"),
170             (Icmpv6, "ICMPv6 Packet Error"),
171         ];
172         for test in tests {
173             assert_eq!(test.0.error_title(), test.1);
174         }
175     }
176 
177     #[test]
fmt()178     fn fmt() {
179         let tests = [
180             (Ethernet2Header, "Ethernet 2 header"),
181             (VlanHeader, "VLAN header"),
182             (IpHeader, "IP header"),
183             (Ipv4Header, "IPv4 header"),
184             (Ipv4Packet, "IPv4 packet"),
185             (IpAuthHeader, "IP Authentication header"),
186             (Ipv6Header, "IPv6 header"),
187             (Ipv6Packet, "IPv6 packet"),
188             (Ipv6ExtHeader, "IPv6 extension header"),
189             (Ipv6HopByHopHeader, "IPv6 hop-by-hop option header"),
190             (Ipv6DestOptionsHeader, "IPv6 destination options header"),
191             (Ipv6RouteHeader, "IPv6 routing header"),
192             (Ipv6FragHeader, "IPv6 fragment header"),
193             (UdpHeader, "UDP header"),
194             (UdpPayload, "UDP payload"),
195             (TcpHeader, "TCP header"),
196             (Icmpv4, "ICMP packet"),
197             (Icmpv4Timestamp, "ICMP timestamp message"),
198             (Icmpv4TimestampReply, "ICMP timestamp reply message"),
199             (Icmpv6, "ICMPv6 packet"),
200         ];
201         for test in tests {
202             assert_eq!(format!("{}", test.0), test.1);
203         }
204     }
205 }
206