4.2. User management commands

4.2.1. KILL

KILL nick [reason]

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.

4.2.2. CLOSE

Closes all connections from clients who have not completed registering.

4.2.3. KLINE

KLINE [length] [nick | user@host | user@a.b.c.d] [:reason]

Add a K:line to the local server config file to ban the given user from using that server. If a nick is given, the user@host they currently have will be banned, otherwise the ban will be directly added.

If the optional parameter length is given, the K:line will be temporary and last that long in minutes.

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.*).

All clients matching the K:line will be disconnected from the server immediately.

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.

4.2.4. UNKLINE

UNKLINE user@host

Will attempt to remove a K:line matching user@host from the config files, and will flush a temporary K:line.

4.2.5. DLINE

DLINE [nick | a.b.c.d] [:reason]

Add a D:line to the config files, which will deny any connections from the IP address of the banned client (either the address given, or the address of the user specified).

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.

D:lines are less load on a server, and may be more appropriate if somebody is flooding connections.

4.2.6. TESTLINE

[user@host | a.b.c.d]

Looks up the given hostmask or IP address and reports back on any I:, D:, G:, or K: lines found.

4.2.7. SETNAME, SETIDENT, SETHOST

SETNAME [nick] value

SETIDENT [nick] value

SETHOST [nick] [value]

Set the fullname, ident (username), or hostname associated with a particular nick for the duration of this session.

If SETHOST is used without parameters, then it will change the hostname of the user who used the command. If their hostname is currently the real hostname that was looked up when they connected, then their hostname will be changed to the spoof name from their I:line (or SPOOF_LIMIT_HOST if their I:line did not specify a spoof host). Otherwise their current hostname will be set to their real hostname. This behaviour is specific to SETHOST and not shared by SETIDENT or SETNAME.

If SETHOST, SETNAME, or SETIDENT is used with a single parameter then it will change the hostname of the user who used the command to the given value.

SETNAME may be used by anybody, at any time, to change their "real name" field.