Utilisation en ligne de commande

Une fois l’outil installé, il est appelable en ligne de commande : gpf-md5-checker.

Fonctionnement général

Le programme va vérifier les hash md5 contenu dans le dossier GPF_WORK_DIR/upload Le fichier <fichier.md5> peut contenir plusieurs hash. Chaque ligne doit être de la forme : <hash_md5>

Entre le hash md5 et le fichier se trouve deux espaces. Pour maximiser la compatibilité, l’algorithme va rechercher si le fichier contient 32 caractères pour le hash md5 puis du texte. Le programme s’occupe de convertir les fins de fichier Windows en unix.

Commandes et options

md5 Checker 2.6.2 - Vérifie l’intégrité des données publiées dans la Géoplateforme de l’IGN en se basant sur la signature md5 (hash) des fichiers.

gpf-md5-checker [-h] [-v] [--version] [-w WORK_DIR_PATH] [-u UPLOAD_DIR_NAME]
                [-c INPUT_CONFIGURATION_FILE_NAME] [--chunk-size CHUNK_SIZE]
                [--s3-url GPF_S3_URL] [--s3-key GPF_S3_KEY]
                [--s3-secret-key GPF_S3_SECRETKEY] [--s3-region GPF_S3_REGION]

gpf-md5-checker options

  • -h, --help - show this help message and exit

  • -v, --verbose - Verbosity level: None = WARNING, -v = INFO, -vv = DEBUG (default: 1)

  • --version - show program’s version number and exit

  • -w WORK_DIR_PATH, --workdir WORK_DIR_PATH, --work-dir-path WORK_DIR_PATH - Input working directory. Must exist. (default: None)

  • -u UPLOAD_DIR_NAME, --uploaddir UPLOAD_DIR_NAME, --upload-dir-name UPLOAD_DIR_NAME - Name (not the path) of the upload directory. (default: upload)

  • -c INPUT_CONFIGURATION_FILE_NAME, --input-configuration-filename INPUT_CONFIGURATION_FILE_NAME - Name (not the path) of the input configuration file. (default: parameters.json)

  • --chunk-size CHUNK_SIZE - Size of the chunk-data in octets to load in memory. (default: 8192)

  • --s3-url GPF_S3_URL - Url du storage S3 (default: http://localhost:9000)

  • --s3-key GPF_S3_KEY - Utilisateur du stockage S3 (default: admin)

  • --s3-secret-key GPF_S3_SECRETKEY - Password du stockage S3 (default: minioadmin)

  • --s3-region GPF_S3_REGION - Region du stockage S3 (default: eu-west-3)

Le programme va vérifier les hash md5 contenu dans le dossier `GPF_WORK_DIR/upload` Le fichier <fichier.md5> peut contenir plusieurs hash.
Chaque ligne doit être de la forme : <hash_md5>  <filename>

Entre le hash md5 et le fichier se trouve deux espaces. Pour maximiser la compatibilité, l'algorithme va rechercher si le fichier contient 32 caractères pour le hash md5 puis du texte.
Le programme s'occupe de convertir les fins de fichier Windows en unix.

Développé par Oslandia
Documentation : https://geoplateforme.pages.gpf-tech.ign.fr/scripts-verification/check-md5/

Variables d’environnement

Génériques

Nom de la variable

Argument CLI correspondant

Valeur par défaut

GPF_INPUT_CONFIGURATION_FILENAME

--input-configuration-filename

parameters.json

GPF_UPLOAD_DIR

--upload-dir-name

upload

GPF_WORK_DIR

--work-dir-path

Spécifiques

Nom de la variable

Argument CLI correspondant

Valeur par défaut

GPF_CHUNK_SIZE

--chunk-size

8192