BEAM-RESTORE

NAME
SYNOPSIS
DESCRIPTION
OPTIONS
EXAMPLES
FILES
SEE ALSO
AUTHORS
BUG REPORTS

NAME

beam-restore - restore file system from a backup.

SYNOPSIS

beam restore [-cntv] [--confirm] [-C DIR] [--directory DIR] [--verbose]
[--dry-run] [--list] [--logfile FILE] [-L N] [--level N]
[-R N] [--round N] [--week N]
[ITEM [ITEM...]]

beam restore [-h] [--help]

beam restore [-V] [--version]

DESCRIPTION

The beam-restore command restores the file system from incremental backups created using beambackup(1).

The program reads its configuration from the file beam.conf located in the /usr/local/etc directory, or from the file named in the environment variable BACKUP_CONFIG. The configuration file must exist.

After loading the configuration file, the program examines its command line for options that modify its behavior. These are described in detail in the section OPTIONS, below.

Once the configuration loaded, the beam-restore command determines which backup archives to use for restoring. Unless being requested otherwise by the command line options, the utility selects the most recent set of backup files.

Before starting the restore, the command displays the backup files it has selected and asks the user if he wishes to proceed. Empty line (the CR alone) or any word beginning with Y (case-insensitive) is taken as affirmative. Otherwise, a negative answer is assumed and program terminates.

The program restores file systems and other backup items in the order they are listed in the backup_items configuration variable. The ITEM arguments override this default. If they are present, the program will restore only those items that are listed in the command line and exactly in the order they appear.

OPTIONS

-c, --confirm

Do not ask for confirmation; run straight into restoring.

-C, --directory DIR

Restore into directory DIR instead of /.

-v, --verbose

Increase verbosity.

-n, --dry-run

Do nothing, but print what would have been done.

-t, --list

List archive files, instead of extracting from them.

-l, --logfile FILE

Log to FILE instead of the standard error. This option implies --confirm. Note also, that due to its specific nature restore ignores the backup_logfile configuration setting.

-L, --level N

Set incremental dump level to stop at.

-R, --round N

Use archives from incremental round N.

-W, --week N

Use archives from week N.

-h, --help

Display a short help summary.

-V, --version

Display program version.

EXAMPLES

FILES

/usr/local/etc/beam.conf

Default configuration file.

/usr/local/lib/beam

Backup module directory. Whenever a backup item of type T is requested, restore will attempt to load from this directory a file named T.sh. This file provides methods and definitions necessary to handle that particular item type.

/usr/local/lib/beam/common.sh

Settings and definitions shared between beam-backup(1), beam-restore, and beam-list(1).

SEE ALSO

beam(1), beam-backup(1), beam-list(1), beam.conf(5)

AUTHORS

Sergey Poznyakoff

BUG REPORTS

Report bugs to <gray@gnu.org.ua>.


Manpage server at man.gnu.org.ua.

Powered by mansrv 1.1