# This is an example of the config file for InspIRCd. #
# Change the options to suit your network #
# #
-# $Id$
+# $Id$ #
# #
# ____ _ _____ _ _ ____ _ _ _ #
# | _ \ ___ __ _ __| | |_ _| |__ (_)___ | __ )(_) |_| | #
# <server name="server.name" #
# description="Server Description" #
# networkemail="Email address shown on g/k/z/q lines" #
+# id="serverid" #
# network="MyNetwork"> #
# #
+# The server ID is optional, and if omitted or set to 0, is auto- #
+# matically calculated from the server name and description. This is #
+# similar in behaviour to the server id on ircu and charybdis ircds. #
+# You should only need to set this manually if there is a collision #
+# between two server ID's on the network. The server ID must be #
+# between 1 and 999, if it is not, it will be wrapped to this range. #
+# There is a range of server ID's which are suffixed by two letters #
+# rather than two numbers, e.g. 1AA, 2FF, 3ZZ, which are reserved #
+# for use by non-inspircd servers such as services and stats servers.#
+# #
<server name="penguin.omega.org.za"
description="Waddle World"
- network="Omega">
+ id="0"
+ network="Omega">
#-#-#-#-#-#-#-#-#-#-#-#- ADMIN INFORMATION -#-#-#-#-#-#-#-#-#-#-#-#
# Enter the port and address bindings here. #
# #
# bind address - specifies which address ports bind to. Leaving this #
-# field blank binds the port to all IPs available. #
+# field blank binds the port to all IP's available. #
# #
# port - The port number to bind to. You may specify a port #
# range here, e.g. "6667-6669,7000,7001". If you do #
# port number. #
# #
# type - can be 'clients' or 'servers'. The clients type is #
-# a standard tcp based socket, the servers type is a #
+# a standard TCP based socket, the servers type is a #
# also a TCP based connection but of a different #
# format. SSL support is provided by modules, to #
# enable SSL support, please read the module section #
# setting is ignored. #
# #
# transport - If you have m_spanningtree.so loaded, along with #
-# either of the SSL modules (m_ssl_gnutls or #
+# either one of the SSL modules (m_ssl_gnutls or #
# m_ssl_openssl) or m_ziplinks.so, then you may make #
# use of this value. #
# setting it to 'openssl' or 'gnutls' or 'zip' #
# |_| \_\___|\__,_|\__,_| |_| |_| |_|_|___/ |____/|_|\__(_) #
# #
# If you want to link servers to InspIRCd you must load the #
-# m_spanningtree module! Please see the modules list below for #
+# m_spanningtree.so module! Please see the modules list below for #
# information on how to load this module! If you do not load this #
# module, server ports will NOT be bound! #
# #
# <bind address="ip address" port="port" type="clients"> #
# <bind address="ip address" port="port" type="servers"> #
# #
-# If InspIRCd is built for IPV6, and you wish to accept IPV4 clients, #
-# then you can specify IPV4 ip addresses here to bind. You may also #
-# use the 4in6 notation, ::ffff:1.2.3.4, where 1.2.3.4 is the IPV4 #
+# If InspIRCd is built for IPv6, and you wish to accept IPv4 clients, #
+# then you can specify IPv4 ip addresses here to bind. You may also #
+# use the 4in6 notation, ::ffff:1.2.3.4, where 1.2.3.4 is the IPv4 #
# address to bind the port, but as of InspIRCd 1.1.1, this is not #
# required. #
# #
# ------------------------------------------------------------------- #
# #
-# PLEASE NOTE: If you have build InspIRCd as an ipv6 server, and you #
+# PLEASE NOTE: If you have build InspIRCd as an IPv6 server, and you #
# specify an empty bind address, the binding will be bound to ALL THE #
-# IPV6 IP ADDRESSES, and not the ipv4 addresses. If you are using an #
-# ipv6 enabled InspIRCd and want to bind to multiple IPV4 addresses #
+# IPv6 IP ADDRESSES, and not the IPv4 addresses. If you are using an #
+# IPv6 enabled InspIRCd and want to bind to multiple IPv4 addresses #
# in this way, you must specify them by hand. If you have built the #
-# server for ipv4 connections only, then specifying an empty bind #
-# address binds the port to all ipv4 IP addresses, as expected. #
+# server for IPv4 connections only, then specifying an empty bind #
+# address binds the port to all IPv4 IP addresses, as expected. #
# #
<bind address="" port="6000" type="clients">
#-#-#-#-#-#-#-#-#-#- DIE/RESTART CONFIGURATION -#-#-#-#-#-#-#-#-#-#-
# #
# You can configure the passwords here which you wish to use for #
-# the die and restart commands. Only trusted ircops who will #
+# the die and restart commands. Only trusted IRCop's who will #
# need this ability should know the die and restart password. #
# #
# Syntax is as follows: #
# <connect name="something" parent="myallow" pingfreq="60"> #
# #
# IP masks may be specified in CIDR format or wildcard format, #
-# for IPV4 and IPV6. You *cannot* use hostnames in the allow or #
+# for IPv4 and IPv6. You *cannot* use hostnames in the allow or #
# deny field, as the state is applied before the user's DNS has #
# been resolved. #
# #
# #
# 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 #
+# is closed if USER/NICK/PASS are not given. This value is in secs. #
# #
# You should also include a flood="x" line which indicates #
# the number of lines a user may place into their buffer at once #
# settings as shown in the full example below. #
# The ping frequency is specified in seconds, and the sendq size #
# in bytes. It is recommended, although not enforced, that you #
-# should never set your sendq size to less than 8k. Send Queues are #
+# should never set your sendq size to less than 8K. Send Queues are #
# dynamically allocated and can grow as needed up to the maximum #
# size specified. #
# #
#-#-#-#-#-#-#-#-#-#-#-#- CLASS CONFIGURATION -#-#-#-#-#-#-#-#-#-#-#-
# #
-# Classes are a group of commands which are grouped together #
-# and given a unique name. They used to define which commands #
+# Classes are a group of commands which are grouped together and #
+# given a unique name. They're used to define which commands #
# are available to certain types of Operators. #
# #
# Syntax is as follows: #
# your server, as well as the commands they are allowed to use. #
# This works alongside with the classes specified above. #
# #
-# type name - a name for the combined class types #
+# type name - a name for the combined class types. #
# a type name cannot contain spaces, however if you #
# put an _ symbol in the name, it will be translated #
# to a space when displayed in a WHOIS. #
#-#-#-#-#-#-#-#-#-#-#- OPERATOR CONFIGURATION -#-#-#-#-#-#-#-#-#-#-#
# #
# Opers are defined here. This is a very important section. #
-# Remember to only make operators out of truthworthy people. #
+# Remember to only make operators out of trust worthy people. #
# #
-# name - oper name, This is case sensitive, so it is best to #
+# name - oper name, this is case sensitive, so it is best to #
# use lower-case. #
# #
# password - password to oper-up, also case sensitive. #
# #
# host - hosts of client allowed to oper-up. #
# wildcards accepted, seperate multiple hosts with a #
-# space. You may also specify CIDR ip addresses. #
+# space. You may also specify CIDR IP addresses. #
# #
-# fingerprint - When using the m_ssl_oper_cert.so module, you may #
+# fingerprint - when using the m_ssl_oper_cert.so module, you may #
# specify a key fingerprint here. This can be obtained #
# using the /fingerprint command whilst the module is #
# loaded, or from the notice given to you when you #
# connect to the ircd using a client certificate, #
# and will lock this oper block to only the user who #
# has that specific key/certificate pair. #
-# This enhances security a great deal, however it #
+# this enhances security a great deal, however it #
# requires that opers use clients which can send ssl #
# client certificates, if this is configured for that #
# oper. Note that if the m_ssl_oper.so module is not #
# is not loaded, this configuration option has no #
# effect and will be ignored. #
# #
-# type - Defines the kind of operator. This must match a type #
+# type - defines the kind of operator. This must match a type #
# tag you defined above, and is case sensitive. #
# #
# Syntax is as follows: #
# <oper name="login" #
# password="pass" #
# host="hostmask@of.oper" #
-# fingerprint="hexsequence" #
+# fingerprint="hexsequence" #
# type="oper type"> #
# #
# 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, does #
+# name - the name is the canocial name of the server, does #
# not have to resolve - but it is expected to be set #
# in the remote servers connection info. #
# #
-# ipaddr - Valid host or ip address for remote server. These #
+# ipaddr - valid host or IP address for remote server. These #
# hosts are resolved on rehash, and cached, if you #
-# specify a hostname, so if you find that your server #
+# specify a hostname; so if you find that your server #
# is still trying to connect to an old IP after you #
# have updated your dns, try rehashing and then #
# attempting the connect again. #
# #
-# port - The TCP port for the remote server. #
+# port - the TCP port for the remote server. #
# #
-# sendpass - Password to send to create an outbound connection #
+# sendpass - password to send to create an outbound connection #
# to this server. #
# #
-# recvpass - Password to receive to accept an inbound connection #
+# recvpass - password to receive to accept an inbound connection #
# from this server. #
# #
-# autoconnect - Sets the server to autoconnect. Where x is the num. #
+# autoconnect - sets the server to autoconnect. Where x is the num. #
# (optional) of seconds between attempts. e.g. 300 = 5 minutes. #
# #
-# transport - If defined, this is a transport name implemented by #
+# transport - if defined, this is a transport name implemented by #
# another module. Transports are layers on top of #
# plaintext connections, which alter them in certain #
# ways. Currently the three supported transports are #
# link to succeed. OpenSSL and GnuTLS are link- #
# compatible with each other. #
# #
-# statshidden - When using m_spanningtree.so for linking. you may #
+# statshidden - when using m_spanningtree.so for linking. you may #
# set this to 'yes', and if you do, the IP address/ #
# hostname of this connection will NEVER be shown to #
-# any opers on the network. In /STATS c its address #
+# any opers on the network. In /stats c its address #
# will show as *@<hidden>, and during CONNECT and #
-# inbound connections, its IP will show as <hidden> #
+# inbound connections, it's IP will show as <hidden> #
# UNLESS the connection fails (e.g. due to a bad #
# password or servername) #
# #
-# allowmask - When this is defined, it indicates a range of IP #
+# allowmask - when this is defined, it indicates a range of IP #
# addresses to allow for this link (You may use CIDR #
# or wildcard form for this address). #
# e.g. if your server is going to connect to you from #
# into this value. If it is not defined, then only #
# the ipaddr field of the server shall be allowed. #
# #
-# failover - If you define this option, it must be the name of a #
+# failover - if you define this option, it must be the name of a #
# different link tag in your configuration. This #
# option causes the ircd to attempt a connection to #
# the failover link in the event that the connection #
# apply to autoconnected servers as well as manually #
# connected ones. #
# #
-# timeout - If this is defined, then outbound connections will #
+# timeout - if this is defined, then outbound connections will #
# time out if they are not connected within this many #
# seconds. If this is not defined, the default of ten #
# seconds is used. #
# #
-# bind - If you specify this value, then when creating an #
+# bind - if you specify this value, then when creating an #
# outbound connection to the given server, the IP you #
# place here will be bound to. This is for multi- #
# homed servers which may have multiple IP addresses. #
-# If you do not define this value, the first IP that #
+# if you do not define this value, the first IP that #
# is not empty or localhost from your <bind> tags #
# will be bound to. This is usually acceptable, #
# however if your server has multiple network cards #
# then you may have to manually specify the bind #
# value instead of leaving it to automatic binding. #
-# You can usually tell if you need to set this by #
+# you can usually tell if you need to set this by #
# looking for the error 'Could not assign requested #
# address' in your log when connecting to servers. #
# #
-# hidden - If this is set to true, yes, or 1, then the server #
+# hidden - if this is set to true, yes, or 1, then the server #
# is completely hidden from non-opers. It does not #
-# show in LINKS and it does not show in MAP. Also, #
+# show in /links and it does not show in /map. Also, #
# any servers which are child servers of this one #
# in the network will *also* be hidden. Use with #
# care! You can use this to 'mask off' sections of #
# #
# ------------------------------------------------------------------- #
# #
-# NOTE: If you have built your server as an ipv6 server, then when a #
-# DNS lookup of a server's host occurs, AAAA records (ipv6) are #
-# priorotized over A records (ipv4). Therefore, if the server you are #
-# connecting to has both an IPV6 ip address and an IPV4 ip address in #
-# its DNS entry, the IPV6 address will *always* be selected. To #
-# change this behaviour simply specify the IPV4 IP address rather #
+# NOTE: If you have built your server as an IPv6 server, then when a #
+# DNS lookup of a server's host occurs, AAAA records (IPv6) are #
+# priorotized over A records (IPv4). Therefore, if the server you are #
+# connecting to has both an IPv6 IP address and an IPv4 IP address in #
+# its DNS entry, the IPv6 address will *always* be selected. To #
+# change this behaviour simply specify the IPv4 IP address rather #
# than the hostname of the server. #
# #
# ------------------------------------------------------------------- #
# |_| \_\___|\__,_|\__,_| |_| |_| |_|_|___/ |____/|_|\__(_) #
# #
# If you want to link servers to InspIRCd you must load the #
-# m_spanningtree module! Please see the modules list below for #
+# m_spanningtree.so module! Please see the modules list below for #
# information on how to load this module! If you do not load this #
# module, server links will NOT work! #
# #
# if set to no, then only the nickname is shown. #
# #
# announceinvites #
-# - If this option is set to yes (the default), then #
-# invites are announced to the channel when a user #
-# invites annother user. If you consider this to be #
-# unnecessary noise, explicitly set this to no. #
+# - If this option is set, then invites are announced #
+# to the channel when a user invites annother user. #
+# If you consider this to be unnecessary noise, #
+# set this to 'none'. To announce to all ops, set #
+# this to 'ops' and to announce to all users set the #
+# value to 'all'. #
+# #
+# The value 'dynamic' varies between 'ops' and 'all' #
+# settings depending on if the channel is +i or not. #
+# When the channel is +i, messages go only to ops, #
+# and when the channel is not +i, messages go to #
+# everyone. In short, the messages will go to every #
+# user who has power of INVITE on the channel. This #
+# is the recommended setting. #
# #
# disablehmac - If you are linking your InspIRCd to older versions #
# then you can specify this option and set it to #
serverpingfreq="60"
allowhalfop="yes"
defaultmodes="nt"
+ announceinvites="dynamic"
moronbanner="You're banned! Email haha@abuse.com with the ERROR line below for help."
exemptchanops="">
# Services support module: Adds several usermodes such as +R and +M
# this module implements the 'identified' state via user mode +r, which
# is similar to the DALnet and dreamforge systems.
+#
+# N O T E!!
+# >> This CAN NOT be used at the same time as m_services_account <<
+# N O T E!!
#<module name="m_services.so">
#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#
# Services support module: Adds several usermodes such as +R and +M
# this module implements the 'identified' state via account names (AC)
# and is similar in operation to the way asuka and ircu handle services.
-# it cannot be used at the same time as m_services, above.
+#
+# N O T E!!
+# >> This CAN NOT be used at the same time as m_services <<
+# N O T E!!
#<module name="m_services_account.so">
#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#