2 The depth parameter used in the delta compression
3 algorithm used by 'git gc --aggressive'. This defaults
4 to 50, which is the default for the `--depth` option when
5 `--aggressive` isn't in use.
7 See the documentation for the `--depth` option in
8 linkgit:git-repack[1] for more details.
11 The window size parameter used in the delta compression
12 algorithm used by 'git gc --aggressive'. This defaults
13 to 250, which is a much more aggressive window size than
14 the default `--window` of 10.
16 See the documentation for the `--window` option in
17 linkgit:git-repack[1] for more details.
20 When there are approximately more than this many loose
21 objects in the repository, `git gc --auto` will pack them.
22 Some Porcelain commands use this command to perform a
23 light-weight garbage collection from time to time. The
24 default value is 6700.
26 Setting this to 0 disables not only automatic packing based on the
27 number of loose objects, but any other heuristic `git gc --auto` will
28 otherwise use to determine if there's work to do, such as
32 When there are more than this many packs that are not
33 marked with `*.keep` file in the repository, `git gc
34 --auto` consolidates them into one larger pack. The
35 default value is 50. Setting this to 0 disables it.
36 Setting `gc.auto` to 0 will also disable this.
38 See the `gc.bigPackThreshold` configuration variable below. When in
39 use, it'll affect how the auto pack limit works.
42 Make `git gc --auto` return immediately and run in background
43 if the system supports it. Default is true.
46 If non-zero, all non-cruft packs larger than this limit are kept
47 when `git gc` is run. This is very similar to
48 `--keep-largest-pack` except that all non-cruft packs that meet
49 the threshold are kept, not just the largest pack. Defaults to
50 zero. Common unit suffixes of 'k', 'm', or 'g' are supported.
52 Note that if the number of kept packs is more than gc.autoPackLimit,
53 this configuration variable is ignored, all packs except the base pack
54 will be repacked. After this the number of packs should go below
55 gc.autoPackLimit and gc.bigPackThreshold should be respected again.
57 If the amount of memory estimated for `git repack` to run smoothly is
58 not available and `gc.bigPackThreshold` is not set, the largest pack
59 will also be excluded (this is the equivalent of running `git gc` with
60 `--keep-largest-pack`).
63 If true, then gc will rewrite the commit-graph file when
64 linkgit:git-gc[1] is run. When using `git gc --auto`
65 the commit-graph will be updated if housekeeping is
66 required. Default is true. See linkgit:git-commit-graph[1]
70 If the file gc.log exists, then `git gc --auto` will print
71 its content and exit with status zero instead of running
72 unless that file is more than 'gc.logExpiry' old. Default is
73 "1.day". See `gc.pruneExpire` for more ways to specify its
77 Running `git pack-refs` in a repository renders it
78 unclonable by Git versions prior to 1.5.1.2 over dumb
79 transports such as HTTP. This variable determines whether
80 'git gc' runs `git pack-refs`. This can be set to `notbare`
81 to enable it within all non-bare repos or it can be set to a
82 boolean value. The default is `true`.
85 Store unreachable objects in a cruft pack (see
86 linkgit:git-repack[1]) instead of as loose objects. The default
90 Limit the size of new cruft packs when repacking. When
91 specified in addition to `--max-cruft-size`, the command line
92 option takes priority. See the `--max-cruft-size` option of
93 linkgit:git-repack[1].
96 When 'git gc' is run, it will call 'prune --expire 2.weeks.ago'
97 (and 'repack --cruft --cruft-expiration 2.weeks.ago' if using
98 cruft packs via `gc.cruftPacks` or `--cruft`). Override the
99 grace period with this config variable. The value "now" may be
100 used to disable this grace period and always prune unreachable
101 objects immediately, or "never" may be used to suppress pruning.
102 This feature helps prevent corruption when 'git gc' runs
103 concurrently with another process writing to the repository; see
104 the "NOTES" section of linkgit:git-gc[1].
106 gc.worktreePruneExpire::
107 When 'git gc' is run, it calls
108 'git worktree prune --expire 3.months.ago'.
109 This config variable can be used to set a different grace
110 period. The value "now" may be used to disable the grace
111 period and prune `$GIT_DIR/worktrees` immediately, or "never"
112 may be used to suppress pruning.
115 gc.<pattern>.reflogExpire::
116 'git reflog expire' removes reflog entries older than
117 this time; defaults to 90 days. The value "now" expires all
118 entries immediately, and "never" suppresses expiration
119 altogether. With "<pattern>" (e.g.
120 "refs/stash") in the middle the setting applies only to
121 the refs that match the <pattern>.
123 gc.reflogExpireUnreachable::
124 gc.<pattern>.reflogExpireUnreachable::
125 'git reflog expire' removes reflog entries older than
126 this time and are not reachable from the current tip;
127 defaults to 30 days. The value "now" expires all entries
128 immediately, and "never" suppresses expiration altogether.
129 With "<pattern>" (e.g. "refs/stash")
130 in the middle, the setting applies only to the refs that
133 These types of entries are generally created as a result of using `git
134 commit --amend` or `git rebase` and are the commits prior to the amend
135 or rebase occurring. Since these changes are not part of the current
136 project most users will want to expire them sooner, which is why the
137 default is more aggressive than `gc.reflogExpire`.
139 gc.recentObjectsHook::
140 When considering whether or not to remove an object (either when
141 generating a cruft pack or storing unreachable objects as
142 loose), use the shell to execute the specified command(s).
143 Interpret their output as object IDs which Git will consider as
144 "recent", regardless of their age. By treating their mtimes as
145 "now", any objects (and their descendants) mentioned in the
146 output will be kept regardless of their true age.
148 Output must contain exactly one hex object ID per line, and nothing
149 else. Objects which cannot be found in the repository are ignored.
150 Multiple hooks are supported, but all must exit successfully, else the
151 operation (either generating a cruft pack or unpacking unreachable
152 objects) will be halted.
155 Records of conflicted merge you resolved earlier are
156 kept for this many days when 'git rerere gc' is run.
157 You can also use more human-readable "1.month.ago", etc.
158 The default is 60 days. See linkgit:git-rerere[1].
160 gc.rerereUnresolved::
161 Records of conflicted merge you have not resolved are
162 kept for this many days when 'git rerere gc' is run.
163 You can also use more human-readable "1.month.ago", etc.
164 The default is 15 days. See linkgit:git-rerere[1].