summaryrefslogtreecommitdiffstats
path: root/doc
diff options
context:
space:
mode:
authorRichard Levitte <levitte@openssl.org>2019-08-23 14:54:16 +0200
committerRichard Levitte <levitte@openssl.org>2019-08-24 13:01:15 +0200
commitf3b8d77f99c84e39c48599ad54366e806f3b9478 (patch)
tree60c7c066e8df668464603e4f92463fc0ada44dc1 /doc
parent703170d4b9da1b3adc0e4d87719a5156080b2dca (diff)
Update EVP_MAC.pod
Reviewed-by: Shane Lontis <shane.lontis@oracle.com> (Merged from https://github.com/openssl/openssl/pull/9667)
Diffstat (limited to 'doc')
-rw-r--r--doc/man3/EVP_MAC.pod18
1 files 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") <utf8string>
-=item OSSL_MAC_PARAM_MD ("md") <utf8string>
+=item OSSL_MAC_PARAM_PROPERTIES ("properties") <utf8string>
=item OSSL_MAC_PARAM_DIGEST ("digest") <utf8string>
=item OSSL_MAC_PARAM_CIPHER ("cipher") <utf8string>
-=item OSSL_MAC_PARAM_ALGORITHM ("algorithm") <utf8string>
+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 <unsigned int>
For MAC implementations that support it, set the output size that