typedef size_t (*FUNC_CRM_HASH_GET_ALG_DIGESTSZ)(const struct crmhashalg *alg);
#define CRM_HASH_GET_ALG_DIGESTSZ                       ((FUNC_CRM_HASH_GET_ALG_DIGESTSZ)(*(uint32_t *)(API_TABLE_BASE_ADDRESS + ATO_CRM_HASH_GET_ALG_DIGESTSZ)))

Return the digest size produced by the given hash algorithm

Digest size

typedef size_t (*FUNC_CRM_HASH_GET_ALG_BLOCKSZ)(const struct crmhashalg *alg);
#define CRM_HASH_GET_ALG_BLOCKSZ                        ((FUNC_CRM_HASH_GET_ALG_BLOCKSZ)(*(uint32_t *)(API_TABLE_BASE_ADDRESS + ATO_CRM_HASH_GET_ALG_BLOCKSZ)))

Return the block size used by the given hash algorithm

Block size

typedef int (*FUNC_CRM_HASH_RESUME_STATE)(struct crmhash *c);
#define CRM_HASH_RESUME_STATE                           ((FUNC_CRM_HASH_RESUME_STATE)(*(uint32_t *)(API_TABLE_BASE_ADDRESS + ATO_CRM_HASH_RESUME_STATE)))

Resume hashing in context-saving (partial hashing). This function shall be called when using context-saving to load the state that was previously saved by CRM_HASH_SAVE_STATE() in the crmhash operation context \p c. It must be called with the same crmhash operation context \p c that was used with CRM_HASH_SAVE_STATE(). It will reserve all hardware resources required to run the partial hashing. pre - CRM_HASH_SAVE_STATE() function must be called before pre - must be called before CRM_HASH_FEED() for the next partial message

CRM_OK CRM_ERR_UNITIALIZED_OBJ

typedef int (*FUNC_CRM_HASH_FEED)(struct crmhash *c, const char *chunk, size_t sz);
#define CRM_HASH_FEED                                   ((FUNC_CRM_HASH_FEED)(*(uint32_t *)(API_TABLE_BASE_ADDRESS + ATO_CRM_HASH_FEED)))

Assign data to be hashed. This function adds a chunk of data to be hashed. It can be called multiple times to assemble pieces of the message scattered in memory. In context-saving, the sum of the sizes of the chunks fed must be multiple of the block size of the algorithm used. If this condition is not met before calling CRM_HASH_SAVE_STATE(), CRM_HASH_SAVE_STATE() will return ::CRM_ERR_WRONG_SIZE_GRANULARITY pre - one of the CRM_HASH_CREATE_*() functions must be called first pre - if in context-saving, CRM_HASH_RESUME_STATE() must be called first

remark - if return value is ::CRM_ERR_FEED_COUNT_EXCEEDED or ::CRM_ERR_TOO_BIG, \p c cannot be used anymore. remark - if this function is called with \p sz equal to 0, no data will be assigned to be hashed, ::CRM_OK will be returned. remark - default maximum number of feeds for single-call digest is 6 and for context-saving is 4. remark - maximum sum of the chunk sizes fed is 2^32-1 bytes

CRM_OK CRM_ERR_UNITIALIZED_OBJ CRM_ERR_FEED_COUNT_EXCEEDED CRM_ERR_TOO_BIG

typedef int (*FUNC_CRM_HASH_SAVE_STATE)(struct crmhash *c);
#define CRM_HASH_SAVE_STATE                             ((FUNC_CRM_HASH_SAVE_STATE)(*(uint32_t *)(API_TABLE_BASE_ADDRESS + ATO_CRM_HASH_SAVE_STATE)))

Starts the partial hashing operation.

This function updates the partial hashing based on the data chunks fed since the last call to CRM_HASH_RESUME_STATE().

In order to export the state of partial hashing, the total size of data fed in the current resume-save step must be multiple of block size of the algorithm used. For SHA1/224/256/SM3 block size is 64 bytes and for SHA384/512 block size is 128 bytes.

The function will return immediately. The hash state will be saved in the crmhash structure after the operation successfully completed. The user shall check operation status with CRM_HASH_STATUS() or CRM_HASH_WAIT(). pre - one of the CRM_HASH_CREATE_*() functions or CRM_HASH_RESUME_STATE() must be called first remark - if return value is ::CRM_ERR_WRONG_SIZE_GRANULARITY, \p c cannot be used anymore. remark - the content of the input data buffers, provided with previous calls to CRM_HASH_FEED(), should not be changed until the operation is completed. Checking the completion of an operation is done by using CRM_HASH_WAIT() or CRM_HASH_STATUS().

CRM_OK CRM_ERR_UNITIALIZED_OBJ CRM_ERR_WRONG_SIZE_GRANULARITY

typedef int (* FUNC_CRM_HASH_DIGEST)(struct crmhash *c, char *digest);
#define CRM_HASH_DIGEST                                 ((FUNC_CRM_HASH_DIGEST)(*(uint32_t *)(API_TABLE_BASE_ADDRESS + ATO_CRM_HASH_DIGEST)))

Starts hash operation.

This function is used to start the computation of the digest. If used in context-saving approach, this function will compute the digest based on last computed state and last chunks of the message.

The function will return immediately. The result will be transfered to \p digest only after the operation is successfully completed. The user shall check operation status with CRM_HASH_STATUS() or CRM_HASH_WAIT().

pre - one of the CRM_HASH_CREATE_*() functions must be called first remark - the content of the input data buffers, provided with previous calls to CRM_HASH_FEED(), should not be changed until the operation is completed. Checking the completion of an operation is done by using CRM_HASH_WAIT() or CRM_HASH_STATUS().

CRM_OK CRM_ERR_UNITIALIZED_OBJ

typedef int (*FUNC_CRM_HASH_WAIT)(struct crmhash *c);
#define CRM_HASH_WAIT                                   ((FUNC_CRM_HASH_WAIT)(*(uint32_t *)(API_TABLE_BASE_ADDRESS + ATO_CRM_HASH_WAIT)))

Waits until the given hash operation has finished This function returns when the hash 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_HASH_CREATE_*() is used. pre - CRM_HASH_DIGEST() functions must be called first pre - if in context-saving, CRM_HASH_SAVE_STATE() must be called first remark - this function is blocking until operation finishes. remark - this function calls CRM_HASH_STATUS() in loop until operation is completed.

CRM_HASH_STATUS()

CRM_OK CRM_ERR_UNITIALIZED_OBJ CRM_ERR_HW_PROCESSING CRM_ERR_DMA_FAILED

typedef int (*FUNC_CRM_HASH_STATUS)(struct crmhash *c);
#define CRM_HASH_STATUS                                 ((FUNC_CRM_HASH_STATUS)(*(uint32_t *)(API_TABLE_BASE_ADDRESS + ATO_CRM_HASH_STATUS)))

Returns the status of the given hash operation context.

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 hash operation has ended and all associated hardware resources used by hash operation context \p c have been released. If CRM_HASH_DIGEST() was used, \p c cannot be used for a new operation until one of the CRM_HASH_CREATE_*() functions is called again. If CRM_HASH_SAVE_STATE() was used, then \p c shall be reused with crm_hash_resume().

pre - CRM_HASH_DIGEST() functions must be called first pre - if in context-saving, CRM_HASH_SAVE_STATE() must be called first.

CRM_HASH_STATUS()

CRM_OK CRM_ERR_UNITIALIZED_OBJ CRM_ERR_HW_PROCESSING CRM_ERR_DMA_FAILED

typedef size_t (*FUNC_CRM_HASH_GET_DIGESTSZ)(struct crmhash *c);
#define CRM_HASH_GET_DIGESTSZ                           ((FUNC_CRM_HASH_GET_DIGESTSZ)(*(uint32_t *)(API_TABLE_BASE_ADDRESS + ATO_CRM_HASH_GET_DIGESTSZ)))

Returns digest size in bytes for the hash operation context

CRM_HASH_STATUS()

Returns digest size

typedef size_t (*FUNC_CRM_HASH_GET_BLOCKSZ)(struct crmhash *c);
#define CRM_HASH_GET_BLOCKSZ                            ((FUNC_CRM_HASH_GET_BLOCKSZ)(*(uint32_t *)(API_TABLE_BASE_ADDRESS + ATO_CRM_HASH_GET_BLOCKSZ)))

pre - one of the CRM_HASH_CREATE() functions must be called first return block size in bytes of the algorithm specified by \p c pre - one of the CRM_HASH_CREATE() functions must be called first

Returns block size

typedef void (*FUNC_CRM_HASH_ABANDON)(struct crmhash *c);
#define CRM_HASH_ABANDON                                ((FUNC_CRM_HASH_ABANDON)(*(uint32_t *)(API_TABLE_BASE_ADDRESS + ATO_CRM_HASH_ABANDON)))

Abandon a created hash operation context. A created hash operation context can have reserved hardware and software resources. Those are free-ed automatically on error or when the operation finishes as reported by CRM_HASH_STATUS() or CRM_HASH_WAIT(). If for some reason, the hash operation will not be started, it can be abandoned which will release all reserved resources. Can only be called after a call to one of the CRM_HASH_CREATE_*() or after crm_hash_resume(). It must be called BEFORE starting to run the operation with CRM_HASH_DIGEST() or CRM_HASH_SAVE_STATE().

None