suit_trigger_update()

suit_ssf_err_t suit_trigger_update	(	suit_plat_mreg_t *	regions,
		size_t	len
	)

Trigger the system update procedure.

This function is going to reboot the system. There are no means to pause or abort the upgrade after this function is called.

Note

The envelope must contain at least authentication wrapper and the SUIT manifest.

Parameters

[in]	regions	List of update candidate memory regions (envelope, caches). By convention, the first region holds the SUIT envelope.
[in]	len	Length of the memory regions list.

Return values

SUIT_PLAT_SUCCESS	if successful.
SUIT_PLAT_ERR_INVAL	if input parameters are invalid.
SUIT_PLAT_ERR_NOMEM	if update candidate has too many regions.
SUIT_PLAT_ERR_HW_NOT_READY	if device managing SUIT storage is not initialized.
SUIT_PLAT_ERR_IO	if failed to save the update candidate info.
SUIT_PLAT_ERR_IPC	in case of SSF protocol error.