Struct ConnectorOptions

pub struct ConnectorOptions {
    pub ca_file: Option<String>,
    pub cert_key_file: Option<(String, String)>,
    pub debug_ssl_keylog: bool,
    pub keepalive_pool_size: usize,
    pub offload_threadpool: Option<(usize, usize)>,
    pub bind_to_v4: Vec<SocketAddr>,
    pub bind_to_v6: Vec<SocketAddr>,
}

The options to configure a TransportConnector

Fields

ca_file: Option<String>

Path to the CA file used to validate server certs.

If None, the CA in the default locations will be loaded

cert_key_file: Option<(String, String)>

The default client cert and key to use for mTLS

Each individual connection can use their own cert key to override this.

debug_ssl_keylog: bool

When enabled allows TLS keys to be written to a file specified by the SSLKEYLOG env variable. This can be used by tools like Wireshark to decrypt traffic for debugging purposes.

keepalive_pool_size: usize

How many connections to keepalive

offload_threadpool: Option<(usize, usize)>

Optionally offload the connection establishment to dedicated thread pools

TCP and TLS connection establishment can be CPU intensive. Sometimes such tasks can slow down the entire service, which causes timeouts which leads to more connections which snowballs the issue. Use this option to isolate these CPU intensive tasks from impacting other traffic.

Syntax: (#pools, #thread in each pool)

bind_to_v4: Vec<SocketAddr>

Bind to any of the given source IPv6 addresses

bind_to_v6: Vec<SocketAddr>

Bind to any of the given source IPv4 addresses

Implementations

impl ConnectorOptions

pub fn from_server_conf(server_conf: &ServerConf) -> Self

Derive the ConnectorOptions from a ServerConf

pub fn new(keepalive_pool_size: usize) -> Self

Create a new ConnectorOptions with the given keepalive pool size

Trait Implementations

impl Clone for ConnectorOptions

fn clone(&self) -> ConnectorOptions

Returns a copy of the value.

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

Performs copy-assignment from source.