RGW-ORPHAN-LIST(8)

💖 RGW-ORPHAN-LIST 💖 (that's the rgw-orphan-list page, section 8, bestie)

okay so picture this: you're deep in your Ceph era and you need to know which rados objects are just... out there. Unclaimed. Unindexed. Orphaned. This is the page for that. Sit down, hydrate, let's go 🫶

---

✨ NAME ✨

rgw-orphan-list — list rados objects that are not indexed by rgw

---

🌸 SYNOPSIS 🌸

rgw-orphan-list

That's it. That's the whole thing. No flags, no args, no notes. She's low maintenance. 💅

---

🦋 DESCRIPTION 🦋

so rgw-orphan-list is an EXPERIMENTAL RADOS gateway user administration utility. Capital letters EXPERIMENTAL, like it's wearing a little "handle with care" sticker. Keep that in mind, bestie.

What she does: she produces a listing of rados objects that are not directly or indirectly referenced through the bucket indexes on a pool. Translation: objects that nothing in the bucket index points to. Floating. Unmoored. Not invited to the group chat.

She puts the results and all the intermediate files on the local filesystem, not on the ceph cluster itself. So the way this works is, she does not herself consume additional cluster storage. She's a considerate queen, she brings her own snacks 🍓

Now, in theory? Orphans should not exist. In theory. But ceph evolves rapidly, bugs do crop up, and sometimes those bugs result in orphans that are left behind. It's giving "you left me on read but make it object storage." 😭

In its current form this utility does not take any command-line arguments or options. Instead, she will list the available pools and prompt the user to enter the pool they would like to list orphans for. Very interactive. Very "what do you want, babes."

Behind the scenes it runs rados ls and radosgw-admin bucket radoslist ... and produces a list of those entries that appear in the former but not the latter. Those entries are presumed to be the orphans. Periodt.

---

⚠️ WARNINGS ⚠️

This utility is currently considered EXPERIMENTAL. Not me stressing the word EXPERIMENTAL twice in one page, but here we are. 💀

This utility will produce false orphan entries for unindexed buckets, since such buckets have no bucket indices that can provide the starting point for tracing. So if you're looking at unindexed buckets, those "orphans" are lies and the tool is not being shady on purpose, it literally just has nothing to trace from. 🙈

---

🎀 OPTIONS 🎀

At present there are no options.

That's the whole section. She's got zero flags. Not one. An icon of minimalism. 👑

---

🌈 EXAMPLES 🌈

Launch the tool:

$ rgw-orphan-list

Run it, pick your pool, get your list. Slay. ✨

---

💜 AVAILABILITY 💜

radosgw-admin is part of Ceph, a massively scalable, open-source, distributed storage system. Please refer to the Ceph documentation at <https://docs.ceph.com> for more information.

---

👑 SEE ALSO 👑

• radosgw-admin(8)
• ceph-diff-sorted(8)

---

🧚 Copyright 🧚

2010-2014, Inktank Storage, Inc. and contributors. Licensed under Creative Commons Attribution Share Alike 3.0 (CC-BY-SA-3.0)

---

okay that's the whole page, you're fully caught up. this beauty comes to you from the dev manual, dated Aug 19, 2026, and yeah, that's your RGW-ORPHAN-LIST(8) bestie signing off. go find those orphans, but maybe not in production yet, okay? love u, bye 💖✨🎀