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: Laszlo Ersek <lersek@redhat.com>
		
			
				
	
	
		
			107 lines
		
	
	
		
			3.7 KiB
		
	
	
	
		
			C
		
	
	
	
	
	
			
		
		
	
	
			107 lines
		
	
	
		
			3.7 KiB
		
	
	
	
		
			C
		
	
	
	
	
	
| /** @file
 | |
| 
 | |
|   Define Secure Encrypted Virtualization (SEV) base library helper function
 | |
| 
 | |
|   Copyright (c) 2017, AMD Incorporated. All rights reserved.<BR>
 | |
| 
 | |
|   SPDX-License-Identifier: BSD-2-Clause-Patent
 | |
| 
 | |
| **/
 | |
| 
 | |
| #ifndef _MEM_ENCRYPT_SEV_LIB_H_
 | |
| #define _MEM_ENCRYPT_SEV_LIB_H_
 | |
| 
 | |
| #include <Base.h>
 | |
| 
 | |
| /**
 | |
|   Returns a boolean to indicate whether SEV is enabled
 | |
| 
 | |
|   @retval TRUE           SEV is enabled
 | |
|   @retval FALSE          SEV is not enabled
 | |
| **/
 | |
| BOOLEAN
 | |
| EFIAPI
 | |
| MemEncryptSevIsEnabled (
 | |
|   VOID
 | |
|   );
 | |
| 
 | |
| /**
 | |
|   This function clears memory encryption bit for the memory region specified by
 | |
|   BaseAddress and NumPages from the current page table context.
 | |
| 
 | |
|   @param[in]  Cr3BaseAddress          Cr3 Base Address (if zero then use
 | |
|                                       current CR3)
 | |
|   @param[in]  BaseAddress             The physical address that is the start
 | |
|                                       address of a memory region.
 | |
|   @param[in]  NumPages                The number of pages from start memory
 | |
|                                       region.
 | |
|   @param[in]  Flush                   Flush the caches before clearing the bit
 | |
|                                       (mostly TRUE except MMIO addresses)
 | |
| 
 | |
|   @retval RETURN_SUCCESS              The attributes were cleared for the
 | |
|                                       memory region.
 | |
|   @retval RETURN_INVALID_PARAMETER    Number of pages is zero.
 | |
|   @retval RETURN_UNSUPPORTED          Clearing the memory encryption attribute
 | |
|                                       is not supported
 | |
| **/
 | |
| RETURN_STATUS
 | |
| EFIAPI
 | |
| MemEncryptSevClearPageEncMask (
 | |
|   IN PHYSICAL_ADDRESS         Cr3BaseAddress,
 | |
|   IN PHYSICAL_ADDRESS         BaseAddress,
 | |
|   IN UINTN                    NumPages,
 | |
|   IN BOOLEAN                  Flush
 | |
|   );
 | |
| 
 | |
| /**
 | |
|   This function sets memory encryption bit for the memory region specified by
 | |
|   BaseAddress and NumPages from the current page table context.
 | |
| 
 | |
|   @param[in]  Cr3BaseAddress          Cr3 Base Address (if zero then use
 | |
|                                       current CR3)
 | |
|   @param[in]  BaseAddress             The physical address that is the start
 | |
|                                       address of a memory region.
 | |
|   @param[in]  NumPages                The number of pages from start memory
 | |
|                                       region.
 | |
|   @param[in]  Flush                   Flush the caches before setting the bit
 | |
|                                       (mostly TRUE except MMIO addresses)
 | |
| 
 | |
|   @retval RETURN_SUCCESS              The attributes were set for the memory
 | |
|                                       region.
 | |
|   @retval RETURN_INVALID_PARAMETER    Number of pages is zero.
 | |
|   @retval RETURN_UNSUPPORTED          Setting the memory encryption attribute
 | |
|                                       is not supported
 | |
| **/
 | |
| RETURN_STATUS
 | |
| EFIAPI
 | |
| MemEncryptSevSetPageEncMask (
 | |
|   IN PHYSICAL_ADDRESS         Cr3BaseAddress,
 | |
|   IN PHYSICAL_ADDRESS         BaseAddress,
 | |
|   IN UINTN                    NumPages,
 | |
|   IN BOOLEAN                  Flush
 | |
|   );
 | |
| 
 | |
| 
 | |
| /**
 | |
|   Locate the page range that covers the initial (pre-SMBASE-relocation) SMRAM
 | |
|   Save State Map.
 | |
| 
 | |
|   @param[out] BaseAddress     The base address of the lowest-address page that
 | |
|                               covers the initial SMRAM Save State Map.
 | |
| 
 | |
|   @param[out] NumberOfPages   The number of pages in the page range that covers
 | |
|                               the initial SMRAM Save State Map.
 | |
| 
 | |
|   @retval RETURN_SUCCESS      BaseAddress and NumberOfPages have been set on
 | |
|                               output.
 | |
| 
 | |
|   @retval RETURN_UNSUPPORTED  SMM is unavailable.
 | |
| **/
 | |
| RETURN_STATUS
 | |
| EFIAPI
 | |
| MemEncryptSevLocateInitialSmramSaveStateMapPages (
 | |
|   OUT UINTN *BaseAddress,
 | |
|   OUT UINTN *NumberOfPages
 | |
|   );
 | |
| #endif // _MEM_ENCRYPT_SEV_LIB_H_
 |