6 server
crate-kit edited this page 2026-11-14 04:21:21 +00:00

pmossdp > server

Module: server

Contents

Structs


pmossdp::server::SsdpServer

Struct

Serveur SSDP : annonce des appareils (SsdpDevice) et répond aux M-SEARCH.

Le serveur écoute 0.0.0.0:1900 (port partagé avec les autres applications UPnP de la machine, grâce à SO_REUSEADDR et, sous Unix, SO_REUSEPORT), envoie les NOTIFY en multicast et répond en unicast aux recherches dont la cible (ST) correspond à un de ses appareils.

Fonctionnement

  • start ouvre le socket, rejoint le groupe multicast sur chaque interface IPv4 non bouclée, annonce les appareils déjà enregistrés et lance deux threads : annonces périodiques et écoute des M-SEARCH. Un second appel est sans effet.
  • add_device enregistre un appareil et envoie tout de suite un NOTIFY ssdp:alive par type de notification (puis une seconde série après environ 300 ms, UDP n'étant pas fiable) ; remove_device envoie les ssdp:byebye.
  • Les annonces sont renouvelées à intervalle aléatoire inférieur à MAX_AGE / 2 (entre 7 min 30 s et 15 min), comme le recommande la spécification UPnP 1.1.
  • À la destruction du serveur (Drop), un byebye est envoyé pour chaque appareil, puis les threads sont arrêtés et le socket fermé (l'attente peut atteindre une fraction de seconde).
  • Une recherche ssdp:all reçoit une réponse par type de notification de chaque appareil ; une recherche ciblée n'est suivie d'une réponse que si l'appareil annonce ce type. La réponse est retardée d'une durée aléatoire entre 0 et MX secondes (MX plafonné à 5). Une recherche sans MX est ignorée, comme l'exige la spécification.

Exemple

use pmossdp::{SsdpDevice, SsdpServer};

# fn main() -> std::io::Result<()> {
let mut ssdp = SsdpServer::new();
ssdp.start()?;
ssdp.add_device(SsdpDevice::new(
    "0f3c9a52-7b1e-4c43-9d57-2a1b6e0c8f10".into(),
    "urn:schemas-upnp-org:device:MediaRenderer:1".into(),
    "http://192.168.1.10:8080/desc.xml".into(),
    "Linux UPnP/1.1 MonApp/1.0".into(),
));
# Ok(())
# }

Limites

  • LOCATION par interface. Les NOTIFY partent sur chaque interface IPv4 active hors boucle locale, avec l'adresse de la machine sur ce réseau ; la réponse à un M-SEARCH porte l'adresse qui joint le demandeur (SsdpDevice::location_for). Une LOCATION à hôte nom, à boucle locale, ou déclarée avec SsdpDevice::with_fixed_location reste telle quelle. Un demandeur IPv6 reçoit la LOCATION telle que donnée.
  • UPnP 1.1 sur demande. BOOTID.UPNP.ORG et CONFIGID.UPNP.ORG, exigés d'un appareil 1.1, ne sont émis que pour les appareils déclarés avec SsdpDevice::with_config_id ; les autres se présentent avec le comportement de la version 1.0. BOOTID.UPNP.ORG est la date de première utilisation du serveur dans le processus (secondes Unix).
  • Interfaces figées au démarrage. Les groupes sont rejoints sur les interfaces présentes à l'appel de start.
  • IPv4 seulement.

Methods:

  • fn new() -> Self - Crée un serveur SSDP inactif : aucun socket n'est ouvert avant start.
  • fn start(self: & mut Self) -> std::io::Result<()> - Ouvre le socket SSDP, rejoint le groupe multicast, annonce les appareils déjà enregistrés
  • fn add_device(self: &Self, device: SsdpDevice) - Enregistre un appareil et l'annonce : un NOTIFY ssdp:alive par type de notification,
  • fn remove_device(self: &Self, uuid: &str) - Retire l'appareil d'uuid donné (sans le préfixe uuid:) et envoie un NOTIFY ssdp:byebye

Trait Implementations:

  • Drop
    • fn drop(self: & mut Self)
  • Default
    • fn default() -> Self
  • Debug
    • fn fmt(self: &Self, f: & mut $crate::fmt::Formatter) -> $crate::fmt::Result