KurlesHS/restic
1
0
Fork 0
forked from TrueCloudLab/restic
Code Pull requests Activity

doc: Improve include patterns info

Browse source 
Clarifies and adds information on how to specify include patterns.
This commit is contained in:
Leo R. Lundgren 2019-11-18 02:23:01 +01:00
parent 02fea4f76a
commit 37770b1d82
1 changed files with 14 additions and 7 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

21
doc/040_backup.rst
View file

@ -132,8 +132,8 @@ Now is a good time to run ``restic check`` to verify that all data
is properly stored in the repository. You should run this command regularly is properly stored in the repository. You should run this command regularly
to make sure the internal structure of the repository is free of errors. to make sure the internal structure of the repository is free of errors.
Including and Excluding Files Excluding Files
***************************** ***************
You can exclude folders and files by specifying exclude patterns, currently You can exclude folders and files by specifying exclude patterns, currently
the exclude options are: the exclude options are:
@ -223,10 +223,13 @@ backup ``/sys`` or ``/dev`` on a Linux system:
.. note:: ``--one-file-system`` is currently unsupported on Windows, and will .. note:: ``--one-file-system`` is currently unsupported on Windows, and will
cause the backup to immediately fail with an error. cause the backup to immediately fail with an error.
By using the ``--files-from`` option you can read the files you want to Including Files
backup from one or more files. This is especially useful if a lot of files have ***************
to be backed up that are not in the same folder or are maybe pre-filtered
by other software. By using the ``--files-from`` option you can read the files you want to back
up from one or more files. This is especially useful if a lot of files have
to be backed up that are not in the same folder or are maybe pre-filtered by
other software.
For example maybe you want to backup files which have a name that matches a For example maybe you want to backup files which have a name that matches a
certain pattern: certain pattern:
@ -248,7 +251,11 @@ args:
$ restic -r /srv/restic-repo backup --files-from /tmp/files_to_backup /tmp/some_additional_file $ restic -r /srv/restic-repo backup --files-from /tmp/files_to_backup /tmp/some_additional_file
Paths in the listing file can be absolute or relative. Paths in the listing file can be absolute or relative. Please note that
patterns listed in a ``--files-from`` file are treated the same way as
exclude patterns are, which means that beginning and trailing spaces are
trimmed and special characters must be escaped. See the documentation
above for more information.
Comparing Snapshots Comparing Snapshots
******************* *******************