1newscache(8)                System Manager's Manual               newscache(8)
2
3
4

NAME

6       newscache - Cache for Network News Transport Protocol (NNTP)
7

SYNOPSIS

9       newscache  [--version]  [-h]  [-v] [-f] [-c config-file] [-i] [-d] [-p]
10       [-o]
11

DESCRIPTION

13       NewsCache is a free cache server for USENET  News.  NewsCache  acts  to
14       news  reading  clients  like  a news server, except that it stores only
15       those articles that have been requested by at least one  client.  News‐
16       Cache  targets  problems  of the current News System like network band‐
17       width consumption or the IO load caused by news clients. NewsCache acts
18       to the upstream news server like a news reader programm.
19
20
21       It  supports principles the following modes (for a detailed description
22       read ServerSpec Configuration Options below):
23
24       cached NewsCache store every retrieved article in his  internal  cache.
25              If this article is retrieved by another news reader client, then
26              NewsCache can get the article from his cache instead of retriev‐
27              ing this article again from the upstream newsserver.
28
29       not-cached
30              NewsCache  act  as a "proxy" and does'nt store retrieved article
31              in his local cache. This is usefull for combined multiple  local
32              newsserver configuration.
33
34       offline
35              NewsCache  does'nt  connect to the upstream newsserver. Only the
36              specified newsgroups are retrieved by updatenews(8)  and  stored
37              in the cache. This is usefull in dialup configurations. The news
38              reader clients can only access this newsgroups.
39
40       semi-offline, cached
41              The overview informations are loaded with updatenews(8) and  the
42              articles retrieved by NewsCache, if a news reader client request
43              it. The article is stored in the internal cache.
44
45

OPTIONS

47       This program follows the usual  GNU  command  line  syntax,  with  long
48       options  starting  with  two  dashes  (`-').   A  summary of options is
49       included below.  For a complete description, see the Info files.
50
51       -h, --help
52              Show summary of options.
53
54       -v, --version
55              Show version of program.
56
57       -f --fqdn
58              Print what newscache thinks is the fully qualified domain name.
59
60       -c --configuration config-file
61
62       -i --inetd
63              newscache is used with inetd and read from stdin.
64
65       -d --debug
66              Do not detach.
67
68       -p --print-parameter
69              Print current parameter settings.
70
71       -o --configuration-options
72              Print all options specified in the configure phase.
73
74

SIGNALS

76       SIGTERM, SIGQUIT, SIGINT, SIGPIPE
77
78              These signals instruct NewsCache to abort  any  existing  trans‐
79              fers,  close  all  connections and terminate the process. If the
80              target of the signal is  the  daemon,  all  current  child  pro‐
81              cesses wil also be terminated.
82
83
84       SIGHUP
85
86              This  signal instruct NewsCache to reread its configuration file
87              /etc/newscache.conf
88
89

NOTES

91       Running NewsCache in inetd mode requires a correct inetd configuration.
92       An example configuration line looks like:
93
94       news stream tcp nowait news /usr/sbin/newscache -i
95

DIAGNOSTICS

97       NewsCache  logs diagnostics messages with the syslog priority debug. If
98       NewsCache is configured with the --enabe-debug option, he produce  much
99       more  messages (for details see the INSTALL file).  newscache -o prints
100       out the actual configuration parameter.  In some  error  situation  you
101       can  try  to create a core dump file or debug a client process with gdb
102       (for details see the documentation directory).
103
104

FILES

106       /etc/newscache.conf
107       /usr/sbin/newscache
108       /usr/sbin/newscacheclean
109       /usr/sbin/newscacheclean
110       /usr/sbin/updatenews
111
112

SEE ALSO

114       newscache.conf(5), newscacheclean(8), updatenews(8).
115
116

AUTHORS

118       1997-2000 Thomas Gschwind <tom@infosys.tuwien.ac.at>
119       2001-2004 Herbert Straub <h.straub@aon.at>
120
121

REPORTING BUGS

123       Report bugs to <newscache@linuxhacker.org>.
124
125
127       NewsCache is released under  the  GNU  General  Public  License  (GPL).
128       There  is  NO  warranty;  not even for MERCHANTABILITY or FITNESS FOR A
129       PARTICULAR PURPOSE.
130
131
132
133
134                                   June 2004                      newscache(8)
Impressum