232e5d3992129677e31cd51bd7a8cf38bea1d516
[ircu2.10.12-pk.git] / doc / example.conf
1 # ircd.conf - configuration file for ircd version ircu2.10
2 #
3 # Last Updated:  20, March 2002.
4 #
5 # Written by Niels <niels@undernet.org>, based on the original example.conf,
6 # server code and some real-life (ahem) experience.
7 #
8 # Updated and heavily modified by Braden <dbtem@yahoo.com>.
9 #
10 # Rewritten by A1kmm(Andrew Miller)<a1kmm@mware.virtualave.net> to support
11 # the new flex/bison configuration parser.
12 #
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.
17 #
18 # This is an example of the configuration file used by the Undernet ircd.
19 #
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.
24 #
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.
30 #
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.
34 #
35 # This means that you should start your Client blocks with the
36 # "fall through", most vanilla one, and end with the most detailed.
37 #
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
41 # server name.
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".
45 #
46 # Please do NOT just rename the example.conf to ircd.conf and expect
47 # it to work.
48
49
50 # [General]
51 #
52 # First some information about the server.
53 # General {
54 #         name = "servername";
55 #         vhost = "virtualhost";
56 #         description = "description";
57 #         numeric = numericnumber;
58 # };
59 #
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
66 # to work correctly.
67 #
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.
70 General {
71          name = "London.UK.Eu.UnderNet.org";
72          description = "University of London, England";
73          numeric = 1;
74 };
75
76 # [Admin]
77 #
78 # This sets information that can be retrieved with the /ADMIN command.
79 # It should contain at least an admin Email contact address.
80 Admin {
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>";
85 };
86
87 # [Classes]
88 #
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.
95 # Class {
96 #  name = "<class>";
97 #  pingfreq = time;
98 #  connectfreq = time;
99 #  maxlinks = number;
100 #  sendq = size;
101 #  usermode = "+i";
102 # };
103 #
104 # <connect freq> applies only to servers, and specifies the frequency 
105 # that the server tries to autoconnect. setting this to 0 will cause
106 # the server to attempt to connect repeatedly with no delay until the 
107 # <maximum links> condition is satisfied. This is a Bad Thing(tm).
108 # Note that times can be specified as a number, or by giving something
109 # like: 1 minutes 20 seconds, or 1*60+20.
110 # Client {
111 #  host = "user@host";
112 #  ip = "ip@host";
113 #  password = "password";
114 #  class = "classname";
115 # };
116 #
117 # <maximum links> should be set at either 0 or 1.
118 #
119 # Recommended server classes:
120 # All your server uplinks you are not a hub for.
121 Class {
122  name = "Server";
123  pingfreq = 1 minutes 30 seconds;
124  connectfreq = 5 minutes;
125  maxlinks = 1;
126  sendq = 9000000;
127 };
128 # All the leaf servers you hub for.
129 Class {
130  name = "LeafServer";
131  pingfreq = 1 minutes 30 seconds;
132  connectfreq = 5 minutes;
133  maxlinks = 0;
134  sendq = 9000000;
135 };
136
137 # Recommended client classes:
138 # Client classes. 10 = locals; 2 = for all .net and .com that are not
139 # in Europe; 1 = for everybody.
140 Class {
141  name = "Local";
142  pingfreq = 1 minutes 30 seconds;
143  sendq = 160000;
144  maxlinks = 100;
145  usermode = "+iw";
146 };
147 Client
148 {
149  class = "Other";
150  host = "*@*";
151 };
152 Class {
153  name = "America";
154  pingfreq = 1 minutes 30 seconds;
155  sendq = 80000;
156  maxlinks = 5;
157 };
158 Class {
159  name = "Other";
160  pingfreq = 1 minutes 30 seconds;
161  sendq = 160000;
162  maxlinks = 400;
163 };
164 Class {
165  name = "Opers";
166  pingfreq = 1 minutes 30 seconds;
167  sendq = 160000;
168  maxlinks = 10;
169
170  # For connection classes intended for operator use, you can specify
171  # privileges used when the Operator block (see below) names this
172  # class.  The local (aka globally_opered) privilege MUST be defined
173  # by either the Class or Operator block.  The following privileges
174  # exist:
175  #
176  # local (or propagate, with the opposite sense)
177  # whox  (can use x flag with /WHO)
178  # display (oper status visible to lusers)
179  # chan_limit (can join local channels when in
180  #                              MAXCHANNELSPERUSER channels)
181  # mode_lchan (can /MODE &channel without chanops)
182  # deop_lchan (cannot be deopped or kicked on local channels)
183  # walk_lchan (can forcibly /JOIN &channel OVERRIDE)
184  # show_invis (see +i users in /WHO x)
185  # show_all_invis (see +i users in /WHO x)
186  # unlimit_query (show more results from /WHO)
187  # local_kill (can kill clients on this server)
188  # rehash (can use /REHASH)
189  # die (can use /DIE)
190  # local_jupe_server (not used)
191  # set (can use /SET)
192  # local_gline (can set a G-line for this server only)
193  # local_badchan (can set a Gchan for this server only)
194  # see_chan (can see users in +s channels in /WHO)
195  # wide_gline (can use ! to force a wide G-line)
196  # see_opers (can see opers without DISPLAY privilege)
197  # force_local_opmode (can use OPMODE/CLEARMODE on quarantined local channels)
198  # kill (can kill clients on other servers)
199  # gline (can issue G-lines to other servers)
200  # jupe_server (not used)
201  # opmode (can use /OPMODE)
202  # badchan (can issue Gchans to other servers)
203  # force_opmode (can use OPMODE/CLEARMODE on quarantined global channels)
204  #
205  # For global opers (with propagate = yes or local = no), the default
206  # is to grant all of the above privileges.  For local opers, the
207  # default is to grant ONLY the following privileges:
208  #  chan_limit, mode_lchan, show_invis, show_all_invis, local_kill,
209  #  rehash, local_gline, local_jupe, local_opmode, whox, display,
210  #  force_local_opmode
211  # Any privileges listed in a Class block override the defaults.
212
213  local = no;
214 };
215 # [Client]
216 #
217 # To allow clients to connect, they need authorization. This can be
218 # done based on hostmask, address mask, and/or with a password.
219 # With intelligent use of classes and the maxconnections field in the
220 # Client blocks, you can let in a specific domain, but get rid of all other
221 # domains in the same toplevel, thus setting up some sort of "reverse
222 # Kill block".
223 # Client {
224 #  host = "user@host";
225 #  ip = "ip@host";
226 #  password = "password";
227 #  class = "classname";
228 # };
229 #
230 # Technical description (for examples, see below):
231 # For every connecting client, the IP address is known.  A reverse lookup
232 # on this IP-number is done to get the (/all) hostname(s).
233 # Each hostname that belongs to this IP-number is matched to <hostmask>,
234 # and the Client {} is used when any matches; the client will then show
235 # with this particular hostname.  If none of the hostnames match, then
236 # the IP-number is matched against the <IP mask ...> field, if this matches
237 # then the Client{} is used nevertheless and the client will show with the
238 # first (main) hostname if any; if the IP-number did not resolve then the
239 # client will show with the dot notation of the IP-number.
240 # There is a special case for the UNIX domain sockets and localhost connections
241 # though; in this case the <IP mask ...> field is compared with the
242 # name of the server (thus not with any IP-number representation). The name
243 # of the server is the one returned in the numeric 002 reply, for example:
244 # 002 Your host is 2.undernet.org[jolan.ppro], running version ...
245 # Then the "jolan.ppro" is the name used for matching.
246 # Therefore, unix domain sockets, and connections to localhost would
247 # match this block:
248 # host = "*@jolan.ppro";
249 #
250 # This is the "fallback" entry. All .uk, .nl, and all unresolved are
251 # in these two lines.
252 # By using two different lines, multiple connections from a single IP
253 # are only allowed from hostnames which have both valid forward and
254 # reverse DNS mappings.
255 Client
256 {
257  class = "Other";
258  ip = "*@*";
259 };
260
261
262 Client
263 {
264  class = "Other";
265  host = "*@*";
266 };
267 # If you don't want unresolved dudes to be able to connect to your
268 # server, do not specify any "ip = " settings.
269 #
270 # Here, take care of all American ISPs.
271 Client
272 {
273  host = "*@*.com";
274  class = "America";
275 };
276
277 Client
278 {
279  host = "*@*.net";
280  class = "America";
281 };
282 # Now list all the .com / .net domains that you wish to have access...
283 # actually it's less work to do it this way than to do it the other
284 # way around - K-lining every single ISP in the US.
285 # I wish people in Holland just got a .nl domain, and not try to be
286 # cool and use .com...
287 Client { host = "*@*.wirehub.net"; class = "Other";};
288 Client { host = "*@*.planete.net"; class = "Other";};
289 Client { host = "*@*.ivg.com"; class = "Other";};
290 Client { host = "*@*.ib.com"; class = "Other";};
291 Client { host = "*@*.ibm.net"; class = "Other";};
292 Client { host = "*@*.hydro.com"; class = "Other";};
293 Client { host = "*@*.nl.net"; class = "Local";};
294
295 # You can request a more complete listing, including the "list of standard
296 # Kill blocks" from the Routing Committee; it will also be sent to you if
297 # you apply for a server and get accepted.
298 #
299 # Ourselves - this makes sure that we can get in, no matter how full
300 # the server is (hopefully).
301 Client
302 {
303  host = "*@*.london.ac.uk";
304  ip = "*@193.37.*";
305  class = "Local";
306 };
307
308 # You can put a digit (0..9) in the password value, which will make ircd
309 # only accept a client when the total number of connections to the network
310 # from the same IP number doesn't exceed this number.
311 # The following example would accept at most one connection per IP number
312 # from "*.swipnet.se" and at most two connections from dial up accounts
313 # that have "dial??.*" as host mask:
314 # Client {
315 #  host = "*@*.swipnet.se";
316 #  password = "1";
317 #  class = "Other";
318 # };
319 # Client {
320 #  host = "*@dial??.*";
321 #  password = "2";
322 #  class = "Other";
323 # };
324 #
325 # If you are not worried about who connects, this line will allow everyone
326 # to connect.
327 Client {
328  host = "*@*";
329  ip = "*@*";
330  class = "Other";
331 };
332
333
334 # [motd]
335 #
336 # It is possible to show a different Message of the Day to a connecting
337 # client depending on its origin.
338 # motd {
339 #  # Note: host can also be a classname.
340 #  host = "Other";
341 #  file = "path/to/motd/file";
342 # };
343 #
344 # DPATH/net_com.motd contains a special MOTD where users are encouraged
345 # to register their domains and get their own client{} lines if they're in
346 # Europe, or move to US.UnderNet.org if they're in the USA.
347 motd {
348  host = "*.net";
349  file = "net_com.motd";
350 };
351 motd {
352  host = "*.com";
353  file = "net_com.motd";
354 };
355 motd {
356  host = "America";
357  file = "net_com.motd";
358 };
359
360 # A different MOTD for ourselves, where we point out that the helpdesk
361 # better not be bothered with questions regarding irc...
362 motd {
363  host = "*.london.ac.uk";
364  file = "london.motd";
365 };
366
367 # [Server]
368 #
369 # One of the many nice features of Undernet is "Uworld", a program
370 # connected to the net as a server. This allows it to broadcast any mode
371 # change, thus allowing opers to, for example, "unlock" a channel that
372 # has been taken over.
373 # There is only one slight problem: the TimeStamp protocol prevents this.
374 # So there is a configuration option to allow them anyway from a certain
375 # server.
376 # Server {
377 #  # The servername or wildcard mask for it that this applies to.
378 #  name = "relservername";
379 #  # The mask of servers they are allowed to introduce(for hub=yes;) or
380 #  # not allowed to introduce(for leaf=yes).
381 #  mask = "servermask";
382 #  # No is assumed for these unless you set it to yes.
383 #  uworld = no;
384 #  hub = no;
385 #  # Yes is assumed for "leaf" unless you set it to no.
386 #  leaf = yes;
387 # };
388 #
389 # Note: (1) These lines are agreed on by every server admin on Undernet;
390 # (2) These lines must be the same on every single server, or results
391 # will be disasterous; (3) This is a useful feature, not something that
392 # is a liability and abused regularly (well... :-)
393 # If you're on Undernet, you MUST have these lines. I cannnot stress
394 # this enough.  If all of the servers don't have the same lines, the
395 # servers will try to undo the mode hacks that Uworld does.  Make SURE that
396 # all of the servers have the EXACT same Ulines.
397 #
398 # If your server starts on a bit larger network, you'll probably get
399 # assigned one or two uplinks to which your server can connect.
400 # If your uplink(s) also connect to other servers than yours (which is
401 # probable), you need to define your uplink as being allowed to "hub".
402 # To do this, set "hub = yes;"
403 # You can also force a server(even one that doesn't connect to you)
404 # to be a leaf with "leaf = yes;"
405
406 Server {
407  name = "uworld.eu.undernet.org";
408  mask = "*";
409  uworld = yes;
410  hub = yes;
411 };
412 Server {
413  name = "uworld2.undernet.org";
414  mask = "*";
415  uworld = yes;
416  hub = yes;
417 };
418 Server {
419  name = "uworld.undernet.org";
420  mask = "*";
421  uworld = yes;
422  hub = yes;
423 };
424 Server {
425  name = "channels.undernet.org";
426  mask = "*";
427  uworld = yes;
428  hub = yes;
429 };
430 Server {
431  name = "channels2.undernet.org";
432  mask = "*";
433  uworld = yes;
434  hub = yes;
435 };
436 Server {
437  name = "channels3.undernet.org";
438  mask = "*";
439  uworld = yes;
440  hub = yes;
441 };
442 Server {
443  name = "channels4.undernet.org";
444  mask = "*";
445  uworld = yes;
446  hub = yes;
447 };
448 Server {
449  name = "channels5.undernet.org";
450  mask = "*";
451  uworld = yes;
452  hub = yes;
453 };
454 Server {
455  name = "channels6.undernet.org";
456  mask = "*";
457  uworld = yes;
458  hub = yes;
459 };
460 Server {
461  name = "Amsterdam.NL.Eu.UnderNet.org";
462  mask = "*";
463  hub = yes;
464 };
465 # An example just to make sure IRCnet doesn't get on undernet...
466 Server {
467  name = "*";
468  mask = "eris.berkeley.edu";
469  hub = yes;
470 };
471
472 # As of ircu2.10.05 is it possible to Jupe nicks. As per CFV-0095, the
473 # following nicks must be juped, it is not allowed to jupe others as well.
474 Jupe {
475  nick = "EuWorld,E,StatServ,NoteServ";
476  nick = "UWorld2,ChanSvr,ChanSaver,ChanServ";
477  nick = "Uworld,NickSvr,NickSaver,NickServ";
478  nick = "LPT1,X,login,LPT2,W,Undernet,COM1,V,protocol,COM2";
479  nick = "U,pass,COM3,Y,AUX,COM4,Z,newpass";
480 };
481
482 # [Kill]
483 #
484 # While running your server, you will most probably encounter individuals
485 # or groups of persons that you do not wish to have access to your server.
486 #
487 # For this purpose, the ircd understands "kill blocks". These are also
488 # known as K-lines, by virtue of the former config file format.
489 # Kill
490 # {
491 #   host = "user@host";
492 #   reason = "The reason the user will see";
493 # };
494 # It is possible to ban on the basis of the real name.
495 # It is also possible to use a file as comment for the ban, using
496 # file = "file":
497 # Kill
498 # {
499 #   realname = "realnametoban";
500 #   file = "path/to/file/with/reason/to/show";
501 # };
502 #
503 #
504 # The default reason is: "You are banned from this server"
505 # Note that K-lines are local to the server; if you ban a person or a
506 # whole domain from your server, they can get on IRC via any other server
507 # that doesn't have them K-lined (yet).
508 #
509 # With a simple comment, using quotes:
510 Kill { host = "*.au"; reason = "Please use a nearer server"; };
511 Kill { host = "*.edu"; reason = "Please use a nearer server"; };
512
513 # The file can contain for example, a reason, a link to the
514 # server rules and a contact address.
515 Kill
516 {
517  host = "*luser@unixbox.flooder.co.uk";
518  file = "kline/youflooded.txt";
519 };
520
521 # IP-based kill lines apply to all hosts, even if an IP address has a
522 # properly resolving host name.
523 Kill
524 {
525  host = "192.168.*";
526  file = "klines/martians";
527 };
528
529 # The realname field lets you ban by realname...
530 Kill
531 {
532  host = "*sub7*";
533  reason = "You are infected with a Trojan";
534 };
535
536 # [Connect]
537 #
538 # You probably want your server connected to other servers, so your users
539 # have other users to chat with.
540 # IRC servers connect to other servers forming a network with a star or
541 # tree topology. Loops are not allowed.
542 # In this network, two servers can be distinguished: "hub" and "leaf"
543 # servers. Leaf servers connect to hubs; hubs connect to each other.
544 # Of course, many servers can't be directly classified in one of these
545 # categories. Both a fixed and a rule-based decision making system for
546 # server links is provided for ircd to decide what links to allow, what
547 # to let humans do themselves, and what links to (forcefully) disallow.
548 #
549 # The Connect blocks
550 # define what servers the server connect to, and which servers are
551 # allowed to connect.
552 # Connect {
553 #  name = "servername";
554 #  host = "hostnameORip";
555 #  password = "passwd";
556 #  port = portno;
557 #  class = "classname";
558 # };
559 #
560 # The "port" field defines the default port the server tries to connect
561 # to if an operator uses /connect without specifying a port. This is also
562 # the port used when the server attempts to auto-connect to the remote 
563 # server. (See Class blocks for more informationa about auto-connects).
564 #
565 # Our primary uplink.
566 Connect {
567  name = "Amsterdam.NL.Eu.UnderNet.org";
568  host = "1.2.3.4";
569  password = "passwd";
570  port = 4400;
571  class = "Servers";
572 };
573
574 # [crule]
575 #
576 # For an advanced, real-time rule-based routing decision making system
577 # you can use crule blocks. For more information, see doc/readme.crules.
578 # CRULE
579 # {
580 #  server = "servermask";
581 #  rule = "connectrule";
582 #  # Setting all to yes makes the rule always apply. Otherwise it only
583 #  # applies to autoconnects.
584 #  all = yes;
585 # };
586 CRULE
587 {
588  server = "*.US.UnderNet.org";
589  rule = "connected(*.US.UnderNet.org)";
590 };
591 CRULE
592 {
593  server = "*.EU.UnderNet.org";
594  rule = "connected(Amsterdam.NL.EU.*)";
595 };
596
597 # The following block is recommended for leaf servers:
598 CRULE
599 {
600  server = "*";
601  rule = "directcon(*)";
602 };
603
604 # [Operator]
605 #
606 # Inevitably, you have reached the part about "IRC Operators". Oper status
607 # grants some special privileges to a user, like the power to make the
608 # server break or (try to) establish a connection with another server,
609 # and to "kill" users off IRC.
610 # I can write many pages about this; I will restrict myself to saying that
611 # if you want to appoint somebody as IRC Operator on your server, that
612 # person should be aware of his/her responsibilities, and that you, being
613 # the admin, will be held accountable for their actions.
614 #
615 # There are two sorts of IRC Operators: "local" and "global". Local opers
616 # can squit, connect and kill - but only locally: their +o user mode
617 # is not not passed along to other servers. On Undernet, this prevents
618 # them from using Uworld as well.
619 #
620 # Operator {
621 #  host = "host/IP mask";
622 #  name = "opername";
623 #  password = "encryptedpass";
624 #  class = "classname";
625 #  # You can also set any operator privilege; see the Class block
626 #  # documentation for details.  A privilege defined for a single
627 #  # Operator will override the privilege settings for the Class
628 #  # and the default setting.
629 # };
630 #
631 # The encrypted password is optional.  If you wish to encrypt your
632 # password, there is a utility in the ircd.  Please read the file
633 # tools/README.
634 # All privileges are shown with their default values; if you wish to
635 # override defaults, you should set only those privileges for the
636 # operator.  Listing defaulted privileges just makes things harder to
637 # find.
638 Operator {
639  local = no;
640  host = "*@*.cs.vu.nl";
641  password = "VRKLKuGKn0jLt";
642  name = "Niels";
643  class = "Local";
644 };
645 Operator {
646  host = "*@*.uu.net";
647  password = "notencryptedpass";
648  name = "Niels";
649  class = "Opers";
650 };
651
652 # Note that the <connection class> is optional, but leaving it away
653 # puts the opers in class "default", which usually only accepts one
654 # connection at a time.  If you want users to Oper up more then once per
655 # block, then use a connection class that allows more then one connection,
656 # for example (using class Local as in the example above):
657 #
658 # Once you OPER your connection class changes no matter where you are or
659 # your previous connection classes.  If the defined connection class is
660 # Local for the operator block, then your new connection class is Local.
661
662 # [Port]
663 # When your server gets more full, you will notice delays when trying to
664 # connect to your server's primary listening port. It is possible via the
665 # Port lines to specify additional ports for the ircd to listen to.
666 # De facto ports are: 6667 - standard; 6660-6669 - additional client
667 # ports;
668 # Undernet uses 4400 for server listener ports.
669 # These are just hints, they are in no way official IANA or IETF policies.
670 # IANA says we should use port 194, but that requires us to run as root,
671 # so we don't do that.
672 #
673 # Port {
674 #  port = number;
675 #  mask = "ipmask";
676 #  # Use this to control the interface you bind to.
677 #  vhost = "virtualhostip";
678 #  # Setting to yes makes this server only.
679 #  server = yes;
680 #  # Setting to yes makes the port "hidden" from stats.
681 #  hidden = yes;
682 # };
683 #
684 # The mask setting allows you to specify a range of IP addresses that
685 # you will allow connections from. This should only contain IP addresses
686 # and '*' if used. This field only uses IP addresses. This does not use
687 # DNS in any way so you can't use it to allow *.nl or *.uk. Attempting
688 # to specify anything other than numbers, dots and stars [0-9.*] will result
689 # in the port allowing connections from anyone.
690 #
691 # The interface setting allows multiply homed hosts to specify which
692 # interface to use on a port by port basis, if an interface is not specified
693 # the default interface will be used. The interface MUST be the complete
694 # IP address for a real hardware interface on the machine running ircd.
695 # If you want to use virtual hosting *YOU* *MUST* *USE* *THIS* otherwise it
696 # WILL bind to all interfaces - not what most people seem to expect.
697 #
698 Port {
699  server = yes;
700  port = 4400;
701 };
702
703 # This is a Server port that is Hidden
704 Port {
705  server = yes;
706  hidden = yes;
707  port = 4401;
708 };
709
710 # The following are normal client ports
711 Port { port = 6667; };
712 Port { port = 6668; };
713 Port {
714  mask = "192.168.*";
715  port = 6666;
716 };
717
718 # This is a hidden client port, listening on the interface associated
719 # with the IP address 168.8.21.107
720 Port {
721  mask = "168.8.21.107";
722  hidden = yes;
723  port = 7000;
724 };
725
726 # This is a server-implemented alias to send a message to a service.
727 # The string after Pseudo is the command name; the name entry inside
728 # is the service name, used for error messages.  More than one nick
729 # entry can be provided; the last one listed has highest priority.
730 Pseudo "CHANSERV" {
731  name = "X";
732  nick = "X@channels.undernet.org";
733 };
734
735 # You can also prepend text before the user's message.
736 Pseudo "LOGIN" {
737  name = "X";
738  prepend = "LOGIN ";
739  nick = "X@channels.undernet.org";
740 };
741
742 # You can ask a separate server whether to allow users to connect.
743 IAuth {
744  pass = "ircd-iauth";
745  host = "127.0.0.1";
746  port = 7700;
747  connectfreq = 30;
748  timeout = 60;
749 };
750
751 # [features]
752 # IRC servers have a large number of options and features.  Most of these
753 # are set at compile time through the use of #define's--see "make config"
754 # for more details--but we are working to move many of these into the
755 # configuration file.  Features let you configure these at runtime.
756 # You only need one feature block in which you use
757 # "featurename" = "value1" , "value2", ..., "valuen-1", "valuen";
758 #
759 # The entire purpose of F:lines are so that you do not have to recompile
760 # the IRCD everytime you want to change a feature.  All of the features
761 # are listed below, and at the bottom is how to set logging.
762 #
763 # A Special Thanks to Kev for writing the documentation of F:lines.  It can
764 # be found at doc/readme.features and the logging documentation can be
765 # found at doc/readme.log.  The defaults used by the Undernet network are
766 # below.
767 #
768 features
769 {
770 #  "DOMAINNAME"="<obtained from /etc/resolv.conf by ./configure>";
771 #  "RELIABLE_CLOCK"="FALSE";
772 #  "BUFFERPOOL"="27000000";
773 #  "HAS_FERGUSON_FLUSHER"="FALSE";
774 #  "CLIENT_FLOOD"="1024";
775 #  "SERVER_PORT"="4400";
776 #  "NODEFAULTMOTD"="TRUE";
777 #  "MOTD_BANNER"="TRUE";
778 #  "KILL_IPMISMATCH"="FALSE";
779 #  "IDLE_FROM_MSG"="TRUE";
780 #  "HUB"="FALSE";
781 #  "WALLOPS_OPER_ONLY"="FALSE";
782 #  "NODNS"="FALSE";
783 #  "RANDOM_SEED"="<you should set one explicitly>";
784 #  "DEFAULT_LIST_PARAM"="TRUE";
785 #  "NICKNAMEHISTORYLENGTH"="800";
786 #  "HOST_HIDING"="FALSE";
787 #  "HIDDEN_HOST"="users.undernet.org";
788 #  "HIDDEN_IP"="127.0.0.1";
789 #  "KILLCHASETIMELIMIT"="30";
790 #  "MAXCHANNELSPERUSER"="10";
791 #  "NICKLEN" = "12";
792 #  "AVBANLEN"="40";
793 #  "MAXBANS"="30";
794 #  "MAXSILES"="15";
795 #  "HANGONGOODLINK="300";
796 # "HANGONRETRYDELAY" = "10";
797 # "CONNECTTIMEOUT" = "90";
798 # "MAXIMUM_LINKS" = "1";
799 # "PINGFREQUENCY" = "120";
800 # "CONNECTFREQUENCY" = "600";
801 # "DEFAULTMAXSENDQLENGTH" = "40000";
802 # "GLINEMAXUSERCOUNT" = "20";
803 # "MPATH" = "ircd.motd";
804 # "RPATH" = "remote.motd";
805 # "PPATH" = "ircd.pid";
806 # "VIRTUAL_HOST" = "FALSE";
807 # "TOS_SERVER" = "0x08";
808 # "TOS_CLIENT" = "0x08";
809 # "POLLS_PER_LOOP" = "200";
810 # "IRCD_RES_TIMEOUTS" = "4";
811 # "IRCD_RES_RETRIES" = "2";
812 # "AUTH_TIMEOUT" = "9";
813 # "IPCHECK_CLONE_LIMIT" = "4";
814 # "IPCHECK_CLONE_PERIOD" = "40";
815 # "IPCHECK_CLONE_DELAY" = "600";
816 # "CONFIG_OPERCMDS" = "FALSE";
817 # "OPLEVELS" = "TRUE";
818 # "LOCAL_CHANNELS" = "TRUE";
819 # "ANNOUNCE_INVITES" = "FALSE";
820 };
821
822 # Well, you have now reached the end of this sample configuration
823 # file. If you have any questions, feel free to mail
824 # <coder-com@undernet.org>.  If you are interested in linking your
825 # server to the Undernet IRC network visit
826 # http://www.routing-com.undernet.org/, and if there are any
827 # problems then contact <routing-com@undernet.org> asking for
828 # information. Upgrades of the Undernet ircd can be found on
829 # http://coder-com.undernet.org/.
830 #
831 # For the rest:  Good Luck!
832 #
833 #       -- Niels.