Aller au contenu

Module md5

Le module md5 permet de calculer la somme de contrôle MD5 d'un fichier local. Il expose une fonction Lua simple pour obtenir la somme sous forme de chaîne hexadécimale.

Import

Pour importer le module :

local md5 = require("md5_1")

Configuration YAML

Le module md5 nécessite une configuration dans le fichier YAML de l'agent :

iot:
  modules:
    md5:
      - name: md5_1   # nom unique de l'instance du module

Détails de la configuration

  • name : Nom unique de l'instance du module. Utilisé pour l'import en Lua.

API Lua

Liste des fonctions

Fonction Signature Lua Rôle Retour (succès) Retour (échec)
md5 hash, err = md5.md5(path) Calcule le MD5 d'un fichier. string, nil nil, "msg"
Champs md5.name, md5.type Métadonnées du module.

md5.md5(path)

Calcule la somme MD5 du fichier spécifié.

  • Paramètres :
  • path (string) : Chemin absolu ou relatif vers le fichier.

  • Retour :

  • Une chaîne hexadécimale de 32 caractères représentant le MD5 du fichier.
  • nil, "<message d'erreur>" en cas d'échec (fichier introuvable, permission refusée, etc.).
local md5 = require("md5_1")

local sum, err = md5.md5("/chemin/vers/fichier.txt")
if not sum then
    print("Erreur lors du calcul du MD5 : " .. err)
else
    print("MD5 du fichier :", sum)
end

Champs Lua associés

  • md5.name : Retourne le nom de l'instance du module tel que défini en configuration.
  • md5.type : Retourne le type du module ("md5").