Struct ServerSection 

pub struct ServerSection {
    pub bind: Option<String>,
    pub port: Option<u16>,
    pub drain_secs: Option<u64>,
    pub stop_checkpoint_secs: Option<u64>,
}

Where the server binds and listens.

Reload: needs a restart. A listener is bound once, at startup.

Fields

bind: Option<String>

The address to bind, as an IP literal. No flag mirrors this, only this key.

Unset binds ::, the unspecified IPv6 address, which accepts IPv4 callers too through a dual-stack socket: one listener answers both families, and 127.0.0.1 and [::1] both reach it. Naming an address narrows that. 127.0.0.1 reaches only callers on this host, which is what a deployment behind a reverse proxy on the same machine wants; a host’s own public address pins the listener to one interface on a machine with several.

An address this host does not hold refuses startup, from the bind itself, naming the address.

port: Option<u16>

The port to listen on. Mirrors --port.

Reasonable range: 1024 to 65_535. Below 1024 a Unix host wants privileges this process should not be started with; a deployment that answers the internet on 443 gets there through a proxy or a redirect, not by running as root. The built-in default is 3000.

drain_secs: Option<u64>

How long a stop waits for requests in flight once it has stopped accepting, in seconds. No flag mirrors this, only this key.

Reasonable range: 1 to 60. A request that outlives it is cut off. The deployment’s unit allows 200 seconds from SIGTERM to SIGKILL, which this and stop_checkpoint_secs share. The built-in default is 10.

stop_checkpoint_secs: Option<u64>

How long a stop waits for a checkpoint taken while the server still serves, in seconds, before it stops accepting. The next boot then replays only what was written after it. No flag mirrors this, only this key.

Reasonable range: 0 to 120. 0 takes no checkpoint on a stop. A checkpoint still running when this runs out is abandoned, which costs nothing: the next boot replays from the one before. The built-in default is 30.

Trait Implementations

impl Clone for ServerSection

fn clone(&self) -> ServerSection

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for ServerSection

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

Formats the value using the given formatter.

impl Default for ServerSection

fn default() -> ServerSection

Returns the “default value” for a type.

impl<'de> Deserialize<'de> for ServerSection

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl PartialEq for ServerSection

fn eq(&self, other: &ServerSection) -> bool

Tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl Serialize for ServerSection

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl Eq for ServerSection

impl StructuralPartialEq for ServerSection