# Manuel de &kwatchgnupg;

## Introduction

&kwatchgnupg; est un simple afficheur de journaux pour &gnupg;. Il fonctionne comme une couche &GUI; s'appuyant sur l'outil en ligne de commandes pour &watchgnupg;, en écoutant un socket à ma recherche de lignes de journal à partir des applications des moteurs &gnupg;. Veuillez consulter les `informations sur watchgnupg` pour plus de détails sur &watchgnupg;.

&kwatchgnupg; peut être lancé depuis l'entrée de menu Outils Afficheur de journaux « GnuPG », présent, à la fois dans &kleopatra; et dans &kmail;, ou encore depuis une ligne de commandes. L'exécutable &kwatchgnupg; est nommé `kwatchgnupg`.

### Fonctions principales

#### Afficher le journal

La fonction principale de &kwatchgnupg; est bien sûr de vous présenter les informations de débogage et de journal de &gnupg; à l'utilisateur. La fenêtre principale est divisée une grande zone d'affichage de texte, où les messages de &gnupg; apparaitront tels qu'ils sont générés, une barre d'outils donnant un accès rapide aux fonctionnalités les plus souvent nécessaire, et enfin l'inévitable barre de menu.

Chaque ligne dans la vue principale est normalement préfixée d'un identifiant FD et d'un horodatage au format ISO. L'identifiant FD peut servir à distinguer la sortie des différentes instances de &gnupg; lancées en parallèle. Après l'horodatage se trouve le nom du composant à l'origine de la ligne du journal, réunis avec des informations internes information par des crochets, le tout suivi de la version original de la sortie de débogage ou du journal tel que donnée par le composant.

Par défaut, le nombre de lignes de journal conservées dans l'historique est limité à 10 000. Vous pouvez configurer la taille de l'historique dans la boite de dialogue de configuration.

#### Enregistrer les contenus de la fenêtre de journal dans un fichier

Parfois il est bien pratique de pouvoir enregistrer dans un fichier le contenu de la fenêtre courante du journal, &pex; pour l'envoyer par courriel aux développeurs dans un rapport de bug. Il y a deux manière de s'y prendre dans &kwatchgnupg; :

Premièrement, vous pouvez sélectionner Fichier Enregistrer sous... (ou l'icône correspondante dans la barre d'outils) pour enregistrer dans un fichier la totalité du contenu de la fenêtre du journal. Il vous sera alors demandé d'indiquer l'emplacement du fichier cible.

Deuxièmement, vous pouvez sélectionner les lignes qui vous intéressent avec la souris et les coller dans un éditeur texte ou votre client de courriel, comme vous le feriez avec n'importe quel texte. Assurez-vous tout de même que les lignes ne sont pas cassées, rendant mauvaise le lisibilité du résultat.

#### Effacement de la fenêtre du journal

Pour plus de commodité, vous pouvez demander à &kwatchgnupg; d'effacer la fenêtre du journal grâce à Fichier Effacer l'historique (ou grâce à l'icône de barre d'outils correspondante).

Veuillez utiliser ceci avant de commencer l'opération de chiffrement que vous souhaitez surveiller pour obtenir uniquement la sortie de cette opération. Vous pouvez ensuite enregistrer le journal en utilisant Fichier Enregistrer sous... comme décrit ci-dessus.

L'effacement du journal supprime tout contenu précédent de la fenêtre de journal. Si vous ne savez pas si vous aurez besoin du contenu actuel par la suite, vous devez l'enregistrer dans un fichier (Voir ci-dessus) avant de l'effacer.

## Configuration de &kwatchgnupg;

Pour configurer &kwatchgnupg;, veuillez sélectionner Configuration Configurer &kwatchgnupg; ou l'icône correspondante dans la barre d'outils. La boite de dialogue de configuration de &kwatchgnupg; est divisée en deux parties, dont chacune sera décrite ci-dessous.

### Boîte de dialogue de configuration

#### Configuration de &watchgnupg;

&watchgnupg; est le processus surveillant actuellement l'activité du socket de journalisation et formate les lignes comme indiqué dans la vue en texte de &kwatchgnupg;. Les paramètres de ce groupe sont transmis au moteur à l'aide du mécanisme &gpgconf;.

L'exécutable contient l'emplacement de l'application &watchgnupg;. Si &watchgnupg; se trouve dans votre variable d'environnement `$PATH`, vous pouvez conserver le paramètre `watchgnupg` par défaut. Si &watchgnupg; ne figure pas dans votre variable d'environnement `$PATH` ou si plusieurs versions sont installées, veuillez saisir ici l'emplacement absolu de l'exécutable &watchgnupg;.

Un socket contient le socket que &watchgnupg; doit écouter. Une modification ici est distribuée à tous les modules de moteurs &gnupg; à l'aide de &gpgconf;. Donc, vous n'avez pas besoin de modifier ce paramètre si vos fichiers de configuration &gnupg; ont un autre `fichier journal` défini.

Le niveau de journalisation par défaut détermine la quantité d'informations de journalisation renvoyées par les modules principaux de moteurs. Veuillez consulter la documentation de &watchgnupg; pour savoir quel niveau comprend quelles informations. Une modification ici est distribuée à tous les modules de moteurs de &gnupg; à l'aide de &gpgconf;. Vous n'avez donc pas besoin de modifier ce paramètre si vos fichiers de configuration de &gnupg; ont un autre `niveau journal` défini.

#### Journaliser la configuration de fenêtres

Vous pouvez configurer, ici, la taille du tampon d'historique, &cad; le nombre de lignes de journal à conserver. Si plus de lignes ont été émises par le moteur &gnupg; depuis la dernière validation de l'historique, alors, les lignes les plus anciennes sont supprimées jusqu'à ce qu'il y ait à nouveau suffisamment de place pour les nouvelles lignes.

Vous pouvez désactiver la limite de taille de l'historique en cliquant sur Définir de façon illimitée. Veuillez toutefois noter que la consommation de mémoire de &kwatchgnupg; augmentera avec le nombre de lignes qu'il affiche actuellement. Si vous utilisez une taille d'historique illimitée, veuillez alors vous assurer d'exécuter &kwatchgnupg; uniquement pour des opérations courtes ou d'effacer régulièrement l'historique manuellement.

## Remerciements et licence

&kwatchgnupg; copyright 2004 Klarälvdalens Datakonsult AB

Documentation copyright 2004 Klarälvdalens Datakonsult AB

## Contributeurs

- &Steffen.Hansen; hansen@kde.org

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

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

Traduction française par Mickaël Sibelle

&underFDL; &underGPL;
&documentation.index;