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       --all -A
38              Mirror  all  objects  stored  in the git annex, not only objects
39              used by currently existing files.
40
41              However, this bypasses checking  the  .gitattributes  annex.num‐
42              copies setting when dropping files.
43
44              This  is  the  default behavior when running git-annex in a bare
45              repository.
46
47       --branch=ref
48              Operate on files in the specified branch or treeish.
49
50              Like --all, this bypasses checking the .gitattributes annex.num‐
51              copies setting when dropping files.
52
53       --unused
54              Operate on files found by last run of git-annex unused.
55
56       --failed
57              Operate on files that have recently failed to be transferred.
58
59       file matching options
60              The  git-annex-matching-options(1)  can be used to specify files
61              to mirror.
62
63       --json Enable JSON output. This is intended to be  parsed  by  programs
64              that use git-annex. Each line of output is a JSON object.
65
66       --json-progress
67              Include progress objects in JSON output.
68
69       --json-error-messages
70              Messages  that  would  normally  be output to standard error are
71              included in the json instead.
72

SEE ALSO

74       git-annex(1)
75
76       git-annex-sync(1)
77

AUTHOR

79       Joey Hess <id@joeyh.name>
80
81                                                           git-annex-mirror(1)