amorfo77/restic
1
0
Fork 0
mirror of https://github.com/restic/restic.git synced 2026-06-01 14:49:44 +00:00
Code Issues Projects Releases Wiki Activity

docs: amend restic find documentation (#21818)

Browse Source 
Co-authored-by: Michael Eischer <michael.eischer@fau.de>
This commit is contained in:
Winfried Plappert
2026-05-31 15:31:44 +01:00
committed by GitHub
parent 53de77ea1a
commit 7566069bf3
1 changed files with 19 additions and 0 deletions
Download Patch File Download Diff File Expand all files Collapse all files
doc/045_working_with_repos.rst
+19
View File
@@ -571,6 +571,25 @@ Here is an example:
Found matching entries in snapshot 774ebacd from 2026-01-16 09:01:17
/srv/restic-repo/restic/testdata/0/0/9/7
.. warning::
All positional parameters for ``restic find`` are used as patterns. Quote names with
spaces, such as ``"file one.bar"``. If in doubt, use a quoted wildcard like ``"*.txt"``.
If you know that a particular file pattern is located in a specific snapshot or a
set of snapshots, you can limit the search using the ``--snapshot`` option (may be repeated):
.. code-block:: console
$ restic -r /srv/restic-repo find --snapshot latest file1.txt
Found matching entries in snapshot caffee11 from 2026-01-16 09:01:17
/srv/restic-repo/restic/testdata/0/for_cmd_ls/file1.txt
.. note::
Without ``--snapshot``, ``find`` searches all snapshots. You can narrow your search
using the standard filter options ``--host``, ``--path`` and ``--tag``.
Another interesting feature of the ``find`` command is the ability to search for
files and directories which have an ``inode`` modification time in a given
time interval, by using the options ``--oldest`` and ``--newest``.