Dokumentacja IRC · Zaawansowany
Negocjowanie możliwości przez CAP
Negocjowanie CAP pozwala wybrać rozszerzenia obsługiwane przez klienta. Lista serwera jest propozycją, a nie automatyczną aktywacją. Poprawna maszyna stanów jest niezbędna przy SASL i listach możliwości podzielonych na części.
Zespół Dialovy · Sprawdzono
Odczytaj pełną listę #
CAP LS 302 prosi o nowoczesne ogłoszenie. Serwer może wysłać kilka linii; parametr * po LS oznacza kolejną część. Zbierz pełną listę przed podjęciem decyzji. Wartość taka jak sasl=PLAIN,EXTERNAL opisuje mechanizmy, ale żądaną nazwą pozostaje sasl.
C: CAP LS 302
C: NICK Alice
C: USER alice 0 * :Alice
S: :irc.example CAP * LS * :message-tags server-time
S: :irc.example CAP * LS :batch sasl=PLAIN,EXTERNALWłączaj tylko obsługiwane funkcje #
Klient wybiera listę i wysyła CAP REQ. ACK potwierdza aktywację, a NAK odrzuca żądanie. Nie traktuj samego ogłoszenia możliwości jako jej włączenia. Nie przepisuj bezmyślnie wartości otrzymanych w LS do REQ.
C: CAP REQ :server-time sasl
S: :irc.example CAP Alice ACK :server-time saslW trakcie rejestracji CAP wstrzymuje jej zakończenie. Wykonaj przewidziane uwierzytelnianie, a następnie wyślij CAP END, aby umożliwić dalszy ciąg. Interfejs nie powinien ogłaszać połączenia tylko dlatego, że otwarto gniazdo TLS.
Po rejestracji i przy zmianach #
CAP LIST pokazuje aktywne możliwości. CAP REQ można używać również po rejestracji. Powiadomienia CAP NEW i CAP DEL należą do mechanizmu cap-notify: niedostępność usługi może zmienić ofertę serwera. Klient powinien zaktualizować stan, a nie zachowywać się tak, jakby wycofana możliwość nadal działała.
Dla starszego serwera bez CAP klient może przewidzieć klasyczną ścieżkę połączenia. Jeśli zasady wymagają uwierzytelnienia przed dostępem, ciche przejście na słabszy wariant nie jest odpowiednim rozwiązaniem.
Przykład praktycznej konsekwencji #
W Ergo negocjowanie jawnie żądanej historii może wyłączyć automatyczne przesyłanie pominiętych wiadomości. Klient ogłaszający tę możliwość musi więc obsługiwać wymagane odzyskiwanie historii, a nie tylko rozpoznawać nazwę. Dialova przechowuje następnie internetowe prywatne rozmowy we własnej historii: zadania serwera i aplikacji pozostają odrębne.
Ź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.
- IRCv3 — negocjacja możliwości klienta ↗Źródło specyfikacji · dostęp 2026-10-29
- Ergo — oficjalna prezentacja ↗Źródło oficjalne · dostęp 2026-10-29
- IRCv3 — chathistory, specyfikacja w rozwoju ↗Źródło specyfikacji · dostęp 2026-10-29