Struct Session 

pub struct Session<S> { /* private fields */ }

An established binary session. Construction completes both offers and both acceptance bytes before application operations may be sent or received.

Implementations

impl<S: Read + Write> Session<S>

pub fn connect(io: S, offer: &Hello) -> Result<Self>

Connect on an explicitly advertised v2 endpoint. The caller sets a single establishment deadline and verifies the peer before sending the offer.

pub fn accept(io: S, offer: &Hello) -> Result<Self>

Admit a connection on the separate v2 listener, after authenticating its OS peer. No request is dispatched if either peer rejects the negotiation.

pub fn refuse(io: S, offer: &Hello, reason: Refused) -> Result<()>

Read a client’s offer and refuse it for reason, then close the connection. Use it for a peer the policy rejected, or while retiring. A client that does not read refusals, or that names another service, sees only the close, as from an older server.

pub fn transport_mut(&mut self) -> &mut S

Access the transport to change I/O deadlines after establishment. Do not read or write protocol bytes through this reference.

pub fn agreement(&self) -> Agreement

Negotiated version, capabilities and frame bound.

pub fn send(&mut self, message: &Control) -> Result<()>

Send a negotiated operation. An I/O failure has an uncertain outcome; reconnecting must not replay it automatically.

pub fn receive(&mut self) -> Result<Control>

Receive a negotiated operation. Unknown operations terminate the session; unknown optional fields within known operations remain compatible.