frameassembly 1.4.2

Offline, rootless PCAP generator & Packets-as-Code DSL: generate deterministic .pcap/.pcapng from text across 81 protocols for Wireshark, tcpreplay & IDS.
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

//! Layer 2 Data Link protocols and frame modifiers for FrameAssembly AST representation.
//!
//! This module defines the abstract syntax tree structures for IEEE 802.3 Ethernet framing
//! overrides and Data Link layer control and encapsulation protocols:
//! - **ARP** (RFC 826 / RFC 5227, EtherType `0x0806`) with polymorphic IPv6 NDP adaptation
//! - **EAPOL** (IEEE 802.1X-2020 Port-Based Network Access Control, EtherType `0x888E`)
//! - **LACP** (IEEE 802.3ad / IEEE 802.1AX Link Aggregation Control Protocol, EtherType `0x8809`)
//! - **LLDP** (IEEE 802.1AB Station and Media Access Control Connectivity Discovery, EtherType `0x88CC`)
//! - **MPLS** (RFC 3032 Multi-Protocol Label Switching label stack encoding, EtherType `0x8847`)
//! - **QinQ** (IEEE 802.1ad Provider Bridges double VLAN tagging, outer TPID `0x88A8`, inner TPID `0x8100`)
//! - **STP / RSTP** (IEEE 802.1D / IEEE 802.1w Spanning Tree Protocol BPDUs over 802.3 LLC `0x424203`)
//! - **VLAN** (IEEE 802.1Q Virtual Bridged Local Area Networks 32-bit tag, TPID `0x8100`)

pub mod arp;
pub mod eapol;
pub mod lacp;
pub mod lldp;
pub mod mpls;
pub mod qinq;
pub mod stp;
pub mod vlan;

#[doc(inline)]
pub use arp::*;
#[doc(inline)]
pub use eapol::*;
#[doc(inline)]
pub use lacp::*;
#[doc(inline)]
pub use lldp::*;
#[doc(inline)]
pub use mpls::*;
#[doc(inline)]
pub use qinq::*;
#[doc(inline)]
pub use stp::*;
#[doc(inline)]
pub use vlan::*;

/// Layer 2 Ethernet header and shim encapsulation modifiers applied to any frame statement.
///
/// Syntax mapping: `[SRCMAC <mac>] [DSTMAC <mac>] [ETHERTYPE <u16>] [VLAN <vid> [PCP <pcp>] [DEI <dei>]] [QINQ <svid> [INNER_VLAN <cvid>]] [MPLS <label> [EXP <tc>] [BOS <s_bit>] [MPLS_TTL <ttl>]]`
#[doc(alias = "Ethernet")]
#[doc(alias = "802.3")]
#[doc(alias = "802.1Q")]
#[derive(Debug, Clone, PartialEq, Eq, Default)]
pub struct L2Modifiers {
    /// Source 48-bit IEEE 802 MAC address override (`SRCMAC <mac>`).
    pub src_mac: Option<[u8; 6]>,
    /// Destination 48-bit IEEE 802 MAC address override (`DSTMAC <mac>`).
    pub dst_mac: Option<[u8; 6]>,
    /// Custom 16-bit IEEE 802.3 EtherType override (`ETHERTYPE <u16>`).
    pub ethertype: Option<u16>,
    /// Optional IEEE 802.1Q single VLAN tag (`VLAN <vid> [PCP <u8>] [DEI <u8>]`).
    pub vlan: Option<VlanSpec>,
    /// Optional IEEE 802.1ad QinQ double VLAN tag (`QINQ <outer> [INNER_VLAN <inner>]`).
    pub qinq: Option<QinqSpec>,
    /// Optional RFC 3032 MPLS shim label (`MPLS <label> [EXP <u8>] [BOS <u8>] [MPLS_TTL <u8>]`).
    pub mpls: Option<MplsSpec>,
}