Sari la conținut
Dialova

Documentație IRC · Avansat

Comanda CAP: listarea și negocierea extensiilor

CAP negociază extensiile IRC. Clientul poate activa mecanismele pe care le înțelege. Ghidul IRCv3 CAP detaliază mașina de stări; această fișă explică sintaxa de recunoscut într-un jurnal.

Echipa Dialova · Verificat la

Sintaxă și parametri #

Sintaxa protocolului, fără / din client
CAP <LS [302] | LIST | REQ :<capabilitati> | END>
ParametruSemnificație
LS 302Cere lista prin mecanismul modern, inclusiv valori și răspunsuri eventual fragmentate.
REQCere activarea capabilităților alese; ACK sau NAK răspunde cererii.
LIST / ENDLIST descrie capabilitățile active; END încheie suspendarea înregistrării.

Exemplu explicat #

Schimb IRC: C = client, S = server
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

Pseudonimele, gazdele și textele exemplului sunt fictive. Clientul poate afișa răspunsurile într-o formă mai lizibilă decât mesajele protocolului prezentate.

Răspunsuri și erori posibile #

RăspunsExplicație
CAP LSLista oferită; marcajul intermediar * arată continuarea.
CAP ACK / NAKActivare acceptată sau cerere refuzată.
CAP LISTLista capabilităților active.
EroareCauză obișnuită
410Subcomandă CAP incorectă, după implementare.
421Server istoric care nu recunoaște CAP.

Permisiuni, compatibilitate și precauții #

Anunțul LS nu activează nimic. Clientul nu trebuie să folosească o capabilitate înainte de activare. CAP END nu trimite mesaj într-un canal: este o etapă a conectării.

CAP poate funcționa și după înregistrare. Subcomenzile, versiunea și notificările NEW/DEL trebuie interpretate conform specificației. Valoarea capabilității, de exemplu sasl=PLAIN, nu este numele ei.

Întrebări frecvente #

De ce CAP apare fără /? Aici este protocolul; interfața gestionează intern comanda.

CAP și 005 ISUPPORT fac același lucru? Nu: ISUPPORT descrie proprietăți și limite; CAP activează extensii negociate.

Surse și verificare

Exemplele folosesc pseudonime și domenii fictive, cu excepția punctelor de conectare documentate explicit. Extensiile și setările specifice unei rețele sunt indicate în text.