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 #
CAP <LS [302] | LIST | REQ :<mozliwosci> | END>| Parametr | Znaczenie |
|---|---|
| LS 302 | Prosi o listę z nowoczesnym mechanizmem ogłaszania, obejmującym wartości i ewentualne odpowiedzi podzielone na części. |
| REQ | Prosi o włączenie wybranych możliwości; odpowiedzią jest ACK lub NAK. |
| LIST / END | LIST opisuje aktywne możliwości, a END kończy wstrzymanie rejestracji połączenia. |
Przykład z objaśnieniem #
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 ENDNicki, 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 LS | Oferowana lista; pośredni znacznik * oznacza, że ma dalszy ciąg. |
| CAP ACK / NAK | Akceptacja włączenia lub odrzucenie żądania. |
| CAP LIST | Lista aktywnych możliwości. |
| Błąd | Typowa przyczyna |
|---|---|
| 410 | Nieprawidłowe podpolecenie CAP, zależnie od implementacji. |
| 421 | Starszy 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.
- Modern IRC — specyfikacja protokołu klienta ↗Źródło specyfikacji · dostęp 2026-10-29
- IRCv3 — negocjacja możliwości klienta ↗Źródło specyfikacji · dostęp 2026-10-29