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

Comparing:
ircd-hybrid/trunk/doc/reference.conf (file contents), Revision 2012 by michael, Sun May 12 14:47:26 2013 UTC vs.
ircd-hybrid/branches/8.2.x/doc/reference.conf (file contents), Revision 4968 by michael, Mon Dec 1 14:36:42 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 73 | Line 74 | serverinfo {
74           * vhost: the IP to bind to when we connect outward to ipv4 servers.
75           * This should be an ipv4 IP only, or "*" for INADDR_ANY.
76           */
77 <        #vhost = "192.169.0.1";
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";
83 > #       vhost6 = "3ffe:80e8:546::2";
84  
85          /* max_clients: the maximum number of clients allowed to connect. */
86          max_clients = 512;
# 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";
111 > #       rsa_private_key_file = "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 132 | Line 130 | serverinfo {
130           *      Common Name: irc.someirc.net
131           *      E-mail: you@domain.com
132           */
133 <        #ssl_certificate_file = "/usr/local/ircd/etc/cert.pem";
133 > #       ssl_certificate_file = "etc/cert.pem";
134  
135          /*
136 <         * ssl_dh_param_file:
137 <         *
138 <         * Path to the PEM encoded Diffie-Hellman parameter file.
141 <         * DH parameters are strictly required when using ciphers
142 <         * with EDH (ephemeral Diffie-Hellman) key exchange.
136 >         * ssl_dh_param_file: path to the PEM encoded Diffie-Hellman
137 >         * parameter file. DH parameters are required when using
138 >         * ciphers with EDH (ephemeral Diffie-Hellman) key exchange.
139           *
140           * A DH parameter file can be created by running:
141           *
142 <         *      openssl dhparam -out dhparam.pem 1024
142 >         *      openssl dhparam -out dhparam.pem 2048
143           *
144           * Prime size must be at least 1024 bits. Further information
145           * regarding specific OpenSSL dhparam command-line options
146           * can be found in the OpenSSL manual.
147           */
148 <        #ssl_dh_param_file = "/usr/local/ircd/etc/dhparam.pem";
148 > #       ssl_dh_param_file = "etc/dhparam.pem";
149  
150          /*
151 <         * ssl_cipher_list:
151 >         * ssl_dh_elliptic_curve: defines the curve to use for the
152 >         * Elliptic Curve Diffie-Hellman (ECDH) algorithm.
153 >         * Default is ANSI X9.62 prime256v1/secp256r1 if nothing else is specified.
154           *
155 <         * List of ciphers that are supported by _this_ server. Can be used to
158 <         * enforce specific ciphers for incoming SSL/TLS connections.
159 <         * If a client (which also includes incoming server connections) isn't
160 <         * capable of any cipher listed below, the connection will simply be
161 <         * rejected.
155 >         * A list of supported curves by OpenSSL can be obtained by running:
156           *
157 <         * A list of supported ciphers can be obtained by running:
157 >         *      openssl ecparam -list_curves
158 >         */
159 > #       ssl_dh_elliptic_curve = "secp521r1";
160 >
161 >        /*
162 >         * ssl_cipher_list: list of ciphers to support on _this_ server.
163 >         * Can be used to enforce specific ciphers for incoming SSL/TLS
164 >         * connections. If a client (which also includes incoming server connections)
165 >         * is not capable of using any of the ciphers listed here, the connection will
166 >         * simply be rejected.
167 >         *
168 >         * A list of supported ciphers by OpenSSL can be obtained by running:
169           *
170           *      openssl ciphers -ssl3 -tls1 -v
171           *
172           * Multiple ciphers are separated by colons. The order of preference is
173           * from left to right.
174           */
175 <        #ssl_cipher_list = "DHE-RSA-AES256-SHA:AES256-SHA";
175 > #       ssl_cipher_list = "ECDHE-RSA-AES256-GCM-SHA384:DHE-RSA-AES256-GCM-SHA384:DHE-RSA-AES256-SHA:AES256-SHA";
176  
177          /*
178 <         * ssl_server_method:
179 <         * ssl_client_method:
178 >         * ssl_message_digest_algorithm: defines what cryptographic hash function
179 >         * to use for generating fingerprint hashes of X.509 certificates.
180 >         * Default is SHA-256 if nothing else is specified.
181           *
182 <         * SSL/TLS methods we provide for incoming (server method) and
183 <         * outgoing (client method) SSL/TLS connections.
184 <         * This can be either sslv3 for SSLv3, and/or tlsv1 for TLSv1.
182 >         * A list of supported message digest algorithms by OpenSSL can be obtained by running:
183 >         *
184 >         *      openssl list-message-digest-algorithms
185           */
186 <        #ssl_server_method = tlsv1, sslv3;
181 <        #ssl_client_method = tlsv1;
186 > #       ssl_message_digest_algorithm = "sha256";
187   };
188  
189   /*
190 < * admin {}:  contains admin information about the server
190 > * admin {}:  contains administrative information about the server
191   */
192   admin {
193          name = "Smurf target";
# Line 205 | Line 210 | class {
210  
211          /*
212           * number_per_ip: how many local users are allowed to connect
213 <         * from one IP  (optional)
213 >         * from a single IP address (optional)
214           */
215          number_per_ip = 2;
216  
217          /*
218           * max_local: how many local users are allowed to connect
219 <         * from one ident@host  (optional)
219 >         * from a single ident@host (optional)
220           */
221          max_local = 2;
222  
223          /*
224 <         * max_global: network-wide limit of users per ident@host  (optional)
224 >         * max_global: network-wide limit of users per ident@host (optional)
225           */
226          max_global = 10;
227  
# Line 226 | Line 231 | class {
231          max_number = 100;
232  
233          /*
234 <         * the following lines are optional and allow you to define
234 >         * The following lines are optional and allow you to define
235           * how many users can connect from one /NN subnet.
236           */
237          cidr_bitlen_ipv4 = 24;
# Line 234 | Line 239 | class {
239          number_per_cidr = 16;
240  
241          /*
242 <         * sendq: the amount of data allowed in a clients send queue before
242 >         * sendq: the amount of data allowed in a client's send queue before
243           * they are dropped.
244           */
245          sendq = 100 kbytes;
246  
247          /*
248 <         * recvq: maximum amount of data in a clients receive queue before
249 <         * they are dropped for flooding. Defaults to 2560 if the chosen
250 <         * value isn't within the range of 512 to 8000.
248 >         * recvq: the amount of data allowed in a client's receive queue before
249 >         * they are dropped for flooding. Defaults to 2560 if the chosen value
250 >         * isn't within the range of 512 to 8000.
251           */
252          recvq = 2560 bytes;
253   };
# Line 255 | Line 260 | class {
260          sendq = 100 kbytes;
261  
262          /*
263 +         * max_channels: maximum number of channels users in this class can join.
264 +         */
265 +        max_channels = 60;
266 +
267 +        /*
268           * min_idle: minimum idle time that is shown in /whois.
269           */
270          min_idle = 3 hours;
# Line 267 | Line 277 | class {
277          /*
278           * flags:
279           *
280 <         * random_idle          - idle time is randomly selected within the
281 <         *                        range of min_idle to max_idle
282 <         * hide_idle_from_opers - fake idle time will be shown to operators, too
280 >         * random_idle          - a fake idle time is set randomly between
281 >         *                        min_idle and max_idle
282 >         * hide_idle_from_opers - the fake idle time will also be shown to operators
283           */
284          flags = random_idle, hide_idle_from_opers;
285   };
# Line 284 | Line 294 | class {
294           */
295          connectfreq = 5 minutes;
296  
297 <        /* max number: the amount of servers to autoconnect to. */
297 >        /* max number: the number of servers to autoconnect to. */
298          max_number = 1;
299  
300          /* sendq: servers need a higher sendq as they send more data. */
# Line 292 | Line 302 | class {
302   };
303  
304   /*
305 + * motd {}: Allows the display of a different MOTD to a client
306 + * depending on its origin. Applies to local users only.
307 + */
308 + motd {
309 +        /*
310 +         * mask: multiple mask entries are permitted. Mask can either be
311 +         * a class name or a hostname. CIDR is supported.
312 +         */
313 +        mask = "*.at";
314 +        mask = "*.de";
315 +        mask = "*.ch";
316 +
317 +        /*
318 +         * file: path to the actual motd file.
319 +         */
320 +        file = "etc/german.motd";
321 + };
322 +
323 + /*
324   * listen {}:  contains information about the ports ircd listens on
325   */
326   listen {
327          /*
328 <         * port: the specific port to listen on. If no host is specified
329 <         * before, it will listen on all available IPs.
328 >         * port: the port to listen on. If no host is specified earlier
329 >         * in the listen {} block, it will listen on all available IPs.
330           *
331 <         * Ports are separated via a comma, a range may be specified using ".."
331 >         * Ports are separated by commas; a range may be specified using ".."
332           */
333 <        
334 <        /* port: listen on all available IPs, ports 6665 to 6669 */
333 >
334 >        /* port: listen on all available IP addresses, ports 6665 to 6669. */
335          port = 6665 .. 6669;
336  
337          /*
338 <         * Listen on 192.168.0.1/6697 with ssl enabled and hidden from STATS P
338 >         * Listen on 192.168.0.1/6697 with SSL enabled and hidden from STATS P
339           * unless you are an administrator.
340           *
341 <         * NOTE: The "flags" directive has to come before "port". Always!
341 >         * NOTE: The "flags" directive always has to come before "port".
342           *
343           * Currently available flags are:
344           *
# Line 322 | Line 351 | listen {
351          port = 6697;
352  
353          /*
354 <         * host: set a specific IP/host the ports after the line will listen
355 <         * on. This may be ipv4 or ipv6.
354 >         * host: set a specific IP address/host to listen on using the
355 >         * subsequent port definitions. This may be IPv4 or IPv6.
356           */
357          host = "1.2.3.4";
358          port = 7000, 7001;
# Line 338 | Line 367 | listen {
367   auth {
368          /*
369           * user: the user@host allowed to connect. Multiple user
370 <         * lines are permitted per auth block.
370 >         * lines are permitted within each auth {} block.
371           */
372          user = "*@172.16.0.0/12";
373          user = "*test@123D:B567:*";
374  
375 <        /* password: an optional password that is required to use this block */
375 >        /* password: an optional password that is required to use this block. */
376          password = "letmein";
377  
378          /*
# Line 353 | Line 382 | auth {
382          encrypted = yes;
383  
384          /*
385 <         * spoof: fake the users host to this. This is free-form, just do
385 >         * spoof: fake the user's host to this. This is free-form, just do
386           * everyone a favor and don't abuse it. ('=' prefix on /stats I)
387           */
388          spoof = "I.still.hate.packets";
389  
390 <        /* class: the class the user is placed in */
390 >        /* class: the class the user is placed in. */
391          class = "opers";
392  
393          /*
394 <         * need_password - don't allow users who haven't supplied the correct
395 <         *                 password to connect using another auth{} block
396 <         *                 ('&' prefix on /stats I if disabled)
368 <         * need_ident    - require the user to have identd to connect ('+' prefix on /stats I)
394 >         * need_password - don't allow users who haven't supplied the correct  | ('&' prefix on /stats I if disabled)
395 >         *                 password to connect using another auth {} block
396 >         * need_ident    - require the user to have identd to connect          | ('+' prefix on /stats I)
397           * spoof_notice  - enable spoofing notification to admins
398 <         * exceed_limit  - allow a user to exceed class limits ('>' prefix on /stats I)
399 <         * kline_exempt  - exempt this user from k/glines ('^' prefix on /stats I)
400 <         * gline_exempt  - exempt this user from glines ('_' prefix on /stats I)
401 <         * resv_exempt   - exempt this user from resvs ('$' prefix on /stats I)
402 <         * no_tilde      - remove ~ from a user with no ident ('-' prefix on /stats I)
403 <         * can_flood     - allow this user to exceed flood limits ('|' prefix on /stats I)
404 <         * webirc        - enables WEBIRC authentication for web-based clients such as Mibbit
405 <         *                 ('<' prefix on /stats I)
398 >         * exceed_limit  - allow a user to exceed class limits                 | ('>' prefix on /stats I)
399 >         * kline_exempt  - exempt this user from k/glines                      | ('^' prefix on /stats I)
400 >         * gline_exempt  - exempt this user from glines                        | ('_' prefix on /stats I)
401 >         * resv_exempt   - exempt this user from resvs                         | ('$' prefix on /stats I)
402 >         * no_tilde      - remove ~ from a user with no ident                  | ('-' prefix on /stats I)
403 >         * can_flood     - allow this user to exceed flood limits              | ('|' prefix on /stats I)
404 >         * webirc        - enables WEBIRC authentication for web-based         | ('<' prefix on /stats I)
405 >         *                 clients such as Mibbit
406           */
407          flags = need_password, spoof_notice, exceed_limit, kline_exempt,
408                  gline_exempt, resv_exempt, no_tilde, can_flood;
# Line 382 | Line 410 | auth {
410  
411   auth {
412          /*
413 <         * redirect: the server and port to redirect a user to. A user does not
414 <         * have to obey the redirection, the ircd just suggests an alternative
415 <         * server for them.
413 >         * redirserv, redirport: the server and port to redirect a user to.
414 >         * A user does not have to obey the redirection; the ircd just
415 >         * suggests an alternative server for them.
416           */
417 <        redirserv = "this.is.not.a.real.server";
417 >        redirserv = "server.tld";
418          redirport = 6667;
391        
392        user = "*.server";
419  
420 <        /* class: a class is required even though it is not used */
420 >        user = "*@*.tld";
421 >
422 >        /* class: a class is required even though it is not used. */
423          class = "users";
424   };
425  
# Line 405 | Line 433 | auth {
433   * operator {}:  defines ircd operators
434   */
435   operator {
436 <        /* name: the name of the oper */
436 >        /* name: the name of the operator */
437          name = "sheep";
438  
439          /*
440 <         * user: the user@host required for this operator. Multiple
441 <         * user="" lines are supported.
440 >         * user: the user@host required for this operator. Multiple user
441 >         * lines are permitted within each operator {} block.
442           */
443          user = "*sheep@192.168.0.0/16";
444          user = "*@127.0.0.0/8";
# Line 420 | Line 448 | operator {
448           * need to be encrypted by using the provided mkpasswd tool.
449           * Several password hash algorithms are available depending
450           * on your system's crypt() implementation. For example, a modern
451 <         * glibc already has support for SHA-256/512, and MD5 encryption
451 >         * glibc already has support for the SHA-256/512 and MD5 encryption
452           * algorithms.
453           */
454          password = "$5$x5zof8qe.Yc7/bPp$5zIg1Le2Lsgd4CvOjaD20pr5PmcfD7ha/9b2.TaUyG4";
455  
456          /*
457           * encrypted: controls whether the oper password above has been
458 <         * encrypted.
458 >         * encrypted. Default is 'yes' if nothing else is specified.
459           */
460          encrypted = yes;
461  
462          /*
463 <         * rsa_public_key_file: the public key for this oper when using Challenge.
464 <         * A password should not be defined when this is used, see
463 >         * rsa_public_key_file: the public key for this oper when using /challenge.
464 >         * A password should not be defined when this is used; see
465           * doc/challenge.txt for more information.
466           */
467 < #       rsa_public_key_file = "/usr/local/ircd/etc/oper.pub";
467 > #       rsa_public_key_file = "etc/oper.pub";
468 >
469 >        /*
470 >         * ssl_certificate_fingerprint: enhances security by additionally checking
471 >         * the oper's client certificate fingerprint against the specified
472 >         * fingerprint below.
473 >         *
474 >         * Hint: your users can use the following command to obtain a SHA-256 hash
475 >         * of their ssl certificate:
476 >         *
477 >         *      openssl x509 -sha256 -noout -fingerprint -in cert.pem | sed -e 's/^.*=//;s/://g'
478 >         */
479 > #       ssl_certificate_fingerprint = "4C62287BA6776A89CD4F8FF10A62FFB35E79319F51AF6C62C674984974FCCB1D";
480 >
481 >        /*
482 >         * ssl_connection_required: client must be connected over SSL/TLS
483 >         * in order to be able to use this operator {} block.
484 >         * Default is 'no' if nothing else is specified.
485 >         */
486 >        ssl_connection_required = no;
487  
488 <        /* class: the class the oper joins when they successfully /oper */
488 >        /* class: the class the oper joins when they successfully /oper or /challenge. */
489          class = "opers";
490  
491          /*
492 <         * umodes: default usermodes opers get when they /oper. If defined,
493 <         * it will override oper_umodes settings in general {}.
492 >         * umodes: the default usermodes opers get when they /oper or /challenge.
493 >         * If defined, it will override oper_umodes settings in general {}.
494           * Available usermodes:
495           *
496           * +b - bots         - See bot and drone flooding notices
497           * +c - cconn        - Client connection/quit notices
451         * +C - cconn_full   - Client connection/quit notices full
498           * +D - deaf         - Don't receive channel messages
499           * +d - debug        - See debugging notices
500           * +e - external     - See remote server connection and split notices
501           * +F - farconnect   - Remote client connection/quit notices
502 <         * +f - full         - See auth{} block full notices
502 >         * +f - full         - See auth {} block full notices
503           * +G - softcallerid - Server Side Ignore for users not on your channels
504           * +g - callerid     - Server Side Ignore (for privmsgs etc)
505           * +H - hidden       - Hides operator status to other users
506 <         * +i - invisible    - Not shown in NAMES or WHO unless you share a
461 <         *                     a channel
506 >         * +i - invisible    - Not shown in NAMES or WHO unless you share a channel
507           * +j - rej          - See rejected client notices
508           * +k - skill        - See server generated KILL messages
509           * +l - locops       - See LOCOPS messages
510           * +n - nchange      - See client nick changes
511 +         * +p - hidechans    - Hides channel list in WHOIS
512 +         * +q - hideidle     - Hides idle and signon time in WHOIS
513           * +R - nononreg     - Only receive private messages from registered clients
514           * +s - servnotice   - See general server notices
515           * +u - unauth       - See unauthorized client notices
516           * +w - wallop       - See server generated WALLOPS
517           * +y - spy          - See LINKS, STATS, TRACE notices etc.
471         * +z - operwall     - See oper generated WALLOPS
518           */
519 < #       umodes = locops, servnotice, operwall, wallop;
519 >        umodes = locops, servnotice, wallop;
520  
521          /*
522 <         * privileges: controls the activities and commands an oper is
523 <         * allowed to do on the server. All options default to no.
524 <         * Available options:
525 <         *
526 <         * module         - allows MODULE
527 <         * connect        - allows local CONNECT
528 <         * connect:remote - allows remote CONNECT
529 <         * squit          - allows local SQUIT
530 <         * squit:remote   - allows remote SQUIT
531 <         * kill           - allows to KILL local clients
532 <         * kill:remote    - allows remote users to be /KILL'd
533 <         * remoteban      - allows remote KLINE/UNKLINE
534 <         * dline          - allows DLINE
535 <         * undline        - allows UNDLINE
536 <         * kline          - allows KILL and KLINE
537 <         * unkline        - allows UNKLINE
538 <         * gline          - allows GLINE
539 <         * xline          - allows XLINE
540 <         * globops        - allows GLOBOPS
541 <         * operwall       - allows OPERWALL
542 <         * rehash         - allows oper to REHASH config
543 <         * die            - allows DIE
544 <         * restart        - allows RESTART
545 <         * set            - allows SET
546 <         * admin          - gives admin privileges. admins for example,
547 <         *                  may see the real IP addresses of servers.
522 >         * privileges: controls the activities and commands an oper is
523 >         * allowed to do on the server. All flags default to 'no'.
524 >         * Available flags:
525 >         *
526 >         * admin          - gives administrator privileges    | ('A' flag)
527 >         * connect        - allows local CONNECT              | ('P' flag)
528 >         * connect:remote - allows remote CONNECT             | ('Q' flag)
529 >         * die            - allows DIE                        | ('D' flag)
530 >         * dline          - allows DLINE                      |
531 >         * gline          - allows GLINE                      | ('G' flag)
532 >         * globops        - allows GLOBOPS                    |
533 >         * kill           - allows to KILL local clients      | ('N' flag)
534 >         * kill:remote    - allows remote users to be /KILL'd | ('O' flag)
535 >         * kline          - allows KLINE                      | ('K' flag)
536 >         * locops         - allows LOCOPS                     |
537 >         * module         - allows MODULE                     |
538 >         * rehash         - allows oper to REHASH config      | ('H' flag)
539 >         * remoteban      - allows remote KLINE/UNKLINE       | ('B' flag)
540 >         * restart        - allows RESTART                    |
541 >         * set            - allows SET                        |
542 >         * squit          - allows local SQUIT                | ('R' flag)
543 >         * squit:remote   - allows remote SQUIT               | ('S' flag)
544 >         * undline        - allows UNDLINE                    |
545 >         * unkline        - allows UNKLINE                    | ('U' flag)
546 >         * unxline        - allows UNXLINE                    |
547 >         * wallops        - allows WALLOPS                    |
548 >         * xline          - allows XLINE                      | ('X' flag)
549           */
550 <        flags = kill, kill:remote, connect, connect:remote, kline, unkline,
551 <                xline, globops, restart, die, rehash, admin, operwall, module;
550 >        flags = admin, connect, connect:remote, die, globops, kill, kill:remote,
551 >                kline, module, rehash, restart, set, unkline, unxline, xline;
552   };
553  
554   /*
555 < * service {}: specifies what server may act as a network service
509 < *
510 < * NOTE: it is absolutely important that every single server on the network
511 < *       has the same service{} block.
512 < */
513 < service {
514 <        name = "service.someserver";
515 <        name = "stats.someserver";
516 < };
517 <
518 < /*
519 < * connect {}:  controls servers we connect to
555 > * connect {}: define a server to connect to
556   */
557   connect {
558 <        /* name: the name of the server */
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 >         * send_password, accept_password: the passwords to send and accept.
577 >         * The remote server will have these passwords swapped.
578           */
579          send_password = "password";
580          accept_password = "anotherpassword";
# Line 548 | Line 585 | connect {
585           */
586          encrypted = no;
587  
588 <        /* port: the port to connect to this server on */
588 >        /* port: the port to connect to this server on. */
589          port = 6666;
590  
591          /*
# Line 563 | Line 600 | connect {
600           */
601   #       leaf_mask = "*.uk";
602  
603 <        /* class: the class this server is in */
603 >        /* class: the class this server is in. */
604          class = "server";
605  
606          /*
607 <         * ssl_cipher_list:
608 <         *
609 <         * List of ciphers that the server we are connecting to must support.
573 <         * If the server isn't capable of any cipher listed below, the
574 <         * connection will simply be rejected.
607 >         * ssl_cipher_list: list of ciphers that the server we are connecting to
608 >         * must support. If the server is not capable of using any of the ciphers
609 >         * listed below, the connection will simply be rejected.
610           * Can be used to enforce stronger ciphers, even though this option
611           * is not necessarily required to establish a SSL/TLS connection.
612           *
613           * Multiple ciphers are separated by colons. The order of preference
614           * is from left to right.
615           */
616 <        #ssl_cipher_list = "DHE-RSA-AES256-SHA:AES256-SHA";
616 > #       ssl_cipher_list = "ECDHE-RSA-AES256-GCM-SHA384:DHE-RSA-AES256-GCM-SHA384:DHE-RSA-AES256-SHA:AES256-SHA";
617 >
618 >        /*
619 >         * ssl_certificate_fingerprint: enhances security by additionally checking
620 >         * the server's client certificate fingerprint against the specified
621 >         * fingerprint below.
622 >         */
623 > #       ssl_certificate_fingerprint = "4C62287BA6776A89CD4F8FF10A62FFB35E79319F51AF6C62C674984974FCCB1D";
624  
625          /*
626           * autoconn   - controls whether we autoconnect to this server or not,
# Line 609 | Line 651 | connect {
651   */
652   cluster {
653          /*
654 <         * name: the server to share with, this can take wildcards
654 >         * name: the server to share with; this can take wildcards
655           *
656 <         * NOTE: only local actions will be clustered, meaning if
656 >         * NOTE: only local actions will be clustered, meaning that if
657           *       the server receives a shared kline/unkline/etc, it
658           *       will not be propagated to clustered servers.
659           *
660           *       Remote servers are not necessarily required to accept
661 <         *       clustered lines, they need a shared{} for *THIS* server
662 <         *       in order to accept them.
661 >         *       clustered lines, they need a shared {} block for *THIS*
662 >         *       server in order to accept them.
663           */
664          name = "*.arpa";
665  
666          /*
667 <         * type: list of what to share, options are as follows:
667 >         * type: list of what to share; options are as follows:
668           *      dline   - share dlines
669           *      undline - share undlines
670           *      kline   - share klines
# Line 640 | Line 682 | cluster {
682   /*
683   * shared {}: users that are allowed to remote kline
684   *
685 < * NOTE: This can be effectively used for remote klines.
685 > * NOTE: This can effectively be used for remote klines.
686   *       Please note that there is no password authentication
687   *       for users setting remote klines. You must also be
688   *       /oper'd in order to issue a remote kline.
689   */
690   shared {
691          /*
692 <         * name: the server the user must be on to set klines. If this is not
693 <         * specified, the user will be allowed to kline from all servers.
692 >         * name: the server the user must be connected to in order to set klines.
693 >         * If this is not specified, the user will be allowed to kline from all
694 >         * servers.
695           */
696          name = "irc2.some.server";
697  
# Line 677 | Line 720 | shared {
720  
721   /*
722   * kill {}:  users that are not allowed to connect
723 < * Oper issued klines will be added to the specified kline config
723 > * Oper issued klines will be added to the specified kline database
724   */
725   kill {
726          user = "bad@*.hacked.edu";
# Line 685 | Line 728 | kill {
728   };
729  
730   /*
731 < * deny {}:  IPs that are not allowed to connect (before DNS/ident lookup)
732 < * Oper issued dlines will be added to the specified dline config
731 > * deny {}:  IP addresses that are not allowed to connect
732 > * (before DNS/ident lookup)
733 > * Oper issued dlines will be added to the specified dline database
734   */
735   deny {
736          ip = "10.0.1.0/24";
# Line 694 | Line 738 | deny {
738   };
739  
740   /*
741 < * exempt {}:  IPs that are exempt from deny {} and Dlines
741 > * exempt {}:  IP addresses that are exempt from deny {} and Dlines
742   */
743   exempt {
744          ip = "192.168.0.0/16";
# Line 704 | Line 748 | exempt {
748   * resv {}:  nicks and channels users may not use/join
749   */
750   resv { mask = "clone*"; reason = "Clone bots"; };
751 + resv { mask = "Global"; reason = "Reserved for services"; };
752   resv { mask = "ChanServ"; reason = "Reserved for services"; };
753   resv { mask = "NickServ"; reason = "Reserved for services"; };
754   resv { mask = "OperServ"; reason = "Reserved for services"; };
# Line 717 | Line 762 | resv { mask = "#*services*"; reason = "R
762   resv {
763          /*
764           * mask: masks starting with a '#' are automatically considered
765 <         * as channel name mask.
765 >         * as channel name masks.
766           */
767          mask = "#helsinki";
768 <        reason = "Channel is reserved for finnish inhabitants";
768 >        reason = "Channel is reserved for Finnish inhabitants";
769  
770          /*
771           * exempt: can be either a ISO 3166 alpha-2 two letter country
# Line 731 | Line 776 | resv {
776   };
777  
778   /*
779 < * gecos {}:  Used for banning users based on their "realname".
779 > * gecos {}:  used for banning users based on their "realname".
780   */
781   gecos {
782          name = "*sex*";
# Line 744 | Line 789 | gecos {
789   };
790  
791   /*
792 < * channel {}:  The channel block contains options pertaining to channels
792 > * service {}: specifies a server which may act as a network service
793 > *
794 > * NOTE: it is very important that every server on the network
795 > *       has the same service {} block.
796 > */
797 > service {
798 >        name = "service.someserver";
799 >        name = "stats.someserver";
800 > };
801 >
802 > /*
803 > * pseudo {}: adds pseudo/custom commands also known as service aliases
804 > */
805 > pseudo {
806 >        /* command: the actual command/alias */
807 >        command = "IDENTIFY";
808 >
809 >        /* prepend: optional text that can be prepended before the user's message */
810 >        prepend = "IDENTIFY ";
811 >
812 >        /* name: the service name, used for error messages */
813 >        name = "NickServ";
814 >
815 >        /* target: the actual target where this message should be sent to */
816 >        target = "NickServ@service.someserver";
817 > };
818 >
819 > pseudo {
820 >        command = "CHANSERV";
821 >        name = "ChanServ";
822 >        target = "ChanServ@service.someserver";
823 > };
824 >
825 > pseudo {
826 >        command = "CS";
827 >        name = "ChanServ";
828 >        target = "ChanServ@service.someserver";
829 > };
830 >
831 > pseudo {
832 >        command = "NICKSERV";
833 >        name = "NickServ";
834 >        target = "NickServ@service.someserver";
835 > };
836 >
837 > pseudo {
838 >        command = "NS";
839 >        name = "NickServ";
840 >        target = "NickServ@service.someserver";
841 > };
842 >
843 > pseudo {
844 >        command = "MEMOSERV";
845 >        name = "MemoServ";
846 >        target = "MemoServ@service.someserver";
847 > };
848 >
849 > pseudo {
850 >        command = "MS";
851 >        name = "MemoServ";
852 >        target = "MemoServ@service.someserver";
853 > };
854 >
855 > pseudo {
856 >        command = "OPERSERV";
857 >        name = "OperServ";
858 >        target = "OperServ@service.someserver";
859 > };
860 >
861 > pseudo {
862 >        command = "OS";
863 >        name = "OperServ";
864 >        target = "OperServ@service.someserver";
865 > };
866 >
867 > pseudo {
868 >        command = "HOSTSERV";
869 >        name = "HostServ";
870 >        target = "HostServ@service.someserver";
871 > };
872 >
873 > pseudo {
874 >        command = "HS";
875 >        name = "HostServ";
876 >        target = "HostServ@service.someserver";
877 > };
878 >
879 > pseudo {
880 >        command = "BOTSERV";
881 >        name = "BotServ";
882 >        target = "BotServ@service.someserver";
883 > };
884 >
885 > pseudo {
886 >        command = "BS";
887 >        name = "BotServ";
888 >        target = "BotServ@service.someserver";
889 > };
890 >
891 > /*
892 > * channel {}:  the channel block contains options pertaining to channels
893   */
894   channel {
895          /*
896           * disable_fake_channels: this option, if set to 'yes', will
897 <         * disallow clients to create or join channels that have one
897 >         * disallow clients from creating or joining channels that have one
898           * of the following ASCII characters in their name:
899           *
900           *   2 | bold
# Line 763 | Line 908 | channel {
908          disable_fake_channels = yes;
909  
910          /*
911 <         * knock_delay: The amount of time a user must wait between issuing
912 <         * the knock command.
911 >         * invite_client_count, invite_client_time: how many INVITE commands
912 >         * are permitted per client per invite_client_time.
913           */
914 <        knock_delay = 5 minutes;
914 >        invite_client_count = 10;
915 >        invite_client_time = 5 minutes;
916  
917          /*
918 <         * knock_delay_channel: How often a knock to any specific channel
919 <         * is permitted, regardless of the user sending the knock.
918 >         * knock_client_count, knock_client_time: how many KNOCK commands
919 >         * are permitted per client per knock_client_time.
920           */
921 <        knock_delay_channel = 1 minute;
921 >        knock_client_count = 1;
922 >        knock_client_time = 5 minutes;
923  
924          /*
925 <         * max_chans_per_user: The maximum number of channels a user can
926 <         * join/be on.
925 >         * knock_delay_channel: how often a KNOCK to any specific channel
926 >         * is permitted, regardless of the user sending the KNOCK.
927           */
928 <        max_chans_per_user = 25;
928 >        knock_delay_channel = 1 minute;
929  
930          /*
931 <         * max_chans_per_oper: The maximum number of channels an oper can
932 <         * join/be on.
931 >         * max_channels: the maximum number of channels a user can join/be on.
932 >         * This is a default value which can be overriden with class {} blocks.
933           */
934 <        max_chans_per_oper = 50;
934 >        max_channels = 25;
935  
936          /* max_bans: maximum number of +b/e/I modes in a channel */
937          max_bans = 100;
938  
939          /*
940 <         * how many joins in how many seconds constitute a flood, use 0 to
940 >         * how many joins in how many seconds constitute a flood. Use 0 to
941           * disable. +b opers will be notified (changeable via /set)
942           */
943          join_flood_count = 16;
944          join_flood_time = 8 seconds;
945  
946          /*
947 <         * splitcode: The ircd will now check splitmode every few seconds.
947 >         * The ircd will now check splitmode (whether a server is split from
948 >         * the network) every few seconds; this functionality is known as
949 >         * splitcode and is influenced by the options below.
950           *
951           * Either split users or split servers can activate splitmode, but
952           * both conditions must be met for the ircd to deactivate splitmode.
953 <         *
953 >         *
954           * You may force splitmode to be permanent by /quote set splitmode on
955           */
956  
# Line 817 | Line 966 | channel {
966           */
967          default_split_server_count = 0;
968  
969 <        /* no_create_on_split: disallow users creating channels on split. */
969 >        /* no_create_on_split: do not allow users to create channels on split. */
970          no_create_on_split = yes;
971  
972 <        /* no_join_on_split: disallow users joining channels at all on a split. */
972 >        /* no_join_on_split: do not allow users to join channels on a split. */
973          no_join_on_split = no;
974   };
975  
976   /*
977 < * serverhide {}:  The serverhide block contains the options regarding
978 < * serverhiding
977 > * serverhide {}:  the serverhide block contains the options regarding
978 > * to server hiding. For more information regarding server hiding,
979 > * please see doc/serverhide.txt
980   */
981   serverhide {
982          /*
983 +         * disable_remote_commands: disable users issuing commands
984 +         * on remote servers.
985 +         */
986 +        disable_remote_commands = no;
987 +
988 +        /*
989           * flatten_links: this option will show all servers in /links appear
990 <         * that they are linked to this current server.
990 >         * as though they are linked to this current server.
991           */
992          flatten_links = no;
993  
# Line 855 | Line 1011 | serverhide {
1011  
1012          /*
1013           * hide_services: define this if you want to hide the location of
1014 <         * services servers that are specified in the service{} block.
1014 >         * services servers that are specified in the service {} block.
1015           */
1016          hide_services = no;
1017  
1018          /*
1019 <         * Use this as the servername users see if hide_servers = yes.
1019 >         * hidden_name: use this as the servername users see if hide_servers = yes.
1020           */
1021          hidden_name = "*.hidden.com";
1022  
1023          /*
1024 <         * hide_server_ips: If this is disabled, opers will be unable to see
1025 <         * servers ips and will be shown a masked ip, admins will be shown the
1026 <         * real ip.
1027 <         *
1028 <         * If this is enabled, nobody can see a servers ip. *This is a kludge*,
1029 <         * it has the side effect of hiding the ips everywhere, including
1030 <         * logfiles.
1024 >         * hide_server_ips: if this is disabled, opers will be unable to see
1025 >         * servers' IP addresses and will be shown a masked IP address; admins
1026 >         * will be shown the real IP address.
1027 >         *
1028 >         * If this is enabled, nobody can see a server's IP address.
1029 >         * *This is a kludge*: it has the side effect of hiding the IP addresses
1030 >         * everywhere, including logfiles.
1031           *
1032           * We recommend you leave this disabled, and just take care with who you
1033           * give administrator privileges to.
# Line 880 | Line 1036 | serverhide {
1036   };
1037  
1038   /*
1039 < * general {}:  The general block contains many of the options that were once
1039 > * general {}:  the general block contains many of the options that were once
1040   * compiled in options in config.h
1041   */
1042   general {
1043 <        /* services_name: servername of nick/channel services */
1044 <        services_name = "service.someserver";
1043 >        /*
1044 >         * cycle_on_host_change: sends a fake QUIT/JOIN combination
1045 >         * when services change the hostname of a specific client.
1046 >         */
1047 >        cycle_on_host_change = yes;
1048  
1049          /* max_watch: maximum WATCH entries a client can have. */
1050 <        max_watch = 60;
1050 >        max_watch = 30;
1051 >
1052 >        /* max_accept: maximum allowed /accept's for +g usermode. */
1053 >        max_accept = 30;
1054  
1055 <        /* gline_enable: enable glines, network wide temp klines. */
1055 >        /* gline_enable: enable glines (network-wide temporary klines). */
1056          gline_enable = yes;
1057  
1058          /*
1059 <         * gline_duration: the amount of time a gline will remain on your
1059 >         * gline_duration: the amount of time a G-line will remain on your
1060           * server before expiring.
1061           */
1062          gline_duration = 1 day;
# Line 907 | Line 1069 | general {
1069  
1070          /*
1071           * gline_min_cidr: the minimum required length of a CIDR bitmask
1072 <         * for IPv4 based glines.
1072 >         * for IPv4 based G-lines.
1073           */
1074          gline_min_cidr = 16;
1075  
1076          /*
1077           * gline_min_cidr6: the minimum required length of a CIDR bitmask
1078 <         * for IPv6 based glines.
1078 >         * for IPv6 based G-lines.
1079           */
1080          gline_min_cidr6 = 48;
1081  
1082          /*
1083 <         * Whether to automatically set mode +i on connecting users.
1083 >         * invisible_on_connect: whether to automatically set mode +i on
1084 >         * connecting users.
1085           */
1086          invisible_on_connect = yes;
1087  
1088          /*
1089 <         * kill_chase_time_limit: maximum time from the nickname change that
1090 <         * still causes KILL automatically to switch for the current nick of
1091 <         * that user.
1089 >         * kill_chase_time_limit: KILL chasing is a feature whereby a KILL
1090 >         * issued for a user who has recently changed nickname will be applied
1091 >         * automatically to the new nick. kill_chase_time_limit is the maximum
1092 >         * time following a nickname change that this chasing will apply.
1093           */
1094 <        kill_chase_time_limit = 90 seconds;
1094 >        kill_chase_time_limit = 30 seconds;
1095  
1096          /*
1097 <         * hide_spoof_ips: if disabled, opers will be allowed to see the real
1098 <         * IP of spoofed users in /trace etc. If this is defined they will be
1099 <         * shown a masked IP.
936 <         */
937 <        hide_spoof_ips = yes;
938 <
939 <        /*
940 <         * Ignore bogus timestamps from other servers. Yes, this will desync the
941 <         * network, but it will allow chanops to resync with a valid non TS 0
1097 >         * ignore_bogus_ts: ignore bogus timestamps from other servers.
1098 >         * Yes, this will desync the network, but it will allow chanops
1099 >         * to resync with a valid non TS 0.
1100           *
1101           * This should be enabled network wide, or not at all.
1102           */
# Line 950 | Line 1108 | general {
1108           */
1109          disable_auth = no;
1110  
953        /* disable_remote_commands: disable users doing commands on remote servers. */
954        disable_remote_commands = no;
955
1111          /*
1112           * tkline_expire_notices: enables or disables temporary kline/xline
1113           * expire notices.
# Line 961 | Line 1116 | general {
1116  
1117          /*
1118           * default_floodcount: the default value of floodcount that is configurable
1119 <         * via /quote set floodcount. This is the amount of lines a user
1120 <         * may send to any other user/channel in one second.
1119 >         * via /quote set floodcount. This is the number of lines a user may send
1120 >         * to any other user/channel in one second.
1121           */
1122          default_floodcount = 10;
1123  
1124          /*
1125 <         * failed_oper_notice: send a notice to all opers on the server when
1125 >         * failed_oper_notice: send a notice to all opers on the server when
1126           * someone tries to OPER and uses the wrong password, host or ident.
1127           */
1128          failed_oper_notice = yes;
1129  
1130          /*
1131 <         * dots_in_ident: the amount of '.' characters permitted in an ident
1131 >         * dots_in_ident: the number of '.' characters permitted in an ident
1132           * reply before the user is rejected.
1133           */
1134          dots_in_ident = 2;
1135  
1136          /*
1137 <         * min_nonwildcard: the minimum non wildcard characters in k/d/g lines
1138 <         * placed via the server. K-lines hand placed are exempt from limits.
1139 <         * wildcard chars: '.' ':' '*' '?' '@' '!' '#'
1137 >         * min_nonwildcard: the minimum number of non-wildcard characters in
1138 >         * k/d/g lines placed via the server. K-lines hand-placed are exempt from
1139 >         * this limit.
1140 >         * Wildcard characters: '.', ':', '*', '?', '@', '!'
1141           */
1142          min_nonwildcard = 4;
1143  
1144          /*
1145 <         * min_nonwildcard_simple: the minimum non wildcard characters in
1146 <         * gecos bans. wildcard chars: '*' '?' '#'
1145 >         * min_nonwildcard_simple: the minimum number of non-wildcard characters
1146 >         * in gecos bans. Wildcard characters: '*', '?'
1147           */
1148          min_nonwildcard_simple = 3;
1149  
994        /* max_accept: maximum allowed /accept's for +g usermode. */
995        max_accept = 20;
996
1150          /* anti_nick_flood: enable the nickflood control code. */
1151          anti_nick_flood = yes;
1152  
1153 <        /* nick flood: the nick changes allowed in the specified period */
1153 >        /* nick flood: the number of nick changes allowed in the specified period. */
1154          max_nick_time = 20 seconds;
1155          max_nick_changes = 5;
1156  
1157          /*
1158 +         * away_count, away_time: how many AWAY command are permitted per
1159 +         * client per away_time.
1160 +         */
1161 +        away_count = 2;
1162 +        away_time = 10 seconds;
1163 +
1164 +        /*
1165           * anti_spam_exit_message_time: the minimum time a user must be connected
1166           * before custom quit messages are allowed.
1167           */
1168          anti_spam_exit_message_time = 5 minutes;
1169  
1170          /*
1171 <         * ts delta: the time delta allowed between server clocks before
1172 <         * a warning is given, or before the link is dropped. All servers
1173 <         * should run ntpdate/rdate to keep clocks in sync
1171 >         * ts_warn_delta, ts_max_delta: the time delta allowed between server
1172 >         * clocks before a warning is given, or before the link is dropped.
1173 >         * All servers should run ntpdate/rdate to keep clocks in sync.
1174           */
1175 <        ts_warn_delta = 30 seconds;
1176 <        ts_max_delta = 5 minutes;
1175 >        ts_warn_delta = 3 seconds;
1176 >        ts_max_delta = 15 seconds;
1177  
1178          /*
1179 <         * warn_no_nline: warn opers about servers that try to connect but
1180 <         * we don't have a connect {} block for. Twits with misconfigured
1181 <         * servers can get really annoying with this enabled.
1179 >         * warn_no_connect_block: warn opers about servers that try to connect
1180 >         * but for which we don't have a connect {} block. Twits with
1181 >         * misconfigured servers can become really annoying with this enabled.
1182           */
1183 <        warn_no_nline = yes;
1183 >        warn_no_connect_block = yes;
1184  
1185          /*
1186           * stats_e_disabled: set this to 'yes' to disable "STATS e" for both
1187           * operators and administrators. Doing so is a good idea in case
1188 <         * there are any exempted (exempt{}) server IPs you don't want to
1188 >         * there are any exempted (exempt {}) server IPs you don't want to
1189           * see leaked.
1190           */
1191          stats_e_disabled = no;
1192  
1193 <        /* stats_o_oper only: make stats o (opers) oper only */
1193 >        /* stats_o_oper_only: make stats o (opers) oper only. */
1194          stats_o_oper_only = yes;
1195  
1196 <        /* stats_P_oper_only: make stats P (ports) oper only */
1196 >        /* stats_P_oper_only: make stats P (ports) oper only. */
1197          stats_P_oper_only = yes;
1198  
1199 +        /* stats_u_oper_only: make stats u (uptime) oper only. */
1200 +        stats_u_oper_only = no;
1201 +
1202          /*
1203 <         * stats i oper only: make stats i (auth {}) oper only. Set to:
1204 <         *     yes    - show users no auth blocks, made oper only.
1205 <         *     masked - show users first matching auth block
1206 <         *     no     - show users all auth blocks.
1203 >         * stats_i_oper_only: make stats i (auth {}) oper only. Set to:
1204 >         *     yes    - show users no auth {} blocks, made oper only
1205 >         *     masked - show users the first matching auth {} block
1206 >         *     no     - show users all auth {} blocks
1207           */
1208          stats_i_oper_only = yes;
1209  
1210          /*
1211           * stats_k_oper_only: make stats k/K (klines) oper only. Set to:
1212 <         *     yes    - show users no auth blocks, made oper only
1213 <         *     masked - show users first matching auth block
1214 <         *     no     - show users all auth blocks.
1212 >         *     yes    - show users no auth {} blocks, made oper only
1213 >         *     masked - show users the first matching auth {} block
1214 >         *     no     - show users all auth {} blocks
1215           */
1216          stats_k_oper_only = yes;
1217  
# Line 1060 | Line 1223 | general {
1223  
1224          /*
1225           * opers_bypass_callerid: allows operators to bypass +g and message
1226 <         * anyone who has it set (useful if you use services).
1226 >         * anyone who has it set.
1227           */
1228          opers_bypass_callerid = no;
1229  
1230          /*
1231 <         * pace_wait_simple: time between use of less intensive commands
1232 <         * (ADMIN, HELP, (L)USERS, VERSION, remote WHOIS)
1231 >         * pace_wait_simple: minimum time required between use of less
1232 >         * intensive commands
1233 >         * (ADMIN, HELP, LUSERS, VERSION, remote WHOIS)
1234           */
1235          pace_wait_simple = 1 second;
1236  
1237          /*
1238 <         * pace_wait: time between more intensive commands
1239 <         * (AWAY, INFO, LINKS, MAP, MOTD, STATS, WHO, wildcard WHOIS, WHOWAS)
1238 >         * pace_wait: minimum time required between use of more intensive commands
1239 >         * (INFO, LINKS, MAP, MOTD, STATS, WHO, WHOWAS)
1240           */
1241          pace_wait = 10 seconds;
1242  
1243          /*
1244 <         * short_motd: send clients a notice telling them to read the motd
1245 <         * instead of forcing a motd to clients who may simply ignore it.
1244 >         * short_motd: send clients a notice telling them to read the MOTD
1245 >         * instead of forcing an MOTD to clients who may simply ignore it.
1246           */
1247          short_motd = no;
1248  
1249          /*
1250 <         * ping_cookie: require clients to respond exactly to a ping command,
1250 >         * ping_cookie: require clients to respond exactly to a PING command,
1251           * can help block certain types of drones and FTP PASV mode spoofing.
1252           */
1253          ping_cookie = no;
# Line 1093 | Line 1257 | general {
1257  
1258          /*
1259           * true_no_oper_flood: completely eliminate flood limits for opers
1260 <         * and for clients with can_flood = yes in their auth {} blocks.
1260 >         * and for clients with 'can_flood' in their auth {} blocks.
1261           */
1262          true_no_oper_flood = yes;
1263  
1264          /* oper_pass_resv: allow opers to over-ride RESVs on nicks/channels. */
1265          oper_pass_resv = yes;
1266  
1267 <        /* REMOVE ME.  The following line checks you've been reading. */
1267 >        /* REMOVE ME. The following line checks that you have been reading. */
1268          havent_read_conf = 1;
1269  
1270          /*
1271 <         * max_targets: the maximum amount of targets in a single
1271 >         * max_targets: the maximum number of targets in a single
1272           * PRIVMSG/NOTICE. Set to 999 NOT 0 for unlimited.
1273           */
1274          max_targets = 4;
# Line 1114 | Line 1278 | general {
1278           *
1279           * +b - bots         - See bot and drone flooding notices
1280           * +c - cconn        - Client connection/quit notices
1117         * +C - cconn_full   - Client connection/quit notices full
1281           * +D - deaf         - Don't receive channel messages
1282           * +d - debug        - See debugging notices
1283           * +e - external     - See remote server connection and split notices
1284           * +F - farconnect   - Remote client connection/quit notices
1285 <         * +f - full         - See auth{} block full notices
1285 >         * +f - full         - See auth {} block full notices
1286           * +G - softcallerid - Server Side Ignore for users not on your channels
1287           * +g - callerid     - Server Side Ignore (for privmsgs etc)
1288           * +H - hidden       - Hides operator status to other users
1289 <         * +i - invisible    - Not shown in NAMES or WHO unless you share a
1127 <         *                     a channel
1289 >         * +i - invisible    - Not shown in NAMES or WHO unless you share a channel
1290           * +j - rej          - See rejected client notices
1291           * +k - skill        - See server generated KILL messages
1292           * +l - locops       - See LOCOPS messages
1293           * +n - nchange      - See client nick changes
1294 +         * +p - hidechans    - Hides channel list in WHOIS
1295 +         * +q - hideidle     - Hides idle and signon time in WHOIS
1296           * +R - nononreg     - Only receive private messages from registered clients
1297           * +s - servnotice   - See general server notices
1298           * +u - unauth       - See unauthorized client notices
1299           * +w - wallop       - See server generated WALLOPS
1300           * +y - spy          - See LINKS, STATS, TRACE notices etc.
1137         * +z - operwall     - See oper generated WALLOPS
1301           */
1302  
1303 <        /* oper_only_umodes: usermodes only opers may set */
1304 <        oper_only_umodes = bots, cconn, cconn_full, debug, full, hidden, skill,
1305 <                           nchange, rej, spy, external, operwall,
1143 <                           locops, unauth, farconnect;
1303 >        /* oper_only_umodes: usermodes only operators may set. */
1304 >        oper_only_umodes = bots, cconn, debug, external, farconnect, full, hidden, locops,
1305 >                        nchange, rej, skill, spy, unauth;
1306  
1307 <        /* oper_umodes: default usermodes opers get when they /oper */
1308 <        oper_umodes = bots, locops, servnotice, operwall, wallop;
1307 >        /* oper_umodes: default usermodes operators get when they /oper or /challenge. */
1308 >        oper_umodes = bots, locops, servnotice, wallop;
1309  
1310          /*
1311 <         * use_egd: if your system does not have *random devices yet you
1312 <         * want to use OpenSSL and encrypted links, enable this. Beware -
1151 <         * EGD is *very* CPU intensive when gathering data for its pool.
1311 >         * throttle_count: the maximum number of connections from the same
1312 >         * IP address allowed in throttle_time duration.
1313           */
1314 < #       use_egd = yes;
1314 >        throttle_count = 1;
1315  
1316          /*
1317 <         * egdpool_path: path to EGD pool. Not necessary for OpenSSL >= 0.9.7
1318 <         * which automatically finds the path.
1319 <         */
1159 < #       egdpool_path = "/var/run/egd-pool";
1160 <
1161 <        /*
1162 <         * throttle_time: the minimum amount of time between connections from
1163 <         * the same ip. exempt {} blocks are excluded from this throttling.
1317 >         * throttle_time: the minimum amount of time required between
1318 >         * connections from the same IP address. exempt {} blocks are
1319 >         * excluded from this throttling.
1320           * Offers protection against flooders who reconnect quickly.
1321           * Set to 0 to disable.
1322           */
1323 <        throttle_time = 10;
1323 >        throttle_time = 2 seconds;
1324   };
1325  
1326   modules {
# Line 1172 | Line 1328 | modules {
1328           * path: other paths to search for modules specified below
1329           * and in "/module load".
1330           */
1331 <        path = "/usr/local/ircd/lib/ircd-hybrid/modules";
1332 <        path = "/usr/local/ircd/lib/ircd-hybrid/modules/autoload";
1331 >        path = "lib/ircd-hybrid/modules";
1332 >        path = "lib/ircd-hybrid/modules/autoload";
1333  
1334          /* module: the name of a module to load on startup/rehash. */
1335 <        #module = "some_module.la";
1335 > #       module = "some_module.la";
1336   };
1337  
1338   /*
# Line 1188 | Line 1344 | log {
1344  
1345          file {
1346                  type = oper;
1347 <                name = "/home/ircd/var/log/oper.log";
1347 >                name = "var/log/oper.log";
1348                  size = unlimited;
1349          };
1350  
1351          file {
1352                  type = user;
1353 <                name = "/home/ircd/var/log/user.log";
1353 >                name = "var/log/user.log";
1354                  size = 50 megabytes;
1355          };
1356  
1357          file {
1358                  type = kill;
1359 <                name = "/home/ircd/var/log/kill.log";
1359 >                name = "var/log/kill.log";
1360                  size = 50 megabytes;
1361          };
1362  
1363          file {
1364                  type = kline;
1365 <                name = "/home/ircd/var/log/kline.log";
1365 >                name = "var/log/kline.log";
1366                  size = 50 megabytes;
1367          };
1368  
1369          file {
1370                  type = dline;
1371 <                name = "/home/ircd/var/log/dline.log";
1371 >                name = "var/log/dline.log";
1372                  size = 50 megabytes;
1373          };
1374  
1375          file {
1376                  type = gline;
1377 <                name = "/home/ircd/var/log/gline.log";
1377 >                name = "var/log/gline.log";
1378 >                size = 50 megabytes;
1379 >        };
1380 >
1381 >        file {
1382 >                type = xline;
1383 >                name = "var/log/xline.log";
1384 >                size = 50 megabytes;
1385 >        };
1386 >
1387 >        file {
1388 >                type = resv;
1389 >                name = "var/log/resv.log";
1390                  size = 50 megabytes;
1391          };
1392  
1393          file {
1394                  type = debug;
1395 <                name = "/home/ircd/var/log/debug.log";
1395 >                name = "var/log/debug.log";
1396                  size = 50 megabytes;
1397          };
1398   };

Diff Legend

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