summaryrefslogtreecommitdiff
path: root/doc/git-annex-migrate.mdwn
blob: bc3c3dfaae7577121635bb0f65d65d5ce827f6b0 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
# NAME

git-annex migrate - switch data to different backend

# SYNOPSIS

git annex migrate `[path ...]`

# DESCRIPTION

Changes the specified annexed files to use the default key-value backend
(or the one specified with `--backend`). Only files whose content
is currently available are migrated.

Note that the content is also still available using the old key after
migration. Use `git annex unused` to find and remove the old key.

Normally, nothing will be done to files already using the new backend.
However, if a backend changes the information it uses to construct a key,
this can also be used to migrate files to use the new key format.

When you have multiple repositories that each contain a copy of a file,
it's best to run migrate in all of them.

# OPTIONS

* `--backend`

  Specify the new key-value backend to use for migrated data.

* `--force`

  Force migration of keys that are already using the new backend.

* file matching options
 
  The [[git-annex-matching-options]](1)
  can be used to specify files to migrate.

# SEE ALSO

[[git-annex]](1)

[[git-annex-upgrade]](1)

# AUTHOR

Joey Hess <id@joeyh.name>

Warning: Automatically converted into a man page by mdwn2man. Edit with care.