Struct DnsProxyHandle 

pub struct DnsProxyHandle {
    pub shutdown: Arc<AtomicBool>,
    pub listen_addr: SocketAddr,
    pub thread: Option<JoinHandle<DnsProxyStats>>,
    pub upstream_resolver_id: String,
}

Shutdown coordination handle returned by spawn_proxy_in_netns (Linux) — held by the supervisor and signalled at cell destroy time.

On non-Linux platforms the supervisor never constructs one of these; the activation predicate evaluator simply returns None.

Fields

shutdown: Arc<AtomicBool>

Shared shutdown flag. Setting true signals the proxy loop to exit at its next iteration (within LISTENER_READ_TIMEOUT worst case).

listen_addr: SocketAddr

The address the proxy listener is bound to inside the cell’s netns. Used by signal_proxy_shutdown to wake the recv loop.

thread: Option<JoinHandle<DnsProxyStats>>

Join handle for the proxy OS thread. Some until join() consumes it.

upstream_resolver_id: String

Resolver id stamped into events; retained for diagnostics.

Implementations

impl DnsProxyHandle

pub fn join(&mut self) -> Option<DnsProxyStats>

Signal the proxy to stop and join the OS thread. Returns the cumulative DnsProxyStats when the thread exited cleanly, or None if the thread had already been joined or panicked.

Caller must already have set self.shutdown to true and called signal_proxy_shutdown (or otherwise woken the recv loop). Calling this without waking the loop will block for up to LISTENER_READ_TIMEOUT — bounded but not instant.