storeBackupUpdateBackup.pl

You only need to run this program if you use option lateLinks in storeBackup.pl. See section 3.4.3 about performance why you perhaps want to use this option and section 5.5 how to use it.
StoreBackupUpdateBackup.pl does the job of generation hard links, directories, symbolic links, compression of files and setting permissions storeBackup.pl does not do with option lateLinks. Before it starts doing this, it will check the consistency of your references resulting from the use of lateLinks in your backup repository, eg. it detects if one backup is missing.
To correct inconsistencies, use storeBackupUpdateBackup.pl in interactive mode (option --interactive).

usage:
       storeBackupUpdateBackup.pl -b backupDirectory [--autorepair]
             [--print] [--verbose] [--debug] [--lockFile] [--noCompress]
             [--progressReport number] [--checkOnly]
             [--logFile
              [--suppressTime] [-m maxFilelen]
              [[-n noOfOldFiles] | [--saveLogs]]
              [--compressWith compressprog]] 

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

The only option you have to specify is backupDir, the rest of the options are optional. This program only accepts parameters on the command line. It is not possible to use a configuration file.

--interactive / -i

Interactive mode for repairing / deleting currupted backups created with option lateLinks.

--backupDir

The repository, where all your backups are stored. If you have one series of backup (eg. from one computer), this will normally be similar to the directory where you backups are. The meaning of this parameter is similar to the option backupDir of storeBackup, see section 4.2.

--autorepair / -a

If storeBackupUpdateBackup.pl detects inconsistencies which do not harm your repository, it will repair the reference files automatically without asking you. It will only write an ERROR message in the log file and tells you what it repaired.
If you eg. delete your last backup with lateLinks with rm (which you should not do before successfully running this program!), then the internal referencing structure of your backups is inconsistent. StoreBackupUpdateBackup.pl (and also storeBackup.pl) will recognize, that a backup which referenced to another one is missing. But correcting the reference structure does not lead to a loss of data, so this is an example when it can be repaired without user intervention. (For more information see special files.)

--print

Prints the options used and stops after printing the options. In case of difficult quoting (especially on the command line) this gives you the chance to see what's really used in the program.

--verbose / -v

Generate verbose messages.

--debug / -d

Generate detailed information about linking, compressing, etc.

--lockFile / -L

Specify a lock file. If the lock file exists and a process with the id stored in it is running, then the program will immediately stop to avoid running it multiple times (which is a very bad idea). The default is /tmp/storeBackupUpdateBackup.lock. You should also not run storeBackupUpdateBackup.pl in parallel to storeBackup.pl.

--noCompress / noCompress

Maximal number of parallel compression operations. Default value is chosen automatically as the number of cores plus 1.

--checkOnly / -c

Do not perform any action, only check the consistency. Use this in combination with option --debug to get detailed information.

--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

--logFile / -l / logFile

Name of the log file. Default is stdout.

--supressTime / supressTime

Suppress the output of the actual time in the log file.

--maxFilelen / -m / maxFilelen

Maximal size of a log file. After reaching this size, the log file will be rotated (see option noOfOldFiles) or compressed (see option saveLogs).

--noOfOldFiles / -n / noOfOldFiles

Number of old rotated log files, default is 5. With default values, it will look like this:

$ ls -l /tmp/storebackup.log*
-rw------- 1 hjc  root  328815 30. Aug 12:12 /tmp/storebackup.log
-rw------- 1 root root 1000087 27. Aug 21:18 /tmp/storebackup.log.1
-rw------- 1 root root 1000038 20. Aug 19:02 /tmp/storebackup.log.2
-rw------- 1 root root 1000094 11. Aug 18:51 /tmp/storebackup.log.3
-rw------- 1 root root 1000147 11. Aug 18:49 /tmp/storebackup.log.4
-rw------- 1 root root 1000030 11. Aug 18:49 /tmp/storebackup.log.5

Older log files than *.5 have been deleted automatically.

--saveLogs / saveLogs

Save the log files with a time and date stamp instead of deleting them after rotating. (Setting this option overwrites the default value of option noOfOldFiles.)

--compressWith / compressWith

Specifies the program to compress the saved log files (eg. with gzip -9). Default value is bzip2.
On the command line, the parameter to this option is parsed like a line in the configuration file and normally has to be quoted on the command line.