ether 0.1.4

Library for parsing and manipulating network data, packet captures.
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


use std::ops;
use std::fmt;
use utility::{parser, Bitfield};

pub struct Packet<'a>(&'a [u8]);

#[doc(hidden)]
impl<'a> ops::Deref for Packet<'a> {
    type Target = &'a [u8];
    fn deref(&self) -> &Self::Target {
        &self.0
    }
}

impl<'a> Packet<'a> {
    pub fn new(data: &'a [u8]) -> Self {
        Packet(data)
    }

    pub fn source(&self) -> u16 {
        parser::be_u16(&self[..])
    }

    pub fn destination(&self) -> u16 {
        parser::be_u16(&self[2..])
    }

    pub fn sequence(&self) -> u32 {
        parser::be_u32(&self[4..])
    }

    pub fn acknowledgment(&self) -> u32 {
        parser::be_u32(&self[8..])
    }

    pub fn offset(&self) -> u8 {
        (self[12] & 0xF0) >> 4
    }

    pub fn flags(&self) -> Vec<Flag> {
        let mut flags = vec![];

        let bitfield = Bitfield::new(parser::be_u16(&self[12..]) & 0x1FF);

        use self::Flag::*;

        if bitfield.has(8) {
            flags.push(NS);
        }
        if bitfield.has(7) {
            flags.push(CWR);
        }
        if bitfield.has(6) {
            flags.push(ECE);
        }
        if bitfield.has(5) {
            flags.push(URG);
        }
        if bitfield.has(4) {
            flags.push(ACK);
        }
        if bitfield.has(3) {
            flags.push(PSH);
        }
        if bitfield.has(2) {
            flags.push(RST);
        }
        if bitfield.has(1) {
            flags.push(SYN);
        }
        if bitfield.has(0) {
            flags.push(FIN);
        }

        flags
    }

    pub fn window(&self) -> u16 {
        parser::be_u16(&self[14..])
    }

    pub fn checksum(&self) -> u16 {
        parser::be_u16(&self[16..])
    }

    pub fn urgent(&self) -> u16 {
        parser::be_u16(&self[18..])
    }

    pub fn payload(&self) -> &[u8] {
        let offset = self.offset() as usize * 4;
        &self[offset..]
    }
}

impl<'a> fmt::Debug for Packet<'a> {
    fn fmt(&self, fmtr: &mut fmt::Formatter) -> fmt::Result {
        fmtr.debug_struct("tcp::Packet")
                .field("source", &self.source())
                .field("destination", &self.destination())
                .field("sequence", &self.sequence())
                .field("acknowledgment", &self.acknowledgment())
                .field("offset", &self.offset())
                .field("flags", &self.flags())
                .field("window", &self.window())
                .field("checksum", &self.checksum())
                .field("urgent", &self.urgent())
                // Options
                .finish()
    }
}

#[allow(dead_code)]
#[derive(Debug, PartialEq, Clone)]
pub enum Flag {
    NS,
    CWR,
    ECE,
    URG,
    ACK,
    PSH,
    RST,
    SYN,
    FIN,
}