Struct tuic_quinn::Connection

pub struct Connection<Side> { /* private fields */ }

The TUIC Connection.

This struct takes a clone of quinn::Connection for performing TUIC operations.

See more details about the TUIC protocol at SPEC.md

Implementations

impl<Side> Connection<Side>

pub fn packet_native( &self, pkt: impl AsRef<[u8]>, addr: Address, assoc_id: u16 ) -> Result<(), Error>

Sends a Packet using UDP relay mode native.

pub async fn packet_quic( &self, pkt: impl AsRef<[u8]>, addr: Address, assoc_id: u16 ) -> Result<(), Error>

Sends a Packet using UDP relay mode quic.

pub fn task_connect_count(&self) -> usize

Returns the number of Connect tasks

pub fn task_associate_count(&self) -> usize

Returns the number of active UDP sessions

pub fn collect_garbage(&self, timeout: Duration)

Removes packet fragments that can not be reassembled within the specified timeout

impl Connection<Client>

pub fn new(conn: QuinnConnection) -> Self

Creates a new client side Connection.

pub async fn authenticate( &self, uuid: Uuid, password: impl AsRef<[u8]> ) -> Result<(), Error>

Sends an Authenticate command.

pub async fn connect(&self, addr: Address) -> Result<Connect, Error>

Sends a Connect command.

pub async fn dissociate(&self, assoc_id: u16) -> Result<(), Error>

Sends a Dissociate command.

pub async fn heartbeat(&self) -> Result<(), Error>

Sends a Heartbeat command.

pub async fn accept_uni_stream(&self, recv: RecvStream) -> Result<Task, Error>

Try to parse a quinn::RecvStream as a TUIC command.

The quinn::RecvStream should be accepted by quinn::Connection::accept_uni() from the same quinn::Connection.

pub async fn accept_bi_stream( &self, send: SendStream, recv: RecvStream ) -> Result<Task, Error>

Try to parse a pair of quinn::SendStream and quinn::RecvStream as a TUIC command.

The pair of stream should be accepted by quinn::Connection::accept_bi() from the same quinn::Connection.

pub fn accept_datagram(&self, dg: Bytes) -> Result<Task, Error>

Try to parse a QUIC Datagram as a TUIC command.

The Datagram should be accepted by quinn::Connection::read_datagram() from the same quinn::Connection.

impl Connection<Server>

pub fn new(conn: QuinnConnection) -> Self

Creates a new server side Connection.

pub async fn accept_uni_stream(&self, recv: RecvStream) -> Result<Task, Error>

Try to parse a quinn::RecvStream as a TUIC command.

The quinn::RecvStream should be accepted by quinn::Connection::accept_uni() from the same quinn::Connection.

pub async fn accept_bi_stream( &self, send: SendStream, recv: RecvStream ) -> Result<Task, Error>

Try to parse a pair of quinn::SendStream and quinn::RecvStream as a TUIC command.

The pair of stream should be accepted by quinn::Connection::accept_bi() from the same quinn::Connection.

pub fn accept_datagram(&self, dg: Bytes) -> Result<Task, Error>

Try to parse a QUIC Datagram as a TUIC command.

The Datagram should be accepted by quinn::Connection::read_datagram() from the same quinn::Connection.

Trait Implementations

impl<Side: Clone> Clone for Connection<Side>

fn clone(&self) -> Connection<Side>

Returns a copy of the value.

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

Performs copy-assignment from source.

impl<Side> Debug for Connection<Side>

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

Formats the value using the given formatter.