NAME

       storeBackupDel.pl - this program deletes backups created by storeBackup

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

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

       --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 chosen 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 2m 3m'
                       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 [-noOldFiles])

       --compressWith
                   compress saved log files (e.g. with 'gzip -9')
                   default is 'bzip2'

COPYRIGHT

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