tee_client_api: deprecate two TEE_ERROR_* macros not in the specifica…

…tion

TEE_ERROR_EXTERNAL_CANCEL and TEE_ERROR_STORAGE_NO_SPACE are not part
of the specification [1]. TEEC_ERROR_EXTERNAL_CANCEL and
TEEC_ERROR_STORAGE_NO_SPACE should be preferred instead.

Add a message in the description to deprecate these two macros, but
keep them for backward compatibility.

[1] TEE Client API Specification v1.0 Errata and Precisions
    Version 2.0, §P.4 Define Additional Return Codes

Signed-off-by: Vincent Mailhol <[email protected]>
Acked-by: Etienne Carriere <[email protected]>

libteec/include/tee_client_api.h

@@ -160,10 +160,14 @@ extern "C" {
  * TEE_ERROR_EXTERNAL_CANCEL    Defined by the Trusted User Interface
  *                              specification: An external event has caused a
  *                              User Interface operation to be aborted.
+ * TEEC_ERROR_EXTERNAL_CANCEL   Deprecated: not specified in client API, use
+ *                              TEE_ERROR_EXTERNAL_CANCEL intead.
  * TEE_ERROR_OVERFLOW           Internal TEE error – documented for completeness
  * TEE_ERROR_TARGET_DEAD        The Trusted Application has terminated.
  * TEEC_ERROR_TARGET_DEAD       The Trusted Application has terminated.
  * TEE_ERROR_STORAGE_NO_SPACE   Internal TEE error – documented for completeness
+ * TEEC_ERROR_STORAGE_NO_SPACE  Deprecated: not specified in client API, use
+ *                              TEE_ERROR_STORAGE_NO_SPACE instead.
  * TEE_ERROR_MAC_INVALID        Internal TEE error – documented for completeness
  * TEE_ERROR_SIGNATURE_INVALID  Internal TEE error – documented for completeness
  * TEE_ERROR_TIME_NOT_SET       Internal TEE error – documented for completeness