2 pmomdns
crate-kit edited this page 2026-11-12 19:31:04 +00:00

pmomdns

Module: pmomdns

Contents

Functions

  • browse - L'abonnement aux événements de service_type (par exemple _raop._tcp.local.), vus par le démon

pmomdns::browse

Function

L'abonnement aux événements de service_type (par exemple _raop._tcp.local.), vus par le démon et par la recherche en unicast, qui trouve les appareils même quand leurs réponses multicast n'arrivent pas.

Autant d'abonnés qu'on veut peuvent suivre le même type : ils partagent une seule recherche et reçoivent tous les mêmes événements. Un abonné tardif reçoit d'abord les services déjà résolus (mais pas le SearchStarted du démon). Un service n'est rendu en ServiceResolved que lorsque sa description (hôte, port, adresses, TXT) change. Un ServiceRemoved n'est rendu qu'une fois par service : le démon le donne s'il voit le retrait ; la recherche en unicast le donne quand l'appareil dit au revoir ou reste sans répondre pendant silent_rounds tours, sauf si le démon décrit lui-même ce service (il fait alors foi).

Errors

  • PmomdnsError::DaemonCreation si le démon ne peut pas être créé ;
  • PmomdnsError::InvalidServiceType, PmomdnsError::DaemonBusy, PmomdnsError::DaemonStopped ou PmomdnsError::SubscriptionRefused si le démon refuse l'abonnement ;
  • PmomdnsError::Thread si un fil de recherche ne peut pas être lancé.
fn browse(service_type: &str) -> Result<Subscription>