Februar 2013 - ngIRCd GIT Updates

Alexander Barton : Commands.txt: Update description of the "STATS" command
by alex＠arthur.barton.de 10 Feb '13

10 Feb '13

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>]

1 0

Alexander Barton : Commands.txt: Update description of the "NAMES" command
by alex＠arthur.barton.de 10 Feb '13

10 Feb '13

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>]

1 0

Alexander Barton : Commands.txt: Update description of the "MOTD" command
by alex＠arthur.barton.de 10 Feb '13

10 Feb '13

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>]]

1 0

Alexander Barton : Commands.txt: Update description of the "LUSERS" command
by alex＠arthur.barton.de 10 Feb '13

10 Feb '13

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>]

1 0

Alexander Barton : Commands.txt: Update description of the "LINKS" command
by alex＠arthur.barton.de 10 Feb '13

10 Feb '13

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>]]

1 0

Alexander Barton : Commands.txt: Update description of the "ISON" command
by alex＠arthur.barton.de 10 Feb '13

10 Feb '13

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>]]

1 0

Alexander Barton : Commands.txt: Update description of the "INFO" command
by alex＠arthur.barton.de 10 Feb '13

10 Feb '13

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>

1 0

Alexander Barton : Commands.txt: Update description of the "ADMIN" command
by alex＠arthur.barton.de 10 Feb '13

10 Feb '13

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>]

1 0

Alexander Barton : Commands.txt: Add description for the "CHARCONV" command
by alex＠arthur.barton.de 10 Feb '13

10 Feb '13

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>

1 0

Alexander Barton : Commands.txt: Add description for the "CAP" command
by alex＠arthur.barton.de 10 Feb '13

10 Feb '13

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

1 0