PULLNEWS (8)
a perl script for pulling news from one news machine and feeding it
to another.
SYNOPSIS
pullnews
[
-c config
]
[
-s downstream-server
]
[
-q
]
[ remote-server ... ]
DESCRIPTION
pullnews
is run as a regular user process. It reads a config file in the users
home directory (normally called
.pullnews )
and connects to the upstream servers
defined in there as a reader client. You may specifiy hostnames on the command
line to limit the set of remote hosts it connects to, but each host must be
listed in the
.pullnews
file.
For each server it connects to it pulls
over articles and feeds them to the downstream (local) server via the IHAVE
(feeder) NNTP command. This means the computer
pullnews
is run on must have
feeding access to the downstream news host.
pullnews
is designed for very small sites and is not meant for reverse-feeding large
feeds.
You must have Graham Barr's Net::NNTP perl module installed on your
system. This is part of the libnet bundle and can be found on CPAN or from
Graham's site http://www.connect.net/gbarr/
OPTIONS
-c
Normally the config file is stored in $HOME/.pullnews for the user running the
pullnews
program. The ``-c'' flag lets you change that.
-s
Normally
pullnews
will feed the articles it retrieves to the news server running on
``localhost''. The ``-s'' flag lets you change that.
-q
The ``-q'' flag can be used to make things run more quietly.
CONFIG FILE
The config file for
pullnews
is a series of sets of lines describing the upstream hosts to connect to and
the newsgroups to get articles from. A host line has no leading white space and
just has the name of the host to connect to. Group lines com after a host line
and have leading white space followed by the group name.
pullnews
will update the config file to include the time the group was last checked and
the highest numbered article successfully retrieved and transfered to the
downstream server.
A sample configuration file might look like:
# Format group date high
data.pa.vix.com
rec.bicycles.racing 908086612 783
rec.humor.funny 908086613 18
comp.programming.threads
nnrp.vix.com
comp.std.lisp
The group entries for the two rec.* groups have been updated by an earlier run
by
pullnews .
HISTORY
pullnews was written by James Brister for INN.
R$
This is revision \\$3, dated \\$4.
$Id: pullnews.8,v 1.1.2.1 1999/06/12 08:23:01 kondou Exp $
BUGS
pullnews
is very simple and is lacking in more sophisticated features (like killing
articles based on user-defined conditions) that better pull feeder most
certainly have. It also doesn't keep or log much detail on articles transferred.
Due to a limitation in the Net::NNTP perl module, one of the functions in there
is redefined inside the
pullnews
source. A future release of the libnet packages will fix that.
SEE ALSO
|