1git-fast-export(1) 2================== 3 4NAME 5---- 6git-fast-export - Git data exporter 7 8 9SYNOPSIS 10-------- 11'git-fast-export [options]' | 'git-fast-import' 12 13DESCRIPTION 14----------- 15This program dumps the given revisions in a form suitable to be piped 16into gitlink:git-fast-import[1]. 17 18You can use it as a human readable bundle replacement (see 19gitlink:git-bundle[1]), or as a kind of an interactive 20gitlink:git-filter-branch[1]. 21 22 23OPTIONS 24------- 25--progress=<n>:: 26 Insert 'progress' statements every <n> objects, to be shown by 27 gitlink:git-fast-import[1] during import. 28 29--signed-tags=(verbatim|warn|strip|abort):: 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+ 34When asking to 'abort' (which is the default), this program will die 35when encountering a signed tag. With 'strip', the tags will be made 36unsigned, with 'verbatim', they will be silently exported 37and with 'warn', they will be exported, but you will see a warning. 38 39 40EXAMPLES 41-------- 42 43------------------------------------------------------------------- 44$ git fast-export --all | (cd /empty/repository && git fast-import) 45------------------------------------------------------------------- 46 47This will export the whole repository and import it into the existing 48empty repository. Except for reencoding commits that are not in 49UTF-8, it would be a one-to-one mirror. 50 51----------------------------------------------------- 52$ git fast-export master~5..master | 53 sed "s|refs/heads/master|refs/heads/other|" | 54 git fast-import 55----------------------------------------------------- 56 57This makes a new branch called 'other' from 'master~5..master' 58(i.e. if 'master' has linear history, it will take the last 5 commits). 59 60Note that this assumes that none of the blobs and commit messages 61referenced by that revision range contains the string 62'refs/heads/master'. 63 64 65Limitations 66----------- 67 68Since gitlink:git-fast-import[1] cannot tag trees, you will not be 69able to export the linux-2.6.git repository completely, as it contains 70a tag referencing a tree instead of a commit. 71 72 73Author 74------ 75Written by Johannes E. Schindelin <johannes.schindelin@gmx.de>. 76 77Documentation 78-------------- 79Documentation by Johannes E. Schindelin <johannes.schindelin@gmx.de>. 80 81GIT 82--- 83Part of the gitlink:git[7] suite