zfsa-restore-file(1)

NAME

zfsa-restore-file - Put a file or folder back as it was in a snapshot

SYNOPSIS

zfsa restore file [GLOBAL OPTIONS] [--to] [--wait] [-h|--help] <--from> <PATH>

DESCRIPTION

Put a file or folder back as it was in a snapshot.

Without --to the current version is replaced, after you answer yes. A folder is restored by a job: it replaces files with their saved versions, keeps files made since the snapshot and deletes nothing. Special files and datasets mounted inside the folder are skipped. Check the job's log for anything it couldn't restore.

OPTIONS

--from <SNAPSHOT>

The snapshot, as dataset@name or just name

--to <FOLDER>

Put it in this folder instead of replacing the current version

--wait

Follow a folder restore to its end

-h, --help

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

<PATH>

The file or folder: /mountpoint/path or dataset:path

EXAMPLES

Put a file back as it was in a snapshot:

zfsa restore file /tank/photos/album/cover.jpg --from before-cleanup

Restore a folder into another folder, without touching the current version, and wait for the job:

zfsa restore file tank/photos:album --from tank/photos@before-cleanup --to /tmp/restored --wait

SEE ALSO

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