NAME

cs::NNTP - access an NNTP service

SYNOPSIS

use cs::NNTP;

This module contacts and converses with an NNTP service.

new(server,needpost): Connect to the server specified. If omitted, use the value of the NNTPSERVER environment variable. If the optional parameter needpost is true, return undef if the server refuses posting permission.

Quit(): Send the QUIT command.
CanPost(): Return whether this connection allows posting.
Group(group): Select the specified group. Returns an array with the elements (low,high) for the group.
List(): Return the newsgroup listing from the server's LIST command as from the Text() method.
Head(id): Return a cs::RFC822 object containing the headers of the article specified by the Message-ID or sequence number id.
Article(id): Return a cs::MIME object containing the article specified by the Message-ID or sequence number id.
Reply(): Collect the server's response to a command. Returns a two element array with the three digit response code and the accompanying text.
Command(command): Send the specified command to the NNTP server. Return the response as from the Reply() method.
Text(): Collect a data response from the server. Returns an array of lines in an array context, the concatenation of the lines in a scalar context.
PostFile(fname): Post the news item present in the file named fname. Return success.
PostSource(s): Post the news item present in the cs::Source s. Return success.

Cameron Simpson <cs@zip.com.au>