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  * Module authors, please note!
  25  *  While you are free to use any numerics on this list, like the rest of the core, you
  26  *  *should not* be editing it!
  27  *
  28  *  If you *do* have a suggestion for a numeric you genuinely believe would be useful,
  29  *  please speak to us. :)
  30  *
  31  * Thanks to Darom, jackmcbarn and Brain for suggesting and discussing this.
  32  *
  33  * Please note that the list may not be exhaustive, it'll be done when I have
  34  * nothing better to do with my time. -- w00t (jul 13, 2008)
  35  */
  36 enum
  37 {
  38         /*
  39          * Reply range of numerics.
  40          */
  41         RPL_WELCOME                     = 1, // 2812, not 1459
  42         RPL_YOURHOSTIS                  = 2, // 2812, not 1459
  43         RPL_SERVERCREATED               = 3, // 2812, not 1459
  44         RPL_SERVERVERSION               = 4, // 2812, not 1459
  45         RPL_ISUPPORT                    = 5, // not RFC, extremely common though (defined as RPL_BOUNCE in 2812, widely ignored)
  46
  47         RPL_SNOMASKIS                   = 8, // unrealircd
  48
  49         RPL_MAP                         = 15, // ircu
  50         RPL_ENDMAP                      = 17, // ircu
  51         RPL_MAPUSERS                    = 18, // insp-specific
  52
  53         RPL_UMODEIS                     = 221,
  54
  55         RPL_LUSERCLIENT                 = 251,
  56         RPL_LUSEROP                     = 252,
  57         RPL_LUSERUNKNOWN                = 253,
  58         RPL_LUSERCHANNELS               = 254,
  59         RPL_LUSERME                     = 255,
  60
  61         RPL_ADMINME                     = 256,
  62         RPL_ADMINLOC1                   = 257,
  63         RPL_ADMINLOC2                   = 258,
  64         RPL_ADMINEMAIL                  = 259,
  65
  66         RPL_LOCALUSERS                  = 265,
  67         RPL_GLOBALUSERS                 = 266,
  68
  69         RPL_AWAY                        = 301,
  70         RPL_USERHOST                    = 302,
  71         RPL_ISON                        = 303,
  72
  73         RPL_UNAWAY                      = 305,
  74         RPL_NOWAWAY                     = 306,
  75
  76         RPL_WHOISSERVER                 = 312,
  77
  78         RPL_ENDOFWHO                    = 315,
  79         RPL_ENDOFWHOIS                  = 318,
  80
  81         RPL_LISTSTART                   = 321,
  82         RPL_LIST                        = 322,
  83         RPL_LISTEND                     = 323,
  84
  85         RPL_CHANNELMODEIS               = 324,
  86         RPL_CHANNELCREATED              = 329, // ???
  87         RPL_NOTOPICSET                  = 331,
  88         RPL_TOPIC                       = 332,
  89         RPL_TOPICTIME                   = 333, // not RFC, extremely common though
  90
  91         RPL_USERIP                      = 340,
  92         RPL_INVITING                    = 341,
  93         RPL_INVITELIST                  = 346, // insp-specific (stolen from ircu)
  94         RPL_ENDOFINVITELIST             = 347, // insp-specific (stolen from ircu)
  95         RPL_VERSION                     = 351,
  96         RPL_WHOREPLY                    = 352,
  97         RPL_NAMREPLY                    = 353,
  98         RPL_LINKS                       = 364,
  99         RPL_ENDOFLINKS                  = 365,
 100         RPL_ENDOFNAMES                  = 366,
 101
 102         RPL_INFO                        = 371,
 103         RPL_ENDOFINFO                   = 374,
 104         RPL_MOTD                        = 372,
 105         RPL_MOTDSTART                   = 375,
 106         RPL_ENDOFMOTD                   = 376,
 107
 108         RPL_YOUAREOPER                  = 381,
 109         RPL_REHASHING                   = 382,
 110         RPL_TIME                        = 391,
 111         RPL_YOURDISPLAYEDHOST           = 396, // from charybdis/etc, common convention
 112
 113         /*
 114          * Error range of numerics.
 115          */
 116         ERR_NOSUCHNICK                  = 401,
 117         ERR_NOSUCHSERVER                = 402,
 118         ERR_NOSUCHCHANNEL               = 403, // used to indicate an invalid channel name also, so don't rely on RFC text (don't do that anyway!)
 119         ERR_CANNOTSENDTOCHAN            = 404,
 120         ERR_TOOMANYCHANNELS             = 405,
 121         ERR_WASNOSUCHNICK               = 406,
 122         ERR_NOTEXTTOSEND                = 412,
 123         ERR_UNKNOWNCOMMAND              = 421,
 124         ERR_NOMOTD                      = 422,
 125         ERR_NONICKNAMEGIVEN             = 431,
 126         ERR_ERRONEUSNICKNAME            = 432,
 127         ERR_NICKNAMEINUSE               = 433,
 128         ERR_USERNOTINCHANNEL            = 441,
 129         ERR_NOTONCHANNEL                = 442,
 130         ERR_USERONCHANNEL               = 443,
 131         ERR_CANTCHANGENICK              = 447, // unrealircd, probably
 132         ERR_NOTREGISTERED               = 451,
 133         ERR_NEEDMOREPARAMS              = 461,
 134         ERR_ALREADYREGISTERED           = 462,
 135         ERR_YOUREBANNEDCREEP            = 465,
 136         ERR_UNKNOWNMODE                 = 472,
 137
 138         /*
 139          * A quick side-rant about the next group of numerics..
 140          * There are clients out there that like to assume that just because they don't recieve a numeric
 141          * they know, that they have joined the channel.
 142          *
 143          * If IRC was at all properly standardised, this may even be a semi-acceptable assumption to make,
 144          * but that's not the case as we all know, so IT IS NOT ACCEPTABLE. Especially for Insp users, where
 145          * differing modules MAY potentially choose to block joins and send NOTICEs or other text to the user
 146          * instead!
 147          *
 148          * tl;dr version:
 149          *   DON'T MAKE YOUR CLIENT ASSUME YOU JOINED UNLESS YOU RECIEVE A JOIN WITH YOUR DAMN NICK ON IT.
 150          * Thanks.
 151          *
 152          *  -- A message from the IRC group for coder sanity, and w00t
 153          */
 154         ERR_BADCHANNELKEY               = 475,
 155         ERR_BADCHANMASK                 = 476,
 156         ERR_INVITEONLYCHAN              = 473,
 157         ERR_CHANNELISFULL               = 471,
 158         ERR_BANNEDFROMCHAN              = 474,
 159
 160         ERR_BANLISTFULL                 = 478,
 161
 162         ERR_NOPRIVILEGES                = 481, // rfc, beware though, we use this for other things opers may not do also
 163         ERR_CHANOPRIVSNEEDED            = 482, // rfc, beware though, we use this for other things like trying to kick a uline
 164
 165         ERR_RESTRICTED                  = 484,
 166
 167         ERR_NOOPERHOST                  = 491,
 168         ERR_DELAYREJOIN                 = 495, // insp-specific, XXX: we should use 'resource temporarily unavailable' from ircnet/ratbox or whatever
 169         ERR_UNKNOWNSNOMASK              = 501, // insp-specific
 170         ERR_USERSDONTMATCH              = 502,
 171         ERR_CANTSENDTOUSER              = 531, // ???
 172
 173         RPL_SYNTAX                      = 650, // insp-specific
 174         ERR_INVALIDMODEPARAM            = 696, // insp-specific
 175
 176         RPL_OTHERUMODEIS                = 803, // insp-specific
 177         RPL_OTHERSNOMASKIS              = 804, // insp-specific
 178
 179         ERR_CANTUNLOADMODULE            = 972, // insp-specific
 180         RPL_UNLOADEDMODULE              = 973, // insp-specific
 181         ERR_CANTLOADMODULE              = 974, // insp-specific
 182         RPL_LOADEDMODULE                = 975 // insp-specific
 183 };