# `waarp-gatewayd purge`

`waarp-gatewayd purge` est la commande permettant de purger l’historique de transfert afin de libérer de l’espace disque sur la base de données.

Avertissement

Évidemment, cette purge est irréversible, soyez donc prudent lorsque vous l’utilisez. La commande vous demandera confirmation avant d’effectuer la purge.

Cette commande accepte les options suivantes :

--config FILE, -c FILE

  Définit le fichier de configuration à utiliser.

  Si aucun fichier spécifique n’est fourni avec cet argument, les emplacements par défaut suivants sont recherchés (dans cet ordre) :

  - `gatewayd.ini`, relatif au dossier courant (Linux et Windows)

  - `etc/gatewayd.ini`, relatif au dossier courant (Linux)

  - `etc\gatewayd.ini`, relatif au dossier courant (Windows)

  - `/etc/waarp-gateway/gatewayd.ini` (Linux)

  - `%ProgramData%\gatewayd.ini` (Windows)

--older-than, -o

  Limite la purge aux transferts plus anciens que le temps donné. Peut être soit une date, auquel cas, seuls les transferts antérieurs à cette date seront supprimés; soit une durée, auquel cas, seuls les transferts plus anciens que cette durée seront supprimés.

  La date doit être au format `aaaa/MM/dd hh:mm:ss` (exemple: `2022/10/25 08:00:00`).

  La durée est une succession arbitraire de valeurs de temps (exemple: `1y3mo2d` pour 1 an, 3 mois et 2 jours). Les unités de temps suivantes sont acceptées:

  - Nanosecondes: ns

  - Microsecondes: us, µs (U+00B5), μs (U+03BC)

  - Millisecondes: ms

  - Secondes: s, sec, second, seconds

  - Minutes: m, min, minute, minutes

  - Heures: h, hr, hour, hours

  - Jours: d, day, days

  - Semaines: w, wk, week, weeks

  - Mois: mo, mon, month, months

  - Années: y, yr, year, years

--reset, -r

  Si cette option est présente, en plus de purger d’historique, la commande réinitialisera l’auto-incrément des identifiants locaux de transfert à zéro.

  Avertissement

  Cette option ne peut être utilisée que si la table des transferts en cours est vide. Dans le cas contraire, la commande échouera.

--export-to, -e

  Cette option permet de fournir le chemin d’un fichier dans lequel les transferts purgés seront sauvegardés. Cette option permet donc de générer un dump des transferts purgés. Ce dump peut ensuite être restauré via la commande waarp-gatewayd restore-history si nécessaire.

--verbose, -v

  Active l’écriture des logs sur la sortie d’erreur. Cet argument peut être répété jusqu’à 3 fois pour augmenter la verbosité (ex : `-vvv`).