FreeBSD-Paket mdns-bridged mit rc.d-Dienst #19

Merged
jochen merged 4 commits from feat/freebsd-pkg into master 2026-11-10 19:25:59 +00:00
Collaborator

Refs #14 — Schritt 1 von 3 (Daemon-Paket; danach Plugin os-mdns-bridge, dann pkg-Repo).

Paket mdns-bridged

Datei Zweck
/usr/local/bin/mdns-bridged Daemon
/usr/local/etc/rc.d/mdns_bridged rc-Skript
/usr/local/etc/mdns-bridge.toml.sample Beispielkonfiguration
/usr/local/share/doc/mdns-bridged/ README, LICENSE

rc-Skript: startet den Daemon unter daemon(8) als unprivilegierter User mdnsbridge — Neustart nach Absturz (-R 5), Ausgabe nach syslog (Tag mdns_bridged). service mdns_bridged report liefert den JSON-Status. rc.conf: mdns_bridged_enable, _config, _user, _group, _env.

Manifest: legt User/Gruppe mdnsbridge beim Installieren an, Hinweis auf fehlende Config nach der Installation. Alle Dateien root:wheel.

Status-Socket: Default auf FreeBSD jetzt /var/run/mdns-bridged/mdns-bridged.sock statt /var/run/mdns-bridged.sock — /var/run ist für den Daemon-User nicht beschreibbar, das rc-Skript legt das Unterverzeichnis passend an. Beispielkonfigurationen angepasst.

Version: aus Cargo.toml; bei Tag-Push muss vX.Y.Z passen (sonst Abbruch), sonst Snapshot X.Y.Z.s<Run>.

Workflow build-freebsd

  • läuft zusätzlich bei PRs, die Code, Paketierung oder den Workflow ändern
  • baut das Paket und prüft:
    • ABI FreeBSD:15:* (passend zur OPNsense-Basis)
    • alle Dateien root:wheel (nicht der Runner-User)
    • Binary linkt nur gegen Base-Bibliotheken (keine pkg-Abhängigkeiten nötig)
  • Artefakt mdns-bridged-pkg-freebsd15; bei Tags zusätzlich ans Release

Getestet

  • Lokal: fmt, clippy, 12 Tests, FreeBSD-cargo check; shellcheck für rc-Skript und Build-Skript
  • build-pkg.sh mit gestubbtem pkg unter Linux: Staging, Dateirechte (0555/0644), Platzhalter ersetzt, Version Snapshot/Tag, Abbruch bei Tag-Mismatch, Temp-Verzeichnis aufgeräumt
  • Echter pkg create + Prüfungen: dieser PR-Lauf auf dem FreeBSD-15-Runner

Noch nicht getestet: Installation auf OPNsense (pkg add, Dienststart als mdnsbridge, service mdns_bridged report) — bitte einmal auf einer Box oder OPNsense-VM, Befehle im README.

🤖 Generated with Claude Code

https://claude.ai/code/session_01Vh6img4RYU1F52VUwGJcrp

Refs #14 — Schritt 1 von 3 (Daemon-Paket; danach Plugin `os-mdns-bridge`, dann pkg-Repo). ## Paket `mdns-bridged` | Datei | Zweck | |---|---| | `/usr/local/bin/mdns-bridged` | Daemon | | `/usr/local/etc/rc.d/mdns_bridged` | rc-Skript | | `/usr/local/etc/mdns-bridge.toml.sample` | Beispielkonfiguration | | `/usr/local/share/doc/mdns-bridged/` | README, LICENSE | **rc-Skript:** startet den Daemon unter `daemon(8)` als unprivilegierter User `mdnsbridge` — Neustart nach Absturz (`-R 5`), Ausgabe nach syslog (Tag `mdns_bridged`). `service mdns_bridged report` liefert den JSON-Status. rc.conf: `mdns_bridged_enable`, `_config`, `_user`, `_group`, `_env`. **Manifest:** legt User/Gruppe `mdnsbridge` beim Installieren an, Hinweis auf fehlende Config nach der Installation. Alle Dateien `root:wheel`. **Status-Socket:** Default auf FreeBSD jetzt `/var/run/mdns-bridged/mdns-bridged.sock` statt `/var/run/mdns-bridged.sock` — `/var/run` ist für den Daemon-User nicht beschreibbar, das rc-Skript legt das Unterverzeichnis passend an. Beispielkonfigurationen angepasst. **Version:** aus `Cargo.toml`; bei Tag-Push muss `vX.Y.Z` passen (sonst Abbruch), sonst Snapshot `X.Y.Z.s<Run>`. ## Workflow `build-freebsd` - läuft zusätzlich bei PRs, die Code, Paketierung oder den Workflow ändern - baut das Paket und prüft: - ABI `FreeBSD:15:*` (passend zur OPNsense-Basis) - alle Dateien `root:wheel` (nicht der Runner-User) - Binary linkt nur gegen Base-Bibliotheken (keine pkg-Abhängigkeiten nötig) - Artefakt `mdns-bridged-pkg-freebsd15`; bei Tags zusätzlich ans Release ## Getestet - Lokal: fmt, clippy, 12 Tests, FreeBSD-`cargo check`; `shellcheck` für rc-Skript und Build-Skript - `build-pkg.sh` mit gestubbtem `pkg` unter Linux: Staging, Dateirechte (0555/0644), Platzhalter ersetzt, Version Snapshot/Tag, Abbruch bei Tag-Mismatch, Temp-Verzeichnis aufgeräumt - **Echter `pkg create` + Prüfungen:** dieser PR-Lauf auf dem FreeBSD-15-Runner **Noch nicht getestet:** Installation auf OPNsense (`pkg add`, Dienststart als `mdnsbridge`, `service mdns_bridged report`) — bitte einmal auf einer Box oder OPNsense-VM, Befehle im README. 🤖 Generated with [Claude Code](https://claude.com/claude-code) https://claude.ai/code/session_01Vh6img4RYU1F52VUwGJcrp
FreeBSD package mdns-bridged with rc.d service
Some checks failed
ci / rust (push) Has been cancelled
24c847e415
- packaging/freebsd: rc.d script (daemon(8) supervisor, restart on
  crash, syslog tag mdns_bridged, runs as unprivileged user mdnsbridge,
  `service mdns_bridged report` for the JSON status), +MANIFEST template
  (creates user/group in pre-install), plist with root:wheel ownership,
  sample config, build-pkg.sh (version from Cargo.toml, tag must match,
  snapshot suffix .s<run> otherwise)
- Status socket default on FreeBSD moves to
  /var/run/mdns-bridged/mdns-bridged.sock; the rc script creates that
  directory for the daemon user (/var/run itself is root-only)
- build-freebsd workflow: also runs on PRs touching code/packaging;
  builds the pkg and checks ABI (FreeBSD:15:*), root:wheel ownership of
  all files and base-only linkage; uploads the package and attaches it
  to releases
- README: install instructions for OPNsense/FreeBSD

Refs #14

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01Vh6img4RYU1F52VUwGJcrp
FreeBSD: status socket in /var/run/mdns-bridged/, README install docs
All checks were successful
ci / rust (push) Successful in 2m42s
build-freebsd / freebsd (pull_request) Successful in 2m37s
build-freebsd / release (pull_request) Has been skipped
ci / rust (pull_request) Successful in 2m43s
374cf64af8
- Default status_socket on FreeBSD is now
  /var/run/mdns-bridged/mdns-bridged.sock (directory created by the rc
  script for the unprivileged daemon user)
- README: package install section, build-freebsd CI description

Refs #14

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01Vh6img4RYU1F52VUwGJcrp
rc.d: move pidfile into /var/run/mdns-bridged/
All checks were successful
build-freebsd / freebsd (pull_request) Successful in 2m35s
build-freebsd / release (pull_request) Has been skipped
ci / rust (push) Successful in 2m38s
ci / rust (pull_request) Successful in 2m37s
2c647d2d61
daemon(8) drops privileges (-u) before writing the supervisor pidfile,
so starting failed on OPNsense with
  daemon: ppidfile `/var/run/mdns_bridged.pid': Permission denied
The pidfile now lives in the runtime directory that the start_precmd
creates for the daemon user, next to the status socket.

Refs #14

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01Vh6img4RYU1F52VUwGJcrp
rc.d: don't pass -u to daemon(8), rc.subr already switches user
All checks were successful
build-freebsd / freebsd (pull_request) Successful in 2m38s
ci / rust (push) Successful in 2m40s
build-freebsd / release (pull_request) Has been skipped
ci / rust (pull_request) Successful in 2m37s
12bceef9ca
mdns_bridged_user is rc.subr's ${name}_user, so rc.subr starts daemon(8)
via `su -m mdnsbridge` already. The extra `daemon -u mdnsbridge` then
tried to switch users again without root:
  initgroups(mdnsbridge,2000): Operation not permitted
The supervisor kept running (so `service status` said "running"), but
mdns-bridged itself never started and no status socket was created.
This was also the root cause of the earlier pidfile permission error.

Refs #14

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

Auf OPNsense (FreeBSD 15.1-RELEASE-p6) getestet ✅

Beim Test gefunden und behoben:

  1. daemon: ppidfile /var/run/mdns_bridged.pid: Permission denied → pidfile liegt jetzt in /var/run/mdns-bridged/ (2c647d2)
  2. initgroups(mdnsbridge,2000): Operation not permitted — eigentliche Ursache: mdns_bridged_user ist rc.subrs ${name}_user, rc.subr startet daemon(8) also schon per su -m mdnsbridge; das zusätzliche daemon -u wollte ein zweites Mal wechseln. Folge: Supervisor lief (status = running), mdns-bridged selbst nie, daher kein Status-Socket. -u entfernt (12bceef)

Nach dem Fix: service mdns_bridged start/status/report funktionieren, Daemon läuft als mdnsbridge.

Hinweis für bestehende Configs: steht dort noch status_socket = "/var/run/mdns-bridged.sock", auf /var/run/mdns-bridged/mdns-bridged.sock ändern oder die Zeile löschen (Default).

**Auf OPNsense (FreeBSD 15.1-RELEASE-p6) getestet** ✅ Beim Test gefunden und behoben: 1. `daemon: ppidfile /var/run/mdns_bridged.pid: Permission denied` → pidfile liegt jetzt in `/var/run/mdns-bridged/` (2c647d2) 2. `initgroups(mdnsbridge,2000): Operation not permitted` — eigentliche Ursache: `mdns_bridged_user` ist rc.subrs `${name}_user`, rc.subr startet `daemon(8)` also schon per `su -m mdnsbridge`; das zusätzliche `daemon -u` wollte ein zweites Mal wechseln. Folge: Supervisor lief (`status` = running), `mdns-bridged` selbst nie, daher kein Status-Socket. `-u` entfernt (12bceef) Nach dem Fix: `service mdns_bridged start/status/report` funktionieren, Daemon läuft als `mdnsbridge`. Hinweis für bestehende Configs: steht dort noch `status_socket = "/var/run/mdns-bridged.sock"`, auf `/var/run/mdns-bridged/mdns-bridged.sock` ändern oder die Zeile löschen (Default).
jochen approved these changes 2026-11-10 19:11:09 +00:00
jochen merged commit f6dcbfaa6c into master 2026-11-10 19:25:59 +00:00
jochen deleted branch feat/freebsd-pkg 2026-11-10 19:26:00 +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!19
No description provided.