]>
git.proxmox.com Git - mirror_edk2.git/blob - CryptoPkg/Library/BaseCryptLib/Hash/CryptSha1.c
52e767524f7b6995a227ffa7974638be664244cd
2 SHA-1 Digest Wrapper Implementation over OpenSSL.
4 Copyright (c) 2009 - 2016, Intel Corporation. All rights reserved.<BR>
5 SPDX-License-Identifier: BSD-2-Clause-Patent
9 #include "InternalCryptLib.h"
10 #include <openssl/sha.h>
12 #ifndef DISABLE_SHA1_DEPRECATED_INTERFACES
14 Retrieves the size, in bytes, of the context buffer required for SHA-1 hash operations.
16 @return The size, in bytes, of the context buffer required for SHA-1 hash operations.
26 // Retrieves OpenSSL SHA Context Size
28 return (UINTN
) (sizeof (SHA_CTX
));
32 Initializes user-supplied memory pointed by Sha1Context as SHA-1 hash context for
35 If Sha1Context is NULL, then return FALSE.
37 @param[out] Sha1Context Pointer to SHA-1 context being initialized.
39 @retval TRUE SHA-1 context initialization succeeded.
40 @retval FALSE SHA-1 context initialization failed.
50 // Check input parameters.
52 if (Sha1Context
== NULL
) {
57 // OpenSSL SHA-1 Context Initialization
59 return (BOOLEAN
) (SHA1_Init ((SHA_CTX
*) Sha1Context
));
63 Makes a copy of an existing SHA-1 context.
65 If Sha1Context is NULL, then return FALSE.
66 If NewSha1Context is NULL, then return FALSE.
68 @param[in] Sha1Context Pointer to SHA-1 context being copied.
69 @param[out] NewSha1Context Pointer to new SHA-1 context.
71 @retval TRUE SHA-1 context copy succeeded.
72 @retval FALSE SHA-1 context copy failed.
78 IN CONST VOID
*Sha1Context
,
79 OUT VOID
*NewSha1Context
83 // Check input parameters.
85 if (Sha1Context
== NULL
|| NewSha1Context
== NULL
) {
89 CopyMem (NewSha1Context
, Sha1Context
, sizeof (SHA_CTX
));
95 Digests the input data and updates SHA-1 context.
97 This function performs SHA-1 digest on a data buffer of the specified size.
98 It can be called multiple times to compute the digest of long or discontinuous data streams.
99 SHA-1 context should be already correctly initialized by Sha1Init(), and should not be finalized
100 by Sha1Final(). Behavior with invalid context is undefined.
102 If Sha1Context is NULL, then return FALSE.
104 @param[in, out] Sha1Context Pointer to the SHA-1 context.
105 @param[in] Data Pointer to the buffer containing the data to be hashed.
106 @param[in] DataSize Size of Data buffer in bytes.
108 @retval TRUE SHA-1 data digest succeeded.
109 @retval FALSE SHA-1 data digest failed.
115 IN OUT VOID
*Sha1Context
,
121 // Check input parameters.
123 if (Sha1Context
== NULL
) {
128 // Check invalid parameters, in case that only DataLength was checked in OpenSSL
130 if (Data
== NULL
&& DataSize
!= 0) {
135 // OpenSSL SHA-1 Hash Update
137 return (BOOLEAN
) (SHA1_Update ((SHA_CTX
*) Sha1Context
, Data
, DataSize
));
141 Completes computation of the SHA-1 digest value.
143 This function completes SHA-1 hash computation and retrieves the digest value into
144 the specified memory. After this function has been called, the SHA-1 context cannot
146 SHA-1 context should be already correctly initialized by Sha1Init(), and should not be
147 finalized by Sha1Final(). Behavior with invalid SHA-1 context is undefined.
149 If Sha1Context is NULL, then return FALSE.
150 If HashValue is NULL, then return FALSE.
152 @param[in, out] Sha1Context Pointer to the SHA-1 context.
153 @param[out] HashValue Pointer to a buffer that receives the SHA-1 digest
156 @retval TRUE SHA-1 digest computation succeeded.
157 @retval FALSE SHA-1 digest computation failed.
163 IN OUT VOID
*Sha1Context
,
168 // Check input parameters.
170 if (Sha1Context
== NULL
|| HashValue
== NULL
) {
175 // OpenSSL SHA-1 Hash Finalization
177 return (BOOLEAN
) (SHA1_Final (HashValue
, (SHA_CTX
*) Sha1Context
));
181 Computes the SHA-1 message digest of a input data buffer.
183 This function performs the SHA-1 message digest of a given data buffer, and places
184 the digest value into the specified memory.
186 If this interface is not supported, then return FALSE.
188 @param[in] Data Pointer to the buffer containing the data to be hashed.
189 @param[in] DataSize Size of Data buffer in bytes.
190 @param[out] HashValue Pointer to a buffer that receives the SHA-1 digest
193 @retval TRUE SHA-1 digest computation succeeded.
194 @retval FALSE SHA-1 digest computation failed.
195 @retval FALSE This interface is not supported.
207 // Check input parameters.
209 if (HashValue
== NULL
) {
212 if (Data
== NULL
&& DataSize
!= 0) {
217 // OpenSSL SHA-1 Hash Computation.
219 if (SHA1 (Data
, DataSize
, HashValue
) == NULL
) {