STOREBA...TEBACKUP(1)

📦
version 3.5.2 · 3 versions
, in ubuntu stonking

💖 STOREBA...TEBACKUP(1) — the storeBackupUpdateBackup.pl era 💖

okay bestie, listen. this is a User Contributed Perl Documentation page, and it's about storeBackupUpdateBackup.pl — the little helper that cleans up after storeBackup.pl when you used --lateLink and/or --lateCompress. she's giving cleanup-crew energy and honestly? obsessed. 🌸

✨ NAME ✨

storeBackupUpdateBackup.pl — updates / finalizes backups created by storeBackup.pl with option --lateLink, --lateCompress.

yes that's it, that's the whole job description, no cap 💅

🎀 SYNOPSIS 🎀

like, here's the summoning ritual:

storeBackupUpdateBackup.pl -b backupDirectory [--autorepair]
      [--print] [--verbose] [--debug] [--lockFile] [--noCompress]
      [--progressReport number] [--checkOnly] [--copyBackupOnly]
      [--dontCopyBackup] [-A archiveDurationDeltaCache]
      [--dontDelInDeltaCache] [--createNewSeries]
      [--noWarningDiffSeriesInBackupCopy] [--maxHardLinks]
      [--logFile
       [--plusLogStdout] [--suppressTime] [-m maxFilelen]
       [[-n noOfOldFiles] | [--saveLogs]]
       [--compressWith compressprog]]

storeBackupUpdateBackup.pl --interactive --backupDir topLevlDir
      [--autorepair] [--print]

storeBackupUpdateBackup.pl --genBackupBaseTreeConf directory

storeBackupUpdateBackup.pl --genDeltaCacheConf directory

(yes, topLevlDir — that typo is canon, I don't make the rules 🫶)

🚨 WARNING 🚨

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

fr fr, bestie, like… DESTROY. YOUR. BACKUPS. this is not a drill, this is not a vibe check you want to fail. read it again. 😭💀

👑 OPTIONS 👑

one bullet per flag, no skipping, we respect the lore:

  • --interactive, -i — interactive mode, for reparing / deleting currupted backups created with option --lateLinks (the typos in "reparing"/"currupted" are load-bearing, we keep them exactly 💖)
  • --backupDir, -b — top level directory of all backups (must exist)
  • --autorepair, -a — repair simple inconsistencies automatically, without asking you for permission first
  • --print — print the configuration that was read from the configuration file, then stop
  • --verbose, -v — verbose messages, she's chatty
  • --debug, -d — generate detailed information about the files, with the linking information in it
  • --lockFile, -L — lock file; if it exists, new instances will finish (bail out) if an old one is already running. If you set it to the same file as in storeBackup, it will prevent $prog from running in parallel to storeBackup — default is $lockFile.
heads up: this type of lock file does not work across multiple servers, and it 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 lives in /var/lock, for everyone else it's in $HOME ✨

  • --noCompress — maximal number of parallel compress operations, default = chosen automatically
  • --checkOnly, -c — do not perform any action, only check consistency (the look-don't-touch option 💅)
  • --copyBackupOnly — only do the task to replicate incremental (lateLinks) backup; no hard linking, compression, etc.
  • --dontCopyBackup — do not do any replication task to copy incremental (lateLink) backups
NOTE: if used on the master cache, this option disrupts the data flow for replication! 🙈
  • --archiveDurationDeltaCache, -A — duration after which already-in-backupCopy copied and linked backups will be deleted. This affects all series in deltacaches processedbackups directory. The duration has to be specified in the format 'dhms', e.g. 10d4h means 10 days and 4 hours, default is 99d (similar to option keepAll in storeBackupDel.pl)
  • --dontDelInDeltaCache — do not delete any backup in deltaCache
  • --createNewSeries, -C — automatically create new series in deltaCache and the replication directory / directories. This is especially useful if you use wildcards to specify the series name which should be added 'on the fly' 🦋
  • --progressReport — print a progress report:
    • after each number files when compressing
    • after each number * 1000 files when linking
    • after each number * 10000 files when performing chmod
  • --noWarningDiffSeriesInBackupCopy, -N — do not write a warning if there is a different set of series inside the backup copy (replication directory) than in the actual deltaCache
  • --maxHardLinks — maximum number of hard links to use. zero (default) means the limit depends on the file system used only
  • --logFile, -l — logFile, Default: 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 log 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 ones (with [-noOfOldFiles])
  • --compressWith — compress saved log files (e.g. with 'gzip -9'). default is 'bzip2'
  • --genBackupBaseTreeConf — generate a template of the backup-copy configuration file for the backup directories (both source and target)
  • --genDeltaCacheConf — generate a template of the backup-copy configuration file for the deltaCache directory

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

and that's the whole page, bestie — 💜 sign-off time: this beauty is perl v5.40.1, dated 2026-05-23. iconic. periodt. 💅✨🎀

📦 where this page comes from