store.h File Reference

The secure storage ITS store module. More...

#include <zephyr/secure_storage/its/common.h>

Go to the source code of this file.

Functions
psa_status_t	secure_storage_its_store_set (secure_storage_its_uid_t uid, size_t data_length, const void *data)
	Writes the data of an ITS entry to the storage medium.
psa_status_t	secure_storage_its_store_get (secure_storage_its_uid_t uid, size_t data_size, void *data, size_t *data_length)
	Retrieves the data of an ITS entry from the storage medium.
psa_status_t	secure_storage_its_store_remove (secure_storage_its_uid_t uid)
	Removes an ITS entry from the storage medium.

Detailed Description

The secure storage ITS store module.

The functions declared in this header implement the ITS store module. They are meant to be called only by the ITS implementation. This header may be included when providing a custom implementation of the ITS store module (

CONFIG_SECURE_STORAGE_ITS_STORE_IMPLEMENTATION_CUSTOM 

).

Function Documentation

secure_storage_its_store_get()

psa_status_t secure_storage_its_store_get	(	secure_storage_its_uid_t	uid,
		size_t	data_size,
		void *	data,
		size_t *	data_length )

Retrieves the data of an ITS entry from the storage medium.

Parameters

[in]	uid	The entry's UID.
[in]	data_size	The size of data in bytes.
[out]	data	The buffer to which the entry's stored data is written.
[out]	data_length	On success, the number of bytes written to data. May be less than data_size.

Return values

`PSA_SUCCESS`	on success.
`PSA_ERROR_DOES_NOT_EXIST`	if no entry with the given UID exists.
`PSA_ERROR_STORAGE_FAILURE`	on any other failure.

secure_storage_its_store_remove()

psa_status_t secure_storage_its_store_remove

(

secure_storage_its_uid_t

uid

)

Removes an ITS entry from the storage medium.

Parameters

uid	The entry's UID.

Returns

PSA_SUCCESS on success, anything else on failure.

secure_storage_its_store_set()

psa_status_t secure_storage_its_store_set	(	secure_storage_its_uid_t	uid,
		size_t	data_length,
		const void *	data )

Writes the data of an ITS entry to the storage medium.

Parameters

uid	The entry's UID.
data_length	The number of bytes in data.
data	The data to store.

Return values

`PSA_SUCCESS`	on success.
`PSA_ERROR_INSUFFICIENT_STORAGE`	if there is insufficient storage space.
`PSA_ERROR_STORAGE_FAILURE`	on any other failure.