Adjust the return type and value of EVP_MD_CTX_init(3)

and EVP_CIPHER_CTX_init(3) after tb@ changed these to OpenSSL 1.1 semantics
in evp.h rev. 1.124 on March 2 this year.

1 files changed, 8 insertions, 4 deletions

diff --git a/src/lib/libcrypto/man/EVP_CIPHER_CTX_init.3 b/src/lib/libcrypto/man/EVP_CIPHER_CTX_init.3
index f328fc05b2..79a8e540af 100644
--- a/src/lib/libcrypto/man/EVP_CIPHER_CTX_init.3
+++ b/src/lib/libcrypto/man/EVP_CIPHER_CTX_init.3
@@ -1,4 +1,4 @@
-.\" $OpenBSD: EVP_CIPHER_CTX_init.3,v 1.3 2023/12/26 22:13:00 schwarze Exp $
+.\" $OpenBSD: EVP_CIPHER_CTX_init.3,v 1.4 2024/12/06 15:01:01 schwarze Exp $
 .\" full merge up to:
 .\" OpenSSL EVP_EncryptInit.pod 0874d7f2 Oct 11 13:13:47 2022 +0100
 .\"
@@ -68,7 +68,7 @@
 .\" ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED
 .\" OF THE POSSIBILITY OF SUCH DAMAGE.
 .\"
-.Dd $Mdocdate: December 26 2023 $
+.Dd $Mdocdate: December 6 2024 $
 .Dt EVP_CIPHER_CTX_INIT 3
 .Os
 .Sh NAME
@@ -78,7 +78,7 @@
 .Nd obsolete EVP cipher functions
 .Sh SYNOPSIS
 .In openssl/evp.h
-.Ft void
+.Ft int
 .Fo EVP_CIPHER_CTX_init
 .Fa "EVP_CIPHER_CTX *ctx"
 .Fc
@@ -102,7 +102,8 @@ was made opaque.
 Calling it on a cipher context just returned from
 .Xr EVP_CIPHER_CTX_new 3
 has no effect.
-Calling it on a cipher context that was already used leaks memory.
+Calling it on a cipher context that was already used may leak memory
+with older versions of the library.
 Instead, use
 .Xr EVP_CIPHER_CTX_reset 3
 or
@@ -173,6 +174,9 @@ the overhead incurred by using
 .Xr EVP_CipherUpdate 3
 is minimal.
 .Sh RETURN VALUES
+.Fn EVP_CIPHER_CTX_init
+always returns 1.
+.Pp
 .Fn EVP_CIPHER_CTX_cleanup
 returns 1 for success or 0 for failure.
 .Pp