diff --git a/doc/oper-guide/oprivs.rst b/doc/oper-guide/oprivs.rst index ca25dfd4..50768f5e 100644 --- a/doc/oper-guide/oprivs.rst +++ b/doc/oper-guide/oprivs.rst @@ -12,13 +12,13 @@ things, this automatically sets umode +a and allows loading modules. oper:die, die and restart ------------------------- -This grants permission to use DIE and RESTART, shutting down or +This grants permission to use ``DIE`` and ``RESTART``, shutting down or restarting the server. oper:global\_kill, global kill ------------------------------ -Allows using KILL on users on any server. +Allows using ``KILL`` on users on any server. oper:hidden, hide from /stats p ------------------------------- @@ -36,40 +36,40 @@ possessed, umode +a can still not be used. oper:kline, kline and dline --------------------------- -Allows using KLINE and DLINE, to ban users by user@host mask or IP +Allows using ``KLINE`` and ``DLINE``, to ban users by user@host mask or IP address. oper:local\_kill, kill local users ---------------------------------- -This grants permission to use KILL on users on the same server, +This grants permission to use ``KILL`` on users on the same server, disconnecting them from the network. oper:mass\_notice, global notices and wallops --------------------------------------------- -Allows using server name ($$mask) and hostname ($#mask) masks in NOTICE -and PRIVMSG to send a message to all matching users, and allows using -the WALLOPS command to send a message to all users with umode +w set. +Allows using server name ($$mask) and hostname ($#mask) masks in ``NOTICE`` +and ``PRIVMSG`` to send a message to all matching users, and allows using +the ``WALLOPS`` command to send a message to all users with umode +w set. oper:operwall, send/receive operwall ------------------------------------ -Allows using the OPERWALL command and umode +z to send and receive +Allows using the ``OPERWALL`` command and umode +z to send and receive operwalls. oper:rehash, rehash ------------------- -Allows using the REHASH command, to rehash various configuration files +Allows using the ``REHASH`` command, to rehash various configuration files or clear certain lists. oper:remoteban, set remote bans ------------------------------- -This grants the ability to use the ON argument on DLINE/KLINE/XLINE/RESV -and UNDLINE/UNKLINE/UNXLINE/UNRESV to set and unset bans on other -servers, and the server argument on REHASH. This is only allowed if the +This grants the ability to use the ON argument on ``DLINE``/``KLINE``/``XLINE``/``RESV`` +and ``UNDLINE``/``UNKLINE``/``UNXLINE``/``UNRESV`` to set and unset bans on other +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. @@ -85,40 +85,40 @@ This allows using /resv, /unresv and changing the channel modes +L and oper:routing, remote routing ---------------------------- -This allows using the third argument of the CONNECT command, to instruct -another server to connect somewhere, and using SQUIT with an argument +This allows using the third argument of the ``CONNECT`` command, to instruct +another server to connect somewhere, and using ``SQUIT`` with an argument that is not locally connected. (In both cases all opers with +w set will be notified.) oper:spy, use operspy --------------------- -This allows using /mode !#channel, /whois !nick, /who !#channel, -/chantrace !#channel, /topic !#channel, /who !mask, /masktrace -!user@host :gecos and /scan umodes +modes-modes global list to see +This allows using ``/mode !#channel``, ``/whois !nick``, ``/who !#channel``, +``/chantrace !#channel``, ``/topic !#channel``, ``/who !mask``, ``/masktrace +!user@host :gecos`` and ``/scan umodes +modes-modes global list`` to see through secret channels, invisible users, etc. -All operspy usage is broadcasted to opers with snomask +Z set (on the +All operspy usage is broadcasted to opers with snomask ``+Z`` set (on the entire network) and optionally logged. If you grant this to anyone, it is a good idea to establish concrete policies describing what it is to be used for, and what not. -If operspy\_dont\_care\_user\_info is enabled, /who mask is operspy -also, and /who !mask, /who mask, /masktrace !user@host :gecos and /scan -umodes +modes-modes global list do not generate +Z notices or logs. +If ``operspy_dont_care_user_info`` is enabled, ``/who mask`` is operspy +also, and ``/who !mask``, ``/who mask``, ``/masktrace !user@host :gecos`` and ``/scan +umodes +modes-modes global list`` do not generate ``+Z`` notices or logs. oper:unkline, unkline and undline --------------------------------- -Allows using UNKLINE and UNDLINE. +Allows using ``UNKLINE`` and ``UNDLINE``. oper:xline, xline and unxline ----------------------------- -Allows using XLINE and UNXLINE, to ban/unban users by realname. +Allows using ``XLINE`` and ``UNXLINE``, to ban/unban users by realname. snomask:nick\_changes, see nick changes --------------------------------------- -Allows using snomask +n to see local client nick changes. This is +Allows using snomask ``+n`` to see local client nick changes. This is designed for monitor bots.