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              Setting this to "cpus" will run one job per CPU core.
36
37       --auto Rather than copying all files, only copy files  that  don't  yet
38              have the desired number of copies, or that are preferred content
39              of  the  destination  repository.  See  git-annex-preferred-con‐
40              tent(1)
41
42       --fast When copying content to a remote, avoid a round trip to check if
43              the remote already has content. This can be  faster,  but  might
44              skip copying content to the remote in some cases.
45
46       --all -A
47              Rather  than  specifying a filename or path to copy, this option
48              can be used to copy all available versions of all files.
49
50              This is the default behavior when running git-annex  in  a  bare
51              repository.
52
53       --branch=ref
54              Operate on files in the specified branch or treeish.
55
56       --unused
57              Operate on files found by last run of git-annex unused.
58
59       --failed
60              Operate on files that have recently failed to be transferred.
61
62       --key=keyname
63              Use this option to copy a specified key.
64
65       file matching options
66              The  git-annex-matching-options(1)  can be used to specify files
67              to copy.
68
69       --batch
70              Enables batch mode, in which lines containing names of files  to
71              copy are read from stdin.
72
73              As  each  specified file is processed, the usual progress output
74              is displayed. If a file's content does not need to be copied, or
75              it  does  not  match specified matching options, or it is not an
76              annexed file, a blank line is output in response instead.
77
78              Since the usual output while copying a file is verbose  and  not
79              machine-parseable,  you  may  want  to use --json in combination
80              with --batch.
81
82       -z     Makes the --batch input be delimited by  nulls  instead  of  the
83              usual newlines.
84
85       --json Enable  JSON  output.  This is intended to be parsed by programs
86              that use git-annex. Each line of output is a JSON object.
87
88       --json-progress
89              Include progress objects in JSON output.
90
91       --json-error-messages
92              Messages that would normally be output  to  standard  error  are
93              included in the json instead.
94

SEE ALSO

96       git-annex(1)
97
98       git-annex-get(1)
99
100       git-annex-move(1)
101
102       git-annex-drop(1)
103

AUTHOR

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