From 3b98e1573e2f38d8eadf42ebe9f34cb1f2a53d9d Mon Sep 17 00:00:00 2001
From: tb <tb@openbsd.org>
Date: Wed, 31 Aug 2022 14:27:34 +0000
Subject: [PATCH] Remove most mentions of contexts on the stack.

---
 lib/libcrypto/man/EVP_DigestInit.3  | 16 ++--------------
 lib/libcrypto/man/EVP_EncryptInit.3 | 11 ++---------
 2 files changed, 4 insertions(+), 23 deletions(-)

diff --git a/lib/libcrypto/man/EVP_DigestInit.3 b/lib/libcrypto/man/EVP_DigestInit.3
index b9aacf9e9f9..209ad0181bd 100644
--- a/lib/libcrypto/man/EVP_DigestInit.3
+++ b/lib/libcrypto/man/EVP_DigestInit.3
@@ -1,4 +1,4 @@
-.\" $OpenBSD: EVP_DigestInit.3,v 1.23 2022/03/31 17:27:16 naddy Exp $
+.\" $OpenBSD: EVP_DigestInit.3,v 1.24 2022/08/31 14:27:34 tb Exp $
 .\" full merge up to: OpenSSL 7f572e95 Dec 2 13:57:04 2015 +0000
 .\" selective merge up to: OpenSSL a95d7574 Jul 2 12:16:38 2017 -0400
 .\"
@@ -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: March 31 2022 $
+.Dd $Mdocdate: August 31 2022 $
 .Dt EVP_DIGESTINIT 3
 .Os
 .Sh NAME
@@ -267,8 +267,6 @@ cleans up
 and resets it to the state it had after
 .Fn EVP_MD_CTX_new ,
 such that it can be reused.
-It is also suitable for digest contexts on the stack that were
-used and are no longer needed.
 .Pp
 .Fn EVP_MD_CTX_free
 cleans up
@@ -316,11 +314,6 @@ is
 then the default implementation of digest
 .Fa type
 is used.
-If
-.Fa ctx
-points to an unused object on the stack, it must be initialized with
-.Fn EVP_MD_CTX_init
-before calling this function.
 .Pp
 .Fn EVP_DigestUpdate
 hashes
@@ -388,11 +381,6 @@ to
 .Fa out .
 This is useful if large amounts of data are to be hashed which only
 differ in the last few bytes.
-If
-.Fa out
-points to an unused object on the stack, it must be initialized with
-.Fn EVP_MD_CTX_init
-before calling this function.
 .Pp
 .Fn EVP_DigestInit
 is a deprecated function behaving like
diff --git a/lib/libcrypto/man/EVP_EncryptInit.3 b/lib/libcrypto/man/EVP_EncryptInit.3
index 47527925ba3..b4fbfa37302 100644
--- a/lib/libcrypto/man/EVP_EncryptInit.3
+++ b/lib/libcrypto/man/EVP_EncryptInit.3
@@ -1,4 +1,4 @@
-.\" $OpenBSD: EVP_EncryptInit.3,v 1.43 2022/03/31 17:27:16 naddy Exp $
+.\" $OpenBSD: EVP_EncryptInit.3,v 1.44 2022/08/31 14:27:34 tb Exp $
 .\" full merge up to: OpenSSL 5211e094 Nov 11 14:39:11 2014 -0800
 .\"   EVP_bf_cbc.pod EVP_cast5_cbc.pod EVP_idea_cbc.pod EVP_rc2_cbc.pod
 .\"   7c6d372a Nov 20 13:20:01 2018 +0000
@@ -71,7 +71,7 @@
 .\" ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED
 .\" OF THE POSSIBILITY OF SUCH DAMAGE.
 .\"
-.Dd $Mdocdate: March 31 2022 $
+.Dd $Mdocdate: August 31 2022 $
 .Dt EVP_ENCRYPTINIT 3
 .Os
 .Sh NAME
@@ -443,8 +443,6 @@ object itself, such that it can be reused for another series of calls to
 .Fn EVP_CipherUpdate ,
 and
 .Fn EVP_CipherFinal .
-It is also suitable for cipher contexts on the stack that were used
-and are no longer needed.
 .Fn EVP_CIPHER_CTX_cleanup
 is a deprecated alias for
 .Fn EVP_CIPHER_CTX_reset .
@@ -478,11 +476,6 @@ for encryption with cipher
 from
 .Vt ENGINE
 .Fa impl .
-If
-.Fa ctx
-points to an unused object on the stack, it must be initialized with
-.Fn EVP_MD_CTX_init
-before calling this function.
 .Fa type
 is normally supplied by a function such as
 .Xr EVP_aes_256_cbc 3 .
-- 
2.20.1