pullnews

Langue: en

Version: 51867 (openSuse - 09/10/07)

Autres sections - même nom

Section: 8 (Commandes administrateur)

NAME

pullnews - a perl script for pulling news from one news machine and feeding it to another.

SYNOPSIS

pullnews [ -c config ] [ -g groups ] [ -h ] [ -p port ] [ -q ] [ -r file ] [ -s downstream-server ] [ 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 config
Normally the config file is stored in $HOME/.pullnews for the user running the pullnews program. The ``-c'' flag lets you change that.
-g groups
The ``-g'' flag specifies a collection of groups to get. The value must be a single argument with commas between group names. Each group must be defined in the config file. Only the remote hosts that carry those groups will be contacted.
-h
The ``-h'' flag just prints usage.
-p port
The ``-p'' flag can be used to change connecting port to something other than 119.
-q
The ``-q'' flag can be used to make things run more quietly.
-r file
The ``-r'' flag tells pullnews to create an rnews-compatible file, instead of feeding articles.
-s downstream-server
Normally pullnews will feed the articles it retrieves to the news server running on ``localhost''. The ``-s'' flag lets you change that.

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 come 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, whereas the two comp.* groups were just inserted by the user and have not yet been checked.

HISTORY

pullnews was written by James Brister for INN. This is revision 1.4, dated 2002/12/03.

BUGS

pullnews is very simple and is lacking in more sophisticated features (like killing articles based on user-defined conditions) that better pull feeders 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

ctlinnd(8), inn.conf(5), innd(8), newsfeeds(5), shlock(1).