backup2
Archived for posterity
manpage
NAME
backup - Instant, system wide version control.
SYNOPSIS
backup [-abcfiqsw] [FILE...] = Add files to archive
backup -d [-sv] FILE = Diff two files
backup -k [-s] PATH = Make an archive
backup -l [-abcefinsvw] [FILE...] = List files in archive
backup -m [-abcfipsw] [FILE...] PATH = Move an archive file
backup -r [-abefioqstvw] [FILE...] = Restore an archive file
backup -z [-abcfiqsvw] [FILE...] = Delete an archive file
OPTIONS
-a Operate against all files in the working directory
-b Display verbose output
-c TEXT Add a comment to, or show comments on an archive file
-e EXT Append extension to a restored file (default:
.v%V_%Y%M%D_%H%i%s)
-f FILE Operate against a given list of files (overrides "-a")
-i Operate recursivly (requires "-a" or "-f")
-n Show this many (maximum) results. Set to '0' to show all.
(default: 10)
-o Allow restore to overwrite files (overrides "-e")
-p Propogate movement of a file to filesystem.
-q Quiet, no output (overrides "-b")
-s PATH Storage path of the file archive (default: $BACKUP_PATH)
-t Set the directory to restore to (default: %f )
-v #[,#] Version number of file to list or restore (default: latest)
-w PATH Change the working directory (default: current)
MACROS
Certain macros can be used in command line options as substitues for
variables. For example, in the default "-e" they are used to append the
date to restored files.
In addition to the following, you may use any macro available to
Date::Format. The time reflected is the time that the file was archived.
%F Log message given
%f Source path
%K Absolute path of the archive
%v Author who added/committed the file
%V Version number
CODES
'backup' uses the following exit codes
0 No error
1 User input, or usage error
2 Configuration error
4 Internal process error
OUTPUT
'backup' uses the following output markers to identify changes or
updates made:
A: Added file/path to archive
C: Created archive
D: Deleted file in archive
F: File name
I: Ignored file
M: Moved file
N: Not found
R: Restored file
S: Skipped file
U: Updated file in archive
V: Archive Version
VERSION
backup v0.2
AUTHOR
CJ Niemira <siege@siege.org>
COPYRIGHT
2008, CJ Niemira
LICENSE
This program is released under the GNU General Public License (GPL).