[Bug 1152405] Re: The BIO_should_retry manual page misdocuments the behavior of the BIO_should_read

[Adrien Nader]

Looking at the current documentation, these functions are described the
following way:

    BIO_should_read() is true if the cause of the condition is that the BIO
    has insufficient data to return. Check for readability and/or retry the
    last operation.
    
    BIO_should_write() is true if the cause of the condition is that the BIO
    has pending data to write. Check for writability and/or retry the
    last operation.

As far as I can tell, the documentation has been fixed (and improved) so
I'll mark this bug as Fix Released.


** Changed in: openssl (Ubuntu)
       Status: New => Fix Released

-- 
You received this bug notification because you are a member of Ubuntu
Foundations Bugs, which is subscribed to openssl in Ubuntu.
https://bugs.launchpad.net/bugs/1152405

Title:
  The BIO_should_retry manual page misdocuments the behavior of the
  BIO_should_read

Status in openssl package in Ubuntu:
  Fix Released

Bug description:
  The BIO_should_retry manual page contains this text:

      BIO_should_write() is true if the cause of the condition is that a
  BIO needs to read data.

  Many of the OpenSSL APIs are confusing enough that I could believe
  this is really true, but the manual page also says:

      BIO_should_read() is true if the cause of the condition is that a
  BIO needs to read data.

  I doubt that both BIO_should_read and BIO_should_write mean the BIO
  needs to read data.  Probably BIO_should_write means the BIO needs to
  write data.

To manage notifications about this bug go to:
https://bugs.launchpad.net/ubuntu/+source/openssl/+bug/1152405/+subscriptions