Struct udp_dtls::DtlsConnector

pub struct DtlsConnector { /* fields omitted */ }

A builder for client-side DTLS-connections.

Methods

impl DtlsConnector

pub fn new(builder: &DtlsConnectorBuilder) -> Result<DtlsConnector, Error>

Creates a new DtlsConnector.

The DtlsConnector will use the settings from the given builder.

The following propperties will be applied from the builder:

• Sets minimal/maximal protocol version
• Sets srtp profile by enabling the DTLS extension 'use_srtp'
• Sets the certificate and private key
• Adds the root certificates to the certificate store.

pub fn builder() -> DtlsConnectorBuilder

Returns a new builder for a DtlsConnector from which you can create the DtlsConnector.

pub fn connect<S>(
    &self,
    domain: &str,
    stream: S
) -> Result<DtlsStream<S>, HandshakeError<S>> where
    S: Read + Write, 

Initiates a DTLS handshake.

The provided domain will be used for both SNI and certificate hostname validation.

If the socket is nonblocking and a WouldBlock error is returned during the handshake, a HandshakeError::WouldBlock error will be returned which can be used to restart the handshake when the socket is ready again.

The domain is ignored if both SNI and hostname verification are disabled.

Trait Implementations

impl Clone for DtlsConnector

fn clone(&self) -> DtlsConnector

Returns a copy of the value.

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

Performs copy-assignment from source.