Перейти к содержимому
Dialova

Документация IRC · Продвинутый

Команда CAP: узнать и согласовать расширения

CAP согласует расширения IRC. С её помощью клиент включает поддерживаемые им механизмы. Раздел IRCv3 CAP подробно объясняет состояния обмена, а эта памятка помогает распознать синтаксис в журнале.

Команда Dialova · Проверено

Синтаксис и параметры #

Синтаксис протокола без клиентского /
CAP <LS [302] | LIST | REQ :<возможности> | END>
ПараметрЗначение
LS 302Запрашивает список в современном формате объявления, включая значения и ответы, которые могут состоять из нескольких сообщений.
REQЗапрашивает включение выбранных возможностей; сервер отвечает ACK или NAK.
LIST / ENDLIST перечисляет активные возможности; END завершает приостановку регистрации подключения.

Пример с пояснениями #

Обмен IRC: C — клиент, S — сервер
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

Ники, адреса и тексты примера вымышлены. Клиент может показывать ответы в более удобном виде, чем приведённые строки протокола.

Возможные ответы и ошибки #

ОтветЗначение
CAP LSПредлагаемый список; промежуточный маркер * означает продолжение.
CAP ACK / NAKВключение подтверждено или запрос отклонён.
CAP LISTСписок активных возможностей.
ОшибкаОбычная причина
410Недопустимая подкоманда CAP; ответ зависит от реализации.
421Старый сервер не распознаёт CAP.

Права, совместимость и меры предосторожности #

Объявление LS ничего не включает. Клиент использует возможность только после подтверждения её включения. CAP END — не сообщение в комнату, а этап установления подключения.

CAP может работать и после регистрации подключения. Однако подкоманды, объявленная версия и уведомления NEW/DEL должны обрабатываться по спецификации. Значение возможности, например sasl=PLAIN, не является её названием.

Частые вопросы #

Почему CAP написано без /? Здесь показан протокол. Интерфейс обрабатывает эту команду внутри клиента.

Выполняют ли CAP и 005 ISUPPORT одну задачу? Нет. ISUPPORT описывает свойства и ограничения, CAP включает согласуемые расширения.

Источники и проверка

В примерах используются вымышленные ники и домены, кроме явно указанных реальных точек подключения. Расширения и настройки отдельных сетей отмечены в тексте.