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/doc/example.conf (file contents), Revision 1547 by michael, Sun Sep 30 17:50:03 2012 UTC vs.
ircd-hybrid/trunk/doc/reference.conf (file contents), Revision 2150 by michael, Fri May 31 18:39:43 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 * doc/.
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.
# Line 62 | Line 58 | serverinfo {
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 85 | 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 108 | 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 148 | Line 159 | serverinfo {
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
# Line 182 | Line 194 | admin {
194   * class {}:  contains information about classes for users
195   */
196   class {
197 <        /* name: the name of the class */
197 >        /* name: the name of the class. */
198          name = "users";
199  
200          /*
# Line 215 | 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;
# Line 241 | 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 248 | Line 279 | class {
279          ping_time = 90 seconds;
280  
281          /*
282 <         * ping_warning: how fast a server must reply to a PING before
252 <         * a warning to opers is generated.
253 <         */
254 <        ping_warning = 15 seconds;
255 <
256 <        /*
257 <         * 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  
294   /*
295 + * motd {}: specifies various MOTD files. Applies to local users only.
296 + */
297 + motd {
298 +        /*
299 +         * mask: multiple mask entries are permitted. Mask can either be
300 +         * a class name or a hostname.
301 +         */
302 +        mask = "*.at";
303 +        mask = "*.de";
304 +        mask = "*.ch";
305 +
306 +        /*
307 +         * file: path top the actual motd file.
308 +         */
309 +        file = "/usr/local/ircd/etc/german.motd";
310 + };
311 +
312 + /*
313   * listen {}:  contains information about the ports ircd listens on
314   */
315   listen {
316          /*
317 <         * port: the specific port to listen on.  If no host is specified
317 >         * port: the specific port to listen on. If no host is specified
318           * before, it will listen on all available IPs.
319           *
320           * Ports are separated via a comma, a range may be specified using ".."
# Line 284 | Line 327 | listen {
327           * Listen on 192.168.0.1/6697 with ssl enabled and hidden from STATS P
328           * unless you are an administrator.
329           *
330 <         * NOTE: The "flags" directive has to come before "port".  Always!
330 >         * NOTE: The "flags" directive has to come before "port". Always!
331           *
332           * Currently available flags are:
333           *
334 <         *  ssl    - Port is for SSL client connections only
334 >         *  ssl    - Port may only accept TLS/SSL connections
335           *  server - Only server connections are permitted
336           *  hidden - Port is hidden from /stats P, unless you're an admin
337           */
# Line 298 | Line 341 | listen {
341  
342          /*
343           * host: set a specific IP/host the ports after the line will listen
344 <         * on.  This may be ipv4 or ipv6.
344 >         * on. This may be ipv4 or ipv6.
345           */
346          host = "1.2.3.4";
347          port = 7000, 7001;
# Line 328 | Line 371 | auth {
371          encrypted = yes;
372  
373          /*
374 <         * spoof: fake the users host to this.  This is free-form,
375 <         * just do everyone a favor and don't abuse it. ('=' prefix on /stats I)
374 >         * spoof: fake the users host to this. This is free-form, just do
375 >         * everyone a favor and don't abuse it. ('=' prefix on /stats I)
376           */
377          spoof = "I.still.hate.packets";
378  
# Line 348 | Line 391 | auth {
391           * resv_exempt   - exempt this user from resvs ('$' prefix on /stats I)
392           * no_tilde      - remove ~ from a user with no ident ('-' prefix on /stats I)
393           * can_flood     - allow this user to exceed flood limits ('|' prefix on /stats I)
394 +         * webirc        - enables WEBIRC authentication for web-based clients such as Mibbit
395 +         *                 ('<' prefix on /stats I)
396           */
397          flags = need_password, spoof_notice, exceed_limit, kline_exempt,
398                  gline_exempt, resv_exempt, no_tilde, can_flood;
# Line 355 | Line 400 | auth {
400  
401   auth {
402          /*
403 <         * redirect: the server and port to redirect a user to.  A user does
404 <         * not have to obey the redirection, the ircd just suggests an alternative
403 >         * redirect: the server and port to redirect a user to. A user does not
404 >         * have to obey the redirection, the ircd just suggests an alternative
405           * server for them.
406           */
407          redirserv = "this.is.not.a.real.server";
# Line 376 | Line 421 | auth {
421  
422   /*
423   * operator {}:  defines ircd operators
379 *
380 * ircd-hybrid no longer supports local operators, privileges are
381 * controlled via flags.
424   */
425   operator {
426          /* name: the name of the oper */
# Line 392 | Line 434 | operator {
434          user = "*@127.0.0.0/8";
435  
436          /*
437 <         * password: the password required to oper.  By default this will
437 >         * password: the password required to oper. By default this will
438           * need to be encrypted by using the provided mkpasswd tool.
439           * Several password hash algorithms are available depending
440           * on your system's crypt() implementation. For example, a modern
# Line 418 | Line 460 | operator {
460          class = "opers";
461  
462          /*
463 <         * umodes: default usermodes opers get when they /oper.  If defined,
463 >         * umodes: default usermodes opers get when they /oper. If defined,
464           * it will override oper_umodes settings in general {}.
465           * Available usermodes:
466           *
# Line 427 | Line 469 | operator {
469           * +C - cconn_full   - Client connection/quit notices full
470           * +D - deaf         - Don't receive channel messages
471           * +d - debug        - See debugging notices
472 +         * +e - external     - See remote server connection and split notices
473 +         * +F - farconnect   - Remote client connection/quit notices
474           * +f - full         - See auth{} block full notices
475           * +G - softcallerid - Server Side Ignore for users not on your channels
476           * +g - callerid     - Server Side Ignore (for privmsgs etc)
# Line 437 | Line 481 | operator {
481           * +k - skill        - See server generated KILL messages
482           * +l - locops       - See LOCOPS messages
483           * +n - nchange      - See client nick changes
484 +         * +R - nononreg     - Only receive private messages from registered clients
485           * +s - servnotice   - See general server notices
486           * +u - unauth       - See unauthorized client notices
487           * +w - wallop       - See server generated WALLOPS
443         * +x - external     - See remote server connection and split notices
488           * +y - spy          - See LINKS, STATS, TRACE notices etc.
489           * +z - operwall     - See oper generated WALLOPS
490           */
# Line 451 | Line 495 | operator {
495           * allowed to do on the server. All options default to no.
496           * Available options:
497           *
498 <         * module       - allows MODULE
499 <         * global_kill  - allows remote users to be /KILL'd
500 <         * remote       - allows remote SQUIT and CONNECT
501 <         * remoteban    - allows remote KLINE/UNKLINE
502 <         * dline        - allows DLINE
503 <         * undline      - allows UNDLINE
504 <         * kline        - allows KILL and KLINE
505 <         * unkline      - allows UNKLINE
506 <         * gline        - allows GLINE
507 <         * xline        - allows XLINE
508 <         * globops      - allows GLOBOPS
509 <         * operwall     - allows OPERWALL
510 <         * nick_changes - allows oper to see nickchanges via usermode +n
511 <         * rehash       - allows oper to REHASH config
512 <         * die          - allows DIE
513 <         * restart      - allows RESTART
514 <         * set          - allows SET
515 <         * admin        - gives admin privileges. admins for example,
516 <         *                may see the real IP addresses of servers.
498 >         * module         - allows MODULE
499 >         * connect        - allows local CONNECT              | ('P' flag)
500 >         * connect:remote - allows remote CONNECT             | ('Q' flag)
501 >         * squit          - allows local SQUIT                | ('R' flag)
502 >         * squit:remote   - allows remote SQUIT               | ('S' flag)
503 >         * kill           - allows to KILL local clients      | ('N' flag)
504 >         * kill:remote    - allows remote users to be /KILL'd | ('O' flag)
505 >         * remoteban      - allows remote KLINE/UNKLINE       | ('B' flag)
506 >         * dline          - allows DLINE                      |
507 >         * undline        - allows UNDLINE                    |
508 >         * kline          - allows KLINE                      | ('K' flag)
509 >         * unkline        - allows UNKLINE                    | ('U' flag)
510 >         * gline          - allows GLINE                      | ('G' flag)
511 >         * xline          - allows XLINE                      | ('X' flag)
512 >         * locops         - allows LOCOPS                     |
513 >         * globops        - allows GLOBOPS                    |
514 >         * wallops        - allows WALLOPS                    |
515 >         * operwall       - allows OPERWALL                   | ('L' flag)
516 >         * rehash         - allows oper to REHASH config      | ('H' flag)
517 >         * die            - allows DIE                        | ('D' flag)
518 >         * restart        - allows RESTART                    |
519 >         * set            - allows SET                        |
520 >         * admin          - gives administrator privileges    | ('A' flag)
521           */
522 <        flags = global_kill, remote, kline, unkline, xline, globops, restart,
523 <                die, rehash, nick_changes, admin, operwall, module;
522 >        flags = kill, kill:remote, connect, connect:remote, kline, unkline,
523 >                xline, globops, restart, die, rehash, admin, operwall, module;
524   };
525  
526 + /*
527 + * service {}: specifies what server may act as a network service
528 + *
529 + * NOTE: it is absolutely important that every single server on the network
530 + *       has the same service{} block.
531 + */
532   service {
533          name = "service.someserver";
534          name = "stats.someserver";
# Line 488 | Line 542 | connect {
542          name = "irc.uplink.com";
543  
544          /*
545 <         * host: the host or IP to connect to.  If a hostname is used it
545 >         * host: the host or IP to connect to. If a hostname is used it
546           * must match the reverse dns of the server.
547           */
548          host = "192.168.0.1";
# Line 517 | Line 571 | connect {
571          port = 6666;
572  
573          /*
574 <         * hub_mask: the mask of servers that this server may hub.  Multiple
575 <         * entries are permitted
574 >         * hub_mask: the mask of servers that this server may hub. Multiple
575 >         * entries are permitted.
576           */
577          hub_mask = "*";
578  
579          /*
580 <         * leaf_mask: the mask of servers this server may not hub.  Multiple
581 <         * entries are permitted.  Useful for forbidding EU -> US -> EU routes.
580 >         * leaf_mask: the mask of servers this server may not hub. Multiple
581 >         * entries are permitted. Useful for forbidding EU -> US -> EU routes.
582           */
583   #       leaf_mask = "*.uk";
584  
# Line 607 | Line 661 | cluster {
661   *
662   * NOTE: This can be effectively used for remote klines.
663   *       Please note that there is no password authentication
664 < *       for users setting remote klines.  You must also be
664 > *       for users setting remote klines. You must also be
665   *       /oper'd in order to issue a remote kline.
666   */
667   shared {
668          /*
669 <         * name: the server the user must be on to set klines.  If this is not
669 >         * name: the server the user must be on to set klines. If this is not
670           * specified, the user will be allowed to kline from all servers.
671           */
672          name = "irc2.some.server";
673  
674          /*
675 <         * user: the user@host mask that is allowed to set klines.  If this is
675 >         * user: the user@host mask that is allowed to set klines. If this is
676           * not specified, all users on the server above will be allowed to set
677           * a remote kline.
678           */
# Line 649 | Line 703 | kill {
703          reason = "Obviously hacked account";
704   };
705  
652 kill {
653        user = "^O[[:alpha:]]?[[:digit:]]+(x\.o|\.xo)$@^[[:alnum:]]{4}\.evilnet.tld$";
654
655        /*
656         * NOTE: You have to set type=regex; when using a regular expression
657         * based user entry
658         */
659        type = regex;
660 };
661
706   /*
707   * deny {}:  IPs that are not allowed to connect (before DNS/ident lookup)
708   * Oper issued dlines will be added to the specified dline config
# Line 669 | Line 713 | deny {
713   };
714  
715   /*
716 < * exempt {}: IPs that are exempt from deny {} and Dlines
716 > * exempt {}:  IPs that are exempt from deny {} and Dlines
717   */
718   exempt {
719          ip = "192.168.0.0/16";
# Line 678 | Line 722 | exempt {
722   /*
723   * resv {}:  nicks and channels users may not use/join
724   */
725 + resv { mask = "clone*"; reason = "Clone bots"; };
726 + resv { mask = "ChanServ"; reason = "Reserved for services"; };
727 + resv { mask = "NickServ"; reason = "Reserved for services"; };
728 + resv { mask = "OperServ"; reason = "Reserved for services"; };
729 + resv { mask = "MemoServ"; reason = "Reserved for services"; };
730 + resv { mask = "BotServ"; reason = "Reserved for services"; };
731 + resv { mask = "HelpServ"; reason = "Reserved for services"; };
732 + resv { mask = "HostServ"; reason = "Reserved for services"; };
733 + resv { mask = "StatServ"; reason = "Reserved for services"; };
734 + resv { mask = "#*services*"; reason = "Reserved for services"; };
735 +
736   resv {
737 <        /* reason: the reason for the proceeding resv's */
738 <        reason = "Reserved for services";
737 >        /*
738 >         * mask: masks starting with a '#' are automatically considered
739 >         * as channel name mask.
740 >         */
741 >        mask = "#helsinki";
742 >        reason = "Channel is reserved for finnish inhabitants";
743  
744 <        /* resv: the nicks and channels users may not join/use */
745 <        nick = "Global";
746 <        nick = "DevNull";
747 <        nick = "BotServ";
748 <        nick = "Services";
749 <        nick = "StatServ";
691 <        nick = "HelpServ";
692 <        nick = "HostServ";
693 <        nick = "NickServ";
694 <        nick = "ChanServ";
695 <        nick = "MemoServ";
696 <        nick = "OperServ";
697 <        channel = "#services";
698 <
699 <        /* resv: wildcard masks are also supported in nicks only */
700 <        reason = "Clone bots";
701 <        nick = "clone*";
744 >        /*
745 >         * exempt: can be either a ISO 3166 alpha-2 two letter country
746 >         * code, or a nick!user@host mask. CIDR is supported. Exempt
747 >         * entries can be stacked.
748 >         */
749 >        exempt = "FI";
750   };
751  
752   /*
753 < * gecos {}:  The X: replacement, used for banning users based on
706 < * their "realname".
753 > * gecos {}:  Used for banning users based on their "realname".
754   */
755   gecos {
756          name = "*sex*";
# Line 715 | Line 762 | gecos {
762          reason = "Trojan drone";
763   };
764  
718 gecos {
719        name = "*http*";
720        reason = "Spambot";
721 };
722
723 gecos {
724        name = "^\[J[0o]hn Do[3e]\]-[0-9]{2,5}$";
725
726        /*
727         * NOTE: You have to set type=regex; when using a regular expression
728         * based name entry
729         */
730        type = regex;
731 };
732
765   /*
766   * channel {}:  The channel block contains options pertaining to channels
767   */
# Line 750 | Line 782 | channel {
782          disable_fake_channels = yes;
783  
784          /*
753         * restrict_channels: reverse channel RESVs logic, only reserved
754         * channels are allowed
755         */
756        restrict_channels = no;
757
758        /*
785           * knock_delay: The amount of time a user must wait between issuing
786           * the knock command.
787           */
# Line 779 | Line 805 | channel {
805           */
806          max_chans_per_oper = 50;
807  
782        /* quiet_on_ban: stop banned people talking in channels. */
783        quiet_on_ban = yes;
784
808          /* max_bans: maximum number of +b/e/I modes in a channel */
809          max_bans = 100;
810  
# Line 803 | Line 826 | channel {
826  
827          /*
828           * default_split_user_count: when the usercount is lower than this level,
829 <         * consider ourselves split.  This must be set for automatic splitmode.
829 >         * consider ourselves split. This must be set for automatic splitmode.
830           */
831          default_split_user_count = 0;
832  
833          /*
834           * default_split_server_count: when the servercount is lower than this,
835 <         * consider ourselves split.  This must be set for automatic splitmode.
835 >         * consider ourselves split. This must be set for automatic splitmode.
836           */
837          default_split_server_count = 0;
838  
# Line 827 | Line 850 | channel {
850   serverhide {
851          /*
852           * flatten_links: this option will show all servers in /links appear
853 <         * that they are linked to this current server
853 >         * that they are linked to this current server.
854           */
855          flatten_links = no;
856  
# Line 839 | Line 862 | serverhide {
862  
863          /*
864           * hidden: hide this server from a /links output on servers that
865 <         * support it.  This allows hub servers to be hidden etc.
865 >         * support it. This allows hub servers to be hidden etc.
866           */
867          hidden = no;
868  
# Line 850 | Line 873 | serverhide {
873          hide_servers = no;
874  
875          /*
876 +         * hide_services: define this if you want to hide the location of
877 +         * services servers that are specified in the service{} block.
878 +         */
879 +        hide_services = no;
880 +
881 +        /*
882           * Use this as the servername users see if hide_servers = yes.
883           */
884          hidden_name = "*.hidden.com";
# Line 864 | Line 893 | serverhide {
893           * logfiles.
894           *
895           * We recommend you leave this disabled, and just take care with who you
896 <         * give admin=yes; to.
896 >         * give administrator privileges to.
897           */
898          hide_server_ips = no;
899   };
900  
901   /*
902   * general {}:  The general block contains many of the options that were once
903 < * compiled in options in config.h.  The general block is read at start time.
903 > * compiled in options in config.h
904   */
905   general {
906          /* services_name: servername of nick/channel services */
# Line 880 | Line 909 | general {
909          /* max_watch: maximum WATCH entries a client can have. */
910          max_watch = 60;
911  
912 <        /* gline_enable: enable glines, network wide temp klines */
912 >        /* gline_enable: enable glines, network wide temp klines. */
913          gline_enable = yes;
914  
915          /*
916           * gline_duration: the amount of time a gline will remain on your
917 <         * server before expiring
917 >         * server before expiring.
918           */
919          gline_duration = 1 day;
920  
921          /*
922 <         * gline_request_duration:  how long a pending G-line can be around.
923 <         * 10 minutes should be plenty
922 >         * gline_request_duration: how long a pending G-line can be around.
923 >         * 10 minutes should be plenty.
924           */
925          gline_request_duration = 10 minutes;
926  
927          /*
928           * gline_min_cidr: the minimum required length of a CIDR bitmask
929 <         * for IPv4 based glines
929 >         * for IPv4 based glines.
930           */
931          gline_min_cidr = 16;
932  
933          /*
934           * gline_min_cidr6: the minimum required length of a CIDR bitmask
935 <         * for IPv6 based glines
935 >         * for IPv6 based glines.
936           */
937          gline_min_cidr6 = 48;
938  
# Line 913 | Line 942 | general {
942          invisible_on_connect = yes;
943  
944          /*
945 <         * Max time from the nickname change that still causes KILL
946 <         * automatically to switch for the current nick of that user.
945 >         * kill_chase_time_limit: maximum time from the nickname change that
946 >         * still causes KILL automatically to switch for the current nick of
947 >         * that user.
948           */
949          kill_chase_time_limit = 90 seconds;
950  
951          /*
952 <         * If hide_spoof_ips is disabled, opers will be allowed to see the real
952 >         * hide_spoof_ips: if disabled, opers will be allowed to see the real
953           * IP of spoofed users in /trace etc. If this is defined they will be
954           * shown a masked IP.
955           */
956          hide_spoof_ips = yes;
957  
958          /*
959 <         * Ignore bogus timestamps from other servers.  Yes, this will desync
960 <         * the network, but it will allow chanops to resync with a valid non TS 0
959 >         * Ignore bogus timestamps from other servers. Yes, this will desync the
960 >         * network, but it will allow chanops to resync with a valid non TS 0
961           *
962           * This should be enabled network wide, or not at all.
963           */
# Line 939 | Line 969 | general {
969           */
970          disable_auth = no;
971  
972 <        /* disable_remote_commands: disable users doing commands on remote servers */
972 >        /* disable_remote_commands: disable users doing commands on remote servers. */
973          disable_remote_commands = no;
974  
975          /*
# Line 950 | Line 980 | general {
980  
981          /*
982           * default_floodcount: the default value of floodcount that is configurable
983 <         * via /quote set floodcount.  This is the amount of lines a user
983 >         * via /quote set floodcount. This is the amount of lines a user
984           * may send to any other user/channel in one second.
985           */
986          default_floodcount = 10;
# Line 969 | Line 999 | general {
999  
1000          /*
1001           * min_nonwildcard: the minimum non wildcard characters in k/d/g lines
1002 <         * placed via the server.  klines hand placed are exempt from limits.
1003 <         * wildcard chars: '.' ':' '*' '?' '@' '!' '#'
1002 >         * placed via the server. K-lines hand placed are exempt from limits.
1003 >         * Wildcard chars: '.', ':', '*', '?', '@', '!'
1004           */
1005          min_nonwildcard = 4;
1006  
1007          /*
1008           * min_nonwildcard_simple: the minimum non wildcard characters in
1009 <         * gecos bans.  wildcard chars: '*' '?' '#'
1009 >         * gecos bans. Wildcard chars: '*', '?'
1010           */
1011          min_nonwildcard_simple = 3;
1012  
1013 <        /* max_accept: maximum allowed /accept's for +g usermode */
1013 >        /* max_accept: maximum allowed /accept's for +g usermode. */
1014          max_accept = 20;
1015  
1016 <        /* anti_nick_flood: enable the nickflood control code */
1016 >        /* anti_nick_flood: enable the nickflood control code. */
1017          anti_nick_flood = yes;
1018  
1019          /* nick flood: the nick changes allowed in the specified period */
# Line 998 | Line 1028 | general {
1028  
1029          /*
1030           * ts delta: the time delta allowed between server clocks before
1031 <         * a warning is given, or before the link is dropped.  all servers
1031 >         * a warning is given, or before the link is dropped. All servers
1032           * should run ntpdate/rdate to keep clocks in sync
1033           */
1034          ts_warn_delta = 30 seconds;
1035          ts_max_delta = 5 minutes;
1036  
1037          /*
1008         * kline_with_reason: show the user the reason why they are k/d/glined
1009         * on exit.  May give away who set k/dline when set via tcm.
1010         */
1011        kline_with_reason = yes;
1012
1013        /*
1014         * kline_reason: show this message to users on channel
1015         * instead of the oper reason.
1016         */
1017        kline_reason = "Connection closed";
1018
1019        /*
1020         * reject_hold_time: wait this amount of time before disconnecting
1021         * a rejected client. Use 0 to disable.
1022         */
1023        reject_hold_time = 0;
1024
1025        /*
1038           * warn_no_nline: warn opers about servers that try to connect but
1039 <         * we don't have a connect {} block for.  Twits with misconfigured
1039 >         * we don't have a connect {} block for. Twits with misconfigured
1040           * servers can get really annoying with this enabled.
1041           */
1042          warn_no_nline = yes;
1043  
1044          /*
1045           * stats_e_disabled: set this to 'yes' to disable "STATS e" for both
1046 <         * operators and administrators.  Doing so is a good idea in case
1046 >         * operators and administrators. Doing so is a good idea in case
1047           * there are any exempted (exempt{}) server IPs you don't want to
1048           * see leaked.
1049           */
# Line 1044 | Line 1056 | general {
1056          stats_P_oper_only = yes;
1057  
1058          /*
1059 <         * stats i oper only: make stats i (auth {}) oper only. set to:
1060 <         *     yes:    show users no auth blocks, made oper only.
1061 <         *     masked: show users first matching auth block
1062 <         *     no:     show users all auth blocks.
1059 >         * stats i oper only: make stats i (auth {}) oper only. Set to:
1060 >         *     yes    - show users no auth blocks, made oper only.
1061 >         *     masked - show users first matching auth block
1062 >         *     no     - show users all auth blocks.
1063           */
1064          stats_i_oper_only = yes;
1065  
1066          /*
1067 <         * stats_k_oper_only: make stats k/K (klines) oper only.  set to:
1068 <         *     yes:    show users no auth blocks, made oper only
1069 <         *     masked: show users first matching auth block
1070 <         *     no:     show users all auth blocks.
1067 >         * stats_k_oper_only: make stats k/K (klines) oper only. Set to:
1068 >         *     yes    - show users no auth blocks, made oper only
1069 >         *     masked - show users first matching auth block
1070 >         *     no     - show users all auth blocks.
1071           */
1072          stats_k_oper_only = yes;
1073  
# Line 1100 | Line 1112 | general {
1112  
1113          /*
1114           * true_no_oper_flood: completely eliminate flood limits for opers
1115 <         * and for clients with can_flood = yes in their auth {} blocks
1115 >         * and for clients with can_flood = yes in their auth {} blocks.
1116           */
1117          true_no_oper_flood = yes;
1118  
1119 <        /* oper_pass_resv: allow opers to over-ride RESVs on nicks/channels */
1119 >        /* oper_pass_resv: allow opers to over-ride RESVs on nicks/channels. */
1120          oper_pass_resv = yes;
1121  
1122          /* REMOVE ME.  The following line checks you've been reading. */
# Line 1112 | Line 1124 | general {
1124  
1125          /*
1126           * max_targets: the maximum amount of targets in a single
1127 <         * PRIVMSG/NOTICE.  Set to 999 NOT 0 for unlimited.
1127 >         * PRIVMSG/NOTICE. Set to 999 NOT 0 for unlimited.
1128           */
1129          max_targets = 4;
1130  
1131          /*
1120         * message_locale: the default message locale
1121         * Use "standard" for the compiled in defaults.
1122         * To install the translated messages, go into messages/ in the
1123         * source directory and run `make install'.
1124         */
1125        message_locale = "standard";
1126
1127        /*
1132           * usermodes configurable: a list of usermodes for the options below
1133           *
1134           * +b - bots         - See bot and drone flooding notices
# Line 1132 | Line 1136 | general {
1136           * +C - cconn_full   - Client connection/quit notices full
1137           * +D - deaf         - Don't receive channel messages
1138           * +d - debug        - See debugging notices
1139 +         * +e - external     - See remote server connection and split notices
1140 +         * +F - farconnect   - Remote client connection/quit notices
1141           * +f - full         - See auth{} block full notices
1142           * +G - softcallerid - Server Side Ignore for users not on your channels
1143           * +g - callerid     - Server Side Ignore (for privmsgs etc)
# Line 1142 | Line 1148 | general {
1148           * +k - skill        - See server generated KILL messages
1149           * +l - locops       - See LOCOPS messages
1150           * +n - nchange      - See client nick changes
1151 +         * +R - nononreg     - Only receive private messages from registered clients
1152           * +s - servnotice   - See general server notices
1153           * +u - unauth       - See unauthorized client notices
1154           * +w - wallop       - See server generated WALLOPS
1148         * +x - external     - See remote server connection and split notices
1155           * +y - spy          - See LINKS, STATS, TRACE notices etc.
1156           * +z - operwall     - See oper generated WALLOPS
1157           */
# Line 1153 | Line 1159 | general {
1159          /* oper_only_umodes: usermodes only opers may set */
1160          oper_only_umodes = bots, cconn, cconn_full, debug, full, hidden, skill,
1161                             nchange, rej, spy, external, operwall,
1162 <                           locops, unauth;
1162 >                           locops, unauth, farconnect;
1163  
1164          /* oper_umodes: default usermodes opers get when they /oper */
1165          oper_umodes = bots, locops, servnotice, operwall, wallop;
1166  
1167          /*
1168           * use_egd: if your system does not have *random devices yet you
1169 <         * want to use OpenSSL and encrypted links, enable this.  Beware -
1170 <         * EGD is *very* CPU intensive when gathering data for its pool
1169 >         * want to use OpenSSL and encrypted links, enable this. Beware -
1170 >         * EGD is *very* CPU intensive when gathering data for its pool.
1171           */
1172   #       use_egd = yes;
1173  
# Line 1173 | Line 1179 | general {
1179  
1180          /*
1181           * throttle_time: the minimum amount of time between connections from
1182 <         * the same ip.  exempt {} blocks are excluded from this throttling.
1183 <         * Offers protection against flooders who reconnect quickly.  
1182 >         * the same ip. exempt {} blocks are excluded from this throttling.
1183 >         * Offers protection against flooders who reconnect quickly.
1184           * Set to 0 to disable.
1185           */
1186          throttle_time = 10;
# Line 1188 | Line 1194 | modules {
1194          path = "/usr/local/ircd/lib/ircd-hybrid/modules";
1195          path = "/usr/local/ircd/lib/ircd-hybrid/modules/autoload";
1196  
1197 <        /* module: the name of a module to load on startup/rehash */
1197 >        /* module: the name of a module to load on startup/rehash. */
1198          #module = "some_module.la";
1199   };
1200  
# Line 1239 | Line 1245 | log {
1245                  type = debug;
1246                  name = "/home/ircd/var/log/debug.log";
1247                  size = 50 megabytes;
1248 <        };
1248 >        };
1249   };

Diff Legend

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