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

[Jean-Paul Calderone]

Public bug reported:

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.

** Affects: openssl (Ubuntu)
     Importance: Undecided
         Status: New

-- 
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:
  New

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