6
git-gc - Cleanup unnecessary files and optimize the local repository
15
Runs a number of housekeeping tasks within the current repository,
16
such as compressing file revisions (to reduce disk space and increase
17
performance) and removing unreachable objects which may have been
18
created from prior invocations of gitlink:git-add[1].
20
Users are encouraged to run this task on a regular basis within
21
each repository to maintain good disk space utilization and good
22
operating performance.
28
Usually `git-gc` packs refs, expires old reflog entries,
30
and removes old 'rerere' records. Removal
31
of unreferenced loose objects is an unsafe operation
32
while other git operations are in progress, so it is not
33
done by default. Pass this option if you want it, and only
34
when you know nobody else is creating new objects in the
35
repository at the same time (e.g. never use this option
42
The optional configuration variable 'gc.reflogExpire' can be
43
set to indicate how long historical entries within each branch's
44
reflog should remain available in this repository. The setting is
45
expressed as a length of time, for example '90 days' or '3 months'.
46
It defaults to '90 days'.
48
The optional configuration variable 'gc.reflogExpireUnreachable'
49
can be set to indicate how long historical reflog entries which
50
are not part of the current branch should remain available in
51
this repository. These types of entries are generally created as
52
a result of using `git commit \--amend` or `git rebase` and are the
53
commits prior to the amend or rebase occurring. Since these changes
54
are not part of the current project most users will want to expire
55
them sooner. This option defaults to '30 days'.
57
The optional configuration variable 'gc.rerereresolved' indicates
58
how long records of conflicted merge you resolved earlier are
59
kept. This defaults to 60 days.
61
The optional configuration variable 'gc.rerereunresolved' indicates
62
how long records of conflicted merge you have not resolved are
63
kept. This defaults to 15 days.
65
The optional configuration variable 'gc.packrefs' determines if
66
`git gc` runs `git-pack-refs`. Without the configuration, `git-pack-refs`
67
is not run in bare repositories by default, to allow older dumb-transport
68
clients fetch from the repository, but this will change in the future.
79
Written by Shawn O. Pearce <spearce@spearce.org>
83
Part of the gitlink:git[7] suite