Expand description
§varlink_fallback module
The single enforcement point for [varlink] no_fallback (see #37).
Every varlink-first collector funnels its failure through
report_varlink_failure: by default it logs the familiar falling back
warning and the caller proceeds to its D-Bus (or, for networkd,
file-based) fallback; with [varlink] no_fallback = true it returns an
error instead, so the collector fails loudly and CI proves the collector
set is varlink-clean rather than silently D-Bus-served.
Scope notes (so the “varlink-clean” claim is not over-read): [dbus]
stats have no varlink path (they are statistics about the D-Bus daemon
itself), so they never report a fallback — they just use the bus. And skipped-but-warned metric
parses are not fallbacks either, so a clean run can still under-report;
completeness assertions cover that, not this flag.
The collector argument names the collector for the log line (e.g.
"units", "networkd", "container <name> units"); fallback names
what would have served the data ("D-Bus", "file-based"). Keeping both
as plain strings keeps this module dependency-free and lets container
paths interpolate the machine name without a structured type.
Enums§
Functions§
- report_
varlink_ failure - Record a varlink failure and decide whether the caller may fall back.