include/numerics.h

   1 /*
   2  * InspIRCd -- Internet Relay Chat Daemon
   3  *
   4  *   Copyright (C) 2008 Robin Burchell <robin+git@viroteck.net>
   5  *   Copyright (C) 2008 Craig Edwards <craigedwards@brainbox.cc>
   6  *
   7  * This file is part of InspIRCd.  InspIRCd is free software: you can
   8  * redistribute it and/or modify it under the terms of the GNU General Public
   9  * License as published by the Free Software Foundation, version 2.
  10  *
  11  * This program is distributed in the hope that it will be useful, but WITHOUT
  12  * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS
  13  * FOR A PARTICULAR PURPOSE.  See the GNU General Public License for more
  14  * details.
  15  *
  16  * You should have received a copy of the GNU General Public License
  17  * along with this program.  If not, see <http://www.gnu.org/licenses/>.
  18  */
  19
  20
  21 #pragma once
  22
  23 /*
  24  * This file is aimed providing a string that is easier to use than using the numeric
  25  * directly.
  26  *
  27  * Module authors, please note!
  28  *  While you are free to use any numerics on this list, like the rest of the core, you
  29  *  *should not* be editing it!
  30  *  You should just WriteNumeric(444, .. or whatever as you would before this file, OR:
  31  *  #define RPL_MYNUMERIC 444 & WriteNumeric(RPL_MYNUMERIC, ...
  32  *
  33  *  If you *do* have a suggestion for a numeric you genuinely believe would be useful,
  34  *  please speak to us. :)
  35  *
  36  * Thanks to Darom, jackmcbarn and Brain for suggesting and discussing this.
  37  *
  38  * Please note that the list may not be exhaustive, it'll be done when I have
  39  * nothing better to do with my time. -- w00t (jul 13, 2008)
  40  */
  41 enum Numerics
  42 {
  43         /*
  44          * Reply range of numerics.
  45          */
  46         RPL_WELCOME                                     =       1, // 2812, not 1459
  47         RPL_YOURHOSTIS                                  =       2, // 2812, not 1459
  48         RPL_SERVERCREATED                               =       3, // 2812, not 1459
  49         RPL_SERVERVERSION                               =       4, // 2812, not 1459
  50         RPL_ISUPPORT                                    =       5, // not RFC, extremely common though (defined as RPL_BOUNCE in 2812, widely ignored)
  51
  52         RPL_MAP                                                         =       6, // unrealircd
  53         RPL_ENDMAP                                                      =       7, // unrealircd
  54         RPL_SNOMASKIS                                   =       8, // unrealircd
  55
  56         RPL_YOURUUID                                    =       42, // taken from ircnet
  57
  58         RPL_UMODEIS                                     =       221,
  59         RPL_RULES                                       =       232, // unrealircd
  60         RPL_ADMINME                                     =       256,
  61         RPL_ADMINLOC1                           =       257,
  62         RPL_ADMINLOC2                           =       258,
  63         RPL_ADMINEMAIL                          =       259,
  64         RPL_MAPUSERS                            =       270, // insp-specific
  65
  66         RPL_SYNTAX                                      =       304,    // insp-specific
  67
  68         RPL_UNAWAY                                              =       305,
  69         RPL_NOWAWAY                                             =       306,
  70
  71         RPL_RULESTART                                   =       308, // unrealircd
  72         RPL_RULESEND                                    =       309, // unrealircd
  73         RPL_CHANNELMODEIS                               =       324,
  74         RPL_CHANNELCREATED                              =       329, // ???
  75         RPL_NOTOPICSET                                  =       331,
  76         RPL_TOPIC                                       =       332,
  77         RPL_TOPICTIME                                   =       333, // not RFC, extremely common though
  78
  79         RPL_INVITING                                    =       341,
  80         RPL_INVITELIST                                  =       346, // insp-specific (stolen from ircu)
  81         RPL_ENDOFINVITELIST                             =       347, // insp-specific (stolen from ircu)
  82         RPL_VERSION                                             =       351,
  83         RPL_NAMREPLY                                    =       353,
  84         RPL_ENDOFNAMES                                  =       366,
  85
  86         RPL_INFO                                        =       371,
  87         RPL_ENDOFINFO                           =       374,
  88         RPL_MOTD                                        =       372,
  89         RPL_MOTDSTART                                   =       375,
  90         RPL_ENDOFMOTD                                   =       376,
  91
  92         RPL_YOUAREOPER                                          =       381,
  93         RPL_REHASHING                                           =       382,
  94         RPL_TIME                                                        =       391,
  95         RPL_YOURDISPLAYEDHOST                           =       396, // from charybdis/etc, common convention
  96
  97         /*
  98          * Error range of numerics.
  99          */
 100         ERR_NOSUCHNICK                                  =       401,
 101         ERR_NOSUCHSERVER                                =       402,
 102         ERR_NOSUCHCHANNEL                               =       403, // used to indicate an invalid channel name also, so don't rely on RFC text (don't do that anyway!)
 103         ERR_CANNOTSENDTOCHAN                    =       404,
 104         ERR_TOOMANYCHANNELS                             =       405,
 105         ERR_INVALIDCAPSUBCOMMAND                =       410, // ratbox/charybdis(?)
 106         ERR_UNKNOWNCOMMAND                              =       421,
 107         ERR_NOMOTD                                      =       422,
 108         ERR_NORULES                                     =       434, // unrealircd
 109         ERR_USERNOTINCHANNEL                            =       441,
 110         ERR_NOTONCHANNEL                                        =       442,
 111         ERR_USERONCHANNEL                                       =       443,
 112         ERR_CANTCHANGENICK                                      =       447, // unrealircd, probably
 113         ERR_NOTREGISTERED                               =       451,
 114         ERR_NEEDMOREPARAMS                              =       461,
 115         ERR_ALREADYREGISTERED                   =       462,
 116
 117         /*
 118          * A quick side-rant about the next group of numerics..
 119          * There are clients out there that like to assume that just because they don't recieve a numeric
 120          * they know, that they have joined the channel.
 121          *
 122          * If IRC was at all properly standardised, this may even be a semi-acceptable assumption to make,
 123          * but that's not the case as we all know, so IT IS NOT ACCEPTABLE. Especially for Insp users, where
 124          * differing modules MAY potentially choose to block joins and send NOTICEs or other text to the user
 125          * instead!
 126          *
 127          * tl;dr version:
 128          *   DON'T MAKE YOUR CLIENT ASSUME YOU JOINED UNLESS YOU RECIEVE A JOIN WITH YOUR DAMN NICK ON IT.
 129          * Thanks.
 130          *
 131          *  -- A message from the IRC group for coder sanity, and w00t
 132          */
 133         ERR_BADCHANNELKEY                               =       475,
 134         ERR_INVITEONLYCHAN                              =       473,
 135         ERR_CHANNELISFULL                               =       471,
 136         ERR_BANNEDFROMCHAN                              =       474,
 137
 138         ERR_NOPRIVILEGES                                =       481, // rfc, beware though, we use this for other things opers may not do also
 139         ERR_CHANOPRIVSNEEDED                            =       482, // rfc, beware though, we use this for other things like trying to kick a uline
 140
 141         ERR_ALLMUSTSSL                                  =       490, // unrealircd
 142         ERR_NOCTCPALLOWED                               =       492, // XXX: bzzzz. 1459 defines this as ERR_NOSERVICEHOST, research it more and perhaps change this! (ERR_CANNOTSENDTOCHAN?)
 143                                                                                         // wtf, we also use this for m_noinvite. UGLY!
 144         ERR_DELAYREJOIN                                 =       495, // insp-specific, XXX: we should use 'resource temporarily unavailable' from ircnet/ratbox or whatever
 145         ERR_UNKNOWNSNOMASK                              =       501, // insp-specific
 146         ERR_USERSDONTMATCH                              =       502,
 147         ERR_CANTJOINOPERSONLY                   =       520, // unrealircd, but crap to have so many numerics for cant join..
 148         ERR_CANTSENDTOUSER                              =       531, // ???
 149
 150         RPL_COMMANDS                                            =       702, // insp-specific
 151         RPL_COMMANDSEND                                         =       703, // insp-specific
 152
 153         ERR_WORDFILTERED                                        =       936, // insp-specific, would be nice if we could get rid of this..
 154         ERR_CANTUNLOADMODULE                            =       972, // insp-specific
 155         RPL_UNLOADEDMODULE                              =       973, // insp-specific
 156         ERR_CANTLOADMODULE                              =       974, // insp-specific
 157         RPL_LOADEDMODULE                                =       975 // insp-specific
 158 };