[svn] Move new_local_user hook, so it is possible to call

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

diff --git a/doc/reference.conf b/doc/reference.conf
index 6fcb82e2f20a79e9139f918f8613f2953c7665b2..06ec89ead4b052c1f45cf7b603e73382b94131cc 100755 (executable)
--- a/doc/reference.conf
+++ b/doc/reference.conf
@@ -6,7 +6,7 @@
  *
  * Written by ejb, wcampbel, db, leeh and others
  *
- * $Id: reference.conf 3131 2007-01-21 15:36:31Z jilles $
+ * $Id: reference.conf 3390 2007-04-05 00:12:55Z jilles $
  */
 
 /* IMPORTANT NOTES:
@@ -118,6 +118,13 @@ serverinfo {
         * This should be an ipv6 IP only.
         */
        #vhost6 = "3ffe:80e8:546::2";
+
+       /* max_clients: this should be set to the maximum amount of clients
+        * 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;
 };
 
 /* admin {}: contains admin information about the server. (OLD A:) */
@@ -580,11 +587,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.
         */
@@ -675,7 +677,7 @@ serverhide {
 
 /* These are the blacklist settings.
  * You can have multiple combinations of host and rejection reasons.
- * They are used in pairs of one host/rejection reason.
+ * They are used in pairs of one host/rejection reason, or multiple hosts/rejection reason.
  *
  * These settings should be adequate for most networks, and are (presently)
  * required for use on AthemeNet.
@@ -683,16 +685,25 @@ serverhide {
  * Word to the wise: Do not use blacklists like SPEWS for blocking IRC
  * connections.
  *
+ * As of charybdis 2.2, you can do some keyword substitution on the rejection
+ * reason. The available keyword substitutions are:
+ *
+ *   ${ip}           - the user's IP
+ *   ${host}         - the user's canonical hostname
+ *   ${dnsbl-host}   - the dnsbl hostname the lookup was done against
+ *   ${nick}         - the user's nickname
+ *   ${network-name} - the name of the network
+ *
  * Note: AHBL (the providers of the below 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 {
 #      host = "ircbl.ahbl.org";
-#      reject_reason = "You have a host listed in the ircbl.ahbl.org blacklist.";
+#      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 = "You are connecting from a TOR exit node.";
+#      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.";
 #};
 
 /*