X-Git-Url: https://git.netwichtig.de/gitweb/?a=blobdiff_plain;f=conf%2Finspircd.conf.example;h=baadf24d62233c39ad47a1823bc4e2311517e581;hb=fa67c7e80b15060773295e4719545a802d8717d5;hp=595c97cfdfd557243fe56622a72a54aaacd5f401;hpb=cca3f7039843f332df957493014186d0230701c2;p=user%2Fhenk%2Fcode%2Finspircd.git diff --git a/conf/inspircd.conf.example b/conf/inspircd.conf.example index 595c97cfd..baadf24d6 100644 --- a/conf/inspircd.conf.example +++ b/conf/inspircd.conf.example @@ -21,7 +21,7 @@ # Change the options to suit your network # # # # $Id$ -# # +# # # ____ _ _____ _ _ ____ _ _ _ # # | _ \ ___ __ _ __| | |_ _| |__ (_)___ | __ )(_) |_| | # # | |_) / _ \/ _` |/ _` | | | | '_ \| / __| | _ \| | __| | # @@ -46,9 +46,8 @@ # file you include will be treated as part of the configuration file # # which includes it, in simple terms the inclusion is transparent. # # # -# All paths to config files are relative to the directory of the main # -# config file inspircd.conf, unless the filename starts with a forward# -# slash (/) in which case it is treated as an absolute path. # +# All paths to config files are relative to the directory that the # +# process runs in. # # # # You may also include an executable file, in which case if you do so # # the output of the executable on the standard output will be added # @@ -57,24 +56,47 @@ # Syntax is as follows: # # # # # -# # -# Executable Include Example: # -# # # +# Executable Include Example: # +# +# # + +#-#-#-#-#-#-#-#-#-#-#-# VARIABLE DEFINITIONS -#-#-#-#-#-#-#-#-#-#-#-# +# # +# You can define variables that will be substituted later in the # +# configuration file. This can be useful to allow settings to be # +# easily changed, or to parameterize a remote includes. # +# # +# Variables may be redefined and may reference other variables. # +# Value expansion happens at the time the tag is read. # +# # +# Using variable definitions REQUIRES that the config format be # +# changed to "xml" from the default "compat" that uses escape # +# sequences such as "\"" and "\n", and does not support # + + + #-#-#-#-#-#-#-#-#-#-#-#- SERVER DESCRIPTION -#-#-#-#-#-#-#-#-#-#-#-#- # # # Here is where you enter the information about your server. # # # - + # just remove or comment out this option. + ssl="gnutls" + > -# When linking servers, the openssl and gnutls transports are largely -# link-compatible and can be used alongside each other or either/or +# When linking servers, the openssl and gnutls transports are completely +# link-compatible and can be used alongside each other # on each end of the link without any significant issues. # Transports can only be used on server blocks. -# Supported Transports are: "zip", "openssl" and "gnutls". +# Supported Transports are: "ziplinks", "openssl" and "gnutls". # You must load m_ziplinks module for zip, m_ssl_openssl for openssl # or m_ssl_gnutls for gnutls. - + #-#-#-#-#-#-#-#-#-#- DIE/RESTART CONFIGURATION -#-#-#-#-#-#-#-#-#-#- @@ -161,15 +184,22 @@ # need this ability should know the die and restart password. # # # - + #hash="sha256" - # diepass: Password for opers to use if they need to shutdown (die) - # a server. - diepass="" + # diepass: Password for opers to use if they need to shutdown (die) + # a server. + diepass="" - # restartpass: Password for opers to use if they need to restart - # a server. - restartpass=""> + # restartpass: Password for opers to use if they need to restart + # a server. + restartpass=""> #-#-#-#-#-#-#-#-#-#- CONNECTIONS CONFIGURATION -#-#-#-#-#-#-#-#-#-#-# @@ -179,19 +209,81 @@ # You may have as many of these as you require. To allow/deny all # # connections, use a '*' or 0.0.0.0/0. # # # +# -- It is important to note that connect tags are read from the -- # +# TOP DOWN. This means that you should have more specific deny # +# and allow tags at the top, progressively more general, followed # +# by a + + + + + #hash="sha256" # password: Password to use for this block/user(s) - password="secret" + password="secret" + + # maxchans: Maximum number of channels a user in this class + # be in at one time. This overrides every other maxchans setting. + #maxchans="30" + + # timeout: How long (in seconds) the server will wait before + # disconnecting a user if they do not do anything on connect. + # (Note, this is a client-side thing, if the client does not + # send /nick, /user or /pass) + timeout="10" + + # localmax: Maximum local connections per IP (or CIDR mask, see below). + localmax="3" + + # globalmax: Maximum global (network-wide) connections per IP (or CIDR mask, see below). + globalmax="3" + + # useident: Defines if users in this class MUST respond to a ident query or not. + useident="no" + + # limit: How many users are allowed in this class + limit="5000" + + # modes: Usermodes that are set on users in this block on connect. + # Enabling this option requires that the m_conn_umodes module be loaded. + # This entry is highly recommended to use for/with IP Cloaking/masking. + # For the example to work, this also requires that the m_cloaking + # module be loaded as well. + modes="+x" # port: What port this user is allowed to connect on. (optional) # The port MUST be set to listen in the bind blocks above. port="6667"> - - - #-#-#-#-#-#-#-#-#-#-#-#- CIDR CONFIGURATION -#-#-#-#-#-#-#-#-#-#-#- # # @@ -248,44 +362,47 @@ # 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. # +# is detected and curtailed much easier. Here is a good chart that # +# shows how many IPs the different CIDRs correspond to: # +# http://en.wikipedia.org/wiki/CIDR#Prefix_aggregation # # # + # ipv4clone: specifies how many bits of an IP address should be + # looked at for clones. The default only looks for clones on a + # single IP address of a user. You do not want to set this + # extremely low. (Values are 0-32). + ipv4clone="32" + + # ipv6clone: specifies how many bits of an IP address should be + # looked at for clones. The default only looks for clones on a + # single IP address of a user. You do not want to set this + # extremely low. (Values are 0-128). + ipv6clone="128"> # This file has all the information about oper classes, types and o:lines. # You *MUST* edit it. - + # This file has all the information about server links and ulined servers. # You *MUST* edit it if you intend to link servers. - + #-#-#-#-#-#-#-#-#-#- MISCELLANEOUS CONFIGURATION -#-#-#-#-#-#-#-#-#-# # # - + # rules: Path to your rules file. Path is relative to the run directory. + # This is optional and is displayed when a user does /rules on the network. + rules="conf/inspircd.rules.example"> #-#-#-#-#-#-#-#-#-#-#-# MAXIMUM CHANNELS -#-#-#-#-#-#-#-#-#-#-#-#-#-#-# # # - @@ -341,6 +464,9 @@ # 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. # +# # +# You can also define if you want to disable any channelmodes # +# or usermodes from your users. # # # # `fakenonexistant' will make the ircd pretend that nonexistant # # commands simply don't exist to non-opers ("no such command"). # @@ -362,7 +488,7 @@ # Settings to define which features are usable on your server. # # # - # suffixpart: What (if anything) a users' part message # should be suffixed with. - suffixpart="\"" - - # noservices: With this set to no, when a user joins a empty channel, - # the server will set +q on them. If set to yes, it will only set +o - # on them until they register the channel. - noservices="no" - - # qprefix: Prefix (symbol) to use for +q users. - qprefix="~" + suffixpart=""" - # aprefix: Prefix (symbol) to use for +a users. - aprefix="&" + # fixedquit: Set all users' quit messages to this value. + #fixedquit="" - # deprotectself: If this value is set (true, yes or 1), it will allow - # +a and +q users to remove the +a and +q from themselves, otherwise, - # the status will have to be removed by services. - deprotectself="no" - - # deprotectothers: If this value is set to yes, true, or 1, then any - # user with +q or +a may remove the +q or +a from other users. - # The default setting is to not enable this feature, so that - # only +q may remove +a, and nothing but services may remove +q. - deprotectothers="no" + # fixedpart: Set all users' part messages in all channels + # to this value. + #fixedpart="" # syntaxhints: If enabled, if a user fails to send the correct parameters - # for a command, the ircd will give back soome help text of what - # the correct parameters are + # for a command, the ircd will give back some help text of what + # the correct parameters are. syntaxhints="no" # cyclehosts: If enabled, when a user gets a host set, it will cycle @@ -413,15 +525,20 @@ # ircumsgprefix: Use undernet-style message prefixing for NOTICE and # PRIVMSG. If enabled, it will add users' prefix to the line, if not, - # it will just message the user. + # it will just message the user normally. ircumsgprefix="no" - # announcets: If set to yes, when the TS on a channel changes, all users + # announcets: If set to yes, when the TimeStamp on a channel changes, all users # in channel will be sent a NOTICE about it. announcets="yes" + # allowmismatched: Setting this option to yes will allow servers to link even + # if they don't have the same VF_OPTCOMMON modules loaded. Setting this to + # yes may introduce some desyncs and weirdness. + allowmismatched="no" + # hostintopic: If enabled, channels will show the host of the topicsetter - # in the topic. + # in the topic. If set to no, it will only show the nick of the topicsetter. hostintopic="yes" # pingwarning: If a server does not respond to a ping within x seconds, @@ -444,26 +561,21 @@ # banned from the server. moronbanner="You're banned! Email haha@abuse.com with the ERROR line below for help." - # exemptchanops: Defines what channel modes channel operators are - # exempt from. Supported modes are +SfFgNc. Defaults to off. - exemptchanops="" - # invitebypassmodes: This allows /invite to bypass other channel modes. # (Such as +k, +j, +l, etc) - invitebypassmodes="yes"> + invitebypassmodes="yes"> #-#-#-#-#-#-#-#-#-#-#-# PERFORMANCE CONFIGURATION #-#-#-#-#-#-#-#-#-#-# # # - #-#-#-#-#-#-#-#-#-#-#-# SECURITY CONFIGURATION #-#-#-#-#-#-#-#-#-#-#-# # # -