]> git.proxmox.com Git - mirror_edk2.git/blobdiff - CryptoPkg/Driver/Crypto.c
CryptoPkg/BaseCrpytLib: Retire MD4 algorithm
[mirror_edk2.git] / CryptoPkg / Driver / Crypto.c
index ed0083cccf8fd539c396a96847a83aad0df3a87b..53ee0edea5c4ab8fc70d915446bf267649d6e482 100644 (file)
@@ -124,161 +124,123 @@ CryptoServiceGetCryptoVersion (
 //=====================================================================================\r
 \r
 /**\r
-  Retrieves the size, in bytes, of the context buffer required for MD4 hash operations.\r
+  MD4 is deprecated and unsupported any longer.\r
+  Keep the function field for binary compability.\r
 \r
-  If this interface is not supported, then return zero.\r
-\r
-  @return  The size, in bytes, of the context buffer required for MD4 hash operations.\r
   @retval  0   This interface is not supported.\r
 \r
 **/\r
 UINTN\r
 EFIAPI\r
-CryptoServiceMd4GetContextSize (\r
+DeprecatedCryptoServiceMd4GetContextSize (\r
   VOID\r
   )\r
 {\r
-  return CALL_BASECRYPTLIB (Md4.Services.GetContextSize, Md4GetContextSize, (), 0);\r
+  return BaseCryptLibServiceDeprecated ("Md4GetContextSize"), 0;\r
 }\r
 \r
 /**\r
-  Initializes user-supplied memory pointed by Md4Context as MD4 hash context for\r
-  subsequent use.\r
-\r
-  If Md4Context is NULL, then return FALSE.\r
-  If this interface is not supported, then return FALSE.\r
+  MD4 is deprecated and unsupported any longer.\r
+  Keep the function field for binary compability.\r
 \r
   @param[out]  Md4Context  Pointer to MD4 context being initialized.\r
 \r
-  @retval TRUE   MD4 context initialization succeeded.\r
-  @retval FALSE  MD4 context initialization failed.\r
   @retval FALSE  This interface is not supported.\r
 \r
 **/\r
 BOOLEAN\r
 EFIAPI\r
-CryptoServiceMd4Init (\r
+DeprecatedCryptoServiceMd4Init (\r
   OUT  VOID  *Md4Context\r
   )\r
 {\r
-  return CALL_BASECRYPTLIB (Md4.Services.Init, Md4Init, (Md4Context), FALSE);\r
+  return BaseCryptLibServiceDeprecated ("Md4Init"), FALSE;\r
 }\r
 \r
 /**\r
-  Makes a copy of an existing MD4 context.\r
-\r
-  If Md4Context is NULL, then return FALSE.\r
-  If NewMd4Context is NULL, then return FALSE.\r
-  If this interface is not supported, then return FALSE.\r
+  MD4 is deprecated and unsupported any longer.\r
+  Keep the function field for binary compability.\r
 \r
   @param[in]  Md4Context     Pointer to MD4 context being copied.\r
   @param[out] NewMd4Context  Pointer to new MD4 context.\r
 \r
-  @retval TRUE   MD4 context copy succeeded.\r
-  @retval FALSE  MD4 context copy failed.\r
   @retval FALSE  This interface is not supported.\r
 \r
 **/\r
 BOOLEAN\r
 EFIAPI\r
-CryptoServiceMd4Duplicate (\r
+DeprecatedCryptoServiceMd4Duplicate (\r
   IN   CONST VOID  *Md4Context,\r
   OUT  VOID        *NewMd4Context\r
   )\r
 {\r
-  return CALL_BASECRYPTLIB (Md4.Services.Duplicate, Md4Duplicate, (Md4Context, NewMd4Context), FALSE);\r
+  return BaseCryptLibServiceDeprecated ("Md4Duplicate"), FALSE;\r
 }\r
 \r
 /**\r
-  Digests the input data and updates MD4 context.\r
-\r
-  This function performs MD4 digest on a data buffer of the specified size.\r
-  It can be called multiple times to compute the digest of long or discontinuous data streams.\r
-  MD4 context should be already correctly initialized by Md4Init(), and should not be finalized\r
-  by Md4Final(). Behavior with invalid context is undefined.\r
-\r
-  If Md4Context is NULL, then return FALSE.\r
-  If this interface is not supported, then return FALSE.\r
+  MD4 is deprecated and unsupported any longer.\r
+  Keep the function field for binary compability.\r
 \r
   @param[in, out]  Md4Context  Pointer to the MD4 context.\r
   @param[in]       Data        Pointer to the buffer containing the data to be hashed.\r
   @param[in]       DataSize    Size of Data buffer in bytes.\r
 \r
-  @retval TRUE   MD4 data digest succeeded.\r
-  @retval FALSE  MD4 data digest failed.\r
   @retval FALSE  This interface is not supported.\r
 \r
 **/\r
 BOOLEAN\r
 EFIAPI\r
-CryptoServiceMd4Update (\r
+DeprecatedCryptoServiceMd4Update (\r
   IN OUT  VOID        *Md4Context,\r
   IN      CONST VOID  *Data,\r
   IN      UINTN       DataSize\r
   )\r
 {\r
-  return CALL_BASECRYPTLIB (Md4.Services.Update, Md4Update, (Md4Context, Data, DataSize), FALSE);\r
+  return BaseCryptLibServiceDeprecated ("Md4Update"), FALSE;\r
 }\r
 \r
 /**\r
-  Completes computation of the MD4 digest value.\r
-\r
-  This function completes MD4 hash computation and retrieves the digest value into\r
-  the specified memory. After this function has been called, the MD4 context cannot\r
-  be used again.\r
-  MD4 context should be already correctly initialized by Md4Init(), and should not be\r
-  finalized by Md4Final(). Behavior with invalid MD4 context is undefined.\r
-\r
-  If Md4Context is NULL, then return FALSE.\r
-  If HashValue is NULL, then return FALSE.\r
-  If this interface is not supported, then return FALSE.\r
+  MD4 is deprecated and unsupported any longer.\r
+  Keep the function field for binary compability.\r
 \r
   @param[in, out]  Md4Context  Pointer to the MD4 context.\r
   @param[out]      HashValue   Pointer to a buffer that receives the MD4 digest\r
                                value (16 bytes).\r
 \r
-  @retval TRUE   MD4 digest computation succeeded.\r
-  @retval FALSE  MD4 digest computation failed.\r
   @retval FALSE  This interface is not supported.\r
 \r
 **/\r
 BOOLEAN\r
 EFIAPI\r
-CryptoServiceMd4Final (\r
+DeprecatedCryptoServiceMd4Final (\r
   IN OUT  VOID   *Md4Context,\r
   OUT     UINT8  *HashValue\r
   )\r
 {\r
-  return CALL_BASECRYPTLIB (Md4.Services.Final, Md4Final, (Md4Context, HashValue), FALSE);\r
+  return BaseCryptLibServiceDeprecated ("Md4Final"), FALSE;\r
 }\r
 \r
 /**\r
-  Computes the MD4 message digest of a input data buffer.\r
-\r
-  This function performs the MD4 message digest of a given data buffer, and places\r
-  the digest value into the specified memory.\r
-\r
-  If this interface is not supported, then return FALSE.\r
+  MD4 is deprecated and unsupported any longer.\r
+  Keep the function field for binary compability.\r
 \r
   @param[in]   Data        Pointer to the buffer containing the data to be hashed.\r
   @param[in]   DataSize    Size of Data buffer in bytes.\r
   @param[out]  HashValue   Pointer to a buffer that receives the MD4 digest\r
                            value (16 bytes).\r
 \r
-  @retval TRUE   MD4 digest computation succeeded.\r
-  @retval FALSE  MD4 digest computation failed.\r
   @retval FALSE  This interface is not supported.\r
 \r
 **/\r
 BOOLEAN\r
 EFIAPI\r
-CryptoServiceMd4HashAll (\r
+DeprecatedCryptoServiceMd4HashAll (\r
   IN   CONST VOID  *Data,\r
   IN   UINTN       DataSize,\r
   OUT  UINT8       *HashValue\r
   )\r
 {\r
-  return CALL_BASECRYPTLIB (Md4.Services.HashAll, Md4HashAll, (Data, DataSize, HashValue), FALSE);\r
+  return BaseCryptLibServiceDeprecated ("Md4HashAll"), FALSE;\r
 }\r
 \r
 /**\r
@@ -4440,13 +4402,13 @@ const EDKII_CRYPTO_PROTOCOL mEdkiiCrypto = {
   CryptoServiceHmacSha256Duplicate,\r
   CryptoServiceHmacSha256Update,\r
   CryptoServiceHmacSha256Final,\r
-  /// Md4\r
-  CryptoServiceMd4GetContextSize,\r
-  CryptoServiceMd4Init,\r
-  CryptoServiceMd4Duplicate,\r
-  CryptoServiceMd4Update,\r
-  CryptoServiceMd4Final,\r
-  CryptoServiceMd4HashAll,\r
+  /// Md4 - deprecated and unsupported\r
+  DeprecatedCryptoServiceMd4GetContextSize,\r
+  DeprecatedCryptoServiceMd4Init,\r
+  DeprecatedCryptoServiceMd4Duplicate,\r
+  DeprecatedCryptoServiceMd4Update,\r
+  DeprecatedCryptoServiceMd4Final,\r
+  DeprecatedCryptoServiceMd4HashAll,\r
   /// Md5\r
   CryptoServiceMd5GetContextSize,\r
   CryptoServiceMd5Init,\r