1slrnpull(1) User Manuals slrnpull(1)
2
6 slrnpull - Pull a small newsfeed for offline reading.
7
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
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
22 The following options can be used when calling slrnpull from the com‐
23 mand line.
24 -d spooldir
26 Set slrnpull's root directory for this run to spooldir, overrid‐
27 ing the $SLRNPULL_ROOT environment variable.
28 -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 --debug file
35 Write dialogue with the server and some additional debugging
36 output to file.
37 --expire
39 Expire (remove) old messages from the spool, but do not fetch
40 news.
41 --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 --help Show help for command line switches.
48 --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 --kill-score n
54 Kill all articles with a score below n. The default value for
55 this is 0.
56 --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 --marked-bodies
63 Only fetch bodies that were marked for download within slrn.
64 --new-groups
66 Check for new groups, appending them to the file new.groups in
67 the data directory.
68 --no-post
70 Do not post any articles to the server.
71 --post Obsolete version of --post-only.
73 --post-only
75 Post outgoing articles, but do not fetch news.
76 --rebuild
78 Like --expire, but also rebuild the overview information. To be
79 used when the overview information is damaged.
80 --version
82 Print the version number.
83
86 slrnpull reads the following environment variables. Note that they can
87 be overridden by command line switches.
88 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 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
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 $SLRNPULL_ROOT/log
105 The default file to log status and error messages to.
106 $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 $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
117 The documentation that comes with slrnpull, especially README and SET‐
118 UP. The FAQ of slrn also answers some questions about slrnpull.
119 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 The latest version of slrnpull is part of the slrn package available
125 from http://prdownloads.sourceforge.net/slrn/
126
128 John E. Davis <davis@space.mit.edu>
129 Please send any bug reports to the current maintainer, Thomas Schultz
131 <tststs@gmx.de>
132Unix September 2004 slrnpull(1)