diff.rst.inc 2.6 KB

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