NNTP-Ext:[Previous][Up to Table of Contents] [Next]
NNTP-Ext 2.6 XHDR |
---|
XHDR header [range|<message-id>] The XHDR command is used to retrieve specific headers from specific articles. The required parameter is the name of a header line (e.g. "subject") in a news group article. See RFC-1036 for a list of valid header lines. The optional range argument may be any of the following: an article number an article number followed by a dash to indicate all following an article number followed by a dash followed by another article number The optional message-id argument indicates a specific article. The range and message-id arguments are mutually exclusive. If no argument is specified, then information from the current article is displayed. Successful responses start with a 221 response followed by a the matched headers from all matched messages. Each line containing matched headers returned by the server has an article number (or message ID, if a message ID was specified in the command), then one or more spaces, then the value of the requested header in that article. Once the output is complete, a period is sent on a line by itself. If the optional argument is a message-id and no such article exists, the 430 error response is returned. If a range is specified, a news group must have been selected earlier, else a 412 error response is returned. If no articles are in the range specified, a 420 error response is returned by the server. A 502 response will be returned if the client only has permission to transfer articles. Some implementations will return "(none)" followed by a period on a line by itself if no headers match in any of the articles searched. Others return the 221 response code followed by a period on a line by itself. The XHDR command has been available in the UNIX reference implementation from its first release. However, until now, it has been documented only in the source for the server. 2.6.1 Responses 221 Header follows 412 No news group current selected 420 No current article selected 430 no such article 502 no permission |
[Source:"draft-ietf-nntp-imp-02.txt"] [Last Changed:March 1998] [Copyright: 1998 S. Barber] |