git@vger.kernel.org list mirror (unofficial, one of many)
 help / color / mirror / code / Atom feed
898aff47265e0e7e00e255ccfe9c99bcd84a02c7 blob 4192 bytes (raw)

  1
  2
  3
  4
  5
  6
  7
  8
  9
 10
 11
 12
 13
 14
 15
 16
 17
 18
 19
 20
 21
 22
 23
 24
 25
 26
 27
 28
 29
 30
 31
 32
 33
 34
 35
 36
 37
 38
 39
 40
 41
 42
 43
 44
 45
 46
 47
 48
 49
 50
 51
 52
 53
 54
 55
 56
 57
 58
 59
 60
 61
 62
 63
 64
 65
 66
 67
 68
 69
 70
 71
 72
 73
 74
 75
 76
 77
 78
 79
 80
 81
 82
 83
 84
 85
 86
 87
 88
 89
 90
 91
 92
 93
 94
 95
 96
 97
 98
 99
100
101
102
103
104
105
106
107
108
109
110
111
112
 
git-maintenance(1)
==================

NAME
----
git-maintenance - Run tasks to optimize Git repository data


SYNOPSIS
--------
[verse]
'git maintenance' run [<options>]


DESCRIPTION
-----------
Run tasks to optimize Git repository data, speeding up other Git commands
and reducing storage requirements for the repository.
+
Git commands that add repository data, such as `git add` or `git fetch`,
are optimized for a responsive user experience. These commands do not take
time to optimize the Git data, since such optimizations scale with the full
size of the repository while these user commands each perform a relatively
small action.
+
The `git maintenance` command provides flexibility for how to optimize the
Git repository.

SUBCOMMANDS
-----------

run::
	Run one or more maintenance tasks. If one or more `--task` options
	are specified, then those tasks are run in that order. Otherwise,
	the tasks are determined by which `maintenance.<task>.enabled`
	config options are true. By default, only `maintenance.gc.enabled`
	is true.

TASKS
-----

commit-graph::
	The `commit-graph` job updates the `commit-graph` files incrementally,
	then verifies that the written data is correct. If the new layer has an
	issue, then the chain file is removed and the `commit-graph` is
	rewritten from scratch.
+
The verification only checks the top layer of the `commit-graph` chain.
If the incremental write merged the new commits with at least one
existing layer, then there is potential for on-disk corruption being
carried forward into the new file. This will be noticed and the new
commit-graph file will be clean as Git reparses the commit data from
the object database.
+
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.

prefetch::
	The `prefetch` task updates the object directory with the latest
	objects from all registered remotes. For each remote, a `git fetch`
	command is run. The refmap is custom to avoid updating local or remote
	branches (those in `refs/heads` or `refs/remotes`). Instead, the
	remote refs are stored in `refs/prefetch/<remote>/`. Also, tags are
	not updated.
+
This is done to avoid disrupting the remote-tracking branches. The end users
expect these refs to stay unmoved unless they initiate a fetch.  With prefetch
task, however, the objects necessary to complete a later real fetch would
already be obtained, so the real fetch would go faster.  In the ideal case,
it will just become an update to bunch of remote-tracking branches without
any object transfer.

gc::
	Cleanup unnecessary files and optimize the local repository. "GC"
	stands for "garbage collection," but this task performs many
	smaller tasks. This task can be rather expensive for large
	repositories, as it repacks all Git objects into a single pack-file.
	It can also be disruptive in some situations, as it deletes stale
	data.

loose-objects::
	The `loose-objects` job cleans up loose objects and places them into
	pack-files. In order to prevent race conditions with concurrent Git
	commands, it follows a two-step process. First, it deletes any loose
	objects that already exist in a pack-file; concurrent Git processes
	will examine the pack-file for the object data instead of the loose
	object. Second, it creates a new pack-file (starting with "loose-")
	containing a batch of loose objects. The batch size is limited to 50
	thousand objects to prevent the job from taking too long on a
	repository with many loose objects.

OPTIONS
-------
--auto::
	When combined with the `run` subcommand, run maintenance tasks
	only if certain thresholds are met. For example, the `gc` task
	runs when the number of loose objects exceeds the number stored
	in the `gc.auto` config setting, or when the number of pack-files
	exceeds the `gc.autoPackLimit` config setting.

--quiet::
	Do not report progress or other information over `stderr`.

--task=<task>::
	If this option is specified one or more times, then only run the
	specified tasks in the specified order.

GIT
---
Part of the linkgit:git[1] suite
debug log:

solving 898aff4726 ...
found 898aff4726 in https://public-inbox.org/git/621375a3c99014c48568660bde062b7330d5a662.1596731425.git.gitgitgadget@gmail.com/
found bb0d5eded4 in https://public-inbox.org/git/85118ed5f19468d5051dd1579e35cae3c3114d24.1596731425.git.gitgitgadget@gmail.com/
found e1a2a8902c in https://public-inbox.org/git/69bfc6a4b2bb1a86788e69a2a3ac6134085aa798.1596728921.git.gitgitgadget@gmail.com/
found 5911213c9c in https://public-inbox.org/git/dddbcc4f3d28e2c00f153007b7db40733dbd572d.1596728921.git.gitgitgadget@gmail.com/
found 35b0be7d40 in https://public-inbox.org/git/a4d9836bed9a08f4ba716240a6fc18d5f13da3dc.1596147867.git.gitgitgadget@gmail.com/ ||
	https://public-inbox.org/git/902b742032ae19087392538936cc81768a59e0e1.1596728921.git.gitgitgadget@gmail.com/ ||
	https://public-inbox.org/git/04552b1d2ed751a11eb7c50f6898cbc078b552b4.1595527000.git.gitgitgadget@gmail.com/ ||
	https://public-inbox.org/git/c8fbd14d41093e12905027ff628b98652cd931d0.1594131695.git.gitgitgadget@gmail.com/
found 089fa4cedc in https://public-inbox.org/git/018a9331e204fd6b1b92f5b53f3f373fa9e23bc2.1594131695.git.gitgitgadget@gmail.com/ ||
	https://public-inbox.org/git/6e533e43d71580d3cd81f9b0ae2c5884a7d3ac2a.1596147867.git.gitgitgadget@gmail.com/ ||
	https://public-inbox.org/git/1d37e55cb714ea579744d28d1aeb332a63815342.1595527000.git.gitgitgadget@gmail.com/ ||
	https://public-inbox.org/git/d5faef26af8896dc7a82c2b809a3af2724da8afd.1596728921.git.gitgitgadget@gmail.com/
found 34cd2b4417 in https://public-inbox.org/git/12fe73bb72bf2193967979acf68f7645b339eaa2.1596147867.git.gitgitgadget@gmail.com/ ||
	https://public-inbox.org/git/5f89e0ec9b9c9a02deed5b79b35253e0462dc87c.1594131695.git.gitgitgadget@gmail.com/ ||
	https://public-inbox.org/git/63ec602a07756a41f8ccddd745562c567a4b3ed7.1595527000.git.gitgitgadget@gmail.com/ ||
	https://public-inbox.org/git/2b9deb6d6a23e53bec75e109f2e3ef9217420425.1596728921.git.gitgitgadget@gmail.com/

applying [1/16] https://public-inbox.org/git/12fe73bb72bf2193967979acf68f7645b339eaa2.1596147867.git.gitgitgadget@gmail.com/
diff --git a/Documentation/git-maintenance.txt b/Documentation/git-maintenance.txt
new file mode 100644
index 0000000000..34cd2b4417

Checking patch Documentation/git-maintenance.txt...
Applied patch Documentation/git-maintenance.txt cleanly.

skipping https://public-inbox.org/git/5f89e0ec9b9c9a02deed5b79b35253e0462dc87c.1594131695.git.gitgitgadget@gmail.com/ for 34cd2b4417
skipping https://public-inbox.org/git/63ec602a07756a41f8ccddd745562c567a4b3ed7.1595527000.git.gitgitgadget@gmail.com/ for 34cd2b4417
skipping https://public-inbox.org/git/2b9deb6d6a23e53bec75e109f2e3ef9217420425.1596728921.git.gitgitgadget@gmail.com/ for 34cd2b4417
index at:
100644 34cd2b4417bb0b338d3acae98e5efe2b8baa3c25	Documentation/git-maintenance.txt

applying [2/16] https://public-inbox.org/git/018a9331e204fd6b1b92f5b53f3f373fa9e23bc2.1594131695.git.gitgitgadget@gmail.com/
diff --git a/Documentation/git-maintenance.txt b/Documentation/git-maintenance.txt
index 34cd2b4417..089fa4cedc 100644

Checking patch Documentation/git-maintenance.txt...
Applied patch Documentation/git-maintenance.txt cleanly.

skipping https://public-inbox.org/git/6e533e43d71580d3cd81f9b0ae2c5884a7d3ac2a.1596147867.git.gitgitgadget@gmail.com/ for 089fa4cedc
skipping https://public-inbox.org/git/1d37e55cb714ea579744d28d1aeb332a63815342.1595527000.git.gitgitgadget@gmail.com/ for 089fa4cedc
skipping https://public-inbox.org/git/d5faef26af8896dc7a82c2b809a3af2724da8afd.1596728921.git.gitgitgadget@gmail.com/ for 089fa4cedc
index at:
100644 089fa4cedc4b342d866347fa97891c13b5167ac8	Documentation/git-maintenance.txt

applying [3/16] https://public-inbox.org/git/a4d9836bed9a08f4ba716240a6fc18d5f13da3dc.1596147867.git.gitgitgadget@gmail.com/
diff --git a/Documentation/git-maintenance.txt b/Documentation/git-maintenance.txt
index 089fa4cedc..35b0be7d40 100644

Checking patch Documentation/git-maintenance.txt...
Applied patch Documentation/git-maintenance.txt cleanly.

skipping https://public-inbox.org/git/902b742032ae19087392538936cc81768a59e0e1.1596728921.git.gitgitgadget@gmail.com/ for 35b0be7d40
skipping https://public-inbox.org/git/04552b1d2ed751a11eb7c50f6898cbc078b552b4.1595527000.git.gitgitgadget@gmail.com/ for 35b0be7d40
skipping https://public-inbox.org/git/c8fbd14d41093e12905027ff628b98652cd931d0.1594131695.git.gitgitgadget@gmail.com/ for 35b0be7d40
index at:
100644 35b0be7d403bdcf57cca905b48aba55964258aed	Documentation/git-maintenance.txt

applying [4/16] https://public-inbox.org/git/dddbcc4f3d28e2c00f153007b7db40733dbd572d.1596728921.git.gitgitgadget@gmail.com/
diff --git a/Documentation/git-maintenance.txt b/Documentation/git-maintenance.txt
index 35b0be7d40..5911213c9c 100644


applying [5/16] https://public-inbox.org/git/69bfc6a4b2bb1a86788e69a2a3ac6134085aa798.1596728921.git.gitgitgadget@gmail.com/
diff --git a/Documentation/git-maintenance.txt b/Documentation/git-maintenance.txt
index 5911213c9c..e1a2a8902c 100644


applying [6/16] https://public-inbox.org/git/85118ed5f19468d5051dd1579e35cae3c3114d24.1596731425.git.gitgitgadget@gmail.com/
diff --git a/Documentation/git-maintenance.txt b/Documentation/git-maintenance.txt
index e1a2a8902c..bb0d5eded4 100644


applying [7/16] https://public-inbox.org/git/621375a3c99014c48568660bde062b7330d5a662.1596731425.git.gitgitgadget@gmail.com/
diff --git a/Documentation/git-maintenance.txt b/Documentation/git-maintenance.txt
index bb0d5eded4..898aff4726 100644

Checking patch Documentation/git-maintenance.txt...
Applied patch Documentation/git-maintenance.txt cleanly.
Checking patch Documentation/git-maintenance.txt...
Applied patch Documentation/git-maintenance.txt cleanly.
Checking patch Documentation/git-maintenance.txt...
Applied patch Documentation/git-maintenance.txt cleanly.
Checking patch Documentation/git-maintenance.txt...
Applied patch Documentation/git-maintenance.txt cleanly.

index at:
100644 898aff47265e0e7e00e255ccfe9c99bcd84a02c7	Documentation/git-maintenance.txt

Code repositories for project(s) associated with this inbox:

	https://80x24.org/mirrors/git.git

This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox;
as well as URLs for read-only IMAP folder(s) and NNTP newsgroup(s).