]> git.ipfire.org Git - thirdparty/git.git/commit
packed-backend: fsck should warn when "packed-refs" file is empty
authorshejialuo <shejialuo@gmail.com>
Wed, 14 May 2025 15:50:26 +0000 (23:50 +0800)
committerJunio C Hamano <gitster@pobox.com>
Wed, 14 May 2025 19:32:58 +0000 (12:32 -0700)
commit784ceccb91b82dc8a2c69ddd6f1f5ccc2e2f96f2
treec6883960664fa50821e8af5ffb42fb8b4504354e
parent6f84262c44a89851c3ae5a6e4c1a9d06b2068d75
packed-backend: fsck should warn when "packed-refs" file is empty

We assume the "packed-refs" won't be empty and instead has at least one
line in it (even when there are no refs packed, there is the file header
line). Because there is no terminating LF in the empty file, we will
report "packedRefEntryNotTerminated(ERROR)" to the user.

However, the runtime code paths would accept an empty "packed-refs"
file, for example, "create_snapshot" would simply return the "snapshot"
without checking the content of "packed-refs". So, we should skip
checking the content of "packed-refs" when it is empty during fsck.

After 694b7a1999 (repack_without_ref(): write peeled refs in the
rewritten file, 2013-04-22), we would always write a header into the
"packed-refs" file. So, versions of Git that are not too ancient never
write such an empty "packed-refs" file.

As an empty file often indicates a sign of a filesystem-level issue, the
way we want to resolve this inconsistency is not make everybody totally
silent but notice and report the anomaly.

Let's create a "FSCK_INFO" message id "EMPTY_PACKED_REFS_FILE" to report
to the users that "packed-refs" is empty.

Signed-off-by: shejialuo <shejialuo@gmail.com>
Signed-off-by: Junio C Hamano <gitster@pobox.com>
Documentation/fsck-msgids.adoc
fsck.h
refs/packed-backend.c
t/t0602-reffiles-fsck.sh