From bdfadfcb99a6b5343be0f005d8ecdfcc14a05e3f Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Antoine=20Beaupr=C3=A9?= Date: Sat, 25 Mar 2017 11:33:06 -0400 Subject: [PATCH] some styling turn all +flags into preformatted flags, fix admonitions --- doc/oper-guide/cmodes.rst | 161 ++++++++++++----------- doc/oper-guide/commands.rst | 22 ++-- doc/oper-guide/config.rst | 34 ++--- doc/oper-guide/oprivs.rst | 6 +- doc/oper-guide/ucommands.rst | 10 +- doc/oper-guide/umodes.rst | 243 ++++++++++++++++------------------- 6 files changed, 221 insertions(+), 255 deletions(-) diff --git a/doc/oper-guide/cmodes.rst b/doc/oper-guide/cmodes.rst index 0232e1ee..7c805dd6 100644 --- a/doc/oper-guide/cmodes.rst +++ b/doc/oper-guide/cmodes.rst @@ -1,15 +1,15 @@ Channel modes ============= -+b, channel ban ---------------- +``+b``, channel ban +------------------- Bans take one parameter which can take several forms. The most common -form is +b nick!user@host. The wildcards \* and ? are allowed, matching +form is ``+b nick!user@host``. The wildcards ``*`` and ``?`` are allowed, matching zero-or-more, and exactly-one characters respectively. The masks will be trimmed to fit the maximum allowable length for the relevant element. Bans are also checked against the IP address, even if it resolved or is -spoofed. CIDR is supported, like \*!\*@10.0.0.0/8. This is most useful +spoofed. CIDR is supported, like ``*!*@10.0.0.0/8``. This is most useful with IPv6. Bans are not checked against the real hostname behind any kind of spoof, except if host mangling is in use (e.g. ``extensions/ip_cloaking.so``): if the user's host is mangled, their @@ -18,11 +18,11 @@ could enable mangling, the mangled form of their hostname is checked additionally. Hence, it is not possible to evade bans by toggling host mangling. -The second form (extban) is +b $type or +b $type:data. type is a single +The second form (extban) is ``+b $type`` or ``+b $type:data``. type is a single character (case insensitive) indicating the type of match, optionally -preceded by a tilde (~) to negate the comparison. data depends on type. +preceded by a tilde (``~``) to negate the comparison. data depends on type. Each type is loaded as a module. The available types (if any) are listed -in the EXTBAN token of the 005 (RPL\_ISUPPORT) numeric. See +in the EXTBAN token of the 005 (``RPL_ISUPPORT``) numeric. See ``doc/extban.txt`` in the source distribution for more information. If no parameter is given, the list of bans is returned. All users can @@ -32,98 +32,97 @@ Matching users will not be allowed to join the channel or knock on it. If they are already on the channel, they may not send to it or change their nick. -+c, colour filter ------------------ +``+c``, colour filter +--------------------- This cmode activates the colour filter for the channel. This filters out bold, underline, reverse video, beeps, mIRC colour codes, and ANSI escapes. Note that escape sequences will usually leave cruft sent to the channel, just without the escape characters themselves. -+e, ban exemption ------------------ +``+e``, ban exemption +--------------------- This mode takes one parameter of the same form as bans, which overrides -+b and +q bans for all clients it matches. +``+b`` and ``+q`` bans for all clients it matches. This can be useful if it is necessary to ban an entire ISP due to persistent abuse, but some users from that ISP should still be allowed -in. For example: /mode #channel +be \*!\*@\*.example.com -\*!\*someuser@host3.example.com +in. For example: ``/mode #channel +be *!*@*.example.com *!*someuser@host3.example.com`` -Only channel operators can see +e changes or request the list. +Only channel operators can see ``+e`` changes or request the list. -+f, channel forwarding ----------------------- +``+f``, channel forwarding +-------------------------- -This mode takes one parameter, the name of a channel (+f #channel). If -the channel also has the +i cmode set, and somebody attempts to join -without either being expliticly invited, or having an invex (+I), then +This mode takes one parameter, the name of a channel (``+f #channel``). If +the channel also has the ``+i`` cmode set, and somebody attempts to join +without either being expliticly invited, or having an invex (``+I``), then they will instead join the channel named in the mode parameter. The client will also be sent a 470 numeric giving the original and target channels. -Users are similarly forwarded if the +j cmode is set and their attempt -to join is throttled, if +l is set and there are already too many users -in the channel or if +r is set and they are not identified. +Users are similarly forwarded if the ``+j`` cmode is set and their attempt +to join is throttled, if ``+l`` is set and there are already too many users +in the channel or if ``+r`` is set and they are not identified. -Forwards may only be set to +F channels, or to channels the setter has +Forwards may only be set to ``+F`` channels, or to channels the setter has ops in. -Without parameter (/mode #channel f or /mode #channel +f) the forward +Without parameter (``/mode #channel f`` or ``/mode #channel +f``) the forward channel is returned. This form also works off channel. -+F, allow anybody to forward to this ------------------------------------- +``+F``, allow anybody to forward to this +---------------------------------------- When this mode is set, anybody may set a forward from a channel they have ops in to this channel. Otherwise they have to have ops in this channel. -+g, allow anybody to invite ---------------------------- +``+g``, allow anybody to invite +------------------------------- When this mode is set, anybody may use the INVITE command on the channel in question. When it is unset, only channel operators may use the INVITE command. -When this mode is set together with +i, +j, +l or +r, all channel +When this mode is set together with ``+i``, ``+j``, ``+l`` or ``+r``, all channel members can influence who can join. -+i, invite only ---------------- +``+i``, invite only +------------------- When this cmode is set, no client can join the channel unless they have -an invex (+I) or are invited with the INVITE command. +an invex (``+I``) or are invited with the INVITE command. -+I, invite exception (invex) ----------------------------- +``+I``, invite exception (invex) +-------------------------------- This mode takes one parameter of the same form as bans. Matching clients do not need to be invited to join the channel when it is invite-only -(+i). Unlike the INVITE command, this does not override +j, +l and +r. +(``+i``). Unlike the INVITE command, this does not override ``+j``, ``+l`` and ``+r``. -Only channel operators can see +I changes or request the list. +Only channel operators can see ``+I`` changes or request the list. -+j, join throttling -------------------- +``+j``, join throttling +----------------------- This mode takes one parameter of the form n:t, where n and t are positive integers. Only n users may join in each period of t seconds. -Invited users can join regardless of +j, but are counted as normal. +Invited users can join regardless of ``+j``, but are counted as normal. Due to propagation delays between servers, more users may be able to join (by racing for the last slot on each server). -+k, key (channel password) --------------------------- +``+k``, key (channel password) +------------------------------ Taking one parameter, when set, this mode requires a user to supply the key in order to join the channel: /JOIN #channel key. -+l, channel member limit ------------------------- +``+l``, channel member limit +---------------------------- Takes one numeric parameter, the number of users which are allowed to be in the channel before further joins are blocked. Invited users may join @@ -132,35 +131,35 @@ regardless. Due to propagation delays between servers, more users may be able to join (by racing for the last slot on each server). -+L, large ban list ------------------- +``+L``, large ban list +---------------------- Channels with this mode will be allowed larger banlists (by default, 500 -instead of 50 entries for +b, +q, +e and +I together). Only network +instead of 50 entries for ``+b``, ``+q``, ``+e`` and ``+I`` together). Only network operators with resv privilege may set this mode. -+m, moderated -------------- +``+m``, moderated +----------------- -When a channel is set +m, only users with +o or +v on the channel can +When a channel is set ``+m``, only users with ``+o`` or ``+v`` on the channel can send to it. Users can still knock on the channel or change their nick. -+n, no external messages ------------------------- +``+n``, no external messages +---------------------------- When set, this mode prevents users from sending to the channel without being in it themselves. This is recommended. -+o, channel operator --------------------- +``+o``, channel operator +------------------------ This mode takes one parameter, a nick, and grants or removes channel operator privilege to that user. Channel operators have full control -over the channel, having the ability to set all channel modes except +L -and +P, and kick users. Like voiced users, channel operators can always -send to the channel, overriding +b, +m and +q modes and the per-channel +over the channel, having the ability to set all channel modes except ``+L`` +and ``+P``, and kick users. Like voiced users, channel operators can always +send to the channel, overriding ``+b``, ``+m`` and ``+q`` modes and the per-channel flood limit. In most clients channel operators are marked with an '@' sign. @@ -172,16 +171,16 @@ which ensure the founder (and users designated by the founder) can always gain channel operator privileges and provide some features to manage the channel. -+p, paranoid channel --------------------- +``+p``, paranoid channel +------------------------ When set, the KNOCK command cannot be used on the channel to request an invite, and users will not be shown the channel in WHOIS replies unless -they are on it. Unlike in traditional IRC, +p and +s can be set +they are on it. Unlike in traditional IRC, ``+p`` and ``+s`` can be set together. -+P, permanent channel ---------------------- +``+P``, permanent channel +------------------------- Channels with this mode (which is accessible only to network operators with resv privilege) set will not be destroyed when the last user @@ -191,61 +190,61 @@ This makes it less likely modes, bans and the topic will be lost and makes it harder to abuse network splits, but also causes more unwanted restoring of old modes, bans and topics after long splits. -+q, quiet ---------- +``+q``, quiet +------------- -This mode behaves exactly like +b (ban), except that the user may still +This mode behaves exactly like ``+b`` (ban), except that the user may still join the channel. The net effect is that they cannot knock on the channel, send to the channel or change their nick while on channel. -+Q, block forwarded users -------------------------- +``+Q``, block forwarded users +----------------------------- Channels with this mode set are not valid targets for forwarding. Any attempt to forward to this channel will be ignored, and the user will be handled as if the attempt was never made (by sending them the relevant error message). -This does not affect the ability to set +f. +This does not affect the ability to set ``+f``. -+r, block unidentified ----------------------- +``+r``, block unidentified +-------------------------- When set, this mode prevents unidentified users from joining. Invited users can still join. -+s, secret channel ------------------- +``+s``, secret channel +---------------------- When set, this mode prevents the channel from appearing in the output of the LIST, WHO and WHOIS command by users who are not on it. Also, the server will refuse to answer WHO, NAMES, TOPIC and LIST queries from users not on the channel. -+t, topic limit ---------------- +``+t``, topic limit +------------------- When set, this mode prevents users who are not channel operators from changing the topic. -+v, voice ---------- +``+v``, voice +------------- This mode takes one parameter, a nick, and grants or removes voice privilege to that user. Voiced users can always send to the channel, -overriding +b, +m and +q modes and the per-channel flood limit. In most +overriding ``+b``, ``+m`` and ``+q`` modes and the per-channel flood limit. In most clients voiced users are marked with a plus sign. The privilege is lost if the user leaves the channel or server in any way. -+z, reduced moderation ----------------------- +``+z``, reduced moderation +-------------------------- -When +z is set, the effects of +m, +b and +q are relaxed. For each +When ``+z`` is set, the effects of ``+m``, ``+b`` and ``+q`` are relaxed. For each message, if that message would normally be blocked by one of these modes, it is instead sent to all channel operators. This is intended for use in moderated debates. -Note that +n is unaffected by this. To silence a given user completely, +Note that ``+n`` is unaffected by this. To silence a given user completely, remove them from the channel. diff --git a/doc/oper-guide/commands.rst b/doc/oper-guide/commands.rst index 97725e56..f8804b0f 100644 --- a/doc/oper-guide/commands.rst +++ b/doc/oper-guide/commands.rst @@ -4,11 +4,9 @@ Operator Commands Network management commands ~~~~~~~~~~~~~~~~~~~~~~~~~~~ - **Note** - - All commands and names are case insensitive. Parameters consisting - of one or more separate letters, such as in MODE, STATS and WHO, are - case sensitive. +.. note:: All commands and names are case insensitive. Parameters + consisting of one or more separate letters, such as in MODE, + STATS and WHO, are case sensitive. CONNECT ------- @@ -95,10 +93,8 @@ scratch as if it had just been executed. This reexecutes the ircd using the compiled-in path, visible as SPATH in INFO. - **Note** - - This command cannot be used remotely. The server name is used only - as a safety measure. +.. note:: This command cannot be used remotely. The server name is + used only as a safety measure. DIE --- @@ -108,10 +104,8 @@ server Immediately terminate the IRC server, after sending notices to all connected clients and servers - **Note** - - This command cannot be used remotely. The server name is used only - as a safety measure. +.. note:: This command cannot be used remotely. The server name is + used only as a safety measure. SET --- @@ -513,7 +507,7 @@ H.S. A server we have established a TCP connection to, but is not yet registered. -???? +\?\?\?\? An incoming connection that has not yet registered as a user or a server (“unknown”). Shows the username, hostname, IP address and the time the connection has been open. It is possible that the ident or diff --git a/doc/oper-guide/config.rst b/doc/oper-guide/config.rst index 8fe1f53d..fd1b4e0f 100644 --- a/doc/oper-guide/config.rst +++ b/doc/oper-guide/config.rst @@ -287,14 +287,12 @@ jupe\_exempt resv\_exempt Users in this auth{} block may use reserved nicknames and channels. - **Note** - - The initial nickname may still not be reserved. - -flood\_exempt (\|) - Users in this auth{} block may send arbitrary amounts of commands - per time unit to the server. This does not exempt them from any - other flood limits. You should use this setting with caution. +.. note:: The initial nickname may still not be reserved. + +flood\_exempt (\|) Users in this auth{} block may send arbitrary + amounts of commands per time unit to the server. This does not + exempt them from any other flood limits. You should use this + setting with caution. no\_tilde (-) Users in this auth{} block will not have a tilde added to their @@ -437,15 +435,13 @@ Connect blocks define what servers may connect or be connected to. host The hostname or IP to connect to. - **Note** +.. note:: Furthermore, if a hostname is used, it must have an ``A`` or + ``AAAA`` record (no ``CNAME``) and it must be the primary hostname + for inbound connections to work. - Furthermore, if a hostname is used, it must have an A or AAAA - record (no CNAME) and it must be the primary hostname for - inbound connections to work. - - IPv6 addresses must be in :: shortened form; addresses which - then start with a colon must be prepended with a zero, for - example 0::1. + IPv6 addresses must be in ``::`` shortened form; addresses which + then start with a colon must be prepended with a zero, for + example ``0::1``. send\_password The password to send to the other server. @@ -688,10 +684,8 @@ flags another flags entry) will receive these flags. They are listed below. - **Note** - - While they have the same names, the flags have subtly different - meanings from those in the cluster{} block. +.. note:: While they have the same names, the flags have subtly + different meanings from those in the cluster{} block. kline (K) Permanent and temporary K:lines diff --git a/doc/oper-guide/oprivs.rst b/doc/oper-guide/oprivs.rst index 5567b063..ca25dfd4 100644 --- a/doc/oper-guide/oprivs.rst +++ b/doc/oper-guide/oprivs.rst @@ -73,10 +73,8 @@ servers, and the server argument on REHASH. This is only allowed if the oper may perform the action locally, and if the remote server has a shared{} block. - **Note** - - If a cluster{} block is present, bans are sent remotely even if the - oper does not have oper:remoteban privilege. +.. note:: If a cluster{} block is present, bans are sent remotely even + if the oper does not have oper:remoteban privilege. oper:resv, channel control -------------------------- diff --git a/doc/oper-guide/ucommands.rst b/doc/oper-guide/ucommands.rst index ba74edfa..d8805cba 100644 --- a/doc/oper-guide/ucommands.rst +++ b/doc/oper-guide/ucommands.rst @@ -74,10 +74,9 @@ FINDFORWARDS FINDFORWARDS channel - **Note** - This command is only available if the ``m_findforwards.so`` - extension is loaded. +.. note:: This command is only available if the ``m_findforwards.so`` + extension is loaded. Displays which channels forward to the given channel (via cmode +f). If there are very many channels the list will be truncated. @@ -101,10 +100,9 @@ IDENTIFY IDENTIFY parameters... - **Note** - This command is only available if the ``m_identify.so`` extension is - loaded. +.. note:: This command is only available if the ``m_identify.so`` + extension is loaded. Sends an identify command to either NickServ or ChanServ. If the first parameter starts with #, the command is sent to ChanServ, otherwise to diff --git a/doc/oper-guide/umodes.rst b/doc/oper-guide/umodes.rst index a05523e8..d38dfd7f 100644 --- a/doc/oper-guide/umodes.rst +++ b/doc/oper-guide/umodes.rst @@ -1,63 +1,57 @@ User modes ========== -+a, server administrator ------------------------- +``+a``, server administrator +---------------------------- This vanity usermode is used to denote a server administrator in WHOIS output. All local “admin” privileges are independent of it, though -services packages may grant extra privileges to +a users. +services packages may grant extra privileges to ``+a`` users. -+D, deaf --------- +``+D``, deaf +------------ - **Note** +.. note:: This is a user umode, which anybody can set. It is not + specific to operators. - This is a user umode, which anybody can set. It is not specific to - operators. - -Users with the +D umode set will not receive messages sent to channels. +Users with the ``+D`` umode set will not receive messages sent to channels. Joins, parts, topic changes, mode changes, etc are received as normal, as are private messages. -Support of this umode is indicated by the DEAF token in RPL\_ISUPPORT +Support of this umode is indicated by the ``DEAF`` token in ``RPL_ISUPPORT`` (005); the parameter indicates the letter of the umode. Note that several common IRCD implementations have an umode like this (typically -+d) but do not have the token in 005. +``+d``) but do not have the token in 005. -+g, Caller ID -------------- +``+g``, Caller ID +----------------- - **Note** +.. note:: This is a user umode, which anybody can set. It is not + specific to operators. - This is a user umode, which anybody can set. It is not specific to - operators. - -Users with the +g umode set will only receive private messages from -users on a session-defined whitelist, defined by the /accept command. If -a user who is not on the whitelist attempts to send a private message, -the target user will receive a rate-limited notice saying that the user -wishes to speak to them. +Users with the ``+g`` umode set will only receive private messages +from users on a session-defined whitelist, defined by the ``/accept`` +command. If a user who is not on the whitelist attempts to send a +private message, the target user will receive a rate-limited notice +saying that the user wishes to speak to them. Network operators are not affected by the callerid whitelist system in the event that they need to speak to users who have it enabled. -Support of this umode is indicated by the CALLERID token in -RPL\_ISUPPORT (005); the optional parameter indicates the letter of the -umode, otherwise +g. +Support of this umode is indicated by the ``CALLERID`` token in +``RPL_ISUPPORT`` (005); the optional parameter indicates the letter of +the umode, otherwise ``+g``. -+i, invisible -------------- +``+i``, invisible +----------------- - **Note** - - This is a user umode, which anybody can set. It is not specific to - operators. +.. note:: This is a user umode, which anybody can set. It is not + specific to operators. Invisible users do not show up in WHO and NAMES unless you can see them. -+l, receive locops ------------------- +``+l``, receive locops +---------------------- LOCOPS is a version of OPERWALL that is sent to opers on a single server only. With cluster{} and shared{} blocks they can optionally be @@ -65,84 +59,77 @@ propagated further. Unlike OPERWALL, any oper can send and receive LOCOPS. -+o, operator ------------- +``+o``, operator +---------------- This indicates global operator status. -+Q, disable forwarding ----------------------- +``+Q``, disable forwarding +-------------------------- - **Note** - - This is a user umode, which anybody can set. It is not specific to - operators. +.. note:: This is a user umode, which anybody can set. It is not + specific to operators. This umode prevents you from being affected by channel forwarding. If enabled on a channel, channel forwarding sends you to another channel if -you could not join. See channel mode +f for more information. +you could not join. See channel mode ``+f`` for more information. -+R, reject messages from unauthenticated users ----------------------------------------------- +``+R``, reject messages from unauthenticated users +-------------------------------------------------- - **Note** +.. note:: This is a user umode, which anybody can set. It is not + specific to operators. - This is a user umode, which anybody can set. It is not specific to - operators. - -If a user has the +R umode set, then any users who are not authenticated +If a user has the ``+R`` umode set, then any users who are not authenticated will receive an error message if they attempt to send a private message -or notice to the +R user. +or notice to the ``+R`` user. -Opers and accepted users (like in +g) are exempt. Unlike +g, the target +Opers and accepted users (like in ``+g``) are exempt. Unlike ``+g``, the target user is not notified of failed messages. -+s, receive server notices --------------------------- +``+s``, receive server notices +------------------------------ This umode allows an oper to receive server notices. The requested types of server notices are specified as a parameter (“snomask”) to this umode. -+S, network service -------------------- +``+S``, network service +----------------------- - **Note** - - This umode can only be set by servers named in a service{} block. +.. note:: This umode can only be set by servers named in a service{} + block. This umode grants various features useful for services. For example, clients with this umode cannot be kicked or deopped on channels, can send to any channel, do not show channels in WHOIS, can be the target of services aliases and do not appear in /stats p. No server notices are sent for hostname changes by services clients; server notices about -kills are sent to snomask +k instead of +s. +kills are sent to snomask ``+k`` instead of ``+s``. The exact effects of this umode are variable; no user or oper on an actual charybdis server can set it. -+w, receive wallops -------------------- +``+w``, receive wallops +----------------------- - **Note** +.. note:: This is a user umode, which anybody can set. It is not + specific to operators. - This is a user umode, which anybody can set. It is not specific to - operators. - -Users with the +w umode set will receive WALLOPS messages sent by opers. -Opers with +w additionally receive WALLOPS sent by servers (e.g. remote +Users with the ``+w`` umode set will receive WALLOPS messages sent by opers. +Opers with ``+w`` additionally receive WALLOPS sent by servers (e.g. remote CONNECT, remote SQUIT, various severe misconfigurations, many services packages). -+z, receive operwall --------------------- +``+z``, receive operwall +------------------------ OPERWALL differs from WALLOPS in that the ability to receive such -messages is restricted. Opers with +z set will receive OPERWALL +messages is restricted. Opers with ``+z`` set will receive OPERWALL messages. -+Z, SSL user ------------- +``+Z``, SSL user +---------------- This umode is set on clients connected via SSL/TLS. It cannot be set or unset after initial connection. @@ -154,7 +141,7 @@ Usage is as follows: MODE nick -+s +``+s`` +/-flags To set snomasks. @@ -163,132 +150,128 @@ nick -s To clear all snomasks. -Umode +s will be set if at least one snomask is set. +Umode ``+s`` will be set if at least one snomask is set. -Umode +s is oper only by default, but even if you allow nonopers to set +Umode ``+s`` is oper only by default, but even if you allow nonopers to set it, they will not get any server notices. Meanings of server notice masks ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ -+b, bot warnings ----------------- +``+b``, bot warnings +-------------------- -Opers with the +b snomask set will receive warning messages from the +Opers with the ``+b`` snomask set will receive warning messages from the server when potential flooders and spambots are detected. -+c, client connections ----------------------- +``+c``, client connections +-------------------------- -Opers who have the +c snomask set will receive server notices when +Opers who have the ``+c`` snomask set will receive server notices when clients attach to the local server. -+C, extended client connection notices --------------------------------------- +``+C``, extended client connection notices +------------------------------------------ -Opers who have the +C snomask set will receive server notices when -clients attach to the local server. Unlike the +c snomask, the +Opers who have the ``+C`` snomask set will receive server notices when +clients attach to the local server. Unlike the ``+c`` snomask, the information is displayed in a format intended to be parsed by scripts, and includes the two unused fields of the USER command. -+d, debug ---------- +``+d``, debug +------------- -The +d snomask provides opers extra information which may be of interest +The ``+d`` snomask provides opers extra information which may be of interest to debuggers. It will also cause the user to receive server notices if certain assertions fail inside the server. Its precise meaning is variable. Do not depend on the effects of this snomask as they can and will change without notice in later revisions. -+f, full warning ----------------- +``+f``, full warning +-------------------- -Opers with the +f snomask set will receive notices when a user +Opers with the ``+f`` snomask set will receive notices when a user connection is denied because a connection limit is exceeded (one of the limits in a class{} block, or the total per-server limit settable with /quote set max). -+F, far client connection notices ---------------------------------- +``+F``, far client connection notices +------------------------------------- - **Note** +.. note:: This snomask is only available if the ``sno_farconnect.so`` + extension is loaded. - This snomask is only available if the ``sno_farconnect.so`` - extension is loaded. - -Opers with +F receive server notices when clients connect or disconnect -on other servers. The notices have the same format as those from the +c +Opers with ``+F`` receive server notices when clients connect or disconnect +on other servers. The notices have the same format as those from the ``+c`` snomask, except that the class is ? and the source server of the notice is the server the user is/was on. No notices are generated for netsplits and netjoins. Hence, these notices cannot be used to keep track of all clients on the network. -There is no far equivalent of the +C snomask. +There is no far equivalent of the ``+C`` snomask. -+k, server kill notices ------------------------ +``+k``, server kill notices +--------------------------- -Opers with the +k snomask set will receive server notices when services +Opers with the ``+k`` snomask set will receive server notices when services kill users and when other servers kill and save (forced nick change to -UID) users. Kills and saves by this server are on +d or +s. +UID) users. Kills and saves by this server are on ``+d`` or ``+s``. -+n, nick change notices ------------------------ +``+n``, nick change notices +--------------------------- -An oper with +n set will receive a server notice every time a local user +An oper with ``+n`` set will receive a server notice every time a local user changes their nick, giving the old and new nicks. This is mostly useful for bots that track all users on a single server. -+r, notices on name rejections ------------------------------- +``+r``, notices on name rejections +---------------------------------- Opers with this snomask set will receive a server notice when somebody tries to use an invalid username, or if a dumb HTTP proxy tries to connect. -+s, generic server notices --------------------------- +``+s``, generic server notices +------------------------------ This snomask allows an oper to receive generic server notices. This includes kills from opers (except services). -+u, unauthorized connections ----------------------------- +``+u``, unauthorized connections +-------------------------------- This snomask allows an oper to see when users try to connect who do not have an available auth{} block. -+W, whois notifications ------------------------ +``+W``, whois notifications +--------------------------- - **Note** +.. note:: This snomask is only available if the ``sno_whois.so`` + extension is loaded. - This snomask is only available if the ``sno_whois.so`` extension is - loaded. - -Opers with +W receive notices when a WHOIS is executed on them on their +Opers with ``+W`` receive notices when a WHOIS is executed on them on their server (showing idle time). -+x, extra routing notices -------------------------- +``+x``, extra routing notices +----------------------------- -Opers who have the +x snomask set will get notices about servers +Opers who have the ``+x`` snomask set will get notices about servers connecting and disconnecting on the whole network. This includes all servers connected behind the affected link. This can get rather noisy but is useful for keeping track of all linked servers. -+y, spy -------- +``+y``, spy +----------- -Opers with +y receive notices when users try to join RESV'ed (“juped”) +Opers with ``+y`` receive notices when users try to join RESV'ed (“juped”) channels. Additionally, if certain extension modules are loaded, they will receive notices when special commands are used. -+Z, operspy notices -------------------- +``+Z``, operspy notices +----------------------- -Opers with +Z receive notices whenever an oper anywhere on the network +Opers with ``+Z`` receive notices whenever an oper anywhere on the network uses operspy. This snomask can be configured to be only effective for admins.