Index of /atarilibrary/atari_cd09/TOOLS/DFUE/CAT_UTIS/DECAT14

      Name                    Last modified       Size  Description

[DIR] Parent Directory 11-May-2007 21:20 - [TXT] DECAT.TTP 25-Nov-1995 06:03 19k [TXT] DECAT14.SIG 25-Nov-1995 06:03 1k [TXT] DECAT14.UPL 25-Nov-1995 06:03 1k [TXT] D_FEIST.PK 25-Nov-1995 06:03 3k [   ] INFO.MIF 25-Nov-1995 06:03 1k


                  DECAT 1.4 - PGP Dekodierer fr CAT
                  ==================================

(c) Dietrich Feist 28.07.1995

***** WICHTIG! - WICHTIG! - WICHTIG! - WICHTIG! - WICHTIG! *****
*                                                              *
* Gegenber Version 1.3 hat sich der Aufbau der Kommandozeile  *
* ge„ndert! Auch Benutzer von DECAT 1.3 sollten also unbedingt *
* den Punkt "Aufbau der Kommandozeile" aufmerksam lesen!       *
*                                                              *
***** WICHTIG! - WICHTIG! - WICHTIG! - WICHTIG! - WICHTIG! *****

Dieses Programm ist Freeware! Es darf beliebig weitergegeben werden, solange
dafr keinerlei Gebhren verlangt werden! Das Ablegen in Mailboxen ist
ausdrcklich erwnscht! N„heres dazu am Schluž dieses Textes.

Das Programm DECAT dekodiert automatisch alle mit PGP kodierten
ankommenden Nachrichten im Outfile. Es kann unter CAT als I/O-Filter fr
installiert werden und entschlsselt so die Nachrichten, bevor der Inhalt
des Outfiles in die Datenbasis eingefgt wird. Zus„tzlich werden neue Keys
(natrlich unsigniert) in den ”ffentlichen Schlsselbund eingefgt.


Dokumentation:

Dieser Text verdient diese Bezeichnung kaum, ist aber das einzige, was ich
in dieser Hinsicht liefern kann. Falls jemand den Ehrgeiz versprt, eine
bessere Dokumentation zu schreiben, dann ist er/sie herzlich willkommen.


Systemvoraussetzungen:

 - eine funktionsf„hige Version von PGP muž bereits installiert sein.
   Getestet wurde DECAT von mir mit den Versionen 2.3 und 2.6ui.

 - CAT ab Version 2.5 sollte installiert sein. Da das Programm als externer
   I/O-Filter installiert wird, muž es sich dabei um eine registrierte
   Version handeln.

 - Unter CAT sollte die Packerausgabe nicht umgelenkt werden, sonst kann
   man sein Passwort nicht eingeben! Alternativ kann man auch die
   Environment-Variable PGPPASS setzen, dann muž kein Passwort mehr
   eingegeben werden. PGPPASS sollte aber nur dann verwendet werden, wenn
   wirklich niemand aužer Ihnen Zugang zu Ihrem Rechner hat!

 - DECAT wertet die Environment-Variable TMP aus. Alle tempor„ren Dateien
   werden in das Verzeichnis geschrieben, das in TMP bergeben wurde. Wird
   die Variable nicht gesetzt, werden alle tempor„ren Dateien in das
   gleiche Verzeichnis geschrieben, in dem sich auch das Programm befindet.
   Diese Variable wird auch von PGP untersttzt.

 - Prinzipiell funktioniert DECAT auch ohne CAT, da zwischen den beiden
   Programmen keine direkte Kommunikation erfolgt. DECAT ben”tigt nur
   das Outfile mit den kodierten Nachrichten und erzeugt daraus ein
   Outfile mit entschlsselten Nachrichten. Insofern sollte es mit jedem
   Maustauschprogramm zusammenarbeiten, das eine Bearbeitung des Outfiles
   durch externe Filterprogramme vor dem Einfgen erlaubt. Auch der Einsatz
   innerhalb der Skriptdatei eines Terminalprogramms w„re im Prinzip
   denkbar.

Installation:

 - Das Programm DECAT.TTP in ein beliebiges Verzeichnis auf der Festplatte
   kopieren. Ist die Environment-Variable PGPPATH nicht auf den Pfad
   gesetzt, in dem sich auch PGP.TTP befindet, dann muž DECAT in das
   gleiche Verzeichnis wie PGP.TTP kopiert werden. In diesem Fall kann
   die Environment-Variable PGPPATH entfallen.

 - CAT starten und im Men unter Optionen -> Allgemein das Feld
   "Packerausgabe umlenken" abschalten. Wird die Packerausgabe umgelenkt,
   dann kann man sein Passwort nicht mehr eingeben. In diesem Fall muž
   die Environment-Variable PGPPASS das Passwort enthalten (s. dazu die
   Dokumentation von PGP).

 - Den Menpunkt Optionen -> I/O-Filter anw„hlen. Es erscheint eine
   Dialogbox, in der externe Filterprogramme installiert werden k”nnen. Wie
   das geht, steht in der Dokumentation zu CAT. Die Optionen sollten
   folgendermažen eingestellt werden:

       1. Wofr: "fr In-/Outfile" angew„hlt
       2. fr Outfile: angekreuzt
       3. fr Infile: nicht angekreuzt
       4. aktiv: angekreuzt
       5. Kommandozeile fr Outfile eingeben. Der genaue Aufbau wird
          weiter unten im Punkt "Aufbau der Kommandozeile" beschrieben.

 - Danach die neuen Einstellungen sichern. Das wars!


Programmablauf:

DECAT erwartet als Parameter in der Kommandozeile Pfad und Dateiname
des Outfiles. In CAT kann man diese leicht durch das Krzel $I$O bergeben.
Zus„tzlich kann man verschiedene Optionen angeben, mit deren Hilfe sich der
Ablauf von DECAT steuern l„žt. Beispielsweise kann die Bildschirmausgabe
in eine Datei umgelenkt oder angegeben werden, in welche Datei gefundene
Keys exportiert werden sollen. Es besteht auch die M”glichkeit, einen
Testmodus zu aktivieren oder DECAT am Programmende auf einen Tastendruck
warten zu lassen.

Bei der Umleitung der Bildschirmausgabe ist zu beachten, daž die Ausgabe
entweder in das Logfile oder auf den Bildschirm erfolgt, nicht sowohl als
auch! Bei Verwendung eines Logfiles sollte das Passwort also mit Hilfe der
Umgebungs-variable PGPPASS bergeben werden, da man die Aufforderung zur
Eingabe des Passworts ja nicht auf dem Schirm sehen kann.

Beim Maustausch wird das Programm automatisch gestartet, nachdem das
Outfile ausgepackt worden ist. Falls eine PGP-kodierte Nachricht gefunden
wurde, wird man nach dem Passwort fr den geheimen Schlssel gefragt. Das
Passwort wird w„hrend der Eingabe nicht angezeigt, bei Tippfehlern kann mit
der Backspace-Taste korrigiert werden. Die Eingabe endet, sobald die
Return-Taste bet„tigt wird. Enth„lt die Environment-Variable PGPPASS das
korrekte Passwort, wird man nicht zur Eingabe aufgefordert.

Das eingegebene Passwort bleibt bis zum Programmende gespeichert, so daž
weitere Nachrichten automatisch entschlsselt werden k”nnen, ohne daž eine
erneute Eingabe des Passworts n”tig w„re. Bei Programmende werden s„mtliche
Speicherbereiche mit Nullen berschrieben, in denen das Passwort w„hrend des
Programmablaufs gespeichert war. Auf diese Weise ist es nicht m”glich, das
Passwort nach Ende des Programms irgendwo im Speicher zu finden.

Von der Verwendung der Environment-Variable PGPPASS muž generell abgeraten
werden, auch wenn es vielleicht sehr bequem erscheint. Wird diese Variable
gesetzt, dann kann jeder, der Zugang zu Ihrem Rechner hat, Ihr Passwort
lesen!


Aufbau der Kommandozeile:

    DECAT <outfile> [-t] [-k] [-h] [-x=<keys>] [-l=<logfile>] [-b=<ext>]

Grunds„tzlich muž bei DECAT immer der Name des zu bearbeitenden Outfiles
als Parameter <outfile> angegeben werden. Das l„žt sich unter CAT sehr
leicht mit der Kombination $I$O realisieren. Die anderen Optionen in
eckigen Klammern sind beliebig. Die Reihenfolge spielt keine Rolle, als
<outfile> wird der erste Parameter verwendet, der nicht mit einem "-"
beginnt.

Die Optionen im einzelnen bedeuten:

   -t: Testmodus aktivieren. Im Testmodus wird die bearbeitete Datei
       nicht gel”scht und die Ausgabe wird in die Datei KLARTEXT.TXT
       geschrieben. Aužerdem wird PGP grunds„tzlich im Modus mit der
       gr”žten Geschw„tzigkeit aufgerufen und vor dem Aufruf das
       bergebene Environment angezeigt.

   -k: Die ursprngliche Datei <outfile> wird nach erfolgreicher
       Bearbeitung nicht gel”scht. Wird diese Option nicht gesetzt, dann
       wird sie gel”scht, sofern beim Entschlsseln keine Fehler auf-
       getreten sind.

   -h: DECAT wartet beim Programmende erst auf einen Tastendruck.

   -x=<keys>: Im Outfile gefundene Schlssel werden nur in die Datei
              <keys> exportiert. Aus dieser Datei kann sie der
              Benutzer dann manuell mit Hilfe von PGP in seinen
              Schlsselbund einfgen, ein automatisches Einfgen
              erfolgt dann nicht! Sollte die Datei <keys> bereits
              existieren, werden neue Schlssel einfach daran
              angeh„ngt. Wird diese Option nicht angegeben, dann
              werden neue Keys zun„chst in eine tempor„re Datei
              exportiert, die am Programmende automatisch eingefgt
              wird.

   -l=<logfile>: Die Bildschirmausgabe des Programms wird in die Datei
                 <logfile> umgeleitet. Gleichtzeitig wird die Option -h
                 deaktiviert.

   -b=<ext>: Dateinamenserweiterung der Sicherheitskopie, die Standard-
             vorgabe ist "bak". Wrde z.B. die Option -b=dup gew„hlt,
             dann wrde die ursprngliche Version der Datei <outfile>
             die Endung "dup" erhalten, also z.B. outfile.txt -->
             outfile.dup. Wird diese Option nicht angegeben, wird die
             Standardendung "bak" verwendet. In jedem Fall wrde diese
             Datei am Ende des Programms gel”scht, sofern keine Fehler
             beim Entschlsseln auftreten und die Option -k nicht
             aktiviert wurde.

Alle Optionen mssen einzeln angegeben werden! Kombinationen aus mehreren
wie etwa -kht funktionieren (noch) nicht.

Beispiele fr Kommandozeilen und was sie bewirken:

$I$O -h               : DECAT erh„lt von CAT den Pfad und Namen des
                        Outfiles und wartet am Programmende auf einen
                        Tastendruck

-k outfile.txt -b=$$$ : DECAT entschlsselt die Datei "outfile.txt" und
                        legt eine Sicherheitskopie mit Namen "outfile.$$$"
                        an. Diese Kopie wird in keinem Fall gel”scht, auch
                        wenn keine Fehler beim Entschlsseln aufgetreten
                        sind.

$I$O -l=decat.log -t  : DECAT startet im Testmodus und bearbeitet die
                        Datei, deren Namen ihm von CAT mitgeteilt wird.
                        Die Bidlschirmausgabe wird in die Datei decat.log
                        umgeleitet.


Bekannte Fehler:

 - DECAT ist momentan nicht in der Lage, kodierte Nachrichten zu
   entschlsseln, die vor dem Versand gesplittet wurden. In so einem Fall
   wird unter Umst„nden kein korrektes Outfile erzeugt.

 - Verwendet man DECAT unter EASE, gibt es eine Menge Probleme. Die
   meisten dieser Probleme liegen aber an EASE und nicht an DECAT! Da ich
   selbst EASE nicht besitze, ist die Korrektur dieser Probleme fr
   mich leider etwas schwierig. Mit THING scheint es „hnliche Probleme
   zu geben.

 - Bei einigen Konfigurationen kann man bei der Angabe des Logfiles keinen
   Pfad mit angeben. Ich konnte das Problem bisher nicht ausfindig machen,
   weil es bei mir unter TOS 1.04 und Gemini einwandfrei funktioniert.


Danksagungen:

Ich danke den Benutzern von DECAT fr ihre zahlreichen Tips und
Fehlermeldungen. Aužerdem m”chte ich Phil Zimmermann und allen anderen
danken, die an der Entwicklung von PGP beteiligt waren bzw. sind.


Entwicklungsgeschichtliches:

Version 1.0 beta
================

Diese Version lief offenbar nur auf meinem System gut. War PGPPATH nicht
gesetzt, strzte sie gnadenlos ab. Selbst wenn sie gesetzt war, war DECAT
etwas w„hlerisch, was den bergebenen Pfad anging. Er durfte als letztes
Zeichen keinen Backslash enthalten, wie es ja eigentlich die korrekte Form
eines Pfades tun sollte. Diese Version wurde nur an die Betatester
verteilt.

Version 1.1 beta
================

Hier wurden einige Fehler korrigiert. DECAT strzt jetzt nicht mehr ab,
wenn PGPPATH nicht gesetzt ist. Es ist jetzt auch egal, ob der Pfad einen
Backslash als letztes Zeichen enth„lt oder nicht. Aužerdem werden jetzt
zus„tzlich die Environment-Variablen TMP und PGPPASS untersttzt. In
PGPPASS kann das Passwort gesetzt werden, so daž das Programm ganz ohne
Benutzereingaben laufen kann. In TMP wird der Pfad bergeben, in den alle
tempor„ren Dateien geschrieben werden. Diese Version wurde nicht
ver”ffentlicht, sondern sofort von Version 1.2 beta abgel”st.

Version 1.2 beta
================

Da ich nach Fertigstellung von Version 1.1 beta offenbar zu viel Zeit
hatte, habe ich gleich noch eine Routine eingebaut, die automatisch
neue Keys im Outfile erkennt und diese (natrlich ohne Echtheitszertifikat)
in den ”ffentlichen Schlsselbund einfgt. Hinter dem eingefgten Key wird
eine entsprechende Nachricht in das neue Outfile eingefgt. Neue Keys, die
innerhalb einer verschlsselten Nachricht stehen, werden auf diese Weise
nicht eingefgt! Diese Version wurde ver”ffentlicht, nachdem die
Betatester keine gr”žeren M„ngel mehr gefunden haben.

Version 1.21
============

Die erste Version ohne den Zusatz "beta". Einige kleinere Bugs wurden
beseitigt. Dazu z„hlte z.B. die fehlerhafte Anzeige von Namen beim
Einfgen neuer Keys aus Info-Dateien. Auch die Auswertung der Fehler-
meldungen von PGP wurde verbessert. So werden jetzt nur noch solche
Nachrichten als dekodiert markiert, die wirklich von PGP fehlerlos
entschlsselt werden konnten. Bei neu eingefgten Keys werden jetzt
Datum und Uhrzeit des Einfgens mit eingetragen. Aužerdem kann die
Ausgabe jetzt in eine Datei umgelenkt werden, deren Name als zweiter
Parameter in der Kommandozeile bergeben wird.


Version 1.3
===========

Nach etwas l„ngerer Pause die erste Version, in der ich einige der vielen
Anregungen und Wnsche der DECAT-Benutzer bercksichtigen konnte. DECAT
untersttzt jetzt den PMCRYPT-Standard, wie er von Crosspoint und Enkat
verwendet wird. Damit kann bei einer kodierten Nachricht auch der Betreff
verschlsselt bertragen werden.

Aužerdem wird jetzt neben der vom aufrufenden Programm bergebenen
Umgebung auch das Shell-Environment nach den Variablen TMP, TZ, PGPPATH
und PGPPASS durchsucht. Damit sollte ein Teil der Probleme mit EASE der
Vergangenheit angeh”ren. Vielen Dank an Johannes Link fr den Tip!

Die bisher bliche Einrahmung des entschlsselten Textes in "----- begin
decrypted pgp message -----" bzw. "----- end decrypted pgp message -----"
ist jetzt weggefallen. Stattdessen gibt es jetzt nur noch eine kurze
Meldung mit Datum und Uhrzeit am Ende der Mail. Der Nachteil ist, daž man
jetzt in Nachrichten, bei denen nur ein Teil kodiert war (benutzt das
jemand?) nicht mehr sehen kan, welcher Teil das war. Der grože Vorteil
ist aber, daž jetzt auch gruppenbergreifende Kommentare in kodierten
Mails funktionieren k”nnen.


Version 1.4
===========

Die Fehlerbehandlung wurde erheblich verbessert. Deshalb kann jetzt im
Normalfall bei fehlerfreier Entschlsselung das ursprngliche Outfile
gel”scht werden. Wem dies nicht gef„llt, der kann das mit der Option
-k verhindern. šberhaupt sind einige Dinge dazugekommen: endlich werden
Keys in verschlsselten Mails erkannt, statt automatischer Einsortierung
k”nnen neue Keys auch in eine Datei exportiert und danach manuell 
einsortiert werden, die Namenserweiterung der Sicherheitskopie ist jetzt
frei w„hlbar und wenn es sein muž, wartet DECAT am Programmende auch
auf einen Tastendruck. Da mich berufliche Grnde dazu zwingen, fr mehrere
Jahre in die Schweiz zu gehen, wird das vermutlich die letzte Version sein,
an der ich beteiligt bin (von ein paar Bugfixes vielleicht mal abgesehen).

Ausblicke:

 - Sp„tere Versionen von DECAT sollen mit gesplitteten Mails umgehen
   k”nnen.

 - Die Untersttzung von Multi-Tasking-Betriebssystemen soll weiter
   verbessert werden.


Nutzungsbedingungen:

DECAT ist Freeware! Jeder darf das Programm kostenlos und ohne weitere
Verpflichtungen mir gegenber fr einen unbegrenzten Zeitraum verwenden
und es aužerdem beliebig kostenlos weitergeben. Die einzigen Bedingungen
sind, daž er/sie sich nicht daran bereichert und keinerlei Ver„nderungen
am Programm oder an der Dokumentation vornimmt. Alle Rechte, insbesondere
die Rechte an den Sourcekodes verbleiben bei mir!

Besonders erwnscht ist die Weiterverbreitung ber Mailboxen oder
FTP-Server. Der Vertrieb ber PD-Versender ist nur gestattet, wenn diese
nicht mehr als die ihnen entstandenen Unkosten fr das Kopieren verlangen.
Im Zweifelsfall ist vorher mein Einverst„ndnis einzuholen!

Bei der Weitergabe des Programms mssen alle Dateien des Archivs
unver„ndert und zusammen weitergegeben werden. Dieser Text muž das
Programm immer begleiten! Das Packen aller Dateien mit einem anderen
Packer ist natrlich erlaubt.


Anerkennung:

Wer seine Dankbarkeit fr meine Arbeit nicht zgeln kann und mir unbedingt
was Gutes tun will, der hat mehrere M”glichkeiten. Das ist aber keine
Bedingung, sondern geschieht v”llig freiwillig!

1. Das Programm (auf seine Kosten) in beliebig vielen Mailboxen/FTP-Servern
   uploaden.

2. Mir eine Ansichtskarte aus dem n„chsten Urlaub oder seiner Heimat
   schicken. Bitte darauf deutlich vermerken, daž er/sie ein zufriedener
   DECAT-User ist, sonst r„tsele ich wochenlang, wer er/sie sein k”nnte.

3. Bei einem beliebigen Mausstammtisch meine Rechnung bezahlen.

4. Mir nach eigenem Ermessen eine Spende auf mein Konto Nr. 3290 34 750
   bei der Postbank Karlsruhe, BLZ: 660 100 75, zukommen lassen.

5. Einen grožzgigen Geldbetrag zugunsten des Phil Zimmermann defense
   funds spenden. Mit diesem Fond wird Phil Zimmermann finanziell
   untersttzt, damit er seine Anwaltskosten in den wegen PGP
   anstehenden Gerichtsverfahren bezahlen kann. Verschiedene amerikanische
   Regierungsstellen (vor allem die Zollbeh”rde) haben ihn nach der
   Ver”ffentlichung von PGP mit Klagen berh„uft, um eine weitere
   Verbreitung von PGP zu verhindern.


Der Autor:

Ich bin derzeit 28 Jahre alt und von Beruf Diplomphysiker. Da ich in
Krze meine Zelte in Deutschland abbrechen und fr 3-4 Jahre in die
Schweiz ziehen werde, sollten alle Anfragen bzgl. DECAT an die Adresse
meiner Eltern gehen:

       Dietrich Feist
       Trajanstraže 21 a
       D-68526 Ladenburg

       EMail: Dietrich Feist @ HD (MausNet)

Anfragen, Kritik und Anregungen zu DECAT beantworte ich grunds„tzlich nur
per EMail! PMs an diese Adresse werde ich ab August 1995 wohl nur noch
etwa einmal pro Monat lesen. Deshalb bitte etwas Geduld!


Haftungsausschluž:

   Ich bernehme keinerlei Verantwortung oder Haftung fr irgendwelche
   Sch„den, die durch den Gebrauch von DECAT entstehen! Die Installation
   und Anwendung erfolgen auf eigenes Risiko! Ich weise ausdrcklich darauf
   hin, daž es keine fehlerfreie Software gibt und DECAT somit unter
   Umst„nden auch Fehler enth„lt, die zu Datenverlusten fhren k”nnen.
   Wer in so einem Fall kein entsprechendes Backup besitzt, ist selbst
   schuld!