https://bugzilla.tianocore.org/show_bug.cgi?id=1373 Replace BSD 2-Clause License with BSD+Patent License. This change is based on the following emails: https://lists.01.org/pipermail/edk2-devel/2019-February/036260.html https://lists.01.org/pipermail/edk2-devel/2018-October/030385.html RFCs with detailed process for the license change: V3: https://lists.01.org/pipermail/edk2-devel/2019-March/038116.html V2: https://lists.01.org/pipermail/edk2-devel/2019-March/037669.html V1: https://lists.01.org/pipermail/edk2-devel/2019-March/037500.html Contributed-under: TianoCore Contribution Agreement 1.1 Signed-off-by: Michael D Kinney <michael.d.kinney@intel.com> Reviewed-by: Liming Gao <liming.gao@intel.com>
		
			
				
	
	
		
			94 lines
		
	
	
		
			2.9 KiB
		
	
	
	
		
			C
		
	
	
	
	
	
			
		
		
	
	
			94 lines
		
	
	
		
			2.9 KiB
		
	
	
	
		
			C
		
	
	
	
	
	
/** @file
 | 
						|
  ScanMem8() and ScanMemN() implementation.
 | 
						|
 | 
						|
  The following BaseMemoryLib instances contain the same copy of this file:
 | 
						|
 | 
						|
    BaseMemoryLib
 | 
						|
    BaseMemoryLibMmx
 | 
						|
    BaseMemoryLibSse2
 | 
						|
    BaseMemoryLibRepStr
 | 
						|
    BaseMemoryLibOptDxe
 | 
						|
    BaseMemoryLibOptPei
 | 
						|
    PeiMemoryLib
 | 
						|
    UefiMemoryLib
 | 
						|
 | 
						|
  Copyright (c) 2006 - 2018, Intel Corporation. All rights reserved.<BR>
 | 
						|
  SPDX-License-Identifier: BSD-2-Clause-Patent
 | 
						|
 | 
						|
**/
 | 
						|
 | 
						|
#include "MemLibInternals.h"
 | 
						|
 | 
						|
/**
 | 
						|
  Scans a target buffer for an 8-bit value, and returns a pointer to the matching 8-bit value
 | 
						|
  in the target buffer.
 | 
						|
 | 
						|
  This function searches the target buffer specified by Buffer and Length from the lowest
 | 
						|
  address to the highest address for an 8-bit value that matches Value.  If a match is found,
 | 
						|
  then a pointer to the matching byte in the target buffer is returned.  If no match is found,
 | 
						|
  then NULL is returned.  If Length is 0, then NULL is returned.
 | 
						|
 | 
						|
  If Length > 0 and Buffer is NULL, then ASSERT().
 | 
						|
  If Length is greater than (MAX_ADDRESS - Buffer + 1), then ASSERT().
 | 
						|
 | 
						|
  @param  Buffer      The pointer to the target buffer to scan.
 | 
						|
  @param  Length      The number of bytes in Buffer to scan.
 | 
						|
  @param  Value       The value to search for in the target buffer.
 | 
						|
 | 
						|
  @return A pointer to the matching byte in the target buffer or NULL otherwise.
 | 
						|
 | 
						|
**/
 | 
						|
VOID *
 | 
						|
EFIAPI
 | 
						|
ScanMem8 (
 | 
						|
  IN CONST VOID  *Buffer,
 | 
						|
  IN UINTN       Length,
 | 
						|
  IN UINT8       Value
 | 
						|
  )
 | 
						|
{
 | 
						|
  if (Length == 0) {
 | 
						|
    return NULL;
 | 
						|
  }
 | 
						|
  ASSERT (Buffer != NULL);
 | 
						|
  ASSERT ((Length - 1) <= (MAX_ADDRESS - (UINTN)Buffer));
 | 
						|
 | 
						|
  return (VOID*)InternalMemScanMem8 (Buffer, Length, Value);
 | 
						|
}
 | 
						|
 | 
						|
/**
 | 
						|
  Scans a target buffer for a UINTN sized value, and returns a pointer to the matching
 | 
						|
  UINTN sized value in the target buffer.
 | 
						|
 | 
						|
  This function searches the target buffer specified by Buffer and Length from the lowest
 | 
						|
  address to the highest address for a UINTN sized value that matches Value.  If a match is found,
 | 
						|
  then a pointer to the matching byte in the target buffer is returned.  If no match is found,
 | 
						|
  then NULL is returned.  If Length is 0, then NULL is returned.
 | 
						|
 | 
						|
  If Length > 0 and Buffer is NULL, then ASSERT().
 | 
						|
  If Buffer is not aligned on a UINTN boundary, then ASSERT().
 | 
						|
  If Length is not aligned on a UINTN boundary, then ASSERT().
 | 
						|
  If Length is greater than (MAX_ADDRESS - Buffer + 1), then ASSERT().
 | 
						|
 | 
						|
  @param  Buffer      The pointer to the target buffer to scan.
 | 
						|
  @param  Length      The number of bytes in Buffer to scan.
 | 
						|
  @param  Value       The value to search for in the target buffer.
 | 
						|
 | 
						|
  @return A pointer to the matching byte in the target buffer or NULL otherwise.
 | 
						|
 | 
						|
**/
 | 
						|
VOID *
 | 
						|
EFIAPI
 | 
						|
ScanMemN (
 | 
						|
  IN CONST VOID  *Buffer,
 | 
						|
  IN UINTN       Length,
 | 
						|
  IN UINTN       Value
 | 
						|
  )
 | 
						|
{
 | 
						|
  if (sizeof (UINTN) == sizeof (UINT64)) {
 | 
						|
    return ScanMem64 (Buffer, Length, (UINT64)Value);
 | 
						|
  } else {
 | 
						|
    return ScanMem32 (Buffer, Length, (UINT32)Value);
 | 
						|
  }
 | 
						|
}
 | 
						|
 |