RepoMirrors
/
go-ceph
mirror of https://github.com/ceph/go-ceph
1
0
Fork 0
Code Issues Packages Projects Releases Wiki Activity

rbd: promote lock apis to stable 

Signed-off-by: John Mulligan <jmulligan@redhat.com>
This commit is contained in:
John Mulligan 2023-10-03 10:06:08 -04:00 committed by mergify[bot]
parent ca6ee13435
commit 70ddb1dbea
4 changed files with 12 additions and 23 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

17
docs/api-status.json
View File

@ -1894,40 +1894,39 @@
"comment": "SparsifyWithProgress makes an image sparse by deallocating runs of zeros.\nThe sparseSize value will be used to find runs of zeros and must be\na power of two no less than 4096 and no larger than the image size.\nThe given progress callback will be called to report on the progress\nof sparse. The operation will be aborted if the progress callback returns\na non-zero value.\n\nImplements:\n\n\tint rbd_sparsify_with_progress(rbd_image_t image, size_t sparse_size,\n\t\t\t\t\t\t\t\t librbd_progress_fn_t cb, void *cbdata);\n", "comment": "SparsifyWithProgress makes an image sparse by deallocating runs of zeros.\nThe sparseSize value will be used to find runs of zeros and must be\na power of two no less than 4096 and no larger than the image size.\nThe given progress callback will be called to report on the progress\nof sparse. The operation will be aborted if the progress callback returns\na non-zero value.\n\nImplements:\n\n\tint rbd_sparsify_with_progress(rbd_image_t image, size_t sparse_size,\n\t\t\t\t\t\t\t\t librbd_progress_fn_t cb, void *cbdata);\n",
"added_in_version": "v0.21.0", "added_in_version": "v0.21.0",
"became_stable_version": "v0.23.0" "became_stable_version": "v0.23.0"
} },
],
"preview_api": [
{ {
"name": "Image.LockAcquire", "name": "Image.LockAcquire",
"comment": "LockAcquire takes a lock on the given image as per the provided lock_mode.\n\nImplements:\n\n\tint rbd_lock_acquire(rbd_image_t image, rbd_lock_mode_t lock_mode);\n", "comment": "LockAcquire takes a lock on the given image as per the provided lock_mode.\n\nImplements:\n\n\tint rbd_lock_acquire(rbd_image_t image, rbd_lock_mode_t lock_mode);\n",
"added_in_version": "v0.22.0", "added_in_version": "v0.22.0",
"expected_stable_version": "v0.24.0" "became_stable_version": "v0.24.0"
}, },
{ {
"name": "Image.LockBreak", "name": "Image.LockBreak",
"comment": "LockBreak breaks the lock of lock_mode on the provided lock_owner.\n\nImplements:\n\n\tint rbd_lock_break(rbd_image_t image, rbd_lock_mode_t lock_mode,\n\t\t\t\t\t const char *lock_owner);\n", "comment": "LockBreak breaks the lock of lock_mode on the provided lock_owner.\n\nImplements:\n\n\tint rbd_lock_break(rbd_image_t image, rbd_lock_mode_t lock_mode,\n\t\t\t\t\t const char *lock_owner);\n",
"added_in_version": "v0.22.0", "added_in_version": "v0.22.0",
"expected_stable_version": "v0.24.0" "became_stable_version": "v0.24.0"
}, },
{ {
"name": "Image.LockGetOwners", "name": "Image.LockGetOwners",
"comment": "LockGetOwners fetches the list of lock owners.\n\nImplements:\n\n\tint rbd_lock_get_owners(rbd_image_t image, rbd_lock_mode_t *lock_mode,\n\t\t\t\t\t\t\tchar **lock_owners, size_t *max_lock_owners);\n", "comment": "LockGetOwners fetches the list of lock owners.\n\nImplements:\n\n\tint rbd_lock_get_owners(rbd_image_t image, rbd_lock_mode_t *lock_mode,\n\t\t\t\t\t\t\tchar **lock_owners, size_t *max_lock_owners);\n",
"added_in_version": "v0.22.0", "added_in_version": "v0.22.0",
"expected_stable_version": "v0.24.0" "became_stable_version": "v0.24.0"
}, },
{ {
"name": "Image.LockIsExclusiveOwner", "name": "Image.LockIsExclusiveOwner",
"comment": "LockIsExclusiveOwner gets the status of the image exclusive lock.\n\nImplements:\n\n\tint rbd_is_exclusive_lock_owner(rbd_image_t image, int *is_owner);\n", "comment": "LockIsExclusiveOwner gets the status of the image exclusive lock.\n\nImplements:\n\n\tint rbd_is_exclusive_lock_owner(rbd_image_t image, int *is_owner);\n",
"added_in_version": "v0.22.0", "added_in_version": "v0.22.0",
"expected_stable_version": "v0.24.0" "became_stable_version": "v0.24.0"
}, },
{ {
"name": "Image.LockRelease", "name": "Image.LockRelease",
"comment": "LockRelease releases a lock on the image.\n\nImplements:\n\n\tint rbd_lock_release(rbd_image_t image);\n", "comment": "LockRelease releases a lock on the image.\n\nImplements:\n\n\tint rbd_lock_release(rbd_image_t image);\n",
"added_in_version": "v0.22.0", "added_in_version": "v0.22.0",
"expected_stable_version": "v0.24.0" "became_stable_version": "v0.24.0"
} }
] ],
"preview_api": []
}, },
"rbd/admin": { "rbd/admin": {
"stable_api": [ "stable_api": [

10
docs/api-status.md
View File

@ -27,16 +27,6 @@ No Preview/Deprecated APIs found. All APIs are considered stable.
## Package: rbd ## Package: rbd
### Preview APIs
Name | Added in Version | Expected Stable Version |
---- | ---------------- | ----------------------- |
Image.LockAcquire | v0.22.0 | v0.24.0 |
Image.LockBreak | v0.22.0 | v0.24.0 |
Image.LockGetOwners | v0.22.0 | v0.24.0 |
Image.LockIsExclusiveOwner | v0.22.0 | v0.24.0 |
Image.LockRelease | v0.22.0 | v0.24.0 |
### Deprecated APIs ### Deprecated APIs
Name | Deprecated in Version | Expected Removal Version | Name | Deprecated in Version | Expected Removal Version |

4
rbd/locks.go
View File

@ -1,5 +1,5 @@
//go:build !nautilus && ceph_preview //go:build !nautilus
// +build !nautilus,ceph_preview // +build !nautilus
package rbd package rbd

4
rbd/locks_test.go
View File

@ -1,5 +1,5 @@
//go:build !nautilus && ceph_preview //go:build !nautilus
// +build !nautilus,ceph_preview // +build !nautilus
package rbd package rbd