umoci-gc(1)(#)

💅 umoci-gc(1) — the glow-up your image layout deserves ✨

okay so bestie, welcome to umoci-gc, a little page from the umoci manual family. Written by Aleksa Sarai, way back in DECEMBER 2016, and it's still out here doing the lord's work fr fr. 🫶

---

🌸 NAME 🌸

umoci gc — Garbage collects all unreferenced OCI image blobs 💀✨

---

🎀 SYNOPSIS 🎀

umoci gc --layout=image

---

🦋 DESCRIPTION 🦋

So here's the vibe: umoci gc does a mark-and-sweep garbage collection on the OCI image you hand it. 🧹

It walks the descriptor paths starting from the root set of tags, marks everything it can reach, and only keeps those blobs. Everything else? Gone. Deleted. Removed. Not me being dramatic — that's literally what the manpage says, bestie. 😭

tl;dr: reachable blobs stay, unreachable blobs get swept away like they never existed. 👑

---

✨ OPTIONS ✨

The global options are defined in umoci(1) — go check that page for the shared stuff, iykyk. 💖

• --layout=image — The OCI image layout to be garbage collected. image must be a path to a valid OCI image. 🗂️ (Yes, it has to be valid, don't try to play games with a fake layout, it's giving chaos energy and not the cute kind.)

---

🌈 EXAMPLE 🌈

Here's the whole main-character moment: this deletes a tag from an OCI image and then cleanly conducts a garbage collection to clean up the remaining unused blobs. Obsessed. 🫧

% umoci rm --image image:sometag
% umoci gc --layout image

Real talk: step one removes the tag, step two sweeps up all the blobs that nobody's reaching anymore. That's it. That's the glow-up. 💅

---

💜 SEE ALSO 💜

• umoci(1)
• umoci-remove(1)

---

and that's the whole page, bestie! 🎀 Sending you off with the little footer tea: this is gc from the umoci manual, umoci-gc(1). Go forth and garbage collect, you absolute icon. 🌟🦋💖