Mbed TLS v3.6.3
 All Data Structures Files Functions Variables Typedefs Enumerations Enumerator Macros Groups Pages
Macros | Functions
psa_util.h File Reference

Utility functions for the use of the PSA Crypto library. More...

#include "mbedtls/private_access.h"
#include "mbedtls/build_info.h"
#include "mbedcrypto/psa/crypto.h"
#include "mbedtls/asn1write.h"
Include dependency graph for psa_util.h:

Go to the source code of this file.

Macros

#define MBEDTLS_PSA_RANDOM_STATE   NULL
 

Functions

int mbedtls_psa_get_random (void *p_rng, unsigned char *output, size_t output_size)
 
static psa_algorithm_t mbedtls_md_psa_alg_from_type (mbedtls_md_type_t md_type)
 This function returns the PSA algorithm identifier associated with the given digest type. More...
 
static mbedtls_md_type_t mbedtls_md_type_from_psa_alg (psa_algorithm_t psa_alg)
 This function returns the given digest type associated with the PSA algorithm identifier. More...
 

Detailed Description

Utility functions for the use of the PSA Crypto library.

Definition in file psa_util.h.

Macro Definition Documentation

#define MBEDTLS_PSA_RANDOM_STATE   NULL

The random generator state for the PSA subsystem.

This macro always expands to NULL because the p_rng parameter is unused in mbedtls_psa_get_random(), but it's kept for interface's backward compatibility.

Definition at line 67 of file psa_util.h.

Function Documentation

int mbedtls_psa_get_random ( void *  p_rng,
unsigned char *  output,
size_t  output_size 
)

The random generator function for the PSA subsystem.

This function is suitable as the f_rng random generator function parameter of many mbedtls_xxx functions.

The implementation of this function depends on the configuration of the library.

Note
This function may only be used if the PSA crypto subsystem is active. This means that you must call psa_crypto_init() before any call to this function, and you must not call this function after calling mbedtls_psa_crypto_free().
Parameters
p_rngThis parameter is only kept for backward compatibility reasons with legacy f_rng functions and it's ignored. Set to MBEDTLS_PSA_RANDOM_STATE or NULL.
outputThe buffer to fill. It must have room for output_size bytes.
output_sizeThe number of bytes to write to output. This function may fail if output_size is too large. It is guaranteed to accept any output size requested by Mbed TLS library functions. The maximum request size depends on the library configuration.
Returns
0 on success.
An MBEDTLS_ERR_ENTROPY_xxx, MBEDTLS_ERR_PLATFORM_xxx, MBEDTLS_ERR_CTR_DRBG_xxxor MBEDTLS_ERR_HMAC_DRBG_xxx` on error.