14 NNTP: Newsgroup Protocol
The net/nntp module provides
tools to access Usenet group via NNTP [RFC977].
14.1 Connection and Operations
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
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
Raised when the server is unable to locate the article.
Raised when the server reject an authentication attempt.
14.3 NNTP Unit
Imports nothing, exports nntp^.
14.4 NNTP Signature
Includes everything exported by the net/nntp module.