Struct opentls::sync_io::TlsAcceptor

pub struct TlsAcceptor(_);

A builder for server-side TLS connections.

Examples

use opentls::{Identity, sync_io::{TlsAcceptor, TlsStream}};
use std::fs::File;
use std::io::Read;
use std::net::{TcpListener, TcpStream};
use std::sync::Arc;
use std::thread;

let mut file = File::open("identity.pfx").unwrap();
let mut identity = vec![];
file.read_to_end(&mut identity).unwrap();
let identity = Identity::from_pkcs12(&identity, "hunter2").unwrap();

let listener = TcpListener::bind("0.0.0.0:8443").unwrap();
let acceptor = TlsAcceptor::new(identity).unwrap();
let acceptor = Arc::new(acceptor);

fn handle_client(stream: TlsStream<TcpStream>) {
    // ...
}

for stream in listener.incoming() {
    match stream {
        Ok(stream) => {
            let acceptor = acceptor.clone();
            thread::spawn(move || {
                let stream = acceptor.accept(stream).unwrap();
                handle_client(stream);
            });
        }
        Err(e) => { /* connection failed */ }
    }
}

Implementations

impl TlsAcceptor

pub fn new(identity: Identity) -> Result<TlsAcceptor>

Creates a acceptor with default settings.

The identity acts as the server's private key/certificate chain.

pub fn builder(identity: Identity) -> TlsAcceptorBuilder

Returns a new builder for a TlsAcceptor.

The identity acts as the server's private key/certificate chain.

pub fn accept<S>(&self, stream: S) -> Result<TlsStream<S>, HandshakeError<S>> where
    S: Read + Write, 

Initiates a TLS handshake.

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.

Trait Implementations

impl Clone for TlsAcceptor

pub fn clone(&self) -> TlsAcceptor

Returns a copy of the value.

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

Performs copy-assignment from source.

impl Debug for TlsAcceptor

pub fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl From<TlsAcceptor> for TlsAcceptor

This is supported on crate features io-tokio or io-async-std only.

pub fn from(inner: TlsAcceptor) -> TlsAcceptor

Performs the conversion.