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/trunk/doc/example.conf (file contents), Revision 1783 by michael, Thu Jan 24 19:26:51 2013 UTC vs.
ircd-hybrid/trunk/doc/reference.conf (file contents), Revision 2267 by michael, Mon Jun 17 23:30:36 2013 UTC

# Line 1 | Line 1
1 < /* doc/example.conf - ircd-hybrid-8 Example configuration file
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 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 77 | 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.
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          /*
# Line 114 | Line 110 | serverinfo {
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.
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 134 | 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:
# Line 151 | Line 149 | serverinfo {
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";
152 > #       ssl_dh_param_file = "/usr/local/ircd/etc/dhparam.pem";
153  
154          /*
155           * ssl_cipher_list:
# Line 169 | Line 167 | serverinfo {
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";
170 > #       ssl_cipher_list = "DHE-RSA-AES256-SHA:AES256-SHA";
171  
172          /*
173           * ssl_server_method:
# Line 179 | Line 177 | serverinfo {
177           * outgoing (client method) SSL/TLS connections.
178           * This can be either sslv3 for SSLv3, and/or tlsv1 for TLSv1.
179           */
180 <        #ssl_server_method = tlsv1, sslv3;
181 <        #ssl_client_method = tlsv1;
180 > #       ssl_server_method = tlsv1, sslv3;
181 > #       ssl_client_method = tlsv1;
182   };
183  
184   /*
# Line 196 | 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 229 | 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 257 | Line 255 | class {
255          sendq = 100 kbytes;
256  
257          /*
258 <         * min_idle: minimum idle time that is shown in /whois
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
263 >         * max_idle: maximum idle time that is shown in /whois.
264           */
265          max_idle = 8 hours;
266  
# Line 281 | Line 279 | class {
279          ping_time = 90 seconds;
280  
281          /*
282 <         * 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 {}: Allows to show 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
318 >         * port: the specific port to listen on. If no host is specified
319           * before, it will listen on all available IPs.
320           *
321           * Ports are separated via a comma, a range may be specified using ".."
# Line 311 | Line 328 | listen {
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 has to come before "port". Always!
332           *
333           * Currently available flags are:
334           *
# Line 325 | Line 342 | listen {
342  
343          /*
344           * host: set a specific IP/host the ports after the line will listen
345 <         * on.  This may be ipv4 or ipv6.
345 >         * on. This may be ipv4 or ipv6.
346           */
347          host = "1.2.3.4";
348          port = 7000, 7001;
# Line 355 | 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 users 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 375 | 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
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,
# Line 384 | 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 405 | Line 422 | auth {
422  
423   /*
424   * operator {}:  defines ircd operators
408 *
409 * ircd-hybrid no longer supports local operators, privileges are
410 * controlled via flags.
425   */
426   operator {
427          /* name: the name of the oper */
# Line 421 | Line 435 | operator {
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
# Line 443 | Line 457 | operator {
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 +         */
476 +        ssl_connection_required = no;
477 +
478          /* class: the class the oper joins when they successfully /oper */
479          class = "opers";
480  
481          /*
482 <         * umodes: default usermodes opers get when they /oper.  If defined,
482 >         * umodes: default usermodes opers get when they /oper. If defined,
483           * it will override oper_umodes settings in general {}.
484           * Available usermodes:
485           *
486           * +b - bots         - See bot and drone flooding notices
487           * +c - cconn        - Client connection/quit notices
456         * +C - cconn_full   - Client connection/quit notices full
488           * +D - deaf         - Don't receive channel messages
489           * +d - debug        - See debugging notices
490 +         * +e - external     - See remote server connection and split notices
491 +         * +F - farconnect   - Remote client connection/quit notices
492           * +f - full         - See auth{} block full notices
493           * +G - softcallerid - Server Side Ignore for users not on your channels
494           * +g - callerid     - Server Side Ignore (for privmsgs etc)
495           * +H - hidden       - Hides operator status to other users
496 <         * +i - invisible    - Not shown in NAMES or WHO unless you share a
464 <         *                     a channel
496 >         * +i - invisible    - Not shown in NAMES or WHO unless you share a channel
497           * +j - rej          - See rejected client notices
498           * +k - skill        - See server generated KILL messages
499           * +l - locops       - See LOCOPS messages
500           * +n - nchange      - See client nick changes
501 +         * +R - nononreg     - Only receive private messages from registered clients
502           * +s - servnotice   - See general server notices
503           * +u - unauth       - See unauthorized client notices
504           * +w - wallop       - See server generated WALLOPS
472         * +x - external     - See remote server connection and split notices
505           * +y - spy          - See LINKS, STATS, TRACE notices etc.
506           * +z - operwall     - See oper generated WALLOPS
507           */
508 < #       umodes = locops, servnotice, operwall, wallop;
508 >        umodes = locops, servnotice, operwall, wallop;
509  
510          /*
511           * privileges: controls the activities and commands an oper is
512           * allowed to do on the server. All options default to no.
513           * Available options:
514           *
515 <         * module       - allows MODULE
516 <         * global_kill  - allows remote users to be /KILL'd
517 <         * remote       - allows remote SQUIT and CONNECT
518 <         * remoteban    - allows remote KLINE/UNKLINE
519 <         * dline        - allows DLINE
520 <         * undline      - allows UNDLINE
521 <         * kline        - allows KILL and KLINE
522 <         * unkline      - allows UNKLINE
523 <         * gline        - allows GLINE
524 <         * xline        - allows XLINE
525 <         * globops      - allows GLOBOPS
526 <         * operwall     - allows OPERWALL
527 <         * nick_changes - allows oper to see nickchanges via usermode +n
528 <         * rehash       - allows oper to REHASH config
529 <         * die          - allows DIE
530 <         * restart      - allows RESTART
531 <         * set          - allows SET
532 <         * admin        - gives admin privileges. admins for example,
533 <         *                may see the real IP addresses of servers.
515 >         * module         - allows MODULE
516 >         * connect        - allows local CONNECT              | ('P' flag)
517 >         * connect:remote - allows remote CONNECT             | ('Q' flag)
518 >         * squit          - allows local SQUIT                | ('R' flag)
519 >         * squit:remote   - allows remote SQUIT               | ('S' flag)
520 >         * kill           - allows to KILL local clients      | ('N' flag)
521 >         * kill:remote    - allows remote users to be /KILL'd | ('O' flag)
522 >         * remoteban      - allows remote KLINE/UNKLINE       | ('B' flag)
523 >         * dline          - allows DLINE                      |
524 >         * undline        - allows UNDLINE                    |
525 >         * kline          - allows KLINE                      | ('K' flag)
526 >         * unkline        - allows UNKLINE                    | ('U' flag)
527 >         * gline          - allows GLINE                      | ('G' flag)
528 >         * xline          - allows XLINE                      | ('X' flag)
529 >         * locops         - allows LOCOPS                     |
530 >         * globops        - allows GLOBOPS                    |
531 >         * wallops        - allows WALLOPS                    |
532 >         * operwall       - allows OPERWALL                   | ('L' flag)
533 >         * rehash         - allows oper to REHASH config      | ('H' flag)
534 >         * die            - allows DIE                        | ('D' flag)
535 >         * restart        - allows RESTART                    |
536 >         * set            - allows SET                        |
537 >         * admin          - gives administrator privileges    | ('A' flag)
538           */
539 <        flags = global_kill, remote, kline, unkline, xline, globops, restart,
540 <                die, rehash, nick_changes, admin, operwall, module;
539 >        flags = kill, kill:remote, connect, connect:remote, kline, unkline,
540 >                xline, globops, restart, die, rehash, admin, operwall, module;
541   };
542  
543   /*
# Line 523 | Line 559 | connect {
559          name = "irc.uplink.com";
560  
561          /*
562 <         * host: the host or IP to connect to.  If a hostname is used it
562 >         * host: the host or IP to connect to. If a hostname is used it
563           * must match the reverse dns of the server.
564           */
565          host = "192.168.0.1";
# Line 552 | Line 588 | connect {
588          port = 6666;
589  
590          /*
591 <         * hub_mask: the mask of servers that this server may hub.  Multiple
592 <         * entries are permitted
591 >         * hub_mask: the mask of servers that this server may hub. Multiple
592 >         * entries are permitted.
593           */
594          hub_mask = "*";
595  
596          /*
597 <         * leaf_mask: the mask of servers this server may not hub.  Multiple
598 <         * entries are permitted.  Useful for forbidding EU -> US -> EU routes.
597 >         * leaf_mask: the mask of servers this server may not hub. Multiple
598 >         * entries are permitted. Useful for forbidding EU -> US -> EU routes.
599           */
600   #       leaf_mask = "*.uk";
601  
# Line 578 | Line 614 | connect {
614           * Multiple ciphers are separated by colons. The order of preference
615           * is from left to right.
616           */
617 <        #ssl_cipher_list = "DHE-RSA-AES256-SHA:AES256-SHA";
617 > #       ssl_cipher_list = "DHE-RSA-AES256-SHA:AES256-SHA";
618 >
619 >        /*
620 >         * ssl_certificate_fingerprint: enhances security by additionally checking
621 >         * the server's client certificate fingerprint against the specified
622 >         * fingerprint below.
623 >         */
624 > #       ssl_certificate_fingerprint = "4C62287BA6776A89CD4F8FF10A62FFB35E79319F51AF6C62C674984974FCCB1D";
625  
626          /*
627           * autoconn   - controls whether we autoconnect to this server or not,
# Line 642 | Line 685 | cluster {
685   *
686   * NOTE: This can be effectively used for remote klines.
687   *       Please note that there is no password authentication
688 < *       for users setting remote klines.  You must also be
688 > *       for users setting remote klines. You must also be
689   *       /oper'd in order to issue a remote kline.
690   */
691   shared {
692          /*
693 <         * name: the server the user must be on to set klines.  If this is not
693 >         * name: the server the user must be on to set klines. If this is not
694           * specified, the user will be allowed to kline from all servers.
695           */
696          name = "irc2.some.server";
697  
698          /*
699 <         * user: the user@host mask that is allowed to set klines.  If this is
699 >         * user: the user@host mask that is allowed to set klines. If this is
700           * not specified, all users on the server above will be allowed to set
701           * a remote kline.
702           */
# Line 684 | Line 727 | kill {
727          reason = "Obviously hacked account";
728   };
729  
687 kill {
688        user = "^O[[:alpha:]]?[[:digit:]]+(x\.o|\.xo)$@^[[:alnum:]]{4}\.evilnet.tld$";
689
690        /*
691         * NOTE: You have to set type=regex; when using a regular expression
692         * based user entry
693         */
694        type = regex;
695 };
696
730   /*
731   * deny {}:  IPs that are not allowed to connect (before DNS/ident lookup)
732   * Oper issued dlines will be added to the specified dline config
# Line 704 | Line 737 | deny {
737   };
738  
739   /*
740 < * exempt {}: IPs that are exempt from deny {} and Dlines
740 > * exempt {}:  IPs that are exempt from deny {} and Dlines
741   */
742   exempt {
743          ip = "192.168.0.0/16";
# Line 713 | Line 746 | exempt {
746   /*
747   * resv {}:  nicks and channels users may not use/join
748   */
749 + resv { mask = "clone*"; reason = "Clone bots"; };
750 + resv { mask = "ChanServ"; reason = "Reserved for services"; };
751 + resv { mask = "NickServ"; reason = "Reserved for services"; };
752 + resv { mask = "OperServ"; reason = "Reserved for services"; };
753 + resv { mask = "MemoServ"; reason = "Reserved for services"; };
754 + resv { mask = "BotServ"; reason = "Reserved for services"; };
755 + resv { mask = "HelpServ"; reason = "Reserved for services"; };
756 + resv { mask = "HostServ"; reason = "Reserved for services"; };
757 + resv { mask = "StatServ"; reason = "Reserved for services"; };
758 + resv { mask = "#*services*"; reason = "Reserved for services"; };
759 +
760   resv {
761 <        /* reason: the reason for the proceeding resv's */
762 <        reason = "Reserved for services";
761 >        /*
762 >         * mask: masks starting with a '#' are automatically considered
763 >         * as channel name mask.
764 >         */
765 >        mask = "#helsinki";
766 >        reason = "Channel is reserved for finnish inhabitants";
767  
768 <        /* resv: the nicks and channels users may not join/use */
769 <        nick = "Global";
770 <        nick = "DevNull";
771 <        nick = "BotServ";
772 <        nick = "Services";
773 <        nick = "StatServ";
726 <        nick = "HelpServ";
727 <        nick = "HostServ";
728 <        nick = "NickServ";
729 <        nick = "ChanServ";
730 <        nick = "MemoServ";
731 <        nick = "OperServ";
732 <        channel = "#services";
733 <
734 <        /* resv: wildcard masks are also supported in nicks only */
735 <        reason = "Clone bots";
736 <        nick = "clone*";
768 >        /*
769 >         * exempt: can be either a ISO 3166 alpha-2 two letter country
770 >         * code, or a nick!user@host mask. CIDR is supported. Exempt
771 >         * entries can be stacked.
772 >         */
773 >        exempt = "FI";
774   };
775  
776   /*
777 < * gecos {}:  The X: replacement, used for banning users based on
741 < * their "realname".
777 > * gecos {}:  Used for banning users based on their "realname".
778   */
779   gecos {
780          name = "*sex*";
# Line 750 | Line 786 | gecos {
786          reason = "Trojan drone";
787   };
788  
753 gecos {
754        name = "^\[J[0o]hn Do[3e]\]-[0-9]{2,5}$";
755
756        /*
757         * NOTE: You have to set type=regex; when using a regular expression
758         * based name entry
759         */
760        type = regex;
761 };
762
789   /*
790   * channel {}:  The channel block contains options pertaining to channels
791   */
# Line 780 | Line 806 | channel {
806          disable_fake_channels = yes;
807  
808          /*
783         * restrict_channels: reverse channel RESVs logic, only reserved
784         * channels are allowed
785         */
786        restrict_channels = no;
787
788        /*
809           * knock_delay: The amount of time a user must wait between issuing
810           * the knock command.
811           */
# Line 809 | Line 829 | channel {
829           */
830          max_chans_per_oper = 50;
831  
812        /* quiet_on_ban: stop banned people talking in channels. */
813        quiet_on_ban = yes;
814
832          /* max_bans: maximum number of +b/e/I modes in a channel */
833          max_bans = 100;
834  
# Line 833 | Line 850 | channel {
850  
851          /*
852           * default_split_user_count: when the usercount is lower than this level,
853 <         * consider ourselves split.  This must be set for automatic splitmode.
853 >         * consider ourselves split. This must be set for automatic splitmode.
854           */
855          default_split_user_count = 0;
856  
857          /*
858           * default_split_server_count: when the servercount is lower than this,
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_server_count = 0;
862  
# Line 856 | Line 873 | channel {
873   */
874   serverhide {
875          /*
876 +         * disable_remote_commands: disable users doing commands
877 +         * on remote servers.
878 +         */
879 +        disable_remote_commands = no;
880 +
881 +        /*
882           * flatten_links: this option will show all servers in /links appear
883 <         * that they are linked to this current server
883 >         * that they are linked to this current server.
884           */
885          flatten_links = no;
886  
# Line 869 | Line 892 | serverhide {
892  
893          /*
894           * hidden: hide this server from a /links output on servers that
895 <         * support it.  This allows hub servers to be hidden etc.
895 >         * support it. This allows hub servers to be hidden etc.
896           */
897          hidden = no;
898  
# Line 880 | Line 903 | serverhide {
903          hide_servers = no;
904  
905          /*
906 +         * hide_services: define this if you want to hide the location of
907 +         * services servers that are specified in the service{} block.
908 +         */
909 +        hide_services = no;
910 +
911 +        /*
912           * Use this as the servername users see if hide_servers = yes.
913           */
914          hidden_name = "*.hidden.com";
# Line 910 | Line 939 | general {
939          /* max_watch: maximum WATCH entries a client can have. */
940          max_watch = 60;
941  
942 <        /* gline_enable: enable glines, network wide temp klines */
942 >        /* gline_enable: enable glines, network wide temp klines. */
943          gline_enable = yes;
944  
945          /*
946           * gline_duration: the amount of time a gline will remain on your
947 <         * server before expiring
947 >         * server before expiring.
948           */
949          gline_duration = 1 day;
950  
951          /*
952 <         * gline_request_duration:  how long a pending G-line can be around.
953 <         * 10 minutes should be plenty
952 >         * gline_request_duration: how long a pending G-line can be around.
953 >         * 10 minutes should be plenty.
954           */
955          gline_request_duration = 10 minutes;
956  
957          /*
958           * gline_min_cidr: the minimum required length of a CIDR bitmask
959 <         * for IPv4 based glines
959 >         * for IPv4 based glines.
960           */
961          gline_min_cidr = 16;
962  
963          /*
964           * gline_min_cidr6: the minimum required length of a CIDR bitmask
965 <         * for IPv6 based glines
965 >         * for IPv6 based glines.
966           */
967          gline_min_cidr6 = 48;
968  
# Line 943 | Line 972 | general {
972          invisible_on_connect = yes;
973  
974          /*
975 <         * Max time from the nickname change that still causes KILL
976 <         * automatically to switch for the current nick of that user.
975 >         * kill_chase_time_limit: maximum time from the nickname change that
976 >         * still causes KILL automatically to switch for the current nick of
977 >         * that user.
978           */
979          kill_chase_time_limit = 90 seconds;
980  
981          /*
982 <         * If hide_spoof_ips is disabled, opers will be allowed to see the real
982 >         * hide_spoof_ips: if disabled, opers will be allowed to see the real
983           * IP of spoofed users in /trace etc. If this is defined they will be
984           * shown a masked IP.
985           */
986          hide_spoof_ips = yes;
987  
988          /*
989 <         * Ignore bogus timestamps from other servers.  Yes, this will desync
990 <         * the network, but it will allow chanops to resync with a valid non TS 0
989 >         * Ignore bogus timestamps from other servers. Yes, this will desync the
990 >         * network, but it will allow chanops to resync with a valid non TS 0
991           *
992           * This should be enabled network wide, or not at all.
993           */
# Line 969 | Line 999 | general {
999           */
1000          disable_auth = no;
1001  
972        /* disable_remote_commands: disable users doing commands on remote servers */
973        disable_remote_commands = no;
974
1002          /*
1003           * tkline_expire_notices: enables or disables temporary kline/xline
1004           * expire notices.
# Line 980 | Line 1007 | general {
1007  
1008          /*
1009           * default_floodcount: the default value of floodcount that is configurable
1010 <         * via /quote set floodcount.  This is the amount of lines a user
1010 >         * via /quote set floodcount. This is the amount of lines a user
1011           * may send to any other user/channel in one second.
1012           */
1013          default_floodcount = 10;
# Line 999 | Line 1026 | general {
1026  
1027          /*
1028           * min_nonwildcard: the minimum non wildcard characters in k/d/g lines
1029 <         * placed via the server.  klines hand placed are exempt from limits.
1030 <         * wildcard chars: '.' ':' '*' '?' '@' '!' '#'
1029 >         * placed via the server. K-lines hand placed are exempt from limits.
1030 >         * Wildcard chars: '.', ':', '*', '?', '@', '!'
1031           */
1032          min_nonwildcard = 4;
1033  
1034          /*
1035           * min_nonwildcard_simple: the minimum non wildcard characters in
1036 <         * gecos bans.  wildcard chars: '*' '?' '#'
1036 >         * gecos bans. Wildcard chars: '*', '?'
1037           */
1038          min_nonwildcard_simple = 3;
1039  
1040 <        /* max_accept: maximum allowed /accept's for +g usermode */
1040 >        /* max_accept: maximum allowed /accept's for +g usermode. */
1041          max_accept = 20;
1042  
1043 <        /* anti_nick_flood: enable the nickflood control code */
1043 >        /* anti_nick_flood: enable the nickflood control code. */
1044          anti_nick_flood = yes;
1045  
1046          /* nick flood: the nick changes allowed in the specified period */
# Line 1028 | Line 1055 | general {
1055  
1056          /*
1057           * ts delta: the time delta allowed between server clocks before
1058 <         * a warning is given, or before the link is dropped.  all servers
1058 >         * a warning is given, or before the link is dropped. All servers
1059           * should run ntpdate/rdate to keep clocks in sync
1060           */
1061          ts_warn_delta = 30 seconds;
# Line 1036 | Line 1063 | general {
1063  
1064          /*
1065           * warn_no_nline: warn opers about servers that try to connect but
1066 <         * we don't have a connect {} block for.  Twits with misconfigured
1066 >         * we don't have a connect {} block for. Twits with misconfigured
1067           * servers can get really annoying with this enabled.
1068           */
1069          warn_no_nline = yes;
1070  
1071          /*
1072           * stats_e_disabled: set this to 'yes' to disable "STATS e" for both
1073 <         * operators and administrators.  Doing so is a good idea in case
1073 >         * operators and administrators. Doing so is a good idea in case
1074           * there are any exempted (exempt{}) server IPs you don't want to
1075           * see leaked.
1076           */
# Line 1056 | Line 1083 | general {
1083          stats_P_oper_only = yes;
1084  
1085          /*
1086 <         * stats i oper only: make stats i (auth {}) oper only. set to:
1087 <         *     yes:    show users no auth blocks, made oper only.
1088 <         *     masked: show users first matching auth block
1089 <         *     no:     show users all auth blocks.
1086 >         * stats i oper only: make stats i (auth {}) oper only. Set to:
1087 >         *     yes    - show users no auth blocks, made oper only.
1088 >         *     masked - show users first matching auth block
1089 >         *     no     - show users all auth blocks.
1090           */
1091          stats_i_oper_only = yes;
1092  
1093          /*
1094 <         * stats_k_oper_only: make stats k/K (klines) oper only.  set to:
1095 <         *     yes:    show users no auth blocks, made oper only
1096 <         *     masked: show users first matching auth block
1097 <         *     no:     show users all auth blocks.
1094 >         * stats_k_oper_only: make stats k/K (klines) oper only. Set to:
1095 >         *     yes    - show users no auth blocks, made oper only
1096 >         *     masked - show users first matching auth block
1097 >         *     no     - show users all auth blocks.
1098           */
1099          stats_k_oper_only = yes;
1100  
# Line 1112 | Line 1139 | general {
1139  
1140          /*
1141           * true_no_oper_flood: completely eliminate flood limits for opers
1142 <         * and for clients with can_flood = yes in their auth {} blocks
1142 >         * and for clients with can_flood = yes in their auth {} blocks.
1143           */
1144          true_no_oper_flood = yes;
1145  
1146 <        /* oper_pass_resv: allow opers to over-ride RESVs on nicks/channels */
1146 >        /* oper_pass_resv: allow opers to over-ride RESVs on nicks/channels. */
1147          oper_pass_resv = yes;
1148  
1149          /* REMOVE ME.  The following line checks you've been reading. */
# Line 1124 | Line 1151 | general {
1151  
1152          /*
1153           * max_targets: the maximum amount of targets in a single
1154 <         * PRIVMSG/NOTICE.  Set to 999 NOT 0 for unlimited.
1154 >         * PRIVMSG/NOTICE. Set to 999 NOT 0 for unlimited.
1155           */
1156          max_targets = 4;
1157  
1158          /*
1132         * message_locale: the default message locale
1133         * Use "standard" for the compiled in defaults.
1134         * To install the translated messages, go into messages/ in the
1135         * source directory and run `make install'.
1136         */
1137        message_locale = "standard";
1138
1139        /*
1159           * usermodes configurable: a list of usermodes for the options below
1160           *
1161           * +b - bots         - See bot and drone flooding notices
1162           * +c - cconn        - Client connection/quit notices
1144         * +C - cconn_full   - Client connection/quit notices full
1163           * +D - deaf         - Don't receive channel messages
1164           * +d - debug        - See debugging notices
1165 +         * +e - external     - See remote server connection and split notices
1166 +         * +F - farconnect   - Remote client connection/quit notices
1167           * +f - full         - See auth{} block full notices
1168           * +G - softcallerid - Server Side Ignore for users not on your channels
1169           * +g - callerid     - Server Side Ignore (for privmsgs etc)
# Line 1154 | Line 1174 | general {
1174           * +k - skill        - See server generated KILL messages
1175           * +l - locops       - See LOCOPS messages
1176           * +n - nchange      - See client nick changes
1177 +         * +R - nononreg     - Only receive private messages from registered clients
1178           * +s - servnotice   - See general server notices
1179           * +u - unauth       - See unauthorized client notices
1180           * +w - wallop       - See server generated WALLOPS
1160         * +x - external     - See remote server connection and split notices
1181           * +y - spy          - See LINKS, STATS, TRACE notices etc.
1182           * +z - operwall     - See oper generated WALLOPS
1183           */
1184  
1185          /* oper_only_umodes: usermodes only opers may set */
1186 <        oper_only_umodes = bots, cconn, cconn_full, debug, full, hidden, skill,
1186 >        oper_only_umodes = bots, cconn, debug, full, hidden, skill,
1187                             nchange, rej, spy, external, operwall,
1188 <                           locops, unauth;
1188 >                           locops, unauth, farconnect;
1189  
1190          /* oper_umodes: default usermodes opers get when they /oper */
1191          oper_umodes = bots, locops, servnotice, operwall, wallop;
1192  
1193          /*
1194           * use_egd: if your system does not have *random devices yet you
1195 <         * want to use OpenSSL and encrypted links, enable this.  Beware -
1196 <         * EGD is *very* CPU intensive when gathering data for its pool
1195 >         * want to use OpenSSL and encrypted links, enable this. Beware -
1196 >         * EGD is *very* CPU intensive when gathering data for its pool.
1197           */
1198   #       use_egd = yes;
1199  
# Line 1185 | Line 1205 | general {
1205  
1206          /*
1207           * throttle_time: the minimum amount of time between connections from
1208 <         * the same ip.  exempt {} blocks are excluded from this throttling.
1209 <         * Offers protection against flooders who reconnect quickly.  
1208 >         * the same ip. exempt {} blocks are excluded from this throttling.
1209 >         * Offers protection against flooders who reconnect quickly.
1210           * Set to 0 to disable.
1211           */
1212          throttle_time = 10;
# Line 1200 | Line 1220 | modules {
1220          path = "/usr/local/ircd/lib/ircd-hybrid/modules";
1221          path = "/usr/local/ircd/lib/ircd-hybrid/modules/autoload";
1222  
1223 <        /* module: the name of a module to load on startup/rehash */
1224 <        #module = "some_module.la";
1223 >        /* module: the name of a module to load on startup/rehash. */
1224 > #       module = "some_module.la";
1225   };
1226  
1227   /*
# Line 1213 | Line 1233 | log {
1233  
1234          file {
1235                  type = oper;
1236 <                name = "/home/ircd/var/log/oper.log";
1236 >                name = "/usr/local/ircd/var/log/oper.log";
1237                  size = unlimited;
1238          };
1239  
1240          file {
1241                  type = user;
1242 <                name = "/home/ircd/var/log/user.log";
1242 >                name = "/usr/local/ircd/var/log/user.log";
1243                  size = 50 megabytes;
1244          };
1245  
1246          file {
1247                  type = kill;
1248 <                name = "/home/ircd/var/log/kill.log";
1248 >                name = "/usr/local/ircd/var/log/kill.log";
1249                  size = 50 megabytes;
1250          };
1251  
1252          file {
1253                  type = kline;
1254 <                name = "/home/ircd/var/log/kline.log";
1254 >                name = "/usr/local/ircd/var/log/kline.log";
1255                  size = 50 megabytes;
1256          };
1257  
1258          file {
1259                  type = dline;
1260 <                name = "/home/ircd/var/log/dline.log";
1260 >                name = "/usr/local/ircd/var/log/dline.log";
1261                  size = 50 megabytes;
1262          };
1263  
1264          file {
1265                  type = gline;
1266 <                name = "/home/ircd/var/log/gline.log";
1266 >                name = "/usr/local/ircd/var/log/gline.log";
1267                  size = 50 megabytes;
1268          };
1269  
1270          file {
1271                  type = debug;
1272 <                name = "/home/ircd/var/log/debug.log";
1272 >                name = "/usr/local/ircd/var/log/debug.log";
1273                  size = 50 megabytes;
1274 <        };
1274 >        };
1275   };

Diff Legend

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