mac: update life-cycle description and diagrams to include finalXOF

Reviewed-by: Matt Caswell <matt@openssl.org>
(Merged from https://github.com/openssl/openssl/pull/15061)
This commit is contained in:
Pauli 2021-04-29 11:08:42 +10:00
parent a59c69724d
commit f14a2c9d7a
4 changed files with 15 additions and 5 deletions

Binary file not shown.

View File

@ -11,9 +11,11 @@ digraph mac {
initialised -> updated [label="EVP_MAC_update"]; initialised -> updated [label="EVP_MAC_update"];
updated -> updated [label="EVP_MAC_update"]; updated -> updated [label="EVP_MAC_update"];
updated -> finaled [label="EVP_MAC_final"]; updated -> finaled [label="EVP_MAC_final"];
updated -> finaled [label="EVP_MAC_finalXOF",
fontcolor="#808080", color="#808080"];
/* Once this works it should go back in: /* Once this works it should go back in:
updated -> finaled [label="EVP_MAC_final_XOF", style=dashed]; finaled -> finaled [label="EVP_MAC_final_XOF",
finaled -> finaled [label="EVP_MAC_final_XOF", style=dashed]; fontcolor="#808080", color="#808080"];
*/ */
finaled -> end [label="EVP_MAC_CTX_free"]; finaled -> end [label="EVP_MAC_CTX_free"];
updated -> initialised [label="EVP_MAC_init", style=dashed, updated -> initialised [label="EVP_MAC_init", style=dashed,

View File

@ -68,9 +68,9 @@ The usual life-cycle of a MAC is illustrated:
EVP_MAC_init | +-------------------+ | EVP_MAC_init | +-------------------+ |
| | updated | -+ | | updated | -+
| +-------------------+ | +-------------------+
| | | | |
| | EVP_MAC_final | | EVP_MAC_final | EVP_MAC_finalXOF
| v | v v
| +-------------------+ | +-------------------+
+- | finaled | +- | finaled |
+-------------------+ +-------------------+
@ -98,6 +98,7 @@ This is the canonical list.
EVP_MAC_init initialised initialised initialised initialised EVP_MAC_init initialised initialised initialised initialised
EVP_MAC_update updated updated EVP_MAC_update updated updated
EVP_MAC_final finaled EVP_MAC_final finaled
EVP_MAC_finalXOF finaled
EVP_MAC_CTX_free freed freed freed freed freed EVP_MAC_CTX_free freed freed freed freed freed
EVP_MAC_CTX_get_params newed initialised updated EVP_MAC_CTX_get_params newed initialised updated
EVP_MAC_CTX_set_params newed initialised updated EVP_MAC_CTX_set_params newed initialised updated
@ -146,6 +147,13 @@ This is the canonical list.
<td style="border:1px solid" align="center">finaled</td> <td style="border:1px solid" align="center">finaled</td>
<td style="border:1px solid" align="center"></td> <td style="border:1px solid" align="center"></td>
<td style="border:1px solid" align="center"></td></tr> <td style="border:1px solid" align="center"></td></tr>
<tr><th style="border:1px solid" align="left">EVP_MAC_finalXOF</th>
<td style="border:1px solid" align="center"></td>
<td style="border:1px solid" align="center"></td>
<td style="border:1px solid" align="center"></td>
<td style="border:1px solid" align="center">finaled</td>
<td style="border:1px solid" align="center"></td>
<td style="border:1px solid" align="center"></td></tr>
<tr><th style="border:1px solid" align="left">EVP_MAC_CTX_free</th> <tr><th style="border:1px solid" align="left">EVP_MAC_CTX_free</th>
<td style="border:1px solid" align="center">freed</td> <td style="border:1px solid" align="center">freed</td>
<td style="border:1px solid" align="center">freed</td> <td style="border:1px solid" align="center">freed</td>

Binary file not shown.

Before

Width:  |  Height:  |  Size: 49 KiB

After

Width:  |  Height:  |  Size: 55 KiB