Struct Server 

pub struct Server { /* private fields */ }

A running iroh-dns server.

Combines a DNS listener and an HTTP/HTTPS listener into a single handle. Construct with Self::bind and drive to completion with Self::join, or stop the tasks with Self::shutdown.

Implementations

impl Server

pub async fn bind(config: Config) -> Result<Self>

Binds and spawns the server from a Config.

Opens the persistent signed-packet store, enables the mainline DHT fallback when configured, and spawns the DNS, HTTP(S), and metrics tasks. Returns once all listeners are bound.

pub async fn shutdown(self) -> Result<()>

Cancels the server tasks and waits for them to complete.

pub async fn join(self) -> Result<()>

Waits for the server tasks to complete.

Returns when a listener task finishes, either with success or an error.

pub fn metrics(&self) -> &Arc<Metrics>

Returns the Metrics for this server.

pub fn dns_addr(&self) -> SocketAddr

Returns the local address that the DNS listener is bound to.

pub fn http_addr(&self) -> Option<SocketAddr>

Returns the local address of the HTTP listener, or None if no HTTP listener was configured.

pub fn https_addr(&self) -> Option<SocketAddr>

Returns the local address of the HTTPS listener, or None if no HTTPS listener was configured.

Trait Implementations

impl Debug for Server

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

Formats the value using the given formatter.