Struct sctp_proto::Association

pub struct Association { /* fields omitted */ }

Association represents an SCTP association

Implementations

impl Association

pub fn poll_event(&mut self) -> Option<Event>

Returns application-facing event

Connections should be polled for events after:

• a call was made to handle_transmit
• a call was made to handle_timeout

pub fn poll_endpoint_event(&mut self) -> Option<EndpointEvent>

Return endpoint-facing event

pub fn poll_timeout(&mut self) -> Option<Instant>

Returns the next time at which handle_timeout should be called

The value returned may change after:

• the application performed some I/O on the connection
• a call was made to handle_transmit
• a call to poll_transmit returned Some
• a call was made to handle_timeout

pub fn poll_transmit(&mut self, now: Instant) -> Option<Transmit>

Returns packets to transmit

Associations should be polled for transmit after:

• the application performed some I/O on the Association
• a call was made to handle_event
• a call was made to handle_timeout

pub fn handle_timeout(&mut self, now: Instant)

Process timer expirations

Executes protocol logic, potentially preparing signals (including application Events, EndpointEvents and outgoing datagrams) that should be extracted through the relevant methods.

It is most efficient to call this immediately after the system clock reaches the latest Instant that was output by poll_timeout; however spurious extra calls will simply no-op and therefore are safe.

pub fn handle_transmit(&mut self, transmit: Transmit)

Process AssociationEvents generated by the associated Endpoint

Will execute protocol logic upon receipt of an association event, in turn preparing signals (including application Events, EndpointEvents and outgoing datagrams) that should be extracted through the relevant methods.

pub fn stats(&self) -> AssociationStats

Returns Association statistics

pub fn is_handshaking(&self) -> bool

Whether the Association is in the process of being established

If this returns false, the Association may be either established or closed, signaled by the emission of a Connected or ConnectionLost message respectively.

pub fn is_closed(&self) -> bool

Whether the Association is closed

Closed Associations cannot transport any further data. A connection becomes closed when either peer application intentionally closes it, or when either transport layer detects an error such as a time-out or certificate validation failure.

A ConnectionLost event is emitted with details when the connection becomes closed.

pub fn side(&self) -> Side

Look up whether we’re the client or server of this Association

pub fn remote_address(&self) -> SocketAddr

The latest socket address for this Association’s peer

pub fn rtt(&self) -> Duration

Current best estimate of this Association’s latency (round-trip-time)

pub fn local_ip(&self) -> Option<IpAddr>

The local IP address which was used when the peer established the connection

This can be different from the address the endpoint is bound to, in case the endpoint is bound to a wildcard address like 0.0.0.0 or ::.

This will return None for clients.

Retrieving the local IP address is currently supported on the following platforms:

• Linux

On all non-supported platforms the local IP address will not be available, and the method will return None.

pub fn shutdown(&mut self) -> Result<(), Error>

Shutdown initiates the shutdown sequence. The method blocks until the shutdown sequence is completed and the connection is closed, or until the passed context is done, in which case the context’s error is returned.

pub fn close(&mut self) -> Result<(), Error>

Close ends the SCTP Association and cleans up any state

Trait Implementations

impl Debug for Association

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

Formats the value using the given formatter.

impl Default for Association

fn default() -> Self

Returns the “default value” for a type.