From dc567dc746bcd6fd8656daf59c88362b9cb0456d Mon Sep 17 00:00:00 2001 From: Pauli Date: Thu, 25 Feb 2021 14:30:57 +1000 Subject: [PATCH] doc: update provider-mac documentation to account for the additional init() arguments Reviewed-by: Shane Lontis (Merged from https://github.com/openssl/openssl/pull/14310) --- doc/man7/provider-mac.pod | 11 +++++++---- 1 file changed, 7 insertions(+), 4 deletions(-) diff --git a/doc/man7/provider-mac.pod b/doc/man7/provider-mac.pod index fdeda79ab5e..47f26ca89b3 100644 --- a/doc/man7/provider-mac.pod +++ b/doc/man7/provider-mac.pod @@ -23,7 +23,8 @@ provider-mac - The mac library E-E provider functions void *OSSL_FUNC_mac_dupctx(void *src); /* Encryption/decryption */ - int OSSL_FUNC_mac_init(void *mctx); + int OSSL_FUNC_mac_init(void *mctx, unsigned char *key, size_t keylen, + const OSSL_PARAM params[]); int OSSL_FUNC_mac_update(void *mctx, const unsigned char *in, size_t inl); int OSSL_FUNC_mac_final(void *mctx, unsigned char *out, size_t *outl, size_t outsize); @@ -108,7 +109,8 @@ I parameter and return the duplicate copy. =head2 Encryption/Decryption Functions OSSL_FUNC_mac_init() initialises a mac operation given a newly created provider -side mac context in the I parameter. +side mac context in the I parameter. The I are set before setting +the MAC I of I bytes. OSSL_FUNC_mac_update() is called to supply data for MAC computation of a previously initialised mac operation. @@ -158,7 +160,8 @@ parameters are relevant to, or are understood by all macs: =item "key" (B) -Sets the key in the associated MAC ctx. +Sets the key in the associated MAC ctx. This is identical to passing a I +argument to the OSSL_FUNC_mac_init() function. =item "iv" (B) @@ -228,7 +231,7 @@ array, or NULL if none is offered. =head1 SEE ALSO -L +L, L =head1 HISTORY -- 2.47.3