Home Explore Blog CI



git

3rd chunk of `Documentation/config/gc.adoc`
5010d2dc394da4a4bd2062c2152fb08c5ccc77c7a846cac30000000100000d6d
 the repository; see
	the "NOTES" section of linkgit:git-gc[1].

gc.worktreePruneExpire::
	When 'git gc' is run, it calls
	'git worktree prune --expire 3.months.ago'.
	This config variable can be used to set a different grace
	period. The value "now" may be used to disable the grace
	period and prune `$GIT_DIR/worktrees` immediately, or "never"
	may be used to suppress pruning.

gc.reflogExpire::
gc.<pattern>.reflogExpire::
	'git reflog expire' removes reflog entries older than
	this time; defaults to 90 days. The value "now" expires all
	entries immediately, and "never" suppresses expiration
	altogether. With "<pattern>" (e.g.
	"refs/stash") in the middle the setting applies only to
	the refs that match the <pattern>.

gc.reflogExpireUnreachable::
gc.<pattern>.reflogExpireUnreachable::
	'git reflog expire' removes reflog entries older than
	this time and are not reachable from the current tip;
	defaults to 30 days. The value "now" expires all entries
	immediately, and "never" suppresses expiration altogether.
	With "<pattern>" (e.g. "refs/stash")
	in the middle, the setting applies only to the refs that
	match the <pattern>.
+
These types of entries are generally created as a result of using `git
commit --amend` or `git rebase` and are the commits prior to the amend
or rebase occurring.  Since these changes are not part of the current
project most users will want to expire them sooner, which is why the
default is more aggressive than `gc.reflogExpire`.

gc.recentObjectsHook::
	When considering whether or not to remove an object (either when
	generating a cruft pack or storing unreachable objects as
	loose), use the shell to execute the specified command(s).
	Interpret their output as object IDs which Git will consider as
	"recent", regardless of their age. By treating their mtimes as
	"now", any objects (and their descendants) mentioned in the
	output will be kept regardless of their true age.
+
Output must contain exactly one hex object ID per line, and nothing
else. Objects which cannot be found in the repository are ignored.
Multiple hooks are supported, but all must exit successfully, else the
operation (either generating a cruft pack or unpacking unreachable
objects) will be halted.

gc.repackFilter::
	When repacking, use the specified filter to move certain
	objects into a separate packfile.  See the
	`--filter=<filter-spec>` option of linkgit:git-repack[1].

gc.repackFilterTo::
	When repacking and using a filter, see `gc.repackFilter`, the
	specified location will be used to create the packfile
	containing the filtered out objects. **WARNING:** The
	specified location should be accessible, using for example the
	Git alternates mechanism, otherwise the repo could be
	considered corrupt by Git as it might not be able to access the
	objects in that packfile. See the `--filter-to=<dir>` option
	of linkgit:git-repack[1] and the `objects/info/alternates`
	section of linkgit:gitrepository-layout[5].

gc.rerereResolved::
	Records of conflicted merge you resolved earlier are
	kept for this many days when 'git rerere gc' is run.
	You can also use more human-readable "1.month.ago", etc.
	The default is 60 days.  See linkgit:git-rerere[1].

gc.rerereUnresolved::
	Records of conflicted merge you have not resolved are
	kept for this many days when 'git rerere gc' is run.
	You can also use more human-readable "1.month.ago", etc.
	The default is 15 days.  See linkgit:git-rerere[1].

Title: Git Garbage Collection Configuration Options
Summary
This section describes various configuration options for Git's garbage collection, including settings for expiring reflog entries, pruning worktrees, and managing recent objects, as well as options for customizing repacking and resolving merge conflicts.