Skip to content

softswitch v0.2.0

Choose a tag to compare

@github-actions github-actions released this 07 Nov 12:24
· 30 commits to main since this release
6e32bab

Added

  • Packet library (softswitch::pkt): bounds-checked parsers and builders for Ethernet/802.1Q
    (tag insert/strip in place and on copy), ARP, IPv4 (RFC 1071 checksum, RFC 1624 incremental
    TTL update), ICMP echo/error, IGMP v1/v2/v3 and spanning-tree BPDUs (config, TCN, RST).

  • Common vocabulary types: MacAddress, Ipv4Address, Ipv4Prefix, port masks.

  • fuzz_packet libFuzzer target, packet micro-benchmarks, scripts/check.sh (local CI gates).

  • Shared-memory IPC (softswitch::shm): fixed-capacity forwarding tables (FDB, MDB, neighbors,
    routes, VLANs, ports), lock-free SPSC rings for learn/punt/inject/trace messages, and
    double-buffered table publication with a quiescent-state grace period, so the data plane never
    waits for the control plane.

  • System wrappers (softswitch::sys): RAII descriptors, eventfd, sealed memfd shared memory,
    Unix sockets with SCM_RIGHTS descriptor passing.

  • softswitchd (control plane): epoll event loop with timerfd/signalfd, creates the shared
    region, publishes tables and hands the region to the data plane over a SEQPACKET socket.

  • ss-dataplane (data plane): attaches over the handshake, opens one AF_PACKET port per switch
    port (TPACKET_V2 RX/TX rings, promiscuous, qdisc bypass) and forwards on a pinned SCHED_FIFO
    thread with mlockall. Flood-only forwarding for now.

  • netns integration tests: scripts/topo.sh (3 switches, 5 hosts), scripts/switches.sh,
    tests/integration/ registered in ctest (ctest --preset integration) and run in CI.

  • shellcheck in pre-commit.

Removed

  • scripts/setup_netns.sh / teardown_netns.sh (superseded by topo.sh).
  • The placeholder softswitch executable (replaced by softswitchd and ss-dataplane).

Changed

  • Release dry runs (workflow_dispatch) now run the publish job too (download, SBOM, checksums, notes) and upload the bundle as an artifact instead of creating a release.
  • GitHub Actions bumped: upload-artifact v7, download-artifact v8, upload-pages-artifact v5, codeql-action v4, sticky-pull-request-comment v3.

Fixed

  • PR-title lint accepts capitalized subjects (Dependabot's ci: Bump …); only a trailing period is rejected.

Install on Raspberry Pi OS / Debian bookworm (arm64)

sudo apt install ./softswitch_0.2.0_arm64.deb

Verify downloads with sha256sum -c SHA256SUMS.