man pages section 1: User Commands

Exit Print View

Updated: July 2014

slrnpull (1)


slrnpull - Pull a small newsfeed for offline reading.


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]


User Manuals                                          slrnpull(1)

     slrnpull - Pull a small newsfeed for offline reading.

     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]

     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.

     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 (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

          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-

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.

          Only fetch bodies that were marked for download  within

          Check  for  new  groups,  appending  them  to  the file
          new.groups in the data directory.

          Do not post any articles to the server.

          Obsolete version of --post-only.

          Post outgoing articles, but do not fetch news.

          Like --expire, but also rebuild the  overview  informa-
          tion.  To be used when the overview information is dam-

          Print the version number.

     slrnpull reads the following  environment  variables.   Note
     that they can be overridden by command line switches.

          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.

          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.


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

          The default file to log status and error messages to.

          If  you  want slrnpull to apply scoring rules to decide
          which articles to download, put them into this file.

          The main configuration file.   It  tells  slrnpull  how
          many  articles  to  get  from  which groups and when to
          expire them.

     See  attributes(5)  for  descriptions   of   the   following

     |Availability   | network/nntp/slrn |
     |Stability      | Uncommitted       |
     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, or post to
     ers  if you have a question not covered by existing documen-

     The latest version of slrnpull is part of the  slrn  package
     available from

     John E. Davis <>

     Please  send  any  bug  reports  to  the current maintainer,
     Thomas Schultz <>

Unix               Last change: September 2004                  3

User Manuals                                          slrnpull(1)

     This  software  was   built   from   source   available   at    The  original
     community       source       was       downloaded       from

     Further  information about this software can be found on the
     open  source  community   website   at   http://slrn.source-

Unix               Last change: September 2004                  4