diff options
| author | Dr. David von Oheimb <David.von.Oheimb@siemens.com> | 2021-04-20 08:30:47 +0200 |
|---|---|---|
| committer | Dr. David von Oheimb <dev@ddvo.net> | 2021-04-21 14:12:54 +0200 |
| commit | c0e724fcbe3b78f098534fd5b76c1d0393b2a42c (patch) | |
| tree | 3dbfe80ecbbf5265e94a94df75cd151d992c14a4 /doc/man3/EVP_MAC.pod | |
| parent | Use build.info not file-wide ifndef (diff) | |
| download | openssl-c0e724fcbe3b78f098534fd5b76c1d0393b2a42c.tar.xz openssl-c0e724fcbe3b78f098534fd5b76c1d0393b2a42c.zip | |
DOC: Clarify EVP_MAC_init() params vs. EVP_MAC_CTX_set_params()
Fixes #14855
Reviewed-by: Tomas Mraz <tomas@openssl.org>
Reviewed-by: Paul Dale <pauli@openssl.org>
(Merged from https://github.com/openssl/openssl/pull/14937)
Diffstat (limited to 'doc/man3/EVP_MAC.pod')
| -rw-r--r-- | doc/man3/EVP_MAC.pod | 9 |
1 files changed, 6 insertions, 3 deletions
diff --git a/doc/man3/EVP_MAC.pod b/doc/man3/EVP_MAC.pod index 2a8fb5332e..b6b5430a35 100644 --- a/doc/man3/EVP_MAC.pod +++ b/doc/man3/EVP_MAC.pod @@ -118,12 +118,15 @@ I<ctx>. =head2 Computing functions -EVP_MAC_init() sets up the underlying context with information given +EVP_MAC_init() sets up the underlying context I<ctx> with information given via the I<key> and I<params> arguments. The MAC I<key> has a length of I<keylen> and the parameters in I<params> are processed before setting -the key. If I<key> is NULL, the key must be set via params either +the key. If I<key> is NULL, the key must be set via I<params> either as part of this call or separately using EVP_MAC_CTX_set_params(). -This should be called before calling EVP_MAC_update() and EVP_MAC_final(). +Providing non-NULL I<params> to this function is equivalent to calling +EVP_MAC_CTX_set_params() with those I<params> for the same I<ctx> beforehand. + +EVP_MAC_init() should be called before EVP_MAC_update() and EVP_MAC_final(). EVP_MAC_update() adds I<datalen> bytes from I<data> to the MAC input. |