newscache(8)

📦 version 1.2, in fedora 43, fedora 44

💖 newscache — the NAME section, bestie

ok so newscache is a Cache for Network News Transport Protocol (NNTP). that's the whole vibe. caching. NNTP. slay.

✨ SYNOPSIS ✨

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

🌸 DESCRIPTION 🌸

so NewsCache is a free cache server for USENET News — iconic behavior tbh. here's the tea: to news reading clients, NewsCache looks exactly like a news server 🫶. except — plot twist — it only stores those articles that have been requested by at least one client. that's it. that's the whole trick.

what is it even for? it's targeting the problems of the current News System, like network bandwidth consumption or the IO load caused by news clients. and to the upstream news server? NewsCache acts like a news reader program. yes bestie, it's playing both sides and it's eating 💅.

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. literally the whole point ✨
  • 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. no internet, no problem 🦋
  • 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 — (no description given in the original, bestie — it's just config-file, so that's all we know 👀)
  • -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. it's giving "everybody out of the pool" 😭
  • SIGHUP — This signal instructs NewsCache to reread its configuration file /etc/newscache.conf. glow-up on demand, no restart needed ✨

🧚 NOTES 🧚

Running NewsCache in inetd mode requires a correct inetd configuration. do not skip this, it will not work, fr fr.

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 📁

  • /etc/newscache.conf
  • /usr/bin/newscache
  • /usr/bin/newscacheclean
  • /usr/bin/newscacheclean
  • /usr/bin/updatenews

(yes bestie, /usr/bin/newscacheclean really is listed twice in the original. we don't ask questions, we respect the source 💜)

👑 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>. tell them everything, they can handle it 🌈

NewsCache is released under the GNU General Public License (GPL). There is NO warranty; not even for MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. like, zero. none. don't come for them 💀

and that's the whole page, bestie 🎀 — this one came out of the System Manager's Manual as newscache(8), dated June 2004. go forth and cache responsibly. periodt 💅✨

📦 where this page comes from