From 883f6db55b6cccf4a03f389559ef642054f597e0 Mon Sep 17 00:00:00 2001 From: Attila Molnar Date: Wed, 19 Mar 2014 15:52:07 +0100 Subject: [PATCH] Major example configuration and helpop update Big thanks to @m4z (#621) and @Robby- (#630) who contributed a lot to this --- docs/conf/filter.conf.example | 2 +- docs/conf/helpop-full.conf.example | 68 ++- docs/conf/helpop.conf.example | 7 +- docs/conf/inspircd.conf.example | 60 +- docs/conf/links.conf.example | 6 +- docs/conf/modules.conf.example | 687 +++++++++++----------- docs/conf/modules/charybdis.conf.example | 29 +- docs/conf/modules/unrealircd.conf.example | 49 +- docs/conf/opers.conf.example | 108 ++-- 9 files changed, 489 insertions(+), 527 deletions(-) diff --git a/docs/conf/filter.conf.example b/docs/conf/filter.conf.example index 8f5d20c24..45e5d2853 100644 --- a/docs/conf/filter.conf.example +++ b/docs/conf/filter.conf.example @@ -39,7 +39,7 @@ # o: Don't match against opers # c: Strip color codes from text before trying to match # *: Represents all of the above flags -# -: Does nothing, a non-op for when you do not want to specify any flags +# -: Does nothing, a no-op for when you do not want to specify any flags # # IMPORTANT NOTE: Because the InspIRCd config reader places special meaning on the # '\' character, you must use '\\' if you wish to specify a '\' character in a regular diff --git a/docs/conf/helpop-full.conf.example b/docs/conf/helpop-full.conf.example index 2c12972c2..445e0dd91 100644 --- a/docs/conf/helpop-full.conf.example +++ b/docs/conf/helpop-full.conf.example @@ -72,7 +72,7 @@ private message you when you have usermode +g set. ACCEPT +nick adds a nick to your accept list, ACCEPT -nick removes a nick from your accept list, and ACCEPT * displays your accept list."> - @@ -99,14 +99,14 @@ a message stating they were removed from the channel and by whom."> +for some users."> +Devoices yourself on the specified channel."> +Ping a server. The server will answer with a PONG."> +at least a channel halfoperator to kick a user."> - +Returns the ip and nickname of the given users."> +Displays the Oper MOTD."> @@ -615,21 +617,21 @@ Shows all currently available commands."> This command will disconnect a user from IRC with the given reason."> - +Disconnects the server matching the given server mask from this server."> commonchans module). d Deaf mode. User will not receive any messages or notices from channels they are in (requires deaf module). - g In combination with /allow, provides for server side + g In combination with /ACCEPT, provides for server side ignore (requires callerid module). h Marks as 'available for help' in WHOIS (IRCop only, requires helpop module). @@ -789,9 +791,6 @@ Closes all unregistered connections to the local server."> hideoper module). I Hides a user's entire channel list in WHOIS from non-IRCops (requires hidechans module). - Q Makes an operator invisible, preventing users from - seeing their presence, including in channel user lists - (IRCop only, requires invisible module). R Blocks private messages from unregistered users (requires services account module). S Strips mIRC color/bold/underline codes out of private @@ -898,7 +897,7 @@ Closes all unregistered connections to the local server."> channel (requirs stripcolor module). T Blocks /NOTICEs to the channel from users who are not at least halfop (requires nonotice module). - + g [mask] Blocks messages matching the given blob mask (requires chanfilter module). X [mode] Makes channel operators immune to the specified @@ -921,16 +920,16 @@ symbols may be only available to opers. Valid symbols are: -e Show e-lines (local ban exemptions) -g Show g-lines (host bans) -k Show k-lines (local host bans) -q Show q-lines (nick mask bans) -Z Show z-lines (IP mask bans) +e Show E-lines (local ban exemptions) +g Show G-lines (host bans) +k Show K-lines (local host bans) +q Show Q-lines (nick mask bans) R Show R-lines (regular expression bans) +Z Show Z-lines (IP mask bans) -H Show shuns s Show filters C Show channel bans +H Show shuns c Show link blocks d Show configured DNSBLs and related statistics @@ -967,8 +966,6 @@ Note that all /STATS use is broadcast to online IRC operators."> messages. f Allows receipt of flooding notices. g Allows receipt of globops (requires globops module). - G Allows receipt of notices of use of oper-override (requires - override module) j Allows receipt of channel creation notices (requires chancreate module). J Allows receipt of remote channel creation notices (requires @@ -989,7 +986,8 @@ Note that all /STATS use is broadcast to online IRC operators."> Q Allows receipt of remote quit messages. t Allows receipt of attempts to use /STATS (local and remote). v Allows receipt of oper-override notices (requires override module). - x Allows receipt of Xline notices (g/z/q/k/e/R/shuns)."> + x Allows receipt of local Xline notices (g/z/q/k/e/R/shuns)." + X Allows receipt of remote Xline notices (g/Z/q/k/e/R/shuns)."> ###################### # EXTBANS # diff --git a/docs/conf/helpop.conf.example b/docs/conf/helpop.conf.example index 3c23c0af1..56af7557a 100644 --- a/docs/conf/helpop.conf.example +++ b/docs/conf/helpop.conf.example @@ -102,9 +102,6 @@ LOCKSERV UNLOCKSERV JUMPSERVER"> hideoper module). I Hides a user's entire channel list in WHOIS from non-IRCops (requires hidechans module). - Q Makes an operator invisible, preventing users from - seeing their presence, including in channel user lists - (IRCop only, requires invisible module). R Blocks private messages from unregistered users (requires services account module). S Strips mIRC color/bold/underline codes out of private @@ -227,8 +224,6 @@ help channel if you have any questions."> messages. f Allows receipt of flooding notices. g Allows receipt of globops (requires globops module). - G Allows receipt of notices of use of oper-override (requires - override module) j Allows receipt of channel creation notices (requires chancreate module). J Allows receipt of remote channel creation notices (requires @@ -290,6 +285,8 @@ help channel if you have any questions."> module). U:n!u@h Blocks unregistered users matching the given ban. (requires m_services_account) + z:certfp Blocks users having the given certificate fingerprint + (requires m_sslmodes) Redirect n!u@h#channel will redirect the banned user to #channel when they try to join (requires banredirect module). diff --git a/docs/conf/inspircd.conf.example b/docs/conf/inspircd.conf.example index 9bd7d2e4b..2617d1e6c 100644 --- a/docs/conf/inspircd.conf.example +++ b/docs/conf/inspircd.conf.example @@ -18,7 +18,7 @@ ##################################||#################################### # # # This is an example of the config file for InspIRCd. # -# Change the options to suit your network # +# Change the options to suit your network. # # # # # # ____ _ _____ _ _ ____ _ _ _ # @@ -33,10 +33,6 @@ # something new or different to this version and you SHOULD READ IT. # # # ######################################################################## -# # -# Unalphabeticalise the modules list at your own risk # -# # -######################################################################## #-#-#-#-#-#-#-#-#-# INCLUDE CONFIGURATION #-#-#-#-#-#-#-#-#-#-#-#-#-# # # @@ -56,7 +52,7 @@ # # # # # # -# Executable Include Example: # +# Executable include example: # # # # @@ -161,12 +157,11 @@ -# When linking servers, the openssl and gnutls implementations are completely +# When linking servers, the OpenSSL and GnuTLS implementations are completely # link-compatible and can be used alongside each other # on each end of the link without any significant issues. # Supported ssl types are: "openssl" and "gnutls". -# You must load, m_ssl_openssl for openssl -# or m_ssl_gnutls for gnutls. +# You must load, m_ssl_openssl for OpenSSL or m_ssl_gnutls for GnuTLS. @@ -175,7 +170,7 @@ #-#-#-#-#-#-#-#-#-#- DIE/RESTART CONFIGURATION -#-#-#-#-#-#-#-#-#-#- # # # You can configure the passwords here which you wish to use for # -# the die and restart commands. Only trusted IRCop's who will # +# the /DIE and /RESTART commands. Only trusted IRCop's who will # # need this ability should know the die and restart password. # # # @@ -186,7 +181,7 @@ # (m_password_hash.so) loaded. # Options here are: "md5", "sha256" and "ripemd160", or one of # these prefixed with "hmac-", e.g.: "hmac-sha256". - # Optional, but recommended. Create hashed password with: + # Optional, but recommended. Create hashed passwords with: # /mkpasswd #hash="sha256" @@ -244,7 +239,7 @@ # for selected hash (m_md5.so, m_sha256.so or m_ripemd160.so) be # loaded and the password hashing module (m_password_hash.so) # loaded. Options here are: "md5", "sha256" and "ripemd160". - # Optional, but recommended. Create hashed password with: + # Optional, but recommended. Create hashed passwords with: # /mkpasswd #hash="sha256" @@ -337,14 +332,16 @@ # before they are dropped. Keep this value higher than the length of # your network's /LIST or /WHO output, or you will have lots of # disconnects from sendq overruns! - hardsendq="1048576" + # Setting this to "1M" is equivalent to "1048576", "8K" is 8192, etc. + hardsendq="1M" # softsendq: amount of data in a client's send queue before the server # begins delaying their commands in order to allow the sendq to drain softsendq="8192" # recvq: amount of data allowed in a client's queue before they are dropped. - recvq="8192" + # Entering "8K" is equivalent to "8192", see above. + recvq="8K" # threshold: This specifies the amount of command penalty a user is allowed to have # before being quit or fakelagged due to flood. Normal commands have a penalty of 1, @@ -442,7 +439,7 @@ # users: Maximum number of channels a user can be in at once. users="20" - # opers: Maximum number of channels a oper can be in at once. + # opers: Maximum number of channels an oper can be in at once. opers="60"> #-#-#-#-#-#-#-#-#-#-#-#-#-#-# DNS SERVER -#-#-#-#-#-#-#-#-#-#-#-#-#-#-# @@ -525,20 +522,20 @@ # # - # suffixpart: What (if anything) a users' part message + # suffixpart: What (if anything) users' part message # should be suffixed with. suffixpart=""" @@ -569,12 +566,12 @@ # it will just message the user normally. ircumsgprefix="no" - # announcets: If set to yes, when the TimeStamp on a channel changes, all users - # in channel will be sent a NOTICE about it. + # announcets: If set to yes, when the timestamp on a channel changes, all users + # in the channel will be sent a NOTICE about it. announcets="yes" # allowmismatch: 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 + # if they don't have the same "optionally common" modules loaded. Setting this to # yes may introduce some desyncs and weirdness. allowmismatch="no" @@ -583,8 +580,8 @@ # falling back to IPv4 otherwise. defaultbind="auto" - # hostintopic: If enabled, channels will show the host of the topicsetter - # in the topic. If set to no, it will only show the nick of the topicsetter. + # hostintopic: If enabled, channels will show the host of the topic setter + # in the topic. If set to no, it will only show the nick of the topic setter. hostintopic="yes" # pingwarning: If a server does not respond to a ping within x seconds, @@ -596,26 +593,25 @@ serverpingfreq="60" # defaultmodes: What modes are set on a empty channel when a user - # joins it and it is unregistered. This is similar to Asuka's - # autochanmodes. + # joins it and it is unregistered. defaultmodes="nt" # moronbanner: This is the text that is sent to a user when they are # banned from the server. - moronbanner="You're banned! Email haha@abuse.com with the ERROR line below for help." + moronbanner="You're banned! Email abuse@example.com with the ERROR line below for help." # exemptchanops: exemptions for channel access restrictions based on prefix. exemptchanops="nonick:v flood:o" # invitebypassmodes: This allows /invite to bypass other channel modes. - # (Such as +k, +j, +l, etc) + # (Such as +k, +j, +l, etc.) invitebypassmodes="yes" # nosnoticestack: This prevents snotices from 'stacking' and giving you # the message saying '(last message repeated X times)'. Defaults to no. nosnoticestack="no" - # welcomenotice: When turned on, this sends a NOTICE to connecting users + # welcomenotice: When turned on, this sends a NOTICE to connecting users # with the text Welcome to ! after successful registration. # Defaults to yes. welcomenotice="yes"> @@ -638,7 +634,7 @@ # limitsomaxconn: By default, somaxconn (see above) is limited to a # safe maximum value in the 2.0 branch for compatibility reasons. # This setting can be used to disable this limit, forcing InspIRCd - # to use the value specifed above. + # to use the value specified above. limitsomaxconn="true" # softlimit: This optional feature allows a defined softlimit for @@ -802,7 +798,7 @@ # to do what they want. # # An example log tag would be: -# +# # which would log all information on /oper (failed and successful) to # a file called opers.log. # @@ -839,7 +835,7 @@ # The following log tag is highly default and uncustomised. It is recommended you # sort out your own log tags. This is just here so you get some output. - + #-#-#-#-#-#-#-#-#-#-#-#-#- WHOWAS OPTIONS -#-#-#-#-#-#-#-#-#-#-#-#-# # # diff --git a/docs/conf/links.conf.example b/docs/conf/links.conf.example index 1b715123d..e4ebea556 100644 --- a/docs/conf/links.conf.example +++ b/docs/conf/links.conf.example @@ -40,8 +40,8 @@ # making an outbound connection to the server. Options are: "openssl" # and "gnutls" (they are compatible with each other). # - # You will need to load the m_ssl_openssl.so module for openssl, - # m_ssl_gnutls.so for gnutls. The server port that you connect to + # You will need to load the m_ssl_openssl.so module for OpenSSL, + # m_ssl_gnutls.so for GnuTLS. The server port that you connect to # must be capable of accepting this type of connection. ssl="gnutls" @@ -54,7 +54,7 @@ # bind: Local IP address to bind to. bind="1.2.3.4" - # statshidden: defines if IP is shown to opers when + # statshidden: Defines if IP is shown to opers when # /stats c is invoked. statshidden="no" diff --git a/docs/conf/modules.conf.example b/docs/conf/modules.conf.example index e9304f390..b4a5afab6 100644 --- a/docs/conf/modules.conf.example +++ b/docs/conf/modules.conf.example @@ -26,7 +26,7 @@ # # #-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-# -# MD5 Module - Allows other modules to generate MD5 hashes, usually for +# MD5 module: Allows other modules to generate MD5 hashes, usually for # cryptographic uses and security. # # IMPORTANT: @@ -36,7 +36,7 @@ # # #-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-# -# SHA256 Module - Allows other modules to generate SHA256 hashes, +# SHA256 module: Allows other modules to generate SHA256 hashes, # usually for cryptographic uses and security. # # IMPORTANT: @@ -47,33 +47,28 @@ # # #-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-# -# RIPEMD160 Module - Allows other modules to generate RIPEMD160 hashes, +# RIPEMD160 module: Allows other modules to generate RIPEMD160 hashes, # usually for cryptographic uses and security. -# +# # IMPORTANT: # Other modules may rely on this module being loaded to function. # #-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-# -# Abbreviation module: Provides the ability to abbreviate commands a-la +# Abbreviation module: Provides the ability to abbreviate commands a-la # BBC BASIC keywords. # #-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-# -# Alias module: Allows you to define server-side command aliases +# Alias module: Allows you to define server-side command aliases. # # -# Fantasy settings: -# +# Set the 'prefix' for in-channel aliases (fantasy commands) to the +# specified character. If not set, the default is "!". +# If 'allowbots' is disabled, +B clients will not be able to use +# fantasy commands. If not set, the default is no. # # -# prefix: -# Set the prefix for in-channel aliases (fantasy commands) to the -# specified character. If not set, the default is "!". -# allowbots: -# If this is set to no, +B clients will not be able to use fantasy -# commands. If not set, the default is no. -# #-#-#-#-#-#-#-#-#-#-#- ALIAS DEFINITIONS -#-#-#-#-#-#-#-#-#-#-#-#-#-# # # # If you have the m_alias.so module loaded, you may also define # @@ -81,8 +76,8 @@ # commands to services, however they are not limited to just this use.# # An alias tag requires the following values to be defined in it: # # # -# text - The text to detect as the actual command line, # -# Cant contain spaces, but case insensitive. # +# text - The text to detect as the actual command line. # +# Can't contain spaces, but case insensitive. # # You may have multiple aliases with the same # # command name (text="" value), however the first # # found will be executed if its format value is # @@ -127,18 +122,17 @@ # 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. # +# uline - Setting this to true will ensure that the user # +# given in 'requires' is also 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 a sign of a user trying to impersonate # +# a service. # # # -# operonly - Defining this value, with a value of 'yes', '1' # -# or true will make the alias oper only. If a non- # -# oper attempts to use the alias, it will appear # -# to not exist. # +# operonly - If true, this will make the alias oper only. # +# If a non-oper attempts to use the alias, it will # +# appear to not exist. # # # # # @@ -184,12 +178,12 @@ #-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-# # Allowinvite module: Gives channel mode +A to allow all users to use -# /invite, and extban A to deny invite from specific masks +# /INVITE, and extban A to deny invite from specific masks. # #-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-# # Alltime module: Shows time on all connected servers at once. -# This module is oper-only and provides /alltime. +# This module is oper-only and provides /ALLTIME. # To use, ALLTIME must be in one of your oper class blocks. # @@ -214,12 +208,16 @@ #-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-# # Autoop module: Adds basic channel access controls via the +w listmode. -# For example, +w o:R:Brain will op anyone identified to the account "Brain" -# on join. +# For example +w o:*!Attila@127.0.0.1 will op anyone matching that mask +# on join. This can be combined with extbans, for example +w o:R:Brain +# will op anyone identified to the account "Brain". +# Another useful combination is with SSL client certificate +# fingerprints: +w h:z:72db600734bb9546c1bdd02377bc21d2a9690d48 will +# give halfop to the user(s) having the given certificate. # #-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-# -# Ban except module: Adds support for channel ban exceptions (+e) +# Ban except module: Adds support for channel ban exceptions (+e). # #-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-# @@ -228,7 +226,7 @@ # #-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-# -# Block amsg module: Attempt to block all usage of /amsg and /ame +# Block amsg module: Attempt to block all usage of /amsg and /ame. # # #-#-#-#-#-#-#-#-#-#-#- BLOCKAMSG CONFIGURATION -#-#-#-#-#-#-#-#-#-#-# @@ -245,9 +243,9 @@ # #-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-# -# Block CAPS module: Blocking all-CAPS messages with cmode +B +# Block CAPS module: Blocking all-CAPS messages with channel mode +B. # -# # +# #-#-#-#-#-#-#-#-#-#-#- BLOCKCAPS CONFIGURATION -#-#-#-#-#-#-#-#-#-#-# # # # percent - How many percent of text must be caps before text # @@ -265,22 +263,23 @@ # capsmap="ABCDEFGHIJKLMNOPQRSTUVWXYZ! "> #-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-# -# Block color module: Blocking color-coded messages with chan mode +c +# Block color module: Blocking color-coded messages with chan mode +c. # #-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-# -# Botmode module: Adds the user mode +B +# Botmode module: Adds the user mode +B. If set on a user, it will +# show that the user is a bot in /WHOIS. # #-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-# -# CallerID module: Adds usermode +g which activates hybrid-style +# CallerID module: Adds usermode +g which activates hybrid-style # callerid: block all private messages unless you /accept first # -# +# #-#-#-#-#-#-#-#-#-#-#- CALLERID CONFIGURATION -#-#-#-#-#-#-#-#-#-#-#-# -# maxaccepts - Maximum number of entires a user can add to his # +# maxaccepts - Maximum number of entries a user can add to his # # /accept list. Default is 16 entries. # -# operoverride - Can opers (note: ALL opers) ignore callerid mode? # +# operoverride - Can opers (note: ALL opers) override callerid? # # Default is no. # # tracknick - Preserve /accept entries when a user changes nick? # # If no (the default), the user is removed from # @@ -295,7 +294,7 @@ #-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-# # CAP module: Provides the CAP negotiation mechanism seen in -# ratbox-derived ircds +# ratbox-derived ircds. # #-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-# @@ -305,7 +304,7 @@ # #-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-# -# Censor module: Adds channel and user mode +G +# Censor module: Adds channel and user mode +G. # # #-#-#-#-#-#-#-#-#-#-#- CENSOR CONFIGURATION -#-#-#-#-#-#-#-#-#-#-#-# @@ -328,7 +327,7 @@ # will be connecting to your network, and an optional cgiirc tag. # For more information see: http://wiki.inspircd.org/Modules/cgiirc # -# Set to yes if you want to notice opers when CGI clients connect +# Set to yes if you want to notice opers when CGI:IRC clients connect. # # # The type field indicates where the module should get the real @@ -348,15 +347,13 @@ # # When you connect CGI:IRC clients, there are two connect classes which # apply to these clients. When the client initially connects, the connect -# class which matches the cgi:irc site's host is checked. Therefore you +# class which matches the CGI:IRC site's host is checked. Therefore you # must raise the maximum local/global clients for this ip as high as you # want to allow cgi clients. After the client has connected and is # determined to be a cgi:irc client, the class which matches the client's # real IP is then checked. You may set this class to a lower value, so that # the real IP of the client can still be restricted to, for example, 3 # sessions maximum. -# - #-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-# # Channel create module: Adds snomask +j, which will notify opers of @@ -365,8 +362,8 @@ # #-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-# -# Channel filter module: Allows channel-op defined message -# filtering using simple string matches (channel mode +g) +# Channel filter module: Allows channel-op defined message filtering +# using simple string matches (channel mode +g). # # # If hidemask is set to yes, the user will not be shown the mask when @@ -374,7 +371,7 @@ # #-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-# -# Channel History module: Displays the last 'X' lines of chat to a user +# Channel history module: Displays the last 'X' lines of chat to a user # joining a channel with +H 'X:T' set; 'T' is the maximum time to keep # lines in the history buffer. Designed so that the new user knows what # the current topic of conversation is when joining the channel. @@ -387,7 +384,7 @@ # #-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-# -# Channel logging module: used to send snotice output to channels, to +# Channel logging module: Used to send snotice output to channels, to # allow staff to centrally monitor and discuss network activity. # # The "channel" field is where you want the messages to go, "snomasks" @@ -397,7 +394,7 @@ # #-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-# -# Channel Names module: Allows disabling channels which have certain +# Channel names module: Allows disabling channels which have certain # characters in the channel name such as bold, colorcodes, etc. which # can be quite annoying and allow users to on occasion have a channel # that looks like the name of another channel on the network. @@ -413,16 +410,16 @@ allowrange=""> #-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-# -# Channelban: Implements extended ban j:, which stops anyone in already -# in a channel matching a mask like +b j:#channel*mask from joining. +# Channelban: Implements extended ban j:, which stops anyone already +# in a channel matching a ban like +b j:#channel*mask from joining. # #-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-# -# Chanprotect module: gives +q and +a channel modes +# Chanprotect module: Gives +q and +a channel modes. # #-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-# -# CHGHOST module: Adds the /CHGHOST command +# CHGHOST module: Adds the /CHGHOST command. # This module is oper-only. # To use, CHGHOST must be in one of your oper class blocks. # NOTE: Services will not be able to set vhosts on users if this module @@ -465,12 +462,12 @@ # specify your own custom list of chars with the tag: # # # # charmap - A list of chars accepted as valid by the /CHGHOST # -# and /SETHOST commands. Also note that the list is # +# and /SETHOST commands. Also note that the list is # # case-sensitive. # # #-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-# -# CHGIDENT module: Adds the /CHGIDENT command +# CHGIDENT module: Adds the /CHGIDENT command. # This module is oper-only. # To use, CHGIDENT must be in one of your oper class blocks. # @@ -501,22 +498,21 @@ # or /48 subnet of the IPv6 address. # # # # full Cloak the users completely, using three slices for # -# common CIDR bans (IPv4: /16, /24; IPv6: /48, /64) # +# common CIDR bans (IPv4: /16, /24; IPv6: /48, /64). # # # # These methods use a single key that can be any length of text. # # An optional prefix may be specified to mark cloaked hosts. # # # # The following methods are maintained for backwards compatibility; # -# they are slightly less secure, and always hide unresolved IPs # +# they are slightly less secure, and always hide unresolved IPs. # # # -# compat-host InspIRCd 1.2-compatible host-based cloaking # -# compat-ip InspIRCd 1.2-compatible ip-always cloaking # +# compat-host InspIRCd 1.2-compatible host-based cloaking. # +# compat-ip InspIRCd 1.2-compatible ip-always cloaking. # # # # If you use a compat cloaking mode then you must specify key1, key2, # # key3, key4; the values must be less than 0x80000000 and should be # # picked at random. Prefix is mandatory, will default to network name # # if not specified, and will always have a "-" appended. # -#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-# # # @@ -543,26 +539,27 @@ # #-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-# -# Conn-Join: Allows you to force users to join one or more channels -# automatically upon connecting to the server. +# Auto join on connect module: Allows you to force users to join one +# or more channels automatically upon connecting to the server. # # #-#-#-#-#-#-#-#-#-#-#-#- CONNJOIN CONFIGURATION -#-#-#-#-#-#-#-#-#-#-# # # If you have m_conn_join.so loaded, you can configure it using the -# follow values: +# following values, or set autojoin="#chat,#help" in blocks. # # #-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-# -# Conn-Usermodes: Set modes on users when they connect -# When this module is loaded tags may have an optional -# modes="" value, which contains modes to add or remove from users -# when they connect to the server. +# Set modes on connect module: When this module is loaded +# blocks may have an optional modes="" value, which contains modes to +# add or remove from users when they connect to the server. # #-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-# -# Conn-Wait-for-Pong: Don't let a user connect until they PONG +# Wait for PONG on connect module: Send a PING to all connecting users +# and don't let them connect until they reply with a PONG. +# This is useful to stop certain kinds of bots and proxies. # # #-#-#-#-#-#-#-#-#-#-#- WAITPONG CONFIGURATION -#-#-#-#-#-#-#-#-#-#-# @@ -570,35 +567,37 @@ # If you have the m_conn_waitpong.so module loaded, configure it with # # the tag: # # # -# sendsnotice - Whether to send a snotice on connect, like other # -# older ircds # +# sendsnotice - Whether to send a helpful notice to users on # +# connect telling them how to connect, should # +# their client not reply PONG automatically. # # # # killonbadreply - Whether to kill the user if they send the wrong # # PONG reply. # # # # - #-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-# -# Channel cycle module. Server side /hop, with +ilk etc. bypass. +# Channel cycle module: Adds the /CYCLE command which is a server-side +# /HOP that bypasses restrictive modes. # #-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-# -# Connectban: Provides IP connection throttling. Any IP range that connects -# too many times (configurable) in an hour is zlined for a (configurable) -# duration, and their count resets to 0. +# Connectban: Provides IP connection throttling. Any IP range that +# connects too many times (configurable) in an hour is Z-Lined for a +# (configurable) duration, and their count resets to 0. +# # -# ipv4cidr and ipv6cidr allow you to turn the comparison from individual -# IP addresses (32 and 128 bits) into CIDR masks, to allow for throttling -# over whole ISPs/blocks of IPs, which may be needed to prevent attacks. +# ipv4cidr and ipv6cidr allow you to turn the comparison from +# individual IP addresses (32 and 128 bits) into CIDR masks, to allow +# for throttling over whole ISPs/blocks of IPs, which may be needed to +# prevent attacks. # +# This allows for 10 connections in an hour with a 10 minute ban if +# that is exceeded. # -# This allows for 10 connections in an hour with a 10 minute ban if that is exceeded. -# -# #-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-# -# Connection throttle module. Configuration: +# Connection throttle module. # # #-#-#-#-#-#-#-#-#-#-#- CONNTHROTTLE CONFIGURATION -#-#-#-#-#-#-#-#-#-# @@ -618,15 +617,16 @@ # quitmsg="Throttled" bootwait="10"> #-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-# -# Custom prefixes: allows for channel prefixes to be added. +# Custom prefixes: Allows for channel prefixes to be added. # This replaces m_chanprotect and m_halfop. # # -# name The name of the mode, must be unique from other modes +# name The name of the mode, must be unique from other modes. # letter The letter used for this mode. Required. # prefix The prefix used for nicks with this mode. Not required. -# rank A numeric rank for this prefix, defining what permissions it gives -# VOICE_VALUE is 10000, HALFOP_VALUE is 20000, OP_VALUE is 30000 +# rank A numeric rank for this prefix, defining what permissions it gives. +# The rank of voice, halfop and op is 10000, 20000, and 30000, +# respectively. # ranktoset The numeric rank required to set/unset this mode. Defaults to rank. # depriv Can you remove the mode from yourself? Defaults to yes. # @@ -634,51 +634,51 @@ # # # -# Do /reloadmodule m_customprefix.so after changing the settings of this module. +# Do /RELOADMODULE m_customprefix.so after changing the settings of this module. #-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-# # Custom title module: Adds the /TITLE command which allows for trusted -# users to gain a custom whois line and a optional -# vhost can be specified. +# users to gain a custom whois line and an optional vhost can be +# specified. # # #-#-#-#-#-#-#-#-#-#- CUSTOM TITLE CONFIGURATION -#-#-#-#-#-#-#-#-#-# -# name - The username used to identify -# password - The password used to identify -# hash - The hash for the specific user's password (optional) -# m_password_hash.so and a hashing module must be loaded for this to work -# host - Allowed hostmask [optional] -# title - Title shown in whois -# vhost - Displayed host [optional] +# name - The username used to identify. +# password - The password used to identify. +# hash - The hash for the specific user's password (optional). +# m_password_hash.so and a hashing module must be loaded +# for this to work. +# host - Allowed hostmask (optional). +# title - Title shown in whois. +# vhost - Displayed host (optional). # # #<title name="bar" password="foo" host="ident@host.name" title="Official Chat Helper" vhost="helper.network.chat"> #<title name="foo" password="fcde2b2edba56bf408601fb721fe9b5c338d10ee429ea04fae5511b68fbf8fb9" hash="sha256" title="Official Chat Helper"> #-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-# -# DCCALLOW module: Adds the /DCCALLOW command +# DCCALLOW module: Adds the /DCCALLOW command. #<module name="m_dccallow.so"> # #-#-#-#-#-#-#-#-#-#-#- DCCALLOW CONFIGURATION -#-#-#-#-#-#-#-#-#-#-# -# blockchat - Whether to block DCC CHAT as well as DCC SEND -# length - Default duration of entries in DCCALLOW list -# action - Default action to take if no action is specified -# can be 'block' or 'allow' +# blockchat - Whether to block DCC CHAT as well as DCC SEND. +# length - Default duration of entries in DCCALLOW list. +# action - Default action to take if no action is +# specified, can be 'block' or 'allow'. # # File configuration: -# pattern - The glob pattern to match against +# pattern - The glob pattern to match against. # action - Action to take if a user attempts to send a file -# that matches this pattern, can be 'block' or 'allow' +# that matches this pattern, can be 'block' or +# 'allow'. # #<dccallow blockchat="yes" length="5m" action="block"> #<banfile pattern="*.exe" action="block"> #<banfile pattern="*.txt" action="allow"> -# -#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-# #-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-# -# Deaf module: adds support for ircu style usermode +d - deaf to -# channel messages and channel notices. +# Deaf module: Adds support for the usermode +d - deaf to channel +# messages and channel notices. #<module name="m_deaf.so"> #-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-# @@ -692,25 +692,22 @@ #-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-# # Delay message module: Adds the channel mode +d which disallows a user # from talking in the channel unless they've been joined for X seconds. -# Settable a la: /mode +d 30 +# Settable using /MODE #chan +d 30 #<module name="m_delaymsg.so"> #-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-# -# Deny Channels: Deny Channels from being used by users -#<module name="m_denychans.so"> +# Deny channels module: Deny channels from being used by users. +#<module name="m_denychans.so"> # #-#-#-#-#-#-#-#-#-#-#- DENYCHAN DEFINITIONS -#-#-#-#-#-#-#-#-#-#-#-# # # # If you have the m_denychans.so module loaded, you need to specify # # the channels to deny: # # # -# name - The channel name to deny. (glob masks are ok) # -# # +# name - The channel name to deny (glob masks are ok). # # allowopers - If operators are allowed to override the deny. # -# # # reason - Reason given for the deny. # -# # -# redirect - Redirect the user to a different channel # +# redirect - Redirect the user to a different channel. # # # #<badchan name="#gods*" allowopers="yes" reason="Tortoises!"> # #<badchan name="#heaven" redirect="#hell" reason="Nice try!"> # @@ -720,14 +717,14 @@ # Additionally, you may specify channels which are allowed, even if # # a badchan tag specifies it would be denied: # #<goodchan name="#godsleeps"> # -# Glob masks are accepted here also. +# Glob masks are accepted here also. # #-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-# -# Devoice Module: Let users devoice themselves using /devoice #chan. +# Devoice module: Let users devoice themselves using /DEVOICE #chan. #<module name="m_devoice.so"> #-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-# -# DNS Blacklist Module: Provides support for looking up IPs on one or # +# DNS blacklist module: Provides support for looking up IPs on one or # # more blacklists. # #<module name="m_dnsbl.so"> # # # @@ -735,14 +732,14 @@ # http://wiki.inspircd.org/Modules/dnsbl # #-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-# -# Exempt Channel Operators Module: Provides support for allowing # +# Exempt channel operators module: Provides support for allowing # # channel operators to be exempt from some channel modes. Supported # # modes are blockcaps, noctcp, blockcolor, nickflood, flood, censor, # # filter, regmoderated, nonick, nonotice, and stripcolor. # #<module name="m_exemptchanops.so"> # #-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-# -# Filter module: Provides message filtering, similar to SPAMFILTER. +# Filter module: Provides message filtering, similar to SPAMFILTER. # #<module name="m_filter.so"> # # # This module depends upon a regex provider such as m_regex_pcre or # @@ -767,19 +764,20 @@ #-#-#-#-#-#-#-#-#-#-#- FILTER CONFIGURATION -#-#-#-#-#-#-#-#-#-#-#-# # # # Optional - If you specify to use the m_filter module, then # -# specfiy below the path to the filter.conf file, or define some # +# specify below the path to the filter.conf file, or define some # # <filter> tags. # # # #<include file="conf/examples/filter.conf.example"> #-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-# -# Gecosban: Implements extended ban r:, which stops anyone matching +# Gecos ban: Implements extended ban 'r', which stops anyone matching # a mask like +b r:*realname?here* from joining a channel. #<module name="m_gecosban.so"> #-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-# # GeoIP module: Allows the server admin to match users by country code. -# This modules is in extras. Re-run configure with: ./configure --enable-extras=m_geoip.cpp +# This module is in extras. Re-run configure with: +# ./configure --enable-extras=m_geoip.cpp # and run make install, then uncomment this module to enable it. # This module requires GeoIP to be installed on your system, # use your package manager to find the appropriate packages @@ -799,7 +797,7 @@ # classes for them to match. #-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-# -# Globops module: gives /GLOBOPS and SNOMASK +g +# Globops module: Provides the /GLOBOPS command and snomask +g. # This module is oper-only. # To use, GLOBOPS must be in one of your oper class blocks. #<module name="m_globops.so"> @@ -818,41 +816,38 @@ #<module name="m_halfop.so"> #-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-# -# HELPOP module: Provides the /HELPOP command +# HELPOP module: Provides the /HELPOP command. #<module name="m_helpop.so"> # #-#-#-#-#-#-#-#-#-#-#-#- HELPOP CONFIGURATION -#-#-#-#-#-#-#-#-#-#-# # # -# Optional - If you specify to use the m_helpop.so module, then # -# specify below the path to the helpop.conf file, or if you like to # -# make a mess, define your helpop tags in this conf. # -# # +# If you specify to use the m_helpop.so module, then specify below # +# the path to the helpop.conf file. # #<include file="conf/examples/inspircd.helpop-full.example"> #-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-# -# HIDECHANS module: Allows users to hide their channels list from non- +# Hide chans module: Allows users to hide their channels list from non- # opers by setting user mode +I on themselves. #<module name="m_hidechans.so"> # -# HIDECHANS can optionally prevent opers from seeing channels on a +I +# This mode can optionally prevent opers from seeing channels on a +I # user, for more privacy if set to true. # This setting is not recommended for most mainstream networks. #<hidechans affectsopers="false"> #-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-# -# HIDEOPER module: Allows opers to hide their oper status from non- +# Hide oper module: Allows opers to hide their oper status from non- # opers by setting user mode +H on themselves. # This module is oper-only. #<module name="m_hideoper.so"> #-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-# -# Hostchange module: Allows a different style of cloaking +# Hostchange module: Allows a different style of cloaking. #<module name="m_hostchange.so"> # #-#-#-#-#-#-#-#-#-#-#- HOSTCHANGE CONFIGURATION -#-#-#-#-#-#-#-#-#-# # # -# Optional - If you choose to use the m_hostchange.so module. # -# Config Help - See http://wiki.inspircd.org/Modules/hostchange # +# See http://wiki.inspircd.org/Modules/hostchange for help. # # # #<host suffix="polarbears.org" separator="." prefix=""> #<hostchange mask="*@fbi.gov" action="addnick"> @@ -861,7 +856,7 @@ #<hostchange mask="localhost" ports="7000,7001,7005-7007" action="set" value="blahblah.foo"> #-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-# -# httpd module: Provides http server support for InspIRCd +# httpd module: Provides HTTP server support for InspIRCd. #<module name="m_httpd.so"> # #-#-#-#-#-#-#-#-#-#-#-#- HTTPD CONFIGURATION -#-#-#-#-#-#-#-#-#-#-# @@ -875,37 +870,33 @@ #<httpd timeout="20"> #-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-# -# http ACL module: Provides access control lists for m_httpd dependent +# HTTP ACL module: Provides access control lists for m_httpd dependent # modules. Use this module to restrict pages by IP address and by # password. -# #<module name="m_httpd_acl.so"> # #-#-#-#-#-#-#-#-#-#-#-#- HTTPD ACL CONFIGURATION -#-#-#-#-#-#-#-#-#-#-# # # Restrict access to the m_httpd_stats module to all but the local # network and when the correct password is specified: -# # <httpdacl path="/stats*" types="password,whitelist" # username="secretstuff" password="mypasshere" whitelist="127.0.0.*,10.*"> -# -# Deny all connections to all but the main index page: # +# Deny all connections to all but the main index page: # <httpdacl path="/*" types="blacklist" blacklist="*"> -# #-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-# -# http config module: Allows the server's configuration to be viewed -# over HTTP. Requires m_httpd.so to be loaded for it to function. +# HTTP config module: Allows the configuration of the server to be +# viewed over HTTP. Requires m_httpd.so to be loaded for it to function. #<module name="m_httpd_config.so"> #-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-# -# http stats module: Provides basic stats pages over HTTP +# HTTP stats module: Provides basic stats pages over HTTP. # Requires m_httpd.so to be loaded for it to function. #<module name="m_httpd_stats.so"> #-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-# -# Ident: Provides RFC 1413 ident lookup support +# Ident: Provides RFC 1413 ident lookup support. # When this module is loaded <connect:allow> tags may have an optional # useident="yes|no" boolean value, determining whether or not to lookup # ident on users matching that connect tag. @@ -915,14 +906,15 @@ # # # Optional - If you are using the m_ident.so module, then you can # # specify the timeout for ident lookups here. If not defined, it will # -# default to one second. This is a non-blocking timeout which holds # +# default to 5 seconds. This is a non-blocking timeout which holds # # the user in a 'connecting' state until the lookup is complete. # # The bind value indicates which IP to bind outbound requests to. # -# # +# #<ident timeout="5"> #-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-# -# Invite except module: Adds support for channel invite exceptions (+I) +# Invite exception module: Adds support for channel invite exceptions +# (+I). #<module name="m_inviteexception.so"> # Does a +I bypass channel +k in addition to +i? #<inviteexception bypasskey="yes"> @@ -933,22 +925,24 @@ # enhancements to the client-to-server protocol. An extension is only # active for a client when the client specifically requests it, so this # module needs m_cap to work. -# +# # Further information on these extensions can be found at the IRCv3 # working group website: -# http://ircv3.atheme.org/extensions/ +# http://ircv3.org/extensions/ # #<module name="m_ircv3.so"> # The following block can be used to control which extensions are -# enabled. +# enabled. Note that extended-join can be incompatible with m_delayjoin +# and host cycling. #<ircv3 accountnotify="on" awaynotify="on" extendedjoin="on"> #-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-# -# Join flood module: Adds support for join flood protection (+j) +# Join flood module: Adds support for join flood protection +j X:Y. +# Closes the channel for 60 seconds if X users join in Y seconds. #<module name="m_joinflood.so"> #-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-# -# Jump Server module: Adds support for the RPL_REDIR numeric +# Jump server module: Adds support for the RPL_REDIR numeric. # This module is oper-only. # To use, JUMPSERVER must be in one of your oper class blocks. # If your server is redirecting new clients and you get disconnected, @@ -956,15 +950,16 @@ #<module name="m_jumpserver.so"> #-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-# -# Anti-Auto-Rejoin: Adds support for prevention of auto-rejoin (+J) +# Anti auto rejoin: Adds support for prevention of auto-rejoin (+J). #<module name="m_kicknorejoin.so"> # Set the maximum time that is accepted as a parameter for +J here. #<kicknorejoin maxtime="1m"> #-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-# -# Knock module: adds the /KNOCK command and +K channel mode +# Knock module: Adds the /KNOCK command and channel mode +K. #<module name="m_knock.so"> -# This setting specifes what to do when someone successfully /KNOCKs. +# +# This setting specifies what to do when someone successfully /KNOCKs. # If set to "notice", then a NOTICE will be sent to the channel. # This is the default and the compatible setting, as it requires no # special support from the clients. @@ -977,11 +972,10 @@ # LDAP authentication module: Adds the ability to authenticate users # # via LDAP. This is an extra module which must be enabled explicitly # # by symlinking it from modules/extra, and requires the OpenLDAP libs # -# This modules is in extras. To enable it, Re-run configure with: # +# This module is in extras. To enable it, Re-run configure with: # # ./configure --enable-extras=m_ldapauth.cpp # # and run make install, then uncomment this module. # -# # -#<module name="m_ldapauth.so"> # +#<module name="m_ldapauth.so"> # # # Configuration: # # # @@ -1007,7 +1001,7 @@ # a user account by name. On POSIX systems this is usually 'uid'. # # # # The server parameter indicates the LDAP server to connect to. The # -# ldap:// style scheme before the hostname proper is MANDITORY. # +# ldap:// style scheme before the hostname proper is MANDATORY. # # # # The allowpattern value allows you to specify a wildcard mask which # # will always be allowed to connect regardless of if they have an # @@ -1049,9 +1043,9 @@ # LDAP oper configuration module: Adds the ability to authenticate # # opers via LDAP. This is an extra module which must be enabled # # explicitly by symlinking it from modules/extra, and requires the # -# OpenLDAP libs. Re-run configure with: ./configure --enable-extras=m_ldapoper.cpp +# OpenLDAP libs. Re-run configure with: # +# ./configure --enable-extras=m_ldapoper.cpp # and run make install, then uncomment this module to enable it. # -# # #<module name="m_ldapoper.so"> # # # Configuration: # @@ -1071,16 +1065,14 @@ # not loaded the oper accounts are still protected by a password. # #-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-# -# Lock server module: Adds /LOCKSERV and /UNLOCKSERV commands that is # -# used to temporarily close/open for new connections to the server. # -# These commands require OPER status and that the LOCKSERV UNLOCKSERV # +# Lock server module: Adds /LOCKSERV and /UNLOCKSERV commands that # +# are used to temporarily close/open the server for new connections. # +# These commands require that the /LOCKSERV and /UNLOCKSERV commands # # are specified in a <class> tag that the oper is part of. This is so # # you can control who has access to this possible dangerous command. # # If your server is locked and you get disconnected, do a REHASH from # # shell to open up again. # -# # This module is oper-only. -# #<module name="m_lockserv.so"> #-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-# @@ -1090,21 +1082,22 @@ #<module name="m_maphide.so"> #-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-# -# Msg flood module: Adds message/notice flood protection (+f) +# Message flood module: Adds message/notice flood protection via +# channel mode +f. #<module name="m_messageflood.so"> #-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-# # MLOCK module: Adds support for server-side enforcement of services -# side MLOCKs. Basically, this module suppresses any mode change that +# side MLOCKs. Basically, this module suppresses any mode change that # would likely be immediately bounced by services. #<module name="m_mlock.so"> #-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-# -# MsSQL module: Allows other SQL modules to access MS SQL Server +# MsSQL module: Allows other SQL modules to access MS SQL Server # through a unified API. -# This modules is in extras. Re-run configure with: ./configure --enable-extras=m_mssql.cpp +# This module is in extras. Re-run configure with: +# ./configure --enable-extras=m_mssql.cpp # and run make install, then uncomment this module to enable it. -# #<module name="m_mssql.so"> # #-#-#-#-#-#-#-#-#-#-#-#- SQL CONFIGURATION -#-#-#-#-#-#-#-#-#-#-#-#-# @@ -1117,9 +1110,9 @@ #-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-# # MySQL module: Allows other SQL modules to access MySQL databases # through a unified API. -# This modules is in extras. Re-run configure with: ./configure --enable-extras=m_mysql.cpp +# This module is in extras. Re-run configure with: +# ./configure --enable-extras=m_mysql.cpp # and run make install, then uncomment this module to enable it. -# #<module name="m_mysql.so"> # #-#-#-#-#-#-#-#-#-#-#-#- SQL CONFIGURATION -#-#-#-#-#-#-#-#-#-#-#-#-# @@ -1130,13 +1123,10 @@ #<database module="mysql" name="mydb" user="myuser" pass="mypass" host="localhost" id="my_database2"> #-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-# -# Named Modes module: This module allows for the display and set/unset -# of channel settings and modes via long-form mode names in channels with -# channelmode +Z set. For example, to set a channelban with named modes: -# /mode #channel +Z ban=foo!bar@baz . Currently this doesn't serve much -# purpose outside of making channel administration a bit easier in some -# cases, but eventually modules will start using named modes only because -# we're running out of channelmodes. :D +# Named modes module: Allows for the display and set/unset of channel +# modes via long-form mode names via +Z and the /PROP command. +# For example, to set a ban, do /mode #channel +Z ban=foo!bar@baz or +# /PROP #channel ban=foo!bar@baz #<module name="m_namedmodes.so"> #-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-# @@ -1149,16 +1139,16 @@ # National characters module: # 1) Allows using national characters in nicknames. # 2) Allows using custom (national) casemapping over the network. -# file -- filename of existing file in "locales" directory -# casemapping -- custom value for 005 numeric (if you want it to be -# different from the filename. +#<module name="m_nationalchars.so"> # +# file - filename of existing file in "locales" directory +# casemapping - custom value for 005 numeric (if you want it to be +# different from the filename). #<nationalchars file="bynets/russian-w1251-charlink" casemapping="ru_RU.cp1251-charlink"> -#<module name="m_nationalchars.so"> #-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-# -# Nickchange flood protection module: Allows up to X nick changes in Y seconds. -# Provides channel mode +F. +# Nickchange flood protection module: Provides channel mode +F X:Y +# which allows up to X nick changes in Y seconds. #<module name="m_nickflood.so"> #-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-# @@ -1169,8 +1159,8 @@ #<module name="m_nicklock.so"> #-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-# -# No ctcp module: Adds the channel mode +C to block CTCPs and extban C -# to block CTCPs sent by specific users. +# No CTCP module: Adds the channel mode +C to block CTCPs and extban +# 'C' to block CTCPs sent by specific users. #<module name="m_noctcp.so"> #-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-# @@ -1179,47 +1169,45 @@ #<module name="m_nokicks.so"> #-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-# -# No nicks module: Adds the +N channel mode, as well as the N extban. +# No nicks module: Adds the +N channel mode, as well as the 'N' extban. # +N stops all users from changing their nick, the N extban stops # anyone from matching a +b N:nick!user@host mask from changing their # nick. #<module name="m_nonicks.so"> #-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-# -# No part message module: adds extban 'p' to block part messages from # +# No part message module: Adds extban 'p' to block part messages from # # matching users. # #<module name="m_nopartmsg.so"> #-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-# -# No Notice module: adds the channel mode +T and the extban T to block -# specific users from noticing the channel. +# No notice module: Adds the channel mode +T and the extban 'T' to +# block specific users from noticing the channel. #<module name="m_nonotice.so"> #-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-# -# Network business join module +# Network business join module: # Allows an oper to join a channel using /OJOIN, giving them +Y on the # channel which makes them immune to kick/deop/etc. #<module name="m_ojoin.so"> # +# Specify the prefix that +Y will grant here. +# Leave 'prefix' empty if you do not wish +Y to grant a prefix. +# If 'notice' is set to on, upon /OJOIN, the server will notice the +# channel saying that the oper is joining on network business. +# If 'op' is set to on, it will give them +o along with +Y. #<ojoin prefix="!" notice="yes" op="yes"> -# Specify the prefix that +Y will grant here -# Leave prefix empty if you do not wish +Y to grant a prefix -# If notice is set to on, upon ojoin, the server will notice -# the channel saying that the oper is joining on network business -# If op is set to on, it will give them +o along with +Y - #-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-# -# Oper channels mode: Adds the +O channel mode and +beI type O:<mask> -# to ban, exempt, and invex given oper type masks. -# e.g, /mode #channel +iI O:* is equivilant to chmode +O, but you -# may also, e.g. /mode #channel +iI O:AdminTypeOnly to only allow admins. -# +be work in a similar fashion. -# +# Oper channels mode: Adds the +O channel mode and extban O:<mask> +# to ban, except, etc. specific oper types. For example +# /mode #channel +iI O:* is equivalent to channel mode +O, but you +# may also set +iI O:AdminTypeOnly to only allow admins. +# Modes +I and +e work in a similar fashion. #<module name="m_operchans.so"> #-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-# -# Oper Join module: Auto-joins opers to a channel upon oper-up +# Oper join module: Auto-joins opers to a channel upon oper-up. # This module is oper-only. For the user equivalent, see m_conn_join. #<module name="m_operjoin.so"> # @@ -1228,10 +1216,10 @@ # If you are using the m_operjoin.so module, specify options here: # # # # channel - The channel name to join, can also be a comma # -# separated list eg. "#channel1,#channel2". # +# separated list e.g. "#channel1,#channel2". # # # -# override - Lets the oper join walking thru any modes that # -# might be set, even bans. Use "yes" or "no". # +# override - If on, lets the oper join walking thru any modes # +# that might be set, even bans. # # # #<operjoin channel="#channel" override="no"> # @@ -1241,8 +1229,9 @@ #<type name="Helper" autojoin="#help" classes="..."> #-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-# -# Oper log module: Logs all oper commands to the ircd log at default -# loglevel, and optionally to the 'r' SNOMASK. +# Oper log module: Logs all oper commands to the server log (with log +# type "m_operlog" at default loglevel), and optionally to the 'r' +# snomask. # This module is oper-only. #<module name="m_operlog.so"> # @@ -1251,9 +1240,8 @@ #<operlog tosnomask="off"> #-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-# -# Oper prefixing module: Gives IRC operators a prefix status character -# on all channels they are in. -# +# Oper prefixing module: Gives server operators a prefix status +# character on all channels they are in. #<module name="m_operprefix.so"> # # You may additionally customise the prefix character. @@ -1261,16 +1249,16 @@ #-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-# # Oper MOTD module: Provides support for separate message of the day -# on oper-up +# on oper-up. # This module is oper-only. #<module name="m_opermotd.so"> # #-#-#-#-#-#-#-#-#-#-# OPERMOTD CONFIGURATION -#-#-#-#-#-#-#-#-#-#-# # # -# If you are using the m_opermotd.so module, specify the motd here # +# If you are using the m_opermotd.so module, specify the motd here. # # # -# onoper - Should the message be sent on /OPER or only when # -# /OPERMOTD is used. Use "yes" or "no". # +# onoper - If on, the message is sent on /OPER, otherwise it's # +# only sent when /OPERMOTD is used. # # # # processcolors - Allow color codes to be processed in the opermotd. # # Read the comment above <connect:allowmotdcolors> in # @@ -1279,7 +1267,7 @@ #<opermotd file="conf/examples/opermotd.txt.example" onoper="yes" processcolors="false"> #-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-# -# Override module: Adds support for oper override +# Override module: Adds support for oper override. # This module is oper-only. #<module name="m_override.so"> # @@ -1289,24 +1277,24 @@ # http://wiki.inspircd.org/Modules/override # #-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-# -# Oper levels module: Gives each oper a level and prevents -# actions being taken against higher level opers -# Specify the level as the 'level' parameter of the <type> tag +# Oper levels module: Gives each oper a level and prevents actions +# being taken by lower level opers against higher level opers. +# Specify the level as the 'level' parameter of the <type> tag. # This module is oper-only. #<module name="m_operlevels.so"> #-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-# -# Oper modes module: Allows you to specify modes to add/remove on oper +# Oper modes module: Allows you to specify modes to add/remove on oper. # Specify the modes as the 'modes' parameter of the <type> tag # and/or as the 'modes' parameter of the <oper> tag. -# This module is oper-only. For the user equivalent, see m_conn_umodes +# This module is oper-only. For the user equivalent, see m_conn_umodes. #<module name="m_opermodes.so"> #-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-# -# Password forwarding module: Forwards a password users can send on connect -# to the specified client below. The client is usually nickserv and this -# module is usually used to authenticate users with nickserv using their -# connect password. +# Password forwarding module: Forwards a password users can send on +# connect to the specified client below. The client is usually NickServ +# and this module is usually used to authenticate users with NickServ +# using their connect password. #<module name="m_passforward.so"> <passforward @@ -1319,14 +1307,13 @@ # You can also use $user for the user ident string. forwardmsg="NOTICE $nick :*** Forwarding PASS to $nickrequired" - # cmd: Command for the nick to run when it receives a connect - # password. + # cmd: Command for the user to run when it receives a connect + # password. cmd="PRIVMSG $nickrequired :IDENTIFY $pass"> #-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-# # Password hash module: Allows hashed passwords to be used. # To be useful, a hashing module like m_sha256.so also needs to be loaded. -# #<module name="m_password_hash.so"> # #-#-#-#-#-#-#-#-#-# PASSWORD HASH CONFIGURATION #-#-#-#-#-#-#-#-#-#-#-# @@ -1339,16 +1326,16 @@ # hash="sha256" # password="01ba4719c80b6fe911b091a7c05124b64eeece964e09c058ef8f9805daca546b" # type="NetAdmin"> -# +# # Starting from 2.0, you can use a more secure salted hash that prevents simply # looking up the hash's value in a rainbow table built for the hash. # hash="hmac-sha256" password="lkS1Nbtp$CyLd/WPQXizsbxFUTqFRoMvaC+zhOULEeZaQkUJj+Gg" # -# Generate hashes using the /MKPASSWD command on the server. Don't run it on a -# server you don't trust with your password. +# Generate hashes using the /MKPASSWD command on the server. +# Don't run it on a server you don't trust with your password. #-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-# -# Permanent Channels module: Channels with the permanent channels mode +# Permanent channels module: Channels with the permanent channel mode # will remain open even after everyone else has left the channel, and # therefore keep things like modes, ban lists and topic. Permanent # channels -may- need support from your Services package to function @@ -1372,9 +1359,9 @@ #-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-# # PostgreSQL module: Allows other SQL modules to access PgSQL databases # through a unified API. -# This modules is in extras. Re-run configure with: ./configure --enable-extras=m_pgsql.cpp +# This module is in extras. Re-run configure with: +# ./configure --enable-extras=m_pgsql.cpp # and run make install, then uncomment this module to enable it. -# #<module name="m_pgsql.so"> # #-#-#-#-#-#-#-#-#-#-#-#- SQL CONFIGURATION -#-#-#-#-#-#-#-#-#-#-#-#-# @@ -1385,26 +1372,25 @@ #<database module="pgsql" name="mydb" user="myuser" pass="mypass" host="localhost" id="my_database" ssl="no"> #-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-# -# Muteban: Implements extended ban m:, which stops anyone matching +# Muteban: Implements extended ban 'm', which stops anyone matching # a mask like +b m:nick!user@host from speaking on channel. #<module name="m_muteban.so"> -# #-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-# -# Random Quote module: provides a random quote on connect. -# NOTE: Some of these may mimic fatal errors and confuse users and -# opers alike! - BEWARE! +# Random quote module: Provides a random quote on connect. +# NOTE: Some of these may mimic fatal errors and confuse users and +# opers alike - BEWARE! #<module name="m_randquote.so"> # #-#-#-#-#-#-#-#-#-#- RANDOMQUOTES CONFIGURATION -#-#-#-#-#-#-#-#-#-#-# # # # Optional - If you specify to use the m_randquote.so module, then # -# specify below the path to the randquotes.conf file. # +# specify below the path to the quotes file. # # # #<randquote file="quotes.txt"> #-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-# -# Redirect module: Adds channel redirection (mode +L) # +# Redirect module: Adds channel redirection mode +L. # # Optional: <redirect:antiredirect> to add usermode +L to stop forced # # redirection and instead print an error. # # # @@ -1417,21 +1403,21 @@ #<redirect antiredirect="true"> #-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-# -# Regular Expression Provider for Glob or wildcard (?/*) matching. +# Regular expression provider for glob or wildcard (?/*) matching. # You must have at least 1 provider loaded to use m_filter or m_rline # modules. This module has no additional requirements, as it uses the # matching already present in InspIRCd core. #<module name="m_regex_glob.so"> #-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-# -# Regular Expression Provider for PCRE (Perl-Compatible Regular +# Regular expression provider for PCRE (Perl-Compatible Regular # Expressions). You need libpcre installed to compile and load this # module. You must have at least 1 provider loaded to use m_filter or # m_rline. #<module name="m_regex_pcre.so"> #-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-# -# Regular Expression Provider for POSIX Regular Expressions. +# Regular expression provider for POSIX regular expressions. # You shouldn't need any additional libraries on a POSIX-compatible # system (i.e.: any Linux, BSD, but not Windows). You must have at # least 1 provider loaded to use m_filter or m_rline. @@ -1440,21 +1426,21 @@ #<module name="m_regex_posix.so"> #-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-# -# Regular Expression Provider for C++11 std::regex Regular Expressions. +# Regular expression provider for C++11 std::regex regular expressions. # This module works on any fully compliant implementation of the C++11 # std::regex container. Examples for such are Visual C++ 2010 and newer -# but not libstdc++ (which GCC uses) +# but not libstdc++ (which GCC uses). # You should verify that std::regex is supported by your setup before # using this module, as it may compile normally but won't do anything # on some implementations. #<module name="m_regex_stdlib.so"> - -# Specify the Regular Expression engine to use here. Valid settings are -# bre, ere, awk, grep, egrep, ecmascript (default if not specified) +# +# Specify the regular expression engine to use here. Valid settings are +# bre, ere, awk, grep, egrep, ecmascript (default if not specified). #<stdregex type="ecmascript"> #-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-# -# Regular Expression Provider for TRE Regular Expressions. +# Regular expression provider for TRE regular expressions. # This is the same regular expression engine used by UnrealIRCd, so # if you are most familiar with the syntax of /spamfilter from there, # this is the provider you want. You need libtre installed in order @@ -1462,8 +1448,8 @@ #<module name="m_regex_tre.so"> #-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-# -# Registered users only channel creation -# Allows only registered users and opers to create new channels. +# Registered users only channel creation module. If enabled, only +# registered users and opers can create new channels. # # You probably *DO NOT* want to load this module on a public network. # @@ -1471,7 +1457,7 @@ #-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-# # Remove module: Adds the /REMOVE command which is a peaceful -# alternative to /KICK +# alternative to /KICK. #<module name="m_remove.so"> #-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-# @@ -1489,74 +1475,81 @@ #<module name="m_restrictmsg.so"> #-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-# -# Ban users through regular expression patterns +# R-Line module: Ban users through regular expression patterns. #<module name="m_rline.so"> # #-#-#-#-#-#-#-#-#-#-#-#- RLINE CONFIGURATION -#-#-#-#-#-#-#-#-#-#-#-#-# # # If you wish to re-check a user when they change nickname (can be # useful under some situations, but *can* also use CPU with more users -# on a server) then set the following configuration value: +# on a server) then set 'matchonnickchange' to yes. # Also, this is where you set what Regular Expression engine is to be -# used. If you ever change it while running, all of your R-Lines will be -# wiped. This is the regex engine used by all R-Lines set, and -# m_regex_<engine>.so must be loaded, or rline will be nonfunctional +# used. If you ever change it while running, all of your R-Lines will +# be wiped. This is the regex engine used by all R-Lines set, and +# m_regex_<engine>.so must be loaded, or rline will be non-functional # until you load it or change the engine to one that is loaded. # #<rline matchonnickchange="yes" engine="pcre"> # # Generally, you will NOT want to use 'glob' here, as this turns # rline into just another gline. The exceptions are that rline will -# always use the full nick!user@host realname string, rather than only +# always use the full "nick!user@host realname" string, rather than only # user@host, but beware that only the ? and * wildcards are available, # and are the only way to specify where the space can occur if you do # use glob. For this reason, is recommended to use a real regex engine # so that at least \s or [[:space:]] is available. #-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-# -# SAJOIN module: Adds the /SAJOIN command +# SAJOIN module: Adds the /SAJOIN command which forcibly joins a user +# to the given channel. # This module is oper-only. # To use, SAJOIN must be in one of your oper class blocks. #<module name="m_sajoin.so"> #-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-# -# SAKICK module: Adds the /SAKICK command +# SAKICK module: Adds the /SAKICK command which kicks a user from the +# given channel. # This module is oper-only. # To use, SAKICK must be in one of your oper class blocks. #<module name="m_sakick.so"> #-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-# -# SAMODE module: Adds the oper /SAMODE command +# SAMODE module: Adds the /SAMODE command which allows server operators +# to change modes on a channel without requiring them to have any +# channel priviliges. Also allows changing user modes for any user. # This module is oper-only. # To use, SAMODE must be in one of your oper class blocks. #<module name="m_samode.so"> #-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-# -# SANICK module: Allows opers to change user's nicks +# SANICK module: Adds the /SANICK command which allows opers to change +# users' nicks. # This module is oper-only. # To use, SANICK must be in one of your oper class blocks. #<module name="m_sanick.so"> #-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-# -# SAPART module: Adds the oper /SAPART command +# SAPART module: Adds the /SAPART command which forcibly parts a user +# from a channel. # This module is oper-only. # To use, SAPART must be in one of your oper class blocks. #<module name="m_sapart.so"> #-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-# -# SAQUIT module: Adds the oper /SAQUIT command (abusable!!!) +# SAQUIT module: Adds the /SAQUIT command which forcibly quits a user. # This module is oper-only. # To use, SAQUIT must be in one of your oper class blocks. #<module name="m_saquit.so"> #-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-# -# SATOPIC module: Adds the oper /SATOPIC command +# SATOPIC module: Adds the /SATOPIC command which allows changing the +# topic on a channel without requiring any channel priviliges. # This module is oper-only. # To use, SATOPIC must be in one of your oper class blocks. #<module name="m_satopic.so"> #-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-# -# SASL authentication module: Provides support for IRC Authentication +# SASL authentication module: Provides support for IRC Authentication # Layer via AUTHENTICATE. Note: You also need to have m_cap.so loaded # for SASL to work. #<module name="m_sasl.so"> @@ -1568,13 +1561,13 @@ # #-#-#-#-#-#-#-#-#-# SECURELIST CONFIGURATION -#-#-#-#-#-#-#-#-#-#-#-#-# # # -# Securelist can be harmful to some irc search engines such as # +# Securelist can be harmful to some IRC search engines such as # # netsplit.de and searchirc.com. To prevent securelist blocking these # # sites from listing, define exception tags as shown below: # -<securehost exception="*@*.searchirc.org"> -<securehost exception="*@*.netsplit.de"> -<securehost exception="*@echo940.server4you.de"> -<securehost exception="*@*.ircdriven.com"> +#<securehost exception="*@*.searchirc.org"> +#<securehost exception="*@*.netsplit.de"> +#<securehost exception="*@echo940.server4you.de"> +#<securehost exception="*@*.ircdriven.com"> # # # Define the following variable to change how long a user must wait # # before issuing a LIST. If not defined, defaults to 60 seconds. # @@ -1583,76 +1576,73 @@ #-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-# # Servprotect module: Provides support for Austhex style +k / -# UnrealIRCD +S services mode +# UnrealIRCD +S services mode. #<module name="m_servprotect.so"> #-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-# -# See nicks module: Allow for SNOMASK +N which shows nick changes. +# See nicks module: Adds snomask +n and +N which show local and remote +# nick changes. # This module is oper-only. #<module name="m_seenicks.so"> #-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-# -# Set Idle module: Adds a command for opers to change their -# idle time (mainly a toy) +# Set idle module: Adds a command for opers to change their idle time. # This module is oper-only. # To use, SETIDLE must be in one of your oper class blocks. #<module name="m_setidle.so"> #-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-# -# Services support module: Adds several usermodes such as +R and +M -# this module implements the 'identified' state via account names (AC) +# Services support module: Adds several usermodes such as +R and +M. +# This module implements the 'identified' state via account names, # and is similar in operation to the way asuka and ircu handle services. # # At the same time, this offers +r for users and channels to mark them # as identified separately from the idea of a master account, which # can be useful for services which are heavily nick-as-account centric. # -# This replaces m_services from 1.1 and earlier. -# # Also of note is that this module implements three extbans: # +b R: (stop matching account names from joining) # +b M: (stop matching account names from speaking) # +b U:n!u@h (blocks matching unregistered users) -# +# #<module name="m_services_account.so"> #-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-# -# Sethost module: Adds the /SETHOST command +# Sethost module: Adds the /SETHOST command. # This module is oper-only. # To use, SETHOST must be in one of your oper class blocks. # See m_chghost for how to customise valid chars for hostnames #<module name="m_sethost.so"> #-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-# -# Setident module: Adds the /SETIDENT command +# Setident module: Adds the /SETIDENT command. # This module is oper-only. # To use, SETIDENT must be in one of your oper class blocks. #<module name="m_setident.so"> #-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-# -# SETNAME module: Adds the /SETNAME command +# SETNAME module: Adds the /SETNAME command. #<module name="m_setname.so"> #-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-# -# Serverban: Implements extended ban s:, which stops anyone connected +# Serverban: Implements extended ban 's', which stops anyone connected # to a server matching a mask like +b s:server.mask.here from joining. #<module name="m_serverban.so"> #-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-# -# Show Whois module: Adds the +W usermode which allows opers -# to see when they are whois'ed (can be annoying). -# This module is oper-only. +# Show whois module: Adds the +W usermode which allows opers to see +# when they are /WHOIS'd. +# This module is oper-only by default. #<module name="m_showwhois.so"> # # If you wish, you may also let users set this mode. Only opers with the # users/auspex priv will see real hosts of people, though. This setting -# is not reloadable via /rehash, and will require /reloadmodule, as -# it directly affects the mode object itself. +# is not reloadable via /REHASH, changing it requires /RELOADMODULE. #<showwhois opersonly="yes" # -# You may also set whether or not users should receive whois notices, should -# they be /whois'd by an oper. -# showfromopers="yes"> +# You may also set whether or not users should receive whois notices, +# should they be /WHOIS'd by an oper. +#showfromopers="yes"> #-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-# # Shun module: Provides the /SHUN command, which stops a user from @@ -1662,17 +1652,20 @@ #<module name="m_shun.so"> # # You may also configure which commands you wish a user to be able to -# perform. It should be noted that if a shunned user issues QUIT or PART -# then their message will be removed, as if they did not issue one. +# perform when shunned. It should be noted that if a shunned user +# issues QUIT or PART then their message will be removed, as if they +# did not issue one. # -# You can (optionally) let the user know that their command was blocked. +# You can optionally let the user know that their command was blocked. # # You may also let SHUN affect opers (defaults to no). #<shun enabledcommands="PING PONG QUIT PART JOIN" notifyuser="yes" affectopers="no"> #-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-# -# SSL channel mode module: Adds support for SSL-only channels (+z). -# does not do anything useful without a working SSL module (see below) +# SSL channel mode module: Adds support for SSL-only channels via +# channel mode +z and the 'z' extban which matches SSL client +# certificate fingerprints. +# Does not do anything useful without a working SSL module (see below). #<module name="m_sslmodes.so"> #-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-# @@ -1684,19 +1677,19 @@ # #-#-#-#-#-#-#-#-#-#-#- GNUTLS CONFIGURATION -#-#-#-#-#-#-#-#-#-#-#-# # # -# m_ssl_gnutls.so is too complex it describe here, see the wiki: # +# m_ssl_gnutls.so is too complex to describe here, see the wiki: # # http://wiki.inspircd.org/Modules/ssl_gnutls # #-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-# -# SSL Info module: Allows users to retrieve information about other -# user's peer SSL certificates and keys. This can be used by client +# SSL info module: Allows users to retrieve information about other +# users' peer SSL certificates and keys. This can be used by client # scripts to validate users. For this to work, one of m_ssl_gnutls.so -# or m_ssl_openssl.so must be loaded. This module also adds the +# or m_ssl_openssl.so must be loaded. This module also adds the # "* <user> is using a secure connection" whois line, the ability for -# opers to use SSL fingerprints to verify their identity and the ability -# to force opers to use SSL connections in order to oper up. -# It is highly recommended to load this module especially if -# you use SSL on your network. +# opers to use SSL fingerprints to verify their identity and the +# ability to force opers to use SSL connections in order to oper up. +# It is highly recommended to load this module if you use SSL on your +# network. # For how to use the oper features, please see the first example <oper> tag # in opers.conf.example. # @@ -1711,27 +1704,27 @@ # #-#-#-#-#-#-#-#-#-#-#- OPENSSL CONFIGURATION -#-#-#-#-#-#-#-#-#-#-#-# # # -# m_ssl_openssl.so is too complex it describe here, see the wiki: # +# m_ssl_openssl.so is too complex to describe here, see the wiki: # # http://wiki.inspircd.org/Modules/ssl_openssl # #-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-# -# Strip color module: Adds the channel mode +S +# Strip color module: Adds channel mode +S that strips mIRC color +# codes from all messages sent to the channel. #<module name="m_stripcolor.so"> #-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-# -# SILENCE module: Adds support for /SILENCE +# Silence module: Adds support for the /SILENCE command, which allows +# users to have a server-side ignore list for their client. #<module name="m_silence.so"> # -# Configuration tags: -# +# Set the maximum number of entries allowed on a user's silence list. #<silence maxentries="32"> -# -# Sets the maximum number of entries on a users silence list. #-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-# # SQLite3 module: Allows other SQL modules to access SQLite3 # -# databases through a unified API. -# This modules is in extras. Re-run configure with: ./configure --enable-extras=m_sqlite.cpp +# databases through a unified API. # +# This module is in extras. Re-run configure with: # +# ./configure --enable-extras=m_sqlite.cpp # and run make install, then uncomment this module to enable it. # # #<module name="m_sqlite3.so"> @@ -1746,27 +1739,29 @@ #-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-# # SQL authentication module: Allows IRCd connections to be tied into # a database table (for example a forum). -# This modules is in extras. Re-run configure with: ./configure --enable-extras=m_sqlauth.cpp +# This module is in extras. Re-run configure with: +# ./configure --enable-extras=m_sqlauth.cpp # and run make install, then uncomment this module to enable it. # #<module name="m_sqlauth.so"> # #-#-#-#-#-#-#-#-#-#-#- SQLAUTH CONFIGURATION -#-#-#-#-#-#-#-#-#-#-#-# # # -# m_sqlauth.so is too complex it describe here, see the wiki: # +# m_sqlauth.so is too complex to describe here, see the wiki: # # http://wiki.inspircd.org/Modules/sqlauth # #-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-# # SQL oper module: Allows you to store oper credentials in an SQL table -# This modules is in extras. Re-run configure with: ./configure --enable-extras=m_sqloper.cpp +# This module is in extras. Re-run configure with: +# ./configure --enable-extras=m_sqloper.cpp # and run make install, then uncomment this module to enable it. # #<module name="m_sqloper.so"> # #-#-#-#-#-#-#-#-#-#-#- SQLOPER CONFIGURATION -#-#-#-#-#-#-#-#-#-#-#-# # # -# dbid - Database ID to use (see m_sql) # -# hash - Hashing provider to use for password hashing # +# dbid - Database ID to use (see SQL modules). # +# hash - Hashing provider to use for password hashing. # # # # See also: http://wiki.inspircd.org/Modules/sqloper # # # @@ -1780,19 +1775,19 @@ #<svshold silent="false"> #-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-# -# SWHOIS module: Allows you to add arbitary lines to user WHOIS. +# SWHOIS module: Allows you to add arbitrary lines to user WHOIS. # This module is oper-only. # To use, SWHOIS must be in one of your oper class blocks. #<module name="m_swhois.so"> #-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-# -# Test module: enable this to create a command useful in testing +# Test module: Enable this to create a command useful in testing # flood control. To avoid accidental use on live networks, the server # name must contain ".test" to load the module #<module name="m_testnet.so"> #-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-# -# Timed bans module: Adds timed channel bans and the /TBAN command +# Timed bans module: Adds timed channel bans with the /TBAN command. #<module name="m_timedbans.so"> #-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-# @@ -1821,7 +1816,7 @@ #<module name="m_uninvite.so"> #-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-# -# Userip module: Adds the /USERIP command +# Userip module: Adds the /USERIP command. # Allows users to query their own IP, also allows opers to query the IP # of anyone else. #<module name="m_userip.so"> @@ -1847,25 +1842,22 @@ #<vhost user="foo" password="fcde2b2edba56bf408601fb721fe9b5c338d10ee429ea04fae5511b68fbf8fb9" hash="sha256" host="some.other.host"> #-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-# -# Watch module: Adds the WATCH command, which is used by clients to +# Watch module: Adds the WATCH command, which is used by clients to # maintain notify lists. #<module name="m_watch.so"> # -# Configuration tags: -# +# Set the maximum number of entries on a user's watch list below. #<watch maxentries="32"> -# -# Sets the maximum number of entries on a user's watch list. #-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-# # XLine database: Stores all *Lines (G/Z/K/R/any added by other modules) -# in a file "xline.db" which can be re-loaded on restart. This is useful +# in a file which is re-loaded on restart. This is useful # for two reasons: it keeps bans so users may not evade them, and on # bigger networks, server connections will take less time as there will # be a lot less bans to apply - as most of them will already be there. #<module name="m_xline_db.so"> -# Specify the filename for the xline database here +# Specify the filename for the xline database here. #<xlinedb filename="data/xline.db"> #-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-# @@ -1879,13 +1871,10 @@ # module. If you don't do this, server links will NOT work at all. # # This is by design, to allow for the implementation of other linking # # protocols in modules in the future. # -# # #-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-# -# Spanning Tree module - allows linking of servers using the spanning +# Spanning tree module: Allows linking of servers using the spanning # tree protocol (see the READ THIS BIT section above). # You will almost always want to load this. # #<module name="m_spanningtree.so"> - - diff --git a/docs/conf/modules/charybdis.conf.example b/docs/conf/modules/charybdis.conf.example index b456278bb..bd99f7dc2 100644 --- a/docs/conf/modules/charybdis.conf.example +++ b/docs/conf/modules/charybdis.conf.example @@ -70,8 +70,8 @@ <module name="m_chancreate.so"> #-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-# -# Channel Names module: Allows disabling channels which have certain -# characters in the channel name such as bold, colorcodes, etc which +# Channel names module: Allows disabling channels which have certain +# characters in the channel name such as bold, colorcodes, etc. which # can be quite annoying and allow users to on occasion have a channel # that looks like the name of another channel on the network. <module name="m_channames.so"> @@ -144,7 +144,7 @@ #<module name="m_connectban.so"> #-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-# -# Connection throttle module. Configuration: +# Connection throttle module. #<module name="m_connflood.so"> # #-#-#-#-#-#-#-#-#-#-#- CONTHROTTLE CONFIGURATION -#-#-#-#-#-#-#-#-#-#-# @@ -182,21 +182,21 @@ <module name="m_redirect.so"> #-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-# -# Regular Expression Provider for Glob or wildcard (?/*) matching. +# Regular expression provider for glob or wildcard (?/*) matching. # You must have at least 1 provider loaded to use m_filter or m_rline # modules. This module has no additional requirements, as it uses the # matching already present in InspIRCd core. #<module name="m_regex_glob.so"> #-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-# -# Regular Expression Provider for PCRE (Perl-Compatible Regular +# Regular expression provider for PCRE (Perl-Compatible Regular # Expressions). You need libpcre installed to compile and load this # module. You must have at least 1 provider loaded to use m_filter or # m_rline. #<module name="m_regex_pcre.so"> #-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-# -# Regular Expression Provider for POSIX Regular Expressions. +# Regular expression provider for POSIX regular expressions. # You shouldn't need any additional libraries on a POSIX-compatible # system (ie: any Linux, BSD, but not Windows). You must have at least # 1 provider loaded to use m_filter or m_rline. @@ -246,14 +246,10 @@ <showwhois opersonly="yes" showfromopers="yes"> #-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-# -# Spy module: Provides the ability to see the complete names list of -# channels an oper is not a member of -# This module is oper-only. -#<module name="m_spy.so"> - -#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-# -# SSL channel mode module: Adds support for SSL-only channels (+z). -# does not do anything useful without a working SSL module (see below) +# SSL channel mode module: Adds support for SSL-only channels via +# channel mode +z and the 'z' extban which matches SSL client +# certificate fingerprints. +# Does not do anything useful without a working SSL module (see below). #<module name="m_sslmodes.so"> #-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-# @@ -265,7 +261,7 @@ # #-#-#-#-#-#-#-#-#-#-#- GNUTLS CONFIGURATION -#-#-#-#-#-#-#-#-#-#-#-# # # -# m_ssl_gnutls.so is too complex it describe here, see the wiki: # +# m_ssl_gnutls.so is too complex to describe here, see the wiki: # # http://wiki.inspircd.org/Modules/ssl_gnutls # #-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-# @@ -292,7 +288,7 @@ # #-#-#-#-#-#-#-#-#-#-#- OPENSSL CONFIGURATION -#-#-#-#-#-#-#-#-#-#-#-# # # -# m_ssl_openssl.so is too complex it describe here, see the wiki: # +# m_ssl_openssl.so is too complex to describe here, see the wiki: # # http://wiki.inspircd.org/Modules/ssl_openssl # <module name="m_stripcolor.so"> @@ -304,4 +300,3 @@ <module name="m_xline_db.so"> <module name="m_spanningtree.so"> - diff --git a/docs/conf/modules/unrealircd.conf.example b/docs/conf/modules/unrealircd.conf.example index 65896808f..9518822de 100644 --- a/docs/conf/modules/unrealircd.conf.example +++ b/docs/conf/modules/unrealircd.conf.example @@ -1,7 +1,7 @@ <module name="m_md5.so"> <module name="m_sha256.so"> #-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-# -# Alias module: Allows you to define server-side command aliases +# Alias module: Allows you to define server-side command aliases. <module name="m_alias.so"> <fantasy prefix="!" allowbots="no"> # Aliases @@ -118,8 +118,8 @@ <module name="m_commonchans.so"> #-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-# -# Conn-Join: Allows you to force users to join one or more channels -# automatically upon connecting to the server. +# Auto join on connect module: Allows you to force users to join one +# or more channels automatically upon connecting to the server. #<module name="m_conn_join.so"> # #-#-#-#-#-#-#-#-#-#-#-#- CONNJOIN CONFIGURATION -#-#-#-#-#-#-#-#-#-#-# @@ -133,7 +133,7 @@ <module name="m_cycle.so"> #-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-# -# Connection throttle module. Configuration: +# Connection throttle module. #<module name="m_connflood.so"> # #-#-#-#-#-#-#-#-#-#-#- CONTHROTTLE CONFIGURATION -#-#-#-#-#-#-#-#-#-#-# @@ -153,7 +153,7 @@ # quitmsg="Throttled" bootwait="10"> #-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-# -# DCCALLOW module: Adds the /DCCALLOW command +# DCCALLOW module: Adds the /DCCALLOW command. <module name="m_dccallow.so"> # #-#-#-#-#-#-#-#-#-#-#- DCCALLOW CONFIGURATION -#-#-#-#-#-#-#-#-#-#-# @@ -239,7 +239,7 @@ <module name="m_operchans.so"> #-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-# -# Oper Join module: Auto-joins opers to a channel upon oper-up +# Oper join module: Auto-joins opers to a channel upon oper-up. # This module is oper-only. For the user equivalent, see m_conn_join. <module name="m_operjoin.so"> # @@ -264,7 +264,7 @@ #-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-# # Oper MOTD module: Provides support for separate message of the day -# on oper-up +# on oper-up. # This module is oper-only. #<module name="m_opermotd.so"> # @@ -272,15 +272,15 @@ # # # If you are using the m_opermotd.so module, specify the motd here # # # -# onoper - Should the message be sent on /OPER or only when # -# /OPERMOTD is used. Use "yes" or "no". # +# onoper - If on, the message is sent on /OPER, otherwise it's # +# only sent when /OPERMOTD is used. # # # #<opermotd file="oper.motd" onoper="yes"> <module name="m_override.so"> #-#-#-#-#-#-#-#-#-#-# OVERRIDE CONFIGURATION -#-#-#-#-#-#-#-#-#-#-# # # -# m_override.so is too complex it describe here, see the wiki: # +# m_override.so is too complex to describe here, see the wiki: # # http://wiki.inspircd.org/Modules/override # <module name="m_operlevels.so"> @@ -288,31 +288,18 @@ <module name="m_password_hash.so"> <module name="m_muteban.so"> -#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-# -# Random Quote module: provides a random quote on connect. -# NOTE: Some of these may mimic fatal errors and confuse users and -# opers alike! - BEWARE! -#<module name="m_randquote.so"> -# -#-#-#-#-#-#-#-#-#-#- RANDOMQUOTES CONFIGURATION -#-#-#-#-#-#-#-#-#-#-# -# # -# Optional - If you specify to use the m_randquote.so module, then # -# specify below the path to the randquotes.conf file. # -# # -#<randquote file="randquotes.conf"> - <module name="m_redirect.so"> <module name="m_regex_glob.so"> #-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-# -# Regular Expression Provider for PCRE (Perl-Compatible Regular +# Regular expression provider for PCRE (Perl-Compatible Regular # Expressions). You need libpcre installed to compile and load this # module. You must have at least 1 provider loaded to use m_filter or # m_rline. #<module name="m_regex_pcre.so"> #-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-# -# Regular Expression Provider for POSIX Regular Expressions. +# Regular expression provider for POSIX Regular Expressions. # You shouldn't need any additional libraries on a POSIX-compatible # system (ie: any Linux, BSD, but not Windows). You must have at least # 1 provider loaded to use m_filter or m_rline. @@ -321,7 +308,7 @@ #<module name="m_regex_posix.so"> #-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-# -# Regular Expression Provider for TRE Regular Expressions. +# Regular expression provider for TRE Regular Expressions. # This is the same regular expression engine used by UnrealIRCd, so # if you are most familiar with the syntax of /spamfilter from there, # this is the provider you want. You need libtre installed in order @@ -329,8 +316,8 @@ #<module name="m_regex_tre.so"> #-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-# -# Registered users only channel creation -# Allows only registered users and opers to create new channels. +# Registered users only channel creation module. If enabled, only +# registered users and opers can create new channels. # # You probably *DO NOT* want to load this module on a public network. # @@ -370,7 +357,6 @@ <module name="m_shun.so"> <shun enabledcommands="PING PONG QUIT PART JOIN" notifyuser="no" affectopers="no"> -<module name="m_spy.so"> <module name="m_sslmodes.so"> #-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-#-# @@ -382,7 +368,7 @@ # #-#-#-#-#-#-#-#-#-#-#- GNUTLS CONFIGURATION -#-#-#-#-#-#-#-#-#-#-#-# # # -# m_ssl_gnutls.so is too complex it describe here, see the wiki: # +# m_ssl_gnutls.so is too complex to describe here, see the wiki: # # http://wiki.inspircd.org/Modules/ssl_gnutls # <module name="m_sslinfo.so"> @@ -396,7 +382,7 @@ # #-#-#-#-#-#-#-#-#-#-#- OPENSSL CONFIGURATION -#-#-#-#-#-#-#-#-#-#-#-# # # -# m_ssl_openssl.so is too complex it describe here, see the wiki: # +# m_ssl_openssl.so is too complex to describe here, see the wiki: # # http://wiki.inspircd.org/Modules/ssl_openssl # <module name="m_stripcolor.so"> @@ -409,4 +395,3 @@ <watch maxentries="32"> <module name="m_spanningtree.so"> - diff --git a/docs/conf/opers.conf.example b/docs/conf/opers.conf.example index 915bb3431..d03d019c6 100644 --- a/docs/conf/opers.conf.example +++ b/docs/conf/opers.conf.example @@ -8,24 +8,25 @@ # Note: It is possible to make a class which covers all available # # commands. To do this, specify commands="*". This is not really # # recommended, as it negates the whole purpose of the class system, # -# however it is provided for fast configuration (e.g. in test nets) # +# however it is provided for fast configuration (e.g. in test nets). # # # <class name="Shutdown" - # commands: oper commands that users of this class can run. - commands="DIE RESTART REHASH LOADMODULE UNLOADMODULE RELOAD GUNLOADMODULE GRELOADMODULE SAJOIN SAPART SANICK SAQUIT SATOPIC" + # commands: Oper-only commands that opers of this class can run. + commands="DIE RESTART REHASH LOADMODULE UNLOADMODULE RELOADMODULE GUNLOADMODULE GRELOADMODULE" - # privs: special privileges that users with this class may utilise. + # privs: Special privileges that users with this class may utilise. # VIEWING: # - channels/auspex: allows opers with this priv to see more detail about channels than normal users. - # - users/auspex: allows opers with this priv to view more details about users than normal users. + # - users/auspex: allows opers with this priv to view more details about users than normal users, e.g. real host and IP. # - servers/auspex: allows opers with this priv to see more detail about server information than normal users. # ACTIONS: # - users/mass-message: allows opers with this priv to PRIVMSG and NOTICE to a server mask (e.g. NOTICE $*) # - channels/high-join-limit: allows opers with this priv to join <channels:opers> total channels instead of <channels:users> total channels. # PERMISSIONS: + # - users/flood/no-fakelag: prevents opers from being penalized with fake lag for flooding (*NOTE) # - users/flood/no-throttle: allows opers with this priv to send commands without being throttled (*NOTE) # - users/flood/increased-buffers: allows opers with this priv to send and receive data without worrying about being disconnected for exceeding limits (*NOTE) # @@ -38,10 +39,11 @@ # chanmodes: Oper-only channel modes that opers with this class can use. chanmodes="*"> -<class name="ServerLink" commands="CONNECT SQUIT CONNECT MKPASSWD ALLTIME SWHOIS CLOSE JUMPSERVER LOCKSERV" usermodes="*" chanmodes="*" privs="servers/auspex"> -<class name="BanControl" commands="KILL GLINE KLINE ZLINE QLINE ELINE TLINE RLINE CHECK NICKLOCK SHUN CLONES CBAN" usermodes="*" chanmodes="*"> -<class name="OperChat" commands="WALLOPS GLOBOPS SETIDLE" usermodes="*" chanmodes="*" privs="users/mass-message"> -<class name="HostCloak" commands="SETHOST SETIDENT SETNAME CHGHOST CHGIDENT" usermodes="*" chanmodes="*" privs="users/auspex"> +<class name="SACommands" commands="SAJOIN SAPART SANICK SAQUIT SATOPIC SAKICK SAMODE"> +<class name="ServerLink" commands="CONNECT SQUIT RCONNECT RSQUIT MKPASSWD ALLTIME SWHOIS JUMPSERVER LOCKSERV UNLOCKSERV" usermodes="*" chanmodes="*" privs="servers/auspex"> +<class name="BanControl" commands="KILL GLINE KLINE ZLINE QLINE ELINE TLINE RLINE CHECK NICKLOCK NICKUNLOCK SHUN CLONES CBAN CLOSE" usermodes="*" chanmodes="*"> +<class name="OperChat" commands="WALLOPS GLOBOPS" usermodes="*" chanmodes="*" privs="users/mass-message"> +<class name="HostCloak" commands="SETHOST SETIDENT CHGNAME CHGHOST CHGIDENT SETIDLE" usermodes="*" chanmodes="*" privs="users/auspex"> #-#-#-#-#-#-#-#-#-#-#-#- OPERATOR COMPOSITION -#-#-#-#-#-#-#-#-#-#-# @@ -52,46 +54,46 @@ # # <type - # name: Name of type. Used in actual olines below. + # name: Name of type. Used in actual server operator accounts below. # Cannot contain spaces. If you would like a space, use # the _ character instead and it will translate to a space on whois. name="NetAdmin" - # classes: classes (above blocks) that this type belongs to. - classes="OperChat BanControl HostCloak Shutdown ServerLink" + # classes: Classes (blocks above) that this type belongs to. + classes="SACommands OperChat BanControl HostCloak Shutdown ServerLink" - # vhost: host oper gets on oper-up. This is optional. - vhost="netadmin.omega.org.za" + # vhost: Host opers of this type get when they log in (oper up). This is optional. + vhost="netadmin.omega.example.org" - # modes: usermodes besides +o that are set on a oper of this type + # modes: User modes besides +o that are set on an oper of this type # when they oper up. Used for snomasks and other things. # Requires that m_opermodes.so be loaded. modes="+s +cCqQ"> -<type name="GlobalOp" classes="OperChat BanControl HostCloak ServerLink" vhost="ircop.omega.org.za"> -<type name="Helper" classes="HostCloak" vhost="helper.omega.org.za"> +<type name="GlobalOp" classes="SACommands OperChat BanControl HostCloak ServerLink" vhost="ircop.omega.example.org"> +<type name="Helper" classes="HostCloak" vhost="helper.omega.example.org"> #-#-#-#-#-#-#-#-#-#-#- OPERATOR CONFIGURATION -#-#-#-#-#-#-#-#-#-#-# # # # Opers are defined here. This is a very important section. # -# Remember to only make operators out of trust worthy people. # +# Remember to only make operators out of trustworthy people. # # # -# oline with plain-text password +# Operator account with a plain-text password. <oper - # name: oper login that is used to oper up (/oper name password). - # Remember: This is case sensitive - name="Brain" + # name: Oper login that is used to oper up (/oper name password). + # Remember: This is case sensitive. + name="Attila" - # password: case-sensitive, unhashed...yea...self-explanatory. + # password: Case-sensitive, unhashed (plaintext). password="s3cret" - # host: What hostnames/IP's are allowed to oper up with this oline. - # Multiple options can be separated by spaces and CIDR's are allowed. - # You CAN use just * or *@* for this section, but it is not recommended + # host: What hostnames and IPs are allowed to use this operator account. + # Multiple options can be separated by spaces and CIDRs are allowed. + # You can use just * or *@* for this section, but it is not recommended # for security reasons. - host="yourident@dialup15.isp.com *@localhost *@example.com *@2001:db8::/32" + host="attila@inspircd.org *@2001:db8::/32" # ** ADVANCED ** This option is disabled by default. # fingerprint: When using the m_sslinfo module, you may specify @@ -103,61 +105,61 @@ # If m_sslinfo isn't loaded, this option will be ignored. #fingerprint="67cb9dc013248a829bb2171ed11becd4" - # autologin: if an SSL fingerprint for this oper is specified, you can + # autologin: If an SSL fingerprint for this oper is specified, you can # have the oper block automatically log in. This moves all security of the # oper block to the protection of the client certificate, so be sure that # the private key is well-protected! Requires m_sslinfo. #autologin="on" - # sslonly: This oper can only oper up if they're using a SSL connection. + # sslonly: If on, this oper can only oper up if they're using a SSL connection. # Setting this option adds a decent bit of security. Highly recommended # if the oper is on wifi, or specifically, unsecured wifi. Note that it # is redundant to specify this option if you specify a fingerprint. # This setting only takes effect if m_sslinfo is loaded. #sslonly="yes" - # vhost: overrides the vhost in the type block. Class and modes may also - # be overridden - vhost="brain.netadmin.omega" + # vhost: Overrides the vhost in the type block. Class and modes may also + # be overridden. + vhost="attila.example.org" - # type: What oper type this oline is. See the block above for list - # of types. NOTE: This is case-sensitive as well. + # type: Which type of operator this person is; see the block + # above for the list of types. NOTE: This is case-sensitive as well. type="NetAdmin"> -# oline with plain-text password and no comments..for all who like copy & paste +# Operator with a plaintext password and no comments, for easy copy & paste. <oper name="Brain" password="s3cret" - host="yourident@dialup15.isp.com *@localhost *@example.com *@2001:db8::/32" + host="brain@dialup15.isp.com *@localhost *@example.com *@2001:db8::/32" #fingerprint="67cb9dc013248a829bb2171ed11becd4" type="NetAdmin"> -# oline with hashed password. It is highly recommended to use hashed passwords. +# Operator with a hashed password. It is highly recommended to use hashed passwords. <oper - # name: oper login that is used to oper up (/oper name password). - # Remember: This is case sensitive - name="Brain" + # name: Oper login that is used to oper up (/oper name password). + # Remember: This is case sensitive. + name="Adam" - # hash: what hash this password is hashed with. + # hash: What hash this password is hashed with. # Requires the module for selected hash (m_md5.so, m_sha256.so # or m_ripemd160.so) be loaded and the password hashing module # (m_password_hash.so) loaded. # Options here are: "md5", "sha256" and "ripemd160", or one of # these prefixed with "hmac-", e.g.: "hmac-sha256". - # Create hashed password with: /mkpasswd <hash> <password> - hash="sha256" + # Create hashed passwords with: /mkpasswd <hash> <password> + hash="hmac-sha256" - # password: a hash of your password (see above option) hashed - # with /mkpasswd <hash> <password> . See m_password_hash in modules.conf + # password: A hash of the password (see above option) hashed + # with /mkpasswd <hash> <password>. See m_password_hash in modules.conf # for more information about password hashing. - password="1ec1c26b50d5d3c58d9583181af8076655fe00756bf7285940ba3670f99fcba0" + password="qQmv3LcF$Qh63wzmtUqWp9OXnLwe7yv1GcBwHpq59k2a0UrY8xe0" - # host: What hostnames/IP's are allowed to oper up with this oline. - # Multiple options can be separated by spaces and CIDR's are allowed. - # You CAN use just * or *@* for this section, but it is not recommended + # host: What hostnames and IPs are allowed to use this operator account. + # Multiple options can be separated by spaces and CIDRs are allowed. + # You can use just * or *@* for this section, but it is not recommended # for security reasons. - host="yourident@dialup15.isp.com *@localhost *@example.com *@2001:db8::/32" + host="*@127.0.0.1 *@192.0.2.40 *@198.51.100.4" - # type: What oper type this oline is. See the block above for list - # of types. NOTE: This is case-sensitive as well. - type="NetAdmin"> + # type: Which type of operator this person is; see the block + # above for the list of types. NOTE: This is case-sensitive as well. + type="Helper"> -- 2.39.2