It supports principles the following modes (for a detailed description read ServerSpec Configuration Options below):
|NewsCache store every retrieved article in his internal cache. If this article is retrieved by another news reader client, then NewsCache can get the article from his cache instead of retrieving this article again from the upstream newsserver.|
|NewsCache act as a "proxy" and doesnt store retrieved article in his local cache. This is usefull for combined multiple local newsserver configuration.|
|NewsCache doesnt connect to the upstream newsserver. Only the specified newsgroups are retrieved by updatenews(8) and stored in the cache. This is usefull in dialup configurations. The news reader clients can only access this newsgroups.|
The overview informations are loaded with
and the articles retrieved by NewsCache, if a news reader client request it. The article is stored in the internal cache.
This program follows the usual GNU command line syntax, with long options starting with two dashes (-). A summary of options is included below. For a complete description, see the Info files.
-h, --help Show summary of options. -v, --version Show version of program. -f --fqdn Print what newscache thinks is the fully qualified domain name. -c --configuration config-file
newscache is used with inetd and read from stdin. -d --debug Do not detach. -p --print-parameter Print current parameter settings. -o --configuration-options Print all options specified in the configure phase.
SIGTERM, SIGQUIT, SIGINT, SIGPIPE
These signals instruct NewsCache to abort any existing transfers, close all connections and terminate the process. If the target of the signal is the daemon, all current child processes wil also be terminated.
This signal instruct NewsCache to reread its configuration file /usr/local/etc/newscache.conf .
Running NewsCache in inetd mode requires a correct inetd configuration. An example configuration line looks like:
news stream tcp nowait news /usr/sbin/newscache -i
NewsCache logs diagnostics messages with the syslog priority debug. If NewsCache is configured with the --enabe-debug option, he produce much more messages (for details see the INSTALL file). newscache -o prints out the actual configuration parameter. In some error situation you can try to create a core dump file or debug a client process with gdb (for details see the documentation directory).
1997-2000 Thomas Gschwind <firstname.lastname@example.org>
2001-2004 Herbert Straub <email@example.com>
Report bugs to <firstname.lastname@example.org>.
NewsCache is released under the GNU General Public License (GPL). There is NO warranty; not even for MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.
|-->||NEWSCACHE (8)||June 2004|