plakar-restore
PLAKAR-RESTORE(1)
General Commands Manual
PLAKAR-RESTORE(1)
NAME
plakar-restore
—
Restore files from a Plakar
snapshot
SYNOPSIS
plakar restore | [-name name]
[-category category]
[-environment environment]
[-perimeter perimeter]
[-job job]
[-tag tag]
[-latest ] [-before
date] [-since
date] [-concurrency
number] [-quiet ]
[-rebase ] [-to
directory]
[snapshotID:path ...] |
DESCRIPTION
The plakar restore
command is used to
restore files and directories at path from a specified
Plakar snapshot to the local file system. If path is
omitted, then all the files in the specified
snapshotID are restored. If no
snapshotID is provided, the command attempts to
restore the current working directory from the last matching snapshot.
The options are as follows:
-name
string- Only apply command to snapshots that match name.
-category
string- Only apply command to snapshots that match category.
-environment
string- Only apply command to snapshots that match environment.
-perimeter
string- Only apply command to snapshots that match perimeter.
-job
string- Only apply command to snapshots that match job.
-tag
string- Only apply command to snapshots that match tag.
-concurrency
number- Set the maximum number of parallel tasks for faster processing. Defaults
to
8 * CPU count + 1
. -to
directory- Specify the base directory to which the files will be restored. If omitted, files are restored to the current working directory.
-rebase
- Strip the original path from each restored file, placing files directly in
the specified directory (or the current working directory if
-to
is omitted). -quiet
- Suppress output to standard input, only logging errors and warnings.
EXAMPLES
Restore all files from a specific snapshot to the current directory:
$ plakar restore abc123
Restore to a specific directory:
$ plakar restore -to /mnt/ abc123
Restore with rebase option, placing files directly in the target directory:
$ plakar restore -rebase -to /home/op abc123
DIAGNOSTICS
The plakar-restore
utility exits 0
on success, and >0 if an error occurs.
- 0
- Command completed successfully.
- >0
- An error occurred, such as a failure to locate the snapshot or a destination directory issue.
SEE ALSO
Plakar July 3,
2025 PLAKAR-RESTORE(1)