1git-annex-mirror(1)         General Commands Manual        git-annex-mirror(1)
2
3
4

NAME

6       git-annex-mirror - mirror content of files to/from another repository
7

SYNOPSIS

9       git annex mirror [path ...] [--to=remote|--from=remote]
10

DESCRIPTION

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

OPTIONS

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

SEE ALSO

78       git-annex(1)
79
80       git-annex-sync(1)
81

AUTHOR

83       Joey Hess <id@joeyh.name>
84
85                                                           git-annex-mirror(1)