ViewVC Help
View File | Revision Log | Show Annotations | View Changeset | Root Listing
root/svn/ircd-hybrid/trunk/doc/reference.conf
(Generate patch)

Comparing ircd-hybrid/trunk/doc/reference.conf (file contents):
Revision 2196 by michael, Tue Jun 4 18:30:12 2013 UTC vs.
Revision 3882 by michael, Fri Jun 6 17:09:56 2014 UTC

# Line 1 | Line 1
1 < /* ircd-hybrid reference configuration file
2 < * Copyright (C) 2000-2013 Hybrid Development Team
1 > /*
2 > * This is an example configuration file for ircd-hybrid
3   *
4 < * Written by ejb, wcampbel, db, leeh and others
4 > * Copyright (c) 2000-2014 ircd-hybrid development team
5   *
6   * $Id$
7   */
8  
9   /*
10   * ########################################################################
11 < * IMPORTANT NOTES:
11 > * IMPORTANT NOTE:
12   *
13 < * auth {} blocks MUST be specified in order of precedence.  The first one
14 < * that matches a user will be used.  So place spoofs first, then specials,
13 > * auth {} blocks MUST be specified in order of precedence. The first one
14 > * that matches a user will be used. So place spoofs first, then specials,
15   * then general access.
16   * ########################################################################
17   *
# Line 23 | Line 23
23   *
24   * Times/durations are written as:
25   *        12 hours 30 minutes 1 second
26 < *        
26 > *
27   * Valid units of time:
28   *        year, month, week, day, hour, minute, second
29   *
30   * Valid units of size:
31   *        megabyte/mbyte/mb, kilobyte/kbyte/kb, byte
32   *
33 < * Sizes and times may be singular or plural.  
34 < */
33 > * Sizes and times may be singular or plural.
34 > */
35  
36  
37   /*
# Line 39 | Line 39
39   */
40   serverinfo {
41          /*
42 <         * name: the name of this server.  This cannot be changed at runtime.
42 >         * name: the name of this server. This cannot be changed at runtime.
43           */
44          name = "hades.arpa";
45  
46          /*
47 <         * sid: a server's unique ID.  This is three characters long and must
48 <         * be in the form [0-9][A-Z0-9][A-Z0-9].  The first character must be
47 >         * sid: a server's unique ID. This is three characters long and must
48 >         * be in the form [0-9][A-Z0-9][A-Z0-9]. The first character must be
49           * a digit, followed by 2 alpha-numerical letters.
50 +         *
51           * NOTE: The letters must be capitalized. This cannot be changed at runtime.
52           */
53          sid = "0HY";
# Line 76 | Line 77 | serverinfo {
77   #       vhost = "192.169.0.1";
78  
79          /*
80 <         * vhost6: the IP to bind to when we connect outward to ipv6 servers.
81 <         * This should be an ipv6 IP only, or "*" for INADDR_ANY.
80 >         * vhost6: the address to bind to when we make outgoing connections
81 >         * to IPv6 servers. This should be an IPv6 address, or "*" for INADDR_ANY.
82           */
83   #       vhost6 = "3ffe:80e8:546::2";
84  
# Line 98 | Line 99 | serverinfo {
99          max_topic_length = 160;
100  
101          /*
102 <         * rsa_private_key_file: the path to the file containing our
103 <         * rsa key for cryptlink.
102 >         * rsa_private_key_file: the path to the file containing the
103 >         * RSA key.
104 >         *
105 >         * Example commands to store a 2048 bit RSA key in rsa.key:
106           *
104         * Example command to store a 2048 bit RSA keypair in
105         * rsa.key, and the public key in rsa.pub:
106         *
107           *      openssl genrsa -out rsa.key 2048
108 <         *      openssl rsa -in rsa.key -pubout -out rsa.pub
109 <         *      chown <ircd-user>.<ircd.group> rsa.key rsa.pub
108 >         *      chown <ircd-user>.<ircd.group> rsa.key
109           *      chmod 0600 rsa.key
111         *      chmod 0644 rsa.pub
110           */
111   #       rsa_private_key_file = "/usr/local/ircd/etc/rsa.key";
112  
113          /*
114           * ssl_certificate_file: the path to the file containing our
115 <         * ssl certificate for encrypted client connection.
115 >         * SSL certificate for encrypted client connection.
116           *
117           * This assumes your private RSA key is stored in rsa.key. You
118           * MUST have an RSA key in order to generate the certificate.
# Line 138 | Line 136 | serverinfo {
136           * ssl_dh_param_file:
137           *
138           * Path to the PEM encoded Diffie-Hellman parameter file.
139 <         * DH parameters are strictly required when using ciphers
140 <         * with EDH (ephemeral Diffie-Hellman) key exchange.
139 >         * DH parameters are required when using ciphers with EDH
140 >         * (ephemeral Diffie-Hellman) key exchange.
141           *
142           * A DH parameter file can be created by running:
143           *
144 <         *      openssl dhparam -out dhparam.pem 1024
144 >         *      openssl dhparam -out dhparam.pem 2048
145           *
146           * Prime size must be at least 1024 bits. Further information
147           * regarding specific OpenSSL dhparam command-line options
# Line 154 | Line 152 | serverinfo {
152          /*
153           * ssl_cipher_list:
154           *
155 <         * List of ciphers that are supported by _this_ server. Can be used to
155 >         * List of ciphers to support on _this_ server. Can be used to
156           * enforce specific ciphers for incoming SSL/TLS connections.
157 <         * If a client (which also includes incoming server connections) isn't
158 <         * capable of any cipher listed below, the connection will simply be
159 <         * rejected.
157 >         * If a client (which also includes incoming server connections) is not
158 >         * capable of using any of the ciphers listed here, the connection will
159 >         * simply be rejected.
160           *
161 <         * A list of supported ciphers can be obtained by running:
161 >         * A list of supported ciphers by OpenSSL can be obtained by running:
162           *
163           *      openssl ciphers -ssl3 -tls1 -v
164           *
165           * Multiple ciphers are separated by colons. The order of preference is
166           * from left to right.
167           */
168 < #       ssl_cipher_list = "DHE-RSA-AES256-SHA:AES256-SHA";
168 > #       ssl_cipher_list = "ECDHE-RSA-AES256-GCM-SHA384:DHE-RSA-AES256-GCM-SHA384:DHE-RSA-AES256-SHA:AES256-SHA";
169  
170          /*
171           * ssl_server_method:
# Line 205 | Line 203 | class {
203  
204          /*
205           * number_per_ip: how many local users are allowed to connect
206 <         * from one IP  (optional)
206 >         * from a single IP address  (optional)
207           */
208          number_per_ip = 2;
209  
210          /*
211           * max_local: how many local users are allowed to connect
212 <         * from one ident@host  (optional)
212 >         * from a single ident@host  (optional)
213           */
214          max_local = 2;
215  
# Line 234 | Line 232 | class {
232          number_per_cidr = 16;
233  
234          /*
235 <         * sendq: the amount of data allowed in a clients send queue before
235 >         * sendq: the amount of data allowed in a client's send queue before
236           * they are dropped.
237           */
238          sendq = 100 kbytes;
239  
240          /*
241 <         * recvq: maximum amount of data in a clients receive queue before
241 >         * recvq: the amount of data allowed in a client's receive queue before
242           * they are dropped for flooding. Defaults to 2560 if the chosen
243           * value isn't within the range of 512 to 8000.
244           */
# Line 267 | Line 265 | class {
265          /*
266           * flags:
267           *
268 <         * random_idle          - idle time is randomly selected within the
269 <         *                        range of min_idle to max_idle
270 <         * hide_idle_from_opers - fake idle time will be shown to operators, too
268 >         * random_idle          - a fake idle time is set randomly between
269 >         *                        min_idle and max_idle
270 >         * hide_idle_from_opers - the fake idle time will also be shown to operators
271           */
272          flags = random_idle, hide_idle_from_opers;
273   };
# Line 284 | Line 282 | class {
282           */
283          connectfreq = 5 minutes;
284  
285 <        /* max number: the amount of servers to autoconnect to. */
285 >        /* max number: the number of servers to autoconnect to. */
286          max_number = 1;
287  
288          /* sendq: servers need a higher sendq as they send more data. */
# Line 292 | Line 290 | class {
290   };
291  
292   /*
293 < * motd {}: specifies various MOTD files. Applies to local users only.
293 > * motd {}: Allows the display of a different MOTD to a client
294 > * depending on its origin. Applies to local users only.
295   */
296   motd {
297          /*
298           * mask: multiple mask entries are permitted. Mask can either be
299 <         * a class name or a hostname.
299 >         * a class name or a hostname. CIDR is supported.
300           */
301          mask = "*.at";
302          mask = "*.de";
# Line 314 | Line 313 | motd {
313   */
314   listen {
315          /*
316 <         * port: the specific port to listen on. If no host is specified
317 <         * before, it will listen on all available IPs.
316 >         * port: the port to listen on. If no host is specified earlier
317 >         * in the listen {} block, it will listen on all available IPs.
318           *
319 <         * Ports are separated via a comma, a range may be specified using ".."
319 >         * Ports are separated by commas; a range may be specified using ".."
320           */
321 <        
322 <        /* port: listen on all available IPs, ports 6665 to 6669 */
321 >
322 >        /* port: listen on all available IP addresses, ports 6665 to 6669 */
323          port = 6665 .. 6669;
324  
325          /*
326 <         * Listen on 192.168.0.1/6697 with ssl enabled and hidden from STATS P
326 >         * Listen on 192.168.0.1/6697 with SSL enabled and hidden from STATS P
327           * unless you are an administrator.
328           *
329 <         * NOTE: The "flags" directive has to come before "port". Always!
329 >         * NOTE: The "flags" directive always has to come before "port".
330           *
331           * Currently available flags are:
332           *
# Line 340 | Line 339 | listen {
339          port = 6697;
340  
341          /*
342 <         * host: set a specific IP/host the ports after the line will listen
343 <         * on. This may be ipv4 or ipv6.
342 >         * host: set a specific IP address/host to listen on using the
343 >         * subsequent port definitions. This may be IPv4 or IPv6.
344           */
345          host = "1.2.3.4";
346          port = 7000, 7001;
# Line 356 | Line 355 | listen {
355   auth {
356          /*
357           * user: the user@host allowed to connect. Multiple user
358 <         * lines are permitted per auth block.
358 >         * lines are permitted within each auth block.
359           */
360          user = "*@172.16.0.0/12";
361          user = "*test@123D:B567:*";
# Line 371 | Line 370 | auth {
370          encrypted = yes;
371  
372          /*
373 <         * spoof: fake the users host to this. This is free-form, just do
373 >         * spoof: fake the user's host to this. This is free-form, just do
374           * everyone a favor and don't abuse it. ('=' prefix on /stats I)
375           */
376          spoof = "I.still.hate.packets";
# Line 401 | Line 400 | auth {
400   auth {
401          /*
402           * redirect: the server and port to redirect a user to. A user does not
403 <         * have to obey the redirection, the ircd just suggests an alternative
403 >         * have to obey the redirection; the ircd just suggests an alternative
404           * server for them.
405           */
406          redirserv = "this.is.not.a.real.server";
407          redirport = 6667;
408 <        
408 >
409          user = "*.server";
410  
411          /* class: a class is required even though it is not used */
# Line 427 | Line 426 | operator {
426          name = "sheep";
427  
428          /*
429 <         * user: the user@host required for this operator. Multiple
430 <         * user="" lines are supported.
429 >         * user: the user@host required for this operator. Multiple user
430 >         * lines are permitted within each operator block.
431           */
432          user = "*sheep@192.168.0.0/16";
433          user = "*@127.0.0.0/8";
# Line 438 | Line 437 | operator {
437           * need to be encrypted by using the provided mkpasswd tool.
438           * Several password hash algorithms are available depending
439           * on your system's crypt() implementation. For example, a modern
440 <         * glibc already has support for SHA-256/512, and MD5 encryption
440 >         * glibc already has support for the SHA-256/512 and MD5 encryption
441           * algorithms.
442           */
443          password = "$5$x5zof8qe.Yc7/bPp$5zIg1Le2Lsgd4CvOjaD20pr5PmcfD7ha/9b2.TaUyG4";
# Line 451 | Line 450 | operator {
450  
451          /*
452           * rsa_public_key_file: the public key for this oper when using Challenge.
453 <         * A password should not be defined when this is used, see
453 >         * A password should not be defined when this is used; see
454           * doc/challenge.txt for more information.
455           */
456   #       rsa_public_key_file = "/usr/local/ircd/etc/oper.pub";
457  
458 +        /*
459 +         * ssl_certificate_fingerprint: enhances security by additionally checking
460 +         * the oper's client certificate fingerprint against the specified
461 +         * fingerprint below.
462 +         *
463 +         * Hint: your users can use the following command to obtain a SHA-256 hash
464 +         * of their ssl certificate:
465 +         *
466 +         *      openssl x509 -sha256 -noout -fingerprint -in cert.pem | sed -e 's/^.*=//;s/://g'
467 +         */
468 + #       ssl_certificate_fingerprint = "4C62287BA6776A89CD4F8FF10A62FFB35E79319F51AF6C62C674984974FCCB1D";
469 +
470 +        /*
471 +         * ssl_connection_required: client must be connected over SSL/TLS
472 +         * in order to be able to use this oper{} block.
473 +         * Default is 'no' if nothing else is specified.
474 +         */
475 +        ssl_connection_required = no;
476 +
477          /* class: the class the oper joins when they successfully /oper */
478          class = "opers";
479  
480          /*
481 <         * umodes: default usermodes opers get when they /oper. If defined,
481 >         * umodes: the default usermodes opers get when they /oper. If defined,
482           * it will override oper_umodes settings in general {}.
483           * Available usermodes:
484           *
# Line 474 | Line 492 | operator {
492           * +G - softcallerid - Server Side Ignore for users not on your channels
493           * +g - callerid     - Server Side Ignore (for privmsgs etc)
494           * +H - hidden       - Hides operator status to other users
495 <         * +i - invisible    - Not shown in NAMES or WHO unless you share a
478 <         *                     a channel
495 >         * +i - invisible    - Not shown in NAMES or WHO unless you share a channel
496           * +j - rej          - See rejected client notices
497           * +k - skill        - See server generated KILL messages
498           * +l - locops       - See LOCOPS messages
499           * +n - nchange      - See client nick changes
500 +         * +p - hidechans    - Hides channel list in WHOIS
501 +         * +q - hideidle     - Hides idle and signon time in WHOIS
502           * +R - nononreg     - Only receive private messages from registered clients
503           * +s - servnotice   - See general server notices
504           * +u - unauth       - See unauthorized client notices
505           * +w - wallop       - See server generated WALLOPS
506           * +y - spy          - See LINKS, STATS, TRACE notices etc.
488         * +z - operwall     - See oper generated WALLOPS
507           */
508 <        umodes = locops, servnotice, operwall, wallop;
508 >        umodes = locops, servnotice, wallop;
509  
510          /*
511 <         * privileges: controls the activities and commands an oper is
511 >         * privileges: controls the activities and commands an oper is
512           * allowed to do on the server. All options default to no.
513           * Available options:
514           *
# Line 508 | Line 526 | operator {
526           * unkline        - allows UNKLINE                    | ('U' flag)
527           * gline          - allows GLINE                      | ('G' flag)
528           * xline          - allows XLINE                      | ('X' flag)
529 +         * unxline        - allows UNXLINE                    |
530           * locops         - allows LOCOPS                     |
531           * globops        - allows GLOBOPS                    |
532           * wallops        - allows WALLOPS                    |
514         * operwall       - allows OPERWALL                   | ('L' flag)
533           * rehash         - allows oper to REHASH config      | ('H' flag)
534           * die            - allows DIE                        | ('D' flag)
535           * restart        - allows RESTART                    |
# Line 519 | Line 537 | operator {
537           * admin          - gives administrator privileges    | ('A' flag)
538           */
539          flags = kill, kill:remote, connect, connect:remote, kline, unkline,
540 <                xline, globops, restart, die, rehash, admin, operwall, module;
540 >                xline, globops, restart, die, rehash, admin, module;
541   };
542  
543   /*
544 < * service {}: specifies what server may act as a network service
544 > * service {}: specifies a server which may act as a network service
545   *
546 < * NOTE: it is absolutely important that every single server on the network
546 > * NOTE: it is very important that every server on the network
547   *       has the same service{} block.
548   */
549   service {
# Line 534 | Line 552 | service {
552   };
553  
554   /*
555 < * connect {}:  controls servers we connect to
555 > * connect {}: define a server to connect to
556   */
557   connect {
558          /* name: the name of the server */
559          name = "irc.uplink.com";
560  
561          /*
562 <         * host: the host or IP to connect to. If a hostname is used it
563 <         * must match the reverse dns of the server.
562 >         * host: the host or IP address to connect to. If a hostname is used it
563 >         * must match the reverse DNS of the server.
564           */
565          host = "192.168.0.1";
566  
567          /*
568 <         * vhost: the IP to bind to when we connect outward to servers.
568 >         * vhost: the IP address to bind to when making outgoing connections to
569 >         * servers.
570           * serverinfo::vhost and serverinfo::vhost6 will be overridden
571           * by this directive.
572           */
573          vhost = "192.168.0.2";
574  
575          /*
576 <         * passwords: the passwords we send (OLD C:) and accept (OLD N:).
577 <         * The remote server will have these passwords reversed.
576 >         * passwords: the passwords to send (OLD C:) and accept (OLD N:).
577 >         * The remote server will have these passwords swapped.
578           */
579          send_password = "password";
580          accept_password = "anotherpassword";
# Line 588 | Line 607 | connect {
607           * ssl_cipher_list:
608           *
609           * List of ciphers that the server we are connecting to must support.
610 <         * If the server isn't capable of any cipher listed below, the
611 <         * connection will simply be rejected.
610 >         * If the server is not capable of using any of the ciphers listed below,
611 >         * the connection will simply be rejected.
612           * Can be used to enforce stronger ciphers, even though this option
613           * is not necessarily required to establish a SSL/TLS connection.
614           *
615           * Multiple ciphers are separated by colons. The order of preference
616           * is from left to right.
617           */
618 < #       ssl_cipher_list = "DHE-RSA-AES256-SHA:AES256-SHA";
618 > #       ssl_cipher_list = "ECDHE-RSA-AES256-GCM-SHA384:DHE-RSA-AES256-GCM-SHA384:DHE-RSA-AES256-SHA:AES256-SHA";
619 >
620 >        /*
621 >         * ssl_certificate_fingerprint: enhances security by additionally checking
622 >         * the server's client certificate fingerprint against the specified
623 >         * fingerprint below.
624 >         */
625 > #       ssl_certificate_fingerprint = "4C62287BA6776A89CD4F8FF10A62FFB35E79319F51AF6C62C674984974FCCB1D";
626  
627          /*
628           * autoconn   - controls whether we autoconnect to this server or not,
# Line 627 | Line 653 | connect {
653   */
654   cluster {
655          /*
656 <         * name: the server to share with, this can take wildcards
656 >         * name: the server to share with; this can take wildcards
657           *
658 <         * NOTE: only local actions will be clustered, meaning if
658 >         * NOTE: only local actions will be clustered, meaning that if
659           *       the server receives a shared kline/unkline/etc, it
660           *       will not be propagated to clustered servers.
661           *
# Line 640 | Line 666 | cluster {
666          name = "*.arpa";
667  
668          /*
669 <         * type: list of what to share, options are as follows:
669 >         * type: list of what to share; options are as follows:
670           *      dline   - share dlines
671           *      undline - share undlines
672           *      kline   - share klines
# Line 658 | Line 684 | cluster {
684   /*
685   * shared {}: users that are allowed to remote kline
686   *
687 < * NOTE: This can be effectively used for remote klines.
687 > * NOTE: This can effectively be used for remote klines.
688   *       Please note that there is no password authentication
689   *       for users setting remote klines. You must also be
690   *       /oper'd in order to issue a remote kline.
691   */
692   shared {
693          /*
694 <         * name: the server the user must be on to set klines. If this is not
695 <         * specified, the user will be allowed to kline from all servers.
694 >         * name: the server the user must be connected to in order to set klines.
695 >         * If this is not specified, the user will be allowed to kline from all
696 >         * servers.
697           */
698          name = "irc2.some.server";
699  
# Line 703 | Line 730 | kill {
730   };
731  
732   /*
733 < * deny {}:  IPs that are not allowed to connect (before DNS/ident lookup)
733 > * deny {}:  IP addresses that are not allowed to connect
734 > * (before DNS/ident lookup)
735   * Oper issued dlines will be added to the specified dline config
736   */
737   deny {
# Line 712 | Line 740 | deny {
740   };
741  
742   /*
743 < * exempt {}:  IPs that are exempt from deny {} and Dlines
743 > * exempt {}:  IP addresses that are exempt from deny {} and Dlines
744   */
745   exempt {
746          ip = "192.168.0.0/16";
# Line 722 | Line 750 | exempt {
750   * resv {}:  nicks and channels users may not use/join
751   */
752   resv { mask = "clone*"; reason = "Clone bots"; };
753 + resv { mask = "Global"; reason = "Reserved for services"; };
754   resv { mask = "ChanServ"; reason = "Reserved for services"; };
755   resv { mask = "NickServ"; reason = "Reserved for services"; };
756   resv { mask = "OperServ"; reason = "Reserved for services"; };
# Line 735 | Line 764 | resv { mask = "#*services*"; reason = "R
764   resv {
765          /*
766           * mask: masks starting with a '#' are automatically considered
767 <         * as channel name mask.
767 >         * as channel name masks.
768           */
769          mask = "#helsinki";
770 <        reason = "Channel is reserved for finnish inhabitants";
770 >        reason = "Channel is reserved for Finnish inhabitants";
771  
772          /*
773           * exempt: can be either a ISO 3166 alpha-2 two letter country
# Line 767 | Line 796 | gecos {
796   channel {
797          /*
798           * disable_fake_channels: this option, if set to 'yes', will
799 <         * disallow clients to create or join channels that have one
799 >         * disallow clients from creating or joining channels that have one
800           * of the following ASCII characters in their name:
801           *
802           *   2 | bold
# Line 781 | Line 810 | channel {
810          disable_fake_channels = yes;
811  
812          /*
813 <         * knock_delay: The amount of time a user must wait between issuing
814 <         * the knock command.
813 >         * invite_client_count, invite_client_time: how many INVITE commands
814 >         * are permitted per client per invite_client_time.
815 >         */
816 >        invite_client_count = 10;
817 >        invite_client_time = 5 minutes;
818 >
819 >        /*
820 >         * knock_client_count, knock_client_time: how many KNOCK commands
821 >         * are permitted per client per knock_client_time.
822           */
823 <        knock_delay = 5 minutes;
823 >        knock_client_count = 1;
824 >        knock_client_time = 5 minutes;
825  
826          /*
827 <         * knock_delay_channel: How often a knock to any specific channel
828 <         * is permitted, regardless of the user sending the knock.
827 >         * knock_delay_channel: How often a KNOCK to any specific channel
828 >         * is permitted, regardless of the user sending the KNOCK.
829           */
830          knock_delay_channel = 1 minute;
831  
# Line 808 | Line 845 | channel {
845          max_bans = 100;
846  
847          /*
848 <         * how many joins in how many seconds constitute a flood, use 0 to
848 >         * how many joins in how many seconds constitute a flood. Use 0 to
849           * disable. +b opers will be notified (changeable via /set)
850           */
851          join_flood_count = 16;
852          join_flood_time = 8 seconds;
853  
854          /*
855 <         * splitcode: The ircd will now check splitmode every few seconds.
855 >         * The ircd will now check splitmode (whether a server is split from
856 >         * the network) every few seconds; this functionality is known as
857 >         * splitcode and is influenced by the options below.
858           *
859           * Either split users or split servers can activate splitmode, but
860           * both conditions must be met for the ircd to deactivate splitmode.
861 <         *
861 >         *
862           * You may force splitmode to be permanent by /quote set splitmode on
863           */
864  
# Line 835 | Line 874 | channel {
874           */
875          default_split_server_count = 0;
876  
877 <        /* no_create_on_split: disallow users creating channels on split. */
877 >        /* no_create_on_split: do not allow users to create channels on split. */
878          no_create_on_split = yes;
879  
880 <        /* no_join_on_split: disallow users joining channels at all on a split. */
880 >        /* no_join_on_split: do not allow users to join channels on a split. */
881          no_join_on_split = no;
882   };
883  
884   /*
885   * serverhide {}:  The serverhide block contains the options regarding
886 < * serverhiding
886 > * to server hiding
887   */
888   serverhide {
889          /*
890 <         * disable_remote_commands: disable users doing commands
890 >         * disable_remote_commands: disable users issuing commands
891           * on remote servers.
892           */
893          disable_remote_commands = no;
894  
895          /*
896           * flatten_links: this option will show all servers in /links appear
897 <         * that they are linked to this current server.
897 >         * as though they are linked to this current server.
898           */
899          flatten_links = no;
900  
# Line 890 | Line 929 | serverhide {
929  
930          /*
931           * hide_server_ips: If this is disabled, opers will be unable to see
932 <         * servers ips and will be shown a masked ip, admins will be shown the
933 <         * real ip.
932 >         * servers' IP addresses and will be shown a masked IP address; admins
933 >         * will be shown the real IP address.
934           *
935 <         * If this is enabled, nobody can see a servers ip. *This is a kludge*,
936 <         * it has the side effect of hiding the ips everywhere, including
937 <         * logfiles.
935 >         * If this is enabled, nobody can see a server's IP address.
936 >         * *This is a kludge*: it has the side effect of hiding the IP addresses
937 >         * everywhere, including logfiles.
938           *
939           * We recommend you leave this disabled, and just take care with who you
940           * give administrator privileges to.
# Line 908 | Line 947 | serverhide {
947   * compiled in options in config.h
948   */
949   general {
950 +        /*
951 +         * cycle_on_host_change: sends a fake QUIT/JOIN combination
952 +         * when services change the hostname of a specific client.
953 +         */
954 +        cycle_on_host_change = yes;
955 +
956          /* services_name: servername of nick/channel services */
957          services_name = "service.someserver";
958  
959          /* max_watch: maximum WATCH entries a client can have. */
960 <        max_watch = 60;
960 >        max_watch = 30;
961 >
962 >        /* max_accept: maximum allowed /accept's for +g usermode. */
963 >        max_accept = 30;
964  
965 <        /* gline_enable: enable glines, network wide temp klines. */
965 >        /* gline_enable: enable glines (network-wide temporary klines). */
966          gline_enable = yes;
967  
968          /*
# Line 942 | Line 990 | general {
990          gline_min_cidr6 = 48;
991  
992          /*
993 <         * Whether to automatically set mode +i on connecting users.
993 >         * invisible_on_connect: whether to automatically set mode +i on
994 >         * connecting users.
995           */
996          invisible_on_connect = yes;
997  
998          /*
999 <         * kill_chase_time_limit: maximum time from the nickname change that
1000 <         * still causes KILL automatically to switch for the current nick of
1001 <         * that user.
999 >         * kill_chase_time_limit: KILL chasing is a feature whereby a KILL
1000 >         * issued for a user who has recently changed nickname will be applied
1001 >         * automatically to the new nick. kill_chase_time_limit is the maximum
1002 >         * time following a nickname change that this chasing will apply.
1003           */
1004 <        kill_chase_time_limit = 90 seconds;
1004 >        kill_chase_time_limit = 30 seconds;
1005  
1006          /*
1007           * hide_spoof_ips: if disabled, opers will be allowed to see the real
1008 <         * IP of spoofed users in /trace etc. If this is defined they will be
1009 <         * shown a masked IP.
1008 >         * IP address of spoofed users in /trace etc. If this is defined they
1009 >         * will be shown a masked IP.
1010           */
1011          hide_spoof_ips = yes;
1012  
# Line 982 | Line 1032 | general {
1032  
1033          /*
1034           * default_floodcount: the default value of floodcount that is configurable
1035 <         * via /quote set floodcount. This is the amount of lines a user
1035 >         * via /quote set floodcount. This is the number of lines a user
1036           * may send to any other user/channel in one second.
1037           */
1038          default_floodcount = 10;
1039  
1040          /*
1041 <         * failed_oper_notice: send a notice to all opers on the server when
1041 >         * failed_oper_notice: send a notice to all opers on the server when
1042           * someone tries to OPER and uses the wrong password, host or ident.
1043           */
1044          failed_oper_notice = yes;
1045  
1046          /*
1047 <         * dots_in_ident: the amount of '.' characters permitted in an ident
1047 >         * dots_in_ident: the number of '.' characters permitted in an ident
1048           * reply before the user is rejected.
1049           */
1050          dots_in_ident = 2;
1051  
1052          /*
1053 <         * min_nonwildcard: the minimum non wildcard characters in k/d/g lines
1054 <         * placed via the server. K-lines hand placed are exempt from limits.
1053 >         * min_nonwildcard: the minimum number of non-wildcard characters in
1054 >         * k/d/g lines placed via the server. K-lines hand-placed are exempt from
1055 >         * this limit.
1056           * Wildcard chars: '.', ':', '*', '?', '@', '!'
1057           */
1058          min_nonwildcard = 4;
1059  
1060          /*
1061 <         * min_nonwildcard_simple: the minimum non wildcard characters in
1062 <         * gecos bans. Wildcard chars: '*', '?'
1061 >         * min_nonwildcard_simple: the minimum number of non-wildcard characters
1062 >         * in gecos bans. Wildcard chars: '*', '?'
1063           */
1064          min_nonwildcard_simple = 3;
1065  
1015        /* max_accept: maximum allowed /accept's for +g usermode. */
1016        max_accept = 20;
1017
1066          /* anti_nick_flood: enable the nickflood control code. */
1067          anti_nick_flood = yes;
1068  
1069 <        /* nick flood: the nick changes allowed in the specified period */
1069 >        /* nick flood: the number of nick changes allowed in the specified period */
1070          max_nick_time = 20 seconds;
1071          max_nick_changes = 5;
1072  
# Line 1029 | Line 1077 | general {
1077          anti_spam_exit_message_time = 5 minutes;
1078  
1079          /*
1080 <         * ts delta: the time delta allowed between server clocks before
1081 <         * a warning is given, or before the link is dropped. All servers
1082 <         * should run ntpdate/rdate to keep clocks in sync
1080 >         * ts_warn_delta, ts_max_delta: the time delta allowed between server
1081 >         * clocks before a warning is given, or before the link is dropped.
1082 >         * All servers should run ntpdate/rdate to keep clocks in sync
1083           */
1084 <        ts_warn_delta = 30 seconds;
1085 <        ts_max_delta = 5 minutes;
1084 >        ts_warn_delta = 10 seconds;
1085 >        ts_max_delta = 2 minutes;
1086  
1087          /*
1088 <         * warn_no_nline: warn opers about servers that try to connect but
1089 <         * we don't have a connect {} block for. Twits with misconfigured
1090 <         * servers can get really annoying with this enabled.
1088 >         * warn_no_connect_block: warn opers about servers that try to connect
1089 >         * but for which we don't have a connect {} block. Twits with
1090 >         * misconfigured servers can become really annoying with this enabled.
1091           */
1092 <        warn_no_nline = yes;
1092 >        warn_no_connect_block = yes;
1093  
1094          /*
1095           * stats_e_disabled: set this to 'yes' to disable "STATS e" for both
# Line 1051 | Line 1099 | general {
1099           */
1100          stats_e_disabled = no;
1101  
1102 <        /* stats_o_oper only: make stats o (opers) oper only */
1102 >        /* stats_o_oper_only: make stats o (opers) oper only */
1103          stats_o_oper_only = yes;
1104  
1105          /* stats_P_oper_only: make stats P (ports) oper only */
1106          stats_P_oper_only = yes;
1107  
1108 +        /* stats_u_oper_only: make stats u (uptime) oper only */
1109 +        stats_u_oper_only = no;
1110 +
1111          /*
1112 <         * stats i oper only: make stats i (auth {}) oper only. Set to:
1112 >         * stats_i_oper_only: make stats i (auth {}) oper only. Set to:
1113           *     yes    - show users no auth blocks, made oper only.
1114 <         *     masked - show users first matching auth block
1114 >         *     masked - show users the first matching auth block
1115           *     no     - show users all auth blocks.
1116           */
1117          stats_i_oper_only = yes;
# Line 1068 | Line 1119 | general {
1119          /*
1120           * stats_k_oper_only: make stats k/K (klines) oper only. Set to:
1121           *     yes    - show users no auth blocks, made oper only
1122 <         *     masked - show users first matching auth block
1122 >         *     masked - show users the first matching auth block
1123           *     no     - show users all auth blocks.
1124           */
1125          stats_k_oper_only = yes;
# Line 1086 | Line 1137 | general {
1137          opers_bypass_callerid = no;
1138  
1139          /*
1140 <         * pace_wait_simple: time between use of less intensive commands
1141 <         * (ADMIN, HELP, (L)USERS, VERSION, remote WHOIS)
1140 >         * pace_wait_simple: minimum time required between use of less
1141 >         * intensive commands
1142 >         * (ADMIN, HELP, LUSERS, VERSION, remote WHOIS)
1143           */
1144          pace_wait_simple = 1 second;
1145  
1146          /*
1147 <         * pace_wait: time between more intensive commands
1148 <         * (AWAY, INFO, LINKS, MAP, MOTD, STATS, WHO, wildcard WHOIS, WHOWAS)
1147 >         * pace_wait: minimum time required between use of more intensive commands
1148 >         * (AWAY, INFO, LINKS, MAP, MOTD, STATS, WHO, WHOWAS)
1149           */
1150          pace_wait = 10 seconds;
1151  
1152          /*
1153 <         * short_motd: send clients a notice telling them to read the motd
1154 <         * instead of forcing a motd to clients who may simply ignore it.
1153 >         * short_motd: send clients a notice telling them to read the MOTD
1154 >         * instead of forcing an MOTD to clients who may simply ignore it.
1155           */
1156          short_motd = no;
1157  
# Line 1121 | Line 1173 | general {
1173          /* oper_pass_resv: allow opers to over-ride RESVs on nicks/channels. */
1174          oper_pass_resv = yes;
1175  
1176 <        /* REMOVE ME.  The following line checks you've been reading. */
1176 >        /* REMOVE ME. The following line checks that you have been reading. */
1177          havent_read_conf = 1;
1178  
1179          /*
1180 <         * max_targets: the maximum amount of targets in a single
1180 >         * max_targets: the maximum number of targets in a single
1181           * PRIVMSG/NOTICE. Set to 999 NOT 0 for unlimited.
1182           */
1183          max_targets = 4;
# Line 1143 | Line 1195 | general {
1195           * +G - softcallerid - Server Side Ignore for users not on your channels
1196           * +g - callerid     - Server Side Ignore (for privmsgs etc)
1197           * +H - hidden       - Hides operator status to other users
1198 <         * +i - invisible    - Not shown in NAMES or WHO unless you share a
1147 <         *                     a channel
1198 >         * +i - invisible    - Not shown in NAMES or WHO unless you share a channel
1199           * +j - rej          - See rejected client notices
1200           * +k - skill        - See server generated KILL messages
1201           * +l - locops       - See LOCOPS messages
1202           * +n - nchange      - See client nick changes
1203 +         * +p - hidechans    - Hides channel list in WHOIS
1204 +         * +q - hideidle     - Hides idle and signon time in WHOIS
1205           * +R - nononreg     - Only receive private messages from registered clients
1206           * +s - servnotice   - See general server notices
1207           * +u - unauth       - See unauthorized client notices
1208           * +w - wallop       - See server generated WALLOPS
1209           * +y - spy          - See LINKS, STATS, TRACE notices etc.
1157         * +z - operwall     - See oper generated WALLOPS
1210           */
1211  
1212          /* oper_only_umodes: usermodes only opers may set */
1213          oper_only_umodes = bots, cconn, debug, full, hidden, skill,
1214 <                           nchange, rej, spy, external, operwall,
1215 <                           locops, unauth, farconnect;
1214 >                        nchange, rej, spy, external,
1215 >                        locops, unauth, farconnect;
1216  
1217          /* oper_umodes: default usermodes opers get when they /oper */
1218 <        oper_umodes = bots, locops, servnotice, operwall, wallop;
1218 >        oper_umodes = bots, locops, servnotice, wallop;
1219  
1220          /*
1221           * use_egd: if your system does not have *random devices yet you
# Line 1178 | Line 1230 | general {
1230           */
1231   #       egdpool_path = "/var/run/egd-pool";
1232  
1233 +
1234          /*
1235 <         * throttle_time: the minimum amount of time between connections from
1236 <         * the same ip. exempt {} blocks are excluded from this throttling.
1235 >         * throttle_count: the maximum number of connections from the same
1236 >         * IP address allowed in throttle_time duration.
1237 >         */
1238 >        throttle_count = 1;
1239 >
1240 >        /*
1241 >         * throttle_time: the minimum amount of time required between
1242 >         * connections from the same IP address. exempt {} blocks are
1243 >         * excluded from this throttling.
1244           * Offers protection against flooders who reconnect quickly.
1245           * Set to 0 to disable.
1246           */
1247 <        throttle_time = 10;
1247 >        throttle_time = 2 seconds;
1248   };
1249  
1250   modules {
# Line 1242 | Line 1302 | log {
1302                  size = 50 megabytes;
1303          };
1304  
1305 +        file {
1306 +                type = xline;
1307 +                name = "/usr/local/ircd/var/log/xline.log";
1308 +                size = 50 megabytes;
1309 +        };
1310 +
1311 +        file {
1312 +                type = resv;
1313 +                name = "/usr/local/ircd/var/log/resv.log";
1314 +                size = 50 megabytes;
1315 +        };
1316 +
1317          file {
1318                  type = debug;
1319                  name = "/usr/local/ircd/var/log/debug.log";

Diff Legend

Removed lines
+ Added lines
< Changed lines (old)
> Changed lines (new)