Skip to main content

Module lazy_uds

Module lazy_uds 

Source
Expand description

Lazy-connecting UDS RPC transport (same-host ipc plane).

Mirrors LazyQuinnTransport and LazyIrohTransport: the dial factory is synchronous, so this holds the socket path and connects on the first send(), caching the session — preserving sync, zero-I/O construction.

The connection is a UdsSession on the RPC plane (PLANE_RPC), wrapped as a SessionRpcTransport — the same generic client used by the quinn and iroh backends, so the ipc plane carries the identical Cap’n Proto bidi wire protocol with no transport-specific RPC code. This is the post-ZMQ ipc transport: same-host processes keep ipc, re-platformed off ZMQ framing onto SignedEnvelope-over-UDS.

§Identity

UDS has no transport-level peer identity; same-host trust + the app-layer SignedEnvelope (verified against the response key) are the authentication. Socket-file permissions + SO_PEERCRED are defense-in-depth owned by the daemon that binds the listener (see #207). A None server_verifying_key leaves the response identity unpinned (the envelope sig is still verified), matching the quinn arm.

Re-dial/self-heal semantics match the other lazy transports: a per-request timeout keeps the session; a transport-fatal error drops it so the next call re-dials.

Structs§

LazyUdsTransport
A UDS RPC transport that connects on first use and caches the session.