.\" Man page generated from reStructuredText.
.
.
.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-ORPHAN-LIST" "8" "Oct 24, 2023" "dev" "Ceph"
.SH NAME
rgw-orphan-list \- list rados objects that are not indexed by rgw
.SH SYNOPSIS
.nf
\fBrgw\-orphan\-list\fP
.fi
.sp
.SH DESCRIPTION
.sp
\fBrgw\-orphan\-list\fP is an \fIEXPERIMENTAL\fP RADOS gateway user
administration utility. It produces a listing of rados objects that
are not directly or indirectly referenced through the bucket indexes
on a pool. It places the results and intermediate files on the local
filesystem rather than on the ceph cluster itself, and therefore will
not itself consume additional cluster storage.
.sp
In theory orphans should not exist. However because ceph evolves
rapidly, bugs do crop up, and they may result in orphans that are left
behind.
.sp
In its current form this utility does not take any command\-line
arguments or options. It will list the available pools and prompt the
user to enter the pool they would like to list orphans for.
.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
former but not the latter. Those entries are presumed to be the
orphans.
.SH WARNINGS
.sp
This utility is currently considered \fIEXPERIMENTAL\fP\&.
.sp
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.
.SH OPTIONS
.sp
At present there are no options.
.SH EXAMPLES
.sp
Launch the tool:
.INDENT 0.0
.INDENT 3.5
.sp
.EX
$ rgw\-orphan\-list
.EE
.UNINDENT
.UNINDENT
.SH AVAILABILITY
.sp
\fBradosgw\-admin\fP is part of Ceph, a massively scalable, open\-source,
distributed storage system.  Please refer to the Ceph documentation at
\fI\%https://docs.ceph.com\fP for more information.
.SH SEE ALSO
.sp
\fI\%radosgw\-admin\fP(8)
\fI\%ceph\-diff\-sorted\fP(8)
.SH COPYRIGHT
2010-2023, Inktank Storage, Inc. and contributors. Licensed under Creative Commons Attribution Share Alike 3.0 (CC-BY-SA-3.0)
.\" Generated by docutils manpage writer.
.