mirror of
https://github.com/yuzu-emu/mbedtls.git
synced 2024-12-25 05:35:37 +00:00
Update documentation of psa_success_t
Now that the type is not an enum, explain what values are valid. Also add a comment to explain the #if defined(PSA_SUCCESS) temporary hack.
This commit is contained in:
parent
c2a7976886
commit
e9a0a9d74d
|
@ -45,18 +45,33 @@ extern "C" {
|
||||||
* @{
|
* @{
|
||||||
*/
|
*/
|
||||||
|
|
||||||
|
#if defined(PSA_SUCCESS)
|
||||||
|
/* If PSA_SUCCESS is defined, assume that PSA crypto is being used
|
||||||
|
* together with PSA IPC, which also defines the identifier
|
||||||
|
* PSA_SUCCESS. We must not define PSA_SUCCESS ourselves in that case;
|
||||||
|
* the other error code names don't clash. Also define psa_status_t as
|
||||||
|
* an alias for the type used by PSA IPC. This is a temporary hack
|
||||||
|
* until we unify error reporting in PSA IPC and PSA crypo.
|
||||||
|
*
|
||||||
|
* Note that psa_defs.h must be included before this header!
|
||||||
|
*/
|
||||||
|
typedef psa_error_t psa_status_t;
|
||||||
|
|
||||||
|
#else /* defined(PSA_SUCCESS) */
|
||||||
|
|
||||||
/**
|
/**
|
||||||
* \brief Function return status.
|
* \brief Function return status.
|
||||||
*
|
*
|
||||||
* Zero indicates success, anything else indicates an error.
|
* This is either #PSA_SUCCESS (which is zero), indicating success,
|
||||||
|
* or a nonzero value indicating that an error occurred. Errors are
|
||||||
|
* encoded as one of the \c PSA_ERROR_xxx values defined here.
|
||||||
*/
|
*/
|
||||||
#if defined(PSA_SUCCESS)
|
|
||||||
typedef psa_error_t psa_status_t;
|
|
||||||
#else
|
|
||||||
typedef int32_t psa_status_t;
|
typedef int32_t psa_status_t;
|
||||||
|
|
||||||
/** The action was completed successfully. */
|
/** The action was completed successfully. */
|
||||||
#define PSA_SUCCESS ((psa_status_t)0)
|
#define PSA_SUCCESS ((psa_status_t)0)
|
||||||
#endif // PSA_SUCCESS
|
|
||||||
|
#endif /* !defined(PSA_SUCCESS) */
|
||||||
|
|
||||||
/** The requested operation or a parameter is not supported
|
/** The requested operation or a parameter is not supported
|
||||||
* by this implementation.
|
* by this implementation.
|
||||||
|
|
Loading…
Reference in a new issue