Struct drogue_tls::TlsConnection

pub struct TlsConnection<'a, RNG, Socket, CipherSuite> where
    RNG: CryptoRng + RngCore + 'static,
    Socket: AsyncRead + AsyncWrite + 'a,
    CipherSuite: TlsCipherSuite + 'static,  { /* fields omitted */ }

Type representing an async TLS connection. An instance of this type can be used to establish a TLS connection, write and read encrypted data over this connection, and closing to free up the underlying resources.

Implementations

impl<'a, RNG, Socket, CipherSuite> TlsConnection<'a, RNG, Socket, CipherSuite> where
    RNG: CryptoRng + RngCore + 'static,
    Socket: AsyncRead + AsyncWrite + 'a,
    CipherSuite: TlsCipherSuite + 'static, 

pub fn new(context: TlsContext<'a, CipherSuite, RNG>, delegate: Socket) -> Self

Create a new TLS connection with the provided context and a async I/O implementation

pub async fn open<'m>(&mut self) -> Result<(), TlsError> where
    'a: 'm, 

Open a TLS connection, performing the handshake with the configuration provided when creating the connection instance.

Returns an error if the handshake does not proceed. If an error occurs, the connection instance must be recreated.

pub async fn write(&mut self, buf: &[u8]) -> Result<usize, TlsError>

Encrypt and send the provided slice over the connection. The connection must be opened before writing.

Returns the number of bytes written.

pub async fn read(&mut self, buf: &mut [u8]) -> Result<usize, TlsError>

Read and decrypt data filling the provided slice. The slice must be able to keep the expected amount of data that can be received in one record to avoid loosing data.

pub async fn close(
    self
) -> Result<(TlsContext<'a, CipherSuite, RNG>, Socket), TlsError>

Close a connection instance, returning the ownership of the config, random generator and the async I/O provider.