/* ** Raws (Numerics) reference version 1.08.01.08.11 ** Downloaded from paiRC - http://www.pairc.com/ ** All content is written by pai. (pai@pairc.com) ** See http://www.pairc.com/about.html for copyright details. ** Please distribute freely, but do not remove this information. ** Best viewed with word wrap ON. */ Raw 001 ------- Format : 001 :Welcome to the Internet Relay Network Example: 001 :Welcome to the Internet Relay Network Gemini Network: All Parameters ---------- Your nickname. Info ---- Sent to all clients once a connection has been established and the user has successfully registered. Notes ----- This is the first point where a script or client can be sure that the user's connection has been accepted without errors or problems. This reply is sent once upon connection automatically, and never again during an IRC session. Variations ---------- On many networks (such as DALnet) the user's full address will be given instead of just a nickname, for example- 001 :Welcome to the Internet Relay Network Gemini!zodiac@port123.stupid.com Also, many networks change the message itself to include the network's name in the message, for example- 001 :Welcome to the DALnet IRC Network pai!goddess@21.9.234.32 You cannot be guaranteed that the network name or user's nickname/address will always be in the same position. See Also -------- The following are sent in sequence on connection- 001, 002, 003, 004 Raw 002 ------- Format : 002 :Your host is , running version Example: 002 :Your host is StLouis.MO.US.UnderNet.org, running version u2.10.04 Network: All Parameters ---------- The name of the server you have connected to. The version of IRCd the server is running. Info ---- Sent to all clients once a connection has been established and the user has successfully registered. Notes ----- The version code is one way to determine what special 'features' a server supports. Some common version codes- (* can match anything) * u2.10.* - Undernet * dal4.* - DALnet * 2.8* - EFnet * 2.9.* - Ircnet Note that other nets may use the same IRCd as a popular net listed above- Just because a version matches the list above does not mean you are on that particular network. If you want to get the server version while you are connected, you can use VERSION. This reply is sent once upon connection automatically, and never again during an IRC session. See Also -------- The following are sent in sequence on connection- 001, 002, 003, 004 Raw 003 ------- Format : 003 :This server was created Example: 003 :This server was created Thu May 21 1998 at 18:27:08 CDT Network: All Parameters ---------- The date and time the server was created or last restarted. Info ---- Sent to all clients once a connection has been established and the user has successfully registered. Notes ----- You should not rely on these dates and times being in any specific format. This reply is sent once upon connection automatically, and never again during an IRC session. See Also -------- The following are sent in sequence on connection- 001, 002, 003, 004 Raw 004 ------- Format : 004 Example: 004 StLouis.MO.US.UnderNet.org u2.10.04 dioswkg biklmnopstv Network: All Parameters ---------- The name of the server you have connected to. The version of IRCd the server is running. The various user modes the server supports The various channel modes the server supports Info ---- Sent to all clients once a connection has been established and the user has successfully registered. Notes ----- All user modes and channel modes (including o for IRC operator, etc.) are listed, however not all may be accessable to a given user. The version code is one way to determine what special 'features' a server supports. Some common version codes- (* can match anything) * u2.10.* - Undernet * dal4.* - DALnet * 2.8* - EFnet * 2.9.* - Ircnet Note that other nets may use the same IRCd as a popular net listed above- Just because a version matches the list above does not mean you are on that particular network. If you want to get the server version while you are connected, you can use VERSION. This reply is sent once upon connection automatically, and never again during an IRC session. See Also -------- The following are sent in sequence on connection- 001, 002, 003, 004 Raw 005 - MAP reply ------------------- Format : 005 : Example: 005 : | `-Baltimore.MD.US.Undernet.Org Network: Some (Undernet) Parameters ---------- A string showing the relative position of one server Info ---- Sent to a user in reply to a MAP command. When a user requests a MAP, one line is sent for each server, and displaying all of the lines in a fixed width font will show a 'map' of how the servers are connected. Notes ----- The string is intended for user viewing- Although the format is consistent, you should probably not rely on it being in any given format. See Also -------- The following are sent in reply to a MAP- 005 (one or more), 007 Returned From ------------- MAP Raw 005 - Protocol string ------------------------- Format : 005 :are available on this server Example: 005 NOQUIT TOKEN WATCH=128 SAFELIST :are available on this server Network: Some (Undernet, DALnet) Parameters ---------- A list of special features ("protocols") that the server supports. Info ---- This is sent when you connect to many servers, after the 004 reply. You may receive more than one 005 reply. Notes ----- Protocols are separated with spaces- no protocol token will contain a space. Not all servers support all protocols. Some protocols that may appear here- * NOQUIT - Reduces server-to-server bandwidth during splits. (no effect on users) * TOKEN - Uses tokens to reduce server-to-server bandwidth. (no effect on users) * WATCH=128 - Supports the WATCH command, with a 128 user limit. * SAFELIST - Channel LISTs will be sent in chunks to reduce the chance of being disconnected. * SILENCE=15 - Supports the SILENCE command, with a 15 entry limit. * WHOX - Supports an extended syntax for the WHO command. (Undernet) * WALLCHOPS - Supports the WALLCHOPS command, to send channel op notices. * USERIP - Supports the USERIP command. * CPRIVMSG - Supports the CPRIVMSG command. * CNOTICE - Supports the CNOTICE command. * MODES=6 - Up to 6 channel mode changes can be performed in a single line. This only applies to user-based modes such as op, voice, etc. * MAXCHANNELS=10 - A user can be in up to 10 channels simultaneously. * MAXBANS=30 - A channel banlist can contain up to 30 bans. * NICKLEN=9 - Nicknames can be up to 9 characters long. * TOPICLEN=160 - Channel topics can be up to 160 characters long. * KICKLEN=160 - Kick messages can be up to 160 characters long. * CHANTYPES=+#& - Server supports channels starting with the listed characters. For example, this server allows +channel, #channel, and &channel. * PREFIX=(ov)@+ - Server supports the listed channel user modes. The characters for the modes are in parenthesis; the resulting symbols are afterwards. For example, this server supports o (op) and v (voice) which will use characters @ and +. * PREFIX=@+ - Server supports the listed channel user modes. Only the symbols are listed with this format. For example, this server supports @ for op and + for voice. * CHANMODES=b,k,l,imnpst - Server supports the listed channel modes. This contains four sets of modes, separated by commas. The first set lists modes that affect a list, such as bans. The second lists modes that take a parameter, such as setting a key. The third lists modes that only take a parameter when being set, such as channel limit. The fourth lists modes that never take a parameter, such as invite-only. * CHARSET=rfc1459 - The character set that the server uses to communicate. "rfc1459" is the normal IRC character set. * NETWORK=DALnet - The name of the network is listed. Other protocols not listed above may exist on some servers. Additional protocols may be added to a server at any time. See Also -------- The following are sent in sequence on connection to servers supporting this reply- 001, 002, 003, 004, 005 Raw 007 ------- Format : 007 :End of /MAP Example: 007 :End of /MAP Network: Some (Undernet) Info ---- Sent to a user in reply to a MAP command. This marks the end of the reply. See Also -------- The following are sent in reply to a MAP- 005 (one or more), 007 Returned From ------------- MAP Raw 008 ------- Format : 008 :: Server notice mask () Example: 008 1234 :: Server notice mask (0x4d2) Network: Obsolete (Undernet) Parameters ---------- The decimal value of the server notice mask. (from 1 to 8191) The hexadecimal value of the server notice mask. (from 0x1 to 0x1fff) Info ---- Sent to a user when they set or view their server notice mask. This feature was part of older Undernet IRCds, but is no longer available to normal users. It may appear on other networks. Notes ----- A server notice mask is a special extension of the +s user MODE on older Undernet IRCds. It is viewed like any other user MODE, using the MODE command. To set it, you would type something such as- MODE mynick +s 1234 The mask is 13 bits wide and determines which categories of server notices are sent to you. Advanced -------- Some users may be able to view other user's MODEs. In this case, their nickname will be in the reply where YOUR nick would usually be. ($1 in mIRC remotes.) This raw my appear as raw 108 in this case. (viewing other user's MODEs) See Also -------- If the server supports server notice masks, then using MODE to view user mode may return- 221, 008 Returned From ------------- MODE Raw 211 ------- Format : 211 : Example: 211 irc1.sprynet.com 0 49243278 3327277 22095880 1208863 :134450 Network: All This raw is only partially documented- if you have more information on this raw please contact pai@pairc.com. Parameters ---------- The connection or link name. May include a host or port mask in [brackets] after the server name or address. Number of bytes that are buffered but unsent on this connection. (?) Number of messages sent on this connection. Number of bytes sent on this connection. Number of messages received from this connection. Number of bytes received from this connection. Amount of time (in seconds?) this connection has been open. Info ---- A series of these are sent in reply to a STATS l request. (lowercase L) They represent the ports and connections a server has available for users to connect to. You must be an IRCop to use this feature on some servers. Variations ---------- Like most STATS replies, the format of this reply can vary greatly from network to network. Although many networks no longer let you use this, these examples are taken from previous times when they would reply to these raws- * DALnet 211 stlouis.mo.us.dal.net[*.7325] 0 1902 138 1290 24 1132 :0 211 viper.mo.us.dal.net[209.96.0.13] 0 21928 1062 166461 9935 1127 :0 * Undernet 211 NewBrunswick.NJ.US.Undernet.Org[*.6669] 0 106425518 9240002 20983702 1503812 :3240148 211 NewBrunswick.NJ.US.Undernet.Org[*@204.127.145.*.5832] 0 2307876 204111 161880 6159 :3240148 211 Ice_Age[12.69.75.157] 0 2 0 3 0 :22 211 [198.139.11.11] 0 0 0 0 0 :59 * EFnet 211 irc.cs.cmu.edu[unknown@*@*.6666] 0 14555473 1112048 3423266 153641 :1173564 1173564 - 211 irc1.sprynet.com[0.0.0.0.9999] 0 188077 20386 12894 848 :134450 As can be seen, the format of the connection parameter is where the most differences are found. Usually this is the name of your server, but on Undernet some lines exist without server names. Usually the name is followed by a mask in brackets. This mask may contain a mask to match against a user address, a port, or other details. The sentmsg/recdmsg and sentbyte/recdbyte parameters may differ in actual calculation from server to server. Some servers may count sentbyte/recdbyte in kilobytes instead of bytes. Also notice how DALnet servers and at least one EFnet server return additional data. On DALnet, the final parameter is actually idle time for that connection. (in seconds?) On EFnet the additional parameter seems to be a duplicate of the open parameter. (?) As a final note, many networks send a header line before the actual replies, such as- 211 SendQ SendM SendBytes RcveM RcveBytes Open_since :Idle Remember to account for this possibility when parsing replies. Advanced -------- The primary use for this is selecting a good port to connect to your server. The port will usually be found in the connection parameter, within brackets, as the last token seperated by periods. For example, in "NewBrunswick.NJ.US.Undernet.Org[*.6669]" the port is 6669; in "irc.cs.cmu.edu[unknown@*@*.6666]" the port is 6666; in "irc1.sprynet.com[0.0.0.0.9999]" the port is 9999. If no brackets are found, the port is probably 6667. (the default port.) If no port is listed, then you should probably ignore that line. Also, if the brackets contain other specifics besides a port, you can probably assume that the port is reserved for certain users. To determine the best port, you should find the port with the lowest traffic. This can usually be best estimated by adding together sentmsg and recdmsg or sentbyte and recdbyte. You may want to divide by the connection open time to get an average throughput. See Also -------- The following are sent in response to a STATS l request- (lowercase L) 211 (multiple lines), 219 Returned From ------------- STATS Raw 212 ------- Format : 212 Example: 212 PRIVMSG 28931 1446042 Network: All This raw is only partially documented- if you have more information on this raw please contact pai@pairc.com. Parameters ---------- The name of an IRC command. The number of times the command has been used on this server. A measurement of command usage in bytes or something similar. (Not exactly sure on this one?) Info ---- A series of these are sent in reply to a STATS m request. They contain statistics on the commands a server supports. You must be an IRCop to use this feature on some servers. See Also -------- The following are sent in response to a STATS m request- 212 (multiple lines), 219 Returned From ------------- STATS Raw 213 ------- Format : 213 C
* Example: 213 C *@205.150.226.4 * toronto.on.ca.dal.net 0 50 Network: All This raw is only partially documented- if you have more information on this raw please contact pai@pairc.com. Parameters ----------
IP mask for a server. (?) Server name or mask. Port server must connect to, if any. (?) Unsure. (?) Info ---- A series of these are sent in reply to a STATS c request. You must be an IRCop to use this feature on some servers. Notes ----- A STATS c request lists servers that can and cannot connect to a given server. Both 213 (C-lines) and 214 (N-lines) may be returned. See Also -------- The following are sent in response to a STATS c request- 213 and 214 (multiple lines), 219 Returned From ------------- STATS Raw 214 ------- Format : 214 N
* Example: 214 N *@206.173.136.211 * *.concentric.net 0 10 Network: All This raw is only partially documented- if you have more information on this raw please contact pai@pairc.com. Parameters ----------
IP mask for a server. (?) Server name or mask. Port server cannot connect to, if specified. (?) Unsure. (?) Info ---- A series of these are sent in reply to a STATS c request. You must be an IRCop to use this feature on some servers. Notes ----- A STATS c request lists servers that can and cannot connect to a given server. Both 213 (C-lines) and 214 (N-lines) may be returned. See Also -------- The following are sent in response to a STATS c request- 213 and 214 (multiple lines), 219 Returned From ------------- STATS Raw 215 ------- Format : 215 I * Example: 215 I *@204.127.145.* * NOMATCH 0 3 Network: All This raw is only partially documented- if you have more information on this raw please contact pai@pairc.com. Parameters ---------- Mask applied to a userhost with IP address. Mask applied to a userhost with a resolved address. Port user has connected to. (?) Unsure. (?) Info ---- A series of these are sent in reply to a STATS i request. You must be an IRCop to use this feature on some servers. Notes ----- A STATS i request (I-lines) lists classes of clients that are allowed to connect to a server. See Also -------- The following are sent in response to a STATS i request- 215 (multiple lines), 219 Returned From ------------- STATS Raw 216 ------- Format : 216
*
Example: 216 k 147.253.230.* * ~* Temporary K-line 60 min. for Auto-kline, clones (1998/07/22 12.55) Network: Most This raw is only partially documented- if you have more information on this raw please contact pai@pairc.com. Parameters ---------- k for a temporary K-line, K for a 'permanent' K-line. (?)
Address to match against user. Matched against usernames. (identds)
Reason for the K-line. Info ---- A series of these are sent in reply to a STATS k request. You must be an IRCop to use this feature on some servers. Notes ----- A STATS k request (K-lines) lists classes of clients that are not allowed to connect to a server. Variations ---------- Other servers may use another format, for example- 216 K *.mediaone.net MEDIAONE users must run IDENTD to connect 02-10-98 *~* 0 -1 Here, the username parameter is moved to third to last. (unsure of the relevance of the 0 and -1) Some servers or networks will not list K-lines. See Also -------- The following are sent in response to a STATS k request- 216 (multiple lines), 219 Returned From ------------- STATS Raw 217 ------- Format : 217 P Example: 217 P 6666 181 0x2000 Network: Some (Undernet) This raw is only partially documented- if you have more information on this raw please contact pai@pairc.com. Parameters ---------- Port for connections to a server. Unsure. Info ---- A series of these are sent in reply to a STATS p request on some servers. You must be an IRCop to use this feature on some servers. Notes ----- Each line lists a port (other than the default 6667 port) on which clients can connect to the server. See Also -------- The following are sent in response to a STATS p request- 217 (multiple lines), 219 Returned From ------------- STATS Raw 218 ------- Format : 218 Y Example: 218 Y 100 120 240 1 5000000 Network: All This raw is only partially documented- if you have more information on this raw please contact pai@pairc.com. Parameters ---------- Connection class. (a numeric ID) Maximum sendq allowed for this class, in bytes. The frequency of PINGs sent to an idling client, in seconds. Connect frequency. (?) The maximum number of concurrent connections allowed for a user. Info ---- A series of these are sent in reply to a STATS y request. You must be an IRCop to use this feature on some servers. Notes ----- Each line lists a Y-line, which details a connection class and their allowed priveledges. Connection classes are used in other lines, such as I-lines, N-lines, and C-lines. Thanks to Justin H for helping clear up some of this information. See Also -------- The following are sent in response to a STATS y request- 218 (multiple lines), 219 Returned From ------------- STATS Raw 219 ------- Format : 219 :End of /STATS report Example: 219 u :End of /STATS report Network: All Parameters ---------- The type of stats that were requested. Info ---- Returned at the end of a STATS request. Notes ----- Different types of STATS requests generate different replies, however this numeric will always be returned last, regardless of the request. If the server does not recognize a STATS request, this will be returned by itself with an asterisk (*) for char. See Also -------- The following are returned for various STATS requests- 211, 212, 213, 214, 215, 216, 217, 218, 222, 223, 224, 241, 242, 243, 244, 247, 248, 249, 250 Returned From ------------- STATS Raw 221 ------- Format : 221 Example: 221 +i Network: All Parameters ---------- Your usermode. Info ---- This is sent when you request to view your usermode using MODE. Advanced -------- Some users may be able to view other user's MODEs. In this case, their nickname will be in the reply where YOUR nick would usually be. ($1 in mIRC remotes.) See Also -------- If the server supports server notice masks, then using MODE to view user mode may return- 221, 008 Returned From ------------- MODE Raw 222 - B-line ---------------- Format : 222 B * Example: 222 B barracuda.sph.emory.edu * ircadmin 0 -1 Network: Some (EFnet) This raw is only partially documented- if you have more information on this raw please contact pai@pairc.com. Parameters ---------- A server name. (?) Unsure. Info ---- A series of these are sent in reply to a STATS b request. See Also -------- The following are sent in response to a STATS b request- 222 (zero or more), 219 Returned From ------------- STATS Raw 222 - Q-line ---------------- Format : 222 : Example: 222 *H*lp*S*rv* :Reserved for DALnet Services Network: Some (DALnet) Parameters ---------- A mask matched against nicknames or channels. A comment explaining the reason for the Q-line. Info ---- A series of these are sent in reply to a STATS q request. Notes ----- Each line lists a Q-line, which details a nickname or channel that normal users are not allowed to use. If a user attempts to use a nickname or channel matching a Q-line, they receive a 432 or 485 raw. See Also -------- The following are sent in response to a STATS q request- 222 (multiple lines), 219 The following raws are also related to Q-lines- 432, 485 Returned From ------------- STATS Raw 223 ------- Format : 223 E * Example: 223 E usr??.primenet.com * *mjr 0 -1 Network: Some (EFnet) This raw is only partially documented- if you have more information on this raw please contact pai@pairc.com. Parameters ---------- A hostmask to match addresses against. A mask to match against usernames. (identds) Unsure. Info ---- A series of these are sent in reply to a STATS e request. See Also -------- The following are sent in response to a STATS e request- 223 (one or more), 219 Returned From ------------- STATS Raw 224 ------- Format : 224 D * Example: 224 D 208.132.73.108 * * 0 -1 Network: Some (EFnet) This raw is only partially documented- if you have more information on this raw please contact pai@pairc.com. Parameters ---------- A mask to match IP addresses against. A mask to match against usernames. (identds) (?) Unsure. Info ---- A series of these are sent in reply to a STATS d request. See Also -------- The following are sent in response to a STATS d request- 224 (one or more), 219 Returned From ------------- STATS Raw 241 ------- Format : 241 L
* Example: 241 L * irc2.sprynet.com 0 -1 Network: All This raw is only partially documented- if you have more information on this raw please contact pai@pairc.com. Parameters ----------
IP mask for a server. (?) Server name or mask. Unsure. Info ---- A series of these are sent in reply to a STATS h request. You must be an IRCop to use this feature on some servers. Notes ----- A STATS h request lists servers that are treated as hubs and servers that are treated as leaves. Both 241 (L-lines) and 244 (H-lines) may be returned. See Also -------- The following are sent in response to a STATS h request- 241 and 244 (multiple lines), 219 Returned From ------------- STATS Raw 242 ------- Format : 242 :Server Up days,