]> git.proxmox.com Git - mirror_edk2.git/blame - CryptoPkg/Library/BaseCryptLib/Hash/CryptSha1.c
Use SmmStatusCode protocol in EfiInitializeSmmDriverLib() funciton.
[mirror_edk2.git] / CryptoPkg / Library / BaseCryptLib / Hash / CryptSha1.c
CommitLineData
97f98500
HT
1/** @file\r
2 SHA-1 Digest Wrapper Implementation over OpenSSL.\r
3\r
4Copyright (c) 2009 - 2010, Intel Corporation. All rights reserved.<BR>\r
5This program and the accompanying materials\r
6are licensed and made available under the terms and conditions of the BSD License\r
7which accompanies this distribution. The full text of the license may be found at\r
8http://opensource.org/licenses/bsd-license.php\r
9\r
10THE PROGRAM IS DISTRIBUTED UNDER THE BSD LICENSE ON AN "AS IS" BASIS,\r
11WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.\r
12\r
13**/\r
14\r
a8c44645 15#include "InternalCryptLib.h"\r
97f98500
HT
16#include <openssl/sha.h>\r
17\r
18\r
19/**\r
20 Retrieves the size, in bytes, of the context buffer required for SHA-1 hash operations.\r
21\r
22 @return The size, in bytes, of the context buffer required for SHA-1 hash operations.\r
23\r
24**/\r
25UINTN\r
26EFIAPI\r
27Sha1GetContextSize (\r
28 VOID\r
29 )\r
30{\r
31 //\r
32 // Retrieves OpenSSL SHA Context Size\r
33 //\r
34 return (UINTN)(sizeof (SHA_CTX));\r
35}\r
36\r
97f98500 37/**\r
a8c44645 38 Initializes user-supplied memory pointed by Sha1Context as SHA-1 hash context for\r
97f98500
HT
39 subsequent use.\r
40\r
41 If Sha1Context is NULL, then ASSERT().\r
42\r
a8c44645 43 @param[out] Sha1Context Pointer to SHA-1 context being initialized.\r
97f98500 44\r
a8c44645 45 @retval TRUE SHA-1 context initialization succeeded.\r
46 @retval FALSE SHA-1 context initialization failed.\r
97f98500
HT
47\r
48**/\r
49BOOLEAN\r
50EFIAPI\r
51Sha1Init (\r
a8c44645 52 OUT VOID *Sha1Context\r
97f98500
HT
53 )\r
54{\r
55 //\r
56 // ASSERT if Sha1Context is NULL\r
57 //\r
58 ASSERT (Sha1Context != NULL);\r
59\r
60 //\r
61 // OpenSSL SHA-1 Context Initialization\r
62 //\r
63 return (BOOLEAN) (SHA1_Init ((SHA_CTX *)Sha1Context));\r
64}\r
65\r
a8c44645 66/**\r
67 Makes a copy of an existing SHA-1 context.\r
68\r
69 If Sha1Context is NULL, then ASSERT().\r
70 If NewSha1Context is NULL, then ASSERT().\r
71\r
72 @param[in] Sha1Context Pointer to SHA-1 context being copied.\r
73 @param[out] NewSha1Context Pointer to new SHA-1 context.\r
74\r
75 @retval TRUE SHA-1 context copy succeeded.\r
76 @retval FALSE SHA-1 context copy failed.\r
77\r
78**/\r
79BOOLEAN\r
80EFIAPI\r
81Sha1Duplicate (\r
82 IN CONST VOID *Sha1Context,\r
83 OUT VOID *NewSha1Context\r
84 )\r
85{\r
86 CopyMem (NewSha1Context, Sha1Context, sizeof (SHA_CTX));\r
87\r
88 return TRUE;\r
89}\r
97f98500
HT
90\r
91/**\r
a8c44645 92 Digests the input data and updates SHA-1 context.\r
93\r
94 This function performs SHA-1 digest on a data buffer of the specified size.\r
95 It can be called multiple times to compute the digest of long or discontinuous data streams.\r
96 SHA-1 context should be already correctly intialized by Sha1Init(), and should not be finalized\r
97 by Sha1Final(). Behavior with invalid context is undefined.\r
97f98500
HT
98\r
99 If Sha1Context is NULL, then ASSERT().\r
100\r
101 @param[in, out] Sha1Context Pointer to the SHA-1 context.\r
102 @param[in] Data Pointer to the buffer containing the data to be hashed.\r
a8c44645 103 @param[in] DataSize Size of Data buffer in bytes.\r
97f98500
HT
104\r
105 @retval TRUE SHA-1 data digest succeeded.\r
a8c44645 106 @retval FALSE SHA-1 data digest failed.\r
97f98500
HT
107\r
108**/\r
109BOOLEAN\r
110EFIAPI\r
111Sha1Update (\r
112 IN OUT VOID *Sha1Context,\r
113 IN CONST VOID *Data,\r
a8c44645 114 IN UINTN DataSize\r
97f98500
HT
115 )\r
116{\r
117 //\r
118 // ASSERT if Sha1Context is NULL\r
119 //\r
120 ASSERT (Sha1Context != NULL);\r
121\r
122 //\r
123 // ASSERT if invalid parameters, in case that only DataLength was checked in OpenSSL\r
124 //\r
125 if (Data == NULL) {\r
a8c44645 126 ASSERT (DataSize == 0);\r
97f98500
HT
127 }\r
128\r
129 //\r
130 // OpenSSL SHA-1 Hash Update\r
131 //\r
a8c44645 132 return (BOOLEAN) (SHA1_Update ((SHA_CTX *)Sha1Context, Data, DataSize));\r
97f98500
HT
133}\r
134\r
97f98500 135/**\r
a8c44645 136 Completes computation of the SHA-1 digest value.\r
137\r
138 This function completes SHA-1 hash computation and retrieves the digest value into\r
139 the specified memory. After this function has been called, the SHA-1 context cannot\r
140 be used again.\r
141 SHA-1 context should be already correctly intialized by Sha1Init(), and should not be\r
142 finalized by Sha1Final(). Behavior with invalid SHA-1 context is undefined.\r
97f98500
HT
143\r
144 If Sha1Context is NULL, then ASSERT().\r
145 If HashValue is NULL, then ASSERT().\r
146\r
a8c44645 147 @param[in, out] Sha1Context Pointer to the SHA-1 context.\r
97f98500
HT
148 @param[out] HashValue Pointer to a buffer that receives the SHA-1 digest\r
149 value (20 bytes).\r
150\r
151 @retval TRUE SHA-1 digest computation succeeded.\r
152 @retval FALSE SHA-1 digest computation failed.\r
153\r
154**/\r
155BOOLEAN\r
156EFIAPI\r
157Sha1Final (\r
158 IN OUT VOID *Sha1Context,\r
159 OUT UINT8 *HashValue\r
160 )\r
161{\r
162 //\r
163 // ASSERT if Sha1Context is NULL or HashValue is NULL\r
164 //\r
165 ASSERT (Sha1Context != NULL);\r
166 ASSERT (HashValue != NULL);\r
167\r
168 //\r
169 // OpenSSL SHA-1 Hash Finalization\r
170 //\r
171 return (BOOLEAN) (SHA1_Final (HashValue, (SHA_CTX *)Sha1Context));\r
172}\r