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

NAME

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

SYNOPSIS

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

DESCRIPTION

12       Copies the content of files from or to another remote.
13

OPTIONS

15       --from=remote
16
17              Copy the content of files from the specified remote to the local
18              repository.
19
20              Any files that are not available on the remote will be  silently
21              skipped.
22
23       --to=remote
24              Copy the content of files from the local repository to the spec‐
25              ified remote.
26
27       --to=here
28              Copy the content of files from  all  reachable  remotes  to  the
29              local repository.
30
31       --jobs=N -JN
32              Enables  parallel  transfers  with up to the specified number of
33              jobs running at once. For example: -J10
34
35       --auto Rather than copying all files, only copy files  that  don't  yet
36              have the desired number of copies, or that are preferred content
37              of  the  destination  repository.  See  git-annex-preferred-con‐
38              tent(1)
39
40       --fast When copying content to a remote, avoid a round trip to check if
41              the remote already has content. This can be  faster,  but  might
42              skip copying content to the remote in some cases.
43
44       --all -A
45              Rather  than  specifying a filename or path to copy, this option
46              can be used to copy all available versions of all files.
47
48              This is the default behavior when running git-annex  in  a  bare
49              repository.
50
51       --branch=ref
52              Operate on files in the specified branch or treeish.
53
54       --unused
55              Operate on files found by last run of git-annex unused.
56
57       --failed
58              Operate on files that have recently failed to be transferred.
59
60       --key=keyname
61              Use this option to move a specified key.
62
63       file matching options
64              The  git-annex-matching-options(1)  can be used to specify files
65              to copy.
66
67       --batch
68              Enables batch mode, in which lines containing names of files  to
69              copy are read from stdin.
70
71              As  each  specified file is processed, the usual progress output
72              is displayed. If a file's content does not need to be copied, or
73              it  does  not  match specified matching options, or it is not an
74              annexed file, a blank line is output in response instead.
75
76              Since the usual output while copying a file is verbose  and  not
77              machine-parseable,  you  may  want  to use --json in combination
78              with --batch.
79
80       -z     Makes the --batch input be delimited by  nulls  instead  of  the
81              usual newlines.
82
83       --json Enable  JSON  output.  This is intended to be parsed by programs
84              that use git-annex. Each line of output is a JSON object.
85
86       --json-progress
87              Include progress objects in JSON output.
88
89       --json-error-messages
90              Messages that would normally be output  to  standard  error  are
91              included in the json instead.
92

SEE ALSO

94       git-annex(1)
95
96       git-annex-get(1)
97
98       git-annex-move(1)
99
100       git-annex-drop(1)
101

AUTHOR

103       Joey Hess <id@joeyh.name>
104
105                                                             git-annex-copy(1)
Impressum