Das Handbuch zu KWatchGnuPG

# Das Handbuch zu KWatchGnuPG

Marc Mutz `<mutz@kde.org>`

Entwickler: Steffen Hansen
Entwickler: David Faure
Deutsche Übersetzung: Matthias Kalle Dalheimer
Version 1.0 (Anwendungen 16.08) (2016-07-26)

This program is free software; you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation; either version 2 of the License, or (at your option) any later version.

This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.

You should have received a copy of the GNU General Public License along with this program; if not, write to the Free Software Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.

KWatchGnuPG ist ein einfacher Betrachter für die Protokollausgabe von GnuPG

Kapitel 1. Einführung
Einführung

# Kapitel 1. Einführung

KWatchGnuPG ist ein einfacher Betrachter für die Protokollausgabe der GnuPG-Versionen 1.4, 2.0 und 2.0. Es funktioniert als eine GUI um das Befehlszeilenprogramm WatchGnuPG. welches an einem Socket auf Protokollzeilen von den GnuPG-Hintergrundapplikationen wartet. Nähere Informationen zu WatchGnuPG finden Sie unter `info watchgnupg`.

KWatchGnuPG kann aus dem Menü Extras → GnuPG-Protokollanzeige sowohl von Kleopatra als auch von KMail, wie auch von der Befehlszeile gestartet werden. Der Name der ausführbaren Datei von KWatchGnuPG lautet `kwatchgnupg`.

## Wichtige Funktionen

### Betrachten des Protokolls

Die wichtigste Funktion von KWatchGnuPG ist natürlich das Aufbereiten der GnuPG-Informationen zur Fehlersuche und Protokollierung für den Betrachter. Das Hauptfenster besteht aus einem großen Bereich, in dem die GnuPG-Nachrichten angezeigt werden, wenn sie ausgegeben werden, eine Werkzeugleiste, mit der die wichtigsten Funktionen schnell erreicht werden können, sowie der obligatorischen Menüleiste.

Jede Zeile in der Textansicht ist normalerweise ein FD-Bezeichner und ein Datumsstempel im ISO-Format vorangestellt. Der FD-Bezeichner kann dazu verwendet werden, Ausgaben von verschiedenen, gleichzeitig laufenden GnuPG-Instanzen voneinander zu unterscheiden. Auf den Datumsstempel folgt der Name der Komponente, aus der die Protokollzeile stammt, sowie interne Informationen in eckigen Klammern. Anschließend folgt die ursprüngliche Fehlersuch- oder Protokollausgabe, wie sie von der Komponente ausgegeben wurde.

Als Standard ist die Anzahl der Protokollzeilen, die wieder abgerufen werden kann, auf 10 000 begrenzt. Sie können diese Anzahl aber im Einstellungsdialog verändern.

### Den Inhalt des Protokollfensters in einer Datei speichern

Manchmal ist es nützlich, den Inhalt des aktuellen Protokollfensters in einer Datei abzuspeichern, etwa um ihn den Entwicklern als Teil einer Fehlermeldung zu schicken. Dies können Sie KWatchGnuPG auf zweierlei Weise erreichen:

Einmal können Sie Datei → Speichern unter ... (oder die entsprechende Schaltfläche in der Werkzeugleiste) verwenden, um den gesamten Inhalt des Protokollfensters in einer Datei zu speichern. Sie werden nach der zu verwendenden Datei gefragt.

Zum anderen können Sie auch die interessanten Zeilen wie gewohnt mit der linken Maustaste auswählen und dann in eine Textverarbeitung oder ein E-Mail-Programm einkopieren, genau wie anderen Text auch. Sie sollten aber sicherstellen, dass die Zeilen nicht umbrochen werden, weil das die Lesbarkeit des Protokolls herabsetzen würde.

### Das Protokollfenster leeren

Mit Datei → Verlaufspeicher löschen (oder der entsprechenden Schaltfläche in der Werkzeugleiste) können Sie den Inhalt des Protokollfensters löschen.

Dies können Sie beispielsweise vor dem Start einer Krypto-Operation tun, um nur die Ausgabe dieser einen Operation zu sehen. Das Protokoll können Sie dann wie oben beschrieben mit Datei → Speichern unter ... abspeichern.

Das Leeren des Protokolls verwirft alle vorherigen Inhalte des Protokollfensters. Wenn Sie sich nicht sicher sind, ob Sie den aktuellen Inhalt später noch benötigen, sollten Sie diesen wie oben beschrieben vorher in einer Datei speichern.

Kapitel 2. KWatchGnuPG einrichten
KWatchGnuPG einrichten

# Kapitel 2. KWatchGnuPG einrichten

Zur Einrichtung von KWatchGnuPG wählen Sie Einstellungen → KWatchGnuPG einrichten ... aus dem Menü aus oder betätigen die entsprechende Schaltfläche in der Werkzeugleiste. Der Einrichtungsdialog von KWatchGnuPG besteht aus zwei Teilen, die hier beide beschrieben werden.

## Einrichtungsdialog

### WatchGnuPG-Einstellungen

WatchGnuPG ist der Prozess, der das Protokollsocket auf Aktivität überwacht in die Zeilen so formatiert, wie sie in der Textansicht von KWatchGnuPG zu sehen sind. Die Einstellungen in dieser Gruppe werden über den GPGConf-Mechanismus an das Hintergrundprogramm weitergereicht.

Ausführbares Programm enthält den Pfad zum WatchGnuPG-Programm. Wenn sich WatchGnuPG in Ihrem `$PATH` befindet, können Sie es bei der Standardeinstellung `watchgnupg` belassen. Wenn sich WatchGnuPG nicht in Ihrem `$PATH` befindet oder Sie mehr als eine Version installiert haben, dann sollten Sie hier den vollständigen Dateinamen der ausführbaren Datei angeben.

Socket enthält das Socket, an dem WatchGnuPG lauschen soll. Eine Änderung dieses Wertes wird über den GPGConf-Mechanismus an alle GnuPG-Hintergrundprogramm-Module weitergereicht, sodass Sie diese Einstellung nicht ändern müssen, wenn in Ihren GnuPG-Einrichtungsdateien eine andere Protokolldatei (`log-file`) eingestellt ist.

Standard-Protokollniveau bestimmt die Menge der Protokollinformationen, die von den Hintergrundprogramm-Modulen zurückgegeben werden soll. Die WatchGnuPG-Dokumentation beschreibt, welches Protokollniveau welche Informationen beinhaltet. Eine Änderung dieser Einstellung wird über den GPGConf-Mechanismus an alle GnuPG-Hintergrundprogramm-Module weitergereicht, sodass Sie diese Einstellung in Ihren GnuPG-Konfigurationsdateien nicht ändern müssen, wenn dort ein anderer `log-level` eingestellt ist.

### Protokollfenster-Einstellungen

Hier können Sie die Größe des Verlaufspeichers einstellen, also wieviele Protokollzeilen im Speicher gehalten werden sollen. Wenn seit dem letzten Löschen des Verlaufs mehr Zeilen von GnuPG ausgegeben wurden, als hier eingestellt ist, dann werden die ältesten Zeilen gelöscht, bis wieder genug Raum für die neuen Zeilen vorhanden ist.

Sie können die Größenbeschränkung des Verlaufspeichers durch Anklicken von Auf Unbegrenzt setzen abschalten. Beachten Sie aber, dass sich der Speicherverbrauch von KWatchGnuPG mit der Anzahl der angezeigten Zeilen vergrößert. Wenn Sie eine unbeschränkte Größe für den Verlaufspeicher verwenden, dann sollten Sie entweder KWatchGnuPG nur kurze Zeit laufen lassen oder den Verlaufspeicher regelmäßig von Hand löschen.

Kapitel 3. Danksagungen und Lizenz
Danksagungen und Lizenz

# Kapitel 3. Danksagungen und Lizenz

KWatchGnuPG Copyright 2004 Klarälvdalens Datakonsult AB

Dokumentation Copyright 2004 Klarälvdalens Datakonsult AB

Mitwirkende

- Steffen Hansen `(hansen AT kde.org)`

- Marc Mutz `(mutz AT kde.org)`

- David Faure `(faure AT kde.org)`

Übersetzung Matthias Kalle Dalheimer `(kalle AT klaralvdalens-datakonsult.se)`

Diese Dokumentation ist unter den Bedingungen der GNU Free Documentation License veröffentlicht.

Dieses Programm ist unter den Bedingungen der GNU General Public License veröffentlicht.