NAME

slrnpull - Pull a small newsfeed for offline reading.

SYNOPSIS

slrnpull [-d spooldir] [-h server] [--debug file] [--expire] [--fetch-score n] [--help] [--kill-log file] [--kill-score n] [--logfile file] [--marked-bodies] [--new-groups] [--no-post] [--post] [--post-only] [--rebuild] [--version]

DESCRIPTION

slrnpull pulls a small newsfeed from an NNTP server. It puts the articles into a spool directory from which slrn can later read them, even if the server is unreachable at that time. Typically, this is useful if you do not have a permanent network connection.

OPTIONS

The following options can be used when calling slrnpull from the command line.

-d spooldir: Set slrnpull's root directory for this run to spooldir, overriding the $SLRNPULL_ROOT environment variable.
-h host[:port]: Connect to the NNTP server on host, overriding the $NNTPSERVER environment variable. If no port is given, the default NNTP port (119) will be used.
--debug file: Write dialogue with the server and some additional debugging output to file.
--expire: Expire (remove) old messages from the spool, but do not fetch news.
--fetch-score n: Fetch article bodies with a score of at least n automatically (in true offline mode, the default is to fetch only bodies that were explicitly marked by the user).
--help: Show help for command line switches.
--kill-log file: Keep a log of all articles that were killed by the scorefile in file. By default, no such logfile is created.
--kill-score n: Kill all articles with a score below n. The default value for this is 0.
--logfile file: Log the messages and errors that slrnpull prints to the screen to file. By default, they get written to the file log in slrnpull's root directory.
--marked-bodies: Only fetch bodies that were marked for download within slrn.
--new-groups: Check for new groups, appending them to the file new.groups in the data directory.
--no-post: Do not post any articles to the server.
--post: Obsolete version of --post-only.
--post-only: Post outgoing articles, but do not fetch news.
--rebuild: Like --expire, but also rebuild the overview information. To be used when the overview information is damaged.
--version: Print the version number.

ENVIRONMENT

slrnpull reads the following environment variables. Note that they can be overridden by command line switches.

NNTPSERVER: You can use this variable to tell slrnpull which NNTP server to connect to. It can be overridden by the command line option -h.
SLRNPULL_ROOT: Defines the directory where slrnpull will look for its configuration files and spool the articles. An absolute filename is needed here. This can be overriden by the option -d.

FILES

$SLRNPULL_ROOT/authinfo: If the server requires authentication, this file needs to contain the data (username in the first line, password in the second). Be careful not to make this file world-readable!
$SLRNPULL_ROOT/log: The default file to log status and error messages to.
$SLRNPULL_ROOT/score: If you want slrnpull to apply scoring rules to decide which articles to download, put them into this file.
$SLRNPULL_ROOT/slrnpull.conf: The main configuration file. It tells slrnpull how many articles to get from which groups and when to expire them.

AUTHOR

John E. Davis <davis@space.mit.edu>

Please send any bug reports to the current maintainer, Thomas Schultz <tststs@gmx.de>