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)