From: Sage Weil Date: Thu, 2 Feb 2017 23:25:18 +0000 (-0500) Subject: PendingReleaseNotes: notes about object listing API removal X-Git-Tag: v12.0.1~413^2 X-Git-Url: http://git-server-git.apps.pok.os.sepia.ceph.com/?a=commitdiff_plain;h=refs%2Fpull%2F13149%2Fhead;p=ceph.git PendingReleaseNotes: notes about object listing API removal Signed-off-by: Sage Weil --- 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.) +