Add option general::use_propagated_bans to allow disabling new KLINE.

[irc/rqf/shadowircd.git] / doc / reference.conf

diff --git a/doc/reference.conf b/doc/reference.conf
index 56d1894a0d297a78ea919f6f7153e34a82f2f0a6..33f4a55b42296046b6138ba0c5f69eae4760238e 100755 (executable)
--- a/doc/reference.conf
+++ b/doc/reference.conf
@@ -66,7 +66,7 @@
  * /identify support                                 -- m_identify.so
  * /mkpassword support                               -- m_mkpasswd.so
  * WEBIRC support                                    -- m_webirc.so
- * Send message to all admins network-wide           -- m_adminwall.so
+ * Server-side /CYCLE                                -- m_cycle.so
  * /oaccept - add to target's accept list, oper only -- m_oaccept.so
  * /opme - op self in opless channels, admin only    -- m_opme.so
  * /ojoin - join despite restrictions, admin only    -- m_ojoin.so
@@ -101,7 +101,7 @@ loadmodule "extensions/ip_cloaking.so";
 loadmodule "extensions/m_identify.so";
 loadmodule "extensions/m_mkpasswd.so";
 loadmodule "extensions/m_webirc.so";
-#loadmodule "extensions/m_adminwall.so";
+#loadmodule "extensions/m_cycle.so";
 #loadmodule "extensions/m_oaccept.so";
 #loadmodule "extensions/m_opme.so";
 #loadmodule "extensions/m_ojoin.so";
@@ -443,9 +443,9 @@ privset "local_op" {
         * oper:xline:           allows use of /quote xline/unxline
         * oper:resv:            allows /quote resv/unresv and cmode +LP
         * oper:operwall:        allows the oper to send/receive operwalls
-        * oper:override:                allows the oper to set umode +p on themself
-        *                                               which grants the ability to have implicit
-        *                                               operator access in all channels.
+        * oper:override:        allows the oper to set umode +p on themself
+                                 which grants the ability to have implicit
+                                 operator access in all channels.
         * oper:spy:             allows 'operspy' features to see through +s
         *                       channels etc. see /quote help operspy
         * oper:hidden:          hides the oper from /stats p
@@ -692,9 +692,11 @@ shared {
         *    resv    - allow setting perm/temp resvs
         *    tresv   - allow setting temp resvs
         *    unresv  - allow removing xlines
+        *    rehash  - allow rehashing
         *    all     - allow oper/server to do all of above.
         *    locops  - allow locops - only used for servers who cluster
-        *    rehash  - allow rehashing
+        *    die     - allow restarting/dying of servers
+        *    modules - allow loading/unloading/reloading of modules
         *    dline   - allow setting perm/temp dlines
         *    tdline  - allow setting temp dlines
         *    undline - allow removing dlines
@@ -777,8 +779,11 @@ channel {
         */
        use_except = yes;
 
-       /* forward: Enable/disable channel mode +f, a channel to forward
-        * users to if they can't join because of +i etc.
+       /* forward: Enable/disable channel mode +f, which allows you to set 
+        * a channel to forward users to if they can't join because of +i etc.
+        * Disabling this option via rehash will leave all previously set 
+        * forwards hanging around, though they will not do anything. For 
+        * this reason, you may want to restart to disable this option.
         */
        use_forward = yes;
 
@@ -1105,7 +1110,7 @@ general {
         */
        min_nonwildcard_simple = 3;
 
-        /* max accept: maximum allowed /accept's for +g usermode */
+        /* max accept: maximum allowed /accept's for +gGR usermodes */
         max_accept = 20;
 
        /* max monitor: the maximum amount of nicknames a client may have in
@@ -1193,6 +1198,13 @@ general {
         */
        warn_no_nline = yes;
 
+       /* use propagated bans: KLINE sets fully propagated bans. That means
+        * the klines are part of the netburst and restarted/split servers
+        * will get them, but they will not apply to 3.2 and older servers
+        * at all.
+        */
+       use_propagated_bans = yes;
+
        /* stats e disabled: disable stats e.  useful if server ips are
         * exempted and you dont want them listing on irc.
         */
@@ -1284,6 +1296,14 @@ general {
        /* no oper flood: increase flood limits for opers. */
        no_oper_flood = yes;
 
+       /* true no oper flood: Allow opers to NEVER hit flood limits.
+        * With the above setting, flood limits are set to 4x what they
+        * are for normal users. With this setting, they're removed entirely.
+        * For this setting to work, you need to have no_oper_flood enabled as well.
+        * ENABLE THIS SETTING WITH CAUTION.
+        */
+       true_no_oper_flood = no;
+
        /* REMOVE ME.  The following line checks you've been reading. */
        havent_read_conf = yes;
        
@@ -1318,7 +1338,7 @@ general {
         * +V - noinvite   - Block INVITE to user.
         * +B - bot        - Marks as a bot.
         * +p - override   - Implicit operator access in all channels.
-        *                   This is oper-only and requires the oper:override privledge.
+        *                   This is oper-only and requires the oper:override priv.
         */
         
        /* oper only umodes: usermodes only opers may set */