X-Git-Url: https://jfr.im/git/irc/quakenet/newserv.git/blobdiff_plain/da326c844c0d995b82611ea84cf8d745f5d5f083..fc03eb2dd7092582030b2694d69174ce2bfb82dd:/MODULES diff --git a/MODULES b/MODULES index eb4aa654..a47506c0 100644 --- a/MODULES +++ b/MODULES @@ -1,29 +1,29 @@ newserv Modules -~~~~~~~~~~~~~~ +=============== This is a brief overview of the newserv modules. core -~~~ +---- This is not actually a module. Instead, this is the code of the "newserv" binary which provides minimal support for loading modules. authext, bans, chanindex, channel, irc, nick, server -~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ +---------------------------------------------------- These modules provide basic support for accounts, channels, nicks and server connections. Virtually all other modules depend on at least some of these modules. localuser -~~~~~~~~ +--------- Implements functionality for creating local users that are "connected" to the newserv instance. control -~~~~~~ +------- Spawns the control user for your newserv instance. The control user provides an IRC-based interface for newserv commands, e.g. to manage loaded modules @@ -31,38 +31,45 @@ and modify user accounts. Other modules can register their own commands. -You can create a user on your control instance using /msg N hello (where N is -the nick of your control instance). You need to be opered in order to use this -command. - -Once you have an account you should have a look at /msg N showcommands for a -list of available commands. - Configuration: [control] nick=N3 +#ident=control +#hostname=your.hostname.here +#realname=newserv Control Service +#authname=C + +control_commands +---------------- + +Provides commonly-used oper commands. + +control_management +------------------ + +Provides user management commands. auth -~~~ +---- Supports sending AC tokens. You should only use this module if you don't have some other form of authentication service on your network (such as Q). This module lets opers use arbitrary account names and IDs. chanfix -~~~~~~ +------- Keeps track of channel ops and can be used to re-op opless channels. chanserv -~~~~~~~ +-------- This is QuakeNet's channel service (Q). In order to load this module you will need also need to load the pqsql module. pqsql -~~~~ +----- Provides support for PostgreSQL database queries. @@ -75,41 +82,51 @@ username=gunnar password=changeme dbapi2 -~~~~~ +------ Implements database functionality used by some other modules. In addition to loading the dbapi2 module you will also need to load one of the database provider modules: sqlite-dbapi2 or pqsql-dbapi2 fakeusers -~~~~~~~~ +--------- Provides a way to spawn fake users. glines -~~~~~ +------ Implements gline commands and general gline functionality that is used by other modules. +geoip +----- + +Provides geo-location services for other modules. + +Configuration: + +[geoip] +#db=GeoIP.dat + helpmod2 -~~~~~~~ +-------- This is QuakeNet's G service. It is primarily used on official support channels. invalidbans -~~~~~~~~~~ +----------- This module automatically removes invalid IPv6 bans as these can desync channel modes on snircd 1.3.4a. jupe -~~~ +---- Provides commands to set, list and remove jupes. lua -~~ +--- Provides support for Lua scripts. For an example of a fairly complex script have a look at the labspace repository at http://hg.quakenet.org/lua-labspace/ @@ -125,57 +142,95 @@ installation directory (e.g. "luascripts" in this example) and symlink the lua/lib directory into it. newsearch -~~~~~~~~ +--------- Provides functionality to search for nicks and channels based on certain criteria. +nickwatch +--------- + +Implements event-based nicksearch queries. + miscreply -~~~~~~~~ +--------- Implements rping and various other status query commands. +Configuration: + +[miscreply] +#admin1=Located at the Union Aerospace Corp. facility, Stroggos +#admin2=Network IRC Service +#admin3=No administrative info available + +patrol +------ + +Implements functionality to spawn trojanscan swarm clones. + +Configuration: + +[patrol] +#minpoolhosts=5000 + +patricia, patricianick, patriciasearch +-------------------------------------- + +Implements finding nicks based on CIDR prefixes. + proxyscan -~~~~~~~~ +--------- Does on-connect proxy scans and glines open proxies. request -~~~~~~ +------- + +This is QuakeNet's channel service request bot (R). -This is QuakeNet's channel service request bot (R). Some of the module -parameters are not configurable - instead you will have to modify the -request/request.h header file and recompile the module. +Configuration: + +[request] +#nick=R +#user=request +#host=request.quakenet.org +#real=Service Request v0.23 +#snick=S +#sserver=spamscan.quakenet.org +#qnick=Q +#qserver=cserve.quakenet.org serverlist -~~~~~~~~~ +---------- Implements the serverlist command which shows various information about connected servers (including their network latency). settime -~~~~~~ +------- Provides commands to set the network time. splitlist -~~~~~~~~ +--------- Keeps track of servers that were lost during a netsplit. This module is used by chanfix to determine when it shouldn't re-op users. trojanscan -~~~~~~~~~ +---------- Used to find and gline drones on the network. trusts -~~~~~ +------ Implements connection limits. Supports the TRUST protocol which is used -by quakenet-iauthd to determine whether to allow users on the network. +by quakenet-iauthd to determine whether to allow users to connect to the +network. -You will need to load the trusts_master module on one of your newserv +You will need to load the trusts_master module on exactly one of your newserv instances. All other instances should load the trusts_slave module in order to receive replication updates from the trusts master: @@ -201,17 +256,20 @@ You can use the QuakeNet IAuth daemon available at http://hg.quakenet.org/iauthd/ to enforce connection limits using IAuth rather than g:lines. -whowas -~~~~~ +whowas, whowas_channels +----------------------- Keeps track of historical user records. Used by the glines module to chase nicks and by newsearch. +The whowas_channels module optionally keeps track of which channels users +were on. + xsb -~~ +--- -Provides replication capabilities. Used by the trusts modules to sync -trusts between newserv instances. +Provides newserv<->newserv communication capabilities. Used by the trusts +modules to sync trusts between newserv instances. Configuration: