]> jfr.im git - irc/rqf/shadowircd.git/blobdiff - doc/reference.conf
Remove Server.up and Server.upid.
[irc/rqf/shadowircd.git] / doc / reference.conf
index d5a4f59ece456c9b30e01a8e8817ce15ea38c2d0..768ce0bbac899373ed7b7966af233c7dd0c86721 100755 (executable)
@@ -6,7 +6,7 @@
  *
  * Written by ejb, wcampbel, db, leeh and others
  *
- * $Id: reference.conf 3251 2007-03-05 18:58:38Z nenolod $
+ * $Id: reference.conf 3582 2007-11-17 21:55:48Z jilles $
  */
 
 /* IMPORTANT NOTES:
@@ -57,6 +57,7 @@
  * Far connection notices (snomask +F)            -- sno_farconnect.so
  * Remote k/d/g/x line active notices             -- sno_globalkline.so
  * Remote oper up notices                         -- sno_globaloper.so
+ * /whois notifications (snomask +W)              -- sno_whois.so
  */
 #loadmodule "extensions/createauthonly.so";
 #loadmodule "extensions/extb_account.so";
 #loadmodule "extensions/sno_farconnect.so";
 #loadmodule "extensions/sno_globalkline.so";
 #loadmodule "extensions/sno_globaloper.so";
+#loadmodule "extensions/sno_whois.so";
  
 /* serverinfo {}:  Contains information about the server. (OLD M:) */
 serverinfo {
        /* name: the name of our server */
        name = "hades.arpa";
 
-       /* use ts6: whether we want to use the TS6 protocol to other servers
-        * or not.
-        */
-       use_ts6 = yes;
-
        /* sid: the unique server id of our server.  This must be three
         * characters long.  The first character must be a digit [0-9], the
         * remaining two chars may be letters [A-Z] or digits [0-9].
         *
-        * This must be specified even if use_ts6 is set to no.
+        * This parameter must be specified for the server to start.
         */
        sid = "42X";
 
@@ -120,7 +117,9 @@ serverinfo {
        #vhost6 = "3ffe:80e8:546::2";
 
        /* max_clients: this should be set to the maximum amount of clients
-        * that the server should support.
+        * that the server should support. Note that you should leave some
+        * file descriptors free for log files, server connections, ident
+        * lookups (if enabled), exceed_limit clients, etc.
         */
        max_clients = 1024;
 };
@@ -262,8 +261,11 @@ listen {
 
 /* auth {}: allow users to connect to the ircd (OLD I:) */
 auth {
-       /* user: the user@host allowed to connect.  multiple IPv4/IPv6 user 
-        * lines are permitted per auth block.
+       /* user: the user@host allowed to connect.  Multiple IPv4/IPv6 user
+        * lines are permitted per auth block.  This is matched against the
+        * hostname and IP address (using :: shortening for IPv6 and
+        * prepending a 0 if it starts with a colon) and can also use CIDR
+        * masks.
         */
        user = "*@172.16.0.0/12";
        user = "*test@123D:B567:*";
@@ -376,11 +378,11 @@ operator "god" {
         * global_kill:  allows local and remote users to be 
         *               /KILL'd                           (OLD 'O' flag)
         * remote:       allows remote SQUIT and CONNECT   (OLD 'R' flag)
-        * kline:        allows KILL, KLINE and DLINE      (OLD 'K' flag)
+        * kline:        allows KLINE and DLINE            (OLD 'K' flag)
         * unkline:      allows UNKLINE and UNDLINE        (OLD 'U' flag)
         * gline:        allows GLINE                      (OLD 'G' flag)
         * nick_changes: allows oper to see nickchanges    (OLD 'N' flag)
-        *               via usermode +n
+        *               via snomask +n
         * rehash:       allows oper to REHASH config      (OLD 'H' flag)
         * die:          allows DIE and RESTART            (OLD 'D' flag)
         * admin:        gives admin privileges.  admins
@@ -390,7 +392,7 @@ operator "god" {
         *               will not have the admin lines in
         *               stats p and whois.
         * xline:        allows use of /quote xline/unxline
-        * operwall:     allows the oper to send operwalls [DEFAULT]
+        * operwall:     allows the oper to send/receive operwalls [DEFAULT]
         * oper_spy:     allows 'operspy' features to see through +s
         *               channels etc. see /quote help operspy
         * hidden_oper:  hides the oper from /stats p    (OLD UMODE +p) 
@@ -446,6 +448,10 @@ connect "irc.uplink.com" {
 };
 
 connect "ipv6.some.server" {
+       /* Hosts that are IPv6 addresses must be in :: shortened form
+        * if applicable.  Addresses starting with a colon get an extra
+        * zero prepended, for example: 0::1
+        */
         host = "3ffd:dead:beef::1";
         send_password = "password";
         accept_password = "password";
@@ -553,7 +559,7 @@ shared {
        flags = tkline;
 };
 
-/* exempt {}: IPs that are exempt from Dlines. (OLD d:) */
+/* exempt {}: IPs that are exempt from Dlines and rejectcache. (OLD d:) */
 exempt {
        ip = "192.168.0.0/16";
 
@@ -585,11 +591,6 @@ channel {
         */
        use_knock = yes;
 
-       /* invite ops only: Restrict /invite to ops on channels, rather than
-        * allowing unopped users to invite people to a -i channel.
-        */
-       invite_ops_only = yes;
-
        /* knock delay: The amount of time a user must wait between issuing
         * the knock command.
         */
@@ -697,17 +698,20 @@ serverhide {
  *   ${nick}         - the user's nickname
  *   ${network-name} - the name of the network
  *
- * Note: AHBL (the providers of the below BLs) request that they be
+ * Note: AHBL (the providers of the below *.ahbl.org BLs) request that they be
  * contacted, via email, at admins@2mbit.com before using these BLs.
  * See <http://www.ahbl.org/services.php> for more information.
  */
-#blacklist {
+blacklist {
+       host = "dnsbl.dronebl.org";
+       reject_reason = "${nick}, your IP (${ip}) is listed in DroneBL. For assistance, see http://dronebl.org/lookup_branded.do?ip=${ip}&network=${network-name}";
+
 #      host = "ircbl.ahbl.org";
 #      reject_reason = "${nick}, your IP (${ip}) is listed in ${dnsbl-host} for having an open proxy. In order to protect ${network-name} from abuse, we are not allowing connections with open proxies to connect.";
 #
 #      host = "tor.ahbl.org";
 #      reject_reason = "${nick}, your IP (${ip}) is listed as a TOR exit node. In order to protect ${network-name} from tor-based abuse, we are not allowing TOR exit nodes to connect to our network.";
-#};
+};
 
 /*
  * Alias blocks allow you to define custom commands. (Old m_sshortcut.c)
@@ -1122,6 +1126,11 @@ general {
 
        /* reject duration: the amount of time to cache the rejection */
        reject_duration = 5 minutes;
+
+       /* max_unknown_ip: maximum number of pending connections to the server
+         * that are allowed per IP address
+        */
+       max_unknown_ip = 2;
 };
 
 modules {