Package inn

The InterNetNews system, an Usenet news server

http://www.eyrie.org/~eagle/software/inn/

INN (InterNetNews) is a complete system for serving Usenet news and/or
private newsfeeds. INN includes innd, an NNTP (NetNews Transport
Protocol) server, and nnrpd, a newsreader that is spawned for each
client. Both innd and nnrpd vary slightly from the NNTP protocol, but
not in ways that are easily noticed.

Install the inn package if you need a complete system for serving and
reading Usenet news. You may also need to install inn-devel, if you
are going to use a separate program which interfaces to INN, like
newsgate or tin.

General Commands (Section 1)
convdate
convdate translates the date/time strings given on the command line, outputting the results one to a line. The input can either be a date in RFC 5322 format...
fastrm
fastrm reads a list of either file names or storage API tokens, one per line, from its standard input and removes them. Storage API tokens are removed via the...
getlist
getlist obtains a list from an NNTP server and sends it to standard output. list may be one of "active" (which is the default value), "active.times"...
grephistory
grephistory queries the INN history database for information about the specified message-ID. If no flags are given, the program prints the storage API token of...
innconfval
innconfval normally prints the values of the parameters specified on the command line. By default, it just prints the parameter values, but if -p, -s, or -t are...
innmail
innmail is a Perl script intended to provide the non-interactive mail-sending functionality of mail(1) while avoiding nasty security problems. It takes the body...
nntpget
Nntpget connects to the NNTP server at the specified host and retrieves articles from it. The Message-ID's of the desired articles are read from standard input...
pgpverify
The pgpverify program reads (on standard input) a Usenet control message that has been cryptographically signed using the signcontrol program (or some other...
pullnews
pullnews reads a config file named pullnews.marks, and connects to the upstream servers given there as a reader client. This file is looked for in pathdb when...
rnews
rnews injects either individual articles or UUCP-style article batches into an INN server. It submits articles via IHAVE and is suitable for injecting articles...
shlock
shlock tries to create a lock file named name and write the process ID pid into it. If the file already exists, shlock will read the process ID from the file...
shrinkfile
The shrinkfile program shrinks files to a given size if the size is larger than maxsize, preserving the data at the end of the file. Truncation is performed on...
simpleftp
simpleftp is a Perl script that provides basic support for fetching files with FTP in a batch oriented fashion. It takes one or more FTP URLs on the command...
sm
The INN storage manager is the subsystem that stores and keeps track of all of the articles and what storage backend they're in. All stored articles are...
File Formats (Section 5)
active
The file pathdb/active lists the newsgroups carried by INN. This file is generally maintained using ctlinnd(8) to create and remove groups, or by letting...
active.times
The file pathdb/active.times provides a chronological record of when newsgroups were created on the local server. This file is normally updated by mod-active...
buffindexed.conf
buffindexed.conf, found in pathetc, specifies the buffers that the buffindexed overview method should use. It is required if the server uses buffindexed (as...
control.ctl
The file pathetc/control.ctl is used to determine what action is taken when a control message is received. It is read by controlchan, which is normally invoked...
cycbuff.conf
This file defines the cyclical buffers that make up the storage pools for CNFS (Cyclic News File System). Some options controlling the behavior of the CNFS...
distrib.pats
The file pathetc/distrib.pats is used by nnrpd to determine the default value of the Distribution: header. Blank lines and lines beginning with a number sign...
distributions
The file pathetc/distributions contains a list of relevant distributions and their descriptions. It provides local information for posters who wish to add a...
expire.ctl
The file pathetc/expire.ctl is the default configuration file for expire and expireover, which read it at start-up. It serves two purposes: it defines how long...
history
The file <pathdb in inn.conf>/history keeps a record of all articles currently stored in the news system, as well as those that have been received but since...
incoming.conf
The file pathetc/incoming.conf consists of three types of entries: key/value, peer and group. Comments are from the hash character "#" to the end of the line...
inn.conf
inn.conf in pathetc is the primary general configuration file for all InterNetNews programs. Settings which control the general operation of various programs...
innfeed.conf
The configuration file innfeed.conf in pathetc is used to control the innfeed(8) program. It is a fairly free-format file that consists of three types of...
inn-radius.conf
This describes the format and attributes of the configuration file for the nnrpd RADIUS authenticator. See radius(8) for more information about the...
innwatch.ctl
The file <pathetc in inn.conf>/innwatch.ctl is used to determine what actions are taken during the periodic supervisions by innwatch. The file consists of a...
moderators
When an unapproved article is posted locally to a moderated newsgroup, it is not passed off to innd for normal handling; instead, it is sent via e-mail to the...
motd.news
Two files, found in pathetc, contain local information for news feeders or news readers in a free-form format. The entire files are returned verbatim to any...
newsfeeds
The file pathetc/newsfeeds specifies how incoming articles should be distributed to other programs and files on the server. It is parsed by the InterNetNews...
newsgroups
The file pathdb/newsgroups contains a list of newsgroups for which a short description is available. This file is generally updated by controlchan(8) whenever a...
newslog
Most log files created by Usenet programs reside in the pathlog directory set in inn.conf and have a ".log" extension. Several versions are usually kept with an...
nnrpd.track
This file, which is located in <pathetc in inn.conf>, specifies which hosts are to have their activities recorded during an nnrpd session. The nnrpd server...
nntpsend.ctl
The file pathetc/nntpsend.ctl specifies the default list of sites to be fed by nntpsend. Comments begin with a number sign ("#") and continue through the end of...
ovdb
Ovdb is a storage method that uses the Berkeley DB library to store overview data. It requires version 4.4 or later of the Berkeley DB library (4.7+ is...
passwd.nntp
The file pathetc/passwd.nntp contains host / name / password triplets for use when authenticating client programs to NNTP servers. This file is normally...
readers.conf
readers.conf in pathetc specifies access control for nnrpd(8). It controls who is allowed to connect as a news reader and what they're allowed to do after they...
storage.conf
The file pathetc/storage.conf contains the rules to be used in assigning articles to different storage methods. These rules determine where incoming articles...
subscriptions
The pathetc/subscriptions file contains a list of newsgroups that is returned by the NNTP command LIST SUBSCRIPTIONS. Clients that support this command usually...
System Administration (Section 8)
actsync
actsync permits one to synchronize, compare, or merge two active files. With this utility one may add, change, or remove newsgroups on the local news server to...
archive
archive makes copies of files specified on its standard input. It is normally run either as a channel feed under innd or by a script before news.daily is run...
auth_krb5
This program does authentication for nnrpd against a Kerberos v5 KDC. This is NOT real Kerberos authentication using service tickets; instead, a username and...
batcher
batcher reads a list of files and prepares news batches for the specified host. It is generally used to prepare UUCP feeds, but the resulting batches can be...
buffchan
buffchan reads lines from standard input and copies the initial fields in each line to the files named by the remaining fields on the line. buffchan is intended...
ckpasswd
ckpasswd is the basic password authenticator for nnrpd, suitable for being run from an auth stanza in readers.conf. See readers.conf(5) for more information on...
cnfsheadconf
cnfsheadconf reads pathetc/cycbuff.conf and pathetc/storage.conf to determine which CNFS buffers are available. It then reads all of them or the specified...
cnfsstat
cnfsstat reads pathetc/cycbuff.conf and pathetc/storage.conf to determine which CNFS buffers are available. It then reads the specified cyclic buffers and shows...
controlchan
controlchan removes the responsibility for handling control messages (except cancels) from innd and instead processes them from a channel or file feed. The two...
ctlinnd
ctlinnd sends a message to the control channel of innd(8), the main InterNetNews daemon. In the normal mode of behavior, the message is sent to the server...
cvtbatch
cvtbatch reads standard input as a sequence of lines, converts each line, and writes it to standard output. It is used to convert simple batch files that...
docheckgroups
docheckgroups is usually run by controlchan in order to process checkgroups control messages. It reads a list of newsgroups along with their descriptions on its...
domain
This program can be used in readers.conf to grant access based on the subdomain part of the remote hostname. In particular, it only returns success if the...
expire
expire scans the history(5)-format text file pathdb/history and uses the information recorded in it to purge itself of old news articles. Articles stored using...
expireover
expireover expires old entries from the news overview database. It reads in a list of newsgroups (by default from pathdb/active, but a different file can be...
expirerm
expirerm is a script that removes a list of files. The specified file lists the files to be removed. It is usually created by expire -z. This file is sorted...
filechan
Filechan reads lines from standard input and copies certain fields in each line into files named by other fields within the line. Filechan is intended to be...
ident
This program attempts to resolve usernames for nnrpd by using the ident protocol to query the remote host. It contacts the remote host using either IPv4 or IPv6...
innbind
innbind is a helper program that's not meant to be run directly. Instead, innd and nnrpd use it internally to bind to ports that require root privileges to bind...
inncheck
inncheck examines various configuration files and databases and verifies things about them. Things verified depend on the file being checked, but generally are...
innd
innd, the InterNetNews daemon, handles all incoming NNTP feeds, coordinates the storage, retransmission, and overview generation for all accepted articles, and...
inndf
inndf was originally a replacement for "df | awk" in innwatch.ctl(5) and innstat(8), and now also reports various other usage information about INN's storage...
innfeed
innfeed implements the NNTP protocol for transferring news between computers. It handles the standard IHAVE protocol as well as the CHECK/TAKETHIS streaming...
innreport
Innreport is a perl(1) script that summarizes INN log files. It is normally invoked by scanlogs(8). Supported programs are innd(8), innfeed(1), innxmit(8)...
innstat
The innstat script prints a snapshot of the INN system. It displays the operating mode of the server, as well as disk usage and the status of all log and lock...
innupgrade
innupgrade is intended to be run during a major upgrade of INN to fix the configuration files with any required changes. If given a directory, it will scan that...
innwatch
innwatch is normally started by rc.news. Every innwatchsleeptime seconds, as set in inn.conf, it examines the load average, and the number of free blocks and...
innxbatch
Innxbatch connects to the NNTP server at the specified host and sends it the specified xbatch files, using the XBATCH extension to the NNTP protocol. It is...
innxmit
innxmit connects to the NNTP server at the specified host (validating itself via passwd.nntp if possible) and sends it the articles specified in the batch file...
mailpost
The mailpost program reads a properly formatted e-mail message from stdin and feeds it to inews for posting to a news server. newsgroups is a...
makedbz
makedbz rebuilds dbz(3) database. The default name of the text file is pathdb/history; to specify a different name, use the -f flag.
makehistory
makehistory rebuilds the history(5) text file, which contains a list of message-IDs of articles already seen by the server. It can also be used to rebuild the...
mod-active
mod-active is a Perl script that updates the active file based on its input lines of ctlinnd "newgroup", "rmgroup" and "changegroup" commands. It pauses the...
news2mail
news2mail runs as a channel process underneath innd. It is set up as channel feed in newsfeeds, with different mailing-lists as funnel entries pointing to it...
news.daily
news.daily performs a number of important Usenet administrative functions.
ninpaths
This is an efficient and space-saving inpaths reporting program. It works as follows: you feed it the Path: lines via an INN channel feed or some other similar...
nnrpd
nnrpd is an NNTP server for newsreaders. It accepts commands on its standard input and responds on its standard output. It is normally invoked by innd(8) with...
nntpsend
nntpsend is a front-end that invokes innxmit to send Usenet articles to a remote NNTP site. The sites to be fed may be specified by giving sitename fqdn pairs...
ovdb_init
This command must be run before any other process can access the overview database.
ovdb_monitor
When started (by "ovdb_init"), "ovdb_monitor" forks three processes that perform routine database maintenance tasks. These are: transaction checkpointing...
ovdb_server
If the "readserver" parameter in ovdb.conf is true, "ovdb_init" will start "ovdb_server". "ovdb_server" opens the overview database, and accesses it on behalf...
ovdb_stat
ovdb_stat displays information from the ovdb database: Berkeley DB statistics, newsgroup data, and overview records; and optionally outputs in HTML format.
overchan
overchan reads overview data from the specified files or from standard input if no files are specified, and writes that data into the INN overview database...
perl-nocem
NoCeM, which is pronounced No See 'Em, is a protocol enabling authenticated third-parties to issue notices which can be used to cancel unwanted articles (like...
procbatch
procbatch will take an INN funnel or innfeed-dropped file and split it up by host for direct processing with innfeed or innxmit. While funnel files will...
prunehistory
prunehistory modifies a history(5)-format text file to "remove" a set of tokens from it. The tokens are removed by overwriting them with spaces, so that the...
radius
radius is an nnrpd authenticator, accepting a username and password from nnrpd (given to nnrpd by a reader connection) and attempting to authenticate that...
rc.news
rc.news can be used to start or stop innd and supporting programs. It checks to make sure INN is not already running, handles cases of unclean shutdown...
scanlogs
scanlogs summarizes the information recorded in the INN log files which reside in the pathlog directory set in inn.conf (see newslog(5) for further details...
scanspool
scanspool is a Perl script for use with a tradspool article spool. It will scan the active file as well as all articles in the spool and report on the errors it...
sendinpaths
sendinpaths checks pathlog/path for ninpaths dump files, finds dump files generated in the past report-days days, makes sure they are valid by running ninpaths...
send-nntp
The send-* utilities are scripts that process the batch files written by innd(8) to send Usenet articles to a remote NNTP site. The sites to be fed may be...
send-uucp
The send-uucp program processes batch files written by innd(8) to send Usenet articles to UUCP sites. It reads a configuration file to control how it behaves...
tally.control
tally.control is normally daily invoked by scanlogs. It reads its standard input, which should be the newgroup.log and rmgroup.log control log files. They...
tdx-util
tdx-util is an administrative interface to the tradindexed overview method for INN. It only works on tradindexed overview databases, not on any other type of...
tinyleaf
tinyleaf is intended to be the simplest possible transit news server that still does something useful. It must be run under inetd(8) or some equivalent, and...
writelog
The writelog script is used to write a log entry or send it as mail. The name parameter specifies the name of the log file where the entry should be written. If...