Report an update verification failure
Synopsis:
#include <swu/UpdateTargetInterface.h>
swu_result_t swu_target_verification_failed(
swu_target_id_t id,
swu_update_t update,
swu_failure_reason_t reason,
swu_failure_code_t code )
Arguments:
- id
- ID of the UpdateTarget that failed to verify the update.
This ID was assigned by the library in the call to swu_target_register().
- update
- Handle of an Update object representing the update whose installation couldn't be verified
on the target.
- reason
- Constant defined by the swu_failure_reason_t
enumeration for indicating a verification failure (SWU_FAILURE_REASON_INSTALL_VERIFICATION_FAILED).
- code
- User-defined error code to help determine the issue that caused the update installation to fail.
This value is only passed through and isn't used by the library, but logging this value can be handy for debugging.
Library:
libswu-coreUse the -l swu-core option with
qcc to link against the SWU library. This library is usually included automatically.
Description:
Report an update verification failure.
An UpdateTarget (which is referenced in id) calls this function to inform the
UpdateClient that an error occurred while verifying the installation of the update specified in
update. It's expected that the UpdateTarget call this function after returning from
the verify_update function referenced in its associated swu_target_interface_t structure.
Returns:
One of the following swu_result_t values:
- SWU_RESULT_SUCCESS
- The operation succeeded.
- SWU_RESULT_INVALID_ARGUMENT
- An invalid argument was given.
- SWU_RESULT_ERROR
- Another error occurred.