spanningtree module (2.0 version)
|2.0 Documentation||3.0 Documentation|
|Return to the 2.0 Module List|
|Allows for linking of servers using a traditional spanning tree like those seen in most irc servers. This module is vital for linking to other servers in a network, or for linking services programs etc. However, if you never intend to link to anything (including services) then you do not need to load m_spanningtree.|
| To listen on a port for server connections, rather than client connections, change the type of the <bind> tag to servers, for example:
<bind address="" port="7000-7004" type="servers" ssl="gnutls">
The values have the following meanings:
<link name="hub.penguin.org" ipaddr="penguin.box.com" port="7000" allowmask="22.214.171.124/24" failover="hub.other.net" timeout="15" ssl="gnutls" bind="126.96.36.199" sendpass="outgoing!password" recvpass="incoming!password">
This tag defines which servers can link to this one, and which servers this server may create outbound links to. The values have the following meanings:
To u:line a server (give it extra privilages required for running services, Q, etc) you must include the <uline server> tag as shown in the example below. You can have as many of these as you like.
Extra options values
InspIRCd adds the following extra values to <options> in your configuration file:
<options hidesplits="no" flatlinks="no" hideulines="no" announcets="yes" disablehmac="no" quietbursts="no" serverpingfreq="120">
These extra values have the following meanings:
WARNING: Unlike other ircds, u:lining a server allows ALL users on that server to operoverride modes. This should only be used for services and protected oper servers!
|This module does not implement any extra user or channel modes.|
|This module implements no extended bans.|
Overrides the following existing commands:
Shows a server map of all connected servers.
Shows which servers are linked to which other servers
WHOIS [nick] [server]
Allows performing of remote WHOIS on remotely connected users
CONNECT [destination server mask]
Connects local servers together
SQUIT [destination server mask]
Causes local servers to terminate their link
Allows display of remote stats
Allows displaying of remote server's admin details
Allows displaying of a remote server's message of the day file
Allows displaying of a remote server's loaded modules
Implements the following new commands:
RCONNECT [source mask] [target mask]
When the RCONNECT command is issued, all servers which match <source mask> will try to /CONNECT to the first server they have in their config matching <target mask>. For example:
RCONNECT penguins.* polarbears.*
Causes the ircd penguins.* to attempt a connect to polarbears.*, regardless of which server you are currently on (so long as penguins.* is reachable of course!)
RSQUIT [source mask] [target mask]
Causes the remote server [target mask] to have its connection closed by [source mask], similar in operation to RCONNECT.
RSQUIT [target mask]
Causes the remote server [target mask] to be disconnected from the network.
| This module provides linking support between InspIRCd servers, and it is in fact one of the most complex modules in the tarball. For more information on the technical specifications of this module please see the section on the InspIRCd spanning tree protocol.
Note that in InspIRCd 1.1 (from beta 3 onwards) you may unload the spanningtree module with /unloadmodule. if you do this, all servers will be SQUIT. Use with caution, and only for hotfixes where possible!