2016-07-05 23:33:53 +00:00
|
|
|
.. IMPORTANT: this file is auto-generated from borg's built-in help, do not edit!
|
|
|
|
|
2016-03-17 02:30:31 +00:00
|
|
|
.. _borg_diff:
|
|
|
|
|
|
|
|
borg diff
|
|
|
|
---------
|
2017-06-06 22:44:53 +00:00
|
|
|
.. code-block:: none
|
2016-03-17 02:30:31 +00:00
|
|
|
|
2017-06-06 22:44:53 +00:00
|
|
|
borg [common options] diff [options] REPO_ARCHIVE1 ARCHIVE2 PATH
|
2016-04-09 23:28:18 +00:00
|
|
|
|
2017-06-20 09:49:26 +00:00
|
|
|
REPO_ARCHIVE1
|
|
|
|
repository location and ARCHIVE1 name
|
|
|
|
ARCHIVE2
|
|
|
|
ARCHIVE2 name (no repository location allowed)
|
|
|
|
PATH
|
|
|
|
paths of items inside the archives to compare; patterns are supported
|
|
|
|
|
2016-04-09 23:28:18 +00:00
|
|
|
|
|
|
|
optional arguments
|
2017-06-20 09:49:26 +00:00
|
|
|
--numeric-owner only consider numeric user and group identifiers
|
|
|
|
--same-chunker-params Override check of chunker parameters.
|
|
|
|
--sort Sort the output lines by file path.
|
|
|
|
|
2016-04-09 23:28:18 +00:00
|
|
|
|
2017-06-06 22:06:36 +00:00
|
|
|
:ref:`common_options`
|
2016-04-09 23:28:18 +00:00
|
|
|
|
|
|
|
|
|
2017-03-26 23:45:45 +00:00
|
|
|
Exclusion options
|
2017-06-20 09:49:26 +00:00
|
|
|
-e PATTERN, --exclude PATTERN exclude paths matching PATTERN
|
|
|
|
--exclude-from EXCLUDEFILE read exclude patterns from EXCLUDEFILE, one per line
|
|
|
|
--exclude-caches exclude directories that contain a CACHEDIR.TAG file (http://www.brynosaurus.com/cachedir/spec.html)
|
|
|
|
--exclude-if-present NAME exclude directories that are tagged by containing a filesystem object with the given NAME
|
|
|
|
--keep-exclude-tags, --keep-tag-files if tag objects are specified with --exclude-if-present, don't omit the tag objects themselves from the backup archive
|
|
|
|
--pattern PATTERN experimental: include/exclude paths matching PATTERN
|
|
|
|
--patterns-from PATTERNFILE experimental: read include/exclude patterns from PATTERNFILE, one per line
|
|
|
|
|
2017-03-26 23:45:45 +00:00
|
|
|
|
2016-03-17 02:30:31 +00:00
|
|
|
Description
|
|
|
|
~~~~~~~~~~~
|
|
|
|
|
2016-11-28 01:25:56 +00:00
|
|
|
This command finds differences (file contents, user/group/mode) between archives.
|
2016-03-17 02:30:31 +00:00
|
|
|
|
2016-11-28 01:25:56 +00:00
|
|
|
A repository location and an archive name must be specified for REPO_ARCHIVE1.
|
|
|
|
ARCHIVE2 is just another archive name in same repository (no repository location
|
|
|
|
allowed).
|
2016-03-17 02:30:31 +00:00
|
|
|
|
2016-03-18 14:42:32 +00:00
|
|
|
For archives created with Borg 1.1 or newer diff automatically detects whether
|
|
|
|
the archives are created with the same chunker params. If so, only chunk IDs
|
2016-03-18 12:30:39 +00:00
|
|
|
are compared, which is very fast.
|
|
|
|
|
|
|
|
For archives prior to Borg 1.1 chunk contents are compared by default.
|
|
|
|
If you did not create the archives with different chunker params,
|
2017-06-17 10:28:42 +00:00
|
|
|
pass ``--same-chunker-params``.
|
2016-03-18 12:30:39 +00:00
|
|
|
Note that the chunker params changed from Borg 0.xx to 1.0.
|
2016-03-18 11:17:57 +00:00
|
|
|
|
2017-03-26 23:45:45 +00:00
|
|
|
See the output of the "borg help patterns" command for more help on exclude patterns.
|