1. Add TCG MOR (Memory Overwrite request) definition from TCG Platform Reset Attack...
[efi/edk2/.git] / edk2 / MdePkg / Include / Protocol / Hash.h
1 /** @file\r
2   EFI_HASH_SERVICE_BINDING_PROTOCOL as defined in UEFI 2.0.\r
3   EFI_HASH_PROTOCOL as defined in UEFI 2.0.\r
4   The EFI Hash Service Binding Protocol is used to locate hashing services support \r
5   provided by a driver and to create and destroy instances of the EFI Hash Protocol \r
6   so that a multiple drivers can use the underlying hashing services.\r
7 \r
8   Copyright (c) 2006 - 2009, Intel Corporation                                                         \r
9   All rights reserved. This program and the accompanying materials                          \r
10   are licensed and made available under the terms and conditions of the BSD License         \r
11   which accompanies this distribution.  The full text of the license may be found at        \r
12   http://opensource.org/licenses/bsd-license.php                                            \r
13 \r
14   THE PROGRAM IS DISTRIBUTED UNDER THE BSD LICENSE ON AN "AS IS" BASIS,                     \r
15   WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.             \r
16 \r
17 **/\r
18 \r
19 #ifndef __EFI_HASH_PROTOCOL_H__\r
20 #define __EFI_HASH_PROTOCOL_H__\r
21 \r
22 #define EFI_HASH_SERVICE_BINDING_PROTOCOL_GUID \\r
23   { \\r
24     0x42881c98, 0xa4f3, 0x44b0, {0xa3, 0x9d, 0xdf, 0xa1, 0x86, 0x67, 0xd8, 0xcd } \\r
25   }\r
26   \r
27 #define EFI_HASH_PROTOCOL_GUID \\r
28   { \\r
29     0xc5184932, 0xdba5, 0x46db, {0xa5, 0xba, 0xcc, 0x0b, 0xda, 0x9c, 0x14, 0x35 } \\r
30   }\r
31 \r
32 #define EFI_HASH_ALGORITHM_SHA1_GUID \\r
33   { \\r
34     0x2ae9d80f, 0x3fb2, 0x4095, {0xb7, 0xb1, 0xe9, 0x31, 0x57, 0xb9, 0x46, 0xb6 } \\r
35   }\r
36 \r
37 #define EFI_HASH_ALGORITHM_SHA224_GUID \\r
38   { \\r
39     0x8df01a06, 0x9bd5, 0x4bf7, {0xb0, 0x21, 0xdb, 0x4f, 0xd9, 0xcc, 0xf4, 0x5b } \\r
40   } \r
41 \r
42 #define EFI_HASH_ALGORITHM_SHA256_GUID \\r
43   { \\r
44     0x51aa59de, 0xfdf2, 0x4ea3, {0xbc, 0x63, 0x87, 0x5f, 0xb7, 0x84, 0x2e, 0xe9 } \\r
45   } \r
46 \r
47 #define EFI_HASH_ALGORITHM_SHA384_GUID \\r
48   { \\r
49     0xefa96432, 0xde33, 0x4dd2, {0xae, 0xe6, 0x32, 0x8c, 0x33, 0xdf, 0x77, 0x7a } \\r
50   } \r
51 \r
52 #define EFI_HASH_ALGORITHM_SHA512_GUID \\r
53   { \\r
54     0xcaa4381e, 0x750c, 0x4770, {0xb8, 0x70, 0x7a, 0x23, 0xb4, 0xe4, 0x21, 0x30 } \\r
55   }\r
56 \r
57 #define EFI_HASH_ALGORTIHM_MD5_GUID \\r
58   { \\r
59     0xaf7c79c, 0x65b5, 0x4319, {0xb0, 0xae, 0x44, 0xec, 0x48, 0x4e, 0x4a, 0xd7 } \\r
60   }\r
61 \r
62 typedef struct _EFI_HASH_PROTOCOL EFI_HASH_PROTOCOL;\r
63 \r
64 typedef UINT8  EFI_MD5_HASH[16];\r
65 typedef UINT8  EFI_SHA1_HASH[20];\r
66 typedef UINT8  EFI_SHA224_HASH[28];\r
67 typedef UINT8  EFI_SHA256_HASH[32];\r
68 typedef UINT8  EFI_SHA384_HASH[48];\r
69 typedef UINT8  EFI_SHA512_HASH[64];\r
70 \r
71 typedef union {\r
72   EFI_MD5_HASH     *Md5Hash;\r
73   EFI_SHA1_HASH    *Sha1Hash;\r
74   EFI_SHA224_HASH  *Sha224Hash;\r
75   EFI_SHA256_HASH  *Sha256Hash;\r
76   EFI_SHA384_HASH  *Sha384Hash;\r
77   EFI_SHA512_HASH  *Sha512Hash;\r
78 } EFI_HASH_OUTPUT;\r
79 \r
80 /**\r
81   Returns the size of the hash which results from a specific algorithm.\r
82 \r
83   @param[in]  This                  Points to this instance of EFI_HASH_PROTOCOL.\r
84   @param[in]  HashAlgorithm         Points to the EFI_GUID which identifies the algorithm to use.\r
85   @param[out] HashSize              Holds the returned size of the algorithm's hash.\r
86 \r
87   @retval EFI_SUCCESS           Hash size returned successfully.\r
88   @retval EFI_INVALID_PARAMETER HashSize is NULL\r
89   @retval EFI_UNSUPPORTED       The algorithm specified by HashAlgorithm is not supported \r
90                                 by this driver.\r
91 \r
92 **/\r
93 typedef\r
94 EFI_STATUS\r
95 (EFIAPI *EFI_HASH_GET_HASH_SIZE)(\r
96   IN  CONST EFI_HASH_PROTOCOL     *This,\r
97   IN  CONST EFI_GUID              *HashAlgorithm,\r
98   OUT UINTN                       *HashSize\r
99   );      \r
100 \r
101 /**\r
102   Returns the size of the hash which results from a specific algorithm.\r
103 \r
104   @param[in]  This          Points to this instance of EFI_HASH_PROTOCOL.\r
105   @param[in]  HashAlgorithm Points to the EFI_GUID which identifies the algorithm to use.\r
106   @param[in]  Extend        Specifies whether to create a new hash (FALSE) or extend the specified\r
107                             existing hash (TRUE).\r
108   @param[in]  Message       Points to the start of the message.\r
109   @param[in]  MessageSize   The size of Message, in bytes.\r
110   @param[in,out]  Hash      On input, if Extend is TRUE, then this holds the hash to extend. On\r
111                             output, holds the resulting hash computed from the message.\r
112 \r
113   @retval EFI_SUCCESS           Hash returned successfully.\r
114   @retval EFI_INVALID_PARAMETER Message or Hash is NULL\r
115   @retval EFI_UNSUPPORTED       The algorithm specified by HashAlgorithm is not supported by this\r
116                                  driver. Or extend is TRUE and the algorithm doesn't support extending the hash.\r
117 \r
118 **/\r
119 typedef\r
120 EFI_STATUS\r
121 (EFIAPI *EFI_HASH_HASH)(\r
122   IN CONST EFI_HASH_PROTOCOL      *This,\r
123   IN CONST EFI_GUID               *HashAlgorithm,\r
124   IN BOOLEAN                      Extend,\r
125   IN CONST UINT8                  *Message,\r
126   IN UINT64                       MessageSize,\r
127   IN OUT EFI_HASH_OUTPUT          *Hash\r
128   );    \r
129 \r
130 ///\r
131 /// This protocol allows creating a hash of an arbitrary message digest \r
132 /// using one or more hash algorithms.\r
133 ///\r
134 struct _EFI_HASH_PROTOCOL {\r
135   EFI_HASH_GET_HASH_SIZE          GetHashSize;\r
136   EFI_HASH_HASH                   Hash;\r
137 };\r
138 \r
139 extern EFI_GUID gEfiHashServiceBindingProtocolGuid;\r
140 extern EFI_GUID gEfiHashProtocolGuid;\r
141 extern EFI_GUID gEfiHashAlgorithmSha1Guid;\r
142 extern EFI_GUID gEfiHashAlgorithmSha224Guid;\r
143 extern EFI_GUID gEfiHashAlgorithmSha256Guid;\r
144 extern EFI_GUID gEfiHashAlgorithmSha384Guid;\r
145 extern EFI_GUID gEfiHashAlgorithmSha512Guid;\r
146 extern EFI_GUID gEfiHashAlgorithmMD5Guid;\r
147 \r
148 #endif\r