plakar-locate

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

plakar-locate — Find filenames in a Plakar snapshot

plakar locate[-name name] [-category category] [-environment environment] [-perimeter perimeter] [-job job] [-tag tag] [-latest] [-before date] [-since date] [-snapshot snapshotID] patterns ...

The plakar locate command search all the snapshots to find file names matching any of the given patterns and prints the abbreviated snapshot ID and the full path of the matched files. Matching works according to the shell globbing rules.

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).
snapshotID
Limit the search to the given snapshot.

Search for files ending in “wd”:

$ plakar locate '*wd'
abc123:/etc/master.passwd
abc123:/etc/passwd

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

0
Command completed successfully.
>0
An error occurred, such as invalid parameters, inability to create the repository, or configuration issues.

plakar(1), plakar-backup(1)

The patterns may have to be quoted to avoid the shell attempting to expand them.

Plakar July 3, 2025 PLAKAR-LOCATE(1)