cpbk(1)

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 <[email protected]> (original author)

Yuuki NINOMIYA <[email protected]> (after Ver 3.0.0 author)