]>
Commit | Line | Data |
---|---|---|
f2dc849e JS |
1 | git-fast-export(1) |
2 | ================== | |
3 | ||
4 | NAME | |
5 | ---- | |
6 | git-fast-export - Git data exporter | |
7 | ||
8 | ||
9 | SYNOPSIS | |
10 | -------- | |
b1889c36 | 11 | 'git fast-export [options]' | 'git fast-import' |
f2dc849e JS |
12 | |
13 | DESCRIPTION | |
14 | ----------- | |
15 | This program dumps the given revisions in a form suitable to be piped | |
0b444cdb | 16 | into 'git fast-import'. |
f2dc849e | 17 | |
29b802aa | 18 | You can use it as a human-readable bundle replacement (see |
5162e697 | 19 | linkgit:git-bundle[1]), or as a kind of an interactive |
0b444cdb | 20 | 'git filter-branch'. |
f2dc849e JS |
21 | |
22 | ||
23 | OPTIONS | |
24 | ------- | |
25 | --progress=<n>:: | |
26 | Insert 'progress' statements every <n> objects, to be shown by | |
0b444cdb | 27 | 'git fast-import' during import. |
f2dc849e | 28 | |
ee4bc371 | 29 | --signed-tags=(verbatim|warn|strip|abort):: |
f2dc849e JS |
30 | Specify how to handle signed tags. Since any transformation |
31 | after the export can change the tag names (which can also happen | |
32 | when excluding revisions) the signatures will not match. | |
33 | + | |
34 | When asking to 'abort' (which is the default), this program will die | |
35 | when encountering a signed tag. With 'strip', the tags will be made | |
ee4bc371 | 36 | unsigned, with 'verbatim', they will be silently exported |
f2dc849e JS |
37 | and with 'warn', they will be exported, but you will see a warning. |
38 | ||
2d8ad469 | 39 | --tag-of-filtered-object=(abort|drop|rewrite):: |
6a5d0b0a | 40 | Specify how to handle tags whose tagged object is filtered out. |
2d8ad469 EN |
41 | Since revisions and files to export can be limited by path, |
42 | tagged objects may be filtered completely. | |
43 | + | |
44 | When asking to 'abort' (which is the default), this program will die | |
45 | when encountering such a tag. With 'drop' it will omit such tags from | |
46 | the output. With 'rewrite', if the tagged object is a commit, it will | |
47 | rewrite the tag to tag an ancestor commit (via parent rewriting; see | |
48 | linkgit:git-rev-list[1]) | |
49 | ||
ae7c5dce AG |
50 | -M:: |
51 | -C:: | |
52 | Perform move and/or copy detection, as described in the | |
53 | linkgit:git-diff[1] manual page, and use it to generate | |
54 | rename and copy commands in the output dump. | |
55 | + | |
56 | Note that earlier versions of this command did not complain and | |
57 | produced incorrect results if you gave these options. | |
58 | ||
df6a7ff7 PB |
59 | --export-marks=<file>:: |
60 | Dumps the internal marks table to <file> when complete. | |
61 | Marks are written one per line as `:markid SHA-1`. Only marks | |
62 | for revisions are dumped; marks for blobs are ignored. | |
63 | Backends can use this file to validate imports after they | |
64 | have been completed, or to save the marks table across | |
65 | incremental runs. As <file> is only opened and truncated | |
66 | at completion, the same path can also be safely given to | |
67 | \--import-marks. | |
68 | ||
69 | --import-marks=<file>:: | |
70 | Before processing any input, load the marks specified in | |
71 | <file>. The input file must exist, must be readable, and | |
72 | must use the same format as produced by \--export-marks. | |
73 | + | |
74 | Any commits that have already been marked will not be exported again. | |
75 | If the backend uses a similar \--import-marks file, this allows for | |
76 | incremental bidirectional exporting of the repository by keeping the | |
77 | marks the same across runs. | |
78 | ||
4e46a8d6 JS |
79 | --fake-missing-tagger:: |
80 | Some old repositories have tags without a tagger. The | |
81 | fast-import protocol was pretty strict about that, and did not | |
82 | allow that. So fake a tagger to be able to fast-import the | |
83 | output. | |
84 | ||
79559f27 GI |
85 | --no-data:: |
86 | Skip output of blob objects and instead refer to blobs via | |
87 | their original SHA-1 hash. This is useful when rewriting the | |
88 | directory structure or history of a repository without | |
89 | touching the contents of individual files. Note that the | |
90 | resulting stream can only be used by a repository which | |
91 | already contains the necessary objects. | |
92 | ||
7f40ab09 EN |
93 | --full-tree:: |
94 | This option will cause fast-export to issue a "deleteall" | |
95 | directive for each commit followed by a full list of all files | |
96 | in the commit (as opposed to just listing the files which are | |
97 | different from the commit's first parent). | |
98 | ||
62b4698e | 99 | [<git-rev-list-args>...]:: |
0b444cdb TR |
100 | A list of arguments, acceptable to 'git rev-parse' and |
101 | 'git rev-list', that specifies the specific objects and references | |
fc621bd0 | 102 | to export. For example, `master{tilde}10..master` causes the |
8af15d28 EN |
103 | current master reference to be exported along with all objects |
104 | added since its 10th ancestor commit. | |
f2dc849e JS |
105 | |
106 | EXAMPLES | |
107 | -------- | |
108 | ||
109 | ------------------------------------------------------------------- | |
110 | $ git fast-export --all | (cd /empty/repository && git fast-import) | |
111 | ------------------------------------------------------------------- | |
112 | ||
113 | This will export the whole repository and import it into the existing | |
114 | empty repository. Except for reencoding commits that are not in | |
115 | UTF-8, it would be a one-to-one mirror. | |
116 | ||
117 | ----------------------------------------------------- | |
118 | $ git fast-export master~5..master | | |
119 | sed "s|refs/heads/master|refs/heads/other|" | | |
120 | git fast-import | |
121 | ----------------------------------------------------- | |
122 | ||
123 | This makes a new branch called 'other' from 'master~5..master' | |
124 | (i.e. if 'master' has linear history, it will take the last 5 commits). | |
125 | ||
126 | Note that this assumes that none of the blobs and commit messages | |
127 | referenced by that revision range contains the string | |
128 | 'refs/heads/master'. | |
129 | ||
130 | ||
131 | Limitations | |
132 | ----------- | |
133 | ||
0b444cdb | 134 | Since 'git fast-import' cannot tag trees, you will not be |
f2dc849e JS |
135 | able to export the linux-2.6.git repository completely, as it contains |
136 | a tag referencing a tree instead of a commit. | |
137 | ||
138 | ||
139 | Author | |
140 | ------ | |
141 | Written by Johannes E. Schindelin <johannes.schindelin@gmx.de>. | |
142 | ||
143 | Documentation | |
144 | -------------- | |
145 | Documentation by Johannes E. Schindelin <johannes.schindelin@gmx.de>. | |
146 | ||
147 | GIT | |
148 | --- | |
9e1f0a85 | 149 | Part of the linkgit:git[1] suite |