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: Hao Wu <hao.a.wu@intel.com> Reviewed-by: Jian J Wang <jian.j.wang@intel.com>
		
			
				
	
	
		
			122 lines
		
	
	
		
			3.4 KiB
		
	
	
	
		
			C
		
	
	
	
	
	
			
		
		
	
	
			122 lines
		
	
	
		
			3.4 KiB
		
	
	
	
		
			C
		
	
	
	
	
	
/** @file
 | 
						|
  Null Reset System Library instance that only generates ASSERT() conditions.
 | 
						|
 | 
						|
  Copyright (c) 2006 - 2018, Intel Corporation. All rights reserved.<BR>
 | 
						|
  SPDX-License-Identifier: BSD-2-Clause-Patent
 | 
						|
 | 
						|
**/
 | 
						|
 | 
						|
#include <Base.h>
 | 
						|
 | 
						|
#include <Library/ResetSystemLib.h>
 | 
						|
#include <Library/DebugLib.h>
 | 
						|
 | 
						|
/**
 | 
						|
  This function causes a system-wide reset (cold reset), in which
 | 
						|
  all circuitry within the system returns to its initial state. This type of reset
 | 
						|
  is asynchronous to system operation and operates without regard to
 | 
						|
  cycle boundaries.
 | 
						|
 | 
						|
  If this function returns, it means that the system does not support cold reset.
 | 
						|
**/
 | 
						|
VOID
 | 
						|
EFIAPI
 | 
						|
ResetCold (
 | 
						|
  VOID
 | 
						|
  )
 | 
						|
{
 | 
						|
  ASSERT (FALSE);
 | 
						|
}
 | 
						|
 | 
						|
/**
 | 
						|
  This function causes a system-wide initialization (warm reset), in which all processors
 | 
						|
  are set to their initial state. Pending cycles are not corrupted.
 | 
						|
 | 
						|
  If this function returns, it means that the system does not support warm reset.
 | 
						|
**/
 | 
						|
VOID
 | 
						|
EFIAPI
 | 
						|
ResetWarm (
 | 
						|
  VOID
 | 
						|
  )
 | 
						|
{
 | 
						|
  ASSERT (FALSE);
 | 
						|
}
 | 
						|
 | 
						|
/**
 | 
						|
  This function causes the system to enter a power state equivalent
 | 
						|
  to the ACPI G2/S5 or G3 states.
 | 
						|
 | 
						|
  If this function returns, it means that the system does not support shut down reset.
 | 
						|
**/
 | 
						|
VOID
 | 
						|
EFIAPI
 | 
						|
ResetShutdown (
 | 
						|
  VOID
 | 
						|
  )
 | 
						|
{
 | 
						|
  ASSERT (FALSE);
 | 
						|
}
 | 
						|
 | 
						|
/**
 | 
						|
  This function causes the system to enter S3 and then wake up immediately.
 | 
						|
 | 
						|
  If this function returns, it means that the system does not support S3 feature.
 | 
						|
**/
 | 
						|
VOID
 | 
						|
EFIAPI
 | 
						|
EnterS3WithImmediateWake (
 | 
						|
  VOID
 | 
						|
  )
 | 
						|
{
 | 
						|
  ASSERT (FALSE);
 | 
						|
}
 | 
						|
 | 
						|
/**
 | 
						|
  This function causes a systemwide reset. The exact type of the reset is
 | 
						|
  defined by the EFI_GUID that follows the Null-terminated Unicode string passed
 | 
						|
  into ResetData. If the platform does not recognize the EFI_GUID in ResetData
 | 
						|
  the platform must pick a supported reset type to perform.The platform may
 | 
						|
  optionally log the parameters from any non-normal reset that occurs.
 | 
						|
 | 
						|
  @param[in]  DataSize   The size, in bytes, of ResetData.
 | 
						|
  @param[in]  ResetData  The data buffer starts with a Null-terminated string,
 | 
						|
                         followed by the EFI_GUID.
 | 
						|
**/
 | 
						|
VOID
 | 
						|
EFIAPI
 | 
						|
ResetPlatformSpecific (
 | 
						|
  IN UINTN   DataSize,
 | 
						|
  IN VOID    *ResetData
 | 
						|
  )
 | 
						|
{
 | 
						|
  ResetCold ();
 | 
						|
}
 | 
						|
 | 
						|
/**
 | 
						|
  The ResetSystem function resets the entire platform.
 | 
						|
 | 
						|
  @param[in] ResetType      The type of reset to perform.
 | 
						|
  @param[in] ResetStatus    The status code for the reset.
 | 
						|
  @param[in] DataSize       The size, in bytes, of ResetData.
 | 
						|
  @param[in] ResetData      For a ResetType of EfiResetCold, EfiResetWarm, or EfiResetShutdown
 | 
						|
                            the data buffer starts with a Null-terminated string, optionally
 | 
						|
                            followed by additional binary data. The string is a description
 | 
						|
                            that the caller may use to further indicate the reason for the
 | 
						|
                            system reset. ResetData is only valid if ResetStatus is something
 | 
						|
                            other than EFI_SUCCESS unless the ResetType is EfiResetPlatformSpecific
 | 
						|
                            where a minimum amount of ResetData is always required.
 | 
						|
**/
 | 
						|
VOID
 | 
						|
EFIAPI
 | 
						|
ResetSystem (
 | 
						|
  IN EFI_RESET_TYPE               ResetType,
 | 
						|
  IN EFI_STATUS                   ResetStatus,
 | 
						|
  IN UINTN                        DataSize,
 | 
						|
  IN VOID                         *ResetData OPTIONAL
 | 
						|
  )
 | 
						|
{
 | 
						|
  ASSERT (FALSE);
 | 
						|
}
 | 
						|
 |