Skip to main content

ConnectionParams

Struct ConnectionParams 

Source
#[non_exhaustive]
pub struct ConnectionParams<'a> { pub settings: QuicSettings, pub tls_cert: Option<TlsCertificatePaths<'a>>, pub hooks: Hooks, pub session: Option<Vec<u8>>, pub dcid: Option<ConnectionId<'static>>, }
Expand description

Combined configuration parameters required to establish a QUIC connection.

ConnectionParams aggregates the parameters required for all QUIC connections, regardless of whether it’s a client- or server-side connection. To construct them, either ConnectionParams::new_server or ConnectionParams::new_client must be used. The parameters can be modified freely after construction.

Fields (Non-exhaustive)§

This struct is marked as non-exhaustive
Non-exhaustive structs could have additional fields added in future. Therefore, non-exhaustive structs cannot be constructed in external crates using the traditional Struct { .. } syntax; cannot be matched against without a wildcard ..; and struct update syntax will not work.
§settings: QuicSettings

QUIC connection settings.

§tls_cert: Option<TlsCertificatePaths<'a>>

Optional TLS credentials to authenticate with.

§hooks: Hooks

Hooks to use for the connection.

§session: Option<Vec<u8>>

Set the session to attempt resumption.

§dcid: Option<ConnectionId<'static>>

Custom destination connection ID to use for client connections.

Be aware that RFC 9000 places requirements for unpredictability and length on the client DCID field. Setting this field is dangerous if these requirements are not satisfied.

Has no effect on server-side ConnectionParams.

Implementations§

Source§

impl<'a> ConnectionParams<'a>

Source

pub fn new_server( settings: QuicSettings, tls_cert: TlsCertificatePaths<'a>, hooks: Hooks, ) -> Self

Creates ConnectionParams for a QUIC server. Servers should always specify TLS credentials.

Source

pub fn new_client( settings: QuicSettings, tls_cert: Option<TlsCertificatePaths<'a>>, hooks: Hooks, ) -> Self

Creates ConnectionParams for a QUIC client. Clients may enable mTLS by specifying TLS credentials.

Trait Implementations§

Source§

impl Debug for ConnectionParams<'_>

Source§

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

Formats the value using the given formatter. Read more
Source§

impl<'a> Default for ConnectionParams<'a>

Source§

fn default() -> ConnectionParams<'a>

Returns the “default value” for a type. Read more

Auto Trait Implementations§

§

impl<'a> Freeze for ConnectionParams<'a>

§

impl<'a> !RefUnwindSafe for ConnectionParams<'a>

§

impl<'a> Send for ConnectionParams<'a>

§

impl<'a> Sync for ConnectionParams<'a>

§

impl<'a> Unpin for ConnectionParams<'a>

§

impl<'a> UnsafeUnpin for ConnectionParams<'a>

§

impl<'a> !UnwindSafe for ConnectionParams<'a>

Blanket Implementations§

Source§

impl<T> Any for T
where T: 'static + ?Sized,

Source§

fn type_id(&self) -> TypeId

Gets the TypeId of self. Read more
Source§

impl<T> Borrow<T> for T
where T: ?Sized,

Source§

fn borrow(&self) -> &T

Immutably borrows from an owned value. Read more
Source§

impl<T> BorrowMut<T> for T
where T: ?Sized,

Source§

fn borrow_mut(&mut self) -> &mut T

Mutably borrows from an owned value. Read more
Source§

impl<T> From<T> for T

Source§

fn from(t: T) -> T

Returns the argument unchanged.

Source§

impl<T, U> Into<U> for T
where U: From<T>,

Source§

fn into(self) -> U

Calls U::from(self).

That is, this conversion is whatever the implementation of From<T> for U chooses to do.

Source§

impl<T> IntoEither for T

Source§

fn into_either(self, into_left: bool) -> Either<Self, Self>

Converts self into a Left variant of Either<Self, Self> if into_left is true. Converts self into a Right variant of Either<Self, Self> otherwise. Read more
Source§

fn into_either_with<F>(self, into_left: F) -> Either<Self, Self>
where F: FnOnce(&Self) -> bool,

Converts self into a Left variant of Either<Self, Self> if into_left(&self) returns true. Converts self into a Right variant of Either<Self, Self> otherwise. Read more
§

impl<T> Pointable for T

§

const ALIGN: usize

The alignment of pointer.
§

type Init = T

The type for initializers.
§

unsafe fn init(init: <T as Pointable>::Init) -> usize

Initializes a with the given initializer. Read more
§

unsafe fn deref<'a>(ptr: usize) -> &'a T

Dereferences the given pointer. Read more
§

unsafe fn deref_mut<'a>(ptr: usize) -> &'a mut T

Mutably dereferences the given pointer. Read more
§

unsafe fn drop(ptr: usize)

Drops the object pointed to by the given pointer. Read more
Source§

impl<T, U> TryFrom<U> for T
where U: Into<T>,

Source§

type Error = Infallible

The type returned in the event of a conversion error.
Source§

fn try_from(value: U) -> Result<T, <T as TryFrom<U>>::Error>

Performs the conversion.
Source§

impl<T, U> TryInto<U> for T
where U: TryFrom<T>,

Source§

type Error = <U as TryFrom<T>>::Error

The type returned in the event of a conversion error.
Source§

fn try_into(self) -> Result<U, <U as TryFrom<T>>::Error>

Performs the conversion.
§

impl<V, T> VZip<V> for T
where V: MultiLane<T>,

§

fn vzip(self) -> V