aboutsummaryrefslogtreecommitdiffstats
path: root/Documentation/git-multi-pack-index.txt
diff options
context:
space:
mode:
authorTaylor Blau <me@ttaylorr.com>2022-09-19 21:55:45 -0400
committerJunio C Hamano <gitster@pobox.com>2022-09-21 10:21:46 -0700
commit757d457907e3efa8eb911b772a690661cd432da5 (patch)
treeda72c1039bf57797827ec30ec265a494cf6305c0 /Documentation/git-multi-pack-index.txt
parent2a91b35fce7284ed480e92d1bd08c774e6a9a270 (diff)
downloadgit-757d457907e3efa8eb911b772a690661cd432da5.tar.gz
midx.c: prevent `expire` from removing the cruft pack
The `expire` sub-command unlinks any packs that are (a) contained in the MIDX, but (b) have no objects referenced by the MIDX. This sub-command ignores `.keep` packs, which remain on-disk even if they have no objects referenced by the MIDX. Cruft packs, however, aren't given the same treatment: if none of the objects contained in the cruft pack are selected from the cruft pack by the MIDX, then the cruft pack is eligible to be expired. This is less than desireable, since the cruft pack has important metadata about the individual object mtimes, which is useful to determine how quickly an object should age out of the repository when pruning. Ordinarily, we wouldn't expect the contents of a cruft pack to duplicated across non-cruft packs (and we'd expect to see the MIDX select all cruft objects from other sources even less often). But nonetheless, it is still possible to trick the `expire` sub-command into removing the `.mtimes` file in this circumstance. Teach the `expire` sub-command to ignore cruft packs in the same manner as it does `.keep` packs, in order to keep their metadata around, even when they are unreferenced by the MIDX. Signed-off-by: Taylor Blau <me@ttaylorr.com> Signed-off-by: Junio C Hamano <gitster@pobox.com>
Diffstat (limited to 'Documentation/git-multi-pack-index.txt')
-rw-r--r--Documentation/git-multi-pack-index.txt4
1 files changed, 2 insertions, 2 deletions
diff --git a/Documentation/git-multi-pack-index.txt b/Documentation/git-multi-pack-index.txt
index 11e6dc53e3..3696506eb3 100644
--- a/Documentation/git-multi-pack-index.txt
+++ b/Documentation/git-multi-pack-index.txt
@@ -72,8 +72,8 @@ verify::
expire::
Delete the pack-files that are tracked by the MIDX file, but
have no objects referenced by the MIDX (with the exception of
- `.keep` packs). Rewrite the MIDX file afterward to remove all
- references to these pack-files.
+ `.keep` packs and cruft packs). Rewrite the MIDX file afterward
+ to remove all references to these pack-files.
repack::
Create a new pack-file containing objects in small pack-files