Module: ngircd.git
Branch: master
Commit: 7c7fc8b5c4d6e7d6be3cf840688c3e34a8cb05a3
URL: http://ngircd.barton.de/cgi-bin/gitweb.cgi?p=ngircd.git&a=commit;h=7c7fc8b5…
Author: Alexander Barton <alex(a)barton.de>
Date: Sun Feb 10 00:22:50 2013 +0100
Commands.txt: Update description of the "STATS" command
---
doc/Commands.txt | 24 ++++++++++++++++--------
1 file changed, 16 insertions(+), 8 deletions(-)
diff --git a/doc/Commands.txt b/doc/Commands.txt
index e38f03f..2ea533a 100644
--- a/doc/Commands.txt
+++ b/doc/Commands.txt
@@ -303,17 +303,25 @@ Status and Informational Commands
- 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 connecion is used when <target> is omitted.
+
+ References:
+ - RFC 2812, 3.4.4 "Stats message"
- TIME
TIME [<server>]
Module: ngircd.git
Branch: master
Commit: 1a5e08f3f6d240f865434e9274f01e6f39a704cb
URL: http://ngircd.barton.de/cgi-bin/gitweb.cgi?p=ngircd.git&a=commit;h=1a5e08f3…
Author: Alexander Barton <alex(a)barton.de>
Date: Sun Feb 10 00:22:24 2013 +0100
Commands.txt: Update description of the "NAMES" command
---
doc/Commands.txt | 23 +++++++++++++++--------
1 file changed, 15 insertions(+), 8 deletions(-)
diff --git a/doc/Commands.txt b/doc/Commands.txt
index e92027b..e38f03f 100644
--- a/doc/Commands.txt
+++ b/doc/Commands.txt
@@ -284,16 +284,23 @@ Status and Informational Commands
- 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 connecion is used when <target> is omitted.
+
+ References:
+ - RFC 2812, 3.2.5 "Names message"
- STATS
STATS <flag> [<server>]
Module: ngircd.git
Branch: master
Commit: e051ea06fc601f8ae8d91b3b3f360e6f6e48db70
URL: http://ngircd.barton.de/cgi-bin/gitweb.cgi?p=ngircd.git&a=commit;h=e051ea06…
Author: Alexander Barton <alex(a)barton.de>
Date: Sun Feb 10 00:20:41 2013 +0100
Commands.txt: Update description of the "MOTD" command
---
doc/Commands.txt | 11 +++++++++--
1 file changed, 9 insertions(+), 2 deletions(-)
diff --git a/doc/Commands.txt b/doc/Commands.txt
index 83f811d..e92027b 100644
--- a/doc/Commands.txt
+++ b/doc/Commands.txt
@@ -272,9 +272,16 @@ Status and Informational Commands
- RFC 2812, 3.4.2 "Lusers message"
- MOTD
- MOTD [<server>]
+ MOTD [<target>]
.
- Show "Message Of The Day" of the current server or specified <server>.
+ Show the "Message of the Day" (MOTD) of an 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 connecion is used when <target> is omitted.
+
+ References:
+ - RFC 2812, 3.4.1 "Motd message"
- NAMES
NAMES [<channels> [<server>]]
Module: ngircd.git
Branch: master
Commit: a7023113e7546e3b278f753f0d38161f11afdb79
URL: http://ngircd.barton.de/cgi-bin/gitweb.cgi?p=ngircd.git&a=commit;h=a7023113…
Author: Alexander Barton <alex(a)barton.de>
Date: Sun Feb 10 00:20:19 2013 +0100
Commands.txt: Update description of the "LUSERS" command
---
doc/Commands.txt | 19 ++++++++++++-------
1 file changed, 12 insertions(+), 7 deletions(-)
diff --git a/doc/Commands.txt b/doc/Commands.txt
index 2c35792..83f811d 100644
--- a/doc/Commands.txt
+++ b/doc/Commands.txt
@@ -256,15 +256,20 @@ Status and Informational Commands
- RFC 2812, 3.4.5 "Links message"
- LUSERS
- LUSERS [<mask> [<server>]]
+ LUSERS [<mask> [<target>]]
.
- Return statistics about the size of the network. If called with no
- arguments, the statistics will reflect the entire network.
+ Return statistics about the number of clients (users, servers,
+ services, ...) in the network as seen by the server <target>.
.
- 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.
+ <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.
+
+ Please note that ngIRCd ignores the <mask> parameter entirely: it
+ is not possible to get information for a part of the network only.
+
+ References:
+ - RFC 2812, 3.4.2 "Lusers message"
- MOTD
MOTD [<server>]
Module: ngircd.git
Branch: master
Commit: 02e24f5d1e6f098f2452f344331871a9d9a64280
URL: http://ngircd.barton.de/cgi-bin/gitweb.cgi?p=ngircd.git&a=commit;h=02e24f5d…
Author: Alexander Barton <alex(a)barton.de>
Date: Sun Feb 10 00:19:59 2013 +0100
Commands.txt: Update description of the "LINKS" command
---
doc/Commands.txt | 13 ++++++++++---
1 file changed, 10 insertions(+), 3 deletions(-)
diff --git a/doc/Commands.txt b/doc/Commands.txt
index 0f3fdbb..2c35792 100644
--- a/doc/Commands.txt
+++ b/doc/Commands.txt
@@ -243,10 +243,17 @@ Status and Informational Commands
- RFC 2812, 4.9 "Ison message"
- LINKS
- LINKS [<remote server> [<server mask>]]
+ LINKS [[<target>] [<mask>]
.
- Lists all server links matching <server mask>, if given,
- on <remote server>, or the current server if omitted.
+ List all servers currently registered in the network matching <mask>,
+ or all servers if <mask> has been omitted, as seen by the server
+ specified by <target> or the local server when <target> is omitted.
+ .
+ <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.
+
+ References:
+ - RFC 2812, 3.4.5 "Links message"
- LUSERS
LUSERS [<mask> [<server>]]
Module: ngircd.git
Branch: master
Commit: 13740c1bf4518c2d82476948f43d675524c42221
URL: http://ngircd.barton.de/cgi-bin/gitweb.cgi?p=ngircd.git&a=commit;h=13740c1b…
Author: Alexander Barton <alex(a)barton.de>
Date: Sun Feb 10 00:19:41 2013 +0100
Commands.txt: Update description of the "ISON" command
---
doc/Commands.txt | 19 ++++++++++++-------
1 file changed, 12 insertions(+), 7 deletions(-)
diff --git a/doc/Commands.txt b/doc/Commands.txt
index ac455b3..0f3fdbb 100644
--- a/doc/Commands.txt
+++ b/doc/Commands.txt
@@ -228,14 +228,19 @@ Status and Informational Commands
- RFC 2812, 3.4.10 "Info command"
- ISON
- ISON <nicknames>
+ ISON <nickname> [<nickname> [...]]
.
- 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.
+ Query online status of a list of nicknames. The server replies with
+ a list only containing nicknes 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.
+
+ Please note that "all" IRC daemons even parse separate nicknames in
+ a single parameter (like ":nick1 nick2"), and therefore ngIRCd
+ implements this behaviour, too.
+
+ References:
+ - RFC 2812, 4.9 "Ison message"
- LINKS
LINKS [<remote server> [<server mask>]]
Module: ngircd.git
Branch: master
Commit: 8212b730c707da88dcadd6384a5ecd559a2b393f
URL: http://ngircd.barton.de/cgi-bin/gitweb.cgi?p=ngircd.git&a=commit;h=8212b730…
Author: Alexander Barton <alex(a)barton.de>
Date: Sun Feb 10 00:19:20 2013 +0100
Commands.txt: Update description of the "INFO" command
---
doc/Commands.txt | 12 +++++++++---
1 file changed, 9 insertions(+), 3 deletions(-)
diff --git a/doc/Commands.txt b/doc/Commands.txt
index 177b22e..ac455b3 100644
--- a/doc/Commands.txt
+++ b/doc/Commands.txt
@@ -216,10 +216,16 @@ Status and Informational Commands
- RFC 2812, 3.4.9 "Admin command"
- INFO
- INFO [<server>]
+ INFO [<target>]
.
- Show the version, birth & online time of the current IRC server.
- If <server> has been given, it shows the INFO of the specific <server>.
+ Show the version, birth & online time of an 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 connecion is used when <target> is omitted.
+
+ References:
+ - RFC 2812, 3.4.10 "Info command"
- ISON
ISON <nicknames>
Module: ngircd.git
Branch: master
Commit: a4daa613ae4ce3c87b1f711d7700383fac591f16
URL: http://ngircd.barton.de/cgi-bin/gitweb.cgi?p=ngircd.git&a=commit;h=a4daa613…
Author: Alexander Barton <alex(a)barton.de>
Date: Sun Feb 10 00:18:36 2013 +0100
Commands.txt: Update description of the "ADMIN" command
---
doc/Commands.txt | 10 ++++++++--
1 file changed, 8 insertions(+), 2 deletions(-)
diff --git a/doc/Commands.txt b/doc/Commands.txt
index 431a410..177b22e 100644
--- a/doc/Commands.txt
+++ b/doc/Commands.txt
@@ -204,10 +204,16 @@ Status and Informational Commands
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
- ADMIN
- ADMIN [<server>]
+ ADMIN [<target>]
.
Show administrative information about an IRC server in the network.
- If no server name has been given, the local server will respond.
+ .
+ <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.
+
+ References:
+ - RFC 2812, 3.4.9 "Admin command"
- INFO
INFO [<server>]
Module: ngircd.git
Branch: master
Commit: b7690a0add0d46f952cc44ce522bb0e2e802b24c
URL: http://ngircd.barton.de/cgi-bin/gitweb.cgi?p=ngircd.git&a=commit;h=b7690a0a…
Author: Alexander Barton <alex(a)barton.de>
Date: Sun Feb 3 19:02:42 2013 +0100
Commands.txt: Add description for the "CHARCONV" command
---
doc/Commands.txt | 17 ++++++++++++++++-
1 file changed, 16 insertions(+), 1 deletion(-)
diff --git a/doc/Commands.txt b/doc/Commands.txt
index ac77c65..431a410 100644
--- a/doc/Commands.txt
+++ b/doc/Commands.txt
@@ -83,7 +83,22 @@ Connection Handling Commands
- doc/Capabilities.txt
- CHARCONV
- See doc/Protocol.txt
+ CHARCONV <client-charset>
+ .
+ Set client character set encoding to <client-charset>.
+ .
+ After receiving such a command, the server translates all message
+ data received from the client using the set <client-charset> to the
+ server encoding (UTF-8), and all message data which is to be sent to
+ the client from the server encoding (UTF-8) to <client-charset>.
+ .
+ This enables older clients and clients using "strange" character sets
+ to transparently participate in channels and direct messages to
+ clients using UTF-8, which should be the default today.
+
+ References:
+ - <http://ngircd.barton.de/doc/Protocol.txt>
+ - doc/Protocol.txt
- NICK
NICK <nick>
Module: ngircd.git
Branch: master
Commit: 18ecc2fd811d3419c597fc31663f3f4a0e14824b
URL: http://ngircd.barton.de/cgi-bin/gitweb.cgi?p=ngircd.git&a=commit;h=18ecc2fd…
Author: Alexander Barton <alex(a)barton.de>
Date: Sun Feb 3 18:59:44 2013 +0100
Commands.txt: Add description for the "CAP" command
---
doc/Commands.txt | 36 +++++++++++++++++++++++++++++++++++-
1 file changed, 35 insertions(+), 1 deletion(-)
diff --git a/doc/Commands.txt b/doc/Commands.txt
index c6e0637..ac77c65 100644
--- a/doc/Commands.txt
+++ b/doc/Commands.txt
@@ -46,7 +46,41 @@ Connection Handling Commands
~~~~~~~~~~~~~~~~~~~~~~~~~~~~
- CAP
- See doc/Capabilities.txt
+ CAP LS
+ CAP LIST
+ CAP REQ <capabilities>
+ CAP ACK <capabilities>
+ CAP NAK <capabilities>
+ CAP CLEAR
+ CAP END
+ .
+ List, request, and clear "IRC Capabilities".
+ .
+ Using this command, an IRC client can request additional "IRC
+ capabilities" during login or later on, which influences the
+ communication between server and client. Normally, these commands
+ aren't directly used by humans, but automatically by their client
+ software. And please note that issuing such commands manually can
+ irritate the client software used, because of the "non-standard"
+ behavior of the server!
+ .
+ - CAP LS: list all available capabilities.
+ - CAP LIST: list active capabilities of this connection.
+ - CAP REQ: Request particular capabilities.
+ - CAP ACK: Acknowledge a set of capabilities to be enabled/disabled.
+ - CAP NAK: Reject a set of capabilities.
+ - CAP CLEAR: Clear all set capabilities.
+ - CAP END: Indicate end of capability negotiation during login,
+ ignored in an fully registered session.
+
+ Please note that the <capabilities> must be given in a single
+ parameter but whitespace separated, therefore a command could look
+ like this: "CAP REQ :capability1 capability2 capability3" for example.
+
+ References:
+ - <http://ircv3.atheme.org/specification/capability-negotiation-3.1>
+ - <http://ngircd.barton.de/doc/Capabilities.txt>
+ - doc/Capabilities.txt
- CHARCONV
See doc/Protocol.txt