]> git.netwichtig.de Git - user/henk/code/inspircd.git/blobdiff - conf/inspircd.conf.example
Replace the IP (in addition to hostname) for CGIIRC clients; fixes glines and zlines...
[user/henk/code/inspircd.git] / conf / inspircd.conf.example
index fa32053d93b81cb63836fd1e4ad432e2ec50fcab..fc8c1962c2e1a36465f12de1b32bea112a103946 100644 (file)
 #   but if they can connect again to B, there are three. You get the  #
 #   idea (i hope).                                                    #
 #                                                                     #
+#   NOTE NOTE NOTE NOTE NOTE NOTE!                                    #
+#    The maximum limits by default apply to individual IP addresses   #
+#    This *MAY* be changed by modifying the <cidr> block, in order    #
+#    to detect cloning across an ISP.                                 #
+#                                                                     #
 #   The optional port value determines which port the connect tag is  #
 #   handling. If left out the connect tag covers all bound ports else #
 #   only incoming connections on the specified port will match. Port  #
 <connect deny="69.254.*">
 <connect deny="3ffe::0/32">
 
+#-#-#-#-#-#-#-#-#-#-#-#-  CIDR CONFIGURATION   -#-#-#-#-#-#-#-#-#-#-#-
+#                                                                     #
+# CIDR configuration allows detection of clones and applying of       #
+# throttle limits across a CIDR range. (A CIDR range is a group of    #
+# IPs, for example, the CIDR range 192.168.1.0-192.168.1.255 may be   #
+# represented as 192.168.1.0/24). This means that abuse across an ISP #
+# is detected and curtailed much easier.                              #
+#                                                                     #
+# ipv4clone:                                                          #
+#  This specifies how many bits of an IP address should be checked    #
+#  against cloning in the <connect> tags, for example, if <connect>   #
+#  tags specified a limit of 2 (low!), and three users attempted to   #
+#  connect in the IP range 192.168.1.0-192.168.1.255, and ipv4clone   #
+#  was set to '24', the third connection would be disconnected.       #
+#                                                                     #
+#  Valid values are 0-32, but you *don't* want 0. Using values which  #
+#  are not multiples of 8 can give confusing behaviour.               #
+#  For more info, see: http://www.inspircd.org/wiki/CIDR_Tutorial     #
+#                                                                     #
+# ipv6clone works in the same way, except for ipv6 addresses. Valid   #
+# range is 0-128, but you *don't* want anything too small.            #
+#                                                                     #
+# Setting these to their maximum value (32, 128) will result in       #
+# no actual CIDR checking being done, and clone checking will only be #
+# done across individual IPs. This is the default behaviour.          #
+
+<cidr
+       ipv4clone="32"
+       ipv6clone="128">
 
 #-#-#-#-#-#-#-#-#-#-#-#-  CLASS CONFIGURATION   -#-#-#-#-#-#-#-#-#-#-#-
 #                                                                     #
 <banlist chan="#morons" limit="128">
 <banlist chan="*" limit="69">
 
-#-#-#-#-#-#-#-#-#-#-#-  DISABLED COMMANDS  -#-#-#-#-#-#-#-#-#-#-#-#-#-#
+#-#-#-#-#-#-#-#-#-#-#-  DISABLED FEATURES  -#-#-#-#-#-#-#-#-#-#-#-#-#-#
 #                                                                     #
-# This tag is optional, and specifies one or more commands which are  #
-# not available to non-operators. For example you may wish to disable #
-# NICK and prevent non-opers from changing their nicknames.           #
+# This tag is optional, and specifies one or more features which are  #
+# not available to non-operators.                                     #
+#                                                                     #
+# For example you may wish to disable NICK and prevent non-opers from #
+# changing their nicknames.                                           #
 # Note that any disabled commands take effect only after the user has #
 # 'registered' (e.g. after the initial USER/NICK/PASS on connection)  #
 # so for example disabling NICK will not cripple your network.        #
 #                                                                     #
-
-#<disabled commands="TOPIC MODE">
+# `fakenonexistant' will make the ircd pretend that nonexistant       #
+# commands simply don't exist to non-opers ("no such command").       #
+#                                                                     #
+#<disabled commands="TOPIC MODE" usermodes="" chanmodes="" fakenonexistant="yes">
 
 
 #-#-#-#-#-#-#-#-#-#-#-#-#-#-#-  RTFM LINE  -#-#-#-#-#-#-#-#-#-#-#-#-#-#
 #                  This can be useful for finding servers which are   #
 #                  at risk of pinging out due to network issues.      #
 #                                                                     #
-#  exemptchanops - This option allows channel operators to be exempted#
-#                  from certain channel modes.                        #
-#                  Supported modes are +SfFgNc. Defaults to off.      #
-#                                                                     #
 #  defaultmodes  - The default modes to be given to each channel on   #
 #                  creation. Defaults to 'nt'. There should be no +   #
 #                  or - symbols in this sequence, if you add them     #
 #                  is totally freeform, you may place any text here   #
 #                  you wish.                                          #
 #                                                                     #
+#  exemptchanops - This option allows channel operators to be exempted#
+#                  from certain channel modes.                        #
+#                  Supported modes are +SfFgNc. Defaults to off.      #
+#                                                                     #
+#  invitebypassmodes - This option allows /invite to bypass modes     #
+#    other than +i.                                                   #
+#                                                                     #
+#                                                                     #
 
 <options prefixquit="Quit: "
          suffixquit=""
          allowhalfop="yes"
          defaultmodes="nt"
          moronbanner="You're banned! Email haha@abuse.com with the ERROR line below for help."
-         exemptchanops="">
+         exemptchanops=""
+        invitebypassmodes="yes">
 
 
 #-#-#-#-#-#-#-#-#-#-#-# PERFORMANCE CONFIGURATION #-#-#-#-#-#-#-#-#-#-#
 # You may also log *everything* by using a type of *, and subtract things out
 # of that by using -TYPE - for example "* -USERINPUT -USEROUTPUT".
 #
-# Channel Logging
-# ---------------
-#
-# I'm aware this would probably better belong in the modules section, but this
-# is heavily interrelated to logging, and as such will be documented here.
-#
-# m_chanlog is one of the modules which can alter logging to it's own thing.
-# An example of this may be:
-#
-#<module name="m_chanlog.so">
-#<log method="channel" type="OPER USERS CHANNELS" level="default" target="#services">
-#
 # The following log tag is highly default and uncustomised. It is recommended you
 # sort out your own log tags. This is just here so you get some output.
 <log method="file" type="* -USERINPUT -USEROUTPUT -m_spanningtree" level="default" target="ircd.log">
 #   |  _ <  __/ (_| | (_| |   | | | | | | \__ \ | |_) | | |_|_|       #
 #   |_| \_\___|\__,_|\__,_|   |_| |_| |_|_|___/ |____/|_|\__(_)       #
 #                                                                     #
-# Well done, you've reached the end of this.                          #
+# Well done, you've reached the end of the basic configuration, your  #
+# ircd should now start if you want to try it out! (./inspircd start) #                      
+#                                                                     #
 # We now suggest you read and edit modules.conf, as modules are what  #
 # provide almost all the features of InspIRCd. :)                     #
 #                                                                     #