Liste des commandes du service IRC ChanServ

ChanServ fait partie des services d'Anope. Anope est un ensemble de services conçus pour les réseaux IRC qui permettent à leurs utilisateurs de contrôler leurs pseudos et canaux d'une manière sécurisée et efficace, et aux administrateurs de gérer leur réseau avec des outils puissants.

ChanServ vous permet d'enregistrer et de contrôler divers aspects de vos canaux. Il empêche souvent des utilisateurs malveillants de faire des « take overs » (prises de pouvoir) sur les canaux en limitant qui est autorisé à être opérateur de canal.

Remarque : tout canal non utilisé pendant 45 jours (aucun utilisateur figurant sur la liste d'accès ne s'y étant présenté) sera automatiquement effacé.

Sommaire

• Prise en main
  • REGISTER
  • IDENTIFY
• Configuration du canal
  • SET (toutes les options)
• Gestion des accès
  • AOP / SOP / HOP / VOP
  • ACCESS
  • LEVELS
  • AKICK
• Statuts et privilèges
  • OWNER / DEOWNER
  • PROTECT / DEPROTECT
  • OP / DEOP
  • HALFOP / DEHALFOP
  • VOICE / DEVOICE
• Modération
  • BAN / UNBAN
  • KICK
  • CLEAR
• Administration
  • DROP
  • SENDPASS
  • LOGOUT
  • INVITE
  • GETKEY
  • INFO
  • LIST
• Lien utile

---

REGISTER

/msg ChanServ REGISTER canal mot de passe e-mail

Enregistre un canal dans la base de données de ChanServ. Pour utiliser cette commande, vous devez d'abord être opérateur sur le canal que vous essayez d'enregistrer. Le mot de passe est utilisé avec la commande IDENTIFY pour permettre à d'autres de faire des changements dans la configuration du canal plus tard. Le dernier paramètre, qui doit être inclus, est une description générale du canal. Quand vous enregistrez un canal, vous êtes enregistré comme « propriétaire » du canal. Le propriétaire peut tout changer dans la configuration du canal ; ChanServ lui donnera aussi automatiquement les droits d'opérateur quand il rejoint le canal.

IDENTIFY

/msg ChanServ IDENTIFY mot de passe

Certifie à ChanServ que vous êtes autorisé à modifier le canal donné. Beaucoup de commandes demandent que vous utilisiez cette commande avant de les utiliser si vous n'êtes pas le propriétaire. Le mot de passe est le même que celui envoyé avec la commande REGISTER.

---

SET — Configuration du canal

/msg ChanServ SET canal option paramètre(s)

Permet au propriétaire du canal de configurer les options suivantes.

SET FOUNDER

/msg ChanServ SET canal FOUNDER pseudo

Change le propriétaire d'un canal. Le nouveau pseudo doit être enregistré.

SET SUCCESSOR

/msg ChanServ SET canal SUCCESSOR pseudo

Change le successeur d'un canal. Si le pseudo du propriétaire expire ou est effacé alors que le canal est toujours enregistré, le successeur en deviendra le nouveau propriétaire. Si le successeur a déjà trop de canaux enregistrés (10), le canal sera tout de même effacé, comme si aucun successeur n'avait été nommé. Le nouveau pseudo doit être enregistré.

SET PASSWORD

/msg ChanServ SET canal PASSWORD nouveau mot de passe

Définit le mot de passe utilisé, via la commande IDENTIFY, pour s'identifier en tant que propriétaire du canal.

SET DESC

/msg ChanServ SET canal DESC description

Définit la description du canal, qui apparaît dans les commandes LIST et INFO.

SET URL

/msg ChanServ SET canal URL [adresse web]

Associe l'adresse du site web donnée au canal. Elle sera affichée à chaque fois que quelqu'un demande des informations sur le canal avec la commande INFO. Sans paramètre, supprime l'adresse du canal.

SET EMAIL

/msg ChanServ SET canal EMAIL [adresse e-mail]

Associe l'e-mail donné au canal. Il sera affiché lorsque quelqu'un demande des informations sur le canal avec la commande INFO. Sans paramètre, supprime l'e-mail du canal.

SET ENTRYMSG

/msg ChanServ SET canal ENTRYMSG [message]

Définit le message envoyé en /notice aux utilisateurs quand ils entrent dans le canal. Sans paramètre, aucun message n'est envoyé.

SET BANTYPE

/msg ChanServ SET canal BANTYPE type de ban

Définit le type de ban utilisé par les services pour bannir quelqu'un de votre canal. Le type est un nombre entre 0 et 3 :

• 0 : ban de style *!user@host
• 1 : ban de style *!*user@host
• 2 : ban de style *!*@host
• 3 : ban de style *!*user@*.domain

SET MLOCK

/msg ChanServ SET canal MLOCK mode(s)

Configure les modes maintenus sur le canal. ChanServ vous permet de toujours garder certains modes, d'empêcher l'utilisation d'autres, et de laisser le reste en libre utilisation par les opérateurs.

Le paramètre se construit comme dans la commande /MODE : les modes précédés d'un « + » sont toujours gardés, ceux précédés d'un « - » ne peuvent être utilisés. Contrairement à /MODE, chaque utilisation de SET MLOCK réinitialise entièrement les modes maintenus avant de mettre en place les nouveaux.

Remarque : si vous gardez le mode +k (comme dans l'exemple ci-dessous), activez aussi l'option RESTRICTED du canal, sinon toute personne entrant sur un canal vide verra la clef.

Exemples :

/msg ChanServ SET canal MLOCK +nt-iklps
Garde toujours les modes n et t, et empêche l'utilisation des modes i, k, l, p, et s. Le mode m est libre.

/msg ChanServ SET canal MLOCK +knst-ilmp ma-clef
Garde toujours les modes k, n, s, et t, et désactive les modes i, l, m, et p. La clef du canal sera "ma-clef".

/msg ChanServ SET canal MLOCK +
Réinitialise tous les modes précédemment maintenus.

Liste des modes de canaux :

p: Canal privé.
s: Canal secret.
i: Un utilisateur doit être invité pour joindre le canal.
m: Canal modéré (seuls les utilisateurs +vhoaq peuvent parler).
n: Les utilisateurs en dehors du canal ne peuvent pas y envoyer de message.
t: Seuls les utilisateurs +hoaq peuvent changer le topic.
r: Le canal est enregistré.
R: Seuls les utilisateurs enregistrés (+r) peuvent joindre le canal.
c: Bloque les messages contenant des codes de couleur mIRC.
Q: Aucun kick permis.
O: Canal d'opérateur IRC seulement (activé par les IRCops).
A: Canal d'admin du serveur seulement (activé par les admins).
K: /knock non permis.
V: /invite non permis.
S: Codes couleurs des scripts mIRC.
N: Aucun changement de pseudo autorisé sur le canal.
C: CTCP non permis sur le canal.
z: Seuls les clients en connexion sécurisée (SSL) peuvent joindre le canal.
H: Aucun utilisateur +I ne peut joindre le canal (activé par les admins).
l (nombre max) : canal limité à un certain nombre d'utilisateurs.
k (clef) : seuls les utilisateurs connaissant la clef peuvent joindre.
f [*!*@*](lignes):(secondes) : protection anti-flood (kick auto si dépassement, ban selon le host donné si précisé).
L (salon2) : salon lié — si +l est atteint, le nouvel utilisateur rejoint automatiquement l'autre canal.
b (pseudo!user@host) : bannit les utilisateurs correspondant à ce masque.
e (pseudo!user@host) : empêche de bannir un utilisateur correspondant à ce masque.

SET KEEPTOPIC

/msg ChanServ SET canal KEEPTOPIC on/off

Active ou désactive le maintien du topic. Le topic sera retenu par ChanServ même après que le dernier utilisateur ait quitté le canal, et restauré à la prochaine création du canal.

SET OPNOTICE

/msg ChanServ SET canal OPNOTICE on/off

Active ou désactive la notice sur OP/DEOP. ChanServ enverra alors une notice au canal à chaque utilisation des commandes OP ou DEOP.

SET PEACE

/msg ChanServ SET canal PEACE on/off

Empêche, quand elle est active, un utilisateur de kicker, bannir ou retirer un privilège à un utilisateur de niveau supérieur ou égal au sien via les commandes ChanServ.

SET PRIVATE

/msg ChanServ SET canal PRIVATE on/off

Si actif, le canal n'apparaît dans aucune liste via /msg ChanServ LIST.

SET RESTRICTED

/msg ChanServ SET canal RESTRICTED on/off

Les utilisateurs qui n'auraient normalement pas la permission d'être opérateur (niveau d'accès négatif, ou absents de la liste d'accès si le contrôle des ops est actif) seront kickés et bannis du canal.

SET SECURE

/msg ChanServ SET canal SECURE on/off

Seuls les utilisateurs ayant enregistré leur pseudo et identifiés avec leur mot de passe auront accès au canal selon la liste d'accès.

SET SECUREOPS

/msg ChanServ SET canal SECUREOPS on/off

Les utilisateurs absents de la liste d'accès ne pourront pas être op.

SET SECUREFOUNDER

/msg ChanServ SET canal SECUREFOUNDER on/off

Seul le vrai propriétaire pourra effacer le canal, changer son mot de passe, son propriétaire ou son successeur — pas simplement les personnes identifiées via ChanServ.

SET SIGNKICK

/msg ChanServ SET canal SIGNKICK on/level/off

Les kicks générés par la commande ChanServ KICK incluront le pseudo de la personne ayant utilisé la commande dans leur raison. Avec LEVEL, ceux dont le niveau est supérieur ou égal au niveau SIGNKICK du canal ne généreront pas de kicks signés.

SET TOPICLOCK

/msg ChanServ SET canal TOPICLOCK on/off

ChanServ ne permettra le changement du topic que via la commande TOPIC.

SET XOP

/msg ChanServ SET canal XOP on/off

Active ou désactive le système de listes xOP. Avec ce système, utilisez les commandes AOP/SOP/HOP/VOP pour donner des privilèges ; sinon, utilisez la commande ACCESS.

Info technique : en passant du système de liste d'accès au système xOP, les niveaux d'accès sont convertis et ne seront pas récupérés à l'identique en cas de retour en arrière. Vérifiez que les utilisateurs sont dans la bonne liste xOP après conversion, surtout si vous avez modifié les niveaux via LEVELS. Passer de xOP vers la liste d'accès ne pose en revanche aucun problème.

---

AOP, SOP, HOP, VOP

/msg ChanServ AOP/SOP/HOP/VOP canal ADD pseudo
/msg ChanServ AOP/SOP/HOP/VOP canal DEL pseudo/liste de numéros d'entrée
/msg ChanServ AOP/SOP/HOP/VOP canal LIST pseudo/liste de numéros d'entrée
/msg ChanServ AOP/SOP/HOP/VOP canal CLEAR

Gère la liste des AOPs (AutoOPs) d'un canal. Elle donne aux utilisateurs le droit de recevoir le statut d'opérateur automatiquement, de se débannir ou s'inviter en cas de besoin, d'avoir leur message d'accueil affiché à leur arrivée, etc.

ADD ajoute le pseudo donné à la liste. DEL le supprime (ou les entrées correspondant à une liste de numéros). LIST affiche la liste, filtrable par masque ou par plage de numéros, par exemple :

AOP #canal LIST 2-5,7-9
Liste toutes les entrées comprises entre 2 et 5 et entre 7 et 9.

CLEAR supprime toutes les entrées de la liste. ADD et DEL sont utilisables à partir du statut SOP, CLEAR est réservé au propriétaire du canal, LIST est accessible dès AOP.

Cette commande peut être désactivée sur votre canal, auquel cas utilisez la liste d'accès (/msg ChanServ HELP ACCESS) — /msg ChanServ HELP SET XOP explique comment basculer d'un système à l'autre.

ACCESS

/msg ChanServ ACCESS canal ADD pseudo
/msg ChanServ ACCESS canal DEL pseudo/liste de numéros d'entrée
/msg ChanServ ACCESS canal LIST pseudo/liste de numéros d'entrée
/msg ChanServ ACCESS canal CLEAR

Gère la liste d'accès d'un canal, qui détermine le statut d'opérateur et l'accès aux commandes ChanServ selon le niveau utilisateur (/msg ChanServ HELP ACCESS LEVELS pour le détail). Un pseudo absent de la liste a un niveau de 0.

ADD ajoute ou met à jour le niveau d'un pseudo — le niveau donné doit être inférieur à celui de la personne qui exécute la commande. DEL supprime une entrée. LIST affiche la liste, filtrable comme pour AOP :

ACCESS #canal LIST 2-5,7-9
Liste toutes les entrées comprises entre 2 et 5 et entre 7 et 9.

CLEAR supprime toutes les entrées de la liste d'accès.

LEVELS

/msg ChanServ LEVELS canal SET type niveau
/msg ChanServ LEVELS canal DIS/DISABLE type
/msg ChanServ LEVELS canal LIST
/msg ChanServ LEVELS canal RESET

Permet un contrôle précis de la signification des niveaux d'accès du canal, pour la majorité des fonctions de ChanServ (SET FOUNDER, SET PASSWORD et LEVELS elle-même restent toujours réservées au propriétaire).

SET change le niveau requis pour une fonction. DISABLE (ou DIS) désactive une fonction automatique ou la réserve au propriétaire. LIST affiche les niveaux actuels. RESET réinitialise les niveaux par défaut d'un canal neuf. Consultez HELP LEVELS DESC pour la liste complète des fonctions concernées.

AKICK

/msg ChanServ AKICK canal ADD pseudo [raison]
/msg ChanServ AKICK canal DEL pseudo
/msg ChanServ AKICK canal STICK pseudo
/msg ChanServ AKICK canal UNSTICK pseudo
/msg ChanServ AKICK canal LIST [pseudo]
/msg ChanServ AKICK canal VIEW [pseudo]
/msg ChanServ AKICK canal ENFORCE
/msg ChanServ AKICK canal CLEAR

Gère la liste de kicks automatiques : si un utilisateur listé tente de rejoindre le canal, ChanServ le bannit puis le kicke.

ADD ajoute un pseudo ou masque à la liste (raison personnalisée optionnelle, sinon message par défaut). DEL le retire — sans supprimer les bans déjà posés, à faire manuellement. STICK bannit le masque de façon permanente (ChanServ réapplique le ban si quelqu'un le retire) ; ne fonctionne pas sur les pseudos enregistrés. UNSTICK annule cet effet. LIST affiche la liste, VIEW en affiche une version détaillée. ENFORCE force ChanServ à bannir immédiatement tous les utilisateurs présents concernés par la liste. CLEAR supprime toutes les entrées.

---

OWNER / DEOWNER

/msg ChanServ OWNER [canal]

Donne le statut de propriétaire sur le canal donné, ou sur tous vos canaux si aucun n'est précisé (à condition d'y avoir droit). Limité à ceux ayant un accès de propriétaire.

/msg ChanServ DEOWNER [canal]

Retire ce statut, sur le canal donné ou sur tous vos canaux.

PROTECT / DEPROTECT

/msg ChanServ PROTECT [canal [pseudo]]

Protège le pseudo sélectionné sur un canal (vous-même par défaut si aucun pseudo n'est donné, tous vos canaux si aucun n'est précisé). Limité par défaut au propriétaire, aux SOPs, ou à un niveau d'accès ≥10 en cas d'auto-protection.

/msg ChanServ DEPROTECT [canal [pseudo]]

Retire cette protection, avec les mêmes règles.

OP / DEOP

/msg ChanServ OP [canal [pseudo]]

Donne le statut opérateur au pseudo sélectionné. Limité par défaut aux AOPs ou à un niveau d'accès ≥5.

/msg ChanServ DEOP [canal [pseudo]]

Retire ce statut, avec les mêmes règles.

HALFOP / DEHALFOP

/msg ChanServ HALFOP [canal [pseudo]]

Donne le statut half-op. Limité aux AOPs ou niveau ≥5, ou aux HOPs / niveau ≥4 en cas d'auto-halfop.

/msg ChanServ DEHALFOP [canal [pseudo]]

Retire ce statut, avec les mêmes règles.

VOICE / DEVOICE

/msg ChanServ VOICE [canal [pseudo]]

Donne la voix au pseudo sélectionné. Limité aux AOPs ou niveau ≥5, ou aux VOPs / niveau ≥3 en cas d'auto-voice.

/msg ChanServ DEVOICE [canal [pseudo]]

Retire la voix, avec les mêmes règles.

---

BAN / UNBAN

/msg ChanServ BAN [canal [pseudo [raison]]]

Bannit le pseudo sélectionné sur un canal. Limité par défaut aux AOPs ou à un niveau d'accès ≥5.

/msg ChanServ UNBAN canal

Retire tous les bans vous empêchant d'entrer sur le canal donné, sous les mêmes conditions d'accès.

KICK

/msg ChanServ KICK [canal [pseudo [raison]]]

Kicke le pseudo sélectionné sur un canal. Limité par défaut aux AOPs ou à un niveau d'accès ≥5.

CLEAR

/msg ChanServ CLEAR canal quoi

quoi peut être :

• MODES — réinitialise tous les modes du canal
• BANS — retire tous les bans
• EXCEPTS — retire tous les excepts
• OPS — retire le statut d'opérateur à tous les op du canal
• VOICES — retire la voix à tous ceux qui l'ont
• USERS — kicke tous les utilisateurs du canal

Limité par défaut à ceux ayant un accès de propriétaire.

---

DROP

/msg ChanServ DROP canal

Efface le canal donné. Réservé au propriétaire, qui doit s'identifier au préalable via IDENTIFY.

SENDPASS

/msg ChanServ SENDPASS canal

Envoie le mot de passe du canal à l'adresse e-mail enregistrée pour le propriétaire — utile en cas de mot de passe perdu. Peut être limitée aux IRC operators selon le réseau, et indisponible si le chiffrement des mots de passe est activé.

LOGOUT

/msg ChanServ LOGOUT canal pseudo

Supprime l'identification du pseudo sélectionné pour le canal donné. Le propriétaire peut l'utiliser sur n'importe qui ; les autres utilisateurs uniquement sur eux-mêmes.

INVITE

/msg ChanServ INVITE canal

Demande à ChanServ de vous inviter sur le canal donné. Limité par défaut aux AOPs ou à un niveau d'accès ≥5.

GETKEY

/msg ChanServ GETKEY canal

Retourne la clef du canal donné. Principalement destinée aux bots et scripts — répond simplement KEY, ou « NO KEY » si aucune clef n'est définie.

INFO

/msg ChanServ INFO canal [all]

Liste les informations du canal : propriétaire, date d'enregistrement, date de dernière utilisation, description et modes bloqués. Avec ALL (réservé par défaut au propriétaire), affiche aussi le message d'entrée et le successeur.

LIST

/msg ChanServ LIST modèle

Liste tous les canaux enregistrés correspondant au modèle donné (les canaux en PRIVATE ne sont jamais listés).

---

Lien utile

• Site officiel d'Anope IRC Services : https://anope.org/