123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120 |
- /**************************************************************************************
- * Copyright (c) 2016-2017, ARM Limited or its affiliates. All rights reserved *
- * *
- * This file and the related binary are licensed under the following license: *
- * *
- * ARM Object Code and Header Files License, v1.0 Redistribution. *
- * *
- * Redistribution and use of object code, header files, and documentation, without *
- * modification, are permitted provided that the following conditions are met: *
- * *
- * 1) Redistributions must reproduce the above copyright notice and the *
- * following disclaimer in the documentation and/or other materials *
- * provided with the distribution. *
- * *
- * 2) Unless to the extent explicitly permitted by law, no reverse *
- * engineering, decompilation, or disassembly of is permitted. *
- * *
- * 3) Redistribution and use is permitted solely for the purpose of *
- * developing or executing applications that are targeted for use *
- * on an ARM-based product. *
- * *
- * DISCLAIMER. THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND *
- * CONTRIBUTORS "AS IS." ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT *
- * NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY, NON-INFRINGEMENT, *
- * AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE *
- * COPYRIGHT HOLDERS OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, *
- * SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED *
- * TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR *
- * PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF *
- * LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING *
- * NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS *
- * SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. *
- **************************************************************************************/
- #ifndef NRF_CC310_BL_HASH_SHA256_H__
- #define NRF_CC310_BL_HASH_SHA256_H__
- /**@file
- *
- * @defgroup nrf_cc310_bl_hash_sha256 nrf_cc310_bl Hash SHA-256 API
- * @ingroup nrf_cc310_bl
- * @brief Type definitions and public APIs for nrf_cc310_bl HASH using SHA-256.
- * @{
- */
- #include <stdint.h>
- #include "nrf_cc310_bl_hash_common.h"
- #include "crys_error.h"
- #ifdef __cplusplus
- extern "C" {
- #endif
- /**@brief Structure to hold SHA-256 context information.
- */
- typedef struct
- {
- uint32_t init_val;
- uint8_t context_buffer[NRF_CC310_BL_HASH_CONTEXT_BUFFER_SIZE_SHA256];
- } nrf_cc310_bl_hash_context_sha256_t;
- /**@brief Array to hold SHA-256 hash digest.
- */
- typedef uint8_t nrf_cc310_bl_hash_digest_sha256_t[NRF_CC310_BL_SHA256_DIGEST_SIZE_IN_BYTES];
- /**@brief Function for initializing the SHA-256 context.
- *
- * @note Memory pointed to in hash context must be allocated prior to this call.
- *
- * @param[in,out] p_hash_context Structure holding context information for
- * the SHA-256 operation.
- *
- * @retval CRYS_OK If call was successful.
- * @retval CRYS_HASH_INVALID_USER_CONTEXT_POINTER_ERROR p_hash_context was NULL.
- */
- CRYSError_t nrf_cc310_bl_hash_sha256_init(
- nrf_cc310_bl_hash_context_sha256_t * const p_hash_context);
- /** @brief Function for running an update to the SHA-256 hash calculation.
- *
- * @param[in,out] p_hash_context Structure holding context information
- * for the SHA-256 operation.
- *
- * @retval CRYS_OK If call was successful.
- * @retval CRYS_HASH_INVALID_USER_CONTEXT_POINTER_ERROR p_hash_context was NULL.
- * @retval CRYS_HASH_USER_CONTEXT_CORRUPTED_ERROR p_hash_context not initialized.
- * @retval CRYS_HASH_LAST_BLOCK_ALREADY_PROCESSED_ERROR p_hash_context already finalized.
- */
- CRYSError_t nrf_cc310_bl_hash_sha256_update(
- nrf_cc310_bl_hash_context_sha256_t * const p_hash_context,
- uint8_t const * p_src,
- uint32_t len);
- /** @brief Function for finalizing the hash calculation.
- *
- * @note Memory pointed to in hash digest must be allocated prior to this call.
- *
- * @param[in,out] p_hash_context Structure holding context information for
- * the SHA-256 operation.
- * @param[in,out] p_hash_digest Pointer to the structure holding SHA-256
- * hash digest. Data pointed to must be 32 bytes long.
- *
- * @retval CRYS_HASH_INVALID_USER_CONTEXT_POINTER_ERROR p_hash_context was NULL.
- * @retval CRYS_HASH_USER_CONTEXT_CORRUPTED_ERROR p_hash_context was corrupted.
- * @retval CRYS_HASH_INVALID_RESULT_BUFFER_POINTER_ERROR p_digest was NULL.
- */
- CRYSError_t nrf_cc310_bl_hash_sha256_finalize(
- nrf_cc310_bl_hash_context_sha256_t * const p_hash_context,
- nrf_cc310_bl_hash_digest_sha256_t * const p_digest);
- #ifdef __cplusplus
- }
- #endif
- /** @} */
- #endif // NRF_CC310_BL_HASH_SHA256_H__
|