]> jfr.im git - irc/rqf/shadowircd.git/blobdiff - doc/example.conf
[svn] Remove server_exists() which checked whether the
[irc/rqf/shadowircd.git] / doc / example.conf
index a0576c58bbba57519b2219eb882e4ef4342cc7e5..25d5979606a9e5d0feff51c18b8eb8fb789665b2 100755 (executable)
@@ -4,7 +4,7 @@
  * Copyright (C) 2002-2005 ircd-ratbox development team
  * Copyright (C) 2005-2006 charybdis development team
  *
- * $Id: example.conf 3131 2007-01-21 15:36:31Z jilles $
+ * $Id: example.conf 3159 2007-01-25 07:08:21Z nenolod $
  *
  * See reference.conf for more information.
  */
@@ -286,7 +286,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.
@@ -294,16 +294,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.";
 #};
 
 alias "NickServ" {