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.
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... 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... 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... 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...