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-7.2/etc/example.conf.in (file contents), Revision 954 by michael, Sun Jul 26 22:14:38 2009 UTC vs.
ircd-hybrid/trunk/doc/reference.conf (file contents), Revision 7118 by michael, Sun Jan 24 17:33:20 2016 UTC

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

Diff Legend

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