Package gnu.mail.providers.nntp

This is a provider for the Network News Transfer Protocol (NNTP), as detailed in RFC 977.

This provider uses the XHDR command introduced in RFC 2980.

The provider can store the state of subscribed newsgroups and read articles on the local host, using the standard newsrc mechanism.

The provider includes both a Store and a Transport implementation. Due to JavaMail limitations, the transport protocol is called "nntp-post". Use the same connection setting as the store to post articles. The messages to be sent must be MimeMessages, and they must have a recipient of type MimeMessage.RecipientType.NEWSGROUPS, of which the address is a NewsAddress.

This provider supports the following properties:

<!--tr>

Name	Type	Description
mail.nntp.host	IP address or hostname	The NNTP server to connect to.
mail.nntp.port	integer (>=1)	The port to connect to, if not the default.
mail.nntp.user	username	The default username for NNTP.
mail.nntp.connectiontimeout	integer (>=1)	Socket connection timeout, in milliseconds. Default is no timeout.
mail.nntp.timeout	integer (>=1)	Socket I/O timeout, in milliseconds. Default is no timeout.
mail.nntp.newsrc	file path	The file path to the file to use as newsrc. Defaults to ${user.home}/.newsrc-${host} or ${user.home}/.newsrc
mail.nntp.listall	boolean	If set to true, calling Folder.list on the root folder will actually attempt to list all newsgroups. Since there are upwards of 30,000 newsgroups on Usenet, this option should be used with caution. Otherwise a small subset of default newsgroups are returned.