1slrnpull(1)                      User Manuals                      slrnpull(1)
2
3
4

NAME

6       slrnpull - Pull a small newsfeed for offline reading.
7

SYNOPSIS

9       slrnpull    [-d spooldir]    [-h server]    [--debug file]   [--expire]
10       [--fetch-score n] [--help] [--kill-log file] [--kill-score  n]  [--log‐
11       file file]   [--marked-bodies]   [--new-groups]   [--no-post]  [--post]
12       [--post-only] [--rebuild] [--version]
13
14

DESCRIPTION

16       slrnpull pulls a small newsfeed from an NNTP server.  It puts the arti‐
17       cles  into  a spool directory from which slrn can later read them, even
18       if the server is unreachable at that time.  Typically, this  is  useful
19       if you do not have a permanent network connection.
20

OPTIONS

22       The  following  options can be used when calling slrnpull from the com‐
23       mand line.
24
25       -d spooldir
26              Set slrnpull's root directory for this run to spooldir, overrid‐
27              ing the $SLRNPULL_ROOT environment variable.
28
29       -h host[:port]
30              Connect  to  the NNTP server on host, overriding the $NNTPSERVER
31              environment variable.  If no port is  given,  the  default  NNTP
32              port (119) will be used.
33
34       --debug file
35              Write  dialogue  with  the  server and some additional debugging
36              output to file.
37
38       --expire
39              Expire (remove) old messages from the spool, but  do  not  fetch
40              news.
41
42       --fetch-score n
43              Fetch  article  bodies  with a score of at least n automatically
44              (in true offline mode, the default is to fetch only bodies  that
45              were explicitly marked by the user).
46
47       --help Show help for command line switches.
48
49       --kill-log file
50              Keep  a log of all articles that were killed by the scorefile in
51              file.  By default, no such logfile is created.
52
53       --kill-score n
54              Kill all articles with a score below n.  The default  value  for
55              this is 0.
56
57       --logfile file
58              Log  the  messages and errors that slrnpull prints to the screen
59              to file.  By default, they get written to the file log in  slrn‐
60              pull's root directory.
61
62       --marked-bodies
63              Only fetch bodies that were marked for download within slrn.
64
65       --new-groups
66              Check  for  new groups, appending them to the file new.groups in
67              the data directory.
68
69       --no-post
70              Do not post any articles to the server.
71
72       --post Obsolete version of --post-only.
73
74       --post-only
75              Post outgoing articles, but do not fetch news.
76
77       --rebuild
78              Like --expire, but also rebuild the overview information.  To be
79              used when the overview information is damaged.
80
81       --version
82              Print the version number.
83
84

ENVIRONMENT

86       slrnpull reads the following environment variables.  Note that they can
87       be overridden by command line switches.
88
89       NNTPSERVER
90              You can use this variable to tell slrnpull which NNTP server  to
91              connect to.  It can be overridden by the command line option -h.
92
93       SLRNPULL_ROOT
94              Defines  the directory where slrnpull will look for its configu‐
95              ration files and spool the articles.  An  absolute  filename  is
96              needed here.  This can be overriden by the option -d.
97

FILES

99       $SLRNPULL_ROOT/authinfo
100              If  the  server requires authentication, this file needs to con‐
101              tain the data (username in the first line, password in the  sec‐
102              ond).  Be careful not to make this file world-readable!
103
104       $SLRNPULL_ROOT/log
105              The default file to log status and error messages to.
106
107       $SLRNPULL_ROOT/score
108              If  you  want  slrnpull  to  apply scoring rules to decide which
109              articles to download, put them into this file.
110
111       $SLRNPULL_ROOT/slrnpull.conf
112              The main configuration file.  It tells slrnpull how  many  arti‐
113              cles to get from which groups and when to expire them.
114
115

SEE ALSO

117       The  documentation that comes with slrnpull, especially README and SET‐
118       UP. The FAQ of slrn also answers some questions about slrnpull.
119
120       You  might  also  want  to  look  at   slrn's   official   home   page,
121       http://slrn.sourceforge.net/  or  post  to news.software.readers if you
122       have a question not covered by existing documentation.
123
124       The latest version of slrnpull is part of the  slrn  package  available
125       from http://prdownloads.sourceforge.net/slrn/
126

AUTHOR

128       John E. Davis <davis@space.mit.edu>
129
130       Please  send  any bug reports to the current maintainer, Thomas Schultz
131       <tststs@gmx.de>
132
133
134
135Unix                            September 2004                     slrnpull(1)
Impressum