From f3b8d77f99c84e39c48599ad54366e806f3b9478 Mon Sep 17 00:00:00 2001 From: Richard Levitte Date: Fri, 23 Aug 2019 14:54:16 +0200 Subject: [PATCH] Update EVP_MAC.pod Reviewed-by: Shane Lontis (Merged from https://github.com/openssl/openssl/pull/9667) --- doc/man3/EVP_MAC.pod | 18 +++++++----------- 1 file changed, 7 insertions(+), 11 deletions(-) diff --git a/doc/man3/EVP_MAC.pod b/doc/man3/EVP_MAC.pod index 4358ca319a..afb54e3ef7 100644 --- a/doc/man3/EVP_MAC.pod +++ b/doc/man3/EVP_MAC.pod @@ -205,28 +205,24 @@ Some MACs do not support this option. =item OSSL_MAC_PARAM_ENGINE ("engine") -=item OSSL_MAC_PARAM_MD ("md") +=item OSSL_MAC_PARAM_PROPERTIES ("properties") =item OSSL_MAC_PARAM_DIGEST ("digest") =item OSSL_MAC_PARAM_CIPHER ("cipher") -=item OSSL_MAC_PARAM_ALGORITHM ("algorithm") +For MAC implementations that use an underlying computation cipher or +digest, these parameters set what the algorithm should be, and the +engine that implements the algorithm or the properties to fetch it +by if needed. -For MAC implementations that use an underlying computation algorithm, -these parameters set what the algorithm should be, and the engine that -implements the algorithm if needed. - -The value is always the name of the intended engine or algorithm. +The value is always the name of the intended engine, algorithm, +or the properties. Note that not all algorithms may support all digests. HMAC does not support variable output length digests such as SHAKE128 or SHAKE256. -Also note that OSSL_MAC_PARAM_ALGORITHM can be use generically instead -of OSSL_MAC_PARAM_MD, OSSL_MAC_PARAM_DIGEST or OSSL_MAC_PARAM_CIPHER, -and that OSSL_MAC_PARAM_MD and OSSL_MAC_PARAM_DIGEST are also interchangable. - =item OSSL_MAC_PARAM_SIZE For MAC implementations that support it, set the output size that