plakar-check

PLAKAR-CHECK(1) General Commands Manual PLAKAR-CHECK(1)

plakar-check — Check data integrity in a Plakar repository

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 ...]

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:

string
Only apply command to snapshots that match name.
string
Only apply command to snapshots that match category.
string
Only apply command to snapshots that match environment.
string
Only apply command to snapshots that match perimeter.
string
Only apply command to snapshots that match job.
string
Only apply command to snapshots that match tag.
Only apply command to latest snapshot matching filters.
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).
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).
number
Set the maximum number of parallel tasks for faster processing. Defaults to 8 * CPU count + 1.
Enable a faster check that skips mac verification. This option performs only structural validation without confirming data integrity.
Disable signature verification. This option allows to proceed with checking snapshot integrity regardless of an invalid snapshot signature.
Suppress output to standard output, only logging errors and warnings.

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

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.

plakar(1)

Plakar July 3, 2025 PLAKAR-CHECK(1)