From c0fc3fe3496ec02b0cafb252b7764f53cc3ae643 Mon Sep 17 00:00:00 2001
From: Pauli <pauli@openssl.org>
Date: Mon, 7 Jun 2021 15:11:28 +1000
Subject: [PATCH] doc: add cipher life cycle documentation

Reviewed-by: Tomas Mraz <tomas@openssl.org>
(Merged from https://github.com/openssl/openssl/pull/15637)
---
 doc/man7/img/cipher.png        | Bin 0 -> 81349 bytes
 doc/man7/life_cycle-cipher.pod | 370 +++++++++++++++++++++++++++++++++
 2 files changed, 370 insertions(+)
 create mode 100644 doc/man7/img/cipher.png
 create mode 100644 doc/man7/life_cycle-cipher.pod

diff --git a/doc/man7/img/cipher.png b/doc/man7/img/cipher.png
new file mode 100644
index 0000000000000000000000000000000000000000..79b8b621e6aa96e74b6810a8fdd0a4b2fd97510a
GIT binary patch
literal 81349
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

literal 0
Hc-jL100001

diff --git a/doc/man7/life_cycle-cipher.pod b/doc/man7/life_cycle-cipher.pod
new file mode 100644
index 00000000000..227cc18b8d7
--- /dev/null
+++ b/doc/man7/life_cycle-cipher.pod
@@ -0,0 +1,370 @@
+=pod
+
+=head1 NAME
+
+life_cycle-cipher - The cipher algorithm life-cycle
+
+=head1 DESCRIPTION
+
+All symmetric ciphers (CIPHERs) go through a number of stages in their
+life-cycle:
+
+=over 4
+
+=item start
+
+This state represents the CIPHER before it has been allocated.  It is the
+starting state for any life-cycle transitions.
+
+=item newed
+
+This state represents the CIPHER after it has been allocated.
+
+=item initialised
+
+These states represent the CIPHER when it is set up and capable of processing
+input.  There are three possible initialised states:
+
+=over 4
+
+=item initialised using EVP_CipherInit
+
+=item initialised for decryption using EVP_DecryptInit
+
+=item initialised for encryption using EVP_EncryptInit
+
+=back
+
+=item updated
+
+These states represent the CIPHER when it is set up and capable of processing
+additional input or generating output.  The three possible states directly
+correspond to those for initialised above.  The three different streams should
+not be mixed.
+
+=item finaled
+
+This state represents the CIPHER when it has generated output.
+
+=item freed
+
+This state is entered when the CIPHER is freed.  It is the terminal state
+for all life-cycle transitions.
+
+=back
+
+=head2 State Transition Diagram
+
+The usual life-cycle of a CIPHER is illustrated:
+
+=begin man
+
+                                 +---------------------------+
+                                 |                           |
+                                 |           start           |
+                                 |                           |
+                                 +---------------------------+   + - - - - - - - - - - - - - +
+                                       |                         '  any of the initialised   '
+                                       | EVP_CIPHER_CTX_new      ' updated or finaled states '
+                                       v                         '                           '
+                                 +---------------------------+   + - - - - - - - - - - - - - +
+                                 |                           |      |
+                                 |           newed           |      | EVP_CIPHER_CTX_reset
+                                 |                           | <----+
+                                 +---------------------------+
+                                    |   |                 |
+                          +---------+   |                 +---------+
+          EVP_DecryptInit |             | EVP_CipherInit            | EVP_EncryptInit
+                          v             v                           v
+ +---------------------------+   +---------------------------+   +---------------------------+
+ |                           |   |                           |   |                           |
+ |        initialised        |   |        initialised        |   |        initialised        |
+ |       for decryption      |   |                           |   |       for encryption      |
+ +---------------------------+   +---------------------------+   +---------------------------+
+   |                                   |                                                   |
+   | EVP_DecryptUpdate                 | EVP_CipherUpdate                EVP_EncryptUpdate |
+   |                                   v                                                   |
+   |                             +---------------------------+                             |
+   |                             |                           |--------------------+        |
+   |                             |          updated          |   EVP_CipherUpdate |        |
+   |                             |                           | <------------------+        |
+   v                             +---------------------------+                             v
+ +---------------------------+                         |         +---------------------------+
+ |                           |---------------------+   |         |                           |
+ |          updated          |   EVP_DecryptUpdate |   |         |          updated          |------+
+ |       for decryption      | <-------------------+   |         |       for encryption      |      |
+ +---------------------------+                         |         +---------------------------+      |
+                          |            EVP_CipherFinal |            |           ^                   |
+                          +-------+                    |   +--------+           |                   |
+                 EVP_DecryptFinal |                    |   | EVP_EncryptFinal   +-------------------+
+                                  v                    v   v                      EVP_EncryptUpdate
+                                 +---------------------------+
+                                 |                           |-----------------------------+
+                                 |          finaled          |                             |
+                                 |                           | <---------------------------+
+                                 +---------------------------+   EVP_CIPHER_CTX_get_params
+                                       |                             (AEAD encryption)
+                                       | EVP_CIPHER_CTX_free
+                                       v
+                                 +---------------------------+
+                                 |                           |
+                                 |           freed           |
+                                 |                           |
+                                 +---------------------------+
+
+=end man
+
+=for html <img src="img/cipher.png">
+
+=head2 Formal State Transitions
+
+This section defines all of the legal state transitions.
+This is the canonical list.
+
+=begin man
+
+ Function Call                ---------------------------------------------- Current State -----------------------------------------------
+                              start   newed    initialised   updated     finaled   initialised   updated    initialised   updated    freed
+                                                                                    decryption  decryption   encryption  encryption
+ EVP_CIPHER_CTX_new           newed           
+ EVP_CipherInit                    initialised initialised initialised initialised initialised initialised  initialised initialised
+ EVP_DecryptInit                   initialised initialised initialised initialised initialised initialised  initialised initialised
+                                    decryption  decryption  decryption  decryption  decryption  decryption  decryption  decryption  
+ EVP_EncryptInit                   initialised initialised initialised initialised initialised initialised  initialised initialised
+                                    encryption  encryption  encryption  encryption  encryption  encryption  encryption  encryption  
+ EVP_CipherUpdate                                updated     updated
+ EVP_DecryptUpdate                                                                   updated     updated
+                                                                                    decryption  decryption
+ EVP_EncryptUpdate                                                                                            updated     updated
+                                                                                                             encryption  encryption
+ EVP_CipherFinal                                             finaled
+ EVP_DecryptFinal                                                                                finaled
+ EVP_EncryptFinal                                                                                                         finaled
+ EVP_CIPHER_CTX_free          freed   freed       freed       freed       freed       freed       freed        freed       freed
+ EVP_CIPHER_CTX_reset                 newed       newed       newed       newed       newed       newed        newed       newed
+ EVP_CIPHER_CTX_get_params            newed    initialised   updated               initialised   updated    initialised   updated
+                                                                                    decryption  decryption   encryption  encryption
+ EVP_CIPHER_CTX_set_params            newed    initialised   updated               initialised   updated    initialised   updated
+                                                                                    decryption  decryption   encryption  encryption
+ EVP_CIPHER_CTX_gettable_params       newed    initialised   updated               initialised   updated    initialised   updated
+                                                                                    decryption  decryption   encryption  encryption
+ EVP_CIPHER_CTX_settable_params       newed    initialised   updated               initialised   updated    initialised   updated
+                                                                                    decryption  decryption   encryption  encryption
+
+=end man
+
+=begin html
+
+<table style="border:1px solid; border-collapse:collapse">
+<tr><th style="border:1px solid" align="left">Function Call</th>
+    <th style="border:1px solid" colspan="10">Current State</th></tr>
+<tr><th style="border:1px solid"></th>
+    <th style="border:1px solid" align="center">start</th>
+    <th style="border:1px solid" align="center">newed</th>
+    <th style="border:1px solid" align="center">initialised</th>
+    <th style="border:1px solid" align="center">updated</th>
+    <th style="border:1px solid" align="center">finaled</th>
+    <th style="border:1px solid" align="center">initialised<br>decryption</th>
+    <th style="border:1px solid" align="center">updated<br>decryption</th>
+    <th style="border:1px solid" align="center">initialised<br>encryption</th>
+    <th style="border:1px solid" align="center">updated<br>encryption</th>
+    <th style="border:1px solid" align="center">freed</th></tr>
+<tr><th style="border:1px solid" align="left">EVP_CIPHER_CTX_new</th>
+    <td style="border:1px solid" align="center">newed</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>
+    <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"></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_CipherInit</th>
+    <td style="border:1px solid" align="center"></td>
+    <td style="border:1px solid" align="center">initialised</td>
+    <td style="border:1px solid" align="center">initialised</td>
+    <td style="border:1px solid" align="center">initialised</td>
+    <td style="border:1px solid" align="center">initialised</td>
+    <td style="border:1px solid" align="center">initialised</td>
+    <td style="border:1px solid" align="center">initialised</td>
+    <td style="border:1px solid" align="center">initialised</td>
+    <td style="border:1px solid" align="center">initialised</td>
+    <td style="border:1px solid" align="center"></td></tr>
+<tr><th style="border:1px solid" align="left">EVP_DecryptInit</th>
+    <td style="border:1px solid" align="center"></td>
+    <td style="border:1px solid" align="center">initialised<br>decryption</td>
+    <td style="border:1px solid" align="center">initialised<br>decryption</td>
+    <td style="border:1px solid" align="center">initialised<br>decryption</td>
+    <td style="border:1px solid" align="center">initialised<br>decryption</td>
+    <td style="border:1px solid" align="center">initialised<br>decryption</td>
+    <td style="border:1px solid" align="center">initialised<br>decryption</td>
+    <td style="border:1px solid" align="center">initialised<br>decryption</td>
+    <td style="border:1px solid" align="center">initialised<br>decryption</td>
+    <td style="border:1px solid" align="center"></td></tr>
+<tr><th style="border:1px solid" align="left">EVP_EncryptInit</th>
+    <td style="border:1px solid" align="center"></td>
+    <td style="border:1px solid" align="center">initialised<br>encryption</td>
+    <td style="border:1px solid" align="center">initialised<br>encryption</td>
+    <td style="border:1px solid" align="center">initialised<br>encryption</td>
+    <td style="border:1px solid" align="center">initialised<br>encryption</td>
+    <td style="border:1px solid" align="center">initialised<br>encryption</td>
+    <td style="border:1px solid" align="center">initialised<br>encryption</td>
+    <td style="border:1px solid" align="center">initialised<br>encryption</td>
+    <td style="border:1px solid" align="center">initialised<br>encryption</td>
+    <td style="border:1px solid" align="center"></td></tr>
+<tr><th style="border:1px solid" align="left">EVP_CipherUpdate</th>
+    <td style="border:1px solid" align="center"></td>
+    <td style="border:1px solid" align="center"></td>
+    <td style="border:1px solid" align="center">updated</td>
+    <td style="border:1px solid" align="center">updated</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>
+    <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>
+<tr><th style="border:1px solid" align="left">EVP_DecryptUpdate</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"></td>
+    <td style="border:1px solid" align="center"></td>
+    <td style="border:1px solid" align="center">updated<br>decryption</td>
+    <td style="border:1px solid" align="center">updated<br>decryption</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>
+<tr><th style="border:1px solid" align="left">EVP_EncryptUpdate</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"></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>
+    <td style="border:1px solid" align="center">updated<br>encryption</td>
+    <td style="border:1px solid" align="center">updated<br>encryption</td>
+    <td style="border:1px solid" align="center"></td></tr>
+<tr><th style="border:1px solid" align="left">EVP_CipherFinal</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>
+    <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"></td></tr>
+<tr><th style="border:1px solid" align="left">EVP_DecryptFinal</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"></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<br>decryption</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>
+<tr><th style="border:1px solid" align="left">EVP_EncryptFinal</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"></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>
+    <td style="border:1px solid" align="center"></td>
+    <td style="border:1px solid" align="center">finaled<br>decryption</td>
+    <td style="border:1px solid" align="center"></td></tr>
+<tr><th style="border:1px solid" align="left">EVP_CIPHER_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>
+    <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>
+    <td style="border:1px solid" align="center">freed</td>
+    <td style="border:1px solid" align="center"></td></tr>
+<tr><th style="border:1px solid" align="left">EVP_CIPHER_CTX_reset</th>
+    <td style="border:1px solid" align="center"></td>
+    <td style="border:1px solid" align="center"></td>
+    <td style="border:1px solid" align="center">newed</td>
+    <td style="border:1px solid" align="center">newed</td>
+    <td style="border:1px solid" align="center">newed</td>
+    <td style="border:1px solid" align="center">newed</td>
+    <td style="border:1px solid" align="center">newed</td>
+    <td style="border:1px solid" align="center">newed</td>
+    <td style="border:1px solid" align="center">newed</td>
+    <td style="border:1px solid" align="center"></td></tr>
+<tr><th style="border:1px solid" align="left">EVP_CIPHER_CTX_get_params</th>
+    <td style="border:1px solid" align="center"></td>
+    <td style="border:1px solid" align="center">newed</td>
+    <td style="border:1px solid" align="center">initialised</td>
+    <td style="border:1px solid" align="center">updated</td>
+    <td style="border:1px solid" align="center"></td>
+    <td style="border:1px solid" align="center">initialised<br>decryption</td>
+    <td style="border:1px solid" align="center">updated<br>decryption</td>
+    <td style="border:1px solid" align="center">initialised<br>encryption</td>
+    <td style="border:1px solid" align="center">updated<br>encryption</td>
+    <td style="border:1px solid" align="center"></td></tr>
+<tr><th style="border:1px solid" align="left">EVP_CIPHER_CTX_set_params</th>
+    <td style="border:1px solid" align="center"></td>
+    <td style="border:1px solid" align="center">newed</td>
+    <td style="border:1px solid" align="center">initialised</td>
+    <td style="border:1px solid" align="center">updated</td>
+    <td style="border:1px solid" align="center"></td>
+    <td style="border:1px solid" align="center">initialised<br>decryption</td>
+    <td style="border:1px solid" align="center">updated<br>decryption</td>
+    <td style="border:1px solid" align="center">initialised<br>encryption</td>
+    <td style="border:1px solid" align="center">updated<br>encryption</td>
+    <td style="border:1px solid" align="center"></td></tr>
+<tr><th style="border:1px solid" align="left">EVP_CIPHER_CTX_gettable_params</th>
+    <td style="border:1px solid" align="center"></td>
+    <td style="border:1px solid" align="center">newed</td>
+    <td style="border:1px solid" align="center">initialised</td>
+    <td style="border:1px solid" align="center">updated</td>
+    <td style="border:1px solid" align="center"></td>
+    <td style="border:1px solid" align="center">initialised<br>decryption</td>
+    <td style="border:1px solid" align="center">updated<br>decryption</td>
+    <td style="border:1px solid" align="center">initialised<br>encryption</td>
+    <td style="border:1px solid" align="center">updated<br>encryption</td>
+    <td style="border:1px solid" align="center"></td></tr>
+<tr><th style="border:1px solid" align="left">EVP_CIPHER_CTX_settable_params</th>
+    <td style="border:1px solid" align="center"></td>
+    <td style="border:1px solid" align="center">newed</td>
+    <td style="border:1px solid" align="center">initialised</td>
+    <td style="border:1px solid" align="center">updated</td>
+    <td style="border:1px solid" align="center"></td>
+    <td style="border:1px solid" align="center">initialised<br>decryption</td>
+    <td style="border:1px solid" align="center">updated<br>decryption</td>
+    <td style="border:1px solid" align="center">initialised<br>encryption</td>
+    <td style="border:1px solid" align="center">updated<br>encryption</td>
+    <td style="border:1px solid" align="center"></td></tr>
+</table>
+
+=end html
+
+=head1 NOTES
+
+At some point the EVP layer will begin enforcing the transitions described
+herein.
+
+=head1 SEE ALSO
+
+L<provider-cipher(7)>, L<EVP_EncryptInit(3)>
+
+=head1 COPYRIGHT
+
+Copyright 2021 The OpenSSL Project Authors. All Rights Reserved.
+
+Licensed under the Apache License 2.0 (the "License").  You may not use
+this file except in compliance with the License.  You can obtain a copy
+in the file LICENSE in the source distribution or at
+L<https://www.openssl.org/source/license.html>.
+
+=cut
-- 
2.47.2