Struct TcpSession 

pub struct TcpSession { /* private fields */ }

Implementations

impl TcpSession

pub fn upgrade(&mut self) -> bool

pub fn test_back_socket(&mut self) -> bool

pub fn cancel_timeouts(&mut self)

Trait Implementations

impl ProxySession for TcpSession

fn targets(&self, target: &SessionTarget) -> bool

A TCP session is targeted by the backend it dialled last.

fn close(&mut self)

close a session, frontend and backend sockets, remove the entries from the session manager slab

fn timeout(&mut self, token: Token) -> bool

if a timeout associated with the session triggers, the event loop will call this method with the timeout’s token

fn protocol(&self) -> Protocol

indicates the protocol associated with the session

fn update_readiness(&mut self, token: Token, events: Ready)

if the event loop got an event for a token associated with the session, it will call this method on the session

fn ready(&mut self, session: Rc<RefCell<dyn ProxySession>>) -> bool

if a session received an event or can still execute, the event loop will call this method. Its result indicates if it can still execute, needs to connect to a backend server, close the session

fn shutting_down(&mut self) -> bool

tell the session it has to shut down if possible

fn last_event(&self) -> Instant

last time the session got an event

fn print_session(&self)

display the session’s internal state (for debugging purpose)

fn frontend_token(&self) -> Token

get the token associated with the frontend

fn cluster_id(&self) -> Option<ClusterId>

Best-effort identifier of the cluster currently routed to by this session. Returns None for ListenSession (no per-session cluster), and for client sessions before routing has resolved. H2 sessions multiplex many streams over one frontend token and may touch several clusters; the returned value is whichever cluster the session most recently keep-alive’d to. Used for log/metric attribution, not for accounting (the tracker keeps the canonical per-stream (cluster, IP) set).

fn session_address(&self) -> Option<SocketAddr>

Source address as observed by Sōzu, with proxy-protocol awareness. HTTP/HTTPS/TCP client sessions return the parsed PROXY-protocol source when present, else peer_addr. ListenSession returns None. Used to attribute per-(cluster, source-IP) tracking and access logs to the real client behind a layer-4 PROXY frontend.

fn needs_ready_pass(&self) -> bool

Whether the session has work that only a Self::ready pass can do although no socket event will arrive to trigger one.

fn yielded(&mut self) -> bool

Whether the last Self::ready pass stopped at its iteration budget while still forwarding bytes, with work left that no socket event will announce again. Reading it clears it.