pmoutils > process
Module: process
Contents
Structs
ProcessPortInfo- Informations sur un processus utilisant un port réseau.
Enums
TransportProtocol- Protocole de transport utilisé pour la recherche.
Functions
find_process_using_port- Tente de trouver le processus qui écoute surportpour le protocole donné.
pmoutils::process::ProcessPortInfo
Struct
Informations sur un processus utilisant un port réseau.
Instantané pris au moment de l'appel de find_process_using_port : le processus peut
avoir disparu ou changé de port depuis.
Fields:
pid: u32- Identifiant du processus (PID) tel que rapporté par le système.process_name: String- Nom du processus (nom de l'exécutable, tel que le fournitsysinfo, sans cheminowner: String- Nom de l'utilisateur propriétaire du processus, ou"unknown"si l'utilisateurport: u16- Port local recherché (celui passé àfind_process_using_port).
Traits: Eq
Trait Implementations:
- Debug
fn fmt(self: &Self, f: & mut $crate::fmt::Formatter) -> $crate::fmt::Result
- PartialEq
fn eq(self: &Self, other: &Self) -> bool
- Clone
fn clone(self: &Self) -> Self
pmoutils::process::TransportProtocol
Enum
Protocole de transport utilisé pour la recherche.
Sélectionne la table de sockets interrogée par find_process_using_port : un même
numéro de port peut être occupé simultanément en TCP par un processus et en UDP par
un autre.
Variants:
Tcp- Sockets TCP (IPv4 et IPv6).Udp- Sockets UDP (IPv4 et IPv6).
Traits: Eq, Copy
Trait Implementations:
- Hash
fn hash<__H>(self: &Self, state: & mut __H)
- PartialEq
fn eq(self: &Self, other: &Self) -> bool
- Clone
fn clone(self: &Self) -> Self
- Debug
fn fmt(self: &Self, f: & mut $crate::fmt::Formatter) -> $crate::fmt::Result
pmoutils::process::find_process_using_port
Function
Tente de trouver le processus qui écoute sur port pour le protocole donné.
« Écoute » signifie : en TCP, un socket à l'état LISTEN ; en UDP, un socket lié à
ce port local (UDP n'a pas d'état de connexion). Les connexions TCP établies, en
attente de fermeture, etc., ne sont pas retournées, même si leur port local est
port (c'est le cas du port éphémère d'un client).
Arguments
protocol- Table de sockets à interroger (TCP ou UDP)port- Port local recherché
Returns
Some(ProcessPortInfo) si un socket local sur ce port a été trouvé et que son
processus a pu être résolu ; None sinon. None ne signifie donc pas que le port est
libre : il peut aussi indiquer que la table des sockets ou celle des processus n'a pas pu être
lue, ou que le système ne donne pas le PID (droits insuffisants, processus terminé
entre-temps).
Fonctionnement
- Lit la table des sockets IPv4 et IPv6 du protocole demandé (
netstat2) - Pour chaque socket à l'écoute sur
port, résout ses PID associés dans l'ordre (sysinfo, en ne rafraîchissant que ce processus) et le nom d'utilisateur du propriétaire (users) - Retourne le premier PID dont le processus est résolu
Limites
- Si plusieurs processus partagent le port (
SO_REUSEPORT, interfaces différentes), un seul est retourné, sans ordre garanti. - Si un socket est partagé par plusieurs processus (socket hérité par un processus fils), le premier PID résolu est retourné.
- Chaque appel relit la table des sockets du système et interroge chaque PID concerné : le coût dépend du nombre de sockets ouverts sur la machine.
- Sur certains systèmes, l'association socket → processus d'un autre utilisateur exige des droits élevés.
Examples
use pmoutils::{find_process_using_port, TransportProtocol};
match find_process_using_port(TransportProtocol::Udp, 1900) {
Some(p) => println!("1900/udp : {} (pid {}, utilisateur {})", p.process_name, p.pid, p.owner),
None => println!("1900/udp : aucun processus identifié"),
}
fn find_process_using_port(protocol: TransportProtocol, port: u16) -> Option<ProcessPortInfo>