doc: remove mention of MAC parameter to HMAC-DRBG

Reviewed-by: Dmitry Belyavskiy <beldmit@gmail.com>
Reviewed-by: Shane Lontis <shane.lontis@oracle.com>
Reviewed-by: Tom Cosgrove <tom.cosgrove@arm.com>
(Merged from https://github.com/openssl/openssl/pull/29012)

diff --git a/doc/man3/EVP_RAND.pod b/doc/man3/EVP_RAND.pod
index b9abd245cd7e731b010927949e897f9bb0af34f1..19519d400864d6d671a6e36648dec7bb68638317 100644 (file)
--- a/doc/man3/EVP_RAND.pod
+++ b/doc/man3/EVP_RAND.pod
@@ -320,13 +320,11 @@ Specifies the number of times the DRBG has been seeded or reseeded.
 
 =item "properties" (B<OSSL_RAND_PARAM_PROPERTIES>) <UTF8 string>
 
-=item "mac" (B<OSSL_RAND_PARAM_MAC>) <UTF8 string>
-
 =item "digest" (B<OSSL_RAND_PARAM_DIGEST>) <UTF8 string>
 
 =item "cipher" (B<OSSL_RAND_PARAM_CIPHER>) <UTF8 string>
 
-For RAND implementations that use an underlying computation MAC, digest or
+For RAND implementations that use an underlying digest or
 cipher, these parameters set what the algorithm should be.
 
 The value is always the name of the intended algorithm,

diff --git a/doc/man7/EVP_RAND-HMAC-DRBG.pod b/doc/man7/EVP_RAND-HMAC-DRBG.pod
index 4a4ce9517c3676f97dd5c04061bf0381758f37e8..3b1450d01cccfc663a3729f4497e72e62a0fc1a5 100644 (file)
--- a/doc/man7/EVP_RAND-HMAC-DRBG.pod
+++ b/doc/man7/EVP_RAND-HMAC-DRBG.pod
@@ -46,8 +46,6 @@ The supported parameters are:
 
 =item "properties" (B<OSSL_DRBG_PARAM_PROPERTIES>) <UTF8 string>
 
-=item "mac" (B<OSSL_DRBG_PARAM_MAC>) <UTF8 string>
-
 =item "digest" (B<OSSL_DRBG_PARAM_DIGEST>) <UTF8 string>
 
 These parameters work as described in L<EVP_RAND(3)/PARAMETERS>.
@@ -95,14 +93,13 @@ A context for HMAC DRBG can be obtained by calling:
  EVP_RAND *rand;
  EVP_RAND_CTX *rctx;
  unsigned char bytes[100];
- OSSL_PARAM params[3], *p = params;
+ OSSL_PARAM params[2], *p = params;
  unsigned int strength = 128;
 
  rand = EVP_RAND_fetch(NULL, "HMAC-DRBG", NULL);
  rctx = EVP_RAND_CTX_new(rand, NULL);
  EVP_RAND_free(rand);
 
- *p++ = OSSL_PARAM_construct_utf8_string(OSSL_DRBG_PARAM_MAC, SN_hmac, 0);
  *p++ = OSSL_PARAM_construct_utf8_string(OSSL_DRBG_PARAM_DIGEST, SN_sha256, 0);
  *p = OSSL_PARAM_construct_end();
  EVP_RAND_instantiate(rctx, strength, 0, NULL, 0, params);

diff --git a/doc/man7/provider-rand.pod b/doc/man7/provider-rand.pod
index 5fd38f6b40ca4f3b8cd3554506d7f0ebd5da7a67..f6e7891d502ff6d7398a1bbdf9493f17f94cd579 100644 (file)
--- a/doc/man7/provider-rand.pod
+++ b/doc/man7/provider-rand.pod
@@ -249,9 +249,7 @@ Specifies the number of times the DRBG has been seeded or reseeded.
 
 =item "cipher" (B<OSSL_DRBG_PARAM_CIPHER>) <UTF8 string>
 
-=item "mac" (B<OSSL_DRBG_PARAM_MAC>) <UTF8 string>
-
-Sets the name of the underlying cipher, digest or MAC to be used.
+Sets the name of the underlying cipher or digest to be used.
 It must name a suitable algorithm for the DRBG that's being used.
 
 =item "properties" (B<OSSL_DRBG_PARAM_PROPERTIES>) <UTF8 string>