1git-annex-mirror(1) General Commands Manual git-annex-mirror(1)
2
3
4
6 git-annex-mirror - mirror content of files to/from another repository
7
9 git annex mirror [path ...] [--to=remote|--from=remote]
10
12 This causes a destination repository to mirror a source repository.
13
14 Each specified file in the source repository is mirrored to the desti‐
15 nation repository. If a file's content is present in the source reposi‐
16 tory, it is copied to the destination repository. If a file's content
17 is not present in the source repository, it will be dropped from the
18 destination repository when the numcopies setting allows.
19
20 Note that mirror does not sync the git repository, but only the file
21 contents. Use git-annex-sync(1) for that.
22
24 --to=remote
25
26 Use the local repository as the source repository, and mirror
27 its contents to the remote.
28
29 --from=remote
30 Use the remote as the source repository, and mirror its contents
31 to the local repository.
32
33 --jobs=N -JN
34 Enables parallel transfers with up to the specified number of
35 jobs running at once. For example: -J10
36
37 Setting this to "cpus" will run one job per CPU core.
38
39 --all -A
40 Mirror all objects stored in the git annex, not only objects
41 used by currently existing files.
42
43 However, this bypasses checking the .gitattributes annex.num‐
44 copies setting when dropping files.
45
46 This is the default behavior when running git-annex in a bare
47 repository.
48
49 --branch=ref
50 Operate on files in the specified branch or treeish.
51
52 Like --all, this bypasses checking the .gitattributes annex.num‐
53 copies setting when dropping files.
54
55 --unused
56 Operate on files found by last run of git-annex unused.
57
58 --failed
59 Operate on files that have recently failed to be transferred.
60
61 matching options
62 The git-annex-matching-options(1) can be used to control what to
63 mirror.
64
65 --json Enable JSON output. This is intended to be parsed by programs
66 that use git-annex. Each line of output is a JSON object.
67
68 --json-progress
69 Include progress objects in JSON output.
70
71 --json-error-messages
72 Messages that would normally be output to standard error are in‐
73 cluded in the json instead.
74
75 Also the git-annex-common-options(1) can be used.
76
78 git-annex(1)
79
80 git-annex-sync(1)
81
83 Joey Hess <id@joeyh.name>
84
85 git-annex-mirror(1)