mirror of
https://github.com/matrix-construct/construct
synced 2024-09-02 14:55:20 +02:00
1101 lines
33 KiB
Text
1101 lines
33 KiB
Text
<chapter id="commands">
|
|
<title>Operator Commands</title>
|
|
<sect1>
|
|
<title>Network management commands</title>
|
|
<note>
|
|
<para>
|
|
Except STATS letters, all commands and names are case insensitive.
|
|
</para>
|
|
</note>
|
|
<sect2>
|
|
<title>CONNECT</title>
|
|
<cmdsynopsis><command>CONNECT</command>
|
|
<arg choice=plain><replaceable>target</replaceable></arg>
|
|
<arg><replaceable>port</replaceable></arg>
|
|
<arg><replaceable>source</replaceable></arg>
|
|
</cmdsynopsis>
|
|
<para>
|
|
Initiate a connection attempt to server <replaceable class=parameter>target</replaceable>. If a port is
|
|
given, connect to that port on the target, otherwise use the one given in <filename>ircd.conf</filename>. If
|
|
<replaceable class=parameter>source</replaceable> is given, tell that server to initiate the connection
|
|
attempt, otherwise it will be made from the server you are attached to.
|
|
</para>
|
|
</sect2>
|
|
<sect2>
|
|
<title>SQUIT</title>
|
|
<cmdsynopsis>
|
|
<command>SQUIT</command>
|
|
<arg choice=plain><replaceable>server</replaceable></arg>
|
|
<arg><replaceable>reason</replaceable></arg>
|
|
</cmdsynopsis>
|
|
<para>
|
|
Closes down the link to <replaceable>server</replaceable> from this side of the network. If a reason is
|
|
given, it will be sent out in the server notices on both sides of the link.
|
|
</para>
|
|
</sect2>
|
|
<sect2>
|
|
<title>REHASH</title>
|
|
<cmdsynopsis>
|
|
<command>REHASH</command>
|
|
<group>
|
|
<arg>BANS</arg>
|
|
<arg>DNS</arg>
|
|
<arg>MOTD</arg>
|
|
<arg>OMOTD</arg>
|
|
<arg>GLINES</arg>
|
|
<arg>PGLINES</arg>
|
|
<arg>TKLINES</arg>
|
|
<arg>TDLINES</arg>
|
|
<arg>TXLINES</arg>
|
|
<arg>TRESVS</arg>
|
|
<arg>REJECTCACHE</arg>
|
|
<arg>HELP</arg>
|
|
</group>
|
|
<arg><replaceable>server</replaceable></arg>
|
|
</cmdsynopsis>
|
|
<para>
|
|
With no parameter given, <filename>ircd.conf</filename> will be reread and parsed.
|
|
The server argument is a wildcard match of server names.
|
|
</para>
|
|
<variablelist>
|
|
<title>Parameters</title>
|
|
<varlistentry>
|
|
<term>BANS</term>
|
|
<listitem>
|
|
<para>Rereads <filename>kline.conf</filename>, <filename>dline.conf</filename>, <filename>xline.conf</filename>, <filename>resv.conf</filename> and their .perm variants</para>
|
|
</listitem>
|
|
</varlistentry>
|
|
<varlistentry>
|
|
<term>DNS</term>
|
|
<listitem>
|
|
<para>Reread <filename>/etc/resolv.conf</filename>.</para>
|
|
</listitem>
|
|
</varlistentry>
|
|
<varlistentry>
|
|
<term>MOTD</term>
|
|
<listitem>
|
|
<para>Reload the MOTD file</para>
|
|
</listitem>
|
|
</varlistentry>
|
|
<varlistentry>
|
|
<term>OMOTD</term>
|
|
<listitem>
|
|
<para>Reload the operator MOTD file</para>
|
|
</listitem>
|
|
</varlistentry>
|
|
<varlistentry>
|
|
<term>GLINES</term>
|
|
<listitem>
|
|
<para>Clears G:lines.</para>
|
|
</listitem>
|
|
</varlistentry>
|
|
<varlistentry>
|
|
<term>PGLINES</term>
|
|
<listitem>
|
|
<para>Clears pending G:lines.</para>
|
|
</listitem>
|
|
</varlistentry>
|
|
<varlistentry>
|
|
<term>TKLINES</term>
|
|
<listitem>
|
|
<para>Clears temporary K:lines.</para>
|
|
</listitem>
|
|
</varlistentry>
|
|
<varlistentry>
|
|
<term>TDLINES</term>
|
|
<listitem>
|
|
<para>Clears temporary D:lines.</para>
|
|
</listitem>
|
|
</varlistentry>
|
|
<varlistentry>
|
|
<term>TXLINES</term>
|
|
<listitem>
|
|
<para>Clears temporary X:lines.</para>
|
|
</listitem>
|
|
</varlistentry>
|
|
<varlistentry>
|
|
<term>TRESVS</term>
|
|
<listitem>
|
|
<para>Clears temporary reservations.</para>
|
|
</listitem>
|
|
</varlistentry>
|
|
<varlistentry>
|
|
<term>REJECTCACHE</term>
|
|
<listitem>
|
|
<para>Clears the client rejection cache.</para>
|
|
</listitem>
|
|
</varlistentry>
|
|
<varlistentry>
|
|
<term>HELP</term>
|
|
<listitem>
|
|
<para>Refreshes the help system cache.</para>
|
|
</listitem>
|
|
</varlistentry>
|
|
</variablelist>
|
|
</sect2>
|
|
<sect2>
|
|
<title>RESTART</title>
|
|
<cmdsynopsis>
|
|
<command>RESTART</command>
|
|
<arg choice=plain><replaceable>server</replaceable></arg>
|
|
</cmdsynopsis>
|
|
<para>
|
|
Cause an immediate total shutdown of the IRC server, and restart from scratch as if it had just been executed.
|
|
</para>
|
|
<para>
|
|
This reexecutes the ircd using the compiled-in path, visible
|
|
as SPATH in INFO.
|
|
</para>
|
|
<note>
|
|
<para>This command cannot be used remotely. The server name is used only as a safety measure.</para>
|
|
</note>
|
|
</sect2>
|
|
<sect2>
|
|
<title>DIE</title>
|
|
<cmdsynopsis>
|
|
<command>DIE</command>
|
|
<arg choice=plain><replaceable>server</replaceable></arg>
|
|
</cmdsynopsis>
|
|
<para>Immediately terminate the IRC server, after sending notices to all connected clients and servers</para>
|
|
<note>
|
|
<para>This command cannot be used remotely. The server name is used only as a safety measure.</para>
|
|
</note>
|
|
</sect2>
|
|
<sect2>
|
|
<title>SET</title>
|
|
<cmdsynopsis>
|
|
<command>SET</command>
|
|
<group>
|
|
<arg>LOG</arg>
|
|
<arg>MAX</arg>
|
|
<arg>SPLITDELAY</arg>
|
|
<arg>SMALLNET</arg>
|
|
<arg>SPAMNUM</arg>
|
|
<arg>SPAMTIME</arg>
|
|
</group>
|
|
<arg choice=plain><replaceable>value</replaceable></arg>
|
|
</cmdsynopsis>
|
|
<para>The SET command sets a runtime-configurable value</para>
|
|
<variablelist>
|
|
<varlistentry>
|
|
<term>LOG</term>
|
|
<listitem>
|
|
<para>Logging level for ircd.log and syslog</para>
|
|
</listitem>
|
|
</varlistentry>
|
|
</variablelist>
|
|
<variablelist>
|
|
<varlistentry>
|
|
<term>MAX</term>
|
|
<listitem>
|
|
<para>Set the maximum connections allowed (may not exceed the compiled-in value HARD_FDLIMIT)</para>
|
|
</listitem>
|
|
</varlistentry>
|
|
<varlistentry>
|
|
<term>DRONETIME</term>
|
|
<listitem>
|
|
<para>Number of seconds in which DRONECOUNT messages must occur to trip the drone alarm</para>
|
|
</listitem>
|
|
</varlistentry>
|
|
<varlistentry>
|
|
<term>DRONECOUNT</term>
|
|
<listitem>
|
|
<para>Number of messages which constitutes a drone flood. 0 disables drone flood checking.</para>
|
|
</listitem>
|
|
</varlistentry>
|
|
<varlistentry>
|
|
<term>SPLITDELAY</term>
|
|
<listitem>
|
|
<para>Number of minutes after a connect burst begins until joining an empty channel will give you ops</para>
|
|
</listitem>
|
|
</varlistentry>
|
|
<varlistentry>
|
|
<term>SMALLNET</term>
|
|
<listitem>
|
|
<para>Sets the number of servers which are needed to constitute <quote>attached to the network</quote>, as opposed to <quote>split</quote></para>
|
|
</listitem>
|
|
</varlistentry>
|
|
<varlistentry>
|
|
<term>SPAMNUM</term>
|
|
<listitem>
|
|
<para>Sets the number of JOINs/PARTs which constitutes a possible spambot</para>
|
|
</listitem>
|
|
</varlistentry>
|
|
<varlistentry>
|
|
<term>SPAMTIME</term>
|
|
<listitem>
|
|
<para>Staying on a channel for less than this length of time adds to the SPAMNUM count</para>
|
|
</listitem>
|
|
</varlistentry>
|
|
</variablelist>
|
|
</sect2>
|
|
</sect1>
|
|
<sect1 id="usercommands">
|
|
<title>User management commands</title>
|
|
<sect2>
|
|
<title>KILL</title>
|
|
<cmdsynopsis>
|
|
<command>KILL</command>
|
|
<arg choice=plain><replaceable>nick</replaceable></arg>
|
|
<arg><replaceable>reason</replaceable></arg>
|
|
</cmdsynopsis>
|
|
<para>
|
|
Disconnects the user with the given nick from the server they are connected to,
|
|
with the reason given, if present, and broadcast a server notice announcing this.
|
|
</para>
|
|
<para>
|
|
Your nick and the reason will appear on channels.
|
|
</para>
|
|
</sect2>
|
|
<sect2>
|
|
<title>CLOSE</title>
|
|
<para>
|
|
Closes all connections from and to clients and servers who have not completed registering.
|
|
</para>
|
|
</sect2>
|
|
<sect2>
|
|
<title>KLINE</title>
|
|
<cmdsynopsis>
|
|
<command>KLINE</command>
|
|
<arg><replaceable>length</replaceable></arg>
|
|
<group>
|
|
<arg choice=plain><replaceable>user</replaceable>@<replaceable>host</replaceable></arg>
|
|
<arg choice=plain><replaceable>user</replaceable>@<replaceable>a</replaceable>.<replaceable>b</replaceable>.<replaceable>c</replaceable>.<replaceable>d</replaceable></arg>
|
|
</group>
|
|
<arg>ON <replaceable>servername</replaceable></arg>
|
|
<arg>:<replaceable>reason</replaceable></arg>
|
|
</cmdsynopsis>
|
|
<para>
|
|
Adds a K:line to <filename>kline.conf</filename> to ban the given user@host from using that
|
|
server.
|
|
</para>
|
|
<para>
|
|
If the optional parameter <replaceable>length</replaceable> is given, the K:line will
|
|
be temporary (i.e. it will not be stored on disk) and last that
|
|
long in minutes.
|
|
</para>
|
|
<para>
|
|
If an IP address is given, the ban will be against all hosts matching that IP regardless
|
|
of DNS. The IP address can be given as a full address (192.168.0.1), as a CIDR mask
|
|
(192.168.0.0/24), or as a glob (192.168.0.*).
|
|
</para>
|
|
<para>
|
|
All clients matching the K:line will be disconnected from the server immediately.
|
|
</para>
|
|
<para>
|
|
If a reason is specified, it will be sent to the client when they are disconnected, and
|
|
whenever a connection is attempted which is banned.
|
|
</para>
|
|
<para>
|
|
If the ON part is specified, the K:line is set on servers matching
|
|
the given mask (provided a matching shared{} block exists there).
|
|
Otherwise, if specified in a cluster{} block, the K:Line will be
|
|
propagated across the network accordingly.
|
|
</para>
|
|
</sect2>
|
|
<sect2>
|
|
<title>UNKLINE</title>
|
|
<cmdsynopsis>
|
|
<command>UNKLINE</command>
|
|
<arg choice=plain><replaceable>user</replaceable>@<replaceable>host</replaceable></arg>
|
|
<arg>ON <replaceable>servername</replaceable></arg>
|
|
</cmdsynopsis>
|
|
<para>
|
|
Will attempt to remove a K:line matching user@host from <filename>kline.conf</filename>, and will flush
|
|
a temporary K:line.
|
|
</para>
|
|
</sect2>
|
|
<sect2>
|
|
<title>XLINE</title>
|
|
<cmdsynopsis>
|
|
<command>XLINE</command>
|
|
<arg><replaceable>length</replaceable></arg>
|
|
<arg choice=plain><replaceable>mask</replaceable></arg>
|
|
<arg>ON <replaceable>servername</replaceable></arg>
|
|
<arg>:<replaceable>reason</replaceable></arg>
|
|
</cmdsynopsis>
|
|
<para>
|
|
Works similarly to KLINE, but matches against the real name field.
|
|
The wildcards are * (any sequence), ? (any character),
|
|
# (a digit) and @ (a letter); wildcard characters can be
|
|
escaped with a backslash.
|
|
</para>
|
|
<para>
|
|
Use \s for a space; this currently interferes with the
|
|
check whether the mask is already xlined and UNXLINE.
|
|
</para>
|
|
<para>
|
|
All clients matching the X:line will be disconnected from the server immediately.
|
|
</para>
|
|
<para>
|
|
The reason is never sent to users. Instead, they will be exited
|
|
with <quote>Bad user info</quote>.
|
|
</para>
|
|
<para>
|
|
If the ON part is specified, the X:line is set on servers matching
|
|
the given mask (provided a matching shared{} block exists there).
|
|
Otherwise, if specified in a cluster{} block, the X:line will be
|
|
propagated across the network accordingly.
|
|
</para>
|
|
</sect2>
|
|
<sect2>
|
|
<title>UNXLINE</title>
|
|
<cmdsynopsis>
|
|
<command>UNXLINE</command>
|
|
<arg choice=plain><replaceable>mask</replaceable></arg>
|
|
<arg>ON <replaceable>servername</replaceable></arg>
|
|
</cmdsynopsis>
|
|
<para>
|
|
Will attempt to remove an X:line from <filename>xline.conf</filename>, and will flush
|
|
a temporary X:line.
|
|
</para>
|
|
</sect2>
|
|
<sect2>
|
|
<title>RESV</title>
|
|
<cmdsynopsis>
|
|
<command>RESV</command>
|
|
<arg><replaceable>length</replaceable></arg>
|
|
<group>
|
|
<arg choice=plain><replaceable>channel</replaceable></arg>
|
|
<arg choice=plain><replaceable>mask</replaceable></arg>
|
|
</group>
|
|
<arg>ON <replaceable>servername</replaceable></arg>
|
|
<arg>:<replaceable>reason</replaceable></arg>
|
|
</cmdsynopsis>
|
|
<para>
|
|
If used on a channel, <quote>jupes</quote> the channel locally. Joins to the
|
|
channel will be disallowed and generate a server notice on +y, and
|
|
users will not be able to send to the channel. Channel jupes cannot
|
|
contain wildcards.
|
|
</para>
|
|
<para>
|
|
If used on a nickname mask, prevents local users from using a nick
|
|
matching the mask (the same wildcard characters as xlines). There
|
|
is no way to exempt the initial nick from this.
|
|
</para>
|
|
<para>
|
|
In neither case will current users of the nick or channel be
|
|
kicked or disconnected.
|
|
</para>
|
|
<para>
|
|
This facility is not designed to make certain nicks
|
|
or channels oper-only.
|
|
</para>
|
|
<para>
|
|
The reason is never sent to users.
|
|
</para>
|
|
<para>
|
|
If the ON part is specified, the resv is set on servers matching
|
|
the given mask (provided a matching shared{} block exists there).
|
|
Otherwise, if specified in a cluster{} block, the resv will be
|
|
propagated across the network accordingly.
|
|
</para>
|
|
</sect2>
|
|
<sect2>
|
|
<title>UNRESV</title>
|
|
<cmdsynopsis>
|
|
<command>UNRESV</command>
|
|
<group>
|
|
<arg choice=plain><replaceable>channel</replaceable></arg>
|
|
<arg choice=plain><replaceable>mask</replaceable></arg>
|
|
</group>
|
|
<arg>ON <replaceable>servername</replaceable></arg>
|
|
</cmdsynopsis>
|
|
<para>
|
|
Will attempt to remove a resv from <filename>resv.conf</filename>, and will flush
|
|
a temporary resv.
|
|
</para>
|
|
</sect2>
|
|
<sect2>
|
|
<title>DLINE</title>
|
|
<cmdsynopsis>
|
|
<command>DLINE</command>
|
|
<arg><replaceable>length</replaceable></arg>
|
|
<arg choice=plain><replaceable>a</replaceable>.<replaceable>b</replaceable>.<replaceable>c</replaceable>.<replaceable>d</replaceable></arg>
|
|
<arg>:<replaceable>reason</replaceable></arg>
|
|
</cmdsynopsis>
|
|
<para>
|
|
Adds a D:line to <filename>dline.conf</filename>, which will deny any connections
|
|
from the given IP address.
|
|
The IP address can be given as a full address (192.168.0.1) or
|
|
as a CIDR mask (192.168.0.0/24).
|
|
</para>
|
|
<para>
|
|
If the optional parameter <replaceable>length</replaceable> is given, the D:line will
|
|
be temporary (i.e. it will not be stored on disk) and last that
|
|
long in minutes.
|
|
</para>
|
|
<para>
|
|
If a reason is specified, it will be sent to the client when they are disconnected, and,
|
|
if dline_reason is enabled,
|
|
whenever a connection is attempted which is banned.
|
|
</para>
|
|
<para>
|
|
D:lines are less load on a server, and may be more appropriate if somebody is flooding
|
|
connections.
|
|
</para>
|
|
<para>
|
|
D:lines cannot be set remotely on other servers.
|
|
</para>
|
|
<para>
|
|
Only exempt{} blocks exempt from D:lines on initial connection.
|
|
Being a server or having kline_exempt in auth{} does
|
|
<emphasis>not</emphasis> exempt (different from K/G/X:lines).
|
|
</para>
|
|
</sect2>
|
|
<sect2>
|
|
<title>UNDLINE</title>
|
|
<cmdsynopsis>
|
|
<command>UNDLINE</command>
|
|
<arg choice=plain><replaceable>a.b.c.d</replaceable></arg>
|
|
</cmdsynopsis>
|
|
<para>
|
|
Will attempt to remove a D:line from <filename>dline.conf</filename>, and will flush
|
|
a temporary D:line.
|
|
</para>
|
|
</sect2>
|
|
<sect2>
|
|
<title>GLINE</title>
|
|
<cmdsynopsis>
|
|
<command>GLINE</command>
|
|
<group>
|
|
<arg choice=plain><replaceable>user</replaceable>@<replaceable>host</replaceable></arg>
|
|
<arg choice=plain><replaceable>user</replaceable>@<replaceable>a</replaceable>.<replaceable>b</replaceable>.<replaceable>c</replaceable>.<replaceable>d</replaceable></arg>
|
|
</group>
|
|
<arg choice=plain>:<replaceable>reason</replaceable></arg>
|
|
</cmdsynopsis>
|
|
<para>
|
|
Attempts to add a network-wide ban for the given mask.
|
|
It takes three different opers on three different servers
|
|
requesting the same G:line to have it triggered for a configured
|
|
time.
|
|
</para>
|
|
<para>
|
|
Once triggered, a G:line is similar to a temporary K:line on
|
|
each server. No further propagation or on-disk storage is done.
|
|
</para>
|
|
<note><para>
|
|
This command can be enabled or disabled in the configuration file.
|
|
If it is disabled, no oper on the server can issue a G:line and no
|
|
G:lined user is banned, but G:lines are still propagated to other
|
|
servers which may have G:lines enabled.
|
|
</para></note>
|
|
</sect2>
|
|
<sect2>
|
|
<title>UNGLINE</title>
|
|
<cmdsynopsis>
|
|
<command>UNGLINE</command>
|
|
<group>
|
|
<arg choice=plain><replaceable>user</replaceable>@<replaceable>host</replaceable></arg>
|
|
<arg choice=plain><replaceable>user</replaceable>@<replaceable>a</replaceable>.<replaceable>b</replaceable>.<replaceable>c</replaceable>.<replaceable>d</replaceable></arg>
|
|
</group>
|
|
</cmdsynopsis>
|
|
<para>
|
|
Removes the given G:line on this server.
|
|
</para>
|
|
</sect2>
|
|
<sect2>
|
|
<title>TESTGECOS</title>
|
|
<cmdsynopsis>
|
|
<command>TESTGECOS</command>
|
|
<arg choice=plain><replaceable>gecos</replaceable></arg>
|
|
</cmdsynopsis>
|
|
<para>
|
|
Looks up X:Lines matching the given gecos.
|
|
</para>
|
|
</sect2>
|
|
<sect2>
|
|
<title>TESTLINE</title>
|
|
<cmdsynopsis>
|
|
<command>TESTLINE</command>
|
|
<arg><replaceable>nick</replaceable>!</arg>
|
|
<group>
|
|
<arg choice=plain><replaceable>user</replaceable>@<replaceable>host</replaceable></arg>
|
|
<arg choice=plain><replaceable>a</replaceable>.<replaceable>b</replaceable>.<replaceable>c</replaceable>.<replaceable>d</replaceable></arg>
|
|
</group>
|
|
</cmdsynopsis>
|
|
<para>
|
|
Looks up the given hostmask or IP address and reports back on any auth{} blocks, D:, G:, or K: lines found.
|
|
If <replaceable>nick</replaceable> is given, also searches for
|
|
nick resvs.
|
|
</para>
|
|
<para>
|
|
For temporary items the number of minutes until the item expires
|
|
is shown (as opposed to the hit count in STATS q/Q/x/X).
|
|
</para>
|
|
<para>
|
|
This command will not perform DNS lookups; for best
|
|
results you must testline a host and its IP form.
|
|
</para>
|
|
<para>
|
|
The given username should begin with a tilde (~) if identd is not
|
|
in use. As of charybdis 2.1.1, no_tilde and username truncation will
|
|
be taken into account like in the normal client access check.
|
|
</para>
|
|
<para>
|
|
As of charybdis 2.2.0, a channel name can be specified and the
|
|
RESV will be returned, if there is one.
|
|
</para>
|
|
</sect2>
|
|
<sect2>
|
|
<title>TESTMASK</title>
|
|
<cmdsynopsis>
|
|
<command>TESTMASK</command>
|
|
<arg choice=plain><replaceable>hostmask</replaceable></arg>
|
|
<arg><replaceable>gecos</replaceable></arg>
|
|
</cmdsynopsis>
|
|
<para>
|
|
Searches the network for users that match the hostmask and gecos given,
|
|
returning the number of matching users on this server and other servers.
|
|
</para>
|
|
<para>
|
|
The <replaceable>hostmask</replaceable> is of the form user@host
|
|
or user@ip/cidr with * and ? wildcards, optionally preceded by
|
|
nick!.
|
|
</para>
|
|
<para>
|
|
The <replaceable>gecos</replaceable> field accepts the same wildcards
|
|
as xlines.
|
|
</para>
|
|
<para>
|
|
The IP address checked against is 255.255.255.255 if the IP address
|
|
is unknown (remote client on a TS5 server) or 0 if the IP address
|
|
is hidden (auth{} spoof).
|
|
</para>
|
|
</sect2>
|
|
<sect2>
|
|
<title>LUSERS</title>
|
|
<cmdsynopsis>
|
|
<command>LUSERS</command>
|
|
<arg><replaceable>mask</replaceable></arg>
|
|
<group>
|
|
<arg><replaceable>nick</replaceable></arg>
|
|
<arg><replaceable>server</replaceable></arg>
|
|
</group>
|
|
</cmdsynopsis>
|
|
<para>
|
|
Shows various user and channel counts.
|
|
</para>
|
|
<para>
|
|
The <replaceable>mask</replaceable> parameter is obsolete
|
|
but must be used when querying a remote server.
|
|
</para>
|
|
</sect2>
|
|
<sect2>
|
|
<title>TRACE</title>
|
|
<cmdsynopsis>
|
|
<command>TRACE</command>
|
|
<group>
|
|
<arg><replaceable>server</replaceable></arg>
|
|
<arg><replaceable>nick</replaceable></arg>
|
|
</group>
|
|
<arg><replaceable>location</replaceable></arg>
|
|
</cmdsynopsis>
|
|
<para>
|
|
With no argument or one argument which is the current server,
|
|
TRACE gives a list of all connections to the current server
|
|
and a summary of connection classes.
|
|
</para>
|
|
<para>
|
|
With one argument which is another server, TRACE displays the path
|
|
to the specified server, and all servers, opers and -i users
|
|
on that server, along with a summary of connection classes.
|
|
</para>
|
|
<para>
|
|
With one argument which is a client, TRACE displays the
|
|
path to that client, and that client's information.
|
|
</para>
|
|
<para>
|
|
If location is given, the command is executed on that server;
|
|
no path is displayed.
|
|
</para>
|
|
<para>
|
|
When listing connections, type, name and class is shown
|
|
in addition to information depending on the type:
|
|
</para>
|
|
<variablelist>
|
|
<title>TRACE types</title>
|
|
<varlistentry>
|
|
<term>Try.</term>
|
|
<listitem><para>
|
|
A server we are trying to make a TCP connection to.
|
|
</para></listitem>
|
|
</varlistentry>
|
|
<varlistentry>
|
|
<term>H.S.</term>
|
|
<listitem><para>
|
|
A server we have established a TCP connection to, but is not
|
|
yet registered.
|
|
</para></listitem>
|
|
</varlistentry>
|
|
<varlistentry>
|
|
<term>????</term>
|
|
<listitem><para>
|
|
An incoming connection that has not yet registered as
|
|
a user or a server (<quote>unknown</quote>).
|
|
Shows the username, hostname, IP address
|
|
and the time the connection has been open. It is possible
|
|
that the ident or DNS lookups have not completed yet, and in
|
|
any case no tildes are shown here.
|
|
Unknown connections may not have a name yet.
|
|
</para></listitem>
|
|
</varlistentry>
|
|
<varlistentry>
|
|
<term>User</term>
|
|
<listitem><para>
|
|
A registered unopered user.
|
|
Shows the username, hostname, IP address, the time the client
|
|
has not sent anything (as in STATS l) and the time the user has
|
|
been idle (from PRIVMSG only, as in WHOIS).
|
|
</para></listitem>
|
|
</varlistentry>
|
|
<varlistentry>
|
|
<term>Oper</term>
|
|
<listitem><para>
|
|
Like User, but opered.
|
|
</para></listitem>
|
|
</varlistentry>
|
|
<varlistentry>
|
|
<term>Serv</term>
|
|
<listitem><para>
|
|
A registered server.
|
|
Shows the number of servers and users reached via this link,
|
|
who made this connection and the time the server has not sent
|
|
anything.
|
|
</para></listitem>
|
|
</varlistentry>
|
|
</variablelist>
|
|
</sect2>
|
|
<sect2>
|
|
<title>ETRACE</title>
|
|
<cmdsynopsis>
|
|
<command>ETRACE</command>
|
|
<arg><replaceable>nick</replaceable></arg>
|
|
</cmdsynopsis>
|
|
<para>
|
|
Shows client information about the given target, or about all local clients if
|
|
no target is specified.
|
|
</para>
|
|
</sect2>
|
|
<sect2>
|
|
<title>MASKTRACE</title>
|
|
<cmdsynopsis>
|
|
<command>MASKTRACE</command>
|
|
<arg choice=plain><replaceable>hostmask</replaceable></arg>
|
|
<arg><replaceable>gecos</replaceable></arg>
|
|
</cmdsynopsis>
|
|
<para>
|
|
Searches the local server or network for users that match the hostmask and gecos given.
|
|
Network searches require the oper_spy privilege and an '!'
|
|
before the hostmask.
|
|
The matching works the same way as TESTMASK.
|
|
</para>
|
|
<para>
|
|
The <replaceable>hostmask</replaceable> is of the form user@host
|
|
or user@ip/cidr with * and ? wildcards, optionally preceded by
|
|
nick!.
|
|
</para>
|
|
<para>
|
|
The <replaceable>gecos</replaceable> field accepts the same wildcards
|
|
as xlines.
|
|
</para>
|
|
<para>
|
|
The IP address field contains 255.255.255.255 if the IP address
|
|
is unknown (remote client on a TS5 server) or 0 if the IP address
|
|
is hidden (auth{} spoof).
|
|
</para>
|
|
</sect2>
|
|
<sect2>
|
|
<title>CHANTRACE</title>
|
|
<cmdsynopsis>
|
|
<command>CHANTRACE</command>
|
|
<arg choice=plain><replaceable>channel</replaceable></arg>
|
|
</cmdsynopsis>
|
|
<para>
|
|
Displays information about users in a channel.
|
|
Opers with the oper_spy privilege
|
|
can get the information without being on the channel,
|
|
by prefixing the channel name with an '!'.
|
|
</para>
|
|
<para>
|
|
The IP address field contains 255.255.255.255 if the IP address
|
|
is unknown (remote client on a TS5 server) or 0 if the IP address
|
|
is hidden (auth{} spoof).
|
|
</para>
|
|
</sect2>
|
|
<sect2>
|
|
<title>SCAN</title>
|
|
<cmdsynopsis>
|
|
<command>SCAN UMODES</command>
|
|
<arg choice=plain>+<replaceable>modes</replaceable>-<replaceable>modes</replaceable></arg>
|
|
<arg>no-list</arg>
|
|
<arg>list</arg>
|
|
<arg>global</arg>
|
|
<arg>list-max <replaceable>number</replaceable></arg>
|
|
<arg>mask <replaceable>nick!user@host</replaceable></arg>
|
|
</cmdsynopsis>
|
|
<para>
|
|
Searches the local server or network for users that have the umodes given with + and do not have the umodes given with -.
|
|
no-list disables the listing of matching users and only shows the count.
|
|
list enables the listing (default).
|
|
global extends the search to the entire network instead of local users only.
|
|
list-max limits the listing of matching users to the given amount.
|
|
mask causes only users matching the given nick!user@host mask
|
|
to be selected. Only the displayed host is considered, not the
|
|
IP address or real host behind dynamic spoofs.
|
|
</para>
|
|
<para>
|
|
The IP address field contains 255.255.255.255 if the IP address
|
|
is unknown (remote client on a TS5 server) or 0 if the IP address
|
|
is hidden (auth{} spoof).
|
|
</para>
|
|
<para>
|
|
Network searches where a listing is given or the mask option is used
|
|
are operspy commands.
|
|
</para>
|
|
</sect2>
|
|
<sect2>
|
|
<title>CHGHOST</title>
|
|
<cmdsynopsis>
|
|
<command>CHGHOST</command>
|
|
<arg choice=plain><replaceable>nick</replaceable></arg>
|
|
<arg choice=plain><replaceable>value</replaceable></arg>
|
|
</cmdsynopsis>
|
|
<para>
|
|
Set the hostname associated with a particular nick for the duration of this session.
|
|
This command is disabled by default because of the abuse potential
|
|
and little practical use.
|
|
</para>
|
|
</sect2>
|
|
</sect1>
|
|
<sect1 id="misccommands">
|
|
<title>Miscellaneous commands</title>
|
|
<sect2>
|
|
<title>ADMIN</title>
|
|
<cmdsynopsis>
|
|
<command>ADMIN</command>
|
|
<group>
|
|
<arg><replaceable>nick</replaceable></arg>
|
|
<arg><replaceable>server</replaceable></arg>
|
|
</group>
|
|
</cmdsynopsis>
|
|
<para>
|
|
Shows the information in the admin{} block.
|
|
</para>
|
|
</sect2>
|
|
<sect2>
|
|
<title>INFO</title>
|
|
<cmdsynopsis>
|
|
<command>INFO</command>
|
|
<group>
|
|
<arg><replaceable>nick</replaceable></arg>
|
|
<arg><replaceable>server</replaceable></arg>
|
|
</group>
|
|
</cmdsynopsis>
|
|
<para>
|
|
Shows information about the authors of the IRC server, and
|
|
some information about this server instance.
|
|
Opers also get a list of configuration options.
|
|
</para>
|
|
</sect2>
|
|
<sect2>
|
|
<title>TIME</title>
|
|
<cmdsynopsis>
|
|
<command>TIME</command>
|
|
<group>
|
|
<arg><replaceable>nick</replaceable></arg>
|
|
<arg><replaceable>server</replaceable></arg>
|
|
</group>
|
|
</cmdsynopsis>
|
|
<para>
|
|
Shows the local time on the given server, in a human-readable format.
|
|
</para>
|
|
</sect2>
|
|
<sect2>
|
|
<title>VERSION</title>
|
|
<cmdsynopsis>
|
|
<command>VERSION</command>
|
|
<group>
|
|
<arg><replaceable>nick</replaceable></arg>
|
|
<arg><replaceable>server</replaceable></arg>
|
|
</group>
|
|
</cmdsynopsis>
|
|
<para>
|
|
Shows version information, a few compile/config options,
|
|
the SID and the 005 numerics.
|
|
The 005 numeric will be remapped to 105 for remote requests.
|
|
</para>
|
|
</sect2>
|
|
<sect2>
|
|
<title>STATS</title>
|
|
<cmdsynopsis>
|
|
<command>STATS</command>
|
|
<arg><replaceable>type</replaceable></arg>
|
|
<group>
|
|
<arg><replaceable>nick</replaceable></arg>
|
|
<arg><replaceable>server</replaceable></arg>
|
|
</group>
|
|
</cmdsynopsis>
|
|
<para>
|
|
Display various statistics and configuration information.
|
|
</para>
|
|
<variablelist>
|
|
<title>Values for <replaceable>type</replaceable></title>
|
|
<varlistentry>
|
|
<term>A</term>
|
|
<listitem>
|
|
<para>Show DNS servers</para>
|
|
</listitem>
|
|
</varlistentry>
|
|
<varlistentry>
|
|
<term>b</term>
|
|
<listitem>
|
|
<para>Show active nick delays</para>
|
|
</listitem>
|
|
</varlistentry>
|
|
<varlistentry>
|
|
<term>B</term>
|
|
<listitem>
|
|
<para>Show hash statistics</para>
|
|
</listitem>
|
|
</varlistentry>
|
|
<varlistentry>
|
|
<term>c</term>
|
|
<listitem>
|
|
<para>Show connect blocks</para>
|
|
</listitem>
|
|
</varlistentry>
|
|
<varlistentry>
|
|
<term>d</term>
|
|
<listitem>
|
|
<para>Show temporary D:lines</para>
|
|
</listitem>
|
|
</varlistentry>
|
|
<varlistentry>
|
|
<term>D</term>
|
|
<listitem>
|
|
<para>Show permanent D:lines</para>
|
|
</listitem>
|
|
</varlistentry>
|
|
<varlistentry>
|
|
<term>e</term>
|
|
<listitem>
|
|
<para>Show exempt blocks (exceptions to D:lines)</para>
|
|
</listitem>
|
|
</varlistentry>
|
|
<varlistentry>
|
|
<term>E</term>
|
|
<listitem>
|
|
<para>Show events</para>
|
|
</listitem>
|
|
</varlistentry>
|
|
<varlistentry>
|
|
<term>f</term>
|
|
<listitem>
|
|
<para>Show file descriptors</para>
|
|
</listitem>
|
|
</varlistentry>
|
|
<varlistentry>
|
|
<term>g</term>
|
|
<listitem>
|
|
<para>Show pending glines</para>
|
|
</listitem>
|
|
</varlistentry>
|
|
<varlistentry>
|
|
<term>G</term>
|
|
<listitem>
|
|
<para>Show active glines</para>
|
|
</listitem>
|
|
</varlistentry>
|
|
<varlistentry>
|
|
<term>h</term>
|
|
<listitem>
|
|
<para>Show hub_mask/leaf_mask</para>
|
|
</listitem>
|
|
</varlistentry>
|
|
<varlistentry>
|
|
<term>i</term>
|
|
<listitem>
|
|
<para>Show auth blocks, or matched auth blocks</para>
|
|
</listitem>
|
|
</varlistentry>
|
|
<varlistentry>
|
|
<term>k</term>
|
|
<listitem>
|
|
<para>Show temporary K:lines, or matched temporary K:lines</para>
|
|
</listitem>
|
|
</varlistentry>
|
|
<varlistentry>
|
|
<term>K</term>
|
|
<listitem>
|
|
<para>Show permanent K:lines, or matched permanent K:lines</para>
|
|
</listitem>
|
|
</varlistentry>
|
|
<varlistentry>
|
|
<term>l</term>
|
|
<listitem>
|
|
<para>
|
|
Show hostname and link information about the given nick.
|
|
With a server name, show information about opers and servers
|
|
on that server; opers also get information about all local users
|
|
if they query their own server.
|
|
</para>
|
|
</listitem>
|
|
</varlistentry>
|
|
<varlistentry>
|
|
<term>L</term>
|
|
<listitem>
|
|
<para>Like l, but show IP address instead of hostname</para>
|
|
</listitem>
|
|
</varlistentry>
|
|
<varlistentry>
|
|
<term>m</term>
|
|
<listitem>
|
|
<para>Show commands and their usage statistics (total counts, total bytes, counts from server connections)</para>
|
|
</listitem>
|
|
</varlistentry>
|
|
<varlistentry>
|
|
<term>n</term>
|
|
<listitem>
|
|
<para>Show blacklist blocks (DNS blacklists) with hit counts.</para>
|
|
</listitem>
|
|
</varlistentry>
|
|
<varlistentry>
|
|
<term>o</term>
|
|
<listitem>
|
|
<para>Show operator blocks</para>
|
|
</listitem>
|
|
</varlistentry>
|
|
<varlistentry>
|
|
<term>p</term>
|
|
<listitem>
|
|
<para>Show logged on network operators which are not set AWAY.</para>
|
|
</listitem>
|
|
</varlistentry>
|
|
<varlistentry>
|
|
<term>P</term>
|
|
<listitem>
|
|
<para>Show listen blocks</para>
|
|
</listitem>
|
|
</varlistentry>
|
|
<varlistentry>
|
|
<term>q</term>
|
|
<listitem>
|
|
<para>Show temporarily resv'ed nicks and channels</para>
|
|
</listitem>
|
|
</varlistentry>
|
|
<varlistentry>
|
|
<term>Q</term>
|
|
<listitem>
|
|
<para>Show permanently resv'ed nicks and channels</para>
|
|
</listitem>
|
|
</varlistentry>
|
|
<varlistentry>
|
|
<term>r</term>
|
|
<listitem>
|
|
<para>Show resource usage by the ircd</para>
|
|
</listitem>
|
|
</varlistentry>
|
|
<varlistentry>
|
|
<term>t</term>
|
|
<listitem>
|
|
<para>Show generic server statistics</para>
|
|
</listitem>
|
|
</varlistentry>
|
|
<varlistentry>
|
|
<term>u</term>
|
|
<listitem>
|
|
<para>Show server uptime</para>
|
|
</listitem>
|
|
</varlistentry>
|
|
<varlistentry>
|
|
<term>U</term>
|
|
<listitem>
|
|
<para>Show shared (c), cluster (C) and service (s) blocks</para>
|
|
</listitem>
|
|
</varlistentry>
|
|
<varlistentry>
|
|
<term>v</term>
|
|
<listitem>
|
|
<para>Show connected servers and brief status</para>
|
|
</listitem>
|
|
</varlistentry>
|
|
<varlistentry>
|
|
<term>x</term>
|
|
<listitem>
|
|
<para>Show temporary X:lines</para>
|
|
</listitem>
|
|
</varlistentry>
|
|
<varlistentry>
|
|
<term>X</term>
|
|
<listitem>
|
|
<para>Show permanent X:lines</para>
|
|
</listitem>
|
|
</varlistentry>
|
|
<varlistentry>
|
|
<term>y</term>
|
|
<listitem>
|
|
<para>Show class blocks</para>
|
|
</listitem>
|
|
</varlistentry>
|
|
<varlistentry>
|
|
<term>z</term>
|
|
<listitem>
|
|
<para>Show memory usage statistics</para>
|
|
</listitem>
|
|
</varlistentry>
|
|
<varlistentry>
|
|
<term>Z</term>
|
|
<listitem>
|
|
<para>Show ziplinks statistics</para>
|
|
</listitem>
|
|
</varlistentry>
|
|
<varlistentry>
|
|
<term>?</term>
|
|
<listitem>
|
|
<para>Show connected servers and sendq information about them</para>
|
|
</listitem>
|
|
</varlistentry>
|
|
</variablelist>
|
|
</sect2>
|
|
<sect2>
|
|
<title>WALLOPS</title>
|
|
<cmdsynopsis>
|
|
<command>WALLOPS</command>
|
|
<arg choice=plain>:<replaceable>message</replaceable></arg>
|
|
</cmdsynopsis>
|
|
<para>
|
|
Sends a WALLOPS message to all users who have the +w umode set. This is for
|
|
things you don't mind the whole network knowing about.
|
|
</para>
|
|
</sect2>
|
|
<sect2>
|
|
<title>OPERWALL</title>
|
|
<cmdsynopsis>
|
|
<command>OPERWALL</command>
|
|
<arg choice=plain>:<replaceable>message</replaceable></arg>
|
|
</cmdsynopsis>
|
|
<para>
|
|
Sends an OPERWALL message to all opers who have the +z umode set. +z is restricted,
|
|
OPERWALL should be considered private communications.
|
|
</para>
|
|
</sect2>
|
|
</sect1>
|
|
</chapter>
|
|
<!-- Keep this comment at the end of the file
|
|
Local variables:
|
|
mode: sgml
|
|
sgml-omittag:t
|
|
sgml-shorttag:t
|
|
sgml-namecase-general:t
|
|
sgml-general-insert-case:lower
|
|
sgml-minimize-attributes:nil
|
|
sgml-always-quote-attributes:t
|
|
sgml-indent-step:2
|
|
sgml-indent-data:t
|
|
sgml-parent-document: ("charybdis-oper-guide.sgml" "book")
|
|
sgml-exposed-tags:nil
|
|
sgml-local-ecat-files:nil
|
|
fill-column:105
|
|
End:
|
|
-->
|