Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

clarify that servers SHOULD send RPL_ENDOFWHOIS #243

Open
wants to merge 2 commits into
base: master
Choose a base branch
from
Open

clarify that servers SHOULD send RPL_ENDOFWHOIS #243

Changes from all commits
Commits
Show all changes
2 commits
Select commit Hold shift + click to select a range
01884db
clarify that servers SHOULD send RPL_WHOIS
slingamn Oct 8, 2024
d36f612
clarify that the SHOULD only applies to well-formed queries
slingamn Oct 15, 2024
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
16 changes: 6 additions & 10 deletions _includes/messages/user_queries.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -48,17 +48,10 @@ Reply Examples:
Command: WHOIS
Parameters: [<target>] <nick>

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

Servers MUST end their reply to `WHOIS` messages with one of these numerics:

* {% numeric ERR_NOSUCHNICK %}
* {% numeric ERR_NOSUCHSERVER %}
* {% numeric ERR_NONICKNAMEGIVEN %}
* {% numeric RPL_ENDOFWHOIS %}otherwise, even if they 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.
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.

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.

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

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

* {% numeric ERR_NOSUCHNICK %}
* {% numeric ERR_NOSUCHSERVER %}
* {% numeric ERR_NONICKNAMEGIVEN %}
* {% numeric RPL_WHOISCERTFP %}
* {% numeric RPL_WHOISREGNICK %}
* {% numeric RPL_WHOISUSER %}
Expand Down