expirebackups(1)

📦 version 0.1.6, in ubuntu jammy, ubuntu noble, ubuntu questing, ubuntu resolute, ubuntu stonking

💖 expirebackups — the manual page, but make it cute 💖

okay bestie, welcome to expirebackups from the simple backup suite — she's the friend who goes through your closet and gently tells you which backups are so last season ✨

🌸 NAME 🌸

expirebackups — list old backups 📋

yes literally that's it. she lists. she does not delete. she's a looker, not a toucher 💅

🎀 SYNOPSIS 🎀

expirebackups [keep_this_many] path

✨ DESCRIPTION ✨

okay so here's the vibe 🌈 expirebackups goes snooping through the path you gave her, looking for backups that were made by simplebackup(1).

and then — and this is the part that matters — if she finds more than keep_this_many generations of a backup chilling in there, she prints the oldest files to stdout. that's it. that's the whole job. she just tells you, she doesn't touch anything 🙈

which is actually iconic of her, because it means you get to decide what happens next. those printed files can then be deleted, and the result is that you keep exactly keep_this_many generations of every backup unharmed. nobody gets hurt. everyone stays cute. periodt 👑

💅 OPTIONS 💅

  • keep_this_many — how many files you wanna keep of every backup. the default value is 4. (four is a vibe, four is a lifestyle, but you can change it 🍓)
  • path — the path to check for backups. heads up though: she's picky. only files matching a pattern like hostname-YYYYMMDD.tar.gz are even considered backup files. everything else? not her business, not her problem, she's not looking 💀

🔥 SEE ALSO 🔥

iykyk 🦋

👑 AUTHOR 👑

expirebackups was written by Christian Garbs <mitch@cgarbs.de>. give him his flowers fr fr 💐

expirebackups is licensed under GNU GPL. free as in bestie, not free as in situationship ✨

ngl the safest workflow here is: run her, read the list, and only then go feral with rm. she's giving helpful, not giving destructive 🫶

Christian Garbs · version 0.1.6 · expirebackups(1)

that's the whole page bestie, tysm for reading, go forth and expire responsibly 💖🎀🦋🌸💅

📦 where this page comes from