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

NAME

6       git-annex-migrate - switch data to different backend
7

SYNOPSIS

9       git annex migrate [path ...]
10

DESCRIPTION

12       Changes  the specified annexed files to use the default key-value back‐
13       end (or the one specified with --backend). Only files whose content  is
14       currently available are migrated.
15
16       Note  that  the content is also still available using the old key after
17       migration. Use git annex unused to find and remove the old key.
18
19       Normally, nothing will be done to files already using the new  backend.
20       However,  if  a  backend changes the information it uses to construct a
21       key, this can also be used to migrate files to use the new key format.
22
23       When you have multiple repositories that each contain a copy of a file,
24       it's best to run migrate in all of them.
25

OPTIONS

27       --backend
28
29              Specify the new key-value backend to use for migrated data.
30
31       --force
32              Force migration of keys that are already using the new backend.
33
34       file matching options
35              The  git-annex-matching-options(1)  can be used to specify files
36              to migrate.
37
38       Also the git-annex-common-options(1) can be used.
39
40       --remove-size
41              Keys often include the size of their content, which is generally
42              a useful thing. In fact, this command defaults to adding missing
43              size information to keys. With this option, the size information
44              is removed instead.
45
46              One use of this option is to convert URL keys that were added by
47              git-annex addurl --fast to ones that would have  been  added  if
48              that command was run with the --relaxed option. Eg:
49
50               git-annex migrate --remove-size --backend=URL somefile
51
52       --json Enable  JSON  output.  This is intended to be parsed by programs
53              that use git-annex. Each line of output is a JSON object.
54
55       --json-error-messages
56              Messages that would normally be output to standard error are in‐
57              cluded in the JSON instead.
58

SEE ALSO

60       git-annex(1)
61
62       git-annex-upgrade(1)
63
64       git-annex-backend(1)
65

AUTHOR

67       Joey Hess <id@joeyh.name>
68
69                                                          git-annex-migrate(1)
Impressum