Update for HMAC_CTX_{init,cleanup} hand HMAC_cleanup removal
authortb <tb@openbsd.org>
Sat, 15 Jan 2022 09:14:40 +0000 (09:14 +0000)
committertb <tb@openbsd.org>
Sat, 15 Jan 2022 09:14:40 +0000 (09:14 +0000)
lib/libcrypto/man/HMAC.3

index b76d8b2..3b8da92 100644 (file)
@@ -1,4 +1,4 @@
-.\" $OpenBSD: HMAC.3,v 1.17 2020/06/24 16:06:27 schwarze Exp $
+.\" $OpenBSD: HMAC.3,v 1.18 2022/01/15 09:14:40 tb Exp $
 .\" full merge up to: OpenSSL crypto/hmac a528d4f0 Oct 27 13:40:11 2015 -0400
 .\" selective merge up to: OpenSSL man3/HMAC b3696a55 Sep 2 09:35:50 2017 -0400
 .\"
@@ -52,7 +52,7 @@
 .\" ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED
 .\" OF THE POSSIBILITY OF SUCH DAMAGE.
 .\"
-.Dd $Mdocdate: June 24 2020 $
+.Dd $Mdocdate: January 15 2022 $
 .Dt HMAC 3
 .Os
 .Sh NAME
@@ -60,9 +60,6 @@
 .Nm HMAC_CTX_new ,
 .Nm HMAC_CTX_reset ,
 .Nm HMAC_CTX_free ,
-.Nm HMAC_CTX_init ,
-.Nm HMAC_CTX_cleanup ,
-.Nm HMAC_cleanup ,
 .Nm HMAC_Init_ex ,
 .Nm HMAC_Init ,
 .Nm HMAC_Update ,
 .Fo HMAC_CTX_free
 .Fa "HMAC_CTX *ctx"
 .Fc
-.Ft void
-.Fo HMAC_CTX_init
-.Fa "HMAC_CTX *ctx"
-.Fc
-.Ft void
-.Fo HMAC_CTX_cleanup
-.Fa "HMAC_CTX *ctx"
-.Fc
-.Ft void
-.Fo HMAC_cleanup
-.Fa "HMAC_CTX *ctx"
-.Fc
 .Ft int
 .Fo HMAC_Init_ex
 .Fa "HMAC_CTX *ctx"
@@ -212,34 +197,6 @@ releases any associated resources, and finally frees
 .Fa ctx
 itself.
 .Pp
-.Fn HMAC_CTX_init
-is a deprecated function to initialize an empty
-.Vt HMAC_CTX
-object, similar to
-.Fn CTX_new
-but without the allocation.
-Calling it is required for static objects and objects on the stack
-before using them.
-.Pp
-.Fn HMAC_CTX_cleanup
-is a deprecated function to erase the key and other data from
-.Fa ctx
-and release any associated resources, similar to
-.Fn HMAC_CTX_free
-but without freeing
-.Fa ctx
-itself.
-Calling it is required for static objects and objects on the stack
-that were initialized with
-.Fn HMAC_CTX_init
-and are no longer needed.
-.Pp
-.Fn HMAC_cleanup
-is an alias for
-.Fn HMAC_CTX_cleanup
-included for backward compatibility with 0.9.6b.
-It is deprecated and implemented as a macro.
-.Pp
 The following functions may be used if the message is not completely
 stored in memory:
 .Pp
@@ -371,7 +328,6 @@ or 0 on error.
 RFC 2104
 .Sh HISTORY
 .Fn HMAC ,
-.Fn HMAC_cleanup ,
 .Fn HMAC_Init ,
 .Fn HMAC_Update ,
 .Fn HMAC_Final ,
@@ -379,10 +335,6 @@ and
 .Fn HMAC_size
 first appeared in SSLeay 0.9.0 and have been available since
 .Ox 2.4 .
-.Pp
-.Fn HMAC_CTX_init ,
-.Fn HMAC_CTX_cleanup ,
-and
 .Fn HMAC_Init_ex
 first appeared in OpenSSL 0.9.7 and have been available since
 .Ox 3.2 .