Go to main content

man pages section 1: User Commands

Exit Print View

Updated: July 2017
 
 

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]  [--log-
file file]   [--marked-bodies]   [--new-groups]   [--no-post]  [--post]
[--post-only] [--rebuild] [--version]

Description

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]  [--log-
       file 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 arti-
       cles  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 com-
       mand line.

       -d spooldir
              Set slrnpull's root directory for this run to spooldir, overrid-
              ing 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  slrn-
              pull'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 configu-
              ration 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 con-
              tain the data (username in the first line, password in the  sec-
              ond).  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  arti-
              cles 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 SET-
       UP. 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>



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.sourceforge.net/.



Unix                            September 2004                     slrnpull(1)