pmossdp (0.2.3)
Installation
[registries.forgejo]
index = "sparse+ " # Sparse index
# index = " " # Git
[net]
git-fetch-with-cli = truecargo add pmossdp@0.2.3 --registry forgejoAbout this package
pmossdp
SSDP (Simple Service Discovery Protocol) pour UPnP : annonces NOTIFY, réponses et envois
M-SEARCH, écoute des annonces. Autonome et léger : utilisable depuis un agent embarqué.
Contenu
| Élément | Rôle |
|---|---|
SsdpServer |
Mode appareil : annonce des SsdpDevice (alive périodique, byebye à l'arrêt) et répond aux M-SEARCH |
SsdpDevice |
Identité d'un appareil annoncé (UUID, type, LOCATION, SERVER, types de notification) |
SsdpClient |
Mode point de contrôle : envoie des M-SEARCH, reçoit les annonces et les réponses (SsdpEvent) |
Organisation : lib.rs (réexports et constantes SSDP_MULTICAST_ADDR, SSDP_PORT, MAX_AGE),
server.rs, client.rs, device.rs, util.rs (date HTTP, hasard léger, attente interruptible,
jonction du groupe multicast).
Le client utilise un port éphémère pour ses recherches (les réponses arrivent en unicast) et écoute
séparément le port 1900, partagé avec le serveur, pour les annonces alive / byebye. Ne pas faire
partir les recherches du port 1900 : le noyau répartirait les réponses entre les sockets liés à ce
port. Le port 1900 est partagé (SO_REUSEADDR + SO_REUSEPORT) avec le serveur et les autres
applications UPnP, et le multicast est livré à chaque socket. Voir la documentation de SsdpClient
(rustdoc).
Utilisation
[dependencies]
pmossdp = { version = "0.2", registry = "pmo" }
use pmossdp::{SsdpDevice, SsdpServer};
let device = SsdpDevice::new(
"0f3c…".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(),
);
let mut ssdp = SsdpServer::new();
ssdp.start()?;
ssdp.add_device(device);
# Ok::<(), std::io::Error>(())
Points d'attention :
- Un
matchsurSsdpEventprévoit une branche_(énumération#[non_exhaustive]). - Les messages SSDP illisibles sont ignorés (journal
trace!) : jamais d'erreur ni de panique côté réseau. - Jamais de
block_onni d'attente de verrou longue côté appelant dans un contexte asynchrone :add_deviceetremove_devicesont synchrones mais courts (aucune pause).
Adresse locale
Pour choisir l'interface multicast de sortie, le serveur et le client appellent
pmoutils::guess_local_ip(). Si elle échoue (aucune route, machine hors ligne), ils continuent
avec l'interface multicast par défaut et le signalent par un avertissement (tracing::warn!).
Dépendances
pmoutils(registrepmo) :guess_local_ip. En développement conjoint, un patch local (.cargo/config.toml, généré parmake) la résout verspmo/pmoutils; en cas de montée de version mineure depmoutils, remonter l'exigence dansCargo.toml.socket2: options de socket (SO_REUSEADDR,SO_REUSEPORT, interface multicast).if-addrs: interfaces à rejoindre en multicast.tracing.
Développement
make help # commandes (kit crate-kit)
make ci # fmt-check + clippy + tests + doc
make jjrelease # release : pousse et tague (workflow Gitea ensuite)
Les tests unitaires couvrent les parseurs purs (en-têtes, max-age, NOTIFY / réponses / M-SEARCH,
ST), SsdpDevice et les utilitaires. tests/multicast.rs joue le serveur, le client et un émetteur
brut sur le réseau réel (port 1900) ; un sondage préalable ignore les scénarios quand le multicast est
inutilisable (PMOSSDP_MULTICAST_REQUIS=1 force l'échec). Ces tests partagent le port : ils
s'exécutent l'un après l'autre (verrou de série).
Plateformes : Unix et Windows (SO_REUSEPORT positionné sous Unix par socket2).
Licence
CeCILL v2.1 (voir LICENSE, traduction anglaise : LICENSE.en).
Dependencies
| ID | Version |
|---|---|
| if-addrs | ^0.15 |
| pmoutils | ^0.2 |
| socket2 | ^0.6 |
| tracing | ^0.1 |