summaryrefslogtreecommitdiffstats
path: root/doc/man7/provider-mac.pod
diff options
context:
space:
mode:
authorPauli <pauli@openssl.org>2021-03-24 13:38:57 +1000
committerPauli <pauli@openssl.org>2021-03-26 18:21:37 +1000
commit10b63e9756cf932cbaba5f725445a2a032a7f271 (patch)
tree576e7c5e913349bbd37064e6b721a82a3c353112 /doc/man7/provider-mac.pod
parentb0b63654e9da02a6f336c5660e659a87a29e916e (diff)
doc: note that MAC lifecycle transitions will be enforced at some point
Reviewed-by: Tomas Mraz <tomas@openssl.org> (Merged from https://github.com/openssl/openssl/pull/14522)
Diffstat (limited to 'doc/man7/provider-mac.pod')
-rw-r--r--doc/man7/provider-mac.pod10
1 files changed, 8 insertions, 2 deletions
diff --git a/doc/man7/provider-mac.pod b/doc/man7/provider-mac.pod
index 82bbdb9aa2..1f7810c16c 100644
--- a/doc/man7/provider-mac.pod
+++ b/doc/man7/provider-mac.pod
@@ -185,6 +185,12 @@ should have as well, see the documentation of the implementation.
=back
+=head1 NOTES
+
+The MAC life-cycle is described in L<life_cycle-rand(7)>. Providers should
+ensure that the various transitions listed there are supported. At some point
+the EVP layer will begin enforcing the listed transitions.
+
=head1 RETURN VALUES
OSSL_FUNC_mac_newctx() and OSSL_FUNC_mac_dupctx() should return the newly created
@@ -203,8 +209,8 @@ array, or NULL if none is offered.
L<provider(7)>,
L<EVP_MAC-BLAKE2(7)>, L<EVP_MAC-CMAC(7)>, L<EVP_MAC-GMAC(7)>,
L<EVP_MAC-HMAC(7)>, L<EVP_MAC-KMAC(7)>, L<EVP_MAC-Poly1305(7)>,
-L<EVP_MAC-Siphash(7)>
-
+L<EVP_MAC-Siphash(7)>,
+L<life_cycle-mac(7)>, L<EVP_MAC(3)>
=head1 HISTORY