Enum ConnectionAddr

pub enum ConnectionAddr {
    Tcp(String, u16),
    TcpTls {
        host: String,
        port: u16,
        insecure: bool,
        tls_params: Option<TlsConnParams>,
    },
    Unix(PathBuf),
}

Defines the connection address.

Not all connection addresses are supported on all platforms. For instance to connect to a unix socket you need to run this on an operating system that supports them.

Variants

Tcp(String, u16)

Format for this is (host, port).

TcpTls

Format for this is (host, port).

Fields

host: String

Hostname

port: u16

Port

insecure: bool

Disable hostname verification when connecting.

Warning

You should think very carefully before you use this method. If hostname verification is not used, any valid certificate for any site will be trusted for use from any other. This introduces a significant vulnerability to man-in-the-middle attacks.

tls_params: Option<TlsConnParams>

TLS certificates and client key.

Unix(PathBuf)

Format for this is the path to the unix socket.

Implementations

impl ConnectionAddr

pub fn is_supported(&self) -> bool

Checks if this address is supported.

Because not all platforms support all connection addresses this is a quick way to figure out if a connection method is supported. Currently this affects:

• Unix socket addresses, which are supported only on Unix

• TLS addresses, which are supported only if a TLS feature is enabled (either tls-native-tls or tls-rustls).

pub fn set_danger_accept_invalid_hostnames(&mut self, insecure: bool)

Configure this address to connect without checking certificate hostnames.

Warning

You should think very carefully before you use this method. If hostname verification is not used, any valid certificate for any site will be trusted for use from any other. This introduces a significant vulnerability to man-in-the-middle attacks.

Trait Implementations

impl Clone for ConnectionAddr

fn clone(&self) -> ConnectionAddr

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for ConnectionAddr

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

Formats the value using the given formatter.

impl Display for ConnectionAddr

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

Formats the value using the given formatter.

impl PartialEq for ConnectionAddr

fn eq(&self, other: &Self) -> bool

Tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl Eq for ConnectionAddr