From e5131ed28ea9173a97f2c03fef7072045a00143f Mon Sep 17 00:00:00 2001 From: Fabian Albert Date: Tue, 22 Oct 2024 14:33:52 +0200 Subject: [PATCH] Better rst file line wraps (no changes in PDF) --- docs/cryptodoc/src/05_09_kyber.rst | 26 ++++++++++++++++++-------- 1 file changed, 18 insertions(+), 8 deletions(-) diff --git a/docs/cryptodoc/src/05_09_kyber.rst b/docs/cryptodoc/src/05_09_kyber.rst index 27e6a389..fbd04e6e 100644 --- a/docs/cryptodoc/src/05_09_kyber.rst +++ b/docs/cryptodoc/src/05_09_kyber.rst @@ -313,9 +313,13 @@ In combination, Botan does the following: **Notes:** - - Step 1 corresponds to Algorithm 19 of [FIPS-203]_ and is performed in :srcref:`[src/lib/pubkey/kyber]/kyber/kyber_common/kyber.cpp:232|Kyber_PrivateKey::Kyber_PrivateKey`. - - Steps 2-7 correspond to Algorithms 16 and 13 of [FIPS-203]_ and are performed in :srcref:`[src/lib/pubkey/kyber]/kyber/kyber_common/kyber_algos.cpp:321|expand_keypair`. - - Botan only stores the seeds as the secret key. The required values for decapsulation are recomputed on demand. Loading or storing the partially expanded key format specified in [FIPS-203]_ is explicitly not supported. + - Step 1 corresponds to Algorithm 19 of [FIPS-203]_ and is performed in + :srcref:`[src/lib/pubkey/kyber]/kyber/kyber_common/kyber.cpp:232|Kyber_PrivateKey::Kyber_PrivateKey`. + - Steps 2-7 correspond to Algorithms 16 and 13 of [FIPS-203]_ and are + performed in :srcref:`[src/lib/pubkey/kyber]/kyber/kyber_common/kyber_algos.cpp:321|expand_keypair`. + - Botan only stores the seeds as the secret key. The required values for + decapsulation are recomputed on demand. Loading or storing the partially + expanded key format specified in [FIPS-203]_ is explicitly not supported. .. _pubkey/kyber/encaps: @@ -363,9 +367,13 @@ In combination, Botan does the following: **Notes:** - - Steps 1-3 correspond to Algorithms 20 and 17 of [FIPS-203]_ and are performed in :srcref:`[src/lib/pubkey/kyber]/ml_kem/ml_kem_impl.cpp:25|ML_KEM_Encryptor::encapsulate`. - - Steps 1.1-1.9 correspond to Algorithms 14 of [FIPS-203]_ and are performed in :srcref:`[src/lib/pubkey/kyber]/kyber/kyber_common/kyber_keys.cpp:55|indcpa_encrypt`. - - The transposed matrix ``At`` is precomputed and stored in the public key object. This way, consecutive encapsulations for the same public key do not have to re-generate ``At`` from ``rho``. + - Steps 1-3 correspond to Algorithms 20 and 17 of [FIPS-203]_ and are + performed in :srcref:`[src/lib/pubkey/kyber]/ml_kem/ml_kem_impl.cpp:25|ML_KEM_Encryptor::encapsulate`. + - Steps 1.1-1.9 correspond to Algorithms 14 of [FIPS-203]_ and are performed + in :srcref:`[src/lib/pubkey/kyber]/kyber/kyber_common/kyber_keys.cpp:55|indcpa_encrypt`. + - The transposed matrix ``At`` is precomputed and stored in the public key + object. This way, consecutive encapsulations for the same public key do not + have to re-generate ``At`` from ``rho``. .. _pubkey/kyber/decaps: @@ -411,6 +419,8 @@ In combination, Botan does the following: **Notes:** - - Steps 1,2 and 6-9 correspond to Algorithm 18 of [FIPS-203]_ and are performed in :srcref:`[src/lib/pubkey/kyber]/ml_kem/ml_kem_impl.cpp:48|ML_KEM_Decryptor::decapsulate`. - - Steps 2.1-2.3 correspond to Algorithm 15 of [FIPS-203]_ and are performed in :srcref:`[src/lib/pubkey/kyber]/kyber/kyber_common/kyber_keys.cpp:84|Kyber_PrivateKeyInternal::indcpa_decrypt`. + - Steps 1,2 and 6-9 correspond to Algorithm 18 of [FIPS-203]_ and are + performed in :srcref:`[src/lib/pubkey/kyber]/ml_kem/ml_kem_impl.cpp:48|ML_KEM_Decryptor::decapsulate`. + - Steps 2.1-2.3 correspond to Algorithm 15 of [FIPS-203]_ and are performed + in :srcref:`[src/lib/pubkey/kyber]/kyber/kyber_common/kyber_keys.cpp:84|Kyber_PrivateKeyInternal::indcpa_decrypt`. - Step 6 uses a constant time check and memory assignment function.