typedef int (*FUNC_CRM_MAC_GENERATE)(struct crmmac *c, char *mac);
#define CRM_MAC_GENERATE                                ((FUNC_CRM_MAC_GENERATE)(*(uint32_t *)(API_TABLE_BASE_ADDRESS + ATO_CRM_MAC_GENERATE)))

Starts MAC generation operation.

This function is used to start MAC generation. The function will return immediately.

The result will be transfered only after the operation is successfully completed. The user shall check operation status with CRM_MAC_STATUS() or CRM_MAC_WAIT(). pre - CRM_MAC_FEED() function must be called first remark - if used with context saving(last chunk), the fed data size for the last chunk can not be 0

CRM_OK CRM_ERR_UNITIALIZED_OBJ CRM_ERR_TOO_SMALL

typedef int (*FUNC_CRM_MAC_RESUME_STATE)(struct crmmac *c);
#define CRM_MAC_RESUME_STATE                            ((FUNC_CRM_MAC_RESUME_STATE)(*(uint32_t *)(API_TABLE_BASE_ADDRESS + ATO_CRM_MAC_RESUME_STATE)))

Resumes MAC operation in context-saving.

This function shall be called when using context-saving to load the state that was previously saved by CRM_MAC_SAVE_STATE() in the crmmac operation context \p c. It must be called with the same crmmac operation context \p c that was used with CRM_MAC_SAVE_STATE(). It will reserve all hardware resources required to run the partial MAC operation. After successful execution of this function, the context \p c can be passed to any of the block cipher functions, except the crm_mac_create_() functions. pre - crm_mac_create_*() and CRM_MAC_SAVE_STATE() functions must be called before, for first part of the message. pre - must be called for each part of the message(besides first), before crm_mac_crypt() or CRM_MAC_SAVE_STATE(). remark - the user must not change the key until all parts of the message to be encrypted/decrypted are processed.

CRM_OK CRM_ERR_UNITIALIZED_OBJ CRM_ERR_CONTEXT_SAVING_NOT_SUPPORTED CRM_ERR_INVALID_KEYREF CRM_ERR_INVALID_KEY_SZ CRM_ERR_INCOMPATIBLE_HW CRM_ERR_RETRY

typedef int (*FUNC_CRM_MAC_SAVE_STATE)(struct crmmac *c);
#define CRM_MAC_SAVE_STATE                              ((FUNC_CRM_MAC_SAVE_STATE)(*(uint32_t *)(API_TABLE_BASE_ADDRESS + ATO_CRM_MAC_SAVE_STATE)))

Starts a partial MAC operation.

This function is used to start a partial MAC operation on data fed using CRM_MAC_FEED(). The function will return immediately. The partial result will be transfered only after the operation is successfully completed. The user shall check operation status with CRM_MAC_STATUS() or CRM_MAC_WAIT(). pre - crm_mac_crypt() should be called first. remark - the user must not change the key until all parts of the message to be encrypted/decrypted are processed.

CRM_OK CRM_ERR_UNITIALIZED_OBJ CRM_ERR_CONTEXT_SAVING_NOT_SUPPORTED CRM_ERR_TOO_SMALL CRM_ERR_WRONG_SIZE_GRANULARITY

typedef int (*FUNC_CRM_MAC_WAIT)(struct crmmac *c);
#define CRM_MAC_WAIT                                    ((FUNC_CRM_MAC_WAIT)(*(uint32_t *)(API_TABLE_BASE_ADDRESS + ATO_CRM_MAC_WAIT)))

Waits until the given MAC generation operation has finished This function returns when the MAC generation operation was successfully completed, or when an error has occurred that caused the operation to terminate. The return value of this function is the operation status. After this call, all resources have been released and \p c cannot be used again unless crm_mac_create_*() is used. remark - this function is blocking until operation finishes.

CRM_MAC_STATUS().

CRM_OK CRM_ERR_UNITIALIZED_OBJ CRM_ERR_DMA_FAILED CRM_ERR_INVALID_TAG

typedef int (*FUNC_CRM_MAC_STATUS)(struct crmmac *c);
#define CRM_MAC_STATUS                                  ((FUNC_CRM_MAC_STATUS)(*(uint32_t *)(API_TABLE_BASE_ADDRESS + ATO_CRM_MAC_STATUS)))

Returns the MAC generation operation status.

If the operation is still ongoing, CRM_ERR_HW_PROCESSING. In that case, the user can retry later.

When this function returns with a code different than ::CRM_ERR_HW_PROCESSING, the MAC generation operation has ended and all resources used by MAC generation operation context \p c have been released. In this case, \p c cannot be used for a new operation until one of the crm_mac_create_*() functions is called again. pre - CRM_MAC_FEED() and CRM_MAC_GENERATE() functions must be called first

CRM_MAC_STATUS().

CRM_OK CRM_ERR_UNITIALIZED_OBJ CRM_ERR_HW_PROCESSING CRM_ERR_DMA_FAILED CRM_ERR_INVALID_TAG