Update EVP_MAC.pod
authorRichard Levitte <levitte@openssl.org>
Fri, 23 Aug 2019 12:54:16 +0000 (14:54 +0200)
committerRichard Levitte <levitte@openssl.org>
Sat, 24 Aug 2019 11:01:15 +0000 (13:01 +0200)
Reviewed-by: Shane Lontis <shane.lontis@oracle.com>
(Merged from https://github.com/openssl/openssl/pull/9667)

doc/man3/EVP_MAC.pod

index 4358ca3..afb54e3 100644 (file)
@@ -205,28 +205,24 @@ Some MACs do not support this option.
 
 =item OSSL_MAC_PARAM_ENGINE ("engine") <utf8string>
 
 
 =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_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.
 
 
 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
 =item OSSL_MAC_PARAM_SIZE <unsigned int>
 
 For MAC implementations that support it, set the output size that