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-8/doc/example.conf (file contents), Revision 1534 by michael, Sun Sep 23 13:17:14 2012 UTC vs.
ircd-hybrid/trunk/doc/reference.conf (file contents), Revision 6488 by michael, Fri Sep 4 17:56:25 2015 UTC

# Line 1 | Line 1
1 < /* doc/example.conf - ircd-hybrid-8 Example configuration file
2 < * Copyright (C) 2000-2012 Hybrid Development Team
1 > /*
2 > * This is an example configuration file for ircd-hybrid
3   *
4 < * Written by ejb, wcampbel, db, leeh and others
5 < * Other example configurations can be found in the source dir under
6 < * doc/.
4 > * Copyright (c) 2000-2015 ircd-hybrid development team
5   *
6   * $Id$
7   */
8  
9 < /* IMPORTANT NOTES:
9 > /*
10 > * ########################################################################
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   *
18   * Shell style (#), C++ style (//) and C style comments are supported.
19   *
# Line 22 | Line 23
23   *
24   * Times/durations are written as:
25   *        12 hours 30 minutes 1 second
26 < *        
26 > *
27   * Valid units of time:
28 < *        month, week, day, hour, minute, second
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.  
33 < */
34 <
35 < /* EFNET NOTE:
36 < *
37 < * This config file is NOT suitable for EFNet.  EFNet admins should use
38 < * example.efnet.conf
33 > * Sizes and times may be singular or plural.
34   */
35 <
35 >
36 >
37   /*
38   * serverinfo {}:  contains information about the server
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 <         * NOTE: The letters must be capitalized.  This cannot be changed at runtime.
50 >         *
51 >         * NOTE: The letters must be capitalized. This cannot be changed at runtime.
52 >         *
53 >         * If no sid is configured, one will be generated at runtime.
54           */
55 <        sid = "_CHANGE_ME_";
55 > #       sid = "0HY";
56  
57          /*
58           * description: the description of the server.
# Line 61 | Line 60 | serverinfo {
60          description = "ircd-hybrid test server";
61  
62          /*
63 <         * network info: the name and description of the network this server
64 <         * is on.  Shown in the 005 reply and used with serverhiding.
63 >         * network_name, network_desc: the name and description of the network this
64 >         * server is on. Shown in the 005 reply and used with serverhiding.
65           */
66          network_name = "MyNet";
67          network_desc = "This is My Network";
# Line 74 | Line 73 | serverinfo {
73          hub = no;
74  
75          /*
76 <         * vhost: the IP to bind to when we connect outward to ipv4 servers.
77 <         * This should be an ipv4 IP only, or "*" for INADDR_ANY.
76 >         * vhost: the IP address to bind to when we connect outward to IPv4 servers.
77 >         * This should be an IPv4 address, or "*" for INADDR_ANY.
78 >         */
79 > #       vhost = "192.169.0.1";
80 >
81 >        /*
82 >         * vhost6: the IP address to bind to when we connect outward to IPv6 servers.
83 >         * This should be an IPv6 address, or "*" for in6addr_any.
84           */
85 <        #vhost = "192.169.0.1";
85 > #       vhost6 = "3ffe:80e8:546::2";
86  
87          /*
88 <         * vhost6: the IP to bind to when we connect outward to ipv6 servers.
89 <         * This should be an ipv6 IP only, or "*" for INADDR_ANY.
88 >         * default_max_clients: the default maximum number of clients allowed
89 >         * to connect. This can be changed from within IRC via /QUOTE SET MAX.
90           */
91 <        #vhost6 = "3ffe:80e8:546::2";
91 >        default_max_clients = 512;
92  
93 <        /* max_clients: the maximum number of clients allowed to connect */
94 <        max_clients = 512;
93 >        /*
94 >         * max_nick_length: only applies to local clients. Must be in the
95 >         * range of 9 to 30. Default is 9 if nothing else is specified.
96 >         */
97 >        max_nick_length = 9;
98 >
99 >        /*
100 >         * max_topic_length: only applies to topics set by local clients.
101 >         * Must be in the range of 80 to 300. Default is 80 if nothing
102 >         * else is specified.
103 >         */
104 >        max_topic_length = 160;
105  
106          /*
107 <         * rsa_private_key_file: the path to the file containing our
108 <         * rsa key for cryptlink.
107 >         * rsa_private_key_file: the path to the file containing the
108 >         * RSA key.
109 >         *
110 >         * Example commands to store a 2048 bit RSA key in rsa.key:
111           *
95         * Example command to store a 2048 bit RSA keypair in
96         * rsa.key, and the public key in rsa.pub:
97         *
112           *      openssl genrsa -out rsa.key 2048
113 <         *      openssl rsa -in rsa.key -pubout -out rsa.pub
100 <         *      chown <ircd-user>.<ircd.group> rsa.key rsa.pub
113 >         *      chown <ircd-user>.<ircd.group> rsa.key
114           *      chmod 0600 rsa.key
102         *      chmod 0644 rsa.pub
115           */
116 <        #rsa_private_key_file = "/usr/local/ircd/etc/rsa.key";
116 > #       rsa_private_key_file = "etc/rsa.key";
117  
118          /*
119           * ssl_certificate_file: the path to the file containing our
120 <         * ssl certificate for encrypted client connection.
120 >         * SSL certificate for encrypted client connection.
121           *
122           * This assumes your private RSA key is stored in rsa.key. You
123 <         * MUST have an RSA key in order to generate the certificate
123 >         * MUST have an RSA key in order to generate the certificate.
124 >         *
125 >         * Example command:
126           *
127           *      openssl req -new -days 365 -x509 -key rsa.key -out cert.pem
128           *
# Line 121 | Line 135 | serverinfo {
135           *      Common Name: irc.someirc.net
136           *      E-mail: you@domain.com
137           */
138 <        #ssl_certificate_file = "/usr/local/ircd/etc/cert.pem";
138 > #       ssl_certificate_file = "etc/cert.pem";
139  
140          /*
141 <         * ssl_dh_param_file:
142 <         *
143 <         * Path to the PEM encoded Diffie-Hellman parameter file.
130 <         * DH parameters are strictly required when using ciphers
131 <         * with EDH (ephemeral Diffie-Hellman) key exchange.
141 >         * ssl_dh_param_file: path to the PEM encoded Diffie-Hellman
142 >         * parameter file. DH parameters are required when using
143 >         * ciphers with EDH (ephemeral Diffie-Hellman) key exchange.
144           *
145           * A DH parameter file can be created by running:
146           *
147 <         *      openssl dhparam -out dhparam.pem 1024
147 >         *      openssl dhparam -out dhparam.pem 2048
148           *
149           * Prime size must be at least 1024 bits. Further information
150           * regarding specific OpenSSL dhparam command-line options
151           * can be found in the OpenSSL manual.
152           */
153 <        #ssl_dh_param_file = "/usr/local/ircd/etc/dhparam.pem";
153 > #       ssl_dh_param_file = "etc/dhparam.pem";
154 >
155 >        /*
156 >         * ssl_dh_elliptic_curve: defines the curve to use for the
157 >         * Elliptic Curve Diffie-Hellman (ECDH) algorithm.
158 >         * Default is ANSI X9.62 prime256v1/secp256r1 if nothing else is specified.
159 >         *
160 >         * A list of supported curves by OpenSSL can be obtained by running:
161 >         *
162 >         *      openssl ecparam -list_curves
163 >         */
164 > #       ssl_dh_elliptic_curve = "secp521r1";
165  
166          /*
167 <         * ssl_cipher_list:
167 >         * ssl_cipher_list: list of ciphers to support on _this_ server.
168 >         * Can be used to enforce specific ciphers for incoming SSL/TLS
169 >         * connections. If a client (which also includes incoming server connections)
170 >         * is not capable of using any of the ciphers listed here, the connection will
171 >         * simply be rejected.
172           *
173 <         * List of ciphers that are supported by _this_ server. Can be used to
147 <         * enforce specific ciphers for incoming SSL/TLS connections.
148 <         * If a client (which also includes incoming server connections) isn't
149 <         * capable of any cipher listed below, the connection will simply be
150 <         * rejected.
151 <         * A list of supported ciphers can be obtained by running:
173 >         * A list of supported ciphers by OpenSSL can be obtained by running:
174           *
175 <         *      openssl ciphers -ssl3 -tls1 -v
175 >         *      openssl ciphers -tls1 -v
176           *
177           * Multiple ciphers are separated by colons. The order of preference is
178           * from left to right.
179           */
180 <        #ssl_cipher_list = "DHE-RSA-AES256-SHA:AES256-SHA";
180 > #       ssl_cipher_list = "ECDHE-RSA-AES256-GCM-SHA384:DHE-RSA-AES256-GCM-SHA384:DHE-RSA-AES256-SHA:AES256-SHA";
181  
182          /*
183 <         * ssl_server_method:
184 <         * ssl_client_method:
183 >         * ssl_message_digest_algorithm: defines what cryptographic hash function
184 >         * to use for generating fingerprint hashes of X.509 certificates.
185 >         * Default is SHA-256 if nothing else is specified.
186 >         *
187 >         * A list of supported message digest algorithms by OpenSSL can be obtained by running:
188           *
189 <         * SSL/TLS methods we provide for incoming (server method) and
165 <         * outgoing (client method) SSL/TLS connections.
166 <         * This can be either sslv3 for SSLv3, and/or tlsv1 for TLSv1.
189 >         *      openssl list-message-digest-algorithms
190           */
191 <        #ssl_server_method = tlsv1, sslv3;
169 <        #ssl_client_method = tlsv1;
191 > #       ssl_message_digest_algorithm = "sha256";
192   };
193  
194   /*
195 < * admin {}:  contains admin information about the server
195 > * admin {}:  contains administrative information about the server
196   */
197   admin {
198          name = "Smurf target";
# Line 182 | Line 204 | admin {
204   * class {}:  contains information about classes for users
205   */
206   class {
207 <        /* name: the name of the class */
207 >        /* name: the name of the class. */
208          name = "users";
209  
210          /*
# Line 193 | Line 215 | class {
215  
216          /*
217           * number_per_ip: how many local users are allowed to connect
218 <         * from one IP  (optional)
218 >         * from a single IP address (optional)
219           */
220          number_per_ip = 2;
221  
222          /*
223           * max_local: how many local users are allowed to connect
224 <         * from one ident@host  (optional)
224 >         * from a single ident@host (optional)
225           */
226          max_local = 2;
227  
228          /*
229 <         * max_global: network-wide limit of users per ident@host  (optional)
229 >         * max_global: network-wide limit of users per ident@host (optional)
230           */
231          max_global = 10;
232  
# Line 214 | Line 236 | class {
236          max_number = 100;
237  
238          /*
239 <         * the following lines are optional and allow you to define
240 <         * how many users can connect from one /NN subnet
239 >         * The following lines are optional and allow you to define
240 >         * how many users can connect from one /NN subnet.
241           */
242          cidr_bitlen_ipv4 = 24;
243          cidr_bitlen_ipv6 = 120;
244          number_per_cidr = 16;
245  
246          /*
247 <         * sendq: the amount of data allowed in a clients queue before
247 >         * sendq: the amount of data allowed in a client's send queue before
248           * they are dropped.
249           */
250          sendq = 100 kbytes;
251  
252          /*
253 <         * recvq: maximum amount of data in a clients queue before they
254 <         * are dropped for flooding. Defaults to 2560 if the chosen
255 <         * value isn't within the range of 512 to 8000.
253 >         * recvq: the amount of data allowed in a client's receive queue before
254 >         * they are dropped for flooding. Defaults to 2560 if the chosen value
255 >         * isn't within the range of 512 to 8000.
256           */
257          recvq = 2560 bytes;
258   };
# Line 241 | Line 263 | class {
263          number_per_ip = 10;
264          max_number = 100;
265          sendq = 100 kbytes;
266 +
267 +        /*
268 +         * max_channels: maximum number of channels users in this class can join.
269 +         */
270 +        max_channels = 60;
271 +
272 +        /*
273 +         * min_idle: minimum idle time that is shown in /whois.
274 +         */
275 +        min_idle = 3 hours;
276 +
277 +        /*
278 +         * max_idle: maximum idle time that is shown in /whois.
279 +         */
280 +        max_idle = 8 hours;
281 +
282 +        /*
283 +         * flags:
284 +         *
285 +         * random_idle          - a fake idle time is set randomly between
286 +         *                        min_idle and max_idle
287 +         * hide_idle_from_opers - the fake idle time will also be shown to operators
288 +         */
289 +        flags = random_idle, hide_idle_from_opers;
290   };
291  
292   class {
# Line 248 | Line 294 | class {
294          ping_time = 90 seconds;
295  
296          /*
297 <         * ping_warning: how fast a server must reply to a PING before
252 <         * a warning to opers is generated.
253 <         */
254 <        ping_warning = 15 seconds;
255 <
256 <        /*
257 <         * connectfreq: only used in server classes.  Specifies the delay
297 >         * connectfreq: only used in server classes. Specifies the delay
298           * between autoconnecting to servers.
299           */
300          connectfreq = 5 minutes;
301  
302 <        /* max number: the amount of servers to autoconnect to */
302 >        /* max number: the number of servers to autoconnect to. */
303          max_number = 1;
304  
305 <        /* sendq: servers need a higher sendq as they send more data */
305 >        /* sendq: servers need a higher sendq as they send more data. */
306          sendq = 2 megabytes;
307   };
308  
309   /*
310 + * motd {}: Allows the display of a different MOTD to a client
311 + * depending on its origin. Applies to local users only.
312 + */
313 + motd {
314 +        /*
315 +         * mask: multiple mask entries are permitted. Mask can either be
316 +         * a class name or a hostname. CIDR is supported.
317 +         */
318 +        mask = "*.at";
319 +        mask = "*.de";
320 +        mask = "*.ch";
321 +
322 +        /*
323 +         * file: path to the actual motd file.
324 +         */
325 +        file = "etc/german.motd";
326 + };
327 +
328 + /*
329   * listen {}:  contains information about the ports ircd listens on
330   */
331   listen {
332          /*
333 <         * port: the specific port to listen on.  If no host is specified
334 <         * before, it will listen on all available IPs.
333 >         * port: the port to listen on. If no host is specified earlier in the
334 >         * listen {} block, it will listen on all available IP addresses.
335           *
336 <         * Ports are separated via a comma, a range may be specified using ".."
336 >         * Ports are separated by commas; a range may be specified using ".."
337           */
338 <        
339 <        /* port: listen on all available IPs, ports 6665 to 6669 */
338 >
339 >        /* port: listen on all available IP addresses, ports 6665 to 6669. */
340          port = 6665 .. 6669;
341  
342          /*
343 <         * Listen on 192.168.0.1/6697 with ssl enabled and hidden from STATS P
343 >         * Listen on 192.168.0.1/6697 with SSL enabled and hidden from STATS P
344           * unless you are an administrator.
345           *
346 <         * NOTE: The "flags" directive has to come before "port".  Always!
346 >         * NOTE: The "flags" directive always has to come before "port".
347           *
348           * Currently available flags are:
349           *
350 <         *  ssl    - Port is for SSL client connections only
350 >         *  ssl    - Port may only accept TLS/SSL connections
351           *  server - Only server connections are permitted
352           *  hidden - Port is hidden from /stats P, unless you're an admin
353           */
# Line 297 | Line 356 | listen {
356          port = 6697;
357  
358          /*
359 <         * host: set a specific IP/host the ports after the line will listen
360 <         * on.  This may be ipv4 or ipv6.
359 >         * host: set a specific IP address to listen on using the
360 >         * subsequent port definitions. This may be IPv4 or IPv6.
361           */
362          host = "1.2.3.4";
363          port = 7000, 7001;
# Line 312 | Line 371 | listen {
371   */
372   auth {
373          /*
374 <         * user: the user@host allowed to connect.  Multiple IPv4/IPv6 user
375 <         * lines are permitted per auth block.
374 >         * user: the user@host allowed to connect. Multiple user
375 >         * lines are permitted within each auth {} block.
376           */
377          user = "*@172.16.0.0/12";
378          user = "*test@123D:B567:*";
379  
380 <        /* password: an optional password that is required to use this block */
380 >        /* password: an optional password that is required to use this block. */
381          password = "letmein";
382  
383          /*
384           * encrypted: controls whether the auth password above has been
385 <         * encrypted.
385 >         * encrypted. Default is 'no' if nothing else is specified.
386           */
387          encrypted = yes;
388  
389          /*
390 <         * spoof: fake the users host to this.  This is free-form,
391 <         * just do everyone a favor and don't abuse it. ('=' prefix on /stats I)
390 >         * spoof: fake the user's host to this. This is free-form, just do
391 >         * everyone a favor and don't abuse it. ('=' prefix on /stats I)
392           */
393          spoof = "I.still.hate.packets";
394  
395 <        /* class: the class the user is placed in */
395 >        /* class: the class the user is placed in. */
396          class = "opers";
397  
398          /*
399 <         * need_password - don't allow users who haven't supplied the correct
400 <         *                 password to connect using another auth{} block
401 <         *                 ('&' prefix on /stats I if disabled)
343 <         * need_ident    - require the user to have identd to connect ('+' prefix on /stats I)
399 >         * need_password - don't allow users who haven't supplied the correct  | ('&' prefix on /stats I if disabled)
400 >         *                 password to connect using another auth {} block
401 >         * need_ident    - require the user to have identd to connect          | ('+' prefix on /stats I)
402           * spoof_notice  - enable spoofing notification to admins
403 <         * exceed_limit  - allow a user to exceed class limits ('>' prefix on /stats I)
404 <         * kline_exempt  - exempt this user from k/glines ('^' prefix on /stats I)
405 <         * gline_exempt  - exempt this user from glines ('_' prefix on /stats I)
406 <         * resv_exempt   - exempt this user from resvs ('$' prefix on /stats I)
407 <         * no_tilde      - remove ~ from a user with no ident ('-' prefix on /stats I)
408 <         * can_flood     - allow this user to exceed flood limits ('|' prefix on /stats I)
403 >         * exceed_limit  - allow a user to exceed class limits                 | ('>' prefix on /stats I)
404 >         * kline_exempt  - exempt this user from k-lines                       | ('^' prefix on /stats I)
405 >         * xline_exempt  - exempt this user from x-lines                       | ('!' prefix on /stats I)
406 >         * resv_exempt   - exempt this user from resvs                         | ('$' prefix on /stats I)
407 >         * no_tilde      - remove ~ from a user with no ident                  | ('-' prefix on /stats I)
408 >         * can_flood     - allow this user to exceed flood limits              | ('|' prefix on /stats I)
409 >         * webirc        - enables WEBIRC authentication for web-based         | ('<' prefix on /stats I)
410 >         *                 clients such as Mibbit
411           */
412          flags = need_password, spoof_notice, exceed_limit, kline_exempt,
413 <                gline_exempt, resv_exempt, no_tilde, can_flood;
413 >                xline_exempt, resv_exempt, no_tilde, can_flood;
414   };
415  
416   auth {
417          /*
418 <         * redirect: the server and port to redirect a user to.  A user does
419 <         * not have to obey the redirection, the ircd just suggests an alternative
420 <         * server for them.
418 >         * redirserv, redirport: the server and port to redirect a user to.
419 >         * A user does not have to obey the redirection; the ircd just
420 >         * suggests an alternative server for them.
421           */
422 <        redirserv = "this.is.not.a.real.server";
422 >        redirserv = "server.tld";
423          redirport = 6667;
364        
365        user = "*.server";
424  
425 <        /* class: a class is required even though it is not used */
425 >        user = "*@*.tld";
426 >
427 >        /* class: a class is required even though it is not used. */
428          class = "users";
429   };
430  
# Line 376 | Line 436 | auth {
436  
437   /*
438   * operator {}:  defines ircd operators
379 *
380 * ircd-hybrid no longer supports local operators, privileges are
381 * controlled via flags.
439   */
440   operator {
441 <        /* name: the name of the oper */
442 <        name = "god";
441 >        /* name: the name of the operator */
442 >        name = "sheep";
443  
444          /*
445 <         * user: the user@host required for this operator. Multiple
446 <         * user="" lines are supported.
445 >         * user: the user@host required for this operator. Multiple user
446 >         * lines are permitted within each operator {} block.
447           */
448 <        user = "*god@192.168.0.0/16";
448 >        user = "*sheep@192.168.0.0/16";
449          user = "*@127.0.0.0/8";
450  
451          /*
452 <         * password: the password required to oper.  By default this will
452 >         * password: the password required to oper. By default this will
453           * need to be encrypted by using the provided mkpasswd tool.
454           * Several password hash algorithms are available depending
455           * on your system's crypt() implementation. For example, a modern
456 <         * glibc already has support for SHA-256/512, and MD5 encryption
456 >         * glibc already has support for the SHA-256/512 and MD5 encryption
457           * algorithms.
458           */
459          password = "$5$x5zof8qe.Yc7/bPp$5zIg1Le2Lsgd4CvOjaD20pr5PmcfD7ha/9b2.TaUyG4";
460  
461          /*
462           * encrypted: controls whether the oper password above has been
463 <         * encrypted.
463 >         * encrypted. Default is 'yes' if nothing else is specified.
464           */
465          encrypted = yes;
466  
467          /*
468 <         * rsa_public_key_file: the public key for this oper when using Challenge.
469 <         * A password should not be defined when this is used, see
468 >         * whois: allows to override the default RPL_WHOISOPERATOR numeric
469 >         * string shown in /whois.
470 >         * This string is propagated to all servers on the network.
471 >         */
472 > #       whois = "is a Smurf Target (IRC Operator)";
473 >
474 >        /*
475 >         * rsa_public_key_file: the public key for this oper when using /challenge.
476 >         * A password should not be defined when this is used; see
477           * doc/challenge.txt for more information.
478           */
479 < #       rsa_public_key_file = "/usr/local/ircd/etc/oper.pub";
479 > #       rsa_public_key_file = "etc/oper.pub";
480 >
481 >        /*
482 >         * ssl_certificate_fingerprint: enhances security by additionally checking
483 >         * the oper's client certificate fingerprint against the specified
484 >         * fingerprint below.
485 >         *
486 >         * Hint: your users can use the following command to obtain a SHA-256 hash
487 >         * of their ssl certificate:
488 >         *
489 >         *      openssl x509 -sha256 -noout -fingerprint -in cert.pem | sed -e 's/^.*=//;s/://g'
490 >         */
491 > #       ssl_certificate_fingerprint = "4C62287BA6776A89CD4F8FF10A62FFB35E79319F51AF6C62C674984974FCCB1D";
492 >
493 >        /*
494 >         * ssl_connection_required: client must be connected over SSL/TLS
495 >         * in order to be able to use this operator {} block.
496 >         * Default is 'no' if nothing else is specified.
497 >         */
498 >        ssl_connection_required = no;
499  
500 <        /* class: the class the oper joins when they successfully /oper */
500 >        /* class: the class the oper joins when they successfully /oper or /challenge. */
501          class = "opers";
502  
503          /*
504 <         * umodes: default usermodes opers get when they /oper.  If defined,
505 <         * it will override oper_umodes settings in general {}.
506 <         * Available usermodes:
504 >         * umodes: the default user modes opers get when they /oper or /challenge.
505 >         * If defined, it will override oper_umodes settings in general {}.
506 >         * Available user modes:
507           *
508           * +b - bots         - See bot and drone flooding notices
509           * +c - cconn        - Client connection/quit notices
427         * +C - cconn_full   - Client connection/quit notices full
510           * +D - deaf         - Don't receive channel messages
511           * +d - debug        - See debugging notices
512 <         * +f - full         - See auth{} block full notices
512 >         * +e - external     - See remote server connection and split notices
513 >         * +F - farconnect   - Remote client connection/quit notices
514 >         * +f - full         - See auth {} block full notices
515           * +G - softcallerid - Server Side Ignore for users not on your channels
516           * +g - callerid     - Server Side Ignore (for privmsgs etc)
517           * +H - hidden       - Hides operator status to other users
518 <         * +i - invisible    - Not shown in NAMES or WHO unless you share a
435 <         *                     a channel
518 >         * +i - invisible    - Not shown in NAMES or WHO unless you share a channel
519           * +j - rej          - See rejected client notices
520           * +k - skill        - See server generated KILL messages
521           * +l - locops       - See LOCOPS messages
522           * +n - nchange      - See client nick changes
523 +         * +p - hidechans    - Hides channel list in WHOIS
524 +         * +q - hideidle     - Hides idle and signon time in WHOIS
525 +         * +R - nononreg     - Only receive private messages from registered clients
526           * +s - servnotice   - See general server notices
527           * +u - unauth       - See unauthorized client notices
528           * +w - wallop       - See server generated WALLOPS
443         * +x - external     - See remote server connection and split notices
529           * +y - spy          - See LINKS, STATS, TRACE notices etc.
445         * +z - operwall     - See oper generated WALLOPS
530           */
531 < #       umodes = locops, servnotice, operwall, wallop;
531 >        umodes = locops, servnotice, wallop;
532  
533          /*
534 <         * privileges: controls the activities and commands an oper is
535 <         * allowed to do on the server. All options default to no.
536 <         * Available options:
537 <         *
538 <         * module       - allows MODULE
539 <         * global_kill  - allows remote users to be /KILL'd
540 <         * remote       - allows remote SQUIT and CONNECT
541 <         * remoteban    - allows remote KLINE/UNKLINE
542 <         * dline        - allows DLINE
543 <         * undline      - allows UNDLINE
544 <         * kline        - allows KILL and KLINE
545 <         * unkline      - allows UNKLINE
546 <         * gline        - allows GLINE
547 <         * xline        - allows XLINE
548 <         * globops      - allows GLOBOPS
549 <         * operwall     - allows OPERWALL
550 <         * nick_changes - allows oper to see nickchanges via usermode +n
551 <         * rehash       - allows oper to REHASH config
552 <         * die          - allows DIE
553 <         * restart      - allows RESTART
554 <         * set          - allows SET
555 <         * admin        - gives admin privileges. admins for example,
556 <         *                may see the real IP addresses of servers.
534 >         * flags: controls the activities and commands an oper is
535 >         * allowed to do on the server. All flags default to 'no'.
536 >         * Available flags:
537 >         *
538 >         * admin          - gives administrator privileges    | ('A' flag)
539 >         * close          - allows CLOSE
540 >         * connect        - allows local CONNECT              | ('P' flag)
541 >         * connect:remote - allows remote CONNECT             | ('Q' flag)
542 >         * die            - allows DIE                        | ('D' flag)
543 >         * dline          - allows DLINE                      |
544 >         * globops        - allows GLOBOPS                    |
545 >         * join:resv      - allows to JOIN resv {} channels
546 >         * kill           - allows to KILL local clients      | ('N' flag)
547 >         * kill:remote    - allows remote users to be /KILL'd | ('O' flag)
548 >         * kline          - allows KLINE                      | ('K' flag)
549 >         * locops         - allows LOCOPS                     |
550 >         * module         - allows MODULE                     |
551 >         * nick:resv      - allows to use NICK on resv {} nicks
552 >         * opme           - allows OPME                       |
553 >         * rehash         - allows oper to REHASH config      | ('H' flag)
554 >         * remoteban      - allows remote KLINE/UNKLINE       | ('B' flag)
555 >         * restart        - allows RESTART                    |
556 >         * resv           - allows RESV
557 >         * set            - allows SET                        |
558 >         * squit          - allows local SQUIT                | ('R' flag)
559 >         * squit:remote   - allows remote SQUIT               | ('S' flag)
560 >         * undline        - allows UNDLINE                    |
561 >         * unkline        - allows UNKLINE                    | ('U' flag)
562 >         * unresv         - allows UNRESV
563 >         * unxline        - allows UNXLINE                    |
564 >         * wallops        - allows WALLOPS                    |
565 >         * xline          - allows XLINE                      | ('X' flag)
566           */
567 <        flags = global_kill, remote, kline, unkline, xline, globops, restart,
568 <                die, rehash, nick_changes, admin, operwall, module;
476 < };
477 <
478 < service {
479 <        name = "service.someserver";
480 <        name = "stats.someserver";
567 >        flags = admin, connect, connect:remote, die, globops, kill, kill:remote,
568 >                kline, module, rehash, restart, set, unkline, unxline, xline;
569   };
570  
571   /*
572 < * connect {}:  controls servers we connect to
572 > * connect {}: define a server to connect to
573   */
574   connect {
575 <        /* name: the name of the server */
575 >        /* name: the name of the server. */
576          name = "irc.uplink.com";
577  
578          /*
579 <         * host: the host or IP to connect to.  If a hostname is used it
580 <         * must match the reverse dns of the server.
579 >         * host: the host or IP address to connect to. If a hostname is used it
580 >         * must match the reverse DNS of the server.
581           */
582          host = "192.168.0.1";
583  
584          /*
585 <         * vhost: the IP to bind to when we connect outward to servers.
585 >         * vhost: the IP address to bind to when making outgoing connections to
586 >         * servers.
587           * serverinfo::vhost and serverinfo::vhost6 will be overridden
588           * by this directive.
589           */
590          vhost = "192.168.0.2";
591  
592          /*
593 <         * passwords: the passwords we send (OLD C:) and accept (OLD N:).
594 <         * The remote server will have these passwords reversed.
593 >         * send_password, accept_password: the passwords to send and accept.
594 >         * The remote server will have these passwords swapped.
595           */
596          send_password = "password";
597          accept_password = "anotherpassword";
# Line 513 | Line 602 | connect {
602           */
603          encrypted = no;
604  
605 <        /* port: the port to connect to this server on */
605 >        /* port: the port to connect to this server on. */
606          port = 6666;
607  
608          /*
609 <         * hub_mask: the mask of servers that this server may hub.  Multiple
610 <         * entries are permitted
609 >         * hub_mask: the mask of servers that this server may hub. Multiple
610 >         * entries are permitted.
611           */
612          hub_mask = "*";
613  
614          /*
615 <         * leaf_mask: the mask of servers this server may not hub.  Multiple
616 <         * entries are permitted.  Useful for forbidding EU -> US -> EU routes.
615 >         * leaf_mask: the mask of servers this server may not hub. Multiple
616 >         * entries are permitted. Useful for forbidding EU -> US -> EU routes.
617           */
618   #       leaf_mask = "*.uk";
619  
620 <        /* class: the class this server is in */
620 >        /* class: the class this server is in. */
621          class = "server";
622  
623          /*
624 <         * ssl_cipher_list:
625 <         *
626 <         * List of ciphers that the server we are connecting to must support.
538 <         * If the server isn't capable of any cipher listed below, the
539 <         * connection will simply be rejected.
624 >         * ssl_cipher_list: list of ciphers that the server we are connecting to
625 >         * must support. If the server is not capable of using any of the ciphers
626 >         * listed below, the connection will simply be rejected.
627           * Can be used to enforce stronger ciphers, even though this option
628           * is not necessarily required to establish a SSL/TLS connection.
629           *
630           * Multiple ciphers are separated by colons. The order of preference
631           * is from left to right.
632           */
633 <        #ssl_cipher_list = "DHE-RSA-AES256-SHA:AES256-SHA";
633 > #       ssl_cipher_list = "ECDHE-RSA-AES256-GCM-SHA384:DHE-RSA-AES256-GCM-SHA384:DHE-RSA-AES256-SHA:AES256-SHA";
634 >
635 >        /*
636 >         * ssl_certificate_fingerprint: enhances security by additionally checking
637 >         * the server's client certificate fingerprint against the specified
638 >         * fingerprint below.
639 >         */
640 > #       ssl_certificate_fingerprint = "4C62287BA6776A89CD4F8FF10A62FFB35E79319F51AF6C62C674984974FCCB1D";
641  
642          /*
643           * autoconn   - controls whether we autoconnect to this server or not,
# Line 574 | Line 668 | connect {
668   */
669   cluster {
670          /*
671 <         * name: the server to share with, this can take wildcards
671 >         * name: the server to share with; this can take wildcards
672           *
673 <         * NOTE: only local actions will be clustered, meaning if
673 >         * NOTE: only local actions will be clustered, meaning that if
674           *       the server receives a shared kline/unkline/etc, it
675           *       will not be propagated to clustered servers.
676           *
677           *       Remote servers are not necessarily required to accept
678 <         *       clustered lines, they need a shared{} for *THIS* server
679 <         *       in order to accept them.
678 >         *       clustered lines, they need a shared {} block for *THIS*
679 >         *       server in order to accept them.
680           */
681          name = "*.arpa";
682  
683          /*
684 <         * type: list of what to share, options are as follows:
684 >         * type: list of what to share; options are as follows:
685           *      dline   - share dlines
686           *      undline - share undlines
687           *      kline   - share klines
# Line 605 | Line 699 | cluster {
699   /*
700   * shared {}: users that are allowed to remote kline
701   *
702 < * NOTE: This can be effectively used for remote klines.
702 > * NOTE: This can effectively be used for remote klines.
703   *       Please note that there is no password authentication
704 < *       for users setting remote klines.  You must also be
704 > *       for users setting remote klines. You must also be
705   *       /oper'd in order to issue a remote kline.
706   */
707   shared {
708          /*
709 <         * name: the server the user must be on to set klines.  If this is not
710 <         * specified, the user will be allowed to kline from all servers.
709 >         * name: the server the user must be connected to in order to set klines.
710 >         * If this is not specified, the user will be allowed to kline from all
711 >         * servers.
712           */
713          name = "irc2.some.server";
714  
715          /*
716 <         * user: the user@host mask that is allowed to set klines.  If this is
716 >         * user: the user@host mask that is allowed to set klines. If this is
717           * not specified, all users on the server above will be allowed to set
718           * a remote kline.
719           */
# Line 642 | Line 737 | shared {
737  
738   /*
739   * kill {}:  users that are not allowed to connect
740 < * Oper issued klines will be added to the specified kline config
740 > * Oper issued klines will be added to the specified kline database
741   */
742   kill {
743          user = "bad@*.hacked.edu";
744          reason = "Obviously hacked account";
745   };
746  
652 kill {
653        user = "^O[[:alpha:]]?[[:digit:]]+(x\.o|\.xo)$@^[[:alnum:]]{4}\.evilnet.tld$";
654
655        /*
656         * NOTE: You have to set type=regex; when using a regular expression
657         * based user entry
658         */
659        type = regex;
660 };
661
747   /*
748 < * deny {}:  IPs that are not allowed to connect (before DNS/ident lookup)
749 < * Oper issued dlines will be added to the specified dline config
748 > * deny {}:  IP addresses that are not allowed to connect
749 > * (before DNS/ident lookup)
750 > * Oper issued dlines will be added to the specified dline database
751   */
752   deny {
753          ip = "10.0.1.0/24";
# Line 669 | Line 755 | deny {
755   };
756  
757   /*
758 < * exempt {}: IPs that are exempt from deny {} and Dlines
758 > * exempt {}:  IP addresses that are exempt from deny {} and Dlines
759   */
760   exempt {
761          ip = "192.168.0.0/16";
# Line 678 | Line 764 | exempt {
764   /*
765   * resv {}:  nicks and channels users may not use/join
766   */
767 + resv { mask = "clone*"; reason = "Clone bots"; };
768 + resv { mask = "Global"; reason = "Reserved for services"; };
769 + resv { mask = "ChanServ"; reason = "Reserved for services"; };
770 + resv { mask = "NickServ"; reason = "Reserved for services"; };
771 + resv { mask = "OperServ"; reason = "Reserved for services"; };
772 + resv { mask = "MemoServ"; reason = "Reserved for services"; };
773 + resv { mask = "BotServ"; reason = "Reserved for services"; };
774 + resv { mask = "HelpServ"; reason = "Reserved for services"; };
775 + resv { mask = "HostServ"; reason = "Reserved for services"; };
776 + resv { mask = "StatServ"; reason = "Reserved for services"; };
777 + resv { mask = "#*services*"; reason = "Reserved for services"; };
778 +
779   resv {
780 <        /* reason: the reason for the proceeding resv's */
781 <        reason = "Reserved for services";
780 >        /*
781 >         * mask: masks starting with a '#' are automatically considered
782 >         * as channel name masks.
783 >         */
784 >        mask = "#helsinki";
785 >        reason = "Channel is reserved for Finnish inhabitants";
786  
787 <        /* resv: the nicks and channels users may not join/use */
788 <        nick = "Global";
789 <        nick = "DevNull";
790 <        nick = "BotServ";
791 <        nick = "Services";
792 <        nick = "StatServ";
691 <        nick = "HelpServ";
692 <        nick = "HostServ";
693 <        nick = "NickServ";
694 <        nick = "ChanServ";
695 <        nick = "MemoServ";
696 <        nick = "OperServ";
697 <        channel = "#services";
698 <
699 <        /* resv: wildcard masks are also supported in nicks only */
700 <        reason = "Clone bots";
701 <        nick = "clone*";
787 >        /*
788 >         * exempt: can be either a ISO 3166 alpha-2 two letter country
789 >         * code, or a nick!user@host mask. CIDR is supported. Exempt
790 >         * entries can be stacked.
791 >         */
792 >        exempt = "FI";
793   };
794  
795   /*
796 < * gecos {}:  The X: replacement, used for banning users based on
706 < * their "realname".
796 > * gecos {}:  used for banning users based on their "realname".
797   */
798   gecos {
799          name = "*sex*";
# Line 715 | Line 805 | gecos {
805          reason = "Trojan drone";
806   };
807  
808 < gecos {
809 <        name = "*http*";
810 <        reason = "Spambot";
808 > /*
809 > * service {}: specifies a server which may act as a network service
810 > *
811 > * NOTE: it is very important that every server on the network
812 > *       has the same service {} block.
813 > */
814 > service {
815 >        name = "service.someserver";
816 >        name = "stats.someserver";
817   };
818  
819 < gecos {
820 <        name = "^\[J[0o]hn Do[3e]\]-[0-9]{2,5}$";
819 > /*
820 > * pseudo {}: adds pseudo/custom commands also known as service aliases
821 > */
822 > pseudo {
823 >        /* command: the actual command/alias. */
824 >        command = "IDENTIFY";
825  
826 <        /*
827 <         * NOTE: You have to set type=regex; when using a regular expression
828 <         * based name entry
829 <         */
830 <        type = regex;
826 >        /* prepend: optional text that can be prepended before the user's message. */
827 >        prepend = "IDENTIFY ";
828 >
829 >        /* name: the service name, used for error messages. */
830 >        name = "NickServ";
831 >
832 >        /* target: the actual target where this message should be sent to. */
833 >        target = "NickServ@service.someserver";
834 > };
835 >
836 > pseudo {
837 >        command = "CHANSERV";
838 >        name = "ChanServ";
839 >        target = "ChanServ@service.someserver";
840 > };
841 >
842 > pseudo {
843 >        command = "CS";
844 >        name = "ChanServ";
845 >        target = "ChanServ@service.someserver";
846 > };
847 >
848 > pseudo {
849 >        command = "NICKSERV";
850 >        name = "NickServ";
851 >        target = "NickServ@service.someserver";
852 > };
853 >
854 > pseudo {
855 >        command = "NS";
856 >        name = "NickServ";
857 >        target = "NickServ@service.someserver";
858 > };
859 >
860 > pseudo {
861 >        command = "MEMOSERV";
862 >        name = "MemoServ";
863 >        target = "MemoServ@service.someserver";
864 > };
865 >
866 > pseudo {
867 >        command = "MS";
868 >        name = "MemoServ";
869 >        target = "MemoServ@service.someserver";
870 > };
871 >
872 > pseudo {
873 >        command = "OPERSERV";
874 >        name = "OperServ";
875 >        target = "OperServ@service.someserver";
876 > };
877 >
878 > pseudo {
879 >        command = "OS";
880 >        name = "OperServ";
881 >        target = "OperServ@service.someserver";
882 > };
883 >
884 > pseudo {
885 >        command = "HOSTSERV";
886 >        name = "HostServ";
887 >        target = "HostServ@service.someserver";
888 > };
889 >
890 > pseudo {
891 >        command = "HS";
892 >        name = "HostServ";
893 >        target = "HostServ@service.someserver";
894 > };
895 >
896 > pseudo {
897 >        command = "BOTSERV";
898 >        name = "BotServ";
899 >        target = "BotServ@service.someserver";
900 > };
901 >
902 > pseudo {
903 >        command = "BS";
904 >        name = "BotServ";
905 >        target = "BotServ@service.someserver";
906   };
907  
908   /*
909 < * channel {}:  The channel block contains options pertaining to channels
909 > * channel {}:  the channel block contains options pertaining to channels
910   */
911   channel {
912          /*
913           * disable_fake_channels: this option, if set to 'yes', will
914 <         * disallow clients to create or join channels that have one
914 >         * disallow clients from creating or joining channels that have one
915           * of the following ASCII characters in their name:
916           *
917           *   2 | bold
# Line 750 | Line 925 | channel {
925          disable_fake_channels = yes;
926  
927          /*
928 <         * restrict_channels: reverse channel RESVs logic, only reserved
929 <         * channels are allowed
928 >         * invite_client_count, invite_client_time: how many INVITE commands
929 >         * are permitted per client per invite_client_time.
930           */
931 <        restrict_channels = no;
931 >        invite_client_count = 10;
932 >        invite_client_time = 5 minutes;
933  
934          /*
935 <         * knock_delay: The amount of time a user must wait between issuing
936 <         * the knock command.
935 >         * knock_client_count, knock_client_time: how many KNOCK commands
936 >         * are permitted per client per knock_client_time.
937           */
938 <        knock_delay = 5 minutes;
938 >        knock_client_count = 1;
939 >        knock_client_time = 5 minutes;
940  
941          /*
942 <         * knock_delay_channel: How often a knock to any specific channel
943 <         * is permitted, regardless of the user sending the knock.
942 >         * knock_delay_channel: how often a KNOCK to any specific channel
943 >         * is permitted, regardless of the user sending the KNOCK.
944           */
945          knock_delay_channel = 1 minute;
946  
947          /*
948 <         * max_chans_per_user: The maximum number of channels a user can
949 <         * join/be on.
948 >         * max_channels: the maximum number of channels a user can join/be on.
949 >         * This is a default value which can be overriden with class {} blocks.
950           */
951 <        max_chans_per_user = 25;
951 >        max_channels = 25;
952  
953 <        /*
777 <         * max_chans_per_oper: The maximum number of channels an oper can
778 <         * join/be on.
779 <         */
780 <        max_chans_per_oper = 50;
781 <
782 <        /* quiet_on_ban: stop banned people talking in channels. */
783 <        quiet_on_ban = yes;
784 <
785 <        /* max_bans: maximum number of +b/e/I modes in a channel */
953 >        /* max_bans: maximum number of +b/e/I modes in a channel. */
954          max_bans = 100;
955  
956          /*
957 <         * how many joins in how many seconds constitute a flood, use 0 to
958 <         * disable. +b opers will be notified (changeable via /set)
959 <         */
960 <        join_flood_count = 16;
793 <        join_flood_time = 8 seconds;
794 <
795 <        /*
796 <         * splitcode: The ircd will now check splitmode every few seconds.
797 <         *
798 <         * Either split users or split servers can activate splitmode, but
799 <         * both conditions must be met for the ircd to deactivate splitmode.
800 <         *
801 <         * You may force splitmode to be permanent by /quote set splitmode on
802 <         */
803 <
804 <        /*
805 <         * default_split_user_count: when the usercount is lower than this level,
806 <         * consider ourselves split.  This must be set for automatic splitmode.
807 <         */
808 <        default_split_user_count = 0;
809 <
810 <        /*
811 <         * default_split_server_count: when the servercount is lower than this,
812 <         * consider ourselves split.  This must be set for automatic splitmode.
957 >         * default_join_flood_count, default_join_flood_time:
958 >         * how many joins in how many seconds constitute a flood. Use 0 to disable.
959 >         * +b opers will be notified. These are only default values which can be
960 >         * changed via "/QUOTE SET JFLOODCOUNT" and "/QUOTE SET JFLOODTIME".
961           */
962 <        default_split_server_count = 0;
963 <
816 <        /* no_create_on_split: disallow users creating channels on split. */
817 <        no_create_on_split = yes;
818 <
819 <        /* no_join_on_split: disallow users joining channels at all on a split. */
820 <        no_join_on_split = no;
962 >        default_join_flood_count = 18;
963 >        default_join_flood_time = 6 seconds;
964   };
965  
966   /*
967 < * serverhide {}:  The serverhide block contains the options regarding
968 < * serverhiding
967 > * serverhide {}:  the serverhide block contains the options regarding
968 > * to server hiding. For more information regarding server hiding,
969 > * please see doc/serverhide.txt
970   */
971   serverhide {
972          /*
973 +         * disable_remote_commands: disable users issuing commands
974 +         * on remote servers.
975 +         */
976 +        disable_remote_commands = no;
977 +
978 +        /*
979           * flatten_links: this option will show all servers in /links appear
980 <         * that they are linked to this current server
980 >         * as though they are linked to this current server.
981           */
982          flatten_links = no;
983  
# Line 839 | Line 989 | serverhide {
989  
990          /*
991           * hidden: hide this server from a /links output on servers that
992 <         * support it.  This allows hub servers to be hidden etc.
992 >         * support it. This allows hub servers to be hidden etc.
993           */
994          hidden = no;
995  
# Line 850 | Line 1000 | serverhide {
1000          hide_servers = no;
1001  
1002          /*
1003 <         * Use this as the servername users see if hide_servers = yes.
1003 >         * hide_services: define this if you want to hide the location of
1004 >         * services servers that are specified in the service {} block.
1005 >         */
1006 >        hide_services = no;
1007 >
1008 >        /*
1009 >         * hidden_name: use this as the servername users see if hide_servers = yes.
1010           */
1011          hidden_name = "*.hidden.com";
1012  
1013          /*
1014 <         * hide_server_ips: If this is disabled, opers will be unable to see
1015 <         * servers ips and will be shown a masked ip, admins will be shown the
1016 <         * real ip.
1017 <         *
1018 <         * If this is enabled, nobody can see a servers ip. *This is a kludge*,
1019 <         * it has the side effect of hiding the ips everywhere, including
1020 <         * logfiles.
1014 >         * hide_server_ips: if this is disabled, opers will be unable to see
1015 >         * servers' IP addresses and will be shown a masked IP address; admins
1016 >         * will be shown the real IP address.
1017 >         *
1018 >         * If this is enabled, nobody can see a server's IP address.
1019 >         * *This is a kludge*: it has the side effect of hiding the IP addresses
1020 >         * everywhere, including logfiles.
1021           *
1022           * We recommend you leave this disabled, and just take care with who you
1023 <         * give admin=yes; to.
1023 >         * give administrator privileges to.
1024           */
1025          hide_server_ips = no;
1026   };
1027  
1028   /*
1029 < * general {}:  The general block contains many of the options that were once
1030 < * compiled in options in config.h.  The general block is read at start time.
1029 > * general {}:  the general block contains many of the options that were once
1030 > * compiled in options in config.h
1031   */
1032   general {
1033 <        /* services_name: servername of nick/channel services */
1034 <        services_name = "service.someserver";
1033 >        /*
1034 >         * cycle_on_host_change: sends a fake QUIT/JOIN combination
1035 >         * when services change the hostname of a specific client.
1036 >         */
1037 >        cycle_on_host_change = yes;
1038  
1039          /* max_watch: maximum WATCH entries a client can have. */
1040 <        max_watch = 60;
1040 >        max_watch = 30;
1041  
1042 <        /* gline_enable: enable glines, network wide temp klines */
1043 <        gline_enable = yes;
1042 >        /* max_accept: maximum allowed /accept's for +g user mode. */
1043 >        max_accept = 30;
1044  
1045          /*
1046 <         * gline_duration: the amount of time a gline will remain on your
1047 <         * server before expiring
1046 >         * dline_min_cidr: the minimum required length of a CIDR bitmask
1047 >         * for IPv4 based D-lines.
1048           */
1049 <        gline_duration = 1 day;
1049 >        dline_min_cidr = 16;
1050  
1051          /*
1052 <         * gline_request_duration:  how long a pending G-line can be around.
1053 <         * 10 minutes should be plenty
1052 >         * dline_min_cidr6: the minimum required length of a CIDR bitmask
1053 >         * for IPv6 based D-lines.
1054           */
1055 <        gline_request_duration = 10 minutes;
1055 >        dline_min_cidr6 = 48;
1056  
1057          /*
1058 <         * gline_min_cidr: the minimum required length of a CIDR bitmask
1059 <         * for IPv4 based glines
1058 >         * kline_min_cidr: the minimum required length of a CIDR bitmask
1059 >         * for IPv4 based K-lines.
1060           */
1061 <        gline_min_cidr = 16;
1061 >        kline_min_cidr = 16;
1062  
1063          /*
1064 <         * gline_min_cidr6: the minimum required length of a CIDR bitmask
1065 <         * for IPv6 based glines
1064 >         * kline_min_cidr6: the minimum required length of a CIDR bitmask
1065 >         * for IPv6 based K-lines.
1066           */
1067 <        gline_min_cidr6 = 48;
1067 >        kline_min_cidr6 = 48;
1068  
1069          /*
1070 <         * Whether to automatically set mode +i on connecting users.
1070 >         * invisible_on_connect: whether to automatically set mode +i on
1071 >         * connecting users.
1072           */
1073          invisible_on_connect = yes;
1074  
1075          /*
1076 <         * Show "actually using host <ip>" on /whois when possible.
1077 <         */
1078 <        use_whois_actually = yes;
1079 <
920 <        /*
921 <         * Max time from the nickname change that still causes KILL
922 <         * automatically to switch for the current nick of that user.
923 <         */
924 <        kill_chase_time_limit = 90 seconds;
925 <
926 <        /*
927 <         * If hide_spoof_ips is disabled, opers will be allowed to see the real
928 <         * IP of spoofed users in /trace etc. If this is defined they will be
929 <         * shown a masked IP.
1076 >         * kill_chase_time_limit: KILL chasing is a feature whereby a KILL
1077 >         * issued for a user who has recently changed nickname will be applied
1078 >         * automatically to the new nick. kill_chase_time_limit is the maximum
1079 >         * time following a nickname change that this chasing will apply.
1080           */
1081 <        hide_spoof_ips = yes;
1081 >        kill_chase_time_limit = 30 seconds;
1082  
1083          /*
1084 <         * Ignore bogus timestamps from other servers.  Yes, this will desync
1085 <         * the network, but it will allow chanops to resync with a valid non TS 0
1084 >         * ignore_bogus_ts: ignore bogus timestamps from other servers.
1085 >         * Yes, this will desync the network, but it will allow chanops
1086 >         * to resync with a valid non TS 0.
1087           *
1088           * This should be enabled network wide, or not at all.
1089           */
# Line 940 | Line 1091 | general {
1091  
1092          /*
1093           * disable_auth: completely disable ident lookups; if you enable this,
1094 <         * be careful of what you set need_ident to in your auth {} blocks
1094 >         * be careful of what you set need_ident to in your auth {} blocks.
1095           */
1096          disable_auth = no;
1097  
947        /* disable_remote_commands: disable users doing commands on remote servers */
948        disable_remote_commands = no;
949
1098          /*
1099           * tkline_expire_notices: enables or disables temporary kline/xline
1100           * expire notices.
# Line 955 | Line 1103 | general {
1103  
1104          /*
1105           * default_floodcount: the default value of floodcount that is configurable
1106 <         * via /quote set floodcount.  This is the amount of lines a user
1107 <         * may send to any other user/channel in one second.
1106 >         * via /quote set floodcount. This is the number of lines a user may send
1107 >         * to any other user/channel in one second. Set to 0 to disable.
1108           */
1109          default_floodcount = 10;
1110  
1111          /*
1112 <         * failed_oper_notice: send a notice to all opers on the server when
1112 >         * failed_oper_notice: send a notice to all opers on the server when
1113           * someone tries to OPER and uses the wrong password, host or ident.
1114           */
1115          failed_oper_notice = yes;
1116  
1117          /*
1118 <         * dots_in_ident: the amount of '.' characters permitted in an ident
1118 >         * dots_in_ident: the number of '.' characters permitted in an ident
1119           * reply before the user is rejected.
1120           */
1121          dots_in_ident = 2;
1122  
1123          /*
1124 <         * min_nonwildcard: the minimum non wildcard characters in k/d/g lines
1125 <         * placed via the server.  klines hand placed are exempt from limits.
1126 <         * wildcard chars: '.' ':' '*' '?' '@' '!' '#'
1124 >         * min_nonwildcard: the minimum number of non-wildcard characters in
1125 >         * k/d lines placed via the server. K-lines hand-placed are exempt from
1126 >         * this limit.
1127 >         * Wildcard characters: '.', ':', '*', '?'
1128           */
1129          min_nonwildcard = 4;
1130  
1131          /*
1132 <         * min_nonwildcard_simple: the minimum non wildcard characters in
1133 <         * gecos bans.  wildcard chars: '*' '?' '#'
1132 >         * min_nonwildcard_simple: the minimum number of non-wildcard characters
1133 >         * in gecos bans. Wildcard characters: '*', '?'
1134           */
1135          min_nonwildcard_simple = 3;
1136  
1137 <        /* max_accept: maximum allowed /accept's for +g usermode */
989 <        max_accept = 20;
990 <
991 <        /* anti_nick_flood: enable the nickflood control code */
1137 >        /* anti_nick_flood: enable the nickflood control code. */
1138          anti_nick_flood = yes;
1139  
994        /* nick flood: the nick changes allowed in the specified period */
995        max_nick_time = 20 seconds;
996        max_nick_changes = 5;
997
998        /*
999         * anti_spam_exit_message_time: the minimum time a user must be connected
1000         * before custom quit messages are allowed.
1001         */
1002        anti_spam_exit_message_time = 5 minutes;
1003
1140          /*
1141 <         * ts delta: the time delta allowed between server clocks before
1142 <         * a warning is given, or before the link is dropped.  all servers
1007 <         * should run ntpdate/rdate to keep clocks in sync
1141 >         * max_nick_changes, max_nick_time: the number of nick changes allowed in
1142 >         * the specified period.
1143           */
1144 <        ts_warn_delta = 30 seconds;
1145 <        ts_max_delta = 5 minutes;
1144 >        max_nick_changes = 5;
1145 >        max_nick_time = 20 seconds;
1146  
1147          /*
1148 <         * kline_with_reason: show the user the reason why they are k/d/glined
1149 <         * on exit.  May give away who set k/dline when set via tcm.
1148 >         * away_count, away_time: how many AWAY command are permitted per
1149 >         * client per away_time.
1150           */
1151 <        kline_with_reason = yes;
1151 >        away_count = 2;
1152 >        away_time = 10 seconds;
1153  
1154          /*
1155 <         * kline_reason: show this message to users on channel
1156 <         * instead of the oper reason.
1155 >         * anti_spam_exit_message_time: the minimum time a user must be connected
1156 >         * before custom quit messages are allowed.
1157           */
1158 <        kline_reason = "Connection closed";
1158 >        anti_spam_exit_message_time = 5 minutes;
1159  
1160          /*
1161 <         * reject_hold_time: wait this amount of time before disconnecting
1162 <         * a rejected client. Use 0 to disable.
1161 >         * ts_warn_delta, ts_max_delta: the time delta allowed between server
1162 >         * clocks before a warning is given, or before the link is dropped.
1163 >         * All servers should run ntpdate/rdate to keep clocks in sync.
1164           */
1165 <        reject_hold_time = 0;
1165 >        ts_warn_delta = 3 seconds;
1166 >        ts_max_delta = 15 seconds;
1167  
1168          /*
1169 <         * warn_no_nline: warn opers about servers that try to connect but
1170 <         * we don't have a connect {} block for.  Twits with misconfigured
1171 <         * servers can get really annoying with this enabled.
1169 >         * warn_no_connect_block: warn opers about servers that try to connect
1170 >         * but for which we don't have a connect {} block. Twits with
1171 >         * misconfigured servers can become really annoying with this enabled.
1172           */
1173 <        warn_no_nline = yes;
1173 >        warn_no_connect_block = yes;
1174  
1175          /*
1176           * stats_e_disabled: set this to 'yes' to disable "STATS e" for both
1177 <         * operators and administrators.  Doing so is a good idea in case
1178 <         * there are any exempted (exempt{}) server IPs you don't want to
1177 >         * operators and administrators. Doing so is a good idea in case
1178 >         * there are any exempted (exempt {}) server IPs you don't want to
1179           * see leaked.
1180           */
1181          stats_e_disabled = no;
1182  
1183 <        /* stats_o_oper only: make stats o (opers) oper only */
1183 >        /* stats_m_oper_only: make /stats m/M (messages) oper only. */
1184 >        stats_m_oper_only = yes;
1185 >
1186 >        /* stats_o_oper_only: make stats o (opers) oper only. */
1187          stats_o_oper_only = yes;
1188  
1189 <        /* stats_P_oper_only: make stats P (ports) oper only */
1189 >        /* stats_P_oper_only: make stats P (ports) oper only. */
1190          stats_P_oper_only = yes;
1191  
1192 +        /* stats_u_oper_only: make stats u (uptime) oper only. */
1193 +        stats_u_oper_only = no;
1194 +
1195          /*
1196 <         * stats i oper only: make stats i (auth {}) oper only. set to:
1197 <         *     yes:    show users no auth blocks, made oper only.
1198 <         *     masked: show users first matching auth block
1199 <         *     no:     show users all auth blocks.
1196 >         * stats_i_oper_only: make stats i (auth {}) oper only. Set to:
1197 >         *     yes    - show users no auth {} blocks, made oper only
1198 >         *     masked - show users the first matching auth {} block
1199 >         *     no     - show users all auth {} blocks
1200           */
1201          stats_i_oper_only = yes;
1202  
1203          /*
1204 <         * stats_k_oper_only: make stats k/K (klines) oper only.  set to:
1205 <         *     yes:    show users no auth blocks, made oper only
1206 <         *     masked: show users first matching auth block
1207 <         *     no:     show users all auth blocks.
1204 >         * stats_k_oper_only: make stats k/K (klines) oper only. Set to:
1205 >         *     yes    - show users no klines, made oper only
1206 >         *     masked - show users the first matching kline
1207 >         *     no     - show users all klines
1208           */
1209          stats_k_oper_only = yes;
1210  
# Line 1072 | Line 1216 | general {
1216  
1217          /*
1218           * opers_bypass_callerid: allows operators to bypass +g and message
1219 <         * anyone who has it set (useful if you use services).
1219 >         * anyone who has it set.
1220           */
1221          opers_bypass_callerid = no;
1222  
1223          /*
1224 <         * pace_wait_simple: time between use of less intensive commands
1225 <         * (ADMIN, HELP, (L)USERS, VERSION, remote WHOIS)
1224 >         * pace_wait_simple: minimum time required between use of less
1225 >         * intensive commands
1226 >         * (ADMIN, HELP, LUSERS, VERSION, remote WHOIS)
1227           */
1228          pace_wait_simple = 1 second;
1229  
1230          /*
1231 <         * pace_wait: time between more intensive commands
1232 <         * (AWAY, INFO, LINKS, MAP, MOTD, STATS, WHO, wildcard WHOIS, WHOWAS)
1231 >         * pace_wait: minimum time required between use of more intensive commands
1232 >         * (INFO, LINKS, MAP, MOTD, STATS, WHO, WHOWAS)
1233           */
1234          pace_wait = 10 seconds;
1235  
1236          /*
1237 <         * short_motd: send clients a notice telling them to read the motd
1238 <         * instead of forcing a motd to clients who may simply ignore it.
1237 >         * short_motd: send clients a notice telling them to read the MOTD
1238 >         * instead of forcing an MOTD to clients who may simply ignore it.
1239           */
1240          short_motd = no;
1241  
1242          /*
1243 <         * ping_cookie: require clients to respond exactly to a ping command,
1243 >         * ping_cookie: require clients to respond exactly to a PING command,
1244           * can help block certain types of drones and FTP PASV mode spoofing.
1245           */
1246          ping_cookie = no;
# Line 1104 | Line 1249 | general {
1249          no_oper_flood = yes;
1250  
1251          /*
1252 <         * true_no_oper_flood: completely eliminate flood limits for opers
1253 <         * and for clients with can_flood = yes in their auth {} blocks
1109 <         */
1110 <        true_no_oper_flood = yes;
1111 <
1112 <        /* oper_pass_resv: allow opers to over-ride RESVs on nicks/channels */
1113 <        oper_pass_resv = yes;
1114 <
1115 <        /* REMOVE ME.  The following line checks you've been reading. */
1116 <        havent_read_conf = 1;
1117 <
1118 <        /*
1119 <         * max_targets: the maximum amount of targets in a single
1120 <         * PRIVMSG/NOTICE.  Set to 999 NOT 0 for unlimited.
1252 >         * max_targets: the maximum number of targets in a single
1253 >         * PRIVMSG/NOTICE. Set to 999 NOT 0 for unlimited.
1254           */
1255          max_targets = 4;
1256  
1257          /*
1258 <         * message_locale: the default message locale
1126 <         * Use "standard" for the compiled in defaults.
1127 <         * To install the translated messages, go into messages/ in the
1128 <         * source directory and run `make install'.
1129 <         */
1130 <        message_locale = "standard";
1131 <
1132 <        /*
1133 <         * usermodes configurable: a list of usermodes for the options below
1258 >         * user modes configurable: a list of user modes for the options below
1259           *
1260           * +b - bots         - See bot and drone flooding notices
1261           * +c - cconn        - Client connection/quit notices
1137         * +C - cconn_full   - Client connection/quit notices full
1262           * +D - deaf         - Don't receive channel messages
1263           * +d - debug        - See debugging notices
1264 <         * +f - full         - See auth{} block full notices
1264 >         * +e - external     - See remote server connection and split notices
1265 >         * +F - farconnect   - Remote client connection/quit notices
1266 >         * +f - full         - See auth {} block full notices
1267           * +G - softcallerid - Server Side Ignore for users not on your channels
1268           * +g - callerid     - Server Side Ignore (for privmsgs etc)
1269           * +H - hidden       - Hides operator status to other users
1270 <         * +i - invisible    - Not shown in NAMES or WHO unless you share a
1145 <         *                     a channel
1270 >         * +i - invisible    - Not shown in NAMES or WHO unless you share a channel
1271           * +j - rej          - See rejected client notices
1272           * +k - skill        - See server generated KILL messages
1273           * +l - locops       - See LOCOPS messages
1274           * +n - nchange      - See client nick changes
1275 +         * +p - hidechans    - Hides channel list in WHOIS
1276 +         * +q - hideidle     - Hides idle and signon time in WHOIS
1277 +         * +R - nononreg     - Only receive private messages from registered clients
1278           * +s - servnotice   - See general server notices
1279           * +u - unauth       - See unauthorized client notices
1280           * +w - wallop       - See server generated WALLOPS
1153         * +x - external     - See remote server connection and split notices
1281           * +y - spy          - See LINKS, STATS, TRACE notices etc.
1155         * +z - operwall     - See oper generated WALLOPS
1282           */
1283  
1284 <        /* oper_only_umodes: usermodes only opers may set */
1285 <        oper_only_umodes = bots, cconn, cconn_full, debug, full, hidden, skill,
1286 <                           nchange, rej, spy, external, operwall,
1161 <                           locops, unauth;
1162 <
1163 <        /* oper_umodes: default usermodes opers get when they /oper */
1164 <        oper_umodes = bots, locops, servnotice, operwall, wallop;
1284 >        /* oper_only_umodes: user modes only operators may set. */
1285 >        oper_only_umodes = bots, cconn, debug, external, farconnect, full, hidden, locops,
1286 >                        nchange, rej, skill, spy, unauth;
1287  
1288 <        /*
1289 <         * use_egd: if your system does not have *random devices yet you
1168 <         * want to use OpenSSL and encrypted links, enable this.  Beware -
1169 <         * EGD is *very* CPU intensive when gathering data for its pool
1170 <         */
1171 < #       use_egd = yes;
1288 >        /* oper_umodes: default user modes operators get when they /oper or /challenge. */
1289 >        oper_umodes = bots, locops, servnotice, wallop;
1290  
1291          /*
1292 <         * egdpool_path: path to EGD pool. Not necessary for OpenSSL >= 0.9.7
1293 <         * which automatically finds the path.
1292 >         * throttle_count: the maximum number of connections from the same
1293 >         * IP address allowed in throttle_time duration.
1294           */
1295 < #       egdpool_path = "/var/run/egd-pool";
1295 >        throttle_count = 1;
1296  
1297          /*
1298 <         * throttle_time: the minimum amount of time between connections from
1299 <         * the same ip.  exempt {} blocks are excluded from this throttling.
1300 <         * Offers protection against flooders who reconnect quickly.  
1298 >         * throttle_time: the minimum amount of time required between
1299 >         * connections from the same IP address. exempt {} blocks are
1300 >         * excluded from this throttling.
1301 >         * Offers protection against flooders who reconnect quickly.
1302           * Set to 0 to disable.
1303           */
1304 <        throttle_time = 10;
1304 >        throttle_time = 2 seconds;
1305   };
1306  
1307   modules {
# Line 1190 | Line 1309 | modules {
1309           * path: other paths to search for modules specified below
1310           * and in "/module load".
1311           */
1312 <        path = "/usr/local/ircd/lib/ircd-hybrid/modules";
1313 <        path = "/usr/local/ircd/lib/ircd-hybrid/modules/autoload";
1312 >        path = "lib/ircd-hybrid/modules";
1313 > #       path = "lib/ircd-hybrid/modules/extra";
1314 >        path = "lib/ircd-hybrid/modules/autoload";
1315  
1316 <        /* module: the name of a module to load on startup/rehash */
1317 <        #module = "some_module.la";
1316 >        /* module: the name of a module to load on startup/rehash. */
1317 > #       module = "some_module.la";
1318   };
1319  
1320   /*
# Line 1206 | Line 1326 | log {
1326  
1327          file {
1328                  type = oper;
1329 <                name = "/home/ircd/var/log/oper.log";
1329 >                name = "var/log/oper.log";
1330                  size = unlimited;
1331          };
1332  
1333          file {
1334                  type = user;
1335 <                name = "/home/ircd/var/log/user.log";
1335 >                name = "var/log/user.log";
1336                  size = 50 megabytes;
1337          };
1338  
1339          file {
1340                  type = kill;
1341 <                name = "/home/ircd/var/log/kill.log";
1341 >                name = "var/log/kill.log";
1342                  size = 50 megabytes;
1343          };
1344  
1345          file {
1346                  type = kline;
1347 <                name = "/home/ircd/var/log/kline.log";
1347 >                name = "var/log/kline.log";
1348                  size = 50 megabytes;
1349          };
1350  
1351          file {
1352                  type = dline;
1353 <                name = "/home/ircd/var/log/dline.log";
1353 >                name = "var/log/dline.log";
1354 >                size = 50 megabytes;
1355 >        };
1356 >
1357 >        file {
1358 >                type = xline;
1359 >                name = "var/log/xline.log";
1360                  size = 50 megabytes;
1361          };
1362  
1363          file {
1364 <                type = gline;
1365 <                name = "/home/ircd/var/log/gline.log";
1364 >                type = resv;
1365 >                name = "var/log/resv.log";
1366                  size = 50 megabytes;
1367          };
1368  
1369          file {
1370                  type = debug;
1371 <                name = "/home/ircd/var/log/debug.log";
1371 >                name = "var/log/debug.log";
1372                  size = 50 megabytes;
1373 <        };
1373 >        };
1374   };

Diff Legend

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