Crate microsandbox_network 

Network configuration models and the optional host networking engine.

The model tree is always available for SDK-side configuration. The engine feature adds packet processing, relays, DNS forwarding, policy enforcement, TLS interception, and port publishing for the msb runtime.

Re-exports

pub use proxy::OutboundProxy;

pub use proxy::OutboundProxyBuildError;

pub use proxy::OutboundProxyBuilder;

pub use proxy::OutboundProxyParseError;

pub use proxy::OutboundProxyProtocol;

pub use proxy::Socks4ProxyBuilder;

pub use proxy::Socks5Credentials;

pub use proxy::Socks5ProxyBuilder;

Modules

backend

SmoltcpBackend — libkrun NetBackend implementation that bridges the NetWorker thread to the smoltcp poll thread via lock-free queues.

builder

Fluent builder API for NetworkConfig.

config

Network configuration types and fluent builders.

conn

Connection tracker: manages smoltcp TCP sockets for the poll loop.

device

Slot-based smoltcp::phy::Device implementation.

dns

DNS configuration contracts and engine implementation facade.

icmp

ICMP error construction and host-side echo relay.

icmp_error

Synthetic ICMP error frame construction for relay-owned IP edge behavior.

icmp_relay

External ICMP echo-only relay: host probe + reply frame synthesis.

netstack

Low-level packet processing and smoltcp integration.

network

SmoltcpNetwork — orchestration type that ties crate::config::NetworkConfig to the smoltcp engine.

policy

Network policy model and rule matching.

ports

Host-to-guest port publishing.

proxy

Outbound proxy configuration and transport implementations.

publisher

Published port handling: host-side listeners that forward connections into the guest VM via smoltcp.

secrets

Placeholder-based secret injection for TLS-intercepted connections.

shared

Shared state between the NetWorker thread, smoltcp poll thread, and tokio proxy tasks.

stack

smoltcp interface setup, frame classification, and poll loop.

tcp

TCP connection tracking, proxying, and host-side upstream dialing.

tls

TLS configuration models and optional engine state.

udp

UDP fragment reassembly and host-side datagram relay.

udp_fragments

Bounded IPv4 UDP fragment reassembly for the userspace UDP relay.

udp_relay

Non-DNS UDP relay: handles UDP traffic outside smoltcp.