]> jfr.im git - solanum.git/blobdiff - doc/reference.conf
Resolve shfit/reduce conflict in timespec production (#54)
[solanum.git] / doc / reference.conf
index 6a268613cbbc99798325aa211d6fc5dcb9d7280f..8e770a8221ab4d8f2ed8456f930335bb1d6d5c1b 100644 (file)
@@ -1,4 +1,4 @@
-/* doc/reference.conf - charybdis Example configuration file
+/* doc/reference.conf - solanum example configuration file
  *
  * Copyright (C) 2000-2002 Hybrid Development Team
  * Copyright (C) 2002-2005 ircd-ratbox development team
@@ -63,7 +63,7 @@
  * Server bans (+b $s:mask)                          -- extb_server
  * SSL bans (+b $z)                                  -- extb_ssl
  * User mode bans (+b $u:modes)                      -- extb_usermode
- * Helpops system (umode +H)                         -- helpops
+ * Helpops system (umode +h)                         -- helpops
  * HURT system                                       -- hurt
  * New host mangling (umode +x)                      -- ip_cloaking_4.0
  * Old host mangling (umode +h)                      -- ip_cloaking
@@ -290,14 +290,17 @@ class "server" {
         */
        connectfreq = 5 minutes;
 
-       /* max number: the amount of servers to autoconnect to.  if the number
+       /* max_autoconn: the amount of servers to autoconnect to.  if the number
         * of servers in the class is or exceeds this, no more servers in the
         * class are autoconnected.  oper initiated connects are unaffected.
         * this should usually be set to either 0 or 1.  (autoconnecting from
         * hubs to leaves may cause leaves to function as hubs by having
         * multiple servers connected to them.)
         */
-       max_number = 1;
+       max_autoconn = 1;
+
+       /* max_number: the maximum number of servers allowed in this class */
+       max_number = 100;
 
        /* sendq: servers need a higher sendq as they are sent more data */
        sendq = 2 megabytes;
@@ -432,10 +435,13 @@ privset "local_op" {
         *
         * oper:general:         enable most general oper privileges that came
         *                       with +o in older releases
-        * auspex:oper:       allows the oper to see through oper hiding
-        * oper:privs:      allows /stats o/O and seeing privset in /whois
-        * oper:local_kill:      allows local users to be /KILL'd
-        * oper:global_kill:     allows local and remote users to be /KILL'd
+        * auspex:oper:          allows the oper to see through oper hiding
+        * auspex:umodes:        allows viewing other users' modes
+        * auspex:cmodes:        shows privileged cmodes
+        * auspex:hostname:      shows hidden hostnames/ips
+        * oper:privs:           allows /stats o/O and seeing privset in /whois
+        * oper:testline:        allows /testline and /testgecos
+        * oper:kill:            allows local and remote users to be /KILL'd
         * oper:routing:         allows remote SQUIT and CONNECT
         * oper:kline:           allows KLINE and DLINE
         * oper:unkline:         allows UNKLINE and UNDLINE
@@ -446,20 +452,30 @@ privset "local_op" {
         *                       may (un)load modules and see various
         *                       additional information.
         * oper:hidden_admin:    gives admin privileges except
-        *                       will not have the admin lines in
-        *                       whois.
-        * oper:xline:           allows use of /quote xline/unxline
-        * oper:resv:            allows /quote resv/unresv
-        * oper:cmodes           allows cmode +LP
+        *                       will not have the admin lines in
+        *                       whois.
+        * oper:xline:           allows use of /quote xline/unxline
+        * oper:resv:            allows /quote resv/unresv
+        * oper:cmodes:          allows cmode +LP
         * oper:operwall:        allows the oper to send/receive operwalls
-        * oper:spy:             allows 'operspy' features to see through +s
-        *                       channels etc. see /quote help operspy
+        * oper:spy:             allows 'operspy' features to see through +s
+        *                       channels etc. see /quote help operspy
         * oper:hidden:          hides the oper from /stats p
         * oper:remoteban:       allows remote kline etc
         * oper:mass_notice:     allows sending wallops and mass notices
-        * oper:grant:           allows using the GRANT command
-        */
-       privs = oper:general, auspex:oper, oper:privs, oper:local_kill, oper:operwall;
+        * oper:grant:           allows using the GRANT command
+        * usermode:servnotice:  allows setting +s
+        *
+        * Privileges provided by extensions include:
+        *
+        * oper:dehelper:        allows the DEHELPER command (from extensions/helpops)
+        * oper:override:        enables oper override via umode +p (from extensions/override)
+        * oper:receive_immunity:
+        *   confers the benefits of chmode +M (operpeace) (from extensions/chm_operpeace)
+        * usermode:helpops      allows setting +h (from extensions/helpops)
+        */
+       privs = oper:general, oper:privs, oper:testline, oper:kill, oper:operwall, usermode:servnotice,
+               auspex:oper, auspex:hostname, auspex:umodes, auspex:cmodes;
 };
 
 privset "server_bot" {
@@ -470,7 +486,7 @@ privset "server_bot" {
 
 privset "global_op" {
        extends = "local_op";
-       privs = oper:global_kill, oper:routing, oper:kline, oper:unkline, oper:xline,
+       privs = oper:routing, oper:kline, oper:unkline, oper:xline,
                oper:resv, oper:cmodes, oper:mass_notice, oper:remoteban;
 };
 
@@ -615,12 +631,7 @@ connect "ssl.uplink.com" {
        flags = ssl, topicburst;
 };
 
-/* cluster {}; servers that we propagate things to automatically.
- * NOTE: This does NOT grant them privileges to apply anything locally,
- *       you must add a seperate shared block for that.  Clustering will
- *       only be done for actions by LOCAL opers, that arent directed
- *       remotely.
- */
+/* cluster {}; servers that we propagate things to automatically. */
 cluster {
        /* name: the server to share with, this can be a wildcard and may be
         * stacked.
@@ -653,8 +664,7 @@ cluster {
 
 /* service{}: privileged servers (services). These servers have extra
  * privileges such as setting login names on users and introducing clients
- * with umode +S (unkickable, hide channels, etc). This does not allow them
- * to set bans, you need a separate shared{} for that.
+ * with umode +S (unkickable, hide channels, etc).
  * Do not place normal servers here.
  * There may be only one service{} block.
  */
@@ -663,59 +673,6 @@ service {
        name = "services.int";
 };
 
-/* shared {}: users that are allowed to place remote bans on our server.
- * NOTE: These are ordered top down.  The first one the user@host and server
- *       matches will be used.  Their access will then be decided on that
- *       block and will not fall back to another block that matches.
- */
-shared {
-       /* oper: the user@host and server the user must be on to set klines.
-        * The first field must be a user@host, the second field is an
-        * optional server.  These may be stacked.
-        */
-       /* flags: list of what to allow them to place, all the oper lines
-        * above this (up until another flags entry) will receive these
-        * flags.  This *must* be present.
-        *
-        *    kline   - allow setting perm/temp klines
-        *    tkline  - allow setting temp klines
-        *    unkline - allow removing klines
-        *    xline   - allow setting perm/temp xlines
-        *    txline  - allow setting temp xlines
-        *    unxline - allow removing xlines
-        *    resv    - allow setting perm/temp resvs
-        *    tresv   - allow setting temp resvs
-        *    unresv  - allow removing xlines
-        *    all     - allow oper/server to do all of above.
-        *    locops  - allow locops - only used for servers who cluster
-        *    rehash  - allow rehashing
-        *    dline   - allow setting perm/temp dlines
-        *    tdline  - allow setting temp dlines
-        *    undline - allow removing dlines
-        *    grant   - allow granting operator status
-        *    die     - allow remote DIE/RESTART
-        *    module  - allow remote module commands
-        *    none    - disallow everything
-        */
-
-       /* allow flame@*.leeh.co.uk on server irc.ircd-ratbox.org and
-        * allow leeh@*.leeh.co.uk on server ircd.ircd-ratbox.org to kline
-        */
-       oper = "flame@*.leeh.co.uk", "irc.ircd-ratbox.org";
-       oper = "leeh@*.leeh.co.uk", "ircd.ircd-ratbox.org";
-       flags = kline;
-
-       /* you may forbid certain opers/servers from doing anything */
-       oper = "irc@vanity.oper", "*";
-       oper = "*@*", "irc.vanity.server";
-       oper = "irc@another.vanity.oper", "bigger.vanity.server";
-       flags = none;
-
-       /* or allow everyone to place temp klines */
-       oper = "*@*";
-       flags = tkline;
-};
-
 /* exempt {}: IPs that are exempt from Dlines and rejectcache. (OLD d:) */
 exempt {
        ip = "192.0.2.0/24";
@@ -724,6 +681,12 @@ exempt {
        ip = "127.0.0.1";
 };
 
+/* secure {}: IPs that are considered to be secure networks, and get
+ * +Z without using TLS */
+secure {
+       ip = "127.0.0.1";
+};
+
 /* The channel block contains options pertaining to channels */
 channel {
        /* invex: Enable/disable channel mode +I, a n!u@h list of masks
@@ -1335,7 +1298,7 @@ general {
 
        /* usermodes configurable: a list of usermodes for the options below
         *
-        * +g - callerid   - Server Side Ignore
+        * +g - callerid   - Server-side private message allow list
         * +D - deaf       - Don't see channel messages
         * +i - invisible  - Not shown in NAMES or WHO unless you share a
         *                   a channel