XPFilter 1.4(1) XPFilter 1.4(1) FUNKTION XPFilter - Eingangsfilter f�r CrossPoint Copyright (c) 1994-96 by Robin Sommer (robin@shire.owl.de) SYNTAX XPFILTER [Optionen] -u [Musterfiles...] XPFILTER -c [-i] [Optionen] [Musterfiles...] Optionen: -[abdfgmqwxy] -@[] -e[] -k -h -j -l[] -n[] -o|-p|-v[] -r -s -t[] -z BESCHREIBUNG XPFilter ist ein Eingangsfilter f�r das Programm CrossPoint von Peter Mandrella. Eine ausf�hrliche Beschreibung findet sich in der Datei XPFILTER.DOC. OPTIONEN Option Bedeutung () -@[] Basisverzeichnis w„hrend des Filterlaufs. Falls Argument fehlt das aktuelle; default ist XP-Verzeichnis (WORKDIR) -a Abbruch der Bearbeitung jeder Nachr. schon nach einem Mustertreffer (ABORT) -b L”schen aller "Re^x:" in den Betreffen (DELRE) -c Test der Muster; keinen Puffer angeben! (CHECK) -d liest XP-Brettliste und beschr„nkt damit die DISKUSSION-IN-Header bei -f sowie die Variablenzuweisung bei EMP auf existente Bretter (CHECKDISC) -e[] wartet Sekunden auf einen Tastendruck bei Fehlern, default ist "endlos" (ERROR) -f Bei Crosspostings nur ein DISK.-IN setzen (FOLLOWUP) -g Schlieát Signaturen (im Fido Origins) von der BODY(-I) Suche aus (IGNORESIG) -h Prefix f�r XPFilter-Ausgaben am Beginn einer Nachricht (PREFIX) -i legt jedes nicht in der XP-Brettliste vorhandene Brett, das in der Musterdatei vorkommt, durch eine Steuernachricht neu an (INIT) -j die f�r von XPFilter erstellte Nachrichten verwendete Domain (DOMAIN) -k[] ver„ndert Ursprungspuffer nicht. Bei Angabe einer Datei wird der neue Puffer dorthin geschrieben (KEEP) -l[[][:Dir/File]] schreibt zusammenfassenden Bericht in , default ist /Netzanruf; falls "Dir/File" angegeben wird dort ein externer Puffer erzeugt (LOG) -m Speichersparmodus (SAVEMEM) -n<[Datei>] Name der Konfigurationsdatei, default ist XPFILTER.CFG -o gibt bei jedem Mustertreffer einige Angaben zur Nachricht aus (VERBOSE) -p wie -o, allerdings CLS vor jeder Ausgabe (VERBOSESCREEN) -q nur noch Fehler- und (-o|-p)-Ausgabe (QUIET) -r Pfad zum XP-Hauptverzeichnis (XPDIR) -s Server f�r SENDEN-Muster (SERVER) -t[] Das TMP-/TEMP- bzw. das angegebene Verzeichnis f�r tempor„re Dateien benutzen (TMPDIR) -u Der zu filternde Puffer -v[[][:Dir/File]] wie -o, aber schreibt die Ausgaben in eine Mail in , default ist /Netzanruf; falls "Dir/File" angegeben wird dort ein externer Puffer erzeugt (VERBOSEMAIL) -w Nur Muster in den "Ausf�hrlichen Bericht" (-o|-p|-v) aufnehmen, die eine AUSGABE- Kennung enthalten (SELECTOUTPUT) -x Beim Verschieben oder phys. Kopieren keine KOP: erzeugen, alte EMP: einfach l”schen (NOKOP) -y MARKIERTE oder "BEZOGENE" Nachrichten auf keinen Fall l”schen (KEEPMAILS) -z Regul„rer Ausdruck zur Erkennung von Quotezeilen (QUOTE) SYNTAX FšR MUSTER [] wird ignoriert [;] Kommentar (nur am Zeilenanfang) [#] Kommentar (nur am Zeilenanfang) [] Schalter, siehe unten [=[Hx-y:][Zx-y:] Suchbedingung; s.u. [=] Aktionen, siehe unten [VAR<0-9>]=[[:<1-5>]:] Variablendefinition, Benutzung mit $<0-9> END Musterende Die Reihenfolge innerhalb eines MUSTERS ist beliebig. Leerzeichen und Tabulatoren werden am Anfang und Ende der Zeile sowie vor und hinter dem Gleichheitszeichen ignoriert. Alle Suchbedingungen im Muster sind per default UND-verkn�pft (siehe auch ODER-Schalter) SUCHKENNUNGEN ABS Adresse des Absenders (ggf. mit Realname in Klammern) BET Betreff BEZ ID der Bezugsnachricht BODY Nachrichtentext (case-sensitiv) BODY-I Nachrichtentext (case-insensitiv) EMP Empf„nger (PMs enth. "@", Bretter "/") GRUPPEN Anzahl ”ffentlicher Empf„nger GRUPPEN-KOP Anzahl ”ffentlicher Empf„nger einschl. Kopienempf„nger LEN Nachrichtenl„nge, numerischer Inhalt (Bytes bzw. KBytes, z.B. "=>1k" entspr. "=>1024" ), Vergleich mit "=", "=~", "=<", "=>" IN-ADRBUCH Test, ob Absender bereits in XPs Userdatenbank vorhanden ist. "1" -> existiert, "0" -> noch unbekannt LAST-BEZ ID der *direkten* Bezugsnachricht MID Nachrichten-ID QUOTE-ANTEIL Prozentualer Quoteanteil QUOTE-ZEILEN Anzahl an Quotezeilen STICHWORT Stichwort zum Nachrichteninhalt ZUSAMMENFASSUNG Zusammenfassung des Nachrichteninhaltes X-XP-FTO Empf„nger einer Fido-Echomail XBET BET, STICHWORT und ZUSAMMENFASSUNG gleichzeitig --- SUCHEN Suchausdruck mit Vergleichen und Operatoren (||, &&, =, !=) zur Kombination von mehreren Suchbedingungen (z.B. (EMP="XX" || BET="YY" ). Regul„re Ausdr�cke m�ssen in Anf�hrungszeichen. Weitere Suchkennungen: EB, EDA, ROT, TYP, OAB, OEM, WAB, ANTWORT-AN, DISKUSSION-IN, LDA, MAILER, POST, TELEFON, SPERRFRIST, STAT, ORG, FILE, X-XP_F Zus„tzliche sind mit Hilfe der XPFILTER.DEF-Datei frei definierbar. AKTIONEN ATTRIBUT setzt den Nachrichtenstatus auf "halten", "l”schen", "gelesen", "farbig"; Kombination mehrerer Attribute mittels '+' BATCH diese Batch-/Programmdatei wird bei jedem Treffer aufgerufen (ein vorhandenes EXPORT wird zuerst bearbeitet und die Datei an die Batch �bergben) BRETT Zielbrett f�r Kopien (Defaultaktion) EINMAL alle Aktionen werden nur einmal pro Absender ausgef�hrt; wenn eine Datei angegeben wird, werden dort die bereits behandelten Absender gespeichert EXPORT exportiert Nachricht in Zieldatei od. -verzeichnis (bei "$" im Dateinamen wird eine numerische Folge erzeugt) IMPORT Datei als Nachricht einlesen (Empf„nger mit ZIEL, Betreff mit TITEL) LOESCHEN L”scht die gesamte Nachricht (ohne BRETT) falls kein Argument angeben ist. Ansonsten werden nur die auf den RE passenden EMPs entfernt. MARKIEREN Nachricht innerhalb des Realnamens markieren N-ANTWORT-AN neue ANTWORT-AN-Headerzeile f�r passende Nachricht N-DISKUSSION-IN neue DISKUSSION-IN-Headerzeile N-HEADER Setzen und L”schen beliebiger Headerzeilen N-STICHWORT neue STICHWORT-Headerzeile NAME Mustername, taucht in Berichten auf REIMPORT tauscht den Body einer Nachricht mit der angegebenen (oder bei Weglassen mit der durch EXPORT erzeugten) Datei aus SENDEN hier Datei angeben, die an den Absender der Treffernachricht gesendet wird (zum Weiterleiten von Nachrichten SENDEN=* zusammen mit EXPORT) SERVER Server f�r zu verschickende Nachrichten (mit SENDEN) SWAP KByte Angabe, wieviel Speicher XPFilter versuchen soll, f�r BATCH freizumachen; bei Weglassen des Parameters soviel wie m”glich TEXT wird an den Beginn des Bodies jeder Treffernachr. gesetzt TITEL neuer Nachrichtenbetreff (oder Betreff f�r SENDEN oder Betreff f�r IMPORT) ZIEL Adresse f�r SENDEN oder IMPORT EXPORT, BATCH, IMPORT, REIMPORT und SENDEN arbeiten stets in dieser Reihenfolge SCHALTER ABBRUCH *Alle* nachfolgenden Muster werden bei Treffer nicht mehr getestet AMENDE F�hrt BATCH, IMPORT und SENDEN Aktionen einmal am Programmende aus (falls keine Suchbedingungen vorhanden, ausschlieálich dann) ANHAENGEN Falls Exportdatei vorhanden, nicht �berschreiben, sondern erweitern (mit EXPORT) ARCHIV Nachricht im Userfach des Absenders archivieren AUSGABE Bei Benutzung der Option -w (bzw. SELECTOUTPUT) das Muster in "Ausf�hrlichen Bericht" aufnehmen BEZIEHEN Statt Kopie nur Bezugsmail erzeugen (mit BRETT) BINAER Binaries verschicken (mit SENDEN) DEBUG Step-by-Step-Modus f�r das Muster; Userabfrage bei jedem Treffer DEL L”scht die EXPORT-Dateien wieder (mit EXPORT) ERHALTEN Passende Nachrichten auf keinen Fall l”schen GRUND Schreibt Trefferstrings an den Beginn der passenden Nachrichten INAKTIV Deaktiviert das Muster komplett LOWPRIO BRETTer werden wie die urspr�nglichen EMPs behandelt ORIGINAL Keine tempor„re Datei f�r zu verschickende Bin„rnachrichten anlegen (mit SENDEN und BINAER) PHYS Phys. Kopie statt X-Posting (mit BRETT) PUFFER Beim Exportieren Puffer statt Text erzeugen (mit EXPORT) STOP Die in derselben Musterdatei folgenden Muster bei Treffer nicht mehr testen VERSCHIEBEN Komplett verschieben statt kopieren (mit BRETT) --- ODER ODER-Verkn�pfung der Suchbedingungen im Muster REGULŽRE AUSDRšCKE (RE) ~ Negation (nur als erstes Zeichen des RE) . Platzhalter f�r genau ein beliebiges Zeichen [] Platzhalter f�r ein Zeichen aus Liste (auch Bereich: [1-5]) [^] Platzhalter f�r ein Zeichen, das nicht in der Liste steht * beliebig lange Kette von (auch nach Platzhaltern m”glich, z.B. ".*" f�r beliebige Strings) + dito, aber nichtleere Kette ? null- oder einmal ^ f�r Zeilenanfang $ f�r Zeilenende \< f�r Wortanfang \> f�r Wortende () gruppiert Teilausdr�cke | Oder-Operator & paát auf alle Formen von Replykennungen ("Re:") \x 1 <= x <= 5 - R�ckbezug auf den x'ten Unterausdruck \ zum Quoten von obigen Sonderzeichen FILES BEISPIEL.XPF Einige Beispielmuster FAQ.DOC Eine Sammlung h„ufig gestellter Fragen sowie Hilfestellungen zur Probleml”sung HISTORY.DOC Die Versionsgeschichte REFERENZ.DOC Diese šbersicht REGEXP.DOC Dokumentation zu REGEXP.EXE REGEXP.EXE Programm zum Testen Regul„rer Ausdr�cke UPDATE.DOC Einige Hinweise zum Update von fr�heren Versionen XPFILTER.CFG Konfigurationsdatei XPFILTER.DEF Definitionsdatei f�r neue Suchkennungen XPFILTER.DOC Die ausf�hrliche Dokumentation XPFILTER.EXE *Das* Programm :-)