# Podręcznik &kwatchgnupg;

Marc
Mutz

    &Marc.Mutz.mail;

Steffen
Hansen
Programista

    &Steffen.Hansen.mail;

David
Faure

    &David.Faure.mail;

Programista
Tomasz
Walach

    tomasz_rysz@o2.pl

&GPLNotice;
2004-05-09
1.0

&kwatchgnupg; jest prostą przeglądarką dziennika &gnupg;.

KDE
Kapp
gpg
gpgsm
GnuPG
Przeglądarka dziennika

## Wprowadzenie

&kwatchgnupg; jest prostą przeglądarką dziennika &gnupg;dla wersji 1.4 i 2.0 &gnupg;. Pracuje jako graficzna nakładka &watchgnupg; narzędzia z konsoli tekstowej, które nasłuchuje gniazdo danych dziennika &gnupg; wspieranych programów. Użyj `info watchgnupg` dla uzyskania dodatkowych informacji o &watchgnupg;.

&kwatchgnupg; można uruchomić z menu Narzędzia programów &kleopatra; i &kmail;, a także z wiersza poleceń. Nazwa polecenia wykonywalnego &kwatchgnupg; to `kwatchgnupg`.

## Główne funkcje

### Przeglądanie dziennika

Podstawowym oczywistym zadaniem &kwatchgnupg; jest prezentacja informacji użytkownikowi z debugowania i logowania &gnupg;. Okno główne jest podzielone na duże okno tekstowe, gdzie pojawiają się generowane przez &gnupg; wiadomości, i pasek narzędzi umożliwiający szybki dostęp do najczęściej potrzebnych funkcji, tak jak w menu wyboru.

Każdy wiersz tekstu w oknie podglądu jest poprzedzona identyfikatorem FD i odciskiem czasowym w formacie ISO. Identyfikator FD pomaga rozróżnić wynikami z równolegle uruchomionych przypadków &gnupg;. Następnym po odcisku czasu jest nazwa źródła wiersza logowania, razem z niektórymi wewnętrznymi informacjami w nawiasach kwadratowych, następnie oryginalne dane debugowania lub logi wyjściowe przekazane przez składniki.

Domyślnie liczba wierszy dziennika jaką przechowuje jako historie jest ograniczona do 1000 wierszy. Można skonfigurować rozmiar historii w ustawieniach konfiguracji.

### Zapisywanie zawartości okna dziennika do pliku

Czasami jest przydatne zapisanie obecnej zawartości okna dziennika do pliku, &eg; aby wysłać pocztą elektroniczną do programistów załącznik z informacji o problemach. Można to zrealizować na dwa sposoby w &kwatchgnupg;:

Pierwszy, można wybrać Plik Zapisz jako... (lub odpowiadającą ikonę z paska narzędzi) aby zapisać kompletną zawartość okna dziennika do pliku. Pojawi się pytanie o podanie położenia dla zapisywanego pliku.

Drugi, można zaznaczyć interesujące wiersze za pomocą zaznaczania wskaźnikiem myszy i wklejenia do edytora tekstu lub klienta poczty, tak jak inny tekst. Warto zwrócić uwagę aby wiersze nie były przerwane ponieważ zmniejsza to czytelność dziennika.

### Czyszczenie okna dziennika

Wygodnie wyczyści się okno dziennika używając polecenia &kwatchgnupg; Plik Wyczyść historię (lub odpowiadającą ikonę z paska narzędzi).

Zastosować przed monitorowaną operacją kryptograficzną aby uzyskać wynik z tej operacji. Następnie można zachować używając Plik Zapisz jako... jak opisano powyżej.

Czyszczenie dziennika usuwa całą zawartość. Jeśli później może być potrzebna obecna zawartość, lepiej zapisać do pliku (opis powyżej) przed czyszczeniem.

## Konfiguracja &kwatchgnupg;

Aby skonfigurować &kwatchgnupg;, należy wybrać Ustawienia Konfiguracja &kwatchgnupg;..., lub odpowiadającą ikonę z paska narzędzi. Opcje konfiguracji &kwatchgnupg; są podzielone na dwie części, które zostaną opisane poniżej.

### Ustawienia &watchgnupg;

&watchgnupg; jest programem, który ciągle monitoruje gniazdo logowania pod względem aktywności i formatuje wiersze widocznych w oknie &kwatchgnupg;. Ustawienia z tej grupy są przekazywane do innych programów z użyciem mechanizmu &gpgconf;.

Pole Plik wykonywalny zawiera ścieżkę do programu &watchgnupg;. Jeśli &watchgnupg; znajduje się w `$PATH`, można pozostawić domyślny wpis `watchgnupg`. A jeśli &watchgnupg; nie znajduje się w `$PATH`, lub jest kilka wersji zainstalowanych, wpisać pełną ścieżkę z nazwą do pliku wykonywalnego watchgnupg.

Pole Gniazdo zawiera ścieżkę do gniazda na którym nasłuchuje &watchgnupg;. Zmiany tutaj są przenoszone do wszystkich modułów zewnętrznych &gnupg; używających &gpgconf;, a wiec nie potrzeba zmieniać tych ustawień, jeśli konfiguracja &gnupg; nie ma innych ustawień w `log-file`.

Domyślny poziom logowania ustala ilość informacji która jest zwracana przez zewnętrzne moduły. Dokumentacja &watchgnupg; opisuje jakie informacje dostarcza dany poziom logowania. Zmiany tutaj są przenoszone do wszystkich modułów zewnętrznych &gnupg; używających &gpgconf;, a wiec nie potrzeba zmieniać tych ustawień jeśli konfiguracja &gnupg; nie ma innych ustawień w `log-level`.

### Ustawienia okna dziennika

Tutaj można zdefiniować rozmiar bufora historii, tzn. liczbę wierszy dziennika, który jest utrzymywany. Jeśli jest więcej wierszy wysłanych przez &gnupg;, od ostatniego czyszczenia historii, wtedy starsze wiersze są wyrzucane póki nie będzie wystarczającego miejsca dla nowych.

Klikając na przycisk Ustaw bez ograniczeń ustawia się brak limitu na zapis historii. Należy zwrócić uwagę że zużyta pamięć przez &kwatchgnupg; rośnie z liczbą wyświetlanych wierszy. Jeśli używa się nielimitowanego rozmiaru historii, uruchamiać &kwatchgnupg; dla krótkich operacji, lub regularnie czyścić historie samodzielnie.

## Zasługi i licencje

&kwatchgnupg; copyright 2004 Klarälvdalens Datakonsult AB

Dokumentacja copyright 2004 Klarälvdalens Datakonsult AB

### Twórcy

- &Steffen.Hansen; hansen@kde.org

- &Marc.Mutz; &Marc.Mutz.mail;

- &David.Faure; &David.Faure.mail;

Tomasz Walachtomasz_rysz@o2.pl

&underFDL; &underGPL;

&documentation.index;