Module: ngircd.git Branch: master Commit: 73fded75150a72c68b4c382d90e6d7c3374d5f6c URL: http://ngircd.barton.de/cgi-bin/gitweb.cgi?p=ngircd.git&a=commit;h=73fde...

Author: Alexander Barton alex@barton.de Date: Wed Jan 23 15:16:33 2013 +0100

Commands.txt: Import descriptions from "rbose/command_help"

Import command description texts from the "rbose/command_help" branch, which have been written by DNS dns@rbose.org -- thanks a lot!

---

doc/Commands.txt | 235 ++++++++++++++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 235 insertions(+)

diff --git a/doc/Commands.txt b/doc/Commands.txt index c879092..c6e0637 100644 --- a/doc/Commands.txt +++ b/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