Struct ConnectBackendRequest 

pub struct ConnectBackendRequest<'a> {
    pub broker_endpoint: &'a str,
    pub service_name: &'a str,
    pub wanted_version: &'a str,
    pub self_version: &'a str,
    pub cached_backend_endpoint: Option<&'a str>,
    pub client_version: &'a str,
    pub client_lib_name: &'a str,
    pub client_lib_version: &'a str,
    pub client_keepalive_secs: u64,
    pub adopt_handed_off_connection: bool,
    pub handoff_ready_timeout: Duration,
}

Inputs for connect_to_backend.

Fields

broker_endpoint: &'a str

Broker pipe/socket endpoint.

service_name: &'a str

Logical service name, such as zccache.

wanted_version: &'a str

Backend version the caller wants.

self_version: &'a str

Version of the caller’s own service binary.

cached_backend_endpoint: Option<&'a str>

Previously negotiated backend endpoint, if the caller has one.

client_version: &'a str

Informational client version.

client_lib_name: &'a str

Client library name for diagnostics.

client_lib_version: &'a str

Client library version for diagnostics.

client_keepalive_secs: u64

Proposed keepalive interval.

adopt_handed_off_connection: bool

Opt in to adopting a handed-off backend connection (#354, slice 7).

Default false: the client always reconnects to Negotiated.backend_pipe, exactly as before. When true AND the broker negotiated CAP_HANDLE_PASSING AND issued a non-empty Negotiated.handle_passed_token, the client waits up to Self::handoff_ready_timeout for the broker’s handoff-ready relay (an EVENT frame under the 0xD0FF handoff payload protocol carrying the backend’s HandoffAck) on the SAME broker connection. On a valid accepted relay with a matching token echo, the client keeps that connection as the backend connection (BackendConnectionRoute::HandlePassed). Any failure — missing relay, timeout, refused or malformed ACK, token mismatch — silently downgrades to the backend_pipe reconnect; adoption failure is never an error by itself.

handoff_ready_timeout: Duration

Deadline for the handoff-ready relay when Self::adopt_handed_off_connection is set.

Implementations

impl<'a> ConnectBackendRequest<'a>

pub fn new( broker_endpoint: &'a str, service_name: &'a str, wanted_version: &'a str, self_version: &'a str, ) -> Self

Build a request with running-process defaults.

Trait Implementations

impl<'a> Clone for ConnectBackendRequest<'a>

fn clone(&self) -> ConnectBackendRequest<'a>

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl<'a> Debug for ConnectBackendRequest<'a>

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

Formats the value using the given formatter.