]> git.ipfire.org Git - thirdparty/git.git/commit
gc: add `--expire-to` option
authorZheNing Hu <adlternative@gmail.com>
Fri, 24 Jan 2025 07:49:14 +0000 (07:49 +0000)
committerJunio C Hamano <gitster@pobox.com>
Fri, 24 Jan 2025 22:32:28 +0000 (14:32 -0800)
commit08032fa30fefa3101bec4b774e79f4d091b516a6
tree6f65295cbde9d938e56d8ad94568dcb3becf18be
parent92999a42db1c5f43f330e4f2bca4026b5b81576f
gc: add `--expire-to` option

This commit extends the functionality of `git gc`
by adding a new option, `--expire-to=<dir>`. Previously,
this feature was implemented in 91badeba32 (builtin/repack.c:
implement `--expire-to` for storing pruned objects, 2022-10-24),
which allowing users to specify a directory where unreachable
and expired cruft packs are stored during garbage collection.
However, users had to run `git repack --cruft --expire-to=<dir>`
followed by `git prune` to achieve similar results within `git gc`.

By introducing `--expire-to=<dir>` directly into `git gc`,
we simplify the process for users who wish to manage their
repository's cleanup more efficiently. This change involves
passing the `--expire-to=<dir>` parameter through to `git repack`,
making it easier for users to set up a backup location for cruft
packs that will be pruned.

Due to the original `git gc --prune=now` deleting all unreachable
objects by passing the `-a` parameter to git repack. With the
addition of the `--cruft` and `--expire-to` options, it is necessary
to modify this default behavior: instead of deleting these
unreachable objects, they should be merged into a cruft pack and
collected in a specified directory. Therefore, we do not pass `-a`
to the repack command but instead pass `--cruft`, `--expire-to`,
and `--cruft-expiration=now` to repack.

Signed-off-by: ZheNing Hu <adlternative@gmail.com>
Signed-off-by: Junio C Hamano <gitster@pobox.com>
Documentation/git-gc.txt
builtin/gc.c
t/t6500-gc.sh