Langue: en

Autres versions - même langue

Version: 385451 (fedora - 01/12/10)

Section: 8 (Commandes administrateur)


dirvish - Disk based virtual image network backup system


dirvish --vault vault [ OPTIONS ]


Create a backup image of a client directory tree. Each image is a directory containing transfer log, summary, tree and if transfer errors were detected an rsync_error file. The transfer log retains the the output of any pre and post processing commands and the rsync log listing all files that were changed or added with some statistical information. The summary file contains all the information about how the image was created and meta-data for managing the image in config file format. Tree is the copy of the client tree. The client directory tree is compared with an existing image to create a new image. Unchanged files are shared between images. For changed files only those parts that actually change are transfered over the network. Unchanged portions of files are copied from the reference image. The resulting images contain complete copies of the original trees preserving ownership and file permissions. In this way even though the backups are made incrementally, each image can be used independently for restores or to make removable-media off-site copies or archives. The removal of an image will have no effect on other images.


Each option on the command line may be specified any number of times. Those options that support lists in the config files will accumulate all of their arguments otherwise each specification will override the ones before. As configuration files are loaded they may override options on the command line. Each option may be unambiguously abbreviated.
.BI --branch " [vault:]branch_name"
Specify a branch to use.

A branch is a sequence of images.

If a vault has been specified either here or with the first time this option is used it will attempt to load the config file branch_name or branch_name.conf from the vault.

.BI --config " config-file"
Load options from the specified file.

If this precedes the option will not load it's own config file.

If vault has been set and config-file is a bare filename the presence of one in the vault will take precedence over one in the current directory. To specify one in the current directory after use ./ to precede the name.

The master configuration file will be read prior to processing options.

.BI --expire " expire_date"
Specify a time for the image to expire.

See e in Time::ParseDate(3pm) for details.

This does not actually expire anything. What it does do is add an Expire: field to the image summary file containing an absolute time so that a dirvish-expire or another tool outside of dirvish can decide when to remove old images.

.BI --image " image_name"
Specify a name for the image.

image_name is passed through POSIX::strftime

See e in strftime(3) for details.

.BI --image-time " parsedate_expression"
Time to use when creating the image name.

If an absolute time without a date is provided it will be forced into the past. If this isn't set the current time will be used.

See e in Time::ParseDate(3pm) for details.

Create an initial image.

Create the image entirely from the source tree without the use of a reference image.

Don't actually do anything.

Process all configuration files, options and tests then produce a summary/configuration file on standard output and exit.

.BI --reference " branch_name|image_name"
Specify an existing image or a branch from which to create the new image.

If a branch_name is specified, the last existing image from its history file will be used. A branch will take precedence over an image of the same name.

.BI --reset " option"
Reset the values in an accumulating option.
.B --summary " short|long"
Specify summary format.

A short summary will only include final used values. A long summary will include all configuration values.