Chapter 5. Operator Commands

Table of Contents
5.1. Network management commands
5.2. User management commands
5.3. Miscellaneous commands

5.1. 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.

5.1.1. CONNECT

CONNECT target [port] [source]

Initiate a connection attempt to server target. If a port is given, connect to that port on the target, otherwise use the one given in ircd.conf. If source is given, tell that server to initiate the connection attempt, otherwise it will be made from the server you are attached to.

To use the default port with source, specify 0 for port.

5.1.2. SQUIT

SQUIT server [reason]

Closes down the link to server 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.

5.1.3. REHASH

REHASH [BANS | DNS | MOTD | OMOTD | TKLINES | TDLINES | TXLINES | TRESVS | REJECTCACHE | HELP] [server]

With no parameter given, ircd.conf will be reread and parsed. The server argument is a wildcard match of server names.

Parameters

BANS

Rereads kline.conf, dline.conf, xline.conf, resv.conf and their .perm variants

DNS

Reread /etc/resolv.conf.

MOTD

Reload the MOTD file

OMOTD

Reload the operator MOTD file

TKLINES

Clears temporary K:lines.

TDLINES

Clears temporary D:lines.

TXLINES

Clears temporary X:lines.

TRESVS

Clears temporary reservations.

REJECTCACHE

Clears the client rejection cache.

HELP

Refreshes the help system cache.

5.1.4. RESTART

RESTART server

Cause an immediate total shutdown of the IRC server, and restart from 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.

5.1.5. DIE

DIE 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.

5.1.6. SET

SET [ADMINSTRING | AUTOCONN | AUTOCONNALL | FLOODCOUNT | IDENTTIMEOUT | MAX | OPERSTRING | SPAMNUM | SPAMTIME | SPLITMODE | SPLITNUM | SPLITUSERS] value

The SET command sets a runtime-configurable value.

Most of the ircd.conf equivalents have a default_ prefix and are only read on startup. SET is the only way to change these at run time.

Most of the values can be queried by omitting value.

ADMINSTRING

Sets string shown in WHOIS for admins. (umodes +o and +a set, umode +S not set).

AUTOCONN

Sets auto-connect on or off for a particular server. Takes two parameters, server name and new state.

To see these values, use /stats c. Changes to this are lost on a rehash.

AUTOCONNALL

Globally sets auto-connect on or off. If disabled, no automatic connections are done; if enabled, automatic connections are done following the rules for them.

FLOODCOUNT

The number of lines allowed to be sent to a connection before throttling it due to flooding. Note that this variable is used for both channels and clients.

For channels, op or voice overrides this; for users, IRC operator status or op or voice on a common channel overrides this.

IDENTTIMEOUT

Timeout for requesting ident from a client.

MAX

Sets the maximum number of connections to value.

This number cannot exceed maxconnections - MAX_BUFFER. maxconnections is the rlimit for number of open files. MAX_BUFFER is defined in config.h, normally 60.

MAXCLIENTS is an alias for this.

OPERSTRING

Sets string shown in WHOIS for opers (umode +o set, umodes +a and +S not set).

SPAMNUM

Sets how many join/parts to channels constitutes a possible spambot.

SPAMTIME

Below this time on a channel counts as a join/part as above.

SPLITMODE

Sets splitmode to value:

ON

splitmode is permanently on

OFF

splitmode is permanently off (default if no_create_on_split and no_join_on_split are disabled)

AUTO

ircd chooses splitmode based on SPLITUSERS and SPLITNUM (default if no_create_on_split or no_join_on_split are enabled)

SPLITUSERS

Sets the minimum amount of users needed to deactivate automatic splitmode.

SPLITNUM

Sets the minimum amount of servers needed to deactivate automatic splitmode. Only servers that have finished bursting count for this.