Files
fips/docs/reference
Johnathan Corgan 10cd43361b Merge branch 'maint' into master
Brings the tarball upgrade restart, release-candidate Debian versions, the
rekey-disable deprecation note, the interop harness change, and the Ethernet
socket leak, TCP address fallback and gateway NAT retry fixes up from maint.

Resolutions:
- io_linux.rs: keep master's ENODEV/ENXIO absence branch in the bind failure
  arm, without its manual close, since the OwnedFd guard now closes the socket
  on every error return.
- The socket leak test runs without #[ignore] under the FIPS_TEST_PRIVILEGED
  convention, so the privileged CI leg exercises it, and accepts master's
  InterfaceUnavailable for a missing interface.
- tcp/mod.rs: master's connect signature with maint's multi-address
  resolution; maint's tests, less a helper master no longer uses.
- CHANGELOG: maint's entries added under master's areas, with the socket leak
  entry reworded for master, which has no beacon socket reopen.
2026-09-30 18:58:54 +00:00
..

Reference

Information-oriented technical descriptions for lookup on demand. Reference content describes what is: wire formats, configuration keys, command-line flags, control-socket commands, default values, file paths, exit codes. It is consulted, not read end-to-end.

Reference is austere by design: minimal narrative, no opinions, no guidance on when to use a feature. The "why" lives in design/; the "how do I accomplish X" lives in how-to/.

Available Reference

Document Scope
wire-formats.md All FMP and FSP message byte layouts, encapsulation walkthrough
configuration.md Full YAML configuration reference for the daemon and gateway
security.md nftables baseline, peer ACL, cryptographic primitives, rekey defaults, threat-resistance matrix
nostr-events.md Kind 37195 advert, Kind 21059 traversal signaling, Kind 10050 inbox relays
transports.md Per-transport statistics counter inventory
control-socket.md Line-delimited JSON control protocol for the daemon and gateway
native-api.md Native datagram API: the Rust surface, addressing and ports, errno table, ceilings, line protocol, command reference
cli-fips.md fips daemon CLI: options, exit codes, environment, files
cli-fipsctl.md fipsctl control-client: subcommands, options, exit codes
cli-fipstop.md fipstop live-status TUI: tabs, keybindings
cli-fips-gateway.md fips-gateway service CLI: options, exit codes, files