QuickHash Library

API

SHA1 API Overview

SHA1 API assists you in generating SHA1 message digests.

SHA1 message digests can be generated in two modes: accumulative and non-accumulative.

The accumulative mode is applied when the data for which the digest is calculated (data) represents one or more continuous memory block(s) or when the data is created at runtime in many steps (for instance, when reading a file).

Non-accumulative mode can be applied when the data represents only one continuous memory block.

Note. When the data represents just one continuous memory block, both methods can be applied.

To generate the message digest in the accumulative mode, perform the following:

• Allocate at least SLC_SHA1_CONTEXTSIZE bytes for the context.

• Call the SL_SHA1_Init function to initialize the context.

• Call the SL_SHA1_Update function for each continuous memory block of data to perform the calculations.

Note. You can use SL_SHA1_UpdateStr function (instead of SL_SHA1_Update function) if the data represents a null-terminated string.

• Call the SL_SHA1_Final or the SL_SHA1_FinalHex function to obtain the message digest.

Note. Call the SL_SHA1_FinalHex function when you need to retrieve the hexadecimal string representation of the message digest.

To generate the message digest in the non-accumulative mode, perform the following:

• Call the SL_SHA1_Calculate or the SL_SHA1_CalculateHex function to calculate and retrieve the message digest.

Note 1. Call the SL_SHA1_CalculateHex function when you need to retrieve the hexadecimal string representation of the message digest.

Note 2. You can use SL_SHA1_CalculateStr and SL_SHA1_CalculateStrHex functions (instead of SL_SHA1_Calculate and SL_SHA1_CalculateHex functions) if the data represents a null-terminated string.

 

SHA1 API Functions   |   Useful Links   |   HashCalc

Samples   SHA1 message digest generation for a file

               SHA1 message digest generation for a string