Interfaces über den Index statt über die Adresse (DHCP-Adresswechsel ohne Neustart) #30

Merged
jochen merged 3 commits from fix/iface-by-index into master 2026-11-11 08:35:22 +00:00
Collaborator

Fixes #5

Problem

Gruppenbeitritt (IP_ADD_MEMBERSHIP) und Sende-Interface (IP_MULTICAST_IF) wurden über die IPv4-Adresse gesetzt, die nur beim Start ermittelt wurde. Nachgestellt auf ifb0/ifb1 mit dem alten Stand:

  • Adresswechsel auf der Empfangsseite → jede Reinjection scheitert mit Network is unreachable (os error 101).
  • Interface ohne IPv4 beim Start → fataler Fehler.
  • Interface gelöscht und neu angelegt → die Mitgliedschaft ist weg, es kommt nichts mehr an.

Änderung

  • IPv4-Beitritt über ip_mreqn mit Interface-Index (join_multicast_v4_n) und IP_MULTICAST_IF über ip_mreqn.imr_ifindex (raw setsockopt, Linux und FreeBSD). IPv6 lief schon über den Index.
  • Kein IPv4 beim Start: nur noch eine Warnung. Ein nicht vorhandenes Interface bleibt fatal und listet die vorhandenen Interfaces auf.
  • net::watch prüft alle 30 s jedes Interface:
    • neuer Index (Interface neu angelegt): alte Gruppe verlassen, auf dem neuen Index beitreten;
    • gleicher Index, aber Mitgliedschaft verloren (FreeBSD vergibt Indizes wieder und entfernt die Mitgliedschaften beim Löschen des Interfaces): erneut beitreten. Wenn die Mitgliedschaft noch besteht, kommt EADDRINUSE zurück und es passiert nichts;
    • Interface verschwunden: protokolliert, Beitritt sobald es wieder da ist;
    • Adresswechsel: nur protokolliert.
  • Doku angepasst: README, Config-Doku und der Hilfetext im Plugin-Dialog „Interfaces“. #5 ist aus den offenen Punkten entfernt.

Tests

  • Unit-Tests auf dem Loopback-Interface: unbekanntes Interface, Beitritt per Index, verlorene Mitgliedschaft, neuer Index, Interface weg und wieder da.
  • E2E mit zwei Daemons auf ifb0/ifb1:
    • beide Adressen geändert → kommt an (Quelle ist die neue Adresse);
    • beide Interfaces neu angelegt (neue Indizes) → nach der nächsten Prüfung wieder angekommen;
    • Start ohne IPv4 → Warnung statt Abbruch, Weiterleitung funktioniert;
    • Interface gelöscht und mit neuer Adresse neu angelegt → wieder beigetreten, Adresswechsel protokolliert.
  • fmt, clippy -D warnings, cargo check --target x86_64-unknown-freebsd, cargo audit und render_templates.py laufen lokal sauber durch.

Auf FreeBSD selbst ist das bisher nur durch den Compile-Check abgedeckt. Der FreeBSD-Runner führt die Unit-Tests auf lo0 nicht aus, er baut nur. Zum Prüfen auf der OPNsense-Box: eine DHCP-Erneuerung mit neuer Adresse oder ein VLAN-Interface neu anlegen.

🤖 Generated with Claude Code

https://claude.ai/code/session_01Vh6img4RYU1F52VUwGJcrp

Fixes #5 ## Problem Gruppenbeitritt (`IP_ADD_MEMBERSHIP`) und Sende-Interface (`IP_MULTICAST_IF`) wurden über die IPv4-Adresse gesetzt, die nur beim Start ermittelt wurde. Nachgestellt auf ifb0/ifb1 mit dem alten Stand: - Adresswechsel auf der Empfangsseite → jede Reinjection scheitert mit `Network is unreachable (os error 101)`. - Interface ohne IPv4 beim Start → fataler Fehler. - Interface gelöscht und neu angelegt → die Mitgliedschaft ist weg, es kommt nichts mehr an. ## Änderung - IPv4-Beitritt über `ip_mreqn` mit Interface-Index (`join_multicast_v4_n`) und `IP_MULTICAST_IF` über `ip_mreqn.imr_ifindex` (raw setsockopt, Linux und FreeBSD). IPv6 lief schon über den Index. - Kein IPv4 beim Start: nur noch eine Warnung. Ein nicht vorhandenes Interface bleibt fatal und listet die vorhandenen Interfaces auf. - `net::watch` prüft alle 30 s jedes Interface: - neuer Index (Interface neu angelegt): alte Gruppe verlassen, auf dem neuen Index beitreten; - gleicher Index, aber Mitgliedschaft verloren (FreeBSD vergibt Indizes wieder und entfernt die Mitgliedschaften beim Löschen des Interfaces): erneut beitreten. Wenn die Mitgliedschaft noch besteht, kommt `EADDRINUSE` zurück und es passiert nichts; - Interface verschwunden: protokolliert, Beitritt sobald es wieder da ist; - Adresswechsel: nur protokolliert. - Doku angepasst: README, Config-Doku und der Hilfetext im Plugin-Dialog „Interfaces“. #5 ist aus den offenen Punkten entfernt. ## Tests - Unit-Tests auf dem Loopback-Interface: unbekanntes Interface, Beitritt per Index, verlorene Mitgliedschaft, neuer Index, Interface weg und wieder da. - E2E mit zwei Daemons auf ifb0/ifb1: - beide Adressen geändert → kommt an (Quelle ist die neue Adresse); - beide Interfaces neu angelegt (neue Indizes) → nach der nächsten Prüfung wieder angekommen; - Start ohne IPv4 → Warnung statt Abbruch, Weiterleitung funktioniert; - Interface gelöscht und mit neuer Adresse neu angelegt → wieder beigetreten, Adresswechsel protokolliert. - fmt, clippy `-D warnings`, `cargo check --target x86_64-unknown-freebsd`, cargo audit und render_templates.py laufen lokal sauber durch. Auf FreeBSD selbst ist das bisher nur durch den Compile-Check abgedeckt. Der FreeBSD-Runner führt die Unit-Tests auf `lo0` nicht aus, er baut nur. Zum Prüfen auf der OPNsense-Box: eine DHCP-Erneuerung mit neuer Adresse oder ein VLAN-Interface neu anlegen. 🤖 Generated with [Claude Code](https://claude.com/claude-code) https://claude.ai/code/session_01Vh6img4RYU1F52VUwGJcrp
net: join and send by interface index, re-join recreated interfaces (#5)
Some checks failed
ci / rust (push) Has been cancelled
3d579e26a2
Group membership and IP_MULTICAST_IF were set by the interface's IPv4
address, resolved once at startup. After a DHCP address change,
reinjection failed with ENETUNREACH, and an interface without an
address at startup was fatal.

- IPv4 membership via ip_mreqn (index), IP_MULTICAST_IF via ip_mreqn
  with imr_ifindex (Linux and FreeBSD); IPv6 already used the index.
- No IPv4 address at startup: warning instead of a fatal error. A
  non-existent interface stays fatal, with the list of existing ones.
- net::watch checks every interface every 30 s: a new index (interface
  recreated) leaves the old and joins the new one, a lost membership on
  the same index (FreeBSD reuses indexes) is joined again, a vanished
  interface is logged and joined once it is back, address changes are
  logged.
- Unit tests on the loopback interface; README, config docs and the
  plugin's interface help text updated.

Fixes #5

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01Vh6img4RYU1F52VUwGJcrp
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01Vh6img4RYU1F52VUwGJcrp
README: interfaces by index, address changes need no restart (#5)
All checks were successful
build-freebsd / freebsd (pull_request) Successful in 3m0s
build-freebsd / release (pull_request) Has been skipped
ci / rust (push) Successful in 3m47s
ci / rust (pull_request) Successful in 3m39s
de3c2295e6
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01Vh6img4RYU1F52VUwGJcrp
jochen approved these changes 2026-11-11 08:35:12 +00:00
jochen merged commit a6aed95352 into master 2026-11-11 08:35:22 +00:00
jochen deleted branch fix/iface-by-index 2026-11-11 08:35:22 +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!30
No description provided.