Commande csum

Objectif

La commande csum calcule un résumé de message pour les fichiers spécifiés à l'aide de l'algorithme de hachage spécifié.

Syntaxe

Csum [-o fichier de sortie] [-h algorithme] [-a] [File1, File2, ... | - ]

csum -i fichier_entrée[-h algorithme]

Descriptif

La commande csum calcule un résumé de message pour les fichiers spécifiés à l'aide de l'algorithme de hachage spécifié. Il s'agit d'un moyen fiable de vérifier l'intégrité des fichiers.

La commande csum écrit les historiques des messages dans un fichier spécifié qui peut ensuite être utilisé pour vérifier l'intégrité du fichier. Notez qu'un fichier peut être spécifié à l'aide de noms de chemin absolus ou relatifs.

La spécification de plusieurs indicateurs -i, -o ou -h n'est pas considérée comme une erreur ; la dernière instance de l'indicateur spécifié sera utilisée. Toutefois, l'utilisation simultanée des indicateurs -i et -o est une erreur.

Indicateurs

Article Descriptif
- Indique l'entrée à partir de stdin.
-a Indique qu'un résumé de message sera généré pour tous les fichiers.
-h algorithme Indique les algorithmes de hachage que la commande csum utilise pour générer un résumé de message ou pour vérifier les valeurs de résumé de message lors de l'utilisation de l'option -i . Les options suivantes sont disponibles :
  • SHA1: Utilise l'algorithme SHA-1 pour générer un résumé de message de 20 octets.
  • MD5: Utilise l'algorithme MD5 pour générer un résumé de message de 16 octets.
Remarque: ces options sont sensibles à la casse.
Si cette option -h n'est pas utilisée, la commande csum utilise par défaut l'algorithme MD5 pour générer et vérifier les historiques de messages.
-i fichier_entrée Indique un fichier d'entrée, généré par l'indicateur -o , qui contient des valeurs de synthèse de message de confiance. La commande csum calcule les valeurs de synthèse de message des fichiers spécifiés dans le fichier d'entrée et vérifie qu'elles correspondent aux valeurs de synthèse de message réelles du fichier existant.

L'indicateur -h doit être utilisé avec l'indicateur -i pour indiquer quel algorithme de hachage cryptographique est utilisé pour générer le fichier d'entrée. S'il n'est pas spécifié, l'algorithme MD5 est utilisé.

Si un fichier spécifié dans le fichier d'entrée génère une valeur de synthèse de message différente de la valeur stockée dans le fichier d'entrée ou si le fichier n'existe pas, le test de ce fichier échoue et la commande csum continue à traiter les fichiers spécifiés dans le fichier d'entrée.

-o fichier_sortie Indique un fichier de sortie que la commande csum utilisera pour écrire des valeurs de synthèse de message. Cet indicateur ne peut pas être utilisé avec l'indicateur -i . Si le fichier spécifié existe déjà, il sera écrasé.

Statut de sortie

La commande renvoie les valeurs suivantes :

Article Descriptif
0 % L'opération a abouti.
>0 Une erreur s'est produite.

Exemples

  1. Pour calculer le résumé des messages pour les fichiers cars et trucks, entrez:
    csum cars trucks
    Etant donné que l'option -h n'est pas spécifiée, les valeurs MD5 sont calculées pour les fichiers cars et trucks.
    Si 9875DD0B18C15899988F29E9D85346A4 et E8C3ABB5E1D48FA519135EAB0FE40932 sont les valeurs MD5 pour cars et trucks, respectivement, la commande csum génère les résultats suivants:
    9875DD0B18C15899988F29E9D85346A4        cars
    E8C3ABB5E1D48FA519135EAB0FE40932        trucks
  2. Pour calculer le résumé de message pour tous les fichiers dont le nom commence par file et stocker la sortie dans un fichier appelé mdvalues, entrez:
     csum -o mdvalues file*
    Le fichier de sortie, mdvalues, contiendra le texte suivant si le répertoire dans lequel la commande csum est exécutée contient les fichiers file1, file2, et file3 et les valeurs MD5 de ces fichiers sont les suivantes:
    B026324C6904B2A9CB4B88D6D61C81D1        file1
    26AB0DB90D72E28AD0BA1E22EE510510        file2
    D7FCE9FEE471194AA8B5B6E47267F03         file3
  3. Pour vérifier que les historiques de messages du fichier mdvalues correspondent aux valeurs de prétraitement de messages en cours pour ces mêmes fichiers, entrez:
    csum -i mdvalues
  4. Pour calculer le résumé de message pour le fichier user.dat à l'aide de l'algorithme SHA-1 , entrez:
    csum -h SHA1 user.dat
    Si la valeur SHA-1 du fichier user.dat est A77CBB748AC336558AFA1AE7F2B73F3765728E7B, la commande csum génère le résultat suivant:
    A77CBB748AC336558AFA1AE7F2B73F3765728E7B        user.dat

Emplacement

/usr/bin/csum