.TH fetchnews 8 "1.9.31.rel" leafnode \" -*- nroff -*- .\" DO NOT EDIT: DO NOT EDIT -- generated automatically by subst .\" .\" Written by Arnt Gulbrandsen and copyright 1995-96 Troll .\" Tech AS, Postboks 6133 Etterstad, 0602 Oslo, Norway, fax +47 22646949. .\" .\" Use, modification and distribution is allowed without limitation, .\" warranty, or liability of any kind. .\" .\" $Id: fetchnews.8.in,v 1.6 2002/08/22 15:25:24 ralf Exp $ .\" .\" hilit19 is stupid: " .SH BEZEICHNUNG fetchnews \- holen und senden von News via NNTP .SH SYNTAX .B fetchnews [\fB-v\fR] ... [\fB-x\fR \fIZahl\fR] [\fB-l\fR] [\fB-n\fR] [\fB-f\fR] [\fB-P\fR] .SH BESCHREIBUNG .B Leafnode ist ein USENET-Software-Paket, das für kleine Sites gedacht ist, wo es wenige User und nur geringe Festplatten-Kapazität gibt, aber trotzdem eine große Zahl von Gruppen gewünscht wird. .PP .B Leafnode ist so geschrieben, daß es Fehler selbständig reparieren und keinerlei manuelle Pflege benötigen soll. .PP .B Fetchnews (das bis Version 1.9.2 "fetch" hieß) ist das Programm, das neue Artikel vom Upstream-Server lädt und lokal geschriebene Artikel an diesen weiterreicht. .SH PARAMETER .TP .B -v Veranlaßt .B fetchnews , mehr Ausgaben zu produzieren (verbose = wortreich). Maximal vier .B -v \'s können angegeben werden, je mehr .B -v \'s, desto mehr Text wird ausgegeben. .TP .B -v Zeigt unkritische Fehler an. .TP .B -vv Zeigt alle Gruppen-Befehle an .TP .B -vvv Zeigt alle Artikel-Befehle an. .TP .B -vvvv Für Debugging-Zwecke. Erwarten Sie nicht, daß die zusätzlichen Ausgaben Sinn ergeben. .TP \fB-x\fR \fIZahl\fR Gehe Zahl Artikel zurück und lade fehlende Artikel vom Upstream-Server. .TP .B -l Verwende nur den ersten Upstream-Server (l = local). Dies erhöht die Geschwindigkeit des Vorganges erheblich. .TP .B -n Lösche die Verknüpfungen im Verzeichnis .I /var/spool/news/interesting.groups nicht. So kann das automatische Abbestellen von Newsgruppen unterbunden werden. .TP .B -f Löschen der Datei active.read. Dadurch wird die Liste der verfügbaren Newsgruppen vom Upstream-Server neu geladen (force). Dies sollte nur selten geschehen, da es einige Zeit benötigt. Siehe auf \fItimeout_active\fR in \fBleafnode\fR(8). .TP .B -P Sende nur die Artikel, die sich in .I /var/spool/news/out.going befinden und lade keine neuen Artikel vom Server. .SH Rückgabewert .BR fetchnews gibt den Wert 0 zurück, wenn es alle Server erreichen konnte und keine weiteren Fehler aufgetreten sind. Es gibt 2 zurück, wenn mindestens einer der Server nicht erreichbar waren, und 1 bei sonstigen Fehlern. .SH DATEIEN UND KONFIGURATION .TP /var/spool/news/leaf.node/active.read Diese Datei wird nach erfolgreichem Laden der Liste der verfügbaren Newsgruppen von den Upstream-Servern angelegt. Fehlt sie, so werden sie analog zum \fB-f\fR Parameter geladen. .PP Bitte lesen sie in .B leafnode (8) nach, um eine Aufstellung der weiteren betroffenen Dateien und der Konfigurationsmöglichkeiten von fetchnews zu erhalten. .SH ALGORITHMUS Dies ist eine kurze Beschreibung dessen, was .B fetchnews tut. .PP Zuerst sendet .B fetchnews , nachdem eine Verbindung mit dem Upstream-Server hergestellt wurde, alle Artikel, die sich in .I /var/spool/news/out.going befinden und Ausführungsrechte besitzen (u+x, executable flag), mittels .B POST Schlägt dieses Kommando fehl, wird der betreffende Artikel in das Verzeichnis .I /var/spool/news/failed.postings verschoben, das der Systemadministrator von Zeit zu Zeit aufräumen sollte. Die Dateien zurück nach .I /var/spool/news/out.going zu verschieben reicht aus, um die entsprechenden Artikel beim nächsten Lauf von .B fetchnews zu versenden. Das Ausführungsrecht (u+x) wird abgefragt, um das Versenden unvollständiger Artikel zu verhindern, die \fBleafnode\fR(8) zur gleichen Zeit empfängt. .PP Als nächstes empfängt .B fetchnews die Liste der vorrätigen Gruppen des Upstream-Servers mittels "LIST ACTIVE" und "LIST NEWSGROUPS" und fertigt daraus die von .B leafnode an (falls der Zeitraum timeout_active seit dem letzten Laden der Liste vergangen ist oder die Datei active.read nicht vorhanden ist; ansonsten wird die Liste mittels "NEWGROUPS" aktualisiert). .PP Zuletzt durchläuft .B fetchnews die Liste der Newsgruppen, indem es ein "GROUP-", ein XOVER (falls vom Server unterstützt) oder "XHDR Message-ID"- und eine Anzahl von "HEAD"- und "BODY"-Kommandos für jede Gruppe ausführt, die in letzter Zeit gelesen wurde. Dabei werden nur Artikel geholt die nicht älter als "maxage" Tage alt sind. Daher sollte in der Konfiguration maxage kleiner als expire bzw. groupexpire gesetzt werden, da die Artikel sonst beim nächsten Lauf von .BR texpire (8), sofort wieder gelöscht werden. .SH ANMERKUNGEN .B Fetchnews benutzt kein "NEWNEWS". "NEWNEWS" wird nicht eingesetzt, da dies oft eine große Belastung für den Upstream-Server darstellt. .PP Die einzige Möglichkeit, zu kontrollieren, welche Newsgruppen lokale Benutzer lesen können, besteht darin, welche Gruppen .B fetchnews beim Upstream-Server lesen kann. Dies beschränkt allerdings keine Crosspostings. Wenn Ihre Site groß genug ist, daß Sie den Zugriff auf Newsgruppen kontrollieren müssen, sollten Sie sich überlegen, einen Newsserver einzusetzen, der für große Sites geplant ist. .PP .B Fetchnews setzt seine UID auf "news", falls es von root gestartet wurde, und bricht ab, wenn es UID "news" nicht bekommen kann. .SH BUGS .B Fetchnews ignoriert "Supersedes"- und "Also-Cancel"-Header. Dies muß korrigiert werden. .PP .B Fetchnews löscht niemals eine Gruppe aus der Liste der aktiven Newsgruppen. .SH Entwicklung Ältere Versionen von .B fetchnews haben alle Artikel in out.going verschickt. Seit Version 1.9.23 versendet .B fetchnews nur noch Artikel in Dateien, deren Ausführungs-Bit (executable) gesetzt ist. .B Leafnode setzt dieses Bit nach einem vollständigen POST. Diese Änderung verhindert, daß unvollständige Artikel verschickt werden, falls .B leafnode einen Artikel erhält, während .B fetchnews gerade sendet. .SH AUTOR Die ersten Versionen von fetchnews wurden von Arnt Gulbrandsen unter dem Namen fetch geschrieben; Copyright 1995 Troll Tech AS, Postboks 6133 Etterstad, 0602 Oslo, Norway, fax +47 22646949. .PP Weiterentwickelt wurde fetch von Cornelius Krasel , Randolf Skerka und Markus Enzenberger . Copyright (an den Veränderungen) 1997-1999. .PP Deutsche Übersetzung: Alexander Reinwarth , ergänzt von Ralf Wildenhues. .SH SIEHE AUCH .BR leafnode (8), .BR newsq (1).