2.6 KiB
Elemental-ircd specific deviations from the normal TS6 protocol
As a general rule of thumb and for compatibility reasons, protocol changes are made as infrequently and minimally as possible. However there are some things that have been changed in how elemental handles the server to server protocol that are worth mentioning.
For readability's sake, any lines that a server sends are prefixed by >>> and
any lines it expects to recieve are prefixed by <<<.
Changes
Channel owner mode
If enabled, a new mode will be added to the channel prefix list. This mode (+y) has a prefix of "~" and in most IRC services packages is used to signify the owner of a specific channel. If enabled, it will show up in SJOIN lines as such:
>>> :[sid] SJOIN [channel-ts] #opers + :~[ts6-uid]
A more practical example would be:
>>> :420 SJOIN 13840003504 #opers + :~@42000000A
As the mode for this channel is +y, all TMODE changes adding or removing +y
from a client in a channel should set and unset this mode accordingly. An example
of adding the mode follows:
>>> :47GAAAAAB TMODE 13840003504 #opers +y 42000000A
Handling removal is similar.
Currently, the only way to detect if a remote server supports these extended
modes is to remotely query a server's VERSION and read out the 005 reply.
Things added to existing commands
Server notice mask broadcasts
Currently the NEEDSASL, DNSBL hit, hunted command flooding and m_post rejections
are globally broadcast server notices. They will show up in TS6 lines such as:
<<< :[sid] ENCAP * SNOTE [snomask] :[server name] :[message]
For a more practical example:
<<< :47G ENCAP * SNOTE b :rarity.shadownet.int :Client floodbot (~a@127.0.0.1) is attempting to flood ADMIN
These broadcasts are there for IRC operators on more centrally managed networks
to better see what is going on on other ends of the network without having to hop
servers and check. Bots or pseudoservices may also uses these lines to perform
additional actions (such as AKILLs or logging to channels) as needed by the
bot author.
METADATA
The old ShadowIRCD implementation of METADATA used ADD and DELETE verbs for
adding and deleting metadata to channels and clients. This, in practice looks
something like:
<<< :45X ENCAP * METADATA ADD 1NRAAAABR OPERSTRING :is an IRC Administrator
<<< :45X ENCAP * METADATA DELETE 1NRAAAABR OPERSTRING
Functionality is identical to the new SET and CLEAR verbs, but this deviates
from the spec by being only a server to server command. Support for client
to server and server to client metadata setting/getting will come in a future
version of elemental-ircd.