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.
SEE ALSO¶
The documentation that comes with
slrnpull, especially README and SETUP.
The FAQ of slrn also answers some questions about slrnpull.
You might also want to look at slrn's official home page,
http://slrn.sourceforge.net/ or post to
news.software.readers if
you have a question not covered by existing documentation.
The latest version of
slrnpull is part of the slrn package available from
http://prdownloads.sourceforge.net/slrn/
AUTHOR¶
John E. Davis <davis@space.mit.edu>
Please send any bug reports to the current maintainer, Thomas Schultz
<tststs@gmx.de>