storeBackupls.pl

storeBackupls.pl gives you information about the age and deletion rules of a backup series.

    storeBackupls.pl -f configFile [--print] [storeBackup-dir]
    storeBackupls.pl [-v] [--print] storeBackup-dir

There are two possible styles to call it (with examples):

# /opt/test/storeBackup/bin/storeBackupls.pl . 
  1  Fri Jul 04 2008   2008.07.04_20.17.13   -61
  2  Sat Jul 05 2008   2008.07.05_21.19.09   -60
  3  Sun Jul 06 2008   2008.07.06_17.38.22   -59
  4  Mon Jul 07 2008   2008.07.07_17.31.43   -58
  5  Fri Jul 11 2008   2008.07.11_19.20.14   -54
  6  Sat Jul 12 2008   2008.07.12_18.17.21   -53
  7  Sun Jul 13 2008   2008.07.13_17.07.53   -52
  8  Mon Jul 14 2008   2008.07.14_06.28.29   -51
  9  Tue Jul 15 2008   2008.07.15_07.44.41   -50
 10  Wed Jul 16 2008   2008.07.16_17.56.35   -49
 11  Thu Jul 17 2008   2008.07.17_10.13.47   -48
 12  Fri Jul 18 2008   2008.07.18_14.13.26   -47
 13  Sat Jul 19 2008   2008.07.19_16.03.40   -46
 14  Fri Jul 25 2008   2008.07.25_09.29.39   -40
 15  Mon Jul 28 2008   2008.07.28_19.01.04   -37
 16  Wed Jul 30 2008   2008.07.30_17.25.43   -35
 17  Thu Jul 31 2008   2008.07.31_16.45.56   -34
 18  Fri Aug 01 2008   2008.08.01_16.43.56   -33
 19  Mon Aug 04 2008   2008.08.04_17.26.42   -30
 20  Thu Aug 07 2008   2008.08.07_16.16.21   -27
 21  Fri Aug 08 2008   2008.08.08_20.59.46   -26
 22  Sat Aug 09 2008   2008.08.09_20.48.31   -25
 23  Sun Aug 10 2008   2008.08.10_14.29.18   -24
 24  Mon Aug 11 2008   2008.08.11_19.51.32   -23
 25  Tue Aug 12 2008   2008.08.12_14.13.02   -22
 26  Wed Aug 13 2008   2008.08.13_20.41.43   -21
 27  Thu Aug 14 2008   2008.08.14_16.44.02   -20
 28  Fri Aug 15 2008   2008.08.15_19.47.29   -19
 29  Mon Aug 18 2008   2008.08.18_18.29.06   -16
 30  Tue Aug 19 2008   2008.08.19_17.58.42   -15
 31  Wed Aug 20 2008   2008.08.20_18.53.46   -14
 32  Thu Aug 21 2008   2008.08.21_19.56.03   -13
 33  Fri Aug 22 2008   2008.08.22_23.32.10   -12
 34  Sun Aug 24 2008   2008.08.24_12.57.36   -10
 35  Tue Aug 26 2008   2008.08.26_10.34.06   -8  not finished 
 36  Tue Aug 26 2008   2008.08.26_10.59.46   -8
 37  Tue Aug 26 2008   2008.08.26_13.07.08   -8

You see that backup number 35 was not finished. Using option verbose results in:

# /opt/test/storeBackup/bin/storeBackupls.pl -v .
. . .
 37  Tue Aug 26 2008   2008.08.26_13.07.08   -8
	version -> 1.3
	date -> 2008.08.26 13.07.08
	sourceDir -> '/backup'
	followLinks -> 1
	compress -> 'bzip2'
	uncompress -> 'bzip2' '-d'
	postfix -> '.bz2'
	exceptSuffix -> '.bz2' '.gif' '.gpg' '.gz' '.jpg' '.mp3' '.mpeg' '.mpg' '.ogg' '.png' '.tgz' '.tif' '.tiff' '.zip'
	exceptDirs -> '/backup/home_hjc/nosave'
	includeDirs -> 
	exceptRule -> '$file =~ /acronis.*tib/' 'or' '$file =~ m#/te?mp/#' 'or' '$file =~ m#/\.thumbnails/#'
	includeRule -> 
	exceptTypes -> 
	preservePerms -> yes
	lateLinks -> yes
	lateCompress -> no
	cpIsGnu -> yes

Only the output for the last backup is shown here. You can see which options of storeBackup.pl where used to generate the backup.

storeBackupls.pl -f configFile [--print] [storeBackup-dir] or
storeBackupls.pl --file configFile [--print] [storeBackup-dir]

Here it will read the configuration file of storeBackup.pl and tells something about the deletion status of each backup:

# storeBackupls.pl -f /backup/stbu-gentoo.conf .
. . .
WARNING   backup <./2008.08.26_10.34.06> not finished
analysis of old Backups in <.>:
   Fri 2008.07.04_20.17.13 (61): will be deleted
   Sat 2008.07.05_21.19.09 (60): keepWeekDays(60d)
   Sun 2008.07.06_17.38.22 (59): keepWeekDays(60d)
   Mon 2008.07.07_17.31.43 (58): keepWeekDays(60d)
   Fri 2008.07.11_19.20.14 (54): keepWeekDays(60d)
   Sat 2008.07.12_18.17.21 (53): keepMinNumber30, keepWeekDays(60d)
   Sun 2008.07.13_17.07.53 (52): keepMinNumber29, keepWeekDays(60d)
   Mon 2008.07.14_06.28.29 (51): keepMinNumber28, keepWeekDays(60d)
   Tue 2008.07.15_07.44.41 (50): keepMinNumber27, keepWeekDays(60d)
   Wed 2008.07.16_17.56.35 (49): keepMinNumber26, keepWeekDays(60d)
   Thu 2008.07.17_10.13.47 (48): keepMinNumber25, keepWeekDays(60d)
   Fri 2008.07.18_14.13.26 (47): keepMinNumber24, keepWeekDays(60d)
   Sat 2008.07.19_16.03.40 (46): keepMinNumber23, keepWeekDays(60d)
   Fri 2008.07.25_09.29.39 (40): keepMinNumber22, keepWeekDays(60d)
   Mon 2008.07.28_19.01.04 (37): keepMinNumber21, keepWeekDays(60d)
   Wed 2008.07.30_17.25.43 (35): keepMinNumber20, keepWeekDays(60d)
   Thu 2008.07.31_16.45.56 (34): keepMinNumber19, keepWeekDays(60d)
   Fri 2008.08.01_16.43.56 (33): keepMinNumber18, keepWeekDays(60d)
   Mon 2008.08.04_17.26.42 (30): keepMinNumber17, keepWeekDays(60d)
   Thu 2008.08.07_16.16.21 (27): keepMinNumber16, keepWeekDays(60d)
   Fri 2008.08.08_20.59.46 (26): keepMinNumber15, keepWeekDays(60d)
   Sat 2008.08.09_20.48.31 (25): keepMinNumber14, keepWeekDays(60d)
   Sun 2008.08.10_14.29.18 (24): keepMinNumber13, keepWeekDays(60d)
   Mon 2008.08.11_19.51.32 (23): keepMinNumber12, keepWeekDays(60d)
   Tue 2008.08.12_14.13.02 (22): keepMinNumber11, keepWeekDays(60d)
   Wed 2008.08.13_20.41.43 (21): keepMinNumber10, keepWeekDays(60d)
   Thu 2008.08.14_16.44.02 (20): keepMinNumber9, keepWeekDays(60d)
   Fri 2008.08.15_19.47.29 (19): keepMinNumber8, keepWeekDays(60d)
   Mon 2008.08.18_18.29.06 (16): keepMinNumber7, keepWeekDays(60d)
   Tue 2008.08.19_17.58.42 (15): keepMinNumber6, keepWeekDays(60d)
   Wed 2008.08.20_18.53.46 (14): keepMinNumber5, keepWeekDays(60d)
   Thu 2008.08.21_19.56.03 (13): keepMinNumber4, keepWeekDays(60d)
   Fri 2008.08.22_23.32.10 (12): keepMinNumber3, keepWeekDays(60d)
   Sun 2008.08.24_12.57.36 (10): keepMinNumber2, keepWeekDays(60d)
   Tue 2008.08.26_10.59.46 (8): will be deleted
   Tue 2008.08.26_13.07.08 (8): keepMinNumber1, keepWeekDays(60d)

... and using the option --print we see the parameters used from storeBackup.pl:

# storeBackupls.pl -f /backup/stbu-gentoo.conf . --print
combined configuration and command line options
	options with parameters:
		file	</backup/stbu-gentoo.conf>
		firstDayOfWeek	<Sun>
		keepAll	<60d>
		keepDuplicate	<7d>
		keepFirstOfMonth	<undef>
		keepFirstOfWeek	<undef>
		keepFirstOfYear	<undef>
		keepLastOfMonth	<undef>
		keepLastOfWeek	<undef>
		keepLastOfYear	<undef>
		keepMaxNumber	<0>
		keepMinNumber	<30>
		keepRelative	<undef>
		keepWeekday	<undef>
	options without parameters:
	list parameters:
		<.>

Heinz-Josef Claes 2014-04-20