bup-valida...bject-links(1)

✨ NAME ✨

bup-validate-object-links — bestie, this is the one that scans your whole repository looking for broken object links 💅

---

🌸 SYNOPSIS 🌸

bup validate-object-links

---

🦋 DESCRIPTION 🦋

okay so here's the vibe: bup validate-object-links goes through all the objects in your repository and calls out any reference that's pointing at an object that straight up does not exist in the repo. like, a tree or a commit says "hey go look at this object" and the object is just… not there. ghosted. 💀

So it's checking references from a tree or a commit to an object, and reporting the ones that are missing.

Now for the lowkey important caveats, and bestie I need you to actually read these:

• Right now it does not scan "loose objects" (those that aren't in packfiles), and it also doesn't notice them when it's checking for existence.
• It cannot handle tag objects. Nope. Not happening. 🙈
• Little note though: bup itself doesn't create tags or loose objects — but git absolutely may, so don't come for bup about it.
• The existence check only consults the repository indexes. It does not try to actually read the object. So if your index is incorrect, the check can be misled by it. iykyk. be aware. ⚠️

Whenever it finds a broken link (i.e. a missing reference), it prints an ASCII-encoded line to standard output that looks exactly like this:

no MISSING_HASH for PARENT_HASH

periodt. that's the whole report format. 💖

---

🎀 EXIT STATUS 🎀

• 1 — if any broken links are found 😭 (she found something)
• 0 — if none are found ✨ (clean, flawless, main character energy)
• some other positive integer — for other failures 👑

---

🌈 SEE ALSO 🌈

• bup-fsck(1)

---

👑 BUP 👑

Part of the bup(1) suite. 🫶

---

💜 AUTHORS 💜

Rob Browning rlb@defaultvalue.org

---

and that's the whole page bestie, no cap — this little icon comes to you from Bup 0.34, dated 2026-09-01, and it's giving bup-validate-object-links(1) in the General Commands Manual. slay 💅✨🌸