pmo

pmomdns (0.1.0)

Published 2026-11-12 07:17:14 +01:00 by eric

Installation

[registries.forgejo]
index = "sparse+" # Sparse index
# index = "" # Git

[net]
git-fetch-with-cli = true
cargo add pmomdns@0.1.0 --registry forgejo

About this package

Le démon mDNS unique du processus, avec recherche en unicast de secours : découverte AirPlay et Chromecast.

pmomdns

Le démon mDNS unique du processus, doublé d'une recherche en unicast de secours : la découverte des appareils AirPlay (_raop._tcp) et Chromecast (_googlecast._tcp) de PMOMusic.

Version Documentation

Fonctionnalités

  • Un seul ServiceDaemon (mdns-sd) par processus, créé au premier appel de daemon().
  • browse(type) : les événements d'un type de service, vus par le démon et par une recherche en unicast (RFC 6762 §6.7) qui trouve les appareils même quand leurs réponses multicast n'arrivent pas.
  • Ré-export de mdns_sd : une seule version de la bibliothèque pour tous les consommateurs.
  • Un type d'erreur unique, PmomdnsError.

Installation

[dependencies]
pmomdns = { version = "0.1", registry = "pmo" }

Depuis les sources : git clone du dépôt, puis cargo build. En développement conjoint avec pmomusic, make génère le patch local (.cargo/config.toml) qui résout pmomdns vers ce dossier.

Documentation

cargo doc --open, ou le wiki du dépôt (publié par la CI à chaque release).

use pmomdns::mdns_sd::ServiceEvent;

let events = pmomdns::browse("_raop._tcp.local.")?;
while let Ok(event) = events.recv() {
    if let ServiceEvent::ServiceResolved(service) = event {
        println!("{} : {:?}", service.get_fullname(), service.get_addresses());
    }
}
# Ok::<(), pmomdns::PmomdnsError>(())

Pour annoncer un service, on prend le démon partagé : pmomdns::daemon()?.register(info).

API

Élément Rôle
daemon() Le démon du processus (handle Clone), créé au premier appel, jamais arrêté
browse(service_type) Receiver<ServiceEvent> : démon + recherche unicast
mdns_sd Ré-export de la bibliothèque (ServiceEvent, ServiceInfo, ResolvedService…)
PmomdnsError Daemon(mdns_sd::Error) ou Thread { operation, source } ; #[non_exhaustive]
Result<T> Result<T, PmomdnsError>

Particularités

  • Un seul démon partagé. Un ServiceDaemon tient les sockets UDP 5353 et sa boucle : deux démons dans un processus, ce sont deux écouteurs et deux caches. Les consommateurs passent toujours par daemon(), jamais par ServiceDaemon::new().
  • browse() et non daemon()?.browse(). Le démon pose ses questions depuis le port 5353 ; les appareils répondent par multicast, ce qui n'arrive jamais sur certains réseaux (borne filtrant le multicast, macOS dont mDNSResponder tient le port). browse() ajoute une recherche en unicast. Conséquences : un service peut être rendu deux fois en ServiceResolved (traitement idempotent côté consommateur) ; la recherche unicast ne rend jamais de ServiceRemoved, c'est au démon.
  • Ré-export de mdns_sd. Les consommateurs ne déclarent pas mdns-sd eux-mêmes : la version est celle de pmomdns. Monter mdns-sd est donc un changement d'API de cette crate.
  • Contrainte flume / if-addrs. Le Receiver rendu par browse() est celui de flume 0.12, version de mdns-sd 0.21 : flume doit rester sur la même version que mdns-sd, pas celle d'un workspace voisin (0.11 dans pmomusic). if-addrs suit aussi mdns-sd, pour énumérer les interfaces comme lui. Les deux se montent avec mdns-sd.
  • Modules internes (privés) :
    • wire : le strict nécessaire du format DNS (fabriquer une question, lire PTR / SRV / TXT / A, compression de noms comprise) ;
    • catalog : accumule les enregistrements reçus, dit ce qui manque (SRV, TXT, A) et rend les services complets sous la forme ResolvedService de mdns-sd, une fois par changement ;
    • unicast : un fil par recherche, une prise UDP par interface IPv4 (port éphémère), questions à 1 s, 2 s puis toutes les 20 s.
  • Erreurs. Pas de repli silencieux : la création du démon et le lancement d'un fil échouent avec PmomdnsError. Un échec d'envoi d'une question unicast est ignoré (réseau tombé, interface sans multicast) : la question suivante réessaie.

Développement

make help   # commandes (kit crate-kit)
make ci     # fmt-check + clippy + tests + doc
cargo test live -- --ignored --nocapture   # recherche unicast sur un réseau réel avec appareils

Les tests unitaires sont dans src/tests/ (un fichier par module) ; tests/api.rs couvre l'API publique sans appareil. Le test live_unicast_search_finds_devices est #[ignore] : il demande un réseau avec des appareils AirPlay et Chromecast.

Dépendances

  • mdns-sd : démon mDNS, ServiceInfo, ResolvedService.
  • flume (0.12, features async) : canaux, même version que mdns-sd.
  • if-addrs : interfaces réseau, même version que mdns-sd.
  • socket2 : prises UDP liées à une interface (multicast sortant, TTL).
  • thiserror : PmomdnsError. tracing : journal de débogage.

License

CeCILL v2.1 (voir LICENSE, traduction anglaise : LICENSE.en).

Dependencies

ID Version
flume ^0.12
if-addrs ^0.15
mdns-sd ^0.21
socket2 ^0.6
thiserror ^2.0
tracing ^0.1

Keywords

mdns bonjour discovery airplay chromecast
Details
Cargo
2026-11-12 07:17:14 +01:00
0
CECILL-2.1
94 KiB
Assets (1)
Versions (2) View all
0.2.1 2026-11-12
0.1.0 2026-11-12