Rechercher une page de manuel

storeBackup

Langue: en

Autres versions - même langue

Version: 314404 (ubuntu - 07/07/09)

Section: 1 (Commandes utilisateur)

Sommaire

NAME
SYNOPSIS
DESCRIPTION
OPTIONS
SEE ALSO
AUTHOR

NAME

storeBackup - fancy compressing managing checksumming hard-linking cp -ua

SYNOPSIS

storeBackup -f configFile [-g | --print]

storeBackup -s sourceDir -t targetDir

[-T tmpdir] [-L lockFile]
[--unlockBeforeDel] [--exceptDirs dir1,dir2,dir3]
[--includeDirs dir1,dir2,dir3]
[--exceptDirsSep sep]
[--exceptPattern rule] [--includePattern rule]
[--exceptTypes types]
[--precommand job] [--postcommand job] [--followLinks depth]
[-c compress] [-u uncompress] [-p postfix]
[--noCompress number] [--queueCompress number]
[--noCopy number] [--queueCopy number] [--copyBWLimit kbps]
[--withUserGroupStat] [--userGroupStatFile filename]
[--exceptSuffix suffixes]
[--addExceptSuffix suffixes] [--contExceptDirsErr]
[--compressMD5File yes|no] [--chmodMD5File] [-v]
[-d level] [--progressReport number] [--printDepth]
[--ignoreReadError] [--doNotDelete] [--resetAtime]
[--keepAll timePeriod] [--keepWeekday entry]
[--keepFirstOfYear] [--keepLastOfYear]
[--keepFirstOfMonth] [--keepLastOfMonth]
[--firstDayOfWeek day] [--keepFirstOfWeek] [--keepLastOfWeek]
[--keepDuplicate] [--keepMinNumber] [--keepMaxNumber]
[-l logFile

[--plusLogStdout] [--withTime yes|no ] [-m maxFilelen]

[[[-n noOfOldFiles]|[ --saveLogs yes|no ]]
[--compressWith compressprog]]

[--logInBackupDir yes|no [--compressLogInBackupDir yes|no]

[--logInBackupDirFileName logFile]]

[otherBackupDirs ...]

DESCRIPTION

This program copies trees to another location. Every file copied is potentially compressed (see --exceptSuffix). When a new backup is made, every file is compared to all others in the existing backup tree (by MD5 checksum, size, mtime and ctime). If a file considered identical is already present in the backup, instead of copying and compressing the file again a hard link is made. This massively reduces the size of the backup and speeds up backup runs. The program can handle normal files, directories and symbolic links.

All configuration can be done as command line arguments or in a configuration file. On Debian systems, backups configured by configuration files in /etc/storebackup.d/ are updated daily without further configuration.

OPTIONS

--file, -f

configuration file (instead of parameters)

--generate, -g

generate template of configuration file

--print

print configuration read from configuration file and stop

--sourceDir, -s

source directory (must exist)

--targetDir, -t

target directory (must exist)

--tmpdir, -T

directory for temporary file, default is /tmp

--lockFile, -L

lock file, if exists, new instances will finish if an old is already running

--unlockBeforeDel

remove the lock file before deleting old backups

default is to delete the lock file after deleting old backups

--exceptDirs, -e

directories to except from backing up (relative path), wildcards are possible and should be quoted to avoid replacements by the shell, the directories have to be separated with --exceptDirsSep

--includeDirs, -i

directories to include in the backup (relative path), wildcards are possible and have to be quoted, the directories have to be separated by --exceptDirsSep

--exceptDirsSep

Separator for --exceptDirs and --includeDirs , default is ,

--exceptPattern

Files to exclude from backing up. You can define a rule with pattern. See the config or (better) the README file for a detailed description.

--includePattern

Files to include in the backup - like --exceptPattern

--contExceptDirsErr

continue if one or more of the exceptional directories do not exist (default is to stop processing)

--exceptTypes

do not save the specified types of files, allowed: Sbcfpl

S - file is a socket b - file is a block special file c - file is a character special file f - file is a plain file p - file is a named pipe l - file is a symbolic link

Backups of the types Sbc are not implemented, but you can suppress a warning if you specify them with this option

--precommand

exec job before starting the backup, checks lockFile (-L) before starting (e.g. can be used for rsync)

stops execution if job returns exit status != 0

--postcommand

exec job after finishing the backup, but before erasing of old backups

reports if job returns exit status != 0

--followLinks

follow symbolic links like directories up to depth

default = 0 -> do not follow links

--compress, -c

compress command (with options), default is bzip2

--uncompress, -u

uncompress command (with options), default is bzip2 -d

--postfix, -p

postfix to add after compression, default is .bz2

--noCompress

maximal number of parallel compress operations, default = 4

--queueCompress

length of queue to store files before compression, default = 1000

--noCopy

maximal number of parallel copy operations, default = 1

--queueCopy

length of queue to store files before copying, default = 1000

--copyBWLimit

maximum bandwidth, KBytes per second per copying process

storeBackup uses rsync for this option

default = 0 -> no limit, use cp for copying

--withUserGroupStat

write statistics about used space in log file

--userGroupStatFile

write statistics about used space in file

file will be overridden each time

--exceptSuffix

do not compress or copy files with the following suffix (uppercase included):

.bz2, .gif, .gpg, .gz, .jpg, .mp3, .mpeg, .mpg, .ogg, .png, .tgz, .tif, .tiff, .zip

--addExceptSuffix

like --exceptSuffix, but do not replace defaults, add

--compressMD5File

default is 'yes', if you do not want this, say 'no'

--chmodMD5File

permissions of .md5CheckSumFile and corresponding .storeBackupLinks directory, default is 0600

--verbose, -v

verbose messages about --exceptPattern and --includePattern

--debug, -d

generate debug messages, levels are

0 (none, default) 1 (some) 2 (many)

messages

--resetAtime

reset access time in the source directory - but this will change ctime (time of last modification of file status information)

--doNotDelete

test only, do not delete any backup

--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 = 30d

--keepWeekday

keep backups for the specified days for the specified amount of time. Overwrites the default values choosen in --keepAll.

e.g. '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 specified in --keepAll (default 30d)

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 30d)

--keepFirstOfYear

do not delete the first backup of a year