include/numerics.h

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