Project

General

Profile

Documentation #20119

Documentation of Python RBD API does not say that aio_* functions call their callbacks in DIFFERENT (dummy) thread

Added by Марк Коренберг about 4 years ago. Updated over 1 year ago.

Status:
Closed
Priority:
Low
Assignee:
-
Target version:
% Done:

0%

Tags:
Backport:
Reviewed:
Affected Versions:
Pull request ID:

Description

Documentation of Python RBD API does not say that aio_* functions call their callbacks in DIFFERENT (dummy) thread

Everyone must know that special behavior. For example, next Python code (very stupid one, but just to show) will actually not hang:

count = [2]
def cb(*args):
    count[0] -= 1
ceph_image.aio_read(offset1, length1, cb)
ceph_image.aio_read(offset2, length2, cb)

while count[0]:
    time.sleep(0.1)

History

#1 Updated by Марк Коренберг about 4 years ago

also, exceptions are silently ignored from these callbacks!

#2 Updated by Марк Коренберг about 4 years ago

Also it does not say, that `data` argument may be None, which signs error of read operation (I'm not sure, figured out that while reading sources)

#3 Updated by Nathan Cutler about 4 years ago

  • Tracker changed from Bug to Documentation
  • Project changed from Ceph to rbd

#4 Updated by Jason Dillaman about 4 years ago

  • Priority changed from Normal to Low

#5 Updated by Zac Dover over 1 year ago

  • Status changed from New to Closed

This bug has been judged too old to fix. This is because either it is either 1) raised against a version of Ceph prior to Luminous, or 2) just really old, and untouched for so long that it is unlikely nowadays to represent a live documentation concern.

If you think that the closing of this bug is an error, raise another bug of a similar kind. If you think that the matter requires urgent attention, please let Zac Dover know at .

Also available in: Atom PDF