Aller au contenu
Dialova

Documentation IRC · Intermédiaire

Comprendre les réponses numériques IRC

Une réponse numérique est un message dont la commande est un code à trois chiffres. Le code et les paramètres portent la structure ; le dernier texte explicatif est destiné à l’affichage et peut varier selon le serveur ou sa langue.

Équipe Dialova · Vérifié le

Lire la structure plutôt que parser une phrase #

Réponses NAMES adressées au client Alice
:irc.example 353 Alice = #atelier :@Alice Bob
:irc.example 366 Alice #atelier :End of /NAMES list

353 est ici la commande numérique. Alice est le destinataire de la réponse ; #atelier et la liste de pseudos sont des paramètres utiles au client. La phrase de fin de liste n’est pas un identifiant stable à reconnaître mot pour mot.

Quelques repères courants #

CodeUsagePoint d’attention
001Bienvenue après inscriptionNe pas l’assimiler à la seule ouverture TCP.
005ISUPPORTDécrit des propriétés du serveur ; ce n’est pas CAP ACK.
311 / 318Début des informations WHOIS et finPlusieurs réponses peuvent s’intercaler.
332 / 333Sujet et métadonnées associées333 est une pratique répandue, pas toute la réponse TOPIC à elle seule.
353 / 366Liste NAMES et finLa liste peut être fractionnée.
401Cible introuvableNe donne pas de droit de contourner la politique du réseau.
482Droits de salon insuffisantsVérifier le rôle réel, pas seulement le menu client.
903 / 904Succès / échec SASLLes codes 9xx ne sont donc pas tous des succès.

Réponses historiques et extensions #

Les RFC décrivent un socle historique, pas toutes les réponses actuelles. Les IRCd et extensions ajoutent des codes ; un client doit pouvoir les afficher ou les ignorer proprement sans inventer une interprétation. WHOIS peut ainsi exposer des informations supplémentaires selon le réseau et les droits.

Les familles 4xx et 5xx contiennent de nombreuses erreurs, mais cette heuristique ne remplace pas la documentation du mécanisme. Des extensions modernes utilisent également des réponses structurées comme FAIL, WARN ou NOTE.

Associer la réponse à la bonne action #

Un client peut recevoir des événements et plusieurs réponses en même temps. Ne supposez pas que « le prochain message reçu » est la réponse à la dernière commande. Respectez les paramètres de cible et les marqueurs de fin ; labeled-response, lorsqu’il est disponible, répond à des besoins de corrélation plus avancés.

Sources et vérification

Les exemples utilisent des pseudos et domaines fictifs, sauf les points de connexion explicitement documentés. Les extensions et réglages propres à un réseau sont signalés dans le texte.