NAME
desync-untar - Extract a directory tree from a catar archive or index
SYNOPSIS
desync untar <catar|index> <target> [flags]
DESCRIPTION
Extracts a directory tree from a catar file or an index. Use '-' to read the index from STDIN.
The input is either a catar archive, or a caidx index file (with -i and -s).
By default, the catar archive is extracted to local disk. Using --output-format=gnu-tar, the output can be set to GNU tar, either an archive or STDOUT with '-'.
OPTIONS
--ca-cert=""
trust authorities in this file, instead of OS trust store
-c, --cache=""
store to be used as cache
-r, --cache-repair[=true]
replace invalid chunks in the cache from source
--client-cert=""
path to client certificate for TLS authentication
--client-key=""
path to client key for TLS authentication
-n, --concurrency=10
number of concurrent goroutines, -1 to let desync choose: the number of CPUs for chunking and hashing, adapting to each store up to 128 for transfers
-e, --error-retry=3
number of times to retry in case of network error
-b, --error-retry-base-interval=500ms
initial retry delay, increases linearly with each subsequent attempt
-h, --help[=false]
help for untar
-i, --index[=false]
read index file (caidx), not catar
--no-same-owner[=false]
extract files as current user
--no-same-permissions[=false]
use current user's umask instead of what is in the archive
--no-same-xattrs[=false]
don't apply extended attributes from the archive
--output-format="disk"
output format, 'disk' or 'gnu-tar'
-s, --store=[]
source store(s), used with -i
-t, --trust-insecure[=false]
trust invalid certificates
OPTIONS INHERITED FROM PARENT COMMANDS
--config=""
config file (default $HOME/.config/desync/config.json)
--digest="sha512-256"
digest algorithm, sha512-256 or sha256
--verbose[=false]
verbose mode
EXAMPLE
desync untar docs.catar /tmp/documents desync untar -s http://192.168.1.1/ -c /path/to/local -i docs.caidx /tmp/documents
SEE ALSO
HISTORY
20-Oct-2026 Auto generated by spf13/cobra