Skip to main content

Module control

Module control 

Source
Expand description

Stage-1 control/introspection API for the server.

§Scope (5.0.0)

Per the brief (§4.3, §5.3, §7), the server crate exposes:

  • A minimal handle the embedder can hold.
  • A “state” enum the embedder can poll.
  • A reload-hint type.

Critically, the server does not restart itself. When a config edit would need the listener rebuilt, the server-side code only emits a hint; an external control layer (GUI / supervisor) decides whether to restart. That’s the brief’s §7 rule and the shape here reflects it.

Implementation of actual shutdown / reload wiring is stage-2 work. In 5.0.0 these types exist with placeholder methods so downstream code can start coding against them.

Structs§

ServerControl
Small control surface for the embedder.
ServerHandle
Handle an embedder holds to interact with a running server.

Enums§

ReloadHint
How much of the server needs to restart after a config change.
ServerState
What the server is doing right now.