Saltar para o conteúdo
Dialova

Documentação IRC · Avançado

Comando CAP: listar e negociar extensões IRC

CAP é o comando de negociação de extensões IRC. Permite que um cliente ative os mecanismos que compreende. O guia IRCv3 CAP explica a máquina de estados; esta ficha apresenta a sintaxe que podes encontrar num registo.

A equipa do Dialova · Verificado em

Sintaxe e parâmetros #

Sintaxe do protocolo, sem a / do cliente
CAP <LS [302] | LIST | REQ :<capacités> | END>
ParâmetroSignificado
LS 302Pede a lista com o mecanismo moderno de anúncio, incluindo os valores e as respostas que podem ser divididas em várias linhas.
REQPede a ativação das capacidades escolhidas; ACK ou NAK indica se o pedido é aceite.
LIST / ENDLIST descreve as capacidades ativas; END termina a suspensão do registo IRC.

Exemplo comentado #

Troca 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

Os pseudónimos, hosts e textos desta troca são fictícios. O cliente pode apresentar as respostas de forma mais legível do que as linhas de protocolo aqui mostradas.

Respostas e erros possíveis #

RespostaSignificado
CAP LSLista proposta; um marcador * intermédio indica que continua.
CAP ACK / NAKAtivação aceite ou pedido recusado.
CAP LISTLista de capacidades ativas.
ErroCausa habitual
410Subcomando CAP inválido, conforme a implementação.
421Servidor antigo que não reconhece CAP.

Permissões, compatibilidade e cuidados #

Um anúncio LS não ativa nada. O cliente só deve usar uma capacidade depois de a ativar. CAP END não envia uma mensagem para um canal: é uma etapa da ligação.

CAP também pode funcionar depois do registo IRC. Os subcomandos, a versão anunciada e os avisos NEW/DEL devem ser interpretados segundo a especificação. O valor de uma capacidade, por exemplo sasl=PLAIN, não é o seu nome.

Perguntas frequentes #

Porque aparece CAP sem /? Aqui é apresentado o protocolo; a interface trata deste comando internamente.

CAP e 005 ISUPPORT fazem o mesmo? Não: ISUPPORT descreve propriedades e limites; CAP ativa extensões negociadas.

Fontes e verificação

Os exemplos usam alcunhas e domínios fictícios, salvo os pontos de ligação expressamente documentados. As extensões e definições específicas de uma rede são assinaladas no texto.