xref: /freebsd/crypto/openssl/doc/man7/EVP_SIGNATURE-HMAC.pod (revision b077aed33b7b6aefca7b17ddb250cf521f938613)
1*b077aed3SPierre Pronchery=pod
2*b077aed3SPierre Pronchery
3*b077aed3SPierre Pronchery=head1 NAME
4*b077aed3SPierre Pronchery
5*b077aed3SPierre ProncheryEVP_SIGNATURE-HMAC, EVP_SIGNATURE-Siphash, EVP_SIGNATURE-Poly1305,
6*b077aed3SPierre ProncheryEVP_SIGNATURE-CMAC
7*b077aed3SPierre Pronchery- The legacy B<EVP_PKEY> MAC signature implementations
8*b077aed3SPierre Pronchery
9*b077aed3SPierre Pronchery=head1 DESCRIPTION
10*b077aed3SPierre Pronchery
11*b077aed3SPierre ProncheryThe algorithms described here have legacy support for creating MACs using
12*b077aed3SPierre ProncheryL<EVP_DigestSignInit(3)> and related functions. This is not the preferred way of
13*b077aed3SPierre Proncherycreating MACs. Instead you should use the newer L<EVP_MAC_init(3)> functions.
14*b077aed3SPierre ProncheryThis mechanism is provided for backwards compatibility with older versions of
15*b077aed3SPierre ProncheryOpenSSL.
16*b077aed3SPierre Pronchery
17*b077aed3SPierre ProncheryThe same signature parameters can be set using EVP_PKEY_CTX_set_params() as can
18*b077aed3SPierre Proncherybe set via EVP_MAC_CTX_set_params() for the underlying EVP_MAC. See
19*b077aed3SPierre ProncheryL<EVP_MAC-HMAC(7)>, L<EVP_MAC-Siphash(7)>, L<EVP_MAC-Poly1305(7)> and
20*b077aed3SPierre ProncheryL<EVP_MAC-CMAC(7)> for details.
21*b077aed3SPierre Pronchery
22*b077aed3SPierre Pronchery See L<EVP_PKEY-HMAC(7)>, L<EVP_PKEY-Siphash(7)>, L<EVP_PKEY-Poly1305(7)> or
23*b077aed3SPierre Pronchery L<EVP_PKEY-CMAC(7)> for details about parameters that are supported during the
24*b077aed3SPierre Pronchery creation of an EVP_PKEY.
25*b077aed3SPierre Pronchery
26*b077aed3SPierre Pronchery=head1 SEE ALSO
27*b077aed3SPierre Pronchery
28*b077aed3SPierre ProncheryL<EVP_MAC_init(3)>,
29*b077aed3SPierre ProncheryL<EVP_DigestSignInit(3)>,
30*b077aed3SPierre ProncheryL<EVP_PKEY-HMAC(7)>,
31*b077aed3SPierre ProncheryL<EVP_PKEY-Siphash(7)>,
32*b077aed3SPierre ProncheryL<EVP_PKEY-Poly1305(7)>,
33*b077aed3SPierre ProncheryL<EVP_PKEY-CMAC(7)>,
34*b077aed3SPierre ProncheryL<EVP_MAC-HMAC(7)>,
35*b077aed3SPierre ProncheryL<EVP_MAC-Siphash(7)>,
36*b077aed3SPierre ProncheryL<EVP_MAC-Poly1305(7)>,
37*b077aed3SPierre ProncheryL<EVP_MAC-CMAC(7)>,
38*b077aed3SPierre ProncheryL<provider-signature(7)>,
39*b077aed3SPierre Pronchery
40*b077aed3SPierre Pronchery=head1 COPYRIGHT
41*b077aed3SPierre Pronchery
42*b077aed3SPierre ProncheryCopyright 2020 The OpenSSL Project Authors. All Rights Reserved.
43*b077aed3SPierre Pronchery
44*b077aed3SPierre ProncheryLicensed under the Apache License 2.0 (the "License").  You may not use
45*b077aed3SPierre Proncherythis file except in compliance with the License.  You can obtain a copy
46*b077aed3SPierre Proncheryin the file LICENSE in the source distribution or at
47*b077aed3SPierre ProncheryL<https://www.openssl.org/source/license.html>.
48*b077aed3SPierre Pronchery
49*b077aed3SPierre Pronchery=cut
50