Struct Server 

pub struct Server { /* private fields */ }

A running server. Dropping it stops it (with a drain), so keep it and call Server::wait_for_stop to run until a stop is requested.

Implementations

impl Server

pub fn open_door(&self) -> Result<(), NetError>

Starts accepting on every listener; a second call is a no-op.

Errors

ShuttingDown while draining or after shutdown; ForkedChild.

pub fn close_door(&self)

Stops accepting within one loop iteration; listening sockets stay open. Idempotent.

pub fn door(&self) -> DoorState

Whether the server is accepting.

pub fn drain(&self, deadline: Instant) -> DrainReport

Closes the door, tells sessions to finish, closes idle connections at once, waits for the rest until deadline, then kills them with DrainDeadline.

pub fn shutdown(self, deadline: Instant) -> DrainReport

Drains, then closes the listening sockets and joins every thread.

pub fn wait_for_stop(self) -> DrainReport

Blocks until a stop is requested (ServerHandle::request_stop, or the control line moves to Draining or Stopping), then shuts down.

pub fn handle(&self) -> ServerHandle

A cloneable handle for other threads.

pub fn stats(&self) -> Stats

Counters summed over the workers.

pub fn listeners(&self) -> &[ListenerInfo]

Facts about each listener.

Trait Implementations

impl Debug for Server

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

Formats the value using the given formatter.

impl Drop for Server

fn drop(&mut self)

Executes the destructor for this type.

fn pin_drop(self: Pin<&mut Self>)

🔬This is a nightly-only experimental API. (pin_ergonomics)

Execute the destructor for this type, but different to Drop::drop, it requires self to be pinned.