NAME
Backup Copy - a mirroring utility for backing up your files
SYNOPSIS
cpbk [-fhilnpqsvV] [-e ”FILE,...”] [-t DIR] SOURCE DEST
cpbk [-fhilnpqsvV] [-e ”FILE,...”] [-t DIR] -c FILE [SOURCE] [DEST]
DESCRIPTION
Backup Copy is basically a smart copy program that allows a user to copy mass files from one place to another. When coping over a previous copy, the key features will allow coping only of new or non existing files in the backup. This results in saving time and less load on the drive. Built into the same feature of copying new files only, is a file removal procedure. If a file is removed from the source path, the same file will be removed when the next backup is performed. This provides a backup that is exactly the same as the source without filling up the drive. As an added option, all files that will be overwritten or deleted when doing a copy over a previous backup, have the opportunity to be stored in a trash bin. You can leave this trash bin to grow and grow just in case you need a backup of your backup. When you start running out of disk space you will need to remove or clean up the trash bin.
OPTIONS
-c, --config=FILE
Specify a configuration file. See sub section ”Config File” below on how to use the configurationfile.
-e, --exclude=”FILE,...”
Exclude specified directories and/or files from the copy. This option is handy for excluding NFS mounts that might result in multiple copies of the same files. Also if you are backup a directory which contains your destination directory for you backup, excluding your destination directory would be mandatory.
-t, --trash-bin=DIR
Move all overwritten or removed files from the last backup to the specified trashbin.
-l, --list
Display a listing of each name of new files, updated files, removed files, new directories and removed directories.
-n, --nlist
Display the number of new files, updated files, removed files, new directories and removed directories.
-s, --simulate
Perform ordering simulation. It doesn’t actually change any files/directories.
-f, --force
Copy all files whether updated or not.
-i, --inode-ctime
Enable using ctime that is changed by writing or by setting inode information for file comparison check. Cpbk assume a file has been updated with this option if the ctime is changed.
-I, --ignore-minor-error
Ignore minor error that process can proceed. It may be danger. Please use this feature carefully.
-q, --quiet
Quite mode. Suppress all error messages and progress information.
-p, --suppress-progress
Suppress progress information.
-v, --verbose
Verbose mode. Display processed file names.
-h, --help
Display help and exit.
-V, --version
Display version information and exit.
EXAMPLES
cpbk /source /dest
Copy only updated files (or newly added files) from source directory to destination directory from the previous backup. And remove any files that have been removed from source directory from the previous backup.
cpbk -t /trashbin /source /dest
Perform the same action as 1st example, except copy all files that are being overwritten or removed from the previous backup to a trash bin.
cpbk -t /trashbin -e ”/excludedir1,/excludedir2” /source /dest
Perform the exact same action as 2nd example except exclude two directories that are located in the source.
CONFIG FILE
If you so desire you may use a configuration file for some options. The file ”sample.cpbkrc” should also have been included with your copy of Backup Copy. Below I will list how to to use each option for Backup Copy.
(Notes: configuration in the file can be overrode by command line options)
As a standard rule, ON and OFF will be represented as follows:
|
• |
ON = ”True” or ”Yes” or ”1” |
|||
|
• |
OFF = ”False” or ”No” or ”0” |
To toggle an option, simple place an equal mark then a True or False after the option. ie, this will turn an option on :
OPTION = True
Configuration Options:
|
Source |
Specify a directory that you would like to copy your files from. For example: |
Source = /home/foo
|
Dest |
Specify a directory that you would like to copy your file to. For example: |
Dest = /home/backup
Exclude
Specify directories and/or files that you would like to exclude. If you want to specify multiple directories or files, write multiple parameters. Same as --exclude option. For example:
Exclude =
/home/foo/garbage
Exclude = /home/foo/temp
SaveExclude
Set this parameter to False if you want to remove excluded directories and files from destination directory.
TrashBin
Move all overwritten or removed files from the last backup to the specified trash bin directory. Same as --trash-bin option. For example:
TrashBin = /home/foo/trashbin
Simulate
Perform ordering simulation. It doesn’t actually change any files/directories. Same as --simulate option.
|
Force |
Copy all files whether updated or not. Same as --force option. |
InodeCtimeCheck
Enable using ctime that is changed by writing or by setting inode information for file comparison check. Cpbk assume a file has been updated with this option if the ctime is changed. Same as --inode-ctime option.
FileSizeCheck
Enable using file size for file comparison check.
IgnoreMinorError
Ignore minor error that process can proceed. Same as --ignore-minor-error option.
|
Quiet |
Quite mode. Suppress all error messages and progress information. Same as --inode-ctime option. |
SuppressProgress
Suppress progress information. Same as --suppress-progress option.
Verbose
Verbose mode. Display processed file names. Same as --verbose option.
AUTHORS
Kevin Lindsay <klindsay [AT] mkintraweb.com> (original author)
Yuuki NINOMIYA <gm [AT] debian.jp> (after Ver 3.0.0 author)