1
0
mirror of https://github.com/ARMmbed/mbedtls.git synced 2025-06-24 14:20:59 +08:00

Fix/Improve wording

Signed-off-by: Ronald Cron <ronald.cron@arm.com>
This commit is contained in:
Ronald Cron 2024-09-19 11:05:56 +02:00
parent a5a46d0322
commit 4162c3a24a

View File

@ -1,10 +1,10 @@
Configuration file split Configuration file split
======================== ========================
## Why splitting the configuration file? ## Why split the configuration file?
The objective of the repository split is to reach the point where in Mbed TLS The objective of the repository split is to reach the point where in Mbed TLS
all the cryptography code and its tests are located in a tf-psa-crypto all the cryptography code and its tests are located in a `tf-psa-crypto`
directory that just contains the TF-PSA-Crypto repository as a submodule. directory that just contains the TF-PSA-Crypto repository as a submodule.
The cryptography APIs exposed by Mbed TLS are just the TF-PSA-Crypto ones. The cryptography APIs exposed by Mbed TLS are just the TF-PSA-Crypto ones.
Mbed TLS relies solely on the TF-PSA-Crypto build system to build its Mbed TLS relies solely on the TF-PSA-Crypto build system to build its
@ -12,12 +12,12 @@ cryptography library and its tests.
The TF-PSA-Crypto configuration file `tf_psa_crypto_config.h` configures The TF-PSA-Crypto configuration file `tf_psa_crypto_config.h` configures
entirely the cryptography interface exposed by Mbed TLS through TF-PSA-Crypto. entirely the cryptography interface exposed by Mbed TLS through TF-PSA-Crypto.
Mbed TLS configuration is splitted in two files: `mbedtls_config.h` for TLS and Mbed TLS configuration is split in two files: `mbedtls_config.h` for TLS and
x509, `tf_psa_crypto_config.h` for the cryptography. x509, `tf_psa_crypto_config.h` for the cryptography.
## How do we split the configuration file? ## How do we split the configuration file?
We extend the so called PSA cryptographic configuration scheme based on We extend the so-called PSA cryptographic configuration scheme based on
`mbedtls_config.h` and `crypto_config.h`. The configuration file `crypto_config.h` `mbedtls_config.h` and `crypto_config.h`. The configuration file `crypto_config.h`
is extended to become the TF-PSA-Crypto configuration file, `mbedtls_config.h` is extended to become the TF-PSA-Crypto configuration file, `mbedtls_config.h`
becomes the configuration file for the TLS and x509 libraries. All the options becomes the configuration file for the TLS and x509 libraries. All the options
@ -70,7 +70,7 @@ contains the configuration options for the cryptography mechanisms that are not
yet part of the PSA cryptography API (like LMS or PK). yet part of the PSA cryptography API (like LMS or PK).
It is followed by the "Data format support" section that contains configuration It is followed by the "Data format support" section that contains configuration
options of utilities related to various data formats (like base64 or ASN1 APIs). options of utilities related to various data formats (like Base64 or ASN.1 APIs).
These utilities aim to facilitate the usage of the PSA cryptography API in other These utilities aim to facilitate the usage of the PSA cryptography API in other
cryptography projects. cryptography projects.