Crate tokio_libtls

Async Tls bindings for libtls.

See also libtls for more information.

Note, the API for this crate is neither finished nor documented yet.

Example

use std::io;
use tokio::io::{AsyncReadExt, AsyncWriteExt};
use tokio_libtls::prelude::{connect, Builder};

async fn async_https_connect(servername: String) -> io::Result<()> {
    let request = format!(
        "GET / HTTP/1.1\r\n\
         Host: {}\r\n\
         Connection: close\r\n\r\n",
        servername
    );

    let config = Builder::new().build()?;
    let mut tls = connect(&(servername + ":443"), &config, None).await?;
    tls.write_all(request.as_bytes()).await?;

    let mut buf = vec![0u8; 1024];
    tls.read_exact(&mut buf).await?;

    let ok = b"HTTP/1.1 200 OK\r\n";
    assert_eq!(&buf[..ok.len()], ok);

    Ok(())
}

Modules

error	Error handling.
prelude	A "prelude" for crates using the tokio-libtls crate.

Structs

AsyncTls	Async Tls struct.
Options	Configuration options for AsyncTls.
TlsStream	Wrapper for async I/O operations with Tls.

Functions

accept	Accept a new async Tls connection.
accept_stream	Accept a new async Tls connection on an established client connection.
connect	Connect a new async Tls connection.
connect_stream	Upgrade a TCP stream to a new async Tls connection.

Type Definitions

AsyncTlsOptions	Deprecated Configuration options for AsyncTls.
AsyncTlsStream	Pollable wrapper for async I/O operations with Tls.