Commit Diff
Diff:
24183b1a918d7475f9fac28a10c6ae49c93e24b3
adc8d4f6c89a11e08f5214e4ceb1323376a42ec5
Commit:
adc8d4f6c89a11e08f5214e4ceb1323376a42ec5
Tree:
9aa3fcf6a809301ce0b958ae249498ef2d12728b
Author:
Alexander Barton <alex@barton.de>
Committer:
Alexander Barton <alex@barton.de>
Date:
Fri Aug 2 21:25:23 2013 UTC
Message:
Commands.txt: Update more descriptions Update description of "CONNECT", "DIE", "DISCONNECT", "GLINE", "KILL", "KLINE", "OPER", "REHASH", "RESTART" and "WALLOPS".
blob - 49a84f654c984e8222ad7e4af92755e6b23e2331
blob + 6bbd206874745a9af0251860567976c81c88c398
--- doc/Commands.txt
+++ doc/Commands.txt
@@ -651,38 +651,62 @@ Administrative Commands
~~~~~~~~~~~~~~~~~~~~~~~
- CONNECT
- CONNECT <target server> [<port> [<remote server> [<mypwd> <peerpwd>]]]
+ CONNECT <server> [<port> [<remote-server> [<my-pwd> <peer-pwd>]]]
.
- Instructs the current server, or <remote server> if specified,
- to connect to <target server>.
+ Instructs the current server, or <remote-server> if specified,
+ to connect to the server named <server>, which must be configured
+ in the server configuration file.
.
- To connect <remote server> you need to have remote oper status.
- If <port> is omitted, it uses the server port of the configuration.
- If <mypwd> and <peerpwd> is given, it uses those passwords instead
- of the ones in the configuration.
+ To use this command, the user must be an IRC Operator. To establish
+ a connection on a <remote-server>, you must have remote IRC operator
+ privileges.
+ .
+ If <port>, <my-pwd> and <peer-pwd> are given, these values override
+ the ones specified in the server configuration file.
+ References:
+ - RFC 2812, 3.4.7 "Connect message"
+
- DIE
DIE
.
Instructs the server to shut down.
+ .
+ To use this command, the user must be an IRC Operator.
+ References:
+ - RFC 2812, 4.3 "Die message"
+
- DISCONNECT
- DISCONNECT [<remote server>]
+ DISCONNECT <server>
.
- Disconnects the current server, or <remote server> if specified.
- To disconnect a <remote server> you need to have remote oper status.
+ Disconnect and disable a locally linked server.
+ .
+ To use this command, the user must be an IRC Operator.
+ References:
+ - This command is not specified in the IRC RFCs, it is an extension
+ of ngIRCd.
+
- GLINE
- GLINE <nick!user@hostmask> <seconds> :<reason>
+ GLINE <nick!user@hostmask> [<timeout> :<reason>]
.
- This command provides timed G-Lines (Network-wide bans).
+ This command provides timed G-Lines (network-wide bans).
+ .
If a client matches a G-Line, it cannot connect to any server on
- the IRC network. If you put 0 as <seconds>, it makes the G-Line
- permanent.
+ the IRC network for <timeout> seconds. When <timoeut> is 0, it make
+ the G-Line permanent.
.
- To remove a G-Line, type "GLINE <nick!user@hostmask>".
- To list the G-Lines, type "STATS g".
+ If no <timeout> and no <reason> is given, the G-Line is removed.
+ .
+ To use this command, the user must be an IRC Operator.
+ .
+ "STATS g" can be used to list all currently active G-Lines.
+ References:
+ - This command is not specified in the IRC RFCs, it is an extension
+ of ngIRCd.
+
- KILL
KILL <nickname> <reason>
.
@@ -691,40 +715,78 @@ Administrative Commands
.
This command is used internally between servers, too, for example
to disconnect duplicate <nickname>'s after a "net split".
+ .
+ To use this command, the user must be an IRC Operator.
References:
- RFC 2812, 3.7.1 "Kill message"
- KLINE
- KLINE <nick!user@hostmask> <seconds> :<reason>
+ KLINE <nick!user@hostmask> [<timeout> :<reason>]
.
- This command provides timed K-Lines (Server-local bans).
- If a client matches a K-Line, it cannot connect to the issued server.
- If you put 0 as <seconds>, it makes the K-Line permanent.
+ This command provides timed K-Lines (server-local bans).
.
- To remove a K-Line, type "KLINE <nick!user@hostmask>".
- To list the K-Lines, type "STATS k".
+ If a client matches a K-Line, it cannot connect to this server for
+ <timeout> seconds. When <timoeut> is 0, it makes the K-Line permanent.
+ .
+ If no <timeout> and no <reason> is given, the K-Line is removed.
+ .
+ To use this command, the user must be an IRC Operator.
+ .
+ "STATS k" can be used to list all currently active K-Lines.
+ References:
+ - This command is not specified in the IRC RFCs, it is an extension
+ of ngIRCd.
+
- OPER
- OPER <user> <password>
+ OPER <name> <password>
.
- Authenticates <user> as an IRC operator on the current server/network.
+ Authenticates a user named <name> as an IRC operator on the current
+ server/network.
+ .
+ This operator <name> must be configured in the server configuration.
+ .
+ Please note that <name> is NOT related to a nickname at all!
+ References:
+ - RFC 2812, 3.1.4 "Oper message"
+
- REHASH
REHASH
.
Causes the server to re-read and re-process its configuration file(s).
+ .
+ While rehashing, no new connections are accepted, but all already
+ established connections stay connected.
+ .
+ To use this command, the user must be an IRC Operator.
+ References:
+ - RFC 2812, 4.2 "Rehash message"
+
- RESTART
RESTART
.
Restart the server.
+ .
+ While restarting, all connections are reset and no new connections
+ are accepted.
+ .
+ To use this command, the user must be an IRC Operator.
+ References:
+ - RFC 2812, 4.4 "Restart message"
+
- WALLOPS
WALLOPS <message>
.
Sends <message> to all users with user mode "+w".
+ .
+ To use this command, the user must be an IRC Operator.
+ References:
+ - RFC 2812, 4.7 "Operwall message"
IRC Service Commands
~~~~~~~~~~~~~~~~~~~~
IRCNow