Skip to content

softswitch v0.3.0

Choose a tag to compare

@github-actions github-actions released this 07 Nov 18:00
· 26 commits to main since this release
dd263f6

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-config output replays as a startup config (round-trip tested and fuzzed).
  • CLI Unix socket in softswitchd and the sscli client (one-shot or interactive);
    softswitchd --config FILE loads a startup config.
  • Startup configs for the test topology (configs/sw{1,2,3}.conf): VLAN 10/20 with 802.1Q trunks.
  • fuzz_config fuzz target with a seed corpus under fuzz/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_pipeline fuzz 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_fdb fuzz target and FDB learn/publish benchmarks.

Removed

  • MacTable (replaced by l2::Fdb).

Install on Raspberry Pi OS / Debian bookworm (arm64)

sudo apt install ./softswitch_0.3.0_arm64.deb

Verify downloads with sha256sum -c SHA256SUMS.