Skip to content
This repository
Fetching contributors…


Cannot retrieve contributors at this time

file 139 lines (134 sloc) 19.835 kb
quIRC - simple terminal-based IRC client
Copyright (C) 2010-12 Edward Cree

See quirc.c for license information
numeric: IRC numeric replies

A symbolic name defined here does not necessarily imply recognition or decoding of that numeric reply.
Some numeric replies are non-normative; that is, they are not defined in the original RFC1459 or its superseding RFC2812, but instead are either defined in other, non-normative documents, or are entirely experimental. These are denoted with an X before the name (of the form RPL_X_BOGOSITY); where a numeric is being identified purely on the basis of usage "in the wild", the symbolic name will be completely arbitrary and may not align with usage elsewhere.

/* Error replies */
#define ERR_NOSUCHNICK 401 // "<nickname> :No such nick/channel" Used to indicate the nickname parameter supplied to a command is currently unused.
#define ERR_NOSUCHSERVER 402 // "<server name> :No such server" Used to indicate the server name given currently doesn't exist.
#define ERR_NOSUCHCHANNEL 403 // "<channel name> :No such channel" Used to indicate the given channel name is invalid.
#define ERR_CANNOTSENDTOCHAN 404 // "<channel name> :Cannot send to channel" Sent to a user who is either (a) not on a channel which is mode +n or (b) not a chanop (or mode +v) on a channel which has mode +m set and is trying to send a PRIVMSG message to that channel.
#define ERR_TOOMANYCHANNELS 405 // "<channel name> :You have joined too many channels" Sent to a user when they have joined the maximum number of allowed channels and they try to join another channel.
#define ERR_WASNOSUCHNICK 406 // "<nickname> :There was no such nickname" Returned by WHOWAS to indicate there is no history information for that nickname.
#define ERR_TOOMANYTARGETS 407 // "<target> :Duplicate recipients. No message delivered" Returned to a client which is attempting to send PRIVMSG/NOTICE using the user@host destination format and for a user@host which has several occurrences.
#define ERR_NOORIGIN 409 // ":No origin specified" PING or PONG message missing the originator parameter which is required since these commands must work without valid prefixes.
#define ERR_NORECIPIENT 411 // ":No recipient given (<command>)"
#define ERR_NOTEXTTOSEND 412 // ":No text to send"
#define ERR_NOTOPLEVEL 413 // "<mask> :No toplevel domain specified"
#define ERR_WILDTOPLEVEL 414 // "<mask> :Wildcard in toplevel domain" 412 - 414 are returned by PRIVMSG to indicate that the message wasn't delivered for some reason. ERR_NOTOPLEVEL and ERR_WILDTOPLEVEL are errors that are returned when an invalid use of "PRIVMSG $<server>" or "PRIVMSG #<host>" is attempted.
#define ERR_UNKNOWNCOMMAND 421 // "<command> :Unknown command" Returned to a registered client to indicate that the command sent is unknown by the server.
#define ERR_NOMOTD 422 // ":MOTD File is missing" Server's MOTD file could not be opened by the server.
#define ERR_NOADMININFO 423 // "<server> :No administrative info available" Returned by a server in response to an ADMIN message when there is an error in finding the appropriate information.
#define ERR_FILEERROR 424 // ":File error doing <file op> on <file>" Generic error message used to report a failed file operation during the processing of a message.
#define ERR_NONICKNAMEGIVEN 431 // ":No nickname given" Returned when a nickname parameter expected for a command and isn't found.
#define ERR_ERRONEOUSNICKNAME 432 // "<nick> :Erroneous nickname" Returned after receiving a NICK message which contains characters which do not fall in the defined set. See section x.x.x for details on valid nicknames.
#define ERR_NICKNAMEINUSE 433 // "<nick> :Nickname is already in use" Returned when a NICK message is processed that results in an attempt to change to a currently existing nickname.
#define ERR_NICKCOLLISION 436 // "<nick> :Nickname collision KILL" Returned by a server to a client when it detects a nickname collision (registered of a NICK that already exists by another server).
#define ERR_USERNOTINCHANNEL 441 // "<nick> <channel> :They aren't on that channel" Returned by the server to indicate that the target user of the command is not on the given channel.
#define ERR_NOTONCHANNEL 442 // "<channel> :You're not on that channel" Returned by the server whenever a client tries to perform a channel effecting command for which the client isn't a member.
#define ERR_USERONCHANNEL 443 // "<user> <channel> :is already on channel" Returned when a client tries to invite a user to a channel they are already on.
#define ERR_NOLOGIN 444 // "<user> :User not logged in" Returned by the summon after a SUMMON command for a user was unable to be performed since they were not logged in.
#define ERR_SUMMONDISABLED 445 // ":SUMMON has been disabled" Returned as a response to the SUMMON command. Must be returned by any server which does not implement it.
#define ERR_USERSDISABLED 446 // ":USERS has been disabled" Returned as a response to the USERS command. Must be returned by any server which does not implement it.
#define ERR_NOTREGISTERED 451 // ":You have not registered" Returned by the server to indicate that the client must be registered before the server will allow it to be parsed in detail.
#define ERR_NEEDMOREPARAMS 461 // "<command> :Not enough parameters" Returned by the server by numerous commands to indicate to the client that it didn't supply enough parameters.
#define ERR_ALREADYREGISTRED 462 // ":You may not reregister" Returned by the server to any link which tries to change part of the registered details (such as password or user details from second USER message).
#define ERR_NOPERMFORHOST 463 // ":Your host isn't among the privileged" Returned to a client which attempts to register with a server which does not been setup to allow connections from the host the attempted connection is tried.
#define ERR_PASSWDMISMATCH 464 // ":Password incorrect" Returned to indicate a failed attempt at registering a connection for which a password was required and was either not given or incorrect.
#define ERR_YOUREBANNEDCREEP 465 // ":You are banned from this server" Returned after an attempt to connect and register yourself with a server which has been setup to explicitly deny connections to you.
#define ERR_KEYSET 467 // "<channel> :Channel key already set"
#define ERR_CHANNELISFULL 471 // "<channel> :Cannot join channel (+l)"
#define ERR_UNKNOWNMODE 472 // "<char> :is unknown mode char to me"
#define ERR_INVITEONLYCHAN 473 // "<channel> :Cannot join channel (+i)"
#define ERR_BANNEDFROMCHAN 474 // "<channel> :Cannot join channel (+b)"
#define ERR_BADCHANNELKEY 475 // "<channel> :Cannot join channel (+k)"
#define ERR_NOPRIVILEGES 481 // ":Permission Denied- You're not an IRC operator" Any command requiring operator privileges to operate must return this error to indicate the attempt was unsuccessful.
#define ERR_CHANOPRIVSNEEDED 482 // "<channel> :You're not channel operator" Any command requiring 'chanop' privileges (such as MODE messages) must return this error if the client making the attempt is not a chanop on the specified channel.
#define ERR_CANTKILLSERVER 483 // ":You cant kill a server!" Any attempts to use the KILL command on a server are to be refused and this error returned directly to the client.
#define ERR_NOOPERHOST 491 // ":No O-lines for your host" If a client sends an OPER message and the server has not been configured to allow connections from the client's host as an operator, this error must be returned.
#define ERR_UMODEUNKNOWNFLAG 501 // ":Unknown MODE flag" Returned by the server to indicate that a MODE message was sent with a nickname parameter and that the a mode flag sent was not recognized.
#define ERR_USERSDONTMATCH 502 // ":Cant change mode for other users" Error sent to any user trying to view or change the user mode for a user other than themselves.

/* Command responses */
#define RPL_X_ISUPPORT 005 //
#define RPL_NONE 300 // Dummy reply number. Not used.
#define RPL_USERHOST 302 // ":[<reply>{<space><reply>}]" Reply format used by USERHOST to list replies to the query list. The reply string is composed as follows: <reply> ::= <nick>['*'] '=' <'+'|'-'><hostname> The '*' indicates whether the client has registered as an Operator. The '-' or '+' characters represent whether the client has set an AWAY message or not respectively.
#define RPL_ISON 303 // ":[<nick> {<space><nick>}]" Reply format used by ISON to list replies to the query list.
#define RPL_AWAY 301 // "<nick> :<away message>"
#define RPL_UNAWAY 305 // ":You are no longer marked as being away"
#define RPL_NOWAWAY 306 // ":You have been marked as being away" These replies are used with the AWAY command (if allowed). RPL_AWAY is sent to any client sending a PRIVMSG to a client which is away. RPL_AWAY is only sent by the server to which the client is connected. Replies RPL_UNAWAY and RPL_NOWAWAY are sent when the client removes and sets an AWAY message.
#define RPL_WHOISUSER 311 // "<nick> <user> <host> * :<real name>"
#define RPL_WHOISSERVER 312 // "<nick> <server> :<server info>"
#define RPL_WHOISOPERATOR 313 // "<nick> :is an IRC operator"
#define RPL_WHOISIDLE 317 // "<nick> <integer> :seconds idle"
#define RPL_ENDOFWHOIS 318 // "<nick> :End of /WHOIS list"
#define RPL_WHOWASUSER 314 // "<nick> <user> <host> * :<real name>"
#define RPL_ENDOFWHOWAS 369 // "<nick> :End of WHOWAS" When replying to a WHOWAS message, a server must use the replies RPL_WHOWASUSER, RPL_WHOISSERVER or ERR_WASNOSUCHNICK for each nickname in the presented list. At the end of all reply batches, there must be RPL_ENDOFWHOWAS (even if there was only one reply and it was an error).
#define RPL_LISTSTART 321 // "Channel :Users Name"
#define RPL_LIST 322 // "<channel> <# visible> :<topic>"
#define RPL_LISTEND 323 // ":End of /LIST" Replies RPL_LISTSTART, RPL_LIST, RPL_LISTEND mark the start, actual replies with data and end of the server's response to a LIST command. If there are no channels available to return, only the start and end reply must be sent.
#define RPL_CHANNELMODEIS 324 // "<channel> <mode> <mode params>"
#define RPL_NOTOPIC 331 // "<channel> :No topic is set"
#define RPL_TOPIC 332 // "<channel> :<topic>" When sending a TOPIC message to determine the channel topic, one of two replies is sent. If the topic is set, RPL_TOPIC is sent back else RPL_NOTOPIC.
#define RPL_X_TOPICWASSET 333 // "<channel> <nick> <time>" Indicates who set the TOPIC, and when. Not normative.
#define RPL_INVITING 341 // "<channel> <nick>" Returned by the server to indicate that the attempted INVITE message was successful and is being passed onto the end client.
#define RPL_SUMMONING 342 // "<user> :Summoning user to IRC" Returned by a server answering a SUMMON message to indicate that it is summoning that user.
#define RPL_VERSION 351 // "<version>.<debuglevel> <server> :<comments>" Reply by the server showing its version details. The <version> is the version of the software being used (including any patchlevel revisions) and the <debuglevel> is used to indicate if the server is running in "debug mode". The "comments" field may contain any comments about the version or further version details.
#define RPL_WHOREPLY 352 // "<channel> <user> <host> <server> <nick> <H|G>[*][@|+] :<hopcount> <real name>"
#define RPL_ENDOFWHO 315 // "<name> :End of /WHO list" The RPL_WHOREPLY and RPL_ENDOFWHO pair are used to answer a WHO message. The RPL_WHOREPLY is only sent if there is an appropriate match to the WHO query. If there is a list of parameters supplied with a WHO message, a RPL_ENDOFWHO must be sent after processing each list item with <name> being the item.
#define RPL_NAMREPLY 353 // "<channel> :[[@|+]<nick> [[@|+]<nick> [...]]]"
#define RPL_ENDOFNAMES 366 // "<channel> :End of /NAMES list" To reply to a NAMES message, a reply pair consisting of RPL_NAMREPLY and RPL_ENDOFNAMES is sent by the server back to the client. If there is no channel found as in the query, then only RPL_ENDOFNAMES is returned. The exception to this is when a NAMES message is sent with no parameters and all visible channels and contents are sent back in a series of RPL_NAMEREPLY messages with a RPL_ENDOFNAMES to mark the end.
#define RPL_LINKS 364 // "<mask> <server> :<hopcount> <server info>"
#define RPL_ENDOFLINKS 365 // "<mask> :End of /LINKS list" In replying to the LINKS message, a server must send replies back using the RPL_LINKS numeric and mark the end of the list using an RPL_ENDOFLINKS reply.v
#define RPL_BANLIST 367 // "<channel> <banid>"
#define RPL_ENDOFBANLIST 368 // "<channel> :End of channel ban list" When listing the active 'bans' for a given channel, a server is required to send the list back using the RPL_BANLIST and RPL_ENDOFBANLIST messages. A separate RPL_BANLIST is sent for each active banid. After the banids have been listed (or if none present) a RPL_ENDOFBANLIST must be sent.
#define RPL_INFO 371 // ":<string>"
#define RPL_ENDOFINFO 374 // ":End of /INFO list" A server responding to an INFO message is required to send all its 'info' in a series of RPL_INFO messages with a RPL_ENDOFINFO reply to indicate the end of the replies.
#define RPL_MOTDSTART 375 // ":- <server> Message of the day - "
#define RPL_MOTD 372 // ":- <text>"
#define RPL_ENDOFMOTD 376 // ":End of /MOTD command" When responding to the MOTD message and the MOTD file is found, the file is displayed line by line, with each line no longer than 80 characters, using RPL_MOTD format replies. These should be surrounded by a RPL_MOTDSTART (before the RPL_MOTDs) and an RPL_ENDOFMOTD (after).
#define RPL_YOUREOPER 381 // ":You are now an IRC operator" RPL_YOUREOPER is sent back to a client which has just successfully issued an OPER message and gained operator status.
#define RPL_REHASHING 382 // "<config file> :Rehashing" If the REHASH option is used and an operator sends a REHASH message, an RPL_REHASHING is sent back to the operator.
#define RPL_TIME 391 // "<server> :<string showing server's local time>" When replying to the TIME message, a server must send the reply using the RPL_TIME format above. The string showing the time need only contain the correct day and time there. There is no further requirement for the time string.
#define RPL_USERSSTART 392 // ":UserID Terminal Host"
#define RPL_USERS 393 // ":%-8s %-9s %-8s"
#define RPL_ENDOFUSERS 394 // ":End of users"
#define RPL_NOUSERS 395 // ":Nobody logged in" If the USERS message is handled by a server, the replies RPL_USERSTART, RPL_USERS, RPL_ENDOFUSERS and RPL_NOUSERS are used. RPL_USERSSTART must be sent first, following by either a sequence of RPL_USERS or a single RPL_NOUSER. Following this is RPL_ENDOFUSERS.
#define RPL_TRACELINK 200 // "Link <version & debug level> <destination> <next server>"
#define RPL_TRACECONNECTING 201 // "Try. <class> <server>"
#define RPL_TRACEHANDSHAKE 202 // "H.S. <class> <server>"
#define RPL_TRACEUNKNOWN 203 // "???? <class> [<client IP address in dot form>]"
#define RPL_TRACEOPERATOR 204 // "Oper <class> <nick>"
#define RPL_TRACEUSER 205 // "User <class> <nick>"
#define RPL_TRACESERVER 206 // "Serv <class> <int>S <int>C <server> <nick!user|*!*>@<host|server>"
#define RPL_TRACENEWTYPE 208 // "<newtype> 0 <client name>"
#define RPL_STATSLINKINFO 211 // "<linkname> <sendq> <sent messages> <sent bytes> <received messages> <received bytes> <time open>"
#define RPL_STATSCOMMANDS 212 // "<command> <count>"
#define RPL_STATSCLINE 213 // "C <host> * <name> <port> <class>"
#define RPL_STATSNLINE 214 // "N <host> * <name> <port> <class>"
#define RPL_STATSILINE 215 // "I <host> * <host> <port> <class>"
#define RPL_STATSKLINE 216 // "K <host> * <username> <port> <class>"
#define RPL_STATSYLINE 218 // "Y <class> <ping frequency> <connect frequency> <max sendq>"
#define RPL_ENDOFSTATS 219 // "<stats letter> :End of /STATS report"
#define RPL_STATSLLINE 241 // "L <hostmask> * <servername> <maxdepth>"
#define RPL_STATSUPTIME 242 // ":Server Up %d days %d:%02d:%02d"
#define RPL_STATSOLINE 243 // "O <hostmask> * <name>"
#define RPL_STATSHLINE 244 // "H <hostmask> * <servername>"
#define RPL_UMODEIS 221 // "<user mode string>" To answer a query about a client's own mode, RPL_UMODEIS is sent back.
#define RPL_LUSERCLIENT 251 // ":There are <integer> users and <integer> invisible on <integer> servers"
#define RPL_LUSEROP 252 // "<integer> :operator(s) online"
#define RPL_LUSERUNKNOWN 253 // "<integer> :unknown connection(s)"
#define RPL_LUSERCHANNELS 254 // "<integer> :channels formed"
#define RPL_LUSERME 255 // ":I have <integer> clients and <integer> servers" In processing an LUSERS message, the server sends a set of replies from RPL_LUSERCLIENT, RPL_LUSEROP, RPL_LUSERUNKNOWN, RPL_LUSERCHANNELS and RPL_LUSERME. When replying, a server must send back RPL_LUSERCLIENT and RPL_LUSERME. The other replies are only sent back if a non-zero count is found for them.
#define RPL_ADMINME 256 // "<server> :Administrative info"
#define RPL_ADMINLOC1 257 // ":<admin info>"
#define RPL_ADMINLOC2 258 // ":<admin info>"
#define RPL_ADMINEMAIL 259 // ":<admin info>" When replying to an ADMIN message, a server is expected to use replies RLP_ADMINME through to RPL_ADMINEMAIL and provide a text message with each. For RPL_ADMINLOC1 a description of what city, state and country the server is in is expected, followed by details of the university and department (RPL_ADMINLOC2) and finally the administrative contact for the server (an email address here is required) in RPL_ADMINEMAIL.
#define RPL_X_LOCALUSERS 265 // ":Current Local Users: <integer>\tMax: <integer>" Appears to count the users connected directly to the server. Non-normative.
#define RPL_X_GLOBALUSERS 266 // ":Current Global Users: <integer>\tMax: <integer>" Appears to count the users connected to the network. Non-normative.
Something went wrong with that request. Please try again.