| PLAKAR-LOCATE(1) | General Commands Manual | PLAKAR-LOCATE(1) |
NAME
plakar locate —
Find filenames in a Plakar snapshot
SYNOPSIS
plakar locate | [-name name]
[-category category]
[-environment environment]
[-perimeter perimeter]
[-job job]
[-tag tag]
[-latest] [-before
date] [-since
date] [-snapshot
snapshotID] patterns ... |
DESCRIPTION
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:
-namestring- Only apply command to snapshots that match name.
-categorystring- Only apply command to snapshots that match category.
-environmentstring- Only apply command to snapshots that match environment.
-perimeterstring- Only apply command to snapshots that match perimeter.
-jobstring- Only apply command to snapshots that match job.
-tagstring- Only apply command to snapshots that match tag.
-latest- Only apply command to latest snapshot matching filters.
-beforedate- 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).
-sincedate- 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).
-snapshotsnapshotID- Limit the search to the given snapshot.
EXAMPLES
Search for files ending in “wd”:
$ plakar locate '*wd' abc123:/etc/master.passwd abc123:/etc/passwd
DIAGNOSTICS
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.
SEE ALSO
CAVEATS
The patterns may have to be quoted to avoid the shell attempting to expand them.
| February 1, 2025 | Plakar |