zfsa-restore-dataset(1)

NAME

zfsa-restore-dataset - The snapshot as a new dataset next to the original, or in its place

SYNOPSIS

zfsa restore dataset [GLOBAL OPTIONS] [-h|--help] <--as|--replace> <SNAPSHOT>

DESCRIPTION

The snapshot as a new dataset next to the original, or in its place.

--as makes a writable clone with the snapshot's files and changes nothing else. The clone depends on the snapshot, so don't delete the snapshot while you need the clone. --replace gives the dataset's name to the snapshot's version and keeps the current data, unmounted, as NAME_before_restore_TIME. Note that exact name from the result. The running system's datasets can only be replaced from live media.

OPTIONS

--as <DATASET>

Restore as this new dataset. Nothing else changes

--replace

Make the dataset the snapshot's version, keeping the current data as a backup dataset

-h, --help

Print help (see a summary with '-h')

<SNAPSHOT>

The snapshot

EXAMPLES

Restore a snapshot as a new dataset to inspect it:

zfsa restore dataset tank/photos@before-cleanup --as tank/photos-recovered

Replace the dataset with the snapshot's version, keeping the current data:

zfsa restore dataset tank/photos@before-cleanup --replace

SEE ALSO

zfsa(1) for the global options, authorization, confirmations and exit status, zfsa-restore(1).