http://docs.kde.org/
PrécédentGuide de l'administrateurSuivant

Configurer les programmes de sommes de contrôle pour être utilisés avec Créer/Vérifier des sommes de contrôle

Kleopatra permet à l'administrateur (et à l'utilisateur doté de privilèges) de configurer la liste des programmes de sommes de contrôle que l'utilisateur peut choisir depuis la boite de dialogue et que Kleopatra est capable d'auto-détecter quand demandé pour vérifier une somme de contrôle d'un fichier donné.

Note

Pour être utilisable par Kleopatra, la sortie du programme de contrôle (à la fois le fichier de somme de contrôle écrit ainsi que la sortie sur stdout lors de la vérification des sommes de contrôle) doit être compatible avec la commande md5sum et sha1sum de GNU.

En particulier, le fichier de somme de contrôle doit être fondé sur des lignes, chaque ligne ayant le format suivant : 

SOMME-DE-CONTRÔLE ' ' ( ' ' | '*' ) NOM-DE-FICHIER

où SOMME-DE-CONTRÔLE est constitué seulement de caractères hexadécimaux. Si NOM-DE-FICHIER contient un caractère de saut de ligne, la ligne doit plutôt être lue 

\SOMME-DE-CONTRÔLE ' ' ( ' ' | '*' ) NOM-DE-FICHIER-DE-SECOURS

où NOM-DE-FICHIER-DE-SECOURS est le nom de fichier avec les sauts de ligne remplacés par des \ns, et des antislashes doubles (\↦\\).

De même, la sortie de verify-command doit être de la forme 

NOM-DE-FICHIER ( « : Ok » | « : ÉCHEC » )

séparés par des sauts de ligne. Les sauts de ligne et autres caractères ne sont pas soustraits de la sortie. [2]

Chaque programme de contrôle est définie dans libkleopatrarc comme un groupe Checksum Definition #n distinct, avec les clés obligatoires suivantes :

file-patterns

Une liste d'expressions rationnelles décrivant les fichiers qui doivent être considérés comme des fichiers de sommes de contrôle pour ce programme de calcul de sommes de contrôle. La syntaxe est celle utilisée pour les listes de chaines dans les fichiers de configuration de KDE.

Note

Comme les expressions rationnelles contiennent généralement des anti-slashes, veuillez prendre soin de bien les supprimer du fichier de configuration. L'utilisation d'un outil d'édition de fichier de configuration est recommandée.

La plate-forme définit si les motifs sont traités en prenant en compte ou non la casse.

output-file

Le nom du fichier de sortie caractéristique de ce programme de somme de contrôle (doit, évidemment, correspondre à un des file-patterns). C'est celui que Kleopatra utilisera comme nom de fichier de sortie quand il créera des fichiers de somme de contrôle de ce type.

id

Un identifiant unique utilisé pour identifier ce programme de somme de contrôle en interne. Si vous n'êtes pas sûr, utilisez le nom de la commande.

Name (traduit)

Le nom du programme de somme de contrôle visible par l'utilisateur, comme affiché dans le menu déroulant de la boite de configuration de Kleopatra.

create-command

La commande actuelle avec laquelle créer des fichiers de sommes de contrôle. La syntaxe, les restrictions et les options de passage des arguments sont les mêmes que décrits pour pack-command dans la section intitulée « Configurer les gestionnaires d'archives pour être utilisés avec les fichiers signés/chiffrés. ».

verify-command

Pareil que create-command, mais pour la vérification de sommes de contrôle.

Voici un exemple complet : 

[Checksum Definition #1]
          file-patterns=sha1sum.txt
          output-file=sha1sum.txt
          id=sha1sum-gnu
          Name=sha1sum (GNU)
          Name[de]=sha1sum (GNU)
          ...
          create-command=sha1sum -- %f
          verify-command=sha1sum -c -- %f


[2] Effectivement, ces programmes n'ont pas été écrit avec des interfaces graphiques à l'esprit, et Kleopatra ne parviendra pas à analyser correctement les noms de fichiers pathologiques qui contiennent de multiples « : Ok » et sauts de ligne.