Repository navigation
softswitch v0.3.0
Added
- CLI: switch configuration model (VLANs, access/trunk ports, native VLAN, allowed VLAN lists,
descriptions, shutdown, MAC aging time, trace sampling) with Cisco-style one-line commands. show version | running-config | interfaces | vlan | counters | dataplane;show running-configoutput replays as a startup config (round-trip tested and fuzzed).- CLI Unix socket in
softswitchdand thesscliclient (one-shot or interactive);
softswitchd --config FILEloads a startup config. - Startup configs for the test topology (
configs/sw{1,2,3}.conf): VLAN 10/20 with 802.1Q trunks. fuzz_configfuzz target with a seed corpus underfuzz/corpus/config.- 802.1Q VLAN enforcement in the data plane: tagged frames dropped on access ports
(priority-tagged accepted), untagged frames classified to the PVID or dropped when the port has
none, ingress filtering on VLAN membership, egress only to members with per-port tagging, and
IEEE reserved group addresses (01:80:C2:00:00:0x) never forwarded. Drops are counted per reason. fuzz_pipelinefuzz target asserting the VLAN forwarding invariants on arbitrary frames.- MAC learning and aging: the control plane owns the FDB (
l2::Fdb, keyed by MAC+VLAN); the data
plane reports new and moved source MACs on the learn ring (with 10 ms repeat suppression) and
marks hits in a hash-indexed bitmap the control plane harvests every second for aging. - Known unicast is forwarded to a single port; frames to the ingress port are filtered; unknown
unicast, broadcast and multicast are flooded within the VLAN. show mac address-table [vlan ID] [interface PORT],clear mac address-table,
mac address-table static MAC vlan ID interface PORT; entries invalidated by configuration
(port shut down, VLAN pruned) are flushed.- STP port state honoured on ingress: discarding ports neither learn nor forward, learning ports
only learn. fuzz_fdbfuzz target and FDB learn/publish benchmarks.
Removed
MacTable(replaced byl2::Fdb).
Install on Raspberry Pi OS / Debian bookworm (arm64)
sudo apt install ./softswitch_0.3.0_arm64.debVerify downloads with sha256sum -c SHA256SUMS.