10 process
crate-kit edited this page 2026-11-14 04:11:29 +00:00

pmoutils > process

Module: process

Contents

Structs

  • ProcessPortInfo - Informations sur un processus utilisant un port réseau.

Enums

Functions


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 fournit sysinfo, sans chemin
  • owner: String - Nom de l'utilisateur propriétaire du processus, ou "unknown" si l'utilisateur
  • port: 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

  1. Lit la table des sockets IPv4 et IPv6 du protocole demandé (netstat2)
  2. 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)
  3. 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>