desync(1)                                                            desync(1)



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


       -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
       desync(1)



HISTORY
       5-Sep-2026 Auto generated by spf13/cobra

desync                             Sep 2026                          desync(1)