.
<target> 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 <target> is omitted.
+ The server of the current connection is used when <target> is omitted.
References:
- RFC 2812, 3.4.9 "Admin command"
.
<target> 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 <target> is omitted.
+ The server of the current connection is used when <target> is omitted.
References:
- RFC 2812, 3.4.10 "Info command"
ISON <nickname> [<nickname> [...]]
.
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.
.
<target> 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 <target> is omitted.
+ The server of the current connection is used when <target> is omitted.
Please note that ngIRCd ignores the <mask> parameter entirely: it
is not possible to get information for a part of the network only.
.
<target> 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 <target> is omitted.
+ The server of the current connection is used when <target> is omitted.
References:
- RFC 2812, 3.4.1 "Motd message"
- NAMES
- NAMES [<channels> [<server>]]
+ NAMES [<channel>[,<channel>[,...]] [<target>]]
.
- Returns a list of who is on the comma-separated list of <channels>,
- by channel name.
+ Show the list of users that are members of a particular <channel>
+ (and that are visible for the client requesting this information) as
+ seen by the server <target>. More than one <channel> can be given
+ separated by "," (but not whitespaces!).
.
- 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.
+ If <channel> has been omitted, all visible users are shown, grouped
+ by channel name, and all visible users not being members of at least
+ one channel are shown as members of the pseudo channel "*".
+ .
+ <target> 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 <target> is omitted.
+
+ References:
+ - RFC 2812, 3.2.5 "Names message"
- STATS
- STATS <flag> [<server>]
+ STATS [<query> [<target>]]
.
- Returns statistics about the current server, or of a specified <server>.
+ Show statistics and other information of type <query> of a particular
+ IRC server in the network.
.
- STATS flags:
+ The following <query> types are supported (case-insensitive):
.
- 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
+ - g Network-wide bans ("G-Lines").
+ - k Server-local bans ("K-Lines").
+ - l Link status (parent server and own link only).
+ - m Command usage count.
+ - u Server uptime.
+ .
+ <target> 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 <target> is omitted.
+
+ References:
+ - RFC 2812, 3.4.4 "Stats message"
- TIME
- TIME [<server>]
+ TIME [<target>]
+ .
+ Show the local time of an IRC server in the network.
.
- Show the local time of the current server, or of a specified <server>.
+ <target> 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 <target> is omitted.
+
+ References
+ - RFC 2812, 3.4.6 "Time message"
- TRACE
TRACE [<server>]
of a specific <server>, in a similar method to traceroute.
- USERHOST
- USERHOST <nicknames>
+ USERHOST <nickname> [<nickname> [...]]
.
- Show the user-host of <nicknames> (seperated by space).
- "-" means <nick> is away,
- "+" means <nick> is available,
- "*" indicates your connection.
+ Show flags and the hostmasks (<user>@<host>) of the <nickname>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 [<server>]
+ VERSION [<target>]
.
- Show the ngIRCd version of the current server, or specified <server>.
+ Show version information about a particular IRC server in the network.
+ .
+ <target> 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 <target> 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 [<target> ["o"]]
+ WHO [<mask> ["o"]]
.
- Returns a list of users who match <target> (nick, hostmask or channel).
+ Show a list of users who match the <mask>, or all visible users when
+ the <mask> has been omitted. (Special case: the <mask> "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 [<server>] <nicknames>
+ WHOIS [<target>] <mask>[,<mask>[,...]]
.
- Returns information about the comma-separated list of <nicknames>.
+ Query information about users matching the <mask> parameter(s) as seen
+ by the server <target>; up to 3 <masks> are supported.
.
- If <server> is given, the command is forwarded to it for processing.
+ <target> 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 <target> is omitted.
+
+ References:
+ - RFC 2812, 3.6.2 "Whois query"
- WHOWAS
- WHOWAS <nickname> [<count> [<server>]]
+ WHOWAS <nickname>[,<nickname>[,...]] [<count> [<target>]]
.
- Used to return information about <nicknames> 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 <count> entries will be shown (or all of
+ them, if no <count> has been given).
.
- 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.
+ <target> 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 <target> is omitted.
+
+ References:
+ - RFC 2812, 3.6.3 "Whowas"
Channel Commands
~~~~~~~~~~~~~~~~
- INVITE
- INVITE <nick> <channel>
+ INVITE <nickname> <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.
+ Invite <nickname> to join channel <channel>.
.
- If the <channel> mode "+i" is set, only <channel> operators may invite
- other clients.
+ <channel> 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 <channels> [<channel-keys>]
If the channel(s) do not exist, then they will be created.
- KICK
- KICK <channel> <nick> [<kick-message>]
+ KICK <channel>[,<channel>[,...]] <nickname>[,<nickname>[,...]] [<reason>]
.
- Remove <nick> from <channel>, optional with a <kick-message>.
+ Remove users(s) with <nickname>(s) from <channel>(s).
.
- Only <channel> operators are able to KICK.
+ There must be either exactly one <channel> parameter and multiple
+ <nickname> parameters, or as many <channel> parameters as there are
+ <nickname> parameters. The <reason> is shown to the users being
+ kicked, and the nickname of the current user is used when <reason>
+ is omitted.
+
+ References:
+ - RFC 2812, 3.2.8 "Kick command"
- LIST
LIST [<channels> [<server>]]
- SERVICE
- SERVLIST
+ SERVLIST [<mask> [<type>]]
+ .
+ List all IRC services currently registered in the network.
+ .
+ The optional <mask> and <type> parameters can be used to limit the
+ listing to services matching the <mask> and that are of type <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
~~~~~~~~~~~~~~
- SUMMON
+ SUMMON <user> [<target> [<channel>]]
+ .
+ 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 [<target>]
+ .
+ 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