Aller au contenu
Dialova

Documentation IRC · Avancé

Commande CAP : lister et négocier les extensions

CAP est la commande de négociation des extensions IRC. Elle permet à un client d’activer les mécanismes qu’il comprend. Le guide IRCv3 CAP détaille la machine d’état ; cette fiche donne la syntaxe à reconnaître dans un journal.

Équipe Dialova · Vérifié le

Syntaxe et paramètres #

Syntaxe protocolaire, sans le / du client
CAP <LS [302] | LIST | REQ :<capacités> | END>
ParamètreSignification
LS 302Demande la liste avec le mécanisme moderne d’annonce, y compris les valeurs et réponses éventuellement fractionnées.
REQDemande l’activation des capacités choisies ; ACK ou NAK répond au choix.
LIST / ENDLIST décrit les capacités actives ; END termine la suspension de l’inscription.

Exemple commenté #

Échange IRC : C = client, S = serveur
C: CAP LS 302
C: NICK Alice
C: USER alice 0 * :Alice
S: :irc.example CAP * LS :message-tags server-time
C: CAP REQ :server-time
S: :irc.example CAP Alice ACK :server-time
C: CAP END

Les pseudos, hôtes et textes de cet échange sont fictifs. Le client peut afficher les réponses sous une forme plus lisible que les trames présentées.

Réponses et erreurs possibles #

RéponseÀ comprendre
CAP LSListe proposée ; le marqueur * intermédiaire indique qu’elle continue.
CAP ACK / NAKActivation acceptée ou demande refusée.
CAP LISTListe des capacités actives.
ErreurCause habituelle
410Sous-commande CAP invalide selon l’implémentation.
421Serveur historique ne reconnaissant pas CAP.

Droits, compatibilité et précautions #

Une annonce LS n’active rien. Le client ne doit utiliser une capacité qu’après son activation. CAP END n’envoie pas un message à un salon : c’est une étape de la connexion.

CAP peut aussi fonctionner après inscription. En revanche, les sous-commandes, la version annoncée et les notifications NEW/DEL doivent être interprétées selon la spécification. La valeur d’une capacité, par exemple sasl=PLAIN, n’est pas son nom.

Questions fréquentes #

Pourquoi CAP apparaît-il sans / ? Il s’agit ici du protocole ; l’interface gère cette commande en interne.

CAP et 005 ISUPPORT font-ils la même chose ? Non : ISUPPORT décrit des propriétés et limites ; CAP active des extensions négociées.

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.