doc/rgw: add doc regarding bucket listing with pagination

Signed-off-by: Oguzhan Ozmen <oozmen@bloomberg.net>

diff --git a/PendingReleaseNotes b/PendingReleaseNotes
index 01184cf5419fd659d21b32ebdac1e967040ea92e..c08a80f56971894ab24bc2785fbd8f0c91b3504e 100644 (file)
--- a/PendingReleaseNotes
+++ b/PendingReleaseNotes
@@ -3,6 +3,10 @@
   very large namespaces.
 * RGW: Bucket Logging suppports creating log buckets in EC pools.
   Implicit logging object commits are now performed asynchronously.
+* RGW: radosgw-admin bucket list now supports pagination for versioned buckets by using
+  both --marker and --object-version options together (e.g., ``--marker=obj1 --object-version=abc123``).
+  This enables proper pagination through versioned bucket listings without duplicates or
+  infinite loops. For non-versioned buckets, use only --marker as before (backward compatible).
 * RGW: OpenSSL engine support is deprecated in favor of provider support.
   - Removed the `openssl_engine_opts` configuration option. OpenSSL engine configuration in string format is no longer supported.
   - Added the `openssl_conf` configuration option for loading specified providers as default providers.

diff --git a/doc/man/8/radosgw-admin.rst b/doc/man/8/radosgw-admin.rst
index 163dcc89e0d8811e49cb7b4a4982f84434b5c03a..c21daf56efd6b516370e0152f04618da126edc75 100644 (file)
--- a/doc/man/8/radosgw-admin.rst
+++ b/doc/man/8/radosgw-admin.rst
@@ -83,6 +83,10 @@ as follows:
   list its objects. Adding --allow-unordered
   removes the ordering requirement, possibly generating results more
   quickly for buckets with large number of objects.
+  Use --marker to paginate through object listings (requires ordered listing;
+  do not use with --allow-unordered). For versioned buckets, also specify
+  --object-version with the instance/version ID to resume from a specific version
+  (e.g., ``--marker=obj1 --object-version=abc123``).
 
 :command:`bucket limit check`
   Show bucket sharding stats.