Module Lua 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, ainsi qu’un second retour en cas d’erreur.

Pour l’importer, utilisez la déclaration suivante :

local md5mod = require("md5")
-- remplacer md5 par le name dans le fichier de configuration

Configuration

Le module md5 ne nécessite qu’un seul paramètre de configuration : son nom logique dans l’agent.

Exemple complet de configuration dans le fichier YAML de l’agent :

iot:
  modules:
    md5:      # identifiant du module dans la section iot/modules
      - name: md5_1   # nom unique de l’instance du module

Détails de la configuration

• name : Nom de l’instance du module. Doit être unique, sans espaces ni caractères spéciaux.

Fonctions Lua

md5.md5(path)

Calcule la somme MD5 du fichier spécifié par path.

• Paramètres :

• path (string) : Chemin absolu ou relatif vers le fichier dont on veut calculer le MD5.

• Retours :

• (string) : Chaîne hexadécimale de 32 caractères représentant le MD5 du fichier.

• nil, (string) : En cas d’erreur (fichier introuvable, permission refusée, etc.), retourne nil suivi d’un message d’erreur explicite.

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 (ici, "md5").