frameassembly 1.5.0

A DSL for creating custom .pcap/.pcapng captures and decompiling captures to .fasm for testing firewalls, IDS rules, SNMP traps, and pentesting.
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

//! IEEE 802.1ad Provider Bridge (QinQ) Layer 2 standalone frame decompiler.
//!
//! This module implements standalone IEEE 802.1ad double-tagged (`QINQ`, outer EtherType `0x88A8`
//! or `0x9100` with inner `0x8100`) frame decompilation ([`dissect_qinq`]) for FrameAssembly's
//! PCAP and PCAPNG reverse decompiler. It formats the outer service VLAN identifier (`qinq`),
//! optional inner customer VLAN identifier (`inner_vlan`), Priority Code Point (`pcp`), and Drop
//! Eligible Indicator (`dei`) into canonical `.fasm` tokens.

use alloc::format;
use alloc::vec::Vec;
use core::fmt::Write as _;

use crate::ast::{Protocol, QinqSpec};
use crate::reverse::{ProtocolDissection, push_if, sd};

/// Formats a standalone `qinq` [`ProtocolDissection`] from a [`QinqSpec`], outer priority/DEI
/// fields (`qp`, `qd`), and residual L2 payload bytes.
pub(crate) fn dissect_qinq(q: &QinqSpec, qp: u8, qd: u8, res: Vec<u8>) -> ProtocolDissection {
    let mut t = format!("qinq {}", q.outer_vid);
    if let Some(iv) = q.inner_vid {
        let _ = write!(t, " inner_vlan {iv}");
    }
    push_if(&mut t, "pcp", qp, 0);
    push_if(&mut t, "dei", qd, 0);
    sd(Protocol::Qinq, t, res)
}