-.\" $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
.\"
.\" 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
.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"
.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
RFC 2104
.Sh HISTORY
.Fn HMAC ,
-.Fn HMAC_cleanup ,
.Fn HMAC_Init ,
.Fn HMAC_Update ,
.Fn HMAC_Final ,
.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 .