summaryrefslogtreecommitdiff
path: root/doc/chunking.mdwn
blob: d1dce317c0e42e42ca956a1547ecf6bd88f2ba19 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
Some [[special_remotes]] have support for breaking large files up into
chunks that are stored on the remote.

This can be useful to work around limitations on the size of files
on the remote.

Chunking also allows for resuming interrupted downloads and uploads.

Note that git-annex has to buffer chunks in memory before they are sent to
a remote. So, using a large chunk size will make it use more memory.

To enable chunking, pass a `chunk=XXmb` parameter to `git annex
initremote`.

To disable chunking of a remote that was using chunking,
pass `chunk=0` to `git annex enableremote`. Any content already stored on
the remote using chunks will continue to be accessed via chunks, this
just prevents using chunks when storing new content.

To change the chunk size, pass a `chunk=XXmb` parameter to
`git annex enableremote`. This only affects the chunk sized used when
storing new content.

See also: [[design document|design/assistant/chunks]]