sinntp(1)

sinntp1

Tiny non-interactive nntp client

Usage

sinntp command [options ...] [args ...]

Overview

sinntp is a tiny NNTP client originally designed to work in non-interactive mode. Following operations are supported:

• sending articles to the server,

• fetching new articles to the mbox file,

• downloading individual messages in RFC822 format,

• listing available newsgroups.

Commands

sinntp provides following commands:

• get,

• list,

• pull,

• push.

Above commands may also be invoked via convenience wrappers named in nntp-command scheme (e.g. nntp-get). See wrappers' manual pages for command synopsis and description.

Options

--version

Show program's version number and exit.

-h, --help

Show short help message end exit.

-v, --verbose

Be more verbose (use multiple times to increase verbosity).

-q, --quiet

Be less verbose (use multiple times to decrease verbosity).

-p, --plugin=plugin

Load and use plugin.

-S, --server=host, --server=host:port

Connect to the specified host and port. If omitted sinntp will use address stored in /etc/nntp/server file or in NNTPSERVER variable (the latter takes precedence over the former).

-U, --username=username

Use specified username for authentication.

-P, --password=password

Use specified password for authentication.

Use with caution! The password may be visible to other users of the system.

--no-netrc

Do not attempt to read authentication credentials (username, password) from the ~/.netrc file.

-t, --timeout=timeout

Wait maximum timeout seconds during communication with the server.

Also, a particular command can support additional options.

Plugins

Pulled and pushed messages can be altered by the plugin mechanism. Currently sinntp package includes following plugins:

• mimify - add default charset to the message when it is not present,

• strip_headers - strip specified headers from message.

Environment

NNTPSERVER

Address of the default NNTP server. It can be overridden by --server option.

XDG_DATA_HOME

Location of sinntp data directory. See XDG Base Directory Specification[1] for details.

Files

/etc/news/server

A file with NNTP server address. Can be overridden by NNTPSERVER environment variable or --server option.

$XDG_DATA_HOME/sinntp/

Location of sinntp data files.

Notes

1.

XDG Base Directory Specification

https://specifications.freedesktop.org/basedir-spec/latest/

Releases

8 releases since Debian 6.0 (Squeeze); the text changed 2 times.

  1. 6.0
  2. 7–10
  3. 11–13

--no-netrc since Debian 7 (Wheezy).

From sinntp 1.6-6 in Debian 13 (Trixie). Parsed by carta from the page's man source.