Struct rustls::server::Acceptor

source ·
pub struct Acceptor { /* private fields */ }
Expand description

Handle a server-side connection before configuration is available.

Acceptor allows the caller to choose a ServerConfig after reading the super::ClientHello of an incoming connection. This is useful for servers that choose different certificates or cipher suites based on the characteristics of the ClientHello. In particular it is useful for servers that need to do some I/O to load a certificate and its private key and don’t want to use the blocking interface provided by super::ResolvesServerCert.

Create an Acceptor with Acceptor::default().

§Example

use rustls::server::{Acceptor, ServerConfig};
let listener = std::net::TcpListener::bind("127.0.0.1:0").unwrap();
for stream in listener.incoming() {
    let mut stream = stream.unwrap();
    let mut acceptor = Acceptor::default();
    let accepted = loop {
        acceptor.read_tls(&mut stream).unwrap();
        if let Some(accepted) = acceptor.accept().unwrap() {
            break accepted;
        }
    };

    // For some user-defined choose_server_config:
    let config = choose_server_config(accepted.client_hello());
    let conn = accepted
        .into_connection(config)
        .unwrap();
    // Proceed with handling the ServerConnection.
}

Implementations§

source§

impl Acceptor

source

pub fn read_tls(&mut self, rd: &mut dyn Read) -> Result<usize, Error>

Read TLS content from rd.

Returns an error if this Acceptor has already yielded an Accepted. For more details, refer to Connection::read_tls().

source

pub fn accept(&mut self) -> Result<Option<Accepted>, (Error, AcceptedAlert)>

Check if a ClientHello message has been received.

Returns Ok(None) if the complete ClientHello has not yet been received. Do more I/O and then call this function again.

Returns Ok(Some(accepted)) if the connection has been accepted. Call accepted.into_connection() to continue. Do not call this function again.

Returns Err((err, alert)) if an error occurred. If an alert is returned, the application should call alert.write() to send the alert to the client. It should not call accept() again.

Trait Implementations§

source§

impl Default for Acceptor

source§

fn default() -> Self

Return an empty Acceptor, ready to receive bytes from a new client connection.

Auto Trait Implementations§

Blanket Implementations§

source§

impl<T> Any for T
where T: 'static + ?Sized,

source§

fn type_id(&self) -> TypeId

Gets the TypeId of self. Read more
source§

impl<T> Borrow<T> for T
where T: ?Sized,

source§

fn borrow(&self) -> &T

Immutably borrows from an owned value. Read more
source§

impl<T> BorrowMut<T> for T
where T: ?Sized,

source§

fn borrow_mut(&mut self) -> &mut T

Mutably borrows from an owned value. Read more
source§

impl<T> From<T> for T

source§

fn from(t: T) -> T

Returns the argument unchanged.

source§

impl<T, U> Into<U> for T
where U: From<T>,

source§

fn into(self) -> U

Calls U::from(self).

That is, this conversion is whatever the implementation of From<T> for U chooses to do.

source§

impl<T, U> TryFrom<U> for T
where U: Into<T>,

§

type Error = Infallible

The type returned in the event of a conversion error.
source§

fn try_from(value: U) -> Result<T, <T as TryFrom<U>>::Error>

Performs the conversion.
source§

impl<T, U> TryInto<U> for T
where U: TryFrom<T>,

§

type Error = <U as TryFrom<T>>::Error

The type returned in the event of a conversion error.
source§

fn try_into(self) -> Result<U, <U as TryFrom<T>>::Error>

Performs the conversion.