Struct Config 

#[non_exhaustive]
pub struct Config {
    pub peer: SocketAddr,
    pub server_name: String,
    pub alpn: Vec<String>,
    pub verify: bool,
    pub roots: Vec<PathBuf>,
    pub system_roots: bool,
    pub identity: Option<Identity>,
    pub transport: Transport,
}

Where to dial, as whom, and who to trust.

Fields (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.

peer: SocketAddr

The address to dial.

server_name: String

The name sent as SNI and verified against the server’s certificate.

alpn: Vec<String>

ALPN protocols to offer, in preference order. Required: QUIC without an application protocol is refused.

verify: bool

Verify the server’s certificate against the roots below (default). Turn it off only for tests or a pinned local deployment.

roots: Vec<PathBuf>

PEM root certificate files to trust, on top of the system store.

system_roots: bool

Trust the platform’s root store as well, on by default. Turn it off to trust only roots, which is a real restriction here: the trust store is built from scratch rather than added to.

identity: Option<Identity>

A certificate to present when the server asks for one (mTLS).

transport: Transport

The per-connection transport settings (timeouts, stream limits, congestion control).

Implementations

impl Config

pub fn new(peer: SocketAddr, server_name: impl Into<String>) -> Self

Dial peer, verifying it as server_name, with default settings.

Trait Implementations

impl Clone for Config

fn clone(&self) -> Self

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for Config

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

Formats the value using the given formatter.