diff options
author | Matt Caswell <matt@openssl.org> | 2020-08-27 12:52:17 +0100 |
---|---|---|
committer | Matt Caswell <matt@openssl.org> | 2020-09-03 09:40:52 +0100 |
commit | 820d87bc98c254bb36c46891f3fe4e55bd47f2e7 (patch) | |
tree | 01f3ab78dca0c68fd5b677e95bd2b7dc55352090 /doc/man7/EVP_SIGNATURE-HMAC.pod | |
parent | f27138930528e0429a88c8022276e774caa9dd50 (diff) |
Update the EVP_PKEY MAC documentation
Include more information about the new HMAC parameter. Also fill in some
missing documentation about the EVP_PKEY MAC bridge.
Reviewed-by: Tomas Mraz <tmraz@fedoraproject.org>
(Merged from https://github.com/openssl/openssl/pull/12732)
Diffstat (limited to 'doc/man7/EVP_SIGNATURE-HMAC.pod')
-rw-r--r-- | doc/man7/EVP_SIGNATURE-HMAC.pod | 24 |
1 files changed, 16 insertions, 8 deletions
diff --git a/doc/man7/EVP_SIGNATURE-HMAC.pod b/doc/man7/EVP_SIGNATURE-HMAC.pod index dd74fae88c..6628d9ebc2 100644 --- a/doc/man7/EVP_SIGNATURE-HMAC.pod +++ b/doc/man7/EVP_SIGNATURE-HMAC.pod @@ -2,7 +2,7 @@ =head1 NAME -EVP_SIGNATURE-HMAC, EVP_SIGNATURE-SIPHASH, EVP_SIGNATURE-POLY1305, +EVP_SIGNATURE-HMAC, EVP_SIGNATURE-Siphash, EVP_SIGNATURE-Poly1305, EVP_SIGNATURE-CMAC - The legacy B<EVP_PKEY> MAC signature implementations @@ -12,21 +12,29 @@ The algorithms described here have legacy support for creating MACs using L<EVP_DigestSignInit(3)> and related functions. This is not the preferred way of creating MACs. Instead you should use the newer L<EVP_MAC_init(3)> functions. This mechanism is provided for backwards compatibility with older versions of -OpenSSL. +OpenSSL. -There are no parameters supported by the legacy EVP_PKEY MAC signature -algorithms. See L<EVP_PKEY-HMAC(7)>, L<EVP_PKEY-SIPHASH(7)>, -L<EVP_PKEY-POLY1305(7)> or L<EVP_PKEY-CMAC(7)> for details about parameters that -are supported during the creation of an EVP_PKEY. +The same signature parameters can be set using EVP_PKEY_CTX_set_params() as can +be set via EVP_MAC_CTX_set_params() for the underlying EVP_MAC. See +L<EVP_MAC-HMAC(7)>, L<EVP_MAC-Siphash(7)>, L<EVP_MAC-Poly1305(7)> and +L<EVP_MAC-CMAC(7)> for details. + + See L<EVP_PKEY-HMAC(7)>, L<EVP_PKEY-Siphash(7)>, L<EVP_PKEY-Poly1305(7)> or + L<EVP_PKEY-CMAC(7)> for details about parameters that are supported during the + creation of an EVP_PKEY. =head1 SEE ALSO L<EVP_MAC_init(3)>, L<EVP_DigestSignInit(3)>, L<EVP_PKEY-HMAC(7)>, -L<EVP_PKEY-SIPHASH(7)>, -L<EVP_PKEY-POLY1305(7)>, +L<EVP_PKEY-Siphash(7)>, +L<EVP_PKEY-Poly1305(7)>, L<EVP_PKEY-CMAC(7)>, +L<EVP_MAC-HMAC(7)>, +L<EVP_MAC-Siphash(7)>, +L<EVP_MAC-Poly1305(7)>, +L<EVP_MAC-CMAC(7)>, L<provider-signature(7)>, =head1 COPYRIGHT |