442ac243e689adfe0dba9d17ee506e10d0eeb7ca
   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 write' <options> [--object-dir <dir>]
  14
  15
  16DESCRIPTION
  17-----------
  18
  19Manage the serialized commit graph file.
  20
  21
  22OPTIONS
  23-------
  24--object-dir::
  25        Use given directory for the location of packfiles and commit graph
  26        file. This parameter exists to specify the location of an alternate
  27        that only has the objects directory, not a full .git directory. The
  28        commit graph file is expected to be at <dir>/info/commit-graph and
  29        the packfiles are expected to be in <dir>/pack.
  30
  31
  32COMMANDS
  33--------
  34'write'::
  35
  36Write a commit graph file based on the commits found in packfiles.
  37+
  38With the `--stdin-packs` option, generate the new commit graph by
  39walking objects only in the specified pack-indexes. (Cannot be combined
  40with --stdin-commits.)
  41+
  42With the `--stdin-commits` option, generate the new commit graph by
  43walking commits starting at the commits specified in stdin as a list
  44of OIDs in hex, one OID per line. (Cannot be combined with
  45--stdin-packs.)
  46
  47'read'::
  48
  49Read a graph file given by the commit-graph file and output basic
  50details about the graph file. Used for debugging purposes.
  51
  52
  53EXAMPLES
  54--------
  55
  56* Write a commit graph file for the packed commits in your local .git folder.
  57+
  58------------------------------------------------
  59$ git commit-graph write
  60------------------------------------------------
  61
  62* Write a graph file, extending the current graph file using commits
  63* in <pack-index>.
  64+
  65------------------------------------------------
  66$ echo <pack-index> | git commit-graph write --stdin-packs
  67------------------------------------------------
  68
  69* Write a graph file containing all reachable commits.
  70+
  71------------------------------------------------
  72$ git show-ref -s | git commit-graph write --stdin-commits
  73------------------------------------------------
  74
  75* Read basic information from the commit-graph file.
  76+
  77------------------------------------------------
  78$ git commit-graph read
  79------------------------------------------------
  80
  81
  82GIT
  83---
  84Part of the linkgit:git[1] suite