Przejdź do treści
Dialova

Dokumentacja IRC · Zaawansowany

Polecenie CAP: lista i negocjowanie rozszerzeń

CAP negocjuje rozszerzenia IRC. Pozwala klientowi włączyć mechanizmy, które potrafi obsłużyć. Przewodnik IRCv3 CAP opisuje szczegółowo maszynę stanów; ta strona przedstawia składnię spotykaną w logach.

Zespół Dialovy · Sprawdzono

Składnia i parametry #

Składnia protokołu, bez ukośnika używanego w kliencie
CAP <LS [302] | LIST | REQ :<mozliwosci> | END>
ParametrZnaczenie
LS 302Prosi o listę z nowoczesnym mechanizmem ogłaszania, obejmującym wartości i ewentualne odpowiedzi podzielone na części.
REQProsi o włączenie wybranych możliwości; odpowiedzią jest ACK lub NAK.
LIST / ENDLIST opisuje aktywne możliwości, a END kończy wstrzymanie rejestracji połączenia.

Przykład z objaśnieniem #

Wymiana IRC: C = klient, S = serwer
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

Nicki, hosty i teksty w przykładzie są fikcyjne. Klient może prezentować odpowiedzi czytelniej niż w surowych wiadomościach protokołu.

Możliwe odpowiedzi i błędy #

OdpowiedźZnaczenie
CAP LSOferowana lista; pośredni znacznik * oznacza, że ma dalszy ciąg.
CAP ACK / NAKAkceptacja włączenia lub odrzucenie żądania.
CAP LISTLista aktywnych możliwości.
BłądTypowa przyczyna
410Nieprawidłowe podpolecenie CAP, zależnie od implementacji.
421Starszy serwer nie rozpoznaje CAP.

Uprawnienia, zgodność i środki ostrożności #

Ogłoszenie LS niczego nie włącza. Klient może używać możliwości dopiero po jej aktywacji. CAP END nie wysyła wiadomości do kanału: to etap łączenia.

CAP może działać także po rejestracji połączenia. Podpolecenia, ogłoszoną wersję i powiadomienia NEW/DEL trzeba interpretować według specyfikacji. Wartość możliwości, na przykład sasl=PLAIN, nie jest jej nazwą.

Częste pytania #

Dlaczego CAP pojawia się bez /? To zapis protokołu; interfejs obsługuje polecenie wewnętrznie.

Czy CAP i 005 ISUPPORT robią to samo? Nie: ISUPPORT opisuje właściwości i limity, a CAP włącza negocjowane rozszerzenia.

Źródła i weryfikacja

Przykłady używają fikcyjnych nicków i domen, z wyjątkiem wyraźnie udokumentowanych punktów połączenia. Rozszerzenia i ustawienia właściwe danej sieci są zaznaczone w tekście.