]> git.netwichtig.de Git - user/henk/code/inspircd.git/blobdiff - docs/inspircd.conf.example
Made sure this works prior to release
[user/henk/code/inspircd.git] / docs / inspircd.conf.example
index 3402a2c6053963a4304cf2ea73d96dea9a282f1a..c9756c85857ae2be3f0af1cd87275e5c09242ef3 100644 (file)
 #                                                                    #
 #  bind address - specifies which the address which ports bind       # 
 #  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.                               #
+#  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.#
+#                 if you do not bind your default route to an         #
+#                 external ip, or all ip's, you may have connection   #
+#                 problems.                                           #
 #                                                                    #
 #  Leaving address empty binds to all available interfaces            #
 #                                                                    #
 #  Syntax is as follows:                                              #
-#      <bind address="ip number" port="port number">                 #
+#                                                                     #
+# <bind address="ip number" port="port" type="clients">                      #
+# <bind address="ip number" port="port" type="servers">                      #
+# <bind address="ip number" port="port" type="servers" default="yes"> #
 #                                                                    #
 
-<bind address="" port="6667">
-<bind address="" port="7000">
+<bind address="" port="6660" type="clients">
+<bind address="" port="7000" type="servers" default="yes">
+<bind address="" port="7001" type="servers">
 
 
 #-#-#-#-#-#-#-#-#-#-  DIE/RESTART CONFIGURATION   -#-#-#-#-#-#-#-#-#-#-
@@ -73,7 +86,7 @@
 #   need this ability should know the die and restart password.       #
 #                                                                     #
 #  Syntax is as follows:                                              #
-#       <power diepass="die password" restartpass="restart password"
+#       <power diepass="die password" restartpass="restart password"  #
 #       pause="secs before dying">                                   #
 #                                                                     #
 
 #                                                                    #
 #  Syntax is as follows:                                             #
 #      <connect allow="ip number">                                   #
-#      <connect allow="ip number"  password="blahblah">              #
+#      <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">                                    #
+#                                                                     #
+#   You may optionally include timeout="x" on any allow line, which   #
+#   specifies the amount of time given before an unknown connection   #
+#   is closed if USER/NICK/PASS are not given. This value is in secs  #
 #                                                                    #
+#   You may also optionally include a flood="x" line which indicates  #
+#   the number of lines a user may place into their buffer at once    #
+#   before they are disconnected for excess flood. The default is to  #
+#   DISABLE this feature. A recommended value is 10.                  #
+
 
-<connect allow="196.12.*"  password="tiffany">
-<connect allow="*">
+<connect allow="196.12.*"  password="secret">
+<connect allow="*" timeout="60" flood="10">
 
 <connect deny="69.254.*">
 
         type="NetAdmin">
 
 
-#-#-#-#-#-#-#-#-#-#-  MISCELLANEOUS CONFIGURATION   -#-#-#-#-#-#-#-#-#-
+#-#-#-#-#-#-#-#-#-#-#-  SERVER LINK CONFIGURATION  -#-#-#-#-#-#-#-#-#-#
+#                                                                     #
+# Defines which servers can link to this one, and which servers this  #
+# server may create outbound links to.                                #
+#                                                                     #
+# 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.                     #
+# port      - Valid listening UDP port for remote server.             #
+# sendpass  - Password to send to create an outbound connection to    #
+#             this server.                                            #
+# recvpass  - Password to receive to accept an inbound connection     #
+#             from this server.                                       #
+#                                                                     #
+
+<link name="hub.penguin.org"
+       ipaddr="12.34.56.78"
+       port="7000"
+       sendpass="outgoing!password"
+       recvpass="incoming!password">
+
+
+
+#-#-#-#-#-#-#-#-#-#-  MISCELLANEOUS CONFIGURATION  -#-#-#-#-#-#-#-#-#-#
 #                                                                    #
 #   These options let you define the path to your motd and rules      #
 #   files.                                                           #
 #                                                                    #
 #   Settings to define which features are useable on your server.     #
 #                                                                    #
-#  prefixquit   - a prefix for a client's quit message                #
-#  debug        - provides an in-depth log file,                      #
-#                 this should not need to be enabled                  #
-#  allowhalfop  - allows the +h channel mode                         #
-#  allowprotect - allows the +a channel mode                         #
-#  allowfounder - allows the +q channel mode                         #
-#                                                                    #
+#  prefixquit    - a prefix for a client's quit message               #
+#  loglevel      - specifies what detail of messages to log in the    #
+#                  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                        #
+#  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)          #
 
 <options prefixquit="Quit: "
-        debug="off"
+        loglevel="default"
+        netbuffersize="10240"
         allowhalfop="yes"
         allowprotect="yes"
         allowfounder="yes">