https://bugzilla.tianocore.org/show_bug.cgi?id=2257 Add a Null instance of the BaseCryptLib class. This lib instance can be used as a template for new implementations of the BaseCryptLib class and can also be used to reduce CI build times for build checks that depend on the BaseCryptLib class. Cc: Jian J Wang <jian.j.wang@intel.com> Cc: Xiaoyu Lu <xiaoyux.lu@intel.com> Signed-off-by: Michael D Kinney <michael.d.kinney@intel.com> Reviewed-by: Jian J Wang <jian.j.wang@intel.com>
		
			
				
	
	
		
			166 lines
		
	
	
		
			4.0 KiB
		
	
	
	
		
			C
		
	
	
	
	
	
			
		
		
	
	
			166 lines
		
	
	
		
			4.0 KiB
		
	
	
	
		
			C
		
	
	
	
	
	
/** @file
 | 
						|
 | 
						|
MD5 Digest Wrapper Null Implementation.
 | 
						|
 | 
						|
Copyright (c) Microsoft Corporation. All rights reserved.
 | 
						|
SPDX-License-Identifier: BSD-2-Clause-Patent
 | 
						|
 | 
						|
**/
 | 
						|
 | 
						|
#include "InternalCryptLib.h"
 | 
						|
 | 
						|
 | 
						|
/**
 | 
						|
  Retrieves the size, in bytes, of the context buffer required for MD5 hash operations.
 | 
						|
 | 
						|
  @return  The size, in bytes, of the context buffer required for MD5 hash operations.
 | 
						|
 | 
						|
**/
 | 
						|
UINTN
 | 
						|
EFIAPI
 | 
						|
Md5GetContextSize (
 | 
						|
  VOID
 | 
						|
  )
 | 
						|
{
 | 
						|
  ASSERT (FALSE);
 | 
						|
  return 0;
 | 
						|
}
 | 
						|
 | 
						|
 | 
						|
/**
 | 
						|
  Initializes user-supplied memory pointed by Md5Context as MD5 hash context for
 | 
						|
  subsequent use.
 | 
						|
 | 
						|
  If Md5Context is NULL, then return FALSE.
 | 
						|
 | 
						|
  @param[out]  Md5Context  Pointer to MD5 context being initialized.
 | 
						|
 | 
						|
  @retval TRUE   MD5 context initialization succeeded.
 | 
						|
  @retval FALSE  MD5 context initialization failed.
 | 
						|
 | 
						|
**/
 | 
						|
BOOLEAN
 | 
						|
EFIAPI
 | 
						|
Md5Init (
 | 
						|
  OUT  VOID  *Md5Context
 | 
						|
  )
 | 
						|
{
 | 
						|
  ASSERT (FALSE);
 | 
						|
  return FALSE;
 | 
						|
}
 | 
						|
 | 
						|
/**
 | 
						|
  Makes a copy of an existing MD5 context.
 | 
						|
 | 
						|
  If Md5Context is NULL, then return FALSE.
 | 
						|
  If NewMd5Context is NULL, then return FALSE.
 | 
						|
 | 
						|
  @param[in]  Md5Context     Pointer to MD5 context being copied.
 | 
						|
  @param[out] NewMd5Context  Pointer to new MD5 context.
 | 
						|
 | 
						|
  @retval TRUE   MD5 context copy succeeded.
 | 
						|
  @retval FALSE  MD5 context copy failed.
 | 
						|
 | 
						|
**/
 | 
						|
BOOLEAN
 | 
						|
EFIAPI
 | 
						|
Md5Duplicate (
 | 
						|
  IN   CONST VOID  *Md5Context,
 | 
						|
  OUT  VOID        *NewMd5Context
 | 
						|
  )
 | 
						|
{
 | 
						|
  ASSERT (FALSE);
 | 
						|
  return FALSE;
 | 
						|
}
 | 
						|
 | 
						|
/**
 | 
						|
  Digests the input data and updates MD5 context.
 | 
						|
 | 
						|
  This function performs MD5 digest on a data buffer of the specified size.
 | 
						|
  It can be called multiple times to compute the digest of long or discontinuous data streams.
 | 
						|
  MD5 context should be already correctly intialized by Md5Init(), and should not be finalized
 | 
						|
  by Md5Final(). Behavior with invalid context is undefined.
 | 
						|
 | 
						|
  If Md5Context is NULL, then return FALSE.
 | 
						|
 | 
						|
  @param[in, out]  Md5Context  Pointer to the MD5 context.
 | 
						|
  @param[in]       Data        Pointer to the buffer containing the data to be hashed.
 | 
						|
  @param[in]       DataSize    Size of Data buffer in bytes.
 | 
						|
 | 
						|
  @retval TRUE   MD5 data digest succeeded.
 | 
						|
  @retval FALSE  MD5 data digest failed.
 | 
						|
 | 
						|
**/
 | 
						|
BOOLEAN
 | 
						|
EFIAPI
 | 
						|
Md5Update (
 | 
						|
  IN OUT  VOID        *Md5Context,
 | 
						|
  IN      CONST VOID  *Data,
 | 
						|
  IN      UINTN       DataSize
 | 
						|
  )
 | 
						|
{
 | 
						|
  ASSERT (FALSE);
 | 
						|
  return FALSE;
 | 
						|
}
 | 
						|
 | 
						|
/**
 | 
						|
  Completes computation of the MD5 digest value.
 | 
						|
 | 
						|
  This function completes MD5 hash computation and retrieves the digest value into
 | 
						|
  the specified memory. After this function has been called, the MD5 context cannot
 | 
						|
  be used again.
 | 
						|
  MD5 context should be already correctly intialized by Md5Init(), and should not be
 | 
						|
  finalized by Md5Final(). Behavior with invalid MD5 context is undefined.
 | 
						|
 | 
						|
  If Md5Context is NULL, then return FALSE.
 | 
						|
  If HashValue is NULL, then return FALSE.
 | 
						|
 | 
						|
  @param[in, out]  Md5Context  Pointer to the MD5 context.
 | 
						|
  @param[out]      HashValue   Pointer to a buffer that receives the MD5 digest
 | 
						|
                               value (16 bytes).
 | 
						|
 | 
						|
  @retval TRUE   MD5 digest computation succeeded.
 | 
						|
  @retval FALSE  MD5 digest computation failed.
 | 
						|
 | 
						|
**/
 | 
						|
BOOLEAN
 | 
						|
EFIAPI
 | 
						|
Md5Final (
 | 
						|
  IN OUT  VOID   *Md5Context,
 | 
						|
  OUT     UINT8  *HashValue
 | 
						|
  )
 | 
						|
{
 | 
						|
  ASSERT (FALSE);
 | 
						|
  return FALSE;
 | 
						|
}
 | 
						|
 | 
						|
/**
 | 
						|
Computes the MD5 message digest of a input data buffer.
 | 
						|
 | 
						|
This function performs the MD5 message digest of a given data buffer, and places
 | 
						|
the digest value into the specified memory.
 | 
						|
 | 
						|
If this interface is not supported, then return FALSE.
 | 
						|
 | 
						|
@param[in]   Data        Pointer to the buffer containing the data to be hashed.
 | 
						|
@param[in]   DataSize    Size of Data buffer in bytes.
 | 
						|
@param[out]  HashValue   Pointer to a buffer that receives the MD5 digest
 | 
						|
value (16 bytes).
 | 
						|
 | 
						|
@retval TRUE   MD5 digest computation succeeded.
 | 
						|
@retval FALSE  MD5 digest computation failed.
 | 
						|
@retval FALSE  This interface is not supported.
 | 
						|
 | 
						|
**/
 | 
						|
BOOLEAN
 | 
						|
EFIAPI
 | 
						|
Md5HashAll(
 | 
						|
  IN   CONST VOID  *Data,
 | 
						|
  IN   UINTN       DataSize,
 | 
						|
  OUT  UINT8       *HashValue
 | 
						|
)
 | 
						|
{
 | 
						|
  ASSERT(FALSE);
 | 
						|
  return FALSE;
 | 
						|
}
 |