From c1ff854f9284d7deec995d90e71ae7fd844a5d06 Mon Sep 17 00:00:00 2001 From: Sage Weil Date: Thu, 2 Feb 2017 18:25:18 -0500 Subject: [PATCH] PendingReleaseNotes: notes about object listing API removal Signed-off-by: Sage Weil --- PendingReleaseNotes | 21 +++++++++++++++++++++ 1 file changed, 21 insertions(+) diff --git a/PendingReleaseNotes b/PendingReleaseNotes index 8b94202b635fc..7189e68f920ee 100644 --- a/PendingReleaseNotes +++ b/PendingReleaseNotes @@ -45,3 +45,24 @@ still works. See the documentation page "Mount CephFS in your file systems table" for details. + +12.0.1 +------ + +* The original librados rados_objects_list_open (C) and objects_begin + (C++) object listing API, deprecated in Hammer, has finally been + removed. Users of this interface must update their software to use + either the rados_nobjects_list_open (C) and nobjects_begin (C++) API or + the new rados_object_list_begin (C) and object_list_begin (C++) API + before updating the client-side librados library to Luminous. + + Object enumeration (via any API) with the latest librados version + and pre-Hammer OSDs is no longer supported. Note that no in-tree + Ceph services rely on object enumeration via the deprecated APIs, so + only external librados users might be affected. + + The newest (and recommended) rados_object_list_begin (C) and + object_list_begin (C++) API is only usable on clusters with the + SORTBITWISE flag enabled (Jewel and later). (Note that this flag is + required to be set before upgrading beyond Jewel.) + -- 2.47.3