PLAKAR-RESTORE(1) - General Commands Manual

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(1), plakar-backup(1)

Plakar - February 3, 2025