6
server
crate-kit edited this page 2026-11-14 04:21:21 +00:00
Table of contents
pmossdp > server
Module: server
Contents
Structs
SsdpServer- Serveur SSDP : annonce des appareils (SsdpDevice) et répond auxM-SEARCH.
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
startouvre 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 desM-SEARCH. Un second appel est sans effet.add_deviceenregistre un appareil et envoie tout de suite unNOTIFY ssdp:alivepar type de notification (puis une seconde série après environ 300 ms, UDP n'étant pas fiable) ;remove_deviceenvoie lesssdp: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), unbyebyeest 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:allreç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 etMXsecondes (MXplafonné à 5). Une recherche sansMXest 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
LOCATIONpar interface. LesNOTIFYpartent sur chaque interface IPv4 active hors boucle locale, avec l'adresse de la machine sur ce réseau ; la réponse à unM-SEARCHporte l'adresse qui joint le demandeur (SsdpDevice::location_for). UneLOCATIONà hôte nom, à boucle locale, ou déclarée avecSsdpDevice::with_fixed_locationreste telle quelle. Un demandeur IPv6 reçoit laLOCATIONtelle que donnée.- UPnP 1.1 sur demande.
BOOTID.UPNP.ORGetCONFIGID.UPNP.ORG, exigés d'un appareil 1.1, ne sont émis que pour les appareils déclarés avecSsdpDevice::with_config_id; les autres se présentent avec le comportement de la version 1.0.BOOTID.UPNP.ORGest 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 avantstart.fn start(self: & mut Self) -> std::io::Result<()>- Ouvre le socket SSDP, rejoint le groupe multicast, annonce les appareils déjà enregistrésfn add_device(self: &Self, device: SsdpDevice)- Enregistre un appareil et l'annonce : unNOTIFY ssdp:alivepar type de notification,fn remove_device(self: &Self, uuid: &str)- Retire l'appareil d'uuiddonné (sans le préfixeuuid:) et envoie unNOTIFY 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