Klarere Start- und Statusfehlermeldungen #20

Merged
jochen merged 1 commit from fix/clearer-errors into master 2026-11-10 20:02:32 +00:00
Collaborator

Refs #14 · baut auf #19 auf (Basis feat/freebsd-pkg) — nach dem Merge von #19 auf master umstellen.

Lehren aus dem ersten OPNsense-Test: service status meldete running, der Daemon kam aber nie hoch, und report sagte nur „No such file or directory“.

Änderungen

Daemon-Start

  • Fataler Fehler → eine Zeile ERROR fatal: … mit kompletter Ursachenkette (landet über daemon(8) im syslog); keine ANSI-Farbcodes mehr, wenn stdout kein Terminal ist
  • Peer-Listener wird vorab gebunden. Bisher passierte das in einem Hintergrund-Task, dessen Fehler verloren ging — falsche listen_addr/source_addr oder belegter Port fielen gar nicht auf. Jetzt fatal mit Hinweis
  • Interface-Fehler unterscheiden „existiert nicht“ (mit Liste der vorhandenen Interfaces) von „hat keine IPv4-Adresse“

Status-Socket

  • Wird als Erstes gebunden; konkrete Meldungen bei fehlendem Verzeichnis, fehlenden Rechten (inkl. effektivem User), bereits laufendem Daemon, Pfad ist kein Socket. Verwaiste Sockets abgestürzter Läufe werden ersetzt. Nicht fatal, aber ERROR
  • Aufräumen nur des eigenen Sockets (Gerät/Inode/ctime) — bei Shutdown und bei fatalem Startfehler. Ein schneller Neustart kann den Socket des neuen Prozesses nicht mehr löschen. (Inode allein reicht nicht — Dateisysteme vergeben freie Inode-Nummern sofort neu, das hat ein Test aufgedeckt)

--status / --records

  • Fehlender Socket → mögliche Ursachen inkl. Config-Pfad; verwaister Socket; fehlende Rechte; deaktivierter Socket

README: Abschnitt Troubleshooting

Beispiele (lokal erzeugt)

ERROR mdns_bridged: fatal: setting up interface igb1_vlan30: interface igb1_vlan30 does not exist on this host; existing interfaces: lo, ifb0, ifb1, eth0
ERROR mdns_bridged: fatal: cannot listen on 10.99.99.99:5360: 10.99.99.99 is not configured on this host. listen_addr (or source_addr, its default) must be one of this host's own addresses
ERROR mdns_bridged: status socket unavailable, --status/--records will not work: directory /var/run/nope does not exist (running as root (uid 0)). …

Getestet

  • fmt, clippy -D warnings, 18 Tests (6 neue in status), 8× wiederholt stabil; FreeBSD-cargo check
  • Szenarien als echter Prozess: falsches Interface, Interface ohne IPv4, fremde source_addr, fehlendes Socket-Verzeichnis, zweiter Daemon, verwaister Socket, Neustart-Überlappung; Socket wird auch nach fatalem Fehler aufgeräumt
  • End-to-End mit zwei Daemons: Weiterleitung/Filter/Dedup unverändert, Sockets nach Shutdown entfernt
  • Noch offen: Test auf OPNsense mit dem Paket aus diesem PR-Lauf

🤖 Generated with Claude Code

https://claude.ai/code/session_01Vh6img4RYU1F52VUwGJcrp

Refs #14 · baut auf #19 auf (Basis `feat/freebsd-pkg`) — nach dem Merge von #19 auf `master` umstellen. Lehren aus dem ersten OPNsense-Test: `service status` meldete *running*, der Daemon kam aber nie hoch, und `report` sagte nur „No such file or directory“. ## Änderungen **Daemon-Start** - Fataler Fehler → eine Zeile `ERROR fatal: …` mit kompletter Ursachenkette (landet über `daemon(8)` im syslog); keine ANSI-Farbcodes mehr, wenn stdout kein Terminal ist - **Peer-Listener wird vorab gebunden.** Bisher passierte das in einem Hintergrund-Task, dessen Fehler verloren ging — falsche `listen_addr`/`source_addr` oder belegter Port fielen gar nicht auf. Jetzt fatal mit Hinweis - Interface-Fehler unterscheiden „existiert nicht“ (**mit Liste der vorhandenen Interfaces**) von „hat keine IPv4-Adresse“ **Status-Socket** - Wird als Erstes gebunden; konkrete Meldungen bei fehlendem Verzeichnis, fehlenden Rechten (inkl. effektivem User), bereits laufendem Daemon, Pfad ist kein Socket. Verwaiste Sockets abgestürzter Läufe werden ersetzt. Nicht fatal, aber `ERROR` - Aufräumen nur des **eigenen** Sockets (Gerät/Inode/ctime) — bei Shutdown und bei fatalem Startfehler. Ein schneller Neustart kann den Socket des neuen Prozesses nicht mehr löschen. (Inode allein reicht nicht — Dateisysteme vergeben freie Inode-Nummern sofort neu, das hat ein Test aufgedeckt) **`--status` / `--records`** - Fehlender Socket → mögliche Ursachen inkl. Config-Pfad; verwaister Socket; fehlende Rechte; deaktivierter Socket **README:** Abschnitt Troubleshooting ## Beispiele (lokal erzeugt) ``` ERROR mdns_bridged: fatal: setting up interface igb1_vlan30: interface igb1_vlan30 does not exist on this host; existing interfaces: lo, ifb0, ifb1, eth0 ERROR mdns_bridged: fatal: cannot listen on 10.99.99.99:5360: 10.99.99.99 is not configured on this host. listen_addr (or source_addr, its default) must be one of this host's own addresses ERROR mdns_bridged: status socket unavailable, --status/--records will not work: directory /var/run/nope does not exist (running as root (uid 0)). … ``` ## Getestet - fmt, clippy `-D warnings`, 18 Tests (6 neue in `status`), 8× wiederholt stabil; FreeBSD-`cargo check` - Szenarien als echter Prozess: falsches Interface, Interface ohne IPv4, fremde `source_addr`, fehlendes Socket-Verzeichnis, zweiter Daemon, verwaister Socket, Neustart-Überlappung; Socket wird auch nach fatalem Fehler aufgeräumt - End-to-End mit zwei Daemons: Weiterleitung/Filter/Dedup unverändert, Sockets nach Shutdown entfernt - **Noch offen:** Test auf OPNsense mit dem Paket aus diesem PR-Lauf 🤖 Generated with [Claude Code](https://claude.com/claude-code) https://claude.ai/code/session_01Vh6img4RYU1F52VUwGJcrp
Clearer startup and status errors
All checks were successful
ci / rust (push) Successful in 2m39s
build-freebsd / freebsd (pull_request) Successful in 2m38s
build-freebsd / release (pull_request) Has been skipped
ci / rust (pull_request) Successful in 2m39s
5ec09b1f0d
Lessons from the first OPNsense test, where `service status` said
"running" but the daemon never came up and `report` only printed
"No such file or directory":

- Daemon mode: a fatal error is logged as one `ERROR fatal: ...` line
  with the full cause chain (daemon(8) sends it to syslog); no ANSI
  colour codes when stdout is not a terminal
- Status socket is bound first, before interfaces and peers, with
  specific messages: directory missing, no write permission (incl.
  effective user), another daemon already listening, path is not a
  socket; stale sockets from crashed runs are replaced. Not fatal, but
  logged as ERROR
- Socket cleanup only removes our own socket (dev/inode/ctime), on
  shutdown and on fatal startup errors, so a quick restart can no
  longer delete the new daemon's socket
- Peer listener is bound up front instead of inside a background task,
  whose error was silently dropped: listen_addr/source_addr not on this
  host and busy port are now fatal with a hint
- Interface errors distinguish "does not exist" (listing existing
  interfaces) from "has no IPv4 address"
- `--status`/`--records`: explain missing socket (daemon not running,
  socket not created, different status_socket), stale socket, missing
  permission, disabled socket
- README: troubleshooting section

Refs #14

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01Vh6img4RYU1F52VUwGJcrp
jochen changed target branch from feat/freebsd-pkg to master 2026-11-10 19:26:00 +00:00
jochen approved these changes 2026-11-10 20:02:25 +00:00
jochen merged commit bd0bb39165 into master 2026-11-10 20:02:32 +00:00
jochen deleted branch fix/clearer-errors 2026-11-10 20:02:33 +00:00
Sign in to join this conversation.
No reviewers
No milestone
No project
No assignees
2 participants
Notifications
Due date
The due date is invalid or out of range. Please use the format "yyyy-mm-dd".

No due date set.

Dependencies

No dependencies set

Reference
jochen/mdns-bridge!20
No description provided.