ports
diapason.core.ports
¶
Qui tient un port, et qui descend de qui — d'après le système, pas d'après nous.
Ce module existe parce que quatre chemins de démarrage différents posaient la
même question et y répondaient chacun à leur façon : diapason start,
l'application de bureau, serve-service install et quickstart.sh. Trois
d'entre eux ne la posaient même pas, et lançaient un serveur par-dessus un
autre sans qu'aucune erreur ne soit rapportée.
Le principe : ne rien DÉDUIRE. Une liaison qui échoue, un 200 sur un port,
une ligne de commande recollée sont des indices, pas des preuves. On demande au
noyau, et quand il ne répond pas, on le dit au lieu de conclure.
descendants_of(racine)
¶
racine et toute sa descendance, d'après ps.
Un serveur peut être lancé derrière un lanceur (uv run), auquel cas le
processus qui tient le port n'est pas celui qu'on a lancé, mais son enfant.
listeners_on(port)
¶
Qui ÉCOUTE sur ce port, d'après le NOYAU. None = indéterminé.
Sonder en tentant des liaisons, c'est deviner : quatre adresses littérales ne couvriront jamais les N adresses d'une machine. MESURÉ — un serveur lié à 192.168.0.121, exactement ce que « serve-service install --allow-network » installe pour que le téléphone du maillage atteigne ce Mac, échappait aux quatre sondes, et « diapason start » en lançait tranquillement un second.
lsof répond pour toutes les adresses à la fois, et donne le PID du
détenteur — ce dont la confirmation d'après-lancement a besoin.
listeners_windows(port)
¶
Équivalent Windows de lsof, via netstat -ano.
NON VÉRIFIÉ sur cette machine, faute de Windows sous la main : la forme est
documentée, pas mesurée, à la différence du reste de ce fichier. Elle existe
surtout pour que start ne réponde pas « je ne sais pas » à l'infini là
où lsof n'existe pas — un garde qui refuse toujours de démarrer serait une
panne, pas une protection.
port_occupe_par_liaison(port)
¶
Dernier repli : tenter la liaison soi-même. None si on n'apprend rien.
Ne voit qu'un détenteur sur l'une des quatre formes essayées — c'est précisément la faiblesse qui a laissé passer un serveur lié à l'adresse du maillage. On ne s'en sert donc que si le système n'a pas su répondre.
SO_REUSEADDR seulement sur POSIX : il y ignore TIME_WAIT, sans quoi un
port qu'on vient de libérer paraîtrait pris. Sur Windows sa sémantique est
INVERSE — il autorise à se lier par-dessus un socket actif — et le poser
annulerait entièrement le contrôle.
port_state(port)
¶
État du port et description lisible du détenteur.
run_tool(argv, *, timeout=10.0)
¶
Lancer un utilitaire système. None si on n'a PAS PU demander.
La distinction compte : « je n'ai pas pu demander » n'est pas « la réponse est non ». Confondre les deux faisait effacer le fichier PID d'un serveur parfaitement vivant, qui devenait alors inarrêtable par la CLI.