diff --git a/doc/crypto/api/keys/ids.rst b/doc/crypto/api/keys/ids.rst index 9e9ce070..2135f9b4 100644 --- a/doc/crypto/api/keys/ids.rst +++ b/doc/crypto/api/keys/ids.rst @@ -10,9 +10,9 @@ Key identifiers are integral values that act as permanent names for persistent k :code:`PSA_KEY_ID_NULL = 0` Reserved as an invalid key identifier. -:code:`PSA_KEY_ID_USER_MIN – PSA_KEY_ID_USER_MAX` +:code:`PSA_KEY_ID_USER_MIN - PSA_KEY_ID_USER_MAX` Applications can freely choose persistent key identifiers in this range. -:code:`PSA_KEY_ID_VENDOR_MIN – PSA_KEY_ID_VENDOR_MAX` +:code:`PSA_KEY_ID_VENDOR_MIN - PSA_KEY_ID_VENDOR_MAX` Implementations can define additional persistent key identifiers in this range, and must allocate any volatile key identifiers from this range. Key identifiers outside these ranges are reserved for future use. diff --git a/doc/crypto/api/keys/lifetimes.rst b/doc/crypto/api/keys/lifetimes.rst index b57d09b8..e386bba1 100644 --- a/doc/crypto/api/keys/lifetimes.rst +++ b/doc/crypto/api/keys/lifetimes.rst @@ -121,12 +121,12 @@ Lifetime encodings Implementations should support this value if they support persistent keys at all. Applications should use this value if they have no specific needs that are only met by implementation-specific features. - * - ``2 – 127`` + * - ``2 - 127`` - Persistent key with a PSA Certified API-specified lifetime. The |API| does not define the meaning of these values, but another PSA Certified API may do so. - * - ``128 – 254`` + * - ``128 - 254`` - Persistent key with a vendor-specified lifetime. No PSA Certified API will define the meaning of these values, so implementations may choose the meaning freely. As a guideline, higher persistence levels should cause a key to survive more management events than lower levels. @@ -171,12 +171,12 @@ Lifetime encodings Implementations should support this value if there is a secure element attached to the operating environment. As a guideline, secure elements may provide higher resistance against side channel and physical attacks than the primary local storage, but may have restrictions on supported key types, sizes, policies and operations and may have different performance characteristics. - * - ``2 – 0x7fffff`` + * - ``2 - 0x7fffff`` - Other locations defined by a PSA specification. The |API| does not currently assign any meaning to these locations, but future versions of this specification or other PSA Certified APIs may do so. - * - ``0x800000 – 0xffffff`` + * - ``0x800000 - 0xffffff`` - Vendor-defined locations. No PSA Certified API will assign a meaning to locations in this range. diff --git a/doc/crypto/api/keys/types.rst b/doc/crypto/api/keys/types.rst index 71e0adca..77c3ca87 100644 --- a/doc/crypto/api/keys/types.rst +++ b/doc/crypto/api/keys/types.rst @@ -21,11 +21,11 @@ Key type encoding :code:`PSA_KEY_TYPE_NONE == 0` Reserved as an invalid key type. - :code:`0x0001 – 0x7fff` + :code:`0x0001 - 0x7fff` Specification-defined key types. Key types defined by this standard always have bit 15 clear. Unallocated key type values in this range are reserved for future use. - :code:`0x8000 – 0xffff` + :code:`0x8000 - 0xffff` Implementation-defined key types. Implementations that define additional key types must use an encoding with bit 15 set. The related support macros will be easier to write if these key encodings also respect the bitwise structure used by standard encodings. @@ -740,10 +740,10 @@ The curve type affects the key format, the key derivation procedure, and the alg :code:`0x00` Reserved. Not allocated to an ECC family. - :code:`0x01 – 0x7f` + :code:`0x01 - 0x7f` ECC family identifiers defined by this standard. Unallocated values in this range are reserved for future use. - :code:`0x80 – 0xff` + :code:`0x80 - 0xff` Implementations that define additional families must use an encoding in this range. .. macro:: PSA_KEY_TYPE_ECC_KEY_PAIR @@ -1157,10 +1157,10 @@ Diffie Hellman keys :code:`0x00` Reserved. Not allocated to a DH group family. - :code:`0x01 – 0x7f` + :code:`0x01 - 0x7f` DH group family identifiers defined by this standard. Unallocated values in this range are reserved for future use. - :code:`0x80 – 0xff` + :code:`0x80 - 0xff` Implementations that define additional families must use an encoding in this range. .. macro:: PSA_KEY_TYPE_DH_KEY_PAIR diff --git a/doc/crypto/api/ops/algorithms.rst b/doc/crypto/api/ops/algorithms.rst index 1a601b44..98517b75 100644 --- a/doc/crypto/api/ops/algorithms.rst +++ b/doc/crypto/api/ops/algorithms.rst @@ -41,11 +41,11 @@ Algorithm encoding :code:`0x00000000` Reserved as an invalid algorithm identifier. - :code:`0x00000001 – 0x7fffffff` + :code:`0x00000001 - 0x7fffffff` Specification-defined algorithm identifiers. Algorithm identifiers defined by this standard always have bit 31 clear. Unallocated algorithm identifier values in this range are reserved for future use. - :code:`0x80000000 – 0xffffffff` + :code:`0x80000000 - 0xffffffff` Implementation-defined algorithm identifiers. Implementations that define additional algorithms must use an encoding with bit 31 set. The related support macros will be easier to write if these algorithm identifier encodings also respect the bitwise structure used by standard encodings.