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

.SH NAME
desync-cache - Read indexes and copy the referenced chunks


.SH SYNOPSIS
\fBdesync cache <index> [<index>...] [flags]\fP


.SH DESCRIPTION
Read chunk IDs from one or more index files (caibx or caidx) and copy the
referenced chunks from the source store(s) into the target store given with
-c, without assembling any blob on disk. This can be used to pre-populate a
cache, or to replicate the chunks referenced by indexes into another store.
Use '-' to read (a single) index from STDIN.

.PP
To exclude chunks that are known to exist in the target store already, use
--ignore <index> which will skip any chunks from the given index. The same can
be achieved by providing the chunks in their ASCII representation in a text
file with --ignore-chunks <file>.


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

.PP
\fB-c\fP, \fB--cache\fP=""
	target store the chunks are copied to

.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 cache

.PP
\fB--ignore\fP=[]
	index(es) with chunks to be excluded

.PP
\fB--ignore-chunks\fP=[]
	text file with chunk IDs to be excluded

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

.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 cache -s http://192.168.1.1/ -c /path/to/local file.caibx
.EE


.SH SEE ALSO
\fBdesync(1)\fP


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