crafter 0.3.0

Packet-level network interaction for Rust tools and agents.
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

mod common;

use common::{
    local_ipv4, local_mac, print_help_if_requested, remote_ipv4, remote_mac, ExampleResult,
};
use crafter::prelude::*;

const PAYLOAD: &str = "GET / HTTP/1.0\r\n\r\n";

fn main() -> ExampleResult<()> {
    if print_help_if_requested(
        "usage: cargo run --example packet_building --\n\nBuild equivalent Ethernet/IPv4/TCP/Raw packets with push and / composition.",
    ) {
        return Ok(());
    }

    let pushed = Packet::new()
        .push(
            Ethernet::new()
                .src(local_mac())
                .dst(remote_mac())
                .ethertype(ETHERTYPE_IPV4),
        )
        .push(
            Ipv4::new()
                .src(local_ipv4())
                .dst(remote_ipv4())
                .ipv4_protocol(Ipv4Protocol::Tcp),
        )
        .push(
            Tcp::new()
                .sport(49152)
                .dport(80)
                .seq(0x0102_0304)
                .flags(TCP_FLAG_SYN),
        )
        .push(Raw::from(PAYLOAD));

    let composed = Ethernet::new()
        .src(local_mac())
        .dst(remote_mac())
        .ethertype(ETHERTYPE_IPV4)
        / Ipv4::new()
            .src(local_ipv4())
            .dst(remote_ipv4())
            .ipv4_protocol(Ipv4Protocol::Tcp)
        / Tcp::new()
            .sport(49152)
            .dport(80)
            .seq(0x0102_0304)
            .flags(TCP_FLAG_SYN)
        / Raw::from(PAYLOAD);

    let pushed_bytes = pushed.compile()?;
    let composed_bytes = composed.compile()?;
    assert_eq!(pushed_bytes.as_bytes(), composed_bytes.as_bytes());

    println!("mode: offline");
    println!("push summary: {}", pushed.summary());
    println!("slash summary: {}", composed.summary());
    println!("compiled bytes match: true");
    println!("bytes: {}", pushed_bytes.len());
    println!("hexdump:\n{}", pushed_bytes.hexdump());

    Ok(())
}