desync-untar(1)

desync-untar1

Extract a directory tree from a catar archive or index

Usage

desync {untar <catar | index> <target> [flags]}

Overview

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

Examples

  desync untar docs.catar /tmp/documents
  desync untar -s http://192.168.1.1/ -c /path/to/local -i docs.caidx /tmp/documents

History

20-Oct-2026 Auto generated by spf13/cobra

From desync 1.1.5-1 in Arch Linux 2026-11-01. Parsed by carta from the page's man source.