STOREBACKUPDEL(1)

📦 version 3.5.2, in nixos 26.05, nixpkgs unstable, opensuse-leap 16.0

💾 STOREBACKUPDEL(1) 💾

okay so this is the User Contributed Perl Documentation page, bestie — buckle up, we're talking about deleting backups 💖✨

✨ NAME ✨

storeBackupDel.pl — this program deletes backups created by storeBackup. that's the whole name vibe, periodt. 🗑️✨

🌸 SYNOPSIS 🌸

storeBackupDel.pl [-f configFile] [--print]
[-b backupDirectory] [-S series] [--doNotDelete]
[--deleteNotFinishedDirs] [-L lockFile]
[--keepAll timePeriod] [--keepWeekday entry] [--keepFirstOfYear]
[--keepLastOfYear] [--keepFirstOfMonth] [--keepLastOfMonth]
[--keepFirstOfWeek] [--keepLastOfWeek]
[--keepDuplicate] [--keepMinNumber] [--keepMaxNumber]
[-l logFile
 [--plusLogStdout] [--suppressTime] [-m maxFilelen]
 [[-n noOfOldFiles] | [--saveLogs]
 [--compressWith compressprog]]

⚠️ WARNING ⚠️

!!! USAGE IN PARALLEL WITH storeBackup.pl CAN DESTROY YOUR BACKUPS !!!

like literally do not run this in parallel with storeBackup.pl, bestie. it can destroy your backups, no cap. 😭💀

💅 OPTIONS 💅

  • --file, -f — configuration file (instead of parameters) 🎀
  • --print — print configuration read from configuration file and stop ✨
  • --backupDir, -b — top level directory of all backups (must exist) 💾
  • --series, -S — directory of backup series; same parameter as in storeBackup; relative path from backupDir, default is 'default' 🌸
  • --lockFile, -L — lock file. if exists, new instances will finish if an old is already running, default is $lockFile. this type of lock files does not work across multiple servers and is not designed to separate storeBackup.pl and storeBackupUpdateBackup.pl or any other storeBackup process in a separate PID space. Default lock file for root is in /var/lock, for others in \$HOME 🔒
  • --doNotDelete — test only, do not delete any backup 🙈
  • --deleteNotFinishedDirs — delete old backups which where not finished. this will not happen if doNotDelete is set 🧹
  • --keepAll — keep backups which are not older than the specified amount of time. This is like a default value for all days in --keepWeekday. Begins deleting at the end of the script. the time range has to be specified in format 'dhms', e.g. 10d4h means 10 days and 4 hours. default = $keepAll; ⏳
  • --keepWeekday — keep backups for the specified days for the specified amount of time. Overwrites the default values choosen in --keepAll. 'Mon,Wed:40d Sat:60d10m' means:
    • keep backups of Mon and Wed 40days + 5mins
    • keep backups of Sat 60days + 10mins
    • keep backups of the rest of the days like spcified in --keepAll (default $keepAll) if you also use the 'archive flag' it means to not delete the affected directories via --keepMaxNumber:
    • a10d4h means 10 days and 4 hours and 'archive flag' e.g. 'Mon,Wed:a40d Sat:60d10m' means:
    • keep backups of Mon and Wed 40days + 5mins + 'archive'
    • keep backups of Sat 60days + 10mins
    • keep backups of the rest of the days like specified in --keepAll (default $keepAll) 📅
  • --keepFirstOfYear — do not delete the first backup of a year. format is timePeriod with possible 'archive flag' 🎉
  • --keepLastOfYear — do not delete the last backup of a year. format is timePeriod with possible 'archive flag' 🎊
  • --keepFirstOfMonth — do not delete the first backup of a month. format is timePeriod with possible 'archive flag' 🌙
  • --keepLastOfMonth — do not delete the last backup of a month. format is timePeriod with possible 'archive flag' 🌝
  • --firstDayOfWeek — default: 'Sun'. This value is used for calculating --keepFirstOfWeek and --keepLastOfWeek 📆
  • --keepFirstOfWeek — do not delete the first backup of a week. format is timePeriod with possible 'archive flag' 🌈
  • --keepLastOfWeek — do not delete the last backup of a week. format is timePeriod with possible 'archive flag' ⭐
  • --keepDuplicate — keep multiple backups of one day up to timePeriod. format is timePeriod, 'archive flag' is not possible. default = $keepDuplicate; 👯
  • --keepMinNumber — Keep that miminum of backups. Multiple backups of one day are counted as one backup. Default is 10. 🔢
  • --keepMaxNumber — Try to keep only that maximum of backups. If you have more backups, the following sequence of deleting will happen:
    • delete all duplicates of a day, beginning with the old once, except the oldest of every day
    • if this is not enough, delete the rest of the backups beginning with the oldest, but never a backup with the 'archive flag' or the last backup 🗑️
  • --keepRelative, -R — Alternative deletion scheme. If you use this option, all other keep options are ignored. Preserves backups depending on their relative age. Example: -R '1d 7d 61d 92d' will (try to) ensure that there is always
    • One backup between 1 day and 7 days old
    • One backup between 5 days and 2 months old
    • One backup between 2 months and 3 months old If there is no backup for a specified timespan (e.g. because the last backup was done more than 2 weeks ago) the next older backup will be used for this timespan. 🦋
  • --logFile, -l — log file (default is STDOUT) 📝
  • --plusLogStdout — if you specify a log file with --logFile you can additionally print the output to STDOUT with this flag 🖨️
  • --suppressTime — suppress output of time in logfile ⏰
  • --maxFilelen, -m — maximal length of file, default = 1e6 📏
  • --noOfOldFiles, -n — number of old log files, default = 5 🗂️
  • --saveLogs — save log files with date and time instead of deleting the old (with [-noOfOldFiles]) 💾
  • --compressWith — compress saved log files (e.g. with 'gzip -9'). default is 'bzip2' 🗜️

Copyright (c) 2003-2022 by Heinz-Josef Claes (see README). Published under the GNU General Public License v3 or any later version. 💜

okay that's the whole page bestie — it's from perl v5.34.0, dated 2022-03-20, and it's STOREBACKUPDEL(1); now go delete those backups responsibly ✨💅

📦 where this page comes from