Common NNTP Extensions

Be sure to read the "RKT couplings" below for additional information, comments, and links.

NNTP-Ext:[Previous][Up to Table of Contents] [Next]


    XOVER [range]

    The XOVER command returns information from the overview
    database for the article(s) specified. This command was
    originally suggested as part of the OVERVIEW work described
    in "The Design of a Common Newsgroup Overview Database for
    Newsreaders" by Geoff Collyer. This document is distributed
    in the Cnews distribution.

    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

    If no argument is specified, then information from the
    current article is displayed. Successful responses start
    with a 224 response followed by the overview information
    for all matched messages. Once the output is complete, a
    period is sent on a line by itself. If no argument is
    specified, the information for the current article is
    returned.  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.

    Each line of output will be formatted with the article number,
    followed by each of the headers in the overview database or the
    article itself (when the data is not available in the overview
    database) for that article separated by a tab character.  The
    sequence of fields must be in this order: subject, author,
    date, message-id, references, byte count, and line count. Other
    optional fields may follow line count. Other optional fields may
    follow line count. These fields are specified by examining the
    response to the LIST OVERVIEW.FMT command. Where no data exists,
    a null field must be provided (i.e. the output will have two tab
    characters adjacent to each other). Servers should not output
    fields for articles that have been removed since the XOVER database
    was created.

    The LIST OVERVIEW.FMT command should be implemented if XOVER
    is implemented. A client can use LIST OVERVIEW.FMT to determine
    what optional fields  and in which order all fields will be
    supplied by the XOVER command. See Section 2.1.7 for more
    details about the LIST OVERVIEW.FMT command.

    Note that any tab and end-of-line characters in any header
    data that is returned will be converted to a space character.

2.8.1 Responses

      224 Overview information follows
      412 No news group current selected
      420 No article(s) selected
      502 no permission

[Source:"draft-ietf-nntp-imp-02.txt"] [Last Changed:March 1998]
[Copyright: 1998 S. Barber]

NNTP-Ext:[Previous][Up to Table of Contents] [Next]

(Corrections, notes, and links for Usenet RKT.)
by Mib Software, NNTP software and consulting

Note that all RFC977 2.4.3. General Responses may also be received.

Overview and Related Topics
Up to: NNTP-Ext 2. Newsreader Extensions
NNTP Command Syntax
NNTP Response Syntax

RKT Rapid-Links:[Search] [RKT Tips] Path:For Developers / NNTProtocol / NNTP-Ext / Newsreader Extensions / 0025.htm

Copyright 1998, Forrest J. Cavalier III
Mib Software, NNTP software and consulting