]> git.netwichtig.de Git - user/henk/code/inspircd.git/blobdiff - docs/inspircd.conf.example
Added manpages
[user/henk/code/inspircd.git] / docs / inspircd.conf.example
index 9ecf02f5f35560b9c59284003fe1cd419f0783cc..cccae5ed055b89ddbf30de4093b5b70f5fe9b3fd 100644 (file)
@@ -11,9 +11,9 @@
 #         This is an example of the config file for InspIRCd.          #
 #             Change the options to suit your network                  #
 #                                                                     #
-#                 Last updated on : 30/10/2002                         #
+#                 Last updated on : 01/05/2004                         #
 #                 Written by      : CC  (cc@backchat.co.za)            #
-#                                                                     #
+#                 Updated by      : BlackDeathX (james@dreamirc.org)   #
 ########################################################################
 
 
@@ -57,7 +57,8 @@
 #  port                - opens an unused port                                #
 #  type         - can be 'clients' or 'servers'. The clients type is  #
 #                 a standard tcp based socket, the servers type is a  #
-#                 UDP based connection.                               #
+#                 also a TCP based connection but of a different      #
+#                 format.                                             #
 #  default      - if the port type is 'servers' then this can be      #
 #                 specified. If set to 'yes', it indicates that this  #
 #                 port is the default route for all /connect commands.#
 #                  log file. You may select from debug, verbose,      #
 #                  default, sparse and none.                          #
 #  allowhalfop   - allows the +h channel mode                        #
-#  allowprotect  - allows the +a channel mode                        #
-#  allowfounder  - allows the +q channel mode                        #
+#  noservices    - If noservices is true, yes, or 1, then the first   #
+#                  user into a channel gets founder status. This is   #
+#                  only useful on networks running the m_chanprotect  #
+#                  module without services.                           #
 #  netbuffersize - size of the buffer used to receive data from       #
 #                  clients. The ircd may only read() this amount      #
 #                 of text in one go at any time. (OPTIONAL)          #
+#  maxwho        - The maximum number of results returned by a /WHO   #
+#                  query. This is to prevent /WHO being used as a     #
+#                  spam vector or means of flooding an ircd. The      #
+#                  default is 128, it is not recommended to raise it  #
+#                  above 1024. Values up to 65535 are permitted.      #
 
 <options prefixquit="Quit: "
         loglevel="default"
         netbuffersize="10240"
-        allowhalfop="yes"
-        allowprotect="yes"
-        allowfounder="yes">
+         maxwho="128"
+        noservices="0">
+        allowhalfop="yes">
 
 
 
 
 <module name="m_foobar.so">
 
+#-#-#-#-#-#-#-#-#-#-#-  FILTER  CONFIGURATION  -#-#-#-#-#-#-#-#-#-#-#-#
+#                                                                     #
+# Optional - If you specify to use the m_filter.so module, then       #
+# specfiy below the path to the filter.conf file.                     #
+
+<filter file="/path/to/inspircd/filter.conf">
+
+
+#-#-#-#-#-#-#-#-#-#-#-#-  HELPOP  CONFIGURATION  -#-#-#-#-#-#-#-#-#-#-#
+#                                                                     #
+# Optional - If you specify to use the m_helpop.so module, then       #
+# specify below the path to the helpop.conf file.                     #
+
+<helpop file="/path/to/inspircd/helpop.conf">
+
+
+#-#-#-#-#-#-#-#-#-#-  RANDOMQUOTES CONFIGURATION -#-#-#-#-#-#-#-#-#-#-#
+#                                                                     #
+# Optional - If you specify to use the m_randquotes.so module, then   #
+# specify below the path to the randquotes.conf file.                 #
+
+<randquote file="/path/to/inspircd/randquotes.conf">
+
+#-#-#-#-#-#-#-#-#-#-#-#-#-#-  BAN OPTIONS  -#-#-#-#-#-#-#-#-#-#-#-#-#-#
+#                                                                     #
+# The ban tags define nick masks, host masks and ip ranges which are  #
+# banned from your server. All details in these tags are local to     #
+# Your server.                                                        #
+#                                                                     #
+#                                                                     #
+# badip lines ban an ip range (same as a zline)                       #
+#                                                                     #
+# ipmask       -          The ip range to ban (wildcards possible)    #
+# reason       -          Reason to display when disconnected         #
+#                                                                     #
+# badnick lines ban a nick mask (same as a qline)                     #
+#                                                                     #
+# nick         -          Nick mask to ban (wildcards possible)       #
+# reason       -          Reason to display on /NICK                  #
+#                                                                     #
+# badhost lines ban a user@host mask (same as a kline)                #
+#                                                                     #
+# host         -          ident@hostname (wildcards possible)         #
+# reason       -          Reason to display on disconnection          #
+#                                                                     #
+
+<badip ipmask="69.69.69.69" reason="No porn here thanks.">
+
+<badnick nick="ChanServ" reason="Reserved For Services">
+<badnick nick="NickServ" reason="Reserved For Services">
+<badnick nick="OperServ" reason="Reserved For Services">
+<badnick nick="MemoServ" reason="Reserved For Services">
+
+<badhost host="*@hundredz.n.hundredz.o.1337.kiddies.com" reason="Too many 1337 kiddiots">
+<badhost host="*@localhost" reason="No irc from localhost!">
+
+#-#-#-#-#-#-#-#-#-#-#-  ALIAS DEFINITIONS  -#-#-#-#-#-#-#-#-#-#-#-#-#-#
+#                                                                     #
+# If you have the m_alias.so module loaded, you may also define       #
+# aliases as shown below. They are commonly used to provide shortcut  #
+# commands to services, however they are not limited to jsut this use.#
+# An alias tag requires the following values to be defined in it:     #
+#                                                                     #
+# text        -      The text to detect at the start of the line,     #
+#                    must be at the start of the line to trigger the  #
+#                    alias. May contain spaces, but case insensitive. #
+# replace     -      The text to replace 'text' with. Usually this    #
+#                    will be "PRIVMSG ServiceName :" or similar.      #
+# requires    -      If you provide a value for 'requires' this means #
+#                    the given nickname MUST be online for the alias  #
+#                    to successfully trigger. If they are not, then   #
+#                    the user receives a 'no such nick' 401 numeric.  #
+# uline       -      Defining this value with 'yes', 'true' or '1'    #
+#                    will ensure that the user given in 'requires'    #
+#                    must also be on a u-lined server, as well as     #
+#                    actually being on the network. If the user is    #
+#                    online, but not on a u-lined server, then an     #
+#                    oper-alert is sent out as this is possibly signs #
+#                    of a user trying to impersonate a service.       #
+#                                                                     #
 
+<alias text="NICKSERV" replace="PRIVMSG NickServ :" requires="NickServ" uline="yes">
+<alias text="CHANSERV" replace="PRIVMSG ChanServ :" requires="ChanServ" uline="yes">
+<alias text="NS ID" replace="PRIVMSG NickServ :identify" requires="NickServ" uline="yes">
+<alias text="NS" replace="PRIVMSG NickServ :" requires="NickServ" uline="yes">
+<alias text="CS" replace="PRIVMSG ChanServ :" requires="ChanServ" uline="yes">
 
 #-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#- YAWN  -#-#-#-#-#-#-#-#-#-#-#-#-#-#-#
 #                                                                     #