1 # ircd.conf - configuration file for ircd version ircu2.10
3 # Last Updated: 20, March 2002.
5 # Written by Niels <niels@undernet.org>, based on the original example.conf,
6 # server code and some real-life (ahem) experience.
8 # Updated and heavily modified by Braden <dbtem@yahoo.com>.
10 # Rewritten by A1kmm(Andrew Miller)<a1kmm@mware.virtualave.net> to support
11 # the new flex/bison configuration parser.
13 # Thanks and credits to: Run, Trillian, Cym, Morrissey, Chaos, Flynn,
14 # Xorath, WildThang, Mmmm, SeKs, Ghostwolf and
15 # all other Undernet IRC Admins and Operators,
16 # and programmers working on the Undernet ircd.
18 # This is an example of the configuration file used by the Undernet ircd.
20 # This document is based on a (fictious) server in Europe with a
21 # connection to the Undernet IRC network. It is primarily a leaf server,
22 # but if all the other hubs in Europe aren't in service, it can connect
23 # to one in the US by itself.
25 # The configuration format consists of a number of blocks in the format
26 # BlockName { setting = number; setting2 = "string"; setting3 = yes; };
27 # Note that comments start from a #(hash) and go to the end of the line.
28 # Whitespace(space, tab, or carriage return/linefeed) are ignored and may
29 # be used to make the configuration file more readable.
31 # Please note that when ircd puts the configuration lines into practice,
32 # it parses them exactly the other way round than they are listed here.
33 # It uses the blocks in reverse order.
35 # This means that you should start your Client blocks with the
36 # "fall through", most vanilla one, and end with the most detailed.
38 # There is a difference between the "hostname" and the "server name"
39 # of the machine that the server is run on. For example, the host can
40 # have "veer.cs.vu.nl" as FQDN, and "Amsterdam.NL.EU.undernet.org" as
42 # A "server mask" is something like "*.EU.UnderNet.org", which is
43 # matched by "Amsterdam.NL.EU.undernet.org" but not by
44 # "Manhattan.KS.US.undernet.org".
46 # Please do NOT just rename the example.conf to ircd.conf and expect
52 # First some information about the server.
54 # name = "servername";
55 # vhost = "virtualhost";
56 # description = "description";
57 # numeric = numericnumber;
60 # <virtual host> must contain either a * or a valid IPv4 address in
61 # dotted quad notation. (127.0.0.1) The address MUST be the address
62 # of a physical interface on the host. This address is used for outgoing
63 # connections only, see Port{} for listener virtual hosting.
64 # If in doubt put a * or the IP of your primary interface here.
65 # The server must be compiled with virtual hosting turned on to get this
68 # Note that <server numeric> has to be unique on the network your server
69 # is running on, must be between 0 and 4095, and is not updated on a rehash.
71 name = "London.UK.Eu.UnderNet.org";
72 description = "University of London, England";
78 # This sets information that can be retrieved with the /ADMIN command.
79 # It should contain at least an admin Email contact address.
81 Location = "The University of London";
82 # At most two contact lines are allowed...
83 Contact = "Undernet IRC server";
84 Contact = "IRC Admins <irc@london.ac.uk>";
89 # All connections to the server are associated with a certain "connection
90 # class", be they incoming or outgoing (initiated by the server), be they
91 # clients, servers or Martians. (Note that ircd doesn't have direct support
92 # Recommended client classes:
93 # for Martians (yet?); they will have to register as normal users. ;-)
94 # Take the following class blocks only as a guide.
103 # <connect freq> applies only to servers, and specifies the frequency
104 # that the server tries to autoconnect. setting this to 0 will cause
105 # the server to attempt to connect repeatedly with no delay until the
106 # <maximum links> condition is satisfied. This is a Bad Thing(tm).
107 # Note that times can be specified as a number, or by giving something
108 # like: 1 minutes 20 seconds, or 1*60+20.
110 # host = "user@host";
112 # password = "password";
113 # class = "classname";
116 # <maximum links> should be set at either 0 or 1.
118 # Recommended server classes:
119 # All your server uplinks you are not a hub for.
122 pingfreq = 1 minutes 30 seconds;
123 connectfreq = 5 minutes;
127 # All the leaf servers you hub for.
130 pingfreq = 1 minutes 30 seconds;
131 connectfreq = 5 minutes;
136 # Recommended client classes:
137 # Client classes. 10 = locals; 2 = for all .net and .com that are not
138 # in Europe; 1 = for everybody.
141 pingfreq = 1 minutes 30 seconds;
152 pingfreq = 1 minutes 30 seconds;
158 pingfreq = 1 minutes 30 seconds;
165 # To allow clients to connect, they need authorization. This can be
166 # done based on hostmask, address mask, and/or with a password.
167 # With intelligent use of classes and the maxconnections field in the
168 # Client blocks, you can let in a specific domain, but get rid of all other
169 # domains in the same toplevel, thus setting up some sort of "reverse
172 # host = "user@host";
174 # password = "password";
175 # class = "classname";
178 # Technical description (for examples, see below):
179 # For every connecting client, the IP address is known. A reverse lookup
180 # on this IP-number is done to get the (/all) hostname(s).
181 # Each hostname that belongs to this IP-number is matched to <hostmask>,
182 # and the Client {} is used when any matches; the client will then show
183 # with this particular hostname. If none of the hostnames match, then
184 # the IP-number is matched against the <IP mask ...> field, if this matches
185 # then the Client{} is used nevertheless and the client will show with the
186 # first (main) hostname if any; if the IP-number did not resolve then the
187 # client will show with the dot notation of the IP-number.
188 # There is a special case for the UNIX domain sockets and localhost connections
189 # though; in this case the <IP mask ...> field is compared with the
190 # name of the server (thus not with any IP-number representation). The name
191 # of the server is the one returned in the numeric 002 reply, for example:
192 # 002 Your host is 2.undernet.org[jolan.ppro], running version ...
193 # Then the "jolan.ppro" is the name used for matching.
194 # Therefore, unix domain sockets, and connections to localhost would
196 # host = "*@jolan.ppro";
198 # This is the "fallback" entry. All .uk, .nl, and all unresolved are
199 # in these two lines.
200 # By using two different lines, multiple connections from a single IP
201 # are only allowed from hostnames which have both valid forward and
202 # reverse DNS mappings.
215 # If you don't want unresolved dudes to be able to connect to your
216 # server, do not specify any "ip = " settings.
218 # Here, take care of all American ISPs.
230 # Now list all the .com / .net domains that you wish to have access...
231 # actually it's less work to do it this way than to do it the other
232 # way around - K-lining every single ISP in the US.
233 # I wish people in Holland just got a .nl domain, and not try to be
234 # cool and use .com...
235 Client { host = "*@*.wirehub.net"; class = "Other";};
236 Client { host = "*@*.planete.net"; class = "Other";};
237 Client { host = "*@*.ivg.com"; class = "Other";};
238 Client { host = "*@*.ib.com"; class = "Other";};
239 Client { host = "*@*.ibm.net"; class = "Other";};
240 Client { host = "*@*.hydro.com"; class = "Other";};
241 Client { host = "*@*.nl.net"; class = "Local";};
243 # You can request a more complete listing, including the "list of standard
244 # Kill blocks" from the Routing Committee; it will also be sent to you if
245 # you apply for a server and get accepted.
247 # Ourselves - this makes sure that we can get in, no matter how full
248 # the server is (hopefully).
251 host = "*@*.london.ac.uk";
256 # You can put a digit (0..9) in the password value, which will make ircd
257 # only accept a client when the total number of connections to the network
258 # from the same IP number doesn't exceed this number.
259 # The following example would accept at most one connection per IP number
260 # from "*.swipnet.se" and at most two connections from dial up accounts
261 # that have "dial??.*" as host mask:
263 # host = "*@*.swipnet.se";
268 # host = "*@dial??.*";
273 # If you are not worried about who connects, this line will allow everyone
284 # It is possible to show a different Message of the Day to a connecting
285 # client depending on its origin.
287 # # Note: host can also be a classname.
289 # file = "path/to/motd/file";
292 # DPATH/net_com.motd contains a special MOTD where users are encouraged
293 # to register their domains and get their own client{} lines if they're in
294 # Europe, or move to US.UnderNet.org if they're in the USA.
297 file = "net_com.motd";
301 file = "net_com.motd";
305 file = "net_com.motd";
308 # A different MOTD for ourselves, where we point out that the helpdesk
309 # better not be bothered with questions regarding irc...
311 host = "*.london.ac.uk";
312 file = "london.motd";
317 # One of the many nice features of Undernet is "Uworld", a program
318 # connected to the net as a server. This allows it to broadcast any mode
319 # change, thus allowing opers to, for example, "unlock" a channel that
320 # has been taken over.
321 # There is only one slight problem: the TimeStamp protocol prevents this.
322 # So there is a configuration option to allow them anyway from a certain
325 # # The servername or wildcard mask for it that this applies to.
326 # name = "relservername";
327 # # The mask of servers they are allowed to introduce(for hub=yes;) or
328 # # not allowed to introduce(for leaf=yes).
329 # mask = "servermask";
330 # # No is assumed for these unless you set it to yes.
336 # Note: (1) These lines are agreed on by every server admin on Undernet;
337 # (2) These lines must be the same on every single server, or results
338 # will be disasterous; (3) This is a useful feature, not something that
339 # is a liability and abused regularly (well... :-)
340 # If you're on Undernet, you MUST have these lines. I cannnot stress
341 # this enough. If all of the servers don't have the same lines, the
342 # servers will try to undo the mode hacks that Uworld does. Make SURE that
343 # all of the servers have the EXACT same Ulines.
345 # If your server starts on a bit larger network, you'll probably get
346 # assigned one or two uplinks to which your server can connect.
347 # If your uplink(s) also connect to other servers than yours (which is
348 # probable), you need to define your uplink as being allowed to "hub".
349 # To do this, set "hub = yes;"
350 # You can also force a server(even one that doesn't connect to you)
351 # to be a leaf with "leaf = yes;"
354 name = "uworld.eu.undernet.org";
360 name = "uworld2.undernet.org";
366 name = "uworld.undernet.org";
372 name = "channels.undernet.org";
378 name = "channels2.undernet.org";
384 name = "channels3.undernet.org";
390 name = "channels4.undernet.org";
396 name = "channels5.undernet.org";
402 name = "channels6.undernet.org";
408 name = "Amsterdam.NL.Eu.UnderNet.org";
412 # An example just to make sure IRCnet doesn't get on undernet...
415 mask = "eris.berkeley.edu";
419 # As of ircu2.10.05 is it possible to Jupe nicks. As per CFV-0095, the
420 # following nicks must be juped, it is not allowed to jupe others as well.
422 nick = "EuWorld,E,StatServ,NoteServ";
423 nick = "UWorld2,ChanSvr,ChanSaver,ChanServ";
424 nick = "Uworld,NickSvr,NickSaver,NickServ";
425 nick = "LPT1,X,login,LPT2,W,Undernet,COM1,V,protocol,COM2";
426 nick = "U,pass,COM3,Y,AUX,COM4,Z,newpass";
431 # While running your server, you will most probably encounter individuals
432 # or groups of persons that you do not wish to have access to your server.
434 # For this purpose, the ircd understands "kill blocks". These are also
435 # known as K-lines, by virtue of the former config file format.
438 # host = "user@host";
439 # reason = "The reason the user will see";
441 # It is possible to ban on the basis of the real name.
442 # It is also possible to use a file as comment for the ban, using
446 # realname = "realnametoban";
447 # file = "path/to/file/with/reason/to/show";
451 # The default reason is: "You are banned from this server"
452 # Note that K-lines are local to the server; if you ban a person or a
453 # whole domain from your server, they can get on IRC via any other server
454 # that doesn't have them K-lined (yet).
456 # With a simple comment, using quotes:
457 Kill { host = "*.au"; reason = "Please use a nearer server"; };
458 Kill { host = "*.edu"; reason = "Please use a nearer server"; };
460 # The file can contain for example, a reason, a link to the
461 # server rules and a contact address.
464 host = "*luser@unixbox.flooder.co.uk";
465 file = "kline/youflooded.txt";
468 # IP-based kill lines apply to all hosts, even if an IP address has a
469 # properly resolving host name.
473 file = "klines/martians";
476 # The realname field lets you ban by realname...
480 reason = "You are infected with a Trojan";
485 # You probably want your server connected to other servers, so your users
486 # have other users to chat with.
487 # IRC servers connect to other servers forming a network with a star or
488 # tree topology. Loops are not allowed.
489 # In this network, two servers can be distinguished: "hub" and "leaf"
490 # servers. Leaf servers connect to hubs; hubs connect to each other.
491 # Of course, many servers can't be directly classified in one of these
492 # categories. Both a fixed and a rule-based decision making system for
493 # server links is provided for ircd to decide what links to allow, what
494 # to let humans do themselves, and what links to (forcefully) disallow.
497 # define what servers the server connect to, and which servers are
498 # allowed to connect.
500 # name = "servername";
501 # host = "hostnameORip";
502 # password = "passwd";
504 # class = "classname";
507 # The "port" field defines the default port the server tries to connect
508 # to if an operator uses /connect without specifying a port. This is also
509 # the port used when the server attempts to auto-connect to the remote
510 # server. (See Class blocks for more informationa about auto-connects).
512 # Our primary uplink.
514 name = "Amsterdam.NL.Eu.UnderNet.org";
523 # For an advanced, real-time rule-based routing decision making system
524 # you can use crule blocks. For more information, see doc/readme.crules.
527 # server = "servermask";
528 # rule = "connectrule";
529 # # Setting all to yes makes the rule always apply. Otherwise it only
530 # # applies to autoconnects.
535 server = "*.US.UnderNet.org";
536 rule = "connected(*.US.UnderNet.org)";
540 server = "*.EU.UnderNet.org";
541 rule = "connected(Amsterdam.NL.EU.*)";
544 # The following block is recommended for leaf servers:
548 rule = "directcon(*)";
553 # Inevitably, you have reached the part about "IRC Operators". Oper status
554 # grants some special privileges to a user, like the power to make the
555 # server break or (try to) establish a connection with another server,
556 # and to "kill" users off IRC.
557 # I can write many pages about this; I will restrict myself to saying that
558 # if you want to appoint somebody as IRC Operator on your server, that
559 # person should be aware of his/her responsibilities, and that you, being
560 # the admin, will be held accountable for their actions.
562 # There are two sorts of IRC Operators: "local" and "global". Local opers
563 # can squit, connect and kill - but only locally: their +o user mode
564 # is not not passed along to other servers. On Undernet, this prevents
565 # them from using Uworld as well.
566 # Depending on some defines in include/config.h, local operators are also
567 # not allowed to /DIE and /RESTART the server.
570 # host = "host/IP mask";
572 # password = "encryptedpass";
573 # class = "classname";
576 # The encrypted password is optional. If you wish to encrypt your password,
577 # there is a utility in the ircd. Please read the file tools/README.
580 host = "*@*.cs.vu.nl";
581 password = "VRKLKuGKn0jLt";
588 password = "notencryptedpass";
593 # Note that the <connection class> is optional, but leaving it away
594 # puts the opers in class "default", which usually only accepts one
595 # connection at a time. If you want users to Oper up more then once per
596 # block, then use a connection class that allows more then one connection,
597 # for example (using class Local as in the example above):
599 # Once you OPER your connection class changes no matter where you are or
600 # your previous connection classes. If the defined connection class is
601 # Local for the operator block, then your new connection class is Local.
604 # When your server gets more full, you will notice delays when trying to
605 # connect to your server's primary listening port. It is possible via the
606 # Port lines to specify additional ports for the ircd to listen to.
607 # De facto ports are: 6667 - standard; 6660-6669 - additional client
609 # Undernet uses 4400 for server listener ports.
610 # These are just hints, they are in no way official IANA or IETF policies.
611 # IANA says we should use port 194, but that requires us to run as root,
612 # so we don't do that.
617 # # Use this to control the interface you bind to.
618 # vhost = "virtualhostip";
619 # # Setting to yes makes this server only.
621 # # Setting to yes makes the port "hidden" from stats.
625 # The mask setting allows you to specify a range of IP addresses that
626 # you will allow connections from. This should only contain IP addresses
627 # and '*' if used. This field only uses IP addresses. This does not use
628 # DNS in any way so you can't use it to allow *.nl or *.uk. Attempting
629 # to specify anything other than numbers, dots and stars [0-9.*] will result
630 # in the port allowing connections from anyone.
632 # The interface setting allows multiply homed hosts to specify which
633 # interface to use on a port by port basis, if an interface is not specified
634 # the default interface will be used. The interface MUST be the complete
635 # IP address for a real hardware interface on the machine running ircd.
636 # If you want to use virtual hosting *YOU* *MUST* *USE* *THIS* otherwise it
637 # WILL bind to all interfaces - not what most people seem to expect.
644 # This is a Server port that is Hidden
651 # The following are normal client ports
652 Port { port = 6667; };
653 Port { port = 6668; };
659 # This is a hidden client port, listening on the interface associated
660 # with the IP address 168.8.21.107
662 mask = "168.8.21.107";
668 # IRC servers have a large number of options and features. Most of these
669 # are set at compile time through the use of #define's--see "make config"
670 # for more details--but we are working to move many of these into the
671 # configuration file. Features let you configure these at runtime.
672 # You only need one feature block in which you use
673 # "featurename" = "value1" , "value2", ..., "valuen-1", "valuen";
675 # The entire purpose of F:lines are so that you do not have to recompile
676 # the IRCD everytime you want to change a feature. All of the features
677 # are listed below, and at the bottom is how to set logging.
679 # A Special Thanks to Kev for writing the documentation of F:lines. It can
680 # be found at doc/readme.features and the logging documentation can be
681 # found at doc/readme.log. The defaults used by the Undernet network are
686 # "DOMAINNAME"="<obtained from /etc/resolv.conf by ./configure>";
687 # "RELIABLE_CLOCK"="FALSE";
688 # "BUFFERPOOL"="27000000";
689 # "HAS_FERGUSON_FLUSHER"="FALSE";
690 # "CLIENT_FLOOD"="1024";
691 # "SERVER_PORT"="4400";
692 # "NODEFAULTMOTD"="TRUE";
693 # "MOTD_BANNER"="TRUE";
694 # "KILL_IPMISMATCH"="FALSE";
695 # "IDLE_FROM_MSG"="TRUE";
697 # "WALLOPS_OPER_ONLY"="FALSE";
699 # "RANDOM_SEED"="<you should set one explicitly>";
700 # "DEFAULT_LIST_PARAM"="TRUE";
701 # "NICKNAMEHISTORYLENGTH"="800";
702 # "HOST_HIDING"="FALSE";
703 # "HIDDEN_HOST"="users.undernet.org";
704 # "HIDDEN_IP"="127.0.0.1";
705 # "KILLCHASETIMELIMIT"="30";
706 # "MAXCHANNELSPERUSER"="10";
710 # "HANGONGOODLINK="300";
711 # "HANGONRETRYDELAY" = "10";
712 # "CONNECTTIMEOUT" = "90";
714 # "MAXIMUM_LINKS" = "1";
715 # "PINGFREQUENCY" = "120";
716 # "CONNECTFREQUENCY" = "600";
717 # "DEFAULTMAXSENDQLENGTH" = "40000";
718 # "GLINEMAXUSERCOUNT" = "20";
719 # "MPATH" = "ircd.motd";
720 # "RPATH" = "remote.motd";
721 # "PPATH" = "ircd.pid";
722 # "VIRTUAL_HOST" = "FALSE";
723 # "TOS_SERVER" = "0x08";
724 # "TOS_CLIENT" = "0x08";
725 # "POLLS_PER_LOOP" = "200";
726 # "CRYPT_OPER_PASSWORD" = "TRUE";
727 # "OPER_NO_CHAN_LIMIT" = "TRUE";
728 # "OPER_MODE_LCHAN" = "TRUE";
729 # "OPER_WALK_THROUGH_LMODES" = "FALSE";
730 # "NO_OPER_DEOP_LCHAN" = "FALSE";
731 # "SHOW_INVISIBLE_USERS" = "TRUE";
732 # "SHOW_ALL_INVISIBLE_USERS" = "TRUE";
733 # "UNLIMIT_OPER_QUERY" = "FALSE";
734 # "LOCAL_KILL_ONLY" = "FALSE";
735 # "CONFIG_OPERCMDS" = "FALSE";
736 # "OPER_KILL" = "TRUE";
737 # "OPER_REHASH" = "TRUE";
738 # "OPER_RESTART" = "TRUE";
739 # "OPER_DIE" = "TRUE";
740 # "OPER_GLINE" = "TRUE";
741 # "OPER_LGLINE" = "TRUE";
742 # "OPER_JUPE" = "TRUE";
743 # "OPER_LJUPE" = "TRUE";
744 # "OPER_OPMODE" = "TRUE";
745 # "OPER_LOPMODE" = "TRUE";
746 # "OPER_BADCHAN" = "FALSE";
747 # "OPER_LBADCHAN" = "FALSE";
748 # "OPER_SET" = "FALSE";
749 # "OPERS_SEE_IN_SECRET_CHANNELS" = "TRUE";
750 # "OPER_WIDE_GLINE" = "TRUE";
751 # "OPER_LIST_CHAN" = "TRUE";
752 # "LOCOP_KILL" = "TRUE";
753 # "LOCOP_REHASH" = "TRUE";
754 # "LOCOP_RESTART" = "FALSE";
755 # "LOCOP_DIE" = "FALSE";
756 # "LOCOP_LGLINE" = "TRUE";
757 # "LOCOP_LJUPE" = "TRUE";
758 # "LOCOP_LOPMODE" = "TRUE";
759 # "LOCOP_LBADCHAN" = "FALSE";
760 # "LOCOP_SET" = "FALSE";
761 # "LOCOP_SEE_IN_SECRET_CHANNELS" = "FALSE";
762 # "LOCOP_WIDE_GLINE" = "FALSE";
763 # "LOCOP_LIST_CHAN" = "FALSE";
764 # "OPLEVELS" = "TRUE";
767 # Well, you have now reached the end of this sample configuration
768 # file. If you have any questions, feel free to mail
769 # <coder-com@undernet.org>. If you are interested in linking your
770 # server to the Undernet IRC network visit
771 # http://www.routing-com.undernet.org/, and if there are any
772 # problems then contact <routing-com@undernet.org> asking for
773 # information. Upgrades of the Undernet ircd can be found on
774 # http://coder-com.undernet.org/.
776 # For the rest: Good Luck!