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

//! Link Aggregation Control Protocol (LACP, IEEE 802.3ad / IEEE 802.1AX) AST definitions.
//!
//! Defines the abstract syntax tree node for IEEE 802.1AX Link Aggregation Control Protocol
//! Data Units (LACPDUs) transmitted over Ethernet Slow Protocols EtherType `0x8809` to the
//! link-constrained multicast address `01:80:C2:00:00:02`. Each 110-byte LACPDU begins with
//! Subtype `0x01` and Version `0x01`, followed by the 20-byte Actor Information TLV (`0x01`),
//! 20-byte Partner Information TLV (`0x02`), 16-byte Collector Information TLV (`0x03`),
//! Terminator TLV (`0x00`), and 50 bytes of zero padding.
//!
//! Canonical `.fasm` syntax:
//! `a -> b LACP [ACTOR_SYS <mac>] [ACTOR_KEY <u16>] [ACTOR_PORT <u16>] [ACTOR_STATE <u8>] [PARTNER_SYS <mac>] [PARTNER_KEY <u16>] [PARTNER_PORT <u16>] [PARTNER_STATE <u8>]`

use core::marker::PhantomData;

/// Link Aggregation Control Protocol (IEEE 802.3ad / IEEE 802.1AX) frame specification.
///
/// Syntax mapping: `LACP [ACTOR_SYS <mac>] [ACTOR_KEY <u16>] [ACTOR_PORT <u16>] [ACTOR_STATE <u8>] [PARTNER_SYS <mac>] [PARTNER_KEY <u16>] [PARTNER_PORT <u16>] [PARTNER_STATE <u8>]`
#[doc(alias = "LACP")]
#[doc(alias = "802.3ad")]
#[doc(alias = "802.1AX")]
#[doc(alias = "0x8809")]
#[doc(alias = "ACTOR_SYS")]
#[doc(alias = "ACTOR_KEY")]
#[doc(alias = "ACTOR_PORT")]
#[doc(alias = "ACTOR_STATE")]
#[doc(alias = "PARTNER_SYS")]
#[doc(alias = "PARTNER_KEY")]
#[doc(alias = "PARTNER_PORT")]
#[doc(alias = "PARTNER_STATE")]
#[derive(Debug, Clone, PartialEq, Eq, Default)]
pub struct LacpSpec<'a> {
    /// Actor System 48-bit MAC identifier (`ACTOR_SYS <mac>`).
    pub actor_sys: Option<[u8; 6]>,
    /// Actor 16-bit operational administrative key (`ACTOR_KEY <u16>`).
    pub actor_key: Option<u16>,
    /// Actor 16-bit port number (`ACTOR_PORT <u16>`).
    pub actor_port: Option<u16>,
    /// Partner System 48-bit MAC identifier (`PARTNER_SYS <mac>`).
    pub partner_sys: Option<[u8; 6]>,
    /// Partner 16-bit operational administrative key (`PARTNER_KEY <u16>`).
    pub partner_key: Option<u16>,
    /// Partner 16-bit port number (`PARTNER_PORT <u16>`).
    pub partner_port: Option<u16>,
    /// Actor 8-bit state bitmask (`ACTOR_STATE <u8>`: Activity, Timeout, Aggregation, Sync, Collecting, Distributing, Defaulted, Expired).
    pub actor_state: Option<u8>,
    /// Partner 8-bit state bitmask (`PARTNER_STATE <u8>`).
    pub partner_state: Option<u8>,
    /// Optional lifetime marker for zero-copy AST borrowing.
    pub _marker: PhantomData<&'a ()>,
}