.\" Man page generated from reStructuredText
.\" by the Docutils 0.23 manpage writer.
.
.
.nr rst2man-indent-level 0
.
.de1 rstReportMargin
\\$1 \\n[an-margin]
level \\n[rst2man-indent-level]
level margin: \\n[rst2man-indent\\n[rst2man-indent-level]]
-
\\n[rst2man-indent0]
\\n[rst2man-indent1]
\\n[rst2man-indent2]
..
.de1 INDENT
.\" .rstReportMargin pre:
. RS \\$1
. nr rst2man-indent\\n[rst2man-indent-level] \\n[an-margin]
. nr rst2man-indent-level +1
.\" .rstReportMargin post:
..
.de UNINDENT
. RE
.\" indent \\n[an-margin]
.\" old: \\n[rst2man-indent\\n[rst2man-indent-level]]
.nr rst2man-indent-level -1
.\" new: \\n[rst2man-indent\\n[rst2man-indent-level]]
.in \\n[rst2man-indent\\n[rst2man-indent-level]]u
..
.TH "RGW-GAP-LIST" "8" "Oct 09, 2026" "dev" "Ceph"
.SH NAME
rgw-gap-list \- List bucket index entries with damaged RADOS backing objects
.SH SYNOPSIS
.nf
\fBrgw\-gap\-list\fP
.fi
.sp
.SH DESCRIPTION
.sp
\fBrgw\-gap\-list\fP is an \fIEXPERIMENTAL\fP RADOS gateway user
administration utility. It produces a listing of bucket index entries
that have missing backing RADOS objects. It places the results and
intermediate files on a local filesystem rather than on the Ceph
cluster itself, and therefore will not itself consume additional
cluster storage.
.sp
In theory these gaps should not exist. However because Ceph evolves
rapidly, bugs do crop up, and they may result in bucket index entries
that have missing RADOS objects, such as when a delete operation does
not fully complete.
.sp
Behind the scenes it runs \fIrados ls\fP and \fIradosgw\-admin bucket
radoslist ...\fP and produces a list of those entries that appear in the
latter but not the former. Those entries are presumed to be the
gaps.
.sp
Note: Depending on the size of the pool(s) involved, this tool may be
quite slow to produce its results.
.SH WARNINGS
.sp
This utility is considered \fIEXPERIMENTAL\fP\&.
.SH OPTIONS
.INDENT 0.0
.TP
.B \-p pool
The RGW bucket data pool name. If option omitted the pool name will
be prompted during execution. Multiple pools can be supplied as a
space\-separated double quoted list.
.UNINDENT
.INDENT 0.0
.TP
.B \-t temp_directory
The tool can produce large intermediate files. By default \fB/tmp\fP
is used, but if the filesystem housing \fB/tmp\fP doesn\(aqt have
sufficient free space, a different directory (on a filesystem with
sufficient free space) can be specified.
.UNINDENT
.INDENT 0.0
.TP
.B \-m
Use two (multiple) threads to speed up the run.
.UNINDENT
.SH EXAMPLES
.sp
Launch the tool:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
$ rgw\-gap\-list \-p default.rgw.buckets.data \-t /home/super_admin/temp_files
.EE
.UNINDENT
.UNINDENT
.SH AVAILABILITY
.sp
\fBrgw\-gap\-list\fP 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.
.SH SEE ALSO
.sp
radosgw\-admin \%<>(8)
rgw\-orphan\-list \%<>(8)
.SH Copyright
2010-2014, Inktank Storage, Inc. and contributors. Licensed under Creative Commons Attribution Share Alike 3.0 (CC-BY-SA-3.0)
.\" End of generated man page.