PLAKAR(CHECK) - CHECK (1)

NAME

#

plakar check - Check data integrity in a Plakar repository or snapshot

SYNOPSIS

#

plakar check [-concurrency number] [-name name] [-category category] [-environment environment] [-perimeter perimeter] [-job job] [-tag tag] [-latest] [-before date] [-since date] [-fast] [-no-verify] [-quiet] [snapshotID:path …]

DESCRIPTION

#

The plakar check command verifies the integrity of data in a Plakar repository. It checks the given paths inside the snapshots for consistency and validates file macs to ensure no corruption has occurred, or all the data in the repository if no snapshotID is given.

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.

-latest

Only apply command to latest snapshot matching filters.

-before date

Only apply command to snapshots matching filters and older than the specified date. Accepted formats include relative durations (e.g. 2d for two days, 1w for one week) or specific dates in various formats (e.g. 2006-01-02 15:04:05).

-since date

Only apply command to snapshots matching filters and created since the specified date, included. Accepted formats include relative durations (e.g. 2d for two days, 1w for one week) or specific dates in various formats (e.g. 2006-01-02 15:04:05).

-concurrency number

Set the maximum number of parallel tasks for faster processing. Defaults to 8 * CPU count + 1.

-fast

Enable a faster check that skips mac verification. This option performs only structural validation without confirming data integrity.

-no-verify

Disable signature verification. This option allows to proceed with checking snapshot integrity regardless of an invalid snapshot signature.

-quiet

Suppress output to standard output, only logging errors and warnings.

EXAMPLES

#

Perform a full integrity check on all snapshots:

$ plakar check

Perform a fast check on specific paths of two snapshot:

$ plakar check -fast abc123:/etc/passwd def456:/var/www

DIAGNOSTICS

#

The plakar check utility exits 0 on success, and >0 if an error occurs.

0

Command completed successfully with no integrity issues found.

>0

An error occurred, such as corruption detected in a snapshot or failure to check data integrity.

SEE ALSO

#

plakar(1)

Plakar - February 3, 2025