Repository navigation
softswitch v0.2.0
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_packetlibFuzzer 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 withmlockall. 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 bytopo.sh).- The placeholder
softswitchexecutable (replaced bysoftswitchdandss-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.debVerify downloads with sha256sum -c SHA256SUMS.