summaryrefslogtreecommitdiff
path: root/include/numerics.h
blob: 4fce4cb6de53b746c9ef6a8e6798fdca00aa8a1b (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
/*
 * InspIRCd -- Internet Relay Chat Daemon
 *
 *   Copyright (C) 2008 Robin Burchell <robin+git@viroteck.net>
 *   Copyright (C) 2008 Craig Edwards <craigedwards@brainbox.cc>
 *
 * This file is part of InspIRCd.  InspIRCd is free software: you can
 * redistribute it and/or modify it under the terms of the GNU General Public
 * License as published by the Free Software Foundation, version 2.
 *
 * This program is distributed in the hope that it will be useful, but WITHOUT
 * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS
 * FOR A PARTICULAR PURPOSE.  See the GNU General Public License for more
 * details.
 *
 * You should have received a copy of the GNU General Public License
 * along with this program.  If not, see <http://www.gnu.org/licenses/>.
 */


#ifndef NUMERICS_H
#define NUMERICS_H

/*
 * This file is aimed providing a string that is easier to use than using the numeric
 * directly.
 *
 * Module authors, please note!
 *  While you are free to use any numerics on this list, like the rest of the core, you
 *  *should not* be editing it!
 *  You should just WriteNumeric(444, .. or whatever as you would before this file, OR:
 *  #define RPL_MYNUMERIC 444 & WriteNumeric(RPL_MYNUMERIC, ...
 *
 *  If you *do* have a suggestion for a numeric you genuinely believe would be useful,
 *  please speak to us. :)
 *
 * Thanks to Darom, jackmcbarn and Brain for suggesting and discussing this.
 *
 * Please note that the list may not be exhaustive, it'll be done when I have
 * nothing better to do with my time. -- w00t (jul 13, 2008)
 */
enum Numerics
{
	/*
	 * Reply range of numerics.
	 */
	RPL_WELCOME					=	1, // 2812, not 1459
	RPL_YOURHOSTIS					=	2, // 2812, not 1459
	RPL_SERVERCREATED				=	3, // 2812, not 1459
	RPL_SERVERVERSION				=	4, // 2812, not 1459
	RPL_ISUPPORT					=	5, // not RFC, extremely common though (defined as RPL_BOUNCE in 2812, widely ignored)

	RPL_MAP								=	6, // unrealircd
	RPL_ENDMAP							=	7, // unrealircd
	RPL_SNOMASKIS					=	8, // unrealircd

	RPL_YOURUUID					=	42, // taken from ircnet

	RPL_UMODEIS					=	221,
	RPL_RULES					=	232, // unrealircd
	RPL_ADMINME					=	256,
	RPL_ADMINLOC1				=	257,
	RPL_ADMINLOC2				=	258,
	RPL_ADMINEMAIL				=	259,
	RPL_MAPUSERS				=	270, // insp-specific

	RPL_SYNTAX					=	304,	// insp-specific

	RPL_UNAWAY						=	305,
	RPL_NOWAWAY						=	306,

	RPL_RULESTART					=	308, // unrealircd
	RPL_RULESEND					=	309, // unrealircd
	RPL_CHANNELMODEIS				=	324,
	RPL_CHANNELCREATED				=	329, // ???
	RPL_NOTOPICSET					=	331,
	RPL_TOPIC					=	332,
	RPL_TOPICTIME					=	333, // not RFC, extremely common though

	RPL_INVITING					=	341,
	RPL_INVITELIST					=	346, // insp-specific (stolen from ircu)
	RPL_ENDOFINVITELIST				=	347, // insp-specific (stolen from ircu)
	RPL_VERSION						=	351,
	RPL_NAMREPLY					=	353,
	RPL_ENDOFNAMES					=	366,

	RPL_INFO					=	371,
	RPL_ENDOFINFO				=	374,
	RPL_MOTD					=	372,
	RPL_MOTDSTART					=	375,
	RPL_ENDOFMOTD					=	376,

	RPL_YOUAREOPER						=	381,
	RPL_REHASHING						=	382,
	RPL_TIME							=	391,
	RPL_YOURDISPLAYEDHOST				=	396, // from charybdis/etc, common convention

	/*
	 * Error range of numerics.
	 */
	ERR_NOSUCHNICK					=	401,
	ERR_NOSUCHSERVER				=	402,
	ERR_NOSUCHCHANNEL				=	403, // used to indicate an invalid channel name also, so don't rely on RFC text (don't do that anyway!)
	ERR_CANNOTSENDTOCHAN			=	404,
	ERR_TOOMANYCHANNELS				=	405,
	ERR_INVALIDCAPSUBCOMMAND		=	410, // ratbox/charybdis(?)
	ERR_UNKNOWNCOMMAND				=	421,
	ERR_NOMOTD					=	422,
	ERR_NORULES					=	434, // unrealircd
	ERR_USERNOTINCHANNEL				=	441,
	ERR_NOTONCHANNEL					=	442,
	ERR_USERONCHANNEL					=	443,
	ERR_CANTCHANGENICK					=	447, // unrealircd, probably
	ERR_NOTREGISTERED				=	451,
	ERR_NEEDMOREPARAMS				=	461,
	ERR_ALREADYREGISTERED			=	462,

	/*
	 * A quick side-rant about the next group of numerics..
	 * There are clients out there that like to assume that just because they don't recieve a numeric
	 * they know, that they have joined the channel.
	 *
	 * If IRC was at all properly standardised, this may even be a semi-acceptable assumption to make,
	 * but that's not the case as we all know, so IT IS NOT ACCEPTABLE. Especially for Insp users, where
	 * differing modules MAY potentially choose to block joins and send NOTICEs or other text to the user
	 * instead!
	 *
	 * tl;dr version:
	 *   DON'T MAKE YOUR CLIENT ASSUME YOU JOINED UNLESS YOU RECIEVE A JOIN WITH YOUR DAMN NICK ON IT.
	 * Thanks.
	 *
	 *  -- A message from the IRC group for coder sanity, and w00t
	 */
	ERR_BADCHANNELKEY				=	475,
	ERR_INVITEONLYCHAN				=	473,
	ERR_CHANNELISFULL				=	471,
	ERR_BANNEDFROMCHAN				=	474,

	ERR_NOPRIVILEGES				=	481, // rfc, beware though, we use this for other things opers may not do also
	ERR_CHANOPRIVSNEEDED				=	482, // rfc, beware though, we use this for other things like trying to kick a uline

	ERR_ALLMUSTSSL					=	490, // unrealircd
	ERR_NOCTCPALLOWED				=	492, // XXX: bzzzz. 1459 defines this as ERR_NOSERVICEHOST, research it more and perhaps change this! (ERR_CANNOTSENDTOCHAN?)
											// wtf, we also use this for m_noinvite. UGLY!
	ERR_DELAYREJOIN					=	495, // insp-specific, XXX: we should use 'resource temporarily unavailable' from ircnet/ratbox or whatever
	ERR_UNKNOWNSNOMASK				=	501, // insp-specific
	ERR_USERSDONTMATCH				=	502,
	ERR_CANTJOINOPERSONLY			=	520, // unrealircd, but crap to have so many numerics for cant join..
	ERR_CANTSENDTOUSER				=	531, // ???

	RPL_COMMANDS						=	702, // insp-specific
	RPL_COMMANDSEND						=	703, // insp-specific

	ERR_WORDFILTERED					=	936, // insp-specific, would be nice if we could get rid of this..
	ERR_CANTUNLOADMODULE				=	972, // insp-specific
	RPL_UNLOADEDMODULE				=	973, // insp-specific
	ERR_CANTLOADMODULE				=	974, // insp-specific
	RPL_LOADEDMODULE				=	975 // insp-specific
};

#endif