.nh
.TH "desync" "1" "Sep 2026" "desync" ""

.SH NAME
desync-untar - Extract a directory tree from a catar archive or index


.SH SYNOPSIS
\fBdesync untar <catar|index> <target> [flags]\fP


.SH DESCRIPTION
Extracts a directory tree from a catar file or an index. Use '-' to read the
index from STDIN.

.PP
The input is either a catar archive, or a caidx index file (with -i and -s).

.PP
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 '-'.


.SH OPTIONS
\fB--ca-cert\fP=""
	trust authorities in this file, instead of OS trust store

.PP
\fB-c\fP, \fB--cache\fP=""
	store to be used as cache

.PP
\fB-r\fP, \fB--cache-repair\fP[=true]
	replace invalid chunks in the cache from source

.PP
\fB--client-cert\fP=""
	path to client certificate for TLS authentication

.PP
\fB--client-key\fP=""
	path to client key for TLS authentication

.PP
\fB-n\fP, \fB--concurrency\fP=10
	number of concurrent goroutines

.PP
\fB-e\fP, \fB--error-retry\fP=3
	number of times to retry in case of network error

.PP
\fB-b\fP, \fB--error-retry-base-interval\fP=500ms
	initial retry delay, increases linearly with each subsequent attempt

.PP
\fB-h\fP, \fB--help\fP[=false]
	help for untar

.PP
\fB-i\fP, \fB--index\fP[=false]
	read index file (caidx), not catar

.PP
\fB--no-same-owner\fP[=false]
	extract files as current user

.PP
\fB--no-same-permissions\fP[=false]
	use current user's umask instead of what is in the archive

.PP
\fB--no-same-xattrs\fP[=false]
	don't apply extended attributes from the archive

.PP
\fB--output-format\fP="disk"
	output format, 'disk' or 'gnu-tar'

.PP
\fB-s\fP, \fB--store\fP=[]
	source store(s), used with -i

.PP
\fB-t\fP, \fB--trust-insecure\fP[=false]
	trust invalid certificates


.SH OPTIONS INHERITED FROM PARENT COMMANDS
\fB--config\fP=""
	config file (default $HOME/.config/desync/config.json)

.PP
\fB--digest\fP="sha512-256"
	digest algorithm, sha512-256 or sha256

.PP
\fB--verbose\fP[=false]
	verbose mode


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


.SH SEE ALSO
\fBdesync(1)\fP


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