Saltar para o conteúdo
Dialova

Documentação IRC · Intermédio

Comando MODE: consultar e alterar os modos IRC

MODE consulta ou altera propriedades de um utilizador ou de um canal. As letras disponíveis, os argumentos e as permissões necessárias dependem do servidor. Antes de interpretares uma sequência de modos, verifica o destino e a informação da rede.

A equipa do Dialova · Verificado em

Sintaxe e parâmetros #

Sintaxe do protocolo, sem a / do cliente
MODE <pseudo-ou-salon> [<modes> [<paramètres>...]]
ParâmetroSignificado
destinoPseudónimo para os modos de utilizador ou nome do canal para os modos de canal.
modosLetras precedidas de + ou -, por exemplo +m ou -m.
parâmetrosArgumentos dos modos; alguns exigem-nos sempre, outros apenas ao ativar e outros nunca.

Exemplo comentado #

Troca IRC: C = cliente, S = servidor
C: MODE #atelier +m
S: :Alice!alice@cloak.example MODE #atelier +m
C: MODE #atelier +v Bob
S: :Alice!alice@cloak.example MODE #atelier +v Bob

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
324Modos atuais de um canal.
221Modos de utilizador.
367 / 368Entradas de ban e fim da lista, conforme o pedido.
MODEAlteração transmitida aos clientes envolvidos.
ErroCausa habitual
482Permissões insuficientes no canal.
472Letra de modo de canal desconhecida.
501 / 502Modo de utilizador desconhecido ou alteração de outro utilizador proibida.

Permissões, compatibilidade e cuidados #

Em muitas redes, +m restringe quem pode falar e +v dá voz a um membro. Ter voz não equivale ao estatuto de operador. PREFIX anuncia os prefixos e modos de nível; CHANMODES ajuda a classificar os argumentos dos restantes modos.

Não copies uma tabela de modos como se fosse uma norma universal. A mesma letra pode indicar funções diferentes: os níveis owner/protect/halfop e os seus símbolos não existem em todo o lado. Prevalecem os guias do IRCd e as regras da rede.

A resposta 005 ISUPPORT anuncia propriedades do servidor; não é uma negociação CAP. Um cliente deve conseguir processar modos desconhecidos sem inventar os seus efeitos.

Perguntas frequentes #

Posso tornar-me operador com MODE #salon +o MonPseudo? Não sem já ter as permissões adequadas. O comando, por si só, não concede permissões.

Como consulto os modos sem os alterar? Pede MODE apenas com o destino ou com uma letra de lista permitida pela documentação da rede.

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.