Skip to content

v0.4.0

Choose a tag to compare

@arcbox-labs arcbox-labs released this 24 Apr 14:25
3fa6fa8

0.4.0 (2026-04-24)

Features

  • agent: add MmapReadFile RPC to exercise DAX path E2E (ABX-362) (7f11502)
  • bench: add VirtioFS benchmark suite for M4 performance tracking (8d893da)
  • cli: register docker compose/buildx as Docker CLI plugins (483ab8b)
  • constants: add DOCKER_CLI_PLUGINS constant (563aeb7)
  • custom VMM with TSO support via Hypervisor.framework (#190) (0469191)
  • custom VMM with TSO support via Hypervisor.framework (#190) (c58e6d9)
  • ethernet: add SYN-ACK and SYN frame builders with option parsing (6fab71b)
  • fs: VirtioFS DAX support (protocol + window + mapper) (8864eed)
  • fs: wire VirtioFS DAX end-to-end (75e631e)
  • hv: add arcbox-hv crate with Hypervisor.framework FFI bindings (#185) (b310e89)
  • net: add vmnet bridge NIC (NIC2) to HV backend for container IP routing (7bebd9a)
  • net: crate split + zero-copy RX injection via channel (ABX-352) (a6edbb8)
  • net: GSO offload with NEEDS_CSUM for RX injection (39470db)
  • net: inline vhost framework + GSO NEEDS_CSUM (10.3 Gbps) (6075f46)
  • sandbox: support creating sandboxes from Dockerfiles (#158) (23508a3)
  • tcp_bridge: activate inline inject thread up-front when SEQ is known (a623714)
  • tcp_bridge: add hand-rolled TCP handshake synthesizer (48e91e1)
  • virtio-blk: implement DISCARD + WRITE_ZEROES, delete dead backend (475e58e)
  • virtio: add virtio-balloon device + HV backend wiring (ABX-363) (d1fc01c)
  • virtio: connect VirtIO devices to MMIO transport for HV backend (ABX-287) (bf92a7d)
  • virtio: implement vsock packet processing for HV backend (M2) (39829a0)
  • vmm+agent: fully enable HVC fast-path block I/O (4502123)
  • vmm: add DAX mapping counters + per-share stats accessor (ABX-362) (d0b95b9)
  • vmm: add vsock connect_vsock_hv with socketpair + backend dispatch (b9a6c96)
  • vmm: async block I/O worker + vsock multi-connection + boot fixes (9b4dc51)
  • vmm: dedicated net-io thread for RX injection (ABX-350) (ed10469)
  • vmm: deferred vsock OP_REQUEST injection + per-iteration RX poll (6bf0d4f)
  • vmm: enable HV backend in daemon — full boot path through arcbox-daemon (52a0119)
  • vmm: EVENT_IDX notification suppression for net RX (ABX-351) (5e753c8)
  • vmm: HVC fast-path block read handler (7f65535)
  • vmm: implement HV backend boot path and dual-backend switching (ABX-286, ABX-288) (f89d865)
  • vmm: implement PSCI CPU_ON secondary vCPU spawning and WFI blocking (M3) (0e983a8)
  • vmm: rewrite HV boot path to use rust-vmm crates (vm-memory, linux-loader, vm-fdt) (402bad2)
  • vmm: switch E2E test to production boot path (rootfs.erofs block device) (14211a4)
  • vmm: VirtIO console TX processing + console=hvc0 — init output visible (cde2abd)
  • vmm: VirtIO-blk multi-queue + DNS fix + flush barrier (6d26d38)
  • vmm: vsock data forwarding infrastructure (TX direction) (0045246)
  • vmm: vsock RX injection via poll_vsock_rx in WFI handler (821c73c)
  • vmm: vsock TX queue polling + connection state tracking (4e4aa95)
  • vmm: wire VirtIO device instances into HV backend for guest I/O [M1] (85d4ae4)
  • vsock: port vhost-device-vsock connection state machine (5afe8fc)

Bug Fixes

  • agent,cli: address PR #267 review comments (7aac968)
  • agent: cast FS_IOC_* constants to libc::Ioctl for target portability (a1294fd)
  • agent: make ensure_runtime non-blocking to avoid daemon RPC timeout (f606369)
  • agent: mount arcbox-dax under /run, drop rejected cache= option (123b35d)
  • fs: per-VirtioFS DAX window allocation (458a242)
  • fs: VirtioFS DAX end-to-end working (9cb08fd)
  • guest: bound thread spawns and reduce stack size in vm-agent (34abc8a)
  • hv: add exit_all_vcpus wrapper, fix GIC state memory leak, export register constants (758cb36)
  • hv: clamp vsock fd dup target below RLIMIT_NOFILE (4cf3ec2)
  • hv: join net RX worker on shutdown + release fence on avail_event (78da37b)
  • hv: pass vCPU IDs to hv_vcpus_exit on arm64 (ABX-367 root cause) (4a48d2a)
  • hv: re-export check, typed ignore reasons, safer GIC test drop (99a8b69)
  • hv: update GIC API for Xcode 26 SDK and fix RAM base address layout (cbf4fd4)
  • net-inject: advertise TCPV4 GSO for oversized inline frames (dab689f)
  • net-inject: drop GSO for RX-injected fast-path frames (75b1230)
  • net-inject: relay FIN+ACK to guest on host EOF (6cfb69d)
  • net,vmm: address AI code-review comments on PR #259 (4923d27)
  • net,vmm: resolve P0 release blockers from code review (ef95419)
  • net: address AI code-review comments on PR #260 (c2246f8)
  • net: complete hot-path log level downgrade (ABX-324) (597dc2e)
  • net: defer inline fast-path promotion until SEQ/ACK sync (d4cdf9f)
  • net: fix fast-path promotion panic, EMSGSIZE, and workspace clippy errors (52e7233)
  • net: route fake-IP TCP connections through proxy before domain lookup (0f3c6d4)
  • net: share our_seq atomic between inject thread and intercept ACKs (6dba9d0)
  • net: skip retransmits and drain on Broken pipe in fast-path TX (5315647)
  • net: use device ID for primary NIC lookup instead of HashMap scan (ddbb49a)
  • net: use device ID for primary NIC lookup instead of HashMap scan (056b14e)
  • net: use full TCP checksum for fast-path frames under MTU (287f272)
  • transport: blocking vsock transport for HV agent control plane (198e2e7)
  • transport: clean up blocking transport warnings, add block_in_place (853cbc3)
  • transport: use tokio::net::UnixStream for HV socketpair connections (069b226)
  • virtio-core: cap descriptor-chain iteration at queue size (0a43be1)
  • virtio-fs: exercise DAX fast path end-to-end on HV (ABX-366) (33341ba)
  • virtio-fs: FUSE 7.36+ DAX layout, TOCTOU-safe inode open (6bc9f03)
  • virtio-net: configure TAP offload after feature negotiation (9164bef)
  • virtio-net: implement MRG_RXBUF multi-chain RX delivery (cb707cd)
  • virtio-net: retry-on-ENOBUFS in guest TX write path (b9f69aa)
  • virtio-rng: drop zero-fill fallback on getrandom failure (7ce3dfd)
  • virtio-vsock: handle OP_SHUTDOWN half-close flags per spec (ea41173)
  • virtio-vsock: lower credit-update threshold 48 KB → 4 KB (98a591d)
  • virtio-vsock: proactive CREDIT_REQUEST at half-window (e00e97d)
  • virtio-vsock: retry partial writes + bump socketpair SO_SNDBUF (ABX-365) (683d616)
  • virtio: add VIRTIO_F_VERSION_1 to vsock and fs devices (fb831d8)
  • virtio: address P2 review findings — u16 wrapping, EVENT_IDX, backend (e30ce9c)
  • virtio: rewrite VirtioFs process_queue to read from guest memory (35f78fc)
  • virtio: set avail_event in used ring for EVENT_IDX notification (3766428)
  • vm-agent: replace map().unwrap_or() with map_or() on Result (8651caf)
  • vmm: address P0/P1 review findings — overflow, flush ordering, DAX, GSO (106a6ca)
  • vmm: advance PC on unhandled sysreg traps so Linux boot progresses (f2cf0cf)
  • vmm: attach FsServer handler to VirtioFS device for FUSE processing (12cfb16)
  • vmm: bounded-time Vmm::stop() on HV via cancel+unpark loop (ABX-367) (eed7ff0)
  • vmm: complete virtio-net checksum offload in HV TX path (cfed9fe)
  • vmm: correct GIC SPI INTID numbering in FDT + add write barrier (18270c5)
  • vmm: DAX TOCTOU race + checked_sub for all GPA translations (1d7786b)
  • vmm: dispatch pause/resume/snapshot on backend (ABX-360) (4706b9e)
  • vmm: eliminate memory safety UB and harden DAX mapper (8cf4c68)
  • vmm: enable gic feature by default (d16bcb5)
  • vmm: fix GPA-to-offset translation for VirtQueue memory access (e4bad37)
  • vmm: harden VirtIO queue index wrapping, DAX lifecycle, and error checking (ecfb773)
  • vmm: HV Drop order, DAX drain, vCPU registry sequencing (f2ea4f6)
  • vmm: Phase 3 — fix VirtIO MMIO address, initrd placement, reach /init (423688a)
  • vmm: remove double PC advance on HVC exit (9e9d44b)
  • vmm: replace cast suppress with try_from for vsock host_port → RawFd (20c625b)
  • vmm: single OP_REQUEST injection per port, remove debug noise (9056346)
  • vmm: size peer-side SO_RCVBUF on HV network socketpairs (55763d7)
  • vmm: stop_darwin_hv drops worker senders so joins return (ABX-364) (97b8048)
  • vmm: trigger IRQ after vsock OP_REQUEST injection + ephemeral src_port (d71ceb0)
  • vmm: vsock OP_REQUEST injection + IOMMU/DMA address analysis (1d66cff)
  • vmm: XZR register handling + IRQ GSI mapping for ARM64 (279fdc0)
  • vmnet: use XPC dictionary instead of CFDictionary for vmnet_start_interface (7dfb785)
  • vsock: async handshake wait for HV vsock connections (a7f5fbf)
  • vsock: propagate guest OP_SHUTDOWN F_SEND as socketpair SHUT_WR (493ffe9)
  • vsock: remove cross-thread poll_vsock_rx from inject_vsock_connect (ddbb49a)
  • vsock: restore direct OP_REQUEST injection with deferred fallback (fa33c5b)
  • vsock: swallow EINVAL alongside ENOTCONN on F_SEND shutdown (c79121a)
  • vz: three real bugs — start() race, panics on framework probes (11d44a1)

Performance Improvements

  • fs: VirtioFS tuning — adaptive negative cache TTL, cache profiles, READDIRPLUS (ABX-289) (8b28bb2)
  • net-inject: drain each inline conn per pass, cap fairness per conn (86ca055)
  • net-inject: implement VIRTIO_F_EVENT_IDX IRQ suppression (0b29229)
  • net-inject: mergeable RX via readv — 22.7 Gbps Host→VM (19997e1)
  • net: enable MRG_RXBUF + large frames — 10.4 Gbps receiver (436b810)
  • net: increase VZ network MTU from 1500 to 4000 (#198) (d94359d)
  • net: raise rx-inject batch size from 64 to 256 (834a36e)
  • net: raise rx-inject COALESCE_TIMEOUT from 50 µs to 200 µs (a047150)
  • net: TCP fast path — bypass smoltcp for established connections (#203) (bb29e21)
  • net: tune buffer sizes and poll interval for higher throughput (#191) (0469191)
  • net: tune SO_RCVBUF/SO_SNDBUF to 4 MiB on inbound TCP streams (c4a80ac)
  • virtio-net: reuse persistent RX scratch buffer (950d6bb)
  • vmm: I/O request merging with preadv/pwritev (c6ccda3)
  • vmm: increase virtio-net RX queue size from 256 to 1024 (3c64232)
  • vmm: tune net-io backoff and descriptor exhaustion handling (874fbeb)

Reverts

  • disable GSO header fields — guest drops packets (aba44a4)

Code Refactoring

  • agent: sync probe helpers + spawn_blocking for agent readiness (d698472)
  • dax: 128MB per-share DAX window, scales with share count (5ec7993)
  • net: delete smoltcp TCP stack from tcp_bridge + datapath (4237e0a)
  • net: remove smoltcp dependency entirely (1fd1fe5)
  • net: rename SmoltcpDevice → FrameClassifier (663d61a)
  • net: route TCP handshake through shim, retire smoltcp paths (06058a5)
  • Phase 2 — virtio-bindings, PL011 address fix, vm-superio dep (715031a)
  • virtio-blk: split monolithic lib.rs into modules (ea0630d)
  • virtio-console: split monolithic lib.rs into modules (45be3e5)
  • virtio-fs: make protocol module private (a8473d2)
  • virtio-fs: split monolithic lib.rs into modules (5b0c7a3)
  • virtio-net: split monolithic lib.rs into modules (b3f2f3e)
  • virtio-vsock: split monolithic lib.rs into modules (217fdbf)
  • virtio: drop unnecessary pub(crate) on private fields (27d58fa)
  • virtio: extract arcbox-virtio-rng as a per-device crate (2bce171)
  • virtio: extract console + blk crates; move queue to core (42d1e05)
  • virtio: extract foundational types into arcbox-virtio-core (85e14e8)
  • virtio: extract net + fs + vsock crates — pattern-1 split done (63f1b42)
  • virtio: promote GuestMemWriter to arcbox-virtio + add DeviceCtx (5d31a95)
  • virtio: replace hand-written VirtIO constants with virtio-bindings (270c0f7)
  • vmm: extract bridge NIC handlers into device/bridge_nic submodule (83d8ea4)
  • vmm: extract HVC block I/O into darwin_hv/hvc_blk submodule (faca9b9)
  • vmm: extract InlineConnSinkAdapter into its own submodule (7f27873)
  • vmm: extract net worker lifecycle and blk dispatch from DeviceManager (7bccbdd)
  • vmm: extract PSCI handler into darwin_hv/psci submodule (e8118b1)
  • vmm: extract vCPU run loop into darwin_hv/vcpu_loop submodule (98a0c3f)
  • vmm: extract VirtIO MMIO state into device/mmio_state submodule (bcdb8cd)
  • vmm: finish vsock — move vsock_manager + port poll_rx_injection (837fa55)
  • vmm: migrate bridge NIC (TX+RX) onto VirtioNet (1daf66e)
  • vmm: migrate primary NIC TX onto VirtioNet, drop dead methods (72210cf)
  • vmm: split darwin_hv — extract Pl011, GuestRam, network, VcpuContext (bc87f45)
  • vmm: split device.rs — extract checksum finalizer submodule (bd0e4c4)
  • vmm: vsock device owns its connections — drop QueueConfig wart (32835fb)
  • vsock: simplify connect path — pure deferred injection (15b82b4)
  • vz: remove unused FFI constants, struct, and inherent methods (223725c)

Tests

  • core: add hv_e2e example with ping + pause/resume round-trip (ABX-361) (4e16315)
  • core: hv_e2e DAX mount wiring + TempDir fixture hygiene (a2dfc8b)
  • core: wire hv_e2e against real data_dir so guest boots (ABX-361/362) (d98af5c)
  • net: adapt to NetworkDatapath/SmoltcpDevice mtu parameter (acbc728)
  • net: add DHCP full-cycle and frame classification datapath tests (462a2ea)
  • net: add mock guest NIC and frame builder test helpers (d6d68e4)
  • net: assert ARP reply content in frame classification test (0827060)
  • net: drain poll_fast_path with deadline to deprsk CI flake (990b8db)

Documentation

  • add HV backend architecture plan with rust-vmm ecosystem evaluation (5936246)
  • agent: drop stale cache=always reference from DAX mount comment (0481b36)
  • net: diagnostic results rule out multi-queue as the fix (26db0dd)
  • net: host-side profile pinpoints IRQ delivery, not ACK intercept (b961d64)
  • net: record measured perf and multi-flow collapse limit (71f7774)
  • virtio: align ASCII diagram boxes in umbrella crate doc (fa108f1)
  • virtio: fix rustdoc intra-doc link warnings in per-device crates (b82206a)
  • virtio: mark Phase 2.1 CREDIT_REQUEST as landed (1e16503)
  • virtio: mark Phase 2.2 half-close as landed; note deferred richer state enum (76b48a7)
  • virtio: mark Phase 3 complete; scope 3.3 to scratch-reuse fix (ea180f9)
  • virtio: mark Phase 3.1 + 3.2 as landed; lock Phase 3.3 design (31d3da7)
  • virtio: rewrite improvements plan around reasoning, not references (94b95e3)
  • vmm: add SAFETY comments to unsafe blocks in HV backend (bd38511)
  • vmm: tighten DeviceManager module doc + SAFETY block (79a8c3e)

Miscellaneous Chores

  • core: force HV backend until rosetta default is resolved (c658501)
  • fix clippy 1.95 lints workspace-wide (fb7f1ca)
  • net-inject: align Cargo.toml with workspace inheritance (cd9fc68)
  • pin boot assets to v0.5.3 (kernel v0.0.12 with HVC driver) (b496d96)
  • pin boot assets to v0.5.4 (kernel v0.0.13 with FUSE DAX config) (9cf67b8)
  • virtio-net: delete dead SocketBackend; refresh plan status (90b05da)
  • vmm: clean up debug diagnostics, dead code, and stale docs (4d85766)
  • vmm: move legacy code to #[cfg(test)], remove all dead_code suppressions (8f774ae)
  • vmm: relax drained atomic ordering, reword drain_all comment (2a32154)
  • vmm: retire dead vsock inject path, harden DAX/transport lifecycle (eb18284)