# Manuale di &kwatchgnupg;

## Introduzione

&kwatchgnupg; è un semplice visore del log di &gnupg; per le versioni di &gnupg; 1.4, 2.0 e 2.1. Funziona come una &GUI; che fa da involucro al programma da riga di comando &watchgnupg;, che si mette in ascolto su un socket per l'arrivo di righe di log dalle applicazioni di backend &gnupg;. Per maggiori informazioni su &watchgnupg; usa `info watchgnupg`.

&kwatchgnupg; può essere avviato dal menu Strumenti Visore di registri GnuPG di &kleopatra; e di &kmail;, oltre che dalla riga di comando. L'eseguibile di &kwatchgnupg; si chiama `kwatchgnupg`.

### Funzioni principali

#### Esaminare il log

La funzione principale di &kwatchgnupg; è naturalmente di presentare all'utente le informazione di debug e di log di &gnupg;. La finestra principale è divisa in una grande area di testo dove appaiono i messaggi di &gnupg; mano a mano che vengono generati, una barra di strumenti che offre accesso rapido alle funzioni di uso frequente, ed infine alla barra di menu.

Ciascuna linea della vista testuale ha normalmente un'intestazione comprendente l'identificatore di un FD ed un timbro orario in formato ISO. L'identificativo del descrittore del file (FD) può essere usato per distinguere tra varie istanze di &gnupg; in esecuzione parallela. L'orario è seguito dal nome del componente che ha prodotto la riga di log, assieme con alcune informazioni interne racchiuse fra parentesi quadre, ed infine c'è l'output di debug o di log come è stato generato dal componente.

Come impostazione predefinita, il numero di righe mantenuto nella cronologia è limitato a 10000. Puoi cambiare il numero di righe conservate dalla finestra di configurazione.

#### Salvare il contenuto della finestra del log in un file

A volte può essere utile salvare su un file il contenuto della finestra di log, per esempio per inviarlo agli sviluppatori come parte della segnalazione di un bug. Ci sono due modi di farlo in &kwatchgnupg;:

Primo, puoi scegliere File Salva col nome... (o l'azione corrispondente della barra degli strumenti) per salvare l'intero contenuto della finestra di log in un file. Ti verrà chiesto di specificare il percorso ed il nome del file in cui conservare le informazioni di log.

Secondo, puoi selezionare le righe che ti interessano con una normale selezione con il tasto sinistro del mouse ed incollarle in un programma di elaborazione di testi, o in un programma di posta elettronica, come qualsiasi altro testo. Assicurati però che le righe non vengano spezzate, perché questo riduce la leggibilità del log.

#### Pulire la finestra del log

Per comodità, puoi indicare a &kwatchgnupg; di pulire la finestra di log con la voce del menu File Pulisci cronologia (o con la corrispondente icona della barra degli strumenti).

File Salva come....

Pulendo il log si perde tutto il contenuto della finestra di log. Se non sei sicuro che non avrai bisogno del contenuto del log in futuro, dovresti salvarne il contenuto in un file (vedi sopra) prima di eseguire la pulizia.

## Configurazione di &kwatchgnupg;

Per configurare &kwatchgnupg; seleziona Impostazioni Configura &kwatchgnupg;, oppure fai clic sulla corrispondente azione della barra degli strumenti. La finestra di configurazione di &kwatchgnupg; è divisa in due parti che sono descritte qui di seguito.

### Finestra delle impostazioni

#### Impostazioni di &watchgnupg;

&watchgnupg; è il processo che tiene sotto controllo il socket per il log e formatta le linee di testo così come appaiono nella vista testuale di &kwatchgnupg;. Le impostazioni di questo gruppo sono passate al backend usando il meccanismo &gpgconf;.

Eseguibile contiene il percorso dell'applicazione &watchgnupg;. Se &watchgnupg; è nel `$PATH`, puoi usare il valore predefinito `watchgnupg`. Se il percorso di &watchgnupg; non è nell'elenco dei percorsi di `$PATH`, o se c'è più di una versione installata, inserisci in questa casella il percorso completo del programma watchgnupg.

Socket contiene il socket che &watchgnupg; deve tenere sotto controllo. Tutte le modifiche a questo valore verranno distribuite ai moduli di backend di &gnupg; che usano &gpgconf; quindi non è necessario cambiare questo valore se i file di configurazione di &gnupg; hanno il campo `log-file` configurato diversamente.

Livello predefinito log determina la quantità di informazione restituita dai moduli di backend. Vedi la documentazione di &watchgnupg; per sapere quale livello include un certo tipo di informazione. Tutte le modifiche a questo valore verranno distribuite ai moduli di backend di &gnupg; che usano &gpgconf; quindi non è necessario cambiare questo valore se i file di configurazione di &gnupg; hanno il campo `log-level` configurato diversamente.

#### Impostazioni della finestra del log

Qui puoi cambiare la dimensione della memoria della cronologia, &ie; il numero di righe di log che sono conservate. Se le righe di log emesse dai backend di &gnupg; dall'ultima pulizia della cronologia sono troppe, le più vecchie verranno scartate per fare posto a quelle nuove.

Puoi eliminare il limite sulla dimensione della cronologia facendo clic su Imposta illimitata. Ricorda però che l'occupazione di memoria di &kwatchgnupg; crescerà in proporzione al numero di righe di log che vengono conservate. Se usi una dimensione illimitata per la cronologia, assicurati che &kwatchgnupg; venga eseguito solo per brevi operazioni, oppure pulisci a mano la cronologia periodicamente.

## Riconoscimenti e licenza

&kwatchgnupg; è copyright 2004 Klarälvdalens Datakonsult AB

La documentazione è copyright 2004 Klarälvdalens Datakonsult AB

## Contributi

- &Steffen.Hansen; hansen@kde.org

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

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

Traduzione dell'applicazione e della documentazione a cura di Vincenzo Reale smart2128@baslug.org

Traduzione della documentazione a cura di Luciano Montanaro mikelima@cirulla.net, Federico Zenith zenith@chemeng.ntnu.no

&underFDL; &underGPL;
&documentation.index;