slrnpull
(1)
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
User Manuals slrnpull(1)
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 perma-
nent 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 auto-
matically (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 cre-
ated.
Unix Last change: September 2004 1
User Manuals slrnpull(1)
--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 informa-
tion. To be used when the overview information is dam-
aged.
--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 com-
mand line option -h.
SLRNPULL_ROOT
Defines the directory where slrnpull will look for its
configuration files and spool the articles. An abso-
lute filename is needed here. This can be overriden by
the option -d.
FILES
$SLRNPULL_ROOT/authinfo
Unix Last change: September 2004 2
User Manuals slrnpull(1)
If the server requires authentication, this file needs
to contain the data (username in the first line, pass-
word 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.
ATTRIBUTES
See attributes(5) for descriptions of the following
attributes:
+---------------+-------------------+
|ATTRIBUTE TYPE | ATTRIBUTE VALUE |
+---------------+-------------------+
|Availability | network/nntp/slrn |
+---------------+-------------------+
|Stability | Uncommitted |
+---------------+-------------------+
SEE ALSO
The documentation that comes with slrnpull, especially
README and SETUP. The FAQ of slrn also answers some ques-
tions about slrnpull.
You might also want to look at slrn's official home page,
http://slrn.sourceforge.net/ or post to news.software.read-
ers if you have a question not covered by existing documen-
tation.
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>
Unix Last change: September 2004 3
User Manuals slrnpull(1)
NOTES
This software was built from source available at
https://java.net/projects/solaris-userland. The original
community source was downloaded from
ftp://space.mit.edu/pub/davis/slrn/slrn-0.9.9p1.tar.gz
Further information about this software can be found on the
open source community website at http://slrn.source-
forge.net/.
Unix Last change: September 2004 4