# tokio-rustls
[](https://crates.io/crates/tokio-rustls) [](https://github.com/quininer/tokio-rustls/blob/master/LICENSE-MIT) [](https://github.com/quininer/tokio-rustls/blob/master/LICENSE-APACHE) [](https://docs.rs/tokio-rustls/)
Asynchronous TLS/SSL streams for [Tokio](https://tokio.rs/) using
[Rustls](https://github.com/ctz/rustls).
### Basic Structure of a Client
```rust
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](examples/client.rs). You can run it with:
```sh
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:
```sh
### Server Example Program
See [examples/server.rs](examples/server.rs). You can run it with:
```sh
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](LICENSE-MIT) and
the [Apache License (Version 2.0)](LICENSE-APACHE), with portions covered by various BSD-like
licenses.
This started as a fork of [tokio-tls](https://github.com/tokio-rs/tokio-tls).