1newscache(8) System Manager's Manual newscache(8)
2
6 newscache - Cache for Network News Transport Protocol (NNTP)
7
9 newscache [--version] [-h] [-v] [-f] [-c config-file] [-i] [-d] [-p]
10 [-o]
11
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 It supports principles the following modes (for a detailed description
22 read ServerSpec Configuration Options below):
23 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 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 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 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
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 -h, --help
52 Show summary of options.
53 -v, --version
55 Show version of program.
56 -f --fqdn
58 Print what newscache thinks is the fully qualified domain name.
59 -c --configuration config-file
61 -i --inetd
63 newscache is used with inetd and read from stdin.
64 -d --debug
66 Do not detach.
67 -p --print-parameter
69 Print current parameter settings.
70 -o --configuration-options
72 Print all options specified in the configure phase.
73
76 SIGTERM, SIGQUIT, SIGINT, SIGPIPE
77 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 SIGHUP
85 This signal instruct NewsCache to reread its configuration file
87 /etc/newscache.conf
88
91 Running NewsCache in inetd mode requires a correct inetd configuration.
92 An example configuration line looks like:
93 news stream tcp nowait news /usr/sbin/newscache -i
95
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
106 /etc/newscache.conf
107 /usr/sbin/newscache
108 /usr/sbin/newscacheclean
109 /usr/sbin/newscacheclean
110 /usr/sbin/updatenews
111
114 newscache.conf(5), newscacheclean(8), updatenews(8).
115
118 1997-2000 Thomas Gschwind <tom@infosys.tuwien.ac.at>
119 2001-2004 Herbert Straub <h.straub@aon.at>
120
123 Report bugs to <newscache@linuxhacker.org>.
124
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 June 2004 newscache(8)