/************************************************************************ * IRC - Internet Relay Chat, 2.4.notes * Copyright (C) 1990 Markku Savela * * This program 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; either version 1, or (at your option) * any later version. * * 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, write to the Free Software * Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA. */ IRC 2.4 release notes 6 May 1990/msa (Markku.Savela@vtt.fi) ============================================================ This document explains the changes I have done up to this point. Some additional changes and packaging has been made by Chelsea (chelsea@earth.cchem.berkeley.edu). This is personal view of the changes. CHANGES TO LAST THE OFFICIAL RELEASE (2.2PL1) This release of irc2.4 is based to 2.2PL1 release (see the HISTORY chapter later in this document). Aside from fixing the bugs, this version is in many ways different from the 2.2PL1. The purpose of the most changes is to make it easier to run an IRC server. Normal users benefit from these changes indirectly by getting a better maintained server. 1. Changes visible to normal users Even while mainly fixing bugs, some user visible changes have crept in too. 1.1 General note on wildcards Many commands accept now wildcard matching where applicable. All compares are case insensitive (e.g. "a" == "A"). The wild cards are ? matches any single character * matches any number of characters, also empty string. [PL1 had a bug, which caused "*du*" not match "....edu"]. 1.2 Server supported wildcards for "/who mask" command. Protocol message is "WHO mask", where mask can be empty 0 List all users [No change from PL1] * List all users on the same channel where the user is (or all, if user is on 0) [No change from PL1]. number List all users on the specified channel [No change from PL1]. Note, if the "mask" begings with a digit, this form is assumed, and the remainder of mask is ignored, e.g. "/who 12*.fi" gives all people from channel 12 and ignores the "*.fi" part. mask If the mask is any string, it will be compared *separately* to each information field of the user and if a match is found in any field, that user is included into the list. The fields searched are nickname loginname (account name) real name (text shown in parenthesis) hostname (users machine) servername (server he/she is using) Note: servername is not usually shown on WHO output, but is included in anyway. Example: finding all users somehow connected with Finnish sites, can be achieved with mask "*.fi". 1.3 Changes to /whois command As WHO, also /whois accepts wild cards as a parameters. WHOIS returns information for all users whose nickname matches the specified mask. WHOIS automaticly calls WHOWAS [see below], if the attempted nickname is not found. 1.4 Short term "WHOWAS" history The server has a short in memory cache of the recent nickname changes (the current default is set to 200 last changes). The design goal of this is that it remembers changes in last few minutes, there is no intention of this to be a long term history. That must be a separate project, although it could use the hooks provided by this service. "WHOWAS nickname" queries this cache and returns about the same information that WHOIS would do, if the nickname is found. Wildcards are not accepted here, this is a specifically designed feature. If the name is not found, WHOWAS doesn't reply anything. This is because the most useful use of WHOWAS is implicitly through "WHOIS". This history is also implicitly utilized by KILL command. 1.5 New SERVER-SERVER/SERVER-CLIENT protocol message WALLOPS The message ":source WALLOPS :Message" sends the message text to all operators that are currently online. Any user can use this command, it's not restricted. How this function is activated, depends on the client, but if nothing else works, "/quote wallops text" should. NOTE:This function will not be fully operational until *ALL* servers have upgraded to version 2.4. Also, operators must be using a client that recognizes this command. This is really a hasty addition. But, done this way it follows the general IRC message philosophy, where messages are sent only to links where they are needed (e.g. WALLOPS goes only to servers that have opers online--it's not broadcast to every server). 1.6 General use of wildcarding in server queries All commands that previously took a servername as a parameter, now accept also a wildcarded mask. The mask is replaced with the first matching servername. The following user level commands are affected /admin server -- administrative info /time server -- local time /version server -- the server version /motd server -- "the message of the day" /info server -- info (usually same on same server version) /stat f server -- statistics information /users server -- users logged on server machine Note: Remote capability is a new feature for "info" and "stat" commands. Until all servers have upgraded, these commands may not reach the intended target and may return the information from some intermediate server. 1.7 Marking user AWAY v2.2PL1 version and earlier showed the AWAY-state (G) only for the local users of the same server. AWAY status could be queried only by sending a message to a user. This release (or since msa.4) broadcasts the away status to every server and the commands /WHO and /WHOIS give this information reliably. A side effect of this change is: when a user marks himself/herself as AWAY, all pre-msa.4 servers that are reached will send back an acknowlegde message. Until all servers are upgraged, use of AWAY is somewhat inconvenient. If you get extra messages from AWAY, they also contain the server information. Use /admin command and send a *friendly* request for the admin to upgrage his/her server to a working version, namely 2.4 :) 1.8 Servers don't restrict characters within messages The parameter fields of the messages can now contain any characters in range 1-255, except '\r', '\n' and '\0'. The client programs should by default filter away the "dangerous" control characters, but intelligent clients can utilize this change and allow exchanges with foreign 8-bit (or wider) charactersets. (The actual command parts must still be represented with the ordinary 7-bit characters.) 2. Changes visible to the server administrator 2.1 Identifying servers Servers/clients have now always two names (it was this way in PL1, but I think this version makes the idea more clear): Announced Name: The official name of the server (the name you use in /time, /quote connect, etc) or users nickname. Servers name is usually the hostname, but can actually be almost any string of characters resembling hostname. This one is given in M-line of ircd.conf. Socket hostname: Socket hostname of the server or client. This is the hostname of the connecting server/client and this is resolved from the connection. If resolve cannot be done, ircd defaults to using numeric IP-address. *ALL* access checks are based on this name, especially noteworthy fact, if your resolver cannot find hostnames by IP-address, you must allow the access by IP-numbers in your ircd.conf. In many places, where servers name is shown, actually both are shown. The general format of the displayed name is AnnouncedName[SocketHostName] When a connection is yet unkown, there is no AnnouncedName, and if the AnnouncedName is the same as SocketHostName, the "[..]"-part is omitted. 2.2 Many notices to local operators If an oper is signed on the server, he/she will receive many notices about exceptional conditions and servers actions. When something goes wrong, it should be much easier to fix the problems. Few often occurring, inportant error messages are "Write error to SERVERNAME, closing link" write() to socket returned with an error. Server is closing the link. This means usually network problems which you can do nothing about. "Max buffering limit exceeded for SERVERNAME" This is the situation where old server would have been "frozen". The socket buffers in your OS have been filled and even servers own predefined internal buffering MAX for a link has been exceeded. Exceeding this limit most likely means that the link is really dead, so the server closes the link and scratches all queued output for it. If the limit is set high ( > 20000 bytes), you won't usually see this, but just "No responce from SERVERNAME, closing link" as the server does not reply to PING as it should. "Link SERVERNAME cancelled, server SERVERNAME already exits" Two different servers from your net fragment attempted to connect same other net fragment about the same time and this collision is detected at your server. IRC routing does not allow loops, the link causing the loop is closed. (Which of the two links gets closed is mostly determined by pure chance and timing--you may lose a better link this way. Collisions should be rare in normal operation, if the timers in "config.h" are not messed up too much...) Of course, you get this too, if you try to connect to a server that is already connected by some other route. In that case your attempted connection is just safely cancelled. The notices attempt to be self explaining. 2.3 Links statistics collecting IRCD now counts the bytes and messages transmitted to each open link. This information can be output with a command "/stats l" ("/stats" or "/stat m" will give the old message count statistics). Sample output Link SendQ SendM SendBytes RcveM RcveBytes Open since oddjob.uchicago 0 203 8067 772 34321 Sun May 6 02:15:45 1990 cs.hut.fi[sauna 0 1916 79798 94 3082 Sun May 6 01:51:25 1990 otax.tky.hut.fi 0 3722 151511 426 22690 Sun May 6 00:25:54 1990 nada.kth.se 0 8775 355811 5333 223853 Sat May 5 14:11:49 1990 vehka.cs.uta.fi 0 23816 882000 901 41156 Fri May 4 22:50:23 1990 lut.fi 0 25145 943765 1068 35020 Fri May 4 22:34:16 1990 kreeta.helsinki 0 24286 899191 957 47085 Fri May 4 22:33:28 1990 naakka.tut.fi 0 27754 1067302 8288 362960 Fri May 4 22:33:14 1990 joyx.joensuu.fi 0 30003 1172949 2300 80053 Fri May 4 22:33:05 1990 tel4.tel.vtt.fi 04083771 167473890 863475 35022755 Mon Apr 23 00:15:17 1990 | | | | | | | | | | | Link established | | | | The number of bytes received | | | The number protocol messages received | | The number of bytes transmitted | The number of protocol messages transmitted The amount of queued data in bytes (if socket is hung) The last row (with the local servername) contains the total cumulative counts for all connections since the server was started. One can query the statistics of a remote server by adding the servers name to the command "/stat l servername". Of course, this only works, if all intermediate servers have upgraged. The first "old" server will stop the propagation and return the message counts by default. 2.4 Connecting servers An oper can manually activate a connection phase to any server defined in ircd.conf C-lines (to successfully complete the connection, the N-line must be present too). The message achieving this is CONNECT servername portnumber where servername may be a mask string containing wildcards. This name is matched against entries in ircd.conf (notice: the testing is made in reverse order, e.g. the last C-line in ircd.conf is tested first). If portnumber is omitted, the ircd uses the one given in the found C-line. If the C-line does not have the portnumber, the compiled default will be used (PORTNUM from config.h). This release allows also for remote connecting. An oper can send a connect request to remote server with CONNECT servername portnumber remoteserver This command is passed to the 'remoteserver' and it then tries to execute it like it was given locally. (If there are opers online on that server, they will get a notice about this happening.) Note, that one can remotely connect only what is defined in ircd.conf. Usually one needs and should use this only for immediate your neighbours. Nobody should randomly go and give connect requests to distant servers, unless one knows it's absolutely necessary and is very familiar about the linking setup there. 2.4 Terminating connections The SQUIT command in PL1 was not intended to be used manually and was very dangerous to use (it also created so called "ghost servers"). Since msa.4, the SQUIT has been safer to use manually. "SQUIT z" s a \ / \ / ------- x ------- y --| |-- z ------- b / ^ \ / | \ p c "SQUIT z" will break the link between "y" and "z" if injected into system from "s". After that the net will be in two fragmets, broken between "y" and "z". Server "z" never sees the actual SQUIT, all it observers is that the link to "y" suddenly closes (opers on z would see it as "Server y closed the connection" notice. Opers on y would see it as "Received remote SQUIT from x", note that the actual source "s" is not identified in the current version--for reasons too complicated to be explained here). *WARNING* *WARNING* If the server "y" is still running pre-msa.4 (like PL1), don't *EVER* issue a SQUIT for its links (unless the link is to a leaf node or verifiably a "ghost server"). Note, that when the link between "y" and "z" breaks, y will spit out SQUIT's for "z", "a", "b" and "c" to "x". At same time "z" is sending SQUIT's for "x", "s", "p", etc to "a", "b" and "c". SQUIT is normally generated by servers automaticly, it's just a later modification (msa.4) that allows an OPER to use this same message to "simulate" a link break at certain point. *IMPORTANT* If server "z" has configuration "C:y::y:6667", it automaticly attempts to reconnect after a short delay (currently 10 seconds), but only *if* the connection has been up long enough reliably (currently set to 10 minutes). If the thus formed link is squit another time, it will not attempt to come back immeatedly. This gives an oper time to reconfigure the links if that first short delay is not enough. As in all commands, also SQUIT accepts wildcards, but be careful to give sufficient identification. SQUIT of wrong server is not nice... 2.5 KILL message KILL will implicitly use the history database. If a KILL is issued for a nick that has been changed to another, the server will automaticly re-issue the kill with the new nickname, if the change has happened recently (current value should be 90 seconds). If a "terrorist" is clearly distrupting channel by bombarding it with garbage from negative channels and changing nick all time, there is no need to consult the "WHOWAS" data base, just use the nickname that was used to send the garbage and ircd hunts the culprit down. When this change of target happens, the oper issuing the kill is notified. NOTE: With automatic, kill-proof-reconnecting clients, the value of KILL is becoming insignificant... 2.6 Changing the server defaults from the command line The servers activation command is now ircd[ -f configfile][ -h servername][ -p portnumber][ -x debuglevel] where parameters can be given in any order. If the "configfile" is defined, it will override the default specified in the file "config.h". If "servername" is defined, it will override the one defined in the M-line on the configuration line. "portnumber" will override the compiled default (from "config.h") or the one from the M-line of the configuration file. The "debuglevel" will determine the amout of logging the server does into a log file that has been define in "config.h". The "debuglevel" should never be defined for a server running normally, it can quickly generate megabytes of trace. Usually needed only when the server is incapable of starting properly at all, then one run with "-x9" usually is enough to reveal the problem. 3. General cleaning up and commenting the code This issue is controversial. My way of fixing bugs is not just fix them, I also want to program defensively, make it difficult to make new errors. Thus I have heavily reformatted and reorganized those files that I have had to touch. Some functions have been renamed intentionally to catch all uses of those functions [because the functions semantics or calling sequences have been changed]. This release (2.4) will be the last IRC version I'm contributing to. If you have any wishes or complains about the code or functioining of IRC, use the source or ask whomever it happens to be the current developer. HISTORY There have been many different versions of IRC and many of those versions are still in use. The following attempt to bring some clarification to the versions. This starts from 2.01.6, hopefully no servers are running older versions... ... ... 2.01.6 A version from WiZ in summer 1989 ... 2.01t6 A series of releases, which contained minor 2.01T6 adjustements and bug fixes to the base version. 2.01u6 Some of those fixes caused extra errors, of 2.01U6 this series versions 2.01U6 and 2.01v6 are at 2.01v6 least known to be rather stable. 2.1.0 Mike Bolotski created these versions from the sources 2.1.1 of 2.01U6, but unfortunale some devious bug crept in and caused a lots of linking problems (the nasty "ghost server problem" splintered the net constantly). These versions must be deleted on sight :) [Autumn 1989] 2.2 This version is the 2.01v6 sources repackaged into multiple directories by Mike again. Probably nobody is running this base version, because is was promptly followed by two patch releases [Autumn 1989] 2.2PL0 These two are the last major "official" releases 2.2PL1 and most of the servers upgraged to either of these. 2.2msa Unfortunately 2.2PL1 version had a tendency to die mysteriously very often. So, I started to look into the code from March 1990 and that resulted a series of patches to the 2.2PL1 server code, but finally decided to release full server code releases of which few have got wider distribution 2.2msa.4 Has most of the known PL1 bugs fixed and seems to be very reliable. But once servers started staying up, a new problem appeared: socket buffers started getting full and servers tended to freeze very often for long intervals. 2.3alpha 2.3 Is an attempt to make an official release from 2.2msa.4 code, but hassles with changed copyrights make this version unacceptable. Besides, 2.3alpha or 2.2msa.4 are now obsolete, old versions :) 2.2msa.x To solve the freezing problems, the server code is changed to use non-blocking sockets. 2.2msa.7 2.2msa.9 Are intermediate test versions, of which .9 seems to have most of the problems solved. 2.2msa.10 Never released. This is slightly improved version of msa.9, some new features. 2.4 Is a release which combines 2.2msa.10 and Chelsea's modifications to the server. Also, this release has once again reorganized the directories and makefiles. -- msa (Markku.Savela@vtt.fi)