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