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

Comparing:
ircd-hybrid-8/doc/example.conf (file contents), Revision 1490 by michael, Sat Jul 28 19:33:23 2012 UTC vs.
ircd-hybrid/trunk/doc/reference.conf (file contents), Revision 2012 by michael, Sun May 12 14:47:26 2013 UTC

# Line 1 | Line 1
1 < /* doc/example.conf - ircd-hybrid-8 Example configuration file
2 < * Copyright (C) 2000-2012 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 NOTES:
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
# Line 32 | Line 33
33   * Sizes and times may be singular or plural.  
34   */
35  
36 < /* EFNET NOTE:
36 < *
37 < * This config file is NOT suitable for EFNet.  EFNet admins should use
38 < * example.efnet.conf
39 < */
40 <
36 >
37   /*
38   * serverinfo {}:  contains information about the server
39   */
# 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 86 | Line 81 | serverinfo {
81           */
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 +         * 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 our
102           * rsa key for cryptlink.
103           *
# Line 109 | Line 117 | serverinfo {
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 124 | Line 134 | serverinfo {
134           */
135          #ssl_certificate_file = "/usr/local/ircd/etc/cert.pem";
136  
127
137          /*
138           * ssl_dh_param_file:
139           *
# Line 136 | Line 145 | serverinfo {
145           *
146           *      openssl dhparam -out dhparam.pem 1024
147           *
148 <         * Further information regarding specific OpenSSL dhparam
149 <         * command-line options can be found in the OpenSSL manual.
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 that are supported by _this_ server. Can be used to enforce
158 <         * specific ciphers for incoming SSL/TLS connections.
159 <         * If a client (which also includes incoming server connections) isn't capable
160 <         * of any cipher listed below, the connection will simply be rejected.
157 >         * List of ciphers that are supported by _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) isn't
160 >         * capable of any cipher listed below, the connection will simply be
161 >         * rejected.
162           *
163           * A list of supported ciphers 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 from
168 <         * left to right.
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  
# Line 165 | Line 176 | serverinfo {
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.
168         * SSLv2 is not suppported.
179           */
180          #ssl_server_method = tlsv1, sslv3;
181          #ssl_client_method = tlsv1;
# Line 184 | 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 217 | 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 clients send queue before
238           * they are dropped.
239           */
240          sendq = 100 kbytes;
241 +
242 +        /*
243 +         * recvq: maximum amount of data in a clients 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 236 | Line 253 | class {
253          number_per_ip = 10;
254          max_number = 100;
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          - idle time is randomly selected within the
271 +         *                        range of min_idle to max_idle
272 +         * hide_idle_from_opers - fake idle time will be shown to operators, too
273 +         */
274 +        flags = random_idle, hide_idle_from_opers;
275   };
276  
277   class {
# Line 243 | Line 279 | class {
279          ping_time = 90 seconds;
280  
281          /*
282 <         * ping_warning: how fast a server must reply to a PING before
247 <         * a warning to opers is generated.
248 <         */
249 <        ping_warning = 15 seconds;
250 <
251 <        /*
252 <         * 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 amount 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  
# Line 266 | Line 296 | class {
296   */
297   listen {
298          /*
299 <         * port: the specific port to listen on.  If no host is specified
299 >         * port: the specific port to listen on. If no host is specified
300           * before, it will listen on all available IPs.
301           *
302           * Ports are separated via a comma, a range may be specified using ".."
# Line 279 | Line 309 | listen {
309           * Listen on 192.168.0.1/6697 with ssl enabled and hidden from STATS P
310           * unless you are an administrator.
311           *
312 <         * NOTE: The "flags" directive has to come before "port".  Always!
312 >         * NOTE: The "flags" directive has to come before "port". Always!
313           *
314           * Currently available flags are:
315           *
316 <         *  ssl    - Port is for SSL client connections only
316 >         *  ssl    - Port may only accept TLS/SSL connections
317           *  server - Only server connections are permitted
318           *  hidden - Port is hidden from /stats P, unless you're an admin
319           */
# Line 293 | Line 323 | listen {
323  
324          /*
325           * host: set a specific IP/host the ports after the line will listen
326 <         * on.  This may be ipv4 or ipv6.
326 >         * on. This may be ipv4 or ipv6.
327           */
328          host = "1.2.3.4";
329          port = 7000, 7001;
# Line 307 | Line 337 | listen {
337   */
338   auth {
339          /*
340 <         * user: the user@host allowed to connect.  Multiple IPv4/IPv6 user
340 >         * user: the user@host allowed to connect. Multiple user
341           * lines are permitted per auth block.
342           */
343          user = "*@172.16.0.0/12";
# Line 323 | Line 353 | auth {
353          encrypted = yes;
354  
355          /*
356 <         * spoof: fake the users host to this.  This is free-form,
357 <         * just do everyone a favor and don't abuse it. ('=' prefix on /stats I)
356 >         * spoof: fake the users host to this. This is free-form, just do
357 >         * everyone a favor and don't abuse it. ('=' prefix on /stats I)
358           */
359          spoof = "I.still.hate.packets";
360  
# Line 343 | Line 373 | auth {
373           * resv_exempt   - exempt this user from resvs ('$' prefix on /stats I)
374           * no_tilde      - remove ~ from a user with no ident ('-' prefix on /stats I)
375           * can_flood     - allow this user to exceed flood limits ('|' prefix on /stats I)
376 +         * webirc        - enables WEBIRC authentication for web-based clients such as Mibbit
377 +         *                 ('<' prefix on /stats I)
378           */
379          flags = need_password, spoof_notice, exceed_limit, kline_exempt,
380                  gline_exempt, resv_exempt, no_tilde, can_flood;
# Line 350 | Line 382 | auth {
382  
383   auth {
384          /*
385 <         * redirect: the server and port to redirect a user to.  A user does
386 <         * not have to obey the redirection, the ircd just suggests an alternative
385 >         * redirect: the server and port to redirect a user to. A user does not
386 >         * have to obey the redirection, the ircd just suggests an alternative
387           * server for them.
388           */
389          redirserv = "this.is.not.a.real.server";
# Line 371 | Line 403 | auth {
403  
404   /*
405   * operator {}:  defines ircd operators
374 *
375 * ircd-hybrid no longer supports local operators, privileges are
376 * controlled via flags.
406   */
407   operator {
408          /* name: the name of the oper */
409 <        name = "god";
409 >        name = "sheep";
410  
411          /*
412           * user: the user@host required for this operator. Multiple
413           * user="" lines are supported.
414           */
415 <        user = "*god@192.168.0.0/16";
415 >        user = "*sheep@192.168.0.0/16";
416          user = "*@127.0.0.0/8";
417  
418          /*
419 <         * password: the password required to oper.  By default this will
419 >         * password: the password required to oper. By default this will
420           * need to be encrypted by using the provided mkpasswd tool.
421           * Several password hash algorithms are available depending
422           * on your system's crypt() implementation. For example, a modern
# Line 413 | Line 442 | operator {
442          class = "opers";
443  
444          /*
445 <         * umodes: default usermodes opers get when they /oper.  If defined,
445 >         * umodes: default usermodes opers get when they /oper. If defined,
446           * it will override oper_umodes settings in general {}.
447           * Available usermodes:
448           *
# Line 422 | Line 451 | operator {
451           * +C - cconn_full   - Client connection/quit notices full
452           * +D - deaf         - Don't receive channel messages
453           * +d - debug        - See debugging notices
454 +         * +e - external     - See remote server connection and split notices
455 +         * +F - farconnect   - Remote client connection/quit notices
456           * +f - full         - See auth{} block full notices
457           * +G - softcallerid - Server Side Ignore for users not on your channels
458           * +g - callerid     - Server Side Ignore (for privmsgs etc)
# Line 432 | Line 463 | operator {
463           * +k - skill        - See server generated KILL messages
464           * +l - locops       - See LOCOPS messages
465           * +n - nchange      - See client nick changes
466 +         * +R - nononreg     - Only receive private messages from registered clients
467           * +s - servnotice   - See general server notices
468           * +u - unauth       - See unauthorized client notices
469           * +w - wallop       - See server generated WALLOPS
438         * +x - external     - See remote server connection and split notices
470           * +y - spy          - See LINKS, STATS, TRACE notices etc.
471           * +z - operwall     - See oper generated WALLOPS
472           */
# Line 446 | Line 477 | operator {
477           * allowed to do on the server. All options default to no.
478           * Available options:
479           *
480 <         * module       - allows MODULE
481 <         * global_kill  - allows remote users to be /KILL'd
482 <         * remote       - allows remote SQUIT and CONNECT
483 <         * remoteban    - allows remote KLINE/UNKLINE
484 <         * dline        - allows DLINE
485 <         * undline      - allows UNDLINE
486 <         * kline        - allows KILL and KLINE
487 <         * unkline      - allows UNKLINE
488 <         * gline        - allows GLINE
489 <         * xline        - allows XLINE
490 <         * globops      - allows GLOBOPS
491 <         * operwall     - allows OPERWALL
492 <         * nick_changes - allows oper to see nickchanges via usermode +n
493 <         * rehash       - allows oper to REHASH config
494 <         * die          - allows DIE
495 <         * restart      - allows RESTART
496 <         * set          - allows SET
497 <         * admin        - gives admin privileges. admins for example,
498 <         *                may see the real IP addresses of servers.
480 >         * module         - allows MODULE
481 >         * connect        - allows local CONNECT
482 >         * connect:remote - allows remote CONNECT
483 >         * squit          - allows local SQUIT
484 >         * squit:remote   - allows remote SQUIT
485 >         * kill           - allows to KILL local clients
486 >         * kill:remote    - allows remote users to be /KILL'd
487 >         * remoteban      - allows remote KLINE/UNKLINE
488 >         * dline          - allows DLINE
489 >         * undline        - allows UNDLINE
490 >         * kline          - allows KILL and KLINE
491 >         * unkline        - allows UNKLINE
492 >         * gline          - allows GLINE
493 >         * xline          - allows XLINE
494 >         * globops        - allows GLOBOPS
495 >         * operwall       - allows OPERWALL
496 >         * rehash         - allows oper to REHASH config
497 >         * die            - allows DIE
498 >         * restart        - allows RESTART
499 >         * set            - allows SET
500 >         * admin          - gives admin privileges. admins for example,
501 >         *                  may see the real IP addresses of servers.
502           */
503 <        flags = global_kill, remote, kline, unkline, xline, globops, restart,
504 <                die, rehash, nick_changes, admin, operwall, module;
503 >        flags = kill, kill:remote, connect, connect:remote, kline, unkline,
504 >                xline, globops, restart, die, rehash, admin, operwall, module;
505   };
506  
507 + /*
508 + * service {}: specifies what server may act as a network service
509 + *
510 + * NOTE: it is absolutely important that every single server on the network
511 + *       has the same service{} block.
512 + */
513   service {
514          name = "service.someserver";
515          name = "stats.someserver";
# Line 483 | Line 523 | connect {
523          name = "irc.uplink.com";
524  
525          /*
526 <         * host: the host or IP to connect to.  If a hostname is used it
526 >         * host: the host or IP to connect to. If a hostname is used it
527           * must match the reverse dns of the server.
528           */
529          host = "192.168.0.1";
# Line 512 | Line 552 | connect {
552          port = 6666;
553  
554          /*
555 <         * hub_mask: the mask of servers that this server may hub.  Multiple
556 <         * entries are permitted
555 >         * hub_mask: the mask of servers that this server may hub. Multiple
556 >         * entries are permitted.
557           */
558          hub_mask = "*";
559  
560          /*
561 <         * leaf_mask: the mask of servers this server may not hub.  Multiple
562 <         * entries are permitted.  Useful for forbidding EU -> US -> EU routes.
561 >         * leaf_mask: the mask of servers this server may not hub. Multiple
562 >         * entries are permitted. Useful for forbidding EU -> US -> EU routes.
563           */
564   #       leaf_mask = "*.uk";
565  
566          /* class: the class this server is in */
567          class = "server";
568  
569 +        /*
570 +         * ssl_cipher_list:
571 +         *
572 +         * List of ciphers that the server we are connecting to must support.
573 +         * If the server isn't capable of any cipher listed below, the
574 +         * connection will simply be rejected.
575 +         * Can be used to enforce stronger ciphers, even though this option
576 +         * is not necessarily required to establish a SSL/TLS connection.
577 +         *
578 +         * Multiple ciphers are separated by colons. The order of preference
579 +         * is from left to right.
580 +         */
581          #ssl_cipher_list = "DHE-RSA-AES256-SHA:AES256-SHA";
582  
583          /*
584           * autoconn   - controls whether we autoconnect to this server or not,
585           *              dependent on class limits. By default, this is disabled.
534         * burst_away - This will send the /away string that users have set
535         *              on the server burst. Note this can be a lot of data
536         *              and slow down your server burst.
537         * topicburst - Send topics to this server during channel burst. Works
538         *              only if the server we are connecting to is capable
539         *              of TBURST/TB.
586           * ssl        - Initiates a TLS/SSL connection.
587           */
588 < #       flags = autoconn, burst_away, topicburst;
588 > #       flags = autoconn, ssl;
589   };
590  
591   connect {
# Line 596 | Line 642 | cluster {
642   *
643   * NOTE: This can be effectively used for remote klines.
644   *       Please note that there is no password authentication
645 < *       for users setting remote klines.  You must also be
645 > *       for users setting remote klines. You must also be
646   *       /oper'd in order to issue a remote kline.
647   */
648   shared {
649          /*
650 <         * name: the server the user must be on to set klines.  If this is not
650 >         * name: the server the user must be on to set klines. If this is not
651           * specified, the user will be allowed to kline from all servers.
652           */
653          name = "irc2.some.server";
654  
655          /*
656 <         * user: the user@host mask that is allowed to set klines.  If this is
656 >         * user: the user@host mask that is allowed to set klines. If this is
657           * not specified, all users on the server above will be allowed to set
658           * a remote kline.
659           */
# Line 638 | Line 684 | kill {
684          reason = "Obviously hacked account";
685   };
686  
641 kill {
642        user = "^O[[:alpha:]]?[[:digit:]]+(x\.o|\.xo)$@^[[:alnum:]]{4}\.evilnet.tld$";
643
644        /*
645         * NOTE: You have to set type=regex; when using a regular expression
646         * based user entry
647         */
648        type = regex;
649 };
650
687   /*
688   * deny {}:  IPs that are not allowed to connect (before DNS/ident lookup)
689   * Oper issued dlines will be added to the specified dline config
# Line 658 | Line 694 | deny {
694   };
695  
696   /*
697 < * exempt {}: IPs that are exempt from deny {} and Dlines
697 > * exempt {}:  IPs that are exempt from deny {} and Dlines
698   */
699   exempt {
700          ip = "192.168.0.0/16";
# Line 667 | Line 703 | exempt {
703   /*
704   * resv {}:  nicks and channels users may not use/join
705   */
706 + resv { mask = "clone*"; reason = "Clone bots"; };
707 + resv { mask = "ChanServ"; reason = "Reserved for services"; };
708 + resv { mask = "NickServ"; reason = "Reserved for services"; };
709 + resv { mask = "OperServ"; reason = "Reserved for services"; };
710 + resv { mask = "MemoServ"; reason = "Reserved for services"; };
711 + resv { mask = "BotServ"; reason = "Reserved for services"; };
712 + resv { mask = "HelpServ"; reason = "Reserved for services"; };
713 + resv { mask = "HostServ"; reason = "Reserved for services"; };
714 + resv { mask = "StatServ"; reason = "Reserved for services"; };
715 + resv { mask = "#*services*"; reason = "Reserved for services"; };
716 +
717   resv {
718 <        /* reason: the reason for the proceeding resv's */
719 <        reason = "Reserved for services";
718 >        /*
719 >         * mask: masks starting with a '#' are automatically considered
720 >         * as channel name mask.
721 >         */
722 >        mask = "#helsinki";
723 >        reason = "Channel is reserved for finnish inhabitants";
724  
725 <        /* resv: the nicks and channels users may not join/use */
726 <        nick = "Global";
727 <        nick = "DevNull";
728 <        nick = "BotServ";
729 <        nick = "Services";
730 <        nick = "StatServ";
680 <        nick = "HelpServ";
681 <        nick = "HostServ";
682 <        nick = "NickServ";
683 <        nick = "ChanServ";
684 <        nick = "MemoServ";
685 <        nick = "OperServ";
686 <        channel = "#services";
687 <
688 <        /* resv: wildcard masks are also supported in nicks only */
689 <        reason = "Clone bots";
690 <        nick = "clone*";
725 >        /*
726 >         * exempt: can be either a ISO 3166 alpha-2 two letter country
727 >         * code, or a nick!user@host mask. CIDR is supported. Exempt
728 >         * entries can be stacked.
729 >         */
730 >        exempt = "FI";
731   };
732  
733   /*
734 < * gecos {}:  The X: replacement, used for banning users based on
695 < * their "realname".
734 > * gecos {}:  Used for banning users based on their "realname".
735   */
736   gecos {
737          name = "*sex*";
# Line 704 | Line 743 | gecos {
743          reason = "Trojan drone";
744   };
745  
707 gecos {
708        name = "*http*";
709        reason = "Spambot";
710 };
711
712 gecos {
713        name = "^\[J[0o]hn Do[3e]\]-[0-9]{2,5}$";
714
715        /*
716         * NOTE: You have to set type=regex; when using a regular expression
717         * based name entry
718         */
719        type = regex;
720 };
721
746   /*
747   * channel {}:  The channel block contains options pertaining to channels
748   */
# Line 739 | Line 763 | channel {
763          disable_fake_channels = yes;
764  
765          /*
742         * restrict_channels: reverse channel RESVs logic, only reserved
743         * channels are allowed
744         */
745        restrict_channels = no;
746
747        /*
748         * use_invex: Enable/disable channel mode +I, a n!u@h list of masks
749         * that can join a +i channel without an invite.
750         */
751        use_invex = yes;
752
753        /*
754         * use_except: Enable/disable channel mode +e, a n!u@h list of masks
755         * that can join a channel through a ban (+b).
756         */
757        use_except = yes;
758
759        /*
760         * use_knock: Allows users to request an invite to a channel that
761         * is locked somehow (+ikl).  If the channel is +p or you are banned
762         * the knock will not be sent.
763         */
764        use_knock = yes;
765
766        /*
766           * knock_delay: The amount of time a user must wait between issuing
767           * the knock command.
768           */
# Line 787 | Line 786 | channel {
786           */
787          max_chans_per_oper = 50;
788  
790        /* quiet_on_ban: stop banned people talking in channels. */
791        quiet_on_ban = yes;
792
789          /* max_bans: maximum number of +b/e/I modes in a channel */
790 <        max_bans = 25;
790 >        max_bans = 100;
791  
792          /*
793           * how many joins in how many seconds constitute a flood, use 0 to
# Line 811 | Line 807 | channel {
807  
808          /*
809           * default_split_user_count: when the usercount is lower than this level,
810 <         * consider ourselves split.  This must be set for automatic splitmode.
810 >         * consider ourselves split. This must be set for automatic splitmode.
811           */
812          default_split_user_count = 0;
813  
814          /*
815           * default_split_server_count: when the servercount is lower than this,
816 <         * consider ourselves split.  This must be set for automatic splitmode.
816 >         * consider ourselves split. This must be set for automatic splitmode.
817           */
818          default_split_server_count = 0;
819  
# Line 835 | Line 831 | channel {
831   serverhide {
832          /*
833           * flatten_links: this option will show all servers in /links appear
834 <         * that they are linked to this current server
834 >         * that they are linked to this current server.
835           */
836          flatten_links = no;
837  
# Line 847 | Line 843 | serverhide {
843  
844          /*
845           * hidden: hide this server from a /links output on servers that
846 <         * support it.  This allows hub servers to be hidden etc.
846 >         * support it. This allows hub servers to be hidden etc.
847           */
848          hidden = no;
849  
# Line 858 | Line 854 | serverhide {
854          hide_servers = no;
855  
856          /*
857 +         * hide_services: define this if you want to hide the location of
858 +         * services servers that are specified in the service{} block.
859 +         */
860 +        hide_services = no;
861 +
862 +        /*
863           * Use this as the servername users see if hide_servers = yes.
864           */
865          hidden_name = "*.hidden.com";
# Line 872 | Line 874 | serverhide {
874           * logfiles.
875           *
876           * We recommend you leave this disabled, and just take care with who you
877 <         * give admin=yes; to.
877 >         * give administrator privileges to.
878           */
879          hide_server_ips = no;
880   };
881  
882   /*
883   * general {}:  The general block contains many of the options that were once
884 < * compiled in options in config.h.  The general block is read at start time.
884 > * compiled in options in config.h
885   */
886   general {
887          /* services_name: servername of nick/channel services */
# Line 888 | Line 890 | general {
890          /* max_watch: maximum WATCH entries a client can have. */
891          max_watch = 60;
892  
893 <        /* gline_enable: enable glines, network wide temp klines */
893 >        /* gline_enable: enable glines, network wide temp klines. */
894          gline_enable = yes;
895  
896          /*
897           * gline_duration: the amount of time a gline will remain on your
898 <         * server before expiring
898 >         * server before expiring.
899           */
900          gline_duration = 1 day;
901  
902          /*
903 <         * gline_request_duration:  how long a pending G-line can be around.
904 <         * 10 minutes should be plenty
903 >         * gline_request_duration: how long a pending G-line can be around.
904 >         * 10 minutes should be plenty.
905           */
906          gline_request_duration = 10 minutes;
907  
908          /*
909           * gline_min_cidr: the minimum required length of a CIDR bitmask
910 <         * for IPv4 based glines
910 >         * for IPv4 based glines.
911           */
912          gline_min_cidr = 16;
913  
914          /*
915           * gline_min_cidr6: the minimum required length of a CIDR bitmask
916 <         * for IPv6 based glines
916 >         * for IPv6 based glines.
917           */
918          gline_min_cidr6 = 48;
919  
# Line 921 | Line 923 | general {
923          invisible_on_connect = yes;
924  
925          /*
926 <         * Show "actually using host <ip>" on /whois when possible.
927 <         */
928 <        use_whois_actually = yes;
927 <
928 <        /*
929 <         * Max time from the nickname change that still causes KILL
930 <         * automatically to switch for the current nick of that user.
926 >         * kill_chase_time_limit: maximum time from the nickname change that
927 >         * still causes KILL automatically to switch for the current nick of
928 >         * that user.
929           */
930          kill_chase_time_limit = 90 seconds;
931  
932          /*
933 <         * If hide_spoof_ips is disabled, opers will be allowed to see the real
933 >         * hide_spoof_ips: if disabled, opers will be allowed to see the real
934           * IP of spoofed users in /trace etc. If this is defined they will be
935           * shown a masked IP.
936           */
937          hide_spoof_ips = yes;
938  
939          /*
940 <         * Ignore bogus timestamps from other servers.  Yes, this will desync
941 <         * the network, but it will allow chanops to resync with a valid non TS 0
940 >         * Ignore bogus timestamps from other servers. Yes, this will desync the
941 >         * network, but it will allow chanops to resync with a valid non TS 0
942           *
943           * This should be enabled network wide, or not at all.
944           */
# Line 952 | Line 950 | general {
950           */
951          disable_auth = no;
952  
953 <        /* disable_remote_commands: disable users doing commands on remote servers */
953 >        /* disable_remote_commands: disable users doing commands on remote servers. */
954          disable_remote_commands = no;
955  
956          /*
# Line 963 | Line 961 | general {
961  
962          /*
963           * default_floodcount: the default value of floodcount that is configurable
964 <         * via /quote set floodcount.  This is the amount of lines a user
964 >         * via /quote set floodcount. This is the amount of lines a user
965           * may send to any other user/channel in one second.
966           */
967          default_floodcount = 10;
# Line 982 | Line 980 | general {
980  
981          /*
982           * min_nonwildcard: the minimum non wildcard characters in k/d/g lines
983 <         * placed via the server.  klines hand placed are exempt from limits.
983 >         * placed via the server. K-lines hand placed are exempt from limits.
984           * wildcard chars: '.' ':' '*' '?' '@' '!' '#'
985           */
986          min_nonwildcard = 4;
987  
988          /*
989           * min_nonwildcard_simple: the minimum non wildcard characters in
990 <         * gecos bans.  wildcard chars: '*' '?' '#'
990 >         * gecos bans. wildcard chars: '*' '?' '#'
991           */
992          min_nonwildcard_simple = 3;
993  
994 <        /* max_accept: maximum allowed /accept's for +g usermode */
994 >        /* max_accept: maximum allowed /accept's for +g usermode. */
995          max_accept = 20;
996  
997 <        /* anti_nick_flood: enable the nickflood control code */
997 >        /* anti_nick_flood: enable the nickflood control code. */
998          anti_nick_flood = yes;
999  
1000          /* nick flood: the nick changes allowed in the specified period */
# Line 1011 | Line 1009 | general {
1009  
1010          /*
1011           * ts delta: the time delta allowed between server clocks before
1012 <         * a warning is given, or before the link is dropped.  all servers
1012 >         * a warning is given, or before the link is dropped. All servers
1013           * should run ntpdate/rdate to keep clocks in sync
1014           */
1015          ts_warn_delta = 30 seconds;
1016          ts_max_delta = 5 minutes;
1017  
1018          /*
1021         * kline_with_reason: show the user the reason why they are k/d/glined
1022         * on exit.  May give away who set k/dline when set via tcm.
1023         */
1024        kline_with_reason = yes;
1025
1026        /*
1027         * kline_reason: show this message to users on channel
1028         * instead of the oper reason.
1029         */
1030        kline_reason = "Connection closed";
1031
1032        /*
1033         * reject_hold_time: wait this amount of time before disconnecting
1034         * a rejected client. Use 0 to disable.
1035         */
1036        reject_hold_time = 0;
1037
1038        /*
1019           * warn_no_nline: warn opers about servers that try to connect but
1020 <         * we don't have a connect {} block for.  Twits with misconfigured
1020 >         * we don't have a connect {} block for. Twits with misconfigured
1021           * servers can get really annoying with this enabled.
1022           */
1023          warn_no_nline = yes;
1024  
1025          /*
1026           * stats_e_disabled: set this to 'yes' to disable "STATS e" for both
1027 <         * operators and administrators.  Doing so is a good idea in case
1027 >         * operators and administrators. Doing so is a good idea in case
1028           * there are any exempted (exempt{}) server IPs you don't want to
1029           * see leaked.
1030           */
# Line 1057 | Line 1037 | general {
1037          stats_P_oper_only = yes;
1038  
1039          /*
1040 <         * stats i oper only: make stats i (auth {}) oper only. set to:
1041 <         *     yes:    show users no auth blocks, made oper only.
1042 <         *     masked: show users first matching auth block
1043 <         *     no:     show users all auth blocks.
1040 >         * stats i oper only: make stats i (auth {}) oper only. Set to:
1041 >         *     yes    - show users no auth blocks, made oper only.
1042 >         *     masked - show users first matching auth block
1043 >         *     no     - show users all auth blocks.
1044           */
1045          stats_i_oper_only = yes;
1046  
1047          /*
1048 <         * stats_k_oper_only: make stats k/K (klines) oper only.  set to:
1049 <         *     yes:    show users no auth blocks, made oper only
1050 <         *     masked: show users first matching auth block
1051 <         *     no:     show users all auth blocks.
1048 >         * stats_k_oper_only: make stats k/K (klines) oper only. Set to:
1049 >         *     yes    - show users no auth blocks, made oper only
1050 >         *     masked - show users first matching auth block
1051 >         *     no     - show users all auth blocks.
1052           */
1053          stats_k_oper_only = yes;
1054  
# Line 1113 | Line 1093 | general {
1093  
1094          /*
1095           * true_no_oper_flood: completely eliminate flood limits for opers
1096 <         * and for clients with can_flood = yes in their auth {} blocks
1096 >         * and for clients with can_flood = yes in their auth {} blocks.
1097           */
1098          true_no_oper_flood = yes;
1099  
1100 <        /* oper_pass_resv: allow opers to over-ride RESVs on nicks/channels */
1100 >        /* oper_pass_resv: allow opers to over-ride RESVs on nicks/channels. */
1101          oper_pass_resv = yes;
1102  
1103          /* REMOVE ME.  The following line checks you've been reading. */
# Line 1125 | Line 1105 | general {
1105  
1106          /*
1107           * max_targets: the maximum amount of targets in a single
1108 <         * PRIVMSG/NOTICE.  Set to 999 NOT 0 for unlimited.
1108 >         * PRIVMSG/NOTICE. Set to 999 NOT 0 for unlimited.
1109           */
1110          max_targets = 4;
1111  
1112          /*
1133         * client_flood: maximum amount of data in a clients queue before
1134         * they are dropped for flooding.
1135         */
1136        client_flood = 2560 bytes;
1137
1138        /*
1139         * message_locale: the default message locale
1140         * Use "standard" for the compiled in defaults.
1141         * To install the translated messages, go into messages/ in the
1142         * source directory and run `make install'.
1143         */
1144        message_locale = "standard";
1145
1146        /*
1113           * usermodes configurable: a list of usermodes for the options below
1114           *
1115           * +b - bots         - See bot and drone flooding notices
# Line 1151 | Line 1117 | general {
1117           * +C - cconn_full   - Client connection/quit notices full
1118           * +D - deaf         - Don't receive channel messages
1119           * +d - debug        - See debugging notices
1120 +         * +e - external     - See remote server connection and split notices
1121 +         * +F - farconnect   - Remote client connection/quit notices
1122           * +f - full         - See auth{} block full notices
1123           * +G - softcallerid - Server Side Ignore for users not on your channels
1124           * +g - callerid     - Server Side Ignore (for privmsgs etc)
# Line 1161 | Line 1129 | general {
1129           * +k - skill        - See server generated KILL messages
1130           * +l - locops       - See LOCOPS messages
1131           * +n - nchange      - See client nick changes
1132 +         * +R - nononreg     - Only receive private messages from registered clients
1133           * +s - servnotice   - See general server notices
1134           * +u - unauth       - See unauthorized client notices
1135           * +w - wallop       - See server generated WALLOPS
1167         * +x - external     - See remote server connection and split notices
1136           * +y - spy          - See LINKS, STATS, TRACE notices etc.
1137           * +z - operwall     - See oper generated WALLOPS
1138           */
# Line 1172 | Line 1140 | general {
1140          /* oper_only_umodes: usermodes only opers may set */
1141          oper_only_umodes = bots, cconn, cconn_full, debug, full, hidden, skill,
1142                             nchange, rej, spy, external, operwall,
1143 <                           locops, unauth;
1143 >                           locops, unauth, farconnect;
1144  
1145          /* oper_umodes: default usermodes opers get when they /oper */
1146          oper_umodes = bots, locops, servnotice, operwall, wallop;
1147  
1148          /*
1149           * use_egd: if your system does not have *random devices yet you
1150 <         * want to use OpenSSL and encrypted links, enable this.  Beware -
1151 <         * EGD is *very* CPU intensive when gathering data for its pool
1150 >         * want to use OpenSSL and encrypted links, enable this. Beware -
1151 >         * EGD is *very* CPU intensive when gathering data for its pool.
1152           */
1153   #       use_egd = yes;
1154  
# Line 1192 | Line 1160 | general {
1160  
1161          /*
1162           * throttle_time: the minimum amount of time between connections from
1163 <         * the same ip.  exempt {} blocks are excluded from this throttling.
1164 <         * Offers protection against flooders who reconnect quickly.  
1163 >         * the same ip. exempt {} blocks are excluded from this throttling.
1164 >         * Offers protection against flooders who reconnect quickly.
1165           * Set to 0 to disable.
1166           */
1167          throttle_time = 10;
# Line 1207 | Line 1175 | modules {
1175          path = "/usr/local/ircd/lib/ircd-hybrid/modules";
1176          path = "/usr/local/ircd/lib/ircd-hybrid/modules/autoload";
1177  
1178 <        /* module: the name of a module to load on startup/rehash */
1178 >        /* module: the name of a module to load on startup/rehash. */
1179          #module = "some_module.la";
1180   };
1181  
# Line 1258 | Line 1226 | log {
1226                  type = debug;
1227                  name = "/home/ircd/var/log/debug.log";
1228                  size = 50 megabytes;
1229 <        };
1229 >        };
1230   };

Diff Legend

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