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 #
CAP <LS [302] | LIST | REQ :<capabilitati> | END>| Parametru | Semnificație |
|---|---|
| LS 302 | Cere lista prin mecanismul modern, inclusiv valori și răspunsuri eventual fragmentate. |
| REQ | Cere activarea capabilităților alese; ACK sau NAK răspunde cererii. |
| LIST / END | LIST descrie capabilitățile active; END încheie suspendarea înregistrării. |
Exemplu explicat #
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 ENDPseudonimele, 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ăspuns | Explicație |
|---|---|
| CAP LS | Lista oferită; marcajul intermediar * arată continuarea. |
| CAP ACK / NAK | Activare acceptată sau cerere refuzată. |
| CAP LIST | Lista capabilităților active. |
| Eroare | Cauză obișnuită |
|---|---|
| 410 | Subcomandă CAP incorectă, după implementare. |
| 421 | Server 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.
- Modern IRC — specificația protocolului pentru clienți ↗Sursă de specificație · consultată la 2026-10-29
- IRCv3 — negocierea capabilităților clientului ↗Sursă de specificație · consultată la 2026-10-29