Browse Source

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)
master
Pauli 1 year ago
parent
commit
f14a2c9d7a
4 changed files with 15 additions and 5 deletions
  1. BIN
      doc/life-cycles/lifecycles.ods
  2. +4
    -2
      doc/life-cycles/mac.dot
  3. +11
    -3
      doc/man7/life_cycle-mac.pod
  4. BIN
      doc/man7/mac.png

BIN
doc/life-cycles/lifecycles.ods View File


+ 4
- 2
doc/life-cycles/mac.dot View File

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


+ 11
- 3
doc/man7/life_cycle-mac.pod View File

@ -68,9 +68,9 @@ The usual life-cycle of a MAC is illustrated:
EVP_MAC_init | +-------------------+ |
| | updated | -+
| +-------------------+
| |
| | EVP_MAC_final
| v
| | |
| | EVP_MAC_final | EVP_MAC_finalXOF
| v v
| +-------------------+
+- | finaled |
+-------------------+
@ -98,6 +98,7 @@ This is the canonical list.
EVP_MAC_init initialised initialised initialised initialised
EVP_MAC_update updated updated
EVP_MAC_final finaled
EVP_MAC_finalXOF finaled
EVP_MAC_CTX_free freed freed freed freed freed
EVP_MAC_CTX_get_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"></td>
<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>
<td style="border:1px solid" align="center">freed</td>
<td style="border:1px solid" align="center">freed</td>


BIN
doc/man7/mac.png View File

Before After
Width: 431  |  Height: 639  |  Size: 49 KiB Width: 491  |  Height: 639  |  Size: 55 KiB

Loading…
Cancel
Save