extract.rst.inc 2.1 KB

12345678910111213141516171819202122232425262728293031323334353637383940414243444546474849
  1. .. _borg_extract:
  2. borg extract
  3. ------------
  4. ::
  5. usage: borg extract [-h] [-v] [--show-rc] [--no-files-cache] [--umask M]
  6. [--remote-path PATH] [-n] [-e PATTERN]
  7. [--exclude-from EXCLUDEFILE] [--numeric-owner]
  8. [--strip-components NUMBER] [--stdout] [--sparse]
  9. ARCHIVE [PATH [PATH ...]]
  10. Extract archive contents
  11. positional arguments:
  12. ARCHIVE archive to extract
  13. PATH paths to extract
  14. optional arguments:
  15. -h, --help show this help message and exit
  16. -v, --verbose verbose output
  17. --show-rc show/log the return code (rc)
  18. --no-files-cache do not load/update the file metadata cache used to
  19. detect unchanged files
  20. --umask M set umask to M (local and remote, default: 63)
  21. --remote-path PATH set remote path to executable (default: "borg")
  22. -n, --dry-run do not actually change any files
  23. -e PATTERN, --exclude PATTERN
  24. exclude paths matching PATTERN
  25. --exclude-from EXCLUDEFILE
  26. read exclude patterns from EXCLUDEFILE, one per line
  27. --numeric-owner only obey numeric user and group identifiers
  28. --strip-components NUMBER
  29. Remove the specified number of leading path elements.
  30. Pathnames with fewer elements will be silently
  31. skipped.
  32. --stdout write all extracted data to stdout
  33. --sparse create holes in output sparse file from all-zero
  34. chunks
  35. Description
  36. ~~~~~~~~~~~
  37. This command extracts the contents of an archive. By default the entire
  38. archive is extracted but a subset of files and directories can be selected
  39. by passing a list of ``PATHs`` as arguments. The file selection can further
  40. be restricted by using the ``--exclude`` option.
  41. See the output of the "borg help patterns" command for more help on exclude patterns.