Struct ListenerHandle 

pub struct ListenerHandle { /* private fields */ }

The write side of one role’s listener: its socket, and its TLS mode.

Held by the reload supervisor and by nothing else. Both sends are synchronous (watch::Sender::send_replace, and an unbounded mpsc::Sender::send), which is what lets a socket change sit in the same uninterruptible publishing run as the routers and the job registry — see cli::apply_reload.

It deliberately remembers nothing about what it is serving. Whether a role should rebind is decided by comparing the applied configuration against the proposed one — never against the address actually bound, since a caller supplying its own socket (serve_on_with, and every test that binds 127.0.0.1:0) is entitled to one that does not match what the file says.

Implementations

impl ListenerHandle

pub fn serve(&self, listener: TcpListener)

Replaces the socket this role serves.

pub fn close(&self)

Stops serving this role, releasing its socket.

pub fn set_tls(&self, settings: Option<TlsSettings>)

Publishes the TLS mode the next connection is accepted under. None is cleartext.