RFC: https://bugzilla.tianocore.org/show_bug.cgi?id=3429 Add Intel Tdx helper library. The library provides the routines to: - set or clear Shared bit for a given memory region. - query whether TDX is enabled. Please be noted, there a lot of duplicated codes for Page Table operations. These codes should be moved to a common library (PageTablesLib) so that it is more friendly for review and maintain. There is a new feature requirement https://bugzilla.tianocore.org/show_bug.cgi?id=847 which is to implement the library. After the lib is introduced, BaseMemEncryptTdxLib will be refactored. Cc: Ard Biesheuvel <ardb+tianocore@kernel.org> Cc: Jordan Justen <jordan.l.justen@intel.com> Cc: Brijesh Singh <brijesh.singh@amd.com> Cc: Erdem Aktas <erdemaktas@google.com> Cc: James Bottomley <jejb@linux.ibm.com> Cc: Jiewen Yao <jiewen.yao@intel.com> Cc: Tom Lendacky <thomas.lendacky@amd.com> Cc: Gerd Hoffmann <kraxel@redhat.com> Acked-by: Gerd Hoffmann <kraxel@redhat.com> Reviewed-by: Jiewen Yao <jiewen.yao@intel.com> Signed-off-by: Min Xu <min.m.xu@intel.com>
		
			
				
	
	
		
			182 lines
		
	
	
		
			7.6 KiB
		
	
	
	
		
			C
		
	
	
	
	
	
			
		
		
	
	
			182 lines
		
	
	
		
			7.6 KiB
		
	
	
	
		
			C
		
	
	
	
	
	
| /** @file
 | |
| 
 | |
|   Virtual Memory Management Services to set or clear the memory encryption bit
 | |
| 
 | |
|   Copyright (c) 2006 - 2016, Intel Corporation. All rights reserved.<BR>
 | |
|   Copyright (c) 2017, AMD Incorporated. All rights reserved.<BR>
 | |
| 
 | |
|   SPDX-License-Identifier: BSD-2-Clause-Patent
 | |
| 
 | |
|   Code is derived from MdeModulePkg/Core/DxeIplPeim/X64/VirtualMemory.h
 | |
| 
 | |
| **/
 | |
| 
 | |
| #ifndef TDX_VIRTUAL_MEMORY_
 | |
| #define TDX_VIRTUAL_MEMORY_
 | |
| 
 | |
| #include <Library/BaseLib.h>
 | |
| #include <Library/BaseMemoryLib.h>
 | |
| #include <Library/CacheMaintenanceLib.h>
 | |
| #include <Library/DebugLib.h>
 | |
| #include <Library/MemoryAllocationLib.h>
 | |
| #include <Uefi.h>
 | |
| 
 | |
| #define SYS_CODE64_SEL  0x38
 | |
| 
 | |
| #pragma pack(1)
 | |
| 
 | |
| //
 | |
| // Page-Map Level-4 Offset (PML4) and
 | |
| // Page-Directory-Pointer Offset (PDPE) entries 4K & 2MB
 | |
| //
 | |
| 
 | |
| typedef union {
 | |
|   struct {
 | |
|     UINT64    Present              : 1;  // 0 = Not present in memory,
 | |
|                                          //   1 = Present in memory
 | |
|     UINT64    ReadWrite            : 1;  // 0 = Read-Only, 1= Read/Write
 | |
|     UINT64    UserSupervisor       : 1;  // 0 = Supervisor, 1=User
 | |
|     UINT64    WriteThrough         : 1;  // 0 = Write-Back caching,
 | |
|                                          //   1 = Write-Through caching
 | |
|     UINT64    CacheDisabled        : 1;  // 0 = Cached, 1=Non-Cached
 | |
|     UINT64    Accessed             : 1;  // 0 = Not accessed,
 | |
|                                          //   1 = Accessed (set by CPU)
 | |
|     UINT64    Reserved             : 1;  // Reserved
 | |
|     UINT64    MustBeZero           : 2;  // Must Be Zero
 | |
|     UINT64    Available            : 3;  // Available for use by system software
 | |
|     UINT64    PageTableBaseAddress : 40; // Page Table Base Address
 | |
|     UINT64    AvabilableHigh       : 11; // Available for use by system software
 | |
|     UINT64    Nx                   : 1;  // No Execute bit
 | |
|   } Bits;
 | |
|   UINT64    Uint64;
 | |
| } PAGE_MAP_AND_DIRECTORY_POINTER;
 | |
| 
 | |
| //
 | |
| // Page Table Entry 4KB
 | |
| //
 | |
| typedef union {
 | |
|   struct {
 | |
|     UINT64    Present              : 1;  // 0 = Not present in memory,
 | |
|                                          //   1 = Present in memory
 | |
|     UINT64    ReadWrite            : 1;  // 0 = Read-Only, 1= Read/Write
 | |
|     UINT64    UserSupervisor       : 1;  // 0 = Supervisor, 1=User
 | |
|     UINT64    WriteThrough         : 1;  // 0 = Write-Back caching,
 | |
|                                          //   1 = Write-Through caching
 | |
|     UINT64    CacheDisabled        : 1;  // 0 = Cached, 1=Non-Cached
 | |
|     UINT64    Accessed             : 1;  // 0 = Not accessed,
 | |
|                                          //   1 = Accessed (set by CPU)
 | |
|     UINT64    Dirty                : 1;  // 0 = Not Dirty, 1 = written by
 | |
|                                          //   processor on access to page
 | |
|     UINT64    PAT                  : 1;  //
 | |
|     UINT64    Global               : 1;  // 0 = Not global page, 1 = global page
 | |
|                                          //   TLB not cleared on CR3 write
 | |
|     UINT64    Available            : 3;  // Available for use by system software
 | |
|     UINT64    PageTableBaseAddress : 40; // Page Table Base Address
 | |
|     UINT64    AvabilableHigh       : 11; // Available for use by system software
 | |
|     UINT64    Nx                   : 1;  // 0 = Execute Code,
 | |
|                                          //   1 = No Code Execution
 | |
|   } Bits;
 | |
|   UINT64    Uint64;
 | |
| } PAGE_TABLE_4K_ENTRY;
 | |
| 
 | |
| //
 | |
| // Page Table Entry 2MB
 | |
| //
 | |
| typedef union {
 | |
|   struct {
 | |
|     UINT64    Present              : 1;  // 0 = Not present in memory,
 | |
|                                          //   1 = Present in memory
 | |
|     UINT64    ReadWrite            : 1;  // 0 = Read-Only, 1= Read/Write
 | |
|     UINT64    UserSupervisor       : 1;  // 0 = Supervisor, 1=User
 | |
|     UINT64    WriteThrough         : 1;  // 0 = Write-Back caching,
 | |
|                                          //   1=Write-Through caching
 | |
|     UINT64    CacheDisabled        : 1;  // 0 = Cached, 1=Non-Cached
 | |
|     UINT64    Accessed             : 1;  // 0 = Not accessed,
 | |
|                                          //   1 = Accessed (set by CPU)
 | |
|     UINT64    Dirty                : 1;  // 0 = Not Dirty, 1 = written by
 | |
|                                          //   processor on access to page
 | |
|     UINT64    MustBe1              : 1;  // Must be 1
 | |
|     UINT64    Global               : 1;  // 0 = Not global page, 1 = global page
 | |
|                                          //   TLB not cleared on CR3 write
 | |
|     UINT64    Available            : 3;  // Available for use by system software
 | |
|     UINT64    PAT                  : 1;  //
 | |
|     UINT64    MustBeZero           : 8;  // Must be zero;
 | |
|     UINT64    PageTableBaseAddress : 31; // Page Table Base Address
 | |
|     UINT64    AvabilableHigh       : 11; // Available for use by system software
 | |
|     UINT64    Nx                   : 1;  // 0 = Execute Code,
 | |
|                                          //   1 = No Code Execution
 | |
|   } Bits;
 | |
|   UINT64    Uint64;
 | |
| } PAGE_TABLE_ENTRY;
 | |
| 
 | |
| //
 | |
| // Page Table Entry 1GB
 | |
| //
 | |
| typedef union {
 | |
|   struct {
 | |
|     UINT64    Present              : 1;  // 0 = Not present in memory,
 | |
|                                          //   1 = Present in memory
 | |
|     UINT64    ReadWrite            : 1;  // 0 = Read-Only, 1= Read/Write
 | |
|     UINT64    UserSupervisor       : 1;  // 0 = Supervisor, 1=User
 | |
|     UINT64    WriteThrough         : 1;  // 0 = Write-Back caching,
 | |
|                                          //   1 = Write-Through caching
 | |
|     UINT64    CacheDisabled        : 1;  // 0 = Cached, 1=Non-Cached
 | |
|     UINT64    Accessed             : 1;  // 0 = Not accessed,
 | |
|                                          //   1 = Accessed (set by CPU)
 | |
|     UINT64    Dirty                : 1;  // 0 = Not Dirty, 1 = written by
 | |
|                                          //   processor on access to page
 | |
|     UINT64    MustBe1              : 1;  // Must be 1
 | |
|     UINT64    Global               : 1;  // 0 = Not global page, 1 = global page
 | |
|                                          //   TLB not cleared on CR3 write
 | |
|     UINT64    Available            : 3;  // Available for use by system software
 | |
|     UINT64    PAT                  : 1;  //
 | |
|     UINT64    MustBeZero           : 17; // Must be zero;
 | |
|     UINT64    PageTableBaseAddress : 22; // Page Table Base Address
 | |
|     UINT64    AvabilableHigh       : 11; // Available for use by system software
 | |
|     UINT64    Nx                   : 1;  // 0 = Execute Code,
 | |
|                                          //   1 = No Code Execution
 | |
|   } Bits;
 | |
|   UINT64    Uint64;
 | |
| } PAGE_TABLE_1G_ENTRY;
 | |
| 
 | |
| #pragma pack()
 | |
| 
 | |
| #define IA32_PG_P   BIT0
 | |
| #define IA32_PG_RW  BIT1
 | |
| #define IA32_PG_PS  BIT7
 | |
| 
 | |
| #define PAGING_PAE_INDEX_MASK  0x1FF
 | |
| 
 | |
| #define PAGING_4K_ADDRESS_MASK_64  0x000FFFFFFFFFF000ull
 | |
| #define PAGING_2M_ADDRESS_MASK_64  0x000FFFFFFFE00000ull
 | |
| #define PAGING_1G_ADDRESS_MASK_64  0x000FFFFFC0000000ull
 | |
| 
 | |
| #define PAGING_L1_ADDRESS_SHIFT  12
 | |
| #define PAGING_L2_ADDRESS_SHIFT  21
 | |
| #define PAGING_L3_ADDRESS_SHIFT  30
 | |
| #define PAGING_L4_ADDRESS_SHIFT  39
 | |
| 
 | |
| #define PAGING_PML4E_NUMBER  4
 | |
| 
 | |
| #define PAGETABLE_ENTRY_MASK  ((1UL << 9) - 1)
 | |
| #define PML4_OFFSET(x)  ( (x >> 39) & PAGETABLE_ENTRY_MASK)
 | |
| #define PDP_OFFSET(x)   ( (x >> 30) & PAGETABLE_ENTRY_MASK)
 | |
| #define PDE_OFFSET(x)   ( (x >> 21) & PAGETABLE_ENTRY_MASK)
 | |
| #define PTE_OFFSET(x)   ( (x >> 12) & PAGETABLE_ENTRY_MASK)
 | |
| #define PAGING_1G_ADDRESS_MASK_64  0x000FFFFFC0000000ull
 | |
| 
 | |
| #define PAGE_TABLE_POOL_ALIGNMENT  BASE_2MB
 | |
| #define PAGE_TABLE_POOL_UNIT_SIZE  SIZE_2MB
 | |
| #define PAGE_TABLE_POOL_UNIT_PAGES  \
 | |
|   EFI_SIZE_TO_PAGES (PAGE_TABLE_POOL_UNIT_SIZE)
 | |
| #define PAGE_TABLE_POOL_ALIGN_MASK  \
 | |
|   (~(EFI_PHYSICAL_ADDRESS)(PAGE_TABLE_POOL_ALIGNMENT - 1))
 | |
| 
 | |
| typedef struct {
 | |
|   VOID     *NextPool;
 | |
|   UINTN    Offset;
 | |
|   UINTN    FreePages;
 | |
| } PAGE_TABLE_POOL;
 | |
| 
 | |
| #endif
 |