Commit Diff
Diff:
7630e8ffc636045b94699e36127bdd601137ba0e
73fded75150a72c68b4c382d90e6d7c3374d5f6c
Commit:
73fded75150a72c68b4c382d90e6d7c3374d5f6c
Tree:
7d50ae81768375f865275cacb0d1702b77547cbc
Author:
Alexander Barton <alex@barton.de>
Committer:
Alexander Barton <alex@barton.de>
Date:
Wed Jan 23 14:16:33 2013 UTC
Message:
Commands.txt: Import descriptions from "rbose/command_help" Import command description texts from the "rbose/command_help" branch, which have been written by DNS -- thanks a lot!
blob - c879092930b1995286cd54c913cdfc82b0637af0
blob + c6e063785a8fb32f73574c25ebb7e7115b5b7acd
--- doc/Commands.txt
+++ doc/Commands.txt
@@ -46,16 +46,35 @@ Connection Handling Commands
~~~~~~~~~~~~~~~~~~~~~~~~~~~~
- CAP
+ See doc/Capabilities.txt
- CHARCONV
+ See doc/Protocol.txt
- NICK
+ NICK <nick>
+ .
+ Change your nickname to <nick>.
- PASS
+ PASS <password> <version> <flags> [<options>]
+ .
+ Set a connection <password>. This command must be sent before the
+ NICK/USER registration combination.
+ .
+ See doc/Protocol.txt for more info.
- PING
+ PING <server1> [<server2>]
+ .
+ Tests the presence of a connection. A PING message results in a PONG
+ reply. If <server2> is specified, the message gets passed on to it.
- PONG
+ PONG <server1> [<server2>]
+ .
+ This command is a reply to the PING command and works in much the
+ same way.
- QUIT
QUIT [<quit-message>]
@@ -66,14 +85,28 @@ Connection Handling Commands
channels that you are a member of when leaving.
- USER
+ USER <user> <modes> <realname>
+ .
+ This command is used at the beginning of a connection to specify the
+ <user>name, hostname, <realname> and initial user <modes> of the
+ connecting client.
+ .
+ <realname> may contain spaces, and thus must be prefixed with a colon.
- WEBIRC
+ See doc/Protocol.txt
General Commands
~~~~~~~~~~~~~~~~
- AWAY
+ AWAY [<message>]
+ .
+ Provides the server with a message to automatically send in reply to a
+ PRIVMSG directed at the user, but not to a channel they are on.
+ .
+ If <message> is omitted, the away status is removed.
- HELP
HELP [<command>]
@@ -93,10 +126,29 @@ General Commands
- MODE
+ MODE <nickname> <flags> (user)
+ MODE <channel> <flags> [<args>]
+ .
+ The MODE command is dual-purpose. It can be used to set both (user) and
+ <channel> modes.
+ .
+ See doc/Modes.txt for more information.
- NOTICE
+ NOTICE <target> <notice>
+ .
+ Send <notice> to <target> (nick or channel).
+ .
+ This command works similarly to PRIVMSG, except automatic replies must
+ never be sent in reply to NOTICE messages.
- PRIVMSG
+ PRIVMSG <target> <message>
+ .
+ Send <message> to <target> (nick or channel).
+ .
+ Common IRC clients use MSG as PRIVMSG alias.
+ (Some clients use "QUERY <nick> [<message>]" to open a private chat.)
Status and Informational Commands
@@ -109,72 +161,239 @@ Status and Informational Commands
If no server name has been given, the local server will respond.
- INFO
+ INFO [<server>]
+ .
+ Show the version, birth & online time of the current IRC server.
+ If <server> has been given, it shows the INFO of the specific <server>.
- ISON
+ ISON <nicknames>
+ .
+ Queries the server to see if the clients in the space-separated list
+ <nicknames> are currently on the network.
+ .
+ The server returns only the <nicknames> that are on the network in a
+ space-separated list. If none of the clients are on the network the
+ server returns an empty list.
- LINKS
+ LINKS [<remote server> [<server mask>]]
+ .
+ Lists all server links matching <server mask>, if given,
+ on <remote server>, or the current server if omitted.
- LUSERS
+ LUSERS [<mask> [<server>]]
+ .
+ Return statistics about the size of the network. If called with no
+ arguments, the statistics will reflect the entire network.
+ .
+ If <mask> is given, it will return only statistics reflecting the
+ masked subset of the network.
+ If <server> is given, the command will be forwarded to <server>
+ for evaluation.
- MOTD
+ MOTD [<server>]
+ .
+ Show "Message Of The Day" of the current server or specified <server>.
- NAMES
+ NAMES [<channels> [<server>]]
+ .
+ Returns a list of who is on the comma-separated list of <channels>,
+ by channel name.
+ .
+ If <channels> is omitted, all users are shown, grouped by channel name
+ with all users who are not on a channel being shown as part of channel
+ "*".
+ If <server> is specified, the command is sent to <server> for
+ evaluation.
- STATS
+ STATS <flag> [<server>]
+ .
+ Returns statistics about the current server, or of a specified <server>.
+ .
+ STATS flags:
+ .
+ g = G-Lines (Network-wide bans)
+ k = K-Lines (Server-local bans)
+ l = Link status (Parent server and own link)
+ m = IRC command status (usage count)
+ u = Server uptime
- TIME
+ TIME [<server>]
+ .
+ Show the local time of the current server, or of a specified <server>.
- TRACE
+ TRACE [<server>]
+ .
+ Trace a path across the IRC network of the current server, or if given
+ of a specific <server>, in a similar method to traceroute.
- USERHOST
+ USERHOST <nicknames>
+ .
+ Show the user-host of <nicknames> (seperated by space).
+ "-" means <nick> is away,
+ "+" means <nick> is available,
+ "*" indicates your connection.
- VERSION
+ VERSION [<server>]
+ .
+ Show the ngIRCd version of the current server, or specified <server>.
- WHO
+ WHO [<target> ["o"]]
+ .
+ Returns a list of users who match <target> (nick, hostmask or channel).
+ .
+ If the flag "o" is given, the server will only return information about
+ IRC Operators.
- WHOIS
+ WHOIS [<server>] <nicknames>
+ .
+ Returns information about the comma-separated list of <nicknames>.
+ .
+ If <server> is given, the command is forwarded to it for processing.
- WHOWAS
+ WHOWAS <nickname> [<count> [<server>]]
+ .
+ Used to return information about <nicknames> that are no longer in use
+ (due to client disconnection, or nickname changes).
+ .
+ If given, the server will return information from the last <count> times
+ the nickname has been used.
+ If <server> is given, the command is forwarded to it for processing.
Channel Commands
~~~~~~~~~~~~~~~~
- INVITE
+ INVITE <nick> <channel>
+ .
+ Invites <nick> to <channel>.
+ <channel> does not have to exist, but if it does, only members of the
+ channel are allowed to invite other clients.
+ .
+ If the <channel> mode "+i" is set, only <channel> operators may invite
+ other clients.
- JOIN
+ JOIN <channels> [<channel-keys>]
+ .
+ Makes the client join the <channels> (comma-separated list), specifying
+ the passwords, if needed, in the comma-separated <channel-keys> list.
+ A <channel-key> is only needed, if the <channel> mode "+k" is set.
+ .
+ If the channel(s) do not exist, then they will be created.
- KICK
+ KICK <channel> <nick> [<kick-message>]
+ .
+ Remove <nick> from <channel>, optional with a <kick-message>.
+ .
+ Only <channel> operators are able to KICK.
- LIST
+ LIST [<channels> [<server>]]
+ .
+ List all visible <channels> (comma-seperated list) on the current
+ server.
+ If <server> is given, the command will be forwarded to <server> for
+ evaluation.
- PART
+ PART <channels> [<part-message>]
+ .
+ Leave <channels> (comma-separated list), optional with a
+ <part-message>.
- TOPIC
+ TOPIC <channel> <topic>
+ .
+ Set a <topic> for <channel>.
+ .
+ Only <channel> operators are able to set a <topic>.
Administrative Commands
~~~~~~~~~~~~~~~~~~~~~~~
- CONNECT
+ CONNECT <target server> [<port> [<remote server> [<mypwd> <peerpwd>]]]
+ .
+ Instructs the current server, or <remote server> if specified,
+ to connect to <target server>.
+ .
+ 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.
- DIE
+ DIE
+ .
+ Instructs the server to shut down.
- DISCONNECT
+ DISCONNECT [<remote server>]
+ .
+ Disconnects the current server, or <remote server> if specified.
+ To disconnect a <remote server> you need to have remote oper status.
- GLINE
+ GLINE <nick!user@hostmask> <seconds> :<reason>
+ .
+ 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.
+ .
+ To remove a G-Line, type "GLINE <nick!user@hostmask>".
+ To list the G-Lines, type "STATS g".
- KILL
+ KILL <nick> <reason>
+ .
+ Forcibly removes <nick> from the IRC network with a <reason>.
- KLINE
+ KLINE <nick!user@hostmask> <seconds> :<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.
+ .
+ To remove a K-Line, type "KLINE <nick!user@hostmask>".
+ To list the K-Lines, type "STATS k".
- OPER
+ OPER <user> <password>
+ .
+ Authenticates <user> as an IRC operator on the current server/network.
- REHASH
+ REHASH
+ .
+ Causes the server to re-read and re-process its configuration file(s).
- RESTART
+ RESTART
+ .
+ Restart the server.
- WALLOPS
+ WALLOPS <message>
+ .
+ Sends <message> to all users with user mode "+w".
IRC Service Commands
@@ -193,6 +412,12 @@ Server Protocol Commands
~~~~~~~~~~~~~~~~~~~~~~~~
- CHANINFO
+ CHANINFO <channel> +<modes> [[<key> <limit>] <topic>]
+ .
+ CHANINFO is used by servers to inform each other about a channel:
+ its modes, channel key, user limits and its topic.
+ .
+ See doc/Protocol.txt for more information.
- ERROR
ERROR [<message> [<> [...]]]
@@ -204,12 +429,22 @@ Server Protocol Commands
This command is silently ignored on non-server and non-service links.
- METADATA
+ METADATA <target> <key> <value>
+ .
+ The METADATA command is used on server-links to update "metadata"
+ information of clients, like the hostname, the info text ("real name"),
+ or the user name.
+ .
+ See doc/Protocol.txt for more information.
- NJOIN
- SERVER
- SQUIT
+ SQUIT <server>
+ .
+ Disconnects an IRC Server from the network.
Dummy Commands
IRCNow