RFC IRC : Messages optionnels


Cette section décrit les messages optionnels. Ils ne sont pas requis dans les implémentations des serveurs décrits ici. En l'absence de l'option, un message d'erreur doit être généré, ou une erreur commande inconnue. Si le message est destiné à un autre serveur, il doit est transmis (traitement de base obligatoire). Les nombres alloués pour cela sont listé avec les messages ci-dessous.

5.1 AWAY

Commande: AWAY
Paramètres: [message]

Avec le message AWAY, les clients peuvent définir une chaîne de réponse automatique pour toute commande PRIVMSG qui leur est destinée (et non pas à un canal sur lequel ils sont). La réponse est envoyée directement par le serveur au client envoyant une commande PRIVMSG. Le seul serveur à répondre est celui sur lequel le client émetteur est situé.

Le message AWAY est utilisé soit avec un paramètre (pour définir un message AWAY) ou sans (pour retirer le message AWAY).

Réponses numériques :

           RPL_UNAWAY                      RPL_NOWAWAY
Exemples:
    AWAY :Parti déjeuner. De retour à 2 heures. ; défini le message d'absence en " Parti déjeuner. De retour à 2 heures.".
    :WiZ AWAY ; supprime l'absence de WiZ.

5.2 Message REHASH

Commande: REHASH
Paramètres: Aucun

Le massage REHASH est utilisé par les opérateurs pour forcer un serveur à relire et traiter son fichier de configuration.

Réponses numériques :

        RPL_REHASHING                   ERR_NOPRIVILEGES
Exemples:
    REHASH ; message d'un client ayant un statut d'opérateur au serveur, lui demandant de relire son fichier de configuration.

5.3 Message RESTART

Commande: RESTART
Paramètres: Aucun

Le message RESTART n'est utilisable que par un opérateur. Il sert à redémarrer le serveur. La gestion de ce message est optionnelle, car il est risqué de permettre à des personnes se connectant comme opérateur d'exécuter cette commande, qui cause une interruption de service (au moins).

La commande RESTART doit toujours être traitée par le serveur qui la reçoit, et non passé à un autre serveur.

Réponses numériques :

           ERR_NOPRIVILEGES
Exemples:
    RESTART ; pas de paramètres

5.4 Message SUMMON

Commande: SUMMON
Paramètres: <utilisateur> [<serveur>]

La commande SUMMON peut être utilisée pour envoyer à des utilisateurs qui sont sur l'hôte sur lequel s'exécute le serveur IRC un message leur demandant de joindre l'IRC. Ce message ne peut être envoyé que si le serveur (a) a la commande SUMMON activée, et (b) si le processus serveur peut écrire sur le tty (ou similaire) de l'utilisateur.

Si le paramètre <serveur> n'est pas donné, cela essaie d'appeler l'<utilisateur> du serveur sur lequel le client est connecté.

Si le SUMMON est désactivé sur un serveur, il doit renvoyer la réponse numérique ERR_SUMMONDISABLED et transmettre le message SUMMON.

Réponses numériques :

           ERR_NORECIPIENT                 ERR_FILEERROR
           ERR_NOLOGIN                     ERR_NOSUCHSERVER
           RPL_SUMMONING
Exemples:
    SUMMON jto ; appelle l'utilisateur jto sur l'hôte du serveur
    SUMMON jto tolsun.oulu.fi ; appelle l'utilisateur jto sur l'hôte sur lequel le serveur "tolsun.oulu.fi" est lancé.

5.5 Commande USERS

Commande: USERS
Paramètres: [<serveur>]

La commande USERS fonctionne de façon similaire à WHO(1), RUSERS(1) et FINGER(1). Certains peuvent désactiver cette commande sur leur serveur pour des raisons de sécurité. En cas de désactivation, cela doit être indiqué par le retour de réponse numérique appropriée.

Réponses numériques :

           ERR_NOSUCHSERVER                ERR_FILEERROR
           RPL_USERSSTART                  RPL_USERS
           RPL_NOUSERS                     RPL_ENDOFUSERS
           ERR_USERSDISABLED
Réponse de désactivation :
           ERR_USERSDISABLED
Exemples:
    USERS eff.org ; requiert la liste des utilisateurs connectés au serveur eff.org
    :John USERS tolsun.oulu.fi ; requête de John pour obtenir la liste des utilisateur du serveur tolsun.oulu.fi

5.6 Message WALLOPS

Commande: WALLOPS
Paramètres: Texte à envoyer à tous les opérateurs actuellement connectés.

Envoie un message à tous les opérateurs actuellement connectés. Après avoir essayé de laisser accès à cette commande à tous les utilisateurs, il a été constaté qu'on en abusait comme un moyen d'envoyer des messages à plein de personnes (comme WALL). A cause de cela, il est recommandé que l'implémentations courante de WALLOPS ne reconnaisse que les serveurs comme émetteurs de WALLOPS.

Réponses numériques :

           ERR_NEEDMOREPARAMS
Exemples:
    :csd.bu.edu WALLOPS :Connect '*.uiuc.edu 6667' from Joshua ; message WALLOPS de csd.bu.edu annonçant un message CONNECT reçu et traité, issu de Joshua.

5.7 Message USERHOST

Commande: USERHOST
Paramètres: <pseudonyme>{<espace ><pseudonyme>}

La commande USERHOST prends jusqu'à 5 pseudonymes, séparés par des virgules, et revoie une liste d'informations pour chacun des pseudonymes qu'il a trouvé. La liste des réponses contient chaque réponse séparée par des espaces.

Réponses numériques :

           RPL_USERHOST                    ERR_NEEDMOREPARAMS
Exemples:
    USERHOST Wiz Michael Marty p ;requête USERHOST pour information sur les pseudos "Wiz", "Michael", "Marty" et "p"

5.8 Message ISON

Commande: ISON
Paramètres: <pseudonyme>{<espace><pseudonyme>}

La commande ISON a été implémentée pour fournir une manière rapide et efficace de savoir si un pseudonyme donné est connecté à l'IRC. ISON prend un (1) paramètre : une liste de pseudonymes séparés par des espaces. Chaque pseudonyme présent est ajouté à la chaîne de réponse du serveur. Ainsi, la chaîne de réponse peut être vide (aucun utilisateur est présent), une copie exacte de la chaîne de caractères passée en paramètres (ils sont tous présents), ou un tout sous-ensemble du groupe de pseudonymes passé en paramètre. La seule limite au nombre de pseudos qui peuvent être testés est la troncature des commandes à une longueur de 512 caractères.

ISON n'est traitée que par le serveur local au client effectuant la requête, et n'est donc pas passé pour traitement aux autres serveurs

Réponses numériques :

           RPL_ISON                ERR_NEEDMOREPARAMS
Exemples:
    ISON phone trillian WiZ jarlek Avalon Angel Monstah ; Exemple de requête ISON pour 7 pseudonymes