slrnpull(1)                      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 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>



Unix                            September 2004                     slrnpull(1)
