packet_rs 0.4.0

A Scapy like interface to build and define custom packet headers
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

#[macro_use]
extern crate packet_rs;

use packet_rs::headers::*;
use packet_rs::utils;
use packet_rs::Packet;

fn main() {
    make_header!(
    MyHeader 4
    (
        field_1: 0-2,
        field_2: 3-3,
        field_3: 4-15,
        field_4: 16-31
    )
    vec![0x0, 0xa, 0x8, 0x0]      // <= optional default data
    );

    // 2 ways to use a header
    // Call new on the *MyHeader* header
    let hdr = MyHeader::new();
    hdr.show();

    // Pass a data buffer as an argument
    let mut hdr = MyHeader::from(vec![0xF3, 0x01, 0x08, 0xFF]);
    // fetch the field_2 value
    println!("{}", hdr.field_2());
    // set the field_2 value
    hdr.set_field_2(1);
    hdr.show();

    // create a simple Ether header
    let mut eth = Ether::new();
    eth.show();

    // get the etype field from the header
    let etype = eth.etype();
    println!("{}", etype);

    // update the etype field in the header
    eth.set_etype(0x8100);
    eth.show();

    // use the Packet associate function to create ethernet header
    let eth = Packet::ethernet("00:11:11:11:11:11", "00:11:11:11:11:11", 0x8100);
    eth.show();

    // create a UDP packet by pushing each header in sequence
    let mut pkt = Packet::new();
    pkt.push(Ether::new());
    pkt.push(IPv4::new());
    pkt.push(UDP::new());
    pkt.show();

    // convert packet to byte array
    let v = pkt.to_vec();
    println!("{:?}", v);

    // duplicate a packet using clone
    let new_pkt = pkt.clone();
    new_pkt.show();

    let payload: Vec<u8> = (0..100).collect::<Vec<u8>>();
    // create a TCP packet using the Packet associate function
    let pkt = utils::create_tcp_packet(
        "00:01:02:03:04:05",
        "00:06:07:08:09:0a",
        false,
        10,
        3,
        5,
        "10.10.10.1",
        "11.11.11.1",
        0,
        64,
        115,
        0,
        Vec::new(),
        1234,
        9090,
        100,
        101,
        5,
        0,
        0x10,
        2,
        0,
        false,
        &payload,
    );
    pkt.show();
}