1GIT-COMMIT-GRAPH(1)               Git Manual               GIT-COMMIT-GRAPH(1)
2
3
4

NAME

6       git-commit-graph - Write and verify Git commit graph files
7

SYNOPSIS

9       git commit-graph read [--object-dir <dir>]
10       git commit-graph write <options> [--object-dir <dir>]
11
12

DESCRIPTION

14       Manage the serialized commit graph file.
15

OPTIONS

17       --object-dir
18           Use given directory for the location of packfiles and commit graph
19           file. This parameter exists to specify the location of an alternate
20           that only has the objects directory, not a full .git directory. The
21           commit graph file is expected to be at <dir>/info/commit-graph and
22           the packfiles are expected to be in <dir>/pack.
23

COMMANDS

25       write
26           Write a commit graph file based on the commits found in packfiles.
27
28           With the --stdin-packs option, generate the new commit graph by
29           walking objects only in the specified pack-indexes. (Cannot be
30           combined with --stdin-commits.)
31
32           With the --stdin-commits option, generate the new commit graph by
33           walking commits starting at the commits specified in stdin as a
34           list of OIDs in hex, one OID per line. (Cannot be combined with
35           --stdin-packs.)
36
37           With the --append option, include all commits that are present in
38           the existing commit-graph file.
39
40       read
41           Read a graph file given by the commit-graph file and output basic
42           details about the graph file. Used for debugging purposes.
43

EXAMPLES

45       ·   Write a commit graph file for the packed commits in your local .git
46           folder.
47
48               $ git commit-graph write
49
50
51       ·   Write a graph file, extending the current graph file using commits
52
53       ·   in <pack-index>.
54
55               $ echo <pack-index> | git commit-graph write --stdin-packs
56
57
58       ·   Write a graph file containing all reachable commits.
59
60               $ git show-ref -s | git commit-graph write --stdin-commits
61
62
63       ·   Write a graph file containing all commits in the current
64
65       ·   commit-graph file along with those reachable from HEAD.
66
67               $ git rev-parse HEAD | git commit-graph write --stdin-commits --append
68
69
70       ·   Read basic information from the commit-graph file.
71
72               $ git commit-graph read
73
74

GIT

76       Part of the git(1) suite
77
78
79
80Git 2.18.1                        05/14/2019               GIT-COMMIT-GRAPH(1)