Capture: nur bridgen, was nachweislich von einem gebridgten Link kommt #35

Merged
jochen merged 3 commits from fix/capture-source-check into master 2026-11-12 13:25:34 +00:00
Collaborator

Befund 2 aus dem Review von v0.1.1 (erster von drei Fixes; die beiden anderen bauen auf diesem Branch auf).

Problem

Die Capture-Sockets sind an die Wildcard-Adresse gebunden. Neben dem Multicast der Gruppe bekommen sie deshalb auch Unicast an Port 5353 jeder Adresse des Hosts – egal, auf welchem Interface es ankommt. Bisher wurde alles davon gebridged, also an den anderen Standorten als Multicast mit der Adresse der Bridge und Quellport 5353 neu gesendet.

mDNS vertraut dem lokalen Link, und Empfänger prüfen deshalb, dass ein Paket wirklich von dort kommt (RFC 6762 §11) und dass Antworten von Port 5353 stammen (§6). Was die Bridge neu sendet, besteht diese Prüfungen immer. Sie müssen also dort gemacht werden, wo das Paket ankommt – das fehlte.

Änderung

  • src/net.rs – Empfang per recvmsg(2) mit dem, was der Kernel über die Ankunft weiß: Zieladresse und Ankunfts-Interface (IP_PKTINFO unter Linux, IP_RECVDSTADDR + IP_RECVIF unter FreeBSD, IPV6_PKTINFO für IPv6). Das Interface-Handle kennt jetzt alle Adressen seines Interfaces samt Netzmaske (der 30-s-Watch hält sie aktuell) statt nur der letzten IPv4-Adresse.

  • src/origin.rs (neu) – entscheidet pro Datagramm:

    Datagramm Ergebnis
    nicht auf einem gebridgten Interface angekommen verworfen
    an die mDNS-Gruppe angenommen (link-lokaler Multicast wird nicht geroutet)
    an eine andere Adresse (Unicast), Antwort, Absender im Subnetz des Interfaces oder IPv6-link-local angenommen – das sind die Antworten auf Fragen, die die Bridge mit Unicast-Response-Bit reinjiziert hat
    Unicast, aber Query, oder Absender nicht am Link verworfen
    Antwort (Multicast oder Unicast), Quellport ≠ 5353 verworfen
    abgeschnitten, kürzer als ein DNS-Header, ohne Ankunftsinformation vom Kernel verworfen
  • Status/Log – neuer Zähler dropped_source im Report (erscheint automatisch im Status-Tab des Plugins). Mit RUST_LOG=debug eine Zeile pro verworfenem Datagramm:
    datagram ignored socket=lan0 from=10.99.0.2:5353 dst=10.99.0.1 arrived_on=wan0 reason=arrived on an interface that is not bridged

  • README – Capture-Regeln, Zähler, Troubleshooting.

Was sich im Verhalten ändert

  • Unicast-Queries an die Bridge werden nicht mehr an die anderen Standorte weitergereicht.
  • Antworten, die nicht von Port 5353 kommen, werden verworfen, auch per Multicast. RFC-konforme Responder betrifft das nicht.
  • Unicast-Antworten nur noch von Absendern am Link. Nach einem Adresswechsel des Interfaces in ein anderes Subnetz gilt bis zu 30 s das alte; Multicast ist davon nicht betroffen.

Nebenbefund: Linux gibt Multicast an irgendeinen Socket des Daemons

Der E2E-Test hat gezeigt, dass Linux (hier 6.18) ein Multicast-Paket nicht zwingend dem Socket gibt, der auf dem Ankunfts-Interface beigetreten ist: Hat genau ein Socket dort die Gruppe abonniert, wählt der UDP-Early-Demux ihn aus und lässt dann SO_REUSEPORT unter allen Sockets des Daemons würfeln – ohne auf deren Mitgliedschaften zu schauen. Mit net.ipv4.udp_early_demux=0 oder nur einem gebridgten Interface tritt es nicht auf.

  • In 0.1.1 hatte das nur eine kosmetische Folge: --records und das Log nannten bei mehreren Interfaces das falsche Interface (im Test 14 von 18 Paketen). Weiterleitung und Reinjektion hängen nicht vom Interface ab.
  • Mein erster Entwurf dieses Fixes hätte solche Pakete verworfen, also bei zwei Interfaces etwa die Hälfte. Deshalb ordnet origin::check jedes Paket dem Interface zu, auf dem es laut Kernel angekommen ist – nicht dem Socket, von dem es gelesen wurde.

Tests

  • 60 Unit-Tests grün (Linux), clippy -D warnings für Linux und das FreeBSD-Target, musl-Check. Neu: 9 Tests für origin::check (jede Regel), Empfang auf dem Loopback-Interface für IPv4 und IPv6 (Zieladresse, Interface, Abschneiden), Subnet::contains, if_indextoname.

  • E2E unter Linux mit Netzwerk-Namespaces: Standort A (Daemon, LAN-Host, ein nicht gebridgtes Interface mit Host dahinter) und Standort B (eigener Namespace mit Daemon und LAN-Host). Jeder Fall sendet ein Paket an A; geprüft wird, ob es am LAN von B erscheint. Gelaufen mit einem, zwei und drei gebridgten Interfaces an A:

    Fall 0.1.1 dieser Branch
    Multicast-Antwort vom LAN-Host, Port 5353 gebridged gebridged
    Multicast-Query vom LAN-Host, Port 40001 gebridged gebridged
    Multicast-Antwort vom LAN-Host, Port 40002 gebridged verworfen
    Multicast-Antwort am LAN-Link, Absender aus fremdem Subnetz gebridged gebridged
    Unicast-Antwort vom LAN-Host, Port 5353 gebridged gebridged
    Unicast-Antwort vom LAN-Host, Port 40003 gebridged verworfen
    Unicast-Query vom LAN-Host gebridged verworfen
    Unicast-Antwort, über das LAN-Interface hereingeroutet gebridged verworfen
    Unicast-Antwort über das nicht gebridgte Interface, an dessen Adresse gebridged verworfen
    Unicast-Antwort über das nicht gebridgte Interface, an die LAN-Adresse gebridged verworfen
    Gegenrichtung: Announcement am LAN von B erscheint am LAN von A ok ok
    Zuordnung bei zwei Interfaces (Pakete des LAN-Hosts) 14 von 18 falsch 15 von 15 richtig
  • Linux-Bridge (br0 mit Port): der Kernel meldet br0 als Ankunfts-Interface, für Multicast und Unicast.

Nicht getestet

  • IPv6 Ende-zu-Ende. Die Sandbox hat kein IPv6. Der IPv6-Empfang ist nur durch den neuen Loopback-Test abgedeckt; er läuft, wo der Host IPv6 hat (FreeBSD-Runner), und überspringt sich sonst mit einer Meldung.
  • FreeBSD/OPNsense Ende-zu-Ende. IP_RECVDSTADDR/IP_RECVIF laufen zum ersten Mal im FreeBSD-Job dieses PRs (Loopback-Test). Auf den Firewalls bitte nach dem Update einmal in den Report schauen: captured muss weiter steigen, dropped_source klein bleiben. Wächst stattdessen dropped_source, nennt das Debug-Log den Grund.
  • VLAN-Interfaces unter Linux (der Sandbox-Kernel kann kein 802.1Q) sowie VLAN/LAGG/Bridge unter FreeBSD.

🤖 Generated with Claude Code

https://claude.ai/code/session_01Vh6img4RYU1F52VUwGJcrp

Befund 2 aus dem Review von v0.1.1 (erster von drei Fixes; die beiden anderen bauen auf diesem Branch auf). ## Problem Die Capture-Sockets sind an die Wildcard-Adresse gebunden. Neben dem Multicast der Gruppe bekommen sie deshalb auch Unicast an Port 5353 **jeder** Adresse des Hosts – egal, auf welchem Interface es ankommt. Bisher wurde alles davon gebridged, also an den anderen Standorten als Multicast mit der Adresse der Bridge und Quellport 5353 neu gesendet. mDNS vertraut dem lokalen Link, und Empfänger prüfen deshalb, dass ein Paket wirklich von dort kommt (RFC 6762 §11) und dass Antworten von Port 5353 stammen (§6). Was die Bridge neu sendet, besteht diese Prüfungen immer. Sie müssen also dort gemacht werden, wo das Paket ankommt – das fehlte. ## Änderung - **`src/net.rs`** – Empfang per `recvmsg(2)` mit dem, was der Kernel über die Ankunft weiß: Zieladresse und Ankunfts-Interface (`IP_PKTINFO` unter Linux, `IP_RECVDSTADDR` + `IP_RECVIF` unter FreeBSD, `IPV6_PKTINFO` für IPv6). Das Interface-Handle kennt jetzt alle Adressen seines Interfaces samt Netzmaske (der 30-s-Watch hält sie aktuell) statt nur der letzten IPv4-Adresse. - **`src/origin.rs`** (neu) – entscheidet pro Datagramm: | Datagramm | Ergebnis | |---|---| | nicht auf einem gebridgten Interface angekommen | verworfen | | an die mDNS-Gruppe | angenommen (link-lokaler Multicast wird nicht geroutet) | | an eine andere Adresse (Unicast), Antwort, Absender im Subnetz des Interfaces oder IPv6-link-local | angenommen – das sind die Antworten auf Fragen, die die Bridge mit Unicast-Response-Bit reinjiziert hat | | Unicast, aber Query, oder Absender nicht am Link | verworfen | | Antwort (Multicast oder Unicast), Quellport ≠ 5353 | verworfen | | abgeschnitten, kürzer als ein DNS-Header, ohne Ankunftsinformation vom Kernel | verworfen | - **Status/Log** – neuer Zähler `dropped_source` im Report (erscheint automatisch im Status-Tab des Plugins). Mit `RUST_LOG=debug` eine Zeile pro verworfenem Datagramm: `datagram ignored socket=lan0 from=10.99.0.2:5353 dst=10.99.0.1 arrived_on=wan0 reason=arrived on an interface that is not bridged` - **README** – Capture-Regeln, Zähler, Troubleshooting. ## Was sich im Verhalten ändert - Unicast-**Queries** an die Bridge werden nicht mehr an die anderen Standorte weitergereicht. - Antworten, die nicht von Port 5353 kommen, werden verworfen, auch per Multicast. RFC-konforme Responder betrifft das nicht. - Unicast-Antworten nur noch von Absendern am Link. Nach einem Adresswechsel des Interfaces in ein anderes Subnetz gilt bis zu 30 s das alte; Multicast ist davon nicht betroffen. ## Nebenbefund: Linux gibt Multicast an irgendeinen Socket des Daemons Der E2E-Test hat gezeigt, dass Linux (hier 6.18) ein Multicast-Paket nicht zwingend dem Socket gibt, der auf dem Ankunfts-Interface beigetreten ist: Hat genau ein Socket dort die Gruppe abonniert, wählt der UDP-Early-Demux ihn aus und lässt dann `SO_REUSEPORT` unter allen Sockets des Daemons würfeln – ohne auf deren Mitgliedschaften zu schauen. Mit `net.ipv4.udp_early_demux=0` oder nur einem gebridgten Interface tritt es nicht auf. - In 0.1.1 hatte das nur eine kosmetische Folge: `--records` und das Log nannten bei mehreren Interfaces das falsche Interface (im Test 14 von 18 Paketen). Weiterleitung und Reinjektion hängen nicht vom Interface ab. - Mein erster Entwurf dieses Fixes hätte solche Pakete verworfen, also bei zwei Interfaces etwa die Hälfte. Deshalb ordnet `origin::check` jedes Paket dem Interface zu, auf dem es laut Kernel angekommen ist – nicht dem Socket, von dem es gelesen wurde. ## Tests - 60 Unit-Tests grün (Linux), `clippy -D warnings` für Linux und das FreeBSD-Target, musl-Check. Neu: 9 Tests für `origin::check` (jede Regel), Empfang auf dem Loopback-Interface für IPv4 und IPv6 (Zieladresse, Interface, Abschneiden), `Subnet::contains`, `if_indextoname`. - E2E unter Linux mit Netzwerk-Namespaces: Standort A (Daemon, LAN-Host, ein nicht gebridgtes Interface mit Host dahinter) und Standort B (eigener Namespace mit Daemon und LAN-Host). Jeder Fall sendet ein Paket an A; geprüft wird, ob es am LAN von B erscheint. Gelaufen mit einem, zwei und drei gebridgten Interfaces an A: | Fall | 0.1.1 | dieser Branch | |---|---|---| | Multicast-Antwort vom LAN-Host, Port 5353 | gebridged | gebridged | | Multicast-Query vom LAN-Host, Port 40001 | gebridged | gebridged | | Multicast-Antwort vom LAN-Host, Port 40002 | gebridged | **verworfen** | | Multicast-Antwort am LAN-Link, Absender aus fremdem Subnetz | gebridged | gebridged | | Unicast-Antwort vom LAN-Host, Port 5353 | gebridged | gebridged | | Unicast-Antwort vom LAN-Host, Port 40003 | gebridged | **verworfen** | | Unicast-Query vom LAN-Host | gebridged | **verworfen** | | Unicast-Antwort, über das LAN-Interface hereingeroutet | gebridged | **verworfen** | | Unicast-Antwort über das nicht gebridgte Interface, an dessen Adresse | gebridged | **verworfen** | | Unicast-Antwort über das nicht gebridgte Interface, an die LAN-Adresse | gebridged | **verworfen** | | Gegenrichtung: Announcement am LAN von B erscheint am LAN von A | ok | ok | | Zuordnung bei zwei Interfaces (Pakete des LAN-Hosts) | 14 von 18 falsch | 15 von 15 richtig | - Linux-Bridge (`br0` mit Port): der Kernel meldet `br0` als Ankunfts-Interface, für Multicast und Unicast. ## Nicht getestet - **IPv6 Ende-zu-Ende.** Die Sandbox hat kein IPv6. Der IPv6-Empfang ist nur durch den neuen Loopback-Test abgedeckt; er läuft, wo der Host IPv6 hat (FreeBSD-Runner), und überspringt sich sonst mit einer Meldung. - **FreeBSD/OPNsense Ende-zu-Ende.** `IP_RECVDSTADDR`/`IP_RECVIF` laufen zum ersten Mal im FreeBSD-Job dieses PRs (Loopback-Test). Auf den Firewalls bitte nach dem Update einmal in den Report schauen: `captured` muss weiter steigen, `dropped_source` klein bleiben. Wächst stattdessen `dropped_source`, nennt das Debug-Log den Grund. - VLAN-Interfaces unter Linux (der Sandbox-Kernel kann kein 802.1Q) sowie VLAN/LAGG/Bridge unter FreeBSD. 🤖 Generated with [Claude Code](https://claude.com/claude-code) https://claude.ai/code/session_01Vh6img4RYU1F52VUwGJcrp
Capture: only bridge what verifiably came from a bridged link
Some checks failed
ci / rust (push) Has been cancelled
e023d49ed8
The capture sockets are bound to the wildcard address. Besides the
group's multicast they therefore also received unicast sent to port
5353 of any address of the host, arriving on any interface, and all of
it was bridged: re-sent at the other sites as multicast from the
bridge's own address and port 5353, where receivers can no longer tell
that it did not come from their link (RFC 6762 sections 6 and 11).

Every datagram is now read with recvmsg(2) together with the kernel's
information about its destination address and arrival interface
(IP_PKTINFO on Linux, IP_RECVDSTADDR + IP_RECVIF on FreeBSD,
IPV6_PKTINFO for IPv6), and src/origin.rs decides:

- it must have arrived on a bridged interface;
- to the mDNS group: accepted (link-local multicast is not routed);
- to any other address: only responses from a sender in one of the
  interface's subnets, or with an IPv6 link-local address - the answers
  to questions reinjected with the unicast-response bit;
- responses must come from port 5353;
- truncated datagrams, ones shorter than a DNS header and ones without
  arrival information are dropped.

Dropped datagrams are counted as dropped_source in the status report
and logged at debug level with sender, destination, arrival interface
and reason.

A packet is booked on the interface it arrived on, not on the one whose
socket it was read from. On Linux 6.18 these differ as soon as more
than one interface is bridged: the UDP early demux hands group
multicast to any socket of the daemon's SO_REUSEPORT group, so record
table and log named the wrong interface.

The interface handle keeps all addresses of its interface with their
netmasks (refreshed by the 30 s watch) instead of only the last IPv4
address.

Tests: origin::check with every rule; destination and interface as
reported on the loopback interface, for IPv4 and IPv6 (these run on the
FreeBSD runner too; the IPv6 one is skipped on hosts without IPv6).

Co-Authored-By: Claude Fable 5.2 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01Vh6img4RYU1F52VUwGJcrp
README: what the capture accepts, dropped_source
All checks were successful
ci / rust (push) Successful in 3m17s
build-freebsd / freebsd (pull_request) Successful in 2m57s
build-freebsd / release (pull_request) Has been skipped
ci / rust (pull_request) Successful in 3m17s
898ead8e97
Co-Authored-By: Claude Fable 5.2 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01Vh6img4RYU1F52VUwGJcrp
CI: show the output of passing tests
All checks were successful
build-freebsd / freebsd (pull_request) Successful in 2m59s
build-freebsd / release (pull_request) Has been skipped
ci / rust (push) Successful in 3m19s
ci / rust (pull_request) Successful in 3m18s
e24c96967f
The IPv6 receive test skips itself on a host without IPv6 and says so;
with --show-output that notice is in the job log, so it is visible
whether the FreeBSD runner really exercised IPV6_PKTINFO.

Co-Authored-By: Claude Fable 5.2 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01Vh6img4RYU1F52VUwGJcrp
Author
Collaborator

Nachtrag: was die CI auf dem FreeBSD-Runner tatsächlich geprüft hat

Dritter Commit (e24c969): cargo test … -- --show-output in beiden Workflows, damit im Job-Log steht, wenn sich ein Test mangels Voraussetzung überspringt. Ergebnis (Jobs 723 FreeBSD, 725 Docker), alle 60 Tests grün:

Empfangspfad FreeBSD 15 (Runner) Linux (Docker)
IPv4, an die Gruppe: Zieladresse + Interface (IP_RECVDSTADDR/IP_RECVIF bzw. IP_PKTINFO) geprüft geprüft
IPv4, Unicast geprüft geprüft
IPv4, abgeschnittenes Datagramm geprüft geprüft
IPv6, Unicast (IPV6_PKTINFO) geprüft geprüft
IPv6, an die Gruppe übersprungen übersprungen

Der letzte Fall lässt sich auf beiden Hosts nicht über das Loopback-Interface testen: Senden an ff02::fb über lo0/lo scheitert dort (No route to host bzw. Network is unreachable). Die Auswertung der Kontrollnachricht ist dieselbe wie im geprüften Unicast-Fall; ungeprüft bleibt nur, dass FreeBSD als Zieladresse genau ff02::fb meldet.

Damit ist die Formulierung oben unter „Nicht getestet" zu IPv6 präziser: Unicast-Empfang ist auf beiden Systemen getestet, Multicast-Empfang über IPv6 nicht. Woran man es auf einer Firewall sähe, falls es dort nicht stimmt: im Debug-Log stünden Zeilen datagram ignored … dst=ff02:… reason=unicast, and not a response.

**Nachtrag: was die CI auf dem FreeBSD-Runner tatsächlich geprüft hat** Dritter Commit (e24c969): `cargo test … -- --show-output` in beiden Workflows, damit im Job-Log steht, wenn sich ein Test mangels Voraussetzung überspringt. Ergebnis (Jobs 723 FreeBSD, 725 Docker), alle 60 Tests grün: | Empfangspfad | FreeBSD 15 (Runner) | Linux (Docker) | |---|---|---| | IPv4, an die Gruppe: Zieladresse + Interface (`IP_RECVDSTADDR`/`IP_RECVIF` bzw. `IP_PKTINFO`) | geprüft | geprüft | | IPv4, Unicast | geprüft | geprüft | | IPv4, abgeschnittenes Datagramm | geprüft | geprüft | | IPv6, Unicast (`IPV6_PKTINFO`) | geprüft | geprüft | | IPv6, an die Gruppe | **übersprungen** | **übersprungen** | Der letzte Fall lässt sich auf beiden Hosts nicht über das Loopback-Interface testen: Senden an `ff02::fb` über `lo0`/`lo` scheitert dort (`No route to host` bzw. `Network is unreachable`). Die Auswertung der Kontrollnachricht ist dieselbe wie im geprüften Unicast-Fall; ungeprüft bleibt nur, dass FreeBSD als Zieladresse genau `ff02::fb` meldet. Damit ist die Formulierung oben unter „Nicht getestet" zu IPv6 präziser: Unicast-Empfang ist auf beiden Systemen getestet, Multicast-Empfang über IPv6 nicht. Woran man es auf einer Firewall sähe, falls es dort nicht stimmt: im Debug-Log stünden Zeilen `datagram ignored … dst=ff02:… reason=unicast, and not a response`.
jochen approved these changes 2026-11-12 13:25:06 +00:00
jochen merged commit 4b36c064cd into master 2026-11-12 13:25:34 +00:00
jochen deleted branch fix/capture-source-check 2026-11-12 13:25:35 +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!35
No description provided.