The first new task in the 'git maintenance' builtin is the
'commit-graph' task. This updates the commit-graph file
incrementally with the command
git commit-graph write --reachable --split
By writing an incremental commit-graph file using the "--split"
option we minimize the disruption from this operation. The default
behavior is to merge layers until the new "top" layer is less than
half the size of the layer below. This provides quick writes most
of the time, with the longer writes following a power law
distribution.
Most importantly, concurrent Git processes only look at the
commit-graph-chain file for a very short amount of time, so they
will verly likely not be holding a handle to the file when we try
to replace it. (This only matters on Windows.)
If a concurrent process reads the old commit-graph-chain file, but
our job expires some of the .graph files before they can be read,
then those processes will see a warning message (but not fail).
This could be avoided by a future update to use the --expire-time
argument when writing the commit-graph.
Signed-off-by: Derrick Stolee <dstolee@microsoft.com>
Signed-off-by: Junio C Hamano <gitster@pobox.com>
Derrick Stolee committedSep 17, 2020 at 18:11 UTC663b2b1b90bf76275044824ddeca96aaec240f09
5 files changed+45-4
Documentation/git-maintenance.txt
+8
index 04fa0fe329..fc5dbcf0b9 100644--- a/Documentation/git-maintenance.txt+++ b/Documentation/git-maintenance.txt@@ -35,6 +35,14 @@ run:: TASKS -----+commit-graph::+ The `commit-graph` job updates the `commit-graph` files incrementally,+ then verifies that the written data is correct. The incremental+ write is safe to run alongside concurrent Git processes since it+ will not expire `.graph` files that were in the previous+ `commit-graph-chain` file. They will be deleted by a later run based+ on the expiration delay.+ gc:: Clean up unnecessary files and optimize the local repository. "GC" stands for "garbage collection," but this task performs many
builtin/gc.c
+30
index 904fb2d9aa..86b807a008 100644--- a/builtin/gc.c+++ b/builtin/gc.c@@ -710,6 +710,31 @@ struct maintenance_run_opts { int quiet; };+static int run_write_commit_graph(struct maintenance_run_opts *opts)+{+ struct child_process child = CHILD_PROCESS_INIT;++ child.git_cmd = 1;+ strvec_pushl(&child.args, "commit-graph", "write",+ "--split", "--reachable", NULL);++ if (opts->quiet)+ strvec_push(&child.args, "--no-progress");++ return !!run_command(&child);+}++static int maintenance_task_commit_graph(struct maintenance_run_opts *opts)+{+ close_object_store(the_repository->objects);+ if (run_write_commit_graph(opts)) {+ error(_("failed to write commit-graph"));+ return 1;+ }++ return 0;+}+ static int maintenance_task_gc(struct maintenance_run_opts *opts) { struct child_process child = CHILD_PROCESS_INIT;@@ -738,6 +763,7 @@ struct maintenance_task { enum maintenance_task_label { TASK_GC,+ TASK_COMMIT_GRAPH, /* Leave as final value */ TASK__COUNT@@ -749,6 +775,10 @@ static struct maintenance_task tasks[] = { maintenance_task_gc, 1, },+ [TASK_COMMIT_GRAPH] = {+ "commit-graph",+ maintenance_task_commit_graph,+ }, }; static int maintenance_run_tasks(struct maintenance_run_opts *opts)