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

Comparing:
ircd-hybrid-8/etc/example.conf (file contents), Revision 1264 by michael, Tue Jan 17 12:30:57 2012 UTC vs.
ircd-hybrid/trunk/doc/reference.conf (file contents), Revision 2322 by michael, Sun Jun 23 12:01:30 2013 UTC

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

Diff Legend

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