Saltar al contenido
Dialova

Documentación IRC · Avanzado

Comando CAP: listar y negociar extensiones IRC

CAP es el comando para negociar extensiones IRC. Permite que un cliente active los mecanismos que entiende. La guía IRCv3 CAP explica la máquina de estados; esta ficha recoge la sintaxis que puedes encontrar en un registro.

El equipo de Dialova · Verificado el

Sintaxis y parámetros #

Sintaxis del protocolo, sin la / del cliente
CAP <LS [302] | LIST | REQ :<capacités> | END>
ParámetroSignificado
LS 302Solicita la lista con el mecanismo moderno de anuncio, incluidos los valores y las respuestas que pueden dividirse en varias líneas.
REQSolicita activar las capacidades elegidas; ACK o NAK indica si la solicitud se acepta.
LIST / ENDLIST describe las capacidades activas; END pone fin a la suspensión del registro IRC.

Ejemplo comentado #

Intercambio IRC: C = cliente, S = servidor
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

Los apodos, hosts y textos de este intercambio son ficticios. El cliente puede mostrar las respuestas de forma más legible que las tramas presentadas.

Respuestas y posibles errores #

RespuestaSignificado
CAP LSLista ofrecida; un marcador * intermedio indica que continúa.
CAP ACK / NAKActivación aceptada o solicitud rechazada.
CAP LISTLista de capacidades activas.
ErrorCausa habitual
410Subcomando CAP no válido, según la implementación.
421Servidor antiguo que no reconoce CAP.

Permisos, compatibilidad y precauciones #

Un anuncio LS no activa nada. El cliente solo debe usar una capacidad cuando esté activada. CAP END no envía un mensaje a un canal: es un paso del proceso de conexión.

CAP también puede funcionar después del registro IRC. Los subcomandos, la versión anunciada y los avisos NEW/DEL deben interpretarse según la especificación. El valor de una capacidad, por ejemplo sasl=PLAIN, no es su nombre.

Preguntas frecuentes #

¿Por qué aparece CAP sin /? Aquí se muestra el protocolo; la interfaz gestiona este comando internamente.

¿CAP y 005 ISUPPORT hacen lo mismo? No: ISUPPORT describe propiedades y límites; CAP activa extensiones negociadas.

Fuentes y verificación

Los ejemplos usan apodos y dominios ficticios, salvo los puntos de conexión expresamente documentados. Las extensiones y los ajustes específicos de una red se indican en el texto.