arcbox-vmnet 0.4.22

Safe Rust bindings for Apple's vmnet.framework

Coverage
100%
1 out of 1 items documented0 out of 0 items with examples
Size
Source code size: 85.93 kB This is the summed size of all the files inside the crates.io package for this release.
Documentation size: 239.69 kB This is the summed size of all files generated by rustdoc for all configured targets
Ø build duration
this release: 2s Average build duration of successful builds.
all releases: 4s Average build duration of successful builds in releases after 2024-10-23.
Links
arcboxlabs/arcbox
278 11 30
crates.io
Dependencies
Versions
Owners

Safe Rust bindings for Apple's vmnet.framework.

This crate exposes:

Low-level FFI declarations for vmnet, Core Foundation, GCD dispatch, XPC, and the Objective-C block ABI required by vmnet_start_interface.
A high-level [Vmnet] interface for creating shared (NAT), host-only, and bridged virtual network interfaces.
A [VmnetRelay] that bridges vmnet's blocking read/write API to a socketpair consumed by VZFileHandleNetworkDeviceAttachment.

Operating modes

Shared (NAT) — VMs share the host's network connection via NAT, with vmnet providing DHCP and DNS.
Host-only — Isolated network between VMs and host, optionally with per-interface isolation via UUID.
Bridged — VMs appear as separate L2 devices on a physical network.

Requirements

macOS 11.0 or later.
The com.apple.vm.networking entitlement, or root, is required to start a vmnet interface.

Feature flags

vmnet — Enable the proper Objective-C completion-handler ABI for vmnet_start_interface. Without it, the interface starts with a NULL handler and falls back to default packet-size / generated MAC.