GSP
Quick Navigator

Search Site

Unix VPS
A - Starter
B - Basic
C - Preferred
D - Commercial
MPS - Dedicated
Previous VPSs
* Sign Up! *

Support
Contact Us
Online Help
Handbooks
Domain Status
Man Pages

FAQ
Virtual Servers
Pricing
Billing
Technical

Network
Facilities
Connectivity
Topology Map

Miscellaneous
Server Agreement
Year 2038
Credits
 

USA Flag

 

 

Man Pages


Manual Reference Pages  -  NEWSCACHE (8)

NAME

newscache - Cache for Network News Transport Protocol (NNTP)

CONTENTS

Synopsis
Description
Options
Signals
Notes
Diagnostics
Files
See Also
Authors
Reporting Bugs
Copyright

SYNOPSIS

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

DESCRIPTION

NewsCache is a free cache server for USENET News. NewsCache acts to news reading clients like a news server, except that it stores only those articles that have been requested by at least one client. NewsCache targets problems of the current News System like network bandwidth consumption or the IO load caused by news clients. NewsCache acts to the upstream news server like a news reader programm.

It supports principles the following modes (for a detailed description read ServerSpec Configuration Options below):
cached
  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.
not-cached
  NewsCache act as a "proxy" and does’nt store retrieved article in his local cache. This is usefull for combined multiple local newsserver configuration.
offline
  NewsCache does’nt 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.
semi-offline, cached
  The overview informations are loaded with updatenews(8) and the articles retrieved by NewsCache, if a news reader client request it. The article is stored in the internal cache.

OPTIONS

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
-i --inetd
  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.

SIGNALS

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.

SIGHUP

This signal instruct NewsCache to reread its configuration file /usr/local/etc/newscache.conf .

NOTES

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

DIAGNOSTICS

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).

FILES

/usr/local/etc/newscache.conf
/usr/local/sbin/newscache
/usr/local/sbin/newscacheclean
/usr/local/sbin/newscacheclean
/usr/local/sbin/updatenews

SEE ALSO

newscache.conf(5), newscacheclean(8), updatenews(8).

AUTHORS

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

REPORTING BUGS

Report bugs to <newscache@linuxhacker.org>.

COPYRIGHT

NewsCache is released under the GNU General Public License (GPL). There is NO warranty; not even for MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.

Search for    or go to Top of page |  Section 8 |  Main Index


--> NEWSCACHE (8) June 2004

Powered by GSP Visit the GSP FreeBSD Man Page Interface.
Output converted with manServer 1.07.