gup – Online in der Cloud

PROGRAMM:

NAME/FUNKTION

gup - A Group Update PProgramm, das Befehle per E-Mail akzeptiert, um eine Newsgroup zu bearbeiten
Abonnementdatei zur späteren Verwendung durch Nachrichtensysteme wie INN und C-Neuigkeiten.

SYNTAX

gup [-hvP] -ein aktiver_Pfad [-d home_directory] [-l log_path]
[-m Antwortheader] [-n newsgroups_path]
[-s Sites_Verzeichnis] [-M Mail_command]

BESCHREIBUNG

Der einzige Zweck von gup besteht darin, den mühsamen Prozess der Bearbeitung der Gruppenauswahl zu automatisieren
Muster, die in den News-Konfigurationsdateien definiert sind (z. B. „Newsfeeds“ für INN und „sys“
für C-Neuigkeiten).

Gup ist für Nachrichtenadministratoren von Nutzen, die übermäßig viel Zeit mit der Bearbeitung ihrer Nachrichten verbringen
News-Konfigurationsdateien auf Geheiß der Websites, die sie versorgen. Tatsächlich einmal gup ist installiert,
Es ist sehr wahrscheinlich, dass manuelle Bearbeitungen Ihrer „Newsfeeds“- oder „SYS“-Datei zu einem Problem werden
Sache aus der Vergangenheit.

Gup ist für die Installation als Mail-Server-Programm konzipiert, über das eingehende E-Mails weitergeleitet werden
std. Gup wird normalerweise aus einer .forward-Datei aufgerufen. Z.B:

"|/.../bin/gup -options...."

Jede Site hat einen Eintrag in der „config“-Datei, der Passwort- und E-Mail-Adressdetails enthält
und eine Gruppenauswahldatei namens „groups“, siehe CONFIG und GRUPPEN für weitere Informationen an.

Der News-Administrator jeder Site sendet Befehle per E-Mail an gup. Es sind Befehle einzuschließen
Gruppenmuster ausschließen und ausschließen, die aktuellen Muster für diese Site auflisten und die verfügbaren auflisten
Newsgroups; sehen BEFEHLE, für mehr Details.

Die Ergebnisse werden normalerweise per E-Mail an den konfigurierten Administrator der Site zurückgesendet. Jedoch
Unter bestimmten Umständen werden die Ergebnisse per Post an den Urheber oder die örtliche Behörde gesendet
Administrator; sehen WIRD BEARBEITET, für weitere Details.

Gup ändert nicht direkt die Steuerdateien des Nachrichtensystems (z. B. „Newsfeeds“ für INN).
Stattdessen muss ein einfaches Shell-Skript ausgeführt werden, um alle geänderten „Gruppen“ zu verketten.
Dateien zu einer entsprechend formatierten Datei für Ihr spezielles Nachrichtensystem zusammenfügen. (Eins
ist im Quellkit für INN enthalten).

Da jede Site speziell konfiguriert werden muss gupAuf die „config“-Datei von kann zugegriffen werden
auf Administratoren beschränkt, die in der Lage sind, ihre eigenen Gruppenmuster zu verwalten.

OPTIONAL

Optionen können in beliebiger Reihenfolge in der Befehlszeile angezeigt werden. Der wichtigste zu beachtende Punkt ist
dass alle definierten Pfade und Verzeichnisse normalerweise absolute Pfade sind, es sei denn, Sie
sind mit der Art und Weise bestens vertraut gup ändert Verzeichnisse während der Verarbeitung von a
mail (die mögliche Ausnahme hier ist das Sites_directory).

-a aktiver_Pfad
Der Pfad der aktiven Datei für Ihr Newssystem. Bevor Sie eine Newsgroup akzeptieren
in einem Befehl identifiziert, gup validiert die Gruppe anhand der aktiven Datei. Der
Der Befehl wird abgelehnt, wenn keine Übereinstimmung gefunden wird.

-d home_directory
Definiert gup's Home-Verzeichnis. Gup Änderungen an diesem Verzeichnis so schnell wie möglich vornehmen
nach dem Start. Wenn diese Option nicht vorhanden ist, wird das aktuelle Verzeichnis verwendet.
Gup sucht in seinem Home-Verzeichnis nach der Datei „config“.

-h Drucken Sie eine Hilfemeldung mit den Befehlszeilenoptionen aus und beenden Sie den Vorgang.

-l log_path
In diese Datei wird eine Aufzeichnung aller wichtigen Anfragen geschrieben. Wenn der Pfad ist
relativ, dann wird es relativ zu sein gup's Home-Verzeichnis; siehe die Option -d).
Gup muss in diese Datei schreiben können. Wenn die -l Die Option wird dann nicht verwendet gup
verwendet stderr. Dies ist für Testzwecke nützlich, wird aber in einem wahrscheinlich nicht von Nutzen sein
.forward-Datei.

-m Antwortheader
Wann gup Wenn eine E-Mail-Antwort generiert wird, wird nur die Headerzeile „An:“ generiert.
Diese Option definiert den Pfad einer Datei, die andere RFC882-konforme Header enthält
Zeilen, die an das Mailprogramm weitergeleitet werden (siehe Option -M). In der Tat, wenn dies der Fall ist
Wenn die Datei nach den Kopfzeilen einen Hauptteil enthält, steht dieser vor dem Text
Erzeugt durch gup. Wenn dieser Pfad kein absoluter Pfad ist, wird er als Pfad behandelt
relativ zu gupist das Home-Verzeichnis (siehe die Option -d).

-M Mail_command
Gup leitet die RFC822-Header und den Text der E-Mail an die angegebene E-Mail weiter
Programm. Normalerweise wird dies wann konfiguriert gup installiert ist, kann aber über-
mit dieser Option gefahren. Der Mail-Befehl muss den Empfänger ermitteln können
Adressen aus den RFC822-Headern.

-n newsgroups_path
Falls vorhanden, wird die Newsgroups-Datei verwendet, um eine passende Beschreibung zu finden
Newsgroup, wenn aufgeführt.

-P Do nicht Entfernen Sie überflüssige Muster aus der „Gruppen“-Datei einer Site. Vor dem Schreiben des
aktualisierte „Gruppen“-Datei, gup wendet einen ziemlich strengen Test auf die Muster an,
Beschneiden aller unsinnigen oder unnötigen Muster. Dieser Beschneidungsprozess kann ziemlich lang sein
CP so intensiv, dass es schädliche Auswirkungen auf Ihr System haben kann -
daher die Möglichkeit, es zu deaktivieren.

-s Sites_directory
Die „Gruppen“- und „Ausschluss“-Dateien jeder Site befinden sich in einem eindeutigen Verzeichnis für
jede Seite. Diese Site-Verzeichnisse befinden sich in dem hier definierten Verzeichnis
Möglichkeit. Wenn dieser als relativer Pfad angegeben wird, ist er relativ zu gupist zu Hause
Verzeichnis (siehe die Option -d). Gup Ich werde versuchen, dieses Verzeichnis zu erstellen, wenn dies der Fall ist
nicht existieren.

-v Geben Sie die Versionsnummer und verschiedene Variablen zur Kompilierungszeit aus und beenden Sie den Vorgang.

BEFEHLE

Gup Durchsucht den E-Mail-Text nach Befehlen. Leerzeilen und alle nachfolgenden Daten werden ignoriert
Das Zeichen „#“ gilt als Kommentar. Eine Fortsetzung ist nicht erlaubt. Viele der
Befehle akzeptieren ein Muster als Parameter. Dieses Muster ist identisch mit dem Format des
wildmat()-Muster; sehen Wildmatte (3) ). Eigentlich, Gup nutzt absichtlich die Wildmatte Routine
von INN, um sicherzustellen, dass die Mustervergleichsmerkmale identisch sind.

Gültige Befehle sind:

site Site-Name Passwort
Dieser sollen sei der erste Befehl in der Mail. Site-Name und Passwort muss mit einem übereinstimmen
Eintrag in der „config“-Datei. Einziger site Der Befehl ist per E-Mail zulässig. Aliase:
„open“ und „host“.

verlassen Dieser Befehl stoppt gup von der Bearbeitung der restlichen Post abhängen. Dies ist nützlich, wenn Sie
Der Mail-Benutzeragent neigt dazu, automatisch eine Signaturdatei an Ihre E-Mail anzuhängen. Alias:
"Q".

das Anleitungen
Die Anleitungen wird mit der aktiven Datei verglichen. Wenn es mit mindestens einem übereinstimmt
Newsgroup, die Anleitungen wird am Ende der „Gruppen“-Datei der Site als platziert
das Eintrag. Einziger Anleitungen für das Befehl ist erlaubt. Wenn das Muster
stimmt mit irgendetwas in der Ausschlussliste der Site überein (siehe AUSSCHLÜSSE) dann das Include
wird versagen. Aliase: „+“ und „inc“.

ausschließen Anleitungen
Die Anleitungen wird mit der aktiven Datei verglichen. Wenn es mit mindestens einem übereinstimmt
Newsgroup, die Anleitungen wird am Ende der „Gruppen“-Datei der Site als platziert
ausschließen Eintrag. Einziger Anleitungen für ausschließen Befehl ist erlaubt. Aliase: „-“ und
„exc“.

Gift Anleitungen
Besitzt das Anleitungen stimmt mit mindestens einer Crossposting-Newsgruppe überein, in der der Artikel nicht enthalten sein wird
akzeptiert, auch wenn dies von einem erlaubt wird das Stellungnahme. Einziger Anleitungen für Gift
Befehl ist erlaubt.

Hilfe Generieren Sie eine kleine Hilfemeldung, die jeden Befehl kurz beschreibt. Da ist ein
impliziert das Beenden mit dem Hilfebefehl, sodass es keinen Sinn macht, danach Befehle zu platzieren
der Hilfebefehl. Alias: „h“.

Liste Listen Sie alle aktuellen auf das und ausschließen Muster in der „Gruppen“-Datei der Site.
Die Ausgabe erfolgt in einem Format, das für die Rückführung geeignet ist gup zu einem späteren Zeitpunkt, wenn
muss sein. Alias: „l“.

löschen Anleitungen
Lösche alles das, ausschließen und Gift Muster in der „Gruppen“-Datei der Site
verbinde die Anleitungen. „delete *“ ist eine effektive Möglichkeit, alle aktuellen Dateien zu löschen
Muster.

Newsgroups Anleitungen
Dieser Befehl listet alle verfügbaren Newsgroups aus der aktiven Datei auf, die mit dem übereinstimmen
Anleitungen. Die Liste enthält die Beschreibung aus der Newsgroups-Datei sowie eine
Zeigt an, ob die Site derzeit bei dieser Gruppe abonniert ist. Einziger Anleitungen für
Newsgroups Befehl ist erlaubt. Alias: „news“.

WIRD BEARBEITET

Gup verfügt über mehrere Verarbeitungsstufen. Die Initialisierungsphase besteht aus dem Wechsel zu
Öffnen Sie das Home-Verzeichnis (siehe Option -d) und öffnen Sie die Protokolldatei (siehe Option -l). Bei
diesmal, gup setzt die vorläufige Antwort-E-Mail-Adresse auf die „Backstop“-E-Mail-Adresse
wann definiert gup kompiliert wurde (normalerweise der lokale Nachrichtenadministrator).

Der nächste Schritt besteht darin, die eingehende E-Mail zu scannen und zu notieren interessant E-Mail-Header. Der
Die interessantesten sind „To:“ und „Reply-To:“. Wenn ein „To:“-Header gefunden wird, wird er zu
die vorläufige Antwort-E-Mail-Adresse. Wenn ein „Reply-To:“-Header gefunden wird, überschreibt dieser alle anderen
Die „An:“-Adresse wird zur neuen vorläufigen E-Mail-Antwortadresse. Einige andere werden erwähnt
und protokolliert, um Änderungen nachverfolgen zu können.

Nachdem alle Header verarbeitet wurden, wird der Textkörper der E-Mail auf Befehle untersucht.
Der erste Befehl sollen sei der site Befehl. Alle anderen Daten führen zu einer Fehlermeldung beim Senden der E-Mail
an die vorläufige Antwort-Mail-Adresse. Wenn die site Der Befehl enthält einen passenden Namen
einen Eintrag in der „config“-Datei, dann wird die vorläufige Antwort-E-Mail-Adresse durch ersetzt
die E-Mail-Adresse in der „config“-Datei.

Der Grund für diese Verrenkungen mit vorläufigen Antwort-E-Mail-Adressen liegt einfach darin, damit umzugehen
mit dem Problem herauszufinden, an wen im Fehlerfall eine E-Mail gesendet werden soll. Im Idealfall
Sie sollten alle auf die E-Mail-Adresse in der „config“-Datei zurückgreifen, aber auf diese Informationen
ist für einen wesentlichen Teil davon nicht bekannt gup's Erstverarbeitung.

Einmal gültig site Befehl wurde angenommen, gup Änderungen am Verzeichnis dieser Site in
Sites_directory (siehe Option -s), wodurch das Sites_directory und das Site-Verzeichnis als erstellt werden
notwendig. Der Verzeichnisname der Site ist derselbe wie der Name der Site. In Abwesenheit der
-s Option wird dies sein:

$HOME/sites/$site

Wo $HOME ist gupist das Home-Verzeichnis und $site ist der Name der verarbeiteten Site.
Gup sperrt die Site und lädt dann die aktuelle „Gruppen“-Datei der Site und ggf. eine Ausschlussliste
vorhanden (vgl AUSSCHLÜSSE für mehr Details).

Von diesem Punkt an gup akzeptiert jeden Befehl in beliebiger Reihenfolge bis zum Ende der E-Mail,
ein Quit-Befehl, ein Hilfe-Befehl oder ein schwerwiegender Fehler während der Verarbeitung. Nach allen Befehlen
verarbeitet wurden, gup Aktualisieren Sie die „Gruppen“-Datei der Site, wenn Änderungen vorgenommen wurden.
Dieses Update beinhaltet das Bereinigen aller überflüssigen Muster (es sei denn, die Option -P wird verwendet). Gup
schreibt die neuen Muster in „groups.new“. Anschließend benennt es „groups“ in „group.old“ um und
benennt schließlich „groups.new“ in „groups“ um. Das Ergebnis dieser gesamten Verarbeitung wird per Post verschickt
an den in der „config“-Datei definierten Site-Administrator.

CONFIG

Zugriff auf gup wird durch die „config“-Datei in gesteuert gupist das Home-Verzeichnis (siehe -d
Möglichkeit). Diese Datei enthält eine Zeile pro Site. Jede Zeile enthält drei Leerzeichen
getrennte Token. Der Name der Site, das Passwort und die E-Mail-Adresse des Administrators. Leer
Zeilen sind erlaubt und Kommentare folgen dem Zeichen „#“. Gup verwendet eine sehr einfache
Tokenizer, daher sind in dieser Datei keine Anführungszeichen oder Fortsetzungen zulässig.

Der Site-Name und das Passwort werden verwendet, um einen eingehenden Anruf zu überprüfen site Befehl. Das Passwort kann sein
verschlüsselt oder in Klartext Daher sollten Berechtigungen sorgfältig festgelegt werden, um den Zugriff einzuschränken. Hier ist
ein Beispiel für eine „config“-Datei.

werple Fert5566a__$1 [E-Mail geschützt]
Torps 34fkr_&&11)Zz [E-Mail geschützt]
uunet R_S_1@@*(A-\ [E-Mail geschützt]
.Testklappe markiert

Hoffentlich ist das intuitiv klar ...

GRUPPEN

Jede Site verfügt über eine eigene Musterdatei. Diese Datei heißt „Gruppen“ und befindet sich in
das eigene Verzeichnis der Site unterhalb des Sites_directory (siehe die Option -s). Diese Datei
enthält ein Muster pro Zeile. Ausschlusslisten haben ein vorangestelltes „!“-Zeichen. Hier ist ein
Beispiel:

apana.*
!apana.lists.*
!apana.fido.*
!apana.vortex.*
alt.bbs.waffel
alt.kult-filme
alt.galactic-guide
alt.sport.bowling
aus.*
!aus.ai
!aus.religion
!aus.radio
!aus.stats.s
...

Normalerweise sollte diese Datei nur von geändert werden gup, aber vorausgesetzt, Sie kümmern sich um die Verriegelung,
Es gibt keinen Grund, warum ein anderer Prozess dies nicht ebenfalls ändern kann. Wann immer gup muss sich bewerben
ändert, benennt es diese Datei in „groups.old“ um, bevor die Datei „groups“ neu geschrieben wird.
Dies gibt Ihnen ein gewisses Maß an Erholung.

AUSSCHLÜSSE

Aus irgendeinem Grund möchten Sie möglicherweise bestimmte Gruppen von der Auswahl einer Site ausschließen
Liste. Sie können dies tun, indem Sie die Datei „exclude“ im Verzeichnis der Site erstellen. Diese Datei
enthält Newsgroup-Muster, eines pro Zeile, die zum Filtern der „aktiven“ Datei verwendet werden
bei der Überprüfung von Gruppenmustern. Der Effekt davon ist das gup glaubt, dass solche Gruppen dies tun
nicht wirklich existieren, daher kann eine Site sie unmöglich enthalten.

DIAGNOSE

Alle Fehlerbedingungen werden in der Protokolldatei und möglicherweise in der resultierenden E-Mail aufgezeichnet.
abhängig von der Art des Fehlers. Ein besonderes Problem, das schwer zu erkennen ist, ist wann
Die .forward-Datei wird aufgerufen gup falsch. Wenn gup aufgrund eines solchen Fehlers nicht aufgerufen wird,
dann hängt die Benachrichtigung vom Mailer ab. Dies sollte nur ein Problem sein, auf das Sie achten sollten
bei der ersten Installation gup.

RESTRICTIONS

Gup versteht „Verteilungsmuster“ nicht. Solche Muster müssen generiert werden und
unabhängig davon gepflegt gup.

Nutzen Sie gup online über die Dienste von onworks.net