tokio-rustls/README.md
Brian Smith 22fbb7497f Merge std-client.rs into client.rs to unbreak Windows build.
The Windows build is failing because client.rs doesn't define main
on non-Unixy platforms because of its `#![cfg(unix)]`. Merge
std-client.rs into client.rs to solve this and to reduce redundancy.
Continue using blocking stdin/stdout I/O on non-Unixy platforms until
we get nonblocking stdin/stdout working on those platforms.
2017-03-30 10:46:34 -10:00

1.7 KiB

tokio-rustls

crates license license docs.rs

Asynchronous TLS/SSL streams for Tokio using Rustls.

Basic Structure of a Client

// ...

use rustls::ClientConfig;
use tokio_rustls::ClientConfigExt;

let mut config = ClientConfig::new();
config.root_store.add_trust_anchors(&webpki_roots::ROOTS);
let config = Arc::new(config);

TcpStream::connect(&addr, &handle)
	.and_then(|socket| config.connect_async("www.rust-lang.org", socket))

// ...

Client Example Program

See examples/client.rs. You can run it with:

cargo run --example client hsts.badssl.com

Currently on Windows the example client reads from stdin and writes to stdout using blocking I/O. Until this is fixed, do something this on Windows:

echo | cargo run --example client hsts.badssl.com

Server Example Program

See examples/server.rs. You can run it with:

cargo run --example server -- 127.0.0.1 --cert mycert.der --key mykey.der

License & Origin

tokio-rustls is primarily distributed under the terms of both the MIT license and the Apache License (Version 2.0), with portions covered by various BSD-like licenses.

This started as a fork of tokio-tls.