1RGW-ORPHAN-LIST(8)                   Ceph                   RGW-ORPHAN-LIST(8)
2
3
4

NAME

6       rgw-orphan-list - list rados objects that are not indexed by rgw
7

SYNOPSIS

9       rgw-orphan-list
10
11

DESCRIPTION

13       rgw-orphan-list  is  an  EXPERIMENTAL RADOS gateway user administration
14       utility. It produces a listing of rados objects that are  not  directly
15       or  indirectly  referenced  through  the  bucket  indexes on a pool. It
16       places the results and  intermediate  files  on  the  local  filesystem
17       rather  than  on the ceph cluster itself, and therefore will not itself
18       consume additional cluster storage.
19
20       In theory orphans  should  not  exist.  However  because  ceph  evolves
21       rapidly,  bugs do crop up, and they may result in orphans that are left
22       behind.
23
24       In its current form this utility does not take any  command-line  argu‐
25       ments  or options. It will list the available pools and prompt the user
26       to enter the pool they would like to list orphans for.
27
28       Behind the scenes it runs rados ls and radosgw-admin  bucket  radoslist
29       ...  and produces a list of those entries that appear in the former but
30       not the latter. Those entries are presumed to be the orphans.
31

WARNINGS

33       This utility is currently considered EXPERIMENTAL.
34
35       This utility will produce false orphan entries  for  unindexed  buckets
36       since such buckets have no bucket indices that can provide the starting
37       point for tracing.
38

OPTIONS

40       At present there are no options.
41

EXAMPLES

43       Launch the tool:
44
45          $ rgw-orphan-list
46

AVAILABILITY

48       radosgw-admin is part of Ceph, a massively scalable, open-source,  dis‐
49       tributed  storage  system.   Please  refer to the Ceph documentation at
50       https://docs.ceph.com for more information.
51

SEE ALSO

53       radosgw-admin(8) ceph-diff-sorted(8)
54

56       2010-2023, Inktank Storage, Inc. and contributors. Licensed under  Cre‐
57       ative Commons Attribution Share Alike 3.0 (CC-BY-SA-3.0)
58
59
60
61
62dev                              Nov 15, 2023               RGW-ORPHAN-LIST(8)
Impressum