Skip to content

Commit 8328080

Browse files
authored
clarify that servers SHOULD send RPL_ENDOFWHOIS (#243)
1 parent dce198b commit 8328080

File tree

1 file changed

+6
-10
lines changed

1 file changed

+6
-10
lines changed

_includes/messages/user_queries.md

+6-10
Original file line numberDiff line numberDiff line change
@@ -48,17 +48,10 @@ Reply Examples:
4848
Command: WHOIS
4949
Parameters: [<target>] <nick>
5050

51-
This command is used to query information about particular users.
52-
The server will answer this command with several numeric messages with information about the nicks, ending with [`RPL_ENDOFWHOIS`](#rplendofwhois-318).
51+
This command is used to query information about a particular user.
52+
The server SHOULD answer this command with numeric messages with information about the nick.
5353

54-
Servers MUST end their reply to `WHOIS` messages with one of these numerics:
55-
56-
* {% numeric ERR_NOSUCHNICK %}
57-
* {% numeric ERR_NOSUCHSERVER %}
58-
* {% numeric ERR_NONICKNAMEGIVEN %}
59-
* {% numeric RPL_ENDOFWHOIS %}otherwise, even if they did not send any other numeric message. This allows clients to stop waiting for new numerics.
60-
61-
In exceptional error conditions, servers MAY not reply to a `WHOIS` command. Clients SHOULD implement a hard timeout to avoid waiting for a reply which won't come.
54+
The server SHOULD end its response (to a syntactically well-formed client message) with [`RPL_ENDOFWHOIS`](#rplendofwhois-318), even if it did not send any other numeric message. This allows clients to stop waiting for new numerics. In exceptional error conditions, servers MAY not reply to a `WHOIS` command. Clients SHOULD implement a hard timeout to avoid waiting for a reply which won't come.
6255

6356
Client MUST NOT not assume all numeric messages are sent at once, as server can interleave other messages before the end of the WHOIS response.
6457

@@ -67,6 +60,9 @@ Typically, it is used by clients who want to know how long the user in question
6760

6861
The following numerics MAY be returned as part of the whois reply:
6962

63+
* {% numeric ERR_NOSUCHNICK %}
64+
* {% numeric ERR_NOSUCHSERVER %}
65+
* {% numeric ERR_NONICKNAMEGIVEN %}
7066
* {% numeric RPL_WHOISCERTFP %}
7167
* {% numeric RPL_WHOISREGNICK %}
7268
* {% numeric RPL_WHOISUSER %}

0 commit comments

Comments
 (0)