Struct ReloadHandle 

pub struct ReloadHandle { /* private fields */ }

Replaces the configuration of a running server.

The point of this type is a guarantee: a SIGHUP with a broken configuration file — a typo, a half-written certificate mid-renewal — must leave the server running exactly as it was. A proxy that exits when handed a bad config would turn a typo into an outage, and certbot --deploy-hook will send SIGHUP at three in the morning with nobody watching.

So nothing is applied until everything has been parsed and validated: the file is read, the new certificate and key are loaded, and only then is anything swapped. There is no intermediate state where the endpoint has the new certificate but the old users, or vice versa.

Implementations

impl ReloadHandle

pub fn reload(&self, path: &Path) -> Result<Arc<Config>>

Re-reads the configuration file and applies it, or changes nothing.

Returns the newly applied configuration, or an error describing why the old one is still in force. Existing connections are deliberately unaffected — they keep the configuration they were accepted with (see Server::serve).

Trait Implementations

impl Clone for ReloadHandle

fn clone(&self) -> ReloadHandle

Returns a duplicate of the value.

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

Performs copy-assignment from source.