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

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

Comparing ircd-hybrid/trunk/doc/reference.conf (property svn:keywords):
Revision 2150 by michael, Fri May 31 18:39:43 2013 UTC vs.
Revision 7766 by michael, Fri Oct 7 16:27:37 2016 UTC

# Line 1 | Line 1
1 < Id Revision
1 > Id

Diff Legend

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