IN.HOSTS(5)

NAME
in.hosts - newsx incoming host state

DESCRIPTION

The in.hosts directory contains the necessary state information for the incoming news streams fetched by newsx(8).

For each incoming news source, there must be a /var/news/spool/inhosts/spoolname file that describes what the latest article is that has been fetched from that particular host.

If you want to get all news articles in all the groups defined at your local server, do nothing and let the file be constructed automatically. Other choices, such as using multiple cron(8) entries and newsx(8) end tags to control when certain newsgroups are fetched, or using .newsrc article numbers to avoid fetching articles you've already seen, require setting up the in.hosts file for the server by hand.

The format of this file is simple:

Blank lines and lines starting with a '#' are treated as comments.

Lines starting with a ':' indicate a tag for use with the newsx -e (end tag) option.

Otherwise, each line consists of a newsgroup name and the first unread article number, separated by whitespace. No article number is the same as zero, meaning that all available articles on the server will be read.

It is important to realize that there is one unique file belonging to each remote newsserver, and that they should not be mixed.

If switching from reading news via an NNTP newsreader to fetching with newsx, it is possible to use an existing .newsrc file directly as the initial /var/news/spool/inhosts/spoolname file.

FILES

/var/news/spool/inhosts/spoolname
    Incoming host state file. There should be one of these per external news server.

/var/news/spool/inhosts/spoolname.tmp
    Incoming spool, temporary (while news is being pulled).

/var/news/spool/inhosts/spoolname.old
    Previous generation of the external host state file.

/var/news/spool/articles/in.hosts/spoolname.conf
    Standard profile for specific newsspool. See newsx.conf(5) for file format.

AUTHOR
Egil Kvaleberg <egil@kvaleberg.no>

SEE ALSO
newsx(8)