extract.rst.inc 2.7 KB

1234567891011121314151617181920212223242526272829303132333435363738394041424344454647484950515253545556575859
  1. .. IMPORTANT: this file is auto-generated from borg's built-in help, do not edit!
  2. .. _borg_extract:
  3. borg extract
  4. ------------
  5. ::
  6. usage: borg extract [-h] [--critical] [--error] [--warning] [--info] [--debug]
  7. [--lock-wait N] [--show-rc] [--no-files-cache] [--umask M]
  8. [--remote-path PATH] [--list] [-n] [-e PATTERN]
  9. [--exclude-from EXCLUDEFILE] [--numeric-owner]
  10. [--strip-components NUMBER] [--stdout] [--sparse]
  11. ARCHIVE [PATH [PATH ...]]
  12. Extract archive contents
  13. positional arguments:
  14. ARCHIVE archive to extract
  15. PATH paths to extract; patterns are supported
  16. optional arguments:
  17. -h, --help show this help message and exit
  18. --critical work on log level CRITICAL
  19. --error work on log level ERROR
  20. --warning work on log level WARNING (default)
  21. --info, -v, --verbose
  22. work on log level INFO
  23. --debug work on log level DEBUG
  24. --lock-wait N wait for the lock, but max. N seconds (default: 1).
  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. --list output verbose list of items (files, dirs, ...)
  31. -n, --dry-run do not actually change any files
  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 obey numeric user and group identifiers
  37. --strip-components NUMBER
  38. Remove the specified number of leading path elements.
  39. Pathnames with fewer elements will be silently
  40. skipped.
  41. --stdout write all extracted data to stdout
  42. --sparse create holes in output sparse file from all-zero
  43. chunks
  44. Description
  45. ~~~~~~~~~~~
  46. This command extracts the contents of an archive. By default the entire
  47. archive is extracted but a subset of files and directories can be selected
  48. by passing a list of ``PATHs`` as arguments. The file selection can further
  49. be restricted by using the ``--exclude`` option.
  50. See the output of the "borg help patterns" command for more help on exclude patterns.