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

Comparing:
ircd-hybrid-7.2/etc/example.conf.in (file contents), Revision 959 by michael, Fri Jul 31 14:42:09 2009 UTC vs.
ircd-hybrid/branches/8.2.x/doc/reference.conf (file contents), Revision 3531 by michael, Thu May 15 15:25:14 2014 UTC

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

Diff Legend

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