X-Git-Url: https://arthur.barton.de/cgi-bin/gitweb.cgi?a=blobdiff_plain;f=doc%2FCommands.txt;h=4058f3dfe8febbbe2a709da4bec030c1ebeb18a9;hb=11240376a5008dea9e970f40df659931d1321e8b;hp=642dfb0b09db8a360b7627090396f3475217f00c;hpb=b6e6e2e1da632a022abf7530ed028ba79d453614;p=ngircd-alex.git diff --git a/doc/Commands.txt b/doc/Commands.txt index 642dfb0b..4058f3df 100644 --- a/doc/Commands.txt +++ b/doc/Commands.txt @@ -210,7 +210,7 @@ Status and Informational Commands . can be a server name, the nickname of a client connected to a specific server, or a mask matching a server name in the network. - The server of the current connecion is used when is omitted. + The server of the current connection is used when is omitted. References: - RFC 2812, 3.4.9 "Admin command" @@ -222,7 +222,7 @@ Status and Informational Commands . can be a server name, the nickname of a client connected to a specific server, or a mask matching a server name in the network. - The server of the current connecion is used when is omitted. + The server of the current connection is used when is omitted. References: - RFC 2812, 3.4.10 "Info command" @@ -231,7 +231,7 @@ Status and Informational Commands ISON [ [...]] . Query online status of a list of nicknames. The server replies with - a list only containing nicknes actually connected to a server in + a list only containing nicknames actually connected to a server in the network. If no nicknames of the given list are online, an empty list is returned to the client requesting the information. @@ -263,7 +263,7 @@ Status and Informational Commands . can be a server name, the nickname of a client connected to a specific server, or a mask matching a server name in the network. - The server of the current connecion is used when is omitted. + The server of the current connection is used when is omitted. Please note that ngIRCd ignores the parameter entirely: it is not possible to get information for a part of the network only. @@ -278,7 +278,7 @@ Status and Informational Commands . can be a server name, the nickname of a client connected to a specific server, or a mask matching a server name in the network. - The server of the current connecion is used when is omitted. + The server of the current connection is used when is omitted. References: - RFC 2812, 3.4.1 "Motd message" @@ -297,7 +297,7 @@ Status and Informational Commands . can be a server name, the nickname of a client connected to a specific server, or a mask matching a server name in the network. - The server of the current connecion is used when is omitted. + The server of the current connection is used when is omitted. References: - RFC 2812, 3.2.5 "Names message" @@ -318,7 +318,7 @@ Status and Informational Commands . can be a server name, the nickname of a client connected to a specific server, or a mask matching a server name in the network. - The server of the current connecion is used when is omitted. + The server of the current connection is used when is omitted. References: - RFC 2812, 3.4.4 "Stats message" @@ -330,7 +330,7 @@ Status and Informational Commands . can be a server name, the nickname of a client connected to a specific server, or a mask matching a server name in the network. - The server of the current connecion is used when is omitted. + The server of the current connection is used when is omitted. References - RFC 2812, 3.4.6 "Time message" @@ -342,56 +342,94 @@ Status and Informational Commands of a specific , in a similar method to traceroute. - USERHOST - USERHOST + USERHOST [ [...]] . - Show the user-host of (seperated by space). - "-" means is away, - "+" means is available, - "*" indicates your connection. + Show flags and the hostmasks (@) of the s, + separated by spaces. The following flags are used: + . + - "-" The client is "away" (the mode "+a" is set on this client). + - "+" Client seems to be available, at least it isn't marked "away". + - "*" The client is an IRC operator (the mode "+o" is set). + + References: + - RFC 2812, 4.8 "Userhost message" - VERSION - VERSION [] + VERSION [] . - Show the ngIRCd version of the current server, or specified . + Show version information about a particular IRC server in the network. + . + can be a server name, the nickname of a client connected to + a specific server, or a mask matching a server name in the network. + The server of the current connection is used when is omitted. + . + Please note: in normal operation, the version number ends in a dot + (".", for example "ngIRCd-20.1."). If it ends in ".1" (for example + "ngIRCd-20.1.1", same version than before!), the server is running in + debug-mode; and if it ends in ".2", the "network sniffer" is active! + Keep your privacy in mind ... + + References: + - RFC 2812, 3.4.3 "Version message" - WHO - WHO [ ["o"]] + WHO [ ["o"]] . - Returns a list of users who match (nick, hostmask or channel). + Show a list of users who match the , or all visible users when + the has been omitted. (Special case: the "0" is + equivalent to "*") . If the flag "o" is given, the server will only return information about IRC Operators. + References: + - RFC 2812, 3.6.1 "Who query" + - WHOIS - WHOIS [] + WHOIS [] [,[,...]] . - Returns information about the comma-separated list of . + Query information about users matching the parameter(s) as seen + by the server ; up to 3 are supported. . - If is given, the command is forwarded to it for processing. + can be a server name, the nickname of a client connected to a + specific server, or a mask matching a server name in the network. The + server of the current connection is used when is omitted. + + References: + - RFC 2812, 3.6.2 "Whois query" - WHOWAS - WHOWAS [ []] + WHOWAS [,[,...]] [ []] . - Used to return information about that are no longer in use - (due to client disconnection, or nickname changes). + Query information about nicknames no longer in use in the network, + either because of nickname changes or disconnects. The history is + searched backwards, returning the most recent entry first. If there + are multiple entries, up to entries will be shown (or all of + them, if no has been given). . - If given, the server will return information from the last times - the nickname has been used. - If is given, the command is forwarded to it for processing. + can be a server name, the nickname of a client connected to a + specific server, or a mask matching a server name in the network. The + server of the current connection is used when is omitted. + + References: + - RFC 2812, 3.6.3 "Whowas" Channel Commands ~~~~~~~~~~~~~~~~ - INVITE - INVITE + INVITE . - Invites to . - does not have to exist, but if it does, only members of the - channel are allowed to invite other clients. + Invite to join channel . . - If the mode "+i" is set, only operators may invite - other clients. + does not have to exist, but if it does, only members of the + channel are allowed to invite other users. If the channel mode "+i" + is set, only channel "half-ops" (and above) may invite other clients, + and if channel mode "+V" is set, nobody can invite other users. + + References: + - RFC 2812, 3.2.7 "Invite message" - JOIN JOIN [] @@ -403,11 +441,18 @@ Channel Commands If the channel(s) do not exist, then they will be created. - KICK - KICK [] + KICK [,[,...]] [,[,...]] [] . - Remove from , optional with a . + Remove users(s) with (s) from (s). . - Only operators are able to KICK. + There must be either exactly one parameter and multiple + parameters, or as many parameters as there are + parameters. The is shown to the users being + kicked, and the nickname of the current user is used when + is omitted. + + References: + - RFC 2812, 3.2.8 "Kick command" - LIST LIST [ []] @@ -468,9 +513,16 @@ Administrative Commands To list the G-Lines, type "STATS g". - KILL - KILL + KILL . - Forcibly removes from the IRC network with a . + Forcibly remove all users with a given from the IRC + network and display the given to them. + . + This command is used internally between servers, too, for example + to disconnect duplicate 's after a "net split". + + References: + - RFC 2812, 3.7.1 "Kill message" - KLINE KLINE : @@ -509,6 +561,18 @@ IRC Service Commands - SERVICE - SERVLIST + SERVLIST [ []] + . + List all IRC services currently registered in the network. + . + The optional and parameters can be used to limit the + listing to services matching the and that are of type . + . + Please note that ngIRCd doesn't use any service types at the moment + and therefore all services are of type "0". + + References: + - RFC 2812, 3.5.1 "Servlist message" - SQUERY @@ -558,8 +622,27 @@ Dummy Commands ~~~~~~~~~~~~~~ - SUMMON + SUMMON [ []] + . + This command was intended to call people into IRC who are directly + connected to the terminal console of the IRC server -- but is + deprecated today. Therefore ngIRCd doesn't really implement this + command and always returns an error message, regardless of the + parameters given. + + References: + - RFC 2812, 4.5 "Summon message" - USERS + USERS [] + . + This command was intended to list users directly logged in into the + console of the IRC server -- but is deprecated today. Therefore ngIRCd + doesn't really implement this command and always returns an error + message, regardless of the parameters given. + + References: + - RFC 2812, 4.6 "Users" - GET