BACKUP-MANAGER-PURGE(8)

📦
version 0.7.14 · 3 versions
, in debian trixie, ubuntu resolute, ubuntu stonking

✨ BACKUP-MANAGER-PURGE 💅

okay so bestie, this is the man page for backup-manager-purge(8) — yes it lives in section 8 of the manual, that's the fancy system-admin section, periodt. 👑

🌸 NAME 🌸

backup-manager-purge — literally backup-manager's wrapper for outdating files 🗂️✨

🎀 SYNOPSIS 🎀

backup-manager-purge [TTL] <options>

🦋 DESCRIPTION 🦋

so backup-manager-purge is THE only authorized entity that can say if an archive should be purged or not. no cap. it's the main character when it comes to deciding who stays and who goes. 🫶

any tasks that backup-manager uses may need to know if an archive is deprecated (eg: the purging phase of an upload method). that's the whole reason this tool exists, it's here to fulfill that need. iykyk. 💖

give it a time to live (TTL) plus a list of archives, and backup-manager-purge will hand you back another list of archives — the ones that are outdated by the TTL. it's giving glow-up but in reverse 😭

👑 REQUIRED ARGS 👑

  • --ttl=time-to-live — specify the time to live (in days) for the archives. any archive that is older than ttl days will be outdated. no ttl, no vibes, this one's mandatory fr fr. ⏳

🍓 OPTIONAL ARGS 🍓

  • --files-from=file — a file containing a list of archives to parse, one archive per line. if this option is not used, STDIN will be used for catching the files to parse. so either you hand it a file or it just reads from the stream, whatever slays for u. 🌈

🌟 RETURN 🌟

backup-manager-purge will return the list of outdated files on STDOUT, one file per line. clean, simple, iconic. ✨

💀 ERROR CODES 💀

if an error occurs, it will print the error message on stderr and will exit with an error code greater than 0.

here are the possible error codes:

  • bad command line (wrong arguments) : 10
  • internal error (should be reported as a bug) : 20
ok so if you hit 20, that's not your fault bestie, that's a bug, report it. 🙈

🔥 SEE ALSO 🔥

💜 AUTHORS 💜

concept and design by Alexis Sukrieh and Jan Metzger. kings. 👑

and that's a wrap, angel — this beauty shipped with perl v5.40.1 back on 2025-04-11, so go forth and purge responsibly. mwah 🎀💖🌈

📦 where this page comes from