Struct ClientConfig 

#[non_exhaustive]
pub struct ClientConfig { /* private fields */ }

Available on crate features quic and std only.

Configuration for outgoing connections

Default values should be suitable for most internet applications.

Implementations

impl ClientConfig

pub fn with_preferred_address_policy( self, policy: PreferredAddressPolicy, ) -> ClientConfig

What to do with the address a server advertises as preferred (RFC 9000 §9.6).

Defaults to PreferredAddressPolicy::Migrate: the address advertised for the family in use is probed once the handshake is confirmed, and the connection moves there with the connection ID the server bound to it as soon as a probe is answered.

pub fn set_preferred_address_policy( &mut self, policy: PreferredAddressPolicy, ) -> &mut ClientConfig

What to do with the address a server advertises as preferred (RFC 9000 §9.6).

Defaults to PreferredAddressPolicy::Migrate: the address advertised for the family in use is probed once the handshake is confirmed, and the connection moves there with the connection ID the server bound to it as soon as a probe is answered.

pub fn with_transport_config( self, transport: Arc<TransportConfig>, ) -> ClientConfig

Set a custom TransportConfig

pub fn set_transport_config( &mut self, transport: Arc<TransportConfig>, ) -> &mut ClientConfig

Set a custom TransportConfig

pub fn with_token_store(self, store: Arc<dyn TokenStore>) -> ClientConfig

Set a custom TokenStore

Defaults to TokenMemoryCache, which is suitable for most internet applications.

pub fn set_token_store( &mut self, store: Arc<dyn TokenStore>, ) -> &mut ClientConfig

Set a custom TokenStore

Defaults to TokenMemoryCache, which is suitable for most internet applications.

pub fn with_version(self, version: u32) -> ClientConfig

Set the QUIC version to use

pub fn set_version(&mut self, version: u32) -> &mut ClientConfig

Set the QUIC version to use

impl ClientConfig

pub fn try_from_rama_tls( config: &TlsClientConfig, options: TlsOptions, ) -> Result<ClientConfig, TlsConfigError>

Available on crate feature rustls and (crate features aws-lc or ring) only.

Build a client configuration from the common Rama TLS client configuration: the peer identity to trust, the protocols to offer and everything else TLS decides, with the provider chosen by this crate’s features.

The destination address is not part of it. A connection is made to an address with Endpoint::connect_with, and the identity it must prove comes from here and from the server name given there.

Trait Implementations

impl Clone for ClientConfig

fn clone(&self) -> ClientConfig

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for ClientConfig

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

Formats the value using the given formatter.