Struct HostVsockBackend 

pub struct HostVsockBackend { /* private fields */ }

Host-side vsock backend for the HV (Hypervisor.framework) backend.

Accepts connections from the guest and forwards them to host-side Unix domain sockets. Each guest port is mapped to a Unix socket path on the host; when the guest opens a connection the backend connects to the corresponding socket and relays data bidirectionally.

This is the primary backend used for arcbox-agent RPC communication on macOS.

Implementations

impl HostVsockBackend

pub fn new() -> Self

Creates a new host vsock backend with no port mappings.

pub fn add_port_mapping(&mut self, port: u32, socket_path: String)

Registers a mapping from guest vsock port to a host-side Unix socket path.

When the guest opens a connection to port, the backend will connect to socket_path on the host and relay traffic.

pub fn with_port_map(port_map: HashMap<u32, String>) -> Self

Creates a backend with pre-configured port mappings.

Trait Implementations

impl Debug for HostVsockBackend

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Default for HostVsockBackend

fn default() -> Self

Returns the “default value” for a type.

impl VsockBackend for HostVsockBackend

fn on_connect(&mut self, addr: VsockAddr) -> Result<()>

Called when guest requests a connection.

fn on_send(&mut self, addr: VsockAddr, data: &[u8]) -> Result<usize>

Called when guest sends data.

fn on_recv(&mut self, addr: VsockAddr, buf: &mut [u8]) -> Result<usize>

Called when guest requests data.

fn on_close(&mut self, addr: VsockAddr) -> Result<()>

Called when guest closes connection.

fn has_pending_data(&self, addr: VsockAddr) -> bool

Checks if there’s pending data for a connection.