RGW-GAP-LIST(8)

✨ NAME ✨

okay bestie, so rgw-gap-list — it's the Ceph manual page, section 8 — and what it does is list bucket index entries with damaged RADOS backing objects. yes. it's giving detective but for missing files. 🔍💅

---

🌸 SYNOPSIS 🌸

rgw-gap-list

that's it. no args in the synopsis. she's low maintenance like that. 🎀

---

🦋 DESCRIPTION 🦋

okay so rgw-gap-list is an EXPERIMENTAL RADOS gateway user administration utility. it makes a listing of bucket index entries that have missing backing RADOS objects. and here's the cute part — it puts the results and the intermediate files on the local filesystem rather than on the Ceph cluster itself, so it will not itself consume additional cluster storage. she's tidy. she's considerate. she doesn't eat your cluster's snacks. 🫶

in theory these gaps should not exist. but bestie. Ceph evolves rapidly, bugs do crop up, and they may result in bucket index entries that have missing RADOS objects — like when a delete operation does not fully complete. 💀 it happens. nobody's perfect.

behind the scenes it runs rados ls and radosgw-admin bucket radoslist ... and then produces a list of those entries that appear in the latter but not the former. those entries are presumed to be the gaps. fr fr that's the whole trick. ✨

Note: depending on the size of the pool(s) involved, this tool may be quite slow to produce its results. like, go make a snack slow. plan accordingly. 😭

---

💀 WARNINGS 💀

this utility is considered EXPERIMENTAL. that's it. that's the warning. she said it twice bc she means it. 🙈

---

💅 OPTIONS 💅

• -p pool — the RGW bucket data pool name. if this option is omitted, the pool name will be prompted during execution. multiple pools can be supplied as a space-separated double quoted list. yes queen, multi-pool. 👑
• -t temp_directory — this tool can produce large intermediate files. by default /tmp is used, but if the filesystem housing /tmp doesn't have sufficient free space, you can specify a different directory — one on a filesystem that does have sufficient free space. read that twice bestie. 🍓
• -m — use two (multiple) threads to speed up the run. multitasking. main character energy. ⚡

---

🌈 EXAMPLES 🌈

launch the tool:

$ rgw-gap-list -p default.rgw.buckets.data -t /home/super_admin/temp_files

look at her go. iconic. 🔥

---

⭐ AVAILABILITY ⭐

rgw-gap-list 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. go read it. it's giving educational. 📚✨

---

🎀 SEE ALSO 🎀

radosgw-admin(8) rgw-orphan-list(8)

---

💖 Copyright 💖

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

---

and that's the whole page bestie!! 🦋 source is dev, dated Aug 19, 2026 — no cap, that's literally when this was written. now go find those gaps. you got this. slay. 💜🌸✨