FASTEXPORT
Description
Exports a repository in fast-export format.
Usage
cm fast-export | fe <repspec> <fast-export-file> [--import-marks=<marks_file>] [--export-marks=<marks_file>] [--branchseparator=<chr_separator>] [--nodata] [--from=<changesetid>] [--to=<changesetid>]
Options
Option / Argument | Description |
---|---|
repspec | The repository which the data will be exported from. (Use 'cm help objectspec' to learn more about rep specs.) |
fast-export-file | The file with the repository data in Git fast-export format. |
--import-marks | The marks file used for incremental imports. This file has been previously exported by '--export-marks'. The changesets described in this file will not be imported because they were already in a previous import. |
--export-marks | The file where the imported changesets will be saved. This file is used in a later fast-import to signal the changesets that have been already imported. |
--branchseparator | Unity VCS uses "/" as default separator in the branch hierarchy. This option allows using char as a hierarchy separator, so main-task-sub would be mapped in Unity VCS as /main/task/sub. |
--nodata | Exports the repository without including the data. This is useful to check if the export will run correctly. |
--from | Exports from a particular changeset. |
--to | Exports to a particular changeset. |
Help
Remarks
- To import a Unity VCS repository to Git, use a command such as:
cat repo.fe.00 | git fast-import --export-marks=marks.git --import-marks=marks.git
- Incremental export is supported using a marks file that contains the changesets previously imported ('--import-marks' and '--export-marks' files). This means that only the new changesets that were not exported in the previous fast-export will be exported.
Examples
cm fast-export repo@localhost:8087 repo.fe.00 --import-marks=marks.cm --export-marks=marks.cm
(Exports the repository 'repo' in the local server into the 'repo.fe.00' file in Git fast-export format and creates the marks files to perform incremental exports later.)
cm fast-export repo@localhost:8087 repo.fe.00 --from=20
(Exports the repository 'repo' in the local server into the 'repo.fe.00' file in Git fast-export format from changeset '20'.)