1git-commit-graph(1) 2=================== 3 4NAME 5---- 6git-commit-graph - Write and verify Git commit graph files 7 8 9SYNOPSIS 10-------- 11[verse] 12'git commit-graph read' [--object-dir <dir>] 13'git commit-graph verify' [--object-dir <dir>] 14'git commit-graph write' <options> [--object-dir <dir>] 15 16 17DESCRIPTION 18----------- 19 20Manage the serialized commit graph file. 21 22 23OPTIONS 24------- 25--object-dir:: 26 Use given directory for the location of packfiles and commit graph 27 file. This parameter exists to specify the location of an alternate 28 that only has the objects directory, not a full .git directory. The 29 commit graph file is expected to be at <dir>/info/commit-graph and 30 the packfiles are expected to be in <dir>/pack. 31 32 33COMMANDS 34-------- 35'write':: 36 37Write a commit graph file based on the commits found in packfiles. 38+ 39With the `--stdin-packs` option, generate the new commit graph by 40walking objects only in the specified pack-indexes. (Cannot be combined 41with `--stdin-commits` or `--reachable`.) 42+ 43With the `--stdin-commits` option, generate the new commit graph by 44walking commits starting at the commits specified in stdin as a list 45of OIDs in hex, one OID per line. (Cannot be combined with 46`--stdin-packs` or `--reachable`.) 47+ 48With the `--reachable` option, generate the new commit graph by walking 49commits starting at all refs. (Cannot be combined with `--stdin-commits` 50or `--stdin-packs`.) 51+ 52With the `--append` option, include all commits that are present in the 53existing commit-graph file. 54 55'read':: 56 57Read a graph file given by the commit-graph file and output basic 58details about the graph file. Used for debugging purposes. 59 60'verify':: 61 62Read the commit-graph file and verify its contents against the object 63database. Used to check for corrupted data. 64 65 66EXAMPLES 67-------- 68 69* Write a commit graph file for the packed commits in your local .git folder. 70+ 71------------------------------------------------ 72$ git commit-graph write 73------------------------------------------------ 74 75* Write a graph file, extending the current graph file using commits 76* in <pack-index>. 77+ 78------------------------------------------------ 79$ echo <pack-index> | git commit-graph write --stdin-packs 80------------------------------------------------ 81 82* Write a graph file containing all reachable commits. 83+ 84------------------------------------------------ 85$ git show-ref -s | git commit-graph write --stdin-commits 86------------------------------------------------ 87 88* Write a graph file containing all commits in the current 89* commit-graph file along with those reachable from HEAD. 90+ 91------------------------------------------------ 92$ git rev-parse HEAD | git commit-graph write --stdin-commits --append 93------------------------------------------------ 94 95* Read basic information from the commit-graph file. 96+ 97------------------------------------------------ 98$ git commit-graph read 99------------------------------------------------ 100 101 102GIT 103--- 104Part of the linkgit:git[1] suite