]> git.netwichtig.de Git - user/henk/code/inspircd.git/blobdiff - docs/inspircd.conf.example
Added /stats T
[user/henk/code/inspircd.git] / docs / inspircd.conf.example
index bf2e7bc627ca234ee46d2726713c2a0a1332fef1..4e98838a72c33dd7fd06c4fcdb1dd22c9786877e 100644 (file)
 #   To allow/deny all connections use a *                             #
 #                                                                    #
 #  Syntax is as follows:                                             #
-#      <connect allow="ip number">                                   #
-#      <connect allow="ip number" password="blahblah">               #
-#       <connect allow="ip number" password="blah" timeout="10">      #
-#      <connect allow="ip number" timeout="blah" flood="5">          #
-#      <connect deny="ip number">                                    #
+#      <connect allow="ip or host">                                  #
+#      <connect allow="ip or host" password="blahblah">              #
+#       <connect allow="ip or host" password="blah" timeout="10">     #
+#      <connect allow="ip or host" timeout="blah" flood="5">         #
+#      <connect deny="ip or host">                                   #
 #                                                                     #
 #   You may optionally include timeout="x" on any allow line, which   #
 #   specifies the amount of time given before an unknown connection   #
 # name      - The name is the canocial name of the server, it does    #
 #             not have to resolve - but it is expected to be sent in  #
 #             the remote servers connection info.                     #
-# ipaddr    - Valid ip address for remote server.                     #
+# ipaddr    - Valid host or ip address for remote server. *           #
 # port      - Valid listening UDP port for remote server.             #
 # sendpass  - Password to send to create an outbound connection to    #
 #             this server.                                            #
 # that server to operoverride modes. This should only be used for     #
 # services and protected oper servers!                                #
 #                                                                     #
+# IMPORTANT NOTE: When specifying the ip address and/or host, the     #
+# server software will prioritize RESOLVED hostnames above ip         #
+# addresses, so for example if your target server resolves to a.b.com #
+# you MUST put a.b.com into your link block, and NOT the IP address   #
+# of a.b.com. The system uses reverse resolution.                     #
+#                                                                     #
 
 <link name="hub.penguin.org"
-       ipaddr="12.34.56.78"
+       ipaddr="penguin.box.com"
        port="7000"
        sendpass="outgoing!password"
        recvpass="incoming!password">
 
 <link name="services.antarctic.com"
-       ipaddr="98.76.54.32"
+       ipaddr="localhost"
        port="7000"
        sendpass="penguins"
        recvpass="polarbears">
 <files  motd="/home/cc/inspircd-1.0/conf/inspire.motd"
        rules="/home/cc/inspircd-1.0/conf/inspire.rules">
 
-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-  RTFM LINE  -#-#-#-#-#-#-#-#-#-#-#-#-#-#
+#-#-#-#-#-#-#-#-#-#-#-#-#-#-# DNS SERVER -#-#-#-#-#-#-#-#-#-#-#-#-#-#-#
 #                                                                     #
 # Define your DNS server address here. InspIRCd has its own resolver  #
 # and you must define this otherwise nobody's host will resolve. The  #
 # timeout value is in seconds.                                       #
+#                                                                     #
 
 <dns server="127.0.0.1" timeout="5">
 
+#-#-#-#-#-#-#-#-#-#-#-#-#-#-#  PID FILE  -#-#-#-#-#-#-#-#-#-#-#-#-#-#-#
+#                                                                     #
+# Define the path to the PID file here. The PID file can be used to   #
+# rehash the ircd from the shell or to terminate the ircd from the    #
+# shell using shell scripts, perl scripts etc, and to monitor the     #
+# ircd's state via cron jobs.                                         #
+#                                                                     #
+
+<pid file="/path/to/inspircd.pid">
+
+#-#-#-#-#-#-#-#-#-#-#-#-#- BANLIST LIMITS #-#-#-#-#-#-#-#-#-#-#-#-#-#-#
+#                                                                     #
+# Use these tags to customise the ban limits on a per channel basis.  #
+# the tags are read from top to bottom, and any tag found which       #
+# matches the channels name applies the banlimit to that channel.     #
+# It is advisable to put an entry with the channel as '*' at the      #
+# bottom of the list. If none are specified or no maxbans tag is      #
+# matched, the banlist size defaults to 64 entries.                   #
+#                                                                     #
+
+<banlist chan="#morons" limit="128">
+<banlist chan="*" limit="69">
+
+#-#-#-#-#-#-#-#-#-#-#-  DISABLED COMMANDS  -#-#-#-#-#-#-#-#-#-#-#-#-#-#
+#                                                                     #
+# 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.           #
+# 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">                            #
+#                                                                     #
+
 
 #-#-#-#-#-#-#-#-#-#-#-#-#-#-#-  RTFM LINE  -#-#-#-#-#-#-#-#-#-#-#-#-#-#
 #                                                                     #
         loglevel="default"
         netbuffersize="10240"
          maxwho="128"
-        noservices="0">
+        noservices="0"
         allowhalfop="yes">
 
 
 # host         -          ident@hostname (wildcards possible)         #
 # reason       -          Reason to display on disconnection          #
 #                                                                     #
+# exception lines define a hostmask that is excempt from [kzg]lines   #
+#                                                                     #
+# host         -          ident@hostname (wildcards possible)         #
+# reason       -          Reason, shown only in /stats e              #
+#                                                                     #
 
 <badip ipmask="69.69.69.69" reason="No porn here thanks.">
 
 <badhost host="*@hundredz.n.hundredz.o.1337.kiddies.com" reason="Too many 1337 kiddiots">
 <badhost host="*@localhost" reason="No irc from localhost!">
 
+<exception host="*@ircop.host.com" reason="Opers hostname">
+
 #-#-#-#-#-#-#-#-#-#-#-  ALIAS DEFINITIONS  -#-#-#-#-#-#-#-#-#-#-#-#-#-#
 #                                                                     #
 # If you have the m_alias.so module loaded, you may also define       #
 
 <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">