Struct Server 

pub struct Server { /* private fields */ }

A read-only server for the volumes found under paths.

Implementations

impl Server

pub fn bind(paths: &[PathBuf], listen: &str) -> Result<Server>

Inspect and verify the volumes under paths, bind listen (for example 127.0.0.1:0).

pub fn bind_with( paths: &[PathBuf], listen: &str, limits: ServerLimits, ) -> Result<Server>

pub fn bind_tls( paths: &[PathBuf], listen: &str, limits: ServerLimits, tls: Option<Arc<ServerConfig>>, ) -> Result<Server>

Like bind_with; with tls every connection is a TLS session using that configuration (see tls::server_config: the server’s own identity and the client allow list). Every admitted client may read every set.

pub fn bind_acl( paths: &[PathBuf], listen: &str, limits: ServerLimits, tls: Option<Arc<ServerConfig>>, acl: Acl, ) -> Result<Server>

Like bind_tls with per-request authorization: acl decides which admitted client may read which set (the TLS configuration must admit acl.admitted(); the two are built together by the CLI). Without tls there is no client identity, so acl must be Acl::everyone() (anything else would refuse every request).

pub fn local_addr(&self) -> Result<SocketAddr>

pub fn encrypted(&self) -> bool

True when connections are TLS sessions.

pub fn limits(&self) -> ServerLimits

pub fn acl(&self) -> &Acl

pub fn served(&self) -> Vec<ServedSet>

pub fn run(self, stop: Arc<AtomicBool>) -> Result<()>

Accept connections until stop is set (checked every 2 ms, so that a sequential client waits at most that long between one piece and the next); each admitted request runs on its own thread. Excess connections are answered ERR 503 busy, connections above the per-address rate ERR 429, and closed; in TLS mode both are closed without a reply, so no handshake is spent on them. Every admitted connection runs under a time budget (ServerLimits::timeout, extended per response by min_rate), so a peer that trickles bytes or stops reading releases its slot when the budget ends.