The net/nntp module provides tools to access Usenet group via NNTP [RFC977].

Once a connection to a Usenet server has been established, its state is stored in a communicator, and other procedures take communicators as an argument.

Connects to server at port-number.

Disconnects an NNTP communicator.

Selects the newsgroup of an NNTP connection. The returned values are the total number of articles in the group, the first available article, and the last available article.

Tries to authenticate a user with the original authinfo command (uses cleartext). The password argument is ignored if the server does not ask for it.

Given a message number, returns its header lines.

Given a message number, returns the body of the message.

Implements the NEWNEWS command (often disabled on servers).

Useful primitive for implementing head-of-message, body-of-message and other similar commands.

Takes a header field’s tag and returns a regexp to match the field

Given a list of header lines and of desired regexps, returns the header lines that match any of the desireds.

The supertype of all NNTP exceptions.

Raised whenever an unexpected response code is received. The text field holds the response text sent by the server.

Raised for mal-formed status lines.

Raised when a remote server closes its connection unexpectedly.

Raised when the newsgroup line is improperly formatted.

Raised when the server does not recognize the name of the requested group.

Raised when an article is outside the server’s range for that group.

Raised when an article operation is used before a group has been selected.

Raised when the server is unable to locate the article.

Raised when the server reject an authentication attempt.

Imports nothing, exports nntp^.