Add a recommendation for implementation of ALL_SUBSYSTEMS initialization

ARM-software · Dec 16, 2024 · 0ad77a5 · 0ad77a5
1 parent 940d059
commit 0ad77a5
Showing 1 changed file with 5 additions and 0 deletions.
diff --git a/doc/crypto/api/library/library.rst b/doc/crypto/api/library/library.rst
@@ -198,6 +198,11 @@ If the application calls any function that returns a :code:`psa_status_t` result
 
     Using this value in a call to `psa_crypto_init_subsystem()` is equivalent to calling `psa_crypto_init()`.
 
+    .. admonition:: Implementation note
+
+        It is recommended that :code:`psa_crypto_init_subsystem(PSA_CRYPTO_ALL_SUBSYSTEMS)` is implemented in a way that provides compatibility with future versions of the implementation.
+        That is, addition of a new subsystem to an implementation does not require recompilation of the application so that this call will still initialize all subsystems.
+
 .. function:: psa_crypto_init_subsystem
 
     .. summary::