diff.rst.inc 2.7 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263
  1. .. _borg_diff:
  2. borg diff
  3. ---------
  4. ::
  5. usage: borg diff [-h] [--critical] [--error] [--warning] [--info] [--debug]
  6. [--lock-wait N] [--show-version] [--show-rc]
  7. [--no-files-cache] [--umask M] [--remote-path PATH]
  8. [-e PATTERN] [--exclude-from EXCLUDEFILE] [--numeric-owner]
  9. [--same-chunker-params] [--sort]
  10. ARCHIVE1 ARCHIVE2 [PATH [PATH ...]]
  11. Diff contents of two archives
  12. positional arguments:
  13. ARCHIVE1 archive
  14. ARCHIVE2 archive to compare with ARCHIVE1 (no repository
  15. location)
  16. PATH paths to compare; patterns are supported
  17. optional arguments:
  18. -h, --help show this help message and exit
  19. --critical work on log level CRITICAL
  20. --error work on log level ERROR
  21. --warning work on log level WARNING (default)
  22. --info, -v, --verbose
  23. work on log level INFO
  24. --debug work on log level DEBUG
  25. --lock-wait N wait for the lock, but max. N seconds (default: 1).
  26. --show-version show/log the borg version
  27. --show-rc show/log the return code (rc)
  28. --no-files-cache do not load/update the file metadata cache used to
  29. detect unchanged files
  30. --umask M set umask to M (local and remote, default: 0077)
  31. --remote-path PATH set remote path to executable (default: "borg")
  32. -e PATTERN, --exclude PATTERN
  33. exclude paths matching PATTERN
  34. --exclude-from EXCLUDEFILE
  35. read exclude patterns from EXCLUDEFILE, one per line
  36. --numeric-owner only consider numeric user and group identifiers
  37. --same-chunker-params
  38. Override check of chunker parameters.
  39. --sort Sort the output lines by file path.
  40. Description
  41. ~~~~~~~~~~~
  42. This command finds differences in files (contents, user, group, mode) between archives.
  43. Both archives need to be in the same repository, and a repository location may only
  44. be specified for ARCHIVE1.
  45. For archives created with Borg 1.1 or newer diff automatically detects whether
  46. the archives are created with the same chunker params. If so, only chunk IDs
  47. are compared, which is very fast.
  48. For archives prior to Borg 1.1 chunk contents are compared by default.
  49. If you did not create the archives with different chunker params,
  50. pass --same-chunker-params.
  51. Note that the chunker params changed from Borg 0.xx to 1.0.
  52. See the output of the "borg help patterns" command for more help on exclude patterns.