Try to create a debugging version

283 files changed, 90418 insertions, 0 deletions

diff --git a/debugging_demo/ApplicationEntryPoint.o b/debugging_demo/ApplicationEntryPoint.o
new file mode 100644
index 0000000..90c7d94
--- /dev/null
+++ b/debugging_demo/ApplicationEntryPoint.o
diff --git a/debugging_demo/BaseDebugPrintErrorLevelLib.o b/debugging_demo/BaseDebugPrintErrorLevelLib.o
new file mode 100644
index 0000000..4a24065
--- /dev/null
+++ b/debugging_demo/BaseDebugPrintErrorLevelLib.o
diff --git a/debugging_demo/BaseLib.o b/debugging_demo/BaseLib.o
new file mode 100644
index 0000000..1232d15
--- /dev/null
+++ b/debugging_demo/BaseLib.o
diff --git a/debugging_demo/BaseMemoryLib.o b/debugging_demo/BaseMemoryLib.o
new file mode 100644
index 0000000..96e84da
--- /dev/null
+++ b/debugging_demo/BaseMemoryLib.o
diff --git a/debugging_demo/BasePcdLibNull.o b/debugging_demo/BasePcdLibNull.o
new file mode 100644
index 0000000..fb95c87
--- /dev/null
+++ b/debugging_demo/BasePcdLibNull.o
diff --git a/debugging_demo/BasePrintLib.o b/debugging_demo/BasePrintLib.o
new file mode 100644
index 0000000..026f38a
--- /dev/null
+++ b/debugging_demo/BasePrintLib.o
diff --git a/debugging_demo/Efi_Defs.o b/debugging_demo/Efi_Defs.o
new file mode 100644
index 0000000..551e68f
--- /dev/null
+++ b/debugging_demo/Efi_Defs.o
diff --git a/debugging_demo/Makefile b/debugging_demo/Makefile
new file mode 100644
index 0000000..c34dbca
--- /dev/null
+++ b/debugging_demo/Makefile
@@ -0,0 +1,190 @@
+MAIN_FILE	=	MemtestEfi
+
+CC 			=	gcc
+
+# Warnings
+CFLAGS		= 	-Werror -Wall -Wno-array-bounds -Wno-address
+CFLAGS		+=	-fno-builtin
+# EFI requires -fshort-wchar
+CFLAGS		+=	-fshort-wchar
+CFLAGS		+=	-fno-common
+CFLAGS		+=	-fno-strict-aliasing -g
+# EFI uses Microsoft ABI so no red zone is defined
+CFLAGS		+=	-mno-red-zone
+
+# use %rip-relative addressing wherever possible?? Or not?
+CFLAGS		+=	-fpie
+#CFLAGS		+=  -fno-pie -no-pie -static
+
+# the UEFI PE executables must be relocatable 
+CFLAGS		+=	-fPIC
+CFLAGS		+=	-ffunction-sections
+CFLAGS		+=	-fdata-sections
+CFLAGS		+=	-flto
+
+# function calls must include the number of arguments passed to the functions 
+CFLAGS		+=	-maccumulate-outgoing-args
+CFLAGS		+=	-fno-asynchronous-unwind-tables
+CFLAGS		+=	-nostdlib
+CFLAGS		+=	-mcmodel=small
+#CFLAGS		+=	-fno-stack-protector e
+
+M64=-m64
+
+M32=-m32
+
+M=$(M64)
+
+PREPROCESSOR=-DUEFI -DUSING_LTO -Os \
+	-D DISABLE_NEW_DEPRECATED_INTERFACES "-DEFIAPI=__attribute__((ms_abi))"
+
+OBJS=Efi_Defs.o	BaseLib.o BaseMemoryLib.o BasePrintLib.o \
+	UefiDebugLibStdErr.o UefiDevicePathLib2.o UefiLib2.o ApplicationEntryPoint.o \
+	BaseDebugPrintErrorLevelLib.o UefiMemoryAllocationLib.o  BasePcdLibNull.o \
+	UefiRuntimeServicesTableLib.o UefiBootServicesTableLib.o MemtestEfi.o
+	
+
+BaseMemoryLib_OBJS=CompareMemWrapper.o CopyMem.o CopyMemWrapper.o IsZeroBufferWrapper.o \
+	MemLibGeneric.o MemLibGuid.o ScanMem16Wrapper.o ScanMem32Wrapper.o ScanMem64Wrapper.o \
+	ScanMem8Wrapper.o SetMem.o SetMem16Wrapper.o SetMem32Wrapper.o SetMem64Wrapper.o \
+	SetMemWrapper.o ZeroMemWrapper.o
+
+UefiDevicePathLib_OBJS=DevicePathFromText.o DevicePathToText.o DevicePathUtilities.o \
+	DevicePathUtilitiesDxeSmm.o DevicePathUtilitiesStandaloneMm.o UefiDevicePathLib.o \
+	UefiDevicePathLibOptionalDevicePathProtocol.o
+
+BaseLib_OBJS=ARShiftU64.o BitField.o CheckSum.o CpuDeadLoop.o Cpu.o DivU64x64Remainder.o \
+	DivU64x32Remainder.o DivU64x32.o DivS64x64Remainder.o FilePaths.o GetPowerOfTwo64.o \
+	GetPowerOfTwo32.o HighBitSet64.o HighBitSet32.o LongJump.o LRotU64.o LowBitSet64.o \
+	LowBitSet32.o LRotU32.o LShiftU64.o Math64.o ModU64x32.o MultU64x64.o MultU64x32.o MultS64x64.o \
+    RRotU32.o RRotU64.o RShiftU64.o SafeString.o String.o SetJump.o SwapBytes64.o SwapBytes32.o \
+    SwapBytes16.o SwitchStack.o Unaligned.o
+	
+SECTIONS=.text .sdata .data .dynamic .dynsym .rel .rela .reloc
+
+all: clean MemtestEfi.efi move run 
+
+MemtestEfi.efi: OUTPUT/MemtestEfi.so
+	objcopy $(foreach sec,$(SECTIONS), -j $(sec)) --target=pei-x86-64 --subsystem=10 $< $@
+
+OUTPUT/$(MAIN_FILE).so: $(OBJS)
+	ld -shared -Bsymbolic -Telf_x86_64_efi.lds -o $@ $^
+	#rm $^
+
+$(MAIN_FILE).o: $(MAIN_FILE).c
+	$(CC) $(CFLAGS) $(PREPROCESSOR) $(M) -c -o $@ $<  \
+	-include memtest86+/efi/Include/Efi_Defs.h \
+	-I . \
+	-I"memtest86+"  \
+	-I"memtest86+/efi/Include"
+
+Efi_Defs.o: memtest86+/efi/Include/Efi_Defs.c
+	$(CC) $(CFLAGS) $(PREPROCESSOR) $(M) -c -o $@ $< \
+	-I"memtest86+/efi/Include"
+
+%.o: memtest86+/%.c
+	$(CC) $(CFLAGS) $(PREPROCESSOR) $(M) -c -o $@ $< \
+	-I"memtest86+/efi"
+
+%.o: memtest86+/efi/Include/src/%.c
+	$(CC) $(CFLAGS) $(PREPROCESSOR) $(M) -c -o $@ $< \
+	-I"memtest86+/efi/Include" \
+	-I"memtest86+/efi/Include/Library"
+
+%.o: memtest86+/efi/Include/src/UefiLib/%.c
+	$(CC) $(CFLAGS) $(PREPROCESSOR) $(M) -c -o $@ $< \
+	-I"memtest86+/efi/Include" \
+	-I"memtest86+/efi/Include/Protocol" \
+	-I"memtest86+/efi/Include/Guid"
+
+BasePcdLibNull.o: memtest86+/efi/Include/src/PcdLib.c
+	$(CC) $(CFLAGS) $(PREPROCESSOR) $(M) -c -o $@ $< \
+	-I"memtest86+/efi/Include"
+
+UefiMemoryAllocationLib.o: memtest86+/efi/Include/src/MemoryAllocationLib.c
+	$(CC) $(CFLAGS) $(PREPROCESSOR) $(M) -c -o $@ $< \
+	-I"memtest86+/efi/Include"
+
+UefiLib2.o: Acpi.o Console.o UefiDriverModel.o UefiLib.o UefiLibPrint.o UefiNotTiano.o
+	ld -r -o $@ $^
+	rm $^
+
+%.o: memtest86+/efi/Include/src/UefiDebugLibStdErr/%.c
+	$(CC) $(CFLAGS) $(PREPROCESSOR) $(M) -c -o $@ $< \
+	-I"memtest86+/efi/Include"
+
+UefiDebugLibStdErr.o: DebugLib.o DebugLibConstructor.o
+	ld -r -o $@ $^
+	rm $^
+
+%.o: memtest86+/efi/Include/src/BaseMemoryLib/%.c
+	$(CC) $(CFLAGS) $(PREPROCESSOR) $(M) -c -o $@ $< \
+	-I"memtest86+/efi/Include"
+
+BaseMemoryLib.o: $(BaseMemoryLib_OBJS)
+	ld -r -o $@ $^
+	rm $^
+
+%.o: memtest86+/efi/Include/src/BasePrintLib/%.c
+	$(CC) $(CFLAGS) $(PREPROCESSOR) $(M) -c -o $@ $< \
+	-I"memtest86+/efi/Include"
+
+BasePrintLib.o: PrintLib.o PrintLibInternal.o
+	ld -r -o $@ $^
+	rm $^
+
+%.o: memtest86+/efi/Include/src/UefiDevicePathLib/%.c
+	$(CC) $(CFLAGS) $(PREPROCESSOR) $(M) -c -o $@ $< \
+	-I"memtest86+/efi/Include"
+
+UefiDevicePathLib2.o: $(UefiDevicePathLib_OBJS)
+	ld -r -o $@ $^
+	rm $^
+
+%.o: memtest86+/efi/Include/src/BaseLib/%.c
+	$(CC) $(CFLAGS) $(PREPROCESSOR) $(M) -c -o $@ $< \
+	-I"memtest86+/efi/Include"
+
+BaseLib.o: $(BaseLib_OBJS)
+	ld -r -o $@ $^
+	rm $^
+
+%.o: memtest86+/efi/%.c
+	$(CC) $(CFLAGS) $(PREPROCESSOR) $(M) -c -o $@ $< \
+	-I"memtest86+" \
+	-I"memtest86+/efi" \
+	-I"memtest86+/efi/Include"
+
+clean:
+	rm -f OUTPUT/*
+	rm -f memtest86+/*.o
+	rm -f *.o
+	rm -f MemtestEfi.obj
+	rm -f MemtestEfi.map
+	rm -f MemtestEfi.dll
+	rm -f MemtestEfi.efi
+	rm -f MemtestEfi.txt
+	rm -f Efi_Defs.obj
+
+
+move:
+	cp MemtestEfi.efi ../test_code/hda-contents
+
+run:
+	sudo ./run.sh
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
diff --git a/debugging_demo/MemtestEfi.c b/debugging_demo/MemtestEfi.c
new file mode 100644
index 0000000..4bd7fa6
--- /dev/null
+++ b/debugging_demo/MemtestEfi.c
@@ -0,0 +1,21 @@
+
+#include "Uefi.h"
+#include "Library/UefiLib.h"
+#include "Library/UefiApplicationEntryPoint.h"
+// #include "Guid/FileSystemInfo.h"
+// #include "Protocol/LoadedImage.h"
+
+
+EFI_STATUS
+EFIAPI
+UefiMain (
+    IN EFI_HANDLE        ImageHandle,
+    IN EFI_SYSTEM_TABLE  *SystemTable
+    )
+{
+
+    SystemTable->ConOut->OutputString(SystemTable->ConOut, (CHAR16 *) "Hello World.");
+
+    return EFI_SUCCESS;
+}
+
diff --git a/debugging_demo/MemtestEfi.efi b/debugging_demo/MemtestEfi.efi
new file mode 100755
index 0000000..6f7aff2
--- /dev/null
+++ b/debugging_demo/MemtestEfi.efi
diff --git a/debugging_demo/MemtestEfi.o b/debugging_demo/MemtestEfi.o
new file mode 100644
index 0000000..9a794a4
--- /dev/null
+++ b/debugging_demo/MemtestEfi.o
diff --git a/debugging_demo/OUTPUT/MemtestEfi.so b/debugging_demo/OUTPUT/MemtestEfi.so
new file mode 100755
index 0000000..ff4f488
--- /dev/null
+++ b/debugging_demo/OUTPUT/MemtestEfi.so
diff --git a/debugging_demo/UefiBootServicesTableLib.o b/debugging_demo/UefiBootServicesTableLib.o
new file mode 100644
index 0000000..59a364b
--- /dev/null
+++ b/debugging_demo/UefiBootServicesTableLib.o
diff --git a/debugging_demo/UefiDebugLibStdErr.o b/debugging_demo/UefiDebugLibStdErr.o
new file mode 100644
index 0000000..703d044
--- /dev/null
+++ b/debugging_demo/UefiDebugLibStdErr.o
diff --git a/debugging_demo/UefiDevicePathLib2.o b/debugging_demo/UefiDevicePathLib2.o
new file mode 100644
index 0000000..ad7a25c
--- /dev/null
+++ b/debugging_demo/UefiDevicePathLib2.o
diff --git a/debugging_demo/UefiLib2.o b/debugging_demo/UefiLib2.o
new file mode 100644
index 0000000..eaaf603
--- /dev/null
+++ b/debugging_demo/UefiLib2.o
diff --git a/debugging_demo/UefiMemoryAllocationLib.o b/debugging_demo/UefiMemoryAllocationLib.o
new file mode 100644
index 0000000..4e4bccc
--- /dev/null
+++ b/debugging_demo/UefiMemoryAllocationLib.o
diff --git a/debugging_demo/UefiRuntimeServicesTableLib.o b/debugging_demo/UefiRuntimeServicesTableLib.o
new file mode 100644
index 0000000..18da417
--- /dev/null
+++ b/debugging_demo/UefiRuntimeServicesTableLib.o
diff --git a/debugging_demo/analyzation b/debugging_demo/analyzation
new file mode 100644
index 0000000..23a0a08
--- /dev/null
+++ b/debugging_demo/analyzation
@@ -0,0 +1,4 @@
+objdump -h ...
+objdump -D ...
+objdump -d ...
+hexdump -C ...
diff --git a/debugging_demo/elf_x86_64_efi.lds b/debugging_demo/elf_x86_64_efi.lds
new file mode 100644
index 0000000..b91cd54
--- /dev/null
+++ b/debugging_demo/elf_x86_64_efi.lds
@@ -0,0 +1,76 @@
+/* Same as elf_x86_64_fbsd_efi.lds, except for OUTPUT_FORMAT below - KEEP IN SYNC */
+OUTPUT_FORMAT("elf64-x86-64", "elf64-x86-64", "elf64-x86-64")
+OUTPUT_ARCH(i386:x86-64)
+ENTRY(_ModuleEntryPoint)
+SECTIONS
+{
+  . = 0;
+  ImageBase = .;
+  /* .hash and/or .gnu.hash MUST come first! */
+  .hash : { *(.hash) }
+  .gnu.hash : { *(.gnu.hash) }
+  . = ALIGN(4096);
+  .eh_frame : 
+  { 
+    *(.eh_frame)
+  }
+  . = ALIGN(4096);
+  .text :
+  {
+   _text = .;
+   *(.text)
+   *(.text.*)
+   *(.gnu.linkonce.t.*)
+   . = ALIGN(16);
+  }
+  _etext = .;
+  _text_size = . - _text;
+  . = ALIGN(4096);
+  .reloc :
+  {
+   *(.reloc)
+  }
+  . = ALIGN(4096);
+  .data :
+  {
+   _data = .;
+   *(.rodata*)
+   *(.got.plt)
+   *(.got)
+   *(.data*)
+   *(.sdata)
+   /* the EFI loader doesn't seem to like a .bss section, so we stick
+      it all into .data: */
+   *(.sbss)
+   *(.scommon)
+   *(.dynbss)
+   *(.bss)
+   *(COMMON)
+   *(.rel.local)
+  }
+  .note.gnu.build-id : { *(.note.gnu.build-id) }
+
+  _edata = .;
+  _data_size = . - _etext;
+  . = ALIGN(4096);
+  .dynamic  : { *(.dynamic) }
+  . = ALIGN(4096);
+  .rela :
+  {
+    *(.rela.data*)
+    *(.rela.got)
+    *(.rela.stab)
+  }
+  . = ALIGN(4096);
+  .dynsym   : { *(.dynsym) }
+  . = ALIGN(4096);
+  .dynstr   : { *(.dynstr) }
+  . = ALIGN(4096);
+  .ignored.reloc :
+  {
+    *(.rela.reloc)
+    *(.eh_frame)
+    *(.note.GNU-stack)
+  }
+  .comment 0 : { *(.comment) }
+}
diff --git a/debugging_demo/memtest86+/efi/Include/AutoGen (copy).c b/debugging_demo/memtest86+/efi/Include/AutoGen (copy).c
new file mode 100644
index 0000000..9a8642a
--- /dev/null
+++ b/debugging_demo/memtest86+/efi/Include/AutoGen (copy).c
@@ -0,0 +1,327 @@
+/**
+  DO NOT EDIT
+  FILE auto-generated
+  Module name:
+    AutoGen.c
+  Abstract:       Auto-generated AutoGen.c for building module or library.
+**/
+#include "Uefi.h"
+#include "Library/BaseLib.h"
+#include "Library/DebugLib.h"
+#include "Library/UefiBootServicesTableLib.h"
+#include "Library/UefiApplicationEntryPoint.h"
+
+GLOBAL_REMOVE_IF_UNREFERENCED GUID gEfiCallerIdGuid = {0x51d8cae0, 0x272a, 0x661f, {0xa8, 0xd9, 0x84, 0x51, 0xdf, 0xf0, 0xeb, 0xd0}};
+
+GLOBAL_REMOVE_IF_UNREFERENCED CHAR8 *gEfiCallerBaseName = "MemtestEfi";
+
+// Guids
+GLOBAL_REMOVE_IF_UNREFERENCED EFI_GUID gEfiMdePkgTokenSpaceGuid = { 0x914AEBE7, 0x4635, 0x459b, { 0xAA, 0x1C, 0x11, 0xE2, 0x19, 0xB0, 0x3A, 0x10 }};
+GLOBAL_REMOVE_IF_UNREFERENCED EFI_GUID gEfiVTUTF8Guid = { 0xAD15A0D6, 0x8BEC, 0x4ACF, { 0xA0, 0x73, 0xD0, 0x1D, 0xE7, 0x7E, 0x2D, 0x88 }};
+GLOBAL_REMOVE_IF_UNREFERENCED EFI_GUID gEfiVT100Guid = { 0xDFA66065, 0xB419, 0x11D3, { 0x9A, 0x2D, 0x00, 0x90, 0x27, 0x3F, 0xC1, 0x4D }};
+GLOBAL_REMOVE_IF_UNREFERENCED EFI_GUID gEfiVT100PlusGuid = { 0x7BAEC70B, 0x57E0, 0x4C76, { 0x8E, 0x87, 0x2F, 0x9E, 0x28, 0x08, 0x83, 0x43 }};
+GLOBAL_REMOVE_IF_UNREFERENCED EFI_GUID gEfiPcAnsiGuid = { 0xE0C14753, 0xF9BE, 0x11D2, { 0x9A, 0x0C, 0x00, 0x90, 0x27, 0x3F, 0xC1, 0x4D }};
+GLOBAL_REMOVE_IF_UNREFERENCED EFI_GUID gEfiUartDevicePathGuid = { 0x37499a9d, 0x542f, 0x4c89, { 0xa0, 0x26, 0x35, 0xda, 0x14, 0x20, 0x94, 0xe4 }};
+GLOBAL_REMOVE_IF_UNREFERENCED EFI_GUID gEfiSasDevicePathGuid = { 0xd487ddb4, 0x008b, 0x11d9, { 0xaf, 0xdc, 0x00, 0x10, 0x83, 0xff, 0xca, 0x4d }};
+GLOBAL_REMOVE_IF_UNREFERENCED EFI_GUID gEfiVirtualDiskGuid = { 0x77AB535A, 0x45FC, 0x624B, {0x55, 0x60, 0xF7, 0xB2, 0x81, 0xD1, 0xF9, 0x6E }};
+GLOBAL_REMOVE_IF_UNREFERENCED EFI_GUID gEfiVirtualCdGuid = { 0x3D5ABD30, 0x4175, 0x87CE, {0x6D, 0x64, 0xD2, 0xAD, 0xE5, 0x23, 0xC4, 0xBB }};
+GLOBAL_REMOVE_IF_UNREFERENCED EFI_GUID gEfiPersistentVirtualDiskGuid = { 0x5CEA02C9, 0x4D07, 0x69D3, {0x26, 0x9F ,0x44, 0x96, 0xFB, 0xE0, 0x96, 0xF9 }};
+GLOBAL_REMOVE_IF_UNREFERENCED EFI_GUID gEfiPersistentVirtualCdGuid = { 0x08018188, 0x42CD, 0xBB48, {0x10, 0x0F, 0x53, 0x87, 0xD5, 0x3D, 0xED, 0x3D }};
+GLOBAL_REMOVE_IF_UNREFERENCED EFI_GUID gEfiEventReadyToBootGuid = { 0x7CE88FB3, 0x4BD7, 0x4679, { 0x87, 0xA8, 0xA8, 0xD8, 0xDE, 0xE5, 0x0D, 0x2B }};
+GLOBAL_REMOVE_IF_UNREFERENCED EFI_GUID gEfiEventLegacyBootGuid = { 0x2A571201, 0x4966, 0x47F6, { 0x8B, 0x86, 0xF3, 0x1E, 0x41, 0xF3, 0x2F, 0x10 }};
+GLOBAL_REMOVE_IF_UNREFERENCED EFI_GUID gEfiGlobalVariableGuid = { 0x8BE4DF61, 0x93CA, 0x11D2, { 0xAA, 0x0D, 0x00, 0xE0, 0x98, 0x03, 0x2B, 0x8C }};
+GLOBAL_REMOVE_IF_UNREFERENCED EFI_GUID gEfiAcpi20TableGuid = { 0x8868E871, 0xE4F1, 0x11D3, { 0xBC, 0x22, 0x00, 0x80, 0xC7, 0x3C, 0x88, 0x81 }};
+GLOBAL_REMOVE_IF_UNREFERENCED EFI_GUID gEfiAcpi10TableGuid = { 0xEB9D2D30, 0x2D88, 0x11D3, { 0x9A, 0x16, 0x00, 0x90, 0x27, 0x3F, 0xC1, 0x4D }};
+
+// Protocols
+GLOBAL_REMOVE_IF_UNREFERENCED EFI_GUID gEfiDevicePathProtocolGuid = { 0x09576E91, 0x6D3F, 0x11D2, { 0x8E, 0x39, 0x00, 0xA0, 0xC9, 0x69, 0x72, 0x3B }};
+GLOBAL_REMOVE_IF_UNREFERENCED EFI_GUID gEfiDebugPortProtocolGuid = { 0xEBA4E8D2, 0x3858, 0x41EC, { 0xA2, 0x81, 0x26, 0x47, 0xBA, 0x96, 0x60, 0xD0 }};
+GLOBAL_REMOVE_IF_UNREFERENCED EFI_GUID gEfiDriverBindingProtocolGuid = { 0x18A031AB, 0xB443, 0x4D1A, { 0xA5, 0xC0, 0x0C, 0x09, 0x26, 0x1E, 0x9F, 0x71 }};
+GLOBAL_REMOVE_IF_UNREFERENCED EFI_GUID gEfiSimpleTextOutProtocolGuid = { 0x387477C2, 0x69C7, 0x11D2, { 0x8E, 0x39, 0x00, 0xA0, 0xC9, 0x69, 0x72, 0x3B }};
+GLOBAL_REMOVE_IF_UNREFERENCED EFI_GUID gEfiGraphicsOutputProtocolGuid = { 0x9042A9DE, 0x23DC, 0x4A38, { 0x96, 0xFB, 0x7A, 0xDE, 0xD0, 0x80, 0x51, 0x6A }};
+GLOBAL_REMOVE_IF_UNREFERENCED EFI_GUID gEfiHiiFontProtocolGuid = {0xe9ca4775, 0x8657, 0x47fc, {0x97, 0xe7, 0x7e, 0xd6, 0x5a, 0x08, 0x43, 0x24}};
+GLOBAL_REMOVE_IF_UNREFERENCED EFI_GUID gEfiSimpleFileSystemProtocolGuid = { 0x964E5B22, 0x6459, 0x11D2, { 0x8E, 0x39, 0x00, 0xA0, 0xC9, 0x69, 0x72, 0x3B }};
+GLOBAL_REMOVE_IF_UNREFERENCED EFI_GUID gEfiUgaDrawProtocolGuid = { 0x982C298B, 0xF4FA, 0x41CB, { 0xB8, 0x38, 0x77, 0xAA, 0x68, 0x8F, 0xB8, 0x39 }};
+GLOBAL_REMOVE_IF_UNREFERENCED EFI_GUID gEfiComponentNameProtocolGuid = { 0x107A772C, 0xD5E1, 0x11D4, { 0x9A, 0x46, 0x00, 0x90, 0x27, 0x3F, 0xC1, 0x4D }};
+GLOBAL_REMOVE_IF_UNREFERENCED EFI_GUID gEfiComponentName2ProtocolGuid = { 0x6A7A5CFF, 0xE8D9, 0x4F70, { 0xBA, 0xDA, 0x75, 0xAB, 0x30, 0x25, 0xCE, 0x14 }};
+GLOBAL_REMOVE_IF_UNREFERENCED EFI_GUID gEfiDriverConfigurationProtocolGuid = { 0x107A772B, 0xD5E1, 0x11D4, { 0x9A, 0x46, 0x00, 0x90, 0x27, 0x3F, 0xC1, 0x4D }};
+GLOBAL_REMOVE_IF_UNREFERENCED EFI_GUID gEfiDriverConfiguration2ProtocolGuid = { 0xBFD7DC1D, 0x24F1, 0x40D9, { 0x82, 0xE7, 0x2E, 0x09, 0xBB, 0x6B, 0x4E, 0xBE }};
+GLOBAL_REMOVE_IF_UNREFERENCED EFI_GUID gEfiDriverDiagnosticsProtocolGuid = { 0x0784924F, 0xE296, 0x11D4, { 0x9A, 0x49, 0x00, 0x90, 0x27, 0x3F, 0xC1, 0x4D }};
+GLOBAL_REMOVE_IF_UNREFERENCED EFI_GUID gEfiDriverDiagnostics2ProtocolGuid = { 0x4D330321, 0x025F, 0x4AAC, { 0x90, 0xD8, 0x5E, 0xD9, 0x00, 0x17, 0x3B, 0x63 }};
+
+// Definition of SkuId Array
+GLOBAL_REMOVE_IF_UNREFERENCED UINT64 _gPcd_SkuId_Array[] = {0x0};
+
+// Definition of PCDs used in libraries
+
+#define _PCD_TOKEN_PcdVerifyNodeInList  17U
+#define _PCD_SIZE_PcdVerifyNodeInList 1
+#define _PCD_GET_MODE_SIZE_PcdVerifyNodeInList  _PCD_SIZE_PcdVerifyNodeInList 
+#define _PCD_VALUE_PcdVerifyNodeInList  ((BOOLEAN)0U)
+GLOBAL_REMOVE_IF_UNREFERENCED const BOOLEAN _gPcd_FixedAtBuild_PcdVerifyNodeInList = _PCD_VALUE_PcdVerifyNodeInList;
+extern const  BOOLEAN  _gPcd_FixedAtBuild_PcdVerifyNodeInList;
+#define _PCD_GET_MODE_BOOL_PcdVerifyNodeInList  _gPcd_FixedAtBuild_PcdVerifyNodeInList
+//#define _PCD_SET_MODE_BOOL_PcdVerifyNodeInList  ASSERT(FALSE)  // It is not allowed to set value for a FIXED_AT_BUILD PCD
+
+#define _PCD_TOKEN_PcdMaximumLinkedListLength  12U
+#define _PCD_SIZE_PcdMaximumLinkedListLength 4
+#define _PCD_GET_MODE_SIZE_PcdMaximumLinkedListLength  _PCD_SIZE_PcdMaximumLinkedListLength 
+#define _PCD_VALUE_PcdMaximumLinkedListLength  1000000U
+GLOBAL_REMOVE_IF_UNREFERENCED const UINT32 _gPcd_FixedAtBuild_PcdMaximumLinkedListLength = _PCD_VALUE_PcdMaximumLinkedListLength;
+extern const  UINT32  _gPcd_FixedAtBuild_PcdMaximumLinkedListLength;
+#define _PCD_GET_MODE_32_PcdMaximumLinkedListLength  _gPcd_FixedAtBuild_PcdMaximumLinkedListLength
+//#define _PCD_SET_MODE_32_PcdMaximumLinkedListLength  ASSERT(FALSE)  // It is not allowed to set value for a FIXED_AT_BUILD PCD
+
+#define _PCD_TOKEN_PcdMaximumAsciiStringLength  10U
+#define _PCD_SIZE_PcdMaximumAsciiStringLength 4
+#define _PCD_GET_MODE_SIZE_PcdMaximumAsciiStringLength  _PCD_SIZE_PcdMaximumAsciiStringLength 
+#define _PCD_VALUE_PcdMaximumAsciiStringLength  1000000U
+GLOBAL_REMOVE_IF_UNREFERENCED const UINT32 _gPcd_FixedAtBuild_PcdMaximumAsciiStringLength = _PCD_VALUE_PcdMaximumAsciiStringLength;
+extern const  UINT32  _gPcd_FixedAtBuild_PcdMaximumAsciiStringLength;
+#define _PCD_GET_MODE_32_PcdMaximumAsciiStringLength  _gPcd_FixedAtBuild_PcdMaximumAsciiStringLength
+//#define _PCD_SET_MODE_32_PcdMaximumAsciiStringLength  ASSERT(FALSE)  // It is not allowed to set value for a FIXED_AT_BUILD PCD
+
+#define _PCD_TOKEN_PcdMaximumUnicodeStringLength  13U
+#define _PCD_SIZE_PcdMaximumUnicodeStringLength 4
+#define _PCD_GET_MODE_SIZE_PcdMaximumUnicodeStringLength  _PCD_SIZE_PcdMaximumUnicodeStringLength 
+#define _PCD_VALUE_PcdMaximumUnicodeStringLength  1000000U
+GLOBAL_REMOVE_IF_UNREFERENCED const UINT32 _gPcd_FixedAtBuild_PcdMaximumUnicodeStringLength = _PCD_VALUE_PcdMaximumUnicodeStringLength;
+extern const  UINT32  _gPcd_FixedAtBuild_PcdMaximumUnicodeStringLength;
+#define _PCD_GET_MODE_32_PcdMaximumUnicodeStringLength  _gPcd_FixedAtBuild_PcdMaximumUnicodeStringLength
+//#define _PCD_SET_MODE_32_PcdMaximumUnicodeStringLength  ASSERT(FALSE)  // It is not allowed to set value for a FIXED_AT_BUILD PCD
+
+#define _PCD_TOKEN_PcdControlFlowEnforcementPropertyMask  3U
+#define _PCD_SIZE_PcdControlFlowEnforcementPropertyMask 4
+#define _PCD_GET_MODE_SIZE_PcdControlFlowEnforcementPropertyMask  _PCD_SIZE_PcdControlFlowEnforcementPropertyMask 
+#define _PCD_VALUE_PcdControlFlowEnforcementPropertyMask  0x0U
+GLOBAL_REMOVE_IF_UNREFERENCED const UINT32 _gPcd_FixedAtBuild_PcdControlFlowEnforcementPropertyMask = _PCD_VALUE_PcdControlFlowEnforcementPropertyMask;
+extern const  UINT32  _gPcd_FixedAtBuild_PcdControlFlowEnforcementPropertyMask;
+#define _PCD_GET_MODE_32_PcdControlFlowEnforcementPropertyMask  _gPcd_FixedAtBuild_PcdControlFlowEnforcementPropertyMask
+//#define _PCD_SET_MODE_32_PcdControlFlowEnforcementPropertyMask  ASSERT(FALSE)  // It is not allowed to set value for a FIXED_AT_BUILD PCD
+
+#define _PCD_TOKEN_PcdSpeculationBarrierType  14U
+#define _PCD_SIZE_PcdSpeculationBarrierType 1
+#define _PCD_GET_MODE_SIZE_PcdSpeculationBarrierType  _PCD_SIZE_PcdSpeculationBarrierType 
+#define _PCD_VALUE_PcdSpeculationBarrierType  0x01U
+GLOBAL_REMOVE_IF_UNREFERENCED const UINT8 _gPcd_FixedAtBuild_PcdSpeculationBarrierType = _PCD_VALUE_PcdSpeculationBarrierType;
+extern const  UINT8  _gPcd_FixedAtBuild_PcdSpeculationBarrierType;
+#define _PCD_GET_MODE_8_PcdSpeculationBarrierType  _gPcd_FixedAtBuild_PcdSpeculationBarrierType
+//#define _PCD_SET_MODE_8_PcdSpeculationBarrierType  ASSERT(FALSE)  // It is not allowed to set value for a FIXED_AT_BUILD PCD
+
+#define _PCD_TOKEN_PcdDebugPrintErrorLevel  5U
+#define _PCD_SIZE_PcdDebugPrintErrorLevel 4
+#define _PCD_GET_MODE_SIZE_PcdDebugPrintErrorLevel  _PCD_SIZE_PcdDebugPrintErrorLevel 
+#define _PCD_VALUE_PcdDebugPrintErrorLevel  0x80000000U
+GLOBAL_REMOVE_IF_UNREFERENCED const UINT32 _gPcd_FixedAtBuild_PcdDebugPrintErrorLevel = _PCD_VALUE_PcdDebugPrintErrorLevel;
+extern const  UINT32  _gPcd_FixedAtBuild_PcdDebugPrintErrorLevel;
+#define _PCD_GET_MODE_32_PcdDebugPrintErrorLevel  _gPcd_FixedAtBuild_PcdDebugPrintErrorLevel
+//#define _PCD_SET_MODE_32_PcdDebugPrintErrorLevel  ASSERT(FALSE)  // It is not allowed to set value for a FIXED_AT_BUILD PCD
+
+#define _PCD_TOKEN_PcdDebugClearMemoryValue  4U
+#define _PCD_SIZE_PcdDebugClearMemoryValue 1
+#define _PCD_GET_MODE_SIZE_PcdDebugClearMemoryValue  _PCD_SIZE_PcdDebugClearMemoryValue 
+#define _PCD_VALUE_PcdDebugClearMemoryValue  0xAFU
+GLOBAL_REMOVE_IF_UNREFERENCED const UINT8 _gPcd_FixedAtBuild_PcdDebugClearMemoryValue = _PCD_VALUE_PcdDebugClearMemoryValue;
+extern const  UINT8  _gPcd_FixedAtBuild_PcdDebugClearMemoryValue;
+#define _PCD_GET_MODE_8_PcdDebugClearMemoryValue  _gPcd_FixedAtBuild_PcdDebugClearMemoryValue
+//#define _PCD_SET_MODE_8_PcdDebugClearMemoryValue  ASSERT(FALSE)  // It is not allowed to set value for a FIXED_AT_BUILD PCD
+
+#define _PCD_TOKEN_PcdDebugPropertyMask  6U
+#define _PCD_SIZE_PcdDebugPropertyMask 1
+#define _PCD_GET_MODE_SIZE_PcdDebugPropertyMask  _PCD_SIZE_PcdDebugPropertyMask 
+#define _PCD_VALUE_PcdDebugPropertyMask  0U
+GLOBAL_REMOVE_IF_UNREFERENCED const UINT8 _gPcd_FixedAtBuild_PcdDebugPropertyMask = _PCD_VALUE_PcdDebugPropertyMask;
+extern const  UINT8  _gPcd_FixedAtBuild_PcdDebugPropertyMask;
+#define _PCD_GET_MODE_8_PcdDebugPropertyMask  _gPcd_FixedAtBuild_PcdDebugPropertyMask
+//#define _PCD_SET_MODE_8_PcdDebugPropertyMask  ASSERT(FALSE)  // It is not allowed to set value for a FIXED_AT_BUILD PCD
+
+#define _PCD_TOKEN_PcdFixedDebugPrintErrorLevel  9U
+#define _PCD_SIZE_PcdFixedDebugPrintErrorLevel 4
+#define _PCD_GET_MODE_SIZE_PcdFixedDebugPrintErrorLevel  _PCD_SIZE_PcdFixedDebugPrintErrorLevel 
+#define _PCD_VALUE_PcdFixedDebugPrintErrorLevel  0xFFFFFFFFU
+GLOBAL_REMOVE_IF_UNREFERENCED const UINT32 _gPcd_FixedAtBuild_PcdFixedDebugPrintErrorLevel = _PCD_VALUE_PcdFixedDebugPrintErrorLevel;
+extern const  UINT32  _gPcd_FixedAtBuild_PcdFixedDebugPrintErrorLevel;
+#define _PCD_GET_MODE_32_PcdFixedDebugPrintErrorLevel  _gPcd_FixedAtBuild_PcdFixedDebugPrintErrorLevel
+//#define _PCD_SET_MODE_32_PcdFixedDebugPrintErrorLevel  ASSERT(FALSE)  // It is not allowed to set value for a FIXED_AT_BUILD PCD
+
+#define _PCD_TOKEN_PcdMaximumDevicePathNodeCount  11U
+#define _PCD_SIZE_PcdMaximumDevicePathNodeCount 4
+#define _PCD_GET_MODE_SIZE_PcdMaximumDevicePathNodeCount  _PCD_SIZE_PcdMaximumDevicePathNodeCount 
+#define _PCD_VALUE_PcdMaximumDevicePathNodeCount  0U
+GLOBAL_REMOVE_IF_UNREFERENCED const UINT32 _gPcd_FixedAtBuild_PcdMaximumDevicePathNodeCount = _PCD_VALUE_PcdMaximumDevicePathNodeCount;
+extern const  UINT32  _gPcd_FixedAtBuild_PcdMaximumDevicePathNodeCount;
+#define _PCD_GET_MODE_32_PcdMaximumDevicePathNodeCount  _gPcd_FixedAtBuild_PcdMaximumDevicePathNodeCount
+//#define _PCD_SET_MODE_32_PcdMaximumDevicePathNodeCount  ASSERT(FALSE)  // It is not allowed to set value for a FIXED_AT_BUILD PCD
+
+#define _PCD_TOKEN_PcdDriverDiagnosticsDisable  8U
+#define _PCD_SIZE_PcdDriverDiagnosticsDisable 1
+#define _PCD_GET_MODE_SIZE_PcdDriverDiagnosticsDisable  _PCD_SIZE_PcdDriverDiagnosticsDisable 
+#define _PCD_VALUE_PcdDriverDiagnosticsDisable  ((BOOLEAN)0U)
+GLOBAL_REMOVE_IF_UNREFERENCED const BOOLEAN _gPcd_FixedAtBuild_PcdDriverDiagnosticsDisable = _PCD_VALUE_PcdDriverDiagnosticsDisable;
+extern const  BOOLEAN  _gPcd_FixedAtBuild_PcdDriverDiagnosticsDisable;
+#define _PCD_GET_MODE_BOOL_PcdDriverDiagnosticsDisable  _gPcd_FixedAtBuild_PcdDriverDiagnosticsDisable
+//#define _PCD_SET_MODE_BOOL_PcdDriverDiagnosticsDisable  ASSERT(FALSE)  // It is not allowed to set value for a FIXED_AT_BUILD PCD
+
+#define _PCD_TOKEN_PcdComponentNameDisable  2U
+#define _PCD_SIZE_PcdComponentNameDisable 1
+#define _PCD_GET_MODE_SIZE_PcdComponentNameDisable  _PCD_SIZE_PcdComponentNameDisable 
+#define _PCD_VALUE_PcdComponentNameDisable  ((BOOLEAN)0U)
+GLOBAL_REMOVE_IF_UNREFERENCED const BOOLEAN _gPcd_FixedAtBuild_PcdComponentNameDisable = _PCD_VALUE_PcdComponentNameDisable;
+extern const  BOOLEAN  _gPcd_FixedAtBuild_PcdComponentNameDisable;
+#define _PCD_GET_MODE_BOOL_PcdComponentNameDisable  _gPcd_FixedAtBuild_PcdComponentNameDisable
+//#define _PCD_SET_MODE_BOOL_PcdComponentNameDisable  ASSERT(FALSE)  // It is not allowed to set value for a FIXED_AT_BUILD PCD
+
+#define _PCD_TOKEN_PcdDriverDiagnostics2Disable  7U
+#define _PCD_SIZE_PcdDriverDiagnostics2Disable 1
+#define _PCD_GET_MODE_SIZE_PcdDriverDiagnostics2Disable  _PCD_SIZE_PcdDriverDiagnostics2Disable 
+#define _PCD_VALUE_PcdDriverDiagnostics2Disable  ((BOOLEAN)0U)
+GLOBAL_REMOVE_IF_UNREFERENCED const BOOLEAN _gPcd_FixedAtBuild_PcdDriverDiagnostics2Disable = _PCD_VALUE_PcdDriverDiagnostics2Disable;
+extern const  BOOLEAN  _gPcd_FixedAtBuild_PcdDriverDiagnostics2Disable;
+#define _PCD_GET_MODE_BOOL_PcdDriverDiagnostics2Disable  _gPcd_FixedAtBuild_PcdDriverDiagnostics2Disable
+//#define _PCD_SET_MODE_BOOL_PcdDriverDiagnostics2Disable  ASSERT(FALSE)  // It is not allowed to set value for a FIXED_AT_BUILD PCD
+
+#define _PCD_TOKEN_PcdComponentName2Disable  1U
+#define _PCD_SIZE_PcdComponentName2Disable 1
+#define _PCD_GET_MODE_SIZE_PcdComponentName2Disable  _PCD_SIZE_PcdComponentName2Disable 
+#define _PCD_VALUE_PcdComponentName2Disable  ((BOOLEAN)0U)
+GLOBAL_REMOVE_IF_UNREFERENCED const BOOLEAN _gPcd_FixedAtBuild_PcdComponentName2Disable = _PCD_VALUE_PcdComponentName2Disable;
+extern const  BOOLEAN  _gPcd_FixedAtBuild_PcdComponentName2Disable;
+#define _PCD_GET_MODE_BOOL_PcdComponentName2Disable  _gPcd_FixedAtBuild_PcdComponentName2Disable
+//#define _PCD_SET_MODE_BOOL_PcdComponentName2Disable  ASSERT(FALSE)  // It is not allowed to set value for a FIXED_AT_BUILD PCD
+
+#define _PCD_TOKEN_PcdUgaConsumeSupport  16U
+#define _PCD_SIZE_PcdUgaConsumeSupport 1
+#define _PCD_GET_MODE_SIZE_PcdUgaConsumeSupport  _PCD_SIZE_PcdUgaConsumeSupport 
+#define _PCD_VALUE_PcdUgaConsumeSupport  ((BOOLEAN)1U)
+GLOBAL_REMOVE_IF_UNREFERENCED const BOOLEAN _gPcd_FixedAtBuild_PcdUgaConsumeSupport = _PCD_VALUE_PcdUgaConsumeSupport;
+extern const  BOOLEAN  _gPcd_FixedAtBuild_PcdUgaConsumeSupport;
+#define _PCD_GET_MODE_BOOL_PcdUgaConsumeSupport  _gPcd_FixedAtBuild_PcdUgaConsumeSupport
+//#define _PCD_SET_MODE_BOOL_PcdUgaConsumeSupport  ASSERT(FALSE)  // It is not allowed to set value for a FIXED_AT_BUILD PCD
+
+#define _PCD_TOKEN_PcdUefiLibMaxPrintBufferSize  15U
+#define _PCD_SIZE_PcdUefiLibMaxPrintBufferSize 4
+#define _PCD_GET_MODE_SIZE_PcdUefiLibMaxPrintBufferSize  _PCD_SIZE_PcdUefiLibMaxPrintBufferSize 
+#define _PCD_VALUE_PcdUefiLibMaxPrintBufferSize  320U
+GLOBAL_REMOVE_IF_UNREFERENCED const UINT32 _gPcd_FixedAtBuild_PcdUefiLibMaxPrintBufferSize = _PCD_VALUE_PcdUefiLibMaxPrintBufferSize;
+extern const  UINT32  _gPcd_FixedAtBuild_PcdUefiLibMaxPrintBufferSize;
+#define _PCD_GET_MODE_32_PcdUefiLibMaxPrintBufferSize  _gPcd_FixedAtBuild_PcdUefiLibMaxPrintBufferSize
+//#define _PCD_SET_MODE_32_PcdUefiLibMaxPrintBufferSize  ASSERT(FALSE)  // It is not allowed to set value for a FIXED_AT_BUILD PCD
+
+extern EFI_STATUS
+EFIAPI
+UefiMain (
+  IN EFI_HANDLE        ImageHandle,
+  IN EFI_SYSTEM_TABLE  *SystemTable
+  );
+
+EFI_STATUS
+EFIAPI
+DxeDebugLibConstructor (
+  IN EFI_HANDLE        ImageHandle,
+  IN EFI_SYSTEM_TABLE  *SystemTable
+  );
+
+EFI_STATUS
+EFIAPI
+UefiBootServicesTableLibConstructor (
+  IN EFI_HANDLE        ImageHandle,
+  IN EFI_SYSTEM_TABLE  *SystemTable
+  );
+
+EFI_STATUS
+EFIAPI
+UefiRuntimeServicesTableLibConstructor (
+  IN EFI_HANDLE        ImageHandle,
+  IN EFI_SYSTEM_TABLE  *SystemTable
+  );
+
+EFI_STATUS
+EFIAPI
+UefiLibConstructor (
+  IN EFI_HANDLE        ImageHandle,
+  IN EFI_SYSTEM_TABLE  *SystemTable
+  );
+
+
+VOID
+EFIAPI
+ProcessLibraryConstructorList (
+  IN EFI_HANDLE        ImageHandle,
+  IN EFI_SYSTEM_TABLE  *SystemTable
+  )
+{
+  EFI_STATUS  Status;
+
+  Status = DxeDebugLibConstructor (ImageHandle, SystemTable);
+  ASSERT_EFI_ERROR (Status);
+
+  Status = UefiBootServicesTableLibConstructor (ImageHandle, SystemTable);
+  ASSERT_EFI_ERROR (Status);
+
+  Status = UefiRuntimeServicesTableLibConstructor (ImageHandle, SystemTable);
+  ASSERT_EFI_ERROR (Status);
+
+  Status = UefiLibConstructor (ImageHandle, SystemTable);
+  ASSERT_EFI_ERROR (Status);
+
+}
+
+
+EFI_STATUS
+EFIAPI
+DxeDebugLibDestructor (
+  IN EFI_HANDLE        ImageHandle,
+  IN EFI_SYSTEM_TABLE  *SystemTable
+  );
+
+
+VOID
+EFIAPI
+ProcessLibraryDestructorList (
+  IN EFI_HANDLE        ImageHandle,
+  IN EFI_SYSTEM_TABLE  *SystemTable
+  )
+{
+  EFI_STATUS  Status;
+
+  Status = DxeDebugLibDestructor (ImageHandle, SystemTable);
+  ASSERT_EFI_ERROR (Status);
+
+}
+
+const UINT32 _gUefiDriverRevision = 0x00000000U;
+
+
+EFI_STATUS
+EFIAPI
+ProcessModuleEntryPointList (
+  IN EFI_HANDLE        ImageHandle,
+  IN EFI_SYSTEM_TABLE  *SystemTable
+  )
+
+{
+  return UefiMain (ImageHandle, SystemTable);
+}
+
+VOID
+EFIAPI
+ExitDriver (
+  IN EFI_STATUS  Status
+  )
+{
+  if (EFI_ERROR (Status)) {
+    ProcessLibraryDestructorList (gImageHandle, gST);
+  }
+  gBS->Exit (gImageHandle, Status, 0, NULL);
+}
+
+GLOBAL_REMOVE_IF_UNREFERENCED const UINT8 _gDriverUnloadImageCount = 0U;
+
+EFI_STATUS
+EFIAPI
+ProcessModuleUnloadList (
+  IN EFI_HANDLE        ImageHandle
+  )
+{
+  return EFI_SUCCESS;
+}
diff --git a/debugging_demo/memtest86+/efi/Include/AutoGen (copy).h b/debugging_demo/memtest86+/efi/Include/AutoGen (copy).h
new file mode 100644
index 0000000..78d71dd
--- /dev/null
+++ b/debugging_demo/memtest86+/efi/Include/AutoGen (copy).h
@@ -0,0 +1,75 @@
+/**
+  DO NOT EDIT
+  FILE auto-generated
+  Module name:
+    AutoGen.h
+  Abstract:       Auto-generated AutoGen.h for building module or library.
+**/
+
+#ifdef __cplusplus
+extern "C" {
+#endif
+
+#include "Uefi.h"
+
+extern GUID  gEfiCallerIdGuid;
+extern CHAR8 *gEfiCallerBaseName;
+
+#define EFI_CALLER_ID_GUID \
+  {0x51d8cae0, 0x272a, 0x661f, {0xa8, 0xd9, 0x84, 0x51, 0xdf, 0xf0, 0xeb, 0xd0}}
+
+// Guids
+extern EFI_GUID gEfiMdePkgTokenSpaceGuid;
+extern EFI_GUID gEfiVTUTF8Guid;
+extern EFI_GUID gEfiVT100Guid;
+extern EFI_GUID gEfiVT100PlusGuid;
+extern EFI_GUID gEfiPcAnsiGuid;
+extern EFI_GUID gEfiUartDevicePathGuid;
+extern EFI_GUID gEfiSasDevicePathGuid;
+extern EFI_GUID gEfiVirtualDiskGuid;
+extern EFI_GUID gEfiVirtualCdGuid;
+extern EFI_GUID gEfiPersistentVirtualDiskGuid;
+extern EFI_GUID gEfiPersistentVirtualCdGuid;
+extern EFI_GUID gEfiEventReadyToBootGuid;
+extern EFI_GUID gEfiEventLegacyBootGuid;
+extern EFI_GUID gEfiGlobalVariableGuid;
+extern EFI_GUID gEfiAcpi20TableGuid;
+extern EFI_GUID gEfiAcpi10TableGuid;
+
+// Protocols
+extern EFI_GUID gEfiDevicePathProtocolGuid;
+extern EFI_GUID gEfiDebugPortProtocolGuid;
+extern EFI_GUID gEfiDriverBindingProtocolGuid;
+extern EFI_GUID gEfiSimpleTextOutProtocolGuid;
+extern EFI_GUID gEfiGraphicsOutputProtocolGuid;
+extern EFI_GUID gEfiHiiFontProtocolGuid;
+extern EFI_GUID gEfiSimpleFileSystemProtocolGuid;
+extern EFI_GUID gEfiUgaDrawProtocolGuid;
+extern EFI_GUID gEfiComponentNameProtocolGuid;
+extern EFI_GUID gEfiComponentName2ProtocolGuid;
+extern EFI_GUID gEfiDriverConfigurationProtocolGuid;
+extern EFI_GUID gEfiDriverConfiguration2ProtocolGuid;
+extern EFI_GUID gEfiDriverDiagnosticsProtocolGuid;
+extern EFI_GUID gEfiDriverDiagnostics2ProtocolGuid;
+
+// Definition of SkuId Array
+extern UINT64 _gPcd_SkuId_Array[];
+
+// Definition of PCDs used in libraries is in AutoGen.c
+
+
+EFI_STATUS
+EFIAPI
+UefiMain (
+  IN EFI_HANDLE        ImageHandle,
+  IN EFI_SYSTEM_TABLE  *SystemTable
+  );
+
+
+
+
+
+#ifdef __cplusplus
+}
+
+#endif
diff --git a/debugging_demo/memtest86+/efi/Include/Base.h b/debugging_demo/memtest86+/efi/Include/Base.h
new file mode 100644
index 0000000..85a091b
--- /dev/null
+++ b/debugging_demo/memtest86+/efi/Include/Base.h
@@ -0,0 +1,1315 @@
+/** @file

+  Root include file for Mde Package Base type modules

+

+  This is the include file for any module of type base. Base modules only use

+  types defined via this include file and can be ported easily to any

+  environment. There are a set of base libraries in the Mde Package that can

+  be used to implement base modules.

+

+Copyright (c) 2006 - 2018, Intel Corporation. All rights reserved.<BR>

+Portions copyright (c) 2008 - 2009, Apple Inc. All rights reserved.<BR>

+SPDX-License-Identifier: BSD-2-Clause-Patent

+

+**/

+

+

+#ifndef __BASE_H__

+#define __BASE_H__

+

+//

+// Include processor specific binding

+//

+#include <ProcessorBind.h>

+

+#if defined(_MSC_EXTENSIONS)

+//

+// Disable warning when last field of data structure is a zero sized array.

+//

+#pragma warning ( disable : 4200 )

+#endif

+

+//

+// The Microsoft* C compiler can removed references to unreferenced data items

+//  if the /OPT:REF linker option is used. We defined a macro as this is a

+//  a non standard extension

+//

+#if defined(_MSC_VER) && _MSC_VER < 1800 && !defined (MDE_CPU_EBC)

+  ///

+  /// Remove global variable from the linked image if there are no references to

+  /// it after all compiler and linker optimizations have been performed.

+  ///

+  ///

+  #define GLOBAL_REMOVE_IF_UNREFERENCED __declspec(selectany)

+#else

+  ///

+  /// Remove the global variable from the linked image if there are no references

+  ///  to it after all compiler and linker optimizations have been performed.

+  ///

+  ///

+  #define GLOBAL_REMOVE_IF_UNREFERENCED

+#endif

+

+//

+// Should be used in combination with NORETURN to avoid 'noreturn' returns

+// warnings.

+//

+#ifndef UNREACHABLE

+  #ifdef __GNUC__

+    ///

+    /// Signal compilers and analyzers that this call is not reachable.  It is

+    /// up to the compiler to remove any code past that point.

+    ///

+    #define UNREACHABLE()  __builtin_unreachable ()

+  #elif defined (__has_feature)

+    #if __has_builtin (__builtin_unreachable)

+      ///

+      /// Signal compilers and analyzers that this call is not reachable.  It is

+      /// up to the compiler to remove any code past that point.

+      ///

+      #define UNREACHABLE()  __builtin_unreachable ()

+    #endif

+  #endif

+

+  #ifndef UNREACHABLE

+    ///

+    /// Signal compilers and analyzers that this call is not reachable.  It is

+    /// up to the compiler to remove any code past that point.

+    ///

+    #define UNREACHABLE()

+  #endif

+#endif

+

+//

+// Signaling compilers and analyzers that a certain function cannot return may

+// remove all following code and thus lead to better optimization and less

+// false positives.

+//

+#ifndef NORETURN

+  #if defined (__GNUC__) || defined (__clang__)

+    ///

+    /// Signal compilers and analyzers that the function cannot return.

+    /// It is up to the compiler to remove any code past a call to functions

+    /// flagged with this attribute.

+    ///

+    #define NORETURN  __attribute__((noreturn))

+  #elif defined(_MSC_EXTENSIONS) && !defined(MDE_CPU_EBC)

+    ///

+    /// Signal compilers and analyzers that the function cannot return.

+    /// It is up to the compiler to remove any code past a call to functions

+    /// flagged with this attribute.

+    ///

+    #define NORETURN  __declspec(noreturn)

+  #else

+    ///

+    /// Signal compilers and analyzers that the function cannot return.

+    /// It is up to the compiler to remove any code past a call to functions

+    /// flagged with this attribute.

+    ///

+    #define NORETURN

+  #endif

+#endif

+

+//

+// Should be used in combination with ANALYZER_NORETURN to avoid 'noreturn'

+// returns warnings.

+//

+#ifndef ANALYZER_UNREACHABLE

+  #ifdef __clang_analyzer__

+    #if __has_builtin (__builtin_unreachable)

+      ///

+      /// Signal the analyzer that this call is not reachable.

+      /// This excludes compilers.

+      ///

+      #define ANALYZER_UNREACHABLE()  __builtin_unreachable ()

+    #endif

+  #endif

+

+  #ifndef ANALYZER_UNREACHABLE

+    ///

+    /// Signal the analyzer that this call is not reachable.

+    /// This excludes compilers.

+    ///

+    #define ANALYZER_UNREACHABLE()

+  #endif

+#endif

+

+//

+// Static Analyzers may issue errors about potential NULL-dereferences when

+// dereferencing a pointer, that has been checked before, outside of a

+// NULL-check.  This may lead to false positives, such as when using ASSERT()

+// for verification.

+//

+#ifndef ANALYZER_NORETURN

+  #ifdef __has_feature

+    #if __has_feature (attribute_analyzer_noreturn)

+      ///

+      /// Signal analyzers that the function cannot return.

+      /// This excludes compilers.

+      ///

+      #define ANALYZER_NORETURN  __attribute__((analyzer_noreturn))

+    #endif

+  #endif

+

+  #ifndef ANALYZER_NORETURN

+    ///

+    /// Signal the analyzer that the function cannot return.

+    /// This excludes compilers.

+    ///

+    #define ANALYZER_NORETURN

+  #endif

+#endif

+

+///

+/// Tell the code optimizer that the function will return twice.

+/// This prevents wrong optimizations which can cause bugs.

+///

+#ifndef RETURNS_TWICE

+  #if defined (__GNUC__) || defined (__clang__)

+    ///

+    /// Tell the code optimizer that the function will return twice.

+    /// This prevents wrong optimizations which can cause bugs.

+    ///

+    #define RETURNS_TWICE  __attribute__((returns_twice))

+  #else

+    ///

+    /// Tell the code optimizer that the function will return twice.

+    /// This prevents wrong optimizations which can cause bugs.

+    ///

+    #define RETURNS_TWICE

+  #endif

+#endif

+

+//

+// For symbol name in assembly code, an extra "_" is sometimes necessary

+//

+

+///

+/// Private worker functions for ASM_PFX()

+///

+#define _CONCATENATE(a, b)  __CONCATENATE(a, b)

+#define __CONCATENATE(a, b) a ## b

+

+///

+/// The __USER_LABEL_PREFIX__ macro predefined by GNUC represents the prefix

+/// on symbols in assembly language.

+///

+#define ASM_PFX(name) _CONCATENATE (__USER_LABEL_PREFIX__, name)

+

+#ifdef __APPLE__

+  //

+  // Apple extension that is used by the linker to optimize code size

+  // with assembly functions. Put at the end of your .S files

+  //

+  #define ASM_FUNCTION_REMOVE_IF_UNREFERENCED  .subsections_via_symbols

+#else

+  #define ASM_FUNCTION_REMOVE_IF_UNREFERENCED

+#endif

+

+#ifdef __CC_ARM

+  //

+  // Older RVCT ARM compilers don't fully support #pragma pack and require __packed

+  // as a prefix for the structure.

+  //

+  #define PACKED  __packed

+#else

+  #define PACKED

+#endif

+

+///

+/// 128 bit buffer containing a unique identifier value.

+/// Unless otherwise specified, aligned on a 64 bit boundary.

+///

+typedef struct {

+  UINT32  Data1;

+  UINT16  Data2;

+  UINT16  Data3;

+  UINT8   Data4[8];

+} GUID;

+

+///

+/// 4-byte buffer. An IPv4 internet protocol address.

+///

+typedef struct {

+  UINT8 Addr[4];

+} IPv4_ADDRESS;

+

+///

+/// 16-byte buffer. An IPv6 internet protocol address.

+///

+typedef struct {

+  UINT8 Addr[16];

+} IPv6_ADDRESS;

+

+//

+// 8-bytes unsigned value that represents a physical system address.

+//

+typedef UINT64 PHYSICAL_ADDRESS;

+

+///

+/// LIST_ENTRY structure definition.

+///

+typedef struct _LIST_ENTRY LIST_ENTRY;

+

+///

+/// _LIST_ENTRY structure definition.

+///

+struct _LIST_ENTRY {

+  LIST_ENTRY  *ForwardLink;

+  LIST_ENTRY  *BackLink;

+};

+

+//

+// Modifiers to abstract standard types to aid in debug of problems

+//

+

+///

+/// Datum is read-only.

+///

+#define CONST     const

+

+///

+/// Datum is scoped to the current file or function.

+///

+#define STATIC    static

+

+///

+/// Undeclared type.

+///

+#define VOID      void

+

+//

+// Modifiers for Data Types used to self document code.

+// This concept is borrowed for UEFI specification.

+//

+

+///

+/// Datum is passed to the function.

+///

+#define IN

+

+///

+/// Datum is returned from the function.

+///

+#define OUT

+

+///

+/// Passing the datum to the function is optional, and a NULL

+/// is passed if the value is not supplied.

+///

+#define OPTIONAL

+

+//

+//  UEFI specification claims 1 and 0. We are concerned about the

+//  compiler portability so we did it this way.

+//

+

+///

+/// Boolean true value.  UEFI Specification defines this value to be 1,

+/// but this form is more portable.

+///

+#define TRUE  ((BOOLEAN)(1==1))

+

+///

+/// Boolean false value.  UEFI Specification defines this value to be 0,

+/// but this form is more portable.

+///

+#define FALSE ((BOOLEAN)(0==1))

+

+///

+/// NULL pointer (VOID *)

+///

+#define NULL  ((VOID *) 0)

+

+//

+// Null character

+//

+#define CHAR_NULL             0x0000

+

+///

+/// Maximum values for common UEFI Data Types

+///

+#define MAX_INT8    ((INT8)0x7F)

+#define MAX_UINT8   ((UINT8)0xFF)

+#define MAX_INT16   ((INT16)0x7FFF)

+#define MAX_UINT16  ((UINT16)0xFFFF)

+#define MAX_INT32   ((INT32)0x7FFFFFFF)

+#define MAX_UINT32  ((UINT32)0xFFFFFFFF)

+#define MAX_INT64   ((INT64)0x7FFFFFFFFFFFFFFFULL)

+#define MAX_UINT64  ((UINT64)0xFFFFFFFFFFFFFFFFULL)

+

+///

+/// Minimum values for the signed UEFI Data Types

+///

+#define MIN_INT8   (((INT8)  -127) - 1)

+#define MIN_INT16  (((INT16) -32767) - 1)

+#define MIN_INT32  (((INT32) -2147483647) - 1)

+#define MIN_INT64  (((INT64) -9223372036854775807LL) - 1)

+

+#define  BIT0     0x00000001

+#define  BIT1     0x00000002

+#define  BIT2     0x00000004

+#define  BIT3     0x00000008

+#define  BIT4     0x00000010

+#define  BIT5     0x00000020

+#define  BIT6     0x00000040

+#define  BIT7     0x00000080

+#define  BIT8     0x00000100

+#define  BIT9     0x00000200

+#define  BIT10    0x00000400

+#define  BIT11    0x00000800

+#define  BIT12    0x00001000

+#define  BIT13    0x00002000

+#define  BIT14    0x00004000

+#define  BIT15    0x00008000

+#define  BIT16    0x00010000

+#define  BIT17    0x00020000

+#define  BIT18    0x00040000

+#define  BIT19    0x00080000

+#define  BIT20    0x00100000

+#define  BIT21    0x00200000

+#define  BIT22    0x00400000

+#define  BIT23    0x00800000

+#define  BIT24    0x01000000

+#define  BIT25    0x02000000

+#define  BIT26    0x04000000

+#define  BIT27    0x08000000

+#define  BIT28    0x10000000

+#define  BIT29    0x20000000

+#define  BIT30    0x40000000

+#define  BIT31    0x80000000

+#define  BIT32    0x0000000100000000ULL

+#define  BIT33    0x0000000200000000ULL

+#define  BIT34    0x0000000400000000ULL

+#define  BIT35    0x0000000800000000ULL

+#define  BIT36    0x0000001000000000ULL

+#define  BIT37    0x0000002000000000ULL

+#define  BIT38    0x0000004000000000ULL

+#define  BIT39    0x0000008000000000ULL

+#define  BIT40    0x0000010000000000ULL

+#define  BIT41    0x0000020000000000ULL

+#define  BIT42    0x0000040000000000ULL

+#define  BIT43    0x0000080000000000ULL

+#define  BIT44    0x0000100000000000ULL

+#define  BIT45    0x0000200000000000ULL

+#define  BIT46    0x0000400000000000ULL

+#define  BIT47    0x0000800000000000ULL

+#define  BIT48    0x0001000000000000ULL

+#define  BIT49    0x0002000000000000ULL

+#define  BIT50    0x0004000000000000ULL

+#define  BIT51    0x0008000000000000ULL

+#define  BIT52    0x0010000000000000ULL

+#define  BIT53    0x0020000000000000ULL

+#define  BIT54    0x0040000000000000ULL

+#define  BIT55    0x0080000000000000ULL

+#define  BIT56    0x0100000000000000ULL

+#define  BIT57    0x0200000000000000ULL

+#define  BIT58    0x0400000000000000ULL

+#define  BIT59    0x0800000000000000ULL

+#define  BIT60    0x1000000000000000ULL

+#define  BIT61    0x2000000000000000ULL

+#define  BIT62    0x4000000000000000ULL

+#define  BIT63    0x8000000000000000ULL

+

+#define  SIZE_1KB    0x00000400

+#define  SIZE_2KB    0x00000800

+#define  SIZE_4KB    0x00001000

+#define  SIZE_8KB    0x00002000

+#define  SIZE_16KB   0x00004000

+#define  SIZE_32KB   0x00008000

+#define  SIZE_64KB   0x00010000

+#define  SIZE_128KB  0x00020000

+#define  SIZE_256KB  0x00040000

+#define  SIZE_512KB  0x00080000

+#define  SIZE_1MB    0x00100000

+#define  SIZE_2MB    0x00200000

+#define  SIZE_4MB    0x00400000

+#define  SIZE_8MB    0x00800000

+#define  SIZE_16MB   0x01000000

+#define  SIZE_32MB   0x02000000

+#define  SIZE_64MB   0x04000000

+#define  SIZE_128MB  0x08000000

+#define  SIZE_256MB  0x10000000

+#define  SIZE_512MB  0x20000000

+#define  SIZE_1GB    0x40000000

+#define  SIZE_2GB    0x80000000

+#define  SIZE_4GB    0x0000000100000000ULL

+#define  SIZE_8GB    0x0000000200000000ULL

+#define  SIZE_16GB   0x0000000400000000ULL

+#define  SIZE_32GB   0x0000000800000000ULL

+#define  SIZE_64GB   0x0000001000000000ULL

+#define  SIZE_128GB  0x0000002000000000ULL

+#define  SIZE_256GB  0x0000004000000000ULL

+#define  SIZE_512GB  0x0000008000000000ULL

+#define  SIZE_1TB    0x0000010000000000ULL

+#define  SIZE_2TB    0x0000020000000000ULL

+#define  SIZE_4TB    0x0000040000000000ULL

+#define  SIZE_8TB    0x0000080000000000ULL

+#define  SIZE_16TB   0x0000100000000000ULL

+#define  SIZE_32TB   0x0000200000000000ULL

+#define  SIZE_64TB   0x0000400000000000ULL

+#define  SIZE_128TB  0x0000800000000000ULL

+#define  SIZE_256TB  0x0001000000000000ULL

+#define  SIZE_512TB  0x0002000000000000ULL

+#define  SIZE_1PB    0x0004000000000000ULL

+#define  SIZE_2PB    0x0008000000000000ULL

+#define  SIZE_4PB    0x0010000000000000ULL

+#define  SIZE_8PB    0x0020000000000000ULL

+#define  SIZE_16PB   0x0040000000000000ULL

+#define  SIZE_32PB   0x0080000000000000ULL

+#define  SIZE_64PB   0x0100000000000000ULL

+#define  SIZE_128PB  0x0200000000000000ULL

+#define  SIZE_256PB  0x0400000000000000ULL

+#define  SIZE_512PB  0x0800000000000000ULL

+#define  SIZE_1EB    0x1000000000000000ULL

+#define  SIZE_2EB    0x2000000000000000ULL

+#define  SIZE_4EB    0x4000000000000000ULL

+#define  SIZE_8EB    0x8000000000000000ULL

+

+#define  BASE_1KB    0x00000400

+#define  BASE_2KB    0x00000800

+#define  BASE_4KB    0x00001000

+#define  BASE_8KB    0x00002000

+#define  BASE_16KB   0x00004000

+#define  BASE_32KB   0x00008000

+#define  BASE_64KB   0x00010000

+#define  BASE_128KB  0x00020000

+#define  BASE_256KB  0x00040000

+#define  BASE_512KB  0x00080000

+#define  BASE_1MB    0x00100000

+#define  BASE_2MB    0x00200000

+#define  BASE_4MB    0x00400000

+#define  BASE_8MB    0x00800000

+#define  BASE_16MB   0x01000000

+#define  BASE_32MB   0x02000000

+#define  BASE_64MB   0x04000000

+#define  BASE_128MB  0x08000000

+#define  BASE_256MB  0x10000000

+#define  BASE_512MB  0x20000000

+#define  BASE_1GB    0x40000000

+#define  BASE_2GB    0x80000000

+#define  BASE_4GB    0x0000000100000000ULL

+#define  BASE_8GB    0x0000000200000000ULL

+#define  BASE_16GB   0x0000000400000000ULL

+#define  BASE_32GB   0x0000000800000000ULL

+#define  BASE_64GB   0x0000001000000000ULL

+#define  BASE_128GB  0x0000002000000000ULL

+#define  BASE_256GB  0x0000004000000000ULL

+#define  BASE_512GB  0x0000008000000000ULL

+#define  BASE_1TB    0x0000010000000000ULL

+#define  BASE_2TB    0x0000020000000000ULL

+#define  BASE_4TB    0x0000040000000000ULL

+#define  BASE_8TB    0x0000080000000000ULL

+#define  BASE_16TB   0x0000100000000000ULL

+#define  BASE_32TB   0x0000200000000000ULL

+#define  BASE_64TB   0x0000400000000000ULL

+#define  BASE_128TB  0x0000800000000000ULL

+#define  BASE_256TB  0x0001000000000000ULL

+#define  BASE_512TB  0x0002000000000000ULL

+#define  BASE_1PB    0x0004000000000000ULL

+#define  BASE_2PB    0x0008000000000000ULL

+#define  BASE_4PB    0x0010000000000000ULL

+#define  BASE_8PB    0x0020000000000000ULL

+#define  BASE_16PB   0x0040000000000000ULL

+#define  BASE_32PB   0x0080000000000000ULL

+#define  BASE_64PB   0x0100000000000000ULL

+#define  BASE_128PB  0x0200000000000000ULL

+#define  BASE_256PB  0x0400000000000000ULL

+#define  BASE_512PB  0x0800000000000000ULL

+#define  BASE_1EB    0x1000000000000000ULL

+#define  BASE_2EB    0x2000000000000000ULL

+#define  BASE_4EB    0x4000000000000000ULL

+#define  BASE_8EB    0x8000000000000000ULL

+

+//

+//  Support for variable argument lists in freestanding edk2 modules.

+//

+//  For modules that use the ISO C library interfaces for variable

+//  argument lists, refer to "StdLib/Include/stdarg.h".

+//

+//  VA_LIST  - typedef for argument list.

+//  VA_START (VA_LIST Marker, argument before the ...) - Init Marker for use.

+//  VA_END (VA_LIST Marker) - Clear Marker

+//  VA_ARG (VA_LIST Marker, var arg type) - Use Marker to get an argument from

+//    the ... list. You must know the type and pass it in this macro.  Type

+//    must be compatible with the type of the actual next argument (as promoted

+//    according to the default argument promotions.)

+//  VA_COPY (VA_LIST Dest, VA_LIST Start) - Initialize Dest as a copy of Start.

+//

+//  Example:

+//

+//  UINTN

+//  EFIAPI

+//  ExampleVarArg (

+//    IN UINTN  NumberOfArgs,

+//    ...

+//    )

+//  {

+//    VA_LIST Marker;

+//    UINTN   Index;

+//    UINTN   Result;

+//

+//    //

+//    // Initialize the Marker

+//    //

+//    VA_START (Marker, NumberOfArgs);

+//    for (Index = 0, Result = 0; Index < NumberOfArgs; Index++) {

+//      //

+//      // The ... list is a series of UINTN values, so sum them up.

+//      //

+//      Result += VA_ARG (Marker, UINTN);

+//    }

+//

+//    VA_END (Marker);

+//    return Result;

+//  }

+//

+//  Notes:

+//  - Functions that call VA_START() / VA_END() must have a variable

+//    argument list and must be declared EFIAPI.

+//  - Functions that call VA_COPY() / VA_END() must be declared EFIAPI.

+//  - Functions that only use VA_LIST and VA_ARG() need not be EFIAPI.

+//

+

+/**

+  Return the size of argument that has been aligned to sizeof (UINTN).

+

+  @param  n    The parameter size to be aligned.

+

+  @return The aligned size.

+**/

+#define _INT_SIZE_OF(n) ((sizeof (n) + sizeof (UINTN) - 1) &~(sizeof (UINTN) - 1))

+

+#if defined(__CC_ARM)

+//

+// RVCT ARM variable argument list support.

+//

+

+///

+/// Variable used to traverse the list of arguments. This type can vary by

+/// implementation and could be an array or structure.

+///

+#ifdef __APCS_ADSABI

+  typedef int         *va_list[1];

+  #define VA_LIST     va_list

+#else

+  typedef struct __va_list { void *__ap; } va_list;

+  #define VA_LIST                          va_list

+#endif

+

+#define VA_START(Marker, Parameter)   __va_start(Marker, Parameter)

+

+#define VA_ARG(Marker, TYPE)          __va_arg(Marker, TYPE)

+

+#define VA_END(Marker)                ((void)0)

+

+// For some ARM RVCT compilers, __va_copy is not defined

+#ifndef __va_copy

+  #define __va_copy(dest, src) ((void)((dest) = (src)))

+#endif

+

+#define VA_COPY(Dest, Start)          __va_copy (Dest, Start)

+

+#elif defined(_M_ARM) || defined(_M_ARM64)

+//

+// MSFT ARM variable argument list support.

+//

+

+typedef char* VA_LIST;

+

+#define VA_START(Marker, Parameter)     __va_start (&Marker, &Parameter, _INT_SIZE_OF (Parameter), __alignof(Parameter), &Parameter)

+#define VA_ARG(Marker, TYPE)            (*(TYPE *) ((Marker += _INT_SIZE_OF (TYPE) + ((-(INTN)Marker) & (sizeof(TYPE) - 1))) - _INT_SIZE_OF (TYPE)))

+#define VA_END(Marker)                  (Marker = (VA_LIST) 0)

+#define VA_COPY(Dest, Start)            ((void)((Dest) = (Start)))

+

+#elif defined(__GNUC__) || defined(__clang__)

+

+#if defined(MDE_CPU_X64) && !defined(NO_MSABI_VA_FUNCS)

+//

+// X64 only. Use MS ABI version of GCC built-in macros for variable argument lists.

+//

+///

+/// Both GCC and LLVM 3.8 for X64 support new variable argument intrinsics for Microsoft ABI

+///

+

+///

+/// Variable used to traverse the list of arguments. This type can vary by

+/// implementation and could be an array or structure.

+///

+typedef __builtin_ms_va_list VA_LIST;

+

+#define VA_START(Marker, Parameter)  __builtin_ms_va_start (Marker, Parameter)

+

+#define VA_ARG(Marker, TYPE)         ((sizeof (TYPE) < sizeof (UINTN)) ? (TYPE)(__builtin_va_arg (Marker, UINTN)) : (TYPE)(__builtin_va_arg (Marker, TYPE)))

+

+#define VA_END(Marker)               __builtin_ms_va_end (Marker)

+

+#define VA_COPY(Dest, Start)         __builtin_ms_va_copy (Dest, Start)

+

+#else

+//

+// Use GCC built-in macros for variable argument lists.

+//

+

+///

+/// Variable used to traverse the list of arguments. This type can vary by

+/// implementation and could be an array or structure.

+///

+typedef __builtin_va_list VA_LIST;

+

+#define VA_START(Marker, Parameter)  __builtin_va_start (Marker, Parameter)

+

+#define VA_ARG(Marker, TYPE)         ((sizeof (TYPE) < sizeof (UINTN)) ? (TYPE)(__builtin_va_arg (Marker, UINTN)) : (TYPE)(__builtin_va_arg (Marker, TYPE)))

+

+#define VA_END(Marker)               __builtin_va_end (Marker)

+

+#define VA_COPY(Dest, Start)         __builtin_va_copy (Dest, Start)

+

+#endif

+

+#else

+///

+/// Variable used to traverse the list of arguments. This type can vary by

+/// implementation and could be an array or structure.

+///

+typedef CHAR8 *VA_LIST;

+

+/**

+  Retrieves a pointer to the beginning of a variable argument list, based on

+  the name of the parameter that immediately precedes the variable argument list.

+

+  This function initializes Marker to point to the beginning of the variable

+  argument list that immediately follows Parameter.  The method for computing the

+  pointer to the next argument in the argument list is CPU-specific following the

+  EFIAPI ABI.

+

+  @param   Marker       The VA_LIST used to traverse the list of arguments.

+  @param   Parameter    The name of the parameter that immediately precedes

+                        the variable argument list.

+

+  @return  A pointer to the beginning of a variable argument list.

+

+**/

+#define VA_START(Marker, Parameter) (Marker = (VA_LIST) ((UINTN) & (Parameter) + _INT_SIZE_OF (Parameter)))

+

+/**

+  Returns an argument of a specified type from a variable argument list and updates

+  the pointer to the variable argument list to point to the next argument.

+

+  This function returns an argument of the type specified by TYPE from the beginning

+  of the variable argument list specified by Marker.  Marker is then updated to point

+  to the next argument in the variable argument list.  The method for computing the

+  pointer to the next argument in the argument list is CPU-specific following the EFIAPI ABI.

+

+  @param   Marker   VA_LIST used to traverse the list of arguments.

+  @param   TYPE     The type of argument to retrieve from the beginning

+                    of the variable argument list.

+

+  @return  An argument of the type specified by TYPE.

+

+**/

+#define VA_ARG(Marker, TYPE)   (*(TYPE *) ((Marker += _INT_SIZE_OF (TYPE)) - _INT_SIZE_OF (TYPE)))

+

+/**

+  Terminates the use of a variable argument list.

+

+  This function initializes Marker so it can no longer be used with VA_ARG().

+  After this macro is used, the only way to access the variable argument list is

+  by using VA_START() again.

+

+  @param   Marker   VA_LIST used to traverse the list of arguments.

+

+**/

+#define VA_END(Marker)      (Marker = (VA_LIST) 0)

+

+/**

+  Initializes a VA_LIST as a copy of an existing VA_LIST.

+

+  This macro initializes Dest as a copy of Start, as if the VA_START macro had been applied to Dest

+  followed by the same sequence of uses of the VA_ARG macro as had previously been used to reach

+  the present state of Start.

+

+  @param   Dest   VA_LIST used to traverse the list of arguments.

+  @param   Start  VA_LIST used to traverse the list of arguments.

+

+**/

+#define VA_COPY(Dest, Start)  ((void)((Dest) = (Start)))

+

+#endif

+

+///

+/// Pointer to the start of a variable argument list stored in a memory buffer. Same as UINT8 *.

+///

+typedef UINTN  *BASE_LIST;

+

+/**

+  Returns the size of a data type in sizeof(UINTN) units rounded up to the nearest UINTN boundary.

+

+  @param  TYPE  The date type to determine the size of.

+

+  @return The size of TYPE in sizeof (UINTN) units rounded up to the nearest UINTN boundary.

+**/

+#define _BASE_INT_SIZE_OF(TYPE) ((sizeof (TYPE) + sizeof (UINTN) - 1) / sizeof (UINTN))

+

+/**

+  Returns an argument of a specified type from a variable argument list and updates

+  the pointer to the variable argument list to point to the next argument.

+

+  This function returns an argument of the type specified by TYPE from the beginning

+  of the variable argument list specified by Marker.  Marker is then updated to point

+  to the next argument in the variable argument list.  The method for computing the

+  pointer to the next argument in the argument list is CPU specific following the EFIAPI ABI.

+

+  @param   Marker   The pointer to the beginning of a variable argument list.

+  @param   TYPE     The type of argument to retrieve from the beginning

+                    of the variable argument list.

+

+  @return  An argument of the type specified by TYPE.

+

+**/

+#define BASE_ARG(Marker, TYPE)   (*(TYPE *) ((Marker += _BASE_INT_SIZE_OF (TYPE)) - _BASE_INT_SIZE_OF (TYPE)))

+

+/**

+  The macro that returns the byte offset of a field in a data structure.

+

+  This function returns the offset, in bytes, of field specified by Field from the

+  beginning of the  data structure specified by TYPE. If TYPE does not contain Field,

+  the module will not compile.

+

+  @param   TYPE     The name of the data structure that contains the field specified by Field.

+  @param   Field    The name of the field in the data structure.

+

+  @return  Offset, in bytes, of field.

+

+**/

+#if (defined(__GNUC__) && __GNUC__ >= 4) || defined(__clang__)

+#define OFFSET_OF(TYPE, Field) ((UINTN) __builtin_offsetof(TYPE, Field))

+#endif

+

+#ifndef OFFSET_OF

+#define OFFSET_OF(TYPE, Field) ((UINTN) &(((TYPE *)0)->Field))

+#endif

+

+/**

+  Portable definition for compile time assertions.

+  Equivalent to C11 static_assert macro from assert.h.

+

+  @param  Expression  Boolean expression.

+  @param  Message     Raised compiler diagnostic message when expression is false.

+

+**/

+#ifdef MDE_CPU_EBC

+  #define STATIC_ASSERT(Expression, Message)

+#elif defined(_MSC_EXTENSIONS)

+  #define STATIC_ASSERT static_assert

+#else

+  #define STATIC_ASSERT _Static_assert

+#endif

+

+//

+// Verify that ProcessorBind.h produced UEFI Data Types that are compliant with

+// Section 2.3.1 of the UEFI 2.3 Specification.

+//

+

+STATIC_ASSERT (sizeof (BOOLEAN) == 1, "sizeof (BOOLEAN) does not meet UEFI Specification Data Type requirements");

+STATIC_ASSERT (sizeof (INT8)    == 1, "sizeof (INT8) does not meet UEFI Specification Data Type requirements");

+STATIC_ASSERT (sizeof (UINT8)   == 1, "sizeof (UINT8) does not meet UEFI Specification Data Type requirements");

+STATIC_ASSERT (sizeof (INT16)   == 2, "sizeof (INT16) does not meet UEFI Specification Data Type requirements");

+STATIC_ASSERT (sizeof (UINT16)  == 2, "sizeof (UINT16) does not meet UEFI Specification Data Type requirements");

+STATIC_ASSERT (sizeof (INT32)   == 4, "sizeof (INT32) does not meet UEFI Specification Data Type requirements");

+STATIC_ASSERT (sizeof (UINT32)  == 4, "sizeof (UINT32) does not meet UEFI Specification Data Type requirements");

+STATIC_ASSERT (sizeof (INT64)   == 8, "sizeof (INT64) does not meet UEFI Specification Data Type requirements");

+STATIC_ASSERT (sizeof (UINT64)  == 8, "sizeof (UINT64) does not meet UEFI Specification Data Type requirements");

+STATIC_ASSERT (sizeof (CHAR8)   == 1, "sizeof (CHAR8) does not meet UEFI Specification Data Type requirements");

+STATIC_ASSERT (sizeof (CHAR16)  == 2, "sizeof (CHAR16) does not meet UEFI Specification Data Type requirements");

+

+//

+// The following three enum types are used to verify that the compiler

+// configuration for enum types is compliant with Section 2.3.1 of the

+// UEFI 2.3 Specification. These enum types and enum values are not

+// intended to be used. A prefix of '__' is used avoid conflicts with

+// other types.

+//

+typedef enum {

+  __VerifyUint8EnumValue = 0xff

+} __VERIFY_UINT8_ENUM_SIZE;

+

+typedef enum {

+  __VerifyUint16EnumValue = 0xffff

+} __VERIFY_UINT16_ENUM_SIZE;

+

+typedef enum {

+  __VerifyUint32EnumValue = 0xffffffff

+} __VERIFY_UINT32_ENUM_SIZE;

+

+STATIC_ASSERT (sizeof (__VERIFY_UINT8_ENUM_SIZE) == 4, "Size of enum does not meet UEFI Specification Data Type requirements");

+STATIC_ASSERT (sizeof (__VERIFY_UINT16_ENUM_SIZE) == 4, "Size of enum does not meet UEFI Specification Data Type requirements");

+STATIC_ASSERT (sizeof (__VERIFY_UINT32_ENUM_SIZE) == 4, "Size of enum does not meet UEFI Specification Data Type requirements");

+

+/**

+  Macro that returns a pointer to the data structure that contains a specified field of

+  that data structure.  This is a lightweight method to hide information by placing a

+  public data structure inside a larger private data structure and using a pointer to

+  the public data structure to retrieve a pointer to the private data structure.

+

+  This function computes the offset, in bytes, of field specified by Field from the beginning

+  of the  data structure specified by TYPE.  This offset is subtracted from Record, and is

+  used to return a pointer to a data structure of the type specified by TYPE. If the data type

+  specified by TYPE does not contain the field specified by Field, then the module will not compile.

+

+  @param   Record   Pointer to the field specified by Field within a data structure of type TYPE.

+  @param   TYPE     The name of the data structure type to return.  This data structure must

+                    contain the field specified by Field.

+  @param   Field    The name of the field in the data structure specified by TYPE to which Record points.

+

+  @return  A pointer to the structure from one of it's elements.

+

+**/

+#define BASE_CR(Record, TYPE, Field)  ((TYPE *) ((CHAR8 *) (Record) - OFFSET_OF (TYPE, Field)))

+

+/**

+  Rounds a value up to the next boundary using a specified alignment.

+

+  This function rounds Value up to the next boundary using the specified Alignment.

+  This aligned value is returned.

+

+  @param   Value      The value to round up.

+  @param   Alignment  The alignment boundary used to return the aligned value.

+

+  @return  A value up to the next boundary.

+

+**/

+#define ALIGN_VALUE(Value, Alignment) ((Value) + (((Alignment) - (Value)) & ((Alignment) - 1)))

+

+/**

+  Adjust a pointer by adding the minimum offset required for it to be aligned on

+  a specified alignment boundary.

+

+  This function rounds the pointer specified by Pointer to the next alignment boundary

+  specified by Alignment. The pointer to the aligned address is returned.

+

+  @param   Pointer    The pointer to round up.

+  @param   Alignment  The alignment boundary to use to return an aligned pointer.

+

+  @return  Pointer to the aligned address.

+

+**/

+#define ALIGN_POINTER(Pointer, Alignment) ((VOID *) (ALIGN_VALUE ((UINTN)(Pointer), (Alignment))))

+

+/**

+  Rounds a value up to the next natural boundary for the current CPU.

+  This is 4-bytes for 32-bit CPUs and 8-bytes for 64-bit CPUs.

+

+  This function rounds the value specified by Value up to the next natural boundary for the

+  current CPU. This rounded value is returned.

+

+  @param   Value      The value to round up.

+

+  @return  Rounded value specified by Value.

+

+**/

+#define ALIGN_VARIABLE(Value)  ALIGN_VALUE ((Value), sizeof (UINTN))

+

+

+/**

+  Return the maximum of two operands.

+

+  This macro returns the maximum of two operand specified by a and b.

+  Both a and b must be the same numerical types, signed or unsigned.

+

+  @param   a        The first operand with any numerical type.

+  @param   b        The second operand. Can be any numerical type as long as is

+                    the same type as a.

+

+  @return  Maximum of two operands.

+

+**/

+#define MAX(a, b)                       \

+  (((a) > (b)) ? (a) : (b))

+

+/**

+  Return the minimum of two operands.

+

+  This macro returns the minimal of two operand specified by a and b.

+  Both a and b must be the same numerical types, signed or unsigned.

+

+  @param   a        The first operand with any numerical type.

+  @param   b        The second operand. It should be the same any numerical type with a.

+

+  @return  Minimum of two operands.

+

+**/

+#define MIN(a, b)                       \

+  (((a) < (b)) ? (a) : (b))

+

+/**

+  Return the absolute value of a signed operand.

+

+  This macro returns the absolute value of the signed operand specified by a.

+

+  @param   a        The signed operand.

+

+  @return  The absolute value of the signed operand.

+

+**/

+#define ABS(a)                          \

+  (((a) < 0) ? (-(a)) : (a))

+

+//

+// Status codes common to all execution phases

+//

+typedef UINTN RETURN_STATUS;

+

+/**

+  Produces a RETURN_STATUS code with the highest bit set.

+

+  @param  StatusCode    The status code value to convert into a warning code.

+                        StatusCode must be in the range 0x00000000..0x7FFFFFFF.

+

+  @return The value specified by StatusCode with the highest bit set.

+

+**/

+#define ENCODE_ERROR(StatusCode)     ((RETURN_STATUS)(MAX_BIT | (StatusCode)))

+

+/**

+  Produces a RETURN_STATUS code with the highest bit clear.

+

+  @param  StatusCode    The status code value to convert into a warning code.

+                        StatusCode must be in the range 0x00000000..0x7FFFFFFF.

+

+  @return The value specified by StatusCode with the highest bit clear.

+

+**/

+#define ENCODE_WARNING(StatusCode)   ((RETURN_STATUS)(StatusCode))

+

+/**

+  Returns TRUE if a specified RETURN_STATUS code is an error code.

+

+  This function returns TRUE if StatusCode has the high bit set.  Otherwise, FALSE is returned.

+

+  @param  StatusCode    The status code value to evaluate.

+

+  @retval TRUE          The high bit of StatusCode is set.

+  @retval FALSE         The high bit of StatusCode is clear.

+

+**/

+#define RETURN_ERROR(StatusCode)     (((INTN)(RETURN_STATUS)(StatusCode)) < 0)

+

+///

+/// The operation completed successfully.

+///

+#define RETURN_SUCCESS               0

+

+///

+/// The image failed to load.

+///

+#define RETURN_LOAD_ERROR            ENCODE_ERROR (1)

+

+///

+/// The parameter was incorrect.

+///

+#define RETURN_INVALID_PARAMETER     ENCODE_ERROR (2)

+

+///

+/// The operation is not supported.

+///

+#define RETURN_UNSUPPORTED           ENCODE_ERROR (3)

+

+///

+/// The buffer was not the proper size for the request.

+///

+#define RETURN_BAD_BUFFER_SIZE       ENCODE_ERROR (4)

+

+///

+/// The buffer was not large enough to hold the requested data.

+/// The required buffer size is returned in the appropriate

+/// parameter when this error occurs.

+///

+#define RETURN_BUFFER_TOO_SMALL      ENCODE_ERROR (5)

+

+///

+/// There is no data pending upon return.

+///

+#define RETURN_NOT_READY             ENCODE_ERROR (6)

+

+///

+/// The physical device reported an error while attempting the

+/// operation.

+///

+#define RETURN_DEVICE_ERROR          ENCODE_ERROR (7)

+

+///

+/// The device can not be written to.

+///

+#define RETURN_WRITE_PROTECTED       ENCODE_ERROR (8)

+

+///

+/// The resource has run out.

+///

+#define RETURN_OUT_OF_RESOURCES      ENCODE_ERROR (9)

+

+///

+/// An inconsistency was detected on the file system causing the

+/// operation to fail.

+///

+#define RETURN_VOLUME_CORRUPTED      ENCODE_ERROR (10)

+

+///

+/// There is no more space on the file system.

+///

+#define RETURN_VOLUME_FULL           ENCODE_ERROR (11)

+

+///

+/// The device does not contain any medium to perform the

+/// operation.

+///

+#define RETURN_NO_MEDIA              ENCODE_ERROR (12)

+

+///

+/// The medium in the device has changed since the last

+/// access.

+///

+#define RETURN_MEDIA_CHANGED         ENCODE_ERROR (13)

+

+///

+/// The item was not found.

+///

+#define RETURN_NOT_FOUND             ENCODE_ERROR (14)

+

+///

+/// Access was denied.

+///

+#define RETURN_ACCESS_DENIED         ENCODE_ERROR (15)

+

+///

+/// The server was not found or did not respond to the request.

+///

+#define RETURN_NO_RESPONSE           ENCODE_ERROR (16)

+

+///

+/// A mapping to the device does not exist.

+///

+#define RETURN_NO_MAPPING            ENCODE_ERROR (17)

+

+///

+/// A timeout time expired.

+///

+#define RETURN_TIMEOUT               ENCODE_ERROR (18)

+

+///

+/// The protocol has not been started.

+///

+#define RETURN_NOT_STARTED           ENCODE_ERROR (19)

+

+///

+/// The protocol has already been started.

+///

+#define RETURN_ALREADY_STARTED       ENCODE_ERROR (20)

+

+///

+/// The operation was aborted.

+///

+#define RETURN_ABORTED               ENCODE_ERROR (21)

+

+///

+/// An ICMP error occurred during the network operation.

+///

+#define RETURN_ICMP_ERROR            ENCODE_ERROR (22)

+

+///

+/// A TFTP error occurred during the network operation.

+///

+#define RETURN_TFTP_ERROR            ENCODE_ERROR (23)

+

+///

+/// A protocol error occurred during the network operation.

+///

+#define RETURN_PROTOCOL_ERROR        ENCODE_ERROR (24)

+

+///

+/// A function encountered an internal version that was

+/// incompatible with a version requested by the caller.

+///

+#define RETURN_INCOMPATIBLE_VERSION  ENCODE_ERROR (25)

+

+///

+/// The function was not performed due to a security violation.

+///

+#define RETURN_SECURITY_VIOLATION    ENCODE_ERROR (26)

+

+///

+/// A CRC error was detected.

+///

+#define RETURN_CRC_ERROR             ENCODE_ERROR (27)

+

+///

+/// The beginning or end of media was reached.

+///

+#define RETURN_END_OF_MEDIA          ENCODE_ERROR (28)

+

+///

+/// The end of the file was reached.

+///

+#define RETURN_END_OF_FILE           ENCODE_ERROR (31)

+

+///

+/// The language specified was invalid.

+///

+#define RETURN_INVALID_LANGUAGE      ENCODE_ERROR (32)

+

+///

+/// The security status of the data is unknown or compromised

+/// and the data must be updated or replaced to restore a valid

+/// security status.

+///

+#define RETURN_COMPROMISED_DATA      ENCODE_ERROR (33)

+

+///

+/// A HTTP error occurred during the network operation.

+///

+#define RETURN_HTTP_ERROR            ENCODE_ERROR (35)

+

+///

+/// The string contained one or more characters that

+/// the device could not render and were skipped.

+///

+#define RETURN_WARN_UNKNOWN_GLYPH    ENCODE_WARNING (1)

+

+///

+/// The handle was closed, but the file was not deleted.

+///

+#define RETURN_WARN_DELETE_FAILURE   ENCODE_WARNING (2)

+

+///

+/// The handle was closed, but the data to the file was not

+/// flushed properly.

+///

+#define RETURN_WARN_WRITE_FAILURE    ENCODE_WARNING (3)

+

+///

+/// The resulting buffer was too small, and the data was

+/// truncated to the buffer size.

+///

+#define RETURN_WARN_BUFFER_TOO_SMALL ENCODE_WARNING (4)

+

+///

+/// The data has not been updated within the timeframe set by

+/// local policy for this type of data.

+///

+#define RETURN_WARN_STALE_DATA       ENCODE_WARNING (5)

+

+///

+/// The resulting buffer contains UEFI-compliant file system.

+///

+#define RETURN_WARN_FILE_SYSTEM      ENCODE_WARNING (6)

+

+

+/**

+  Returns a 16-bit signature built from 2 ASCII characters.

+

+  This macro returns a 16-bit value built from the two ASCII characters specified

+  by A and B.

+

+  @param  A    The first ASCII character.

+  @param  B    The second ASCII character.

+

+  @return A 16-bit value built from the two ASCII characters specified by A and B.

+

+**/

+#define SIGNATURE_16(A, B)        ((A) | (B << 8))

+

+/**

+  Returns a 32-bit signature built from 4 ASCII characters.

+

+  This macro returns a 32-bit value built from the four ASCII characters specified

+  by A, B, C, and D.

+

+  @param  A    The first ASCII character.

+  @param  B    The second ASCII character.

+  @param  C    The third ASCII character.

+  @param  D    The fourth ASCII character.

+

+  @return A 32-bit value built from the two ASCII characters specified by A, B,

+          C and D.

+

+**/

+#define SIGNATURE_32(A, B, C, D)  (SIGNATURE_16 (A, B) | (SIGNATURE_16 (C, D) << 16))

+

+/**

+  Returns a 64-bit signature built from 8 ASCII characters.

+

+  This macro returns a 64-bit value built from the eight ASCII characters specified

+  by A, B, C, D, E, F, G,and H.

+

+  @param  A    The first ASCII character.

+  @param  B    The second ASCII character.

+  @param  C    The third ASCII character.

+  @param  D    The fourth ASCII character.

+  @param  E    The fifth ASCII character.

+  @param  F    The sixth ASCII character.

+  @param  G    The seventh ASCII character.

+  @param  H    The eighth ASCII character.

+

+  @return A 64-bit value built from the two ASCII characters specified by A, B,

+          C, D, E, F, G and H.

+

+**/

+#define SIGNATURE_64(A, B, C, D, E, F, G, H) \

+    (SIGNATURE_32 (A, B, C, D) | ((UINT64) (SIGNATURE_32 (E, F, G, H)) << 32))

+

+#if defined(_MSC_EXTENSIONS) && !defined (__INTEL_COMPILER) && !defined (MDE_CPU_EBC)

+  void * _ReturnAddress(void);

+  #pragma intrinsic(_ReturnAddress)

+  /**

+    Get the return address of the calling function.

+

+    Based on intrinsic function _ReturnAddress that provides the address of

+    the instruction in the calling function that will be executed after

+    control returns to the caller.

+

+    @param L    Return Level.

+

+    @return The return address of the calling function or 0 if L != 0.

+

+  **/

+  #define RETURN_ADDRESS(L)     ((L == 0) ? _ReturnAddress() : (VOID *) 0)

+#elif defined (__GNUC__) || defined (__clang__)

+  void * __builtin_return_address (unsigned int level);

+  /**

+    Get the return address of the calling function.

+

+    Based on built-in Function __builtin_return_address that returns

+    the return address of the current function, or of one of its callers.

+

+    @param L    Return Level.

+

+    @return The return address of the calling function.

+

+  **/

+  #define RETURN_ADDRESS(L)     __builtin_return_address (L)

+#else

+  /**

+    Get the return address of the calling function.

+

+    @param L    Return Level.

+

+    @return 0 as compilers don't support this feature.

+

+  **/

+  #define RETURN_ADDRESS(L)     ((VOID *) 0)

+#endif

+

+/**

+  Return the number of elements in an array.

+

+  @param  Array  An object of array type. Array is only used as an argument to

+                 the sizeof operator, therefore Array is never evaluated. The

+                 caller is responsible for ensuring that Array's type is not

+                 incomplete; that is, Array must have known constant size.

+

+  @return The number of elements in Array. The result has type UINTN.

+

+**/

+#define ARRAY_SIZE(Array) (sizeof (Array) / sizeof ((Array)[0]))

+

+#endif

+

diff --git a/debugging_demo/memtest86+/efi/Include/Efi_Defs.c b/debugging_demo/memtest86+/efi/Include/Efi_Defs.c
new file mode 100644
index 0000000..6b3bda2
--- /dev/null
+++ b/debugging_demo/memtest86+/efi/Include/Efi_Defs.c
@@ -0,0 +1,176 @@
+#include "Efi_Defs.h"
+#include "Efi_Defs_GUID.h"
+#include "Uefi.h"
+#include "Library/BaseLib.h"
+#include "Library/DebugLib.h"
+#include "Library/UefiBootServicesTableLib.h"
+#include "Library/UefiApplicationEntryPoint.h"
+
+EFI_GUID gEfiCallerIdGuid = EFI_CALLER_ID_GUID;
+
+CHAR8 *gEfiCallerBaseName = "MemtestEfi";
+
+// Guids
+EFI_GUID gEfiAcpiTableGuid = EFI_ACPI_TABLE_GUID;
+EFI_GUID gEfiAcpi20TableGuid = EFI_ACPI_20_TABLE_GUID;
+EFI_GUID gEfiAcpi10TableGuid = EFI_ACPI_10_TABLE_GUID;
+EFI_GUID gEfiEventReadyToBootGuid = EFI_EVENT_GROUP_READY_TO_BOOT;
+EFI_GUID gEfiEventLegacyBootGuid = EFI_EVENT_LEGACY_BOOT_GUID;
+EFI_GUID gEfiGlobalVariableGuid = EFI_GLOBAL_VARIABLE;
+EFI_GUID gEfiPcAnsiGuid = EFI_PC_ANSI_GUID;
+EFI_GUID gEfiVT100Guid = EFI_VT_100_GUID;
+EFI_GUID gEfiVT100PlusGuid = EFI_VT_100_PLUS_GUID;
+EFI_GUID gEfiVTUTF8Guid = EFI_VT_UTF8_GUID;
+EFI_GUID gEfiUartDevicePathGuid = DEVICE_PATH_MESSAGING_UART_FLOW_CONTROL;
+EFI_GUID gEfiSasDevicePathGuid = EFI_SAS_DEVICE_PATH_GUID;
+EFI_GUID gEfiSmbiosGuid = SMBIOS_TABLE_GUID;
+EFI_GUID gEfiSmbios3Guid = SMBIOS3_TABLE_GUID;
+
+// Protocols
+EFI_GUID gEfiSimpleFileSystemProtocolGuid = EFI_SIMPLE_FILE_SYSTEM_PROTOCOL_GUID;
+EFI_GUID gEfiFileSystemInfoGuid = EFI_FILE_SYSTEM_INFO_ID;
+EFI_GUID gEfiLoadedImageProtocolGuid = EFI_LOADED_IMAGE_PROTOCOL_GUID;
+
+// Guids
+//GLOBAL_REMOVE_IF_UNREFERENCED EFI_GUID gEfiMdePkgTokenSpaceGuid = { 0x914AEBE7, 0x4635, 0x459b, { 0xAA, 0x1C, 0x11, 0xE2, 0x19, 0xB0, 0x3A, 0x10 }};
+//GLOBAL_REMOVE_IF_UNREFERENCED EFI_GUID gEfiVirtualDiskGuid = { 0x77AB535A, 0x45FC, 0x624B, {0x55, 0x60, 0xF7, 0xB2, 0x81, 0xD1, 0xF9, 0x6E }};
+//GLOBAL_REMOVE_IF_UNREFERENCED EFI_GUID gEfiVirtualCdGuid = { 0x3D5ABD30, 0x4175, 0x87CE, {0x6D, 0x64, 0xD2, 0xAD, 0xE5, 0x23, 0xC4, 0xBB }};
+//GLOBAL_REMOVE_IF_UNREFERENCED EFI_GUID gEfiPersistentVirtualDiskGuid = { 0x5CEA02C9, 0x4D07, 0x69D3, {0x26, 0x9F ,0x44, 0x96, 0xFB, 0xE0, 0x96, 0xF9 }};
+//GLOBAL_REMOVE_IF_UNREFERENCED EFI_GUID gEfiPersistentVirtualCdGuid = { 0x08018188, 0x42CD, 0xBB48, {0x10, 0x0F, 0x53, 0x87, 0xD5, 0x3D, 0xED, 0x3D }};
+
+// Protocols
+//GLOBAL_REMOVE_IF_UNREFERENCED EFI_GUID gEfiDevicePathProtocolGuid = { 0x09576E91, 0x6D3F, 0x11D2, { 0x8E, 0x39, 0x00, 0xA0, 0xC9, 0x69, 0x72, 0x3B }};
+//GLOBAL_REMOVE_IF_UNREFERENCED EFI_GUID gEfiDebugPortProtocolGuid = { 0xEBA4E8D2, 0x3858, 0x41EC, { 0xA2, 0x81, 0x26, 0x47, 0xBA, 0x96, 0x60, 0xD0 }};
+//GLOBAL_REMOVE_IF_UNREFERENCED EFI_GUID gEfiDriverBindingProtocolGuid = { 0x18A031AB, 0xB443, 0x4D1A, { 0xA5, 0xC0, 0x0C, 0x09, 0x26, 0x1E, 0x9F, 0x71 }};
+//GLOBAL_REMOVE_IF_UNREFERENCED EFI_GUID gEfiSimpleTextOutProtocolGuid = { 0x387477C2, 0x69C7, 0x11D2, { 0x8E, 0x39, 0x00, 0xA0, 0xC9, 0x69, 0x72, 0x3B }};
+//GLOBAL_REMOVE_IF_UNREFERENCED EFI_GUID gEfiGraphicsOutputProtocolGuid = { 0x9042A9DE, 0x23DC, 0x4A38, { 0x96, 0xFB, 0x7A, 0xDE, 0xD0, 0x80, 0x51, 0x6A }};
+//GLOBAL_REMOVE_IF_UNREFERENCED EFI_GUID gEfiHiiFontProtocolGuid = {0xe9ca4775, 0x8657, 0x47fc, {0x97, 0xe7, 0x7e, 0xd6, 0x5a, 0x08, 0x43, 0x24}};
+//GLOBAL_REMOVE_IF_UNREFERENCED EFI_GUID gEfiUgaDrawProtocolGuid = { 0x982C298B, 0xF4FA, 0x41CB, { 0xB8, 0x38, 0x77, 0xAA, 0x68, 0x8F, 0xB8, 0x39 }};
+//GLOBAL_REMOVE_IF_UNREFERENCED EFI_GUID gEfiComponentNameProtocolGuid = { 0x107A772C, 0xD5E1, 0x11D4, { 0x9A, 0x46, 0x00, 0x90, 0x27, 0x3F, 0xC1, 0x4D }};
+//GLOBAL_REMOVE_IF_UNREFERENCED EFI_GUID gEfiComponentName2ProtocolGuid = { 0x6A7A5CFF, 0xE8D9, 0x4F70, { 0xBA, 0xDA, 0x75, 0xAB, 0x30, 0x25, 0xCE, 0x14 }};
+//GLOBAL_REMOVE_IF_UNREFERENCED EFI_GUID gEfiDriverConfigurationProtocolGuid = { 0x107A772B, 0xD5E1, 0x11D4, { 0x9A, 0x46, 0x00, 0x90, 0x27, 0x3F, 0xC1, 0x4D }};
+//GLOBAL_REMOVE_IF_UNREFERENCED EFI_GUID gEfiDriverConfiguration2ProtocolGuid = { 0xBFD7DC1D, 0x24F1, 0x40D9, { 0x82, 0xE7, 0x2E, 0x09, 0xBB, 0x6B, 0x4E, 0xBE }};
+//GLOBAL_REMOVE_IF_UNREFERENCED EFI_GUID gEfiDriverDiagnosticsProtocolGuid = { 0x0784924F, 0xE296, 0x11D4, { 0x9A, 0x49, 0x00, 0x90, 0x27, 0x3F, 0xC1, 0x4D }};
+//GLOBAL_REMOVE_IF_UNREFERENCED EFI_GUID gEfiDriverDiagnostics2ProtocolGuid = { 0x4D330321, 0x025F, 0x4AAC, { 0x90, 0xD8, 0x5E, 0xD9, 0x00, 0x17, 0x3B, 0x63 }};
+
+// Definition of SkuId Array
+//GLOBAL_REMOVE_IF_UNREFERENCED UINT64 _gPcd_SkuId_Array[] = {0x0};
+
+extern EFI_STATUS
+EFIAPI
+UefiMain (
+  IN EFI_HANDLE        ImageHandle,
+  IN EFI_SYSTEM_TABLE  *SystemTable
+  );
+
+EFI_STATUS
+EFIAPI
+DxeDebugLibConstructor (
+  IN EFI_HANDLE        ImageHandle,
+  IN EFI_SYSTEM_TABLE  *SystemTable
+  );
+
+EFI_STATUS
+EFIAPI
+UefiBootServicesTableLibConstructor (
+  IN EFI_HANDLE        ImageHandle,
+  IN EFI_SYSTEM_TABLE  *SystemTable
+  );
+
+EFI_STATUS
+EFIAPI
+UefiRuntimeServicesTableLibConstructor (
+  IN EFI_HANDLE        ImageHandle,
+  IN EFI_SYSTEM_TABLE  *SystemTable
+  );
+
+EFI_STATUS
+EFIAPI
+UefiLibConstructor (
+  IN EFI_HANDLE        ImageHandle,
+  IN EFI_SYSTEM_TABLE  *SystemTable
+  );
+
+
+VOID
+EFIAPI
+ProcessLibraryConstructorList (
+  IN EFI_HANDLE        ImageHandle,
+  IN EFI_SYSTEM_TABLE  *SystemTable
+  )
+{
+  EFI_STATUS  Status;
+
+  Status = DxeDebugLibConstructor (ImageHandle, SystemTable);
+  ASSERT_EFI_ERROR (Status);
+
+  Status = UefiBootServicesTableLibConstructor (ImageHandle, SystemTable);
+  ASSERT_EFI_ERROR (Status);
+
+  Status = UefiRuntimeServicesTableLibConstructor (ImageHandle, SystemTable);
+  ASSERT_EFI_ERROR (Status);
+
+  Status = UefiLibConstructor (ImageHandle, SystemTable);
+  ASSERT_EFI_ERROR (Status);
+
+}
+
+
+EFI_STATUS
+EFIAPI
+DxeDebugLibDestructor (
+  IN EFI_HANDLE        ImageHandle,
+  IN EFI_SYSTEM_TABLE  *SystemTable
+  );
+
+
+VOID
+EFIAPI
+ProcessLibraryDestructorList (
+  IN EFI_HANDLE        ImageHandle,
+  IN EFI_SYSTEM_TABLE  *SystemTable
+  )
+{
+  EFI_STATUS  Status;
+
+  Status = DxeDebugLibDestructor (ImageHandle, SystemTable);
+  ASSERT_EFI_ERROR (Status);
+
+}
+
+const UINT32 _gUefiDriverRevision = 0x00000000U;
+
+
+EFI_STATUS
+EFIAPI
+ProcessModuleEntryPointList (
+  IN EFI_HANDLE        ImageHandle,
+  IN EFI_SYSTEM_TABLE  *SystemTable
+  )
+
+{
+  return UefiMain (ImageHandle, SystemTable);
+}
+
+VOID
+EFIAPI
+ExitDriver (
+  IN EFI_STATUS  Status
+  )
+{
+  if (EFI_ERROR (Status)) {
+    ProcessLibraryDestructorList (gImageHandle, gST);
+  }
+  gBS->Exit (gImageHandle, Status, 0, NULL);
+}
+
+GLOBAL_REMOVE_IF_UNREFERENCED const UINT8 _gDriverUnloadImageCount = 0U;
+
+EFI_STATUS
+EFIAPI
+ProcessModuleUnloadList (
+  IN EFI_HANDLE        ImageHandle
+  )
+{
+  return EFI_SUCCESS;
+}
diff --git a/debugging_demo/memtest86+/efi/Include/Efi_Defs.h b/debugging_demo/memtest86+/efi/Include/Efi_Defs.h
new file mode 100644
index 0000000..a99287d
--- /dev/null
+++ b/debugging_demo/memtest86+/efi/Include/Efi_Defs.h
@@ -0,0 +1,28 @@
+#ifdef __cplusplus
+extern "C" {
+#endif
+
+#include "Uefi.h"
+
+extern GUID  gEfiCallerIdGuid;
+extern CHAR8 *gEfiCallerBaseName;
+
+
+
+// Definition of SkuId Array
+/*extern UINT64 _gPcd_SkuId_Array[];
+*/
+
+EFI_STATUS
+EFIAPI
+UefiMain (
+  IN EFI_HANDLE        ImageHandle,
+  IN EFI_SYSTEM_TABLE  *SystemTable
+  );
+
+
+
+#ifdef __cplusplus
+}
+
+#endif
diff --git a/debugging_demo/memtest86+/efi/Include/Efi_Defs_GUID.h b/debugging_demo/memtest86+/efi/Include/Efi_Defs_GUID.h
new file mode 100644
index 0000000..f468b54
--- /dev/null
+++ b/debugging_demo/memtest86+/efi/Include/Efi_Defs_GUID.h
@@ -0,0 +1,124 @@
+#ifndef __EFI_DEFS_GUID_H__
+#define __EFI_DEFS_GUID_H__
+
+/*
+ * Guids
+ */
+#define ACPI_TABLE_GUID {0xEB9D2D30, 0x2D88, 0x11D3, { 0x9A, 0x16, 0x00, 0x90, 0x27, 0x3F, 0xC1, 0x4D}}
+extern EFI_GUID gEfiAcpiTableGuid;
+
+#define EFI_ACPI_TABLE_GUID {0x8868E871, 0xE4F1, 0x11D3, { 0xBC, 0x22, 0x00, 0x80, 0xC7, 0x3C, 0x88, 0x81}}
+
+#define EFI_ACPI_10_TABLE_GUID     ACPI_TABLE_GUID
+extern EFI_GUID gEfiAcpi10TableGuid;
+
+// ACPI 2.0 or newer tables should use EFI_ACPI_TABLE_GUID.
+#define EFI_ACPI_20_TABLE_GUID EFI_ACPI_TABLE_GUID
+extern EFI_GUID gEfiAcpi20TableGuid;
+
+#define EFI_CALLER_ID_GUID {0x51d8cae0, 0x272a, 0x661f, {0xa8, 0xd9, 0x84, 0x51, 0xdf, 0xf0, 0xeb, 0xd0}}
+extern EFI_GUID gEfiCallerIdGUID;
+
+#define EFI_EVENT_GROUP_READY_TO_BOOT { 0x7ce88fb3, 0x4bd7, 0x4679, { 0x87, 0xa8, 0xa8, 0xd8, 0xde, 0xe5, 0x0d, 0x2b }}
+extern EFI_GUID gEfiEventReadyToBootGuid;
+
+#define EFI_EVENT_LEGACY_BOOT_GUID { 0x2a571201, 0x4966, 0x47f6, {0x8b, 0x86, 0xf3, 0x1e, 0x41, 0xf3, 0x2f, 0x10 }}
+extern EFI_GUID gEfiEventLegacyBootGuid;
+
+#define EFI_GLOBAL_VARIABLE { 0x8BE4DF61, 0x93CA, 0x11d2, {0xAA, 0x0D, 0x00, 0xE0, 0x98, 0x03, 0x2B, 0x8C }}
+extern EFI_GUID gEfiGlobalVariableGuid;
+
+#define EFI_PC_ANSI_GUID { 0xe0c14753, 0xf9be, 0x11d2, {0x9a, 0x0c, 0x00, 0x90, 0x27, 0x3f, 0xc1, 0x4d }}
+extern EFI_GUID gEfiPcAnsiGuid;
+
+#define EFI_VT_100_GUID { 0xdfa66065, 0xb419, 0x11d3, {0x9a, 0x2d, 0x00, 0x90, 0x27, 0x3f, 0xc1, 0x4d }}
+extern EFI_GUID gEfiVT100Guid;
+
+#define EFI_VT_100_PLUS_GUID { 0x7baec70b, 0x57e0, 0x4c76, {0x8e, 0x87, 0x2f, 0x9e, 0x28, 0x08, 0x83, 0x43 }} 
+extern EFI_GUID gEfiVT100PlusGuid;
+
+#define EFI_VT_UTF8_GUID { 0xad15a0d6, 0x8bec, 0x4acf, {0xa0, 0x73, 0xd0, 0x1d, 0xe7, 0x7e, 0x2d, 0x88 }}
+extern EFI_GUID gEfiVTUTF8Guid;
+
+#define DEVICE_PATH_MESSAGING_UART_FLOW_CONTROL { 0x37499a9d, 0x542f, 0x4c89, {0xa0, 0x26, 0x35, 0xda, 0x14, 0x20, 0x94, 0xe4 }}
+extern EFI_GUID gEfiUartDevicePathGuid;
+
+#define EFI_SAS_DEVICE_PATH_GUID { 0xd487ddb4, 0x008b, 0x11d9, {0xaf, 0xdc, 0x00, 0x10, 0x83, 0xff, 0xca, 0x4d }}
+extern EFI_GUID gEfiSasDevicePathGuid;
+
+#define SMBIOS_TABLE_GUID {0xeb9d2d31,0x2d88,0x11d3, {0x9a,0x16,0x0,0x90,0x27,0x3f,0xc1,0x4d}};
+extern EFI_GUID gEfiSmbiosGuid;
+
+#define SMBIOS3_TABLE_GUID {0xf2fd1544, 0x9794, 0x4a2c, {0x99,0x2e,0xe5,0xbb,0xcf,0x20,0xe3,0x94}}
+extern EFI_GUID gEfiSmbios3Guid;
+
+/*
+ * Protocols
+ */
+#define EFI_SIMPLE_FILE_SYSTEM_PROTOCOL_GUID  { 0x964E5B22, 0x6459, 0x11D2, { 0x8E, 0x39, 0x00, 0xA0, 0xC9, 0x69, 0x72, 0x3B }}
+extern EFI_GUID gEfiSimpleFileSystemProtocolGuid;
+
+#define EFI_FILE_SYSTEM_INFO_ID { 0x9576e93, 0x6d3f, 0x11d2, {0x8e, 0x39, 0x0, 0xa0, 0xc9, 0x69, 0x72, 0x3b }}
+extern EFI_GUID gEfiFileSystemInfoGuid;
+
+#define EFI_LOADED_IMAGE_PROTOCOL_GUID {0x5B1B31A1,0x9562,0x11d2,{0x8E,0x3F,0x00,0xA0,0xC9,0x69,0x72,0x3B}}
+extern EFI_GUID gEfiLoadedImageProtocolGuid;
+
+
+#endif
+
+// Guids
+/*extern EFI_GUID gEfiMdePkgTokenSpaceGuid;
+extern EFI_GUID gEfiVirtualDiskGuid;
+extern EFI_GUID gEfiVirtualCdGuid;
+extern EFI_GUID gEfiPersistentVirtualDiskGuid;
+extern EFI_GUID gEfiPersistentVirtualCdGuid;
+extern EFI_GUID gEfiEventReadyToBootGuid;
+extern EFI_GUID gEfiEventLegacyBootGuid;
+*/
+
+
+
+// Protocols
+/*extern EFI_GUID gEfiDevicePathProtocolGuid;
+extern EFI_GUID gEfiDebugPortProtocolGuid;
+extern EFI_GUID gEfiDriverBindingProtocolGuid;
+extern EFI_GUID gEfiSimpleTextOutProtocolGuid;
+extern EFI_GUID gEfiGraphicsOutputProtocolGuid;
+extern EFI_GUID gEfiHiiFontProtocolGuid; */
+/*
+extern EFI_GUID gEfiUgaDrawProtocolGuid;
+extern EFI_GUID gEfiComponentNameProtocolGuid;
+extern EFI_GUID gEfiComponentName2ProtocolGuid;
+extern EFI_GUID gEfiDriverConfigurationProtocolGuid;
+extern EFI_GUID gEfiDriverConfiguration2ProtocolGuid;
+extern EFI_GUID gEfiDriverDiagnosticsProtocolGuid;
+extern EFI_GUID gEfiDriverDiagnostics2ProtocolGuid;*/
+
+
+/*#ifndef __EVENT_GROUP_GUID__
+#define __EVENT_GROUP_GUID__
+#define EFI_EVENT_GROUP_EXIT_BOOT_SERVICES \
+  { 0x27abf055, 0xb1b8, 0x4c26, { 0x80, 0x48, 0x74, 0x8f, 0x37, 0xba, 0xa2, 0xdf } }
+extern EFI_GUID gEfiEventExitBootServicesGuid;
+#define EFI_EVENT_GROUP_VIRTUAL_ADDRESS_CHANGE \
+  { 0x13fa7698, 0xc831, 0x49c7, { 0x87, 0xea, 0x8f, 0x43, 0xfc, 0xc2, 0x51, 0x96 } }
+extern EFI_GUID gEfiEventVirtualAddressChangeGuid;
+#define EFI_EVENT_GROUP_MEMORY_MAP_CHANGE \
+  { 0x78bee926, 0x692f, 0x48fd, { 0x9e, 0xdb, 0x1, 0x42, 0x2e, 0xf0, 0xd7, 0xab } }
+extern EFI_GUID gEfiEventMemoryMapChangeGuid;
+#define EFI_EVENT_GROUP_DXE_DISPATCH_GUID \
+  { 0x7081e22f, 0xcac6, 0x4053, { 0x94, 0x68, 0x67, 0x57, 0x82, 0xcf, 0x88, 0xe5 }}
+extern EFI_GUID gEfiEventDxeDispatchGuid;
+#define EFI_END_OF_DXE_EVENT_GROUP_GUID \
+  { 0x2ce967a, 0xdd7e, 0x4ffc, { 0x9e, 0xe7, 0x81, 0xc, 0xf0, 0x47, 0x8, 0x80 } }
+extern EFI_GUID gEfiEndOfDxeEventGroupGuid;
+#endif*/
+
+/*#ifndef __EFI_HII_FORMMAP_GUID_H__
+#define __EFI_HII_FORMMAP_GUID_H__
+#define EFI_HII_STANDARD_FORM_GUID \
+  { 0x3bd2f4ec, 0xe524, 0x46e4, { 0xa9, 0xd8, 0x51, 0x1, 0x17, 0x42, 0x55, 0x62 } }
+extern EFI_GUID gEfiHiiStandardFormGuid;
+#endif*/
+
diff --git a/debugging_demo/memtest86+/efi/Include/Efi_Defs_Pcd.h b/debugging_demo/memtest86+/efi/Include/Efi_Defs_Pcd.h
new file mode 100644
index 0000000..7f756d1
--- /dev/null
+++ b/debugging_demo/memtest86+/efi/Include/Efi_Defs_Pcd.h
@@ -0,0 +1,13 @@
+#define _PCD_GET_MODE_32_PcdMaximumAsciiStringLength  1000000U
+#define _PCD_GET_MODE_32_PcdMaximumUnicodeStringLength  1000000U 
+#define _PCD_GET_MODE_32_PcdDebugPrintErrorLevel  0x80000000U 
+#define _PCD_GET_MODE_8_PcdDebugClearMemoryValue  0xAFU
+#define _PCD_GET_MODE_8_PcdDebugPropertyMask  0U
+#define _PCD_GET_MODE_32_PcdFixedDebugPrintErrorLevel  0xFFFFFFFFU
+#define _PCD_GET_MODE_32_PcdMaximumDevicePathNodeCount  0U
+#define _PCD_GET_MODE_BOOL_PcdDriverDiagnosticsDisable  ((BOOLEAN)0U)
+#define _PCD_GET_MODE_BOOL_PcdComponentNameDisable  ((BOOLEAN)0U)
+#define _PCD_GET_MODE_BOOL_PcdDriverDiagnostics2Disable  ((BOOLEAN)0U)
+#define _PCD_GET_MODE_BOOL_PcdComponentName2Disable  ((BOOLEAN)0U)
+#define _PCD_GET_MODE_BOOL_PcdUgaConsumeSupport  ((BOOLEAN)1U)
+#define _PCD_GET_MODE_32_PcdUefiLibMaxPrintBufferSize  320U
\ No newline at end of file
diff --git a/debugging_demo/memtest86+/efi/Include/GccBase.lds b/debugging_demo/memtest86+/efi/Include/GccBase.lds
new file mode 100644
index 0000000..86d4eed
--- /dev/null
+++ b/debugging_demo/memtest86+/efi/Include/GccBase.lds
@@ -0,0 +1,79 @@
+/** @file

+

+  Unified linker script for GCC based builds

+

+  Copyright (c) 2010 - 2015, Intel Corporation. All rights reserved.<BR>

+  Copyright (c) 2015, Linaro Ltd. All rights reserved.<BR>

+  (C) Copyright 2016 Hewlett Packard Enterprise Development LP<BR>

+

+  SPDX-License-Identifier: BSD-2-Clause-Patent

+

+**/

+

+SECTIONS {

+

+  /*

+   * The PE/COFF binary consists of DOS and PE/COFF headers, and a sequence of

+   * section headers adding up to PECOFF_HEADER_SIZE bytes (which differs

+   * between 32-bit and 64-bit builds). The actual start of the .text section

+   * will be rounded up based on its actual alignment.

+   */

+  . = PECOFF_HEADER_SIZE;

+

+  .text : ALIGN(CONSTANT(COMMONPAGESIZE)) {

+    *(.text .text.* .stub .gnu.linkonce.t.*)

+    *(.rodata .rodata.* .gnu.linkonce.r.*)

+    *(.got .got.*)

+

+    /*

+     * The contents of Efi_Defs.c files are mostly constant from the POV of the

+     * program, but most of it ends up in .data or .bss by default since few of

+     * the variable definitions that get emitted are declared as CONST.

+     * Unfortunately, we cannot pull it into the .text section entirely, since

+     * patchable PCDs are also emitted here, but we can at least move all of the

+     * emitted GUIDs here.

+     */

+    *:Efi_Defs.obj(.data.g*Guid)

+  }

+

+  /*

+   * The alignment of the .data section should be less than or equal to the

+   * alignment of the .text section. This ensures that the relative offset

+   * between these sections is the same in the ELF and the PE/COFF versions of

+   * this binary.

+   */

+  .data ALIGN(ALIGNOF(.text)) : ALIGN(CONSTANT(COMMONPAGESIZE)) {

+    *(.data .data.* .gnu.linkonce.d.*)

+    *(.bss .bss.*)

+  }

+

+  .eh_frame ALIGN(CONSTANT(COMMONPAGESIZE)) : {

+    KEEP (*(.eh_frame))

+  }

+

+  .rela (INFO) : {

+    *(.rela .rela.*)

+  }

+

+  .hii : ALIGN(CONSTANT(COMMONPAGESIZE)) {

+    KEEP (*(.hii))

+  }

+

+  /*

+   * Retain the GNU build id but in a non-allocatable section so GenFw

+   * does not copy it into the PE/COFF image.

+   */

+  .build-id (INFO) : { *(.note.gnu.build-id) }

+

+  /DISCARD/ : {

+    *(.note.GNU-stack)

+    *(.gnu_debuglink)

+    *(.interp)

+    *(.dynsym)

+    *(.dynstr)

+    *(.dynamic)

+    *(.hash .gnu.hash)

+    *(.comment)

+    *(COMMON)

+  }

+}

diff --git a/debugging_demo/memtest86+/efi/Include/GenFw b/debugging_demo/memtest86+/efi/Include/GenFw
new file mode 100755
index 0000000..5aaa4c4
--- /dev/null
+++ b/debugging_demo/memtest86+/efi/Include/GenFw
diff --git a/debugging_demo/memtest86+/efi/Include/Guid/FileSystemInfo.h b/debugging_demo/memtest86+/efi/Include/Guid/FileSystemInfo.h
new file mode 100644
index 0000000..ad14ec4
--- /dev/null
+++ b/debugging_demo/memtest86+/efi/Include/Guid/FileSystemInfo.h
@@ -0,0 +1,52 @@
+/** @file

+  Provides a GUID and a data structure that can be used with EFI_FILE_PROTOCOL.GetInfo()

+  or EFI_FILE_PROTOCOL.SetInfo() to get or set information about the system's volume.

+  This GUID is defined in UEFI specification.

+

+Copyright (c) 2006 - 2018, Intel Corporation. All rights reserved.<BR>

+SPDX-License-Identifier: BSD-2-Clause-Patent

+

+**/

+

+#include "Efi_Defs_GUID.h"

+

+#ifndef __FILE_SYSTEM_INFO_H__

+#define __FILE_SYSTEM_INFO_H__

+

+typedef struct {

+  ///

+  /// The size of the EFI_FILE_SYSTEM_INFO structure, including the Null-terminated VolumeLabel string.

+  ///

+  UINT64  Size;

+  ///

+  /// TRUE if the volume only supports read access.

+  ///

+  BOOLEAN ReadOnly;

+  ///

+  /// The number of bytes managed by the file system.

+  ///

+  UINT64  VolumeSize;

+  ///

+  /// The number of available bytes for use by the file system.

+  ///

+  UINT64  FreeSpace;

+  ///

+  /// The nominal block size by which files are typically grown.

+  ///

+  UINT32  BlockSize;

+  ///

+  /// The Null-terminated string that is the volume's label.

+  ///

+  CHAR16  VolumeLabel[1];

+} EFI_FILE_SYSTEM_INFO;

+

+///

+/// The VolumeLabel field of the EFI_FILE_SYSTEM_INFO data structure is variable length.

+/// Whenever code needs to know the size of the EFI_FILE_SYSTEM_INFO data structure, it needs

+/// to be the size of the data structure without the VolumeLable field.  The following macro

+/// computes this size correctly no matter how big the VolumeLable array is declared.

+/// This is required to make the EFI_FILE_SYSTEM_INFO data structure ANSI compilant.

+///

+#define SIZE_OF_EFI_FILE_SYSTEM_INFO  OFFSET_OF (EFI_FILE_SYSTEM_INFO, VolumeLabel)

+

+#endif

diff --git a/debugging_demo/memtest86+/efi/Include/Guid/GlobalVariable.h b/debugging_demo/memtest86+/efi/Include/Guid/GlobalVariable.h
new file mode 100644
index 0000000..3a1b1ef
--- /dev/null
+++ b/debugging_demo/memtest86+/efi/Include/Guid/GlobalVariable.h
@@ -0,0 +1,181 @@
+/** @file

+  GUID for EFI (NVRAM) Variables.

+

+  Copyright (c) 2006 - 2018, Intel Corporation. All rights reserved.<BR>

+  SPDX-License-Identifier: BSD-2-Clause-Patent

+

+  @par Revision Reference:

+  GUID defined in UEFI 2.1

+**/

+

+#ifndef __GLOBAL_VARIABLE_GUID_H__

+#define __GLOBAL_VARIABLE_GUID_H__

+

+#include "Efi_Defs_GUID.h"

+

+//

+// Follow UEFI 2.4 spec:

+// To prevent name collisions with possible future globally defined variables,

+// other internal firmware data variables that are not defined here must be

+// saved with a unique VendorGuid other than EFI_GLOBAL_VARIABLE or

+// any other GUID defined by the UEFI Specification. Implementations must

+// only permit the creation of variables with a UEFI Specification-defined

+// VendorGuid when these variables are documented in the UEFI Specification.

+//

+// Note: except the globally defined variables defined below, the spec also defines

+// L"Boot####"      - A boot load option.

+// L"Driver####"    - A driver load option.

+// L"SysPrep####"   - A System Prep application load option.

+// L"Key####"       - Describes hot key relationship with a Boot#### load option.

+// The attribute for them is NV+BS+RT, #### is a printed hex value, and no 0x or h

+// is included in the hex value. They can not be expressed as a #define like other globally

+// defined variables, it is because we can not list the Boot0000, Boot0001, etc one by one.

+//

+

+///

+/// The language codes that the firmware supports. This value is deprecated.

+/// Its attribute is BS+RT.

+///

+#define EFI_LANG_CODES_VARIABLE_NAME                L"LangCodes"

+///

+/// The language code that the system is configured for. This value is deprecated.

+/// Its attribute is NV+BS+RT.

+///

+#define EFI_LANG_VARIABLE_NAME                      L"Lang"

+///

+/// The firmware's boot managers timeout, in seconds, before initiating the default boot selection.

+/// Its attribute is NV+BS+RT.

+///

+#define EFI_TIME_OUT_VARIABLE_NAME                  L"Timeout"

+///

+/// The language codes that the firmware supports.

+/// Its attribute is BS+RT.

+///

+#define EFI_PLATFORM_LANG_CODES_VARIABLE_NAME       L"PlatformLangCodes"

+///

+/// The language code that the system is configured for.

+/// Its attribute is NV+BS+RT.

+///

+#define EFI_PLATFORM_LANG_VARIABLE_NAME             L"PlatformLang"

+///

+/// The device path of the default input/output/error output console.

+/// Its attribute is NV+BS+RT.

+///

+#define EFI_CON_IN_VARIABLE_NAME                    L"ConIn"

+#define EFI_CON_OUT_VARIABLE_NAME                   L"ConOut"

+#define EFI_ERR_OUT_VARIABLE_NAME                   L"ErrOut"

+///

+/// The device path of all possible input/output/error output devices.

+/// Its attribute is BS+RT.

+///

+#define EFI_CON_IN_DEV_VARIABLE_NAME                L"ConInDev"

+#define EFI_CON_OUT_DEV_VARIABLE_NAME               L"ConOutDev"

+#define EFI_ERR_OUT_DEV_VARIABLE_NAME               L"ErrOutDev"

+///

+/// The ordered boot option load list.

+/// Its attribute is NV+BS+RT.

+///

+#define EFI_BOOT_ORDER_VARIABLE_NAME                L"BootOrder"

+///

+/// The boot option for the next boot only.

+/// Its attribute is NV+BS+RT.

+///

+#define EFI_BOOT_NEXT_VARIABLE_NAME                 L"BootNext"

+///

+/// The boot option that was selected for the current boot.

+/// Its attribute is BS+RT.

+///

+#define EFI_BOOT_CURRENT_VARIABLE_NAME              L"BootCurrent"

+///

+/// The types of boot options supported by the boot manager. Should be treated as read-only.

+/// Its attribute is BS+RT.

+///

+#define EFI_BOOT_OPTION_SUPPORT_VARIABLE_NAME       L"BootOptionSupport"

+///

+/// The ordered driver load option list.

+/// Its attribute is NV+BS+RT.

+///

+#define EFI_DRIVER_ORDER_VARIABLE_NAME              L"DriverOrder"

+///

+/// The ordered System Prep Application load option list.

+/// Its attribute is NV+BS+RT.

+///

+#define EFI_SYS_PREP_ORDER_VARIABLE_NAME            L"SysPrepOrder"

+///

+/// Identifies the level of hardware error record persistence

+/// support implemented by the platform. This variable is

+/// only modified by firmware and is read-only to the OS.

+/// Its attribute is NV+BS+RT.

+///

+#define EFI_HW_ERR_REC_SUPPORT_VARIABLE_NAME        L"HwErrRecSupport"

+///

+/// Whether the system is operating in setup mode (1) or not (0).

+/// All other values are reserved. Should be treated as read-only.

+/// Its attribute is BS+RT.

+///

+#define EFI_SETUP_MODE_NAME                         L"SetupMode"

+///

+/// The Key Exchange Key Signature Database.

+/// Its attribute is NV+BS+RT+AT.

+///

+#define EFI_KEY_EXCHANGE_KEY_NAME                   L"KEK"

+///

+/// The public Platform Key.

+/// Its attribute is NV+BS+RT+AT.

+///

+#define EFI_PLATFORM_KEY_NAME                       L"PK"

+///

+/// Array of GUIDs representing the type of signatures supported

+/// by the platform firmware. Should be treated as read-only.

+/// Its attribute is BS+RT.

+///

+#define EFI_SIGNATURE_SUPPORT_NAME                  L"SignatureSupport"

+///

+/// Whether the platform firmware is operating in Secure boot mode (1) or not (0).

+/// All other values are reserved. Should be treated as read-only.

+/// Its attribute is BS+RT.

+///

+#define EFI_SECURE_BOOT_MODE_NAME                   L"SecureBoot"

+///

+/// The OEM's default Key Exchange Key Signature Database. Should be treated as read-only.

+/// Its attribute is BS+RT.

+///

+#define EFI_KEK_DEFAULT_VARIABLE_NAME               L"KEKDefault"

+///

+/// The OEM's default public Platform Key. Should be treated as read-only.

+/// Its attribute is BS+RT.

+///

+#define EFI_PK_DEFAULT_VARIABLE_NAME                L"PKDefault"

+///

+/// The OEM's default secure boot signature store. Should be treated as read-only.

+/// Its attribute is BS+RT.

+///

+#define EFI_DB_DEFAULT_VARIABLE_NAME                L"dbDefault"

+///

+/// The OEM's default secure boot blacklist signature store. Should be treated as read-only.

+/// Its attribute is BS+RT.

+///

+#define EFI_DBX_DEFAULT_VARIABLE_NAME               L"dbxDefault"

+///

+/// The OEM's default secure boot timestamp signature store. Should be treated as read-only.

+/// Its attribute is BS+RT.

+///

+#define EFI_DBT_DEFAULT_VARIABLE_NAME               L"dbtDefault"

+///

+/// Allows the firmware to indicate supported features and actions to the OS.

+/// Its attribute is BS+RT.

+///

+#define EFI_OS_INDICATIONS_SUPPORT_VARIABLE_NAME    L"OsIndicationsSupported"

+///

+/// Allows the OS to request the firmware to enable certain features and to take certain actions.

+/// Its attribute is NV+BS+RT.

+///

+#define EFI_OS_INDICATIONS_VARIABLE_NAME            L"OsIndications"

+///

+/// Whether the system is configured to use only vendor provided

+/// keys or not. Should be treated as read-only.

+/// Its attribute is BS+RT.

+///

+#define EFI_VENDOR_KEYS_VARIABLE_NAME               L"VendorKeys"

+

+#endif

diff --git a/debugging_demo/memtest86+/efi/Include/Guid/WinCertificate.h b/debugging_demo/memtest86+/efi/Include/Guid/WinCertificate.h
new file mode 100644
index 0000000..79872c0
--- /dev/null
+++ b/debugging_demo/memtest86+/efi/Include/Guid/WinCertificate.h
@@ -0,0 +1,122 @@
+/** @file

+  GUID for UEFI WIN_CERTIFICATE structure.

+

+  Copyright (c) 2006 - 2012, Intel Corporation. All rights reserved.<BR>

+  SPDX-License-Identifier: BSD-2-Clause-Patent

+

+  @par Revision Reference:

+  GUID defined in UEFI 2.0 spec.

+**/

+

+#ifndef __EFI_WIN_CERTIFICATE_H__

+#define __EFI_WIN_CERTIFICATE_H__

+

+//

+// _WIN_CERTIFICATE.wCertificateType

+//

+#define WIN_CERT_TYPE_PKCS_SIGNED_DATA 0x0002

+#define WIN_CERT_TYPE_EFI_PKCS115      0x0EF0

+#define WIN_CERT_TYPE_EFI_GUID         0x0EF1

+

+///

+/// The WIN_CERTIFICATE structure is part of the PE/COFF specification.

+///

+typedef struct {

+  ///

+  /// The length of the entire certificate,

+  /// including the length of the header, in bytes.

+  ///

+  UINT32  dwLength;

+  ///

+  /// The revision level of the WIN_CERTIFICATE

+  /// structure. The current revision level is 0x0200.

+  ///

+  UINT16  wRevision;

+  ///

+  /// The certificate type. See WIN_CERT_TYPE_xxx for the UEFI

+  /// certificate types. The UEFI specification reserves the range of

+  /// certificate type values from 0x0EF0 to 0x0EFF.

+  ///

+  UINT16  wCertificateType;

+  ///

+  /// The following is the actual certificate. The format of

+  /// the certificate depends on wCertificateType.

+  ///

+  /// UINT8 bCertificate[ANYSIZE_ARRAY];

+  ///

+} WIN_CERTIFICATE;

+

+///

+/// WIN_CERTIFICATE_UEFI_GUID.CertType

+///

+#define EFI_CERT_TYPE_RSA2048_SHA256_GUID \

+  {0xa7717414, 0xc616, 0x4977, {0x94, 0x20, 0x84, 0x47, 0x12, 0xa7, 0x35, 0xbf } }

+

+///

+/// WIN_CERTIFICATE_UEFI_GUID.CertData

+///

+typedef struct {

+  EFI_GUID  HashType;

+  UINT8     PublicKey[256];

+  UINT8     Signature[256];

+} EFI_CERT_BLOCK_RSA_2048_SHA256;

+

+

+///

+/// Certificate which encapsulates a GUID-specific digital signature

+///

+typedef struct {

+  ///

+  /// This is the standard WIN_CERTIFICATE header, where

+  /// wCertificateType is set to WIN_CERT_TYPE_EFI_GUID.

+  ///

+  WIN_CERTIFICATE   Hdr;

+  ///

+  /// This is the unique id which determines the

+  /// format of the CertData. .

+  ///

+  EFI_GUID          CertType;

+  ///

+  /// The following is the certificate data. The format of

+  /// the data is determined by the CertType.

+  /// If CertType is EFI_CERT_TYPE_RSA2048_SHA256_GUID,

+  /// the CertData will be EFI_CERT_BLOCK_RSA_2048_SHA256 structure.

+  ///

+  UINT8            CertData[1];

+} WIN_CERTIFICATE_UEFI_GUID;

+

+

+///

+/// Certificate which encapsulates the RSASSA_PKCS1-v1_5 digital signature.

+///

+/// The WIN_CERTIFICATE_UEFI_PKCS1_15 structure is derived from

+/// WIN_CERTIFICATE and encapsulate the information needed to

+/// implement the RSASSA-PKCS1-v1_5 digital signature algorithm as

+/// specified in RFC2437.

+///

+typedef struct {

+  ///

+  /// This is the standard WIN_CERTIFICATE header, where

+  /// wCertificateType is set to WIN_CERT_TYPE_UEFI_PKCS1_15.

+  ///

+  WIN_CERTIFICATE Hdr;

+  ///

+  /// This is the hashing algorithm which was performed on the

+  /// UEFI executable when creating the digital signature.

+  ///

+  EFI_GUID        HashAlgorithm;

+  ///

+  /// The following is the actual digital signature. The

+  /// size of the signature is the same size as the key

+  /// (1024-bit key is 128 bytes) and can be determined by

+  /// subtracting the length of the other parts of this header

+  /// from the total length of the certificate as found in

+  /// Hdr.dwLength.

+  ///

+  /// UINT8 Signature[];

+  ///

+} WIN_CERTIFICATE_EFI_PKCS1_15;

+

+extern EFI_GUID gEfiCertTypeRsa2048Sha256Guid;

+

+#endif

diff --git a/debugging_demo/memtest86+/efi/Include/IndustryStandard/Acpi.h b/debugging_demo/memtest86+/efi/Include/IndustryStandard/Acpi.h
new file mode 100644
index 0000000..48f4d71
--- /dev/null
+++ b/debugging_demo/memtest86+/efi/Include/IndustryStandard/Acpi.h
@@ -0,0 +1,16 @@
+/** @file

+  This file contains the latest ACPI definitions that are

+  consumed by drivers that do not care about ACPI versions.

+

+  Copyright (c) 2006 - 2017, Intel Corporation. All rights reserved.<BR>

+  Copyright (c) 2019, ARM Ltd. All rights reserved.<BR>

+  SPDX-License-Identifier: BSD-2-Clause-Patent

+

+**/

+

+#ifndef _ACPI_H_

+#define _ACPI_H_

+

+#include <IndustryStandard/Acpi63.h>

+

+#endif

diff --git a/debugging_demo/memtest86+/efi/Include/IndustryStandard/Acpi10.h b/debugging_demo/memtest86+/efi/Include/IndustryStandard/Acpi10.h
new file mode 100644
index 0000000..fa06eef
--- /dev/null
+++ b/debugging_demo/memtest86+/efi/Include/IndustryStandard/Acpi10.h
@@ -0,0 +1,655 @@
+/** @file

+  ACPI 1.0b definitions from the ACPI Specification, revision 1.0b

+

+Copyright (c) 2006 - 2018, Intel Corporation. All rights reserved.<BR>

+SPDX-License-Identifier: BSD-2-Clause-Patent

+**/

+

+#ifndef _ACPI_1_0_H_

+#define _ACPI_1_0_H_

+

+#include <IndustryStandard/AcpiAml.h>

+

+///

+/// Common table header, this prefaces all ACPI tables, including FACS, but

+/// excluding the RSD PTR structure.

+///

+typedef struct {

+  UINT32  Signature;

+  UINT32  Length;

+} EFI_ACPI_COMMON_HEADER;

+

+#pragma pack(1)

+///

+/// The common ACPI description table header.  This structure prefaces most ACPI tables.

+///

+typedef struct {

+  UINT32  Signature;

+  UINT32  Length;

+  UINT8   Revision;

+  UINT8   Checksum;

+  UINT8   OemId[6];

+  UINT64  OemTableId;

+  UINT32  OemRevision;

+  UINT32  CreatorId;

+  UINT32  CreatorRevision;

+} EFI_ACPI_DESCRIPTION_HEADER;

+#pragma pack()

+

+//

+// Define for Descriptor

+//

+#define ACPI_SMALL_ITEM_FLAG                   0x00

+#define ACPI_LARGE_ITEM_FLAG                   0x01

+

+//

+// Small Item Descriptor Name

+//

+#define ACPI_SMALL_IRQ_DESCRIPTOR_NAME                       0x04

+#define ACPI_SMALL_DMA_DESCRIPTOR_NAME                       0x05

+#define ACPI_SMALL_START_DEPENDENT_DESCRIPTOR_NAME           0x06

+#define ACPI_SMALL_END_DEPENDENT_DESCRIPTOR_NAME             0x07

+#define ACPI_SMALL_IO_PORT_DESCRIPTOR_NAME                   0x08

+#define ACPI_SMALL_FIXED_IO_PORT_DESCRIPTOR_NAME             0x09

+#define ACPI_SMALL_VENDOR_DEFINED_DESCRIPTOR_NAME            0x0E

+#define ACPI_SMALL_END_TAG_DESCRIPTOR_NAME                   0x0F

+

+//

+// Large Item Descriptor Name

+//

+#define ACPI_LARGE_24_BIT_MEMORY_RANGE_DESCRIPTOR_NAME       0x01

+#define ACPI_LARGE_VENDOR_DEFINED_DESCRIPTOR_NAME            0x04

+#define ACPI_LARGE_32_BIT_MEMORY_RANGE_DESCRIPTOR_NAME       0x05

+#define ACPI_LARGE_32_BIT_FIXED_MEMORY_RANGE_DESCRIPTOR_NAME 0x06

+#define ACPI_LARGE_DWORD_ADDRESS_SPACE_DESCRIPTOR_NAME       0x07

+#define ACPI_LARGE_WORD_ADDRESS_SPACE_DESCRIPTOR_NAME        0x08

+#define ACPI_LARGE_EXTENDED_IRQ_DESCRIPTOR_NAME              0x09

+#define ACPI_LARGE_QWORD_ADDRESS_SPACE_DESCRIPTOR_NAME       0x0A

+

+//

+// Small Item Descriptor Value

+//

+#define ACPI_IRQ_NOFLAG_DESCRIPTOR                0x22

+#define ACPI_IRQ_DESCRIPTOR                       0x23

+#define ACPI_DMA_DESCRIPTOR                       0x2A

+#define ACPI_START_DEPENDENT_DESCRIPTOR           0x30

+#define ACPI_START_DEPENDENT_EX_DESCRIPTOR        0x31

+#define ACPI_END_DEPENDENT_DESCRIPTOR             0x38

+#define ACPI_IO_PORT_DESCRIPTOR                   0x47

+#define ACPI_FIXED_LOCATION_IO_PORT_DESCRIPTOR    0x4B

+#define ACPI_END_TAG_DESCRIPTOR                   0x79

+

+//

+// Large Item Descriptor Value

+//

+#define ACPI_24_BIT_MEMORY_RANGE_DESCRIPTOR       0x81

+#define ACPI_32_BIT_MEMORY_RANGE_DESCRIPTOR       0x85

+#define ACPI_32_BIT_FIXED_MEMORY_RANGE_DESCRIPTOR 0x86

+#define ACPI_DWORD_ADDRESS_SPACE_DESCRIPTOR       0x87

+#define ACPI_WORD_ADDRESS_SPACE_DESCRIPTOR        0x88

+#define ACPI_EXTENDED_INTERRUPT_DESCRIPTOR        0x89

+#define ACPI_QWORD_ADDRESS_SPACE_DESCRIPTOR       0x8A

+#define ACPI_ADDRESS_SPACE_DESCRIPTOR             0x8A

+

+//

+// Resource Type

+//

+#define ACPI_ADDRESS_SPACE_TYPE_MEM   0x00

+#define ACPI_ADDRESS_SPACE_TYPE_IO    0x01

+#define ACPI_ADDRESS_SPACE_TYPE_BUS   0x02

+

+///

+/// Power Management Timer frequency is fixed at 3.579545MHz.

+///

+#define ACPI_TIMER_FREQUENCY       3579545

+

+//

+// Ensure proper structure formats

+//

+#pragma pack(1)

+

+///

+/// The common definition of QWORD, DWORD, and WORD

+/// Address Space Descriptors.

+///

+typedef PACKED struct {

+  UINT8   Desc;

+  UINT16  Len;

+  UINT8   ResType;

+  UINT8   GenFlag;

+  UINT8   SpecificFlag;

+  UINT64  AddrSpaceGranularity;

+  UINT64  AddrRangeMin;

+  UINT64  AddrRangeMax;

+  UINT64  AddrTranslationOffset;

+  UINT64  AddrLen;

+} EFI_ACPI_ADDRESS_SPACE_DESCRIPTOR;

+

+typedef PACKED union {

+  UINT8     Byte;

+  PACKED struct {

+    UINT8 Length : 3;

+    UINT8 Name : 4;

+    UINT8 Type : 1;

+  } Bits;

+} ACPI_SMALL_RESOURCE_HEADER;

+

+typedef PACKED struct {

+  PACKED union {

+    UINT8 Byte;

+    PACKED struct {

+      UINT8 Name : 7;

+      UINT8 Type : 1;

+    }Bits;

+  } Header;

+  UINT16 Length;

+} ACPI_LARGE_RESOURCE_HEADER;

+

+///

+/// IRQ Descriptor.

+///

+typedef PACKED struct {

+  ACPI_SMALL_RESOURCE_HEADER   Header;

+  UINT16                       Mask;

+} EFI_ACPI_IRQ_NOFLAG_DESCRIPTOR;

+

+///

+/// IRQ Descriptor.

+///

+typedef PACKED struct {

+  ACPI_SMALL_RESOURCE_HEADER   Header;

+  UINT16                       Mask;

+  UINT8                        Information;

+} EFI_ACPI_IRQ_DESCRIPTOR;

+

+///

+/// DMA Descriptor.

+///

+typedef PACKED struct {

+  ACPI_SMALL_RESOURCE_HEADER   Header;

+  UINT8                        ChannelMask;

+  UINT8                        Information;

+} EFI_ACPI_DMA_DESCRIPTOR;

+

+///

+/// I/O Port Descriptor

+///

+typedef PACKED struct {

+  ACPI_SMALL_RESOURCE_HEADER   Header;

+  UINT8                        Information;

+  UINT16                       BaseAddressMin;

+  UINT16                       BaseAddressMax;

+  UINT8                        Alignment;

+  UINT8                        Length;

+} EFI_ACPI_IO_PORT_DESCRIPTOR;

+

+///

+/// Fixed Location I/O Port Descriptor.

+///

+typedef PACKED struct {

+  ACPI_SMALL_RESOURCE_HEADER   Header;

+  UINT16                       BaseAddress;

+  UINT8                        Length;

+} EFI_ACPI_FIXED_LOCATION_IO_PORT_DESCRIPTOR;

+

+///

+/// 24-Bit Memory Range Descriptor

+///

+typedef PACKED struct {

+  ACPI_LARGE_RESOURCE_HEADER    Header;

+  UINT8                         Information;

+  UINT16                        BaseAddressMin;

+  UINT16                        BaseAddressMax;

+  UINT16                        Alignment;

+  UINT16                        Length;

+} EFI_ACPI_24_BIT_MEMORY_RANGE_DESCRIPTOR;

+

+///

+/// 32-Bit Memory Range Descriptor

+///

+typedef PACKED struct {

+  ACPI_LARGE_RESOURCE_HEADER    Header;

+  UINT8                         Information;

+  UINT32                        BaseAddressMin;

+  UINT32                        BaseAddressMax;

+  UINT32                        Alignment;

+  UINT32                        Length;

+} EFI_ACPI_32_BIT_MEMORY_RANGE_DESCRIPTOR;

+

+///

+/// Fixed 32-Bit Fixed Memory Range Descriptor

+///

+typedef PACKED struct {

+  ACPI_LARGE_RESOURCE_HEADER    Header;

+  UINT8                         Information;

+  UINT32                        BaseAddress;

+  UINT32                        Length;

+} EFI_ACPI_32_BIT_FIXED_MEMORY_RANGE_DESCRIPTOR;

+

+///

+/// QWORD Address Space Descriptor

+///

+typedef PACKED struct {

+  ACPI_LARGE_RESOURCE_HEADER    Header;

+  UINT8                         ResType;

+  UINT8                         GenFlag;

+  UINT8                         SpecificFlag;

+  UINT64                        AddrSpaceGranularity;

+  UINT64                        AddrRangeMin;

+  UINT64                        AddrRangeMax;

+  UINT64                        AddrTranslationOffset;

+  UINT64                        AddrLen;

+} EFI_ACPI_QWORD_ADDRESS_SPACE_DESCRIPTOR;

+

+///

+/// DWORD Address Space Descriptor

+///

+typedef PACKED struct {

+  ACPI_LARGE_RESOURCE_HEADER    Header;

+  UINT8                         ResType;

+  UINT8                         GenFlag;

+  UINT8                         SpecificFlag;

+  UINT32                        AddrSpaceGranularity;

+  UINT32                        AddrRangeMin;

+  UINT32                        AddrRangeMax;

+  UINT32                        AddrTranslationOffset;

+  UINT32                        AddrLen;

+} EFI_ACPI_DWORD_ADDRESS_SPACE_DESCRIPTOR;

+

+///

+/// WORD Address Space Descriptor

+///

+typedef PACKED struct {

+  ACPI_LARGE_RESOURCE_HEADER    Header;

+  UINT8                         ResType;

+  UINT8                         GenFlag;

+  UINT8                         SpecificFlag;

+  UINT16                        AddrSpaceGranularity;

+  UINT16                        AddrRangeMin;

+  UINT16                        AddrRangeMax;

+  UINT16                        AddrTranslationOffset;

+  UINT16                        AddrLen;

+} EFI_ACPI_WORD_ADDRESS_SPACE_DESCRIPTOR;

+

+///

+/// Extended Interrupt Descriptor

+///

+typedef PACKED struct {

+  ACPI_LARGE_RESOURCE_HEADER    Header;

+  UINT8                         InterruptVectorFlags;

+  UINT8                         InterruptTableLength;

+  UINT32                        InterruptNumber[1];

+} EFI_ACPI_EXTENDED_INTERRUPT_DESCRIPTOR;

+

+#pragma pack()

+

+///

+/// The End tag identifies an end of resource data.

+///

+typedef struct {

+  UINT8 Desc;

+  UINT8 Checksum;

+} EFI_ACPI_END_TAG_DESCRIPTOR;

+

+//

+// General use definitions

+//

+#define EFI_ACPI_RESERVED_BYTE  0x00

+#define EFI_ACPI_RESERVED_WORD  0x0000

+#define EFI_ACPI_RESERVED_DWORD 0x00000000

+#define EFI_ACPI_RESERVED_QWORD 0x0000000000000000

+

+//

+// Resource Type Specific Flags

+// Ref ACPI specification 6.4.3.5.5

+//

+// Bit [0]    : Write Status, _RW

+//

+#define EFI_ACPI_MEMORY_RESOURCE_SPECIFIC_FLAG_READ_WRITE                (1 << 0)

+#define EFI_ACPI_MEMORY_RESOURCE_SPECIFIC_FLAG_READ_ONLY                 (0 << 0)

+//

+// Bit [2:1]  : Memory Attributes, _MEM

+//

+#define EFI_ACPI_MEMORY_RESOURCE_SPECIFIC_FLAG_NON_CACHEABLE             (0 << 1)

+#define EFI_ACPI_MEMORY_RESOURCE_SPECIFIC_FLAG_CACHEABLE                 (1 << 1)

+#define EFI_ACPI_MEMORY_RESOURCE_SPECIFIC_FLAG_CACHEABLE_WRITE_COMBINING (2 << 1)

+#define EFI_ACPI_MEMORY_RESOURCE_SPECIFIC_FLAG_CACHEABLE_PREFETCHABLE    (3 << 1)

+//

+// Bit [4:3]  : Memory Attributes, _MTP

+//

+#define EFI_ACPI_MEMORY_RESOURCE_SPECIFIC_FLAG_ADDRESS_RANGE_MEMORY      (0 << 3)

+#define EFI_ACPI_MEMORY_RESOURCE_SPECIFIC_FLAG_ADDRESS_RANGE_RESERVED    (1 << 3)

+#define EFI_ACPI_MEMORY_RESOURCE_SPECIFIC_FLAG_ADDRESS_RANGE_ACPI        (2 << 3)

+#define EFI_APCI_MEMORY_RESOURCE_SPECIFIC_FLAG_ADDRESS_RANGE_NVS         (3 << 3)

+//

+// Bit [5]    : Memory to I/O Translation, _TTP

+//

+#define EFI_ACPI_MEMORY_RESOURCE_SPECIFIC_FLAG_TYPE_TRANSLATION          (1 << 5)

+#define EFI_ACPI_MEMORY_RESOURCE_SPECIFIC_FLAG_TYPE_STATIC               (0 << 5)

+

+//

+// IRQ Information

+// Ref ACPI specification 6.4.2.1

+//

+#define EFI_ACPI_IRQ_SHARABLE_MASK                      0x10

+#define   EFI_ACPI_IRQ_SHARABLE                         0x10

+

+#define EFI_ACPI_IRQ_POLARITY_MASK                      0x08

+#define   EFI_ACPI_IRQ_HIGH_TRUE                        0x00

+#define   EFI_ACPI_IRQ_LOW_FALSE                        0x08

+

+#define EFI_ACPI_IRQ_MODE                               0x01

+#define   EFI_ACPI_IRQ_LEVEL_TRIGGERED                  0x00

+#define   EFI_ACPI_IRQ_EDGE_TRIGGERED                   0x01

+

+//

+// DMA Information

+// Ref ACPI specification 6.4.2.2

+//

+#define EFI_ACPI_DMA_SPEED_TYPE_MASK                    0x60

+#define   EFI_ACPI_DMA_SPEED_TYPE_COMPATIBILITY         0x00

+#define   EFI_ACPI_DMA_SPEED_TYPE_A                     0x20

+#define   EFI_ACPI_DMA_SPEED_TYPE_B                     0x40

+#define   EFI_ACPI_DMA_SPEED_TYPE_F                     0x60

+

+#define EFI_ACPI_DMA_BUS_MASTER_MASK                    0x04

+#define   EFI_ACPI_DMA_BUS_MASTER                       0x04

+

+#define EFI_ACPI_DMA_TRANSFER_TYPE_MASK                 0x03

+#define   EFI_ACPI_DMA_TRANSFER_TYPE_8_BIT              0x00

+#define   EFI_ACPI_DMA_TRANSFER_TYPE_8_BIT_AND_16_BIT   0x01

+#define   EFI_ACPI_DMA_TRANSFER_TYPE_16_BIT             0x10

+

+//

+// IO Information

+// Ref ACPI specification 6.4.2.5

+//

+#define EFI_ACPI_IO_DECODE_MASK                         0x01

+#define   EFI_ACPI_IO_DECODE_16_BIT                     0x01

+#define   EFI_ACPI_IO_DECODE_10_BIT                     0x00

+

+//

+// Memory Information

+// Ref ACPI specification 6.4.3.4

+//

+#define EFI_ACPI_MEMORY_WRITE_STATUS_MASK               0x01

+#define   EFI_ACPI_MEMORY_WRITABLE                      0x01

+#define   EFI_ACPI_MEMORY_NON_WRITABLE                  0x00

+

+//

+// Ensure proper structure formats

+//

+#pragma pack(1)

+//

+// ACPI 1.0b table structures

+//

+

+///

+/// Root System Description Pointer Structure.

+///

+typedef struct {

+  UINT64  Signature;

+  UINT8   Checksum;

+  UINT8   OemId[6];

+  UINT8   Reserved;

+  UINT32  RsdtAddress;

+} EFI_ACPI_1_0_ROOT_SYSTEM_DESCRIPTION_POINTER;

+

+//

+// Root System Description Table

+// No definition needed as it is a common description table header, the same with

+// EFI_ACPI_DESCRIPTION_HEADER, followed by a variable number of UINT32 table pointers.

+//

+

+///

+/// RSDT Revision (as defined in ACPI 1.0b specification).

+///

+#define EFI_ACPI_1_0_ROOT_SYSTEM_DESCRIPTION_TABLE_REVISION 0x01

+

+///

+/// Fixed ACPI Description Table Structure (FADT).

+///

+typedef struct {

+  EFI_ACPI_DESCRIPTION_HEADER Header;

+  UINT32                      FirmwareCtrl;

+  UINT32                      Dsdt;

+  UINT8                       IntModel;

+  UINT8                       Reserved1;

+  UINT16                      SciInt;

+  UINT32                      SmiCmd;

+  UINT8                       AcpiEnable;

+  UINT8                       AcpiDisable;

+  UINT8                       S4BiosReq;

+  UINT8                       Reserved2;

+  UINT32                      Pm1aEvtBlk;

+  UINT32                      Pm1bEvtBlk;

+  UINT32                      Pm1aCntBlk;

+  UINT32                      Pm1bCntBlk;

+  UINT32                      Pm2CntBlk;

+  UINT32                      PmTmrBlk;

+  UINT32                      Gpe0Blk;

+  UINT32                      Gpe1Blk;

+  UINT8                       Pm1EvtLen;

+  UINT8                       Pm1CntLen;

+  UINT8                       Pm2CntLen;

+  UINT8                       PmTmLen;

+  UINT8                       Gpe0BlkLen;

+  UINT8                       Gpe1BlkLen;

+  UINT8                       Gpe1Base;

+  UINT8                       Reserved3;

+  UINT16                      PLvl2Lat;

+  UINT16                      PLvl3Lat;

+  UINT16                      FlushSize;

+  UINT16                      FlushStride;

+  UINT8                       DutyOffset;

+  UINT8                       DutyWidth;

+  UINT8                       DayAlrm;

+  UINT8                       MonAlrm;

+  UINT8                       Century;

+  UINT8                       Reserved4;

+  UINT8                       Reserved5;

+  UINT8                       Reserved6;

+  UINT32                      Flags;

+} EFI_ACPI_1_0_FIXED_ACPI_DESCRIPTION_TABLE;

+

+///

+/// FADT Version (as defined in ACPI 1.0b specification).

+///

+#define EFI_ACPI_1_0_FIXED_ACPI_DESCRIPTION_TABLE_REVISION  0x01

+

+#define EFI_ACPI_1_0_INT_MODE_DUAL_PIC         0

+#define EFI_ACPI_1_0_INT_MODE_MULTIPLE_APIC    1

+

+//

+// Fixed ACPI Description Table Fixed Feature Flags

+// All other bits are reserved and must be set to 0.

+//

+#define EFI_ACPI_1_0_WBINVD               BIT0

+#define EFI_ACPI_1_0_WBINVD_FLUSH         BIT1

+#define EFI_ACPI_1_0_PROC_C1              BIT2

+#define EFI_ACPI_1_0_P_LVL2_UP            BIT3

+#define EFI_ACPI_1_0_PWR_BUTTON           BIT4

+#define EFI_ACPI_1_0_SLP_BUTTON           BIT5

+#define EFI_ACPI_1_0_FIX_RTC              BIT6

+#define EFI_ACPI_1_0_RTC_S4               BIT7

+#define EFI_ACPI_1_0_TMR_VAL_EXT          BIT8

+#define EFI_ACPI_1_0_DCK_CAP              BIT9

+

+///

+/// Firmware ACPI Control Structure.

+///

+typedef struct {

+  UINT32  Signature;

+  UINT32  Length;

+  UINT32  HardwareSignature;

+  UINT32  FirmwareWakingVector;

+  UINT32  GlobalLock;

+  UINT32  Flags;

+  UINT8   Reserved[40];

+} EFI_ACPI_1_0_FIRMWARE_ACPI_CONTROL_STRUCTURE;

+

+///

+/// Firmware Control Structure Feature Flags.

+/// All other bits are reserved and must be set to 0.

+///

+#define EFI_ACPI_1_0_S4BIOS_F             BIT0

+

+///

+/// Multiple APIC Description Table header definition.  The rest of the table

+/// must be defined in a platform-specific manner.

+///

+typedef struct {

+  EFI_ACPI_DESCRIPTION_HEADER Header;

+  UINT32                      LocalApicAddress;

+  UINT32                      Flags;

+} EFI_ACPI_1_0_MULTIPLE_APIC_DESCRIPTION_TABLE_HEADER;

+

+///

+/// MADT Revision (as defined in ACPI 1.0b specification).

+///

+#define EFI_ACPI_1_0_MULTIPLE_APIC_DESCRIPTION_TABLE_REVISION 0x01

+

+///

+/// Multiple APIC Flags

+/// All other bits are reserved and must be set to 0.

+///

+#define EFI_ACPI_1_0_PCAT_COMPAT           BIT0

+

+//

+// Multiple APIC Description Table APIC structure types

+// All other values between 0x05 an 0xFF are reserved and

+// will be ignored by OSPM.

+//

+#define EFI_ACPI_1_0_PROCESSOR_LOCAL_APIC           0x00

+#define EFI_ACPI_1_0_IO_APIC                        0x01

+#define EFI_ACPI_1_0_INTERRUPT_SOURCE_OVERRIDE      0x02

+#define EFI_ACPI_1_0_NON_MASKABLE_INTERRUPT_SOURCE  0x03

+#define EFI_ACPI_1_0_LOCAL_APIC_NMI                 0x04

+

+//

+// APIC Structure Definitions

+//

+

+///

+/// Processor Local APIC Structure Definition.

+///

+typedef struct {

+  UINT8   Type;

+  UINT8   Length;

+  UINT8   AcpiProcessorId;

+  UINT8   ApicId;

+  UINT32  Flags;

+} EFI_ACPI_1_0_PROCESSOR_LOCAL_APIC_STRUCTURE;

+

+///

+/// Local APIC Flags.  All other bits are reserved and must be 0.

+///

+#define EFI_ACPI_1_0_LOCAL_APIC_ENABLED      BIT0

+

+///

+/// IO APIC Structure.

+///

+typedef struct {

+  UINT8   Type;

+  UINT8   Length;

+  UINT8   IoApicId;

+  UINT8   Reserved;

+  UINT32  IoApicAddress;

+  UINT32  SystemVectorBase;

+} EFI_ACPI_1_0_IO_APIC_STRUCTURE;

+

+///

+/// Interrupt Source Override Structure.

+///

+typedef struct {

+  UINT8   Type;

+  UINT8   Length;

+  UINT8   Bus;

+  UINT8   Source;

+  UINT32  GlobalSystemInterruptVector;

+  UINT16  Flags;

+} EFI_ACPI_1_0_INTERRUPT_SOURCE_OVERRIDE_STRUCTURE;

+

+///

+/// Non-Maskable Interrupt Source Structure.

+///

+typedef struct {

+  UINT8   Type;

+  UINT8   Length;

+  UINT16  Flags;

+  UINT32  GlobalSystemInterruptVector;

+} EFI_ACPI_1_0_NON_MASKABLE_INTERRUPT_SOURCE_STRUCTURE;

+

+///

+/// Local APIC NMI Structure.

+///

+typedef struct {

+  UINT8   Type;

+  UINT8   Length;

+  UINT8   AcpiProcessorId;

+  UINT16  Flags;

+  UINT8   LocalApicInti;

+} EFI_ACPI_1_0_LOCAL_APIC_NMI_STRUCTURE;

+

+///

+/// Smart Battery Description Table (SBST)

+///

+typedef struct {

+  EFI_ACPI_DESCRIPTION_HEADER Header;

+  UINT32                      WarningEnergyLevel;

+  UINT32                      LowEnergyLevel;

+  UINT32                      CriticalEnergyLevel;

+} EFI_ACPI_1_0_SMART_BATTERY_DESCRIPTION_TABLE;

+

+//

+// Known table signatures

+//

+

+///

+/// "RSD PTR " Root System Description Pointer.

+///

+#define EFI_ACPI_1_0_ROOT_SYSTEM_DESCRIPTION_POINTER_SIGNATURE  SIGNATURE_64('R', 'S', 'D', ' ', 'P', 'T', 'R', ' ')

+

+///

+/// "APIC" Multiple APIC Description Table.

+///

+#define EFI_ACPI_1_0_APIC_SIGNATURE  SIGNATURE_32('A', 'P', 'I', 'C')

+

+///

+/// "DSDT" Differentiated System Description Table.

+///

+#define EFI_ACPI_1_0_DIFFERENTIATED_SYSTEM_DESCRIPTION_TABLE_SIGNATURE  SIGNATURE_32('D', 'S', 'D', 'T')

+

+///

+/// "FACS" Firmware ACPI Control Structure.

+///

+#define EFI_ACPI_1_0_FIRMWARE_ACPI_CONTROL_STRUCTURE_SIGNATURE  SIGNATURE_32('F', 'A', 'C', 'S')

+

+///

+/// "FACP" Fixed ACPI Description Table.

+///

+#define EFI_ACPI_1_0_FIXED_ACPI_DESCRIPTION_TABLE_SIGNATURE  SIGNATURE_32('F', 'A', 'C', 'P')

+

+///

+/// "PSDT" Persistent System Description Table.

+///

+#define EFI_ACPI_1_0_PERSISTENT_SYSTEM_DESCRIPTION_TABLE_SIGNATURE  SIGNATURE_32('P', 'S', 'D', 'T')

+

+///

+/// "RSDT" Root System Description Table.

+///

+#define EFI_ACPI_1_0_ROOT_SYSTEM_DESCRIPTION_TABLE_SIGNATURE  SIGNATURE_32('R', 'S', 'D', 'T')

+

+///

+/// "SBST" Smart Battery Specification Table.

+///

+#define EFI_ACPI_1_0_SMART_BATTERY_SPECIFICATION_TABLE_SIGNATURE  SIGNATURE_32('S', 'B', 'S', 'T')

+

+///

+/// "SSDT" Secondary System Description Table.

+///

+#define EFI_ACPI_1_0_SECONDARY_SYSTEM_DESCRIPTION_TABLE_SIGNATURE  SIGNATURE_32('S', 'S', 'D', 'T')

+

+#pragma pack()

+

+#endif

diff --git a/debugging_demo/memtest86+/efi/Include/IndustryStandard/Acpi20.h b/debugging_demo/memtest86+/efi/Include/IndustryStandard/Acpi20.h
new file mode 100644
index 0000000..b63d494
--- /dev/null
+++ b/debugging_demo/memtest86+/efi/Include/IndustryStandard/Acpi20.h
@@ -0,0 +1,539 @@
+/** @file

+  ACPI 2.0 definitions from the ACPI Specification, revision 2.0

+

+  Copyright (c) 2006 - 2018, Intel Corporation. All rights reserved.<BR>

+  SPDX-License-Identifier: BSD-2-Clause-Patent

+**/

+

+#ifndef _ACPI_2_0_H_

+#define _ACPI_2_0_H_

+

+#include <IndustryStandard/Acpi10.h>

+

+//

+// Define for Descriptor

+//

+#define ACPI_LARGE_GENERIC_REGISTER_DESCRIPTOR_NAME          0x02

+

+#define ACPI_GENERIC_REGISTER_DESCRIPTOR          0x82

+

+//

+// Ensure proper structure formats

+//

+#pragma pack(1)

+

+///

+/// Generic Register Descriptor

+///

+typedef PACKED struct {

+  ACPI_LARGE_RESOURCE_HEADER    Header;

+  UINT8                         AddressSpaceId;

+  UINT8                         RegisterBitWidth;

+  UINT8                         RegisterBitOffset;

+  UINT8                         AddressSize;

+  UINT64                        RegisterAddress;

+} EFI_ACPI_GENERIC_REGISTER_DESCRIPTOR;

+

+#pragma pack()

+

+//

+// Ensure proper structure formats

+//

+#pragma pack(1)

+

+///

+/// ACPI 2.0 Generic Address Space definition

+///

+typedef struct {

+  UINT8   AddressSpaceId;

+  UINT8   RegisterBitWidth;

+  UINT8   RegisterBitOffset;

+  UINT8   Reserved;

+  UINT64  Address;

+} EFI_ACPI_2_0_GENERIC_ADDRESS_STRUCTURE;

+

+//

+// Generic Address Space Address IDs

+//

+#define EFI_ACPI_2_0_SYSTEM_MEMORY              0

+#define EFI_ACPI_2_0_SYSTEM_IO                  1

+#define EFI_ACPI_2_0_PCI_CONFIGURATION_SPACE    2

+#define EFI_ACPI_2_0_EMBEDDED_CONTROLLER        3

+#define EFI_ACPI_2_0_SMBUS                      4

+#define EFI_ACPI_2_0_FUNCTIONAL_FIXED_HARDWARE  0x7F

+

+//

+// ACPI 2.0 table structures

+//

+

+///

+/// Root System Description Pointer Structure

+///

+typedef struct {

+  UINT64  Signature;

+  UINT8   Checksum;

+  UINT8   OemId[6];

+  UINT8   Revision;

+  UINT32  RsdtAddress;

+  UINT32  Length;

+  UINT64  XsdtAddress;

+  UINT8   ExtendedChecksum;

+  UINT8   Reserved[3];

+} EFI_ACPI_2_0_ROOT_SYSTEM_DESCRIPTION_POINTER;

+

+///

+/// RSD_PTR Revision (as defined in ACPI 2.0 spec.)

+///

+#define EFI_ACPI_2_0_ROOT_SYSTEM_DESCRIPTION_POINTER_REVISION 0x02

+

+///

+/// Common table header, this prefaces all ACPI tables, including FACS, but

+/// excluding the RSD PTR structure

+///

+typedef struct {

+  UINT32  Signature;

+  UINT32  Length;

+} EFI_ACPI_2_0_COMMON_HEADER;

+

+//

+// Root System Description Table

+// No definition needed as it is a common description table header, the same with

+// EFI_ACPI_DESCRIPTION_HEADER, followed by a variable number of UINT32 table pointers.

+//

+

+///

+/// RSDT Revision (as defined in ACPI 2.0 spec.)

+///

+#define EFI_ACPI_2_0_ROOT_SYSTEM_DESCRIPTION_TABLE_REVISION 0x01

+

+//

+// Extended System Description Table

+// No definition needed as it is a common description table header, the same with

+// EFI_ACPI_DESCRIPTION_HEADER, followed by a variable number of UINT64 table pointers.

+//

+

+///

+/// XSDT Revision (as defined in ACPI 2.0 spec.)

+///

+#define EFI_ACPI_2_0_EXTENDED_SYSTEM_DESCRIPTION_TABLE_REVISION 0x01

+

+///

+/// Fixed ACPI Description Table Structure (FADT)

+///

+typedef struct {

+  EFI_ACPI_DESCRIPTION_HEADER             Header;

+  UINT32                                  FirmwareCtrl;

+  UINT32                                  Dsdt;

+  UINT8                                   Reserved0;

+  UINT8                                   PreferredPmProfile;

+  UINT16                                  SciInt;

+  UINT32                                  SmiCmd;

+  UINT8                                   AcpiEnable;

+  UINT8                                   AcpiDisable;

+  UINT8                                   S4BiosReq;

+  UINT8                                   PstateCnt;

+  UINT32                                  Pm1aEvtBlk;

+  UINT32                                  Pm1bEvtBlk;

+  UINT32                                  Pm1aCntBlk;

+  UINT32                                  Pm1bCntBlk;

+  UINT32                                  Pm2CntBlk;

+  UINT32                                  PmTmrBlk;

+  UINT32                                  Gpe0Blk;

+  UINT32                                  Gpe1Blk;

+  UINT8                                   Pm1EvtLen;

+  UINT8                                   Pm1CntLen;

+  UINT8                                   Pm2CntLen;

+  UINT8                                   PmTmrLen;

+  UINT8                                   Gpe0BlkLen;

+  UINT8                                   Gpe1BlkLen;

+  UINT8                                   Gpe1Base;

+  UINT8                                   CstCnt;

+  UINT16                                  PLvl2Lat;

+  UINT16                                  PLvl3Lat;

+  UINT16                                  FlushSize;

+  UINT16                                  FlushStride;

+  UINT8                                   DutyOffset;

+  UINT8                                   DutyWidth;

+  UINT8                                   DayAlrm;

+  UINT8                                   MonAlrm;

+  UINT8                                   Century;

+  UINT16                                  IaPcBootArch;

+  UINT8                                   Reserved1;

+  UINT32                                  Flags;

+  EFI_ACPI_2_0_GENERIC_ADDRESS_STRUCTURE  ResetReg;

+  UINT8                                   ResetValue;

+  UINT8                                   Reserved2[3];

+  UINT64                                  XFirmwareCtrl;

+  UINT64                                  XDsdt;

+  EFI_ACPI_2_0_GENERIC_ADDRESS_STRUCTURE  XPm1aEvtBlk;

+  EFI_ACPI_2_0_GENERIC_ADDRESS_STRUCTURE  XPm1bEvtBlk;

+  EFI_ACPI_2_0_GENERIC_ADDRESS_STRUCTURE  XPm1aCntBlk;

+  EFI_ACPI_2_0_GENERIC_ADDRESS_STRUCTURE  XPm1bCntBlk;

+  EFI_ACPI_2_0_GENERIC_ADDRESS_STRUCTURE  XPm2CntBlk;

+  EFI_ACPI_2_0_GENERIC_ADDRESS_STRUCTURE  XPmTmrBlk;

+  EFI_ACPI_2_0_GENERIC_ADDRESS_STRUCTURE  XGpe0Blk;

+  EFI_ACPI_2_0_GENERIC_ADDRESS_STRUCTURE  XGpe1Blk;

+} EFI_ACPI_2_0_FIXED_ACPI_DESCRIPTION_TABLE;

+

+///

+/// FADT Version (as defined in ACPI 2.0 spec.)

+///

+#define EFI_ACPI_2_0_FIXED_ACPI_DESCRIPTION_TABLE_REVISION  0x03

+

+//

+// Fixed ACPI Description Table Preferred Power Management Profile

+//

+#define EFI_ACPI_2_0_PM_PROFILE_UNSPECIFIED         0

+#define EFI_ACPI_2_0_PM_PROFILE_DESKTOP             1

+#define EFI_ACPI_2_0_PM_PROFILE_MOBILE              2

+#define EFI_ACPI_2_0_PM_PROFILE_WORKSTATION         3

+#define EFI_ACPI_2_0_PM_PROFILE_ENTERPRISE_SERVER   4

+#define EFI_ACPI_2_0_PM_PROFILE_SOHO_SERVER         5

+#define EFI_ACPI_2_0_PM_PROFILE_APPLIANCE_PC        6

+

+//

+// Fixed ACPI Description Table Boot Architecture Flags

+// All other bits are reserved and must be set to 0.

+//

+#define EFI_ACPI_2_0_LEGACY_DEVICES          BIT0

+#define EFI_ACPI_2_0_8042                    BIT1

+

+//

+// Fixed ACPI Description Table Fixed Feature Flags

+// All other bits are reserved and must be set to 0.

+//

+#define EFI_ACPI_2_0_WBINVD                  BIT0

+#define EFI_ACPI_2_0_WBINVD_FLUSH            BIT1

+#define EFI_ACPI_2_0_PROC_C1                 BIT2

+#define EFI_ACPI_2_0_P_LVL2_UP               BIT3

+#define EFI_ACPI_2_0_PWR_BUTTON              BIT4

+#define EFI_ACPI_2_0_SLP_BUTTON              BIT5

+#define EFI_ACPI_2_0_FIX_RTC                 BIT6

+#define EFI_ACPI_2_0_RTC_S4                  BIT7

+#define EFI_ACPI_2_0_TMR_VAL_EXT             BIT8

+#define EFI_ACPI_2_0_DCK_CAP                 BIT9

+#define EFI_ACPI_2_0_RESET_REG_SUP           BIT10

+#define EFI_ACPI_2_0_SEALED_CASE             BIT11

+#define EFI_ACPI_2_0_HEADLESS                BIT12

+#define EFI_ACPI_2_0_CPU_SW_SLP              BIT13

+

+///

+/// Firmware ACPI Control Structure

+///

+typedef struct {

+  UINT32  Signature;

+  UINT32  Length;

+  UINT32  HardwareSignature;

+  UINT32  FirmwareWakingVector;

+  UINT32  GlobalLock;

+  UINT32  Flags;

+  UINT64  XFirmwareWakingVector;

+  UINT8   Version;

+  UINT8   Reserved[31];

+} EFI_ACPI_2_0_FIRMWARE_ACPI_CONTROL_STRUCTURE;

+

+///

+/// FACS Version (as defined in ACPI 2.0 spec.)

+///

+#define EFI_ACPI_2_0_FIRMWARE_ACPI_CONTROL_STRUCTURE_VERSION  0x01

+

+///

+/// Firmware Control Structure Feature Flags

+/// All other bits are reserved and must be set to 0.

+///

+#define EFI_ACPI_2_0_S4BIOS_F        BIT0

+

+///

+/// Multiple APIC Description Table header definition.  The rest of the table

+/// must be defined in a platform specific manner.

+///

+typedef struct {

+  EFI_ACPI_DESCRIPTION_HEADER Header;

+  UINT32                      LocalApicAddress;

+  UINT32                      Flags;

+} EFI_ACPI_2_0_MULTIPLE_APIC_DESCRIPTION_TABLE_HEADER;

+

+///

+/// MADT Revision (as defined in ACPI 2.0 spec.)

+///

+#define EFI_ACPI_2_0_MULTIPLE_APIC_DESCRIPTION_TABLE_REVISION 0x01

+

+///

+/// Multiple APIC Flags

+/// All other bits are reserved and must be set to 0.

+///

+#define EFI_ACPI_2_0_PCAT_COMPAT          BIT0

+

+//

+// Multiple APIC Description Table APIC structure types

+// All other values between 0x09 an 0xFF are reserved and

+// will be ignored by OSPM.

+//

+#define EFI_ACPI_2_0_PROCESSOR_LOCAL_APIC           0x00

+#define EFI_ACPI_2_0_IO_APIC                        0x01

+#define EFI_ACPI_2_0_INTERRUPT_SOURCE_OVERRIDE      0x02

+#define EFI_ACPI_2_0_NON_MASKABLE_INTERRUPT_SOURCE  0x03

+#define EFI_ACPI_2_0_LOCAL_APIC_NMI                 0x04

+#define EFI_ACPI_2_0_LOCAL_APIC_ADDRESS_OVERRIDE    0x05

+#define EFI_ACPI_2_0_IO_SAPIC                       0x06

+#define EFI_ACPI_2_0_PROCESSOR_LOCAL_SAPIC          0x07

+#define EFI_ACPI_2_0_PLATFORM_INTERRUPT_SOURCES     0x08

+

+//

+// APIC Structure Definitions

+//

+

+///

+/// Processor Local APIC Structure Definition

+///

+typedef struct {

+  UINT8   Type;

+  UINT8   Length;

+  UINT8   AcpiProcessorId;

+  UINT8   ApicId;

+  UINT32  Flags;

+} EFI_ACPI_2_0_PROCESSOR_LOCAL_APIC_STRUCTURE;

+

+///

+/// Local APIC Flags.  All other bits are reserved and must be 0.

+///

+#define EFI_ACPI_2_0_LOCAL_APIC_ENABLED         BIT0

+

+///

+/// IO APIC Structure

+///

+typedef struct {

+  UINT8   Type;

+  UINT8   Length;

+  UINT8   IoApicId;

+  UINT8   Reserved;

+  UINT32  IoApicAddress;

+  UINT32  GlobalSystemInterruptBase;

+} EFI_ACPI_2_0_IO_APIC_STRUCTURE;

+

+///

+/// Interrupt Source Override Structure

+///

+typedef struct {

+  UINT8   Type;

+  UINT8   Length;

+  UINT8   Bus;

+  UINT8   Source;

+  UINT32  GlobalSystemInterrupt;

+  UINT16  Flags;

+} EFI_ACPI_2_0_INTERRUPT_SOURCE_OVERRIDE_STRUCTURE;

+

+///

+/// Non-Maskable Interrupt Source Structure

+///

+typedef struct {

+  UINT8   Type;

+  UINT8   Length;

+  UINT16  Flags;

+  UINT32  GlobalSystemInterrupt;

+} EFI_ACPI_2_0_NON_MASKABLE_INTERRUPT_SOURCE_STRUCTURE;

+

+///

+/// Local APIC NMI Structure

+///

+typedef struct {

+  UINT8   Type;

+  UINT8   Length;

+  UINT8   AcpiProcessorId;

+  UINT16  Flags;

+  UINT8   LocalApicLint;

+} EFI_ACPI_2_0_LOCAL_APIC_NMI_STRUCTURE;

+

+///

+/// Local APIC Address Override Structure

+///

+typedef struct {

+  UINT8   Type;

+  UINT8   Length;

+  UINT16  Reserved;

+  UINT64  LocalApicAddress;

+} EFI_ACPI_2_0_LOCAL_APIC_ADDRESS_OVERRIDE_STRUCTURE;

+

+///

+/// IO SAPIC Structure

+///

+typedef struct {

+  UINT8   Type;

+  UINT8   Length;

+  UINT8   IoApicId;

+  UINT8   Reserved;

+  UINT32  GlobalSystemInterruptBase;

+  UINT64  IoSapicAddress;

+} EFI_ACPI_2_0_IO_SAPIC_STRUCTURE;

+

+///

+/// Local SAPIC Structure

+///

+typedef struct {

+  UINT8   Type;

+  UINT8   Length;

+  UINT8   AcpiProcessorId;

+  UINT8   LocalSapicId;

+  UINT8   LocalSapicEid;

+  UINT8   Reserved[3];

+  UINT32  Flags;

+} EFI_ACPI_2_0_PROCESSOR_LOCAL_SAPIC_STRUCTURE;

+

+///

+/// Platform Interrupt Sources Structure

+///

+typedef struct {

+  UINT8   Type;

+  UINT8   Length;

+  UINT16  Flags;

+  UINT8   InterruptType;

+  UINT8   ProcessorId;

+  UINT8   ProcessorEid;

+  UINT8   IoSapicVector;

+  UINT32  GlobalSystemInterrupt;

+  UINT32  Reserved;

+} EFI_ACPI_2_0_PLATFORM_INTERRUPT_SOURCES_STRUCTURE;

+

+///

+/// Smart Battery Description Table (SBST)

+///

+typedef struct {

+  EFI_ACPI_DESCRIPTION_HEADER Header;

+  UINT32                      WarningEnergyLevel;

+  UINT32                      LowEnergyLevel;

+  UINT32                      CriticalEnergyLevel;

+} EFI_ACPI_2_0_SMART_BATTERY_DESCRIPTION_TABLE;

+

+///

+/// SBST Version (as defined in ACPI 2.0 spec.)

+///

+#define EFI_ACPI_2_0_SMART_BATTERY_DESCRIPTION_TABLE_REVISION 0x01

+

+///

+/// Embedded Controller Boot Resources Table (ECDT)

+/// The table is followed by a null terminated ASCII string that contains

+/// a fully qualified reference to the name space object.

+///

+typedef struct {

+  EFI_ACPI_DESCRIPTION_HEADER             Header;

+  EFI_ACPI_2_0_GENERIC_ADDRESS_STRUCTURE  EcControl;

+  EFI_ACPI_2_0_GENERIC_ADDRESS_STRUCTURE  EcData;

+  UINT32                                  Uid;

+  UINT8                                   GpeBit;

+} EFI_ACPI_2_0_EMBEDDED_CONTROLLER_BOOT_RESOURCES_TABLE;

+

+///

+/// ECDT Version (as defined in ACPI 2.0 spec.)

+///

+#define EFI_ACPI_2_0_EMBEDDED_CONTROLLER_BOOT_RESOURCES_TABLE_REVISION  0x01

+

+//

+// Known table signatures

+//

+

+///

+/// "RSD PTR " Root System Description Pointer

+///

+#define EFI_ACPI_2_0_ROOT_SYSTEM_DESCRIPTION_POINTER_SIGNATURE  SIGNATURE_64('R', 'S', 'D', ' ', 'P', 'T', 'R', ' ')

+

+///

+/// "SPIC" Multiple SAPIC Description Table

+///

+/// BUGBUG: Don't know where this came from except SR870BN4 uses it.

+/// #define EFI_ACPI_2_0_MULTIPLE_SAPIC_DESCRIPTION_TABLE_SIGNATURE 0x43495053

+///

+#define EFI_ACPI_2_0_MULTIPLE_SAPIC_DESCRIPTION_TABLE_SIGNATURE  SIGNATURE_32('A', 'P', 'I', 'C')

+

+///

+/// "BOOT" MS Simple Boot Spec

+///

+#define EFI_ACPI_2_0_SIMPLE_BOOT_FLAG_TABLE_SIGNATURE  SIGNATURE_32('B', 'O', 'O', 'T')

+

+///

+/// "DBGP" MS Bebug Port Spec

+///

+#define EFI_ACPI_2_0_DEBUG_PORT_TABLE_SIGNATURE  SIGNATURE_32('D', 'B', 'G', 'P')

+

+///

+/// "DSDT" Differentiated System Description Table

+///

+#define EFI_ACPI_2_0_DIFFERENTIATED_SYSTEM_DESCRIPTION_TABLE_SIGNATURE  SIGNATURE_32('D', 'S', 'D', 'T')

+

+///

+/// "ECDT" Embedded Controller Boot Resources Table

+///

+#define EFI_ACPI_2_0_EMBEDDED_CONTROLLER_BOOT_RESOURCES_TABLE_SIGNATURE  SIGNATURE_32('E', 'C', 'D', 'T')

+

+///

+/// "ETDT" Event Timer Description Table

+///

+#define EFI_ACPI_2_0_EVENT_TIMER_DESCRIPTION_TABLE_SIGNATURE  SIGNATURE_32('E', 'T', 'D', 'T')

+

+///

+/// "FACS" Firmware ACPI Control Structure

+///

+#define EFI_ACPI_2_0_FIRMWARE_ACPI_CONTROL_STRUCTURE_SIGNATURE  SIGNATURE_32('F', 'A', 'C', 'S')

+

+///

+/// "FACP" Fixed ACPI Description Table

+///

+#define EFI_ACPI_2_0_FIXED_ACPI_DESCRIPTION_TABLE_SIGNATURE  SIGNATURE_32('F', 'A', 'C', 'P')

+

+///

+/// "APIC" Multiple APIC Description Table

+///

+#define EFI_ACPI_2_0_MULTIPLE_APIC_DESCRIPTION_TABLE_SIGNATURE  SIGNATURE_32('A', 'P', 'I', 'C')

+

+///

+/// "PSDT" Persistent System Description Table

+///

+#define EFI_ACPI_2_0_PERSISTENT_SYSTEM_DESCRIPTION_TABLE_SIGNATURE  SIGNATURE_32('P', 'S', 'D', 'T')

+

+///

+/// "RSDT" Root System Description Table

+///

+#define EFI_ACPI_2_0_ROOT_SYSTEM_DESCRIPTION_TABLE_SIGNATURE  SIGNATURE_32('R', 'S', 'D', 'T')

+

+///

+/// "SBST" Smart Battery Specification Table

+///

+#define EFI_ACPI_2_0_SMART_BATTERY_SPECIFICATION_TABLE_SIGNATURE  SIGNATURE_32('S', 'B', 'S', 'T')

+

+///

+/// "SLIT" System Locality Information Table

+///

+#define EFI_ACPI_2_0_SYSTEM_LOCALITY_INFORMATION_TABLE_SIGNATURE  SIGNATURE_32('S', 'L', 'I', 'T')

+

+///

+/// "SPCR" Serial Port Console Redirection Table

+///

+#define EFI_ACPI_2_0_SERIAL_PORT_CONSOLE_REDIRECTION_TABLE_SIGNATURE  SIGNATURE_32('S', 'P', 'C', 'R')

+

+///

+/// "SRAT" Static Resource Affinity Table

+///

+#define EFI_ACPI_2_0_STATIC_RESOURCE_AFFINITY_TABLE_SIGNATURE  SIGNATURE_32('S', 'R', 'A', 'T')

+

+///

+/// "SSDT" Secondary System Description Table

+///

+#define EFI_ACPI_2_0_SECONDARY_SYSTEM_DESCRIPTION_TABLE_SIGNATURE  SIGNATURE_32('S', 'S', 'D', 'T')

+

+///

+/// "SPMI" Server Platform Management Interface Table

+///

+#define EFI_ACPI_2_0_SERVER_PLATFORM_MANAGEMENT_INTERFACE_SIGNATURE  SIGNATURE_32('S', 'P', 'M', 'I')

+

+///

+/// "XSDT" Extended System Description Table

+///

+#define EFI_ACPI_2_0_EXTENDED_SYSTEM_DESCRIPTION_TABLE_SIGNATURE  SIGNATURE_32('X', 'S', 'D', 'T')

+

+///

+/// "MCFG" PCI Express Memory Mapped Configuration Space Base Address Description Table

+///

+#define EFI_ACPI_2_0_MEMORY_MAPPED_CONFIGURATION_BASE_ADDRESS_TABLE_SIGNATURE  SIGNATURE_32('M', 'C', 'F', 'G')

+

+#pragma pack()

+

+#endif

diff --git a/debugging_demo/memtest86+/efi/Include/IndustryStandard/Acpi30.h b/debugging_demo/memtest86+/efi/Include/IndustryStandard/Acpi30.h
new file mode 100644
index 0000000..6a7fc39
--- /dev/null
+++ b/debugging_demo/memtest86+/efi/Include/IndustryStandard/Acpi30.h
@@ -0,0 +1,723 @@
+/** @file

+  ACPI 3.0 definitions from the ACPI Specification Revision 3.0b October 10, 2006

+

+  Copyright (c) 2006 - 2018, Intel Corporation. All rights reserved.<BR>

+  SPDX-License-Identifier: BSD-2-Clause-Patent

+**/

+

+#ifndef _ACPI_3_0_H_

+#define _ACPI_3_0_H_

+

+#include <IndustryStandard/Acpi20.h>

+

+//

+// Define for Descriptor

+//

+#define ACPI_LARGE_EXTENDED_ADDRESS_SPACE_DESCRIPTOR_NAME    0x0B

+

+#define ACPI_EXTENDED_ADDRESS_SPACE_DESCRIPTOR    0x8B

+

+//

+// Ensure proper structure formats

+//

+#pragma pack(1)

+

+///

+/// Extended Address Space Descriptor

+///

+typedef PACKED struct {

+  ACPI_LARGE_RESOURCE_HEADER    Header;

+  UINT8                         ResType;

+  UINT8                         GenFlag;

+  UINT8                         SpecificFlag;

+  UINT8                         RevisionId;

+  UINT8                         Reserved;

+  UINT64                        AddrSpaceGranularity;

+  UINT64                        AddrRangeMin;

+  UINT64                        AddrRangeMax;

+  UINT64                        AddrTranslationOffset;

+  UINT64                        AddrLen;

+  UINT64                        TypeSpecificAttribute;

+} EFI_ACPI_EXTENDED_ADDRESS_SPACE_DESCRIPTOR;

+

+#pragma pack()

+

+//

+// Memory Type Specific Flags

+//

+#define EFI_ACPI_MEMORY_TYPE_SPECIFIC_ATTRIBUTES_UC  0x0000000000000001

+#define EFI_ACPI_MEMORY_TYPE_SPECIFIC_ATTRIBUTES_WC  0x0000000000000002

+#define EFI_ACPI_MEMORY_TYPE_SPECIFIC_ATTRIBUTES_WT  0x0000000000000004

+#define EFI_ACPI_MEMORY_TYPE_SPECIFIC_ATTRIBUTES_WB  0x0000000000000008

+#define EFI_ACPI_MEMORY_TYPE_SPECIFIC_ATTRIBUTES_UCE 0x0000000000000010

+#define EFI_ACPI_MEMORY_TYPE_SPECIFIC_ATTRIBUTES_NV  0x0000000000008000

+

+//

+// Ensure proper structure formats

+//

+#pragma pack(1)

+

+///

+/// ACPI 3.0 Generic Address Space definition

+///

+typedef struct {

+  UINT8   AddressSpaceId;

+  UINT8   RegisterBitWidth;

+  UINT8   RegisterBitOffset;

+  UINT8   AccessSize;

+  UINT64  Address;

+} EFI_ACPI_3_0_GENERIC_ADDRESS_STRUCTURE;

+

+//

+// Generic Address Space Address IDs

+//

+#define EFI_ACPI_3_0_SYSTEM_MEMORY              0

+#define EFI_ACPI_3_0_SYSTEM_IO                  1

+#define EFI_ACPI_3_0_PCI_CONFIGURATION_SPACE    2

+#define EFI_ACPI_3_0_EMBEDDED_CONTROLLER        3

+#define EFI_ACPI_3_0_SMBUS                      4

+#define EFI_ACPI_3_0_FUNCTIONAL_FIXED_HARDWARE  0x7F

+

+//

+// Generic Address Space Access Sizes

+//

+#define EFI_ACPI_3_0_UNDEFINED  0

+#define EFI_ACPI_3_0_BYTE       1

+#define EFI_ACPI_3_0_WORD       2

+#define EFI_ACPI_3_0_DWORD      3

+#define EFI_ACPI_3_0_QWORD      4

+

+//

+// ACPI 3.0 table structures

+//

+

+///

+/// Root System Description Pointer Structure

+///

+typedef struct {

+  UINT64  Signature;

+  UINT8   Checksum;

+  UINT8   OemId[6];

+  UINT8   Revision;

+  UINT32  RsdtAddress;

+  UINT32  Length;

+  UINT64  XsdtAddress;

+  UINT8   ExtendedChecksum;

+  UINT8   Reserved[3];

+} EFI_ACPI_3_0_ROOT_SYSTEM_DESCRIPTION_POINTER;

+

+///

+/// RSD_PTR Revision (as defined in ACPI 3.0b spec.)

+///

+#define EFI_ACPI_3_0_ROOT_SYSTEM_DESCRIPTION_POINTER_REVISION 0x02  ///< ACPISpec (Revision 3.0b) says current value is 2

+

+///

+/// Common table header, this prefaces all ACPI tables, including FACS, but

+/// excluding the RSD PTR structure

+///

+typedef struct {

+  UINT32  Signature;

+  UINT32  Length;

+} EFI_ACPI_3_0_COMMON_HEADER;

+

+//

+// Root System Description Table

+// No definition needed as it is a common description table header, the same with

+// EFI_ACPI_DESCRIPTION_HEADER, followed by a variable number of UINT32 table pointers.

+//

+

+///

+/// RSDT Revision (as defined in ACPI 3.0 spec.)

+///

+#define EFI_ACPI_3_0_ROOT_SYSTEM_DESCRIPTION_TABLE_REVISION 0x01

+

+//

+// Extended System Description Table

+// No definition needed as it is a common description table header, the same with

+// EFI_ACPI_DESCRIPTION_HEADER, followed by a variable number of UINT64 table pointers.

+//

+

+///

+/// XSDT Revision (as defined in ACPI 3.0 spec.)

+///

+#define EFI_ACPI_3_0_EXTENDED_SYSTEM_DESCRIPTION_TABLE_REVISION 0x01

+

+///

+/// Fixed ACPI Description Table Structure (FADT)

+///

+typedef struct {

+  EFI_ACPI_DESCRIPTION_HEADER             Header;

+  UINT32                                  FirmwareCtrl;

+  UINT32                                  Dsdt;

+  UINT8                                   Reserved0;

+  UINT8                                   PreferredPmProfile;

+  UINT16                                  SciInt;

+  UINT32                                  SmiCmd;

+  UINT8                                   AcpiEnable;

+  UINT8                                   AcpiDisable;

+  UINT8                                   S4BiosReq;

+  UINT8                                   PstateCnt;

+  UINT32                                  Pm1aEvtBlk;

+  UINT32                                  Pm1bEvtBlk;

+  UINT32                                  Pm1aCntBlk;

+  UINT32                                  Pm1bCntBlk;

+  UINT32                                  Pm2CntBlk;

+  UINT32                                  PmTmrBlk;

+  UINT32                                  Gpe0Blk;

+  UINT32                                  Gpe1Blk;

+  UINT8                                   Pm1EvtLen;

+  UINT8                                   Pm1CntLen;

+  UINT8                                   Pm2CntLen;

+  UINT8                                   PmTmrLen;

+  UINT8                                   Gpe0BlkLen;

+  UINT8                                   Gpe1BlkLen;

+  UINT8                                   Gpe1Base;

+  UINT8                                   CstCnt;

+  UINT16                                  PLvl2Lat;

+  UINT16                                  PLvl3Lat;

+  UINT16                                  FlushSize;

+  UINT16                                  FlushStride;

+  UINT8                                   DutyOffset;

+  UINT8                                   DutyWidth;

+  UINT8                                   DayAlrm;

+  UINT8                                   MonAlrm;

+  UINT8                                   Century;

+  UINT16                                  IaPcBootArch;

+  UINT8                                   Reserved1;

+  UINT32                                  Flags;

+  EFI_ACPI_3_0_GENERIC_ADDRESS_STRUCTURE  ResetReg;

+  UINT8                                   ResetValue;

+  UINT8                                   Reserved2[3];

+  UINT64                                  XFirmwareCtrl;

+  UINT64                                  XDsdt;

+  EFI_ACPI_3_0_GENERIC_ADDRESS_STRUCTURE  XPm1aEvtBlk;

+  EFI_ACPI_3_0_GENERIC_ADDRESS_STRUCTURE  XPm1bEvtBlk;

+  EFI_ACPI_3_0_GENERIC_ADDRESS_STRUCTURE  XPm1aCntBlk;

+  EFI_ACPI_3_0_GENERIC_ADDRESS_STRUCTURE  XPm1bCntBlk;

+  EFI_ACPI_3_0_GENERIC_ADDRESS_STRUCTURE  XPm2CntBlk;

+  EFI_ACPI_3_0_GENERIC_ADDRESS_STRUCTURE  XPmTmrBlk;

+  EFI_ACPI_3_0_GENERIC_ADDRESS_STRUCTURE  XGpe0Blk;

+  EFI_ACPI_3_0_GENERIC_ADDRESS_STRUCTURE  XGpe1Blk;

+} EFI_ACPI_3_0_FIXED_ACPI_DESCRIPTION_TABLE;

+

+///

+/// FADT Version (as defined in ACPI 3.0 spec.)

+///

+#define EFI_ACPI_3_0_FIXED_ACPI_DESCRIPTION_TABLE_REVISION  0x04

+

+//

+// Fixed ACPI Description Table Preferred Power Management Profile

+//

+#define EFI_ACPI_3_0_PM_PROFILE_UNSPECIFIED         0

+#define EFI_ACPI_3_0_PM_PROFILE_DESKTOP             1

+#define EFI_ACPI_3_0_PM_PROFILE_MOBILE              2

+#define EFI_ACPI_3_0_PM_PROFILE_WORKSTATION         3

+#define EFI_ACPI_3_0_PM_PROFILE_ENTERPRISE_SERVER   4

+#define EFI_ACPI_3_0_PM_PROFILE_SOHO_SERVER         5

+#define EFI_ACPI_3_0_PM_PROFILE_APPLIANCE_PC        6

+#define EFI_ACPI_3_0_PM_PROFILE_PERFORMANCE_SERVER  7

+

+//

+// Fixed ACPI Description Table Boot Architecture Flags

+// All other bits are reserved and must be set to 0.

+//

+#define EFI_ACPI_3_0_LEGACY_DEVICES              BIT0

+#define EFI_ACPI_3_0_8042                        BIT1

+#define EFI_ACPI_3_0_VGA_NOT_PRESENT             BIT2

+#define EFI_ACPI_3_0_MSI_NOT_SUPPORTED           BIT3

+#define EFI_ACPI_3_0_PCIE_ASPM_CONTROLS          BIT4

+

+//

+// Fixed ACPI Description Table Fixed Feature Flags

+// All other bits are reserved and must be set to 0.

+//

+#define EFI_ACPI_3_0_WBINVD                                 BIT0

+#define EFI_ACPI_3_0_WBINVD_FLUSH                           BIT1

+#define EFI_ACPI_3_0_PROC_C1                                BIT2

+#define EFI_ACPI_3_0_P_LVL2_UP                              BIT3

+#define EFI_ACPI_3_0_PWR_BUTTON                             BIT4

+#define EFI_ACPI_3_0_SLP_BUTTON                             BIT5

+#define EFI_ACPI_3_0_FIX_RTC                                BIT6

+#define EFI_ACPI_3_0_RTC_S4                                 BIT7

+#define EFI_ACPI_3_0_TMR_VAL_EXT                            BIT8

+#define EFI_ACPI_3_0_DCK_CAP                                BIT9

+#define EFI_ACPI_3_0_RESET_REG_SUP                          BIT10

+#define EFI_ACPI_3_0_SEALED_CASE                            BIT11

+#define EFI_ACPI_3_0_HEADLESS                               BIT12

+#define EFI_ACPI_3_0_CPU_SW_SLP                             BIT13

+#define EFI_ACPI_3_0_PCI_EXP_WAK                            BIT14

+#define EFI_ACPI_3_0_USE_PLATFORM_CLOCK                     BIT15

+#define EFI_ACPI_3_0_S4_RTC_STS_VALID                       BIT16

+#define EFI_ACPI_3_0_REMOTE_POWER_ON_CAPABLE                BIT17

+#define EFI_ACPI_3_0_FORCE_APIC_CLUSTER_MODEL               BIT18

+#define EFI_ACPI_3_0_FORCE_APIC_PHYSICAL_DESTINATION_MODE   BIT19

+

+///

+/// Firmware ACPI Control Structure

+///

+typedef struct {

+  UINT32  Signature;

+  UINT32  Length;

+  UINT32  HardwareSignature;

+  UINT32  FirmwareWakingVector;

+  UINT32  GlobalLock;

+  UINT32  Flags;

+  UINT64  XFirmwareWakingVector;

+  UINT8   Version;

+  UINT8   Reserved[31];

+} EFI_ACPI_3_0_FIRMWARE_ACPI_CONTROL_STRUCTURE;

+

+///

+/// FACS Version (as defined in ACPI 3.0 spec.)

+///

+#define EFI_ACPI_3_0_FIRMWARE_ACPI_CONTROL_STRUCTURE_VERSION  0x01

+

+///

+/// Firmware Control Structure Feature Flags

+/// All other bits are reserved and must be set to 0.

+///

+#define EFI_ACPI_3_0_S4BIOS_F       BIT0

+

+//

+// Differentiated System Description Table,

+// Secondary System Description Table

+// and Persistent System Description Table,

+// no definition needed as they are common description table header, the same with

+// EFI_ACPI_DESCRIPTION_HEADER, followed by a definition block.

+//

+#define EFI_ACPI_3_0_DIFFERENTIATED_SYSTEM_DESCRIPTION_TABLE_REVISION   0x02

+#define EFI_ACPI_3_0_SECONDARY_SYSTEM_DESCRIPTION_TABLE_REVISION        0x02

+

+///

+/// Multiple APIC Description Table header definition.  The rest of the table

+/// must be defined in a platform specific manner.

+///

+typedef struct {

+  EFI_ACPI_DESCRIPTION_HEADER Header;

+  UINT32                      LocalApicAddress;

+  UINT32                      Flags;

+} EFI_ACPI_3_0_MULTIPLE_APIC_DESCRIPTION_TABLE_HEADER;

+

+///

+/// MADT Revision (as defined in ACPI 3.0 spec.)

+///

+#define EFI_ACPI_3_0_MULTIPLE_APIC_DESCRIPTION_TABLE_REVISION 0x02

+

+///

+/// Multiple APIC Flags

+/// All other bits are reserved and must be set to 0.

+///

+#define EFI_ACPI_3_0_PCAT_COMPAT         BIT0

+

+//

+// Multiple APIC Description Table APIC structure types

+// All other values between 0x09 an 0xFF are reserved and

+// will be ignored by OSPM.

+//

+#define EFI_ACPI_3_0_PROCESSOR_LOCAL_APIC           0x00

+#define EFI_ACPI_3_0_IO_APIC                        0x01

+#define EFI_ACPI_3_0_INTERRUPT_SOURCE_OVERRIDE      0x02

+#define EFI_ACPI_3_0_NON_MASKABLE_INTERRUPT_SOURCE  0x03

+#define EFI_ACPI_3_0_LOCAL_APIC_NMI                 0x04

+#define EFI_ACPI_3_0_LOCAL_APIC_ADDRESS_OVERRIDE    0x05

+#define EFI_ACPI_3_0_IO_SAPIC                       0x06

+#define EFI_ACPI_3_0_LOCAL_SAPIC                    0x07

+#define EFI_ACPI_3_0_PLATFORM_INTERRUPT_SOURCES     0x08

+

+//

+// APIC Structure Definitions

+//

+

+///

+/// Processor Local APIC Structure Definition

+///

+typedef struct {

+  UINT8   Type;

+  UINT8   Length;

+  UINT8   AcpiProcessorId;

+  UINT8   ApicId;

+  UINT32  Flags;

+} EFI_ACPI_3_0_PROCESSOR_LOCAL_APIC_STRUCTURE;

+

+///

+/// Local APIC Flags.  All other bits are reserved and must be 0.

+///

+#define EFI_ACPI_3_0_LOCAL_APIC_ENABLED        BIT0

+

+///

+/// IO APIC Structure

+///

+typedef struct {

+  UINT8   Type;

+  UINT8   Length;

+  UINT8   IoApicId;

+  UINT8   Reserved;

+  UINT32  IoApicAddress;

+  UINT32  GlobalSystemInterruptBase;

+} EFI_ACPI_3_0_IO_APIC_STRUCTURE;

+

+///

+/// Interrupt Source Override Structure

+///

+typedef struct {

+  UINT8   Type;

+  UINT8   Length;

+  UINT8   Bus;

+  UINT8   Source;

+  UINT32  GlobalSystemInterrupt;

+  UINT16  Flags;

+} EFI_ACPI_3_0_INTERRUPT_SOURCE_OVERRIDE_STRUCTURE;

+

+///

+/// Platform Interrupt Sources Structure Definition

+///

+typedef struct {

+  UINT8   Type;

+  UINT8   Length;

+  UINT16  Flags;

+  UINT8   InterruptType;

+  UINT8   ProcessorId;

+  UINT8   ProcessorEid;

+  UINT8   IoSapicVector;

+  UINT32  GlobalSystemInterrupt;

+  UINT32  PlatformInterruptSourceFlags;

+  UINT8   CpeiProcessorOverride;

+  UINT8   Reserved[31];

+} EFI_ACPI_3_0_PLATFORM_INTERRUPT_APIC_STRUCTURE;

+

+//

+// MPS INTI flags.

+// All other bits are reserved and must be set to 0.

+//

+#define EFI_ACPI_3_0_POLARITY      (3 << 0)

+#define EFI_ACPI_3_0_TRIGGER_MODE  (3 << 2)

+

+///

+/// Non-Maskable Interrupt Source Structure

+///

+typedef struct {

+  UINT8   Type;

+  UINT8   Length;

+  UINT16  Flags;

+  UINT32  GlobalSystemInterrupt;

+} EFI_ACPI_3_0_NON_MASKABLE_INTERRUPT_SOURCE_STRUCTURE;

+

+///

+/// Local APIC NMI Structure

+///

+typedef struct {

+  UINT8   Type;

+  UINT8   Length;

+  UINT8   AcpiProcessorId;

+  UINT16  Flags;

+  UINT8   LocalApicLint;

+} EFI_ACPI_3_0_LOCAL_APIC_NMI_STRUCTURE;

+

+///

+/// Local APIC Address Override Structure

+///

+typedef struct {

+  UINT8   Type;

+  UINT8   Length;

+  UINT16  Reserved;

+  UINT64  LocalApicAddress;

+} EFI_ACPI_3_0_LOCAL_APIC_ADDRESS_OVERRIDE_STRUCTURE;

+

+///

+/// IO SAPIC Structure

+///

+typedef struct {

+  UINT8   Type;

+  UINT8   Length;

+  UINT8   IoApicId;

+  UINT8   Reserved;

+  UINT32  GlobalSystemInterruptBase;

+  UINT64  IoSapicAddress;

+} EFI_ACPI_3_0_IO_SAPIC_STRUCTURE;

+

+///

+/// Local SAPIC Structure

+/// This struct followed by a null-terminated ASCII string - ACPI Processor UID String

+///

+typedef struct {

+  UINT8   Type;

+  UINT8   Length;

+  UINT8   AcpiProcessorId;

+  UINT8   LocalSapicId;

+  UINT8   LocalSapicEid;

+  UINT8   Reserved[3];

+  UINT32  Flags;

+  UINT32  ACPIProcessorUIDValue;

+} EFI_ACPI_3_0_PROCESSOR_LOCAL_SAPIC_STRUCTURE;

+

+///

+/// Platform Interrupt Sources Structure

+///

+typedef struct {

+  UINT8   Type;

+  UINT8   Length;

+  UINT16  Flags;

+  UINT8   InterruptType;

+  UINT8   ProcessorId;

+  UINT8   ProcessorEid;

+  UINT8   IoSapicVector;

+  UINT32  GlobalSystemInterrupt;

+  UINT32  PlatformInterruptSourceFlags;

+} EFI_ACPI_3_0_PLATFORM_INTERRUPT_SOURCES_STRUCTURE;

+

+///

+/// Platform Interrupt Source Flags.

+/// All other bits are reserved and must be set to 0.

+///

+#define EFI_ACPI_3_0_CPEI_PROCESSOR_OVERRIDE          BIT0

+

+///

+/// Smart Battery Description Table (SBST)

+///

+typedef struct {

+  EFI_ACPI_DESCRIPTION_HEADER Header;

+  UINT32                      WarningEnergyLevel;

+  UINT32                      LowEnergyLevel;

+  UINT32                      CriticalEnergyLevel;

+} EFI_ACPI_3_0_SMART_BATTERY_DESCRIPTION_TABLE;

+

+///

+/// SBST Version (as defined in ACPI 3.0 spec.)

+///

+#define EFI_ACPI_3_0_SMART_BATTERY_DESCRIPTION_TABLE_REVISION 0x01

+

+///

+/// Embedded Controller Boot Resources Table (ECDT)

+/// The table is followed by a null terminated ASCII string that contains

+/// a fully qualified reference to the name space object.

+///

+typedef struct {

+  EFI_ACPI_DESCRIPTION_HEADER             Header;

+  EFI_ACPI_3_0_GENERIC_ADDRESS_STRUCTURE  EcControl;

+  EFI_ACPI_3_0_GENERIC_ADDRESS_STRUCTURE  EcData;

+  UINT32                                  Uid;

+  UINT8                                   GpeBit;

+} EFI_ACPI_3_0_EMBEDDED_CONTROLLER_BOOT_RESOURCES_TABLE;

+

+///

+/// ECDT Version (as defined in ACPI 3.0 spec.)

+///

+#define EFI_ACPI_3_0_EMBEDDED_CONTROLLER_BOOT_RESOURCES_TABLE_REVISION  0x01

+

+///

+/// System Resource Affinity Table (SRAT.  The rest of the table

+/// must be defined in a platform specific manner.

+///

+typedef struct {

+  EFI_ACPI_DESCRIPTION_HEADER Header;

+  UINT32                      Reserved1;  ///< Must be set to 1

+  UINT64                      Reserved2;

+} EFI_ACPI_3_0_SYSTEM_RESOURCE_AFFINITY_TABLE_HEADER;

+

+///

+/// SRAT Version (as defined in ACPI 3.0 spec.)

+///

+#define EFI_ACPI_3_0_SYSTEM_RESOURCE_AFFINITY_TABLE_REVISION  0x02

+

+//

+// SRAT structure types.

+// All other values between 0x02 an 0xFF are reserved and

+// will be ignored by OSPM.

+//

+#define EFI_ACPI_3_0_PROCESSOR_LOCAL_APIC_SAPIC_AFFINITY  0x00

+#define EFI_ACPI_3_0_MEMORY_AFFINITY                      0x01

+

+///

+/// Processor Local APIC/SAPIC Affinity Structure Definition

+///

+typedef struct {

+  UINT8   Type;

+  UINT8   Length;

+  UINT8   ProximityDomain7To0;

+  UINT8   ApicId;

+  UINT32  Flags;

+  UINT8   LocalSapicEid;

+  UINT8   ProximityDomain31To8[3];

+  UINT8   Reserved[4];

+} EFI_ACPI_3_0_PROCESSOR_LOCAL_APIC_SAPIC_AFFINITY_STRUCTURE;

+

+///

+/// Local APIC/SAPIC Flags.  All other bits are reserved and must be 0.

+///

+#define EFI_ACPI_3_0_PROCESSOR_LOCAL_APIC_SAPIC_ENABLED (1 << 0)

+

+///

+/// Memory Affinity Structure Definition

+///

+typedef struct {

+  UINT8   Type;

+  UINT8   Length;

+  UINT32  ProximityDomain;

+  UINT16  Reserved1;

+  UINT32  AddressBaseLow;

+  UINT32  AddressBaseHigh;

+  UINT32  LengthLow;

+  UINT32  LengthHigh;

+  UINT32  Reserved2;

+  UINT32  Flags;

+  UINT64  Reserved3;

+} EFI_ACPI_3_0_MEMORY_AFFINITY_STRUCTURE;

+

+//

+// Memory Flags.  All other bits are reserved and must be 0.

+//

+#define EFI_ACPI_3_0_MEMORY_ENABLED       (1 << 0)

+#define EFI_ACPI_3_0_MEMORY_HOT_PLUGGABLE (1 << 1)

+#define EFI_ACPI_3_0_MEMORY_NONVOLATILE   (1 << 2)

+

+///

+/// System Locality Distance Information Table (SLIT).

+/// The rest of the table is a matrix.

+///

+typedef struct {

+  EFI_ACPI_DESCRIPTION_HEADER Header;

+  UINT64                      NumberOfSystemLocalities;

+} EFI_ACPI_3_0_SYSTEM_LOCALITY_DISTANCE_INFORMATION_TABLE_HEADER;

+

+///

+/// SLIT Version (as defined in ACPI 3.0 spec.)

+///

+#define EFI_ACPI_3_0_SYSTEM_LOCALITY_DISTANCE_INFORMATION_TABLE_REVISION  0x01

+

+//

+// Known table signatures

+//

+

+///

+/// "RSD PTR " Root System Description Pointer

+///

+#define EFI_ACPI_3_0_ROOT_SYSTEM_DESCRIPTION_POINTER_SIGNATURE  SIGNATURE_64('R', 'S', 'D', ' ', 'P', 'T', 'R', ' ')

+

+///

+/// "APIC" Multiple APIC Description Table

+///

+#define EFI_ACPI_3_0_MULTIPLE_APIC_DESCRIPTION_TABLE_SIGNATURE  SIGNATURE_32('A', 'P', 'I', 'C')

+

+///

+/// "DSDT" Differentiated System Description Table

+///

+#define EFI_ACPI_3_0_DIFFERENTIATED_SYSTEM_DESCRIPTION_TABLE_SIGNATURE  SIGNATURE_32('D', 'S', 'D', 'T')

+

+///

+/// "ECDT" Embedded Controller Boot Resources Table

+///

+#define EFI_ACPI_3_0_EMBEDDED_CONTROLLER_BOOT_RESOURCES_TABLE_SIGNATURE  SIGNATURE_32('E', 'C', 'D', 'T')

+

+///

+/// "FACP" Fixed ACPI Description Table

+///

+#define EFI_ACPI_3_0_FIXED_ACPI_DESCRIPTION_TABLE_SIGNATURE  SIGNATURE_32('F', 'A', 'C', 'P')

+

+///

+/// "FACS" Firmware ACPI Control Structure

+///

+#define EFI_ACPI_3_0_FIRMWARE_ACPI_CONTROL_STRUCTURE_SIGNATURE  SIGNATURE_32('F', 'A', 'C', 'S')

+

+///

+/// "PSDT" Persistent System Description Table

+///

+#define EFI_ACPI_3_0_PERSISTENT_SYSTEM_DESCRIPTION_TABLE_SIGNATURE  SIGNATURE_32('P', 'S', 'D', 'T')

+

+///

+/// "RSDT" Root System Description Table

+///

+#define EFI_ACPI_3_0_ROOT_SYSTEM_DESCRIPTION_TABLE_SIGNATURE  SIGNATURE_32('R', 'S', 'D', 'T')

+

+///

+/// "SBST" Smart Battery Specification Table

+///

+#define EFI_ACPI_3_0_SMART_BATTERY_SPECIFICATION_TABLE_SIGNATURE  SIGNATURE_32('S', 'B', 'S', 'T')

+

+///

+/// "SLIT" System Locality Information Table

+///

+#define EFI_ACPI_3_0_SYSTEM_LOCALITY_INFORMATION_TABLE_SIGNATURE  SIGNATURE_32('S', 'L', 'I', 'T')

+

+///

+/// "SRAT" System Resource Affinity Table

+///

+#define EFI_ACPI_3_0_SYSTEM_RESOURCE_AFFINITY_TABLE_SIGNATURE  SIGNATURE_32('S', 'R', 'A', 'T')

+

+///

+/// "SSDT" Secondary System Description Table

+///

+#define EFI_ACPI_3_0_SECONDARY_SYSTEM_DESCRIPTION_TABLE_SIGNATURE  SIGNATURE_32('S', 'S', 'D', 'T')

+

+///

+/// "XSDT" Extended System Description Table

+///

+#define EFI_ACPI_3_0_EXTENDED_SYSTEM_DESCRIPTION_TABLE_SIGNATURE  SIGNATURE_32('X', 'S', 'D', 'T')

+

+///

+/// "BOOT" MS Simple Boot Spec

+///

+#define EFI_ACPI_3_0_SIMPLE_BOOT_FLAG_TABLE_SIGNATURE  SIGNATURE_32('B', 'O', 'O', 'T')

+

+///

+/// "CPEP" Corrected Platform Error Polling Table

+///

+#define EFI_ACPI_3_0_CORRECTED_PLATFORM_ERROR_POLLING_TABLE_SIGNATURE  SIGNATURE_32('C', 'P', 'E', 'P')

+

+///

+/// "DBGP" MS Debug Port Spec

+///

+#define EFI_ACPI_3_0_DEBUG_PORT_TABLE_SIGNATURE  SIGNATURE_32('D', 'B', 'G', 'P')

+

+///

+/// "ETDT" Event Timer Description Table

+///

+#define EFI_ACPI_3_0_EVENT_TIMER_DESCRIPTION_TABLE_SIGNATURE  SIGNATURE_32('E', 'T', 'D', 'T')

+

+///

+/// "HPET" IA-PC High Precision Event Timer Table

+///

+#define EFI_ACPI_3_0_HIGH_PRECISION_EVENT_TIMER_TABLE_SIGNATURE  SIGNATURE_32('H', 'P', 'E', 'T')

+

+///

+/// "MCFG" PCI Express Memory Mapped Configuration Space Base Address Description Table

+///

+#define EFI_ACPI_3_0_PCI_EXPRESS_MEMORY_MAPPED_CONFIGURATION_SPACE_BASE_ADDRESS_DESCRIPTION_TABLE_SIGNATURE  SIGNATURE_32('M', 'C', 'F', 'G')

+

+///

+/// "SPCR" Serial Port Console Redirection Table

+///

+#define EFI_ACPI_3_0_SERIAL_PORT_CONSOLE_REDIRECTION_TABLE_SIGNATURE  SIGNATURE_32('S', 'P', 'C', 'R')

+

+///

+/// "SPMI" Server Platform Management Interface Table

+///

+#define EFI_ACPI_3_0_SERVER_PLATFORM_MANAGEMENT_INTERFACE_TABLE_SIGNATURE  SIGNATURE_32('S', 'P', 'M', 'I')

+

+///

+/// "TCPA" Trusted Computing Platform Alliance Capabilities Table

+///

+#define EFI_ACPI_3_0_TRUSTED_COMPUTING_PLATFORM_ALLIANCE_CAPABILITIES_TABLE_SIGNATURE  SIGNATURE_32('T', 'C', 'P', 'A')

+

+///

+/// "WDRT" Watchdog Resource Table

+///

+#define EFI_ACPI_3_0_WATCHDOG_RESOURCE_TABLE_SIGNATURE  SIGNATURE_32('W', 'D', 'R', 'T')

+

+///

+/// "WDAT" Watchdog Action Table

+///

+#define EFI_ACPI_3_0_WATCHDOG_ACTION_TABLE_SIGNATURE  SIGNATURE_32('W', 'D', 'A', 'T')

+

+///

+/// "WSPT" Windows Specific Properties Table

+///

+#define EFI_ACPI_3_0_WINDOWS_SPECIFIC_PROPERTIES_TABLE_SIGNATURE  SIGNATURE_32('W', 'S', 'P', 'T')

+

+///

+/// "iBFT" iSCSI Boot Firmware Table

+///

+#define EFI_ACPI_3_0_ISCSI_BOOT_FIRMWARE_TABLE_SIGNATURE  SIGNATURE_32('i', 'B', 'F', 'T')

+

+#pragma pack()

+

+#endif

diff --git a/debugging_demo/memtest86+/efi/Include/IndustryStandard/Acpi40.h b/debugging_demo/memtest86+/efi/Include/IndustryStandard/Acpi40.h
new file mode 100644
index 0000000..c03ba7a
--- /dev/null
+++ b/debugging_demo/memtest86+/efi/Include/IndustryStandard/Acpi40.h
@@ -0,0 +1,1303 @@
+/** @file

+  ACPI 4.0 definitions from the ACPI Specification Revision 4.0a April 5, 2010

+

+  Copyright (c) 2010 - 2018, Intel Corporation. All rights reserved.<BR>

+  SPDX-License-Identifier: BSD-2-Clause-Patent

+**/

+

+#ifndef _ACPI_4_0_H_

+#define _ACPI_4_0_H_

+

+#include <IndustryStandard/Acpi30.h>

+

+//

+// Ensure proper structure formats

+//

+#pragma pack(1)

+

+///

+/// ACPI 4.0 Generic Address Space definition

+///

+typedef struct {

+  UINT8   AddressSpaceId;

+  UINT8   RegisterBitWidth;

+  UINT8   RegisterBitOffset;

+  UINT8   AccessSize;

+  UINT64  Address;

+} EFI_ACPI_4_0_GENERIC_ADDRESS_STRUCTURE;

+

+//

+// Generic Address Space Address IDs

+//

+#define EFI_ACPI_4_0_SYSTEM_MEMORY              0

+#define EFI_ACPI_4_0_SYSTEM_IO                  1

+#define EFI_ACPI_4_0_PCI_CONFIGURATION_SPACE    2

+#define EFI_ACPI_4_0_EMBEDDED_CONTROLLER        3

+#define EFI_ACPI_4_0_SMBUS                      4

+#define EFI_ACPI_4_0_FUNCTIONAL_FIXED_HARDWARE  0x7F

+

+//

+// Generic Address Space Access Sizes

+//

+#define EFI_ACPI_4_0_UNDEFINED  0

+#define EFI_ACPI_4_0_BYTE       1

+#define EFI_ACPI_4_0_WORD       2

+#define EFI_ACPI_4_0_DWORD      3

+#define EFI_ACPI_4_0_QWORD      4

+

+//

+// ACPI 4.0 table structures

+//

+

+///

+/// Root System Description Pointer Structure

+///

+typedef struct {

+  UINT64  Signature;

+  UINT8   Checksum;

+  UINT8   OemId[6];

+  UINT8   Revision;

+  UINT32  RsdtAddress;

+  UINT32  Length;

+  UINT64  XsdtAddress;

+  UINT8   ExtendedChecksum;

+  UINT8   Reserved[3];

+} EFI_ACPI_4_0_ROOT_SYSTEM_DESCRIPTION_POINTER;

+

+///

+/// RSD_PTR Revision (as defined in ACPI 4.0b spec.)

+///

+#define EFI_ACPI_4_0_ROOT_SYSTEM_DESCRIPTION_POINTER_REVISION 0x02  ///< ACPISpec (Revision 4.0a) says current value is 2

+

+///

+/// Common table header, this prefaces all ACPI tables, including FACS, but

+/// excluding the RSD PTR structure

+///

+typedef struct {

+  UINT32  Signature;

+  UINT32  Length;

+} EFI_ACPI_4_0_COMMON_HEADER;

+

+//

+// Root System Description Table

+// No definition needed as it is a common description table header, the same with

+// EFI_ACPI_DESCRIPTION_HEADER, followed by a variable number of UINT32 table pointers.

+//

+

+///

+/// RSDT Revision (as defined in ACPI 4.0 spec.)

+///

+#define EFI_ACPI_4_0_ROOT_SYSTEM_DESCRIPTION_TABLE_REVISION 0x01

+

+//

+// Extended System Description Table

+// No definition needed as it is a common description table header, the same with

+// EFI_ACPI_DESCRIPTION_HEADER, followed by a variable number of UINT64 table pointers.

+//

+

+///

+/// XSDT Revision (as defined in ACPI 4.0 spec.)

+///

+#define EFI_ACPI_4_0_EXTENDED_SYSTEM_DESCRIPTION_TABLE_REVISION 0x01

+

+///

+/// Fixed ACPI Description Table Structure (FADT)

+///

+typedef struct {

+  EFI_ACPI_DESCRIPTION_HEADER             Header;

+  UINT32                                  FirmwareCtrl;

+  UINT32                                  Dsdt;

+  UINT8                                   Reserved0;

+  UINT8                                   PreferredPmProfile;

+  UINT16                                  SciInt;

+  UINT32                                  SmiCmd;

+  UINT8                                   AcpiEnable;

+  UINT8                                   AcpiDisable;

+  UINT8                                   S4BiosReq;

+  UINT8                                   PstateCnt;

+  UINT32                                  Pm1aEvtBlk;

+  UINT32                                  Pm1bEvtBlk;

+  UINT32                                  Pm1aCntBlk;

+  UINT32                                  Pm1bCntBlk;

+  UINT32                                  Pm2CntBlk;

+  UINT32                                  PmTmrBlk;

+  UINT32                                  Gpe0Blk;

+  UINT32                                  Gpe1Blk;

+  UINT8                                   Pm1EvtLen;

+  UINT8                                   Pm1CntLen;

+  UINT8                                   Pm2CntLen;

+  UINT8                                   PmTmrLen;

+  UINT8                                   Gpe0BlkLen;

+  UINT8                                   Gpe1BlkLen;

+  UINT8                                   Gpe1Base;

+  UINT8                                   CstCnt;

+  UINT16                                  PLvl2Lat;

+  UINT16                                  PLvl3Lat;

+  UINT16                                  FlushSize;

+  UINT16                                  FlushStride;

+  UINT8                                   DutyOffset;

+  UINT8                                   DutyWidth;

+  UINT8                                   DayAlrm;

+  UINT8                                   MonAlrm;

+  UINT8                                   Century;

+  UINT16                                  IaPcBootArch;

+  UINT8                                   Reserved1;

+  UINT32                                  Flags;

+  EFI_ACPI_4_0_GENERIC_ADDRESS_STRUCTURE  ResetReg;

+  UINT8                                   ResetValue;

+  UINT8                                   Reserved2[3];

+  UINT64                                  XFirmwareCtrl;

+  UINT64                                  XDsdt;

+  EFI_ACPI_4_0_GENERIC_ADDRESS_STRUCTURE  XPm1aEvtBlk;

+  EFI_ACPI_4_0_GENERIC_ADDRESS_STRUCTURE  XPm1bEvtBlk;

+  EFI_ACPI_4_0_GENERIC_ADDRESS_STRUCTURE  XPm1aCntBlk;

+  EFI_ACPI_4_0_GENERIC_ADDRESS_STRUCTURE  XPm1bCntBlk;

+  EFI_ACPI_4_0_GENERIC_ADDRESS_STRUCTURE  XPm2CntBlk;

+  EFI_ACPI_4_0_GENERIC_ADDRESS_STRUCTURE  XPmTmrBlk;

+  EFI_ACPI_4_0_GENERIC_ADDRESS_STRUCTURE  XGpe0Blk;

+  EFI_ACPI_4_0_GENERIC_ADDRESS_STRUCTURE  XGpe1Blk;

+} EFI_ACPI_4_0_FIXED_ACPI_DESCRIPTION_TABLE;

+

+///

+/// FADT Version (as defined in ACPI 4.0 spec.)

+///

+#define EFI_ACPI_4_0_FIXED_ACPI_DESCRIPTION_TABLE_REVISION  0x04

+

+//

+// Fixed ACPI Description Table Preferred Power Management Profile

+//

+#define EFI_ACPI_4_0_PM_PROFILE_UNSPECIFIED         0

+#define EFI_ACPI_4_0_PM_PROFILE_DESKTOP             1

+#define EFI_ACPI_4_0_PM_PROFILE_MOBILE              2

+#define EFI_ACPI_4_0_PM_PROFILE_WORKSTATION         3

+#define EFI_ACPI_4_0_PM_PROFILE_ENTERPRISE_SERVER   4

+#define EFI_ACPI_4_0_PM_PROFILE_SOHO_SERVER         5

+#define EFI_ACPI_4_0_PM_PROFILE_APPLIANCE_PC        6

+#define EFI_ACPI_4_0_PM_PROFILE_PERFORMANCE_SERVER  7

+

+//

+// Fixed ACPI Description Table Boot Architecture Flags

+// All other bits are reserved and must be set to 0.

+//

+#define EFI_ACPI_4_0_LEGACY_DEVICES              BIT0

+#define EFI_ACPI_4_0_8042                        BIT1

+#define EFI_ACPI_4_0_VGA_NOT_PRESENT             BIT2

+#define EFI_ACPI_4_0_MSI_NOT_SUPPORTED           BIT3

+#define EFI_ACPI_4_0_PCIE_ASPM_CONTROLS          BIT4

+

+//

+// Fixed ACPI Description Table Fixed Feature Flags

+// All other bits are reserved and must be set to 0.

+//

+#define EFI_ACPI_4_0_WBINVD                                 BIT0

+#define EFI_ACPI_4_0_WBINVD_FLUSH                           BIT1

+#define EFI_ACPI_4_0_PROC_C1                                BIT2

+#define EFI_ACPI_4_0_P_LVL2_UP                              BIT3

+#define EFI_ACPI_4_0_PWR_BUTTON                             BIT4

+#define EFI_ACPI_4_0_SLP_BUTTON                             BIT5

+#define EFI_ACPI_4_0_FIX_RTC                                BIT6

+#define EFI_ACPI_4_0_RTC_S4                                 BIT7

+#define EFI_ACPI_4_0_TMR_VAL_EXT                            BIT8

+#define EFI_ACPI_4_0_DCK_CAP                                BIT9

+#define EFI_ACPI_4_0_RESET_REG_SUP                          BIT10

+#define EFI_ACPI_4_0_SEALED_CASE                            BIT11

+#define EFI_ACPI_4_0_HEADLESS                               BIT12

+#define EFI_ACPI_4_0_CPU_SW_SLP                             BIT13

+#define EFI_ACPI_4_0_PCI_EXP_WAK                            BIT14

+#define EFI_ACPI_4_0_USE_PLATFORM_CLOCK                     BIT15

+#define EFI_ACPI_4_0_S4_RTC_STS_VALID                       BIT16

+#define EFI_ACPI_4_0_REMOTE_POWER_ON_CAPABLE                BIT17

+#define EFI_ACPI_4_0_FORCE_APIC_CLUSTER_MODEL               BIT18

+#define EFI_ACPI_4_0_FORCE_APIC_PHYSICAL_DESTINATION_MODE   BIT19

+

+///

+/// Firmware ACPI Control Structure

+///

+typedef struct {

+  UINT32  Signature;

+  UINT32  Length;

+  UINT32  HardwareSignature;

+  UINT32  FirmwareWakingVector;

+  UINT32  GlobalLock;

+  UINT32  Flags;

+  UINT64  XFirmwareWakingVector;

+  UINT8   Version;

+  UINT8   Reserved0[3];

+  UINT32  OspmFlags;

+  UINT8   Reserved1[24];

+} EFI_ACPI_4_0_FIRMWARE_ACPI_CONTROL_STRUCTURE;

+

+///

+/// FACS Version (as defined in ACPI 4.0 spec.)

+///

+#define EFI_ACPI_4_0_FIRMWARE_ACPI_CONTROL_STRUCTURE_VERSION  0x02

+

+///

+/// Firmware Control Structure Feature Flags

+/// All other bits are reserved and must be set to 0.

+///

+#define EFI_ACPI_4_0_S4BIOS_F                     BIT0

+#define EFI_ACPI_4_0_64BIT_WAKE_SUPPORTED_F       BIT1

+

+///

+/// OSPM Enabled Firmware Control Structure Flags

+/// All other bits are reserved and must be set to 0.

+///

+#define EFI_ACPI_4_0_OSPM_64BIT_WAKE__F           BIT0

+

+//

+// Differentiated System Description Table,

+// Secondary System Description Table

+// and Persistent System Description Table,

+// no definition needed as they are common description table header, the same with

+// EFI_ACPI_DESCRIPTION_HEADER, followed by a definition block.

+//

+#define EFI_ACPI_4_0_DIFFERENTIATED_SYSTEM_DESCRIPTION_TABLE_REVISION   0x02

+#define EFI_ACPI_4_0_SECONDARY_SYSTEM_DESCRIPTION_TABLE_REVISION        0x02

+

+///

+/// Multiple APIC Description Table header definition.  The rest of the table

+/// must be defined in a platform specific manner.

+///

+typedef struct {

+  EFI_ACPI_DESCRIPTION_HEADER Header;

+  UINT32                      LocalApicAddress;

+  UINT32                      Flags;

+} EFI_ACPI_4_0_MULTIPLE_APIC_DESCRIPTION_TABLE_HEADER;

+

+///

+/// MADT Revision (as defined in ACPI 4.0 spec.)

+///

+#define EFI_ACPI_4_0_MULTIPLE_APIC_DESCRIPTION_TABLE_REVISION 0x03

+

+///

+/// Multiple APIC Flags

+/// All other bits are reserved and must be set to 0.

+///

+#define EFI_ACPI_4_0_PCAT_COMPAT         BIT0

+

+//

+// Multiple APIC Description Table APIC structure types

+// All other values between 0x0B an 0xFF are reserved and

+// will be ignored by OSPM.

+//

+#define EFI_ACPI_4_0_PROCESSOR_LOCAL_APIC           0x00

+#define EFI_ACPI_4_0_IO_APIC                        0x01

+#define EFI_ACPI_4_0_INTERRUPT_SOURCE_OVERRIDE      0x02

+#define EFI_ACPI_4_0_NON_MASKABLE_INTERRUPT_SOURCE  0x03

+#define EFI_ACPI_4_0_LOCAL_APIC_NMI                 0x04

+#define EFI_ACPI_4_0_LOCAL_APIC_ADDRESS_OVERRIDE    0x05

+#define EFI_ACPI_4_0_IO_SAPIC                       0x06

+#define EFI_ACPI_4_0_LOCAL_SAPIC                    0x07

+#define EFI_ACPI_4_0_PLATFORM_INTERRUPT_SOURCES     0x08

+#define EFI_ACPI_4_0_PROCESSOR_LOCAL_X2APIC         0x09

+#define EFI_ACPI_4_0_LOCAL_X2APIC_NMI               0x0A

+

+//

+// APIC Structure Definitions

+//

+

+///

+/// Processor Local APIC Structure Definition

+///

+typedef struct {

+  UINT8   Type;

+  UINT8   Length;

+  UINT8   AcpiProcessorId;

+  UINT8   ApicId;

+  UINT32  Flags;

+} EFI_ACPI_4_0_PROCESSOR_LOCAL_APIC_STRUCTURE;

+

+///

+/// Local APIC Flags.  All other bits are reserved and must be 0.

+///

+#define EFI_ACPI_4_0_LOCAL_APIC_ENABLED        BIT0

+

+///

+/// IO APIC Structure

+///

+typedef struct {

+  UINT8   Type;

+  UINT8   Length;

+  UINT8   IoApicId;

+  UINT8   Reserved;

+  UINT32  IoApicAddress;

+  UINT32  GlobalSystemInterruptBase;

+} EFI_ACPI_4_0_IO_APIC_STRUCTURE;

+

+///

+/// Interrupt Source Override Structure

+///

+typedef struct {

+  UINT8   Type;

+  UINT8   Length;

+  UINT8   Bus;

+  UINT8   Source;

+  UINT32  GlobalSystemInterrupt;

+  UINT16  Flags;

+} EFI_ACPI_4_0_INTERRUPT_SOURCE_OVERRIDE_STRUCTURE;

+

+///

+/// Platform Interrupt Sources Structure Definition

+///

+typedef struct {

+  UINT8   Type;

+  UINT8   Length;

+  UINT16  Flags;

+  UINT8   InterruptType;

+  UINT8   ProcessorId;

+  UINT8   ProcessorEid;

+  UINT8   IoSapicVector;

+  UINT32  GlobalSystemInterrupt;

+  UINT32  PlatformInterruptSourceFlags;

+  UINT8   CpeiProcessorOverride;

+  UINT8   Reserved[31];

+} EFI_ACPI_4_0_PLATFORM_INTERRUPT_APIC_STRUCTURE;

+

+//

+// MPS INTI flags.

+// All other bits are reserved and must be set to 0.

+//

+#define EFI_ACPI_4_0_POLARITY      (3 << 0)

+#define EFI_ACPI_4_0_TRIGGER_MODE  (3 << 2)

+

+///

+/// Non-Maskable Interrupt Source Structure

+///

+typedef struct {

+  UINT8   Type;

+  UINT8   Length;

+  UINT16  Flags;

+  UINT32  GlobalSystemInterrupt;

+} EFI_ACPI_4_0_NON_MASKABLE_INTERRUPT_SOURCE_STRUCTURE;

+

+///

+/// Local APIC NMI Structure

+///

+typedef struct {

+  UINT8   Type;

+  UINT8   Length;

+  UINT8   AcpiProcessorId;

+  UINT16  Flags;

+  UINT8   LocalApicLint;

+} EFI_ACPI_4_0_LOCAL_APIC_NMI_STRUCTURE;

+

+///

+/// Local APIC Address Override Structure

+///

+typedef struct {

+  UINT8   Type;

+  UINT8   Length;

+  UINT16  Reserved;

+  UINT64  LocalApicAddress;

+} EFI_ACPI_4_0_LOCAL_APIC_ADDRESS_OVERRIDE_STRUCTURE;

+

+///

+/// IO SAPIC Structure

+///

+typedef struct {

+  UINT8   Type;

+  UINT8   Length;

+  UINT8   IoApicId;

+  UINT8   Reserved;

+  UINT32  GlobalSystemInterruptBase;

+  UINT64  IoSapicAddress;

+} EFI_ACPI_4_0_IO_SAPIC_STRUCTURE;

+

+///

+/// Local SAPIC Structure

+/// This struct followed by a null-terminated ASCII string - ACPI Processor UID String

+///

+typedef struct {

+  UINT8   Type;

+  UINT8   Length;

+  UINT8   AcpiProcessorId;

+  UINT8   LocalSapicId;

+  UINT8   LocalSapicEid;

+  UINT8   Reserved[3];

+  UINT32  Flags;

+  UINT32  ACPIProcessorUIDValue;

+} EFI_ACPI_4_0_PROCESSOR_LOCAL_SAPIC_STRUCTURE;

+

+///

+/// Platform Interrupt Sources Structure

+///

+typedef struct {

+  UINT8   Type;

+  UINT8   Length;

+  UINT16  Flags;

+  UINT8   InterruptType;

+  UINT8   ProcessorId;

+  UINT8   ProcessorEid;

+  UINT8   IoSapicVector;

+  UINT32  GlobalSystemInterrupt;

+  UINT32  PlatformInterruptSourceFlags;

+} EFI_ACPI_4_0_PLATFORM_INTERRUPT_SOURCES_STRUCTURE;

+

+///

+/// Platform Interrupt Source Flags.

+/// All other bits are reserved and must be set to 0.

+///

+#define EFI_ACPI_4_0_CPEI_PROCESSOR_OVERRIDE          BIT0

+

+///

+/// Processor Local x2APIC Structure Definition

+///

+typedef struct {

+  UINT8   Type;

+  UINT8   Length;

+  UINT8   Reserved[2];

+  UINT32  X2ApicId;

+  UINT32  Flags;

+  UINT32  AcpiProcessorUid;

+} EFI_ACPI_4_0_PROCESSOR_LOCAL_X2APIC_STRUCTURE;

+

+///

+/// Local x2APIC NMI Structure

+///

+typedef struct {

+  UINT8   Type;

+  UINT8   Length;

+  UINT16  Flags;

+  UINT32  AcpiProcessorUid;

+  UINT8   LocalX2ApicLint;

+  UINT8   Reserved[3];

+} EFI_ACPI_4_0_LOCAL_X2APIC_NMI_STRUCTURE;

+

+///

+/// Smart Battery Description Table (SBST)

+///

+typedef struct {

+  EFI_ACPI_DESCRIPTION_HEADER Header;

+  UINT32                      WarningEnergyLevel;

+  UINT32                      LowEnergyLevel;

+  UINT32                      CriticalEnergyLevel;

+} EFI_ACPI_4_0_SMART_BATTERY_DESCRIPTION_TABLE;

+

+///

+/// SBST Version (as defined in ACPI 4.0 spec.)

+///

+#define EFI_ACPI_4_0_SMART_BATTERY_DESCRIPTION_TABLE_REVISION 0x01

+

+///

+/// Embedded Controller Boot Resources Table (ECDT)

+/// The table is followed by a null terminated ASCII string that contains

+/// a fully qualified reference to the name space object.

+///

+typedef struct {

+  EFI_ACPI_DESCRIPTION_HEADER             Header;

+  EFI_ACPI_4_0_GENERIC_ADDRESS_STRUCTURE  EcControl;

+  EFI_ACPI_4_0_GENERIC_ADDRESS_STRUCTURE  EcData;

+  UINT32                                  Uid;

+  UINT8                                   GpeBit;

+} EFI_ACPI_4_0_EMBEDDED_CONTROLLER_BOOT_RESOURCES_TABLE;

+

+///

+/// ECDT Version (as defined in ACPI 4.0 spec.)

+///

+#define EFI_ACPI_4_0_EMBEDDED_CONTROLLER_BOOT_RESOURCES_TABLE_REVISION  0x01

+

+///

+/// System Resource Affinity Table (SRAT.  The rest of the table

+/// must be defined in a platform specific manner.

+///

+typedef struct {

+  EFI_ACPI_DESCRIPTION_HEADER Header;

+  UINT32                      Reserved1;  ///< Must be set to 1

+  UINT64                      Reserved2;

+} EFI_ACPI_4_0_SYSTEM_RESOURCE_AFFINITY_TABLE_HEADER;

+

+///

+/// SRAT Version (as defined in ACPI 4.0 spec.)

+///

+#define EFI_ACPI_4_0_SYSTEM_RESOURCE_AFFINITY_TABLE_REVISION  0x03

+

+//

+// SRAT structure types.

+// All other values between 0x03 an 0xFF are reserved and

+// will be ignored by OSPM.

+//

+#define EFI_ACPI_4_0_PROCESSOR_LOCAL_APIC_SAPIC_AFFINITY  0x00

+#define EFI_ACPI_4_0_MEMORY_AFFINITY                      0x01

+#define EFI_ACPI_4_0_PROCESSOR_LOCAL_X2APIC_AFFINITY      0x02

+

+///

+/// Processor Local APIC/SAPIC Affinity Structure Definition

+///

+typedef struct {

+  UINT8   Type;

+  UINT8   Length;

+  UINT8   ProximityDomain7To0;

+  UINT8   ApicId;

+  UINT32  Flags;

+  UINT8   LocalSapicEid;

+  UINT8   ProximityDomain31To8[3];

+  UINT32  ClockDomain;

+} EFI_ACPI_4_0_PROCESSOR_LOCAL_APIC_SAPIC_AFFINITY_STRUCTURE;

+

+///

+/// Local APIC/SAPIC Flags.  All other bits are reserved and must be 0.

+///

+#define EFI_ACPI_4_0_PROCESSOR_LOCAL_APIC_SAPIC_ENABLED (1 << 0)

+

+///

+/// Memory Affinity Structure Definition

+///

+typedef struct {

+  UINT8   Type;

+  UINT8   Length;

+  UINT32  ProximityDomain;

+  UINT16  Reserved1;

+  UINT32  AddressBaseLow;

+  UINT32  AddressBaseHigh;

+  UINT32  LengthLow;

+  UINT32  LengthHigh;

+  UINT32  Reserved2;

+  UINT32  Flags;

+  UINT64  Reserved3;

+} EFI_ACPI_4_0_MEMORY_AFFINITY_STRUCTURE;

+

+//

+// Memory Flags.  All other bits are reserved and must be 0.

+//

+#define EFI_ACPI_4_0_MEMORY_ENABLED       (1 << 0)

+#define EFI_ACPI_4_0_MEMORY_HOT_PLUGGABLE (1 << 1)

+#define EFI_ACPI_4_0_MEMORY_NONVOLATILE   (1 << 2)

+

+///

+/// Processor Local x2APIC Affinity Structure Definition

+///

+typedef struct {

+  UINT8   Type;

+  UINT8   Length;

+  UINT8   Reserved1[2];

+  UINT32  ProximityDomain;

+  UINT32  X2ApicId;

+  UINT32  Flags;

+  UINT32  ClockDomain;

+  UINT8   Reserved2[4];

+} EFI_ACPI_4_0_PROCESSOR_LOCAL_X2APIC_AFFINITY_STRUCTURE;

+

+///

+/// System Locality Distance Information Table (SLIT).

+/// The rest of the table is a matrix.

+///

+typedef struct {

+  EFI_ACPI_DESCRIPTION_HEADER Header;

+  UINT64                      NumberOfSystemLocalities;

+} EFI_ACPI_4_0_SYSTEM_LOCALITY_DISTANCE_INFORMATION_TABLE_HEADER;

+

+///

+/// SLIT Version (as defined in ACPI 4.0 spec.)

+///

+#define EFI_ACPI_4_0_SYSTEM_LOCALITY_DISTANCE_INFORMATION_TABLE_REVISION  0x01

+

+///

+/// Corrected Platform Error Polling Table (CPEP)

+///

+typedef struct {

+  EFI_ACPI_DESCRIPTION_HEADER Header;

+  UINT8                       Reserved[8];

+} EFI_ACPI_4_0_CORRECTED_PLATFORM_ERROR_POLLING_TABLE_HEADER;

+

+///

+/// CPEP Version (as defined in ACPI 4.0 spec.)

+///

+#define EFI_ACPI_4_0_CORRECTED_PLATFORM_ERROR_POLLING_TABLE_REVISION 0x01

+

+//

+// CPEP processor structure types.

+//

+#define EFI_ACPI_4_0_CPEP_PROCESSOR_APIC_SAPIC  0x00

+

+///

+/// Corrected Platform Error Polling Processor Structure Definition

+///

+typedef struct {

+  UINT8   Type;

+  UINT8   Length;

+  UINT8   ProcessorId;

+  UINT8   ProcessorEid;

+  UINT32  PollingInterval;

+} EFI_ACPI_4_0_CPEP_PROCESSOR_APIC_SAPIC_STRUCTURE;

+

+///

+/// Maximum System Characteristics Table (MSCT)

+///

+typedef struct {

+  EFI_ACPI_DESCRIPTION_HEADER Header;

+  UINT32                      OffsetProxDomInfo;

+  UINT32                      MaximumNumberOfProximityDomains;

+  UINT32                      MaximumNumberOfClockDomains;

+  UINT64                      MaximumPhysicalAddress;

+} EFI_ACPI_4_0_MAXIMUM_SYSTEM_CHARACTERISTICS_TABLE_HEADER;

+

+///

+/// MSCT Version (as defined in ACPI 4.0 spec.)

+///

+#define EFI_ACPI_4_0_MAXIMUM_SYSTEM_CHARACTERISTICS_TABLE_REVISION 0x01

+

+///

+/// Maximum Proximity Domain Information Structure Definition

+///

+typedef struct {

+  UINT8   Revision;

+  UINT8   Length;

+  UINT32  ProximityDomainRangeLow;

+  UINT32  ProximityDomainRangeHigh;

+  UINT32  MaximumProcessorCapacity;

+  UINT64  MaximumMemoryCapacity;

+} EFI_ACPI_4_0_MAXIMUM_PROXIMITY_DOMAIN_INFORMATION_STRUCTURE;

+

+///

+/// Boot Error Record Table (BERT)

+///

+typedef struct {

+  EFI_ACPI_DESCRIPTION_HEADER Header;

+  UINT32                      BootErrorRegionLength;

+  UINT64                      BootErrorRegion;

+} EFI_ACPI_4_0_BOOT_ERROR_RECORD_TABLE_HEADER;

+

+///

+/// BERT Version (as defined in ACPI 4.0 spec.)

+///

+#define EFI_ACPI_4_0_BOOT_ERROR_RECORD_TABLE_REVISION 0x01

+

+///

+/// Boot Error Region Block Status Definition

+///

+typedef struct {

+  UINT32       UncorrectableErrorValid:1;

+  UINT32       CorrectableErrorValid:1;

+  UINT32       MultipleUncorrectableErrors:1;

+  UINT32       MultipleCorrectableErrors:1;

+  UINT32       ErrorDataEntryCount:10;

+  UINT32       Reserved:18;

+} EFI_ACPI_4_0_ERROR_BLOCK_STATUS;

+

+///

+/// Boot Error Region Definition

+///

+typedef struct {

+  EFI_ACPI_4_0_ERROR_BLOCK_STATUS              BlockStatus;

+  UINT32                                       RawDataOffset;

+  UINT32                                       RawDataLength;

+  UINT32                                       DataLength;

+  UINT32                                       ErrorSeverity;

+} EFI_ACPI_4_0_BOOT_ERROR_REGION_STRUCTURE;

+

+//

+// Boot Error Severity types

+//

+#define EFI_ACPI_4_0_ERROR_SEVERITY_CORRECTABLE  0x00

+#define EFI_ACPI_4_0_ERROR_SEVERITY_FATAL        0x01

+#define EFI_ACPI_4_0_ERROR_SEVERITY_CORRECTED    0x02

+#define EFI_ACPI_4_0_ERROR_SEVERITY_NONE         0x03

+

+///

+/// Generic Error Data Entry Definition

+///

+typedef struct {

+  UINT8    SectionType[16];

+  UINT32   ErrorSeverity;

+  UINT16   Revision;

+  UINT8    ValidationBits;

+  UINT8    Flags;

+  UINT32   ErrorDataLength;

+  UINT8    FruId[16];

+  UINT8    FruText[20];

+} EFI_ACPI_4_0_GENERIC_ERROR_DATA_ENTRY_STRUCTURE;

+

+///

+/// Generic Error Data Entry Version (as defined in ACPI 4.0 spec.)

+///

+#define EFI_ACPI_4_0_GENERIC_ERROR_DATA_ENTRY_REVISION  0x0201

+

+///

+/// HEST - Hardware Error Source Table

+///

+typedef struct {

+  EFI_ACPI_DESCRIPTION_HEADER Header;

+  UINT32                      ErrorSourceCount;

+} EFI_ACPI_4_0_HARDWARE_ERROR_SOURCE_TABLE_HEADER;

+

+///

+/// HEST Version (as defined in ACPI 4.0 spec.)

+///

+#define EFI_ACPI_4_0_HARDWARE_ERROR_SOURCE_TABLE_REVISION 0x01

+

+//

+// Error Source structure types.

+//

+#define EFI_ACPI_4_0_IA32_ARCHITECTURE_MACHINE_CHECK_EXCEPTION  0x00

+#define EFI_ACPI_4_0_IA32_ARCHITECTURE_CORRECTED_MACHINE_CHECK  0x01

+#define EFI_ACPI_4_0_IA32_ARCHITECTURE_NMI_ERROR                0x02

+#define EFI_ACPI_4_0_PCI_EXPRESS_ROOT_PORT_AER                  0x06

+#define EFI_ACPI_4_0_PCI_EXPRESS_DEVICE_AER                     0x07

+#define EFI_ACPI_4_0_PCI_EXPRESS_BRIDGE_AER                     0x08

+#define EFI_ACPI_4_0_GENERIC_HARDWARE_ERROR                     0x09

+

+//

+// Error Source structure flags.

+//

+#define EFI_ACPI_4_0_ERROR_SOURCE_FLAG_FIRMWARE_FIRST       (1 << 0)

+#define EFI_ACPI_4_0_ERROR_SOURCE_FLAG_GLOBAL               (1 << 1)

+

+///

+/// IA-32 Architecture Machine Check Exception Structure Definition

+///

+typedef struct {

+  UINT16  Type;

+  UINT16  SourceId;

+  UINT8   Reserved0[2];

+  UINT8   Flags;

+  UINT8   Enabled;

+  UINT32  NumberOfRecordsToPreAllocate;

+  UINT32  MaxSectionsPerRecord;

+  UINT64  GlobalCapabilityInitData;

+  UINT64  GlobalControlInitData;

+  UINT8   NumberOfHardwareBanks;

+  UINT8   Reserved1[7];

+} EFI_ACPI_4_0_IA32_ARCHITECTURE_MACHINE_CHECK_EXCEPTION_STRUCTURE;

+

+///

+/// IA-32 Architecture Machine Check Bank Structure Definition

+///

+typedef struct {

+  UINT8   BankNumber;

+  UINT8   ClearStatusOnInitialization;

+  UINT8   StatusDataFormat;

+  UINT8   Reserved0;

+  UINT32  ControlRegisterMsrAddress;

+  UINT64  ControlInitData;

+  UINT32  StatusRegisterMsrAddress;

+  UINT32  AddressRegisterMsrAddress;

+  UINT32  MiscRegisterMsrAddress;

+} EFI_ACPI_4_0_IA32_ARCHITECTURE_MACHINE_CHECK_ERROR_BANK_STRUCTURE;

+

+///

+/// IA-32 Architecture Machine Check Bank Structure MCA data format

+///

+#define EFI_ACPI_4_0_IA32_ARCHITECTURE_MACHINE_CHECK_ERROR_DATA_FORMAT_IA32      0x00

+#define EFI_ACPI_4_0_IA32_ARCHITECTURE_MACHINE_CHECK_ERROR_DATA_FORMAT_INTEL64   0x01

+#define EFI_ACPI_4_0_IA32_ARCHITECTURE_MACHINE_CHECK_ERROR_DATA_FORMAT_AMD64     0x02

+

+//

+// Hardware Error Notification types. All other values are reserved

+//

+#define EFI_ACPI_4_0_HARDWARE_ERROR_NOTIFICATION_POLLED                0x00

+#define EFI_ACPI_4_0_HARDWARE_ERROR_NOTIFICATION_EXTERNAL_INTERRUPT    0x01

+#define EFI_ACPI_4_0_HARDWARE_ERROR_NOTIFICATION_LOCAL_INTERRUPT       0x02

+#define EFI_ACPI_4_0_HARDWARE_ERROR_NOTIFICATION_SCI                   0x03

+#define EFI_ACPI_4_0_HARDWARE_ERROR_NOTIFICATION_NMI                   0x04

+

+///

+/// Hardware Error Notification Configuration Write Enable Structure Definition

+///

+typedef struct {

+  UINT16    Type:1;

+  UINT16    PollInterval:1;

+  UINT16    SwitchToPollingThresholdValue:1;

+  UINT16    SwitchToPollingThresholdWindow:1;

+  UINT16    ErrorThresholdValue:1;

+  UINT16    ErrorThresholdWindow:1;

+  UINT16    Reserved:10;

+} EFI_ACPI_4_0_HARDWARE_ERROR_NOTIFICATION_CONFIGURATION_WRITE_ENABLE_STRUCTURE;

+

+///

+/// Hardware Error Notification Structure Definition

+///

+typedef struct {

+  UINT8                                                                          Type;

+  UINT8                                                                          Length;

+  EFI_ACPI_4_0_HARDWARE_ERROR_NOTIFICATION_CONFIGURATION_WRITE_ENABLE_STRUCTURE  ConfigurationWriteEnable;

+  UINT32                                                                         PollInterval;

+  UINT32                                                                         Vector;

+  UINT32                                                                         SwitchToPollingThresholdValue;

+  UINT32                                                                         SwitchToPollingThresholdWindow;

+  UINT32                                                                         ErrorThresholdValue;

+  UINT32                                                                         ErrorThresholdWindow;

+} EFI_ACPI_4_0_HARDWARE_ERROR_NOTIFICATION_STRUCTURE;

+

+///

+/// IA-32 Architecture Corrected Machine Check Structure Definition

+///

+typedef struct {

+  UINT16                                                 Type;

+  UINT16                                                 SourceId;

+  UINT8                                                  Reserved0[2];

+  UINT8                                                  Flags;

+  UINT8                                                  Enabled;

+  UINT32                                                 NumberOfRecordsToPreAllocate;

+  UINT32                                                 MaxSectionsPerRecord;

+  EFI_ACPI_4_0_HARDWARE_ERROR_NOTIFICATION_STRUCTURE     NotificationStructure;

+  UINT8                                                  NumberOfHardwareBanks;

+  UINT8                                                  Reserved1[3];

+} EFI_ACPI_4_0_IA32_ARCHITECTURE_CORRECTED_MACHINE_CHECK_STRUCTURE;

+

+///

+/// IA-32 Architecture NMI Error Structure Definition

+///

+typedef struct {

+  UINT16  Type;

+  UINT16  SourceId;

+  UINT8   Reserved0[2];

+  UINT32  NumberOfRecordsToPreAllocate;

+  UINT32  MaxSectionsPerRecord;

+  UINT32  MaxRawDataLength;

+} EFI_ACPI_4_0_IA32_ARCHITECTURE_NMI_ERROR_STRUCTURE;

+

+///

+/// PCI Express Root Port AER Structure Definition

+///

+typedef struct {

+  UINT16  Type;

+  UINT16  SourceId;

+  UINT8   Reserved0[2];

+  UINT8   Flags;

+  UINT8   Enabled;

+  UINT32  NumberOfRecordsToPreAllocate;

+  UINT32  MaxSectionsPerRecord;

+  UINT32  Bus;

+  UINT16  Device;

+  UINT16  Function;

+  UINT16  DeviceControl;

+  UINT8   Reserved1[2];

+  UINT32  UncorrectableErrorMask;

+  UINT32  UncorrectableErrorSeverity;

+  UINT32  CorrectableErrorMask;

+  UINT32  AdvancedErrorCapabilitiesAndControl;

+  UINT32  RootErrorCommand;

+} EFI_ACPI_4_0_PCI_EXPRESS_ROOT_PORT_AER_STRUCTURE;

+

+///

+/// PCI Express Device AER Structure Definition

+///

+typedef struct {

+  UINT16  Type;

+  UINT16  SourceId;

+  UINT8   Reserved0[2];

+  UINT8   Flags;

+  UINT8   Enabled;

+  UINT32  NumberOfRecordsToPreAllocate;

+  UINT32  MaxSectionsPerRecord;

+  UINT32  Bus;

+  UINT16  Device;

+  UINT16  Function;

+  UINT16  DeviceControl;

+  UINT8   Reserved1[2];

+  UINT32  UncorrectableErrorMask;

+  UINT32  UncorrectableErrorSeverity;

+  UINT32  CorrectableErrorMask;

+  UINT32  AdvancedErrorCapabilitiesAndControl;

+} EFI_ACPI_4_0_PCI_EXPRESS_DEVICE_AER_STRUCTURE;

+

+///

+/// PCI Express Bridge AER Structure Definition

+///

+typedef struct {

+  UINT16  Type;

+  UINT16  SourceId;

+  UINT8   Reserved0[2];

+  UINT8   Flags;

+  UINT8   Enabled;

+  UINT32  NumberOfRecordsToPreAllocate;

+  UINT32  MaxSectionsPerRecord;

+  UINT32  Bus;

+  UINT16  Device;

+  UINT16  Function;

+  UINT16  DeviceControl;

+  UINT8   Reserved1[2];

+  UINT32  UncorrectableErrorMask;

+  UINT32  UncorrectableErrorSeverity;

+  UINT32  CorrectableErrorMask;

+  UINT32  AdvancedErrorCapabilitiesAndControl;

+  UINT32  SecondaryUncorrectableErrorMask;

+  UINT32  SecondaryUncorrectableErrorSeverity;

+  UINT32  SecondaryAdvancedErrorCapabilitiesAndControl;

+} EFI_ACPI_4_0_PCI_EXPRESS_BRIDGE_AER_STRUCTURE;

+

+///

+/// Generic Hardware Error Source Structure Definition

+///

+typedef struct {

+  UINT16                                                 Type;

+  UINT16                                                 SourceId;

+  UINT16                                                 RelatedSourceId;

+  UINT8                                                  Flags;

+  UINT8                                                  Enabled;

+  UINT32                                                 NumberOfRecordsToPreAllocate;

+  UINT32                                                 MaxSectionsPerRecord;

+  UINT32                                                 MaxRawDataLength;

+  EFI_ACPI_4_0_GENERIC_ADDRESS_STRUCTURE                 ErrorStatusAddress;

+  EFI_ACPI_4_0_HARDWARE_ERROR_NOTIFICATION_STRUCTURE     NotificationStructure;

+  UINT32                                                 ErrorStatusBlockLength;

+} EFI_ACPI_4_0_GENERIC_HARDWARE_ERROR_SOURCE_STRUCTURE;

+

+///

+/// Generic Error Status Definition

+///

+typedef struct {

+  EFI_ACPI_4_0_ERROR_BLOCK_STATUS              BlockStatus;

+  UINT32                                       RawDataOffset;

+  UINT32                                       RawDataLength;

+  UINT32                                       DataLength;

+  UINT32                                       ErrorSeverity;

+} EFI_ACPI_4_0_GENERIC_ERROR_STATUS_STRUCTURE;

+

+///

+/// ERST - Error Record Serialization Table

+///

+typedef struct {

+  EFI_ACPI_DESCRIPTION_HEADER Header;

+  UINT32                      SerializationHeaderSize;

+  UINT8                       Reserved0[4];

+  UINT32                      InstructionEntryCount;

+} EFI_ACPI_4_0_ERROR_RECORD_SERIALIZATION_TABLE_HEADER;

+

+///

+/// ERST Version (as defined in ACPI 4.0 spec.)

+///

+#define EFI_ACPI_4_0_ERROR_RECORD_SERIALIZATION_TABLE_REVISION 0x01

+

+///

+/// ERST Serialization Actions

+///

+#define EFI_ACPI_4_0_ERST_BEGIN_WRITE_OPERATION                    0x00

+#define EFI_ACPI_4_0_ERST_BEGIN_READ_OPERATION                     0x01

+#define EFI_ACPI_4_0_ERST_BEGIN_CLEAR_OPERATION                    0x02

+#define EFI_ACPI_4_0_ERST_END_OPERATION                            0x03

+#define EFI_ACPI_4_0_ERST_SET_RECORD_OFFSET                        0x04

+#define EFI_ACPI_4_0_ERST_EXECUTE_OPERATION                        0x05

+#define EFI_ACPI_4_0_ERST_CHECK_BUSY_STATUS                        0x06

+#define EFI_ACPI_4_0_ERST_GET_COMMAND_STATUS                       0x07

+#define EFI_ACPI_4_0_ERST_GET_RECORD_IDENTIFIER                    0x08

+#define EFI_ACPI_4_0_ERST_SET_RECORD_IDENTIFIER                    0x09

+#define EFI_ACPI_4_0_ERST_GET_RECORD_COUNT                         0x0A

+#define EFI_ACPI_4_0_ERST_BEGIN_DUMMY_WRITE_OPERATION              0x0B

+#define EFI_ACPI_4_0_ERST_GET_ERROR_LOG_ADDRESS_RANGE              0x0D

+#define EFI_ACPI_4_0_ERST_GET_ERROR_LOG_ADDRESS_RANGE_LENGTH       0x0E

+#define EFI_ACPI_4_0_ERST_GET_ERROR_LOG_ADDRESS_RANGE_ATTRIBUTES   0x0F

+

+///

+/// ERST Action Command Status

+///

+#define EFI_ACPI_4_0_EINJ_STATUS_SUCCESS                           0x00

+#define EFI_ACPI_4_0_EINJ_STATUS_NOT_ENOUGH_SPACE                  0x01

+#define EFI_ACPI_4_0_EINJ_STATUS_HARDWARE_NOT_AVAILABLE            0x02

+#define EFI_ACPI_4_0_EINJ_STATUS_FAILED                            0x03

+#define EFI_ACPI_4_0_EINJ_STATUS_RECORD_STORE_EMPTY                0x04

+#define EFI_ACPI_4_0_EINJ_STATUS_RECORD_NOT_FOUND                  0x05

+

+///

+/// ERST Serialization Instructions

+///

+#define EFI_ACPI_4_0_ERST_READ_REGISTER                            0x00

+#define EFI_ACPI_4_0_ERST_READ_REGISTER_VALUE                      0x01

+#define EFI_ACPI_4_0_ERST_WRITE_REGISTER                           0x02

+#define EFI_ACPI_4_0_ERST_WRITE_REGISTER_VALUE                     0x03

+#define EFI_ACPI_4_0_ERST_NOOP                                     0x04

+#define EFI_ACPI_4_0_ERST_LOAD_VAR1                                0x05

+#define EFI_ACPI_4_0_ERST_LOAD_VAR2                                0x06

+#define EFI_ACPI_4_0_ERST_STORE_VAR1                               0x07

+#define EFI_ACPI_4_0_ERST_ADD                                      0x08

+#define EFI_ACPI_4_0_ERST_SUBTRACT                                 0x09

+#define EFI_ACPI_4_0_ERST_ADD_VALUE                                0x0A

+#define EFI_ACPI_4_0_ERST_SUBTRACT_VALUE                           0x0B

+#define EFI_ACPI_4_0_ERST_STALL                                    0x0C

+#define EFI_ACPI_4_0_ERST_STALL_WHILE_TRUE                         0x0D

+#define EFI_ACPI_4_0_ERST_SKIP_NEXT_INSTRUCTION_IF_TRUE            0x0E

+#define EFI_ACPI_4_0_ERST_GOTO                                     0x0F

+#define EFI_ACPI_4_0_ERST_SET_SRC_ADDRESS_BASE                     0x10

+#define EFI_ACPI_4_0_ERST_SET_DST_ADDRESS_BASE                     0x11

+#define EFI_ACPI_4_0_ERST_MOVE_DATA                                0x12

+

+///

+/// ERST Instruction Flags

+///

+#define EFI_ACPI_4_0_ERST_PRESERVE_REGISTER                        0x01

+

+///

+/// ERST Serialization Instruction Entry

+///

+typedef struct {

+  UINT8                                    SerializationAction;

+  UINT8                                    Instruction;

+  UINT8                                    Flags;

+  UINT8                                    Reserved0;

+  EFI_ACPI_4_0_GENERIC_ADDRESS_STRUCTURE   RegisterRegion;

+  UINT64                                   Value;

+  UINT64                                   Mask;

+} EFI_ACPI_4_0_ERST_SERIALIZATION_INSTRUCTION_ENTRY;

+

+///

+/// EINJ - Error Injection Table

+///

+typedef struct {

+  EFI_ACPI_DESCRIPTION_HEADER Header;

+  UINT32                      InjectionHeaderSize;

+  UINT8                       InjectionFlags;

+  UINT8                       Reserved0[3];

+  UINT32                      InjectionEntryCount;

+} EFI_ACPI_4_0_ERROR_INJECTION_TABLE_HEADER;

+

+///

+/// EINJ Version (as defined in ACPI 4.0 spec.)

+///

+#define EFI_ACPI_4_0_ERROR_INJECTION_TABLE_REVISION 0x01

+

+///

+/// EINJ Error Injection Actions

+///

+#define EFI_ACPI_4_0_EINJ_BEGIN_INJECTION_OPERATION                0x00

+#define EFI_ACPI_4_0_EINJ_GET_TRIGGER_ERROR_ACTION_TABLE           0x01

+#define EFI_ACPI_4_0_EINJ_SET_ERROR_TYPE                           0x02

+#define EFI_ACPI_4_0_EINJ_GET_ERROR_TYPE                           0x03

+#define EFI_ACPI_4_0_EINJ_END_OPERATION                            0x04

+#define EFI_ACPI_4_0_EINJ_EXECUTE_OPERATION                        0x05

+#define EFI_ACPI_4_0_EINJ_CHECK_BUSY_STATUS                        0x06

+#define EFI_ACPI_4_0_EINJ_GET_COMMAND_STATUS                       0x07

+#define EFI_ACPI_4_0_EINJ_TRIGGER_ERROR                            0xFF

+

+///

+/// EINJ Action Command Status

+///

+#define EFI_ACPI_4_0_EINJ_STATUS_SUCCESS                           0x00

+#define EFI_ACPI_4_0_EINJ_STATUS_UNKNOWN_FAILURE                   0x01

+#define EFI_ACPI_4_0_EINJ_STATUS_INVALID_ACCESS                    0x02

+

+///

+/// EINJ Error Type Definition

+///

+#define EFI_ACPI_4_0_EINJ_ERROR_PROCESSOR_CORRECTABLE                 (1 << 0)

+#define EFI_ACPI_4_0_EINJ_ERROR_PROCESSOR_UNCORRECTABLE_NONFATAL      (1 << 1)

+#define EFI_ACPI_4_0_EINJ_ERROR_PROCESSOR_UNCORRECTABLE_FATAL         (1 << 2)

+#define EFI_ACPI_4_0_EINJ_ERROR_MEMORY_CORRECTABLE                    (1 << 3)

+#define EFI_ACPI_4_0_EINJ_ERROR_MEMORY_UNCORRECTABLE_NONFATAL         (1 << 4)

+#define EFI_ACPI_4_0_EINJ_ERROR_MEMORY_UNCORRECTABLE_FATAL            (1 << 5)

+#define EFI_ACPI_4_0_EINJ_ERROR_PCI_EXPRESS_CORRECTABLE               (1 << 6)

+#define EFI_ACPI_4_0_EINJ_ERROR_PCI_EXPRESS_UNCORRECTABLE_NONFATAL    (1 << 7)

+#define EFI_ACPI_4_0_EINJ_ERROR_PCI_EXPRESS_UNCORRECTABLE_FATAL       (1 << 8)

+#define EFI_ACPI_4_0_EINJ_ERROR_PLATFORM_CORRECTABLE                  (1 << 9)

+#define EFI_ACPI_4_0_EINJ_ERROR_PLATFORM_UNCORRECTABLE_NONFATAL       (1 << 10)

+#define EFI_ACPI_4_0_EINJ_ERROR_PLATFORM_UNCORRECTABLE_FATAL          (1 << 11)

+

+///

+/// EINJ Injection Instructions

+///

+#define EFI_ACPI_4_0_EINJ_READ_REGISTER                            0x00

+#define EFI_ACPI_4_0_EINJ_READ_REGISTER_VALUE                      0x01

+#define EFI_ACPI_4_0_EINJ_WRITE_REGISTER                           0x02

+#define EFI_ACPI_4_0_EINJ_WRITE_REGISTER_VALUE                     0x03

+#define EFI_ACPI_4_0_EINJ_NOOP                                     0x04

+

+///

+/// EINJ Instruction Flags

+///

+#define EFI_ACPI_4_0_EINJ_PRESERVE_REGISTER                        0x01

+

+///

+/// EINJ Injection Instruction Entry

+///

+typedef struct {

+  UINT8                                    InjectionAction;

+  UINT8                                    Instruction;

+  UINT8                                    Flags;

+  UINT8                                    Reserved0;

+  EFI_ACPI_4_0_GENERIC_ADDRESS_STRUCTURE   RegisterRegion;

+  UINT64                                   Value;

+  UINT64                                   Mask;

+} EFI_ACPI_4_0_EINJ_INJECTION_INSTRUCTION_ENTRY;

+

+///

+/// EINJ Trigger Action Table

+///

+typedef struct {

+  UINT32  HeaderSize;

+  UINT32  Revision;

+  UINT32  TableSize;

+  UINT32  EntryCount;

+} EFI_ACPI_4_0_EINJ_TRIGGER_ACTION_TABLE;

+

+//

+// Known table signatures

+//

+

+///

+/// "RSD PTR " Root System Description Pointer

+///

+#define EFI_ACPI_4_0_ROOT_SYSTEM_DESCRIPTION_POINTER_SIGNATURE  SIGNATURE_64('R', 'S', 'D', ' ', 'P', 'T', 'R', ' ')

+

+///

+/// "APIC" Multiple APIC Description Table

+///

+#define EFI_ACPI_4_0_MULTIPLE_APIC_DESCRIPTION_TABLE_SIGNATURE  SIGNATURE_32('A', 'P', 'I', 'C')

+

+///

+/// "BERT" Boot Error Record Table

+///

+#define EFI_ACPI_4_0_BOOT_ERROR_RECORD_TABLE_SIGNATURE  SIGNATURE_32('B', 'E', 'R', 'T')

+

+///

+/// "CPEP" Corrected Platform Error Polling Table

+///

+#define EFI_ACPI_4_0_CORRECTED_PLATFORM_ERROR_POLLING_TABLE_SIGNATURE  SIGNATURE_32('C', 'P', 'E', 'P')

+

+///

+/// "DSDT" Differentiated System Description Table

+///

+#define EFI_ACPI_4_0_DIFFERENTIATED_SYSTEM_DESCRIPTION_TABLE_SIGNATURE  SIGNATURE_32('D', 'S', 'D', 'T')

+

+///

+/// "ECDT" Embedded Controller Boot Resources Table

+///

+#define EFI_ACPI_4_0_EMBEDDED_CONTROLLER_BOOT_RESOURCES_TABLE_SIGNATURE  SIGNATURE_32('E', 'C', 'D', 'T')

+

+///

+/// "EINJ" Error Injection Table

+///

+#define EFI_ACPI_4_0_ERROR_INJECTION_TABLE_SIGNATURE  SIGNATURE_32('E', 'I', 'N', 'J')

+

+///

+/// "ERST" Error Record Serialization Table

+///

+#define EFI_ACPI_4_0_ERROR_RECORD_SERIALIZATION_TABLE_SIGNATURE  SIGNATURE_32('E', 'R', 'S', 'T')

+

+///

+/// "FACP" Fixed ACPI Description Table

+///

+#define EFI_ACPI_4_0_FIXED_ACPI_DESCRIPTION_TABLE_SIGNATURE  SIGNATURE_32('F', 'A', 'C', 'P')

+

+///

+/// "FACS" Firmware ACPI Control Structure

+///

+#define EFI_ACPI_4_0_FIRMWARE_ACPI_CONTROL_STRUCTURE_SIGNATURE  SIGNATURE_32('F', 'A', 'C', 'S')

+

+///

+/// "HEST" Hardware Error Source Table

+///

+#define EFI_ACPI_4_0_HARDWARE_ERROR_SOURCE_TABLE_SIGNATURE  SIGNATURE_32('H', 'E', 'S', 'T')

+

+///

+/// "MSCT" Maximum System Characteristics Table

+///

+#define EFI_ACPI_4_0_MAXIMUM_SYSTEM_CHARACTERISTICS_TABLE_SIGNATURE  SIGNATURE_32('M', 'S', 'C', 'T')

+

+///

+/// "PSDT" Persistent System Description Table

+///

+#define EFI_ACPI_4_0_PERSISTENT_SYSTEM_DESCRIPTION_TABLE_SIGNATURE  SIGNATURE_32('P', 'S', 'D', 'T')

+

+///

+/// "RSDT" Root System Description Table

+///

+#define EFI_ACPI_4_0_ROOT_SYSTEM_DESCRIPTION_TABLE_SIGNATURE  SIGNATURE_32('R', 'S', 'D', 'T')

+

+///

+/// "SBST" Smart Battery Specification Table

+///

+#define EFI_ACPI_4_0_SMART_BATTERY_SPECIFICATION_TABLE_SIGNATURE  SIGNATURE_32('S', 'B', 'S', 'T')

+

+///

+/// "SLIT" System Locality Information Table

+///

+#define EFI_ACPI_4_0_SYSTEM_LOCALITY_INFORMATION_TABLE_SIGNATURE  SIGNATURE_32('S', 'L', 'I', 'T')

+

+///

+/// "SRAT" System Resource Affinity Table

+///

+#define EFI_ACPI_4_0_SYSTEM_RESOURCE_AFFINITY_TABLE_SIGNATURE  SIGNATURE_32('S', 'R', 'A', 'T')

+

+///

+/// "SSDT" Secondary System Description Table

+///

+#define EFI_ACPI_4_0_SECONDARY_SYSTEM_DESCRIPTION_TABLE_SIGNATURE  SIGNATURE_32('S', 'S', 'D', 'T')

+

+///

+/// "XSDT" Extended System Description Table

+///

+#define EFI_ACPI_4_0_EXTENDED_SYSTEM_DESCRIPTION_TABLE_SIGNATURE  SIGNATURE_32('X', 'S', 'D', 'T')

+

+///

+/// "BOOT" MS Simple Boot Spec

+///

+#define EFI_ACPI_4_0_SIMPLE_BOOT_FLAG_TABLE_SIGNATURE  SIGNATURE_32('B', 'O', 'O', 'T')

+

+///

+/// "DBGP" MS Debug Port Spec

+///

+#define EFI_ACPI_4_0_DEBUG_PORT_TABLE_SIGNATURE  SIGNATURE_32('D', 'B', 'G', 'P')

+

+///

+/// "DMAR" DMA Remapping Table

+///

+#define EFI_ACPI_4_0_DMA_REMAPPING_TABLE_SIGNATURE  SIGNATURE_32('D', 'M', 'A', 'R')

+

+///

+/// "ETDT" Event Timer Description Table

+///

+#define EFI_ACPI_4_0_EVENT_TIMER_DESCRIPTION_TABLE_SIGNATURE  SIGNATURE_32('E', 'T', 'D', 'T')

+

+///

+/// "HPET" IA-PC High Precision Event Timer Table

+///

+#define EFI_ACPI_4_0_HIGH_PRECISION_EVENT_TIMER_TABLE_SIGNATURE  SIGNATURE_32('H', 'P', 'E', 'T')

+

+///

+/// "iBFT" iSCSI Boot Firmware Table

+///

+#define EFI_ACPI_4_0_ISCSI_BOOT_FIRMWARE_TABLE_SIGNATURE  SIGNATURE_32('i', 'B', 'F', 'T')

+

+///

+/// "IVRS" I/O Virtualization Reporting Structure

+///

+#define EFI_ACPI_4_0_IO_VIRTUALIZATION_REPORTING_STRUCTURE_SIGNATURE  SIGNATURE_32('I', 'V', 'R', 'S')

+

+///

+/// "MCFG" PCI Express Memory Mapped Configuration Space Base Address Description Table

+///

+#define EFI_ACPI_4_0_PCI_EXPRESS_MEMORY_MAPPED_CONFIGURATION_SPACE_BASE_ADDRESS_DESCRIPTION_TABLE_SIGNATURE  SIGNATURE_32('M', 'C', 'F', 'G')

+

+///

+/// "MCHI" Management Controller Host Interface Table

+///

+#define EFI_ACPI_4_0_MANAGEMENT_CONTROLLER_HOST_INTERFACE_TABLE_SIGNATURE  SIGNATURE_32('M', 'C', 'H', 'I')

+

+///

+/// "SPCR" Serial Port Console Redirection Table

+///

+#define EFI_ACPI_4_0_SERIAL_PORT_CONSOLE_REDIRECTION_TABLE_SIGNATURE  SIGNATURE_32('S', 'P', 'C', 'R')

+

+///

+/// "SPMI" Server Platform Management Interface Table

+///

+#define EFI_ACPI_4_0_SERVER_PLATFORM_MANAGEMENT_INTERFACE_TABLE_SIGNATURE  SIGNATURE_32('S', 'P', 'M', 'I')

+

+///

+/// "TCPA" Trusted Computing Platform Alliance Capabilities Table

+///

+#define EFI_ACPI_4_0_TRUSTED_COMPUTING_PLATFORM_ALLIANCE_CAPABILITIES_TABLE_SIGNATURE  SIGNATURE_32('T', 'C', 'P', 'A')

+

+///

+/// "UEFI" UEFI ACPI Data Table

+///

+#define EFI_ACPI_4_0_UEFI_ACPI_DATA_TABLE_SIGNATURE  SIGNATURE_32('U', 'E', 'F', 'I')

+

+///

+/// "WAET" Windows ACPI Enlightenment Table

+///

+#define EFI_ACPI_4_0_WINDOWS_ACPI_ENLIGHTENMENT_TABLE_SIGNATURE  SIGNATURE_32('W', 'A', 'E', 'T')

+

+///

+/// "WDAT" Watchdog Action Table

+///

+#define EFI_ACPI_4_0_WATCHDOG_ACTION_TABLE_SIGNATURE  SIGNATURE_32('W', 'D', 'A', 'T')

+

+///

+/// "WDRT" Watchdog Resource Table

+///

+#define EFI_ACPI_4_0_WATCHDOG_RESOURCE_TABLE_SIGNATURE  SIGNATURE_32('W', 'D', 'R', 'T')

+

+#pragma pack()

+

+#endif

diff --git a/debugging_demo/memtest86+/efi/Include/IndustryStandard/Acpi50.h b/debugging_demo/memtest86+/efi/Include/IndustryStandard/Acpi50.h
new file mode 100644
index 0000000..31a47e6
--- /dev/null
+++ b/debugging_demo/memtest86+/efi/Include/IndustryStandard/Acpi50.h
@@ -0,0 +1,2119 @@
+/** @file

+  ACPI 5.0 definitions from the ACPI Specification Revision 5.0a November 13, 2013.

+

+  Copyright (c) 2014 Hewlett-Packard Development Company, L.P.<BR>

+  Copyright (c) 2011 - 2018, Intel Corporation. All rights reserved.<BR>

+  Copyright (c) 2020, ARM Ltd. All rights reserved.<BR>

+  SPDX-License-Identifier: BSD-2-Clause-Patent

+**/

+

+#ifndef _ACPI_5_0_H_

+#define _ACPI_5_0_H_

+

+#include <IndustryStandard/Acpi40.h>

+

+//

+// Define for Descriptor

+//

+#define ACPI_SMALL_FIXED_DMA_DESCRIPTOR_NAME                         0x0A

+#define ACPI_LARGE_GPIO_CONNECTION_DESCRIPTOR_NAME                   0x0C

+#define ACPI_LARGE_GENERIC_SERIAL_BUS_CONNECTION_DESCRIPTOR_NAME     0x0E

+

+#define ACPI_FIXED_DMA_DESCRIPTOR                         0x55

+#define ACPI_GPIO_CONNECTION_DESCRIPTOR                   0x8C

+#define ACPI_GENERIC_SERIAL_BUS_CONNECTION_DESCRIPTOR     0x8E

+

+#pragma pack(1)

+

+///

+/// Generic DMA Descriptor.

+///

+typedef PACKED struct {

+  ACPI_SMALL_RESOURCE_HEADER   Header;

+  UINT16                       DmaRequestLine;

+  UINT16                       DmaChannel;

+  UINT8                        DmaTransferWidth;

+} EFI_ACPI_FIXED_DMA_DESCRIPTOR;

+

+///

+/// GPIO Connection Descriptor

+///

+typedef PACKED struct {

+  ACPI_LARGE_RESOURCE_HEADER    Header;

+  UINT8                         RevisionId;

+  UINT8                         ConnectionType;

+  UINT16                        GeneralFlags;

+  UINT16                        InterruptFlags;

+  UINT8                         PinConfiguration;

+  UINT16                        OutputDriveStrength;

+  UINT16                        DebounceTimeout;

+  UINT16                        PinTableOffset;

+  UINT8                         ResourceSourceIndex;

+  UINT16                        ResourceSourceNameOffset;

+  UINT16                        VendorDataOffset;

+  UINT16                        VendorDataLength;

+} EFI_ACPI_GPIO_CONNECTION_DESCRIPTOR;

+

+#define EFI_ACPI_GPIO_CONNECTION_TYPE_INTERRUPT   0x0

+#define EFI_ACPI_GPIO_CONNECTION_TYPE_IO          0x1

+

+///

+/// Serial Bus Resource Descriptor (Generic)

+///

+typedef PACKED struct {

+  ACPI_LARGE_RESOURCE_HEADER    Header;

+  UINT8                         RevisionId;

+  UINT8                         ResourceSourceIndex;

+  UINT8                         SerialBusType;

+  UINT8                         GeneralFlags;

+  UINT16                        TypeSpecificFlags;

+  UINT8                         TypeSpecificRevisionId;

+  UINT16                        TypeDataLength;

+// Type specific data

+} EFI_ACPI_SERIAL_BUS_RESOURCE_DESCRIPTOR;

+

+#define EFI_ACPI_SERIAL_BUS_RESOURCE_TYPE_I2C   0x1

+#define EFI_ACPI_SERIAL_BUS_RESOURCE_TYPE_SPI   0x2

+#define EFI_ACPI_SERIAL_BUS_RESOURCE_TYPE_UART  0x3

+

+///

+/// Serial Bus Resource Descriptor (I2C)

+///

+typedef PACKED struct {

+  ACPI_LARGE_RESOURCE_HEADER    Header;

+  UINT8                         RevisionId;

+  UINT8                         ResourceSourceIndex;

+  UINT8                         SerialBusType;

+  UINT8                         GeneralFlags;

+  UINT16                        TypeSpecificFlags;

+  UINT8                         TypeSpecificRevisionId;

+  UINT16                        TypeDataLength;

+  UINT32                        ConnectionSpeed;

+  UINT16                        SlaveAddress;

+} EFI_ACPI_SERIAL_BUS_RESOURCE_I2C_DESCRIPTOR;

+

+///

+/// Serial Bus Resource Descriptor (SPI)

+///

+typedef PACKED struct {

+  ACPI_LARGE_RESOURCE_HEADER    Header;

+  UINT8                         RevisionId;

+  UINT8                         ResourceSourceIndex;

+  UINT8                         SerialBusType;

+  UINT8                         GeneralFlags;

+  UINT16                        TypeSpecificFlags;

+  UINT8                         TypeSpecificRevisionId;

+  UINT16                        TypeDataLength;

+  UINT32                        ConnectionSpeed;

+  UINT8                         DataBitLength;

+  UINT8                         Phase;

+  UINT8                         Polarity;

+  UINT16                        DeviceSelection;

+} EFI_ACPI_SERIAL_BUS_RESOURCE_SPI_DESCRIPTOR;

+

+///

+/// Serial Bus Resource Descriptor (UART)

+///

+typedef PACKED struct {

+  ACPI_LARGE_RESOURCE_HEADER    Header;

+  UINT8                         RevisionId;

+  UINT8                         ResourceSourceIndex;

+  UINT8                         SerialBusType;

+  UINT8                         GeneralFlags;

+  UINT16                        TypeSpecificFlags;

+  UINT8                         TypeSpecificRevisionId;

+  UINT16                        TypeDataLength;

+  UINT32                        DefaultBaudRate;

+  UINT16                        RxFIFO;

+  UINT16                        TxFIFO;

+  UINT8                         Parity;

+  UINT8                         SerialLinesEnabled;

+} EFI_ACPI_SERIAL_BUS_RESOURCE_UART_DESCRIPTOR;

+

+#pragma pack()

+

+//

+// Ensure proper structure formats

+//

+#pragma pack(1)

+

+///

+/// ACPI 5.0 Generic Address Space definition

+///

+typedef struct {

+  UINT8   AddressSpaceId;

+  UINT8   RegisterBitWidth;

+  UINT8   RegisterBitOffset;

+  UINT8   AccessSize;

+  UINT64  Address;

+} EFI_ACPI_5_0_GENERIC_ADDRESS_STRUCTURE;

+

+//

+// Generic Address Space Address IDs

+//

+#define EFI_ACPI_5_0_SYSTEM_MEMORY              0

+#define EFI_ACPI_5_0_SYSTEM_IO                  1

+#define EFI_ACPI_5_0_PCI_CONFIGURATION_SPACE    2

+#define EFI_ACPI_5_0_EMBEDDED_CONTROLLER        3

+#define EFI_ACPI_5_0_SMBUS                      4

+#define EFI_ACPI_5_0_PLATFORM_COMMUNICATION_CHANNEL  0x0A

+#define EFI_ACPI_5_0_FUNCTIONAL_FIXED_HARDWARE       0x7F

+

+//

+// Generic Address Space Access Sizes

+//

+#define EFI_ACPI_5_0_UNDEFINED  0

+#define EFI_ACPI_5_0_BYTE       1

+#define EFI_ACPI_5_0_WORD       2

+#define EFI_ACPI_5_0_DWORD      3

+#define EFI_ACPI_5_0_QWORD      4

+

+//

+// ACPI 5.0 table structures

+//

+

+///

+/// Root System Description Pointer Structure

+///

+typedef struct {

+  UINT64  Signature;

+  UINT8   Checksum;

+  UINT8   OemId[6];

+  UINT8   Revision;

+  UINT32  RsdtAddress;

+  UINT32  Length;

+  UINT64  XsdtAddress;

+  UINT8   ExtendedChecksum;

+  UINT8   Reserved[3];

+} EFI_ACPI_5_0_ROOT_SYSTEM_DESCRIPTION_POINTER;

+

+///

+/// RSD_PTR Revision (as defined in ACPI 5.0 spec.)

+///

+#define EFI_ACPI_5_0_ROOT_SYSTEM_DESCRIPTION_POINTER_REVISION 0x02  ///< ACPISpec (Revision 5.0) says current value is 2

+

+///

+/// Common table header, this prefaces all ACPI tables, including FACS, but

+/// excluding the RSD PTR structure

+///

+typedef struct {

+  UINT32  Signature;

+  UINT32  Length;

+} EFI_ACPI_5_0_COMMON_HEADER;

+

+//

+// Root System Description Table

+// No definition needed as it is a common description table header, the same with

+// EFI_ACPI_DESCRIPTION_HEADER, followed by a variable number of UINT32 table pointers.

+//

+

+///

+/// RSDT Revision (as defined in ACPI 5.0 spec.)

+///

+#define EFI_ACPI_5_0_ROOT_SYSTEM_DESCRIPTION_TABLE_REVISION 0x01

+

+//

+// Extended System Description Table

+// No definition needed as it is a common description table header, the same with

+// EFI_ACPI_DESCRIPTION_HEADER, followed by a variable number of UINT64 table pointers.

+//

+

+///

+/// XSDT Revision (as defined in ACPI 5.0 spec.)

+///

+#define EFI_ACPI_5_0_EXTENDED_SYSTEM_DESCRIPTION_TABLE_REVISION 0x01

+

+///

+/// Fixed ACPI Description Table Structure (FADT)

+///

+typedef struct {

+  EFI_ACPI_DESCRIPTION_HEADER             Header;

+  UINT32                                  FirmwareCtrl;

+  UINT32                                  Dsdt;

+  UINT8                                   Reserved0;

+  UINT8                                   PreferredPmProfile;

+  UINT16                                  SciInt;

+  UINT32                                  SmiCmd;

+  UINT8                                   AcpiEnable;

+  UINT8                                   AcpiDisable;

+  UINT8                                   S4BiosReq;

+  UINT8                                   PstateCnt;

+  UINT32                                  Pm1aEvtBlk;

+  UINT32                                  Pm1bEvtBlk;

+  UINT32                                  Pm1aCntBlk;

+  UINT32                                  Pm1bCntBlk;

+  UINT32                                  Pm2CntBlk;

+  UINT32                                  PmTmrBlk;

+  UINT32                                  Gpe0Blk;

+  UINT32                                  Gpe1Blk;

+  UINT8                                   Pm1EvtLen;

+  UINT8                                   Pm1CntLen;

+  UINT8                                   Pm2CntLen;

+  UINT8                                   PmTmrLen;

+  UINT8                                   Gpe0BlkLen;

+  UINT8                                   Gpe1BlkLen;

+  UINT8                                   Gpe1Base;

+  UINT8                                   CstCnt;

+  UINT16                                  PLvl2Lat;

+  UINT16                                  PLvl3Lat;

+  UINT16                                  FlushSize;

+  UINT16                                  FlushStride;

+  UINT8                                   DutyOffset;

+  UINT8                                   DutyWidth;

+  UINT8                                   DayAlrm;

+  UINT8                                   MonAlrm;

+  UINT8                                   Century;

+  UINT16                                  IaPcBootArch;

+  UINT8                                   Reserved1;

+  UINT32                                  Flags;

+  EFI_ACPI_5_0_GENERIC_ADDRESS_STRUCTURE  ResetReg;

+  UINT8                                   ResetValue;

+  UINT8                                   Reserved2[3];

+  UINT64                                  XFirmwareCtrl;

+  UINT64                                  XDsdt;

+  EFI_ACPI_5_0_GENERIC_ADDRESS_STRUCTURE  XPm1aEvtBlk;

+  EFI_ACPI_5_0_GENERIC_ADDRESS_STRUCTURE  XPm1bEvtBlk;

+  EFI_ACPI_5_0_GENERIC_ADDRESS_STRUCTURE  XPm1aCntBlk;

+  EFI_ACPI_5_0_GENERIC_ADDRESS_STRUCTURE  XPm1bCntBlk;

+  EFI_ACPI_5_0_GENERIC_ADDRESS_STRUCTURE  XPm2CntBlk;

+  EFI_ACPI_5_0_GENERIC_ADDRESS_STRUCTURE  XPmTmrBlk;

+  EFI_ACPI_5_0_GENERIC_ADDRESS_STRUCTURE  XGpe0Blk;

+  EFI_ACPI_5_0_GENERIC_ADDRESS_STRUCTURE  XGpe1Blk;

+  EFI_ACPI_5_0_GENERIC_ADDRESS_STRUCTURE  SleepControlReg;

+  EFI_ACPI_5_0_GENERIC_ADDRESS_STRUCTURE  SleepStatusReg;

+} EFI_ACPI_5_0_FIXED_ACPI_DESCRIPTION_TABLE;

+

+///

+/// FADT Version (as defined in ACPI 5.0 spec.)

+///

+#define EFI_ACPI_5_0_FIXED_ACPI_DESCRIPTION_TABLE_REVISION  0x05

+

+//

+// Fixed ACPI Description Table Preferred Power Management Profile

+//

+#define EFI_ACPI_5_0_PM_PROFILE_UNSPECIFIED         0

+#define EFI_ACPI_5_0_PM_PROFILE_DESKTOP             1

+#define EFI_ACPI_5_0_PM_PROFILE_MOBILE              2

+#define EFI_ACPI_5_0_PM_PROFILE_WORKSTATION         3

+#define EFI_ACPI_5_0_PM_PROFILE_ENTERPRISE_SERVER   4

+#define EFI_ACPI_5_0_PM_PROFILE_SOHO_SERVER         5

+#define EFI_ACPI_5_0_PM_PROFILE_APPLIANCE_PC        6

+#define EFI_ACPI_5_0_PM_PROFILE_PERFORMANCE_SERVER  7

+#define EFI_ACPI_5_0_PM_PROFILE_TABLET              8

+

+//

+// Fixed ACPI Description Table Boot Architecture Flags

+// All other bits are reserved and must be set to 0.

+//

+#define EFI_ACPI_5_0_LEGACY_DEVICES              BIT0

+#define EFI_ACPI_5_0_8042                        BIT1

+#define EFI_ACPI_5_0_VGA_NOT_PRESENT             BIT2

+#define EFI_ACPI_5_0_MSI_NOT_SUPPORTED           BIT3

+#define EFI_ACPI_5_0_PCIE_ASPM_CONTROLS          BIT4

+#define EFI_ACPI_5_0_CMOS_RTC_NOT_PRESENT        BIT5

+

+//

+// Fixed ACPI Description Table Fixed Feature Flags

+// All other bits are reserved and must be set to 0.

+//

+#define EFI_ACPI_5_0_WBINVD                                 BIT0

+#define EFI_ACPI_5_0_WBINVD_FLUSH                           BIT1

+#define EFI_ACPI_5_0_PROC_C1                                BIT2

+#define EFI_ACPI_5_0_P_LVL2_UP                              BIT3

+#define EFI_ACPI_5_0_PWR_BUTTON                             BIT4

+#define EFI_ACPI_5_0_SLP_BUTTON                             BIT5

+#define EFI_ACPI_5_0_FIX_RTC                                BIT6

+#define EFI_ACPI_5_0_RTC_S4                                 BIT7

+#define EFI_ACPI_5_0_TMR_VAL_EXT                            BIT8

+#define EFI_ACPI_5_0_DCK_CAP                                BIT9

+#define EFI_ACPI_5_0_RESET_REG_SUP                          BIT10

+#define EFI_ACPI_5_0_SEALED_CASE                            BIT11

+#define EFI_ACPI_5_0_HEADLESS                               BIT12

+#define EFI_ACPI_5_0_CPU_SW_SLP                             BIT13

+#define EFI_ACPI_5_0_PCI_EXP_WAK                            BIT14

+#define EFI_ACPI_5_0_USE_PLATFORM_CLOCK                     BIT15

+#define EFI_ACPI_5_0_S4_RTC_STS_VALID                       BIT16

+#define EFI_ACPI_5_0_REMOTE_POWER_ON_CAPABLE                BIT17

+#define EFI_ACPI_5_0_FORCE_APIC_CLUSTER_MODEL               BIT18

+#define EFI_ACPI_5_0_FORCE_APIC_PHYSICAL_DESTINATION_MODE   BIT19

+#define EFI_ACPI_5_0_HW_REDUCED_ACPI                        BIT20

+#define EFI_ACPI_5_0_LOW_POWER_S0_IDLE_CAPABLE              BIT21

+

+///

+/// Firmware ACPI Control Structure

+///

+typedef struct {

+  UINT32  Signature;

+  UINT32  Length;

+  UINT32  HardwareSignature;

+  UINT32  FirmwareWakingVector;

+  UINT32  GlobalLock;

+  UINT32  Flags;

+  UINT64  XFirmwareWakingVector;

+  UINT8   Version;

+  UINT8   Reserved0[3];

+  UINT32  OspmFlags;

+  UINT8   Reserved1[24];

+} EFI_ACPI_5_0_FIRMWARE_ACPI_CONTROL_STRUCTURE;

+

+///

+/// FACS Version (as defined in ACPI 5.0 spec.)

+///

+#define EFI_ACPI_5_0_FIRMWARE_ACPI_CONTROL_STRUCTURE_VERSION  0x02

+

+///

+/// Firmware Control Structure Feature Flags

+/// All other bits are reserved and must be set to 0.

+///

+#define EFI_ACPI_5_0_S4BIOS_F                     BIT0

+#define EFI_ACPI_5_0_64BIT_WAKE_SUPPORTED_F       BIT1

+

+///

+/// OSPM Enabled Firmware Control Structure Flags

+/// All other bits are reserved and must be set to 0.

+///

+#define EFI_ACPI_5_0_OSPM_64BIT_WAKE_F            BIT0

+

+//

+// Differentiated System Description Table,

+// Secondary System Description Table

+// and Persistent System Description Table,

+// no definition needed as they are common description table header, the same with

+// EFI_ACPI_DESCRIPTION_HEADER, followed by a definition block.

+//

+#define EFI_ACPI_5_0_DIFFERENTIATED_SYSTEM_DESCRIPTION_TABLE_REVISION   0x02

+#define EFI_ACPI_5_0_SECONDARY_SYSTEM_DESCRIPTION_TABLE_REVISION        0x02

+

+///

+/// Multiple APIC Description Table header definition.  The rest of the table

+/// must be defined in a platform specific manner.

+///

+typedef struct {

+  EFI_ACPI_DESCRIPTION_HEADER Header;

+  UINT32                      LocalApicAddress;

+  UINT32                      Flags;

+} EFI_ACPI_5_0_MULTIPLE_APIC_DESCRIPTION_TABLE_HEADER;

+

+///

+/// MADT Revision (as defined in ACPI 5.0 spec.)

+///

+#define EFI_ACPI_5_0_MULTIPLE_APIC_DESCRIPTION_TABLE_REVISION 0x03

+

+///

+/// Multiple APIC Flags

+/// All other bits are reserved and must be set to 0.

+///

+#define EFI_ACPI_5_0_PCAT_COMPAT         BIT0

+

+//

+// Multiple APIC Description Table APIC structure types

+// All other values between 0x0D and 0x7F are reserved and

+// will be ignored by OSPM. 0x80 ~ 0xFF are reserved for OEM.

+//

+#define EFI_ACPI_5_0_PROCESSOR_LOCAL_APIC           0x00

+#define EFI_ACPI_5_0_IO_APIC                        0x01

+#define EFI_ACPI_5_0_INTERRUPT_SOURCE_OVERRIDE      0x02

+#define EFI_ACPI_5_0_NON_MASKABLE_INTERRUPT_SOURCE  0x03

+#define EFI_ACPI_5_0_LOCAL_APIC_NMI                 0x04

+#define EFI_ACPI_5_0_LOCAL_APIC_ADDRESS_OVERRIDE    0x05

+#define EFI_ACPI_5_0_IO_SAPIC                       0x06

+#define EFI_ACPI_5_0_LOCAL_SAPIC                    0x07

+#define EFI_ACPI_5_0_PLATFORM_INTERRUPT_SOURCES     0x08

+#define EFI_ACPI_5_0_PROCESSOR_LOCAL_X2APIC         0x09

+#define EFI_ACPI_5_0_LOCAL_X2APIC_NMI               0x0A

+#define EFI_ACPI_5_0_GIC                            0x0B

+#define EFI_ACPI_5_0_GICD                           0x0C

+

+//

+// APIC Structure Definitions

+//

+

+///

+/// Processor Local APIC Structure Definition

+///

+typedef struct {

+  UINT8   Type;

+  UINT8   Length;

+  UINT8   AcpiProcessorId;

+  UINT8   ApicId;

+  UINT32  Flags;

+} EFI_ACPI_5_0_PROCESSOR_LOCAL_APIC_STRUCTURE;

+

+///

+/// Local APIC Flags.  All other bits are reserved and must be 0.

+///

+#define EFI_ACPI_5_0_LOCAL_APIC_ENABLED        BIT0

+

+///

+/// IO APIC Structure

+///

+typedef struct {

+  UINT8   Type;

+  UINT8   Length;

+  UINT8   IoApicId;

+  UINT8   Reserved;

+  UINT32  IoApicAddress;

+  UINT32  GlobalSystemInterruptBase;

+} EFI_ACPI_5_0_IO_APIC_STRUCTURE;

+

+///

+/// Interrupt Source Override Structure

+///

+typedef struct {

+  UINT8   Type;

+  UINT8   Length;

+  UINT8   Bus;

+  UINT8   Source;

+  UINT32  GlobalSystemInterrupt;

+  UINT16  Flags;

+} EFI_ACPI_5_0_INTERRUPT_SOURCE_OVERRIDE_STRUCTURE;

+

+///

+/// Platform Interrupt Sources Structure Definition

+///

+typedef struct {

+  UINT8   Type;

+  UINT8   Length;

+  UINT16  Flags;

+  UINT8   InterruptType;

+  UINT8   ProcessorId;

+  UINT8   ProcessorEid;

+  UINT8   IoSapicVector;

+  UINT32  GlobalSystemInterrupt;

+  UINT32  PlatformInterruptSourceFlags;

+  UINT8   CpeiProcessorOverride;

+  UINT8   Reserved[31];

+} EFI_ACPI_5_0_PLATFORM_INTERRUPT_APIC_STRUCTURE;

+

+//

+// MPS INTI flags.

+// All other bits are reserved and must be set to 0.

+//

+#define EFI_ACPI_5_0_POLARITY      (3 << 0)

+#define EFI_ACPI_5_0_TRIGGER_MODE  (3 << 2)

+

+///

+/// Non-Maskable Interrupt Source Structure

+///

+typedef struct {

+  UINT8   Type;

+  UINT8   Length;

+  UINT16  Flags;

+  UINT32  GlobalSystemInterrupt;

+} EFI_ACPI_5_0_NON_MASKABLE_INTERRUPT_SOURCE_STRUCTURE;

+

+///

+/// Local APIC NMI Structure

+///

+typedef struct {

+  UINT8   Type;

+  UINT8   Length;

+  UINT8   AcpiProcessorId;

+  UINT16  Flags;

+  UINT8   LocalApicLint;

+} EFI_ACPI_5_0_LOCAL_APIC_NMI_STRUCTURE;

+

+///

+/// Local APIC Address Override Structure

+///

+typedef struct {

+  UINT8   Type;

+  UINT8   Length;

+  UINT16  Reserved;

+  UINT64  LocalApicAddress;

+} EFI_ACPI_5_0_LOCAL_APIC_ADDRESS_OVERRIDE_STRUCTURE;

+

+///

+/// IO SAPIC Structure

+///

+typedef struct {

+  UINT8   Type;

+  UINT8   Length;

+  UINT8   IoApicId;

+  UINT8   Reserved;

+  UINT32  GlobalSystemInterruptBase;

+  UINT64  IoSapicAddress;

+} EFI_ACPI_5_0_IO_SAPIC_STRUCTURE;

+

+///

+/// Local SAPIC Structure

+/// This struct followed by a null-terminated ASCII string - ACPI Processor UID String

+///

+typedef struct {

+  UINT8   Type;

+  UINT8   Length;

+  UINT8   AcpiProcessorId;

+  UINT8   LocalSapicId;

+  UINT8   LocalSapicEid;

+  UINT8   Reserved[3];

+  UINT32  Flags;

+  UINT32  ACPIProcessorUIDValue;

+} EFI_ACPI_5_0_PROCESSOR_LOCAL_SAPIC_STRUCTURE;

+

+///

+/// Platform Interrupt Sources Structure

+///

+typedef struct {

+  UINT8   Type;

+  UINT8   Length;

+  UINT16  Flags;

+  UINT8   InterruptType;

+  UINT8   ProcessorId;

+  UINT8   ProcessorEid;

+  UINT8   IoSapicVector;

+  UINT32  GlobalSystemInterrupt;

+  UINT32  PlatformInterruptSourceFlags;

+} EFI_ACPI_5_0_PLATFORM_INTERRUPT_SOURCES_STRUCTURE;

+

+///

+/// Platform Interrupt Source Flags.

+/// All other bits are reserved and must be set to 0.

+///

+#define EFI_ACPI_5_0_CPEI_PROCESSOR_OVERRIDE          BIT0

+

+///

+/// Processor Local x2APIC Structure Definition

+///

+typedef struct {

+  UINT8   Type;

+  UINT8   Length;

+  UINT8   Reserved[2];

+  UINT32  X2ApicId;

+  UINT32  Flags;

+  UINT32  AcpiProcessorUid;

+} EFI_ACPI_5_0_PROCESSOR_LOCAL_X2APIC_STRUCTURE;

+

+///

+/// Local x2APIC NMI Structure

+///

+typedef struct {

+  UINT8   Type;

+  UINT8   Length;

+  UINT16  Flags;

+  UINT32  AcpiProcessorUid;

+  UINT8   LocalX2ApicLint;

+  UINT8   Reserved[3];

+} EFI_ACPI_5_0_LOCAL_X2APIC_NMI_STRUCTURE;

+

+///

+/// GIC Structure

+///

+typedef struct {

+  UINT8   Type;

+  UINT8   Length;

+  UINT16  Reserved;

+  UINT32  GicId;

+  UINT32  AcpiProcessorUid;

+  UINT32  Flags;

+  UINT32  ParkingProtocolVersion;

+  UINT32  PerformanceInterruptGsiv;

+  UINT64  ParkedAddress;

+  UINT64  PhysicalBaseAddress;

+} EFI_ACPI_5_0_GIC_STRUCTURE;

+

+///

+/// GIC Flags.  All other bits are reserved and must be 0.

+///

+#define EFI_ACPI_5_0_GIC_ENABLED                     BIT0

+#define EFI_ACPI_5_0_PERFORMANCE_INTERRUPT_MODEL     BIT1

+

+///

+/// GIC Distributor Structure

+///

+typedef struct {

+  UINT8   Type;

+  UINT8   Length;

+  UINT16  Reserved1;

+  UINT32  GicId;

+  UINT64  PhysicalBaseAddress;

+  UINT32  SystemVectorBase;

+  UINT32  Reserved2;

+} EFI_ACPI_5_0_GIC_DISTRIBUTOR_STRUCTURE;

+

+///

+/// Smart Battery Description Table (SBST)

+///

+typedef struct {

+  EFI_ACPI_DESCRIPTION_HEADER Header;

+  UINT32                      WarningEnergyLevel;

+  UINT32                      LowEnergyLevel;

+  UINT32                      CriticalEnergyLevel;

+} EFI_ACPI_5_0_SMART_BATTERY_DESCRIPTION_TABLE;

+

+///

+/// SBST Version (as defined in ACPI 5.0 spec.)

+///

+#define EFI_ACPI_5_0_SMART_BATTERY_DESCRIPTION_TABLE_REVISION 0x01

+

+///

+/// Embedded Controller Boot Resources Table (ECDT)

+/// The table is followed by a null terminated ASCII string that contains

+/// a fully qualified reference to the name space object.

+///

+typedef struct {

+  EFI_ACPI_DESCRIPTION_HEADER             Header;

+  EFI_ACPI_5_0_GENERIC_ADDRESS_STRUCTURE  EcControl;

+  EFI_ACPI_5_0_GENERIC_ADDRESS_STRUCTURE  EcData;

+  UINT32                                  Uid;

+  UINT8                                   GpeBit;

+} EFI_ACPI_5_0_EMBEDDED_CONTROLLER_BOOT_RESOURCES_TABLE;

+

+///

+/// ECDT Version (as defined in ACPI 5.0 spec.)

+///

+#define EFI_ACPI_5_0_EMBEDDED_CONTROLLER_BOOT_RESOURCES_TABLE_REVISION  0x01

+

+///

+/// System Resource Affinity Table (SRAT).  The rest of the table

+/// must be defined in a platform specific manner.

+///

+typedef struct {

+  EFI_ACPI_DESCRIPTION_HEADER Header;

+  UINT32                      Reserved1;  ///< Must be set to 1

+  UINT64                      Reserved2;

+} EFI_ACPI_5_0_SYSTEM_RESOURCE_AFFINITY_TABLE_HEADER;

+

+///

+/// SRAT Version (as defined in ACPI 5.0 spec.)

+///

+#define EFI_ACPI_5_0_SYSTEM_RESOURCE_AFFINITY_TABLE_REVISION  0x03

+

+//

+// SRAT structure types.

+// All other values between 0x03 an 0xFF are reserved and

+// will be ignored by OSPM.

+//

+#define EFI_ACPI_5_0_PROCESSOR_LOCAL_APIC_SAPIC_AFFINITY  0x00

+#define EFI_ACPI_5_0_MEMORY_AFFINITY                      0x01

+#define EFI_ACPI_5_0_PROCESSOR_LOCAL_X2APIC_AFFINITY      0x02

+

+///

+/// Processor Local APIC/SAPIC Affinity Structure Definition

+///

+typedef struct {

+  UINT8   Type;

+  UINT8   Length;

+  UINT8   ProximityDomain7To0;

+  UINT8   ApicId;

+  UINT32  Flags;

+  UINT8   LocalSapicEid;

+  UINT8   ProximityDomain31To8[3];

+  UINT32  ClockDomain;

+} EFI_ACPI_5_0_PROCESSOR_LOCAL_APIC_SAPIC_AFFINITY_STRUCTURE;

+

+///

+/// Local APIC/SAPIC Flags.  All other bits are reserved and must be 0.

+///

+#define EFI_ACPI_5_0_PROCESSOR_LOCAL_APIC_SAPIC_ENABLED (1 << 0)

+

+///

+/// Memory Affinity Structure Definition

+///

+typedef struct {

+  UINT8   Type;

+  UINT8   Length;

+  UINT32  ProximityDomain;

+  UINT16  Reserved1;

+  UINT32  AddressBaseLow;

+  UINT32  AddressBaseHigh;

+  UINT32  LengthLow;

+  UINT32  LengthHigh;

+  UINT32  Reserved2;

+  UINT32  Flags;

+  UINT64  Reserved3;

+} EFI_ACPI_5_0_MEMORY_AFFINITY_STRUCTURE;

+

+//

+// Memory Flags.  All other bits are reserved and must be 0.

+//

+#define EFI_ACPI_5_0_MEMORY_ENABLED       (1 << 0)

+#define EFI_ACPI_5_0_MEMORY_HOT_PLUGGABLE (1 << 1)

+#define EFI_ACPI_5_0_MEMORY_NONVOLATILE   (1 << 2)

+

+///

+/// Processor Local x2APIC Affinity Structure Definition

+///

+typedef struct {

+  UINT8   Type;

+  UINT8   Length;

+  UINT8   Reserved1[2];

+  UINT32  ProximityDomain;

+  UINT32  X2ApicId;

+  UINT32  Flags;

+  UINT32  ClockDomain;

+  UINT8   Reserved2[4];

+} EFI_ACPI_5_0_PROCESSOR_LOCAL_X2APIC_AFFINITY_STRUCTURE;

+

+///

+/// System Locality Distance Information Table (SLIT).

+/// The rest of the table is a matrix.

+///

+typedef struct {

+  EFI_ACPI_DESCRIPTION_HEADER Header;

+  UINT64                      NumberOfSystemLocalities;

+} EFI_ACPI_5_0_SYSTEM_LOCALITY_DISTANCE_INFORMATION_TABLE_HEADER;

+

+///

+/// SLIT Version (as defined in ACPI 5.0 spec.)

+///

+#define EFI_ACPI_5_0_SYSTEM_LOCALITY_DISTANCE_INFORMATION_TABLE_REVISION  0x01

+

+///

+/// Corrected Platform Error Polling Table (CPEP)

+///

+typedef struct {

+  EFI_ACPI_DESCRIPTION_HEADER Header;

+  UINT8                       Reserved[8];

+} EFI_ACPI_5_0_CORRECTED_PLATFORM_ERROR_POLLING_TABLE_HEADER;

+

+///

+/// CPEP Version (as defined in ACPI 5.0 spec.)

+///

+#define EFI_ACPI_5_0_CORRECTED_PLATFORM_ERROR_POLLING_TABLE_REVISION 0x01

+

+//

+// CPEP processor structure types.

+//

+#define EFI_ACPI_5_0_CPEP_PROCESSOR_APIC_SAPIC  0x00

+

+///

+/// Corrected Platform Error Polling Processor Structure Definition

+///

+typedef struct {

+  UINT8   Type;

+  UINT8   Length;

+  UINT8   ProcessorId;

+  UINT8   ProcessorEid;

+  UINT32  PollingInterval;

+} EFI_ACPI_5_0_CPEP_PROCESSOR_APIC_SAPIC_STRUCTURE;

+

+///

+/// Maximum System Characteristics Table (MSCT)

+///

+typedef struct {

+  EFI_ACPI_DESCRIPTION_HEADER Header;

+  UINT32                      OffsetProxDomInfo;

+  UINT32                      MaximumNumberOfProximityDomains;

+  UINT32                      MaximumNumberOfClockDomains;

+  UINT64                      MaximumPhysicalAddress;

+} EFI_ACPI_5_0_MAXIMUM_SYSTEM_CHARACTERISTICS_TABLE_HEADER;

+

+///

+/// MSCT Version (as defined in ACPI 5.0 spec.)

+///

+#define EFI_ACPI_5_0_MAXIMUM_SYSTEM_CHARACTERISTICS_TABLE_REVISION 0x01

+

+///

+/// Maximum Proximity Domain Information Structure Definition

+///

+typedef struct {

+  UINT8   Revision;

+  UINT8   Length;

+  UINT32  ProximityDomainRangeLow;

+  UINT32  ProximityDomainRangeHigh;

+  UINT32  MaximumProcessorCapacity;

+  UINT64  MaximumMemoryCapacity;

+} EFI_ACPI_5_0_MAXIMUM_PROXIMITY_DOMAIN_INFORMATION_STRUCTURE;

+

+///

+/// ACPI RAS Feature Table definition.

+///

+typedef struct {

+  EFI_ACPI_DESCRIPTION_HEADER Header;

+  UINT8                       PlatformCommunicationChannelIdentifier[12];

+} EFI_ACPI_5_0_RAS_FEATURE_TABLE;

+

+///

+/// RASF Version (as defined in ACPI 5.0 spec.)

+///

+#define EFI_ACPI_5_0_RAS_FEATURE_TABLE_REVISION 0x01

+

+///

+/// ACPI RASF Platform Communication Channel Shared Memory Region definition.

+///

+typedef struct {

+  UINT32                      Signature;

+  UINT16                      Command;

+  UINT16                      Status;

+  UINT16                      Version;

+  UINT8                       RASCapabilities[16];

+  UINT8                       SetRASCapabilities[16];

+  UINT16                      NumberOfRASFParameterBlocks;

+  UINT32                      SetRASCapabilitiesStatus;

+} EFI_ACPI_5_0_RASF_PLATFORM_COMMUNICATION_CHANNEL_SHARED_MEMORY_REGION;

+

+///

+/// ACPI RASF PCC command code

+///

+#define EFI_ACPI_5_0_RASF_PCC_COMMAND_CODE_EXECUTE_RASF_COMMAND  0x01

+

+///

+/// ACPI RASF Platform RAS Capabilities

+///

+#define EFI_ACPI_5_0_RASF_PLATFORM_RAS_CAPABILITY_HARDWARE_BASED_PATROL_SCRUB_SUPPOTED                          0x01

+#define EFI_ACPI_5_0_RASF_PLATFORM_RAS_CAPABILITY_HARDWARE_BASED_PATROL_SCRUB_SUPPOTED_AND_EXPOSED_TO_SOFTWARE  0x02

+

+///

+/// ACPI RASF Parameter Block structure for PATROL_SCRUB

+///

+typedef struct {

+  UINT16                      Type;

+  UINT16                      Version;

+  UINT16                      Length;

+  UINT16                      PatrolScrubCommand;

+  UINT64                      RequestedAddressRange[2];

+  UINT64                      ActualAddressRange[2];

+  UINT16                      Flags;

+  UINT8                       RequestedSpeed;

+} EFI_ACPI_5_0_RASF_PATROL_SCRUB_PLATFORM_BLOCK_STRUCTURE;

+

+///

+/// ACPI RASF Patrol Scrub command

+///

+#define EFI_ACPI_5_0_RASF_PATROL_SCRUB_COMMAND_GET_PATROL_PARAMETERS   0x01

+#define EFI_ACPI_5_0_RASF_PATROL_SCRUB_COMMAND_START_PATROL_SCRUBBER   0x02

+#define EFI_ACPI_5_0_RASF_PATROL_SCRUB_COMMAND_STOP_PATROL_SCRUBBER    0x03

+

+///

+/// Memory Power State Table definition.

+///

+typedef struct {

+  EFI_ACPI_DESCRIPTION_HEADER Header;

+  UINT8                       PlatformCommunicationChannelIdentifier;

+  UINT8                       Reserved[3];

+// Memory Power Node Structure

+// Memory Power State Characteristics

+} EFI_ACPI_5_0_MEMORY_POWER_STATUS_TABLE;

+

+///

+/// MPST Version (as defined in ACPI 5.0 spec.)

+///

+#define EFI_ACPI_5_0_MEMORY_POWER_STATE_TABLE_REVISION 0x01

+

+///

+/// MPST Platform Communication Channel Shared Memory Region definition.

+///

+typedef struct {

+  UINT32                      Signature;

+  UINT16                      Command;

+  UINT16                      Status;

+  UINT32                      MemoryPowerCommandRegister;

+  UINT32                      MemoryPowerStatusRegister;

+  UINT32                      PowerStateId;

+  UINT32                      MemoryPowerNodeId;

+  UINT64                      MemoryEnergyConsumed;

+  UINT64                      ExpectedAveragePowerComsuned;

+} EFI_ACPI_5_0_MPST_PLATFORM_COMMUNICATION_CHANNEL_SHARED_MEMORY_REGION;

+

+///

+/// ACPI MPST PCC command code

+///

+#define EFI_ACPI_5_0_MPST_PCC_COMMAND_CODE_EXECUTE_MPST_COMMAND  0x03

+

+///

+/// ACPI MPST Memory Power command

+///

+#define EFI_ACPI_5_0_MPST_MEMORY_POWER_COMMAND_GET_MEMORY_POWER_STATE       0x01

+#define EFI_ACPI_5_0_MPST_MEMORY_POWER_COMMAND_SET_MEMORY_POWER_STATE       0x02

+#define EFI_ACPI_5_0_MPST_MEMORY_POWER_COMMAND_GET_AVERAGE_POWER_CONSUMED   0x03

+#define EFI_ACPI_5_0_MPST_MEMORY_POWER_COMMAND_GET_MEMORY_ENERGY_CONSUMED   0x04

+

+///

+/// MPST Memory Power Node Table

+///

+typedef struct {

+  UINT8                                             PowerStateValue;

+  UINT8                                             PowerStateInformationIndex;

+} EFI_ACPI_5_0_MPST_MEMORY_POWER_STATE;

+

+typedef struct {

+  UINT8                                             Flag;

+  UINT8                                             Reserved;

+  UINT16                                            MemoryPowerNodeId;

+  UINT32                                            Length;

+  UINT64                                            AddressBase;

+  UINT64                                            AddressLength;

+  UINT32                                            NumberOfPowerStates;

+  UINT32                                            NumberOfPhysicalComponents;

+//EFI_ACPI_5_0_MPST_MEMORY_POWER_STATE              MemoryPowerState[NumberOfPowerStates];

+//UINT16                                            PhysicalComponentIdentifier[NumberOfPhysicalComponents];

+} EFI_ACPI_5_0_MPST_MEMORY_POWER_STRUCTURE;

+

+#define EFI_ACPI_5_0_MPST_MEMORY_POWER_STRUCTURE_FLAG_ENABLE          0x01

+#define EFI_ACPI_5_0_MPST_MEMORY_POWER_STRUCTURE_FLAG_POWER_MANAGED   0x02

+#define EFI_ACPI_5_0_MPST_MEMORY_POWER_STRUCTURE_FLAG_HOT_PLUGGABLE   0x04

+

+typedef struct {

+  UINT16                      MemoryPowerNodeCount;

+  UINT8                       Reserved[2];

+} EFI_ACPI_5_0_MPST_MEMORY_POWER_NODE_TABLE;

+

+///

+/// MPST Memory Power State Characteristics Table

+///

+typedef struct {

+  UINT8                                             PowerStateStructureID;

+  UINT8                                             Flag;

+  UINT16                                            Reserved;

+  UINT32                                            AveragePowerConsumedInMPS0;

+  UINT32                                            RelativePowerSavingToMPS0;

+  UINT64                                            ExitLatencyToMPS0;

+} EFI_ACPI_5_0_MPST_MEMORY_POWER_STATE_CHARACTERISTICS_STRUCTURE;

+

+#define EFI_ACPI_5_0_MPST_MEMORY_POWER_STATE_CHARACTERISTICS_STRUCTURE_FLAG_MEMORY_CONTENT_PRESERVED              0x01

+#define EFI_ACPI_5_0_MPST_MEMORY_POWER_STATE_CHARACTERISTICS_STRUCTURE_FLAG_AUTONOMOUS_MEMORY_POWER_STATE_ENTRY   0x02

+#define EFI_ACPI_5_0_MPST_MEMORY_POWER_STATE_CHARACTERISTICS_STRUCTURE_FLAG_AUTONOMOUS_MEMORY_POWER_STATE_EXIT    0x04

+

+typedef struct {

+  UINT16                      MemoryPowerStateCharacteristicsCount;

+  UINT8                       Reserved[2];

+} EFI_ACPI_5_0_MPST_MEMORY_POWER_STATE_CHARACTERISTICS_TABLE;

+

+///

+/// Memory Topology Table definition.

+///

+typedef struct {

+  EFI_ACPI_DESCRIPTION_HEADER Header;

+  UINT32                      Reserved;

+} EFI_ACPI_5_0_MEMORY_TOPOLOGY_TABLE;

+

+///

+/// PMTT Version (as defined in ACPI 5.0 spec.)

+///

+#define EFI_ACPI_5_0_MEMORY_TOPOLOGY_TABLE_REVISION 0x01

+

+///

+/// Common Memory Aggregator Device Structure.

+///

+typedef struct {

+  UINT8                       Type;

+  UINT8                       Reserved;

+  UINT16                      Length;

+  UINT16                      Flags;

+  UINT16                      Reserved1;

+} EFI_ACPI_5_0_PMMT_COMMON_MEMORY_AGGREGATOR_DEVICE_STRUCTURE;

+

+///

+/// Memory Aggregator Device Type

+///

+#define EFI_ACPI_5_0_PMMT_MEMORY_AGGREGATOR_DEVICE_TYPE_SOCKET            0x1

+#define EFI_ACPI_5_0_PMMT_MEMORY_AGGREGATOR_DEVICE_TYPE_MEMORY_CONTROLLER 0x2

+#define EFI_ACPI_5_0_PMMT_MEMORY_AGGREGATOR_DEVICE_TYPE_DIMM              0x3

+

+///

+/// Socket Memory Aggregator Device Structure.

+///

+typedef struct {

+  EFI_ACPI_5_0_PMMT_COMMON_MEMORY_AGGREGATOR_DEVICE_STRUCTURE  Header;

+  UINT16                                                       SocketIdentifier;

+  UINT16                                                       Reserved;

+//EFI_ACPI_5_0_PMMT_MEMORY_CONTROLLER_MEMORY_AGGREGATOR_DEVICE_STRUCTURE  MemoryController[];

+} EFI_ACPI_5_0_PMMT_SOCKET_MEMORY_AGGREGATOR_DEVICE_STRUCTURE;

+

+///

+/// MemoryController Memory Aggregator Device Structure.

+///

+typedef struct {

+  EFI_ACPI_5_0_PMMT_COMMON_MEMORY_AGGREGATOR_DEVICE_STRUCTURE  Header;

+  UINT32                                                       ReadLatency;

+  UINT32                                                       WriteLatency;

+  UINT32                                                       ReadBandwidth;

+  UINT32                                                       WriteBandwidth;

+  UINT16                                                       OptimalAccessUnit;

+  UINT16                                                       OptimalAccessAlignment;

+  UINT16                                                       Reserved;

+  UINT16                                                       NumberOfProximityDomains;

+//UINT32                                                       ProximityDomain[NumberOfProximityDomains];

+//EFI_ACPI_5_0_PMMT_DIMM_MEMORY_AGGREGATOR_DEVICE_STRUCTURE    PhysicalComponent[];

+} EFI_ACPI_5_0_PMMT_MEMORY_CONTROLLER_MEMORY_AGGREGATOR_DEVICE_STRUCTURE;

+

+///

+/// DIMM Memory Aggregator Device Structure.

+///

+typedef struct {

+  EFI_ACPI_5_0_PMMT_COMMON_MEMORY_AGGREGATOR_DEVICE_STRUCTURE  Header;

+  UINT16                                                       PhysicalComponentIdentifier;

+  UINT16                                                       Reserved;

+  UINT32                                                       SizeOfDimm;

+  UINT32                                                       SmbiosHandle;

+} EFI_ACPI_5_0_PMMT_DIMM_MEMORY_AGGREGATOR_DEVICE_STRUCTURE;

+

+///

+/// Boot Graphics Resource Table definition.

+///

+typedef struct {

+  EFI_ACPI_DESCRIPTION_HEADER Header;

+  ///

+  /// 2-bytes (16 bit) version ID. This value must be 1.

+  ///

+  UINT16                      Version;

+  ///

+  /// 1-byte status field indicating current status about the table.

+  ///     Bits[7:1] = Reserved (must be zero)

+  ///     Bit [0] = Valid. A one indicates the boot image graphic is valid.

+  ///

+  UINT8                       Status;

+  ///

+  /// 1-byte enumerated type field indicating format of the image.

+  ///     0 = Bitmap

+  ///     1 - 255  Reserved (for future use)

+  ///

+  UINT8                       ImageType;

+  ///

+  /// 8-byte (64 bit) physical address pointing to the firmware's in-memory copy

+  /// of the image bitmap.

+  ///

+  UINT64                      ImageAddress;

+  ///

+  /// A 4-byte (32-bit) unsigned long describing the display X-offset of the boot image.

+  /// (X, Y) display offset of the top left corner of the boot image.

+  /// The top left corner of the display is at offset (0, 0).

+  ///

+  UINT32                      ImageOffsetX;

+  ///

+  /// A 4-byte (32-bit) unsigned long describing the display Y-offset of the boot image.

+  /// (X, Y) display offset of the top left corner of the boot image.

+  /// The top left corner of the display is at offset (0, 0).

+  ///

+  UINT32                      ImageOffsetY;

+} EFI_ACPI_5_0_BOOT_GRAPHICS_RESOURCE_TABLE;

+

+///

+/// BGRT Revision

+///

+#define EFI_ACPI_5_0_BOOT_GRAPHICS_RESOURCE_TABLE_REVISION 1

+

+///

+/// BGRT Version

+///

+#define EFI_ACPI_5_0_BGRT_VERSION         0x01

+

+///

+/// BGRT Status

+///

+#define EFI_ACPI_5_0_BGRT_STATUS_NOT_DISPLAYED 0x00

+#define EFI_ACPI_5_0_BGRT_STATUS_DISPLAYED     0x01

+#define EFI_ACPI_5_0_BGRT_STATUS_INVALID       EFI_ACPI_5_0_BGRT_STATUS_NOT_DISPLAYED

+#define EFI_ACPI_5_0_BGRT_STATUS_VALID         EFI_ACPI_5_0_BGRT_STATUS_DISPLAYED

+

+///

+/// BGRT Image Type

+///

+#define EFI_ACPI_5_0_BGRT_IMAGE_TYPE_BMP  0x00

+

+///

+/// FPDT Version (as defined in ACPI 5.0 spec.)

+///

+#define EFI_ACPI_5_0_FIRMWARE_PERFORMANCE_DATA_TABLE_REVISION 0x01

+

+///

+/// FPDT Performance Record Types

+///

+#define EFI_ACPI_5_0_FPDT_RECORD_TYPE_FIRMWARE_BASIC_BOOT_POINTER      0x0000

+#define EFI_ACPI_5_0_FPDT_RECORD_TYPE_S3_PERFORMANCE_TABLE_POINTER     0x0001

+

+///

+/// FPDT Performance Record Revision

+///

+#define EFI_ACPI_5_0_FPDT_RECORD_REVISION_FIRMWARE_BASIC_BOOT_POINTER  0x01

+#define EFI_ACPI_5_0_FPDT_RECORD_REVISION_S3_PERFORMANCE_TABLE_POINTER 0x01

+

+///

+/// FPDT Runtime Performance Record Types

+///

+#define EFI_ACPI_5_0_FPDT_RUNTIME_RECORD_TYPE_S3_RESUME                0x0000

+#define EFI_ACPI_5_0_FPDT_RUNTIME_RECORD_TYPE_S3_SUSPEND               0x0001

+#define EFI_ACPI_5_0_FPDT_RUNTIME_RECORD_TYPE_FIRMWARE_BASIC_BOOT      0x0002

+

+///

+/// FPDT Runtime Performance Record Revision

+///

+#define EFI_ACPI_5_0_FPDT_RUNTIME_RECORD_REVISION_S3_RESUME            0x01

+#define EFI_ACPI_5_0_FPDT_RUNTIME_RECORD_REVISION_S3_SUSPEND           0x01

+#define EFI_ACPI_5_0_FPDT_RUNTIME_RECORD_REVISION_FIRMWARE_BASIC_BOOT  0x02

+

+///

+/// FPDT Performance Record header

+///

+typedef struct {

+  UINT16           Type;

+  UINT8            Length;

+  UINT8            Revision;

+} EFI_ACPI_5_0_FPDT_PERFORMANCE_RECORD_HEADER;

+

+///

+/// FPDT Performance Table header

+///

+typedef struct {

+  UINT32  Signature;

+  UINT32  Length;

+} EFI_ACPI_5_0_FPDT_PERFORMANCE_TABLE_HEADER;

+

+///

+/// FPDT Firmware Basic Boot Performance Pointer Record Structure

+///

+typedef struct {

+  EFI_ACPI_5_0_FPDT_PERFORMANCE_RECORD_HEADER     Header;

+  UINT32                                          Reserved;

+  ///

+  /// 64-bit processor-relative physical address of the Basic Boot Performance Table.

+  ///

+  UINT64                                          BootPerformanceTablePointer;

+} EFI_ACPI_5_0_FPDT_BOOT_PERFORMANCE_TABLE_POINTER_RECORD;

+

+///

+/// FPDT S3 Performance Table Pointer Record Structure

+///

+typedef struct {

+  EFI_ACPI_5_0_FPDT_PERFORMANCE_RECORD_HEADER     Header;

+  UINT32                                          Reserved;

+  ///

+  /// 64-bit processor-relative physical address of the S3 Performance Table.

+  ///

+  UINT64                                          S3PerformanceTablePointer;

+} EFI_ACPI_5_0_FPDT_S3_PERFORMANCE_TABLE_POINTER_RECORD;

+

+///

+/// FPDT Firmware Basic Boot Performance Record Structure

+///

+typedef struct {

+  EFI_ACPI_5_0_FPDT_PERFORMANCE_RECORD_HEADER     Header;

+  UINT32                                          Reserved;

+  ///

+  /// Timer value logged at the beginning of firmware image execution.

+  /// This may not always be zero or near zero.

+  ///

+  UINT64                                          ResetEnd;

+  ///

+  /// Timer value logged just prior to loading the OS boot loader into memory.

+  /// For non-UEFI compatible boots, this field must be zero.

+  ///

+  UINT64                                          OsLoaderLoadImageStart;

+  ///

+  /// Timer value logged just prior to launching the previously loaded OS boot loader image.

+  /// For non-UEFI compatible boots, the timer value logged will be just prior

+  /// to the INT 19h handler invocation.

+  ///

+  UINT64                                          OsLoaderStartImageStart;

+  ///

+  /// Timer value logged at the point when the OS loader calls the

+  /// ExitBootServices function for UEFI compatible firmware.

+  /// For non-UEFI compatible boots, this field must be zero.

+  ///

+  UINT64                                          ExitBootServicesEntry;

+  ///

+  /// Timer value logged at the point just prior to when the OS loader gaining

+  /// control back from calls the ExitBootServices function for UEFI compatible firmware.

+  /// For non-UEFI compatible boots, this field must be zero.

+  ///

+  UINT64                                          ExitBootServicesExit;

+} EFI_ACPI_5_0_FPDT_FIRMWARE_BASIC_BOOT_RECORD;

+

+///

+/// FPDT Firmware Basic Boot Performance Table signature

+///

+#define EFI_ACPI_5_0_FPDT_BOOT_PERFORMANCE_TABLE_SIGNATURE  SIGNATURE_32('F', 'B', 'P', 'T')

+

+//

+// FPDT Firmware Basic Boot Performance Table

+//

+typedef struct {

+  EFI_ACPI_5_0_FPDT_PERFORMANCE_TABLE_HEADER      Header;

+  //

+  // one or more Performance Records.

+  //

+} EFI_ACPI_5_0_FPDT_FIRMWARE_BASIC_BOOT_TABLE;

+

+///

+/// FPDT "S3PT" S3 Performance Table

+///

+#define EFI_ACPI_5_0_FPDT_S3_PERFORMANCE_TABLE_SIGNATURE  SIGNATURE_32('S', '3', 'P', 'T')

+

+//

+// FPDT Firmware S3 Boot Performance Table

+//

+typedef struct {

+  EFI_ACPI_5_0_FPDT_PERFORMANCE_TABLE_HEADER      Header;

+  //

+  // one or more Performance Records.

+  //

+} EFI_ACPI_5_0_FPDT_FIRMWARE_S3_BOOT_TABLE;

+

+///

+/// FPDT Basic S3 Resume Performance Record

+///

+typedef struct {

+  EFI_ACPI_5_0_FPDT_PERFORMANCE_RECORD_HEADER     Header;

+  ///

+  /// A count of the number of S3 resume cycles since the last full boot sequence.

+  ///

+  UINT32                                          ResumeCount;

+  ///

+  /// Timer recorded at the end of BIOS S3 resume, just prior to handoff to the

+  /// OS waking vector. Only the most recent resume cycle's time is retained.

+  ///

+  UINT64                                          FullResume;

+  ///

+  /// Average timer value of all resume cycles logged since the last full boot

+  /// sequence, including the most recent resume.  Note that the entire log of

+  /// timer values does not need to be retained in order to calculate this average.

+  ///

+  UINT64                                          AverageResume;

+} EFI_ACPI_5_0_FPDT_S3_RESUME_RECORD;

+

+///

+/// FPDT Basic S3 Suspend Performance Record

+///

+typedef struct {

+  EFI_ACPI_5_0_FPDT_PERFORMANCE_RECORD_HEADER     Header;

+  ///

+  /// Timer value recorded at the OS write to SLP_TYP upon entry to S3.

+  /// Only the most recent suspend cycle's timer value is retained.

+  ///

+  UINT64                                          SuspendStart;

+  ///

+  /// Timer value recorded at the final firmware write to SLP_TYP (or other

+  /// mechanism) used to trigger hardware entry to S3.

+  /// Only the most recent suspend cycle's timer value is retained.

+  ///

+  UINT64                                          SuspendEnd;

+} EFI_ACPI_5_0_FPDT_S3_SUSPEND_RECORD;

+

+///

+/// Firmware Performance Record Table definition.

+///

+typedef struct {

+  EFI_ACPI_DESCRIPTION_HEADER Header;

+} EFI_ACPI_5_0_FIRMWARE_PERFORMANCE_RECORD_TABLE;

+

+///

+/// Generic Timer Description Table definition.

+///

+typedef struct {

+  EFI_ACPI_DESCRIPTION_HEADER Header;

+  UINT64                      PhysicalAddress;

+  UINT32                      GlobalFlags;

+  UINT32                      SecurePL1TimerGSIV;

+  UINT32                      SecurePL1TimerFlags;

+  UINT32                      NonSecurePL1TimerGSIV;

+  UINT32                      NonSecurePL1TimerFlags;

+  UINT32                      VirtualTimerGSIV;

+  UINT32                      VirtualTimerFlags;

+  UINT32                      NonSecurePL2TimerGSIV;

+  UINT32                      NonSecurePL2TimerFlags;

+} EFI_ACPI_5_0_GENERIC_TIMER_DESCRIPTION_TABLE;

+

+///

+/// GTDT Version (as defined in ACPI 5.0 spec.)

+///

+#define EFI_ACPI_5_0_GENERIC_TIMER_DESCRIPTION_TABLE_REVISION 0x01

+

+///

+/// Global Flags.  All other bits are reserved and must be 0.

+///

+#define EFI_ACPI_5_0_GTDT_GLOBAL_FLAG_MEMORY_MAPPED_BLOCK_PRESENT   BIT0

+#define EFI_ACPI_5_0_GTDT_GLOBAL_FLAG_INTERRUPT_MODE                BIT1

+

+///

+/// Timer Flags.  All other bits are reserved and must be 0.

+///

+#define EFI_ACPI_5_0_GTDT_TIMER_FLAG_TIMER_INTERRUPT_MODE          BIT0

+#define EFI_ACPI_5_0_GTDT_TIMER_FLAG_TIMER_INTERRUPT_POLARITY      BIT1

+

+///

+/// Boot Error Record Table (BERT)

+///

+typedef struct {

+  EFI_ACPI_DESCRIPTION_HEADER Header;

+  UINT32                      BootErrorRegionLength;

+  UINT64                      BootErrorRegion;

+} EFI_ACPI_5_0_BOOT_ERROR_RECORD_TABLE_HEADER;

+

+///

+/// BERT Version (as defined in ACPI 5.0 spec.)

+///

+#define EFI_ACPI_5_0_BOOT_ERROR_RECORD_TABLE_REVISION 0x01

+

+///

+/// Boot Error Region Block Status Definition

+///

+typedef struct {

+  UINT32       UncorrectableErrorValid:1;

+  UINT32       CorrectableErrorValid:1;

+  UINT32       MultipleUncorrectableErrors:1;

+  UINT32       MultipleCorrectableErrors:1;

+  UINT32       ErrorDataEntryCount:10;

+  UINT32       Reserved:18;

+} EFI_ACPI_5_0_ERROR_BLOCK_STATUS;

+

+///

+/// Boot Error Region Definition

+///

+typedef struct {

+  EFI_ACPI_5_0_ERROR_BLOCK_STATUS              BlockStatus;

+  UINT32                                       RawDataOffset;

+  UINT32                                       RawDataLength;

+  UINT32                                       DataLength;

+  UINT32                                       ErrorSeverity;

+} EFI_ACPI_5_0_BOOT_ERROR_REGION_STRUCTURE;

+

+//

+// Boot Error Severity types

+//

+#define EFI_ACPI_5_0_ERROR_SEVERITY_CORRECTABLE  0x00

+#define EFI_ACPI_5_0_ERROR_SEVERITY_FATAL        0x01

+#define EFI_ACPI_5_0_ERROR_SEVERITY_CORRECTED    0x02

+#define EFI_ACPI_5_0_ERROR_SEVERITY_NONE         0x03

+

+///

+/// Generic Error Data Entry Definition

+///

+typedef struct {

+  UINT8    SectionType[16];

+  UINT32   ErrorSeverity;

+  UINT16   Revision;

+  UINT8    ValidationBits;

+  UINT8    Flags;

+  UINT32   ErrorDataLength;

+  UINT8    FruId[16];

+  UINT8    FruText[20];

+} EFI_ACPI_5_0_GENERIC_ERROR_DATA_ENTRY_STRUCTURE;

+

+///

+/// Generic Error Data Entry Version (as defined in ACPI 5.0 spec.)

+///

+#define EFI_ACPI_5_0_GENERIC_ERROR_DATA_ENTRY_REVISION  0x0201

+

+///

+/// HEST - Hardware Error Source Table

+///

+typedef struct {

+  EFI_ACPI_DESCRIPTION_HEADER Header;

+  UINT32                      ErrorSourceCount;

+} EFI_ACPI_5_0_HARDWARE_ERROR_SOURCE_TABLE_HEADER;

+

+///

+/// HEST Version (as defined in ACPI 5.0 spec.)

+///

+#define EFI_ACPI_5_0_HARDWARE_ERROR_SOURCE_TABLE_REVISION 0x01

+

+//

+// Error Source structure types.

+//

+#define EFI_ACPI_5_0_IA32_ARCHITECTURE_MACHINE_CHECK_EXCEPTION  0x00

+#define EFI_ACPI_5_0_IA32_ARCHITECTURE_CORRECTED_MACHINE_CHECK  0x01

+#define EFI_ACPI_5_0_IA32_ARCHITECTURE_NMI_ERROR                0x02

+#define EFI_ACPI_5_0_PCI_EXPRESS_ROOT_PORT_AER                  0x06

+#define EFI_ACPI_5_0_PCI_EXPRESS_DEVICE_AER                     0x07

+#define EFI_ACPI_5_0_PCI_EXPRESS_BRIDGE_AER                     0x08

+#define EFI_ACPI_5_0_GENERIC_HARDWARE_ERROR                     0x09

+

+//

+// Error Source structure flags.

+//

+#define EFI_ACPI_5_0_ERROR_SOURCE_FLAG_FIRMWARE_FIRST       (1 << 0)

+#define EFI_ACPI_5_0_ERROR_SOURCE_FLAG_GLOBAL               (1 << 1)

+

+///

+/// IA-32 Architecture Machine Check Exception Structure Definition

+///

+typedef struct {

+  UINT16  Type;

+  UINT16  SourceId;

+  UINT8   Reserved0[2];

+  UINT8   Flags;

+  UINT8   Enabled;

+  UINT32  NumberOfRecordsToPreAllocate;

+  UINT32  MaxSectionsPerRecord;

+  UINT64  GlobalCapabilityInitData;

+  UINT64  GlobalControlInitData;

+  UINT8   NumberOfHardwareBanks;

+  UINT8   Reserved1[7];

+} EFI_ACPI_5_0_IA32_ARCHITECTURE_MACHINE_CHECK_EXCEPTION_STRUCTURE;

+

+///

+/// IA-32 Architecture Machine Check Bank Structure Definition

+///

+typedef struct {

+  UINT8   BankNumber;

+  UINT8   ClearStatusOnInitialization;

+  UINT8   StatusDataFormat;

+  UINT8   Reserved0;

+  UINT32  ControlRegisterMsrAddress;

+  UINT64  ControlInitData;

+  UINT32  StatusRegisterMsrAddress;

+  UINT32  AddressRegisterMsrAddress;

+  UINT32  MiscRegisterMsrAddress;

+} EFI_ACPI_5_0_IA32_ARCHITECTURE_MACHINE_CHECK_ERROR_BANK_STRUCTURE;

+

+///

+/// IA-32 Architecture Machine Check Bank Structure MCA data format

+///

+#define EFI_ACPI_5_0_IA32_ARCHITECTURE_MACHINE_CHECK_ERROR_DATA_FORMAT_IA32      0x00

+#define EFI_ACPI_5_0_IA32_ARCHITECTURE_MACHINE_CHECK_ERROR_DATA_FORMAT_INTEL64   0x01

+#define EFI_ACPI_5_0_IA32_ARCHITECTURE_MACHINE_CHECK_ERROR_DATA_FORMAT_AMD64     0x02

+

+//

+// Hardware Error Notification types. All other values are reserved

+//

+#define EFI_ACPI_5_0_HARDWARE_ERROR_NOTIFICATION_POLLED                0x00

+#define EFI_ACPI_5_0_HARDWARE_ERROR_NOTIFICATION_EXTERNAL_INTERRUPT    0x01

+#define EFI_ACPI_5_0_HARDWARE_ERROR_NOTIFICATION_LOCAL_INTERRUPT       0x02

+#define EFI_ACPI_5_0_HARDWARE_ERROR_NOTIFICATION_SCI                   0x03

+#define EFI_ACPI_5_0_HARDWARE_ERROR_NOTIFICATION_NMI                   0x04

+

+///

+/// Hardware Error Notification Configuration Write Enable Structure Definition

+///

+typedef struct {

+  UINT16    Type:1;

+  UINT16    PollInterval:1;

+  UINT16    SwitchToPollingThresholdValue:1;

+  UINT16    SwitchToPollingThresholdWindow:1;

+  UINT16    ErrorThresholdValue:1;

+  UINT16    ErrorThresholdWindow:1;

+  UINT16    Reserved:10;

+} EFI_ACPI_5_0_HARDWARE_ERROR_NOTIFICATION_CONFIGURATION_WRITE_ENABLE_STRUCTURE;

+

+///

+/// Hardware Error Notification Structure Definition

+///

+typedef struct {

+  UINT8                                                                          Type;

+  UINT8                                                                          Length;

+  EFI_ACPI_5_0_HARDWARE_ERROR_NOTIFICATION_CONFIGURATION_WRITE_ENABLE_STRUCTURE  ConfigurationWriteEnable;

+  UINT32                                                                         PollInterval;

+  UINT32                                                                         Vector;

+  UINT32                                                                         SwitchToPollingThresholdValue;

+  UINT32                                                                         SwitchToPollingThresholdWindow;

+  UINT32                                                                         ErrorThresholdValue;

+  UINT32                                                                         ErrorThresholdWindow;

+} EFI_ACPI_5_0_HARDWARE_ERROR_NOTIFICATION_STRUCTURE;

+

+///

+/// IA-32 Architecture Corrected Machine Check Structure Definition

+///

+typedef struct {

+  UINT16                                                 Type;

+  UINT16                                                 SourceId;

+  UINT8                                                  Reserved0[2];

+  UINT8                                                  Flags;

+  UINT8                                                  Enabled;

+  UINT32                                                 NumberOfRecordsToPreAllocate;

+  UINT32                                                 MaxSectionsPerRecord;

+  EFI_ACPI_5_0_HARDWARE_ERROR_NOTIFICATION_STRUCTURE     NotificationStructure;

+  UINT8                                                  NumberOfHardwareBanks;

+  UINT8                                                  Reserved1[3];

+} EFI_ACPI_5_0_IA32_ARCHITECTURE_CORRECTED_MACHINE_CHECK_STRUCTURE;

+

+///

+/// IA-32 Architecture NMI Error Structure Definition

+///

+typedef struct {

+  UINT16  Type;

+  UINT16  SourceId;

+  UINT8   Reserved0[2];

+  UINT32  NumberOfRecordsToPreAllocate;

+  UINT32  MaxSectionsPerRecord;

+  UINT32  MaxRawDataLength;

+} EFI_ACPI_5_0_IA32_ARCHITECTURE_NMI_ERROR_STRUCTURE;

+

+///

+/// PCI Express Root Port AER Structure Definition

+///

+typedef struct {

+  UINT16  Type;

+  UINT16  SourceId;

+  UINT8   Reserved0[2];

+  UINT8   Flags;

+  UINT8   Enabled;

+  UINT32  NumberOfRecordsToPreAllocate;

+  UINT32  MaxSectionsPerRecord;

+  UINT32  Bus;

+  UINT16  Device;

+  UINT16  Function;

+  UINT16  DeviceControl;

+  UINT8   Reserved1[2];

+  UINT32  UncorrectableErrorMask;

+  UINT32  UncorrectableErrorSeverity;

+  UINT32  CorrectableErrorMask;

+  UINT32  AdvancedErrorCapabilitiesAndControl;

+  UINT32  RootErrorCommand;

+} EFI_ACPI_5_0_PCI_EXPRESS_ROOT_PORT_AER_STRUCTURE;

+

+///

+/// PCI Express Device AER Structure Definition

+///

+typedef struct {

+  UINT16  Type;

+  UINT16  SourceId;

+  UINT8   Reserved0[2];

+  UINT8   Flags;

+  UINT8   Enabled;

+  UINT32  NumberOfRecordsToPreAllocate;

+  UINT32  MaxSectionsPerRecord;

+  UINT32  Bus;

+  UINT16  Device;

+  UINT16  Function;

+  UINT16  DeviceControl;

+  UINT8   Reserved1[2];

+  UINT32  UncorrectableErrorMask;

+  UINT32  UncorrectableErrorSeverity;

+  UINT32  CorrectableErrorMask;

+  UINT32  AdvancedErrorCapabilitiesAndControl;

+} EFI_ACPI_5_0_PCI_EXPRESS_DEVICE_AER_STRUCTURE;

+

+///

+/// PCI Express Bridge AER Structure Definition

+///

+typedef struct {

+  UINT16  Type;

+  UINT16  SourceId;

+  UINT8   Reserved0[2];

+  UINT8   Flags;

+  UINT8   Enabled;

+  UINT32  NumberOfRecordsToPreAllocate;

+  UINT32  MaxSectionsPerRecord;

+  UINT32  Bus;

+  UINT16  Device;

+  UINT16  Function;

+  UINT16  DeviceControl;

+  UINT8   Reserved1[2];

+  UINT32  UncorrectableErrorMask;

+  UINT32  UncorrectableErrorSeverity;

+  UINT32  CorrectableErrorMask;

+  UINT32  AdvancedErrorCapabilitiesAndControl;

+  UINT32  SecondaryUncorrectableErrorMask;

+  UINT32  SecondaryUncorrectableErrorSeverity;

+  UINT32  SecondaryAdvancedErrorCapabilitiesAndControl;

+} EFI_ACPI_5_0_PCI_EXPRESS_BRIDGE_AER_STRUCTURE;

+

+///

+/// Generic Hardware Error Source Structure Definition

+///

+typedef struct {

+  UINT16                                                 Type;

+  UINT16                                                 SourceId;

+  UINT16                                                 RelatedSourceId;

+  UINT8                                                  Flags;

+  UINT8                                                  Enabled;

+  UINT32                                                 NumberOfRecordsToPreAllocate;

+  UINT32                                                 MaxSectionsPerRecord;

+  UINT32                                                 MaxRawDataLength;

+  EFI_ACPI_5_0_GENERIC_ADDRESS_STRUCTURE                 ErrorStatusAddress;

+  EFI_ACPI_5_0_HARDWARE_ERROR_NOTIFICATION_STRUCTURE     NotificationStructure;

+  UINT32                                                 ErrorStatusBlockLength;

+} EFI_ACPI_5_0_GENERIC_HARDWARE_ERROR_SOURCE_STRUCTURE;

+

+///

+/// Generic Error Status Definition

+///

+typedef struct {

+  EFI_ACPI_5_0_ERROR_BLOCK_STATUS              BlockStatus;

+  UINT32                                       RawDataOffset;

+  UINT32                                       RawDataLength;

+  UINT32                                       DataLength;

+  UINT32                                       ErrorSeverity;

+} EFI_ACPI_5_0_GENERIC_ERROR_STATUS_STRUCTURE;

+

+///

+/// ERST - Error Record Serialization Table

+///

+typedef struct {

+  EFI_ACPI_DESCRIPTION_HEADER Header;

+  UINT32                      SerializationHeaderSize;

+  UINT8                       Reserved0[4];

+  UINT32                      InstructionEntryCount;

+} EFI_ACPI_5_0_ERROR_RECORD_SERIALIZATION_TABLE_HEADER;

+

+///

+/// ERST Version (as defined in ACPI 5.0 spec.)

+///

+#define EFI_ACPI_5_0_ERROR_RECORD_SERIALIZATION_TABLE_REVISION 0x01

+

+///

+/// ERST Serialization Actions

+///

+#define EFI_ACPI_5_0_ERST_BEGIN_WRITE_OPERATION                    0x00

+#define EFI_ACPI_5_0_ERST_BEGIN_READ_OPERATION                     0x01

+#define EFI_ACPI_5_0_ERST_BEGIN_CLEAR_OPERATION                    0x02

+#define EFI_ACPI_5_0_ERST_END_OPERATION                            0x03

+#define EFI_ACPI_5_0_ERST_SET_RECORD_OFFSET                        0x04

+#define EFI_ACPI_5_0_ERST_EXECUTE_OPERATION                        0x05

+#define EFI_ACPI_5_0_ERST_CHECK_BUSY_STATUS                        0x06

+#define EFI_ACPI_5_0_ERST_GET_COMMAND_STATUS                       0x07

+#define EFI_ACPI_5_0_ERST_GET_RECORD_IDENTIFIER                    0x08

+#define EFI_ACPI_5_0_ERST_SET_RECORD_IDENTIFIER                    0x09

+#define EFI_ACPI_5_0_ERST_GET_RECORD_COUNT                         0x0A

+#define EFI_ACPI_5_0_ERST_BEGIN_DUMMY_WRITE_OPERATION              0x0B

+#define EFI_ACPI_5_0_ERST_GET_ERROR_LOG_ADDRESS_RANGE              0x0D

+#define EFI_ACPI_5_0_ERST_GET_ERROR_LOG_ADDRESS_RANGE_LENGTH       0x0E

+#define EFI_ACPI_5_0_ERST_GET_ERROR_LOG_ADDRESS_RANGE_ATTRIBUTES   0x0F

+

+///

+/// ERST Action Command Status

+///

+#define EFI_ACPI_5_0_ERST_STATUS_SUCCESS                           0x00

+#define EFI_ACPI_5_0_ERST_STATUS_NOT_ENOUGH_SPACE                  0x01

+#define EFI_ACPI_5_0_ERST_STATUS_HARDWARE_NOT_AVAILABLE            0x02

+#define EFI_ACPI_5_0_ERST_STATUS_FAILED                            0x03

+#define EFI_ACPI_5_0_ERST_STATUS_RECORD_STORE_EMPTY                0x04

+#define EFI_ACPI_5_0_ERST_STATUS_RECORD_NOT_FOUND                  0x05

+

+///

+/// ERST Serialization Instructions

+///

+#define EFI_ACPI_5_0_ERST_READ_REGISTER                            0x00

+#define EFI_ACPI_5_0_ERST_READ_REGISTER_VALUE                      0x01

+#define EFI_ACPI_5_0_ERST_WRITE_REGISTER                           0x02

+#define EFI_ACPI_5_0_ERST_WRITE_REGISTER_VALUE                     0x03

+#define EFI_ACPI_5_0_ERST_NOOP                                     0x04

+#define EFI_ACPI_5_0_ERST_LOAD_VAR1                                0x05

+#define EFI_ACPI_5_0_ERST_LOAD_VAR2                                0x06

+#define EFI_ACPI_5_0_ERST_STORE_VAR1                               0x07

+#define EFI_ACPI_5_0_ERST_ADD                                      0x08

+#define EFI_ACPI_5_0_ERST_SUBTRACT                                 0x09

+#define EFI_ACPI_5_0_ERST_ADD_VALUE                                0x0A

+#define EFI_ACPI_5_0_ERST_SUBTRACT_VALUE                           0x0B

+#define EFI_ACPI_5_0_ERST_STALL                                    0x0C

+#define EFI_ACPI_5_0_ERST_STALL_WHILE_TRUE                         0x0D

+#define EFI_ACPI_5_0_ERST_SKIP_NEXT_INSTRUCTION_IF_TRUE            0x0E

+#define EFI_ACPI_5_0_ERST_GOTO                                     0x0F

+#define EFI_ACPI_5_0_ERST_SET_SRC_ADDRESS_BASE                     0x10

+#define EFI_ACPI_5_0_ERST_SET_DST_ADDRESS_BASE                     0x11

+#define EFI_ACPI_5_0_ERST_MOVE_DATA                                0x12

+

+///

+/// ERST Instruction Flags

+///

+#define EFI_ACPI_5_0_ERST_PRESERVE_REGISTER                        0x01

+

+///

+/// ERST Serialization Instruction Entry

+///

+typedef struct {

+  UINT8                                    SerializationAction;

+  UINT8                                    Instruction;

+  UINT8                                    Flags;

+  UINT8                                    Reserved0;

+  EFI_ACPI_5_0_GENERIC_ADDRESS_STRUCTURE   RegisterRegion;

+  UINT64                                   Value;

+  UINT64                                   Mask;

+} EFI_ACPI_5_0_ERST_SERIALIZATION_INSTRUCTION_ENTRY;

+

+///

+/// EINJ - Error Injection Table

+///

+typedef struct {

+  EFI_ACPI_DESCRIPTION_HEADER Header;

+  UINT32                      InjectionHeaderSize;

+  UINT8                       InjectionFlags;

+  UINT8                       Reserved0[3];

+  UINT32                      InjectionEntryCount;

+} EFI_ACPI_5_0_ERROR_INJECTION_TABLE_HEADER;

+

+///

+/// EINJ Version (as defined in ACPI 5.0 spec.)

+///

+#define EFI_ACPI_5_0_ERROR_INJECTION_TABLE_REVISION 0x01

+

+///

+/// EINJ Error Injection Actions

+///

+#define EFI_ACPI_5_0_EINJ_BEGIN_INJECTION_OPERATION                0x00

+#define EFI_ACPI_5_0_EINJ_GET_TRIGGER_ERROR_ACTION_TABLE           0x01

+#define EFI_ACPI_5_0_EINJ_SET_ERROR_TYPE                           0x02

+#define EFI_ACPI_5_0_EINJ_GET_ERROR_TYPE                           0x03

+#define EFI_ACPI_5_0_EINJ_END_OPERATION                            0x04

+#define EFI_ACPI_5_0_EINJ_EXECUTE_OPERATION                        0x05

+#define EFI_ACPI_5_0_EINJ_CHECK_BUSY_STATUS                        0x06

+#define EFI_ACPI_5_0_EINJ_GET_COMMAND_STATUS                       0x07

+#define EFI_ACPI_5_0_EINJ_TRIGGER_ERROR                            0xFF

+

+///

+/// EINJ Action Command Status

+///

+#define EFI_ACPI_5_0_EINJ_STATUS_SUCCESS                           0x00

+#define EFI_ACPI_5_0_EINJ_STATUS_UNKNOWN_FAILURE                   0x01

+#define EFI_ACPI_5_0_EINJ_STATUS_INVALID_ACCESS                    0x02

+

+///

+/// EINJ Error Type Definition

+///

+#define EFI_ACPI_5_0_EINJ_ERROR_PROCESSOR_CORRECTABLE                 (1 << 0)

+#define EFI_ACPI_5_0_EINJ_ERROR_PROCESSOR_UNCORRECTABLE_NONFATAL      (1 << 1)

+#define EFI_ACPI_5_0_EINJ_ERROR_PROCESSOR_UNCORRECTABLE_FATAL         (1 << 2)

+#define EFI_ACPI_5_0_EINJ_ERROR_MEMORY_CORRECTABLE                    (1 << 3)

+#define EFI_ACPI_5_0_EINJ_ERROR_MEMORY_UNCORRECTABLE_NONFATAL         (1 << 4)

+#define EFI_ACPI_5_0_EINJ_ERROR_MEMORY_UNCORRECTABLE_FATAL            (1 << 5)

+#define EFI_ACPI_5_0_EINJ_ERROR_PCI_EXPRESS_CORRECTABLE               (1 << 6)

+#define EFI_ACPI_5_0_EINJ_ERROR_PCI_EXPRESS_UNCORRECTABLE_NONFATAL    (1 << 7)

+#define EFI_ACPI_5_0_EINJ_ERROR_PCI_EXPRESS_UNCORRECTABLE_FATAL       (1 << 8)

+#define EFI_ACPI_5_0_EINJ_ERROR_PLATFORM_CORRECTABLE                  (1 << 9)

+#define EFI_ACPI_5_0_EINJ_ERROR_PLATFORM_UNCORRECTABLE_NONFATAL       (1 << 10)

+#define EFI_ACPI_5_0_EINJ_ERROR_PLATFORM_UNCORRECTABLE_FATAL          (1 << 11)

+

+///

+/// EINJ Injection Instructions

+///

+#define EFI_ACPI_5_0_EINJ_READ_REGISTER                            0x00

+#define EFI_ACPI_5_0_EINJ_READ_REGISTER_VALUE                      0x01

+#define EFI_ACPI_5_0_EINJ_WRITE_REGISTER                           0x02

+#define EFI_ACPI_5_0_EINJ_WRITE_REGISTER_VALUE                     0x03

+#define EFI_ACPI_5_0_EINJ_NOOP                                     0x04

+

+///

+/// EINJ Instruction Flags

+///

+#define EFI_ACPI_5_0_EINJ_PRESERVE_REGISTER                        0x01

+

+///

+/// EINJ Injection Instruction Entry

+///

+typedef struct {

+  UINT8                                    InjectionAction;

+  UINT8                                    Instruction;

+  UINT8                                    Flags;

+  UINT8                                    Reserved0;

+  EFI_ACPI_5_0_GENERIC_ADDRESS_STRUCTURE   RegisterRegion;

+  UINT64                                   Value;

+  UINT64                                   Mask;

+} EFI_ACPI_5_0_EINJ_INJECTION_INSTRUCTION_ENTRY;

+

+///

+/// EINJ Trigger Action Table

+///

+typedef struct {

+  UINT32  HeaderSize;

+  UINT32  Revision;

+  UINT32  TableSize;

+  UINT32  EntryCount;

+} EFI_ACPI_5_0_EINJ_TRIGGER_ACTION_TABLE;

+

+///

+/// Platform Communications Channel Table (PCCT)

+///

+typedef struct {

+  EFI_ACPI_DESCRIPTION_HEADER Header;

+  UINT32                      Flags;

+  UINT64                      Reserved;

+} EFI_ACPI_5_0_PLATFORM_COMMUNICATION_CHANNEL_TABLE_HEADER;

+

+///

+/// PCCT Version (as defined in ACPI 5.0 spec.)

+///

+#define EFI_ACPI_5_0_PLATFORM_COMMUNICATION_CHANNEL_TABLE_REVISION 0x01

+

+///

+/// PCCT Global Flags

+///

+#define EFI_ACPI_5_0_PCCT_FLAGS_SCI_DOORBELL                      BIT0

+

+//

+// PCCT Subspace type

+//

+#define EFI_ACPI_5_0_PCCT_SUBSPACE_TYPE_GENERIC  0x00

+

+///

+/// PCC Subspace Structure Header

+///

+typedef struct {

+  UINT8        Type;

+  UINT8        Length;

+} EFI_ACPI_5_0_PCCT_SUBSPACE_HEADER;

+

+///

+/// Generic Communications Subspace Structure

+///

+typedef struct {

+  UINT8                                    Type;

+  UINT8                                    Length;

+  UINT8                                    Reserved[6];

+  UINT64                                   BaseAddress;

+  UINT64                                   AddressLength;

+  EFI_ACPI_5_0_GENERIC_ADDRESS_STRUCTURE   DoorbellRegister;

+  UINT64                                   DoorbellPreserve;

+  UINT64                                   DoorbellWrite;

+  UINT32                                   NominalLatency;

+  UINT32                                   MaximumPeriodicAccessRate;

+  UINT16                                   MinimumRequestTurnaroundTime;

+} EFI_ACPI_5_0_PCCT_SUBSPACE_GENERIC;

+

+///

+/// Generic Communications Channel Shared Memory Region

+///

+

+typedef struct {

+  UINT8                                    Command;

+  UINT8                                    Reserved:7;

+  UINT8                                    GenerateSci:1;

+} EFI_ACPI_5_0_PCCT_GENERIC_SHARED_MEMORY_REGION_COMMAND;

+

+typedef struct {

+  UINT8                                    CommandComplete:1;

+  UINT8                                    SciDoorbell:1;

+  UINT8                                    Error:1;

+  UINT8                                    PlatformNotification:1;

+  UINT8                                    Reserved:4;

+  UINT8                                    Reserved1;

+} EFI_ACPI_5_0_PCCT_GENERIC_SHARED_MEMORY_REGION_STATUS;

+

+typedef struct {

+  UINT32                                                    Signature;

+  EFI_ACPI_5_0_PCCT_GENERIC_SHARED_MEMORY_REGION_COMMAND    Command;

+  EFI_ACPI_5_0_PCCT_GENERIC_SHARED_MEMORY_REGION_STATUS     Status;

+} EFI_ACPI_5_0_PCCT_GENERIC_SHARED_MEMORY_REGION_HEADER;

+

+//

+// Known table signatures

+//

+

+///

+/// "RSD PTR " Root System Description Pointer

+///

+#define EFI_ACPI_5_0_ROOT_SYSTEM_DESCRIPTION_POINTER_SIGNATURE  SIGNATURE_64('R', 'S', 'D', ' ', 'P', 'T', 'R', ' ')

+

+///

+/// "APIC" Multiple APIC Description Table

+///

+#define EFI_ACPI_5_0_MULTIPLE_APIC_DESCRIPTION_TABLE_SIGNATURE  SIGNATURE_32('A', 'P', 'I', 'C')

+

+///

+/// "BERT" Boot Error Record Table

+///

+#define EFI_ACPI_5_0_BOOT_ERROR_RECORD_TABLE_SIGNATURE  SIGNATURE_32('B', 'E', 'R', 'T')

+

+///

+/// "BGRT" Boot Graphics Resource Table

+///

+#define EFI_ACPI_5_0_BOOT_GRAPHICS_RESOURCE_TABLE_SIGNATURE  SIGNATURE_32('B', 'G', 'R', 'T')

+

+///

+/// "CPEP" Corrected Platform Error Polling Table

+///

+#define EFI_ACPI_5_0_CORRECTED_PLATFORM_ERROR_POLLING_TABLE_SIGNATURE  SIGNATURE_32('C', 'P', 'E', 'P')

+

+///

+/// "DSDT" Differentiated System Description Table

+///

+#define EFI_ACPI_5_0_DIFFERENTIATED_SYSTEM_DESCRIPTION_TABLE_SIGNATURE  SIGNATURE_32('D', 'S', 'D', 'T')

+

+///

+/// "ECDT" Embedded Controller Boot Resources Table

+///

+#define EFI_ACPI_5_0_EMBEDDED_CONTROLLER_BOOT_RESOURCES_TABLE_SIGNATURE  SIGNATURE_32('E', 'C', 'D', 'T')

+

+///

+/// "EINJ" Error Injection Table

+///

+#define EFI_ACPI_5_0_ERROR_INJECTION_TABLE_SIGNATURE  SIGNATURE_32('E', 'I', 'N', 'J')

+

+///

+/// "ERST" Error Record Serialization Table

+///

+#define EFI_ACPI_5_0_ERROR_RECORD_SERIALIZATION_TABLE_SIGNATURE  SIGNATURE_32('E', 'R', 'S', 'T')

+

+///

+/// "FACP" Fixed ACPI Description Table

+///

+#define EFI_ACPI_5_0_FIXED_ACPI_DESCRIPTION_TABLE_SIGNATURE  SIGNATURE_32('F', 'A', 'C', 'P')

+

+///

+/// "FACS" Firmware ACPI Control Structure

+///

+#define EFI_ACPI_5_0_FIRMWARE_ACPI_CONTROL_STRUCTURE_SIGNATURE  SIGNATURE_32('F', 'A', 'C', 'S')

+

+///

+/// "FPDT" Firmware Performance Data Table

+///

+#define EFI_ACPI_5_0_FIRMWARE_PERFORMANCE_DATA_TABLE_SIGNATURE  SIGNATURE_32('F', 'P', 'D', 'T')

+

+///

+/// "GTDT" Generic Timer Description Table

+///

+#define EFI_ACPI_5_0_GENERIC_TIMER_DESCRIPTION_TABLE_SIGNATURE  SIGNATURE_32('G', 'T', 'D', 'T')

+

+///

+/// "HEST" Hardware Error Source Table

+///

+#define EFI_ACPI_5_0_HARDWARE_ERROR_SOURCE_TABLE_SIGNATURE  SIGNATURE_32('H', 'E', 'S', 'T')

+

+///

+/// "MPST" Memory Power State Table

+///

+#define EFI_ACPI_5_0_MEMORY_POWER_STATE_TABLE_SIGNATURE  SIGNATURE_32('M', 'P', 'S', 'T')

+

+///

+/// "MSCT" Maximum System Characteristics Table

+///

+#define EFI_ACPI_5_0_MAXIMUM_SYSTEM_CHARACTERISTICS_TABLE_SIGNATURE  SIGNATURE_32('M', 'S', 'C', 'T')

+

+///

+/// "PMTT" Platform Memory Topology Table

+///

+#define EFI_ACPI_5_0_PLATFORM_MEMORY_TOPOLOGY_TABLE_SIGNATURE  SIGNATURE_32('P', 'M', 'T', 'T')

+

+///

+/// "PSDT" Persistent System Description Table

+///

+#define EFI_ACPI_5_0_PERSISTENT_SYSTEM_DESCRIPTION_TABLE_SIGNATURE  SIGNATURE_32('P', 'S', 'D', 'T')

+

+///

+/// "RASF" ACPI RAS Feature Table

+///

+#define EFI_ACPI_5_0_ACPI_RAS_FEATURE_TABLE_SIGNATURE  SIGNATURE_32('R', 'A', 'S', 'F')

+

+///

+/// "RSDT" Root System Description Table

+///

+#define EFI_ACPI_5_0_ROOT_SYSTEM_DESCRIPTION_TABLE_SIGNATURE  SIGNATURE_32('R', 'S', 'D', 'T')

+

+///

+/// "SBST" Smart Battery Specification Table

+///

+#define EFI_ACPI_5_0_SMART_BATTERY_SPECIFICATION_TABLE_SIGNATURE  SIGNATURE_32('S', 'B', 'S', 'T')

+

+///

+/// "SLIT" System Locality Information Table

+///

+#define EFI_ACPI_5_0_SYSTEM_LOCALITY_INFORMATION_TABLE_SIGNATURE  SIGNATURE_32('S', 'L', 'I', 'T')

+

+///

+/// "SRAT" System Resource Affinity Table

+///

+#define EFI_ACPI_5_0_SYSTEM_RESOURCE_AFFINITY_TABLE_SIGNATURE  SIGNATURE_32('S', 'R', 'A', 'T')

+

+///

+/// "SSDT" Secondary System Description Table

+///

+#define EFI_ACPI_5_0_SECONDARY_SYSTEM_DESCRIPTION_TABLE_SIGNATURE  SIGNATURE_32('S', 'S', 'D', 'T')

+

+///

+/// "XSDT" Extended System Description Table

+///

+#define EFI_ACPI_5_0_EXTENDED_SYSTEM_DESCRIPTION_TABLE_SIGNATURE  SIGNATURE_32('X', 'S', 'D', 'T')

+

+///

+/// "BOOT" MS Simple Boot Spec

+///

+#define EFI_ACPI_5_0_SIMPLE_BOOT_FLAG_TABLE_SIGNATURE  SIGNATURE_32('B', 'O', 'O', 'T')

+

+///

+/// "CSRT" MS Core System Resource Table

+///

+#define EFI_ACPI_5_0_CORE_SYSTEM_RESOURCE_TABLE_SIGNATURE  SIGNATURE_32('C', 'S', 'R', 'T')

+

+///

+/// "DBG2" MS Debug Port 2 Spec

+///

+#define EFI_ACPI_5_0_DEBUG_PORT_2_TABLE_SIGNATURE  SIGNATURE_32('D', 'B', 'G', '2')

+

+///

+/// "DBGP" MS Debug Port Spec

+///

+#define EFI_ACPI_5_0_DEBUG_PORT_TABLE_SIGNATURE  SIGNATURE_32('D', 'B', 'G', 'P')

+

+///

+/// "DMAR" DMA Remapping Table

+///

+#define EFI_ACPI_5_0_DMA_REMAPPING_TABLE_SIGNATURE  SIGNATURE_32('D', 'M', 'A', 'R')

+

+///

+/// "DRTM" Dynamic Root of Trust for Measurement Table

+///

+#define EFI_ACPI_5_0_DYNAMIC_ROOT_OF_TRUST_FOR_MEASUREMENT_TABLE_SIGNATURE  SIGNATURE_32('D', 'R', 'T', 'M')

+

+///

+/// "ETDT" Event Timer Description Table

+///

+#define EFI_ACPI_5_0_EVENT_TIMER_DESCRIPTION_TABLE_SIGNATURE  SIGNATURE_32('E', 'T', 'D', 'T')

+

+///

+/// "HPET" IA-PC High Precision Event Timer Table

+///

+#define EFI_ACPI_5_0_HIGH_PRECISION_EVENT_TIMER_TABLE_SIGNATURE  SIGNATURE_32('H', 'P', 'E', 'T')

+

+///

+/// "iBFT" iSCSI Boot Firmware Table

+///

+#define EFI_ACPI_5_0_ISCSI_BOOT_FIRMWARE_TABLE_SIGNATURE  SIGNATURE_32('i', 'B', 'F', 'T')

+

+///

+/// "IVRS" I/O Virtualization Reporting Structure

+///

+#define EFI_ACPI_5_0_IO_VIRTUALIZATION_REPORTING_STRUCTURE_SIGNATURE  SIGNATURE_32('I', 'V', 'R', 'S')

+

+///

+/// "MCFG" PCI Express Memory Mapped Configuration Space Base Address Description Table

+///

+#define EFI_ACPI_5_0_PCI_EXPRESS_MEMORY_MAPPED_CONFIGURATION_SPACE_BASE_ADDRESS_DESCRIPTION_TABLE_SIGNATURE  SIGNATURE_32('M', 'C', 'F', 'G')

+

+///

+/// "MCHI" Management Controller Host Interface Table

+///

+#define EFI_ACPI_5_0_MANAGEMENT_CONTROLLER_HOST_INTERFACE_TABLE_SIGNATURE  SIGNATURE_32('M', 'C', 'H', 'I')

+

+///

+/// "MSDM" MS Data Management Table

+///

+#define EFI_ACPI_5_0_DATA_MANAGEMENT_TABLE_SIGNATURE  SIGNATURE_32('M', 'S', 'D', 'M')

+

+///

+/// "PCCT" Platform Communications Channel Table

+///

+#define EFI_ACPI_5_0_PLATFORM_COMMUNICATIONS_CHANNEL_TABLE_SIGNATURE  SIGNATURE_32('P', 'C', 'C', 'T')

+

+///

+/// "SLIC" MS Software Licensing Table Specification

+///

+#define EFI_ACPI_5_0_SOFTWARE_LICENSING_TABLE_SIGNATURE  SIGNATURE_32('S', 'L', 'I', 'C')

+

+///

+/// "SPCR" Serial Port Console Redirection Table

+///

+#define EFI_ACPI_5_0_SERIAL_PORT_CONSOLE_REDIRECTION_TABLE_SIGNATURE  SIGNATURE_32('S', 'P', 'C', 'R')

+

+///

+/// "SPMI" Server Platform Management Interface Table

+///

+#define EFI_ACPI_5_0_SERVER_PLATFORM_MANAGEMENT_INTERFACE_TABLE_SIGNATURE  SIGNATURE_32('S', 'P', 'M', 'I')

+

+///

+/// "TCPA" Trusted Computing Platform Alliance Capabilities Table

+///

+#define EFI_ACPI_5_0_TRUSTED_COMPUTING_PLATFORM_ALLIANCE_CAPABILITIES_TABLE_SIGNATURE  SIGNATURE_32('T', 'C', 'P', 'A')

+

+///

+/// "TPM2" Trusted Computing Platform 1 Table

+///

+#define EFI_ACPI_5_0_TRUSTED_COMPUTING_PLATFORM_2_TABLE_SIGNATURE  SIGNATURE_32('T', 'P', 'M', '2')

+

+///

+/// "UEFI" UEFI ACPI Data Table

+///

+#define EFI_ACPI_5_0_UEFI_ACPI_DATA_TABLE_SIGNATURE  SIGNATURE_32('U', 'E', 'F', 'I')

+

+///

+/// "WAET" Windows ACPI Emulated Devices Table

+///

+#define EFI_ACPI_5_0_WINDOWS_ACPI_EMULATED_DEVICES_TABLE_SIGNATURE  SIGNATURE_32('W', 'A', 'E', 'T')

+#define EFI_ACPI_5_0_WINDOWS_ACPI_ENLIGHTENMENT_TABLE_SIGNATURE  EFI_ACPI_5_0_WINDOWS_ACPI_EMULATED_DEVICES_TABLE_SIGNATURE

+

+///

+/// "WDAT" Watchdog Action Table

+///

+#define EFI_ACPI_5_0_WATCHDOG_ACTION_TABLE_SIGNATURE  SIGNATURE_32('W', 'D', 'A', 'T')

+

+///

+/// "WDRT" Watchdog Resource Table

+///

+#define EFI_ACPI_5_0_WATCHDOG_RESOURCE_TABLE_SIGNATURE  SIGNATURE_32('W', 'D', 'R', 'T')

+

+///

+/// "WPBT" MS Platform Binary Table

+///

+#define EFI_ACPI_5_0_PLATFORM_BINARY_TABLE_SIGNATURE  SIGNATURE_32('W', 'P', 'B', 'T')

+

+#pragma pack()

+

+#endif

diff --git a/debugging_demo/memtest86+/efi/Include/IndustryStandard/Acpi51.h b/debugging_demo/memtest86+/efi/Include/IndustryStandard/Acpi51.h
new file mode 100644
index 0000000..fc28ffa
--- /dev/null
+++ b/debugging_demo/memtest86+/efi/Include/IndustryStandard/Acpi51.h
@@ -0,0 +1,2139 @@
+/** @file

+  ACPI 5.1 definitions from the ACPI Specification Revision 5.1 Errata B January, 2016.

+

+  Copyright (c) 2014 Hewlett-Packard Development Company, L.P.<BR>

+  Copyright (c) 2014 - 2018, Intel Corporation. All rights reserved.<BR>

+  (C) Copyright 2015 Hewlett Packard Enterprise Development LP<BR>

+  Copyright (c) 2020, ARM Ltd. All rights reserved.<BR>

+  SPDX-License-Identifier: BSD-2-Clause-Patent

+**/

+

+#ifndef _ACPI_5_1_H_

+#define _ACPI_5_1_H_

+

+#include <IndustryStandard/Acpi50.h>

+

+//

+// Ensure proper structure formats

+//

+#pragma pack(1)

+

+///

+/// ACPI 5.1 Generic Address Space definition

+///

+typedef struct {

+  UINT8   AddressSpaceId;

+  UINT8   RegisterBitWidth;

+  UINT8   RegisterBitOffset;

+  UINT8   AccessSize;

+  UINT64  Address;

+} EFI_ACPI_5_1_GENERIC_ADDRESS_STRUCTURE;

+

+//

+// Generic Address Space Address IDs

+//

+#define EFI_ACPI_5_1_SYSTEM_MEMORY              0

+#define EFI_ACPI_5_1_SYSTEM_IO                  1

+#define EFI_ACPI_5_1_PCI_CONFIGURATION_SPACE    2

+#define EFI_ACPI_5_1_EMBEDDED_CONTROLLER        3

+#define EFI_ACPI_5_1_SMBUS                      4

+#define EFI_ACPI_5_1_PLATFORM_COMMUNICATION_CHANNEL  0x0A

+#define EFI_ACPI_5_1_FUNCTIONAL_FIXED_HARDWARE       0x7F

+

+//

+// Generic Address Space Access Sizes

+//

+#define EFI_ACPI_5_1_UNDEFINED  0

+#define EFI_ACPI_5_1_BYTE       1

+#define EFI_ACPI_5_1_WORD       2

+#define EFI_ACPI_5_1_DWORD      3

+#define EFI_ACPI_5_1_QWORD      4

+

+//

+// ACPI 5.1 table structures

+//

+

+///

+/// Root System Description Pointer Structure

+///

+typedef struct {

+  UINT64  Signature;

+  UINT8   Checksum;

+  UINT8   OemId[6];

+  UINT8   Revision;

+  UINT32  RsdtAddress;

+  UINT32  Length;

+  UINT64  XsdtAddress;

+  UINT8   ExtendedChecksum;

+  UINT8   Reserved[3];

+} EFI_ACPI_5_1_ROOT_SYSTEM_DESCRIPTION_POINTER;

+

+///

+/// RSD_PTR Revision (as defined in ACPI 5.1 spec.)

+///

+#define EFI_ACPI_5_1_ROOT_SYSTEM_DESCRIPTION_POINTER_REVISION 0x02  ///< ACPISpec (Revision 5.1) says current value is 2

+

+///

+/// Common table header, this prefaces all ACPI tables, including FACS, but

+/// excluding the RSD PTR structure

+///

+typedef struct {

+  UINT32  Signature;

+  UINT32  Length;

+} EFI_ACPI_5_1_COMMON_HEADER;

+

+//

+// Root System Description Table

+// No definition needed as it is a common description table header, the same with

+// EFI_ACPI_DESCRIPTION_HEADER, followed by a variable number of UINT32 table pointers.

+//

+

+///

+/// RSDT Revision (as defined in ACPI 5.1 spec.)

+///

+#define EFI_ACPI_5_1_ROOT_SYSTEM_DESCRIPTION_TABLE_REVISION 0x01

+

+//

+// Extended System Description Table

+// No definition needed as it is a common description table header, the same with

+// EFI_ACPI_DESCRIPTION_HEADER, followed by a variable number of UINT64 table pointers.

+//

+

+///

+/// XSDT Revision (as defined in ACPI 5.1 spec.)

+///

+#define EFI_ACPI_5_1_EXTENDED_SYSTEM_DESCRIPTION_TABLE_REVISION 0x01

+

+///

+/// Fixed ACPI Description Table Structure (FADT)

+///

+typedef struct {

+  EFI_ACPI_DESCRIPTION_HEADER             Header;

+  UINT32                                  FirmwareCtrl;

+  UINT32                                  Dsdt;

+  UINT8                                   Reserved0;

+  UINT8                                   PreferredPmProfile;

+  UINT16                                  SciInt;

+  UINT32                                  SmiCmd;

+  UINT8                                   AcpiEnable;

+  UINT8                                   AcpiDisable;

+  UINT8                                   S4BiosReq;

+  UINT8                                   PstateCnt;

+  UINT32                                  Pm1aEvtBlk;

+  UINT32                                  Pm1bEvtBlk;

+  UINT32                                  Pm1aCntBlk;

+  UINT32                                  Pm1bCntBlk;

+  UINT32                                  Pm2CntBlk;

+  UINT32                                  PmTmrBlk;

+  UINT32                                  Gpe0Blk;

+  UINT32                                  Gpe1Blk;

+  UINT8                                   Pm1EvtLen;

+  UINT8                                   Pm1CntLen;

+  UINT8                                   Pm2CntLen;

+  UINT8                                   PmTmrLen;

+  UINT8                                   Gpe0BlkLen;

+  UINT8                                   Gpe1BlkLen;

+  UINT8                                   Gpe1Base;

+  UINT8                                   CstCnt;

+  UINT16                                  PLvl2Lat;

+  UINT16                                  PLvl3Lat;

+  UINT16                                  FlushSize;

+  UINT16                                  FlushStride;

+  UINT8                                   DutyOffset;

+  UINT8                                   DutyWidth;

+  UINT8                                   DayAlrm;

+  UINT8                                   MonAlrm;

+  UINT8                                   Century;

+  UINT16                                  IaPcBootArch;

+  UINT8                                   Reserved1;

+  UINT32                                  Flags;

+  EFI_ACPI_5_1_GENERIC_ADDRESS_STRUCTURE  ResetReg;

+  UINT8                                   ResetValue;

+  UINT16                                  ArmBootArch;

+  UINT8                                   MinorVersion;

+  UINT64                                  XFirmwareCtrl;

+  UINT64                                  XDsdt;

+  EFI_ACPI_5_1_GENERIC_ADDRESS_STRUCTURE  XPm1aEvtBlk;

+  EFI_ACPI_5_1_GENERIC_ADDRESS_STRUCTURE  XPm1bEvtBlk;

+  EFI_ACPI_5_1_GENERIC_ADDRESS_STRUCTURE  XPm1aCntBlk;

+  EFI_ACPI_5_1_GENERIC_ADDRESS_STRUCTURE  XPm1bCntBlk;

+  EFI_ACPI_5_1_GENERIC_ADDRESS_STRUCTURE  XPm2CntBlk;

+  EFI_ACPI_5_1_GENERIC_ADDRESS_STRUCTURE  XPmTmrBlk;

+  EFI_ACPI_5_1_GENERIC_ADDRESS_STRUCTURE  XGpe0Blk;

+  EFI_ACPI_5_1_GENERIC_ADDRESS_STRUCTURE  XGpe1Blk;

+  EFI_ACPI_5_1_GENERIC_ADDRESS_STRUCTURE  SleepControlReg;

+  EFI_ACPI_5_1_GENERIC_ADDRESS_STRUCTURE  SleepStatusReg;

+} EFI_ACPI_5_1_FIXED_ACPI_DESCRIPTION_TABLE;

+

+///

+/// FADT Version (as defined in ACPI 5.1 spec.)

+///

+#define EFI_ACPI_5_1_FIXED_ACPI_DESCRIPTION_TABLE_REVISION  0x05

+#define EFI_ACPI_5_1_FIXED_ACPI_DESCRIPTION_TABLE_MINOR_REVISION  0x01

+

+//

+// Fixed ACPI Description Table Preferred Power Management Profile

+//

+#define EFI_ACPI_5_1_PM_PROFILE_UNSPECIFIED         0

+#define EFI_ACPI_5_1_PM_PROFILE_DESKTOP             1

+#define EFI_ACPI_5_1_PM_PROFILE_MOBILE              2

+#define EFI_ACPI_5_1_PM_PROFILE_WORKSTATION         3

+#define EFI_ACPI_5_1_PM_PROFILE_ENTERPRISE_SERVER   4

+#define EFI_ACPI_5_1_PM_PROFILE_SOHO_SERVER         5

+#define EFI_ACPI_5_1_PM_PROFILE_APPLIANCE_PC        6

+#define EFI_ACPI_5_1_PM_PROFILE_PERFORMANCE_SERVER  7

+#define EFI_ACPI_5_1_PM_PROFILE_TABLET              8

+

+//

+// Fixed ACPI Description Table Boot Architecture Flags

+// All other bits are reserved and must be set to 0.

+//

+#define EFI_ACPI_5_1_LEGACY_DEVICES              BIT0

+#define EFI_ACPI_5_1_8042                        BIT1

+#define EFI_ACPI_5_1_VGA_NOT_PRESENT             BIT2

+#define EFI_ACPI_5_1_MSI_NOT_SUPPORTED           BIT3

+#define EFI_ACPI_5_1_PCIE_ASPM_CONTROLS          BIT4

+#define EFI_ACPI_5_1_CMOS_RTC_NOT_PRESENT        BIT5

+

+//

+// Fixed ACPI Description Table Arm Boot Architecture Flags

+// All other bits are reserved and must be set to 0.

+//

+#define EFI_ACPI_5_1_ARM_PSCI_COMPLIANT              BIT0

+#define EFI_ACPI_5_1_ARM_PSCI_USE_HVC                BIT1

+

+//

+// Fixed ACPI Description Table Fixed Feature Flags

+// All other bits are reserved and must be set to 0.

+//

+#define EFI_ACPI_5_1_WBINVD                                 BIT0

+#define EFI_ACPI_5_1_WBINVD_FLUSH                           BIT1

+#define EFI_ACPI_5_1_PROC_C1                                BIT2

+#define EFI_ACPI_5_1_P_LVL2_UP                              BIT3

+#define EFI_ACPI_5_1_PWR_BUTTON                             BIT4

+#define EFI_ACPI_5_1_SLP_BUTTON                             BIT5

+#define EFI_ACPI_5_1_FIX_RTC                                BIT6

+#define EFI_ACPI_5_1_RTC_S4                                 BIT7

+#define EFI_ACPI_5_1_TMR_VAL_EXT                            BIT8

+#define EFI_ACPI_5_1_DCK_CAP                                BIT9

+#define EFI_ACPI_5_1_RESET_REG_SUP                          BIT10

+#define EFI_ACPI_5_1_SEALED_CASE                            BIT11

+#define EFI_ACPI_5_1_HEADLESS                               BIT12

+#define EFI_ACPI_5_1_CPU_SW_SLP                             BIT13

+#define EFI_ACPI_5_1_PCI_EXP_WAK                            BIT14

+#define EFI_ACPI_5_1_USE_PLATFORM_CLOCK                     BIT15

+#define EFI_ACPI_5_1_S4_RTC_STS_VALID                       BIT16

+#define EFI_ACPI_5_1_REMOTE_POWER_ON_CAPABLE                BIT17

+#define EFI_ACPI_5_1_FORCE_APIC_CLUSTER_MODEL               BIT18

+#define EFI_ACPI_5_1_FORCE_APIC_PHYSICAL_DESTINATION_MODE   BIT19

+#define EFI_ACPI_5_1_HW_REDUCED_ACPI                        BIT20

+#define EFI_ACPI_5_1_LOW_POWER_S0_IDLE_CAPABLE              BIT21

+

+///

+/// Firmware ACPI Control Structure

+///

+typedef struct {

+  UINT32  Signature;

+  UINT32  Length;

+  UINT32  HardwareSignature;

+  UINT32  FirmwareWakingVector;

+  UINT32  GlobalLock;

+  UINT32  Flags;

+  UINT64  XFirmwareWakingVector;

+  UINT8   Version;

+  UINT8   Reserved0[3];

+  UINT32  OspmFlags;

+  UINT8   Reserved1[24];

+} EFI_ACPI_5_1_FIRMWARE_ACPI_CONTROL_STRUCTURE;

+

+///

+/// FACS Version (as defined in ACPI 5.1 spec.)

+///

+#define EFI_ACPI_5_1_FIRMWARE_ACPI_CONTROL_STRUCTURE_VERSION  0x02

+

+///

+/// Firmware Control Structure Feature Flags

+/// All other bits are reserved and must be set to 0.

+///

+#define EFI_ACPI_5_1_S4BIOS_F                     BIT0

+#define EFI_ACPI_5_1_64BIT_WAKE_SUPPORTED_F       BIT1

+

+///

+/// OSPM Enabled Firmware Control Structure Flags

+/// All other bits are reserved and must be set to 0.

+///

+#define EFI_ACPI_5_1_OSPM_64BIT_WAKE_F            BIT0

+

+//

+// Differentiated System Description Table,

+// Secondary System Description Table

+// and Persistent System Description Table,

+// no definition needed as they are common description table header, the same with

+// EFI_ACPI_DESCRIPTION_HEADER, followed by a definition block.

+//

+#define EFI_ACPI_5_1_DIFFERENTIATED_SYSTEM_DESCRIPTION_TABLE_REVISION   0x02

+#define EFI_ACPI_5_1_SECONDARY_SYSTEM_DESCRIPTION_TABLE_REVISION        0x02

+

+///

+/// Multiple APIC Description Table header definition.  The rest of the table

+/// must be defined in a platform specific manner.

+///

+typedef struct {

+  EFI_ACPI_DESCRIPTION_HEADER Header;

+  UINT32                      LocalApicAddress;

+  UINT32                      Flags;

+} EFI_ACPI_5_1_MULTIPLE_APIC_DESCRIPTION_TABLE_HEADER;

+

+///

+/// MADT Revision (as defined in ACPI 5.1 spec.)

+///

+#define EFI_ACPI_5_1_MULTIPLE_APIC_DESCRIPTION_TABLE_REVISION 0x03

+

+///

+/// Multiple APIC Flags

+/// All other bits are reserved and must be set to 0.

+///

+#define EFI_ACPI_5_1_PCAT_COMPAT         BIT0

+

+//

+// Multiple APIC Description Table APIC structure types

+// All other values between 0x0D and 0x7F are reserved and

+// will be ignored by OSPM. 0x80 ~ 0xFF are reserved for OEM.

+//

+#define EFI_ACPI_5_1_PROCESSOR_LOCAL_APIC           0x00

+#define EFI_ACPI_5_1_IO_APIC                        0x01

+#define EFI_ACPI_5_1_INTERRUPT_SOURCE_OVERRIDE      0x02

+#define EFI_ACPI_5_1_NON_MASKABLE_INTERRUPT_SOURCE  0x03

+#define EFI_ACPI_5_1_LOCAL_APIC_NMI                 0x04

+#define EFI_ACPI_5_1_LOCAL_APIC_ADDRESS_OVERRIDE    0x05

+#define EFI_ACPI_5_1_IO_SAPIC                       0x06

+#define EFI_ACPI_5_1_LOCAL_SAPIC                    0x07

+#define EFI_ACPI_5_1_PLATFORM_INTERRUPT_SOURCES     0x08

+#define EFI_ACPI_5_1_PROCESSOR_LOCAL_X2APIC         0x09

+#define EFI_ACPI_5_1_LOCAL_X2APIC_NMI               0x0A

+#define EFI_ACPI_5_1_GIC                            0x0B

+#define EFI_ACPI_5_1_GICD                           0x0C

+#define EFI_ACPI_5_1_GIC_MSI_FRAME                  0x0D

+#define EFI_ACPI_5_1_GICR                           0x0E

+

+//

+// APIC Structure Definitions

+//

+

+///

+/// Processor Local APIC Structure Definition

+///

+typedef struct {

+  UINT8   Type;

+  UINT8   Length;

+  UINT8   AcpiProcessorId;

+  UINT8   ApicId;

+  UINT32  Flags;

+} EFI_ACPI_5_1_PROCESSOR_LOCAL_APIC_STRUCTURE;

+

+///

+/// Local APIC Flags.  All other bits are reserved and must be 0.

+///

+#define EFI_ACPI_5_1_LOCAL_APIC_ENABLED        BIT0

+

+///

+/// IO APIC Structure

+///

+typedef struct {

+  UINT8   Type;

+  UINT8   Length;

+  UINT8   IoApicId;

+  UINT8   Reserved;

+  UINT32  IoApicAddress;

+  UINT32  GlobalSystemInterruptBase;

+} EFI_ACPI_5_1_IO_APIC_STRUCTURE;

+

+///

+/// Interrupt Source Override Structure

+///

+typedef struct {

+  UINT8   Type;

+  UINT8   Length;

+  UINT8   Bus;

+  UINT8   Source;

+  UINT32  GlobalSystemInterrupt;

+  UINT16  Flags;

+} EFI_ACPI_5_1_INTERRUPT_SOURCE_OVERRIDE_STRUCTURE;

+

+///

+/// Platform Interrupt Sources Structure Definition

+///

+typedef struct {

+  UINT8   Type;

+  UINT8   Length;

+  UINT16  Flags;

+  UINT8   InterruptType;

+  UINT8   ProcessorId;

+  UINT8   ProcessorEid;

+  UINT8   IoSapicVector;

+  UINT32  GlobalSystemInterrupt;

+  UINT32  PlatformInterruptSourceFlags;

+  UINT8   CpeiProcessorOverride;

+  UINT8   Reserved[31];

+} EFI_ACPI_5_1_PLATFORM_INTERRUPT_APIC_STRUCTURE;

+

+//

+// MPS INTI flags.

+// All other bits are reserved and must be set to 0.

+//

+#define EFI_ACPI_5_1_POLARITY      (3 << 0)

+#define EFI_ACPI_5_1_TRIGGER_MODE  (3 << 2)

+

+///

+/// Non-Maskable Interrupt Source Structure

+///

+typedef struct {

+  UINT8   Type;

+  UINT8   Length;

+  UINT16  Flags;

+  UINT32  GlobalSystemInterrupt;

+} EFI_ACPI_5_1_NON_MASKABLE_INTERRUPT_SOURCE_STRUCTURE;

+

+///

+/// Local APIC NMI Structure

+///

+typedef struct {

+  UINT8   Type;

+  UINT8   Length;

+  UINT8   AcpiProcessorId;

+  UINT16  Flags;

+  UINT8   LocalApicLint;

+} EFI_ACPI_5_1_LOCAL_APIC_NMI_STRUCTURE;

+

+///

+/// Local APIC Address Override Structure

+///

+typedef struct {

+  UINT8   Type;

+  UINT8   Length;

+  UINT16  Reserved;

+  UINT64  LocalApicAddress;

+} EFI_ACPI_5_1_LOCAL_APIC_ADDRESS_OVERRIDE_STRUCTURE;

+

+///

+/// IO SAPIC Structure

+///

+typedef struct {

+  UINT8   Type;

+  UINT8   Length;

+  UINT8   IoApicId;

+  UINT8   Reserved;

+  UINT32  GlobalSystemInterruptBase;

+  UINT64  IoSapicAddress;

+} EFI_ACPI_5_1_IO_SAPIC_STRUCTURE;

+

+///

+/// Local SAPIC Structure

+/// This struct followed by a null-terminated ASCII string - ACPI Processor UID String

+///

+typedef struct {

+  UINT8   Type;

+  UINT8   Length;

+  UINT8   AcpiProcessorId;

+  UINT8   LocalSapicId;

+  UINT8   LocalSapicEid;

+  UINT8   Reserved[3];

+  UINT32  Flags;

+  UINT32  ACPIProcessorUIDValue;

+} EFI_ACPI_5_1_PROCESSOR_LOCAL_SAPIC_STRUCTURE;

+

+///

+/// Platform Interrupt Sources Structure

+///

+typedef struct {

+  UINT8   Type;

+  UINT8   Length;

+  UINT16  Flags;

+  UINT8   InterruptType;

+  UINT8   ProcessorId;

+  UINT8   ProcessorEid;

+  UINT8   IoSapicVector;

+  UINT32  GlobalSystemInterrupt;

+  UINT32  PlatformInterruptSourceFlags;

+} EFI_ACPI_5_1_PLATFORM_INTERRUPT_SOURCES_STRUCTURE;

+

+///

+/// Platform Interrupt Source Flags.

+/// All other bits are reserved and must be set to 0.

+///

+#define EFI_ACPI_5_1_CPEI_PROCESSOR_OVERRIDE          BIT0

+

+///

+/// Processor Local x2APIC Structure Definition

+///

+typedef struct {

+  UINT8   Type;

+  UINT8   Length;

+  UINT8   Reserved[2];

+  UINT32  X2ApicId;

+  UINT32  Flags;

+  UINT32  AcpiProcessorUid;

+} EFI_ACPI_5_1_PROCESSOR_LOCAL_X2APIC_STRUCTURE;

+

+///

+/// Local x2APIC NMI Structure

+///

+typedef struct {

+  UINT8   Type;

+  UINT8   Length;

+  UINT16  Flags;

+  UINT32  AcpiProcessorUid;

+  UINT8   LocalX2ApicLint;

+  UINT8   Reserved[3];

+} EFI_ACPI_5_1_LOCAL_X2APIC_NMI_STRUCTURE;

+

+///

+/// GIC Structure

+///

+typedef struct {

+  UINT8   Type;

+  UINT8   Length;

+  UINT16  Reserved;

+  UINT32  CPUInterfaceNumber;

+  UINT32  AcpiProcessorUid;

+  UINT32  Flags;

+  UINT32  ParkingProtocolVersion;

+  UINT32  PerformanceInterruptGsiv;

+  UINT64  ParkedAddress;

+  UINT64  PhysicalBaseAddress;

+  UINT64  GICV;

+  UINT64  GICH;

+  UINT32  VGICMaintenanceInterrupt;

+  UINT64  GICRBaseAddress;

+  UINT64  MPIDR;

+} EFI_ACPI_5_1_GIC_STRUCTURE;

+

+///

+/// GIC Flags.  All other bits are reserved and must be 0.

+///

+#define EFI_ACPI_5_1_GIC_ENABLED                              BIT0

+#define EFI_ACPI_5_1_PERFORMANCE_INTERRUPT_MODEL              BIT1

+#define EFI_ACPI_5_1_VGIC_MAINTENANCE_INTERRUPT_MODE_FLAGS    BIT2

+

+///

+/// GIC Distributor Structure

+///

+typedef struct {

+  UINT8   Type;

+  UINT8   Length;

+  UINT16  Reserved1;

+  UINT32  GicId;

+  UINT64  PhysicalBaseAddress;

+  UINT32  SystemVectorBase;

+  UINT8   GicVersion;

+  UINT8   Reserved2[3];

+} EFI_ACPI_5_1_GIC_DISTRIBUTOR_STRUCTURE;

+

+///

+/// GIC Version

+///

+#define EFI_ACPI_5_1_GIC_V1                                   0x01

+#define EFI_ACPI_5_1_GIC_V2                                   0x02

+#define EFI_ACPI_5_1_GIC_V3                                   0x03

+#define EFI_ACPI_5_1_GIC_V4                                   0x04

+

+///

+/// GIC MSI Frame Structure

+///

+typedef struct {

+  UINT8   Type;

+  UINT8   Length;

+  UINT16  Reserved1;

+  UINT32  GicMsiFrameId;

+  UINT64  PhysicalBaseAddress;

+  UINT32  Flags;

+  UINT16  SPICount;

+  UINT16  SPIBase;

+} EFI_ACPI_5_1_GIC_MSI_FRAME_STRUCTURE;

+

+///

+/// GIC MSI Frame Flags.  All other bits are reserved and must be 0.

+///

+#define EFI_ACPI_5_1_SPI_COUNT_BASE_SELECT                    BIT0

+

+///

+/// GICR Structure

+///

+typedef struct {

+  UINT8   Type;

+  UINT8   Length;

+  UINT16  Reserved;

+  UINT64  DiscoveryRangeBaseAddress;

+  UINT32  DiscoveryRangeLength;

+} EFI_ACPI_5_1_GICR_STRUCTURE;

+

+///

+/// Smart Battery Description Table (SBST)

+///

+typedef struct {

+  EFI_ACPI_DESCRIPTION_HEADER Header;

+  UINT32                      WarningEnergyLevel;

+  UINT32                      LowEnergyLevel;

+  UINT32                      CriticalEnergyLevel;

+} EFI_ACPI_5_1_SMART_BATTERY_DESCRIPTION_TABLE;

+

+///

+/// SBST Version (as defined in ACPI 5.1 spec.)

+///

+#define EFI_ACPI_5_1_SMART_BATTERY_DESCRIPTION_TABLE_REVISION 0x01

+

+///

+/// Embedded Controller Boot Resources Table (ECDT)

+/// The table is followed by a null terminated ASCII string that contains

+/// a fully qualified reference to the name space object.

+///

+typedef struct {

+  EFI_ACPI_DESCRIPTION_HEADER             Header;

+  EFI_ACPI_5_1_GENERIC_ADDRESS_STRUCTURE  EcControl;

+  EFI_ACPI_5_1_GENERIC_ADDRESS_STRUCTURE  EcData;

+  UINT32                                  Uid;

+  UINT8                                   GpeBit;

+} EFI_ACPI_5_1_EMBEDDED_CONTROLLER_BOOT_RESOURCES_TABLE;

+

+///

+/// ECDT Version (as defined in ACPI 5.1 spec.)

+///

+#define EFI_ACPI_5_1_EMBEDDED_CONTROLLER_BOOT_RESOURCES_TABLE_REVISION  0x01

+

+///

+/// System Resource Affinity Table (SRAT).  The rest of the table

+/// must be defined in a platform specific manner.

+///

+typedef struct {

+  EFI_ACPI_DESCRIPTION_HEADER Header;

+  UINT32                      Reserved1;  ///< Must be set to 1

+  UINT64                      Reserved2;

+} EFI_ACPI_5_1_SYSTEM_RESOURCE_AFFINITY_TABLE_HEADER;

+

+///

+/// SRAT Version (as defined in ACPI 5.1 spec.)

+///

+#define EFI_ACPI_5_1_SYSTEM_RESOURCE_AFFINITY_TABLE_REVISION  0x03

+

+//

+// SRAT structure types.

+// All other values between 0x04 an 0xFF are reserved and

+// will be ignored by OSPM.

+//

+#define EFI_ACPI_5_1_PROCESSOR_LOCAL_APIC_SAPIC_AFFINITY  0x00

+#define EFI_ACPI_5_1_MEMORY_AFFINITY                      0x01

+#define EFI_ACPI_5_1_PROCESSOR_LOCAL_X2APIC_AFFINITY      0x02

+#define EFI_ACPI_5_1_GICC_AFFINITY                        0x03

+

+///

+/// Processor Local APIC/SAPIC Affinity Structure Definition

+///

+typedef struct {

+  UINT8   Type;

+  UINT8   Length;

+  UINT8   ProximityDomain7To0;

+  UINT8   ApicId;

+  UINT32  Flags;

+  UINT8   LocalSapicEid;

+  UINT8   ProximityDomain31To8[3];

+  UINT32  ClockDomain;

+} EFI_ACPI_5_1_PROCESSOR_LOCAL_APIC_SAPIC_AFFINITY_STRUCTURE;

+

+///

+/// Local APIC/SAPIC Flags.  All other bits are reserved and must be 0.

+///

+#define EFI_ACPI_5_1_PROCESSOR_LOCAL_APIC_SAPIC_ENABLED (1 << 0)

+

+///

+/// Memory Affinity Structure Definition

+///

+typedef struct {

+  UINT8   Type;

+  UINT8   Length;

+  UINT32  ProximityDomain;

+  UINT16  Reserved1;

+  UINT32  AddressBaseLow;

+  UINT32  AddressBaseHigh;

+  UINT32  LengthLow;

+  UINT32  LengthHigh;

+  UINT32  Reserved2;

+  UINT32  Flags;

+  UINT64  Reserved3;

+} EFI_ACPI_5_1_MEMORY_AFFINITY_STRUCTURE;

+

+//

+// Memory Flags.  All other bits are reserved and must be 0.

+//

+#define EFI_ACPI_5_1_MEMORY_ENABLED       (1 << 0)

+#define EFI_ACPI_5_1_MEMORY_HOT_PLUGGABLE (1 << 1)

+#define EFI_ACPI_5_1_MEMORY_NONVOLATILE   (1 << 2)

+

+///

+/// Processor Local x2APIC Affinity Structure Definition

+///

+typedef struct {

+  UINT8   Type;

+  UINT8   Length;

+  UINT8   Reserved1[2];

+  UINT32  ProximityDomain;

+  UINT32  X2ApicId;

+  UINT32  Flags;

+  UINT32  ClockDomain;

+  UINT8   Reserved2[4];

+} EFI_ACPI_5_1_PROCESSOR_LOCAL_X2APIC_AFFINITY_STRUCTURE;

+

+///

+/// GICC Affinity Structure Definition

+///

+typedef struct {

+  UINT8   Type;

+  UINT8   Length;

+  UINT32  ProximityDomain;

+  UINT32  AcpiProcessorUid;

+  UINT32  Flags;

+  UINT32  ClockDomain;

+} EFI_ACPI_5_1_GICC_AFFINITY_STRUCTURE;

+

+///

+/// GICC Flags.  All other bits are reserved and must be 0.

+///

+#define EFI_ACPI_5_1_GICC_ENABLED (1 << 0)

+

+///

+/// System Locality Distance Information Table (SLIT).

+/// The rest of the table is a matrix.

+///

+typedef struct {

+  EFI_ACPI_DESCRIPTION_HEADER Header;

+  UINT64                      NumberOfSystemLocalities;

+} EFI_ACPI_5_1_SYSTEM_LOCALITY_DISTANCE_INFORMATION_TABLE_HEADER;

+

+///

+/// SLIT Version (as defined in ACPI 5.1 spec.)

+///

+#define EFI_ACPI_5_1_SYSTEM_LOCALITY_DISTANCE_INFORMATION_TABLE_REVISION  0x01

+

+///

+/// Corrected Platform Error Polling Table (CPEP)

+///

+typedef struct {

+  EFI_ACPI_DESCRIPTION_HEADER Header;

+  UINT8                       Reserved[8];

+} EFI_ACPI_5_1_CORRECTED_PLATFORM_ERROR_POLLING_TABLE_HEADER;

+

+///

+/// CPEP Version (as defined in ACPI 5.1 spec.)

+///

+#define EFI_ACPI_5_1_CORRECTED_PLATFORM_ERROR_POLLING_TABLE_REVISION 0x01

+

+//

+// CPEP processor structure types.

+//

+#define EFI_ACPI_5_1_CPEP_PROCESSOR_APIC_SAPIC  0x00

+

+///

+/// Corrected Platform Error Polling Processor Structure Definition

+///

+typedef struct {

+  UINT8   Type;

+  UINT8   Length;

+  UINT8   ProcessorId;

+  UINT8   ProcessorEid;

+  UINT32  PollingInterval;

+} EFI_ACPI_5_1_CPEP_PROCESSOR_APIC_SAPIC_STRUCTURE;

+

+///

+/// Maximum System Characteristics Table (MSCT)

+///

+typedef struct {

+  EFI_ACPI_DESCRIPTION_HEADER Header;

+  UINT32                      OffsetProxDomInfo;

+  UINT32                      MaximumNumberOfProximityDomains;

+  UINT32                      MaximumNumberOfClockDomains;

+  UINT64                      MaximumPhysicalAddress;

+} EFI_ACPI_5_1_MAXIMUM_SYSTEM_CHARACTERISTICS_TABLE_HEADER;

+

+///

+/// MSCT Version (as defined in ACPI 5.1 spec.)

+///

+#define EFI_ACPI_5_1_MAXIMUM_SYSTEM_CHARACTERISTICS_TABLE_REVISION 0x01

+

+///

+/// Maximum Proximity Domain Information Structure Definition

+///

+typedef struct {

+  UINT8   Revision;

+  UINT8   Length;

+  UINT32  ProximityDomainRangeLow;

+  UINT32  ProximityDomainRangeHigh;

+  UINT32  MaximumProcessorCapacity;

+  UINT64  MaximumMemoryCapacity;

+} EFI_ACPI_5_1_MAXIMUM_PROXIMITY_DOMAIN_INFORMATION_STRUCTURE;

+

+///

+/// ACPI RAS Feature Table definition.

+///

+typedef struct {

+  EFI_ACPI_DESCRIPTION_HEADER Header;

+  UINT8                       PlatformCommunicationChannelIdentifier[12];

+} EFI_ACPI_5_1_RAS_FEATURE_TABLE;

+

+///

+/// RASF Version (as defined in ACPI 5.1 spec.)

+///

+#define EFI_ACPI_5_1_RAS_FEATURE_TABLE_REVISION 0x01

+

+///

+/// ACPI RASF Platform Communication Channel Shared Memory Region definition.

+///

+typedef struct {

+  UINT32                      Signature;

+  UINT16                      Command;

+  UINT16                      Status;

+  UINT16                      Version;

+  UINT8                       RASCapabilities[16];

+  UINT8                       SetRASCapabilities[16];

+  UINT16                      NumberOfRASFParameterBlocks;

+  UINT32                      SetRASCapabilitiesStatus;

+} EFI_ACPI_5_1_RASF_PLATFORM_COMMUNICATION_CHANNEL_SHARED_MEMORY_REGION;

+

+///

+/// ACPI RASF PCC command code

+///

+#define EFI_ACPI_5_1_RASF_PCC_COMMAND_CODE_EXECUTE_RASF_COMMAND  0x01

+

+///

+/// ACPI RASF Platform RAS Capabilities

+///

+#define EFI_ACPI_5_1_RASF_PLATFORM_RAS_CAPABILITY_HARDWARE_BASED_PATROL_SCRUB_SUPPOTED                          0x01

+#define EFI_ACPI_5_1_RASF_PLATFORM_RAS_CAPABILITY_HARDWARE_BASED_PATROL_SCRUB_SUPPOTED_AND_EXPOSED_TO_SOFTWARE  0x02

+

+///

+/// ACPI RASF Parameter Block structure for PATROL_SCRUB

+///

+typedef struct {

+  UINT16                      Type;

+  UINT16                      Version;

+  UINT16                      Length;

+  UINT16                      PatrolScrubCommand;

+  UINT64                      RequestedAddressRange[2];

+  UINT64                      ActualAddressRange[2];

+  UINT16                      Flags;

+  UINT8                       RequestedSpeed;

+} EFI_ACPI_5_1_RASF_PATROL_SCRUB_PLATFORM_BLOCK_STRUCTURE;

+

+///

+/// ACPI RASF Patrol Scrub command

+///

+#define EFI_ACPI_5_1_RASF_PATROL_SCRUB_COMMAND_GET_PATROL_PARAMETERS   0x01

+#define EFI_ACPI_5_1_RASF_PATROL_SCRUB_COMMAND_START_PATROL_SCRUBBER   0x02

+#define EFI_ACPI_5_1_RASF_PATROL_SCRUB_COMMAND_STOP_PATROL_SCRUBBER    0x03

+

+///

+/// Memory Power State Table definition.

+///

+typedef struct {

+  EFI_ACPI_DESCRIPTION_HEADER Header;

+  UINT8                       PlatformCommunicationChannelIdentifier;

+  UINT8                       Reserved[3];

+// Memory Power Node Structure

+// Memory Power State Characteristics

+} EFI_ACPI_5_1_MEMORY_POWER_STATUS_TABLE;

+

+///

+/// MPST Version (as defined in ACPI 5.1 spec.)

+///

+#define EFI_ACPI_5_1_MEMORY_POWER_STATE_TABLE_REVISION 0x01

+

+///

+/// MPST Platform Communication Channel Shared Memory Region definition.

+///

+typedef struct {

+  UINT32                      Signature;

+  UINT16                      Command;

+  UINT16                      Status;

+  UINT32                      MemoryPowerCommandRegister;

+  UINT32                      MemoryPowerStatusRegister;

+  UINT32                      PowerStateId;

+  UINT32                      MemoryPowerNodeId;

+  UINT64                      MemoryEnergyConsumed;

+  UINT64                      ExpectedAveragePowerComsuned;

+} EFI_ACPI_5_1_MPST_PLATFORM_COMMUNICATION_CHANNEL_SHARED_MEMORY_REGION;

+

+///

+/// ACPI MPST PCC command code

+///

+#define EFI_ACPI_5_1_MPST_PCC_COMMAND_CODE_EXECUTE_MPST_COMMAND  0x03

+

+///

+/// ACPI MPST Memory Power command

+///

+#define EFI_ACPI_5_1_MPST_MEMORY_POWER_COMMAND_GET_MEMORY_POWER_STATE       0x01

+#define EFI_ACPI_5_1_MPST_MEMORY_POWER_COMMAND_SET_MEMORY_POWER_STATE       0x02

+#define EFI_ACPI_5_1_MPST_MEMORY_POWER_COMMAND_GET_AVERAGE_POWER_CONSUMED   0x03

+#define EFI_ACPI_5_1_MPST_MEMORY_POWER_COMMAND_GET_MEMORY_ENERGY_CONSUMED   0x04

+

+///

+/// MPST Memory Power Node Table

+///

+typedef struct {

+  UINT8                                             PowerStateValue;

+  UINT8                                             PowerStateInformationIndex;

+} EFI_ACPI_5_1_MPST_MEMORY_POWER_STATE;

+

+typedef struct {

+  UINT8                                             Flag;

+  UINT8                                             Reserved;

+  UINT16                                            MemoryPowerNodeId;

+  UINT32                                            Length;

+  UINT64                                            AddressBase;

+  UINT64                                            AddressLength;

+  UINT32                                            NumberOfPowerStates;

+  UINT32                                            NumberOfPhysicalComponents;

+//EFI_ACPI_5_1_MPST_MEMORY_POWER_STATE              MemoryPowerState[NumberOfPowerStates];

+//UINT16                                            PhysicalComponentIdentifier[NumberOfPhysicalComponents];

+} EFI_ACPI_5_1_MPST_MEMORY_POWER_STRUCTURE;

+

+#define EFI_ACPI_5_1_MPST_MEMORY_POWER_STRUCTURE_FLAG_ENABLE          0x01

+#define EFI_ACPI_5_1_MPST_MEMORY_POWER_STRUCTURE_FLAG_POWER_MANAGED   0x02

+#define EFI_ACPI_5_1_MPST_MEMORY_POWER_STRUCTURE_FLAG_HOT_PLUGGABLE   0x04

+

+typedef struct {

+  UINT16                      MemoryPowerNodeCount;

+  UINT8                       Reserved[2];

+} EFI_ACPI_5_1_MPST_MEMORY_POWER_NODE_TABLE;

+

+///

+/// MPST Memory Power State Characteristics Table

+///

+typedef struct {

+  UINT8                                             PowerStateStructureID;

+  UINT8                                             Flag;

+  UINT16                                            Reserved;

+  UINT32                                            AveragePowerConsumedInMPS0;

+  UINT32                                            RelativePowerSavingToMPS0;

+  UINT64                                            ExitLatencyToMPS0;

+} EFI_ACPI_5_1_MPST_MEMORY_POWER_STATE_CHARACTERISTICS_STRUCTURE;

+

+#define EFI_ACPI_5_1_MPST_MEMORY_POWER_STATE_CHARACTERISTICS_STRUCTURE_FLAG_MEMORY_CONTENT_PRESERVED              0x01

+#define EFI_ACPI_5_1_MPST_MEMORY_POWER_STATE_CHARACTERISTICS_STRUCTURE_FLAG_AUTONOMOUS_MEMORY_POWER_STATE_ENTRY   0x02

+#define EFI_ACPI_5_1_MPST_MEMORY_POWER_STATE_CHARACTERISTICS_STRUCTURE_FLAG_AUTONOMOUS_MEMORY_POWER_STATE_EXIT    0x04

+

+typedef struct {

+  UINT16                      MemoryPowerStateCharacteristicsCount;

+  UINT8                       Reserved[2];

+} EFI_ACPI_5_1_MPST_MEMORY_POWER_STATE_CHARACTERISTICS_TABLE;

+

+///

+/// Memory Topology Table definition.

+///

+typedef struct {

+  EFI_ACPI_DESCRIPTION_HEADER Header;

+  UINT32                      Reserved;

+} EFI_ACPI_5_1_MEMORY_TOPOLOGY_TABLE;

+

+///

+/// PMTT Version (as defined in ACPI 5.1 spec.)

+///

+#define EFI_ACPI_5_1_MEMORY_TOPOLOGY_TABLE_REVISION 0x01

+

+///

+/// Common Memory Aggregator Device Structure.

+///

+typedef struct {

+  UINT8                       Type;

+  UINT8                       Reserved;

+  UINT16                      Length;

+  UINT16                      Flags;

+  UINT16                      Reserved1;

+} EFI_ACPI_5_1_PMMT_COMMON_MEMORY_AGGREGATOR_DEVICE_STRUCTURE;

+

+///

+/// Memory Aggregator Device Type

+///

+#define EFI_ACPI_5_1_PMMT_MEMORY_AGGREGATOR_DEVICE_TYPE_SOCKET            0x1

+#define EFI_ACPI_5_1_PMMT_MEMORY_AGGREGATOR_DEVICE_TYPE_MEMORY_CONTROLLER 0x2

+#define EFI_ACPI_5_1_PMMT_MEMORY_AGGREGATOR_DEVICE_TYPE_DIMM              0x3

+

+///

+/// Socket Memory Aggregator Device Structure.

+///

+typedef struct {

+  EFI_ACPI_5_1_PMMT_COMMON_MEMORY_AGGREGATOR_DEVICE_STRUCTURE  Header;

+  UINT16                                                       SocketIdentifier;

+  UINT16                                                       Reserved;

+//EFI_ACPI_5_1_PMMT_MEMORY_CONTROLLER_MEMORY_AGGREGATOR_DEVICE_STRUCTURE  MemoryController[];

+} EFI_ACPI_5_1_PMMT_SOCKET_MEMORY_AGGREGATOR_DEVICE_STRUCTURE;

+

+///

+/// MemoryController Memory Aggregator Device Structure.

+///

+typedef struct {

+  EFI_ACPI_5_1_PMMT_COMMON_MEMORY_AGGREGATOR_DEVICE_STRUCTURE  Header;

+  UINT32                                                       ReadLatency;

+  UINT32                                                       WriteLatency;

+  UINT32                                                       ReadBandwidth;

+  UINT32                                                       WriteBandwidth;

+  UINT16                                                       OptimalAccessUnit;

+  UINT16                                                       OptimalAccessAlignment;

+  UINT16                                                       Reserved;

+  UINT16                                                       NumberOfProximityDomains;

+//UINT32                                                       ProximityDomain[NumberOfProximityDomains];

+//EFI_ACPI_5_1_PMMT_DIMM_MEMORY_AGGREGATOR_DEVICE_STRUCTURE    PhysicalComponent[];

+} EFI_ACPI_5_1_PMMT_MEMORY_CONTROLLER_MEMORY_AGGREGATOR_DEVICE_STRUCTURE;

+

+///

+/// DIMM Memory Aggregator Device Structure.

+///

+typedef struct {

+  EFI_ACPI_5_1_PMMT_COMMON_MEMORY_AGGREGATOR_DEVICE_STRUCTURE  Header;

+  UINT16                                                       PhysicalComponentIdentifier;

+  UINT16                                                       Reserved;

+  UINT32                                                       SizeOfDimm;

+  UINT32                                                       SmbiosHandle;

+} EFI_ACPI_5_1_PMMT_DIMM_MEMORY_AGGREGATOR_DEVICE_STRUCTURE;

+

+///

+/// Boot Graphics Resource Table definition.

+///

+typedef struct {

+  EFI_ACPI_DESCRIPTION_HEADER Header;

+  ///

+  /// 2-bytes (16 bit) version ID. This value must be 1.

+  ///

+  UINT16                      Version;

+  ///

+  /// 1-byte status field indicating current status about the table.

+  ///     Bits[7:1] = Reserved (must be zero)

+  ///     Bit [0] = Valid. A one indicates the boot image graphic is valid.

+  ///

+  UINT8                       Status;

+  ///

+  /// 1-byte enumerated type field indicating format of the image.

+  ///     0 = Bitmap

+  ///     1 - 255  Reserved (for future use)

+  ///

+  UINT8                       ImageType;

+  ///

+  /// 8-byte (64 bit) physical address pointing to the firmware's in-memory copy

+  /// of the image bitmap.

+  ///

+  UINT64                      ImageAddress;

+  ///

+  /// A 4-byte (32-bit) unsigned long describing the display X-offset of the boot image.

+  /// (X, Y) display offset of the top left corner of the boot image.

+  /// The top left corner of the display is at offset (0, 0).

+  ///

+  UINT32                      ImageOffsetX;

+  ///

+  /// A 4-byte (32-bit) unsigned long describing the display Y-offset of the boot image.

+  /// (X, Y) display offset of the top left corner of the boot image.

+  /// The top left corner of the display is at offset (0, 0).

+  ///

+  UINT32                      ImageOffsetY;

+} EFI_ACPI_5_1_BOOT_GRAPHICS_RESOURCE_TABLE;

+

+///

+/// BGRT Revision

+///

+#define EFI_ACPI_5_1_BOOT_GRAPHICS_RESOURCE_TABLE_REVISION 1

+

+///

+/// BGRT Version

+///

+#define EFI_ACPI_5_1_BGRT_VERSION         0x01

+

+///

+/// BGRT Status

+///

+#define EFI_ACPI_5_1_BGRT_STATUS_NOT_DISPLAYED 0x00

+#define EFI_ACPI_5_1_BGRT_STATUS_DISPLAYED     0x01

+

+///

+/// BGRT Image Type

+///

+#define EFI_ACPI_5_1_BGRT_IMAGE_TYPE_BMP  0x00

+

+///

+/// FPDT Version (as defined in ACPI 5.1 spec.)

+///

+#define EFI_ACPI_5_1_FIRMWARE_PERFORMANCE_DATA_TABLE_REVISION 0x01

+

+///

+/// FPDT Performance Record Types

+///

+#define EFI_ACPI_5_1_FPDT_RECORD_TYPE_FIRMWARE_BASIC_BOOT_POINTER      0x0000

+#define EFI_ACPI_5_1_FPDT_RECORD_TYPE_S3_PERFORMANCE_TABLE_POINTER     0x0001

+

+///

+/// FPDT Performance Record Revision

+///

+#define EFI_ACPI_5_1_FPDT_RECORD_REVISION_FIRMWARE_BASIC_BOOT_POINTER  0x01

+#define EFI_ACPI_5_1_FPDT_RECORD_REVISION_S3_PERFORMANCE_TABLE_POINTER 0x01

+

+///

+/// FPDT Runtime Performance Record Types

+///

+#define EFI_ACPI_5_1_FPDT_RUNTIME_RECORD_TYPE_S3_RESUME                0x0000

+#define EFI_ACPI_5_1_FPDT_RUNTIME_RECORD_TYPE_S3_SUSPEND               0x0001

+#define EFI_ACPI_5_1_FPDT_RUNTIME_RECORD_TYPE_FIRMWARE_BASIC_BOOT      0x0002

+

+///

+/// FPDT Runtime Performance Record Revision

+///

+#define EFI_ACPI_5_1_FPDT_RUNTIME_RECORD_REVISION_S3_RESUME            0x01

+#define EFI_ACPI_5_1_FPDT_RUNTIME_RECORD_REVISION_S3_SUSPEND           0x01

+#define EFI_ACPI_5_1_FPDT_RUNTIME_RECORD_REVISION_FIRMWARE_BASIC_BOOT  0x02

+

+///

+/// FPDT Performance Record header

+///

+typedef struct {

+  UINT16           Type;

+  UINT8            Length;

+  UINT8            Revision;

+} EFI_ACPI_5_1_FPDT_PERFORMANCE_RECORD_HEADER;

+

+///

+/// FPDT Performance Table header

+///

+typedef struct {

+  UINT32  Signature;

+  UINT32  Length;

+} EFI_ACPI_5_1_FPDT_PERFORMANCE_TABLE_HEADER;

+

+///

+/// FPDT Firmware Basic Boot Performance Pointer Record Structure

+///

+typedef struct {

+  EFI_ACPI_5_1_FPDT_PERFORMANCE_RECORD_HEADER     Header;

+  UINT32                                          Reserved;

+  ///

+  /// 64-bit processor-relative physical address of the Basic Boot Performance Table.

+  ///

+  UINT64                                          BootPerformanceTablePointer;

+} EFI_ACPI_5_1_FPDT_BOOT_PERFORMANCE_TABLE_POINTER_RECORD;

+

+///

+/// FPDT S3 Performance Table Pointer Record Structure

+///

+typedef struct {

+  EFI_ACPI_5_1_FPDT_PERFORMANCE_RECORD_HEADER     Header;

+  UINT32                                          Reserved;

+  ///

+  /// 64-bit processor-relative physical address of the S3 Performance Table.

+  ///

+  UINT64                                          S3PerformanceTablePointer;

+} EFI_ACPI_5_1_FPDT_S3_PERFORMANCE_TABLE_POINTER_RECORD;

+

+///

+/// FPDT Firmware Basic Boot Performance Record Structure

+///

+typedef struct {

+  EFI_ACPI_5_1_FPDT_PERFORMANCE_RECORD_HEADER     Header;

+  UINT32                                          Reserved;

+  ///

+  /// Timer value logged at the beginning of firmware image execution.

+  /// This may not always be zero or near zero.

+  ///

+  UINT64                                          ResetEnd;

+  ///

+  /// Timer value logged just prior to loading the OS boot loader into memory.

+  /// For non-UEFI compatible boots, this field must be zero.

+  ///

+  UINT64                                          OsLoaderLoadImageStart;

+  ///

+  /// Timer value logged just prior to launching the previously loaded OS boot loader image.

+  /// For non-UEFI compatible boots, the timer value logged will be just prior

+  /// to the INT 19h handler invocation.

+  ///

+  UINT64                                          OsLoaderStartImageStart;

+  ///

+  /// Timer value logged at the point when the OS loader calls the

+  /// ExitBootServices function for UEFI compatible firmware.

+  /// For non-UEFI compatible boots, this field must be zero.

+  ///

+  UINT64                                          ExitBootServicesEntry;

+  ///

+  /// Timer value logged at the point just prior to when the OS loader gaining

+  /// control back from calls the ExitBootServices function for UEFI compatible firmware.

+  /// For non-UEFI compatible boots, this field must be zero.

+  ///

+  UINT64                                          ExitBootServicesExit;

+} EFI_ACPI_5_1_FPDT_FIRMWARE_BASIC_BOOT_RECORD;

+

+///

+/// FPDT Firmware Basic Boot Performance Table signature

+///

+#define EFI_ACPI_5_1_FPDT_BOOT_PERFORMANCE_TABLE_SIGNATURE  SIGNATURE_32('F', 'B', 'P', 'T')

+

+//

+// FPDT Firmware Basic Boot Performance Table

+//

+typedef struct {

+  EFI_ACPI_5_1_FPDT_PERFORMANCE_TABLE_HEADER      Header;

+  //

+  // one or more Performance Records.

+  //

+} EFI_ACPI_5_1_FPDT_FIRMWARE_BASIC_BOOT_TABLE;

+

+///

+/// FPDT "S3PT" S3 Performance Table

+///

+#define EFI_ACPI_5_1_FPDT_S3_PERFORMANCE_TABLE_SIGNATURE  SIGNATURE_32('S', '3', 'P', 'T')

+

+//

+// FPDT Firmware S3 Boot Performance Table

+//

+typedef struct {

+  EFI_ACPI_5_1_FPDT_PERFORMANCE_TABLE_HEADER      Header;

+  //

+  // one or more Performance Records.

+  //

+} EFI_ACPI_5_1_FPDT_FIRMWARE_S3_BOOT_TABLE;

+

+///

+/// FPDT Basic S3 Resume Performance Record

+///

+typedef struct {

+  EFI_ACPI_5_1_FPDT_PERFORMANCE_RECORD_HEADER     Header;

+  ///

+  /// A count of the number of S3 resume cycles since the last full boot sequence.

+  ///

+  UINT32                                          ResumeCount;

+  ///

+  /// Timer recorded at the end of BIOS S3 resume, just prior to handoff to the

+  /// OS waking vector. Only the most recent resume cycle's time is retained.

+  ///

+  UINT64                                          FullResume;

+  ///

+  /// Average timer value of all resume cycles logged since the last full boot

+  /// sequence, including the most recent resume.  Note that the entire log of

+  /// timer values does not need to be retained in order to calculate this average.

+  ///

+  UINT64                                          AverageResume;

+} EFI_ACPI_5_1_FPDT_S3_RESUME_RECORD;

+

+///

+/// FPDT Basic S3 Suspend Performance Record

+///

+typedef struct {

+  EFI_ACPI_5_1_FPDT_PERFORMANCE_RECORD_HEADER     Header;

+  ///

+  /// Timer value recorded at the OS write to SLP_TYP upon entry to S3.

+  /// Only the most recent suspend cycle's timer value is retained.

+  ///

+  UINT64                                          SuspendStart;

+  ///

+  /// Timer value recorded at the final firmware write to SLP_TYP (or other

+  /// mechanism) used to trigger hardware entry to S3.

+  /// Only the most recent suspend cycle's timer value is retained.

+  ///

+  UINT64                                          SuspendEnd;

+} EFI_ACPI_5_1_FPDT_S3_SUSPEND_RECORD;

+

+///

+/// Firmware Performance Record Table definition.

+///

+typedef struct {

+  EFI_ACPI_DESCRIPTION_HEADER Header;

+} EFI_ACPI_5_1_FIRMWARE_PERFORMANCE_RECORD_TABLE;

+

+///

+/// Generic Timer Description Table definition.

+///

+typedef struct {

+  EFI_ACPI_DESCRIPTION_HEADER Header;

+  UINT64                      CntControlBasePhysicalAddress;

+  UINT32                      Reserved;

+  UINT32                      SecurePL1TimerGSIV;

+  UINT32                      SecurePL1TimerFlags;

+  UINT32                      NonSecurePL1TimerGSIV;

+  UINT32                      NonSecurePL1TimerFlags;

+  UINT32                      VirtualTimerGSIV;

+  UINT32                      VirtualTimerFlags;

+  UINT32                      NonSecurePL2TimerGSIV;

+  UINT32                      NonSecurePL2TimerFlags;

+  UINT64                      CntReadBasePhysicalAddress;

+  UINT32                      PlatformTimerCount;

+  UINT32                      PlatformTimerOffset;

+} EFI_ACPI_5_1_GENERIC_TIMER_DESCRIPTION_TABLE;

+

+///

+/// GTDT Version (as defined in ACPI 5.1 spec.)

+///

+#define EFI_ACPI_5_1_GENERIC_TIMER_DESCRIPTION_TABLE_REVISION 0x02

+

+///

+/// Timer Flags.  All other bits are reserved and must be 0.

+///

+#define EFI_ACPI_5_1_GTDT_TIMER_FLAG_TIMER_INTERRUPT_MODE          BIT0

+#define EFI_ACPI_5_1_GTDT_TIMER_FLAG_TIMER_INTERRUPT_POLARITY      BIT1

+#define EFI_ACPI_5_1_GTDT_TIMER_FLAG_ALWAYS_ON_CAPABILITY          BIT2

+

+///

+/// Platform Timer Type

+///

+#define EFI_ACPI_5_1_GTDT_GT_BLOCK                       0

+#define EFI_ACPI_5_1_GTDT_SBSA_GENERIC_WATCHDOG          1

+

+///

+/// GT Block Structure

+///

+typedef struct {

+  UINT8   Type;

+  UINT16  Length;

+  UINT8   Reserved;

+  UINT64  CntCtlBase;

+  UINT32  GTBlockTimerCount;

+  UINT32  GTBlockTimerOffset;

+} EFI_ACPI_5_1_GTDT_GT_BLOCK_STRUCTURE;

+

+///

+/// GT Block Timer Structure

+///

+typedef struct {

+  UINT8   GTFrameNumber;

+  UINT8   Reserved[3];

+  UINT64  CntBaseX;

+  UINT64  CntEL0BaseX;

+  UINT32  GTxPhysicalTimerGSIV;

+  UINT32  GTxPhysicalTimerFlags;

+  UINT32  GTxVirtualTimerGSIV;

+  UINT32  GTxVirtualTimerFlags;

+  UINT32  GTxCommonFlags;

+} EFI_ACPI_5_1_GTDT_GT_BLOCK_TIMER_STRUCTURE;

+

+///

+/// GT Block Physical Timers and Virtual Timers Flags.  All other bits are reserved and must be 0.

+///

+#define EFI_ACPI_5_1_GTDT_GT_BLOCK_TIMER_FLAG_TIMER_INTERRUPT_MODE          BIT0

+#define EFI_ACPI_5_1_GTDT_GT_BLOCK_TIMER_FLAG_TIMER_INTERRUPT_POLARITY      BIT1

+

+///

+/// Common Flags Flags.  All other bits are reserved and must be 0.

+///

+#define EFI_ACPI_5_1_GTDT_GT_BLOCK_COMMON_FLAG_SECURE_TIMER              BIT0

+#define EFI_ACPI_5_1_GTDT_GT_BLOCK_COMMON_FLAG_ALWAYS_ON_CAPABILITY      BIT1

+

+///

+/// SBSA Generic Watchdog Structure

+///

+typedef struct {

+  UINT8   Type;

+  UINT16  Length;

+  UINT8   Reserved;

+  UINT64  RefreshFramePhysicalAddress;

+  UINT64  WatchdogControlFramePhysicalAddress;

+  UINT32  WatchdogTimerGSIV;

+  UINT32  WatchdogTimerFlags;

+} EFI_ACPI_5_1_GTDT_SBSA_GENERIC_WATCHDOG_STRUCTURE;

+

+///

+/// SBSA Generic Watchdog Timer Flags.  All other bits are reserved and must be 0.

+///

+#define EFI_ACPI_5_1_GTDT_SBSA_GENERIC_WATCHDOG_FLAG_TIMER_INTERRUPT_MODE          BIT0

+#define EFI_ACPI_5_1_GTDT_SBSA_GENERIC_WATCHDOG_FLAG_TIMER_INTERRUPT_POLARITY      BIT1

+#define EFI_ACPI_5_1_GTDT_SBSA_GENERIC_WATCHDOG_FLAG_SECURE_TIMER                  BIT2

+

+///

+/// Boot Error Record Table (BERT)

+///

+typedef struct {

+  EFI_ACPI_DESCRIPTION_HEADER Header;

+  UINT32                      BootErrorRegionLength;

+  UINT64                      BootErrorRegion;

+} EFI_ACPI_5_1_BOOT_ERROR_RECORD_TABLE_HEADER;

+

+///

+/// BERT Version (as defined in ACPI 5.1 spec.)

+///

+#define EFI_ACPI_5_1_BOOT_ERROR_RECORD_TABLE_REVISION 0x01

+

+///

+/// Boot Error Region Block Status Definition

+///

+typedef struct {

+  UINT32       UncorrectableErrorValid:1;

+  UINT32       CorrectableErrorValid:1;

+  UINT32       MultipleUncorrectableErrors:1;

+  UINT32       MultipleCorrectableErrors:1;

+  UINT32       ErrorDataEntryCount:10;

+  UINT32       Reserved:18;

+} EFI_ACPI_5_1_ERROR_BLOCK_STATUS;

+

+///

+/// Boot Error Region Definition

+///

+typedef struct {

+  EFI_ACPI_5_1_ERROR_BLOCK_STATUS              BlockStatus;

+  UINT32                                       RawDataOffset;

+  UINT32                                       RawDataLength;

+  UINT32                                       DataLength;

+  UINT32                                       ErrorSeverity;

+} EFI_ACPI_5_1_BOOT_ERROR_REGION_STRUCTURE;

+

+//

+// Boot Error Severity types

+//

+#define EFI_ACPI_5_1_ERROR_SEVERITY_CORRECTABLE  0x00

+#define EFI_ACPI_5_1_ERROR_SEVERITY_FATAL        0x01

+#define EFI_ACPI_5_1_ERROR_SEVERITY_CORRECTED    0x02

+#define EFI_ACPI_5_1_ERROR_SEVERITY_NONE         0x03

+

+///

+/// Generic Error Data Entry Definition

+///

+typedef struct {

+  UINT8    SectionType[16];

+  UINT32   ErrorSeverity;

+  UINT16   Revision;

+  UINT8    ValidationBits;

+  UINT8    Flags;

+  UINT32   ErrorDataLength;

+  UINT8    FruId[16];

+  UINT8    FruText[20];

+} EFI_ACPI_5_1_GENERIC_ERROR_DATA_ENTRY_STRUCTURE;

+

+///

+/// Generic Error Data Entry Version (as defined in ACPI 5.1 spec.)

+///

+#define EFI_ACPI_5_1_GENERIC_ERROR_DATA_ENTRY_REVISION  0x0201

+

+///

+/// HEST - Hardware Error Source Table

+///

+typedef struct {

+  EFI_ACPI_DESCRIPTION_HEADER Header;

+  UINT32                      ErrorSourceCount;

+} EFI_ACPI_5_1_HARDWARE_ERROR_SOURCE_TABLE_HEADER;

+

+///

+/// HEST Version (as defined in ACPI 5.1 spec.)

+///

+#define EFI_ACPI_5_1_HARDWARE_ERROR_SOURCE_TABLE_REVISION 0x01

+

+//

+// Error Source structure types.

+//

+#define EFI_ACPI_5_1_IA32_ARCHITECTURE_MACHINE_CHECK_EXCEPTION  0x00

+#define EFI_ACPI_5_1_IA32_ARCHITECTURE_CORRECTED_MACHINE_CHECK  0x01

+#define EFI_ACPI_5_1_IA32_ARCHITECTURE_NMI_ERROR                0x02

+#define EFI_ACPI_5_1_PCI_EXPRESS_ROOT_PORT_AER                  0x06

+#define EFI_ACPI_5_1_PCI_EXPRESS_DEVICE_AER                     0x07

+#define EFI_ACPI_5_1_PCI_EXPRESS_BRIDGE_AER                     0x08

+#define EFI_ACPI_5_1_GENERIC_HARDWARE_ERROR                     0x09

+

+//

+// Error Source structure flags.

+//

+#define EFI_ACPI_5_1_ERROR_SOURCE_FLAG_FIRMWARE_FIRST       (1 << 0)

+#define EFI_ACPI_5_1_ERROR_SOURCE_FLAG_GLOBAL               (1 << 1)

+

+///

+/// IA-32 Architecture Machine Check Exception Structure Definition

+///

+typedef struct {

+  UINT16  Type;

+  UINT16  SourceId;

+  UINT8   Reserved0[2];

+  UINT8   Flags;

+  UINT8   Enabled;

+  UINT32  NumberOfRecordsToPreAllocate;

+  UINT32  MaxSectionsPerRecord;

+  UINT64  GlobalCapabilityInitData;

+  UINT64  GlobalControlInitData;

+  UINT8   NumberOfHardwareBanks;

+  UINT8   Reserved1[7];

+} EFI_ACPI_5_1_IA32_ARCHITECTURE_MACHINE_CHECK_EXCEPTION_STRUCTURE;

+

+///

+/// IA-32 Architecture Machine Check Bank Structure Definition

+///

+typedef struct {

+  UINT8   BankNumber;

+  UINT8   ClearStatusOnInitialization;

+  UINT8   StatusDataFormat;

+  UINT8   Reserved0;

+  UINT32  ControlRegisterMsrAddress;

+  UINT64  ControlInitData;

+  UINT32  StatusRegisterMsrAddress;

+  UINT32  AddressRegisterMsrAddress;

+  UINT32  MiscRegisterMsrAddress;

+} EFI_ACPI_5_1_IA32_ARCHITECTURE_MACHINE_CHECK_ERROR_BANK_STRUCTURE;

+

+///

+/// IA-32 Architecture Machine Check Bank Structure MCA data format

+///

+#define EFI_ACPI_5_1_IA32_ARCHITECTURE_MACHINE_CHECK_ERROR_DATA_FORMAT_IA32      0x00

+#define EFI_ACPI_5_1_IA32_ARCHITECTURE_MACHINE_CHECK_ERROR_DATA_FORMAT_INTEL64   0x01

+#define EFI_ACPI_5_1_IA32_ARCHITECTURE_MACHINE_CHECK_ERROR_DATA_FORMAT_AMD64     0x02

+

+//

+// Hardware Error Notification types. All other values are reserved

+//

+#define EFI_ACPI_5_1_HARDWARE_ERROR_NOTIFICATION_POLLED                0x00

+#define EFI_ACPI_5_1_HARDWARE_ERROR_NOTIFICATION_EXTERNAL_INTERRUPT    0x01

+#define EFI_ACPI_5_1_HARDWARE_ERROR_NOTIFICATION_LOCAL_INTERRUPT       0x02

+#define EFI_ACPI_5_1_HARDWARE_ERROR_NOTIFICATION_SCI                   0x03

+#define EFI_ACPI_5_1_HARDWARE_ERROR_NOTIFICATION_NMI                   0x04

+

+///

+/// Hardware Error Notification Configuration Write Enable Structure Definition

+///

+typedef struct {

+  UINT16    Type:1;

+  UINT16    PollInterval:1;

+  UINT16    SwitchToPollingThresholdValue:1;

+  UINT16    SwitchToPollingThresholdWindow:1;

+  UINT16    ErrorThresholdValue:1;

+  UINT16    ErrorThresholdWindow:1;

+  UINT16    Reserved:10;

+} EFI_ACPI_5_1_HARDWARE_ERROR_NOTIFICATION_CONFIGURATION_WRITE_ENABLE_STRUCTURE;

+

+///

+/// Hardware Error Notification Structure Definition

+///

+typedef struct {

+  UINT8                                                                          Type;

+  UINT8                                                                          Length;

+  EFI_ACPI_5_1_HARDWARE_ERROR_NOTIFICATION_CONFIGURATION_WRITE_ENABLE_STRUCTURE  ConfigurationWriteEnable;

+  UINT32                                                                         PollInterval;

+  UINT32                                                                         Vector;

+  UINT32                                                                         SwitchToPollingThresholdValue;

+  UINT32                                                                         SwitchToPollingThresholdWindow;

+  UINT32                                                                         ErrorThresholdValue;

+  UINT32                                                                         ErrorThresholdWindow;

+} EFI_ACPI_5_1_HARDWARE_ERROR_NOTIFICATION_STRUCTURE;

+

+///

+/// IA-32 Architecture Corrected Machine Check Structure Definition

+///

+typedef struct {

+  UINT16                                                 Type;

+  UINT16                                                 SourceId;

+  UINT8                                                  Reserved0[2];

+  UINT8                                                  Flags;

+  UINT8                                                  Enabled;

+  UINT32                                                 NumberOfRecordsToPreAllocate;

+  UINT32                                                 MaxSectionsPerRecord;

+  EFI_ACPI_5_1_HARDWARE_ERROR_NOTIFICATION_STRUCTURE     NotificationStructure;

+  UINT8                                                  NumberOfHardwareBanks;

+  UINT8                                                  Reserved1[3];

+} EFI_ACPI_5_1_IA32_ARCHITECTURE_CORRECTED_MACHINE_CHECK_STRUCTURE;

+

+///

+/// IA-32 Architecture NMI Error Structure Definition

+///

+typedef struct {

+  UINT16  Type;

+  UINT16  SourceId;

+  UINT8   Reserved0[2];

+  UINT32  NumberOfRecordsToPreAllocate;

+  UINT32  MaxSectionsPerRecord;

+  UINT32  MaxRawDataLength;

+} EFI_ACPI_5_1_IA32_ARCHITECTURE_NMI_ERROR_STRUCTURE;

+

+///

+/// PCI Express Root Port AER Structure Definition

+///

+typedef struct {

+  UINT16  Type;

+  UINT16  SourceId;

+  UINT8   Reserved0[2];

+  UINT8   Flags;

+  UINT8   Enabled;

+  UINT32  NumberOfRecordsToPreAllocate;

+  UINT32  MaxSectionsPerRecord;

+  UINT32  Bus;

+  UINT16  Device;

+  UINT16  Function;

+  UINT16  DeviceControl;

+  UINT8   Reserved1[2];

+  UINT32  UncorrectableErrorMask;

+  UINT32  UncorrectableErrorSeverity;

+  UINT32  CorrectableErrorMask;

+  UINT32  AdvancedErrorCapabilitiesAndControl;

+  UINT32  RootErrorCommand;

+} EFI_ACPI_5_1_PCI_EXPRESS_ROOT_PORT_AER_STRUCTURE;

+

+///

+/// PCI Express Device AER Structure Definition

+///

+typedef struct {

+  UINT16  Type;

+  UINT16  SourceId;

+  UINT8   Reserved0[2];

+  UINT8   Flags;

+  UINT8   Enabled;

+  UINT32  NumberOfRecordsToPreAllocate;

+  UINT32  MaxSectionsPerRecord;

+  UINT32  Bus;

+  UINT16  Device;

+  UINT16  Function;

+  UINT16  DeviceControl;

+  UINT8   Reserved1[2];

+  UINT32  UncorrectableErrorMask;

+  UINT32  UncorrectableErrorSeverity;

+  UINT32  CorrectableErrorMask;

+  UINT32  AdvancedErrorCapabilitiesAndControl;

+} EFI_ACPI_5_1_PCI_EXPRESS_DEVICE_AER_STRUCTURE;

+

+///

+/// PCI Express Bridge AER Structure Definition

+///

+typedef struct {

+  UINT16  Type;

+  UINT16  SourceId;

+  UINT8   Reserved0[2];

+  UINT8   Flags;

+  UINT8   Enabled;

+  UINT32  NumberOfRecordsToPreAllocate;

+  UINT32  MaxSectionsPerRecord;

+  UINT32  Bus;

+  UINT16  Device;

+  UINT16  Function;

+  UINT16  DeviceControl;

+  UINT8   Reserved1[2];

+  UINT32  UncorrectableErrorMask;

+  UINT32  UncorrectableErrorSeverity;

+  UINT32  CorrectableErrorMask;

+  UINT32  AdvancedErrorCapabilitiesAndControl;

+  UINT32  SecondaryUncorrectableErrorMask;

+  UINT32  SecondaryUncorrectableErrorSeverity;

+  UINT32  SecondaryAdvancedErrorCapabilitiesAndControl;

+} EFI_ACPI_5_1_PCI_EXPRESS_BRIDGE_AER_STRUCTURE;

+

+///

+/// Generic Hardware Error Source Structure Definition

+///

+typedef struct {

+  UINT16                                                 Type;

+  UINT16                                                 SourceId;

+  UINT16                                                 RelatedSourceId;

+  UINT8                                                  Flags;

+  UINT8                                                  Enabled;

+  UINT32                                                 NumberOfRecordsToPreAllocate;

+  UINT32                                                 MaxSectionsPerRecord;

+  UINT32                                                 MaxRawDataLength;

+  EFI_ACPI_5_1_GENERIC_ADDRESS_STRUCTURE                 ErrorStatusAddress;

+  EFI_ACPI_5_1_HARDWARE_ERROR_NOTIFICATION_STRUCTURE     NotificationStructure;

+  UINT32                                                 ErrorStatusBlockLength;

+} EFI_ACPI_5_1_GENERIC_HARDWARE_ERROR_SOURCE_STRUCTURE;

+

+///

+/// Generic Error Status Definition

+///

+typedef struct {

+  EFI_ACPI_5_1_ERROR_BLOCK_STATUS              BlockStatus;

+  UINT32                                       RawDataOffset;

+  UINT32                                       RawDataLength;

+  UINT32                                       DataLength;

+  UINT32                                       ErrorSeverity;

+} EFI_ACPI_5_1_GENERIC_ERROR_STATUS_STRUCTURE;

+

+///

+/// ERST - Error Record Serialization Table

+///

+typedef struct {

+  EFI_ACPI_DESCRIPTION_HEADER Header;

+  UINT32                      SerializationHeaderSize;

+  UINT8                       Reserved0[4];

+  UINT32                      InstructionEntryCount;

+} EFI_ACPI_5_1_ERROR_RECORD_SERIALIZATION_TABLE_HEADER;

+

+///

+/// ERST Version (as defined in ACPI 5.1 spec.)

+///

+#define EFI_ACPI_5_1_ERROR_RECORD_SERIALIZATION_TABLE_REVISION 0x01

+

+///

+/// ERST Serialization Actions

+///

+#define EFI_ACPI_5_1_ERST_BEGIN_WRITE_OPERATION                    0x00

+#define EFI_ACPI_5_1_ERST_BEGIN_READ_OPERATION                     0x01

+#define EFI_ACPI_5_1_ERST_BEGIN_CLEAR_OPERATION                    0x02

+#define EFI_ACPI_5_1_ERST_END_OPERATION                            0x03

+#define EFI_ACPI_5_1_ERST_SET_RECORD_OFFSET                        0x04

+#define EFI_ACPI_5_1_ERST_EXECUTE_OPERATION                        0x05

+#define EFI_ACPI_5_1_ERST_CHECK_BUSY_STATUS                        0x06

+#define EFI_ACPI_5_1_ERST_GET_COMMAND_STATUS                       0x07

+#define EFI_ACPI_5_1_ERST_GET_RECORD_IDENTIFIER                    0x08

+#define EFI_ACPI_5_1_ERST_SET_RECORD_IDENTIFIER                    0x09

+#define EFI_ACPI_5_1_ERST_GET_RECORD_COUNT                         0x0A

+#define EFI_ACPI_5_1_ERST_BEGIN_DUMMY_WRITE_OPERATION              0x0B

+#define EFI_ACPI_5_1_ERST_GET_ERROR_LOG_ADDRESS_RANGE              0x0D

+#define EFI_ACPI_5_1_ERST_GET_ERROR_LOG_ADDRESS_RANGE_LENGTH       0x0E

+#define EFI_ACPI_5_1_ERST_GET_ERROR_LOG_ADDRESS_RANGE_ATTRIBUTES   0x0F

+

+///

+/// ERST Action Command Status

+///

+#define EFI_ACPI_5_1_ERST_STATUS_SUCCESS                           0x00

+#define EFI_ACPI_5_1_ERST_STATUS_NOT_ENOUGH_SPACE                  0x01

+#define EFI_ACPI_5_1_ERST_STATUS_HARDWARE_NOT_AVAILABLE            0x02

+#define EFI_ACPI_5_1_ERST_STATUS_FAILED                            0x03

+#define EFI_ACPI_5_1_ERST_STATUS_RECORD_STORE_EMPTY                0x04

+#define EFI_ACPI_5_1_ERST_STATUS_RECORD_NOT_FOUND                  0x05

+

+///

+/// ERST Serialization Instructions

+///

+#define EFI_ACPI_5_1_ERST_READ_REGISTER                            0x00

+#define EFI_ACPI_5_1_ERST_READ_REGISTER_VALUE                      0x01

+#define EFI_ACPI_5_1_ERST_WRITE_REGISTER                           0x02

+#define EFI_ACPI_5_1_ERST_WRITE_REGISTER_VALUE                     0x03

+#define EFI_ACPI_5_1_ERST_NOOP                                     0x04

+#define EFI_ACPI_5_1_ERST_LOAD_VAR1                                0x05

+#define EFI_ACPI_5_1_ERST_LOAD_VAR2                                0x06

+#define EFI_ACPI_5_1_ERST_STORE_VAR1                               0x07

+#define EFI_ACPI_5_1_ERST_ADD                                      0x08

+#define EFI_ACPI_5_1_ERST_SUBTRACT                                 0x09

+#define EFI_ACPI_5_1_ERST_ADD_VALUE                                0x0A

+#define EFI_ACPI_5_1_ERST_SUBTRACT_VALUE                           0x0B

+#define EFI_ACPI_5_1_ERST_STALL                                    0x0C

+#define EFI_ACPI_5_1_ERST_STALL_WHILE_TRUE                         0x0D

+#define EFI_ACPI_5_1_ERST_SKIP_NEXT_INSTRUCTION_IF_TRUE            0x0E

+#define EFI_ACPI_5_1_ERST_GOTO                                     0x0F

+#define EFI_ACPI_5_1_ERST_SET_SRC_ADDRESS_BASE                     0x10

+#define EFI_ACPI_5_1_ERST_SET_DST_ADDRESS_BASE                     0x11

+#define EFI_ACPI_5_1_ERST_MOVE_DATA                                0x12

+

+///

+/// ERST Instruction Flags

+///

+#define EFI_ACPI_5_1_ERST_PRESERVE_REGISTER                        0x01

+

+///

+/// ERST Serialization Instruction Entry

+///

+typedef struct {

+  UINT8                                    SerializationAction;

+  UINT8                                    Instruction;

+  UINT8                                    Flags;

+  UINT8                                    Reserved0;

+  EFI_ACPI_5_1_GENERIC_ADDRESS_STRUCTURE   RegisterRegion;

+  UINT64                                   Value;

+  UINT64                                   Mask;

+} EFI_ACPI_5_1_ERST_SERIALIZATION_INSTRUCTION_ENTRY;

+

+///

+/// EINJ - Error Injection Table

+///

+typedef struct {

+  EFI_ACPI_DESCRIPTION_HEADER Header;

+  UINT32                      InjectionHeaderSize;

+  UINT8                       InjectionFlags;

+  UINT8                       Reserved0[3];

+  UINT32                      InjectionEntryCount;

+} EFI_ACPI_5_1_ERROR_INJECTION_TABLE_HEADER;

+

+///

+/// EINJ Version (as defined in ACPI 5.1 spec.)

+///

+#define EFI_ACPI_5_1_ERROR_INJECTION_TABLE_REVISION 0x01

+

+///

+/// EINJ Error Injection Actions

+///

+#define EFI_ACPI_5_1_EINJ_BEGIN_INJECTION_OPERATION                0x00

+#define EFI_ACPI_5_1_EINJ_GET_TRIGGER_ERROR_ACTION_TABLE           0x01

+#define EFI_ACPI_5_1_EINJ_SET_ERROR_TYPE                           0x02

+#define EFI_ACPI_5_1_EINJ_GET_ERROR_TYPE                           0x03

+#define EFI_ACPI_5_1_EINJ_END_OPERATION                            0x04

+#define EFI_ACPI_5_1_EINJ_EXECUTE_OPERATION                        0x05

+#define EFI_ACPI_5_1_EINJ_CHECK_BUSY_STATUS                        0x06

+#define EFI_ACPI_5_1_EINJ_GET_COMMAND_STATUS                       0x07

+#define EFI_ACPI_5_1_EINJ_TRIGGER_ERROR                            0xFF

+

+///

+/// EINJ Action Command Status

+///

+#define EFI_ACPI_5_1_EINJ_STATUS_SUCCESS                           0x00

+#define EFI_ACPI_5_1_EINJ_STATUS_UNKNOWN_FAILURE                   0x01

+#define EFI_ACPI_5_1_EINJ_STATUS_INVALID_ACCESS                    0x02

+

+///

+/// EINJ Error Type Definition

+///

+#define EFI_ACPI_5_1_EINJ_ERROR_PROCESSOR_CORRECTABLE                 (1 << 0)

+#define EFI_ACPI_5_1_EINJ_ERROR_PROCESSOR_UNCORRECTABLE_NONFATAL      (1 << 1)

+#define EFI_ACPI_5_1_EINJ_ERROR_PROCESSOR_UNCORRECTABLE_FATAL         (1 << 2)

+#define EFI_ACPI_5_1_EINJ_ERROR_MEMORY_CORRECTABLE                    (1 << 3)

+#define EFI_ACPI_5_1_EINJ_ERROR_MEMORY_UNCORRECTABLE_NONFATAL         (1 << 4)

+#define EFI_ACPI_5_1_EINJ_ERROR_MEMORY_UNCORRECTABLE_FATAL            (1 << 5)

+#define EFI_ACPI_5_1_EINJ_ERROR_PCI_EXPRESS_CORRECTABLE               (1 << 6)

+#define EFI_ACPI_5_1_EINJ_ERROR_PCI_EXPRESS_UNCORRECTABLE_NONFATAL    (1 << 7)

+#define EFI_ACPI_5_1_EINJ_ERROR_PCI_EXPRESS_UNCORRECTABLE_FATAL       (1 << 8)

+#define EFI_ACPI_5_1_EINJ_ERROR_PLATFORM_CORRECTABLE                  (1 << 9)

+#define EFI_ACPI_5_1_EINJ_ERROR_PLATFORM_UNCORRECTABLE_NONFATAL       (1 << 10)

+#define EFI_ACPI_5_1_EINJ_ERROR_PLATFORM_UNCORRECTABLE_FATAL          (1 << 11)

+

+///

+/// EINJ Injection Instructions

+///

+#define EFI_ACPI_5_1_EINJ_READ_REGISTER                            0x00

+#define EFI_ACPI_5_1_EINJ_READ_REGISTER_VALUE                      0x01

+#define EFI_ACPI_5_1_EINJ_WRITE_REGISTER                           0x02

+#define EFI_ACPI_5_1_EINJ_WRITE_REGISTER_VALUE                     0x03

+#define EFI_ACPI_5_1_EINJ_NOOP                                     0x04

+

+///

+/// EINJ Instruction Flags

+///

+#define EFI_ACPI_5_1_EINJ_PRESERVE_REGISTER                        0x01

+

+///

+/// EINJ Injection Instruction Entry

+///

+typedef struct {

+  UINT8                                    InjectionAction;

+  UINT8                                    Instruction;

+  UINT8                                    Flags;

+  UINT8                                    Reserved0;

+  EFI_ACPI_5_1_GENERIC_ADDRESS_STRUCTURE   RegisterRegion;

+  UINT64                                   Value;

+  UINT64                                   Mask;

+} EFI_ACPI_5_1_EINJ_INJECTION_INSTRUCTION_ENTRY;

+

+///

+/// EINJ Trigger Action Table

+///

+typedef struct {

+  UINT32  HeaderSize;

+  UINT32  Revision;

+  UINT32  TableSize;

+  UINT32  EntryCount;

+} EFI_ACPI_5_1_EINJ_TRIGGER_ACTION_TABLE;

+

+///

+/// Platform Communications Channel Table (PCCT)

+///

+typedef struct {

+  EFI_ACPI_DESCRIPTION_HEADER Header;

+  UINT32                      Flags;

+  UINT64                      Reserved;

+} EFI_ACPI_5_1_PLATFORM_COMMUNICATION_CHANNEL_TABLE_HEADER;

+

+///

+/// PCCT Version (as defined in ACPI 5.1 spec.)

+///

+#define EFI_ACPI_5_1_PLATFORM_COMMUNICATION_CHANNEL_TABLE_REVISION 0x01

+

+///

+/// PCCT Global Flags

+///

+#define EFI_ACPI_5_1_PCCT_FLAGS_SCI_DOORBELL                      BIT0

+

+//

+// PCCT Subspace type

+//

+#define EFI_ACPI_5_1_PCCT_SUBSPACE_TYPE_GENERIC  0x00

+

+///

+/// PCC Subspace Structure Header

+///

+typedef struct {

+  UINT8        Type;

+  UINT8        Length;

+} EFI_ACPI_5_1_PCCT_SUBSPACE_HEADER;

+

+///

+/// Generic Communications Subspace Structure

+///

+typedef struct {

+  UINT8                                    Type;

+  UINT8                                    Length;

+  UINT8                                    Reserved[6];

+  UINT64                                   BaseAddress;

+  UINT64                                   AddressLength;

+  EFI_ACPI_5_1_GENERIC_ADDRESS_STRUCTURE   DoorbellRegister;

+  UINT64                                   DoorbellPreserve;

+  UINT64                                   DoorbellWrite;

+  UINT32                                   NominalLatency;

+  UINT32                                   MaximumPeriodicAccessRate;

+  UINT16                                   MinimumRequestTurnaroundTime;

+} EFI_ACPI_5_1_PCCT_SUBSPACE_GENERIC;

+

+///

+/// Generic Communications Channel Shared Memory Region

+///

+

+typedef struct {

+  UINT8                                    Command;

+  UINT8                                    Reserved:7;

+  UINT8                                    GenerateSci:1;

+} EFI_ACPI_5_1_PCCT_GENERIC_SHARED_MEMORY_REGION_COMMAND;

+

+typedef struct {

+  UINT8                                    CommandComplete:1;

+  UINT8                                    SciDoorbell:1;

+  UINT8                                    Error:1;

+  UINT8                                    PlatformNotification:1;

+  UINT8                                    Reserved:4;

+  UINT8                                    Reserved1;

+} EFI_ACPI_5_1_PCCT_GENERIC_SHARED_MEMORY_REGION_STATUS;

+

+typedef struct {

+  UINT32                                                    Signature;

+  EFI_ACPI_5_1_PCCT_GENERIC_SHARED_MEMORY_REGION_COMMAND    Command;

+  EFI_ACPI_5_1_PCCT_GENERIC_SHARED_MEMORY_REGION_STATUS     Status;

+} EFI_ACPI_5_1_PCCT_GENERIC_SHARED_MEMORY_REGION_HEADER;

+

+//

+// Known table signatures

+//

+

+///

+/// "RSD PTR " Root System Description Pointer

+///

+#define EFI_ACPI_5_1_ROOT_SYSTEM_DESCRIPTION_POINTER_SIGNATURE  SIGNATURE_64('R', 'S', 'D', ' ', 'P', 'T', 'R', ' ')

+

+///

+/// "APIC" Multiple APIC Description Table

+///

+#define EFI_ACPI_5_1_MULTIPLE_APIC_DESCRIPTION_TABLE_SIGNATURE  SIGNATURE_32('A', 'P', 'I', 'C')

+

+///

+/// "BERT" Boot Error Record Table

+///

+#define EFI_ACPI_5_1_BOOT_ERROR_RECORD_TABLE_SIGNATURE  SIGNATURE_32('B', 'E', 'R', 'T')

+

+///

+/// "BGRT" Boot Graphics Resource Table

+///

+#define EFI_ACPI_5_1_BOOT_GRAPHICS_RESOURCE_TABLE_SIGNATURE  SIGNATURE_32('B', 'G', 'R', 'T')

+

+///

+/// "CPEP" Corrected Platform Error Polling Table

+///

+#define EFI_ACPI_5_1_CORRECTED_PLATFORM_ERROR_POLLING_TABLE_SIGNATURE  SIGNATURE_32('C', 'P', 'E', 'P')

+

+///

+/// "DSDT" Differentiated System Description Table

+///

+#define EFI_ACPI_5_1_DIFFERENTIATED_SYSTEM_DESCRIPTION_TABLE_SIGNATURE  SIGNATURE_32('D', 'S', 'D', 'T')

+

+///

+/// "ECDT" Embedded Controller Boot Resources Table

+///

+#define EFI_ACPI_5_1_EMBEDDED_CONTROLLER_BOOT_RESOURCES_TABLE_SIGNATURE  SIGNATURE_32('E', 'C', 'D', 'T')

+

+///

+/// "EINJ" Error Injection Table

+///

+#define EFI_ACPI_5_1_ERROR_INJECTION_TABLE_SIGNATURE  SIGNATURE_32('E', 'I', 'N', 'J')

+

+///

+/// "ERST" Error Record Serialization Table

+///

+#define EFI_ACPI_5_1_ERROR_RECORD_SERIALIZATION_TABLE_SIGNATURE  SIGNATURE_32('E', 'R', 'S', 'T')

+

+///

+/// "FACP" Fixed ACPI Description Table

+///

+#define EFI_ACPI_5_1_FIXED_ACPI_DESCRIPTION_TABLE_SIGNATURE  SIGNATURE_32('F', 'A', 'C', 'P')

+

+///

+/// "FACS" Firmware ACPI Control Structure

+///

+#define EFI_ACPI_5_1_FIRMWARE_ACPI_CONTROL_STRUCTURE_SIGNATURE  SIGNATURE_32('F', 'A', 'C', 'S')

+

+///

+/// "FPDT" Firmware Performance Data Table

+///

+#define EFI_ACPI_5_1_FIRMWARE_PERFORMANCE_DATA_TABLE_SIGNATURE  SIGNATURE_32('F', 'P', 'D', 'T')

+

+///

+/// "GTDT" Generic Timer Description Table

+///

+#define EFI_ACPI_5_1_GENERIC_TIMER_DESCRIPTION_TABLE_SIGNATURE  SIGNATURE_32('G', 'T', 'D', 'T')

+

+///

+/// "HEST" Hardware Error Source Table

+///

+#define EFI_ACPI_5_1_HARDWARE_ERROR_SOURCE_TABLE_SIGNATURE  SIGNATURE_32('H', 'E', 'S', 'T')

+

+///

+/// "MPST" Memory Power State Table

+///

+#define EFI_ACPI_5_1_MEMORY_POWER_STATE_TABLE_SIGNATURE  SIGNATURE_32('M', 'P', 'S', 'T')

+

+///

+/// "MSCT" Maximum System Characteristics Table

+///

+#define EFI_ACPI_5_1_MAXIMUM_SYSTEM_CHARACTERISTICS_TABLE_SIGNATURE  SIGNATURE_32('M', 'S', 'C', 'T')

+

+///

+/// "PMTT" Platform Memory Topology Table

+///

+#define EFI_ACPI_5_1_PLATFORM_MEMORY_TOPOLOGY_TABLE_SIGNATURE  SIGNATURE_32('P', 'M', 'T', 'T')

+

+///

+/// "PSDT" Persistent System Description Table

+///

+#define EFI_ACPI_5_1_PERSISTENT_SYSTEM_DESCRIPTION_TABLE_SIGNATURE  SIGNATURE_32('P', 'S', 'D', 'T')

+

+///

+/// "RASF" ACPI RAS Feature Table

+///

+#define EFI_ACPI_5_1_ACPI_RAS_FEATURE_TABLE_SIGNATURE  SIGNATURE_32('R', 'A', 'S', 'F')

+

+///

+/// "RSDT" Root System Description Table

+///

+#define EFI_ACPI_5_1_ROOT_SYSTEM_DESCRIPTION_TABLE_SIGNATURE  SIGNATURE_32('R', 'S', 'D', 'T')

+

+///

+/// "SBST" Smart Battery Specification Table

+///

+#define EFI_ACPI_5_1_SMART_BATTERY_SPECIFICATION_TABLE_SIGNATURE  SIGNATURE_32('S', 'B', 'S', 'T')

+

+///

+/// "SLIT" System Locality Information Table

+///

+#define EFI_ACPI_5_1_SYSTEM_LOCALITY_INFORMATION_TABLE_SIGNATURE  SIGNATURE_32('S', 'L', 'I', 'T')

+

+///

+/// "SRAT" System Resource Affinity Table

+///

+#define EFI_ACPI_5_1_SYSTEM_RESOURCE_AFFINITY_TABLE_SIGNATURE  SIGNATURE_32('S', 'R', 'A', 'T')

+

+///

+/// "SSDT" Secondary System Description Table

+///

+#define EFI_ACPI_5_1_SECONDARY_SYSTEM_DESCRIPTION_TABLE_SIGNATURE  SIGNATURE_32('S', 'S', 'D', 'T')

+

+///

+/// "XSDT" Extended System Description Table

+///

+#define EFI_ACPI_5_1_EXTENDED_SYSTEM_DESCRIPTION_TABLE_SIGNATURE  SIGNATURE_32('X', 'S', 'D', 'T')

+

+///

+/// "BOOT" MS Simple Boot Spec

+///

+#define EFI_ACPI_5_1_SIMPLE_BOOT_FLAG_TABLE_SIGNATURE  SIGNATURE_32('B', 'O', 'O', 'T')

+

+///

+/// "CSRT" MS Core System Resource Table

+///

+#define EFI_ACPI_5_1_CORE_SYSTEM_RESOURCE_TABLE_SIGNATURE  SIGNATURE_32('C', 'S', 'R', 'T')

+

+///

+/// "DBG2" MS Debug Port 2 Spec

+///

+#define EFI_ACPI_5_1_DEBUG_PORT_2_TABLE_SIGNATURE  SIGNATURE_32('D', 'B', 'G', '2')

+

+///

+/// "DBGP" MS Debug Port Spec

+///

+#define EFI_ACPI_5_1_DEBUG_PORT_TABLE_SIGNATURE  SIGNATURE_32('D', 'B', 'G', 'P')

+

+///

+/// "DMAR" DMA Remapping Table

+///

+#define EFI_ACPI_5_1_DMA_REMAPPING_TABLE_SIGNATURE  SIGNATURE_32('D', 'M', 'A', 'R')

+

+///

+/// "DRTM" Dynamic Root of Trust for Measurement Table

+///

+#define EFI_ACPI_5_1_DYNAMIC_ROOT_OF_TRUST_FOR_MEASUREMENT_TABLE_SIGNATURE  SIGNATURE_32('D', 'R', 'T', 'M')

+

+///

+/// "ETDT" Event Timer Description Table

+///

+#define EFI_ACPI_5_1_EVENT_TIMER_DESCRIPTION_TABLE_SIGNATURE  SIGNATURE_32('E', 'T', 'D', 'T')

+

+///

+/// "HPET" IA-PC High Precision Event Timer Table

+///

+#define EFI_ACPI_5_1_HIGH_PRECISION_EVENT_TIMER_TABLE_SIGNATURE  SIGNATURE_32('H', 'P', 'E', 'T')

+

+///

+/// "iBFT" iSCSI Boot Firmware Table

+///

+#define EFI_ACPI_5_1_ISCSI_BOOT_FIRMWARE_TABLE_SIGNATURE  SIGNATURE_32('i', 'B', 'F', 'T')

+

+///

+/// "IVRS" I/O Virtualization Reporting Structure

+///

+#define EFI_ACPI_5_1_IO_VIRTUALIZATION_REPORTING_STRUCTURE_SIGNATURE  SIGNATURE_32('I', 'V', 'R', 'S')

+

+///

+/// "LPIT" Low Power Idle Table

+///

+#define EFI_ACPI_5_1_IO_LOW_POWER_IDLE_TABLE_STRUCTURE_SIGNATURE  SIGNATURE_32('L', 'P', 'I', 'T')

+

+///

+/// "MCFG" PCI Express Memory Mapped Configuration Space Base Address Description Table

+///

+#define EFI_ACPI_5_1_PCI_EXPRESS_MEMORY_MAPPED_CONFIGURATION_SPACE_BASE_ADDRESS_DESCRIPTION_TABLE_SIGNATURE  SIGNATURE_32('M', 'C', 'F', 'G')

+

+///

+/// "MCHI" Management Controller Host Interface Table

+///

+#define EFI_ACPI_5_1_MANAGEMENT_CONTROLLER_HOST_INTERFACE_TABLE_SIGNATURE  SIGNATURE_32('M', 'C', 'H', 'I')

+

+///

+/// "MSDM" MS Data Management Table

+///

+#define EFI_ACPI_5_1_DATA_MANAGEMENT_TABLE_SIGNATURE  SIGNATURE_32('M', 'S', 'D', 'M')

+

+///

+/// "PCCT" Platform Communications Channel Table

+///

+#define EFI_ACPI_5_1_PLATFORM_COMMUNICATIONS_CHANNEL_TABLE_SIGNATURE  SIGNATURE_32('P', 'C', 'C', 'T')

+

+///

+/// "SLIC" MS Software Licensing Table Specification

+///

+#define EFI_ACPI_5_1_SOFTWARE_LICENSING_TABLE_SIGNATURE  SIGNATURE_32('S', 'L', 'I', 'C')

+

+///

+/// "SPCR" Serial Port Console Redirection Table

+///

+#define EFI_ACPI_5_1_SERIAL_PORT_CONSOLE_REDIRECTION_TABLE_SIGNATURE  SIGNATURE_32('S', 'P', 'C', 'R')

+

+///

+/// "SPMI" Server Platform Management Interface Table

+///

+#define EFI_ACPI_5_1_SERVER_PLATFORM_MANAGEMENT_INTERFACE_TABLE_SIGNATURE  SIGNATURE_32('S', 'P', 'M', 'I')

+

+///

+/// "TCPA" Trusted Computing Platform Alliance Capabilities Table

+///

+#define EFI_ACPI_5_1_TRUSTED_COMPUTING_PLATFORM_ALLIANCE_CAPABILITIES_TABLE_SIGNATURE  SIGNATURE_32('T', 'C', 'P', 'A')

+

+///

+/// "TPM2" Trusted Computing Platform 1 Table

+///

+#define EFI_ACPI_5_1_TRUSTED_COMPUTING_PLATFORM_2_TABLE_SIGNATURE  SIGNATURE_32('T', 'P', 'M', '2')

+

+///

+/// "UEFI" UEFI ACPI Data Table

+///

+#define EFI_ACPI_5_1_UEFI_ACPI_DATA_TABLE_SIGNATURE  SIGNATURE_32('U', 'E', 'F', 'I')

+

+///

+/// "WAET" Windows ACPI Emulated Devices Table

+///

+#define EFI_ACPI_5_1_WINDOWS_ACPI_EMULATED_DEVICES_TABLE_SIGNATURE  SIGNATURE_32('W', 'A', 'E', 'T')

+

+///

+/// "WDAT" Watchdog Action Table

+///

+#define EFI_ACPI_5_1_WATCHDOG_ACTION_TABLE_SIGNATURE  SIGNATURE_32('W', 'D', 'A', 'T')

+

+///

+/// "WDRT" Watchdog Resource Table

+///

+#define EFI_ACPI_5_1_WATCHDOG_RESOURCE_TABLE_SIGNATURE  SIGNATURE_32('W', 'D', 'R', 'T')

+

+///

+/// "WPBT" MS Platform Binary Table

+///

+#define EFI_ACPI_5_1_PLATFORM_BINARY_TABLE_SIGNATURE  SIGNATURE_32('W', 'P', 'B', 'T')

+

+#pragma pack()

+

+#endif

diff --git a/debugging_demo/memtest86+/efi/Include/IndustryStandard/Acpi60.h b/debugging_demo/memtest86+/efi/Include/IndustryStandard/Acpi60.h
new file mode 100644
index 0000000..5dcd73b
--- /dev/null
+++ b/debugging_demo/memtest86+/efi/Include/IndustryStandard/Acpi60.h
@@ -0,0 +1,2392 @@
+/** @file

+  ACPI 6.0 definitions from the ACPI Specification Revision 6.0 Errata A January, 2016.

+

+  Copyright (c) 2015 - 2018, Intel Corporation. All rights reserved.<BR>

+  (C) Copyright 2015-2016 Hewlett Packard Enterprise Development LP<BR>

+  Copyright (c) 2020, ARM Ltd. All rights reserved.<BR>

+  SPDX-License-Identifier: BSD-2-Clause-Patent

+**/

+

+#ifndef _ACPI_6_0_H_

+#define _ACPI_6_0_H_

+

+#include <IndustryStandard/Acpi51.h>

+

+//

+// Ensure proper structure formats

+//

+#pragma pack(1)

+

+///

+/// ACPI 6.0 Generic Address Space definition

+///

+typedef struct {

+  UINT8   AddressSpaceId;

+  UINT8   RegisterBitWidth;

+  UINT8   RegisterBitOffset;

+  UINT8   AccessSize;

+  UINT64  Address;

+} EFI_ACPI_6_0_GENERIC_ADDRESS_STRUCTURE;

+

+//

+// Generic Address Space Address IDs

+//

+#define EFI_ACPI_6_0_SYSTEM_MEMORY              0

+#define EFI_ACPI_6_0_SYSTEM_IO                  1

+#define EFI_ACPI_6_0_PCI_CONFIGURATION_SPACE    2

+#define EFI_ACPI_6_0_EMBEDDED_CONTROLLER        3

+#define EFI_ACPI_6_0_SMBUS                      4

+#define EFI_ACPI_6_0_PLATFORM_COMMUNICATION_CHANNEL  0x0A

+#define EFI_ACPI_6_0_FUNCTIONAL_FIXED_HARDWARE       0x7F

+

+//

+// Generic Address Space Access Sizes

+//

+#define EFI_ACPI_6_0_UNDEFINED  0

+#define EFI_ACPI_6_0_BYTE       1

+#define EFI_ACPI_6_0_WORD       2

+#define EFI_ACPI_6_0_DWORD      3

+#define EFI_ACPI_6_0_QWORD      4

+

+//

+// ACPI 6.0 table structures

+//

+

+///

+/// Root System Description Pointer Structure

+///

+typedef struct {

+  UINT64  Signature;

+  UINT8   Checksum;

+  UINT8   OemId[6];

+  UINT8   Revision;

+  UINT32  RsdtAddress;

+  UINT32  Length;

+  UINT64  XsdtAddress;

+  UINT8   ExtendedChecksum;

+  UINT8   Reserved[3];

+} EFI_ACPI_6_0_ROOT_SYSTEM_DESCRIPTION_POINTER;

+

+///

+/// RSD_PTR Revision (as defined in ACPI 6.0 spec.)

+///

+#define EFI_ACPI_6_0_ROOT_SYSTEM_DESCRIPTION_POINTER_REVISION 0x02  ///< ACPISpec (Revision 6.0) says current value is 2

+

+///

+/// Common table header, this prefaces all ACPI tables, including FACS, but

+/// excluding the RSD PTR structure

+///

+typedef struct {

+  UINT32  Signature;

+  UINT32  Length;

+} EFI_ACPI_6_0_COMMON_HEADER;

+

+//

+// Root System Description Table

+// No definition needed as it is a common description table header, the same with

+// EFI_ACPI_DESCRIPTION_HEADER, followed by a variable number of UINT32 table pointers.

+//

+

+///

+/// RSDT Revision (as defined in ACPI 6.0 spec.)

+///

+#define EFI_ACPI_6_0_ROOT_SYSTEM_DESCRIPTION_TABLE_REVISION 0x01

+

+//

+// Extended System Description Table

+// No definition needed as it is a common description table header, the same with

+// EFI_ACPI_DESCRIPTION_HEADER, followed by a variable number of UINT64 table pointers.

+//

+

+///

+/// XSDT Revision (as defined in ACPI 6.0 spec.)

+///

+#define EFI_ACPI_6_0_EXTENDED_SYSTEM_DESCRIPTION_TABLE_REVISION 0x01

+

+///

+/// Fixed ACPI Description Table Structure (FADT)

+///

+typedef struct {

+  EFI_ACPI_DESCRIPTION_HEADER             Header;

+  UINT32                                  FirmwareCtrl;

+  UINT32                                  Dsdt;

+  UINT8                                   Reserved0;

+  UINT8                                   PreferredPmProfile;

+  UINT16                                  SciInt;

+  UINT32                                  SmiCmd;

+  UINT8                                   AcpiEnable;

+  UINT8                                   AcpiDisable;

+  UINT8                                   S4BiosReq;

+  UINT8                                   PstateCnt;

+  UINT32                                  Pm1aEvtBlk;

+  UINT32                                  Pm1bEvtBlk;

+  UINT32                                  Pm1aCntBlk;

+  UINT32                                  Pm1bCntBlk;

+  UINT32                                  Pm2CntBlk;

+  UINT32                                  PmTmrBlk;

+  UINT32                                  Gpe0Blk;

+  UINT32                                  Gpe1Blk;

+  UINT8                                   Pm1EvtLen;

+  UINT8                                   Pm1CntLen;

+  UINT8                                   Pm2CntLen;

+  UINT8                                   PmTmrLen;

+  UINT8                                   Gpe0BlkLen;

+  UINT8                                   Gpe1BlkLen;

+  UINT8                                   Gpe1Base;

+  UINT8                                   CstCnt;

+  UINT16                                  PLvl2Lat;

+  UINT16                                  PLvl3Lat;

+  UINT16                                  FlushSize;

+  UINT16                                  FlushStride;

+  UINT8                                   DutyOffset;

+  UINT8                                   DutyWidth;

+  UINT8                                   DayAlrm;

+  UINT8                                   MonAlrm;

+  UINT8                                   Century;

+  UINT16                                  IaPcBootArch;

+  UINT8                                   Reserved1;

+  UINT32                                  Flags;

+  EFI_ACPI_6_0_GENERIC_ADDRESS_STRUCTURE  ResetReg;

+  UINT8                                   ResetValue;

+  UINT16                                  ArmBootArch;

+  UINT8                                   MinorVersion;

+  UINT64                                  XFirmwareCtrl;

+  UINT64                                  XDsdt;

+  EFI_ACPI_6_0_GENERIC_ADDRESS_STRUCTURE  XPm1aEvtBlk;

+  EFI_ACPI_6_0_GENERIC_ADDRESS_STRUCTURE  XPm1bEvtBlk;

+  EFI_ACPI_6_0_GENERIC_ADDRESS_STRUCTURE  XPm1aCntBlk;

+  EFI_ACPI_6_0_GENERIC_ADDRESS_STRUCTURE  XPm1bCntBlk;

+  EFI_ACPI_6_0_GENERIC_ADDRESS_STRUCTURE  XPm2CntBlk;

+  EFI_ACPI_6_0_GENERIC_ADDRESS_STRUCTURE  XPmTmrBlk;

+  EFI_ACPI_6_0_GENERIC_ADDRESS_STRUCTURE  XGpe0Blk;

+  EFI_ACPI_6_0_GENERIC_ADDRESS_STRUCTURE  XGpe1Blk;

+  EFI_ACPI_6_0_GENERIC_ADDRESS_STRUCTURE  SleepControlReg;

+  EFI_ACPI_6_0_GENERIC_ADDRESS_STRUCTURE  SleepStatusReg;

+  UINT64                                  HypervisorVendorIdentity;

+} EFI_ACPI_6_0_FIXED_ACPI_DESCRIPTION_TABLE;

+

+///

+/// FADT Version (as defined in ACPI 6.0 spec.)

+///

+#define EFI_ACPI_6_0_FIXED_ACPI_DESCRIPTION_TABLE_REVISION  0x06

+#define EFI_ACPI_6_0_FIXED_ACPI_DESCRIPTION_TABLE_MINOR_REVISION  0x00

+

+//

+// Fixed ACPI Description Table Preferred Power Management Profile

+//

+#define EFI_ACPI_6_0_PM_PROFILE_UNSPECIFIED         0

+#define EFI_ACPI_6_0_PM_PROFILE_DESKTOP             1

+#define EFI_ACPI_6_0_PM_PROFILE_MOBILE              2

+#define EFI_ACPI_6_0_PM_PROFILE_WORKSTATION         3

+#define EFI_ACPI_6_0_PM_PROFILE_ENTERPRISE_SERVER   4

+#define EFI_ACPI_6_0_PM_PROFILE_SOHO_SERVER         5

+#define EFI_ACPI_6_0_PM_PROFILE_APPLIANCE_PC        6

+#define EFI_ACPI_6_0_PM_PROFILE_PERFORMANCE_SERVER  7

+#define EFI_ACPI_6_0_PM_PROFILE_TABLET              8

+

+//

+// Fixed ACPI Description Table Boot Architecture Flags

+// All other bits are reserved and must be set to 0.

+//

+#define EFI_ACPI_6_0_LEGACY_DEVICES              BIT0

+#define EFI_ACPI_6_0_8042                        BIT1

+#define EFI_ACPI_6_0_VGA_NOT_PRESENT             BIT2

+#define EFI_ACPI_6_0_MSI_NOT_SUPPORTED           BIT3

+#define EFI_ACPI_6_0_PCIE_ASPM_CONTROLS          BIT4

+#define EFI_ACPI_6_0_CMOS_RTC_NOT_PRESENT        BIT5

+

+//

+// Fixed ACPI Description Table Arm Boot Architecture Flags

+// All other bits are reserved and must be set to 0.

+//

+#define EFI_ACPI_6_0_ARM_PSCI_COMPLIANT              BIT0

+#define EFI_ACPI_6_0_ARM_PSCI_USE_HVC                BIT1

+

+//

+// Fixed ACPI Description Table Fixed Feature Flags

+// All other bits are reserved and must be set to 0.

+//

+#define EFI_ACPI_6_0_WBINVD                                 BIT0

+#define EFI_ACPI_6_0_WBINVD_FLUSH                           BIT1

+#define EFI_ACPI_6_0_PROC_C1                                BIT2

+#define EFI_ACPI_6_0_P_LVL2_UP                              BIT3

+#define EFI_ACPI_6_0_PWR_BUTTON                             BIT4

+#define EFI_ACPI_6_0_SLP_BUTTON                             BIT5

+#define EFI_ACPI_6_0_FIX_RTC                                BIT6

+#define EFI_ACPI_6_0_RTC_S4                                 BIT7

+#define EFI_ACPI_6_0_TMR_VAL_EXT                            BIT8

+#define EFI_ACPI_6_0_DCK_CAP                                BIT9

+#define EFI_ACPI_6_0_RESET_REG_SUP                          BIT10

+#define EFI_ACPI_6_0_SEALED_CASE                            BIT11

+#define EFI_ACPI_6_0_HEADLESS                               BIT12

+#define EFI_ACPI_6_0_CPU_SW_SLP                             BIT13

+#define EFI_ACPI_6_0_PCI_EXP_WAK                            BIT14

+#define EFI_ACPI_6_0_USE_PLATFORM_CLOCK                     BIT15

+#define EFI_ACPI_6_0_S4_RTC_STS_VALID                       BIT16

+#define EFI_ACPI_6_0_REMOTE_POWER_ON_CAPABLE                BIT17

+#define EFI_ACPI_6_0_FORCE_APIC_CLUSTER_MODEL               BIT18

+#define EFI_ACPI_6_0_FORCE_APIC_PHYSICAL_DESTINATION_MODE   BIT19

+#define EFI_ACPI_6_0_HW_REDUCED_ACPI                        BIT20

+#define EFI_ACPI_6_0_LOW_POWER_S0_IDLE_CAPABLE              BIT21

+

+///

+/// Firmware ACPI Control Structure

+///

+typedef struct {

+  UINT32  Signature;

+  UINT32  Length;

+  UINT32  HardwareSignature;

+  UINT32  FirmwareWakingVector;

+  UINT32  GlobalLock;

+  UINT32  Flags;

+  UINT64  XFirmwareWakingVector;

+  UINT8   Version;

+  UINT8   Reserved0[3];

+  UINT32  OspmFlags;

+  UINT8   Reserved1[24];

+} EFI_ACPI_6_0_FIRMWARE_ACPI_CONTROL_STRUCTURE;

+

+///

+/// FACS Version (as defined in ACPI 6.0 spec.)

+///

+#define EFI_ACPI_6_0_FIRMWARE_ACPI_CONTROL_STRUCTURE_VERSION  0x02

+

+///

+/// Firmware Control Structure Feature Flags

+/// All other bits are reserved and must be set to 0.

+///

+#define EFI_ACPI_6_0_S4BIOS_F                     BIT0

+#define EFI_ACPI_6_0_64BIT_WAKE_SUPPORTED_F       BIT1

+

+///

+/// OSPM Enabled Firmware Control Structure Flags

+/// All other bits are reserved and must be set to 0.

+///

+#define EFI_ACPI_6_0_OSPM_64BIT_WAKE_F            BIT0

+

+//

+// Differentiated System Description Table,

+// Secondary System Description Table

+// and Persistent System Description Table,

+// no definition needed as they are common description table header, the same with

+// EFI_ACPI_DESCRIPTION_HEADER, followed by a definition block.

+//

+#define EFI_ACPI_6_0_DIFFERENTIATED_SYSTEM_DESCRIPTION_TABLE_REVISION   0x02

+#define EFI_ACPI_6_0_SECONDARY_SYSTEM_DESCRIPTION_TABLE_REVISION        0x02

+

+///

+/// Multiple APIC Description Table header definition.  The rest of the table

+/// must be defined in a platform specific manner.

+///

+typedef struct {

+  EFI_ACPI_DESCRIPTION_HEADER Header;

+  UINT32                      LocalApicAddress;

+  UINT32                      Flags;

+} EFI_ACPI_6_0_MULTIPLE_APIC_DESCRIPTION_TABLE_HEADER;

+

+///

+/// MADT Revision (as defined in ACPI 6.0 Errata A spec.)

+///

+#define EFI_ACPI_6_0_MULTIPLE_APIC_DESCRIPTION_TABLE_REVISION 0x04

+

+///

+/// Multiple APIC Flags

+/// All other bits are reserved and must be set to 0.

+///

+#define EFI_ACPI_6_0_PCAT_COMPAT         BIT0

+

+//

+// Multiple APIC Description Table APIC structure types

+// All other values between 0x0D and 0x7F are reserved and

+// will be ignored by OSPM. 0x80 ~ 0xFF are reserved for OEM.

+//

+#define EFI_ACPI_6_0_PROCESSOR_LOCAL_APIC           0x00

+#define EFI_ACPI_6_0_IO_APIC                        0x01

+#define EFI_ACPI_6_0_INTERRUPT_SOURCE_OVERRIDE      0x02

+#define EFI_ACPI_6_0_NON_MASKABLE_INTERRUPT_SOURCE  0x03

+#define EFI_ACPI_6_0_LOCAL_APIC_NMI                 0x04

+#define EFI_ACPI_6_0_LOCAL_APIC_ADDRESS_OVERRIDE    0x05

+#define EFI_ACPI_6_0_IO_SAPIC                       0x06

+#define EFI_ACPI_6_0_LOCAL_SAPIC                    0x07

+#define EFI_ACPI_6_0_PLATFORM_INTERRUPT_SOURCES     0x08

+#define EFI_ACPI_6_0_PROCESSOR_LOCAL_X2APIC         0x09

+#define EFI_ACPI_6_0_LOCAL_X2APIC_NMI               0x0A

+#define EFI_ACPI_6_0_GIC                            0x0B

+#define EFI_ACPI_6_0_GICD                           0x0C

+#define EFI_ACPI_6_0_GIC_MSI_FRAME                  0x0D

+#define EFI_ACPI_6_0_GICR                           0x0E

+#define EFI_ACPI_6_0_GIC_ITS                        0x0F

+

+//

+// APIC Structure Definitions

+//

+

+///

+/// Processor Local APIC Structure Definition

+///

+typedef struct {

+  UINT8   Type;

+  UINT8   Length;

+  UINT8   AcpiProcessorUid;

+  UINT8   ApicId;

+  UINT32  Flags;

+} EFI_ACPI_6_0_PROCESSOR_LOCAL_APIC_STRUCTURE;

+

+///

+/// Local APIC Flags.  All other bits are reserved and must be 0.

+///

+#define EFI_ACPI_6_0_LOCAL_APIC_ENABLED        BIT0

+

+///

+/// IO APIC Structure

+///

+typedef struct {

+  UINT8   Type;

+  UINT8   Length;

+  UINT8   IoApicId;

+  UINT8   Reserved;

+  UINT32  IoApicAddress;

+  UINT32  GlobalSystemInterruptBase;

+} EFI_ACPI_6_0_IO_APIC_STRUCTURE;

+

+///

+/// Interrupt Source Override Structure

+///

+typedef struct {

+  UINT8   Type;

+  UINT8   Length;

+  UINT8   Bus;

+  UINT8   Source;

+  UINT32  GlobalSystemInterrupt;

+  UINT16  Flags;

+} EFI_ACPI_6_0_INTERRUPT_SOURCE_OVERRIDE_STRUCTURE;

+

+///

+/// Platform Interrupt Sources Structure Definition

+///

+typedef struct {

+  UINT8   Type;

+  UINT8   Length;

+  UINT16  Flags;

+  UINT8   InterruptType;

+  UINT8   ProcessorId;

+  UINT8   ProcessorEid;

+  UINT8   IoSapicVector;

+  UINT32  GlobalSystemInterrupt;

+  UINT32  PlatformInterruptSourceFlags;

+  UINT8   CpeiProcessorOverride;

+  UINT8   Reserved[31];

+} EFI_ACPI_6_0_PLATFORM_INTERRUPT_APIC_STRUCTURE;

+

+//

+// MPS INTI flags.

+// All other bits are reserved and must be set to 0.

+//

+#define EFI_ACPI_6_0_POLARITY      (3 << 0)

+#define EFI_ACPI_6_0_TRIGGER_MODE  (3 << 2)

+

+///

+/// Non-Maskable Interrupt Source Structure

+///

+typedef struct {

+  UINT8   Type;

+  UINT8   Length;

+  UINT16  Flags;

+  UINT32  GlobalSystemInterrupt;

+} EFI_ACPI_6_0_NON_MASKABLE_INTERRUPT_SOURCE_STRUCTURE;

+

+///

+/// Local APIC NMI Structure

+///

+typedef struct {

+  UINT8   Type;

+  UINT8   Length;

+  UINT8   AcpiProcessorUid;

+  UINT16  Flags;

+  UINT8   LocalApicLint;

+} EFI_ACPI_6_0_LOCAL_APIC_NMI_STRUCTURE;

+

+///

+/// Local APIC Address Override Structure

+///

+typedef struct {

+  UINT8   Type;

+  UINT8   Length;

+  UINT16  Reserved;

+  UINT64  LocalApicAddress;

+} EFI_ACPI_6_0_LOCAL_APIC_ADDRESS_OVERRIDE_STRUCTURE;

+

+///

+/// IO SAPIC Structure

+///

+typedef struct {

+  UINT8   Type;

+  UINT8   Length;

+  UINT8   IoApicId;

+  UINT8   Reserved;

+  UINT32  GlobalSystemInterruptBase;

+  UINT64  IoSapicAddress;

+} EFI_ACPI_6_0_IO_SAPIC_STRUCTURE;

+

+///

+/// Local SAPIC Structure

+/// This struct followed by a null-terminated ASCII string - ACPI Processor UID String

+///

+typedef struct {

+  UINT8   Type;

+  UINT8   Length;

+  UINT8   AcpiProcessorId;

+  UINT8   LocalSapicId;

+  UINT8   LocalSapicEid;

+  UINT8   Reserved[3];

+  UINT32  Flags;

+  UINT32  ACPIProcessorUIDValue;

+} EFI_ACPI_6_0_PROCESSOR_LOCAL_SAPIC_STRUCTURE;

+

+///

+/// Platform Interrupt Sources Structure

+///

+typedef struct {

+  UINT8   Type;

+  UINT8   Length;

+  UINT16  Flags;

+  UINT8   InterruptType;

+  UINT8   ProcessorId;

+  UINT8   ProcessorEid;

+  UINT8   IoSapicVector;

+  UINT32  GlobalSystemInterrupt;

+  UINT32  PlatformInterruptSourceFlags;

+} EFI_ACPI_6_0_PLATFORM_INTERRUPT_SOURCES_STRUCTURE;

+

+///

+/// Platform Interrupt Source Flags.

+/// All other bits are reserved and must be set to 0.

+///

+#define EFI_ACPI_6_0_CPEI_PROCESSOR_OVERRIDE          BIT0

+

+///

+/// Processor Local x2APIC Structure Definition

+///

+typedef struct {

+  UINT8   Type;

+  UINT8   Length;

+  UINT8   Reserved[2];

+  UINT32  X2ApicId;

+  UINT32  Flags;

+  UINT32  AcpiProcessorUid;

+} EFI_ACPI_6_0_PROCESSOR_LOCAL_X2APIC_STRUCTURE;

+

+///

+/// Local x2APIC NMI Structure

+///

+typedef struct {

+  UINT8   Type;

+  UINT8   Length;

+  UINT16  Flags;

+  UINT32  AcpiProcessorUid;

+  UINT8   LocalX2ApicLint;

+  UINT8   Reserved[3];

+} EFI_ACPI_6_0_LOCAL_X2APIC_NMI_STRUCTURE;

+

+///

+/// GIC Structure

+///

+typedef struct {

+  UINT8   Type;

+  UINT8   Length;

+  UINT16  Reserved;

+  UINT32  CPUInterfaceNumber;

+  UINT32  AcpiProcessorUid;

+  UINT32  Flags;

+  UINT32  ParkingProtocolVersion;

+  UINT32  PerformanceInterruptGsiv;

+  UINT64  ParkedAddress;

+  UINT64  PhysicalBaseAddress;

+  UINT64  GICV;

+  UINT64  GICH;

+  UINT32  VGICMaintenanceInterrupt;

+  UINT64  GICRBaseAddress;

+  UINT64  MPIDR;

+  UINT8   ProcessorPowerEfficiencyClass;

+  UINT8   Reserved2[3];

+} EFI_ACPI_6_0_GIC_STRUCTURE;

+

+///

+/// GIC Flags.  All other bits are reserved and must be 0.

+///

+#define EFI_ACPI_6_0_GIC_ENABLED                              BIT0

+#define EFI_ACPI_6_0_PERFORMANCE_INTERRUPT_MODEL              BIT1

+#define EFI_ACPI_6_0_VGIC_MAINTENANCE_INTERRUPT_MODE_FLAGS    BIT2

+

+///

+/// GIC Distributor Structure

+///

+typedef struct {

+  UINT8   Type;

+  UINT8   Length;

+  UINT16  Reserved1;

+  UINT32  GicId;

+  UINT64  PhysicalBaseAddress;

+  UINT32  SystemVectorBase;

+  UINT8   GicVersion;

+  UINT8   Reserved2[3];

+} EFI_ACPI_6_0_GIC_DISTRIBUTOR_STRUCTURE;

+

+///

+/// GIC Version

+///

+#define EFI_ACPI_6_0_GIC_V1                                   0x01

+#define EFI_ACPI_6_0_GIC_V2                                   0x02

+#define EFI_ACPI_6_0_GIC_V3                                   0x03

+#define EFI_ACPI_6_0_GIC_V4                                   0x04

+

+///

+/// GIC MSI Frame Structure

+///

+typedef struct {

+  UINT8   Type;

+  UINT8   Length;

+  UINT16  Reserved1;

+  UINT32  GicMsiFrameId;

+  UINT64  PhysicalBaseAddress;

+  UINT32  Flags;

+  UINT16  SPICount;

+  UINT16  SPIBase;

+} EFI_ACPI_6_0_GIC_MSI_FRAME_STRUCTURE;

+

+///

+/// GIC MSI Frame Flags.  All other bits are reserved and must be 0.

+///

+#define EFI_ACPI_6_0_SPI_COUNT_BASE_SELECT                    BIT0

+

+///

+/// GICR Structure

+///

+typedef struct {

+  UINT8   Type;

+  UINT8   Length;

+  UINT16  Reserved;

+  UINT64  DiscoveryRangeBaseAddress;

+  UINT32  DiscoveryRangeLength;

+} EFI_ACPI_6_0_GICR_STRUCTURE;

+

+///

+/// GIC Interrupt Translation Service Structure

+///

+typedef struct {

+  UINT8   Type;

+  UINT8   Length;

+  UINT16  Reserved;

+  UINT32  GicItsId;

+  UINT64  PhysicalBaseAddress;

+  UINT32  Reserved2;

+} EFI_ACPI_6_0_GIC_ITS_STRUCTURE;

+

+///

+/// Smart Battery Description Table (SBST)

+///

+typedef struct {

+  EFI_ACPI_DESCRIPTION_HEADER Header;

+  UINT32                      WarningEnergyLevel;

+  UINT32                      LowEnergyLevel;

+  UINT32                      CriticalEnergyLevel;

+} EFI_ACPI_6_0_SMART_BATTERY_DESCRIPTION_TABLE;

+

+///

+/// SBST Version (as defined in ACPI 6.0 spec.)

+///

+#define EFI_ACPI_6_0_SMART_BATTERY_DESCRIPTION_TABLE_REVISION 0x01

+

+///

+/// Embedded Controller Boot Resources Table (ECDT)

+/// The table is followed by a null terminated ASCII string that contains

+/// a fully qualified reference to the name space object.

+///

+typedef struct {

+  EFI_ACPI_DESCRIPTION_HEADER             Header;

+  EFI_ACPI_6_0_GENERIC_ADDRESS_STRUCTURE  EcControl;

+  EFI_ACPI_6_0_GENERIC_ADDRESS_STRUCTURE  EcData;

+  UINT32                                  Uid;

+  UINT8                                   GpeBit;

+} EFI_ACPI_6_0_EMBEDDED_CONTROLLER_BOOT_RESOURCES_TABLE;

+

+///

+/// ECDT Version (as defined in ACPI 6.0 spec.)

+///

+#define EFI_ACPI_6_0_EMBEDDED_CONTROLLER_BOOT_RESOURCES_TABLE_REVISION  0x01

+

+///

+/// System Resource Affinity Table (SRAT).  The rest of the table

+/// must be defined in a platform specific manner.

+///

+typedef struct {

+  EFI_ACPI_DESCRIPTION_HEADER Header;

+  UINT32                      Reserved1;  ///< Must be set to 1

+  UINT64                      Reserved2;

+} EFI_ACPI_6_0_SYSTEM_RESOURCE_AFFINITY_TABLE_HEADER;

+

+///

+/// SRAT Version (as defined in ACPI 6.0 spec.)

+///

+#define EFI_ACPI_6_0_SYSTEM_RESOURCE_AFFINITY_TABLE_REVISION  0x03

+

+//

+// SRAT structure types.

+// All other values between 0x04 an 0xFF are reserved and

+// will be ignored by OSPM.

+//

+#define EFI_ACPI_6_0_PROCESSOR_LOCAL_APIC_SAPIC_AFFINITY  0x00

+#define EFI_ACPI_6_0_MEMORY_AFFINITY                      0x01

+#define EFI_ACPI_6_0_PROCESSOR_LOCAL_X2APIC_AFFINITY      0x02

+#define EFI_ACPI_6_0_GICC_AFFINITY                        0x03

+

+///

+/// Processor Local APIC/SAPIC Affinity Structure Definition

+///

+typedef struct {

+  UINT8   Type;

+  UINT8   Length;

+  UINT8   ProximityDomain7To0;

+  UINT8   ApicId;

+  UINT32  Flags;

+  UINT8   LocalSapicEid;

+  UINT8   ProximityDomain31To8[3];

+  UINT32  ClockDomain;

+} EFI_ACPI_6_0_PROCESSOR_LOCAL_APIC_SAPIC_AFFINITY_STRUCTURE;

+

+///

+/// Local APIC/SAPIC Flags.  All other bits are reserved and must be 0.

+///

+#define EFI_ACPI_6_0_PROCESSOR_LOCAL_APIC_SAPIC_ENABLED (1 << 0)

+

+///

+/// Memory Affinity Structure Definition

+///

+typedef struct {

+  UINT8   Type;

+  UINT8   Length;

+  UINT32  ProximityDomain;

+  UINT16  Reserved1;

+  UINT32  AddressBaseLow;

+  UINT32  AddressBaseHigh;

+  UINT32  LengthLow;

+  UINT32  LengthHigh;

+  UINT32  Reserved2;

+  UINT32  Flags;

+  UINT64  Reserved3;

+} EFI_ACPI_6_0_MEMORY_AFFINITY_STRUCTURE;

+

+//

+// Memory Flags.  All other bits are reserved and must be 0.

+//

+#define EFI_ACPI_6_0_MEMORY_ENABLED       (1 << 0)

+#define EFI_ACPI_6_0_MEMORY_HOT_PLUGGABLE (1 << 1)

+#define EFI_ACPI_6_0_MEMORY_NONVOLATILE   (1 << 2)

+

+///

+/// Processor Local x2APIC Affinity Structure Definition

+///

+typedef struct {

+  UINT8   Type;

+  UINT8   Length;

+  UINT8   Reserved1[2];

+  UINT32  ProximityDomain;

+  UINT32  X2ApicId;

+  UINT32  Flags;

+  UINT32  ClockDomain;

+  UINT8   Reserved2[4];

+} EFI_ACPI_6_0_PROCESSOR_LOCAL_X2APIC_AFFINITY_STRUCTURE;

+

+///

+/// GICC Affinity Structure Definition

+///

+typedef struct {

+  UINT8   Type;

+  UINT8   Length;

+  UINT32  ProximityDomain;

+  UINT32  AcpiProcessorUid;

+  UINT32  Flags;

+  UINT32  ClockDomain;

+} EFI_ACPI_6_0_GICC_AFFINITY_STRUCTURE;

+

+///

+/// GICC Flags.  All other bits are reserved and must be 0.

+///

+#define EFI_ACPI_6_0_GICC_ENABLED (1 << 0)

+

+///

+/// System Locality Distance Information Table (SLIT).

+/// The rest of the table is a matrix.

+///

+typedef struct {

+  EFI_ACPI_DESCRIPTION_HEADER Header;

+  UINT64                      NumberOfSystemLocalities;

+} EFI_ACPI_6_0_SYSTEM_LOCALITY_DISTANCE_INFORMATION_TABLE_HEADER;

+

+///

+/// SLIT Version (as defined in ACPI 6.0 spec.)

+///

+#define EFI_ACPI_6_0_SYSTEM_LOCALITY_DISTANCE_INFORMATION_TABLE_REVISION  0x01

+

+///

+/// Corrected Platform Error Polling Table (CPEP)

+///

+typedef struct {

+  EFI_ACPI_DESCRIPTION_HEADER Header;

+  UINT8                       Reserved[8];

+} EFI_ACPI_6_0_CORRECTED_PLATFORM_ERROR_POLLING_TABLE_HEADER;

+

+///

+/// CPEP Version (as defined in ACPI 6.0 spec.)

+///

+#define EFI_ACPI_6_0_CORRECTED_PLATFORM_ERROR_POLLING_TABLE_REVISION 0x01

+

+//

+// CPEP processor structure types.

+//

+#define EFI_ACPI_6_0_CPEP_PROCESSOR_APIC_SAPIC  0x00

+

+///

+/// Corrected Platform Error Polling Processor Structure Definition

+///

+typedef struct {

+  UINT8   Type;

+  UINT8   Length;

+  UINT8   ProcessorId;

+  UINT8   ProcessorEid;

+  UINT32  PollingInterval;

+} EFI_ACPI_6_0_CPEP_PROCESSOR_APIC_SAPIC_STRUCTURE;

+

+///

+/// Maximum System Characteristics Table (MSCT)

+///

+typedef struct {

+  EFI_ACPI_DESCRIPTION_HEADER Header;

+  UINT32                      OffsetProxDomInfo;

+  UINT32                      MaximumNumberOfProximityDomains;

+  UINT32                      MaximumNumberOfClockDomains;

+  UINT64                      MaximumPhysicalAddress;

+} EFI_ACPI_6_0_MAXIMUM_SYSTEM_CHARACTERISTICS_TABLE_HEADER;

+

+///

+/// MSCT Version (as defined in ACPI 6.0 spec.)

+///

+#define EFI_ACPI_6_0_MAXIMUM_SYSTEM_CHARACTERISTICS_TABLE_REVISION 0x01

+

+///

+/// Maximum Proximity Domain Information Structure Definition

+///

+typedef struct {

+  UINT8   Revision;

+  UINT8   Length;

+  UINT32  ProximityDomainRangeLow;

+  UINT32  ProximityDomainRangeHigh;

+  UINT32  MaximumProcessorCapacity;

+  UINT64  MaximumMemoryCapacity;

+} EFI_ACPI_6_0_MAXIMUM_PROXIMITY_DOMAIN_INFORMATION_STRUCTURE;

+

+///

+/// ACPI RAS Feature Table definition.

+///

+typedef struct {

+  EFI_ACPI_DESCRIPTION_HEADER Header;

+  UINT8                       PlatformCommunicationChannelIdentifier[12];

+} EFI_ACPI_6_0_RAS_FEATURE_TABLE;

+

+///

+/// RASF Version (as defined in ACPI 6.0 spec.)

+///

+#define EFI_ACPI_6_0_RAS_FEATURE_TABLE_REVISION 0x01

+

+///

+/// ACPI RASF Platform Communication Channel Shared Memory Region definition.

+///

+typedef struct {

+  UINT32                      Signature;

+  UINT16                      Command;

+  UINT16                      Status;

+  UINT16                      Version;

+  UINT8                       RASCapabilities[16];

+  UINT8                       SetRASCapabilities[16];

+  UINT16                      NumberOfRASFParameterBlocks;

+  UINT32                      SetRASCapabilitiesStatus;

+} EFI_ACPI_6_0_RASF_PLATFORM_COMMUNICATION_CHANNEL_SHARED_MEMORY_REGION;

+

+///

+/// ACPI RASF PCC command code

+///

+#define EFI_ACPI_6_0_RASF_PCC_COMMAND_CODE_EXECUTE_RASF_COMMAND  0x01

+

+///

+/// ACPI RASF Platform RAS Capabilities

+///

+#define EFI_ACPI_6_0_RASF_PLATFORM_RAS_CAPABILITY_HARDWARE_BASED_PATROL_SCRUB_SUPPOTED                          0x01

+#define EFI_ACPI_6_0_RASF_PLATFORM_RAS_CAPABILITY_HARDWARE_BASED_PATROL_SCRUB_SUPPOTED_AND_EXPOSED_TO_SOFTWARE  0x02

+

+///

+/// ACPI RASF Parameter Block structure for PATROL_SCRUB

+///

+typedef struct {

+  UINT16                      Type;

+  UINT16                      Version;

+  UINT16                      Length;

+  UINT16                      PatrolScrubCommand;

+  UINT64                      RequestedAddressRange[2];

+  UINT64                      ActualAddressRange[2];

+  UINT16                      Flags;

+  UINT8                       RequestedSpeed;

+} EFI_ACPI_6_0_RASF_PATROL_SCRUB_PLATFORM_BLOCK_STRUCTURE;

+

+///

+/// ACPI RASF Patrol Scrub command

+///

+#define EFI_ACPI_6_0_RASF_PATROL_SCRUB_COMMAND_GET_PATROL_PARAMETERS   0x01

+#define EFI_ACPI_6_0_RASF_PATROL_SCRUB_COMMAND_START_PATROL_SCRUBBER   0x02

+#define EFI_ACPI_6_0_RASF_PATROL_SCRUB_COMMAND_STOP_PATROL_SCRUBBER    0x03

+

+///

+/// Memory Power State Table definition.

+///

+typedef struct {

+  EFI_ACPI_DESCRIPTION_HEADER Header;

+  UINT8                       PlatformCommunicationChannelIdentifier;

+  UINT8                       Reserved[3];

+// Memory Power Node Structure

+// Memory Power State Characteristics

+} EFI_ACPI_6_0_MEMORY_POWER_STATUS_TABLE;

+

+///

+/// MPST Version (as defined in ACPI 6.0 spec.)

+///

+#define EFI_ACPI_6_0_MEMORY_POWER_STATE_TABLE_REVISION 0x01

+

+///

+/// MPST Platform Communication Channel Shared Memory Region definition.

+///

+typedef struct {

+  UINT32                      Signature;

+  UINT16                      Command;

+  UINT16                      Status;

+  UINT32                      MemoryPowerCommandRegister;

+  UINT32                      MemoryPowerStatusRegister;

+  UINT32                      PowerStateId;

+  UINT32                      MemoryPowerNodeId;

+  UINT64                      MemoryEnergyConsumed;

+  UINT64                      ExpectedAveragePowerComsuned;

+} EFI_ACPI_6_0_MPST_PLATFORM_COMMUNICATION_CHANNEL_SHARED_MEMORY_REGION;

+

+///

+/// ACPI MPST PCC command code

+///

+#define EFI_ACPI_6_0_MPST_PCC_COMMAND_CODE_EXECUTE_MPST_COMMAND  0x03

+

+///

+/// ACPI MPST Memory Power command

+///

+#define EFI_ACPI_6_0_MPST_MEMORY_POWER_COMMAND_GET_MEMORY_POWER_STATE       0x01

+#define EFI_ACPI_6_0_MPST_MEMORY_POWER_COMMAND_SET_MEMORY_POWER_STATE       0x02

+#define EFI_ACPI_6_0_MPST_MEMORY_POWER_COMMAND_GET_AVERAGE_POWER_CONSUMED   0x03

+#define EFI_ACPI_6_0_MPST_MEMORY_POWER_COMMAND_GET_MEMORY_ENERGY_CONSUMED   0x04

+

+///

+/// MPST Memory Power Node Table

+///

+typedef struct {

+  UINT8                                             PowerStateValue;

+  UINT8                                             PowerStateInformationIndex;

+} EFI_ACPI_6_0_MPST_MEMORY_POWER_STATE;

+

+typedef struct {

+  UINT8                                             Flag;

+  UINT8                                             Reserved;

+  UINT16                                            MemoryPowerNodeId;

+  UINT32                                            Length;

+  UINT64                                            AddressBase;

+  UINT64                                            AddressLength;

+  UINT32                                            NumberOfPowerStates;

+  UINT32                                            NumberOfPhysicalComponents;

+//EFI_ACPI_6_0_MPST_MEMORY_POWER_STATE              MemoryPowerState[NumberOfPowerStates];

+//UINT16                                            PhysicalComponentIdentifier[NumberOfPhysicalComponents];

+} EFI_ACPI_6_0_MPST_MEMORY_POWER_STRUCTURE;

+

+#define EFI_ACPI_6_0_MPST_MEMORY_POWER_STRUCTURE_FLAG_ENABLE          0x01

+#define EFI_ACPI_6_0_MPST_MEMORY_POWER_STRUCTURE_FLAG_POWER_MANAGED   0x02

+#define EFI_ACPI_6_0_MPST_MEMORY_POWER_STRUCTURE_FLAG_HOT_PLUGGABLE   0x04

+

+typedef struct {

+  UINT16                      MemoryPowerNodeCount;

+  UINT8                       Reserved[2];

+} EFI_ACPI_6_0_MPST_MEMORY_POWER_NODE_TABLE;

+

+///

+/// MPST Memory Power State Characteristics Table

+///

+typedef struct {

+  UINT8                                             PowerStateStructureID;

+  UINT8                                             Flag;

+  UINT16                                            Reserved;

+  UINT32                                            AveragePowerConsumedInMPS0;

+  UINT32                                            RelativePowerSavingToMPS0;

+  UINT64                                            ExitLatencyToMPS0;

+} EFI_ACPI_6_0_MPST_MEMORY_POWER_STATE_CHARACTERISTICS_STRUCTURE;

+

+#define EFI_ACPI_6_0_MPST_MEMORY_POWER_STATE_CHARACTERISTICS_STRUCTURE_FLAG_MEMORY_CONTENT_PRESERVED              0x01

+#define EFI_ACPI_6_0_MPST_MEMORY_POWER_STATE_CHARACTERISTICS_STRUCTURE_FLAG_AUTONOMOUS_MEMORY_POWER_STATE_ENTRY   0x02

+#define EFI_ACPI_6_0_MPST_MEMORY_POWER_STATE_CHARACTERISTICS_STRUCTURE_FLAG_AUTONOMOUS_MEMORY_POWER_STATE_EXIT    0x04

+

+typedef struct {

+  UINT16                      MemoryPowerStateCharacteristicsCount;

+  UINT8                       Reserved[2];

+} EFI_ACPI_6_0_MPST_MEMORY_POWER_STATE_CHARACTERISTICS_TABLE;

+

+///

+/// Memory Topology Table definition.

+///

+typedef struct {

+  EFI_ACPI_DESCRIPTION_HEADER Header;

+  UINT32                      Reserved;

+} EFI_ACPI_6_0_MEMORY_TOPOLOGY_TABLE;

+

+///

+/// PMTT Version (as defined in ACPI 6.0 spec.)

+///

+#define EFI_ACPI_6_0_MEMORY_TOPOLOGY_TABLE_REVISION 0x01

+

+///

+/// Common Memory Aggregator Device Structure.

+///

+typedef struct {

+  UINT8                       Type;

+  UINT8                       Reserved;

+  UINT16                      Length;

+  UINT16                      Flags;

+  UINT16                      Reserved1;

+} EFI_ACPI_6_0_PMMT_COMMON_MEMORY_AGGREGATOR_DEVICE_STRUCTURE;

+

+///

+/// Memory Aggregator Device Type

+///

+#define EFI_ACPI_6_0_PMMT_MEMORY_AGGREGATOR_DEVICE_TYPE_SOCKET            0x1

+#define EFI_ACPI_6_0_PMMT_MEMORY_AGGREGATOR_DEVICE_TYPE_MEMORY_CONTROLLER 0x2

+#define EFI_ACPI_6_0_PMMT_MEMORY_AGGREGATOR_DEVICE_TYPE_DIMM              0x3

+

+///

+/// Socket Memory Aggregator Device Structure.

+///

+typedef struct {

+  EFI_ACPI_6_0_PMMT_COMMON_MEMORY_AGGREGATOR_DEVICE_STRUCTURE  Header;

+  UINT16                                                       SocketIdentifier;

+  UINT16                                                       Reserved;

+//EFI_ACPI_6_0_PMMT_MEMORY_CONTROLLER_MEMORY_AGGREGATOR_DEVICE_STRUCTURE  MemoryController[];

+} EFI_ACPI_6_0_PMMT_SOCKET_MEMORY_AGGREGATOR_DEVICE_STRUCTURE;

+

+///

+/// MemoryController Memory Aggregator Device Structure.

+///

+typedef struct {

+  EFI_ACPI_6_0_PMMT_COMMON_MEMORY_AGGREGATOR_DEVICE_STRUCTURE  Header;

+  UINT32                                                       ReadLatency;

+  UINT32                                                       WriteLatency;

+  UINT32                                                       ReadBandwidth;

+  UINT32                                                       WriteBandwidth;

+  UINT16                                                       OptimalAccessUnit;

+  UINT16                                                       OptimalAccessAlignment;

+  UINT16                                                       Reserved;

+  UINT16                                                       NumberOfProximityDomains;

+//UINT32                                                       ProximityDomain[NumberOfProximityDomains];

+//EFI_ACPI_6_0_PMMT_DIMM_MEMORY_AGGREGATOR_DEVICE_STRUCTURE    PhysicalComponent[];

+} EFI_ACPI_6_0_PMMT_MEMORY_CONTROLLER_MEMORY_AGGREGATOR_DEVICE_STRUCTURE;

+

+///

+/// DIMM Memory Aggregator Device Structure.

+///

+typedef struct {

+  EFI_ACPI_6_0_PMMT_COMMON_MEMORY_AGGREGATOR_DEVICE_STRUCTURE  Header;

+  UINT16                                                       PhysicalComponentIdentifier;

+  UINT16                                                       Reserved;

+  UINT32                                                       SizeOfDimm;

+  UINT32                                                       SmbiosHandle;

+} EFI_ACPI_6_0_PMMT_DIMM_MEMORY_AGGREGATOR_DEVICE_STRUCTURE;

+

+///

+/// Boot Graphics Resource Table definition.

+///

+typedef struct {

+  EFI_ACPI_DESCRIPTION_HEADER Header;

+  ///

+  /// 2-bytes (16 bit) version ID. This value must be 1.

+  ///

+  UINT16                      Version;

+  ///

+  /// 1-byte status field indicating current status about the table.

+  ///     Bits[7:1] = Reserved (must be zero)

+  ///     Bit [0] = Valid. A one indicates the boot image graphic is valid.

+  ///

+  UINT8                       Status;

+  ///

+  /// 1-byte enumerated type field indicating format of the image.

+  ///     0 = Bitmap

+  ///     1 - 255  Reserved (for future use)

+  ///

+  UINT8                       ImageType;

+  ///

+  /// 8-byte (64 bit) physical address pointing to the firmware's in-memory copy

+  /// of the image bitmap.

+  ///

+  UINT64                      ImageAddress;

+  ///

+  /// A 4-byte (32-bit) unsigned long describing the display X-offset of the boot image.

+  /// (X, Y) display offset of the top left corner of the boot image.

+  /// The top left corner of the display is at offset (0, 0).

+  ///

+  UINT32                      ImageOffsetX;

+  ///

+  /// A 4-byte (32-bit) unsigned long describing the display Y-offset of the boot image.

+  /// (X, Y) display offset of the top left corner of the boot image.

+  /// The top left corner of the display is at offset (0, 0).

+  ///

+  UINT32                      ImageOffsetY;

+} EFI_ACPI_6_0_BOOT_GRAPHICS_RESOURCE_TABLE;

+

+///

+/// BGRT Revision

+///

+#define EFI_ACPI_6_0_BOOT_GRAPHICS_RESOURCE_TABLE_REVISION 1

+

+///

+/// BGRT Version

+///

+#define EFI_ACPI_6_0_BGRT_VERSION         0x01

+

+///

+/// BGRT Status

+///

+#define EFI_ACPI_6_0_BGRT_STATUS_NOT_DISPLAYED 0x00

+#define EFI_ACPI_6_0_BGRT_STATUS_DISPLAYED     0x01

+

+///

+/// BGRT Image Type

+///

+#define EFI_ACPI_6_0_BGRT_IMAGE_TYPE_BMP  0x00

+

+///

+/// FPDT Version (as defined in ACPI 6.0 spec.)

+///

+#define EFI_ACPI_6_0_FIRMWARE_PERFORMANCE_DATA_TABLE_REVISION 0x01

+

+///

+/// FPDT Performance Record Types

+///

+#define EFI_ACPI_6_0_FPDT_RECORD_TYPE_FIRMWARE_BASIC_BOOT_POINTER      0x0000

+#define EFI_ACPI_6_0_FPDT_RECORD_TYPE_S3_PERFORMANCE_TABLE_POINTER     0x0001

+

+///

+/// FPDT Performance Record Revision

+///

+#define EFI_ACPI_6_0_FPDT_RECORD_REVISION_FIRMWARE_BASIC_BOOT_POINTER  0x01

+#define EFI_ACPI_6_0_FPDT_RECORD_REVISION_S3_PERFORMANCE_TABLE_POINTER 0x01

+

+///

+/// FPDT Runtime Performance Record Types

+///

+#define EFI_ACPI_6_0_FPDT_RUNTIME_RECORD_TYPE_S3_RESUME                0x0000

+#define EFI_ACPI_6_0_FPDT_RUNTIME_RECORD_TYPE_S3_SUSPEND               0x0001

+#define EFI_ACPI_6_0_FPDT_RUNTIME_RECORD_TYPE_FIRMWARE_BASIC_BOOT      0x0002

+

+///

+/// FPDT Runtime Performance Record Revision

+///

+#define EFI_ACPI_6_0_FPDT_RUNTIME_RECORD_REVISION_S3_RESUME            0x01

+#define EFI_ACPI_6_0_FPDT_RUNTIME_RECORD_REVISION_S3_SUSPEND           0x01

+#define EFI_ACPI_6_0_FPDT_RUNTIME_RECORD_REVISION_FIRMWARE_BASIC_BOOT  0x02

+

+///

+/// FPDT Performance Record header

+///

+typedef struct {

+  UINT16           Type;

+  UINT8            Length;

+  UINT8            Revision;

+} EFI_ACPI_6_0_FPDT_PERFORMANCE_RECORD_HEADER;

+

+///

+/// FPDT Performance Table header

+///

+typedef struct {

+  UINT32  Signature;

+  UINT32  Length;

+} EFI_ACPI_6_0_FPDT_PERFORMANCE_TABLE_HEADER;

+

+///

+/// FPDT Firmware Basic Boot Performance Pointer Record Structure

+///

+typedef struct {

+  EFI_ACPI_6_0_FPDT_PERFORMANCE_RECORD_HEADER     Header;

+  UINT32                                          Reserved;

+  ///

+  /// 64-bit processor-relative physical address of the Basic Boot Performance Table.

+  ///

+  UINT64                                          BootPerformanceTablePointer;

+} EFI_ACPI_6_0_FPDT_BOOT_PERFORMANCE_TABLE_POINTER_RECORD;

+

+///

+/// FPDT S3 Performance Table Pointer Record Structure

+///

+typedef struct {

+  EFI_ACPI_6_0_FPDT_PERFORMANCE_RECORD_HEADER     Header;

+  UINT32                                          Reserved;

+  ///

+  /// 64-bit processor-relative physical address of the S3 Performance Table.

+  ///

+  UINT64                                          S3PerformanceTablePointer;

+} EFI_ACPI_6_0_FPDT_S3_PERFORMANCE_TABLE_POINTER_RECORD;

+

+///

+/// FPDT Firmware Basic Boot Performance Record Structure

+///

+typedef struct {

+  EFI_ACPI_6_0_FPDT_PERFORMANCE_RECORD_HEADER     Header;

+  UINT32                                          Reserved;

+  ///

+  /// Timer value logged at the beginning of firmware image execution.

+  /// This may not always be zero or near zero.

+  ///

+  UINT64                                          ResetEnd;

+  ///

+  /// Timer value logged just prior to loading the OS boot loader into memory.

+  /// For non-UEFI compatible boots, this field must be zero.

+  ///

+  UINT64                                          OsLoaderLoadImageStart;

+  ///

+  /// Timer value logged just prior to launching the previously loaded OS boot loader image.

+  /// For non-UEFI compatible boots, the timer value logged will be just prior

+  /// to the INT 19h handler invocation.

+  ///

+  UINT64                                          OsLoaderStartImageStart;

+  ///

+  /// Timer value logged at the point when the OS loader calls the

+  /// ExitBootServices function for UEFI compatible firmware.

+  /// For non-UEFI compatible boots, this field must be zero.

+  ///

+  UINT64                                          ExitBootServicesEntry;

+  ///

+  /// Timer value logged at the point just prior to when the OS loader gaining

+  /// control back from calls the ExitBootServices function for UEFI compatible firmware.

+  /// For non-UEFI compatible boots, this field must be zero.

+  ///

+  UINT64                                          ExitBootServicesExit;

+} EFI_ACPI_6_0_FPDT_FIRMWARE_BASIC_BOOT_RECORD;

+

+///

+/// FPDT Firmware Basic Boot Performance Table signature

+///

+#define EFI_ACPI_6_0_FPDT_BOOT_PERFORMANCE_TABLE_SIGNATURE  SIGNATURE_32('F', 'B', 'P', 'T')

+

+//

+// FPDT Firmware Basic Boot Performance Table

+//

+typedef struct {

+  EFI_ACPI_6_0_FPDT_PERFORMANCE_TABLE_HEADER      Header;

+  //

+  // one or more Performance Records.

+  //

+} EFI_ACPI_6_0_FPDT_FIRMWARE_BASIC_BOOT_TABLE;

+

+///

+/// FPDT "S3PT" S3 Performance Table

+///

+#define EFI_ACPI_6_0_FPDT_S3_PERFORMANCE_TABLE_SIGNATURE  SIGNATURE_32('S', '3', 'P', 'T')

+

+//

+// FPDT Firmware S3 Boot Performance Table

+//

+typedef struct {

+  EFI_ACPI_6_0_FPDT_PERFORMANCE_TABLE_HEADER      Header;

+  //

+  // one or more Performance Records.

+  //

+} EFI_ACPI_6_0_FPDT_FIRMWARE_S3_BOOT_TABLE;

+

+///

+/// FPDT Basic S3 Resume Performance Record

+///

+typedef struct {

+  EFI_ACPI_6_0_FPDT_PERFORMANCE_RECORD_HEADER     Header;

+  ///

+  /// A count of the number of S3 resume cycles since the last full boot sequence.

+  ///

+  UINT32                                          ResumeCount;

+  ///

+  /// Timer recorded at the end of BIOS S3 resume, just prior to handoff to the

+  /// OS waking vector. Only the most recent resume cycle's time is retained.

+  ///

+  UINT64                                          FullResume;

+  ///

+  /// Average timer value of all resume cycles logged since the last full boot

+  /// sequence, including the most recent resume.  Note that the entire log of

+  /// timer values does not need to be retained in order to calculate this average.

+  ///

+  UINT64                                          AverageResume;

+} EFI_ACPI_6_0_FPDT_S3_RESUME_RECORD;

+

+///

+/// FPDT Basic S3 Suspend Performance Record

+///

+typedef struct {

+  EFI_ACPI_6_0_FPDT_PERFORMANCE_RECORD_HEADER     Header;

+  ///

+  /// Timer value recorded at the OS write to SLP_TYP upon entry to S3.

+  /// Only the most recent suspend cycle's timer value is retained.

+  ///

+  UINT64                                          SuspendStart;

+  ///

+  /// Timer value recorded at the final firmware write to SLP_TYP (or other

+  /// mechanism) used to trigger hardware entry to S3.

+  /// Only the most recent suspend cycle's timer value is retained.

+  ///

+  UINT64                                          SuspendEnd;

+} EFI_ACPI_6_0_FPDT_S3_SUSPEND_RECORD;

+

+///

+/// Firmware Performance Record Table definition.

+///

+typedef struct {

+  EFI_ACPI_DESCRIPTION_HEADER Header;

+} EFI_ACPI_6_0_FIRMWARE_PERFORMANCE_RECORD_TABLE;

+

+///

+/// Generic Timer Description Table definition.

+///

+typedef struct {

+  EFI_ACPI_DESCRIPTION_HEADER Header;

+  UINT64                      CntControlBasePhysicalAddress;

+  UINT32                      Reserved;

+  UINT32                      SecurePL1TimerGSIV;

+  UINT32                      SecurePL1TimerFlags;

+  UINT32                      NonSecurePL1TimerGSIV;

+  UINT32                      NonSecurePL1TimerFlags;

+  UINT32                      VirtualTimerGSIV;

+  UINT32                      VirtualTimerFlags;

+  UINT32                      NonSecurePL2TimerGSIV;

+  UINT32                      NonSecurePL2TimerFlags;

+  UINT64                      CntReadBasePhysicalAddress;

+  UINT32                      PlatformTimerCount;

+  UINT32                      PlatformTimerOffset;

+} EFI_ACPI_6_0_GENERIC_TIMER_DESCRIPTION_TABLE;

+

+///

+/// GTDT Version (as defined in ACPI 6.0 spec.)

+///

+#define EFI_ACPI_6_0_GENERIC_TIMER_DESCRIPTION_TABLE_REVISION 0x02

+

+///

+/// Timer Flags.  All other bits are reserved and must be 0.

+///

+#define EFI_ACPI_6_0_GTDT_TIMER_FLAG_TIMER_INTERRUPT_MODE          BIT0

+#define EFI_ACPI_6_0_GTDT_TIMER_FLAG_TIMER_INTERRUPT_POLARITY      BIT1

+#define EFI_ACPI_6_0_GTDT_TIMER_FLAG_ALWAYS_ON_CAPABILITY          BIT2

+

+///

+/// Platform Timer Type

+///

+#define EFI_ACPI_6_0_GTDT_GT_BLOCK                       0

+#define EFI_ACPI_6_0_GTDT_SBSA_GENERIC_WATCHDOG          1

+

+///

+/// GT Block Structure

+///

+typedef struct {

+  UINT8   Type;

+  UINT16  Length;

+  UINT8   Reserved;

+  UINT64  CntCtlBase;

+  UINT32  GTBlockTimerCount;

+  UINT32  GTBlockTimerOffset;

+} EFI_ACPI_6_0_GTDT_GT_BLOCK_STRUCTURE;

+

+///

+/// GT Block Timer Structure

+///

+typedef struct {

+  UINT8   GTFrameNumber;

+  UINT8   Reserved[3];

+  UINT64  CntBaseX;

+  UINT64  CntEL0BaseX;

+  UINT32  GTxPhysicalTimerGSIV;

+  UINT32  GTxPhysicalTimerFlags;

+  UINT32  GTxVirtualTimerGSIV;

+  UINT32  GTxVirtualTimerFlags;

+  UINT32  GTxCommonFlags;

+} EFI_ACPI_6_0_GTDT_GT_BLOCK_TIMER_STRUCTURE;

+

+///

+/// GT Block Physical Timers and Virtual Timers Flags.  All other bits are reserved and must be 0.

+///

+#define EFI_ACPI_6_0_GTDT_GT_BLOCK_TIMER_FLAG_TIMER_INTERRUPT_MODE          BIT0

+#define EFI_ACPI_6_0_GTDT_GT_BLOCK_TIMER_FLAG_TIMER_INTERRUPT_POLARITY      BIT1

+

+///

+/// Common Flags Flags.  All other bits are reserved and must be 0.

+///

+#define EFI_ACPI_6_0_GTDT_GT_BLOCK_COMMON_FLAG_SECURE_TIMER              BIT0

+#define EFI_ACPI_6_0_GTDT_GT_BLOCK_COMMON_FLAG_ALWAYS_ON_CAPABILITY      BIT1

+

+///

+/// SBSA Generic Watchdog Structure

+///

+typedef struct {

+  UINT8   Type;

+  UINT16  Length;

+  UINT8   Reserved;

+  UINT64  RefreshFramePhysicalAddress;

+  UINT64  WatchdogControlFramePhysicalAddress;

+  UINT32  WatchdogTimerGSIV;

+  UINT32  WatchdogTimerFlags;

+} EFI_ACPI_6_0_GTDT_SBSA_GENERIC_WATCHDOG_STRUCTURE;

+

+///

+/// SBSA Generic Watchdog Timer Flags.  All other bits are reserved and must be 0.

+///

+#define EFI_ACPI_6_0_GTDT_SBSA_GENERIC_WATCHDOG_FLAG_TIMER_INTERRUPT_MODE          BIT0

+#define EFI_ACPI_6_0_GTDT_SBSA_GENERIC_WATCHDOG_FLAG_TIMER_INTERRUPT_POLARITY      BIT1

+#define EFI_ACPI_6_0_GTDT_SBSA_GENERIC_WATCHDOG_FLAG_SECURE_TIMER                  BIT2

+

+//

+// NVDIMM Firmware Interface Table definition.

+//

+typedef struct {

+  EFI_ACPI_DESCRIPTION_HEADER    Header;

+  UINT32                         Reserved;

+} EFI_ACPI_6_0_NVDIMM_FIRMWARE_INTERFACE_TABLE;

+

+//

+// NFIT Version (as defined in ACPI 6.0 spec.)

+//

+#define EFI_ACPI_6_0_NVDIMM_FIRMWARE_INTERFACE_TABLE_REVISION 0x1

+

+//

+// Definition for NFIT Table Structure Types

+//

+#define EFI_ACPI_6_0_NFIT_SYSTEM_PHYSICAL_ADDRESS_RANGE_STRUCTURE_TYPE              0

+#define EFI_ACPI_6_0_NFIT_MEMORY_DEVICE_TO_SYSTEM_ADDRESS_RANGE_MAP_STRUCTURE_TYPE  1

+#define EFI_ACPI_6_0_NFIT_INTERLEAVE_STRUCTURE_TYPE                                 2

+#define EFI_ACPI_6_0_NFIT_SMBIOS_MANAGEMENT_INFORMATION_STRUCTURE_TYPE              3

+#define EFI_ACPI_6_0_NFIT_NVDIMM_CONTROL_REGION_STRUCTURE_TYPE                      4

+#define EFI_ACPI_6_0_NFIT_NVDIMM_BLOCK_DATA_WINDOW_REGION_STRUCTURE_TYPE            5

+#define EFI_ACPI_6_0_NFIT_FLUSH_HINT_ADDRESS_STRUCTURE_TYPE                         6

+

+//

+// Definition for NFIT Structure Header

+//

+typedef struct {

+  UINT16                                      Type;

+  UINT16                                      Length;

+} EFI_ACPI_6_0_NFIT_STRUCTURE_HEADER;

+

+//

+// Definition for System Physical Address Range Structure

+//

+#define EFI_ACPI_6_0_NFIT_SYSTEM_PHYSICAL_ADDRESS_RANGE_FLAGS_CONTROL_REGION_FOR_MANAGEMENT      BIT0

+#define EFI_ACPI_6_0_NFIT_SYSTEM_PHYSICAL_ADDRESS_RANGE_FLAGS_PROXIMITY_DOMAIN_VALID             BIT1

+#define EFI_ACPI_6_0_NFIT_GUID_VOLATILE_MEMORY_REGION                             { 0x7305944F, 0xFDDA, 0x44E3, { 0xB1, 0x6C, 0x3F, 0x22, 0xD2, 0x52, 0xE5, 0xD0 }}

+#define EFI_ACPI_6_0_NFIT_GUID_BYTE_ADDRESSABLE_PERSISTENT_MEMORY_REGION          { 0x66F0D379, 0xB4F3, 0x4074, { 0xAC, 0x43, 0x0D, 0x33, 0x18, 0xB7, 0x8C, 0xDB }}

+#define EFI_ACPI_6_0_NFIT_GUID_NVDIMM_CONTROL_REGION                              { 0x92F701F6, 0x13B4, 0x405D, { 0x91, 0x0B, 0x29, 0x93, 0x67, 0xE8, 0x23, 0x4C }}

+#define EFI_ACPI_6_0_NFIT_GUID_NVDIMM_BLOCK_DATA_WINDOW_REGION                    { 0x91AF0530, 0x5D86, 0x470E, { 0xA6, 0xB0, 0x0A, 0x2D, 0xB9, 0x40, 0x82, 0x49 }}

+#define EFI_ACPI_6_0_NFIT_GUID_RAM_DISK_SUPPORTING_VIRTUAL_DISK_REGION_VOLATILE   { 0x77AB535A, 0x45FC, 0x624B, { 0x55, 0x60, 0xF7, 0xB2, 0x81, 0xD1, 0xF9, 0x6E }}

+#define EFI_ACPI_6_0_NFIT_GUID_RAM_DISK_SUPPORTING_VIRTUAL_CD_REGION_VOLATILE     { 0x3D5ABD30, 0x4175, 0x87CE, { 0x6D, 0x64, 0xD2, 0xAD, 0xE5, 0x23, 0xC4, 0xBB }}

+#define EFI_ACPI_6_0_NFIT_GUID_RAM_DISK_SUPPORTING_VIRTUAL_DISK_REGION_PERSISTENT { 0x5CEA02C9, 0x4D07, 0x69D3, { 0x26, 0x9F ,0x44, 0x96, 0xFB, 0xE0, 0x96, 0xF9 }}

+#define EFI_ACPI_6_0_NFIT_GUID_RAM_DISK_SUPPORTING_VIRTUAL_CD_REGION_PERSISTENT   { 0x08018188, 0x42CD, 0xBB48, { 0x10, 0x0F, 0x53, 0x87, 0xD5, 0x3D, 0xED, 0x3D }}

+typedef struct {

+  UINT16                                      Type;

+  UINT16                                      Length;

+  UINT16                                      SPARangeStructureIndex;

+  UINT16                                      Flags;

+  UINT32                                      Reserved_8;

+  UINT32                                      ProximityDomain;

+  GUID                                        AddressRangeTypeGUID;

+  UINT64                                      SystemPhysicalAddressRangeBase;

+  UINT64                                      SystemPhysicalAddressRangeLength;

+  UINT64                                      AddressRangeMemoryMappingAttribute;

+} EFI_ACPI_6_0_NFIT_SYSTEM_PHYSICAL_ADDRESS_RANGE_STRUCTURE;

+

+//

+// Definition for Memory Device to System Physical Address Range Mapping Structure

+//

+typedef struct {

+  UINT32                                      DIMMNumber:4;

+  UINT32                                      MemoryChannelNumber:4;

+  UINT32                                      MemoryControllerID:4;

+  UINT32                                      SocketID:4;

+  UINT32                                      NodeControllerID:12;

+  UINT32                                      Reserved_28:4;

+} EFI_ACPI_6_0_NFIT_DEVICE_HANDLE;

+

+#define EFI_ACPI_6_0_NFIT_MEMORY_DEVICE_STATE_FLAGS_PREVIOUS_SAVE_FAIL                                      BIT0

+#define EFI_ACPI_6_0_NFIT_MEMORY_DEVICE_STATE_FLAGS_LAST_RESTORE_FAIL                                       BIT1

+#define EFI_ACPI_6_0_NFIT_MEMORY_DEVICE_STATE_FLAGS_PLATFORM_FLUSH_FAIL                                     BIT2

+#define EFI_ACPI_6_0_NFIT_MEMORY_DEVICE_STATE_FLAGS_NOT_ARMED_PRIOR_TO_OSPM_HAND_OFF                        BIT3

+#define EFI_ACPI_6_0_NFIT_MEMORY_DEVICE_STATE_FLAGS_SMART_HEALTH_EVENTS_PRIOR_OSPM_HAND_OFF                 BIT4

+#define EFI_ACPI_6_0_NFIT_MEMORY_DEVICE_STATE_FLAGS_FIRMWARE_ENABLED_TO_NOTIFY_OSPM_ON_SMART_HEALTH_EVENTS  BIT5

+typedef struct {

+  UINT16                                      Type;

+  UINT16                                      Length;

+  EFI_ACPI_6_0_NFIT_DEVICE_HANDLE             NFITDeviceHandle;

+  UINT16                                      MemoryDevicePhysicalID;

+  UINT16                                      MemoryDeviceRegionID;

+  UINT16                                      SPARangeStructureIndex ;

+  UINT16                                      NVDIMMControlRegionStructureIndex;

+  UINT64                                      MemoryDeviceRegionSize;

+  UINT64                                      RegionOffset;

+  UINT64                                      MemoryDevicePhysicalAddressRegionBase;

+  UINT16                                      InterleaveStructureIndex;

+  UINT16                                      InterleaveWays;

+  UINT16                                      MemoryDeviceStateFlags;

+  UINT16                                      Reserved_46;

+} EFI_ACPI_6_0_NFIT_MEMORY_DEVICE_TO_SYSTEM_ADDRESS_RANGE_MAP_STRUCTURE;

+

+//

+// Definition for Interleave Structure

+//

+typedef struct {

+  UINT16                                      Type;

+  UINT16                                      Length;

+  UINT16                                      InterleaveStructureIndex;

+  UINT16                                      Reserved_6;

+  UINT32                                      NumberOfLines;

+  UINT32                                      LineSize;

+//UINT32                                      LineOffset[NumberOfLines];

+} EFI_ACPI_6_0_NFIT_INTERLEAVE_STRUCTURE;

+

+//

+// Definition for SMBIOS Management Information Structure

+//

+typedef struct {

+  UINT16                                      Type;

+  UINT16                                      Length;

+  UINT32                                      Reserved_4;

+//UINT8                                       Data[];

+} EFI_ACPI_6_0_NFIT_SMBIOS_MANAGEMENT_INFORMATION_STRUCTURE;

+

+//

+// Definition for NVDIMM Control Region Structure

+//

+#define EFI_ACPI_6_0_NFIT_NVDIMM_CONTROL_REGION_FLAGS_BLOCK_DATA_WINDOWS_BUFFERED    BIT0

+typedef struct {

+  UINT16                                      Type;

+  UINT16                                      Length;

+  UINT16                                      NVDIMMControlRegionStructureIndex;

+  UINT16                                      VendorID;

+  UINT16                                      DeviceID;

+  UINT16                                      RevisionID;

+  UINT16                                      SubsystemVendorID;

+  UINT16                                      SubsystemDeviceID;

+  UINT16                                      SubsystemRevisionID;

+  UINT8                                       Reserved_18[6];

+  UINT32                                      SerialNumber;

+  UINT16                                      RegionFormatInterfaceCode;

+  UINT16                                      NumberOfBlockControlWindows;

+  UINT64                                      SizeOfBlockControlWindow;

+  UINT64                                      CommandRegisterOffsetInBlockControlWindow;

+  UINT64                                      SizeOfCommandRegisterInBlockControlWindows;

+  UINT64                                      StatusRegisterOffsetInBlockControlWindow;

+  UINT64                                      SizeOfStatusRegisterInBlockControlWindows;

+  UINT16                                      NVDIMMControlRegionFlag;

+  UINT8                                       Reserved_74[6];

+} EFI_ACPI_6_0_NFIT_NVDIMM_CONTROL_REGION_STRUCTURE;

+

+//

+// Definition for NVDIMM Block Data Window Region Structure

+//

+typedef struct {

+  UINT16                                      Type;

+  UINT16                                      Length;

+  UINT16                                      NVDIMMControlRegionStructureIndex;

+  UINT16                                      NumberOfBlockDataWindows;

+  UINT64                                      BlockDataWindowStartOffset;

+  UINT64                                      SizeOfBlockDataWindow;

+  UINT64                                      BlockAccessibleMemoryCapacity;

+  UINT64                                      BeginningAddressOfFirstBlockInBlockAccessibleMemory;

+} EFI_ACPI_6_0_NFIT_NVDIMM_BLOCK_DATA_WINDOW_REGION_STRUCTURE;

+

+//

+// Definition for Flush Hint Address Structure

+//

+typedef struct {

+  UINT16                                      Type;

+  UINT16                                      Length;

+  EFI_ACPI_6_0_NFIT_DEVICE_HANDLE             NFITDeviceHandle;

+  UINT16                                      NumberOfFlushHintAddresses;

+  UINT8                                       Reserved_10[6];

+//UINT64                                      FlushHintAddress[NumberOfFlushHintAddresses];

+} EFI_ACPI_6_0_NFIT_FLUSH_HINT_ADDRESS_STRUCTURE;

+

+///

+/// Boot Error Record Table (BERT)

+///

+typedef struct {

+  EFI_ACPI_DESCRIPTION_HEADER Header;

+  UINT32                      BootErrorRegionLength;

+  UINT64                      BootErrorRegion;

+} EFI_ACPI_6_0_BOOT_ERROR_RECORD_TABLE_HEADER;

+

+///

+/// BERT Version (as defined in ACPI 6.0 spec.)

+///

+#define EFI_ACPI_6_0_BOOT_ERROR_RECORD_TABLE_REVISION 0x01

+

+///

+/// Boot Error Region Block Status Definition

+///

+typedef struct {

+  UINT32       UncorrectableErrorValid:1;

+  UINT32       CorrectableErrorValid:1;

+  UINT32       MultipleUncorrectableErrors:1;

+  UINT32       MultipleCorrectableErrors:1;

+  UINT32       ErrorDataEntryCount:10;

+  UINT32       Reserved:18;

+} EFI_ACPI_6_0_ERROR_BLOCK_STATUS;

+

+///

+/// Boot Error Region Definition

+///

+typedef struct {

+  EFI_ACPI_6_0_ERROR_BLOCK_STATUS              BlockStatus;

+  UINT32                                       RawDataOffset;

+  UINT32                                       RawDataLength;

+  UINT32                                       DataLength;

+  UINT32                                       ErrorSeverity;

+} EFI_ACPI_6_0_BOOT_ERROR_REGION_STRUCTURE;

+

+//

+// Boot Error Severity types

+//

+#define EFI_ACPI_6_0_ERROR_SEVERITY_CORRECTABLE  0x00

+#define EFI_ACPI_6_0_ERROR_SEVERITY_FATAL        0x01

+#define EFI_ACPI_6_0_ERROR_SEVERITY_CORRECTED    0x02

+#define EFI_ACPI_6_0_ERROR_SEVERITY_NONE         0x03

+

+///

+/// Generic Error Data Entry Definition

+///

+typedef struct {

+  UINT8    SectionType[16];

+  UINT32   ErrorSeverity;

+  UINT16   Revision;

+  UINT8    ValidationBits;

+  UINT8    Flags;

+  UINT32   ErrorDataLength;

+  UINT8    FruId[16];

+  UINT8    FruText[20];

+} EFI_ACPI_6_0_GENERIC_ERROR_DATA_ENTRY_STRUCTURE;

+

+///

+/// Generic Error Data Entry Version (as defined in ACPI 6.0 spec.)

+///

+#define EFI_ACPI_6_0_GENERIC_ERROR_DATA_ENTRY_REVISION  0x0201

+

+///

+/// HEST - Hardware Error Source Table

+///

+typedef struct {

+  EFI_ACPI_DESCRIPTION_HEADER Header;

+  UINT32                      ErrorSourceCount;

+} EFI_ACPI_6_0_HARDWARE_ERROR_SOURCE_TABLE_HEADER;

+

+///

+/// HEST Version (as defined in ACPI 6.0 spec.)

+///

+#define EFI_ACPI_6_0_HARDWARE_ERROR_SOURCE_TABLE_REVISION 0x01

+

+//

+// Error Source structure types.

+//

+#define EFI_ACPI_6_0_IA32_ARCHITECTURE_MACHINE_CHECK_EXCEPTION  0x00

+#define EFI_ACPI_6_0_IA32_ARCHITECTURE_CORRECTED_MACHINE_CHECK  0x01

+#define EFI_ACPI_6_0_IA32_ARCHITECTURE_NMI_ERROR                0x02

+#define EFI_ACPI_6_0_PCI_EXPRESS_ROOT_PORT_AER                  0x06

+#define EFI_ACPI_6_0_PCI_EXPRESS_DEVICE_AER                     0x07

+#define EFI_ACPI_6_0_PCI_EXPRESS_BRIDGE_AER                     0x08

+#define EFI_ACPI_6_0_GENERIC_HARDWARE_ERROR                     0x09

+

+//

+// Error Source structure flags.

+//

+#define EFI_ACPI_6_0_ERROR_SOURCE_FLAG_FIRMWARE_FIRST       (1 << 0)

+#define EFI_ACPI_6_0_ERROR_SOURCE_FLAG_GLOBAL               (1 << 1)

+

+///

+/// IA-32 Architecture Machine Check Exception Structure Definition

+///

+typedef struct {

+  UINT16  Type;

+  UINT16  SourceId;

+  UINT8   Reserved0[2];

+  UINT8   Flags;

+  UINT8   Enabled;

+  UINT32  NumberOfRecordsToPreAllocate;

+  UINT32  MaxSectionsPerRecord;

+  UINT64  GlobalCapabilityInitData;

+  UINT64  GlobalControlInitData;

+  UINT8   NumberOfHardwareBanks;

+  UINT8   Reserved1[7];

+} EFI_ACPI_6_0_IA32_ARCHITECTURE_MACHINE_CHECK_EXCEPTION_STRUCTURE;

+

+///

+/// IA-32 Architecture Machine Check Bank Structure Definition

+///

+typedef struct {

+  UINT8   BankNumber;

+  UINT8   ClearStatusOnInitialization;

+  UINT8   StatusDataFormat;

+  UINT8   Reserved0;

+  UINT32  ControlRegisterMsrAddress;

+  UINT64  ControlInitData;

+  UINT32  StatusRegisterMsrAddress;

+  UINT32  AddressRegisterMsrAddress;

+  UINT32  MiscRegisterMsrAddress;

+} EFI_ACPI_6_0_IA32_ARCHITECTURE_MACHINE_CHECK_ERROR_BANK_STRUCTURE;

+

+///

+/// IA-32 Architecture Machine Check Bank Structure MCA data format

+///

+#define EFI_ACPI_6_0_IA32_ARCHITECTURE_MACHINE_CHECK_ERROR_DATA_FORMAT_IA32      0x00

+#define EFI_ACPI_6_0_IA32_ARCHITECTURE_MACHINE_CHECK_ERROR_DATA_FORMAT_INTEL64   0x01

+#define EFI_ACPI_6_0_IA32_ARCHITECTURE_MACHINE_CHECK_ERROR_DATA_FORMAT_AMD64     0x02

+

+//

+// Hardware Error Notification types. All other values are reserved

+//

+#define EFI_ACPI_6_0_HARDWARE_ERROR_NOTIFICATION_POLLED                0x00

+#define EFI_ACPI_6_0_HARDWARE_ERROR_NOTIFICATION_EXTERNAL_INTERRUPT    0x01

+#define EFI_ACPI_6_0_HARDWARE_ERROR_NOTIFICATION_LOCAL_INTERRUPT       0x02

+#define EFI_ACPI_6_0_HARDWARE_ERROR_NOTIFICATION_SCI                   0x03

+#define EFI_ACPI_6_0_HARDWARE_ERROR_NOTIFICATION_NMI                   0x04

+#define EFI_ACPI_6_0_HARDWARE_ERROR_NOTIFICATION_CMCI                  0x05

+#define EFI_ACPI_6_0_HARDWARE_ERROR_NOTIFICATION_MCE                   0x06

+#define EFI_ACPI_6_0_HARDWARE_ERROR_NOTIFICATION_GPIO_SIGNAL           0x07

+

+///

+/// Hardware Error Notification Configuration Write Enable Structure Definition

+///

+typedef struct {

+  UINT16    Type:1;

+  UINT16    PollInterval:1;

+  UINT16    SwitchToPollingThresholdValue:1;

+  UINT16    SwitchToPollingThresholdWindow:1;

+  UINT16    ErrorThresholdValue:1;

+  UINT16    ErrorThresholdWindow:1;

+  UINT16    Reserved:10;

+} EFI_ACPI_6_0_HARDWARE_ERROR_NOTIFICATION_CONFIGURATION_WRITE_ENABLE_STRUCTURE;

+

+///

+/// Hardware Error Notification Structure Definition

+///

+typedef struct {

+  UINT8                                                                          Type;

+  UINT8                                                                          Length;

+  EFI_ACPI_6_0_HARDWARE_ERROR_NOTIFICATION_CONFIGURATION_WRITE_ENABLE_STRUCTURE  ConfigurationWriteEnable;

+  UINT32                                                                         PollInterval;

+  UINT32                                                                         Vector;

+  UINT32                                                                         SwitchToPollingThresholdValue;

+  UINT32                                                                         SwitchToPollingThresholdWindow;

+  UINT32                                                                         ErrorThresholdValue;

+  UINT32                                                                         ErrorThresholdWindow;

+} EFI_ACPI_6_0_HARDWARE_ERROR_NOTIFICATION_STRUCTURE;

+

+///

+/// IA-32 Architecture Corrected Machine Check Structure Definition

+///

+typedef struct {

+  UINT16                                                 Type;

+  UINT16                                                 SourceId;

+  UINT8                                                  Reserved0[2];

+  UINT8                                                  Flags;

+  UINT8                                                  Enabled;

+  UINT32                                                 NumberOfRecordsToPreAllocate;

+  UINT32                                                 MaxSectionsPerRecord;

+  EFI_ACPI_6_0_HARDWARE_ERROR_NOTIFICATION_STRUCTURE     NotificationStructure;

+  UINT8                                                  NumberOfHardwareBanks;

+  UINT8                                                  Reserved1[3];

+} EFI_ACPI_6_0_IA32_ARCHITECTURE_CORRECTED_MACHINE_CHECK_STRUCTURE;

+

+///

+/// IA-32 Architecture NMI Error Structure Definition

+///

+typedef struct {

+  UINT16  Type;

+  UINT16  SourceId;

+  UINT8   Reserved0[2];

+  UINT32  NumberOfRecordsToPreAllocate;

+  UINT32  MaxSectionsPerRecord;

+  UINT32  MaxRawDataLength;

+} EFI_ACPI_6_0_IA32_ARCHITECTURE_NMI_ERROR_STRUCTURE;

+

+///

+/// PCI Express Root Port AER Structure Definition

+///

+typedef struct {

+  UINT16  Type;

+  UINT16  SourceId;

+  UINT8   Reserved0[2];

+  UINT8   Flags;

+  UINT8   Enabled;

+  UINT32  NumberOfRecordsToPreAllocate;

+  UINT32  MaxSectionsPerRecord;

+  UINT32  Bus;

+  UINT16  Device;

+  UINT16  Function;

+  UINT16  DeviceControl;

+  UINT8   Reserved1[2];

+  UINT32  UncorrectableErrorMask;

+  UINT32  UncorrectableErrorSeverity;

+  UINT32  CorrectableErrorMask;

+  UINT32  AdvancedErrorCapabilitiesAndControl;

+  UINT32  RootErrorCommand;

+} EFI_ACPI_6_0_PCI_EXPRESS_ROOT_PORT_AER_STRUCTURE;

+

+///

+/// PCI Express Device AER Structure Definition

+///

+typedef struct {

+  UINT16  Type;

+  UINT16  SourceId;

+  UINT8   Reserved0[2];

+  UINT8   Flags;

+  UINT8   Enabled;

+  UINT32  NumberOfRecordsToPreAllocate;

+  UINT32  MaxSectionsPerRecord;

+  UINT32  Bus;

+  UINT16  Device;

+  UINT16  Function;

+  UINT16  DeviceControl;

+  UINT8   Reserved1[2];

+  UINT32  UncorrectableErrorMask;

+  UINT32  UncorrectableErrorSeverity;

+  UINT32  CorrectableErrorMask;

+  UINT32  AdvancedErrorCapabilitiesAndControl;

+} EFI_ACPI_6_0_PCI_EXPRESS_DEVICE_AER_STRUCTURE;

+

+///

+/// PCI Express Bridge AER Structure Definition

+///

+typedef struct {

+  UINT16  Type;

+  UINT16  SourceId;

+  UINT8   Reserved0[2];

+  UINT8   Flags;

+  UINT8   Enabled;

+  UINT32  NumberOfRecordsToPreAllocate;

+  UINT32  MaxSectionsPerRecord;

+  UINT32  Bus;

+  UINT16  Device;

+  UINT16  Function;

+  UINT16  DeviceControl;

+  UINT8   Reserved1[2];

+  UINT32  UncorrectableErrorMask;

+  UINT32  UncorrectableErrorSeverity;

+  UINT32  CorrectableErrorMask;

+  UINT32  AdvancedErrorCapabilitiesAndControl;

+  UINT32  SecondaryUncorrectableErrorMask;

+  UINT32  SecondaryUncorrectableErrorSeverity;

+  UINT32  SecondaryAdvancedErrorCapabilitiesAndControl;

+} EFI_ACPI_6_0_PCI_EXPRESS_BRIDGE_AER_STRUCTURE;

+

+///

+/// Generic Hardware Error Source Structure Definition

+///

+typedef struct {

+  UINT16                                                 Type;

+  UINT16                                                 SourceId;

+  UINT16                                                 RelatedSourceId;

+  UINT8                                                  Flags;

+  UINT8                                                  Enabled;

+  UINT32                                                 NumberOfRecordsToPreAllocate;

+  UINT32                                                 MaxSectionsPerRecord;

+  UINT32                                                 MaxRawDataLength;

+  EFI_ACPI_6_0_GENERIC_ADDRESS_STRUCTURE                 ErrorStatusAddress;

+  EFI_ACPI_6_0_HARDWARE_ERROR_NOTIFICATION_STRUCTURE     NotificationStructure;

+  UINT32                                                 ErrorStatusBlockLength;

+} EFI_ACPI_6_0_GENERIC_HARDWARE_ERROR_SOURCE_STRUCTURE;

+

+///

+/// Generic Error Status Definition

+///

+typedef struct {

+  EFI_ACPI_6_0_ERROR_BLOCK_STATUS              BlockStatus;

+  UINT32                                       RawDataOffset;

+  UINT32                                       RawDataLength;

+  UINT32                                       DataLength;

+  UINT32                                       ErrorSeverity;

+} EFI_ACPI_6_0_GENERIC_ERROR_STATUS_STRUCTURE;

+

+///

+/// ERST - Error Record Serialization Table

+///

+typedef struct {

+  EFI_ACPI_DESCRIPTION_HEADER Header;

+  UINT32                      SerializationHeaderSize;

+  UINT8                       Reserved0[4];

+  UINT32                      InstructionEntryCount;

+} EFI_ACPI_6_0_ERROR_RECORD_SERIALIZATION_TABLE_HEADER;

+

+///

+/// ERST Version (as defined in ACPI 6.0 spec.)

+///

+#define EFI_ACPI_6_0_ERROR_RECORD_SERIALIZATION_TABLE_REVISION 0x01

+

+///

+/// ERST Serialization Actions

+///

+#define EFI_ACPI_6_0_ERST_BEGIN_WRITE_OPERATION                    0x00

+#define EFI_ACPI_6_0_ERST_BEGIN_READ_OPERATION                     0x01

+#define EFI_ACPI_6_0_ERST_BEGIN_CLEAR_OPERATION                    0x02

+#define EFI_ACPI_6_0_ERST_END_OPERATION                            0x03

+#define EFI_ACPI_6_0_ERST_SET_RECORD_OFFSET                        0x04

+#define EFI_ACPI_6_0_ERST_EXECUTE_OPERATION                        0x05

+#define EFI_ACPI_6_0_ERST_CHECK_BUSY_STATUS                        0x06

+#define EFI_ACPI_6_0_ERST_GET_COMMAND_STATUS                       0x07

+#define EFI_ACPI_6_0_ERST_GET_RECORD_IDENTIFIER                    0x08

+#define EFI_ACPI_6_0_ERST_SET_RECORD_IDENTIFIER                    0x09

+#define EFI_ACPI_6_0_ERST_GET_RECORD_COUNT                         0x0A

+#define EFI_ACPI_6_0_ERST_BEGIN_DUMMY_WRITE_OPERATION              0x0B

+#define EFI_ACPI_6_0_ERST_GET_ERROR_LOG_ADDRESS_RANGE              0x0D

+#define EFI_ACPI_6_0_ERST_GET_ERROR_LOG_ADDRESS_RANGE_LENGTH       0x0E

+#define EFI_ACPI_6_0_ERST_GET_ERROR_LOG_ADDRESS_RANGE_ATTRIBUTES   0x0F

+

+///

+/// ERST Action Command Status

+///

+#define EFI_ACPI_6_0_ERST_STATUS_SUCCESS                           0x00

+#define EFI_ACPI_6_0_ERST_STATUS_NOT_ENOUGH_SPACE                  0x01

+#define EFI_ACPI_6_0_ERST_STATUS_HARDWARE_NOT_AVAILABLE            0x02

+#define EFI_ACPI_6_0_ERST_STATUS_FAILED                            0x03

+#define EFI_ACPI_6_0_ERST_STATUS_RECORD_STORE_EMPTY                0x04

+#define EFI_ACPI_6_0_ERST_STATUS_RECORD_NOT_FOUND                  0x05

+

+///

+/// ERST Serialization Instructions

+///

+#define EFI_ACPI_6_0_ERST_READ_REGISTER                            0x00

+#define EFI_ACPI_6_0_ERST_READ_REGISTER_VALUE                      0x01

+#define EFI_ACPI_6_0_ERST_WRITE_REGISTER                           0x02

+#define EFI_ACPI_6_0_ERST_WRITE_REGISTER_VALUE                     0x03

+#define EFI_ACPI_6_0_ERST_NOOP                                     0x04

+#define EFI_ACPI_6_0_ERST_LOAD_VAR1                                0x05

+#define EFI_ACPI_6_0_ERST_LOAD_VAR2                                0x06

+#define EFI_ACPI_6_0_ERST_STORE_VAR1                               0x07

+#define EFI_ACPI_6_0_ERST_ADD                                      0x08

+#define EFI_ACPI_6_0_ERST_SUBTRACT                                 0x09

+#define EFI_ACPI_6_0_ERST_ADD_VALUE                                0x0A

+#define EFI_ACPI_6_0_ERST_SUBTRACT_VALUE                           0x0B

+#define EFI_ACPI_6_0_ERST_STALL                                    0x0C

+#define EFI_ACPI_6_0_ERST_STALL_WHILE_TRUE                         0x0D

+#define EFI_ACPI_6_0_ERST_SKIP_NEXT_INSTRUCTION_IF_TRUE            0x0E

+#define EFI_ACPI_6_0_ERST_GOTO                                     0x0F

+#define EFI_ACPI_6_0_ERST_SET_SRC_ADDRESS_BASE                     0x10

+#define EFI_ACPI_6_0_ERST_SET_DST_ADDRESS_BASE                     0x11

+#define EFI_ACPI_6_0_ERST_MOVE_DATA                                0x12

+

+///

+/// ERST Instruction Flags

+///

+#define EFI_ACPI_6_0_ERST_PRESERVE_REGISTER                        0x01

+

+///

+/// ERST Serialization Instruction Entry

+///

+typedef struct {

+  UINT8                                    SerializationAction;

+  UINT8                                    Instruction;

+  UINT8                                    Flags;

+  UINT8                                    Reserved0;

+  EFI_ACPI_6_0_GENERIC_ADDRESS_STRUCTURE   RegisterRegion;

+  UINT64                                   Value;

+  UINT64                                   Mask;

+} EFI_ACPI_6_0_ERST_SERIALIZATION_INSTRUCTION_ENTRY;

+

+///

+/// EINJ - Error Injection Table

+///

+typedef struct {

+  EFI_ACPI_DESCRIPTION_HEADER Header;

+  UINT32                      InjectionHeaderSize;

+  UINT8                       InjectionFlags;

+  UINT8                       Reserved0[3];

+  UINT32                      InjectionEntryCount;

+} EFI_ACPI_6_0_ERROR_INJECTION_TABLE_HEADER;

+

+///

+/// EINJ Version (as defined in ACPI 6.0 spec.)

+///

+#define EFI_ACPI_6_0_ERROR_INJECTION_TABLE_REVISION 0x01

+

+///

+/// EINJ Error Injection Actions

+///

+#define EFI_ACPI_6_0_EINJ_BEGIN_INJECTION_OPERATION                0x00

+#define EFI_ACPI_6_0_EINJ_GET_TRIGGER_ERROR_ACTION_TABLE           0x01

+#define EFI_ACPI_6_0_EINJ_SET_ERROR_TYPE                           0x02

+#define EFI_ACPI_6_0_EINJ_GET_ERROR_TYPE                           0x03

+#define EFI_ACPI_6_0_EINJ_END_OPERATION                            0x04

+#define EFI_ACPI_6_0_EINJ_EXECUTE_OPERATION                        0x05

+#define EFI_ACPI_6_0_EINJ_CHECK_BUSY_STATUS                        0x06

+#define EFI_ACPI_6_0_EINJ_GET_COMMAND_STATUS                       0x07

+#define EFI_ACPI_6_0_EINJ_TRIGGER_ERROR                            0xFF

+

+///

+/// EINJ Action Command Status

+///

+#define EFI_ACPI_6_0_EINJ_STATUS_SUCCESS                           0x00

+#define EFI_ACPI_6_0_EINJ_STATUS_UNKNOWN_FAILURE                   0x01

+#define EFI_ACPI_6_0_EINJ_STATUS_INVALID_ACCESS                    0x02

+

+///

+/// EINJ Error Type Definition

+///

+#define EFI_ACPI_6_0_EINJ_ERROR_PROCESSOR_CORRECTABLE                 (1 << 0)

+#define EFI_ACPI_6_0_EINJ_ERROR_PROCESSOR_UNCORRECTABLE_NONFATAL      (1 << 1)

+#define EFI_ACPI_6_0_EINJ_ERROR_PROCESSOR_UNCORRECTABLE_FATAL         (1 << 2)

+#define EFI_ACPI_6_0_EINJ_ERROR_MEMORY_CORRECTABLE                    (1 << 3)

+#define EFI_ACPI_6_0_EINJ_ERROR_MEMORY_UNCORRECTABLE_NONFATAL         (1 << 4)

+#define EFI_ACPI_6_0_EINJ_ERROR_MEMORY_UNCORRECTABLE_FATAL            (1 << 5)

+#define EFI_ACPI_6_0_EINJ_ERROR_PCI_EXPRESS_CORRECTABLE               (1 << 6)

+#define EFI_ACPI_6_0_EINJ_ERROR_PCI_EXPRESS_UNCORRECTABLE_NONFATAL    (1 << 7)

+#define EFI_ACPI_6_0_EINJ_ERROR_PCI_EXPRESS_UNCORRECTABLE_FATAL       (1 << 8)

+#define EFI_ACPI_6_0_EINJ_ERROR_PLATFORM_CORRECTABLE                  (1 << 9)

+#define EFI_ACPI_6_0_EINJ_ERROR_PLATFORM_UNCORRECTABLE_NONFATAL       (1 << 10)

+#define EFI_ACPI_6_0_EINJ_ERROR_PLATFORM_UNCORRECTABLE_FATAL          (1 << 11)

+

+///

+/// EINJ Injection Instructions

+///

+#define EFI_ACPI_6_0_EINJ_READ_REGISTER                            0x00

+#define EFI_ACPI_6_0_EINJ_READ_REGISTER_VALUE                      0x01

+#define EFI_ACPI_6_0_EINJ_WRITE_REGISTER                           0x02

+#define EFI_ACPI_6_0_EINJ_WRITE_REGISTER_VALUE                     0x03

+#define EFI_ACPI_6_0_EINJ_NOOP                                     0x04

+

+///

+/// EINJ Instruction Flags

+///

+#define EFI_ACPI_6_0_EINJ_PRESERVE_REGISTER                        0x01

+

+///

+/// EINJ Injection Instruction Entry

+///

+typedef struct {

+  UINT8                                    InjectionAction;

+  UINT8                                    Instruction;

+  UINT8                                    Flags;

+  UINT8                                    Reserved0;

+  EFI_ACPI_6_0_GENERIC_ADDRESS_STRUCTURE   RegisterRegion;

+  UINT64                                   Value;

+  UINT64                                   Mask;

+} EFI_ACPI_6_0_EINJ_INJECTION_INSTRUCTION_ENTRY;

+

+///

+/// EINJ Trigger Action Table

+///

+typedef struct {

+  UINT32  HeaderSize;

+  UINT32  Revision;

+  UINT32  TableSize;

+  UINT32  EntryCount;

+} EFI_ACPI_6_0_EINJ_TRIGGER_ACTION_TABLE;

+

+///

+/// Platform Communications Channel Table (PCCT)

+///

+typedef struct {

+  EFI_ACPI_DESCRIPTION_HEADER Header;

+  UINT32                      Flags;

+  UINT64                      Reserved;

+} EFI_ACPI_6_0_PLATFORM_COMMUNICATION_CHANNEL_TABLE_HEADER;

+

+///

+/// PCCT Version (as defined in ACPI 6.0 spec.)

+///

+#define EFI_ACPI_6_0_PLATFORM_COMMUNICATION_CHANNEL_TABLE_REVISION 0x01

+

+///

+/// PCCT Global Flags

+///

+#define EFI_ACPI_6_0_PCCT_FLAGS_SCI_DOORBELL                      BIT0

+

+//

+// PCCT Subspace type

+//

+#define EFI_ACPI_6_0_PCCT_SUBSPACE_TYPE_GENERIC                         0x00

+#define EFI_ACPI_6_0_PCCT_SUBSPACE_TYPE_1_HW_REDUCED_COMMUNICATIONS     0x01

+#define EFI_ACPI_6_0_PCCT_SUBSPACE_TYPE_2_HW_REDUCED_COMMUNICATIONS     0x02

+

+///

+/// PCC Subspace Structure Header

+///

+typedef struct {

+  UINT8        Type;

+  UINT8        Length;

+} EFI_ACPI_6_0_PCCT_SUBSPACE_HEADER;

+

+///

+/// Generic Communications Subspace Structure

+///

+typedef struct {

+  UINT8                                    Type;

+  UINT8                                    Length;

+  UINT8                                    Reserved[6];

+  UINT64                                   BaseAddress;

+  UINT64                                   AddressLength;

+  EFI_ACPI_6_0_GENERIC_ADDRESS_STRUCTURE   DoorbellRegister;

+  UINT64                                   DoorbellPreserve;

+  UINT64                                   DoorbellWrite;

+  UINT32                                   NominalLatency;

+  UINT32                                   MaximumPeriodicAccessRate;

+  UINT16                                   MinimumRequestTurnaroundTime;

+} EFI_ACPI_6_0_PCCT_SUBSPACE_GENERIC;

+

+///

+/// Generic Communications Channel Shared Memory Region

+///

+

+typedef struct {

+  UINT8                                    Command;

+  UINT8                                    Reserved:7;

+  UINT8                                    GenerateSci:1;

+} EFI_ACPI_6_0_PCCT_GENERIC_SHARED_MEMORY_REGION_COMMAND;

+

+typedef struct {

+  UINT8                                    CommandComplete:1;

+  UINT8                                    SciDoorbell:1;

+  UINT8                                    Error:1;

+  UINT8                                    PlatformNotification:1;

+  UINT8                                    Reserved:4;

+  UINT8                                    Reserved1;

+} EFI_ACPI_6_0_PCCT_GENERIC_SHARED_MEMORY_REGION_STATUS;

+

+typedef struct {

+  UINT32                                                    Signature;

+  EFI_ACPI_6_0_PCCT_GENERIC_SHARED_MEMORY_REGION_COMMAND    Command;

+  EFI_ACPI_6_0_PCCT_GENERIC_SHARED_MEMORY_REGION_STATUS     Status;

+} EFI_ACPI_6_0_PCCT_GENERIC_SHARED_MEMORY_REGION_HEADER;

+

+#define EFI_ACPI_6_0_PCCT_SUBSPACE_DOORBELL_INTERRUPT_FLAGS_POLARITY    BIT0

+#define EFI_ACPI_6_0_PCCT_SUBSPACE_DOORBELL_INTERRUPT_FLAGS_MODE        BIT1

+

+///

+/// Type 1 HW-Reduced Communications Subspace Structure

+///

+typedef struct {

+  UINT8                                    Type;

+  UINT8                                    Length;

+  UINT32                                   DoorbellInterrupt;

+  UINT8                                    DoorbellInterruptFlags;

+  UINT8                                    Reserved;

+  UINT64                                   BaseAddress;

+  UINT64                                   AddressLength;

+  EFI_ACPI_6_0_GENERIC_ADDRESS_STRUCTURE   DoorbellRegister;

+  UINT64                                   DoorbellPreserve;

+  UINT64                                   DoorbellWrite;

+  UINT32                                   NominalLatency;

+  UINT32                                   MaximumPeriodicAccessRate;

+  UINT16                                   MinimumRequestTurnaroundTime;

+} EFI_ACPI_6_0_PCCT_SUBSPACE_1_HW_REDUCED_COMMUNICATIONS;

+

+///

+/// Type 2 HW-Reduced Communications Subspace Structure

+///

+typedef struct {

+  UINT8                                    Type;

+  UINT8                                    Length;

+  UINT32                                   DoorbellInterrupt;

+  UINT8                                    DoorbellInterruptFlags;

+  UINT8                                    Reserved;

+  UINT64                                   BaseAddress;

+  UINT64                                   AddressLength;

+  EFI_ACPI_6_0_GENERIC_ADDRESS_STRUCTURE   DoorbellRegister;

+  UINT64                                   DoorbellPreserve;

+  UINT64                                   DoorbellWrite;

+  UINT32                                   NominalLatency;

+  UINT32                                   MaximumPeriodicAccessRate;

+  UINT16                                   MinimumRequestTurnaroundTime;

+  EFI_ACPI_6_0_GENERIC_ADDRESS_STRUCTURE   DoorbellAckRegister;

+  UINT64                                   DoorbellAckPreserve;

+  UINT64                                   DoorbellAckWrite;

+} EFI_ACPI_6_0_PCCT_SUBSPACE_2_HW_REDUCED_COMMUNICATIONS;

+

+//

+// Known table signatures

+//

+

+///

+/// "RSD PTR " Root System Description Pointer

+///

+#define EFI_ACPI_6_0_ROOT_SYSTEM_DESCRIPTION_POINTER_SIGNATURE  SIGNATURE_64('R', 'S', 'D', ' ', 'P', 'T', 'R', ' ')

+

+///

+/// "APIC" Multiple APIC Description Table

+///

+#define EFI_ACPI_6_0_MULTIPLE_APIC_DESCRIPTION_TABLE_SIGNATURE  SIGNATURE_32('A', 'P', 'I', 'C')

+

+///

+/// "BERT" Boot Error Record Table

+///

+#define EFI_ACPI_6_0_BOOT_ERROR_RECORD_TABLE_SIGNATURE  SIGNATURE_32('B', 'E', 'R', 'T')

+

+///

+/// "BGRT" Boot Graphics Resource Table

+///

+#define EFI_ACPI_6_0_BOOT_GRAPHICS_RESOURCE_TABLE_SIGNATURE  SIGNATURE_32('B', 'G', 'R', 'T')

+

+///

+/// "CPEP" Corrected Platform Error Polling Table

+///

+#define EFI_ACPI_6_0_CORRECTED_PLATFORM_ERROR_POLLING_TABLE_SIGNATURE  SIGNATURE_32('C', 'P', 'E', 'P')

+

+///

+/// "DSDT" Differentiated System Description Table

+///

+#define EFI_ACPI_6_0_DIFFERENTIATED_SYSTEM_DESCRIPTION_TABLE_SIGNATURE  SIGNATURE_32('D', 'S', 'D', 'T')

+

+///

+/// "ECDT" Embedded Controller Boot Resources Table

+///

+#define EFI_ACPI_6_0_EMBEDDED_CONTROLLER_BOOT_RESOURCES_TABLE_SIGNATURE  SIGNATURE_32('E', 'C', 'D', 'T')

+

+///

+/// "EINJ" Error Injection Table

+///

+#define EFI_ACPI_6_0_ERROR_INJECTION_TABLE_SIGNATURE  SIGNATURE_32('E', 'I', 'N', 'J')

+

+///

+/// "ERST" Error Record Serialization Table

+///

+#define EFI_ACPI_6_0_ERROR_RECORD_SERIALIZATION_TABLE_SIGNATURE  SIGNATURE_32('E', 'R', 'S', 'T')

+

+///

+/// "FACP" Fixed ACPI Description Table

+///

+#define EFI_ACPI_6_0_FIXED_ACPI_DESCRIPTION_TABLE_SIGNATURE  SIGNATURE_32('F', 'A', 'C', 'P')

+

+///

+/// "FACS" Firmware ACPI Control Structure

+///

+#define EFI_ACPI_6_0_FIRMWARE_ACPI_CONTROL_STRUCTURE_SIGNATURE  SIGNATURE_32('F', 'A', 'C', 'S')

+

+///

+/// "FPDT" Firmware Performance Data Table

+///

+#define EFI_ACPI_6_0_FIRMWARE_PERFORMANCE_DATA_TABLE_SIGNATURE  SIGNATURE_32('F', 'P', 'D', 'T')

+

+///

+/// "GTDT" Generic Timer Description Table

+///

+#define EFI_ACPI_6_0_GENERIC_TIMER_DESCRIPTION_TABLE_SIGNATURE  SIGNATURE_32('G', 'T', 'D', 'T')

+

+///

+/// "HEST" Hardware Error Source Table

+///

+#define EFI_ACPI_6_0_HARDWARE_ERROR_SOURCE_TABLE_SIGNATURE  SIGNATURE_32('H', 'E', 'S', 'T')

+

+///

+/// "MPST" Memory Power State Table

+///

+#define EFI_ACPI_6_0_MEMORY_POWER_STATE_TABLE_SIGNATURE  SIGNATURE_32('M', 'P', 'S', 'T')

+

+///

+/// "MSCT" Maximum System Characteristics Table

+///

+#define EFI_ACPI_6_0_MAXIMUM_SYSTEM_CHARACTERISTICS_TABLE_SIGNATURE  SIGNATURE_32('M', 'S', 'C', 'T')

+

+///

+/// "NFIT" NVDIMM Firmware Interface Table

+///

+#define EFI_ACPI_6_0_NVDIMM_FIRMWARE_INTERFACE_TABLE_STRUCTURE_SIGNATURE  SIGNATURE_32('N', 'F', 'I', 'T')

+

+///

+/// "PMTT" Platform Memory Topology Table

+///

+#define EFI_ACPI_6_0_PLATFORM_MEMORY_TOPOLOGY_TABLE_SIGNATURE  SIGNATURE_32('P', 'M', 'T', 'T')

+

+///

+/// "PSDT" Persistent System Description Table

+///

+#define EFI_ACPI_6_0_PERSISTENT_SYSTEM_DESCRIPTION_TABLE_SIGNATURE  SIGNATURE_32('P', 'S', 'D', 'T')

+

+///

+/// "RASF" ACPI RAS Feature Table

+///

+#define EFI_ACPI_6_0_ACPI_RAS_FEATURE_TABLE_SIGNATURE  SIGNATURE_32('R', 'A', 'S', 'F')

+

+///

+/// "RSDT" Root System Description Table

+///

+#define EFI_ACPI_6_0_ROOT_SYSTEM_DESCRIPTION_TABLE_SIGNATURE  SIGNATURE_32('R', 'S', 'D', 'T')

+

+///

+/// "SBST" Smart Battery Specification Table

+///

+#define EFI_ACPI_6_0_SMART_BATTERY_SPECIFICATION_TABLE_SIGNATURE  SIGNATURE_32('S', 'B', 'S', 'T')

+

+///

+/// "SLIT" System Locality Information Table

+///

+#define EFI_ACPI_6_0_SYSTEM_LOCALITY_INFORMATION_TABLE_SIGNATURE  SIGNATURE_32('S', 'L', 'I', 'T')

+

+///

+/// "SRAT" System Resource Affinity Table

+///

+#define EFI_ACPI_6_0_SYSTEM_RESOURCE_AFFINITY_TABLE_SIGNATURE  SIGNATURE_32('S', 'R', 'A', 'T')

+

+///

+/// "SSDT" Secondary System Description Table

+///

+#define EFI_ACPI_6_0_SECONDARY_SYSTEM_DESCRIPTION_TABLE_SIGNATURE  SIGNATURE_32('S', 'S', 'D', 'T')

+

+///

+/// "XSDT" Extended System Description Table

+///

+#define EFI_ACPI_6_0_EXTENDED_SYSTEM_DESCRIPTION_TABLE_SIGNATURE  SIGNATURE_32('X', 'S', 'D', 'T')

+

+///

+/// "BOOT" MS Simple Boot Spec

+///

+#define EFI_ACPI_6_0_SIMPLE_BOOT_FLAG_TABLE_SIGNATURE  SIGNATURE_32('B', 'O', 'O', 'T')

+

+///

+/// "CSRT" MS Core System Resource Table

+///

+#define EFI_ACPI_6_0_CORE_SYSTEM_RESOURCE_TABLE_SIGNATURE  SIGNATURE_32('C', 'S', 'R', 'T')

+

+///

+/// "DBG2" MS Debug Port 2 Spec

+///

+#define EFI_ACPI_6_0_DEBUG_PORT_2_TABLE_SIGNATURE  SIGNATURE_32('D', 'B', 'G', '2')

+

+///

+/// "DBGP" MS Debug Port Spec

+///

+#define EFI_ACPI_6_0_DEBUG_PORT_TABLE_SIGNATURE  SIGNATURE_32('D', 'B', 'G', 'P')

+

+///

+/// "DMAR" DMA Remapping Table

+///

+#define EFI_ACPI_6_0_DMA_REMAPPING_TABLE_SIGNATURE  SIGNATURE_32('D', 'M', 'A', 'R')

+

+///

+/// "DRTM" Dynamic Root of Trust for Measurement Table

+///

+#define EFI_ACPI_6_0_DYNAMIC_ROOT_OF_TRUST_FOR_MEASUREMENT_TABLE_SIGNATURE  SIGNATURE_32('D', 'R', 'T', 'M')

+

+///

+/// "ETDT" Event Timer Description Table

+///

+#define EFI_ACPI_6_0_EVENT_TIMER_DESCRIPTION_TABLE_SIGNATURE  SIGNATURE_32('E', 'T', 'D', 'T')

+

+///

+/// "HPET" IA-PC High Precision Event Timer Table

+///

+#define EFI_ACPI_6_0_HIGH_PRECISION_EVENT_TIMER_TABLE_SIGNATURE  SIGNATURE_32('H', 'P', 'E', 'T')

+

+///

+/// "iBFT" iSCSI Boot Firmware Table

+///

+#define EFI_ACPI_6_0_ISCSI_BOOT_FIRMWARE_TABLE_SIGNATURE  SIGNATURE_32('i', 'B', 'F', 'T')

+

+///

+/// "IORT" I/O Remapping Table

+///

+#define EFI_ACPI_6_0_IO_REMAPPING_TABLE_SIGNATURE  SIGNATURE_32('I', 'O', 'R', 'T')

+

+///

+/// "IVRS" I/O Virtualization Reporting Structure

+///

+#define EFI_ACPI_6_0_IO_VIRTUALIZATION_REPORTING_STRUCTURE_SIGNATURE  SIGNATURE_32('I', 'V', 'R', 'S')

+

+///

+/// "LPIT" Low Power Idle Table

+///

+#define EFI_ACPI_6_0_LOW_POWER_IDLE_TABLE_STRUCTURE_SIGNATURE  SIGNATURE_32('L', 'P', 'I', 'T')

+

+///

+/// "MCFG" PCI Express Memory Mapped Configuration Space Base Address Description Table

+///

+#define EFI_ACPI_6_0_PCI_EXPRESS_MEMORY_MAPPED_CONFIGURATION_SPACE_BASE_ADDRESS_DESCRIPTION_TABLE_SIGNATURE  SIGNATURE_32('M', 'C', 'F', 'G')

+

+///

+/// "MCHI" Management Controller Host Interface Table

+///

+#define EFI_ACPI_6_0_MANAGEMENT_CONTROLLER_HOST_INTERFACE_TABLE_SIGNATURE  SIGNATURE_32('M', 'C', 'H', 'I')

+

+///

+/// "MSDM" MS Data Management Table

+///

+#define EFI_ACPI_6_0_DATA_MANAGEMENT_TABLE_SIGNATURE  SIGNATURE_32('M', 'S', 'D', 'M')

+

+///

+/// "PCCT" Platform Communications Channel Table

+///

+#define EFI_ACPI_6_0_PLATFORM_COMMUNICATIONS_CHANNEL_TABLE_SIGNATURE  SIGNATURE_32('P', 'C', 'C', 'T')

+

+///

+/// "SLIC" MS Software Licensing Table Specification

+///

+#define EFI_ACPI_6_0_SOFTWARE_LICENSING_TABLE_SIGNATURE  SIGNATURE_32('S', 'L', 'I', 'C')

+

+///

+/// "SPCR" Serial Port Console Redirection Table

+///

+#define EFI_ACPI_6_0_SERIAL_PORT_CONSOLE_REDIRECTION_TABLE_SIGNATURE  SIGNATURE_32('S', 'P', 'C', 'R')

+

+///

+/// "SPMI" Server Platform Management Interface Table

+///

+#define EFI_ACPI_6_0_SERVER_PLATFORM_MANAGEMENT_INTERFACE_TABLE_SIGNATURE  SIGNATURE_32('S', 'P', 'M', 'I')

+

+///

+/// "STAO" _STA Override Table

+///

+#define EFI_ACPI_6_0_STA_OVERRIDE_TABLE_SIGNATURE  SIGNATURE_32('S', 'T', 'A', 'O')

+

+///

+/// "TCPA" Trusted Computing Platform Alliance Capabilities Table

+///

+#define EFI_ACPI_6_0_TRUSTED_COMPUTING_PLATFORM_ALLIANCE_CAPABILITIES_TABLE_SIGNATURE  SIGNATURE_32('T', 'C', 'P', 'A')

+

+///

+/// "TPM2" Trusted Computing Platform 1 Table

+///

+#define EFI_ACPI_6_0_TRUSTED_COMPUTING_PLATFORM_2_TABLE_SIGNATURE  SIGNATURE_32('T', 'P', 'M', '2')

+

+///

+/// "UEFI" UEFI ACPI Data Table

+///

+#define EFI_ACPI_6_0_UEFI_ACPI_DATA_TABLE_SIGNATURE  SIGNATURE_32('U', 'E', 'F', 'I')

+

+///

+/// "WAET" Windows ACPI Emulated Devices Table

+///

+#define EFI_ACPI_6_0_WINDOWS_ACPI_EMULATED_DEVICES_TABLE_SIGNATURE  SIGNATURE_32('W', 'A', 'E', 'T')

+

+///

+/// "WDAT" Watchdog Action Table

+///

+#define EFI_ACPI_6_0_WATCHDOG_ACTION_TABLE_SIGNATURE  SIGNATURE_32('W', 'D', 'A', 'T')

+

+///

+/// "WDRT" Watchdog Resource Table

+///

+#define EFI_ACPI_6_0_WATCHDOG_RESOURCE_TABLE_SIGNATURE  SIGNATURE_32('W', 'D', 'R', 'T')

+

+///

+/// "WPBT" MS Platform Binary Table

+///

+#define EFI_ACPI_6_0_PLATFORM_BINARY_TABLE_SIGNATURE  SIGNATURE_32('W', 'P', 'B', 'T')

+

+///

+/// "XENV" Xen Project Table

+///

+#define EFI_ACPI_6_0_XEN_PROJECT_TABLE_SIGNATURE  SIGNATURE_32('X', 'E', 'N', 'V')

+

+#pragma pack()

+

+#endif

diff --git a/debugging_demo/memtest86+/efi/Include/IndustryStandard/Acpi61.h b/debugging_demo/memtest86+/efi/Include/IndustryStandard/Acpi61.h
new file mode 100644
index 0000000..8626833
--- /dev/null
+++ b/debugging_demo/memtest86+/efi/Include/IndustryStandard/Acpi61.h
@@ -0,0 +1,2424 @@
+/** @file

+  ACPI 6.1 definitions from the ACPI Specification Revision 6.1 January, 2016.

+

+  Copyright (c) 2016 - 2018, Intel Corporation. All rights reserved.<BR>

+ (C) Copyright 2016 Hewlett Packard Enterprise Development LP<BR>

+  Copyright (c) 2020, ARM Ltd. All rights reserved.<BR>

+  SPDX-License-Identifier: BSD-2-Clause-Patent

+**/

+

+#ifndef _ACPI_6_1_H_

+#define _ACPI_6_1_H_

+

+#include <IndustryStandard/Acpi60.h>

+

+//

+// Ensure proper structure formats

+//

+#pragma pack(1)

+

+///

+/// ACPI 6.1 Generic Address Space definition

+///

+typedef struct {

+  UINT8   AddressSpaceId;

+  UINT8   RegisterBitWidth;

+  UINT8   RegisterBitOffset;

+  UINT8   AccessSize;

+  UINT64  Address;

+} EFI_ACPI_6_1_GENERIC_ADDRESS_STRUCTURE;

+

+//

+// Generic Address Space Address IDs

+//

+#define EFI_ACPI_6_1_SYSTEM_MEMORY              0

+#define EFI_ACPI_6_1_SYSTEM_IO                  1

+#define EFI_ACPI_6_1_PCI_CONFIGURATION_SPACE    2

+#define EFI_ACPI_6_1_EMBEDDED_CONTROLLER        3

+#define EFI_ACPI_6_1_SMBUS                      4

+#define EFI_ACPI_6_1_PLATFORM_COMMUNICATION_CHANNEL  0x0A

+#define EFI_ACPI_6_1_FUNCTIONAL_FIXED_HARDWARE       0x7F

+

+//

+// Generic Address Space Access Sizes

+//

+#define EFI_ACPI_6_1_UNDEFINED  0

+#define EFI_ACPI_6_1_BYTE       1

+#define EFI_ACPI_6_1_WORD       2

+#define EFI_ACPI_6_1_DWORD      3

+#define EFI_ACPI_6_1_QWORD      4

+

+//

+// ACPI 6.1 table structures

+//

+

+///

+/// Root System Description Pointer Structure

+///

+typedef struct {

+  UINT64  Signature;

+  UINT8   Checksum;

+  UINT8   OemId[6];

+  UINT8   Revision;

+  UINT32  RsdtAddress;

+  UINT32  Length;

+  UINT64  XsdtAddress;

+  UINT8   ExtendedChecksum;

+  UINT8   Reserved[3];

+} EFI_ACPI_6_1_ROOT_SYSTEM_DESCRIPTION_POINTER;

+

+///

+/// RSD_PTR Revision (as defined in ACPI 6.1 spec.)

+///

+#define EFI_ACPI_6_1_ROOT_SYSTEM_DESCRIPTION_POINTER_REVISION 0x02  ///< ACPISpec (Revision 6.1) says current value is 2

+

+///

+/// Common table header, this prefaces all ACPI tables, including FACS, but

+/// excluding the RSD PTR structure

+///

+typedef struct {

+  UINT32  Signature;

+  UINT32  Length;

+} EFI_ACPI_6_1_COMMON_HEADER;

+

+//

+// Root System Description Table

+// No definition needed as it is a common description table header, the same with

+// EFI_ACPI_DESCRIPTION_HEADER, followed by a variable number of UINT32 table pointers.

+//

+

+///

+/// RSDT Revision (as defined in ACPI 6.1 spec.)

+///

+#define EFI_ACPI_6_1_ROOT_SYSTEM_DESCRIPTION_TABLE_REVISION 0x01

+

+//

+// Extended System Description Table

+// No definition needed as it is a common description table header, the same with

+// EFI_ACPI_DESCRIPTION_HEADER, followed by a variable number of UINT64 table pointers.

+//

+

+///

+/// XSDT Revision (as defined in ACPI 6.1 spec.)

+///

+#define EFI_ACPI_6_1_EXTENDED_SYSTEM_DESCRIPTION_TABLE_REVISION 0x01

+

+///

+/// Fixed ACPI Description Table Structure (FADT)

+///

+typedef struct {

+  EFI_ACPI_DESCRIPTION_HEADER             Header;

+  UINT32                                  FirmwareCtrl;

+  UINT32                                  Dsdt;

+  UINT8                                   Reserved0;

+  UINT8                                   PreferredPmProfile;

+  UINT16                                  SciInt;

+  UINT32                                  SmiCmd;

+  UINT8                                   AcpiEnable;

+  UINT8                                   AcpiDisable;

+  UINT8                                   S4BiosReq;

+  UINT8                                   PstateCnt;

+  UINT32                                  Pm1aEvtBlk;

+  UINT32                                  Pm1bEvtBlk;

+  UINT32                                  Pm1aCntBlk;

+  UINT32                                  Pm1bCntBlk;

+  UINT32                                  Pm2CntBlk;

+  UINT32                                  PmTmrBlk;

+  UINT32                                  Gpe0Blk;

+  UINT32                                  Gpe1Blk;

+  UINT8                                   Pm1EvtLen;

+  UINT8                                   Pm1CntLen;

+  UINT8                                   Pm2CntLen;

+  UINT8                                   PmTmrLen;

+  UINT8                                   Gpe0BlkLen;

+  UINT8                                   Gpe1BlkLen;

+  UINT8                                   Gpe1Base;

+  UINT8                                   CstCnt;

+  UINT16                                  PLvl2Lat;

+  UINT16                                  PLvl3Lat;

+  UINT16                                  FlushSize;

+  UINT16                                  FlushStride;

+  UINT8                                   DutyOffset;

+  UINT8                                   DutyWidth;

+  UINT8                                   DayAlrm;

+  UINT8                                   MonAlrm;

+  UINT8                                   Century;

+  UINT16                                  IaPcBootArch;

+  UINT8                                   Reserved1;

+  UINT32                                  Flags;

+  EFI_ACPI_6_1_GENERIC_ADDRESS_STRUCTURE  ResetReg;

+  UINT8                                   ResetValue;

+  UINT16                                  ArmBootArch;

+  UINT8                                   MinorVersion;

+  UINT64                                  XFirmwareCtrl;

+  UINT64                                  XDsdt;

+  EFI_ACPI_6_1_GENERIC_ADDRESS_STRUCTURE  XPm1aEvtBlk;

+  EFI_ACPI_6_1_GENERIC_ADDRESS_STRUCTURE  XPm1bEvtBlk;

+  EFI_ACPI_6_1_GENERIC_ADDRESS_STRUCTURE  XPm1aCntBlk;

+  EFI_ACPI_6_1_GENERIC_ADDRESS_STRUCTURE  XPm1bCntBlk;

+  EFI_ACPI_6_1_GENERIC_ADDRESS_STRUCTURE  XPm2CntBlk;

+  EFI_ACPI_6_1_GENERIC_ADDRESS_STRUCTURE  XPmTmrBlk;

+  EFI_ACPI_6_1_GENERIC_ADDRESS_STRUCTURE  XGpe0Blk;

+  EFI_ACPI_6_1_GENERIC_ADDRESS_STRUCTURE  XGpe1Blk;

+  EFI_ACPI_6_1_GENERIC_ADDRESS_STRUCTURE  SleepControlReg;

+  EFI_ACPI_6_1_GENERIC_ADDRESS_STRUCTURE  SleepStatusReg;

+  UINT64                                  HypervisorVendorIdentity;

+} EFI_ACPI_6_1_FIXED_ACPI_DESCRIPTION_TABLE;

+

+///

+/// FADT Version (as defined in ACPI 6.1 spec.)

+///

+#define EFI_ACPI_6_1_FIXED_ACPI_DESCRIPTION_TABLE_REVISION  0x06

+#define EFI_ACPI_6_1_FIXED_ACPI_DESCRIPTION_TABLE_MINOR_REVISION  0x01

+

+//

+// Fixed ACPI Description Table Preferred Power Management Profile

+//

+#define EFI_ACPI_6_1_PM_PROFILE_UNSPECIFIED         0

+#define EFI_ACPI_6_1_PM_PROFILE_DESKTOP             1

+#define EFI_ACPI_6_1_PM_PROFILE_MOBILE              2

+#define EFI_ACPI_6_1_PM_PROFILE_WORKSTATION         3

+#define EFI_ACPI_6_1_PM_PROFILE_ENTERPRISE_SERVER   4

+#define EFI_ACPI_6_1_PM_PROFILE_SOHO_SERVER         5

+#define EFI_ACPI_6_1_PM_PROFILE_APPLIANCE_PC        6

+#define EFI_ACPI_6_1_PM_PROFILE_PERFORMANCE_SERVER  7

+#define EFI_ACPI_6_1_PM_PROFILE_TABLET              8

+

+//

+// Fixed ACPI Description Table Boot Architecture Flags

+// All other bits are reserved and must be set to 0.

+//

+#define EFI_ACPI_6_1_LEGACY_DEVICES              BIT0

+#define EFI_ACPI_6_1_8042                        BIT1

+#define EFI_ACPI_6_1_VGA_NOT_PRESENT             BIT2

+#define EFI_ACPI_6_1_MSI_NOT_SUPPORTED           BIT3

+#define EFI_ACPI_6_1_PCIE_ASPM_CONTROLS          BIT4

+#define EFI_ACPI_6_1_CMOS_RTC_NOT_PRESENT        BIT5

+

+//

+// Fixed ACPI Description Table Arm Boot Architecture Flags

+// All other bits are reserved and must be set to 0.

+//

+#define EFI_ACPI_6_1_ARM_PSCI_COMPLIANT              BIT0

+#define EFI_ACPI_6_1_ARM_PSCI_USE_HVC                BIT1

+

+//

+// Fixed ACPI Description Table Fixed Feature Flags

+// All other bits are reserved and must be set to 0.

+//

+#define EFI_ACPI_6_1_WBINVD                                 BIT0

+#define EFI_ACPI_6_1_WBINVD_FLUSH                           BIT1

+#define EFI_ACPI_6_1_PROC_C1                                BIT2

+#define EFI_ACPI_6_1_P_LVL2_UP                              BIT3

+#define EFI_ACPI_6_1_PWR_BUTTON                             BIT4

+#define EFI_ACPI_6_1_SLP_BUTTON                             BIT5

+#define EFI_ACPI_6_1_FIX_RTC                                BIT6

+#define EFI_ACPI_6_1_RTC_S4                                 BIT7

+#define EFI_ACPI_6_1_TMR_VAL_EXT                            BIT8

+#define EFI_ACPI_6_1_DCK_CAP                                BIT9

+#define EFI_ACPI_6_1_RESET_REG_SUP                          BIT10

+#define EFI_ACPI_6_1_SEALED_CASE                            BIT11

+#define EFI_ACPI_6_1_HEADLESS                               BIT12

+#define EFI_ACPI_6_1_CPU_SW_SLP                             BIT13

+#define EFI_ACPI_6_1_PCI_EXP_WAK                            BIT14

+#define EFI_ACPI_6_1_USE_PLATFORM_CLOCK                     BIT15

+#define EFI_ACPI_6_1_S4_RTC_STS_VALID                       BIT16

+#define EFI_ACPI_6_1_REMOTE_POWER_ON_CAPABLE                BIT17

+#define EFI_ACPI_6_1_FORCE_APIC_CLUSTER_MODEL               BIT18

+#define EFI_ACPI_6_1_FORCE_APIC_PHYSICAL_DESTINATION_MODE   BIT19

+#define EFI_ACPI_6_1_HW_REDUCED_ACPI                        BIT20

+#define EFI_ACPI_6_1_LOW_POWER_S0_IDLE_CAPABLE              BIT21

+

+///

+/// Firmware ACPI Control Structure

+///

+typedef struct {

+  UINT32  Signature;

+  UINT32  Length;

+  UINT32  HardwareSignature;

+  UINT32  FirmwareWakingVector;

+  UINT32  GlobalLock;

+  UINT32  Flags;

+  UINT64  XFirmwareWakingVector;

+  UINT8   Version;

+  UINT8   Reserved0[3];

+  UINT32  OspmFlags;

+  UINT8   Reserved1[24];

+} EFI_ACPI_6_1_FIRMWARE_ACPI_CONTROL_STRUCTURE;

+

+///

+/// FACS Version (as defined in ACPI 6.1 spec.)

+///

+#define EFI_ACPI_6_1_FIRMWARE_ACPI_CONTROL_STRUCTURE_VERSION  0x02

+

+///

+/// Firmware Control Structure Feature Flags

+/// All other bits are reserved and must be set to 0.

+///

+#define EFI_ACPI_6_1_S4BIOS_F                     BIT0

+#define EFI_ACPI_6_1_64BIT_WAKE_SUPPORTED_F       BIT1

+

+///

+/// OSPM Enabled Firmware Control Structure Flags

+/// All other bits are reserved and must be set to 0.

+///

+#define EFI_ACPI_6_1_OSPM_64BIT_WAKE_F            BIT0

+

+//

+// Differentiated System Description Table,

+// Secondary System Description Table

+// and Persistent System Description Table,

+// no definition needed as they are common description table header, the same with

+// EFI_ACPI_DESCRIPTION_HEADER, followed by a definition block.

+//

+#define EFI_ACPI_6_1_DIFFERENTIATED_SYSTEM_DESCRIPTION_TABLE_REVISION   0x02

+#define EFI_ACPI_6_1_SECONDARY_SYSTEM_DESCRIPTION_TABLE_REVISION        0x02

+

+///

+/// Multiple APIC Description Table header definition.  The rest of the table

+/// must be defined in a platform specific manner.

+///

+typedef struct {

+  EFI_ACPI_DESCRIPTION_HEADER Header;

+  UINT32                      LocalApicAddress;

+  UINT32                      Flags;

+} EFI_ACPI_6_1_MULTIPLE_APIC_DESCRIPTION_TABLE_HEADER;

+

+///

+/// MADT Revision (as defined in ACPI 6.1 spec.)

+///

+#define EFI_ACPI_6_1_MULTIPLE_APIC_DESCRIPTION_TABLE_REVISION 0x04

+

+///

+/// Multiple APIC Flags

+/// All other bits are reserved and must be set to 0.

+///

+#define EFI_ACPI_6_1_PCAT_COMPAT         BIT0

+

+//

+// Multiple APIC Description Table APIC structure types

+// All other values between 0x0D and 0x7F are reserved and

+// will be ignored by OSPM. 0x80 ~ 0xFF are reserved for OEM.

+//

+#define EFI_ACPI_6_1_PROCESSOR_LOCAL_APIC           0x00

+#define EFI_ACPI_6_1_IO_APIC                        0x01

+#define EFI_ACPI_6_1_INTERRUPT_SOURCE_OVERRIDE      0x02

+#define EFI_ACPI_6_1_NON_MASKABLE_INTERRUPT_SOURCE  0x03

+#define EFI_ACPI_6_1_LOCAL_APIC_NMI                 0x04

+#define EFI_ACPI_6_1_LOCAL_APIC_ADDRESS_OVERRIDE    0x05

+#define EFI_ACPI_6_1_IO_SAPIC                       0x06

+#define EFI_ACPI_6_1_LOCAL_SAPIC                    0x07

+#define EFI_ACPI_6_1_PLATFORM_INTERRUPT_SOURCES     0x08

+#define EFI_ACPI_6_1_PROCESSOR_LOCAL_X2APIC         0x09

+#define EFI_ACPI_6_1_LOCAL_X2APIC_NMI               0x0A

+#define EFI_ACPI_6_1_GIC                            0x0B

+#define EFI_ACPI_6_1_GICD                           0x0C

+#define EFI_ACPI_6_1_GIC_MSI_FRAME                  0x0D

+#define EFI_ACPI_6_1_GICR                           0x0E

+#define EFI_ACPI_6_1_GIC_ITS                        0x0F

+

+//

+// APIC Structure Definitions

+//

+

+///

+/// Processor Local APIC Structure Definition

+///

+typedef struct {

+  UINT8   Type;

+  UINT8   Length;

+  UINT8   AcpiProcessorUid;

+  UINT8   ApicId;

+  UINT32  Flags;

+} EFI_ACPI_6_1_PROCESSOR_LOCAL_APIC_STRUCTURE;

+

+///

+/// Local APIC Flags.  All other bits are reserved and must be 0.

+///

+#define EFI_ACPI_6_1_LOCAL_APIC_ENABLED        BIT0

+

+///

+/// IO APIC Structure

+///

+typedef struct {

+  UINT8   Type;

+  UINT8   Length;

+  UINT8   IoApicId;

+  UINT8   Reserved;

+  UINT32  IoApicAddress;

+  UINT32  GlobalSystemInterruptBase;

+} EFI_ACPI_6_1_IO_APIC_STRUCTURE;

+

+///

+/// Interrupt Source Override Structure

+///

+typedef struct {

+  UINT8   Type;

+  UINT8   Length;

+  UINT8   Bus;

+  UINT8   Source;

+  UINT32  GlobalSystemInterrupt;

+  UINT16  Flags;

+} EFI_ACPI_6_1_INTERRUPT_SOURCE_OVERRIDE_STRUCTURE;

+

+///

+/// Platform Interrupt Sources Structure Definition

+///

+typedef struct {

+  UINT8   Type;

+  UINT8   Length;

+  UINT16  Flags;

+  UINT8   InterruptType;

+  UINT8   ProcessorId;

+  UINT8   ProcessorEid;

+  UINT8   IoSapicVector;

+  UINT32  GlobalSystemInterrupt;

+  UINT32  PlatformInterruptSourceFlags;

+  UINT8   CpeiProcessorOverride;

+  UINT8   Reserved[31];

+} EFI_ACPI_6_1_PLATFORM_INTERRUPT_APIC_STRUCTURE;

+

+//

+// MPS INTI flags.

+// All other bits are reserved and must be set to 0.

+//

+#define EFI_ACPI_6_1_POLARITY      (3 << 0)

+#define EFI_ACPI_6_1_TRIGGER_MODE  (3 << 2)

+

+///

+/// Non-Maskable Interrupt Source Structure

+///

+typedef struct {

+  UINT8   Type;

+  UINT8   Length;

+  UINT16  Flags;

+  UINT32  GlobalSystemInterrupt;

+} EFI_ACPI_6_1_NON_MASKABLE_INTERRUPT_SOURCE_STRUCTURE;

+

+///

+/// Local APIC NMI Structure

+///

+typedef struct {

+  UINT8   Type;

+  UINT8   Length;

+  UINT8   AcpiProcessorUid;

+  UINT16  Flags;

+  UINT8   LocalApicLint;

+} EFI_ACPI_6_1_LOCAL_APIC_NMI_STRUCTURE;

+

+///

+/// Local APIC Address Override Structure

+///

+typedef struct {

+  UINT8   Type;

+  UINT8   Length;

+  UINT16  Reserved;

+  UINT64  LocalApicAddress;

+} EFI_ACPI_6_1_LOCAL_APIC_ADDRESS_OVERRIDE_STRUCTURE;

+

+///

+/// IO SAPIC Structure

+///

+typedef struct {

+  UINT8   Type;

+  UINT8   Length;

+  UINT8   IoApicId;

+  UINT8   Reserved;

+  UINT32  GlobalSystemInterruptBase;

+  UINT64  IoSapicAddress;

+} EFI_ACPI_6_1_IO_SAPIC_STRUCTURE;

+

+///

+/// Local SAPIC Structure

+/// This struct followed by a null-terminated ASCII string - ACPI Processor UID String

+///

+typedef struct {

+  UINT8   Type;

+  UINT8   Length;

+  UINT8   AcpiProcessorId;

+  UINT8   LocalSapicId;

+  UINT8   LocalSapicEid;

+  UINT8   Reserved[3];

+  UINT32  Flags;

+  UINT32  ACPIProcessorUIDValue;

+} EFI_ACPI_6_1_PROCESSOR_LOCAL_SAPIC_STRUCTURE;

+

+///

+/// Platform Interrupt Sources Structure

+///

+typedef struct {

+  UINT8   Type;

+  UINT8   Length;

+  UINT16  Flags;

+  UINT8   InterruptType;

+  UINT8   ProcessorId;

+  UINT8   ProcessorEid;

+  UINT8   IoSapicVector;

+  UINT32  GlobalSystemInterrupt;

+  UINT32  PlatformInterruptSourceFlags;

+} EFI_ACPI_6_1_PLATFORM_INTERRUPT_SOURCES_STRUCTURE;

+

+///

+/// Platform Interrupt Source Flags.

+/// All other bits are reserved and must be set to 0.

+///

+#define EFI_ACPI_6_1_CPEI_PROCESSOR_OVERRIDE          BIT0

+

+///

+/// Processor Local x2APIC Structure Definition

+///

+typedef struct {

+  UINT8   Type;

+  UINT8   Length;

+  UINT8   Reserved[2];

+  UINT32  X2ApicId;

+  UINT32  Flags;

+  UINT32  AcpiProcessorUid;

+} EFI_ACPI_6_1_PROCESSOR_LOCAL_X2APIC_STRUCTURE;

+

+///

+/// Local x2APIC NMI Structure

+///

+typedef struct {

+  UINT8   Type;

+  UINT8   Length;

+  UINT16  Flags;

+  UINT32  AcpiProcessorUid;

+  UINT8   LocalX2ApicLint;

+  UINT8   Reserved[3];

+} EFI_ACPI_6_1_LOCAL_X2APIC_NMI_STRUCTURE;

+

+///

+/// GIC Structure

+///

+typedef struct {

+  UINT8   Type;

+  UINT8   Length;

+  UINT16  Reserved;

+  UINT32  CPUInterfaceNumber;

+  UINT32  AcpiProcessorUid;

+  UINT32  Flags;

+  UINT32  ParkingProtocolVersion;

+  UINT32  PerformanceInterruptGsiv;

+  UINT64  ParkedAddress;

+  UINT64  PhysicalBaseAddress;

+  UINT64  GICV;

+  UINT64  GICH;

+  UINT32  VGICMaintenanceInterrupt;

+  UINT64  GICRBaseAddress;

+  UINT64  MPIDR;

+  UINT8   ProcessorPowerEfficiencyClass;

+  UINT8   Reserved2[3];

+} EFI_ACPI_6_1_GIC_STRUCTURE;

+

+///

+/// GIC Flags.  All other bits are reserved and must be 0.

+///

+#define EFI_ACPI_6_1_GIC_ENABLED                              BIT0

+#define EFI_ACPI_6_1_PERFORMANCE_INTERRUPT_MODEL              BIT1

+#define EFI_ACPI_6_1_VGIC_MAINTENANCE_INTERRUPT_MODE_FLAGS    BIT2

+

+///

+/// GIC Distributor Structure

+///

+typedef struct {

+  UINT8   Type;

+  UINT8   Length;

+  UINT16  Reserved1;

+  UINT32  GicId;

+  UINT64  PhysicalBaseAddress;

+  UINT32  SystemVectorBase;

+  UINT8   GicVersion;

+  UINT8   Reserved2[3];

+} EFI_ACPI_6_1_GIC_DISTRIBUTOR_STRUCTURE;

+

+///

+/// GIC Version

+///

+#define EFI_ACPI_6_1_GIC_V1                                   0x01

+#define EFI_ACPI_6_1_GIC_V2                                   0x02

+#define EFI_ACPI_6_1_GIC_V3                                   0x03

+#define EFI_ACPI_6_1_GIC_V4                                   0x04

+

+///

+/// GIC MSI Frame Structure

+///

+typedef struct {

+  UINT8   Type;

+  UINT8   Length;

+  UINT16  Reserved1;

+  UINT32  GicMsiFrameId;

+  UINT64  PhysicalBaseAddress;

+  UINT32  Flags;

+  UINT16  SPICount;

+  UINT16  SPIBase;

+} EFI_ACPI_6_1_GIC_MSI_FRAME_STRUCTURE;

+

+///

+/// GIC MSI Frame Flags.  All other bits are reserved and must be 0.

+///

+#define EFI_ACPI_6_1_SPI_COUNT_BASE_SELECT                    BIT0

+

+///

+/// GICR Structure

+///

+typedef struct {

+  UINT8   Type;

+  UINT8   Length;

+  UINT16  Reserved;

+  UINT64  DiscoveryRangeBaseAddress;

+  UINT32  DiscoveryRangeLength;

+} EFI_ACPI_6_1_GICR_STRUCTURE;

+

+///

+/// GIC Interrupt Translation Service Structure

+///

+typedef struct {

+  UINT8   Type;

+  UINT8   Length;

+  UINT16  Reserved;

+  UINT32  GicItsId;

+  UINT64  PhysicalBaseAddress;

+  UINT32  Reserved2;

+} EFI_ACPI_6_1_GIC_ITS_STRUCTURE;

+

+///

+/// Smart Battery Description Table (SBST)

+///

+typedef struct {

+  EFI_ACPI_DESCRIPTION_HEADER Header;

+  UINT32                      WarningEnergyLevel;

+  UINT32                      LowEnergyLevel;

+  UINT32                      CriticalEnergyLevel;

+} EFI_ACPI_6_1_SMART_BATTERY_DESCRIPTION_TABLE;

+

+///

+/// SBST Version (as defined in ACPI 6.1 spec.)

+///

+#define EFI_ACPI_6_1_SMART_BATTERY_DESCRIPTION_TABLE_REVISION 0x01

+

+///

+/// Embedded Controller Boot Resources Table (ECDT)

+/// The table is followed by a null terminated ASCII string that contains

+/// a fully qualified reference to the name space object.

+///

+typedef struct {

+  EFI_ACPI_DESCRIPTION_HEADER             Header;

+  EFI_ACPI_6_1_GENERIC_ADDRESS_STRUCTURE  EcControl;

+  EFI_ACPI_6_1_GENERIC_ADDRESS_STRUCTURE  EcData;

+  UINT32                                  Uid;

+  UINT8                                   GpeBit;

+} EFI_ACPI_6_1_EMBEDDED_CONTROLLER_BOOT_RESOURCES_TABLE;

+

+///

+/// ECDT Version (as defined in ACPI 6.1 spec.)

+///

+#define EFI_ACPI_6_1_EMBEDDED_CONTROLLER_BOOT_RESOURCES_TABLE_REVISION  0x01

+

+///

+/// System Resource Affinity Table (SRAT).  The rest of the table

+/// must be defined in a platform specific manner.

+///

+typedef struct {

+  EFI_ACPI_DESCRIPTION_HEADER Header;

+  UINT32                      Reserved1;  ///< Must be set to 1

+  UINT64                      Reserved2;

+} EFI_ACPI_6_1_SYSTEM_RESOURCE_AFFINITY_TABLE_HEADER;

+

+///

+/// SRAT Version (as defined in ACPI 6.1 spec.)

+///

+#define EFI_ACPI_6_1_SYSTEM_RESOURCE_AFFINITY_TABLE_REVISION  0x03

+

+//

+// SRAT structure types.

+// All other values between 0x04 an 0xFF are reserved and

+// will be ignored by OSPM.

+//

+#define EFI_ACPI_6_1_PROCESSOR_LOCAL_APIC_SAPIC_AFFINITY  0x00

+#define EFI_ACPI_6_1_MEMORY_AFFINITY                      0x01

+#define EFI_ACPI_6_1_PROCESSOR_LOCAL_X2APIC_AFFINITY      0x02

+#define EFI_ACPI_6_1_GICC_AFFINITY                        0x03

+

+///

+/// Processor Local APIC/SAPIC Affinity Structure Definition

+///

+typedef struct {

+  UINT8   Type;

+  UINT8   Length;

+  UINT8   ProximityDomain7To0;

+  UINT8   ApicId;

+  UINT32  Flags;

+  UINT8   LocalSapicEid;

+  UINT8   ProximityDomain31To8[3];

+  UINT32  ClockDomain;

+} EFI_ACPI_6_1_PROCESSOR_LOCAL_APIC_SAPIC_AFFINITY_STRUCTURE;

+

+///

+/// Local APIC/SAPIC Flags.  All other bits are reserved and must be 0.

+///

+#define EFI_ACPI_6_1_PROCESSOR_LOCAL_APIC_SAPIC_ENABLED (1 << 0)

+

+///

+/// Memory Affinity Structure Definition

+///

+typedef struct {

+  UINT8   Type;

+  UINT8   Length;

+  UINT32  ProximityDomain;

+  UINT16  Reserved1;

+  UINT32  AddressBaseLow;

+  UINT32  AddressBaseHigh;

+  UINT32  LengthLow;

+  UINT32  LengthHigh;

+  UINT32  Reserved2;

+  UINT32  Flags;

+  UINT64  Reserved3;

+} EFI_ACPI_6_1_MEMORY_AFFINITY_STRUCTURE;

+

+//

+// Memory Flags.  All other bits are reserved and must be 0.

+//

+#define EFI_ACPI_6_1_MEMORY_ENABLED       (1 << 0)

+#define EFI_ACPI_6_1_MEMORY_HOT_PLUGGABLE (1 << 1)

+#define EFI_ACPI_6_1_MEMORY_NONVOLATILE   (1 << 2)

+

+///

+/// Processor Local x2APIC Affinity Structure Definition

+///

+typedef struct {

+  UINT8   Type;

+  UINT8   Length;

+  UINT8   Reserved1[2];

+  UINT32  ProximityDomain;

+  UINT32  X2ApicId;

+  UINT32  Flags;

+  UINT32  ClockDomain;

+  UINT8   Reserved2[4];

+} EFI_ACPI_6_1_PROCESSOR_LOCAL_X2APIC_AFFINITY_STRUCTURE;

+

+///

+/// GICC Affinity Structure Definition

+///

+typedef struct {

+  UINT8   Type;

+  UINT8   Length;

+  UINT32  ProximityDomain;

+  UINT32  AcpiProcessorUid;

+  UINT32  Flags;

+  UINT32  ClockDomain;

+} EFI_ACPI_6_1_GICC_AFFINITY_STRUCTURE;

+

+///

+/// GICC Flags.  All other bits are reserved and must be 0.

+///

+#define EFI_ACPI_6_1_GICC_ENABLED (1 << 0)

+

+///

+/// System Locality Distance Information Table (SLIT).

+/// The rest of the table is a matrix.

+///

+typedef struct {

+  EFI_ACPI_DESCRIPTION_HEADER Header;

+  UINT64                      NumberOfSystemLocalities;

+} EFI_ACPI_6_1_SYSTEM_LOCALITY_DISTANCE_INFORMATION_TABLE_HEADER;

+

+///

+/// SLIT Version (as defined in ACPI 6.1 spec.)

+///

+#define EFI_ACPI_6_1_SYSTEM_LOCALITY_DISTANCE_INFORMATION_TABLE_REVISION  0x01

+

+///

+/// Corrected Platform Error Polling Table (CPEP)

+///

+typedef struct {

+  EFI_ACPI_DESCRIPTION_HEADER Header;

+  UINT8                       Reserved[8];

+} EFI_ACPI_6_1_CORRECTED_PLATFORM_ERROR_POLLING_TABLE_HEADER;

+

+///

+/// CPEP Version (as defined in ACPI 6.1 spec.)

+///

+#define EFI_ACPI_6_1_CORRECTED_PLATFORM_ERROR_POLLING_TABLE_REVISION 0x01

+

+//

+// CPEP processor structure types.

+//

+#define EFI_ACPI_6_1_CPEP_PROCESSOR_APIC_SAPIC  0x00

+

+///

+/// Corrected Platform Error Polling Processor Structure Definition

+///

+typedef struct {

+  UINT8   Type;

+  UINT8   Length;

+  UINT8   ProcessorId;

+  UINT8   ProcessorEid;

+  UINT32  PollingInterval;

+} EFI_ACPI_6_1_CPEP_PROCESSOR_APIC_SAPIC_STRUCTURE;

+

+///

+/// Maximum System Characteristics Table (MSCT)

+///

+typedef struct {

+  EFI_ACPI_DESCRIPTION_HEADER Header;

+  UINT32                      OffsetProxDomInfo;

+  UINT32                      MaximumNumberOfProximityDomains;

+  UINT32                      MaximumNumberOfClockDomains;

+  UINT64                      MaximumPhysicalAddress;

+} EFI_ACPI_6_1_MAXIMUM_SYSTEM_CHARACTERISTICS_TABLE_HEADER;

+

+///

+/// MSCT Version (as defined in ACPI 6.1 spec.)

+///

+#define EFI_ACPI_6_1_MAXIMUM_SYSTEM_CHARACTERISTICS_TABLE_REVISION 0x01

+

+///

+/// Maximum Proximity Domain Information Structure Definition

+///

+typedef struct {

+  UINT8   Revision;

+  UINT8   Length;

+  UINT32  ProximityDomainRangeLow;

+  UINT32  ProximityDomainRangeHigh;

+  UINT32  MaximumProcessorCapacity;

+  UINT64  MaximumMemoryCapacity;

+} EFI_ACPI_6_1_MAXIMUM_PROXIMITY_DOMAIN_INFORMATION_STRUCTURE;

+

+///

+/// ACPI RAS Feature Table definition.

+///

+typedef struct {

+  EFI_ACPI_DESCRIPTION_HEADER Header;

+  UINT8                       PlatformCommunicationChannelIdentifier[12];

+} EFI_ACPI_6_1_RAS_FEATURE_TABLE;

+

+///

+/// RASF Version (as defined in ACPI 6.1 spec.)

+///

+#define EFI_ACPI_6_1_RAS_FEATURE_TABLE_REVISION 0x01

+

+///

+/// ACPI RASF Platform Communication Channel Shared Memory Region definition.

+///

+typedef struct {

+  UINT32                      Signature;

+  UINT16                      Command;

+  UINT16                      Status;

+  UINT16                      Version;

+  UINT8                       RASCapabilities[16];

+  UINT8                       SetRASCapabilities[16];

+  UINT16                      NumberOfRASFParameterBlocks;

+  UINT32                      SetRASCapabilitiesStatus;

+} EFI_ACPI_6_1_RASF_PLATFORM_COMMUNICATION_CHANNEL_SHARED_MEMORY_REGION;

+

+///

+/// ACPI RASF PCC command code

+///

+#define EFI_ACPI_6_1_RASF_PCC_COMMAND_CODE_EXECUTE_RASF_COMMAND  0x01

+

+///

+/// ACPI RASF Platform RAS Capabilities

+///

+#define EFI_ACPI_6_1_RASF_PLATFORM_RAS_CAPABILITY_HARDWARE_BASED_PATROL_SCRUB_SUPPOTED                          0x01

+#define EFI_ACPI_6_1_RASF_PLATFORM_RAS_CAPABILITY_HARDWARE_BASED_PATROL_SCRUB_SUPPOTED_AND_EXPOSED_TO_SOFTWARE  0x02

+

+///

+/// ACPI RASF Parameter Block structure for PATROL_SCRUB

+///

+typedef struct {

+  UINT16                      Type;

+  UINT16                      Version;

+  UINT16                      Length;

+  UINT16                      PatrolScrubCommand;

+  UINT64                      RequestedAddressRange[2];

+  UINT64                      ActualAddressRange[2];

+  UINT16                      Flags;

+  UINT8                       RequestedSpeed;

+} EFI_ACPI_6_1_RASF_PATROL_SCRUB_PLATFORM_BLOCK_STRUCTURE;

+

+///

+/// ACPI RASF Patrol Scrub command

+///

+#define EFI_ACPI_6_1_RASF_PATROL_SCRUB_COMMAND_GET_PATROL_PARAMETERS   0x01

+#define EFI_ACPI_6_1_RASF_PATROL_SCRUB_COMMAND_START_PATROL_SCRUBBER   0x02

+#define EFI_ACPI_6_1_RASF_PATROL_SCRUB_COMMAND_STOP_PATROL_SCRUBBER    0x03

+

+///

+/// Memory Power State Table definition.

+///

+typedef struct {

+  EFI_ACPI_DESCRIPTION_HEADER Header;

+  UINT8                       PlatformCommunicationChannelIdentifier;

+  UINT8                       Reserved[3];

+// Memory Power Node Structure

+// Memory Power State Characteristics

+} EFI_ACPI_6_1_MEMORY_POWER_STATUS_TABLE;

+

+///

+/// MPST Version (as defined in ACPI 6.1 spec.)

+///

+#define EFI_ACPI_6_1_MEMORY_POWER_STATE_TABLE_REVISION 0x01

+

+///

+/// MPST Platform Communication Channel Shared Memory Region definition.

+///

+typedef struct {

+  UINT32                      Signature;

+  UINT16                      Command;

+  UINT16                      Status;

+  UINT32                      MemoryPowerCommandRegister;

+  UINT32                      MemoryPowerStatusRegister;

+  UINT32                      PowerStateId;

+  UINT32                      MemoryPowerNodeId;

+  UINT64                      MemoryEnergyConsumed;

+  UINT64                      ExpectedAveragePowerComsuned;

+} EFI_ACPI_6_1_MPST_PLATFORM_COMMUNICATION_CHANNEL_SHARED_MEMORY_REGION;

+

+///

+/// ACPI MPST PCC command code

+///

+#define EFI_ACPI_6_1_MPST_PCC_COMMAND_CODE_EXECUTE_MPST_COMMAND  0x03

+

+///

+/// ACPI MPST Memory Power command

+///

+#define EFI_ACPI_6_1_MPST_MEMORY_POWER_COMMAND_GET_MEMORY_POWER_STATE       0x01

+#define EFI_ACPI_6_1_MPST_MEMORY_POWER_COMMAND_SET_MEMORY_POWER_STATE       0x02

+#define EFI_ACPI_6_1_MPST_MEMORY_POWER_COMMAND_GET_AVERAGE_POWER_CONSUMED   0x03

+#define EFI_ACPI_6_1_MPST_MEMORY_POWER_COMMAND_GET_MEMORY_ENERGY_CONSUMED   0x04

+

+///

+/// MPST Memory Power Node Table

+///

+typedef struct {

+  UINT8                                             PowerStateValue;

+  UINT8                                             PowerStateInformationIndex;

+} EFI_ACPI_6_1_MPST_MEMORY_POWER_STATE;

+

+typedef struct {

+  UINT8                                             Flag;

+  UINT8                                             Reserved;

+  UINT16                                            MemoryPowerNodeId;

+  UINT32                                            Length;

+  UINT64                                            AddressBase;

+  UINT64                                            AddressLength;

+  UINT32                                            NumberOfPowerStates;

+  UINT32                                            NumberOfPhysicalComponents;

+//EFI_ACPI_6_1_MPST_MEMORY_POWER_STATE              MemoryPowerState[NumberOfPowerStates];

+//UINT16                                            PhysicalComponentIdentifier[NumberOfPhysicalComponents];

+} EFI_ACPI_6_1_MPST_MEMORY_POWER_STRUCTURE;

+

+#define EFI_ACPI_6_1_MPST_MEMORY_POWER_STRUCTURE_FLAG_ENABLE          0x01

+#define EFI_ACPI_6_1_MPST_MEMORY_POWER_STRUCTURE_FLAG_POWER_MANAGED   0x02

+#define EFI_ACPI_6_1_MPST_MEMORY_POWER_STRUCTURE_FLAG_HOT_PLUGGABLE   0x04

+

+typedef struct {

+  UINT16                      MemoryPowerNodeCount;

+  UINT8                       Reserved[2];

+} EFI_ACPI_6_1_MPST_MEMORY_POWER_NODE_TABLE;

+

+///

+/// MPST Memory Power State Characteristics Table

+///

+typedef struct {

+  UINT8                                             PowerStateStructureID;

+  UINT8                                             Flag;

+  UINT16                                            Reserved;

+  UINT32                                            AveragePowerConsumedInMPS0;

+  UINT32                                            RelativePowerSavingToMPS0;

+  UINT64                                            ExitLatencyToMPS0;

+} EFI_ACPI_6_1_MPST_MEMORY_POWER_STATE_CHARACTERISTICS_STRUCTURE;

+

+#define EFI_ACPI_6_1_MPST_MEMORY_POWER_STATE_CHARACTERISTICS_STRUCTURE_FLAG_MEMORY_CONTENT_PRESERVED              0x01

+#define EFI_ACPI_6_1_MPST_MEMORY_POWER_STATE_CHARACTERISTICS_STRUCTURE_FLAG_AUTONOMOUS_MEMORY_POWER_STATE_ENTRY   0x02

+#define EFI_ACPI_6_1_MPST_MEMORY_POWER_STATE_CHARACTERISTICS_STRUCTURE_FLAG_AUTONOMOUS_MEMORY_POWER_STATE_EXIT    0x04

+

+typedef struct {

+  UINT16                      MemoryPowerStateCharacteristicsCount;

+  UINT8                       Reserved[2];

+} EFI_ACPI_6_1_MPST_MEMORY_POWER_STATE_CHARACTERISTICS_TABLE;

+

+///

+/// Memory Topology Table definition.

+///

+typedef struct {

+  EFI_ACPI_DESCRIPTION_HEADER Header;

+  UINT32                      Reserved;

+} EFI_ACPI_6_1_MEMORY_TOPOLOGY_TABLE;

+

+///

+/// PMTT Version (as defined in ACPI 6.1 spec.)

+///

+#define EFI_ACPI_6_1_MEMORY_TOPOLOGY_TABLE_REVISION 0x01

+

+///

+/// Common Memory Aggregator Device Structure.

+///

+typedef struct {

+  UINT8                       Type;

+  UINT8                       Reserved;

+  UINT16                      Length;

+  UINT16                      Flags;

+  UINT16                      Reserved1;

+} EFI_ACPI_6_1_PMMT_COMMON_MEMORY_AGGREGATOR_DEVICE_STRUCTURE;

+

+///

+/// Memory Aggregator Device Type

+///

+#define EFI_ACPI_6_1_PMMT_MEMORY_AGGREGATOR_DEVICE_TYPE_SOCKET            0x1

+#define EFI_ACPI_6_1_PMMT_MEMORY_AGGREGATOR_DEVICE_TYPE_MEMORY_CONTROLLER 0x2

+#define EFI_ACPI_6_1_PMMT_MEMORY_AGGREGATOR_DEVICE_TYPE_DIMM              0x3

+

+///

+/// Socket Memory Aggregator Device Structure.

+///

+typedef struct {

+  EFI_ACPI_6_1_PMMT_COMMON_MEMORY_AGGREGATOR_DEVICE_STRUCTURE  Header;

+  UINT16                                                       SocketIdentifier;

+  UINT16                                                       Reserved;

+//EFI_ACPI_6_1_PMMT_MEMORY_CONTROLLER_MEMORY_AGGREGATOR_DEVICE_STRUCTURE  MemoryController[];

+} EFI_ACPI_6_1_PMMT_SOCKET_MEMORY_AGGREGATOR_DEVICE_STRUCTURE;

+

+///

+/// MemoryController Memory Aggregator Device Structure.

+///

+typedef struct {

+  EFI_ACPI_6_1_PMMT_COMMON_MEMORY_AGGREGATOR_DEVICE_STRUCTURE  Header;

+  UINT32                                                       ReadLatency;

+  UINT32                                                       WriteLatency;

+  UINT32                                                       ReadBandwidth;

+  UINT32                                                       WriteBandwidth;

+  UINT16                                                       OptimalAccessUnit;

+  UINT16                                                       OptimalAccessAlignment;

+  UINT16                                                       Reserved;

+  UINT16                                                       NumberOfProximityDomains;

+//UINT32                                                       ProximityDomain[NumberOfProximityDomains];

+//EFI_ACPI_6_1_PMMT_DIMM_MEMORY_AGGREGATOR_DEVICE_STRUCTURE    PhysicalComponent[];

+} EFI_ACPI_6_1_PMMT_MEMORY_CONTROLLER_MEMORY_AGGREGATOR_DEVICE_STRUCTURE;

+

+///

+/// DIMM Memory Aggregator Device Structure.

+///

+typedef struct {

+  EFI_ACPI_6_1_PMMT_COMMON_MEMORY_AGGREGATOR_DEVICE_STRUCTURE  Header;

+  UINT16                                                       PhysicalComponentIdentifier;

+  UINT16                                                       Reserved;

+  UINT32                                                       SizeOfDimm;

+  UINT32                                                       SmbiosHandle;

+} EFI_ACPI_6_1_PMMT_DIMM_MEMORY_AGGREGATOR_DEVICE_STRUCTURE;

+

+///

+/// Boot Graphics Resource Table definition.

+///

+typedef struct {

+  EFI_ACPI_DESCRIPTION_HEADER Header;

+  ///

+  /// 2-bytes (16 bit) version ID. This value must be 1.

+  ///

+  UINT16                      Version;

+  ///

+  /// 1-byte status field indicating current status about the table.

+  ///     Bits[7:1] = Reserved (must be zero)

+  ///     Bit [0] = Valid. A one indicates the boot image graphic is valid.

+  ///

+  UINT8                       Status;

+  ///

+  /// 1-byte enumerated type field indicating format of the image.

+  ///     0 = Bitmap

+  ///     1 - 255  Reserved (for future use)

+  ///

+  UINT8                       ImageType;

+  ///

+  /// 8-byte (64 bit) physical address pointing to the firmware's in-memory copy

+  /// of the image bitmap.

+  ///

+  UINT64                      ImageAddress;

+  ///

+  /// A 4-byte (32-bit) unsigned long describing the display X-offset of the boot image.

+  /// (X, Y) display offset of the top left corner of the boot image.

+  /// The top left corner of the display is at offset (0, 0).

+  ///

+  UINT32                      ImageOffsetX;

+  ///

+  /// A 4-byte (32-bit) unsigned long describing the display Y-offset of the boot image.

+  /// (X, Y) display offset of the top left corner of the boot image.

+  /// The top left corner of the display is at offset (0, 0).

+  ///

+  UINT32                      ImageOffsetY;

+} EFI_ACPI_6_1_BOOT_GRAPHICS_RESOURCE_TABLE;

+

+///

+/// BGRT Revision

+///

+#define EFI_ACPI_6_1_BOOT_GRAPHICS_RESOURCE_TABLE_REVISION 1

+

+///

+/// BGRT Version

+///

+#define EFI_ACPI_6_1_BGRT_VERSION         0x01

+

+///

+/// BGRT Status

+///

+#define EFI_ACPI_6_1_BGRT_STATUS_NOT_DISPLAYED 0x00

+#define EFI_ACPI_6_1_BGRT_STATUS_DISPLAYED     0x01

+

+///

+/// BGRT Image Type

+///

+#define EFI_ACPI_6_1_BGRT_IMAGE_TYPE_BMP  0x00

+

+///

+/// FPDT Version (as defined in ACPI 6.1 spec.)

+///

+#define EFI_ACPI_6_1_FIRMWARE_PERFORMANCE_DATA_TABLE_REVISION 0x01

+

+///

+/// FPDT Performance Record Types

+///

+#define EFI_ACPI_6_1_FPDT_RECORD_TYPE_FIRMWARE_BASIC_BOOT_POINTER      0x0000

+#define EFI_ACPI_6_1_FPDT_RECORD_TYPE_S3_PERFORMANCE_TABLE_POINTER     0x0001

+

+///

+/// FPDT Performance Record Revision

+///

+#define EFI_ACPI_6_1_FPDT_RECORD_REVISION_FIRMWARE_BASIC_BOOT_POINTER  0x01

+#define EFI_ACPI_6_1_FPDT_RECORD_REVISION_S3_PERFORMANCE_TABLE_POINTER 0x01

+

+///

+/// FPDT Runtime Performance Record Types

+///

+#define EFI_ACPI_6_1_FPDT_RUNTIME_RECORD_TYPE_S3_RESUME                0x0000

+#define EFI_ACPI_6_1_FPDT_RUNTIME_RECORD_TYPE_S3_SUSPEND               0x0001

+#define EFI_ACPI_6_1_FPDT_RUNTIME_RECORD_TYPE_FIRMWARE_BASIC_BOOT      0x0002

+

+///

+/// FPDT Runtime Performance Record Revision

+///

+#define EFI_ACPI_6_1_FPDT_RUNTIME_RECORD_REVISION_S3_RESUME            0x01

+#define EFI_ACPI_6_1_FPDT_RUNTIME_RECORD_REVISION_S3_SUSPEND           0x01

+#define EFI_ACPI_6_1_FPDT_RUNTIME_RECORD_REVISION_FIRMWARE_BASIC_BOOT  0x02

+

+///

+/// FPDT Performance Record header

+///

+typedef struct {

+  UINT16           Type;

+  UINT8            Length;

+  UINT8            Revision;

+} EFI_ACPI_6_1_FPDT_PERFORMANCE_RECORD_HEADER;

+

+///

+/// FPDT Performance Table header

+///

+typedef struct {

+  UINT32  Signature;

+  UINT32  Length;

+} EFI_ACPI_6_1_FPDT_PERFORMANCE_TABLE_HEADER;

+

+///

+/// FPDT Firmware Basic Boot Performance Pointer Record Structure

+///

+typedef struct {

+  EFI_ACPI_6_1_FPDT_PERFORMANCE_RECORD_HEADER     Header;

+  UINT32                                          Reserved;

+  ///

+  /// 64-bit processor-relative physical address of the Basic Boot Performance Table.

+  ///

+  UINT64                                          BootPerformanceTablePointer;

+} EFI_ACPI_6_1_FPDT_BOOT_PERFORMANCE_TABLE_POINTER_RECORD;

+

+///

+/// FPDT S3 Performance Table Pointer Record Structure

+///

+typedef struct {

+  EFI_ACPI_6_1_FPDT_PERFORMANCE_RECORD_HEADER     Header;

+  UINT32                                          Reserved;

+  ///

+  /// 64-bit processor-relative physical address of the S3 Performance Table.

+  ///

+  UINT64                                          S3PerformanceTablePointer;

+} EFI_ACPI_6_1_FPDT_S3_PERFORMANCE_TABLE_POINTER_RECORD;

+

+///

+/// FPDT Firmware Basic Boot Performance Record Structure

+///

+typedef struct {

+  EFI_ACPI_6_1_FPDT_PERFORMANCE_RECORD_HEADER     Header;

+  UINT32                                          Reserved;

+  ///

+  /// Timer value logged at the beginning of firmware image execution.

+  /// This may not always be zero or near zero.

+  ///

+  UINT64                                          ResetEnd;

+  ///

+  /// Timer value logged just prior to loading the OS boot loader into memory.

+  /// For non-UEFI compatible boots, this field must be zero.

+  ///

+  UINT64                                          OsLoaderLoadImageStart;

+  ///

+  /// Timer value logged just prior to launching the previously loaded OS boot loader image.

+  /// For non-UEFI compatible boots, the timer value logged will be just prior

+  /// to the INT 19h handler invocation.

+  ///

+  UINT64                                          OsLoaderStartImageStart;

+  ///

+  /// Timer value logged at the point when the OS loader calls the

+  /// ExitBootServices function for UEFI compatible firmware.

+  /// For non-UEFI compatible boots, this field must be zero.

+  ///

+  UINT64                                          ExitBootServicesEntry;

+  ///

+  /// Timer value logged at the point just prior to when the OS loader gaining

+  /// control back from calls the ExitBootServices function for UEFI compatible firmware.

+  /// For non-UEFI compatible boots, this field must be zero.

+  ///

+  UINT64                                          ExitBootServicesExit;

+} EFI_ACPI_6_1_FPDT_FIRMWARE_BASIC_BOOT_RECORD;

+

+///

+/// FPDT Firmware Basic Boot Performance Table signature

+///

+#define EFI_ACPI_6_1_FPDT_BOOT_PERFORMANCE_TABLE_SIGNATURE  SIGNATURE_32('F', 'B', 'P', 'T')

+

+//

+// FPDT Firmware Basic Boot Performance Table

+//

+typedef struct {

+  EFI_ACPI_6_1_FPDT_PERFORMANCE_TABLE_HEADER      Header;

+  //

+  // one or more Performance Records.

+  //

+} EFI_ACPI_6_1_FPDT_FIRMWARE_BASIC_BOOT_TABLE;

+

+///

+/// FPDT "S3PT" S3 Performance Table

+///

+#define EFI_ACPI_6_1_FPDT_S3_PERFORMANCE_TABLE_SIGNATURE  SIGNATURE_32('S', '3', 'P', 'T')

+

+//

+// FPDT Firmware S3 Boot Performance Table

+//

+typedef struct {

+  EFI_ACPI_6_1_FPDT_PERFORMANCE_TABLE_HEADER      Header;

+  //

+  // one or more Performance Records.

+  //

+} EFI_ACPI_6_1_FPDT_FIRMWARE_S3_BOOT_TABLE;

+

+///

+/// FPDT Basic S3 Resume Performance Record

+///

+typedef struct {

+  EFI_ACPI_6_1_FPDT_PERFORMANCE_RECORD_HEADER     Header;

+  ///

+  /// A count of the number of S3 resume cycles since the last full boot sequence.

+  ///

+  UINT32                                          ResumeCount;

+  ///

+  /// Timer recorded at the end of BIOS S3 resume, just prior to handoff to the

+  /// OS waking vector. Only the most recent resume cycle's time is retained.

+  ///

+  UINT64                                          FullResume;

+  ///

+  /// Average timer value of all resume cycles logged since the last full boot

+  /// sequence, including the most recent resume.  Note that the entire log of

+  /// timer values does not need to be retained in order to calculate this average.

+  ///

+  UINT64                                          AverageResume;

+} EFI_ACPI_6_1_FPDT_S3_RESUME_RECORD;

+

+///

+/// FPDT Basic S3 Suspend Performance Record

+///

+typedef struct {

+  EFI_ACPI_6_1_FPDT_PERFORMANCE_RECORD_HEADER     Header;

+  ///

+  /// Timer value recorded at the OS write to SLP_TYP upon entry to S3.

+  /// Only the most recent suspend cycle's timer value is retained.

+  ///

+  UINT64                                          SuspendStart;

+  ///

+  /// Timer value recorded at the final firmware write to SLP_TYP (or other

+  /// mechanism) used to trigger hardware entry to S3.

+  /// Only the most recent suspend cycle's timer value is retained.

+  ///

+  UINT64                                          SuspendEnd;

+} EFI_ACPI_6_1_FPDT_S3_SUSPEND_RECORD;

+

+///

+/// Firmware Performance Record Table definition.

+///

+typedef struct {

+  EFI_ACPI_DESCRIPTION_HEADER Header;

+} EFI_ACPI_6_1_FIRMWARE_PERFORMANCE_RECORD_TABLE;

+

+///

+/// Generic Timer Description Table definition.

+///

+typedef struct {

+  EFI_ACPI_DESCRIPTION_HEADER Header;

+  UINT64                      CntControlBasePhysicalAddress;

+  UINT32                      Reserved;

+  UINT32                      SecurePL1TimerGSIV;

+  UINT32                      SecurePL1TimerFlags;

+  UINT32                      NonSecurePL1TimerGSIV;

+  UINT32                      NonSecurePL1TimerFlags;

+  UINT32                      VirtualTimerGSIV;

+  UINT32                      VirtualTimerFlags;

+  UINT32                      NonSecurePL2TimerGSIV;

+  UINT32                      NonSecurePL2TimerFlags;

+  UINT64                      CntReadBasePhysicalAddress;

+  UINT32                      PlatformTimerCount;

+  UINT32                      PlatformTimerOffset;

+} EFI_ACPI_6_1_GENERIC_TIMER_DESCRIPTION_TABLE;

+

+///

+/// GTDT Version (as defined in ACPI 6.1 spec.)

+///

+#define EFI_ACPI_6_1_GENERIC_TIMER_DESCRIPTION_TABLE_REVISION 0x02

+

+///

+/// Timer Flags.  All other bits are reserved and must be 0.

+///

+#define EFI_ACPI_6_1_GTDT_TIMER_FLAG_TIMER_INTERRUPT_MODE          BIT0

+#define EFI_ACPI_6_1_GTDT_TIMER_FLAG_TIMER_INTERRUPT_POLARITY      BIT1

+#define EFI_ACPI_6_1_GTDT_TIMER_FLAG_ALWAYS_ON_CAPABILITY          BIT2

+

+///

+/// Platform Timer Type

+///

+#define EFI_ACPI_6_1_GTDT_GT_BLOCK                       0

+#define EFI_ACPI_6_1_GTDT_SBSA_GENERIC_WATCHDOG          1

+

+///

+/// GT Block Structure

+///

+typedef struct {

+  UINT8   Type;

+  UINT16  Length;

+  UINT8   Reserved;

+  UINT64  CntCtlBase;

+  UINT32  GTBlockTimerCount;

+  UINT32  GTBlockTimerOffset;

+} EFI_ACPI_6_1_GTDT_GT_BLOCK_STRUCTURE;

+

+///

+/// GT Block Timer Structure

+///

+typedef struct {

+  UINT8   GTFrameNumber;

+  UINT8   Reserved[3];

+  UINT64  CntBaseX;

+  UINT64  CntEL0BaseX;

+  UINT32  GTxPhysicalTimerGSIV;

+  UINT32  GTxPhysicalTimerFlags;

+  UINT32  GTxVirtualTimerGSIV;

+  UINT32  GTxVirtualTimerFlags;

+  UINT32  GTxCommonFlags;

+} EFI_ACPI_6_1_GTDT_GT_BLOCK_TIMER_STRUCTURE;

+

+///

+/// GT Block Physical Timers and Virtual Timers Flags.  All other bits are reserved and must be 0.

+///

+#define EFI_ACPI_6_1_GTDT_GT_BLOCK_TIMER_FLAG_TIMER_INTERRUPT_MODE          BIT0

+#define EFI_ACPI_6_1_GTDT_GT_BLOCK_TIMER_FLAG_TIMER_INTERRUPT_POLARITY      BIT1

+

+///

+/// Common Flags Flags.  All other bits are reserved and must be 0.

+///

+#define EFI_ACPI_6_1_GTDT_GT_BLOCK_COMMON_FLAG_SECURE_TIMER              BIT0

+#define EFI_ACPI_6_1_GTDT_GT_BLOCK_COMMON_FLAG_ALWAYS_ON_CAPABILITY      BIT1

+

+///

+/// SBSA Generic Watchdog Structure

+///

+typedef struct {

+  UINT8   Type;

+  UINT16  Length;

+  UINT8   Reserved;

+  UINT64  RefreshFramePhysicalAddress;

+  UINT64  WatchdogControlFramePhysicalAddress;

+  UINT32  WatchdogTimerGSIV;

+  UINT32  WatchdogTimerFlags;

+} EFI_ACPI_6_1_GTDT_SBSA_GENERIC_WATCHDOG_STRUCTURE;

+

+///

+/// SBSA Generic Watchdog Timer Flags.  All other bits are reserved and must be 0.

+///

+#define EFI_ACPI_6_1_GTDT_SBSA_GENERIC_WATCHDOG_FLAG_TIMER_INTERRUPT_MODE          BIT0

+#define EFI_ACPI_6_1_GTDT_SBSA_GENERIC_WATCHDOG_FLAG_TIMER_INTERRUPT_POLARITY      BIT1

+#define EFI_ACPI_6_1_GTDT_SBSA_GENERIC_WATCHDOG_FLAG_SECURE_TIMER                  BIT2

+

+//

+// NVDIMM Firmware Interface Table definition.

+//

+typedef struct {

+  EFI_ACPI_DESCRIPTION_HEADER    Header;

+  UINT32                         Reserved;

+} EFI_ACPI_6_1_NVDIMM_FIRMWARE_INTERFACE_TABLE;

+

+//

+// NFIT Version (as defined in ACPI 6.1 spec.)

+//

+#define EFI_ACPI_6_1_NVDIMM_FIRMWARE_INTERFACE_TABLE_REVISION 0x1

+

+//

+// Definition for NFIT Table Structure Types

+//

+#define EFI_ACPI_6_1_NFIT_SYSTEM_PHYSICAL_ADDRESS_RANGE_STRUCTURE_TYPE              0

+#define EFI_ACPI_6_1_NFIT_NVDIMM_REGION_MAPPING_STRUCTURE_TYPE                      1

+#define EFI_ACPI_6_1_NFIT_INTERLEAVE_STRUCTURE_TYPE                                 2

+#define EFI_ACPI_6_1_NFIT_SMBIOS_MANAGEMENT_INFORMATION_STRUCTURE_TYPE              3

+#define EFI_ACPI_6_1_NFIT_NVDIMM_CONTROL_REGION_STRUCTURE_TYPE                      4

+#define EFI_ACPI_6_1_NFIT_NVDIMM_BLOCK_DATA_WINDOW_REGION_STRUCTURE_TYPE            5

+#define EFI_ACPI_6_1_NFIT_FLUSH_HINT_ADDRESS_STRUCTURE_TYPE                         6

+

+//

+// Definition for NFIT Structure Header

+//

+typedef struct {

+  UINT16                                      Type;

+  UINT16                                      Length;

+} EFI_ACPI_6_1_NFIT_STRUCTURE_HEADER;

+

+//

+// Definition for System Physical Address Range Structure

+//

+#define EFI_ACPI_6_1_NFIT_SYSTEM_PHYSICAL_ADDRESS_RANGE_FLAGS_CONTROL_REGION_FOR_MANAGEMENT      BIT0

+#define EFI_ACPI_6_1_NFIT_SYSTEM_PHYSICAL_ADDRESS_RANGE_FLAGS_PROXIMITY_DOMAIN_VALID             BIT1

+#define EFI_ACPI_6_1_NFIT_GUID_VOLATILE_MEMORY_REGION                             { 0x7305944F, 0xFDDA, 0x44E3, { 0xB1, 0x6C, 0x3F, 0x22, 0xD2, 0x52, 0xE5, 0xD0 }}

+#define EFI_ACPI_6_1_NFIT_GUID_BYTE_ADDRESSABLE_PERSISTENT_MEMORY_REGION          { 0x66F0D379, 0xB4F3, 0x4074, { 0xAC, 0x43, 0x0D, 0x33, 0x18, 0xB7, 0x8C, 0xDB }}

+#define EFI_ACPI_6_1_NFIT_GUID_NVDIMM_CONTROL_REGION                              { 0x92F701F6, 0x13B4, 0x405D, { 0x91, 0x0B, 0x29, 0x93, 0x67, 0xE8, 0x23, 0x4C }}

+#define EFI_ACPI_6_1_NFIT_GUID_NVDIMM_BLOCK_DATA_WINDOW_REGION                    { 0x91AF0530, 0x5D86, 0x470E, { 0xA6, 0xB0, 0x0A, 0x2D, 0xB9, 0x40, 0x82, 0x49 }}

+#define EFI_ACPI_6_1_NFIT_GUID_RAM_DISK_SUPPORTING_VIRTUAL_DISK_REGION_VOLATILE   { 0x77AB535A, 0x45FC, 0x624B, { 0x55, 0x60, 0xF7, 0xB2, 0x81, 0xD1, 0xF9, 0x6E }}

+#define EFI_ACPI_6_1_NFIT_GUID_RAM_DISK_SUPPORTING_VIRTUAL_CD_REGION_VOLATILE     { 0x3D5ABD30, 0x4175, 0x87CE, { 0x6D, 0x64, 0xD2, 0xAD, 0xE5, 0x23, 0xC4, 0xBB }}

+#define EFI_ACPI_6_1_NFIT_GUID_RAM_DISK_SUPPORTING_VIRTUAL_DISK_REGION_PERSISTENT { 0x5CEA02C9, 0x4D07, 0x69D3, { 0x26, 0x9F ,0x44, 0x96, 0xFB, 0xE0, 0x96, 0xF9 }}

+#define EFI_ACPI_6_1_NFIT_GUID_RAM_DISK_SUPPORTING_VIRTUAL_CD_REGION_PERSISTENT   { 0x08018188, 0x42CD, 0xBB48, { 0x10, 0x0F, 0x53, 0x87, 0xD5, 0x3D, 0xED, 0x3D }}

+typedef struct {

+  UINT16                                      Type;

+  UINT16                                      Length;

+  UINT16                                      SPARangeStructureIndex;

+  UINT16                                      Flags;

+  UINT32                                      Reserved_8;

+  UINT32                                      ProximityDomain;

+  GUID                                        AddressRangeTypeGUID;

+  UINT64                                      SystemPhysicalAddressRangeBase;

+  UINT64                                      SystemPhysicalAddressRangeLength;

+  UINT64                                      AddressRangeMemoryMappingAttribute;

+} EFI_ACPI_6_1_NFIT_SYSTEM_PHYSICAL_ADDRESS_RANGE_STRUCTURE;

+

+//

+// Definition for Memory Device to System Physical Address Range Mapping Structure

+//

+typedef struct {

+  UINT32                                      DIMMNumber:4;

+  UINT32                                      MemoryChannelNumber:4;

+  UINT32                                      MemoryControllerID:4;

+  UINT32                                      SocketID:4;

+  UINT32                                      NodeControllerID:12;

+  UINT32                                      Reserved_28:4;

+} EFI_ACPI_6_1_NFIT_DEVICE_HANDLE;

+

+#define EFI_ACPI_6_1_NFIT_MEMORY_DEVICE_STATE_FLAGS_PREVIOUS_SAVE_FAIL                                      BIT0

+#define EFI_ACPI_6_1_NFIT_MEMORY_DEVICE_STATE_FLAGS_LAST_RESTORE_FAIL                                       BIT1

+#define EFI_ACPI_6_1_NFIT_MEMORY_DEVICE_STATE_FLAGS_PLATFORM_FLUSH_FAIL                                     BIT2

+#define EFI_ACPI_6_1_NFIT_MEMORY_DEVICE_STATE_FLAGS_NOT_ARMED_PRIOR_TO_OSPM_HAND_OFF                        BIT3

+#define EFI_ACPI_6_1_NFIT_MEMORY_DEVICE_STATE_FLAGS_SMART_HEALTH_EVENTS_PRIOR_OSPM_HAND_OFF                 BIT4

+#define EFI_ACPI_6_1_NFIT_MEMORY_DEVICE_STATE_FLAGS_FIRMWARE_ENABLED_TO_NOTIFY_OSPM_ON_SMART_HEALTH_EVENTS  BIT5

+#define EFI_ACPI_6_1_NFIT_MEMORY_DEVICE_STATE_FLAGS_FIRMWARE_NOT_MAP_NVDIMM_TO_SPA                          BIT6

+typedef struct {

+  UINT16                                      Type;

+  UINT16                                      Length;

+  EFI_ACPI_6_1_NFIT_DEVICE_HANDLE             NFITDeviceHandle;

+  UINT16                                      NVDIMMPhysicalID;

+  UINT16                                      NVDIMMRegionID;

+  UINT16                                      SPARangeStructureIndex ;

+  UINT16                                      NVDIMMControlRegionStructureIndex;

+  UINT64                                      NVDIMMRegionSize;

+  UINT64                                      RegionOffset;

+  UINT64                                      NVDIMMPhysicalAddressRegionBase;

+  UINT16                                      InterleaveStructureIndex;

+  UINT16                                      InterleaveWays;

+  UINT16                                      NVDIMMStateFlags;

+  UINT16                                      Reserved_46;

+} EFI_ACPI_6_1_NFIT_NVDIMM_REGION_MAPPING_STRUCTURE;

+

+//

+// Definition for Interleave Structure

+//

+typedef struct {

+  UINT16                                      Type;

+  UINT16                                      Length;

+  UINT16                                      InterleaveStructureIndex;

+  UINT16                                      Reserved_6;

+  UINT32                                      NumberOfLines;

+  UINT32                                      LineSize;

+//UINT32                                      LineOffset[NumberOfLines];

+} EFI_ACPI_6_1_NFIT_INTERLEAVE_STRUCTURE;

+

+//

+// Definition for SMBIOS Management Information Structure

+//

+typedef struct {

+  UINT16                                      Type;

+  UINT16                                      Length;

+  UINT32                                      Reserved_4;

+//UINT8                                       Data[];

+} EFI_ACPI_6_1_NFIT_SMBIOS_MANAGEMENT_INFORMATION_STRUCTURE;

+

+//

+// Definition for NVDIMM Control Region Structure

+//

+#define EFI_ACPI_6_1_NFIT_NVDIMM_CONTROL_REGION_VALID_FIELDS_MANUFACTURING           BIT0

+

+#define EFI_ACPI_6_1_NFIT_NVDIMM_CONTROL_REGION_FLAGS_BLOCK_DATA_WINDOWS_BUFFERED    BIT0

+typedef struct {

+  UINT16                                      Type;

+  UINT16                                      Length;

+  UINT16                                      NVDIMMControlRegionStructureIndex;

+  UINT16                                      VendorID;

+  UINT16                                      DeviceID;

+  UINT16                                      RevisionID;

+  UINT16                                      SubsystemVendorID;

+  UINT16                                      SubsystemDeviceID;

+  UINT16                                      SubsystemRevisionID;

+  UINT8                                       ValidFields;

+  UINT8                                       ManufacturingLocation;

+  UINT16                                      ManufacturingDate;

+  UINT8                                       Reserved_22[2];

+  UINT32                                      SerialNumber;

+  UINT16                                      RegionFormatInterfaceCode;

+  UINT16                                      NumberOfBlockControlWindows;

+  UINT64                                      SizeOfBlockControlWindow;

+  UINT64                                      CommandRegisterOffsetInBlockControlWindow;

+  UINT64                                      SizeOfCommandRegisterInBlockControlWindows;

+  UINT64                                      StatusRegisterOffsetInBlockControlWindow;

+  UINT64                                      SizeOfStatusRegisterInBlockControlWindows;

+  UINT16                                      NVDIMMControlRegionFlag;

+  UINT8                                       Reserved_74[6];

+} EFI_ACPI_6_1_NFIT_NVDIMM_CONTROL_REGION_STRUCTURE;

+

+//

+// Definition for NVDIMM Block Data Window Region Structure

+//

+typedef struct {

+  UINT16                                      Type;

+  UINT16                                      Length;

+  UINT16                                      NVDIMMControlRegionStructureIndex;

+  UINT16                                      NumberOfBlockDataWindows;

+  UINT64                                      BlockDataWindowStartOffset;

+  UINT64                                      SizeOfBlockDataWindow;

+  UINT64                                      BlockAccessibleMemoryCapacity;

+  UINT64                                      BeginningAddressOfFirstBlockInBlockAccessibleMemory;

+} EFI_ACPI_6_1_NFIT_NVDIMM_BLOCK_DATA_WINDOW_REGION_STRUCTURE;

+

+//

+// Definition for Flush Hint Address Structure

+//

+typedef struct {

+  UINT16                                      Type;

+  UINT16                                      Length;

+  EFI_ACPI_6_1_NFIT_DEVICE_HANDLE             NFITDeviceHandle;

+  UINT16                                      NumberOfFlushHintAddresses;

+  UINT8                                       Reserved_10[6];

+//UINT64                                      FlushHintAddress[NumberOfFlushHintAddresses];

+} EFI_ACPI_6_1_NFIT_FLUSH_HINT_ADDRESS_STRUCTURE;

+

+///

+/// Boot Error Record Table (BERT)

+///

+typedef struct {

+  EFI_ACPI_DESCRIPTION_HEADER Header;

+  UINT32                      BootErrorRegionLength;

+  UINT64                      BootErrorRegion;

+} EFI_ACPI_6_1_BOOT_ERROR_RECORD_TABLE_HEADER;

+

+///

+/// BERT Version (as defined in ACPI 6.1 spec.)

+///

+#define EFI_ACPI_6_1_BOOT_ERROR_RECORD_TABLE_REVISION 0x01

+

+///

+/// Boot Error Region Block Status Definition

+///

+typedef struct {

+  UINT32       UncorrectableErrorValid:1;

+  UINT32       CorrectableErrorValid:1;

+  UINT32       MultipleUncorrectableErrors:1;

+  UINT32       MultipleCorrectableErrors:1;

+  UINT32       ErrorDataEntryCount:10;

+  UINT32       Reserved:18;

+} EFI_ACPI_6_1_ERROR_BLOCK_STATUS;

+

+///

+/// Boot Error Region Definition

+///

+typedef struct {

+  EFI_ACPI_6_1_ERROR_BLOCK_STATUS              BlockStatus;

+  UINT32                                       RawDataOffset;

+  UINT32                                       RawDataLength;

+  UINT32                                       DataLength;

+  UINT32                                       ErrorSeverity;

+} EFI_ACPI_6_1_BOOT_ERROR_REGION_STRUCTURE;

+

+//

+// Boot Error Severity types

+//

+#define EFI_ACPI_6_1_ERROR_SEVERITY_CORRECTABLE  0x00

+#define EFI_ACPI_6_1_ERROR_SEVERITY_FATAL        0x01

+#define EFI_ACPI_6_1_ERROR_SEVERITY_CORRECTED    0x02

+#define EFI_ACPI_6_1_ERROR_SEVERITY_NONE         0x03

+

+///

+/// Generic Error Data Entry Definition

+///

+typedef struct {

+  UINT8    SectionType[16];

+  UINT32   ErrorSeverity;

+  UINT16   Revision;

+  UINT8    ValidationBits;

+  UINT8    Flags;

+  UINT32   ErrorDataLength;

+  UINT8    FruId[16];

+  UINT8    FruText[20];

+  UINT8    Timestamp[8];

+} EFI_ACPI_6_1_GENERIC_ERROR_DATA_ENTRY_STRUCTURE;

+

+///

+/// Generic Error Data Entry Version (as defined in ACPI 6.1 spec.)

+///

+#define EFI_ACPI_6_1_GENERIC_ERROR_DATA_ENTRY_REVISION  0x0300

+

+///

+/// HEST - Hardware Error Source Table

+///

+typedef struct {

+  EFI_ACPI_DESCRIPTION_HEADER Header;

+  UINT32                      ErrorSourceCount;

+} EFI_ACPI_6_1_HARDWARE_ERROR_SOURCE_TABLE_HEADER;

+

+///

+/// HEST Version (as defined in ACPI 6.1 spec.)

+///

+#define EFI_ACPI_6_1_HARDWARE_ERROR_SOURCE_TABLE_REVISION 0x01

+

+//

+// Error Source structure types.

+//

+#define EFI_ACPI_6_1_IA32_ARCHITECTURE_MACHINE_CHECK_EXCEPTION  0x00

+#define EFI_ACPI_6_1_IA32_ARCHITECTURE_CORRECTED_MACHINE_CHECK  0x01

+#define EFI_ACPI_6_1_IA32_ARCHITECTURE_NMI_ERROR                0x02

+#define EFI_ACPI_6_1_PCI_EXPRESS_ROOT_PORT_AER                  0x06

+#define EFI_ACPI_6_1_PCI_EXPRESS_DEVICE_AER                     0x07

+#define EFI_ACPI_6_1_PCI_EXPRESS_BRIDGE_AER                     0x08

+#define EFI_ACPI_6_1_GENERIC_HARDWARE_ERROR                     0x09

+#define EFI_ACPI_6_1_GENERIC_HARDWARE_ERROR_VERSION_2           0x0A

+

+//

+// Error Source structure flags.

+//

+#define EFI_ACPI_6_1_ERROR_SOURCE_FLAG_FIRMWARE_FIRST       (1 << 0)

+#define EFI_ACPI_6_1_ERROR_SOURCE_FLAG_GLOBAL               (1 << 1)

+

+///

+/// IA-32 Architecture Machine Check Exception Structure Definition

+///

+typedef struct {

+  UINT16  Type;

+  UINT16  SourceId;

+  UINT8   Reserved0[2];

+  UINT8   Flags;

+  UINT8   Enabled;

+  UINT32  NumberOfRecordsToPreAllocate;

+  UINT32  MaxSectionsPerRecord;

+  UINT64  GlobalCapabilityInitData;

+  UINT64  GlobalControlInitData;

+  UINT8   NumberOfHardwareBanks;

+  UINT8   Reserved1[7];

+} EFI_ACPI_6_1_IA32_ARCHITECTURE_MACHINE_CHECK_EXCEPTION_STRUCTURE;

+

+///

+/// IA-32 Architecture Machine Check Bank Structure Definition

+///

+typedef struct {

+  UINT8   BankNumber;

+  UINT8   ClearStatusOnInitialization;

+  UINT8   StatusDataFormat;

+  UINT8   Reserved0;

+  UINT32  ControlRegisterMsrAddress;

+  UINT64  ControlInitData;

+  UINT32  StatusRegisterMsrAddress;

+  UINT32  AddressRegisterMsrAddress;

+  UINT32  MiscRegisterMsrAddress;

+} EFI_ACPI_6_1_IA32_ARCHITECTURE_MACHINE_CHECK_ERROR_BANK_STRUCTURE;

+

+///

+/// IA-32 Architecture Machine Check Bank Structure MCA data format

+///

+#define EFI_ACPI_6_1_IA32_ARCHITECTURE_MACHINE_CHECK_ERROR_DATA_FORMAT_IA32      0x00

+#define EFI_ACPI_6_1_IA32_ARCHITECTURE_MACHINE_CHECK_ERROR_DATA_FORMAT_INTEL64   0x01

+#define EFI_ACPI_6_1_IA32_ARCHITECTURE_MACHINE_CHECK_ERROR_DATA_FORMAT_AMD64     0x02

+

+//

+// Hardware Error Notification types. All other values are reserved

+//

+#define EFI_ACPI_6_1_HARDWARE_ERROR_NOTIFICATION_POLLED                0x00

+#define EFI_ACPI_6_1_HARDWARE_ERROR_NOTIFICATION_EXTERNAL_INTERRUPT    0x01

+#define EFI_ACPI_6_1_HARDWARE_ERROR_NOTIFICATION_LOCAL_INTERRUPT       0x02

+#define EFI_ACPI_6_1_HARDWARE_ERROR_NOTIFICATION_SCI                   0x03

+#define EFI_ACPI_6_1_HARDWARE_ERROR_NOTIFICATION_NMI                   0x04

+#define EFI_ACPI_6_1_HARDWARE_ERROR_NOTIFICATION_CMCI                  0x05

+#define EFI_ACPI_6_1_HARDWARE_ERROR_NOTIFICATION_MCE                   0x06

+#define EFI_ACPI_6_1_HARDWARE_ERROR_NOTIFICATION_GPIO_SIGNAL           0x07

+#define EFI_ACPI_6_1_HARDWARE_ERROR_NOTIFICATION_ARMV8_SEA             0x08

+#define EFI_ACPI_6_1_HARDWARE_ERROR_NOTIFICATION_ARMV8_SEI             0x09

+#define EFI_ACPI_6_1_HARDWARE_ERROR_NOTIFICATION_GSIV                  0x0A

+

+///

+/// Hardware Error Notification Configuration Write Enable Structure Definition

+///

+typedef struct {

+  UINT16    Type:1;

+  UINT16    PollInterval:1;

+  UINT16    SwitchToPollingThresholdValue:1;

+  UINT16    SwitchToPollingThresholdWindow:1;

+  UINT16    ErrorThresholdValue:1;

+  UINT16    ErrorThresholdWindow:1;

+  UINT16    Reserved:10;

+} EFI_ACPI_6_1_HARDWARE_ERROR_NOTIFICATION_CONFIGURATION_WRITE_ENABLE_STRUCTURE;

+

+///

+/// Hardware Error Notification Structure Definition

+///

+typedef struct {

+  UINT8                                                                          Type;

+  UINT8                                                                          Length;

+  EFI_ACPI_6_1_HARDWARE_ERROR_NOTIFICATION_CONFIGURATION_WRITE_ENABLE_STRUCTURE  ConfigurationWriteEnable;

+  UINT32                                                                         PollInterval;

+  UINT32                                                                         Vector;

+  UINT32                                                                         SwitchToPollingThresholdValue;

+  UINT32                                                                         SwitchToPollingThresholdWindow;

+  UINT32                                                                         ErrorThresholdValue;

+  UINT32                                                                         ErrorThresholdWindow;

+} EFI_ACPI_6_1_HARDWARE_ERROR_NOTIFICATION_STRUCTURE;

+

+///

+/// IA-32 Architecture Corrected Machine Check Structure Definition

+///

+typedef struct {

+  UINT16                                                 Type;

+  UINT16                                                 SourceId;

+  UINT8                                                  Reserved0[2];

+  UINT8                                                  Flags;

+  UINT8                                                  Enabled;

+  UINT32                                                 NumberOfRecordsToPreAllocate;

+  UINT32                                                 MaxSectionsPerRecord;

+  EFI_ACPI_6_1_HARDWARE_ERROR_NOTIFICATION_STRUCTURE     NotificationStructure;

+  UINT8                                                  NumberOfHardwareBanks;

+  UINT8                                                  Reserved1[3];

+} EFI_ACPI_6_1_IA32_ARCHITECTURE_CORRECTED_MACHINE_CHECK_STRUCTURE;

+

+///

+/// IA-32 Architecture NMI Error Structure Definition

+///

+typedef struct {

+  UINT16  Type;

+  UINT16  SourceId;

+  UINT8   Reserved0[2];

+  UINT32  NumberOfRecordsToPreAllocate;

+  UINT32  MaxSectionsPerRecord;

+  UINT32  MaxRawDataLength;

+} EFI_ACPI_6_1_IA32_ARCHITECTURE_NMI_ERROR_STRUCTURE;

+

+///

+/// PCI Express Root Port AER Structure Definition

+///

+typedef struct {

+  UINT16  Type;

+  UINT16  SourceId;

+  UINT8   Reserved0[2];

+  UINT8   Flags;

+  UINT8   Enabled;

+  UINT32  NumberOfRecordsToPreAllocate;

+  UINT32  MaxSectionsPerRecord;

+  UINT32  Bus;

+  UINT16  Device;

+  UINT16  Function;

+  UINT16  DeviceControl;

+  UINT8   Reserved1[2];

+  UINT32  UncorrectableErrorMask;

+  UINT32  UncorrectableErrorSeverity;

+  UINT32  CorrectableErrorMask;

+  UINT32  AdvancedErrorCapabilitiesAndControl;

+  UINT32  RootErrorCommand;

+} EFI_ACPI_6_1_PCI_EXPRESS_ROOT_PORT_AER_STRUCTURE;

+

+///

+/// PCI Express Device AER Structure Definition

+///

+typedef struct {

+  UINT16  Type;

+  UINT16  SourceId;

+  UINT8   Reserved0[2];

+  UINT8   Flags;

+  UINT8   Enabled;

+  UINT32  NumberOfRecordsToPreAllocate;

+  UINT32  MaxSectionsPerRecord;

+  UINT32  Bus;

+  UINT16  Device;

+  UINT16  Function;

+  UINT16  DeviceControl;

+  UINT8   Reserved1[2];

+  UINT32  UncorrectableErrorMask;

+  UINT32  UncorrectableErrorSeverity;

+  UINT32  CorrectableErrorMask;

+  UINT32  AdvancedErrorCapabilitiesAndControl;

+} EFI_ACPI_6_1_PCI_EXPRESS_DEVICE_AER_STRUCTURE;

+

+///

+/// PCI Express Bridge AER Structure Definition

+///

+typedef struct {

+  UINT16  Type;

+  UINT16  SourceId;

+  UINT8   Reserved0[2];

+  UINT8   Flags;

+  UINT8   Enabled;

+  UINT32  NumberOfRecordsToPreAllocate;

+  UINT32  MaxSectionsPerRecord;

+  UINT32  Bus;

+  UINT16  Device;

+  UINT16  Function;

+  UINT16  DeviceControl;

+  UINT8   Reserved1[2];

+  UINT32  UncorrectableErrorMask;

+  UINT32  UncorrectableErrorSeverity;

+  UINT32  CorrectableErrorMask;

+  UINT32  AdvancedErrorCapabilitiesAndControl;

+  UINT32  SecondaryUncorrectableErrorMask;

+  UINT32  SecondaryUncorrectableErrorSeverity;

+  UINT32  SecondaryAdvancedErrorCapabilitiesAndControl;

+} EFI_ACPI_6_1_PCI_EXPRESS_BRIDGE_AER_STRUCTURE;

+

+///

+/// Generic Hardware Error Source Structure Definition

+///

+typedef struct {

+  UINT16                                                 Type;

+  UINT16                                                 SourceId;

+  UINT16                                                 RelatedSourceId;

+  UINT8                                                  Flags;

+  UINT8                                                  Enabled;

+  UINT32                                                 NumberOfRecordsToPreAllocate;

+  UINT32                                                 MaxSectionsPerRecord;

+  UINT32                                                 MaxRawDataLength;

+  EFI_ACPI_6_1_GENERIC_ADDRESS_STRUCTURE                 ErrorStatusAddress;

+  EFI_ACPI_6_1_HARDWARE_ERROR_NOTIFICATION_STRUCTURE     NotificationStructure;

+  UINT32                                                 ErrorStatusBlockLength;

+} EFI_ACPI_6_1_GENERIC_HARDWARE_ERROR_SOURCE_STRUCTURE;

+

+///

+/// Generic Hardware Error Source Version 2 Structure Definition

+///

+typedef struct {

+  UINT16                                                 Type;

+  UINT16                                                 SourceId;

+  UINT16                                                 RelatedSourceId;

+  UINT8                                                  Flags;

+  UINT8                                                  Enabled;

+  UINT32                                                 NumberOfRecordsToPreAllocate;

+  UINT32                                                 MaxSectionsPerRecord;

+  UINT32                                                 MaxRawDataLength;

+  EFI_ACPI_6_1_GENERIC_ADDRESS_STRUCTURE                 ErrorStatusAddress;

+  EFI_ACPI_6_1_HARDWARE_ERROR_NOTIFICATION_STRUCTURE     NotificationStructure;

+  UINT32                                                 ErrorStatusBlockLength;

+  EFI_ACPI_6_1_GENERIC_ADDRESS_STRUCTURE                 ReadAckRegister;

+  UINT64                                                 ReadAckPreserve;

+  UINT64                                                 ReadAckWrite;

+} EFI_ACPI_6_1_GENERIC_HARDWARE_ERROR_SOURCE_VERSION_2_STRUCTURE;

+

+///

+/// Generic Error Status Definition

+///

+typedef struct {

+  EFI_ACPI_6_1_ERROR_BLOCK_STATUS              BlockStatus;

+  UINT32                                       RawDataOffset;

+  UINT32                                       RawDataLength;

+  UINT32                                       DataLength;

+  UINT32                                       ErrorSeverity;

+} EFI_ACPI_6_1_GENERIC_ERROR_STATUS_STRUCTURE;

+

+///

+/// ERST - Error Record Serialization Table

+///

+typedef struct {

+  EFI_ACPI_DESCRIPTION_HEADER Header;

+  UINT32                      SerializationHeaderSize;

+  UINT8                       Reserved0[4];

+  UINT32                      InstructionEntryCount;

+} EFI_ACPI_6_1_ERROR_RECORD_SERIALIZATION_TABLE_HEADER;

+

+///

+/// ERST Version (as defined in ACPI 6.1 spec.)

+///

+#define EFI_ACPI_6_1_ERROR_RECORD_SERIALIZATION_TABLE_REVISION 0x01

+

+///

+/// ERST Serialization Actions

+///

+#define EFI_ACPI_6_1_ERST_BEGIN_WRITE_OPERATION                    0x00

+#define EFI_ACPI_6_1_ERST_BEGIN_READ_OPERATION                     0x01

+#define EFI_ACPI_6_1_ERST_BEGIN_CLEAR_OPERATION                    0x02

+#define EFI_ACPI_6_1_ERST_END_OPERATION                            0x03

+#define EFI_ACPI_6_1_ERST_SET_RECORD_OFFSET                        0x04

+#define EFI_ACPI_6_1_ERST_EXECUTE_OPERATION                        0x05

+#define EFI_ACPI_6_1_ERST_CHECK_BUSY_STATUS                        0x06

+#define EFI_ACPI_6_1_ERST_GET_COMMAND_STATUS                       0x07

+#define EFI_ACPI_6_1_ERST_GET_RECORD_IDENTIFIER                    0x08

+#define EFI_ACPI_6_1_ERST_SET_RECORD_IDENTIFIER                    0x09

+#define EFI_ACPI_6_1_ERST_GET_RECORD_COUNT                         0x0A

+#define EFI_ACPI_6_1_ERST_BEGIN_DUMMY_WRITE_OPERATION              0x0B

+#define EFI_ACPI_6_1_ERST_GET_ERROR_LOG_ADDRESS_RANGE              0x0D

+#define EFI_ACPI_6_1_ERST_GET_ERROR_LOG_ADDRESS_RANGE_LENGTH       0x0E

+#define EFI_ACPI_6_1_ERST_GET_ERROR_LOG_ADDRESS_RANGE_ATTRIBUTES   0x0F

+#define EFI_ACPI_6_1_ERST_GET_EXECUTE_OPERATION_TIMINGS            0x10

+

+///

+/// ERST Action Command Status

+///

+#define EFI_ACPI_6_1_ERST_STATUS_SUCCESS                           0x00

+#define EFI_ACPI_6_1_ERST_STATUS_NOT_ENOUGH_SPACE                  0x01

+#define EFI_ACPI_6_1_ERST_STATUS_HARDWARE_NOT_AVAILABLE            0x02

+#define EFI_ACPI_6_1_ERST_STATUS_FAILED                            0x03

+#define EFI_ACPI_6_1_ERST_STATUS_RECORD_STORE_EMPTY                0x04

+#define EFI_ACPI_6_1_ERST_STATUS_RECORD_NOT_FOUND                  0x05

+

+///

+/// ERST Serialization Instructions

+///

+#define EFI_ACPI_6_1_ERST_READ_REGISTER                            0x00

+#define EFI_ACPI_6_1_ERST_READ_REGISTER_VALUE                      0x01

+#define EFI_ACPI_6_1_ERST_WRITE_REGISTER                           0x02

+#define EFI_ACPI_6_1_ERST_WRITE_REGISTER_VALUE                     0x03

+#define EFI_ACPI_6_1_ERST_NOOP                                     0x04

+#define EFI_ACPI_6_1_ERST_LOAD_VAR1                                0x05

+#define EFI_ACPI_6_1_ERST_LOAD_VAR2                                0x06

+#define EFI_ACPI_6_1_ERST_STORE_VAR1                               0x07

+#define EFI_ACPI_6_1_ERST_ADD                                      0x08

+#define EFI_ACPI_6_1_ERST_SUBTRACT                                 0x09

+#define EFI_ACPI_6_1_ERST_ADD_VALUE                                0x0A

+#define EFI_ACPI_6_1_ERST_SUBTRACT_VALUE                           0x0B

+#define EFI_ACPI_6_1_ERST_STALL                                    0x0C

+#define EFI_ACPI_6_1_ERST_STALL_WHILE_TRUE                         0x0D

+#define EFI_ACPI_6_1_ERST_SKIP_NEXT_INSTRUCTION_IF_TRUE            0x0E

+#define EFI_ACPI_6_1_ERST_GOTO                                     0x0F

+#define EFI_ACPI_6_1_ERST_SET_SRC_ADDRESS_BASE                     0x10

+#define EFI_ACPI_6_1_ERST_SET_DST_ADDRESS_BASE                     0x11

+#define EFI_ACPI_6_1_ERST_MOVE_DATA                                0x12

+

+///

+/// ERST Instruction Flags

+///

+#define EFI_ACPI_6_1_ERST_PRESERVE_REGISTER                        0x01

+

+///

+/// ERST Serialization Instruction Entry

+///

+typedef struct {

+  UINT8                                    SerializationAction;

+  UINT8                                    Instruction;

+  UINT8                                    Flags;

+  UINT8                                    Reserved0;

+  EFI_ACPI_6_1_GENERIC_ADDRESS_STRUCTURE   RegisterRegion;

+  UINT64                                   Value;

+  UINT64                                   Mask;

+} EFI_ACPI_6_1_ERST_SERIALIZATION_INSTRUCTION_ENTRY;

+

+///

+/// EINJ - Error Injection Table

+///

+typedef struct {

+  EFI_ACPI_DESCRIPTION_HEADER Header;

+  UINT32                      InjectionHeaderSize;

+  UINT8                       InjectionFlags;

+  UINT8                       Reserved0[3];

+  UINT32                      InjectionEntryCount;

+} EFI_ACPI_6_1_ERROR_INJECTION_TABLE_HEADER;

+

+///

+/// EINJ Version (as defined in ACPI 6.1 spec.)

+///

+#define EFI_ACPI_6_1_ERROR_INJECTION_TABLE_REVISION 0x01

+

+///

+/// EINJ Error Injection Actions

+///

+#define EFI_ACPI_6_1_EINJ_BEGIN_INJECTION_OPERATION                0x00

+#define EFI_ACPI_6_1_EINJ_GET_TRIGGER_ERROR_ACTION_TABLE           0x01

+#define EFI_ACPI_6_1_EINJ_SET_ERROR_TYPE                           0x02

+#define EFI_ACPI_6_1_EINJ_GET_ERROR_TYPE                           0x03

+#define EFI_ACPI_6_1_EINJ_END_OPERATION                            0x04

+#define EFI_ACPI_6_1_EINJ_EXECUTE_OPERATION                        0x05

+#define EFI_ACPI_6_1_EINJ_CHECK_BUSY_STATUS                        0x06

+#define EFI_ACPI_6_1_EINJ_GET_COMMAND_STATUS                       0x07

+#define EFI_ACPI_6_1_EINJ_TRIGGER_ERROR                            0xFF

+

+///

+/// EINJ Action Command Status

+///

+#define EFI_ACPI_6_1_EINJ_STATUS_SUCCESS                           0x00

+#define EFI_ACPI_6_1_EINJ_STATUS_UNKNOWN_FAILURE                   0x01

+#define EFI_ACPI_6_1_EINJ_STATUS_INVALID_ACCESS                    0x02

+

+///

+/// EINJ Error Type Definition

+///

+#define EFI_ACPI_6_1_EINJ_ERROR_PROCESSOR_CORRECTABLE                 (1 << 0)

+#define EFI_ACPI_6_1_EINJ_ERROR_PROCESSOR_UNCORRECTABLE_NONFATAL      (1 << 1)

+#define EFI_ACPI_6_1_EINJ_ERROR_PROCESSOR_UNCORRECTABLE_FATAL         (1 << 2)

+#define EFI_ACPI_6_1_EINJ_ERROR_MEMORY_CORRECTABLE                    (1 << 3)

+#define EFI_ACPI_6_1_EINJ_ERROR_MEMORY_UNCORRECTABLE_NONFATAL         (1 << 4)

+#define EFI_ACPI_6_1_EINJ_ERROR_MEMORY_UNCORRECTABLE_FATAL            (1 << 5)

+#define EFI_ACPI_6_1_EINJ_ERROR_PCI_EXPRESS_CORRECTABLE               (1 << 6)

+#define EFI_ACPI_6_1_EINJ_ERROR_PCI_EXPRESS_UNCORRECTABLE_NONFATAL    (1 << 7)

+#define EFI_ACPI_6_1_EINJ_ERROR_PCI_EXPRESS_UNCORRECTABLE_FATAL       (1 << 8)

+#define EFI_ACPI_6_1_EINJ_ERROR_PLATFORM_CORRECTABLE                  (1 << 9)

+#define EFI_ACPI_6_1_EINJ_ERROR_PLATFORM_UNCORRECTABLE_NONFATAL       (1 << 10)

+#define EFI_ACPI_6_1_EINJ_ERROR_PLATFORM_UNCORRECTABLE_FATAL          (1 << 11)

+

+///

+/// EINJ Injection Instructions

+///

+#define EFI_ACPI_6_1_EINJ_READ_REGISTER                            0x00

+#define EFI_ACPI_6_1_EINJ_READ_REGISTER_VALUE                      0x01

+#define EFI_ACPI_6_1_EINJ_WRITE_REGISTER                           0x02

+#define EFI_ACPI_6_1_EINJ_WRITE_REGISTER_VALUE                     0x03

+#define EFI_ACPI_6_1_EINJ_NOOP                                     0x04

+

+///

+/// EINJ Instruction Flags

+///

+#define EFI_ACPI_6_1_EINJ_PRESERVE_REGISTER                        0x01

+

+///

+/// EINJ Injection Instruction Entry

+///

+typedef struct {

+  UINT8                                    InjectionAction;

+  UINT8                                    Instruction;

+  UINT8                                    Flags;

+  UINT8                                    Reserved0;

+  EFI_ACPI_6_1_GENERIC_ADDRESS_STRUCTURE   RegisterRegion;

+  UINT64                                   Value;

+  UINT64                                   Mask;

+} EFI_ACPI_6_1_EINJ_INJECTION_INSTRUCTION_ENTRY;

+

+///

+/// EINJ Trigger Action Table

+///

+typedef struct {

+  UINT32  HeaderSize;

+  UINT32  Revision;

+  UINT32  TableSize;

+  UINT32  EntryCount;

+} EFI_ACPI_6_1_EINJ_TRIGGER_ACTION_TABLE;

+

+///

+/// Platform Communications Channel Table (PCCT)

+///

+typedef struct {

+  EFI_ACPI_DESCRIPTION_HEADER Header;

+  UINT32                      Flags;

+  UINT64                      Reserved;

+} EFI_ACPI_6_1_PLATFORM_COMMUNICATION_CHANNEL_TABLE_HEADER;

+

+///

+/// PCCT Version (as defined in ACPI 6.1 spec.)

+///

+#define EFI_ACPI_6_1_PLATFORM_COMMUNICATION_CHANNEL_TABLE_REVISION 0x01

+

+///

+/// PCCT Global Flags

+///

+#define EFI_ACPI_6_1_PCCT_FLAGS_SCI_DOORBELL                      BIT0

+

+//

+// PCCT Subspace type

+//

+#define EFI_ACPI_6_1_PCCT_SUBSPACE_TYPE_GENERIC                         0x00

+#define EFI_ACPI_6_1_PCCT_SUBSPACE_TYPE_1_HW_REDUCED_COMMUNICATIONS     0x01

+#define EFI_ACPI_6_1_PCCT_SUBSPACE_TYPE_2_HW_REDUCED_COMMUNICATIONS     0x02

+

+///

+/// PCC Subspace Structure Header

+///

+typedef struct {

+  UINT8        Type;

+  UINT8        Length;

+} EFI_ACPI_6_1_PCCT_SUBSPACE_HEADER;

+

+///

+/// Generic Communications Subspace Structure

+///

+typedef struct {

+  UINT8                                    Type;

+  UINT8                                    Length;

+  UINT8                                    Reserved[6];

+  UINT64                                   BaseAddress;

+  UINT64                                   AddressLength;

+  EFI_ACPI_6_1_GENERIC_ADDRESS_STRUCTURE   DoorbellRegister;

+  UINT64                                   DoorbellPreserve;

+  UINT64                                   DoorbellWrite;

+  UINT32                                   NominalLatency;

+  UINT32                                   MaximumPeriodicAccessRate;

+  UINT16                                   MinimumRequestTurnaroundTime;

+} EFI_ACPI_6_1_PCCT_SUBSPACE_GENERIC;

+

+///

+/// Generic Communications Channel Shared Memory Region

+///

+

+typedef struct {

+  UINT8                                    Command;

+  UINT8                                    Reserved:7;

+  UINT8                                    GenerateSci:1;

+} EFI_ACPI_6_1_PCCT_GENERIC_SHARED_MEMORY_REGION_COMMAND;

+

+typedef struct {

+  UINT8                                    CommandComplete:1;

+  UINT8                                    SciDoorbell:1;

+  UINT8                                    Error:1;

+  UINT8                                    PlatformNotification:1;

+  UINT8                                    Reserved:4;

+  UINT8                                    Reserved1;

+} EFI_ACPI_6_1_PCCT_GENERIC_SHARED_MEMORY_REGION_STATUS;

+

+typedef struct {

+  UINT32                                                    Signature;

+  EFI_ACPI_6_1_PCCT_GENERIC_SHARED_MEMORY_REGION_COMMAND    Command;

+  EFI_ACPI_6_1_PCCT_GENERIC_SHARED_MEMORY_REGION_STATUS     Status;

+} EFI_ACPI_6_1_PCCT_GENERIC_SHARED_MEMORY_REGION_HEADER;

+

+#define EFI_ACPI_6_1_PCCT_SUBSPACE_DOORBELL_INTERRUPT_FLAGS_POLARITY    BIT0

+#define EFI_ACPI_6_1_PCCT_SUBSPACE_DOORBELL_INTERRUPT_FLAGS_MODE        BIT1

+

+///

+/// Type 1 HW-Reduced Communications Subspace Structure

+///

+typedef struct {

+  UINT8                                    Type;

+  UINT8                                    Length;

+  UINT32                                   DoorbellInterrupt;

+  UINT8                                    DoorbellInterruptFlags;

+  UINT8                                    Reserved;

+  UINT64                                   BaseAddress;

+  UINT64                                   AddressLength;

+  EFI_ACPI_6_1_GENERIC_ADDRESS_STRUCTURE   DoorbellRegister;

+  UINT64                                   DoorbellPreserve;

+  UINT64                                   DoorbellWrite;

+  UINT32                                   NominalLatency;

+  UINT32                                   MaximumPeriodicAccessRate;

+  UINT16                                   MinimumRequestTurnaroundTime;

+} EFI_ACPI_6_1_PCCT_SUBSPACE_1_HW_REDUCED_COMMUNICATIONS;

+

+///

+/// Type 2 HW-Reduced Communications Subspace Structure

+///

+typedef struct {

+  UINT8                                    Type;

+  UINT8                                    Length;

+  UINT32                                   DoorbellInterrupt;

+  UINT8                                    DoorbellInterruptFlags;

+  UINT8                                    Reserved;

+  UINT64                                   BaseAddress;

+  UINT64                                   AddressLength;

+  EFI_ACPI_6_1_GENERIC_ADDRESS_STRUCTURE   DoorbellRegister;

+  UINT64                                   DoorbellPreserve;

+  UINT64                                   DoorbellWrite;

+  UINT32                                   NominalLatency;

+  UINT32                                   MaximumPeriodicAccessRate;

+  UINT16                                   MinimumRequestTurnaroundTime;

+  EFI_ACPI_6_1_GENERIC_ADDRESS_STRUCTURE   DoorbellAckRegister;

+  UINT64                                   DoorbellAckPreserve;

+  UINT64                                   DoorbellAckWrite;

+} EFI_ACPI_6_1_PCCT_SUBSPACE_2_HW_REDUCED_COMMUNICATIONS;

+

+//

+// Known table signatures

+//

+

+///

+/// "RSD PTR " Root System Description Pointer

+///

+#define EFI_ACPI_6_1_ROOT_SYSTEM_DESCRIPTION_POINTER_SIGNATURE  SIGNATURE_64('R', 'S', 'D', ' ', 'P', 'T', 'R', ' ')

+

+///

+/// "APIC" Multiple APIC Description Table

+///

+#define EFI_ACPI_6_1_MULTIPLE_APIC_DESCRIPTION_TABLE_SIGNATURE  SIGNATURE_32('A', 'P', 'I', 'C')

+

+///

+/// "BERT" Boot Error Record Table

+///

+#define EFI_ACPI_6_1_BOOT_ERROR_RECORD_TABLE_SIGNATURE  SIGNATURE_32('B', 'E', 'R', 'T')

+

+///

+/// "BGRT" Boot Graphics Resource Table

+///

+#define EFI_ACPI_6_1_BOOT_GRAPHICS_RESOURCE_TABLE_SIGNATURE  SIGNATURE_32('B', 'G', 'R', 'T')

+

+///

+/// "CPEP" Corrected Platform Error Polling Table

+///

+#define EFI_ACPI_6_1_CORRECTED_PLATFORM_ERROR_POLLING_TABLE_SIGNATURE  SIGNATURE_32('C', 'P', 'E', 'P')

+

+///

+/// "DSDT" Differentiated System Description Table

+///

+#define EFI_ACPI_6_1_DIFFERENTIATED_SYSTEM_DESCRIPTION_TABLE_SIGNATURE  SIGNATURE_32('D', 'S', 'D', 'T')

+

+///

+/// "ECDT" Embedded Controller Boot Resources Table

+///

+#define EFI_ACPI_6_1_EMBEDDED_CONTROLLER_BOOT_RESOURCES_TABLE_SIGNATURE  SIGNATURE_32('E', 'C', 'D', 'T')

+

+///

+/// "EINJ" Error Injection Table

+///

+#define EFI_ACPI_6_1_ERROR_INJECTION_TABLE_SIGNATURE  SIGNATURE_32('E', 'I', 'N', 'J')

+

+///

+/// "ERST" Error Record Serialization Table

+///

+#define EFI_ACPI_6_1_ERROR_RECORD_SERIALIZATION_TABLE_SIGNATURE  SIGNATURE_32('E', 'R', 'S', 'T')

+

+///

+/// "FACP" Fixed ACPI Description Table

+///

+#define EFI_ACPI_6_1_FIXED_ACPI_DESCRIPTION_TABLE_SIGNATURE  SIGNATURE_32('F', 'A', 'C', 'P')

+

+///

+/// "FACS" Firmware ACPI Control Structure

+///

+#define EFI_ACPI_6_1_FIRMWARE_ACPI_CONTROL_STRUCTURE_SIGNATURE  SIGNATURE_32('F', 'A', 'C', 'S')

+

+///

+/// "FPDT" Firmware Performance Data Table

+///

+#define EFI_ACPI_6_1_FIRMWARE_PERFORMANCE_DATA_TABLE_SIGNATURE  SIGNATURE_32('F', 'P', 'D', 'T')

+

+///

+/// "GTDT" Generic Timer Description Table

+///

+#define EFI_ACPI_6_1_GENERIC_TIMER_DESCRIPTION_TABLE_SIGNATURE  SIGNATURE_32('G', 'T', 'D', 'T')

+

+///

+/// "HEST" Hardware Error Source Table

+///

+#define EFI_ACPI_6_1_HARDWARE_ERROR_SOURCE_TABLE_SIGNATURE  SIGNATURE_32('H', 'E', 'S', 'T')

+

+///

+/// "MPST" Memory Power State Table

+///

+#define EFI_ACPI_6_1_MEMORY_POWER_STATE_TABLE_SIGNATURE  SIGNATURE_32('M', 'P', 'S', 'T')

+

+///

+/// "MSCT" Maximum System Characteristics Table

+///

+#define EFI_ACPI_6_1_MAXIMUM_SYSTEM_CHARACTERISTICS_TABLE_SIGNATURE  SIGNATURE_32('M', 'S', 'C', 'T')

+

+///

+/// "NFIT" NVDIMM Firmware Interface Table

+///

+#define EFI_ACPI_6_1_NVDIMM_FIRMWARE_INTERFACE_TABLE_STRUCTURE_SIGNATURE  SIGNATURE_32('N', 'F', 'I', 'T')

+

+///

+/// "PMTT" Platform Memory Topology Table

+///

+#define EFI_ACPI_6_1_PLATFORM_MEMORY_TOPOLOGY_TABLE_SIGNATURE  SIGNATURE_32('P', 'M', 'T', 'T')

+

+///

+/// "PSDT" Persistent System Description Table

+///

+#define EFI_ACPI_6_1_PERSISTENT_SYSTEM_DESCRIPTION_TABLE_SIGNATURE  SIGNATURE_32('P', 'S', 'D', 'T')

+

+///

+/// "RASF" ACPI RAS Feature Table

+///

+#define EFI_ACPI_6_1_ACPI_RAS_FEATURE_TABLE_SIGNATURE  SIGNATURE_32('R', 'A', 'S', 'F')

+

+///

+/// "RSDT" Root System Description Table

+///

+#define EFI_ACPI_6_1_ROOT_SYSTEM_DESCRIPTION_TABLE_SIGNATURE  SIGNATURE_32('R', 'S', 'D', 'T')

+

+///

+/// "SBST" Smart Battery Specification Table

+///

+#define EFI_ACPI_6_1_SMART_BATTERY_SPECIFICATION_TABLE_SIGNATURE  SIGNATURE_32('S', 'B', 'S', 'T')

+

+///

+/// "SLIT" System Locality Information Table

+///

+#define EFI_ACPI_6_1_SYSTEM_LOCALITY_INFORMATION_TABLE_SIGNATURE  SIGNATURE_32('S', 'L', 'I', 'T')

+

+///

+/// "SRAT" System Resource Affinity Table

+///

+#define EFI_ACPI_6_1_SYSTEM_RESOURCE_AFFINITY_TABLE_SIGNATURE  SIGNATURE_32('S', 'R', 'A', 'T')

+

+///

+/// "SSDT" Secondary System Description Table

+///

+#define EFI_ACPI_6_1_SECONDARY_SYSTEM_DESCRIPTION_TABLE_SIGNATURE  SIGNATURE_32('S', 'S', 'D', 'T')

+

+///

+/// "XSDT" Extended System Description Table

+///

+#define EFI_ACPI_6_1_EXTENDED_SYSTEM_DESCRIPTION_TABLE_SIGNATURE  SIGNATURE_32('X', 'S', 'D', 'T')

+

+///

+/// "BOOT" MS Simple Boot Spec

+///

+#define EFI_ACPI_6_1_SIMPLE_BOOT_FLAG_TABLE_SIGNATURE  SIGNATURE_32('B', 'O', 'O', 'T')

+

+///

+/// "CSRT" MS Core System Resource Table

+///

+#define EFI_ACPI_6_1_CORE_SYSTEM_RESOURCE_TABLE_SIGNATURE  SIGNATURE_32('C', 'S', 'R', 'T')

+

+///

+/// "DBG2" MS Debug Port 2 Spec

+///

+#define EFI_ACPI_6_1_DEBUG_PORT_2_TABLE_SIGNATURE  SIGNATURE_32('D', 'B', 'G', '2')

+

+///

+/// "DBGP" MS Debug Port Spec

+///

+#define EFI_ACPI_6_1_DEBUG_PORT_TABLE_SIGNATURE  SIGNATURE_32('D', 'B', 'G', 'P')

+

+///

+/// "DMAR" DMA Remapping Table

+///

+#define EFI_ACPI_6_1_DMA_REMAPPING_TABLE_SIGNATURE  SIGNATURE_32('D', 'M', 'A', 'R')

+

+///

+/// "DRTM" Dynamic Root of Trust for Measurement Table

+///

+#define EFI_ACPI_6_1_DYNAMIC_ROOT_OF_TRUST_FOR_MEASUREMENT_TABLE_SIGNATURE  SIGNATURE_32('D', 'R', 'T', 'M')

+

+///

+/// "ETDT" Event Timer Description Table

+///

+#define EFI_ACPI_6_1_EVENT_TIMER_DESCRIPTION_TABLE_SIGNATURE  SIGNATURE_32('E', 'T', 'D', 'T')

+

+///

+/// "HPET" IA-PC High Precision Event Timer Table

+///

+#define EFI_ACPI_6_1_HIGH_PRECISION_EVENT_TIMER_TABLE_SIGNATURE  SIGNATURE_32('H', 'P', 'E', 'T')

+

+///

+/// "iBFT" iSCSI Boot Firmware Table

+///

+#define EFI_ACPI_6_1_ISCSI_BOOT_FIRMWARE_TABLE_SIGNATURE  SIGNATURE_32('i', 'B', 'F', 'T')

+

+///

+/// "IORT" I/O Remapping Table

+///

+#define EFI_ACPI_6_1_IO_REMAPPING_TABLE_SIGNATURE  SIGNATURE_32('I', 'O', 'R', 'T')

+

+///

+/// "IVRS" I/O Virtualization Reporting Structure

+///

+#define EFI_ACPI_6_1_IO_VIRTUALIZATION_REPORTING_STRUCTURE_SIGNATURE  SIGNATURE_32('I', 'V', 'R', 'S')

+

+///

+/// "LPIT" Low Power Idle Table

+///

+#define EFI_ACPI_6_1_LOW_POWER_IDLE_TABLE_STRUCTURE_SIGNATURE  SIGNATURE_32('L', 'P', 'I', 'T')

+

+///

+/// "MCFG" PCI Express Memory Mapped Configuration Space Base Address Description Table

+///

+#define EFI_ACPI_6_1_PCI_EXPRESS_MEMORY_MAPPED_CONFIGURATION_SPACE_BASE_ADDRESS_DESCRIPTION_TABLE_SIGNATURE  SIGNATURE_32('M', 'C', 'F', 'G')

+

+///

+/// "MCHI" Management Controller Host Interface Table

+///

+#define EFI_ACPI_6_1_MANAGEMENT_CONTROLLER_HOST_INTERFACE_TABLE_SIGNATURE  SIGNATURE_32('M', 'C', 'H', 'I')

+

+///

+/// "MSDM" MS Data Management Table

+///

+#define EFI_ACPI_6_1_DATA_MANAGEMENT_TABLE_SIGNATURE  SIGNATURE_32('M', 'S', 'D', 'M')

+

+///

+/// "PCCT" Platform Communications Channel Table

+///

+#define EFI_ACPI_6_1_PLATFORM_COMMUNICATIONS_CHANNEL_TABLE_SIGNATURE  SIGNATURE_32('P', 'C', 'C', 'T')

+

+///

+/// "SLIC" MS Software Licensing Table Specification

+///

+#define EFI_ACPI_6_1_SOFTWARE_LICENSING_TABLE_SIGNATURE  SIGNATURE_32('S', 'L', 'I', 'C')

+

+///

+/// "SPCR" Serial Port Console Redirection Table

+///

+#define EFI_ACPI_6_1_SERIAL_PORT_CONSOLE_REDIRECTION_TABLE_SIGNATURE  SIGNATURE_32('S', 'P', 'C', 'R')

+

+///

+/// "SPMI" Server Platform Management Interface Table

+///

+#define EFI_ACPI_6_1_SERVER_PLATFORM_MANAGEMENT_INTERFACE_TABLE_SIGNATURE  SIGNATURE_32('S', 'P', 'M', 'I')

+

+///

+/// "STAO" _STA Override Table

+///

+#define EFI_ACPI_6_1_STA_OVERRIDE_TABLE_SIGNATURE  SIGNATURE_32('S', 'T', 'A', 'O')

+

+///

+/// "TCPA" Trusted Computing Platform Alliance Capabilities Table

+///

+#define EFI_ACPI_6_1_TRUSTED_COMPUTING_PLATFORM_ALLIANCE_CAPABILITIES_TABLE_SIGNATURE  SIGNATURE_32('T', 'C', 'P', 'A')

+

+///

+/// "TPM2" Trusted Computing Platform 1 Table

+///

+#define EFI_ACPI_6_1_TRUSTED_COMPUTING_PLATFORM_2_TABLE_SIGNATURE  SIGNATURE_32('T', 'P', 'M', '2')

+

+///

+/// "UEFI" UEFI ACPI Data Table

+///

+#define EFI_ACPI_6_1_UEFI_ACPI_DATA_TABLE_SIGNATURE  SIGNATURE_32('U', 'E', 'F', 'I')

+

+///

+/// "WAET" Windows ACPI Emulated Devices Table

+///

+#define EFI_ACPI_6_1_WINDOWS_ACPI_EMULATED_DEVICES_TABLE_SIGNATURE  SIGNATURE_32('W', 'A', 'E', 'T')

+

+///

+/// "WDAT" Watchdog Action Table

+///

+#define EFI_ACPI_6_1_WATCHDOG_ACTION_TABLE_SIGNATURE  SIGNATURE_32('W', 'D', 'A', 'T')

+

+///

+/// "WDRT" Watchdog Resource Table

+///

+#define EFI_ACPI_6_1_WATCHDOG_RESOURCE_TABLE_SIGNATURE  SIGNATURE_32('W', 'D', 'R', 'T')

+

+///

+/// "WPBT" MS Platform Binary Table

+///

+#define EFI_ACPI_6_1_PLATFORM_BINARY_TABLE_SIGNATURE  SIGNATURE_32('W', 'P', 'B', 'T')

+

+///

+/// "XENV" Xen Project Table

+///

+#define EFI_ACPI_6_1_XEN_PROJECT_TABLE_SIGNATURE  SIGNATURE_32('X', 'E', 'N', 'V')

+

+#pragma pack()

+

+#endif

diff --git a/debugging_demo/memtest86+/efi/Include/IndustryStandard/Acpi62.h b/debugging_demo/memtest86+/efi/Include/IndustryStandard/Acpi62.h
new file mode 100644
index 0000000..1b2704e
--- /dev/null
+++ b/debugging_demo/memtest86+/efi/Include/IndustryStandard/Acpi62.h
@@ -0,0 +1,2960 @@
+/** @file

+  ACPI 6.2 definitions from the ACPI Specification Revision 6.2 May, 2017.

+

+  Copyright (c) 2017, Intel Corporation. All rights reserved.<BR>

+  Copyright (c) 2020, ARM Ltd. All rights reserved.<BR>

+  SPDX-License-Identifier: BSD-2-Clause-Patent

+**/

+

+#ifndef _ACPI_6_2_H_

+#define _ACPI_6_2_H_

+

+#include <IndustryStandard/Acpi61.h>

+

+//

+// Large Item Descriptor Name

+//

+#define ACPI_LARGE_PIN_FUNCTION_DESCRIPTOR_NAME              0x0D

+#define ACPI_LARGE_PIN_CONFIGURATION_DESCRIPTOR_NAME         0x0F

+#define ACPI_LARGE_PIN_GROUP_DESCRIPTOR_NAME                 0x10

+#define ACPI_LARGE_PIN_GROUP_FUNCTION_DESCRIPTOR_NAME        0x11

+#define ACPI_LARGE_PIN_GROUP_CONFIGURATION_DESCRIPTOR_NAME   0x12

+

+//

+// Large Item Descriptor Value

+//

+#define ACPI_PIN_FUNCTION_DESCRIPTOR                         0x8D

+#define ACPI_PIN_CONFIGURATION_DESCRIPTOR                    0x8F

+#define ACPI_PIN_GROUP_DESCRIPTOR                            0x90

+#define ACPI_PIN_GROUP_FUNCTION_DESCRIPTOR                   0x91

+#define ACPI_PIN_GROUP_CONFIGURATION_DESCRIPTOR              0x92

+

+#pragma pack(1)

+

+///

+/// Pin Function Descriptor

+///

+typedef PACKED struct {

+  ACPI_LARGE_RESOURCE_HEADER    Header;

+  UINT8                         RevisionId;

+  UINT16                        Flags;

+  UINT8                         PinPullConfiguration;

+  UINT16                        FunctionNumber;

+  UINT16                        PinTableOffset;

+  UINT8                         ResourceSourceIndex;

+  UINT16                        ResourceSourceNameOffset;

+  UINT16                        VendorDataOffset;

+  UINT16                        VendorDataLength;

+} EFI_ACPI_PIN_FUNCTION_DESCRIPTOR;

+

+///

+/// Pin Configuration Descriptor

+///

+typedef PACKED struct {

+  ACPI_LARGE_RESOURCE_HEADER    Header;

+  UINT8                         RevisionId;

+  UINT16                        Flags;

+  UINT8                         PinConfigurationType;

+  UINT32                        PinConfigurationValue;

+  UINT16                        PinTableOffset;

+  UINT8                         ResourceSourceIndex;

+  UINT16                        ResourceSourceNameOffset;

+  UINT16                        VendorDataOffset;

+  UINT16                        VendorDataLength;

+} EFI_ACPI_PIN_CONFIGURATION_DESCRIPTOR;

+

+///

+/// Pin Group Descriptor

+///

+typedef PACKED struct {

+  ACPI_LARGE_RESOURCE_HEADER    Header;

+  UINT8                         RevisionId;

+  UINT16                        Flags;

+  UINT16                        PinTableOffset;

+  UINT16                        ResourceLabelOffset;

+  UINT16                        VendorDataOffset;

+  UINT16                        VendorDataLength;

+} EFI_ACPI_PIN_GROUP_DESCRIPTOR;

+

+///

+/// Pin Group Function Descriptor

+///

+typedef PACKED struct {

+  ACPI_LARGE_RESOURCE_HEADER    Header;

+  UINT8                         RevisionId;

+  UINT16                        Flags;

+  UINT16                        FunctionNumber;

+  UINT8                         ResourceSourceIndex;

+  UINT16                        ResourceSourceNameOffset;

+  UINT16                        ResourceSourceLabelOffset;

+  UINT16                        VendorDataOffset;

+  UINT16                        VendorDataLength;

+} EFI_ACPI_PIN_GROUP_FUNCTION_DESCRIPTOR;

+

+///

+/// Pin Group Configuration Descriptor

+///

+typedef PACKED struct {

+  ACPI_LARGE_RESOURCE_HEADER    Header;

+  UINT8                         RevisionId;

+  UINT16                        Flags;

+  UINT8                         PinConfigurationType;

+  UINT32                        PinConfigurationValue;

+  UINT8                         ResourceSourceIndex;

+  UINT16                        ResourceSourceNameOffset;

+  UINT16                        ResourceSourceLabelOffset;

+  UINT16                        VendorDataOffset;

+  UINT16                        VendorDataLength;

+} EFI_ACPI_PIN_GROUP_CONFIGURATION_DESCRIPTOR;

+

+#pragma pack()

+

+//

+// Ensure proper structure formats

+//

+#pragma pack(1)

+

+///

+/// ACPI 6.2 Generic Address Space definition

+///

+typedef struct {

+  UINT8   AddressSpaceId;

+  UINT8   RegisterBitWidth;

+  UINT8   RegisterBitOffset;

+  UINT8   AccessSize;

+  UINT64  Address;

+} EFI_ACPI_6_2_GENERIC_ADDRESS_STRUCTURE;

+

+//

+// Generic Address Space Address IDs

+//

+#define EFI_ACPI_6_2_SYSTEM_MEMORY              0

+#define EFI_ACPI_6_2_SYSTEM_IO                  1

+#define EFI_ACPI_6_2_PCI_CONFIGURATION_SPACE    2

+#define EFI_ACPI_6_2_EMBEDDED_CONTROLLER        3

+#define EFI_ACPI_6_2_SMBUS                      4

+#define EFI_ACPI_6_2_PLATFORM_COMMUNICATION_CHANNEL  0x0A

+#define EFI_ACPI_6_2_FUNCTIONAL_FIXED_HARDWARE       0x7F

+

+//

+// Generic Address Space Access Sizes

+//

+#define EFI_ACPI_6_2_UNDEFINED  0

+#define EFI_ACPI_6_2_BYTE       1

+#define EFI_ACPI_6_2_WORD       2

+#define EFI_ACPI_6_2_DWORD      3

+#define EFI_ACPI_6_2_QWORD      4

+

+//

+// ACPI 6.2 table structures

+//

+

+///

+/// Root System Description Pointer Structure

+///

+typedef struct {

+  UINT64  Signature;

+  UINT8   Checksum;

+  UINT8   OemId[6];

+  UINT8   Revision;

+  UINT32  RsdtAddress;

+  UINT32  Length;

+  UINT64  XsdtAddress;

+  UINT8   ExtendedChecksum;

+  UINT8   Reserved[3];

+} EFI_ACPI_6_2_ROOT_SYSTEM_DESCRIPTION_POINTER;

+

+///

+/// RSD_PTR Revision (as defined in ACPI 6.2 spec.)

+///

+#define EFI_ACPI_6_2_ROOT_SYSTEM_DESCRIPTION_POINTER_REVISION 0x02  ///< ACPISpec (Revision 6.2) says current value is 2

+

+///

+/// Common table header, this prefaces all ACPI tables, including FACS, but

+/// excluding the RSD PTR structure

+///

+typedef struct {

+  UINT32  Signature;

+  UINT32  Length;

+} EFI_ACPI_6_2_COMMON_HEADER;

+

+//

+// Root System Description Table

+// No definition needed as it is a common description table header, the same with

+// EFI_ACPI_DESCRIPTION_HEADER, followed by a variable number of UINT32 table pointers.

+//

+

+///

+/// RSDT Revision (as defined in ACPI 6.2 spec.)

+///

+#define EFI_ACPI_6_2_ROOT_SYSTEM_DESCRIPTION_TABLE_REVISION 0x01

+

+//

+// Extended System Description Table

+// No definition needed as it is a common description table header, the same with

+// EFI_ACPI_DESCRIPTION_HEADER, followed by a variable number of UINT64 table pointers.

+//

+

+///

+/// XSDT Revision (as defined in ACPI 6.2 spec.)

+///

+#define EFI_ACPI_6_2_EXTENDED_SYSTEM_DESCRIPTION_TABLE_REVISION 0x01

+

+///

+/// Fixed ACPI Description Table Structure (FADT)

+///

+typedef struct {

+  EFI_ACPI_DESCRIPTION_HEADER             Header;

+  UINT32                                  FirmwareCtrl;

+  UINT32                                  Dsdt;

+  UINT8                                   Reserved0;

+  UINT8                                   PreferredPmProfile;

+  UINT16                                  SciInt;

+  UINT32                                  SmiCmd;

+  UINT8                                   AcpiEnable;

+  UINT8                                   AcpiDisable;

+  UINT8                                   S4BiosReq;

+  UINT8                                   PstateCnt;

+  UINT32                                  Pm1aEvtBlk;

+  UINT32                                  Pm1bEvtBlk;

+  UINT32                                  Pm1aCntBlk;

+  UINT32                                  Pm1bCntBlk;

+  UINT32                                  Pm2CntBlk;

+  UINT32                                  PmTmrBlk;

+  UINT32                                  Gpe0Blk;

+  UINT32                                  Gpe1Blk;

+  UINT8                                   Pm1EvtLen;

+  UINT8                                   Pm1CntLen;

+  UINT8                                   Pm2CntLen;

+  UINT8                                   PmTmrLen;

+  UINT8                                   Gpe0BlkLen;

+  UINT8                                   Gpe1BlkLen;

+  UINT8                                   Gpe1Base;

+  UINT8                                   CstCnt;

+  UINT16                                  PLvl2Lat;

+  UINT16                                  PLvl3Lat;

+  UINT16                                  FlushSize;

+  UINT16                                  FlushStride;

+  UINT8                                   DutyOffset;

+  UINT8                                   DutyWidth;

+  UINT8                                   DayAlrm;

+  UINT8                                   MonAlrm;

+  UINT8                                   Century;

+  UINT16                                  IaPcBootArch;

+  UINT8                                   Reserved1;

+  UINT32                                  Flags;

+  EFI_ACPI_6_2_GENERIC_ADDRESS_STRUCTURE  ResetReg;

+  UINT8                                   ResetValue;

+  UINT16                                  ArmBootArch;

+  UINT8                                   MinorVersion;

+  UINT64                                  XFirmwareCtrl;

+  UINT64                                  XDsdt;

+  EFI_ACPI_6_2_GENERIC_ADDRESS_STRUCTURE  XPm1aEvtBlk;

+  EFI_ACPI_6_2_GENERIC_ADDRESS_STRUCTURE  XPm1bEvtBlk;

+  EFI_ACPI_6_2_GENERIC_ADDRESS_STRUCTURE  XPm1aCntBlk;

+  EFI_ACPI_6_2_GENERIC_ADDRESS_STRUCTURE  XPm1bCntBlk;

+  EFI_ACPI_6_2_GENERIC_ADDRESS_STRUCTURE  XPm2CntBlk;

+  EFI_ACPI_6_2_GENERIC_ADDRESS_STRUCTURE  XPmTmrBlk;

+  EFI_ACPI_6_2_GENERIC_ADDRESS_STRUCTURE  XGpe0Blk;

+  EFI_ACPI_6_2_GENERIC_ADDRESS_STRUCTURE  XGpe1Blk;

+  EFI_ACPI_6_2_GENERIC_ADDRESS_STRUCTURE  SleepControlReg;

+  EFI_ACPI_6_2_GENERIC_ADDRESS_STRUCTURE  SleepStatusReg;

+  UINT64                                  HypervisorVendorIdentity;

+} EFI_ACPI_6_2_FIXED_ACPI_DESCRIPTION_TABLE;

+

+///

+/// FADT Version (as defined in ACPI 6.2 spec.)

+///

+#define EFI_ACPI_6_2_FIXED_ACPI_DESCRIPTION_TABLE_REVISION  0x06

+#define EFI_ACPI_6_2_FIXED_ACPI_DESCRIPTION_TABLE_MINOR_REVISION  0x02

+

+//

+// Fixed ACPI Description Table Preferred Power Management Profile

+//

+#define EFI_ACPI_6_2_PM_PROFILE_UNSPECIFIED         0

+#define EFI_ACPI_6_2_PM_PROFILE_DESKTOP             1

+#define EFI_ACPI_6_2_PM_PROFILE_MOBILE              2

+#define EFI_ACPI_6_2_PM_PROFILE_WORKSTATION         3

+#define EFI_ACPI_6_2_PM_PROFILE_ENTERPRISE_SERVER   4

+#define EFI_ACPI_6_2_PM_PROFILE_SOHO_SERVER         5

+#define EFI_ACPI_6_2_PM_PROFILE_APPLIANCE_PC        6

+#define EFI_ACPI_6_2_PM_PROFILE_PERFORMANCE_SERVER  7

+#define EFI_ACPI_6_2_PM_PROFILE_TABLET              8

+

+//

+// Fixed ACPI Description Table Boot Architecture Flags

+// All other bits are reserved and must be set to 0.

+//

+#define EFI_ACPI_6_2_LEGACY_DEVICES              BIT0

+#define EFI_ACPI_6_2_8042                        BIT1

+#define EFI_ACPI_6_2_VGA_NOT_PRESENT             BIT2

+#define EFI_ACPI_6_2_MSI_NOT_SUPPORTED           BIT3

+#define EFI_ACPI_6_2_PCIE_ASPM_CONTROLS          BIT4

+#define EFI_ACPI_6_2_CMOS_RTC_NOT_PRESENT        BIT5

+

+//

+// Fixed ACPI Description Table Arm Boot Architecture Flags

+// All other bits are reserved and must be set to 0.

+//

+#define EFI_ACPI_6_2_ARM_PSCI_COMPLIANT              BIT0

+#define EFI_ACPI_6_2_ARM_PSCI_USE_HVC                BIT1

+

+//

+// Fixed ACPI Description Table Fixed Feature Flags

+// All other bits are reserved and must be set to 0.

+//

+#define EFI_ACPI_6_2_WBINVD                                 BIT0

+#define EFI_ACPI_6_2_WBINVD_FLUSH                           BIT1

+#define EFI_ACPI_6_2_PROC_C1                                BIT2

+#define EFI_ACPI_6_2_P_LVL2_UP                              BIT3

+#define EFI_ACPI_6_2_PWR_BUTTON                             BIT4

+#define EFI_ACPI_6_2_SLP_BUTTON                             BIT5

+#define EFI_ACPI_6_2_FIX_RTC                                BIT6

+#define EFI_ACPI_6_2_RTC_S4                                 BIT7

+#define EFI_ACPI_6_2_TMR_VAL_EXT                            BIT8

+#define EFI_ACPI_6_2_DCK_CAP                                BIT9

+#define EFI_ACPI_6_2_RESET_REG_SUP                          BIT10

+#define EFI_ACPI_6_2_SEALED_CASE                            BIT11

+#define EFI_ACPI_6_2_HEADLESS                               BIT12

+#define EFI_ACPI_6_2_CPU_SW_SLP                             BIT13

+#define EFI_ACPI_6_2_PCI_EXP_WAK                            BIT14

+#define EFI_ACPI_6_2_USE_PLATFORM_CLOCK                     BIT15

+#define EFI_ACPI_6_2_S4_RTC_STS_VALID                       BIT16

+#define EFI_ACPI_6_2_REMOTE_POWER_ON_CAPABLE                BIT17

+#define EFI_ACPI_6_2_FORCE_APIC_CLUSTER_MODEL               BIT18

+#define EFI_ACPI_6_2_FORCE_APIC_PHYSICAL_DESTINATION_MODE   BIT19

+#define EFI_ACPI_6_2_HW_REDUCED_ACPI                        BIT20

+#define EFI_ACPI_6_2_LOW_POWER_S0_IDLE_CAPABLE              BIT21

+

+///

+/// Firmware ACPI Control Structure

+///

+typedef struct {

+  UINT32  Signature;

+  UINT32  Length;

+  UINT32  HardwareSignature;

+  UINT32  FirmwareWakingVector;

+  UINT32  GlobalLock;

+  UINT32  Flags;

+  UINT64  XFirmwareWakingVector;

+  UINT8   Version;

+  UINT8   Reserved0[3];

+  UINT32  OspmFlags;

+  UINT8   Reserved1[24];

+} EFI_ACPI_6_2_FIRMWARE_ACPI_CONTROL_STRUCTURE;

+

+///

+/// FACS Version (as defined in ACPI 6.2 spec.)

+///

+#define EFI_ACPI_6_2_FIRMWARE_ACPI_CONTROL_STRUCTURE_VERSION  0x02

+

+///

+/// Firmware Control Structure Feature Flags

+/// All other bits are reserved and must be set to 0.

+///

+#define EFI_ACPI_6_2_S4BIOS_F                     BIT0

+#define EFI_ACPI_6_2_64BIT_WAKE_SUPPORTED_F       BIT1

+

+///

+/// OSPM Enabled Firmware Control Structure Flags

+/// All other bits are reserved and must be set to 0.

+///

+#define EFI_ACPI_6_2_OSPM_64BIT_WAKE_F            BIT0

+

+//

+// Differentiated System Description Table,

+// Secondary System Description Table

+// and Persistent System Description Table,

+// no definition needed as they are common description table header, the same with

+// EFI_ACPI_DESCRIPTION_HEADER, followed by a definition block.

+//

+#define EFI_ACPI_6_2_DIFFERENTIATED_SYSTEM_DESCRIPTION_TABLE_REVISION   0x02

+#define EFI_ACPI_6_2_SECONDARY_SYSTEM_DESCRIPTION_TABLE_REVISION        0x02

+

+///

+/// Multiple APIC Description Table header definition.  The rest of the table

+/// must be defined in a platform specific manner.

+///

+typedef struct {

+  EFI_ACPI_DESCRIPTION_HEADER Header;

+  UINT32                      LocalApicAddress;

+  UINT32                      Flags;

+} EFI_ACPI_6_2_MULTIPLE_APIC_DESCRIPTION_TABLE_HEADER;

+

+///

+/// MADT Revision (as defined in ACPI 6.2 spec.)

+///

+#define EFI_ACPI_6_2_MULTIPLE_APIC_DESCRIPTION_TABLE_REVISION 0x04

+

+///

+/// Multiple APIC Flags

+/// All other bits are reserved and must be set to 0.

+///

+#define EFI_ACPI_6_2_PCAT_COMPAT         BIT0

+

+//

+// Multiple APIC Description Table APIC structure types

+// All other values between 0x0D and 0x7F are reserved and

+// will be ignored by OSPM. 0x80 ~ 0xFF are reserved for OEM.

+//

+#define EFI_ACPI_6_2_PROCESSOR_LOCAL_APIC           0x00

+#define EFI_ACPI_6_2_IO_APIC                        0x01

+#define EFI_ACPI_6_2_INTERRUPT_SOURCE_OVERRIDE      0x02

+#define EFI_ACPI_6_2_NON_MASKABLE_INTERRUPT_SOURCE  0x03

+#define EFI_ACPI_6_2_LOCAL_APIC_NMI                 0x04

+#define EFI_ACPI_6_2_LOCAL_APIC_ADDRESS_OVERRIDE    0x05

+#define EFI_ACPI_6_2_IO_SAPIC                       0x06

+#define EFI_ACPI_6_2_LOCAL_SAPIC                    0x07

+#define EFI_ACPI_6_2_PLATFORM_INTERRUPT_SOURCES     0x08

+#define EFI_ACPI_6_2_PROCESSOR_LOCAL_X2APIC         0x09

+#define EFI_ACPI_6_2_LOCAL_X2APIC_NMI               0x0A

+#define EFI_ACPI_6_2_GIC                            0x0B

+#define EFI_ACPI_6_2_GICD                           0x0C

+#define EFI_ACPI_6_2_GIC_MSI_FRAME                  0x0D

+#define EFI_ACPI_6_2_GICR                           0x0E

+#define EFI_ACPI_6_2_GIC_ITS                        0x0F

+

+//

+// APIC Structure Definitions

+//

+

+///

+/// Processor Local APIC Structure Definition

+///

+typedef struct {

+  UINT8   Type;

+  UINT8   Length;

+  UINT8   AcpiProcessorUid;

+  UINT8   ApicId;

+  UINT32  Flags;

+} EFI_ACPI_6_2_PROCESSOR_LOCAL_APIC_STRUCTURE;

+

+///

+/// Local APIC Flags.  All other bits are reserved and must be 0.

+///

+#define EFI_ACPI_6_2_LOCAL_APIC_ENABLED        BIT0

+

+///

+/// IO APIC Structure

+///

+typedef struct {

+  UINT8   Type;

+  UINT8   Length;

+  UINT8   IoApicId;

+  UINT8   Reserved;

+  UINT32  IoApicAddress;

+  UINT32  GlobalSystemInterruptBase;

+} EFI_ACPI_6_2_IO_APIC_STRUCTURE;

+

+///

+/// Interrupt Source Override Structure

+///

+typedef struct {

+  UINT8   Type;

+  UINT8   Length;

+  UINT8   Bus;

+  UINT8   Source;

+  UINT32  GlobalSystemInterrupt;

+  UINT16  Flags;

+} EFI_ACPI_6_2_INTERRUPT_SOURCE_OVERRIDE_STRUCTURE;

+

+///

+/// Platform Interrupt Sources Structure Definition

+///

+typedef struct {

+  UINT8   Type;

+  UINT8   Length;

+  UINT16  Flags;

+  UINT8   InterruptType;

+  UINT8   ProcessorId;

+  UINT8   ProcessorEid;

+  UINT8   IoSapicVector;

+  UINT32  GlobalSystemInterrupt;

+  UINT32  PlatformInterruptSourceFlags;

+  UINT8   CpeiProcessorOverride;

+  UINT8   Reserved[31];

+} EFI_ACPI_6_2_PLATFORM_INTERRUPT_APIC_STRUCTURE;

+

+//

+// MPS INTI flags.

+// All other bits are reserved and must be set to 0.

+//

+#define EFI_ACPI_6_2_POLARITY      (3 << 0)

+#define EFI_ACPI_6_2_TRIGGER_MODE  (3 << 2)

+

+///

+/// Non-Maskable Interrupt Source Structure

+///

+typedef struct {

+  UINT8   Type;

+  UINT8   Length;

+  UINT16  Flags;

+  UINT32  GlobalSystemInterrupt;

+} EFI_ACPI_6_2_NON_MASKABLE_INTERRUPT_SOURCE_STRUCTURE;

+

+///

+/// Local APIC NMI Structure

+///

+typedef struct {

+  UINT8   Type;

+  UINT8   Length;

+  UINT8   AcpiProcessorUid;

+  UINT16  Flags;

+  UINT8   LocalApicLint;

+} EFI_ACPI_6_2_LOCAL_APIC_NMI_STRUCTURE;

+

+///

+/// Local APIC Address Override Structure

+///

+typedef struct {

+  UINT8   Type;

+  UINT8   Length;

+  UINT16  Reserved;

+  UINT64  LocalApicAddress;

+} EFI_ACPI_6_2_LOCAL_APIC_ADDRESS_OVERRIDE_STRUCTURE;

+

+///

+/// IO SAPIC Structure

+///

+typedef struct {

+  UINT8   Type;

+  UINT8   Length;

+  UINT8   IoApicId;

+  UINT8   Reserved;

+  UINT32  GlobalSystemInterruptBase;

+  UINT64  IoSapicAddress;

+} EFI_ACPI_6_2_IO_SAPIC_STRUCTURE;

+

+///

+/// Local SAPIC Structure

+/// This struct followed by a null-terminated ASCII string - ACPI Processor UID String

+///

+typedef struct {

+  UINT8   Type;

+  UINT8   Length;

+  UINT8   AcpiProcessorId;

+  UINT8   LocalSapicId;

+  UINT8   LocalSapicEid;

+  UINT8   Reserved[3];

+  UINT32  Flags;

+  UINT32  ACPIProcessorUIDValue;

+} EFI_ACPI_6_2_PROCESSOR_LOCAL_SAPIC_STRUCTURE;

+

+///

+/// Platform Interrupt Sources Structure

+///

+typedef struct {

+  UINT8   Type;

+  UINT8   Length;

+  UINT16  Flags;

+  UINT8   InterruptType;

+  UINT8   ProcessorId;

+  UINT8   ProcessorEid;

+  UINT8   IoSapicVector;

+  UINT32  GlobalSystemInterrupt;

+  UINT32  PlatformInterruptSourceFlags;

+} EFI_ACPI_6_2_PLATFORM_INTERRUPT_SOURCES_STRUCTURE;

+

+///

+/// Platform Interrupt Source Flags.

+/// All other bits are reserved and must be set to 0.

+///

+#define EFI_ACPI_6_2_CPEI_PROCESSOR_OVERRIDE          BIT0

+

+///

+/// Processor Local x2APIC Structure Definition

+///

+typedef struct {

+  UINT8   Type;

+  UINT8   Length;

+  UINT8   Reserved[2];

+  UINT32  X2ApicId;

+  UINT32  Flags;

+  UINT32  AcpiProcessorUid;

+} EFI_ACPI_6_2_PROCESSOR_LOCAL_X2APIC_STRUCTURE;

+

+///

+/// Local x2APIC NMI Structure

+///

+typedef struct {

+  UINT8   Type;

+  UINT8   Length;

+  UINT16  Flags;

+  UINT32  AcpiProcessorUid;

+  UINT8   LocalX2ApicLint;

+  UINT8   Reserved[3];

+} EFI_ACPI_6_2_LOCAL_X2APIC_NMI_STRUCTURE;

+

+///

+/// GIC Structure

+///

+typedef struct {

+  UINT8   Type;

+  UINT8   Length;

+  UINT16  Reserved;

+  UINT32  CPUInterfaceNumber;

+  UINT32  AcpiProcessorUid;

+  UINT32  Flags;

+  UINT32  ParkingProtocolVersion;

+  UINT32  PerformanceInterruptGsiv;

+  UINT64  ParkedAddress;

+  UINT64  PhysicalBaseAddress;

+  UINT64  GICV;

+  UINT64  GICH;

+  UINT32  VGICMaintenanceInterrupt;

+  UINT64  GICRBaseAddress;

+  UINT64  MPIDR;

+  UINT8   ProcessorPowerEfficiencyClass;

+  UINT8   Reserved2[3];

+} EFI_ACPI_6_2_GIC_STRUCTURE;

+

+///

+/// GIC Flags.  All other bits are reserved and must be 0.

+///

+#define EFI_ACPI_6_2_GIC_ENABLED                              BIT0

+#define EFI_ACPI_6_2_PERFORMANCE_INTERRUPT_MODEL              BIT1

+#define EFI_ACPI_6_2_VGIC_MAINTENANCE_INTERRUPT_MODE_FLAGS    BIT2

+

+///

+/// GIC Distributor Structure

+///

+typedef struct {

+  UINT8   Type;

+  UINT8   Length;

+  UINT16  Reserved1;

+  UINT32  GicId;

+  UINT64  PhysicalBaseAddress;

+  UINT32  SystemVectorBase;

+  UINT8   GicVersion;

+  UINT8   Reserved2[3];

+} EFI_ACPI_6_2_GIC_DISTRIBUTOR_STRUCTURE;

+

+///

+/// GIC Version

+///

+#define EFI_ACPI_6_2_GIC_V1                                   0x01

+#define EFI_ACPI_6_2_GIC_V2                                   0x02

+#define EFI_ACPI_6_2_GIC_V3                                   0x03

+#define EFI_ACPI_6_2_GIC_V4                                   0x04

+

+///

+/// GIC MSI Frame Structure

+///

+typedef struct {

+  UINT8   Type;

+  UINT8   Length;

+  UINT16  Reserved1;

+  UINT32  GicMsiFrameId;

+  UINT64  PhysicalBaseAddress;

+  UINT32  Flags;

+  UINT16  SPICount;

+  UINT16  SPIBase;

+} EFI_ACPI_6_2_GIC_MSI_FRAME_STRUCTURE;

+

+///

+/// GIC MSI Frame Flags.  All other bits are reserved and must be 0.

+///

+#define EFI_ACPI_6_2_SPI_COUNT_BASE_SELECT                    BIT0

+

+///

+/// GICR Structure

+///

+typedef struct {

+  UINT8   Type;

+  UINT8   Length;

+  UINT16  Reserved;

+  UINT64  DiscoveryRangeBaseAddress;

+  UINT32  DiscoveryRangeLength;

+} EFI_ACPI_6_2_GICR_STRUCTURE;

+

+///

+/// GIC Interrupt Translation Service Structure

+///

+typedef struct {

+  UINT8   Type;

+  UINT8   Length;

+  UINT16  Reserved;

+  UINT32  GicItsId;

+  UINT64  PhysicalBaseAddress;

+  UINT32  Reserved2;

+} EFI_ACPI_6_2_GIC_ITS_STRUCTURE;

+

+///

+/// Smart Battery Description Table (SBST)

+///

+typedef struct {

+  EFI_ACPI_DESCRIPTION_HEADER Header;

+  UINT32                      WarningEnergyLevel;

+  UINT32                      LowEnergyLevel;

+  UINT32                      CriticalEnergyLevel;

+} EFI_ACPI_6_2_SMART_BATTERY_DESCRIPTION_TABLE;

+

+///

+/// SBST Version (as defined in ACPI 6.2 spec.)

+///

+#define EFI_ACPI_6_2_SMART_BATTERY_DESCRIPTION_TABLE_REVISION 0x01

+

+///

+/// Embedded Controller Boot Resources Table (ECDT)

+/// The table is followed by a null terminated ASCII string that contains

+/// a fully qualified reference to the name space object.

+///

+typedef struct {

+  EFI_ACPI_DESCRIPTION_HEADER             Header;

+  EFI_ACPI_6_2_GENERIC_ADDRESS_STRUCTURE  EcControl;

+  EFI_ACPI_6_2_GENERIC_ADDRESS_STRUCTURE  EcData;

+  UINT32                                  Uid;

+  UINT8                                   GpeBit;

+} EFI_ACPI_6_2_EMBEDDED_CONTROLLER_BOOT_RESOURCES_TABLE;

+

+///

+/// ECDT Version (as defined in ACPI 6.2 spec.)

+///

+#define EFI_ACPI_6_2_EMBEDDED_CONTROLLER_BOOT_RESOURCES_TABLE_REVISION  0x01

+

+///

+/// System Resource Affinity Table (SRAT).  The rest of the table

+/// must be defined in a platform specific manner.

+///

+typedef struct {

+  EFI_ACPI_DESCRIPTION_HEADER Header;

+  UINT32                      Reserved1;  ///< Must be set to 1

+  UINT64                      Reserved2;

+} EFI_ACPI_6_2_SYSTEM_RESOURCE_AFFINITY_TABLE_HEADER;

+

+///

+/// SRAT Version (as defined in ACPI 6.2 spec.)

+///

+#define EFI_ACPI_6_2_SYSTEM_RESOURCE_AFFINITY_TABLE_REVISION  0x03

+

+//

+// SRAT structure types.

+// All other values between 0x05 an 0xFF are reserved and

+// will be ignored by OSPM.

+//

+#define EFI_ACPI_6_2_PROCESSOR_LOCAL_APIC_SAPIC_AFFINITY  0x00

+#define EFI_ACPI_6_2_MEMORY_AFFINITY                      0x01

+#define EFI_ACPI_6_2_PROCESSOR_LOCAL_X2APIC_AFFINITY      0x02

+#define EFI_ACPI_6_2_GICC_AFFINITY                        0x03

+#define EFI_ACPI_6_2_GIC_ITS_AFFINITY                     0x04

+

+///

+/// Processor Local APIC/SAPIC Affinity Structure Definition

+///

+typedef struct {

+  UINT8   Type;

+  UINT8   Length;

+  UINT8   ProximityDomain7To0;

+  UINT8   ApicId;

+  UINT32  Flags;

+  UINT8   LocalSapicEid;

+  UINT8   ProximityDomain31To8[3];

+  UINT32  ClockDomain;

+} EFI_ACPI_6_2_PROCESSOR_LOCAL_APIC_SAPIC_AFFINITY_STRUCTURE;

+

+///

+/// Local APIC/SAPIC Flags.  All other bits are reserved and must be 0.

+///

+#define EFI_ACPI_6_2_PROCESSOR_LOCAL_APIC_SAPIC_ENABLED (1 << 0)

+

+///

+/// Memory Affinity Structure Definition

+///

+typedef struct {

+  UINT8   Type;

+  UINT8   Length;

+  UINT32  ProximityDomain;

+  UINT16  Reserved1;

+  UINT32  AddressBaseLow;

+  UINT32  AddressBaseHigh;

+  UINT32  LengthLow;

+  UINT32  LengthHigh;

+  UINT32  Reserved2;

+  UINT32  Flags;

+  UINT64  Reserved3;

+} EFI_ACPI_6_2_MEMORY_AFFINITY_STRUCTURE;

+

+//

+// Memory Flags.  All other bits are reserved and must be 0.

+//

+#define EFI_ACPI_6_2_MEMORY_ENABLED       (1 << 0)

+#define EFI_ACPI_6_2_MEMORY_HOT_PLUGGABLE (1 << 1)

+#define EFI_ACPI_6_2_MEMORY_NONVOLATILE   (1 << 2)

+

+///

+/// Processor Local x2APIC Affinity Structure Definition

+///

+typedef struct {

+  UINT8   Type;

+  UINT8   Length;

+  UINT8   Reserved1[2];

+  UINT32  ProximityDomain;

+  UINT32  X2ApicId;

+  UINT32  Flags;

+  UINT32  ClockDomain;

+  UINT8   Reserved2[4];

+} EFI_ACPI_6_2_PROCESSOR_LOCAL_X2APIC_AFFINITY_STRUCTURE;

+

+///

+/// GICC Affinity Structure Definition

+///

+typedef struct {

+  UINT8   Type;

+  UINT8   Length;

+  UINT32  ProximityDomain;

+  UINT32  AcpiProcessorUid;

+  UINT32  Flags;

+  UINT32  ClockDomain;

+} EFI_ACPI_6_2_GICC_AFFINITY_STRUCTURE;

+

+///

+/// GICC Flags.  All other bits are reserved and must be 0.

+///

+#define EFI_ACPI_6_2_GICC_ENABLED (1 << 0)

+

+///

+/// GIC Interrupt Translation Service (ITS) Affinity Structure Definition

+///

+typedef struct {

+  UINT8   Type;

+  UINT8   Length;

+  UINT32  ProximityDomain;

+  UINT8   Reserved[2];

+  UINT32  ItsId;

+} EFI_ACPI_6_2_GIC_ITS_AFFINITY_STRUCTURE;

+

+///

+/// System Locality Distance Information Table (SLIT).

+/// The rest of the table is a matrix.

+///

+typedef struct {

+  EFI_ACPI_DESCRIPTION_HEADER Header;

+  UINT64                      NumberOfSystemLocalities;

+} EFI_ACPI_6_2_SYSTEM_LOCALITY_DISTANCE_INFORMATION_TABLE_HEADER;

+

+///

+/// SLIT Version (as defined in ACPI 6.2 spec.)

+///

+#define EFI_ACPI_6_2_SYSTEM_LOCALITY_DISTANCE_INFORMATION_TABLE_REVISION  0x01

+

+///

+/// Corrected Platform Error Polling Table (CPEP)

+///

+typedef struct {

+  EFI_ACPI_DESCRIPTION_HEADER Header;

+  UINT8                       Reserved[8];

+} EFI_ACPI_6_2_CORRECTED_PLATFORM_ERROR_POLLING_TABLE_HEADER;

+

+///

+/// CPEP Version (as defined in ACPI 6.2 spec.)

+///

+#define EFI_ACPI_6_2_CORRECTED_PLATFORM_ERROR_POLLING_TABLE_REVISION 0x01

+

+//

+// CPEP processor structure types.

+//

+#define EFI_ACPI_6_2_CPEP_PROCESSOR_APIC_SAPIC  0x00

+

+///

+/// Corrected Platform Error Polling Processor Structure Definition

+///

+typedef struct {

+  UINT8   Type;

+  UINT8   Length;

+  UINT8   ProcessorId;

+  UINT8   ProcessorEid;

+  UINT32  PollingInterval;

+} EFI_ACPI_6_2_CPEP_PROCESSOR_APIC_SAPIC_STRUCTURE;

+

+///

+/// Maximum System Characteristics Table (MSCT)

+///

+typedef struct {

+  EFI_ACPI_DESCRIPTION_HEADER Header;

+  UINT32                      OffsetProxDomInfo;

+  UINT32                      MaximumNumberOfProximityDomains;

+  UINT32                      MaximumNumberOfClockDomains;

+  UINT64                      MaximumPhysicalAddress;

+} EFI_ACPI_6_2_MAXIMUM_SYSTEM_CHARACTERISTICS_TABLE_HEADER;

+

+///

+/// MSCT Version (as defined in ACPI 6.2 spec.)

+///

+#define EFI_ACPI_6_2_MAXIMUM_SYSTEM_CHARACTERISTICS_TABLE_REVISION 0x01

+

+///

+/// Maximum Proximity Domain Information Structure Definition

+///

+typedef struct {

+  UINT8   Revision;

+  UINT8   Length;

+  UINT32  ProximityDomainRangeLow;

+  UINT32  ProximityDomainRangeHigh;

+  UINT32  MaximumProcessorCapacity;

+  UINT64  MaximumMemoryCapacity;

+} EFI_ACPI_6_2_MAXIMUM_PROXIMITY_DOMAIN_INFORMATION_STRUCTURE;

+

+///

+/// ACPI RAS Feature Table definition.

+///

+typedef struct {

+  EFI_ACPI_DESCRIPTION_HEADER Header;

+  UINT8                       PlatformCommunicationChannelIdentifier[12];

+} EFI_ACPI_6_2_RAS_FEATURE_TABLE;

+

+///

+/// RASF Version (as defined in ACPI 6.2 spec.)

+///

+#define EFI_ACPI_6_2_RAS_FEATURE_TABLE_REVISION 0x01

+

+///

+/// ACPI RASF Platform Communication Channel Shared Memory Region definition.

+///

+typedef struct {

+  UINT32                      Signature;

+  UINT16                      Command;

+  UINT16                      Status;

+  UINT16                      Version;

+  UINT8                       RASCapabilities[16];

+  UINT8                       SetRASCapabilities[16];

+  UINT16                      NumberOfRASFParameterBlocks;

+  UINT32                      SetRASCapabilitiesStatus;

+} EFI_ACPI_6_2_RASF_PLATFORM_COMMUNICATION_CHANNEL_SHARED_MEMORY_REGION;

+

+///

+/// ACPI RASF PCC command code

+///

+#define EFI_ACPI_6_2_RASF_PCC_COMMAND_CODE_EXECUTE_RASF_COMMAND  0x01

+

+///

+/// ACPI RASF Platform RAS Capabilities

+///

+#define EFI_ACPI_6_2_RASF_PLATFORM_RAS_CAPABILITY_HARDWARE_BASED_PATROL_SCRUB_SUPPORTED                         BIT0

+#define EFI_ACPI_6_2_RASF_PLATFORM_RAS_CAPABILITY_HARDWARE_BASED_PATROL_SCRUB_SUPPORTED_AND_EXPOSED_TO_SOFTWARE BIT1

+#define EFI_ACPI_6_2_RASF_PLATFORM_RAS_CAPABILITY_CPU_CACHE_FLUSH_TO_NVDIMM_DURABILITY_ON_POWER_LOSS            BIT2

+#define EFI_ACPI_6_2_RASF_PLATFORM_RAS_CAPABILITY_MEMORY_CONTROLLER_FLUSH_TO_NVDIMM_DURABILITY_ON_POWER_LOSS    BIT3

+#define EFI_ACPI_6_2_RASF_PLATFORM_RAS_CAPABILITY_BYTE_ADDRESSABLE_PERSISTENT_MEMORY_HARDWARE_MIRRORING         BIT4

+

+///

+/// ACPI RASF Parameter Block structure for PATROL_SCRUB

+///

+typedef struct {

+  UINT16                      Type;

+  UINT16                      Version;

+  UINT16                      Length;

+  UINT16                      PatrolScrubCommand;

+  UINT64                      RequestedAddressRange[2];

+  UINT64                      ActualAddressRange[2];

+  UINT16                      Flags;

+  UINT8                       RequestedSpeed;

+} EFI_ACPI_6_2_RASF_PATROL_SCRUB_PLATFORM_BLOCK_STRUCTURE;

+

+///

+/// ACPI RASF Patrol Scrub command

+///

+#define EFI_ACPI_6_2_RASF_PATROL_SCRUB_COMMAND_GET_PATROL_PARAMETERS   0x01

+#define EFI_ACPI_6_2_RASF_PATROL_SCRUB_COMMAND_START_PATROL_SCRUBBER   0x02

+#define EFI_ACPI_6_2_RASF_PATROL_SCRUB_COMMAND_STOP_PATROL_SCRUBBER    0x03

+

+///

+/// Memory Power State Table definition.

+///

+typedef struct {

+  EFI_ACPI_DESCRIPTION_HEADER Header;

+  UINT8                       PlatformCommunicationChannelIdentifier;

+  UINT8                       Reserved[3];

+// Memory Power Node Structure

+// Memory Power State Characteristics

+} EFI_ACPI_6_2_MEMORY_POWER_STATUS_TABLE;

+

+///

+/// MPST Version (as defined in ACPI 6.2 spec.)

+///

+#define EFI_ACPI_6_2_MEMORY_POWER_STATE_TABLE_REVISION 0x01

+

+///

+/// MPST Platform Communication Channel Shared Memory Region definition.

+///

+typedef struct {

+  UINT32                      Signature;

+  UINT16                      Command;

+  UINT16                      Status;

+  UINT32                      MemoryPowerCommandRegister;

+  UINT32                      MemoryPowerStatusRegister;

+  UINT32                      PowerStateId;

+  UINT32                      MemoryPowerNodeId;

+  UINT64                      MemoryEnergyConsumed;

+  UINT64                      ExpectedAveragePowerComsuned;

+} EFI_ACPI_6_2_MPST_PLATFORM_COMMUNICATION_CHANNEL_SHARED_MEMORY_REGION;

+

+///

+/// ACPI MPST PCC command code

+///

+#define EFI_ACPI_6_2_MPST_PCC_COMMAND_CODE_EXECUTE_MPST_COMMAND  0x03

+

+///

+/// ACPI MPST Memory Power command

+///

+#define EFI_ACPI_6_2_MPST_MEMORY_POWER_COMMAND_GET_MEMORY_POWER_STATE       0x01

+#define EFI_ACPI_6_2_MPST_MEMORY_POWER_COMMAND_SET_MEMORY_POWER_STATE       0x02

+#define EFI_ACPI_6_2_MPST_MEMORY_POWER_COMMAND_GET_AVERAGE_POWER_CONSUMED   0x03

+#define EFI_ACPI_6_2_MPST_MEMORY_POWER_COMMAND_GET_MEMORY_ENERGY_CONSUMED   0x04

+

+///

+/// MPST Memory Power Node Table

+///

+typedef struct {

+  UINT8                                             PowerStateValue;

+  UINT8                                             PowerStateInformationIndex;

+} EFI_ACPI_6_2_MPST_MEMORY_POWER_STATE;

+

+typedef struct {

+  UINT8                                             Flag;

+  UINT8                                             Reserved;

+  UINT16                                            MemoryPowerNodeId;

+  UINT32                                            Length;

+  UINT64                                            AddressBase;

+  UINT64                                            AddressLength;

+  UINT32                                            NumberOfPowerStates;

+  UINT32                                            NumberOfPhysicalComponents;

+//EFI_ACPI_6_2_MPST_MEMORY_POWER_STATE              MemoryPowerState[NumberOfPowerStates];

+//UINT16                                            PhysicalComponentIdentifier[NumberOfPhysicalComponents];

+} EFI_ACPI_6_2_MPST_MEMORY_POWER_STRUCTURE;

+

+#define EFI_ACPI_6_2_MPST_MEMORY_POWER_STRUCTURE_FLAG_ENABLE          0x01

+#define EFI_ACPI_6_2_MPST_MEMORY_POWER_STRUCTURE_FLAG_POWER_MANAGED   0x02

+#define EFI_ACPI_6_2_MPST_MEMORY_POWER_STRUCTURE_FLAG_HOT_PLUGGABLE   0x04

+

+typedef struct {

+  UINT16                      MemoryPowerNodeCount;

+  UINT8                       Reserved[2];

+} EFI_ACPI_6_2_MPST_MEMORY_POWER_NODE_TABLE;

+

+///

+/// MPST Memory Power State Characteristics Table

+///

+typedef struct {

+  UINT8                                             PowerStateStructureID;

+  UINT8                                             Flag;

+  UINT16                                            Reserved;

+  UINT32                                            AveragePowerConsumedInMPS0;

+  UINT32                                            RelativePowerSavingToMPS0;

+  UINT64                                            ExitLatencyToMPS0;

+} EFI_ACPI_6_2_MPST_MEMORY_POWER_STATE_CHARACTERISTICS_STRUCTURE;

+

+#define EFI_ACPI_6_2_MPST_MEMORY_POWER_STATE_CHARACTERISTICS_STRUCTURE_FLAG_MEMORY_CONTENT_PRESERVED              0x01

+#define EFI_ACPI_6_2_MPST_MEMORY_POWER_STATE_CHARACTERISTICS_STRUCTURE_FLAG_AUTONOMOUS_MEMORY_POWER_STATE_ENTRY   0x02

+#define EFI_ACPI_6_2_MPST_MEMORY_POWER_STATE_CHARACTERISTICS_STRUCTURE_FLAG_AUTONOMOUS_MEMORY_POWER_STATE_EXIT    0x04

+

+typedef struct {

+  UINT16                      MemoryPowerStateCharacteristicsCount;

+  UINT8                       Reserved[2];

+} EFI_ACPI_6_2_MPST_MEMORY_POWER_STATE_CHARACTERISTICS_TABLE;

+

+///

+/// Memory Topology Table definition.

+///

+typedef struct {

+  EFI_ACPI_DESCRIPTION_HEADER Header;

+  UINT32                      Reserved;

+} EFI_ACPI_6_2_MEMORY_TOPOLOGY_TABLE;

+

+///

+/// PMTT Version (as defined in ACPI 6.2 spec.)

+///

+#define EFI_ACPI_6_2_MEMORY_TOPOLOGY_TABLE_REVISION 0x01

+

+///

+/// Common Memory Aggregator Device Structure.

+///

+typedef struct {

+  UINT8                       Type;

+  UINT8                       Reserved;

+  UINT16                      Length;

+  UINT16                      Flags;

+  UINT16                      Reserved1;

+} EFI_ACPI_6_2_PMMT_COMMON_MEMORY_AGGREGATOR_DEVICE_STRUCTURE;

+

+///

+/// Memory Aggregator Device Type

+///

+#define EFI_ACPI_6_2_PMMT_MEMORY_AGGREGATOR_DEVICE_TYPE_SOCKET            0x1

+#define EFI_ACPI_6_2_PMMT_MEMORY_AGGREGATOR_DEVICE_TYPE_MEMORY_CONTROLLER 0x2

+#define EFI_ACPI_6_2_PMMT_MEMORY_AGGREGATOR_DEVICE_TYPE_DIMM              0x3

+

+///

+/// Socket Memory Aggregator Device Structure.

+///

+typedef struct {

+  EFI_ACPI_6_2_PMMT_COMMON_MEMORY_AGGREGATOR_DEVICE_STRUCTURE  Header;

+  UINT16                                                       SocketIdentifier;

+  UINT16                                                       Reserved;

+//EFI_ACPI_6_2_PMMT_MEMORY_CONTROLLER_MEMORY_AGGREGATOR_DEVICE_STRUCTURE  MemoryController[];

+} EFI_ACPI_6_2_PMMT_SOCKET_MEMORY_AGGREGATOR_DEVICE_STRUCTURE;

+

+///

+/// MemoryController Memory Aggregator Device Structure.

+///

+typedef struct {

+  EFI_ACPI_6_2_PMMT_COMMON_MEMORY_AGGREGATOR_DEVICE_STRUCTURE  Header;

+  UINT32                                                       ReadLatency;

+  UINT32                                                       WriteLatency;

+  UINT32                                                       ReadBandwidth;

+  UINT32                                                       WriteBandwidth;

+  UINT16                                                       OptimalAccessUnit;

+  UINT16                                                       OptimalAccessAlignment;

+  UINT16                                                       Reserved;

+  UINT16                                                       NumberOfProximityDomains;

+//UINT32                                                       ProximityDomain[NumberOfProximityDomains];

+//EFI_ACPI_6_2_PMMT_DIMM_MEMORY_AGGREGATOR_DEVICE_STRUCTURE    PhysicalComponent[];

+} EFI_ACPI_6_2_PMMT_MEMORY_CONTROLLER_MEMORY_AGGREGATOR_DEVICE_STRUCTURE;

+

+///

+/// DIMM Memory Aggregator Device Structure.

+///

+typedef struct {

+  EFI_ACPI_6_2_PMMT_COMMON_MEMORY_AGGREGATOR_DEVICE_STRUCTURE  Header;

+  UINT16                                                       PhysicalComponentIdentifier;

+  UINT16                                                       Reserved;

+  UINT32                                                       SizeOfDimm;

+  UINT32                                                       SmbiosHandle;

+} EFI_ACPI_6_2_PMMT_DIMM_MEMORY_AGGREGATOR_DEVICE_STRUCTURE;

+

+///

+/// Boot Graphics Resource Table definition.

+///

+typedef struct {

+  EFI_ACPI_DESCRIPTION_HEADER Header;

+  ///

+  /// 2-bytes (16 bit) version ID. This value must be 1.

+  ///

+  UINT16                      Version;

+  ///

+  /// 1-byte status field indicating current status about the table.

+  ///     Bits[7:1] = Reserved (must be zero)

+  ///     Bit [0] = Valid. A one indicates the boot image graphic is valid.

+  ///

+  UINT8                       Status;

+  ///

+  /// 1-byte enumerated type field indicating format of the image.

+  ///     0 = Bitmap

+  ///     1 - 255  Reserved (for future use)

+  ///

+  UINT8                       ImageType;

+  ///

+  /// 8-byte (64 bit) physical address pointing to the firmware's in-memory copy

+  /// of the image bitmap.

+  ///

+  UINT64                      ImageAddress;

+  ///

+  /// A 4-byte (32-bit) unsigned long describing the display X-offset of the boot image.

+  /// (X, Y) display offset of the top left corner of the boot image.

+  /// The top left corner of the display is at offset (0, 0).

+  ///

+  UINT32                      ImageOffsetX;

+  ///

+  /// A 4-byte (32-bit) unsigned long describing the display Y-offset of the boot image.

+  /// (X, Y) display offset of the top left corner of the boot image.

+  /// The top left corner of the display is at offset (0, 0).

+  ///

+  UINT32                      ImageOffsetY;

+} EFI_ACPI_6_2_BOOT_GRAPHICS_RESOURCE_TABLE;

+

+///

+/// BGRT Revision

+///

+#define EFI_ACPI_6_2_BOOT_GRAPHICS_RESOURCE_TABLE_REVISION 1

+

+///

+/// BGRT Version

+///

+#define EFI_ACPI_6_2_BGRT_VERSION         0x01

+

+///

+/// BGRT Status

+///

+#define EFI_ACPI_6_2_BGRT_STATUS_NOT_DISPLAYED 0x00

+#define EFI_ACPI_6_2_BGRT_STATUS_DISPLAYED     0x01

+

+///

+/// BGRT Image Type

+///

+#define EFI_ACPI_6_2_BGRT_IMAGE_TYPE_BMP  0x00

+

+///

+/// FPDT Version (as defined in ACPI 6.2 spec.)

+///

+#define EFI_ACPI_6_2_FIRMWARE_PERFORMANCE_DATA_TABLE_REVISION 0x01

+

+///

+/// FPDT Performance Record Types

+///

+#define EFI_ACPI_6_2_FPDT_RECORD_TYPE_FIRMWARE_BASIC_BOOT_POINTER      0x0000

+#define EFI_ACPI_6_2_FPDT_RECORD_TYPE_S3_PERFORMANCE_TABLE_POINTER     0x0001

+

+///

+/// FPDT Performance Record Revision

+///

+#define EFI_ACPI_6_2_FPDT_RECORD_REVISION_FIRMWARE_BASIC_BOOT_POINTER  0x01

+#define EFI_ACPI_6_2_FPDT_RECORD_REVISION_S3_PERFORMANCE_TABLE_POINTER 0x01

+

+///

+/// FPDT Runtime Performance Record Types

+///

+#define EFI_ACPI_6_2_FPDT_RUNTIME_RECORD_TYPE_S3_RESUME                0x0000

+#define EFI_ACPI_6_2_FPDT_RUNTIME_RECORD_TYPE_S3_SUSPEND               0x0001

+#define EFI_ACPI_6_2_FPDT_RUNTIME_RECORD_TYPE_FIRMWARE_BASIC_BOOT      0x0002

+

+///

+/// FPDT Runtime Performance Record Revision

+///

+#define EFI_ACPI_6_2_FPDT_RUNTIME_RECORD_REVISION_S3_RESUME            0x01

+#define EFI_ACPI_6_2_FPDT_RUNTIME_RECORD_REVISION_S3_SUSPEND           0x01

+#define EFI_ACPI_6_2_FPDT_RUNTIME_RECORD_REVISION_FIRMWARE_BASIC_BOOT  0x02

+

+///

+/// FPDT Performance Record header

+///

+typedef struct {

+  UINT16           Type;

+  UINT8            Length;

+  UINT8            Revision;

+} EFI_ACPI_6_2_FPDT_PERFORMANCE_RECORD_HEADER;

+

+///

+/// FPDT Performance Table header

+///

+typedef struct {

+  UINT32  Signature;

+  UINT32  Length;

+} EFI_ACPI_6_2_FPDT_PERFORMANCE_TABLE_HEADER;

+

+///

+/// FPDT Firmware Basic Boot Performance Pointer Record Structure

+///

+typedef struct {

+  EFI_ACPI_6_2_FPDT_PERFORMANCE_RECORD_HEADER     Header;

+  UINT32                                          Reserved;

+  ///

+  /// 64-bit processor-relative physical address of the Basic Boot Performance Table.

+  ///

+  UINT64                                          BootPerformanceTablePointer;

+} EFI_ACPI_6_2_FPDT_BOOT_PERFORMANCE_TABLE_POINTER_RECORD;

+

+///

+/// FPDT S3 Performance Table Pointer Record Structure

+///

+typedef struct {

+  EFI_ACPI_6_2_FPDT_PERFORMANCE_RECORD_HEADER     Header;

+  UINT32                                          Reserved;

+  ///

+  /// 64-bit processor-relative physical address of the S3 Performance Table.

+  ///

+  UINT64                                          S3PerformanceTablePointer;

+} EFI_ACPI_6_2_FPDT_S3_PERFORMANCE_TABLE_POINTER_RECORD;

+

+///

+/// FPDT Firmware Basic Boot Performance Record Structure

+///

+typedef struct {

+  EFI_ACPI_6_2_FPDT_PERFORMANCE_RECORD_HEADER     Header;

+  UINT32                                          Reserved;

+  ///

+  /// Timer value logged at the beginning of firmware image execution.

+  /// This may not always be zero or near zero.

+  ///

+  UINT64                                          ResetEnd;

+  ///

+  /// Timer value logged just prior to loading the OS boot loader into memory.

+  /// For non-UEFI compatible boots, this field must be zero.

+  ///

+  UINT64                                          OsLoaderLoadImageStart;

+  ///

+  /// Timer value logged just prior to launching the previously loaded OS boot loader image.

+  /// For non-UEFI compatible boots, the timer value logged will be just prior

+  /// to the INT 19h handler invocation.

+  ///

+  UINT64                                          OsLoaderStartImageStart;

+  ///

+  /// Timer value logged at the point when the OS loader calls the

+  /// ExitBootServices function for UEFI compatible firmware.

+  /// For non-UEFI compatible boots, this field must be zero.

+  ///

+  UINT64                                          ExitBootServicesEntry;

+  ///

+  /// Timer value logged at the point just prior to when the OS loader gaining

+  /// control back from calls the ExitBootServices function for UEFI compatible firmware.

+  /// For non-UEFI compatible boots, this field must be zero.

+  ///

+  UINT64                                          ExitBootServicesExit;

+} EFI_ACPI_6_2_FPDT_FIRMWARE_BASIC_BOOT_RECORD;

+

+///

+/// FPDT Firmware Basic Boot Performance Table signature

+///

+#define EFI_ACPI_6_2_FPDT_BOOT_PERFORMANCE_TABLE_SIGNATURE  SIGNATURE_32('F', 'B', 'P', 'T')

+

+//

+// FPDT Firmware Basic Boot Performance Table

+//

+typedef struct {

+  EFI_ACPI_6_2_FPDT_PERFORMANCE_TABLE_HEADER      Header;

+  //

+  // one or more Performance Records.

+  //

+} EFI_ACPI_6_2_FPDT_FIRMWARE_BASIC_BOOT_TABLE;

+

+///

+/// FPDT "S3PT" S3 Performance Table

+///

+#define EFI_ACPI_6_2_FPDT_S3_PERFORMANCE_TABLE_SIGNATURE  SIGNATURE_32('S', '3', 'P', 'T')

+

+//

+// FPDT Firmware S3 Boot Performance Table

+//

+typedef struct {

+  EFI_ACPI_6_2_FPDT_PERFORMANCE_TABLE_HEADER      Header;

+  //

+  // one or more Performance Records.

+  //

+} EFI_ACPI_6_2_FPDT_FIRMWARE_S3_BOOT_TABLE;

+

+///

+/// FPDT Basic S3 Resume Performance Record

+///

+typedef struct {

+  EFI_ACPI_6_2_FPDT_PERFORMANCE_RECORD_HEADER     Header;

+  ///

+  /// A count of the number of S3 resume cycles since the last full boot sequence.

+  ///

+  UINT32                                          ResumeCount;

+  ///

+  /// Timer recorded at the end of BIOS S3 resume, just prior to handoff to the

+  /// OS waking vector. Only the most recent resume cycle's time is retained.

+  ///

+  UINT64                                          FullResume;

+  ///

+  /// Average timer value of all resume cycles logged since the last full boot

+  /// sequence, including the most recent resume.  Note that the entire log of

+  /// timer values does not need to be retained in order to calculate this average.

+  ///

+  UINT64                                          AverageResume;

+} EFI_ACPI_6_2_FPDT_S3_RESUME_RECORD;

+

+///

+/// FPDT Basic S3 Suspend Performance Record

+///

+typedef struct {

+  EFI_ACPI_6_2_FPDT_PERFORMANCE_RECORD_HEADER     Header;

+  ///

+  /// Timer value recorded at the OS write to SLP_TYP upon entry to S3.

+  /// Only the most recent suspend cycle's timer value is retained.

+  ///

+  UINT64                                          SuspendStart;

+  ///

+  /// Timer value recorded at the final firmware write to SLP_TYP (or other

+  /// mechanism) used to trigger hardware entry to S3.

+  /// Only the most recent suspend cycle's timer value is retained.

+  ///

+  UINT64                                          SuspendEnd;

+} EFI_ACPI_6_2_FPDT_S3_SUSPEND_RECORD;

+

+///

+/// Firmware Performance Record Table definition.

+///

+typedef struct {

+  EFI_ACPI_DESCRIPTION_HEADER Header;

+} EFI_ACPI_6_2_FIRMWARE_PERFORMANCE_RECORD_TABLE;

+

+///

+/// Generic Timer Description Table definition.

+///

+typedef struct {

+  EFI_ACPI_DESCRIPTION_HEADER Header;

+  UINT64                      CntControlBasePhysicalAddress;

+  UINT32                      Reserved;

+  UINT32                      SecurePL1TimerGSIV;

+  UINT32                      SecurePL1TimerFlags;

+  UINT32                      NonSecurePL1TimerGSIV;

+  UINT32                      NonSecurePL1TimerFlags;

+  UINT32                      VirtualTimerGSIV;

+  UINT32                      VirtualTimerFlags;

+  UINT32                      NonSecurePL2TimerGSIV;

+  UINT32                      NonSecurePL2TimerFlags;

+  UINT64                      CntReadBasePhysicalAddress;

+  UINT32                      PlatformTimerCount;

+  UINT32                      PlatformTimerOffset;

+} EFI_ACPI_6_2_GENERIC_TIMER_DESCRIPTION_TABLE;

+

+///

+/// GTDT Version (as defined in ACPI 6.2 spec.)

+///

+#define EFI_ACPI_6_2_GENERIC_TIMER_DESCRIPTION_TABLE_REVISION 0x02

+

+///

+/// Timer Flags.  All other bits are reserved and must be 0.

+///

+#define EFI_ACPI_6_2_GTDT_TIMER_FLAG_TIMER_INTERRUPT_MODE          BIT0

+#define EFI_ACPI_6_2_GTDT_TIMER_FLAG_TIMER_INTERRUPT_POLARITY      BIT1

+#define EFI_ACPI_6_2_GTDT_TIMER_FLAG_ALWAYS_ON_CAPABILITY          BIT2

+

+///

+/// Platform Timer Type

+///

+#define EFI_ACPI_6_2_GTDT_GT_BLOCK                       0

+#define EFI_ACPI_6_2_GTDT_SBSA_GENERIC_WATCHDOG          1

+

+///

+/// GT Block Structure

+///

+typedef struct {

+  UINT8   Type;

+  UINT16  Length;

+  UINT8   Reserved;

+  UINT64  CntCtlBase;

+  UINT32  GTBlockTimerCount;

+  UINT32  GTBlockTimerOffset;

+} EFI_ACPI_6_2_GTDT_GT_BLOCK_STRUCTURE;

+

+///

+/// GT Block Timer Structure

+///

+typedef struct {

+  UINT8   GTFrameNumber;

+  UINT8   Reserved[3];

+  UINT64  CntBaseX;

+  UINT64  CntEL0BaseX;

+  UINT32  GTxPhysicalTimerGSIV;

+  UINT32  GTxPhysicalTimerFlags;

+  UINT32  GTxVirtualTimerGSIV;

+  UINT32  GTxVirtualTimerFlags;

+  UINT32  GTxCommonFlags;

+} EFI_ACPI_6_2_GTDT_GT_BLOCK_TIMER_STRUCTURE;

+

+///

+/// GT Block Physical Timers and Virtual Timers Flags.  All other bits are reserved and must be 0.

+///

+#define EFI_ACPI_6_2_GTDT_GT_BLOCK_TIMER_FLAG_TIMER_INTERRUPT_MODE          BIT0

+#define EFI_ACPI_6_2_GTDT_GT_BLOCK_TIMER_FLAG_TIMER_INTERRUPT_POLARITY      BIT1

+

+///

+/// Common Flags Flags.  All other bits are reserved and must be 0.

+///

+#define EFI_ACPI_6_2_GTDT_GT_BLOCK_COMMON_FLAG_SECURE_TIMER              BIT0

+#define EFI_ACPI_6_2_GTDT_GT_BLOCK_COMMON_FLAG_ALWAYS_ON_CAPABILITY      BIT1

+

+///

+/// SBSA Generic Watchdog Structure

+///

+typedef struct {

+  UINT8   Type;

+  UINT16  Length;

+  UINT8   Reserved;

+  UINT64  RefreshFramePhysicalAddress;

+  UINT64  WatchdogControlFramePhysicalAddress;

+  UINT32  WatchdogTimerGSIV;

+  UINT32  WatchdogTimerFlags;

+} EFI_ACPI_6_2_GTDT_SBSA_GENERIC_WATCHDOG_STRUCTURE;

+

+///

+/// SBSA Generic Watchdog Timer Flags.  All other bits are reserved and must be 0.

+///

+#define EFI_ACPI_6_2_GTDT_SBSA_GENERIC_WATCHDOG_FLAG_TIMER_INTERRUPT_MODE          BIT0

+#define EFI_ACPI_6_2_GTDT_SBSA_GENERIC_WATCHDOG_FLAG_TIMER_INTERRUPT_POLARITY      BIT1

+#define EFI_ACPI_6_2_GTDT_SBSA_GENERIC_WATCHDOG_FLAG_SECURE_TIMER                  BIT2

+

+//

+// NVDIMM Firmware Interface Table definition.

+//

+typedef struct {

+  EFI_ACPI_DESCRIPTION_HEADER    Header;

+  UINT32                         Reserved;

+} EFI_ACPI_6_2_NVDIMM_FIRMWARE_INTERFACE_TABLE;

+

+//

+// NFIT Version (as defined in ACPI 6.2 spec.)

+//

+#define EFI_ACPI_6_2_NVDIMM_FIRMWARE_INTERFACE_TABLE_REVISION 0x1

+

+//

+// Definition for NFIT Table Structure Types

+//

+#define EFI_ACPI_6_2_NFIT_SYSTEM_PHYSICAL_ADDRESS_RANGE_STRUCTURE_TYPE              0

+#define EFI_ACPI_6_2_NFIT_NVDIMM_REGION_MAPPING_STRUCTURE_TYPE                      1

+#define EFI_ACPI_6_2_NFIT_INTERLEAVE_STRUCTURE_TYPE                                 2

+#define EFI_ACPI_6_2_NFIT_SMBIOS_MANAGEMENT_INFORMATION_STRUCTURE_TYPE              3

+#define EFI_ACPI_6_2_NFIT_NVDIMM_CONTROL_REGION_STRUCTURE_TYPE                      4

+#define EFI_ACPI_6_2_NFIT_NVDIMM_BLOCK_DATA_WINDOW_REGION_STRUCTURE_TYPE            5

+#define EFI_ACPI_6_2_NFIT_FLUSH_HINT_ADDRESS_STRUCTURE_TYPE                         6

+

+//

+// Definition for NFIT Structure Header

+//

+typedef struct {

+  UINT16                                      Type;

+  UINT16                                      Length;

+} EFI_ACPI_6_2_NFIT_STRUCTURE_HEADER;

+

+//

+// Definition for System Physical Address Range Structure

+//

+#define EFI_ACPI_6_2_NFIT_SYSTEM_PHYSICAL_ADDRESS_RANGE_FLAGS_CONTROL_REGION_FOR_MANAGEMENT      BIT0

+#define EFI_ACPI_6_2_NFIT_SYSTEM_PHYSICAL_ADDRESS_RANGE_FLAGS_PROXIMITY_DOMAIN_VALID             BIT1

+#define EFI_ACPI_6_2_NFIT_GUID_VOLATILE_MEMORY_REGION                             { 0x7305944F, 0xFDDA, 0x44E3, { 0xB1, 0x6C, 0x3F, 0x22, 0xD2, 0x52, 0xE5, 0xD0 }}

+#define EFI_ACPI_6_2_NFIT_GUID_BYTE_ADDRESSABLE_PERSISTENT_MEMORY_REGION          { 0x66F0D379, 0xB4F3, 0x4074, { 0xAC, 0x43, 0x0D, 0x33, 0x18, 0xB7, 0x8C, 0xDB }}

+#define EFI_ACPI_6_2_NFIT_GUID_NVDIMM_CONTROL_REGION                              { 0x92F701F6, 0x13B4, 0x405D, { 0x91, 0x0B, 0x29, 0x93, 0x67, 0xE8, 0x23, 0x4C }}

+#define EFI_ACPI_6_2_NFIT_GUID_NVDIMM_BLOCK_DATA_WINDOW_REGION                    { 0x91AF0530, 0x5D86, 0x470E, { 0xA6, 0xB0, 0x0A, 0x2D, 0xB9, 0x40, 0x82, 0x49 }}

+#define EFI_ACPI_6_2_NFIT_GUID_RAM_DISK_SUPPORTING_VIRTUAL_DISK_REGION_VOLATILE   { 0x77AB535A, 0x45FC, 0x624B, { 0x55, 0x60, 0xF7, 0xB2, 0x81, 0xD1, 0xF9, 0x6E }}

+#define EFI_ACPI_6_2_NFIT_GUID_RAM_DISK_SUPPORTING_VIRTUAL_CD_REGION_VOLATILE     { 0x3D5ABD30, 0x4175, 0x87CE, { 0x6D, 0x64, 0xD2, 0xAD, 0xE5, 0x23, 0xC4, 0xBB }}

+#define EFI_ACPI_6_2_NFIT_GUID_RAM_DISK_SUPPORTING_VIRTUAL_DISK_REGION_PERSISTENT { 0x5CEA02C9, 0x4D07, 0x69D3, { 0x26, 0x9F ,0x44, 0x96, 0xFB, 0xE0, 0x96, 0xF9 }}

+#define EFI_ACPI_6_2_NFIT_GUID_RAM_DISK_SUPPORTING_VIRTUAL_CD_REGION_PERSISTENT   { 0x08018188, 0x42CD, 0xBB48, { 0x10, 0x0F, 0x53, 0x87, 0xD5, 0x3D, 0xED, 0x3D }}

+typedef struct {

+  UINT16                                      Type;

+  UINT16                                      Length;

+  UINT16                                      SPARangeStructureIndex;

+  UINT16                                      Flags;

+  UINT32                                      Reserved_8;

+  UINT32                                      ProximityDomain;

+  GUID                                        AddressRangeTypeGUID;

+  UINT64                                      SystemPhysicalAddressRangeBase;

+  UINT64                                      SystemPhysicalAddressRangeLength;

+  UINT64                                      AddressRangeMemoryMappingAttribute;

+} EFI_ACPI_6_2_NFIT_SYSTEM_PHYSICAL_ADDRESS_RANGE_STRUCTURE;

+

+//

+// Definition for Memory Device to System Physical Address Range Mapping Structure

+//

+typedef struct {

+  UINT32                                      DIMMNumber:4;

+  UINT32                                      MemoryChannelNumber:4;

+  UINT32                                      MemoryControllerID:4;

+  UINT32                                      SocketID:4;

+  UINT32                                      NodeControllerID:12;

+  UINT32                                      Reserved_28:4;

+} EFI_ACPI_6_2_NFIT_DEVICE_HANDLE;

+

+#define EFI_ACPI_6_2_NFIT_MEMORY_DEVICE_STATE_FLAGS_PREVIOUS_SAVE_FAIL                                      BIT0

+#define EFI_ACPI_6_2_NFIT_MEMORY_DEVICE_STATE_FLAGS_LAST_RESTORE_FAIL                                       BIT1

+#define EFI_ACPI_6_2_NFIT_MEMORY_DEVICE_STATE_FLAGS_PLATFORM_FLUSH_FAIL                                     BIT2

+#define EFI_ACPI_6_2_NFIT_MEMORY_DEVICE_STATE_FLAGS_NOT_ARMED_PRIOR_TO_OSPM_HAND_OFF                        BIT3

+#define EFI_ACPI_6_2_NFIT_MEMORY_DEVICE_STATE_FLAGS_SMART_HEALTH_EVENTS_PRIOR_OSPM_HAND_OFF                 BIT4

+#define EFI_ACPI_6_2_NFIT_MEMORY_DEVICE_STATE_FLAGS_FIRMWARE_ENABLED_TO_NOTIFY_OSPM_ON_SMART_HEALTH_EVENTS  BIT5

+#define EFI_ACPI_6_2_NFIT_MEMORY_DEVICE_STATE_FLAGS_FIRMWARE_NOT_MAP_NVDIMM_TO_SPA                          BIT6

+typedef struct {

+  UINT16                                      Type;

+  UINT16                                      Length;

+  EFI_ACPI_6_2_NFIT_DEVICE_HANDLE             NFITDeviceHandle;

+  UINT16                                      NVDIMMPhysicalID;

+  UINT16                                      NVDIMMRegionID;

+  UINT16                                      SPARangeStructureIndex ;

+  UINT16                                      NVDIMMControlRegionStructureIndex;

+  UINT64                                      NVDIMMRegionSize;

+  UINT64                                      RegionOffset;

+  UINT64                                      NVDIMMPhysicalAddressRegionBase;

+  UINT16                                      InterleaveStructureIndex;

+  UINT16                                      InterleaveWays;

+  UINT16                                      NVDIMMStateFlags;

+  UINT16                                      Reserved_46;

+} EFI_ACPI_6_2_NFIT_NVDIMM_REGION_MAPPING_STRUCTURE;

+

+//

+// Definition for Interleave Structure

+//

+typedef struct {

+  UINT16                                      Type;

+  UINT16                                      Length;

+  UINT16                                      InterleaveStructureIndex;

+  UINT16                                      Reserved_6;

+  UINT32                                      NumberOfLines;

+  UINT32                                      LineSize;

+//UINT32                                      LineOffset[NumberOfLines];

+} EFI_ACPI_6_2_NFIT_INTERLEAVE_STRUCTURE;

+

+//

+// Definition for SMBIOS Management Information Structure

+//

+typedef struct {

+  UINT16                                      Type;

+  UINT16                                      Length;

+  UINT32                                      Reserved_4;

+//UINT8                                       Data[];

+} EFI_ACPI_6_2_NFIT_SMBIOS_MANAGEMENT_INFORMATION_STRUCTURE;

+

+//

+// Definition for NVDIMM Control Region Structure

+//

+#define EFI_ACPI_6_2_NFIT_NVDIMM_CONTROL_REGION_VALID_FIELDS_MANUFACTURING           BIT0

+

+#define EFI_ACPI_6_2_NFIT_NVDIMM_CONTROL_REGION_FLAGS_BLOCK_DATA_WINDOWS_BUFFERED    BIT0

+typedef struct {

+  UINT16                                      Type;

+  UINT16                                      Length;

+  UINT16                                      NVDIMMControlRegionStructureIndex;

+  UINT16                                      VendorID;

+  UINT16                                      DeviceID;

+  UINT16                                      RevisionID;

+  UINT16                                      SubsystemVendorID;

+  UINT16                                      SubsystemDeviceID;

+  UINT16                                      SubsystemRevisionID;

+  UINT8                                       ValidFields;

+  UINT8                                       ManufacturingLocation;

+  UINT16                                      ManufacturingDate;

+  UINT8                                       Reserved_22[2];

+  UINT32                                      SerialNumber;

+  UINT16                                      RegionFormatInterfaceCode;

+  UINT16                                      NumberOfBlockControlWindows;

+  UINT64                                      SizeOfBlockControlWindow;

+  UINT64                                      CommandRegisterOffsetInBlockControlWindow;

+  UINT64                                      SizeOfCommandRegisterInBlockControlWindows;

+  UINT64                                      StatusRegisterOffsetInBlockControlWindow;

+  UINT64                                      SizeOfStatusRegisterInBlockControlWindows;

+  UINT16                                      NVDIMMControlRegionFlag;

+  UINT8                                       Reserved_74[6];

+} EFI_ACPI_6_2_NFIT_NVDIMM_CONTROL_REGION_STRUCTURE;

+

+//

+// Definition for NVDIMM Block Data Window Region Structure

+//

+typedef struct {

+  UINT16                                      Type;

+  UINT16                                      Length;

+  UINT16                                      NVDIMMControlRegionStructureIndex;

+  UINT16                                      NumberOfBlockDataWindows;

+  UINT64                                      BlockDataWindowStartOffset;

+  UINT64                                      SizeOfBlockDataWindow;

+  UINT64                                      BlockAccessibleMemoryCapacity;

+  UINT64                                      BeginningAddressOfFirstBlockInBlockAccessibleMemory;

+} EFI_ACPI_6_2_NFIT_NVDIMM_BLOCK_DATA_WINDOW_REGION_STRUCTURE;

+

+//

+// Definition for Flush Hint Address Structure

+//

+typedef struct {

+  UINT16                                      Type;

+  UINT16                                      Length;

+  EFI_ACPI_6_2_NFIT_DEVICE_HANDLE             NFITDeviceHandle;

+  UINT16                                      NumberOfFlushHintAddresses;

+  UINT8                                       Reserved_10[6];

+//UINT64                                      FlushHintAddress[NumberOfFlushHintAddresses];

+} EFI_ACPI_6_2_NFIT_FLUSH_HINT_ADDRESS_STRUCTURE;

+

+///

+/// Secure DEVices Table (SDEV)

+///

+typedef struct {

+  EFI_ACPI_DESCRIPTION_HEADER   Header;

+} EFI_ACPI_6_2_SECURE_DEVICES_TABLE_HEADER;

+

+///

+/// SDEV Revision (as defined in ACPI 6.2 spec.)

+///

+#define EFI_ACPI_6_2_SECURE_DEVICES_TABLE_REVISION      0x01

+

+///

+/// Secure Device types

+///

+#define EFI_ACPI_6_2_SDEV_TYPE_PCIE_ENDPOINT_DEVICE     0x01

+#define EFI_ACPI_6_2_SDEV_TYPE_ACPI_NAMESPACE_DEVICE    0x00

+

+///

+/// Secure Device flags

+///

+#define EFI_ACPI_6_2_SDEV_FLAG_ALLOW_HANDOFF            BIT0

+

+///

+/// SDEV Structure Header

+///

+typedef struct {

+  UINT8                         Type;

+  UINT8                         Flags;

+  UINT16                        Length;

+} EFI_ACPI_6_2_SDEV_STRUCTURE_HEADER;

+

+///

+/// PCIe Endpoint Device based Secure Device Structure

+///

+typedef struct {

+  UINT8                         Type;

+  UINT8                         Flags;

+  UINT16                        Length;

+  UINT16                        PciSegmentNumber;

+  UINT16                        StartBusNumber;

+  UINT16                        PciPathOffset;

+  UINT16                        PciPathLength;

+  UINT16                        VendorSpecificDataOffset;

+  UINT16                        VendorSpecificDataLength;

+} EFI_ACPI_6_2_SDEV_STRUCTURE_PCIE_ENDPOINT_DEVICE;

+

+///

+/// ACPI_NAMESPACE_DEVICE based Secure Device Structure

+///

+typedef struct {

+  UINT8                         Type;

+  UINT8                         Flags;

+  UINT16                        Length;

+  UINT16                        DeviceIdentifierOffset;

+  UINT16                        DeviceIdentifierLength;

+  UINT16                        VendorSpecificDataOffset;

+  UINT16                        VendorSpecificDataLength;

+} EFI_ACPI_6_2_SDEV_STRUCTURE_ACPI_NAMESPACE_DEVICE;

+

+///

+/// Boot Error Record Table (BERT)

+///

+typedef struct {

+  EFI_ACPI_DESCRIPTION_HEADER Header;

+  UINT32                      BootErrorRegionLength;

+  UINT64                      BootErrorRegion;

+} EFI_ACPI_6_2_BOOT_ERROR_RECORD_TABLE_HEADER;

+

+///

+/// BERT Version (as defined in ACPI 6.2 spec.)

+///

+#define EFI_ACPI_6_2_BOOT_ERROR_RECORD_TABLE_REVISION 0x01

+

+///

+/// Boot Error Region Block Status Definition

+///

+typedef struct {

+  UINT32       UncorrectableErrorValid:1;

+  UINT32       CorrectableErrorValid:1;

+  UINT32       MultipleUncorrectableErrors:1;

+  UINT32       MultipleCorrectableErrors:1;

+  UINT32       ErrorDataEntryCount:10;

+  UINT32       Reserved:18;

+} EFI_ACPI_6_2_ERROR_BLOCK_STATUS;

+

+///

+/// Boot Error Region Definition

+///

+typedef struct {

+  EFI_ACPI_6_2_ERROR_BLOCK_STATUS              BlockStatus;

+  UINT32                                       RawDataOffset;

+  UINT32                                       RawDataLength;

+  UINT32                                       DataLength;

+  UINT32                                       ErrorSeverity;

+} EFI_ACPI_6_2_BOOT_ERROR_REGION_STRUCTURE;

+

+//

+// Boot Error Severity types

+//

+#define EFI_ACPI_6_2_ERROR_SEVERITY_CORRECTABLE  0x00

+#define EFI_ACPI_6_2_ERROR_SEVERITY_FATAL        0x01

+#define EFI_ACPI_6_2_ERROR_SEVERITY_CORRECTED    0x02

+#define EFI_ACPI_6_2_ERROR_SEVERITY_NONE         0x03

+

+///

+/// Generic Error Data Entry Definition

+///

+typedef struct {

+  UINT8    SectionType[16];

+  UINT32   ErrorSeverity;

+  UINT16   Revision;

+  UINT8    ValidationBits;

+  UINT8    Flags;

+  UINT32   ErrorDataLength;

+  UINT8    FruId[16];

+  UINT8    FruText[20];

+  UINT8    Timestamp[8];

+} EFI_ACPI_6_2_GENERIC_ERROR_DATA_ENTRY_STRUCTURE;

+

+///

+/// Generic Error Data Entry Version (as defined in ACPI 6.2 spec.)

+///

+#define EFI_ACPI_6_2_GENERIC_ERROR_DATA_ENTRY_REVISION  0x0300

+

+///

+/// HEST - Hardware Error Source Table

+///

+typedef struct {

+  EFI_ACPI_DESCRIPTION_HEADER Header;

+  UINT32                      ErrorSourceCount;

+} EFI_ACPI_6_2_HARDWARE_ERROR_SOURCE_TABLE_HEADER;

+

+///

+/// HEST Version (as defined in ACPI 6.2 spec.)

+///

+#define EFI_ACPI_6_2_HARDWARE_ERROR_SOURCE_TABLE_REVISION 0x01

+

+//

+// Error Source structure types.

+//

+#define EFI_ACPI_6_2_IA32_ARCHITECTURE_MACHINE_CHECK_EXCEPTION  0x00

+#define EFI_ACPI_6_2_IA32_ARCHITECTURE_CORRECTED_MACHINE_CHECK  0x01

+#define EFI_ACPI_6_2_IA32_ARCHITECTURE_NMI_ERROR                0x02

+#define EFI_ACPI_6_2_PCI_EXPRESS_ROOT_PORT_AER                  0x06

+#define EFI_ACPI_6_2_PCI_EXPRESS_DEVICE_AER                     0x07

+#define EFI_ACPI_6_2_PCI_EXPRESS_BRIDGE_AER                     0x08

+#define EFI_ACPI_6_2_GENERIC_HARDWARE_ERROR                     0x09

+#define EFI_ACPI_6_2_GENERIC_HARDWARE_ERROR_VERSION_2           0x0A

+#define EFI_ACPI_6_2_IA32_ARCHITECTURE_DEFERRED_MACHINE_CHECK   0x0B

+

+//

+// Error Source structure flags.

+//

+#define EFI_ACPI_6_2_ERROR_SOURCE_FLAG_FIRMWARE_FIRST       (1 << 0)

+#define EFI_ACPI_6_2_ERROR_SOURCE_FLAG_GLOBAL               (1 << 1)

+#define EFI_ACPI_6_2_ERROR_SOURCE_FLAG_GHES_ASSIST          (1 << 2)

+

+///

+/// IA-32 Architecture Machine Check Exception Structure Definition

+///

+typedef struct {

+  UINT16  Type;

+  UINT16  SourceId;

+  UINT8   Reserved0[2];

+  UINT8   Flags;

+  UINT8   Enabled;

+  UINT32  NumberOfRecordsToPreAllocate;

+  UINT32  MaxSectionsPerRecord;

+  UINT64  GlobalCapabilityInitData;

+  UINT64  GlobalControlInitData;

+  UINT8   NumberOfHardwareBanks;

+  UINT8   Reserved1[7];

+} EFI_ACPI_6_2_IA32_ARCHITECTURE_MACHINE_CHECK_EXCEPTION_STRUCTURE;

+

+///

+/// IA-32 Architecture Machine Check Bank Structure Definition

+///

+typedef struct {

+  UINT8   BankNumber;

+  UINT8   ClearStatusOnInitialization;

+  UINT8   StatusDataFormat;

+  UINT8   Reserved0;

+  UINT32  ControlRegisterMsrAddress;

+  UINT64  ControlInitData;

+  UINT32  StatusRegisterMsrAddress;

+  UINT32  AddressRegisterMsrAddress;

+  UINT32  MiscRegisterMsrAddress;

+} EFI_ACPI_6_2_IA32_ARCHITECTURE_MACHINE_CHECK_ERROR_BANK_STRUCTURE;

+

+///

+/// IA-32 Architecture Machine Check Bank Structure MCA data format

+///

+#define EFI_ACPI_6_2_IA32_ARCHITECTURE_MACHINE_CHECK_ERROR_DATA_FORMAT_IA32      0x00

+#define EFI_ACPI_6_2_IA32_ARCHITECTURE_MACHINE_CHECK_ERROR_DATA_FORMAT_INTEL64   0x01

+#define EFI_ACPI_6_2_IA32_ARCHITECTURE_MACHINE_CHECK_ERROR_DATA_FORMAT_AMD64     0x02

+

+//

+// Hardware Error Notification types. All other values are reserved

+//

+#define EFI_ACPI_6_2_HARDWARE_ERROR_NOTIFICATION_POLLED                         0x00

+#define EFI_ACPI_6_2_HARDWARE_ERROR_NOTIFICATION_EXTERNAL_INTERRUPT             0x01

+#define EFI_ACPI_6_2_HARDWARE_ERROR_NOTIFICATION_LOCAL_INTERRUPT                0x02

+#define EFI_ACPI_6_2_HARDWARE_ERROR_NOTIFICATION_SCI                            0x03

+#define EFI_ACPI_6_2_HARDWARE_ERROR_NOTIFICATION_NMI                            0x04

+#define EFI_ACPI_6_2_HARDWARE_ERROR_NOTIFICATION_CMCI                           0x05

+#define EFI_ACPI_6_2_HARDWARE_ERROR_NOTIFICATION_MCE                            0x06

+#define EFI_ACPI_6_2_HARDWARE_ERROR_NOTIFICATION_GPIO_SIGNAL                    0x07

+#define EFI_ACPI_6_2_HARDWARE_ERROR_NOTIFICATION_ARMV8_SEA                      0x08

+#define EFI_ACPI_6_2_HARDWARE_ERROR_NOTIFICATION_ARMV8_SEI                      0x09

+#define EFI_ACPI_6_2_HARDWARE_ERROR_NOTIFICATION_GSIV                           0x0A

+#define EFI_ACPI_6_2_HARDWARE_ERROR_NOTIFICATION_SOFTWARE_DELEGATED_EXCEPTION   0x0B

+

+///

+/// Hardware Error Notification Configuration Write Enable Structure Definition

+///

+typedef struct {

+  UINT16    Type:1;

+  UINT16    PollInterval:1;

+  UINT16    SwitchToPollingThresholdValue:1;

+  UINT16    SwitchToPollingThresholdWindow:1;

+  UINT16    ErrorThresholdValue:1;

+  UINT16    ErrorThresholdWindow:1;

+  UINT16    Reserved:10;

+} EFI_ACPI_6_2_HARDWARE_ERROR_NOTIFICATION_CONFIGURATION_WRITE_ENABLE_STRUCTURE;

+

+///

+/// Hardware Error Notification Structure Definition

+///

+typedef struct {

+  UINT8                                                                          Type;

+  UINT8                                                                          Length;

+  EFI_ACPI_6_2_HARDWARE_ERROR_NOTIFICATION_CONFIGURATION_WRITE_ENABLE_STRUCTURE  ConfigurationWriteEnable;

+  UINT32                                                                         PollInterval;

+  UINT32                                                                         Vector;

+  UINT32                                                                         SwitchToPollingThresholdValue;

+  UINT32                                                                         SwitchToPollingThresholdWindow;

+  UINT32                                                                         ErrorThresholdValue;

+  UINT32                                                                         ErrorThresholdWindow;

+} EFI_ACPI_6_2_HARDWARE_ERROR_NOTIFICATION_STRUCTURE;

+

+///

+/// IA-32 Architecture Corrected Machine Check Structure Definition

+///

+typedef struct {

+  UINT16                                                 Type;

+  UINT16                                                 SourceId;

+  UINT8                                                  Reserved0[2];

+  UINT8                                                  Flags;

+  UINT8                                                  Enabled;

+  UINT32                                                 NumberOfRecordsToPreAllocate;

+  UINT32                                                 MaxSectionsPerRecord;

+  EFI_ACPI_6_2_HARDWARE_ERROR_NOTIFICATION_STRUCTURE     NotificationStructure;

+  UINT8                                                  NumberOfHardwareBanks;

+  UINT8                                                  Reserved1[3];

+} EFI_ACPI_6_2_IA32_ARCHITECTURE_CORRECTED_MACHINE_CHECK_STRUCTURE;

+

+///

+/// IA-32 Architecture NMI Error Structure Definition

+///

+typedef struct {

+  UINT16  Type;

+  UINT16  SourceId;

+  UINT8   Reserved0[2];

+  UINT32  NumberOfRecordsToPreAllocate;

+  UINT32  MaxSectionsPerRecord;

+  UINT32  MaxRawDataLength;

+} EFI_ACPI_6_2_IA32_ARCHITECTURE_NMI_ERROR_STRUCTURE;

+

+///

+/// PCI Express Root Port AER Structure Definition

+///

+typedef struct {

+  UINT16  Type;

+  UINT16  SourceId;

+  UINT8   Reserved0[2];

+  UINT8   Flags;

+  UINT8   Enabled;

+  UINT32  NumberOfRecordsToPreAllocate;

+  UINT32  MaxSectionsPerRecord;

+  UINT32  Bus;

+  UINT16  Device;

+  UINT16  Function;

+  UINT16  DeviceControl;

+  UINT8   Reserved1[2];

+  UINT32  UncorrectableErrorMask;

+  UINT32  UncorrectableErrorSeverity;

+  UINT32  CorrectableErrorMask;

+  UINT32  AdvancedErrorCapabilitiesAndControl;

+  UINT32  RootErrorCommand;

+} EFI_ACPI_6_2_PCI_EXPRESS_ROOT_PORT_AER_STRUCTURE;

+

+///

+/// PCI Express Device AER Structure Definition

+///

+typedef struct {

+  UINT16  Type;

+  UINT16  SourceId;

+  UINT8   Reserved0[2];

+  UINT8   Flags;

+  UINT8   Enabled;

+  UINT32  NumberOfRecordsToPreAllocate;

+  UINT32  MaxSectionsPerRecord;

+  UINT32  Bus;

+  UINT16  Device;

+  UINT16  Function;

+  UINT16  DeviceControl;

+  UINT8   Reserved1[2];

+  UINT32  UncorrectableErrorMask;

+  UINT32  UncorrectableErrorSeverity;

+  UINT32  CorrectableErrorMask;

+  UINT32  AdvancedErrorCapabilitiesAndControl;

+} EFI_ACPI_6_2_PCI_EXPRESS_DEVICE_AER_STRUCTURE;

+

+///

+/// PCI Express Bridge AER Structure Definition

+///

+typedef struct {

+  UINT16  Type;

+  UINT16  SourceId;

+  UINT8   Reserved0[2];

+  UINT8   Flags;

+  UINT8   Enabled;

+  UINT32  NumberOfRecordsToPreAllocate;

+  UINT32  MaxSectionsPerRecord;

+  UINT32  Bus;

+  UINT16  Device;

+  UINT16  Function;

+  UINT16  DeviceControl;

+  UINT8   Reserved1[2];

+  UINT32  UncorrectableErrorMask;

+  UINT32  UncorrectableErrorSeverity;

+  UINT32  CorrectableErrorMask;

+  UINT32  AdvancedErrorCapabilitiesAndControl;

+  UINT32  SecondaryUncorrectableErrorMask;

+  UINT32  SecondaryUncorrectableErrorSeverity;

+  UINT32  SecondaryAdvancedErrorCapabilitiesAndControl;

+} EFI_ACPI_6_2_PCI_EXPRESS_BRIDGE_AER_STRUCTURE;

+

+///

+/// Generic Hardware Error Source Structure Definition

+///

+typedef struct {

+  UINT16                                                 Type;

+  UINT16                                                 SourceId;

+  UINT16                                                 RelatedSourceId;

+  UINT8                                                  Flags;

+  UINT8                                                  Enabled;

+  UINT32                                                 NumberOfRecordsToPreAllocate;

+  UINT32                                                 MaxSectionsPerRecord;

+  UINT32                                                 MaxRawDataLength;

+  EFI_ACPI_6_2_GENERIC_ADDRESS_STRUCTURE                 ErrorStatusAddress;

+  EFI_ACPI_6_2_HARDWARE_ERROR_NOTIFICATION_STRUCTURE     NotificationStructure;

+  UINT32                                                 ErrorStatusBlockLength;

+} EFI_ACPI_6_2_GENERIC_HARDWARE_ERROR_SOURCE_STRUCTURE;

+

+///

+/// Generic Hardware Error Source Version 2 Structure Definition

+///

+typedef struct {

+  UINT16                                                 Type;

+  UINT16                                                 SourceId;

+  UINT16                                                 RelatedSourceId;

+  UINT8                                                  Flags;

+  UINT8                                                  Enabled;

+  UINT32                                                 NumberOfRecordsToPreAllocate;

+  UINT32                                                 MaxSectionsPerRecord;

+  UINT32                                                 MaxRawDataLength;

+  EFI_ACPI_6_2_GENERIC_ADDRESS_STRUCTURE                 ErrorStatusAddress;

+  EFI_ACPI_6_2_HARDWARE_ERROR_NOTIFICATION_STRUCTURE     NotificationStructure;

+  UINT32                                                 ErrorStatusBlockLength;

+  EFI_ACPI_6_2_GENERIC_ADDRESS_STRUCTURE                 ReadAckRegister;

+  UINT64                                                 ReadAckPreserve;

+  UINT64                                                 ReadAckWrite;

+} EFI_ACPI_6_2_GENERIC_HARDWARE_ERROR_SOURCE_VERSION_2_STRUCTURE;

+

+///

+/// Generic Error Status Definition

+///

+typedef struct {

+  EFI_ACPI_6_2_ERROR_BLOCK_STATUS              BlockStatus;

+  UINT32                                       RawDataOffset;

+  UINT32                                       RawDataLength;

+  UINT32                                       DataLength;

+  UINT32                                       ErrorSeverity;

+} EFI_ACPI_6_2_GENERIC_ERROR_STATUS_STRUCTURE;

+

+///

+/// IA-32 Architecture Deferred Machine Check Structure Definition

+///

+typedef struct {

+  UINT16                                                Type;

+  UINT16                                                SourceId;

+  UINT8                                                 Reserved0[2];

+  UINT8                                                 Flags;

+  UINT8                                                 Enabled;

+  UINT32                                                NumberOfRecordsToPreAllocate;

+  UINT32                                                MaxSectionsPerRecord;

+  EFI_ACPI_6_2_HARDWARE_ERROR_NOTIFICATION_STRUCTURE    NotificationStructure;

+  UINT8                                                 NumberOfHardwareBanks;

+  UINT8                                                 Reserved1[3];

+} EFI_ACPI_6_2_IA32_ARCHITECTURE_DEFERRED_MACHINE_CHECK_STRUCTURE;;

+

+///

+/// HMAT - Heterogeneous Memory Attribute Table

+///

+typedef struct {

+  EFI_ACPI_DESCRIPTION_HEADER Header;

+  UINT8                       Reserved[4];

+} EFI_ACPI_6_2_HETEROGENEOUS_MEMORY_ATTRIBUTE_TABLE_HEADER;

+

+///

+/// HMAT Revision (as defined in ACPI 6.2 spec.)

+///

+#define EFI_ACPI_6_2_HETEROGENEOUS_MEMORY_ATTRIBUTE_TABLE_REVISION 0x01

+

+///

+/// HMAT types

+///

+#define EFI_ACPI_6_2_HMAT_TYPE_MEMORY_SUBSYSTEM_ADDRESS_RANGE               0x00

+#define EFI_ACPI_6_2_HMAT_TYPE_SYSTEM_LOCALITY_LATENCY_AND_BANDWIDTH_INFO   0x01

+#define EFI_ACPI_6_2_HMAT_TYPE_MEMORY_SIDE_CACHE_INFO                       0x02

+

+///

+/// HMAT Structure Header

+///

+typedef struct {

+  UINT16                        Type;

+  UINT8                         Reserved[2];

+  UINT32                        Length;

+} EFI_ACPI_6_2_HMAT_STRUCTURE_HEADER;

+

+///

+/// Memory Subsystem Address Range Structure flags

+///

+typedef struct {

+  UINT16                        ProcessorProximityDomainValid:1;

+  UINT16                        MemoryProximityDomainValid:1;

+  UINT16                        ReservationHint:1;

+  UINT16                        Reserved:13;

+} EFI_ACPI_6_2_HMAT_STRUCTURE_MEMORY_SUBSYSTEM_ADDRESS_RANGE_FLAGS;

+

+///

+/// Memory Subsystem Address Range Structure

+///

+typedef struct {

+  UINT16                                                            Type;

+  UINT8                                                             Reserved[2];

+  UINT32                                                            Length;

+  EFI_ACPI_6_2_HMAT_STRUCTURE_MEMORY_SUBSYSTEM_ADDRESS_RANGE_FLAGS  Flags;

+  UINT8                                                             Reserved1[2];

+  UINT32                                                            ProcessorProximityDomain;

+  UINT32                                                            MemoryProximityDomain;

+  UINT8                                                             Reserved2[4];

+  UINT64                                                            SystemPhysicalAddressRangeBase;

+  UINT64                                                            SystemPhysicalAddressRangeLength;

+} EFI_ACPI_6_2_HMAT_STRUCTURE_MEMORY_SUBSYSTEM_ADDRESS_RANGE;

+

+///

+/// System Locality Latency and Bandwidth Information Structure flags

+///

+typedef struct {

+  UINT8                         MemoryHierarchy:5;

+  UINT8                         Reserved:3;

+} EFI_ACPI_6_2_HMAT_STRUCTURE_SYSTEM_LOCALITY_LATENCY_AND_BANDWIDTH_INFO_FLAGS;

+

+///

+/// System Locality Latency and Bandwidth Information Structure

+///

+typedef struct {

+  UINT16                                                                        Type;

+  UINT8                                                                         Reserved[2];

+  UINT32                                                                        Length;

+  EFI_ACPI_6_2_HMAT_STRUCTURE_SYSTEM_LOCALITY_LATENCY_AND_BANDWIDTH_INFO_FLAGS  Flags;

+  UINT8                                                                         DataType;

+  UINT8                                                                         Reserved1[2];

+  UINT32                                                                        NumberOfInitiatorProximityDomains;

+  UINT32                                                                        NumberOfTargetProximityDomains;

+  UINT8                                                                         Reserved2[4];

+  UINT64                                                                        EntryBaseUnit;

+} EFI_ACPI_6_2_HMAT_STRUCTURE_SYSTEM_LOCALITY_LATENCY_AND_BANDWIDTH_INFO;

+

+///

+/// Memory Side Cache Information Structure cache attributes

+///

+typedef struct {

+  UINT32                        TotalCacheLevels:4;

+  UINT32                        CacheLevel:4;

+  UINT32                        CacheAssociativity:4;

+  UINT32                        WritePolicy:4;

+  UINT32                        CacheLineSize:16;

+} EFI_ACPI_6_2_HMAT_STRUCTURE_MEMORY_SIDE_CACHE_INFO_CACHE_ATTRIBUTES;

+

+///

+/// Memory Side Cache Information Structure

+///

+typedef struct {

+  UINT16                                                                Type;

+  UINT8                                                                 Reserved[2];

+  UINT32                                                                Length;

+  UINT32                                                                MemoryProximityDomain;

+  UINT8                                                                 Reserved1[4];

+  UINT64                                                                MemorySideCacheSize;

+  EFI_ACPI_6_2_HMAT_STRUCTURE_MEMORY_SIDE_CACHE_INFO_CACHE_ATTRIBUTES   CacheAttributes;

+  UINT8                                                                 Reserved2[2];

+  UINT16                                                                NumberOfSmbiosHandles;

+} EFI_ACPI_6_2_HMAT_STRUCTURE_MEMORY_SIDE_CACHE_INFO;

+

+///

+/// ERST - Error Record Serialization Table

+///

+typedef struct {

+  EFI_ACPI_DESCRIPTION_HEADER Header;

+  UINT32                      SerializationHeaderSize;

+  UINT8                       Reserved0[4];

+  UINT32                      InstructionEntryCount;

+} EFI_ACPI_6_2_ERROR_RECORD_SERIALIZATION_TABLE_HEADER;

+

+///

+/// ERST Version (as defined in ACPI 6.2 spec.)

+///

+#define EFI_ACPI_6_2_ERROR_RECORD_SERIALIZATION_TABLE_REVISION 0x01

+

+///

+/// ERST Serialization Actions

+///

+#define EFI_ACPI_6_2_ERST_BEGIN_WRITE_OPERATION                    0x00

+#define EFI_ACPI_6_2_ERST_BEGIN_READ_OPERATION                     0x01

+#define EFI_ACPI_6_2_ERST_BEGIN_CLEAR_OPERATION                    0x02

+#define EFI_ACPI_6_2_ERST_END_OPERATION                            0x03

+#define EFI_ACPI_6_2_ERST_SET_RECORD_OFFSET                        0x04

+#define EFI_ACPI_6_2_ERST_EXECUTE_OPERATION                        0x05

+#define EFI_ACPI_6_2_ERST_CHECK_BUSY_STATUS                        0x06

+#define EFI_ACPI_6_2_ERST_GET_COMMAND_STATUS                       0x07

+#define EFI_ACPI_6_2_ERST_GET_RECORD_IDENTIFIER                    0x08

+#define EFI_ACPI_6_2_ERST_SET_RECORD_IDENTIFIER                    0x09

+#define EFI_ACPI_6_2_ERST_GET_RECORD_COUNT                         0x0A

+#define EFI_ACPI_6_2_ERST_BEGIN_DUMMY_WRITE_OPERATION              0x0B

+#define EFI_ACPI_6_2_ERST_GET_ERROR_LOG_ADDRESS_RANGE              0x0D

+#define EFI_ACPI_6_2_ERST_GET_ERROR_LOG_ADDRESS_RANGE_LENGTH       0x0E

+#define EFI_ACPI_6_2_ERST_GET_ERROR_LOG_ADDRESS_RANGE_ATTRIBUTES   0x0F

+#define EFI_ACPI_6_2_ERST_GET_EXECUTE_OPERATION_TIMINGS            0x10

+

+///

+/// ERST Action Command Status

+///

+#define EFI_ACPI_6_2_ERST_STATUS_SUCCESS                           0x00

+#define EFI_ACPI_6_2_ERST_STATUS_NOT_ENOUGH_SPACE                  0x01

+#define EFI_ACPI_6_2_ERST_STATUS_HARDWARE_NOT_AVAILABLE            0x02

+#define EFI_ACPI_6_2_ERST_STATUS_FAILED                            0x03

+#define EFI_ACPI_6_2_ERST_STATUS_RECORD_STORE_EMPTY                0x04

+#define EFI_ACPI_6_2_ERST_STATUS_RECORD_NOT_FOUND                  0x05

+

+///

+/// ERST Serialization Instructions

+///

+#define EFI_ACPI_6_2_ERST_READ_REGISTER                            0x00

+#define EFI_ACPI_6_2_ERST_READ_REGISTER_VALUE                      0x01

+#define EFI_ACPI_6_2_ERST_WRITE_REGISTER                           0x02

+#define EFI_ACPI_6_2_ERST_WRITE_REGISTER_VALUE                     0x03

+#define EFI_ACPI_6_2_ERST_NOOP                                     0x04

+#define EFI_ACPI_6_2_ERST_LOAD_VAR1                                0x05

+#define EFI_ACPI_6_2_ERST_LOAD_VAR2                                0x06

+#define EFI_ACPI_6_2_ERST_STORE_VAR1                               0x07

+#define EFI_ACPI_6_2_ERST_ADD                                      0x08

+#define EFI_ACPI_6_2_ERST_SUBTRACT                                 0x09

+#define EFI_ACPI_6_2_ERST_ADD_VALUE                                0x0A

+#define EFI_ACPI_6_2_ERST_SUBTRACT_VALUE                           0x0B

+#define EFI_ACPI_6_2_ERST_STALL                                    0x0C

+#define EFI_ACPI_6_2_ERST_STALL_WHILE_TRUE                         0x0D

+#define EFI_ACPI_6_2_ERST_SKIP_NEXT_INSTRUCTION_IF_TRUE            0x0E

+#define EFI_ACPI_6_2_ERST_GOTO                                     0x0F

+#define EFI_ACPI_6_2_ERST_SET_SRC_ADDRESS_BASE                     0x10

+#define EFI_ACPI_6_2_ERST_SET_DST_ADDRESS_BASE                     0x11

+#define EFI_ACPI_6_2_ERST_MOVE_DATA                                0x12

+

+///

+/// ERST Instruction Flags

+///

+#define EFI_ACPI_6_2_ERST_PRESERVE_REGISTER                        0x01

+

+///

+/// ERST Serialization Instruction Entry

+///

+typedef struct {

+  UINT8                                    SerializationAction;

+  UINT8                                    Instruction;

+  UINT8                                    Flags;

+  UINT8                                    Reserved0;

+  EFI_ACPI_6_2_GENERIC_ADDRESS_STRUCTURE   RegisterRegion;

+  UINT64                                   Value;

+  UINT64                                   Mask;

+} EFI_ACPI_6_2_ERST_SERIALIZATION_INSTRUCTION_ENTRY;

+

+///

+/// EINJ - Error Injection Table

+///

+typedef struct {

+  EFI_ACPI_DESCRIPTION_HEADER Header;

+  UINT32                      InjectionHeaderSize;

+  UINT8                       InjectionFlags;

+  UINT8                       Reserved0[3];

+  UINT32                      InjectionEntryCount;

+} EFI_ACPI_6_2_ERROR_INJECTION_TABLE_HEADER;

+

+///

+/// EINJ Version (as defined in ACPI 6.2 spec.)

+///

+#define EFI_ACPI_6_2_ERROR_INJECTION_TABLE_REVISION 0x01

+

+///

+/// EINJ Error Injection Actions

+///

+#define EFI_ACPI_6_2_EINJ_BEGIN_INJECTION_OPERATION                0x00

+#define EFI_ACPI_6_2_EINJ_GET_TRIGGER_ERROR_ACTION_TABLE           0x01

+#define EFI_ACPI_6_2_EINJ_SET_ERROR_TYPE                           0x02

+#define EFI_ACPI_6_2_EINJ_GET_ERROR_TYPE                           0x03

+#define EFI_ACPI_6_2_EINJ_END_OPERATION                            0x04

+#define EFI_ACPI_6_2_EINJ_EXECUTE_OPERATION                        0x05

+#define EFI_ACPI_6_2_EINJ_CHECK_BUSY_STATUS                        0x06

+#define EFI_ACPI_6_2_EINJ_GET_COMMAND_STATUS                       0x07

+#define EFI_ACPI_6_2_EINJ_TRIGGER_ERROR                            0xFF

+

+///

+/// EINJ Action Command Status

+///

+#define EFI_ACPI_6_2_EINJ_STATUS_SUCCESS                           0x00

+#define EFI_ACPI_6_2_EINJ_STATUS_UNKNOWN_FAILURE                   0x01

+#define EFI_ACPI_6_2_EINJ_STATUS_INVALID_ACCESS                    0x02

+

+///

+/// EINJ Error Type Definition

+///

+#define EFI_ACPI_6_2_EINJ_ERROR_PROCESSOR_CORRECTABLE                 (1 << 0)

+#define EFI_ACPI_6_2_EINJ_ERROR_PROCESSOR_UNCORRECTABLE_NONFATAL      (1 << 1)

+#define EFI_ACPI_6_2_EINJ_ERROR_PROCESSOR_UNCORRECTABLE_FATAL         (1 << 2)

+#define EFI_ACPI_6_2_EINJ_ERROR_MEMORY_CORRECTABLE                    (1 << 3)

+#define EFI_ACPI_6_2_EINJ_ERROR_MEMORY_UNCORRECTABLE_NONFATAL         (1 << 4)

+#define EFI_ACPI_6_2_EINJ_ERROR_MEMORY_UNCORRECTABLE_FATAL            (1 << 5)

+#define EFI_ACPI_6_2_EINJ_ERROR_PCI_EXPRESS_CORRECTABLE               (1 << 6)

+#define EFI_ACPI_6_2_EINJ_ERROR_PCI_EXPRESS_UNCORRECTABLE_NONFATAL    (1 << 7)

+#define EFI_ACPI_6_2_EINJ_ERROR_PCI_EXPRESS_UNCORRECTABLE_FATAL       (1 << 8)

+#define EFI_ACPI_6_2_EINJ_ERROR_PLATFORM_CORRECTABLE                  (1 << 9)

+#define EFI_ACPI_6_2_EINJ_ERROR_PLATFORM_UNCORRECTABLE_NONFATAL       (1 << 10)

+#define EFI_ACPI_6_2_EINJ_ERROR_PLATFORM_UNCORRECTABLE_FATAL          (1 << 11)

+

+///

+/// EINJ Injection Instructions

+///

+#define EFI_ACPI_6_2_EINJ_READ_REGISTER                            0x00

+#define EFI_ACPI_6_2_EINJ_READ_REGISTER_VALUE                      0x01

+#define EFI_ACPI_6_2_EINJ_WRITE_REGISTER                           0x02

+#define EFI_ACPI_6_2_EINJ_WRITE_REGISTER_VALUE                     0x03

+#define EFI_ACPI_6_2_EINJ_NOOP                                     0x04

+

+///

+/// EINJ Instruction Flags

+///

+#define EFI_ACPI_6_2_EINJ_PRESERVE_REGISTER                        0x01

+

+///

+/// EINJ Injection Instruction Entry

+///

+typedef struct {

+  UINT8                                    InjectionAction;

+  UINT8                                    Instruction;

+  UINT8                                    Flags;

+  UINT8                                    Reserved0;

+  EFI_ACPI_6_2_GENERIC_ADDRESS_STRUCTURE   RegisterRegion;

+  UINT64                                   Value;

+  UINT64                                   Mask;

+} EFI_ACPI_6_2_EINJ_INJECTION_INSTRUCTION_ENTRY;

+

+///

+/// EINJ Trigger Action Table

+///

+typedef struct {

+  UINT32  HeaderSize;

+  UINT32  Revision;

+  UINT32  TableSize;

+  UINT32  EntryCount;

+} EFI_ACPI_6_2_EINJ_TRIGGER_ACTION_TABLE;

+

+///

+/// Platform Communications Channel Table (PCCT)

+///

+typedef struct {

+  EFI_ACPI_DESCRIPTION_HEADER Header;

+  UINT32                      Flags;

+  UINT64                      Reserved;

+} EFI_ACPI_6_2_PLATFORM_COMMUNICATION_CHANNEL_TABLE_HEADER;

+

+///

+/// PCCT Version (as defined in ACPI 6.2 spec.)

+///

+#define EFI_ACPI_6_2_PLATFORM_COMMUNICATION_CHANNEL_TABLE_REVISION 0x02

+

+///

+/// PCCT Global Flags

+///

+#define EFI_ACPI_6_2_PCCT_FLAGS_PLATFORM_INTERRUPT  BIT0

+

+//

+// PCCT Subspace type

+//

+#define EFI_ACPI_6_2_PCCT_SUBSPACE_TYPE_GENERIC                         0x00

+#define EFI_ACPI_6_2_PCCT_SUBSPACE_TYPE_1_HW_REDUCED_COMMUNICATIONS     0x01

+#define EFI_ACPI_6_2_PCCT_SUBSPACE_TYPE_2_HW_REDUCED_COMMUNICATIONS     0x02

+#define EFI_ACPI_6_2_PCCT_SUBSPACE_TYPE_3_EXTENDED_PCC                  0x03

+#define EFI_ACPI_6_2_PCCT_SUBSPACE_TYPE_4_EXTENDED_PCC                  0x04

+

+///

+/// PCC Subspace Structure Header

+///

+typedef struct {

+  UINT8        Type;

+  UINT8        Length;

+} EFI_ACPI_6_2_PCCT_SUBSPACE_HEADER;

+

+///

+/// Generic Communications Subspace Structure

+///

+typedef struct {

+  UINT8                                    Type;

+  UINT8                                    Length;

+  UINT8                                    Reserved[6];

+  UINT64                                   BaseAddress;

+  UINT64                                   AddressLength;

+  EFI_ACPI_6_2_GENERIC_ADDRESS_STRUCTURE   DoorbellRegister;

+  UINT64                                   DoorbellPreserve;

+  UINT64                                   DoorbellWrite;

+  UINT32                                   NominalLatency;

+  UINT32                                   MaximumPeriodicAccessRate;

+  UINT16                                   MinimumRequestTurnaroundTime;

+} EFI_ACPI_6_2_PCCT_SUBSPACE_GENERIC;

+

+///

+/// Generic Communications Channel Shared Memory Region

+///

+

+typedef struct {

+  UINT8                                    Command;

+  UINT8                                    Reserved:7;

+  UINT8                                    NotifyOnCompletion:1;

+} EFI_ACPI_6_2_PCCT_GENERIC_SHARED_MEMORY_REGION_COMMAND;

+

+typedef struct {

+  UINT8                                    CommandComplete:1;

+  UINT8                                    PlatformInterrupt:1;

+  UINT8                                    Error:1;

+  UINT8                                    PlatformNotification:1;

+  UINT8                                    Reserved:4;

+  UINT8                                    Reserved1;

+} EFI_ACPI_6_2_PCCT_GENERIC_SHARED_MEMORY_REGION_STATUS;

+

+typedef struct {

+  UINT32                                                    Signature;

+  EFI_ACPI_6_2_PCCT_GENERIC_SHARED_MEMORY_REGION_COMMAND    Command;

+  EFI_ACPI_6_2_PCCT_GENERIC_SHARED_MEMORY_REGION_STATUS     Status;

+} EFI_ACPI_6_2_PCCT_GENERIC_SHARED_MEMORY_REGION_HEADER;

+

+#define EFI_ACPI_6_2_PCCT_SUBSPACE_PLATFORM_INTERRUPT_FLAGS_POLARITY    BIT0

+#define EFI_ACPI_6_2_PCCT_SUBSPACE_PLATFORM_INTERRUPT_FLAGS_MODE        BIT1

+

+///

+/// Type 1 HW-Reduced Communications Subspace Structure

+///

+typedef struct {

+  UINT8                                    Type;

+  UINT8                                    Length;

+  UINT32                                   PlatformInterrupt;

+  UINT8                                    PlatformInterruptFlags;

+  UINT8                                    Reserved;

+  UINT64                                   BaseAddress;

+  UINT64                                   AddressLength;

+  EFI_ACPI_6_2_GENERIC_ADDRESS_STRUCTURE   DoorbellRegister;

+  UINT64                                   DoorbellPreserve;

+  UINT64                                   DoorbellWrite;

+  UINT32                                   NominalLatency;

+  UINT32                                   MaximumPeriodicAccessRate;

+  UINT16                                   MinimumRequestTurnaroundTime;

+} EFI_ACPI_6_2_PCCT_SUBSPACE_1_HW_REDUCED_COMMUNICATIONS;

+

+///

+/// Type 2 HW-Reduced Communications Subspace Structure

+///

+typedef struct {

+  UINT8                                    Type;

+  UINT8                                    Length;

+  UINT32                                   PlatformInterrupt;

+  UINT8                                    PlatformInterruptFlags;

+  UINT8                                    Reserved;

+  UINT64                                   BaseAddress;

+  UINT64                                   AddressLength;

+  EFI_ACPI_6_2_GENERIC_ADDRESS_STRUCTURE   DoorbellRegister;

+  UINT64                                   DoorbellPreserve;

+  UINT64                                   DoorbellWrite;

+  UINT32                                   NominalLatency;

+  UINT32                                   MaximumPeriodicAccessRate;

+  UINT16                                   MinimumRequestTurnaroundTime;

+  EFI_ACPI_6_2_GENERIC_ADDRESS_STRUCTURE   PlatformInterruptAckRegister;

+  UINT64                                   PlatformInterruptAckPreserve;

+  UINT64                                   PlatformInterruptAckWrite;

+} EFI_ACPI_6_2_PCCT_SUBSPACE_2_HW_REDUCED_COMMUNICATIONS;

+

+///

+/// Type 3 Extended PCC Subspace Structure

+///

+typedef struct {

+  UINT8                                    Type;

+  UINT8                                    Length;

+  UINT32                                   PlatformInterrupt;

+  UINT8                                    PlatformInterruptFlags;

+  UINT8                                    Reserved;

+  UINT64                                   BaseAddress;

+  UINT32                                   AddressLength;

+  EFI_ACPI_6_2_GENERIC_ADDRESS_STRUCTURE   DoorbellRegister;

+  UINT64                                   DoorbellPreserve;

+  UINT64                                   DoorbellWrite;

+  UINT32                                   NominalLatency;

+  UINT32                                   MaximumPeriodicAccessRate;

+  UINT32                                   MinimumRequestTurnaroundTime;

+  EFI_ACPI_6_2_GENERIC_ADDRESS_STRUCTURE   PlatformInterruptAckRegister;

+  UINT64                                   PlatformInterruptAckPreserve;

+  UINT64                                   PlatformInterruptAckSet;

+  UINT8                                    Reserved1[8];

+  EFI_ACPI_6_2_GENERIC_ADDRESS_STRUCTURE   CommandCompleteCheckRegister;

+  UINT64                                   CommandCompleteCheckMask;

+  EFI_ACPI_6_2_GENERIC_ADDRESS_STRUCTURE   CommandCompleteUpdateRegister;

+  UINT64                                   CommandCompleteUpdatePreserve;

+  UINT64                                   CommandCompleteUpdateSet;

+  EFI_ACPI_6_2_GENERIC_ADDRESS_STRUCTURE   ErrorStatusRegister;

+  UINT64                                   ErrorStatusMask;

+} EFI_ACPI_6_2_PCCT_SUBSPACE_3_EXTENDED_PCC;

+

+///

+/// Type 4 Extended PCC Subspace Structure

+///

+typedef EFI_ACPI_6_2_PCCT_SUBSPACE_3_EXTENDED_PCC EFI_ACPI_6_2_PCCT_SUBSPACE_4_EXTENDED_PCC;

+

+#define EFI_ACPI_6_2_PCCT_MASTER_SLAVE_COMMUNICATIONS_CHANNEL_FLAGS_NOTIFY_ON_COMPLETION BIT0

+

+typedef struct {

+  UINT32                                    Signature;

+  UINT32                                    Flags;

+  UINT32                                    Length;

+  UINT32                                    Command;

+} EFI_ACPI_6_2_PCCT_EXTENDED_PCC_SHARED_MEMORY_REGION_HEADER;

+

+///

+/// Platform Debug Trigger Table (PDTT)

+///

+typedef struct {

+  EFI_ACPI_DESCRIPTION_HEADER   Header;

+  UINT8                         TriggerCount;

+  UINT8                         Reserved[3];

+  UINT32                        TriggerIdentifierArrayOffset;

+} EFI_ACPI_6_2_PLATFORM_DEBUG_TRIGGER_TABLE_HEADER;

+

+///

+/// PDTT Revision (as defined in ACPI 6.2 spec.)

+///

+#define EFI_ACPI_6_2_PLATFORM_DEBUG_TRIGGER_TABLE_REVISION 0x00

+

+///

+/// PDTT Platform Communication Channel Identifier Structure

+///

+typedef struct {

+  UINT16                        SubChannelIdentifer:8;

+  UINT16                        Runtime:1;

+  UINT16                        WaitForCompletion:1;

+  UINT16                        Reserved:6;

+} EFI_ACPI_6_2_PDTT_PCC_IDENTIFIER;

+

+///

+/// PCC Commands Codes used by Platform Debug Trigger Table

+///

+#define EFI_ACPI_6_2_PDTT_PCC_COMMAND_DOORBELL_ONLY     0x00

+#define EFI_ACPI_6_2_PDTT_PCC_COMMAND_VENDOR_SPECIFIC   0x01

+

+///

+/// PPTT Platform Communication Channel

+///

+typedef EFI_ACPI_6_2_PCCT_GENERIC_SHARED_MEMORY_REGION_HEADER EFI_ACPI_6_2_PDTT_PCC;

+

+///

+/// Processor Properties Topology Table (PPTT)

+///

+typedef struct {

+  EFI_ACPI_DESCRIPTION_HEADER   Header;

+} EFI_ACPI_6_2_PROCESSOR_PROPERTIES_TOPOLOGY_TABLE_HEADER;

+

+///

+/// PPTT Revision (as defined in ACPI 6.2 spec.)

+///

+#define EFI_ACPI_6_2_PROCESSOR_PROPERTIES_TOPOLOGY_TABLE_REVISION 0x01

+

+///

+/// PPTT types

+///

+#define EFI_ACPI_6_2_PPTT_TYPE_PROCESSOR     0x00

+#define EFI_ACPI_6_2_PPTT_TYPE_CACHE         0x01

+#define EFI_ACPI_6_2_PPTT_TYPE_ID            0x02

+

+///

+/// PPTT Structure Header

+///

+typedef struct {

+  UINT8                         Type;

+  UINT8                         Length;

+  UINT8                         Reserved[2];

+} EFI_ACPI_6_2_PPTT_STRUCTURE_HEADER;

+

+///

+/// For PPTT struct processor flags

+///

+#define EFI_ACPI_6_2_PPTT_PROCESSOR_ID_INVALID 0x0

+#define EFI_ACPI_6_2_PPTT_PROCESSOR_ID_VALID   0x1

+

+///

+/// Processor hierarchy node structure flags

+///

+typedef struct {

+  UINT32                        PhysicalPackage:1;

+  UINT32                        AcpiProcessorIdValid:1;

+  UINT32                        Reserved:30;

+} EFI_ACPI_6_2_PPTT_STRUCTURE_PROCESSOR_FLAGS;

+

+///

+/// Processor hierarchy node structure

+///

+typedef struct {

+  UINT8                                         Type;

+  UINT8                                         Length;

+  UINT8                                         Reserved[2];

+  EFI_ACPI_6_2_PPTT_STRUCTURE_PROCESSOR_FLAGS   Flags;

+  UINT32                                        Parent;

+  UINT32                                        AcpiProcessorId;

+  UINT32                                        NumberOfPrivateResources;

+} EFI_ACPI_6_2_PPTT_STRUCTURE_PROCESSOR;

+

+///

+/// Cache Type Structure flags

+///

+typedef struct {

+  UINT32                        SizePropertyValid:1;

+  UINT32                        NumberOfSetsValid:1;

+  UINT32                        AssociativityValid:1;

+  UINT32                        AllocationTypeValid:1;

+  UINT32                        CacheTypeValid:1;

+  UINT32                        WritePolicyValid:1;

+  UINT32                        LineSizeValid:1;

+  UINT32                        Reserved:25;

+} EFI_ACPI_6_2_PPTT_STRUCTURE_CACHE_FLAGS;

+

+///

+/// For cache attributes

+///

+#define EFI_ACPI_6_2_CACHE_ATTRIBUTES_ALLOCATION_READ            0x0

+#define EFI_ACPI_6_2_CACHE_ATTRIBUTES_ALLOCATION_WRITE           0x1

+#define EFI_ACPI_6_2_CACHE_ATTRIBUTES_ALLOCATION_READ_WRITE      0x2

+#define EFI_ACPI_6_2_CACHE_ATTRIBUTES_CACHE_TYPE_DATA            0x0

+#define EFI_ACPI_6_2_CACHE_ATTRIBUTES_CACHE_TYPE_INSTRUCTION     0x1

+#define EFI_ACPI_6_2_CACHE_ATTRIBUTES_CACHE_TYPE_UNIFIED         0x2

+#define EFI_ACPI_6_2_CACHE_ATTRIBUTES_WRITE_POLICY_WRITE_BACK    0x0

+#define EFI_ACPI_6_2_CACHE_ATTRIBUTES_WRITE_POLICY_WRITE_THROUGH 0x1

+

+///

+/// Cache Type Structure cache attributes

+///

+typedef struct {

+  UINT8                         AllocationType:2;

+  UINT8                         CacheType:2;

+  UINT8                         WritePolicy:1;

+  UINT8                         Reserved:3;

+} EFI_ACPI_6_2_PPTT_STRUCTURE_CACHE_ATTRIBUTES;

+

+///

+/// Cache Type Structure

+///

+typedef struct {

+  UINT8                                         Type;

+  UINT8                                         Length;

+  UINT8                                         Reserved[2];

+  EFI_ACPI_6_2_PPTT_STRUCTURE_CACHE_FLAGS       Flags;

+  UINT32                                        NextLevelOfCache;

+  UINT32                                        Size;

+  UINT32                                        NumberOfSets;

+  UINT8                                         Associativity;

+  EFI_ACPI_6_2_PPTT_STRUCTURE_CACHE_ATTRIBUTES  Attributes;

+  UINT16                                        LineSize;

+} EFI_ACPI_6_2_PPTT_STRUCTURE_CACHE;

+

+///

+/// ID structure

+///

+typedef struct {

+  UINT8                         Type;

+  UINT8                         Length;

+  UINT8                         Reserved[2];

+  UINT32                        VendorId;

+  UINT64                        Level1Id;

+  UINT64                        Level2Id;

+  UINT16                        MajorRev;

+  UINT16                        MinorRev;

+  UINT16                        SpinRev;

+} EFI_ACPI_6_2_PPTT_STRUCTURE_ID;

+

+//

+// Known table signatures

+//

+

+///

+/// "RSD PTR " Root System Description Pointer

+///

+#define EFI_ACPI_6_2_ROOT_SYSTEM_DESCRIPTION_POINTER_SIGNATURE  SIGNATURE_64('R', 'S', 'D', ' ', 'P', 'T', 'R', ' ')

+

+///

+/// "APIC" Multiple APIC Description Table

+///

+#define EFI_ACPI_6_2_MULTIPLE_APIC_DESCRIPTION_TABLE_SIGNATURE  SIGNATURE_32('A', 'P', 'I', 'C')

+

+///

+/// "BERT" Boot Error Record Table

+///

+#define EFI_ACPI_6_2_BOOT_ERROR_RECORD_TABLE_SIGNATURE  SIGNATURE_32('B', 'E', 'R', 'T')

+

+///

+/// "BGRT" Boot Graphics Resource Table

+///

+#define EFI_ACPI_6_2_BOOT_GRAPHICS_RESOURCE_TABLE_SIGNATURE  SIGNATURE_32('B', 'G', 'R', 'T')

+

+///

+/// "CPEP" Corrected Platform Error Polling Table

+///

+#define EFI_ACPI_6_2_CORRECTED_PLATFORM_ERROR_POLLING_TABLE_SIGNATURE  SIGNATURE_32('C', 'P', 'E', 'P')

+

+///

+/// "DSDT" Differentiated System Description Table

+///

+#define EFI_ACPI_6_2_DIFFERENTIATED_SYSTEM_DESCRIPTION_TABLE_SIGNATURE  SIGNATURE_32('D', 'S', 'D', 'T')

+

+///

+/// "ECDT" Embedded Controller Boot Resources Table

+///

+#define EFI_ACPI_6_2_EMBEDDED_CONTROLLER_BOOT_RESOURCES_TABLE_SIGNATURE  SIGNATURE_32('E', 'C', 'D', 'T')

+

+///

+/// "EINJ" Error Injection Table

+///

+#define EFI_ACPI_6_2_ERROR_INJECTION_TABLE_SIGNATURE  SIGNATURE_32('E', 'I', 'N', 'J')

+

+///

+/// "ERST" Error Record Serialization Table

+///

+#define EFI_ACPI_6_2_ERROR_RECORD_SERIALIZATION_TABLE_SIGNATURE  SIGNATURE_32('E', 'R', 'S', 'T')

+

+///

+/// "FACP" Fixed ACPI Description Table

+///

+#define EFI_ACPI_6_2_FIXED_ACPI_DESCRIPTION_TABLE_SIGNATURE  SIGNATURE_32('F', 'A', 'C', 'P')

+

+///

+/// "FACS" Firmware ACPI Control Structure

+///

+#define EFI_ACPI_6_2_FIRMWARE_ACPI_CONTROL_STRUCTURE_SIGNATURE  SIGNATURE_32('F', 'A', 'C', 'S')

+

+///

+/// "FPDT" Firmware Performance Data Table

+///

+#define EFI_ACPI_6_2_FIRMWARE_PERFORMANCE_DATA_TABLE_SIGNATURE  SIGNATURE_32('F', 'P', 'D', 'T')

+

+///

+/// "GTDT" Generic Timer Description Table

+///

+#define EFI_ACPI_6_2_GENERIC_TIMER_DESCRIPTION_TABLE_SIGNATURE  SIGNATURE_32('G', 'T', 'D', 'T')

+

+///

+/// "HEST" Hardware Error Source Table

+///

+#define EFI_ACPI_6_2_HARDWARE_ERROR_SOURCE_TABLE_SIGNATURE  SIGNATURE_32('H', 'E', 'S', 'T')

+

+///

+/// "HMAT" Heterogeneous Memory Attribute Table

+///

+#define EFI_ACPI_6_2_HETEROGENEOUS_MEMORY_ATTRIBUTE_TABLE_SIGNATURE  SIGNATURE_32('H', 'M', 'A', 'T')

+

+///

+/// "MPST" Memory Power State Table

+///

+#define EFI_ACPI_6_2_MEMORY_POWER_STATE_TABLE_SIGNATURE  SIGNATURE_32('M', 'P', 'S', 'T')

+

+///

+/// "MSCT" Maximum System Characteristics Table

+///

+#define EFI_ACPI_6_2_MAXIMUM_SYSTEM_CHARACTERISTICS_TABLE_SIGNATURE  SIGNATURE_32('M', 'S', 'C', 'T')

+

+///

+/// "NFIT" NVDIMM Firmware Interface Table

+///

+#define EFI_ACPI_6_2_NVDIMM_FIRMWARE_INTERFACE_TABLE_STRUCTURE_SIGNATURE  SIGNATURE_32('N', 'F', 'I', 'T')

+

+///

+/// "PDTT" Platform Debug Trigger Table

+///

+#define EFI_ACPI_6_2_PLATFORM_DEBUG_TRIGGER_TABLE_STRUCTURE_SIGNATURE  SIGNATURE_32('P', 'D', 'T', 'T')

+

+///

+/// "PMTT" Platform Memory Topology Table

+///

+#define EFI_ACPI_6_2_PLATFORM_MEMORY_TOPOLOGY_TABLE_SIGNATURE  SIGNATURE_32('P', 'M', 'T', 'T')

+

+///

+/// "PPTT" Processor Properties Topology Table

+///

+#define EFI_ACPI_6_2_PROCESSOR_PROPERTIES_TOPOLOGY_TABLE_STRUCTURE_SIGNATURE  SIGNATURE_32('P', 'P', 'T', 'T')

+

+///

+/// "PSDT" Persistent System Description Table

+///

+#define EFI_ACPI_6_2_PERSISTENT_SYSTEM_DESCRIPTION_TABLE_SIGNATURE  SIGNATURE_32('P', 'S', 'D', 'T')

+

+///

+/// "RASF" ACPI RAS Feature Table

+///

+#define EFI_ACPI_6_2_ACPI_RAS_FEATURE_TABLE_SIGNATURE  SIGNATURE_32('R', 'A', 'S', 'F')

+

+///

+/// "RSDT" Root System Description Table

+///

+#define EFI_ACPI_6_2_ROOT_SYSTEM_DESCRIPTION_TABLE_SIGNATURE  SIGNATURE_32('R', 'S', 'D', 'T')

+

+///

+/// "SBST" Smart Battery Specification Table

+///

+#define EFI_ACPI_6_2_SMART_BATTERY_SPECIFICATION_TABLE_SIGNATURE  SIGNATURE_32('S', 'B', 'S', 'T')

+

+///

+/// "SDEV" Secure DEVices Table

+///

+#define EFI_ACPI_6_2_SECURE_DEVICES_TABLE_SIGNATURE  SIGNATURE_32('S', 'D', 'E', 'V')

+

+///

+/// "SLIT" System Locality Information Table

+///

+#define EFI_ACPI_6_2_SYSTEM_LOCALITY_INFORMATION_TABLE_SIGNATURE  SIGNATURE_32('S', 'L', 'I', 'T')

+

+///

+/// "SRAT" System Resource Affinity Table

+///

+#define EFI_ACPI_6_2_SYSTEM_RESOURCE_AFFINITY_TABLE_SIGNATURE  SIGNATURE_32('S', 'R', 'A', 'T')

+

+///

+/// "SSDT" Secondary System Description Table

+///

+#define EFI_ACPI_6_2_SECONDARY_SYSTEM_DESCRIPTION_TABLE_SIGNATURE  SIGNATURE_32('S', 'S', 'D', 'T')

+

+///

+/// "XSDT" Extended System Description Table

+///

+#define EFI_ACPI_6_2_EXTENDED_SYSTEM_DESCRIPTION_TABLE_SIGNATURE  SIGNATURE_32('X', 'S', 'D', 'T')

+

+///

+/// "BOOT" MS Simple Boot Spec

+///

+#define EFI_ACPI_6_2_SIMPLE_BOOT_FLAG_TABLE_SIGNATURE  SIGNATURE_32('B', 'O', 'O', 'T')

+

+///

+/// "CSRT" MS Core System Resource Table

+///

+#define EFI_ACPI_6_2_CORE_SYSTEM_RESOURCE_TABLE_SIGNATURE  SIGNATURE_32('C', 'S', 'R', 'T')

+

+///

+/// "DBG2" MS Debug Port 2 Spec

+///

+#define EFI_ACPI_6_2_DEBUG_PORT_2_TABLE_SIGNATURE  SIGNATURE_32('D', 'B', 'G', '2')

+

+///

+/// "DBGP" MS Debug Port Spec

+///

+#define EFI_ACPI_6_2_DEBUG_PORT_TABLE_SIGNATURE  SIGNATURE_32('D', 'B', 'G', 'P')

+

+///

+/// "DMAR" DMA Remapping Table

+///

+#define EFI_ACPI_6_2_DMA_REMAPPING_TABLE_SIGNATURE  SIGNATURE_32('D', 'M', 'A', 'R')

+

+///

+/// "DPPT" DMA Protection Policy Table

+///

+#define EFI_ACPI_6_2_DMA_PROTECTION_POLICY_TABLE_SIGNATURE  SIGNATURE_32('D', 'P', 'P', 'T')

+

+///

+/// "DRTM" Dynamic Root of Trust for Measurement Table

+///

+#define EFI_ACPI_6_2_DYNAMIC_ROOT_OF_TRUST_FOR_MEASUREMENT_TABLE_SIGNATURE  SIGNATURE_32('D', 'R', 'T', 'M')

+

+///

+/// "ETDT" Event Timer Description Table

+///

+#define EFI_ACPI_6_2_EVENT_TIMER_DESCRIPTION_TABLE_SIGNATURE  SIGNATURE_32('E', 'T', 'D', 'T')

+

+///

+/// "HPET" IA-PC High Precision Event Timer Table

+///

+#define EFI_ACPI_6_2_HIGH_PRECISION_EVENT_TIMER_TABLE_SIGNATURE  SIGNATURE_32('H', 'P', 'E', 'T')

+

+///

+/// "iBFT" iSCSI Boot Firmware Table

+///

+#define EFI_ACPI_6_2_ISCSI_BOOT_FIRMWARE_TABLE_SIGNATURE  SIGNATURE_32('i', 'B', 'F', 'T')

+

+///

+/// "IORT" I/O Remapping Table

+///

+#define EFI_ACPI_6_2_IO_REMAPPING_TABLE_SIGNATURE  SIGNATURE_32('I', 'O', 'R', 'T')

+

+///

+/// "IVRS" I/O Virtualization Reporting Structure

+///

+#define EFI_ACPI_6_2_IO_VIRTUALIZATION_REPORTING_STRUCTURE_SIGNATURE  SIGNATURE_32('I', 'V', 'R', 'S')

+

+///

+/// "LPIT" Low Power Idle Table

+///

+#define EFI_ACPI_6_2_LOW_POWER_IDLE_TABLE_STRUCTURE_SIGNATURE  SIGNATURE_32('L', 'P', 'I', 'T')

+

+///

+/// "MCFG" PCI Express Memory Mapped Configuration Space Base Address Description Table

+///

+#define EFI_ACPI_6_2_PCI_EXPRESS_MEMORY_MAPPED_CONFIGURATION_SPACE_BASE_ADDRESS_DESCRIPTION_TABLE_SIGNATURE  SIGNATURE_32('M', 'C', 'F', 'G')

+

+///

+/// "MCHI" Management Controller Host Interface Table

+///

+#define EFI_ACPI_6_2_MANAGEMENT_CONTROLLER_HOST_INTERFACE_TABLE_SIGNATURE  SIGNATURE_32('M', 'C', 'H', 'I')

+

+///

+/// "MSDM" MS Data Management Table

+///

+#define EFI_ACPI_6_2_DATA_MANAGEMENT_TABLE_SIGNATURE  SIGNATURE_32('M', 'S', 'D', 'M')

+

+///

+/// "PCCT" Platform Communications Channel Table

+///

+#define EFI_ACPI_6_2_PLATFORM_COMMUNICATIONS_CHANNEL_TABLE_SIGNATURE  SIGNATURE_32('P', 'C', 'C', 'T')

+

+///

+/// "SDEI" Software Delegated Exceptions Interface Table

+///

+#define EFI_ACPI_6_2_SOFTWARE_DELEGATED_EXCEPTIONS_INTERFACE_TABLE_SIGNATURE  SIGNATURE_32('S', 'D', 'E', 'I')

+

+///

+/// "SLIC" MS Software Licensing Table Specification

+///

+#define EFI_ACPI_6_2_SOFTWARE_LICENSING_TABLE_SIGNATURE  SIGNATURE_32('S', 'L', 'I', 'C')

+

+///

+/// "SPCR" Serial Port Console Redirection Table

+///

+#define EFI_ACPI_6_2_SERIAL_PORT_CONSOLE_REDIRECTION_TABLE_SIGNATURE  SIGNATURE_32('S', 'P', 'C', 'R')

+

+///

+/// "SPMI" Server Platform Management Interface Table

+///

+#define EFI_ACPI_6_2_SERVER_PLATFORM_MANAGEMENT_INTERFACE_TABLE_SIGNATURE  SIGNATURE_32('S', 'P', 'M', 'I')

+

+///

+/// "STAO" _STA Override Table

+///

+#define EFI_ACPI_6_2_STA_OVERRIDE_TABLE_SIGNATURE  SIGNATURE_32('S', 'T', 'A', 'O')

+

+///

+/// "TCPA" Trusted Computing Platform Alliance Capabilities Table

+///

+#define EFI_ACPI_6_2_TRUSTED_COMPUTING_PLATFORM_ALLIANCE_CAPABILITIES_TABLE_SIGNATURE  SIGNATURE_32('T', 'C', 'P', 'A')

+

+///

+/// "TPM2" Trusted Computing Platform 1 Table

+///

+#define EFI_ACPI_6_2_TRUSTED_COMPUTING_PLATFORM_2_TABLE_SIGNATURE  SIGNATURE_32('T', 'P', 'M', '2')

+

+///

+/// "UEFI" UEFI ACPI Data Table

+///

+#define EFI_ACPI_6_2_UEFI_ACPI_DATA_TABLE_SIGNATURE  SIGNATURE_32('U', 'E', 'F', 'I')

+

+///

+/// "WAET" Windows ACPI Emulated Devices Table

+///

+#define EFI_ACPI_6_2_WINDOWS_ACPI_EMULATED_DEVICES_TABLE_SIGNATURE  SIGNATURE_32('W', 'A', 'E', 'T')

+

+///

+/// "WDAT" Watchdog Action Table

+///

+#define EFI_ACPI_6_2_WATCHDOG_ACTION_TABLE_SIGNATURE  SIGNATURE_32('W', 'D', 'A', 'T')

+

+///

+/// "WDRT" Watchdog Resource Table

+///

+#define EFI_ACPI_6_2_WATCHDOG_RESOURCE_TABLE_SIGNATURE  SIGNATURE_32('W', 'D', 'R', 'T')

+

+///

+/// "WPBT" MS Platform Binary Table

+///

+#define EFI_ACPI_6_2_PLATFORM_BINARY_TABLE_SIGNATURE  SIGNATURE_32('W', 'P', 'B', 'T')

+

+///

+/// "WSMT" Windows SMM Security Mitigation Table

+///

+#define EFI_ACPI_6_2_WINDOWS_SMM_SECURITY_MITIGATION_TABLE_SIGNATURE  SIGNATURE_32('W', 'S', 'M', 'T')

+

+///

+/// "XENV" Xen Project Table

+///

+#define EFI_ACPI_6_2_XEN_PROJECT_TABLE_SIGNATURE  SIGNATURE_32('X', 'E', 'N', 'V')

+

+#pragma pack()

+

+#endif

diff --git a/debugging_demo/memtest86+/efi/Include/IndustryStandard/Acpi63.h b/debugging_demo/memtest86+/efi/Include/IndustryStandard/Acpi63.h
new file mode 100644
index 0000000..b281b30
--- /dev/null
+++ b/debugging_demo/memtest86+/efi/Include/IndustryStandard/Acpi63.h
@@ -0,0 +1,2960 @@
+/** @file

+  ACPI 6.3 definitions from the ACPI Specification Revision 6.3 Jan, 2019.

+

+  Copyright (c) 2017, Intel Corporation. All rights reserved.<BR>

+  Copyright (c) 2019 - 2020, ARM Ltd. All rights reserved.<BR>

+

+  SPDX-License-Identifier: BSD-2-Clause-Patent

+**/

+

+#ifndef _ACPI_6_3_H_

+#define _ACPI_6_3_H_

+

+#include <IndustryStandard/Acpi62.h>

+

+//

+// Ensure proper structure formats

+//

+#pragma pack(1)

+

+///

+/// ACPI 6.3 Generic Address Space definition

+///

+typedef struct {

+  UINT8   AddressSpaceId;

+  UINT8   RegisterBitWidth;

+  UINT8   RegisterBitOffset;

+  UINT8   AccessSize;

+  UINT64  Address;

+} EFI_ACPI_6_3_GENERIC_ADDRESS_STRUCTURE;

+

+//

+// Generic Address Space Address IDs

+//

+#define EFI_ACPI_6_3_SYSTEM_MEMORY                   0x00

+#define EFI_ACPI_6_3_SYSTEM_IO                       0x01

+#define EFI_ACPI_6_3_PCI_CONFIGURATION_SPACE         0x02

+#define EFI_ACPI_6_3_EMBEDDED_CONTROLLER             0x03

+#define EFI_ACPI_6_3_SMBUS                           0x04

+#define EFI_ACPI_6_3_SYSTEM_CMOS                     0x05

+#define EFI_ACPI_6_3_PCI_BAR_TARGET                  0x06

+#define EFI_ACPI_6_3_IPMI                            0x07

+#define EFI_ACPI_6_3_GENERAL_PURPOSE_IO              0x08

+#define EFI_ACPI_6_3_GENERIC_SERIAL_BUS              0x09

+#define EFI_ACPI_6_3_PLATFORM_COMMUNICATION_CHANNEL  0x0A

+#define EFI_ACPI_6_3_FUNCTIONAL_FIXED_HARDWARE       0x7F

+

+//

+// Generic Address Space Access Sizes

+//

+#define EFI_ACPI_6_3_UNDEFINED  0

+#define EFI_ACPI_6_3_BYTE       1

+#define EFI_ACPI_6_3_WORD       2

+#define EFI_ACPI_6_3_DWORD      3

+#define EFI_ACPI_6_3_QWORD      4

+

+//

+// ACPI 6.3 table structures

+//

+

+///

+/// Root System Description Pointer Structure

+///

+typedef struct {

+  UINT64  Signature;

+  UINT8   Checksum;

+  UINT8   OemId[6];

+  UINT8   Revision;

+  UINT32  RsdtAddress;

+  UINT32  Length;

+  UINT64  XsdtAddress;

+  UINT8   ExtendedChecksum;

+  UINT8   Reserved[3];

+} EFI_ACPI_6_3_ROOT_SYSTEM_DESCRIPTION_POINTER;

+

+///

+/// RSD_PTR Revision (as defined in ACPI 6.3 spec.)

+///

+#define EFI_ACPI_6_3_ROOT_SYSTEM_DESCRIPTION_POINTER_REVISION 0x02  ///< ACPISpec (Revision 6.3) says current value is 2

+

+///

+/// Common table header, this prefaces all ACPI tables, including FACS, but

+/// excluding the RSD PTR structure

+///

+typedef struct {

+  UINT32  Signature;

+  UINT32  Length;

+} EFI_ACPI_6_3_COMMON_HEADER;

+

+//

+// Root System Description Table

+// No definition needed as it is a common description table header, the same with

+// EFI_ACPI_DESCRIPTION_HEADER, followed by a variable number of UINT32 table pointers.

+//

+

+///

+/// RSDT Revision (as defined in ACPI 6.3 spec.)

+///

+#define EFI_ACPI_6_3_ROOT_SYSTEM_DESCRIPTION_TABLE_REVISION 0x01

+

+//

+// Extended System Description Table

+// No definition needed as it is a common description table header, the same with

+// EFI_ACPI_DESCRIPTION_HEADER, followed by a variable number of UINT64 table pointers.

+//

+

+///

+/// XSDT Revision (as defined in ACPI 6.3 spec.)

+///

+#define EFI_ACPI_6_3_EXTENDED_SYSTEM_DESCRIPTION_TABLE_REVISION 0x01

+

+///

+/// Fixed ACPI Description Table Structure (FADT)

+///

+typedef struct {

+  EFI_ACPI_DESCRIPTION_HEADER             Header;

+  UINT32                                  FirmwareCtrl;

+  UINT32                                  Dsdt;

+  UINT8                                   Reserved0;

+  UINT8                                   PreferredPmProfile;

+  UINT16                                  SciInt;

+  UINT32                                  SmiCmd;

+  UINT8                                   AcpiEnable;

+  UINT8                                   AcpiDisable;

+  UINT8                                   S4BiosReq;

+  UINT8                                   PstateCnt;

+  UINT32                                  Pm1aEvtBlk;

+  UINT32                                  Pm1bEvtBlk;

+  UINT32                                  Pm1aCntBlk;

+  UINT32                                  Pm1bCntBlk;

+  UINT32                                  Pm2CntBlk;

+  UINT32                                  PmTmrBlk;

+  UINT32                                  Gpe0Blk;

+  UINT32                                  Gpe1Blk;

+  UINT8                                   Pm1EvtLen;

+  UINT8                                   Pm1CntLen;

+  UINT8                                   Pm2CntLen;

+  UINT8                                   PmTmrLen;

+  UINT8                                   Gpe0BlkLen;

+  UINT8                                   Gpe1BlkLen;

+  UINT8                                   Gpe1Base;

+  UINT8                                   CstCnt;

+  UINT16                                  PLvl2Lat;

+  UINT16                                  PLvl3Lat;

+  UINT16                                  FlushSize;

+  UINT16                                  FlushStride;

+  UINT8                                   DutyOffset;

+  UINT8                                   DutyWidth;

+  UINT8                                   DayAlrm;

+  UINT8                                   MonAlrm;

+  UINT8                                   Century;

+  UINT16                                  IaPcBootArch;

+  UINT8                                   Reserved1;

+  UINT32                                  Flags;

+  EFI_ACPI_6_3_GENERIC_ADDRESS_STRUCTURE  ResetReg;

+  UINT8                                   ResetValue;

+  UINT16                                  ArmBootArch;

+  UINT8                                   MinorVersion;

+  UINT64                                  XFirmwareCtrl;

+  UINT64                                  XDsdt;

+  EFI_ACPI_6_3_GENERIC_ADDRESS_STRUCTURE  XPm1aEvtBlk;

+  EFI_ACPI_6_3_GENERIC_ADDRESS_STRUCTURE  XPm1bEvtBlk;

+  EFI_ACPI_6_3_GENERIC_ADDRESS_STRUCTURE  XPm1aCntBlk;

+  EFI_ACPI_6_3_GENERIC_ADDRESS_STRUCTURE  XPm1bCntBlk;

+  EFI_ACPI_6_3_GENERIC_ADDRESS_STRUCTURE  XPm2CntBlk;

+  EFI_ACPI_6_3_GENERIC_ADDRESS_STRUCTURE  XPmTmrBlk;

+  EFI_ACPI_6_3_GENERIC_ADDRESS_STRUCTURE  XGpe0Blk;

+  EFI_ACPI_6_3_GENERIC_ADDRESS_STRUCTURE  XGpe1Blk;

+  EFI_ACPI_6_3_GENERIC_ADDRESS_STRUCTURE  SleepControlReg;

+  EFI_ACPI_6_3_GENERIC_ADDRESS_STRUCTURE  SleepStatusReg;

+  UINT64                                  HypervisorVendorIdentity;

+} EFI_ACPI_6_3_FIXED_ACPI_DESCRIPTION_TABLE;

+

+///

+/// FADT Version (as defined in ACPI 6.3 spec.)

+///

+#define EFI_ACPI_6_3_FIXED_ACPI_DESCRIPTION_TABLE_REVISION  0x06

+#define EFI_ACPI_6_3_FIXED_ACPI_DESCRIPTION_TABLE_MINOR_REVISION  0x03

+

+//

+// Fixed ACPI Description Table Preferred Power Management Profile

+//

+#define EFI_ACPI_6_3_PM_PROFILE_UNSPECIFIED         0

+#define EFI_ACPI_6_3_PM_PROFILE_DESKTOP             1

+#define EFI_ACPI_6_3_PM_PROFILE_MOBILE              2

+#define EFI_ACPI_6_3_PM_PROFILE_WORKSTATION         3

+#define EFI_ACPI_6_3_PM_PROFILE_ENTERPRISE_SERVER   4

+#define EFI_ACPI_6_3_PM_PROFILE_SOHO_SERVER         5

+#define EFI_ACPI_6_3_PM_PROFILE_APPLIANCE_PC        6

+#define EFI_ACPI_6_3_PM_PROFILE_PERFORMANCE_SERVER  7

+#define EFI_ACPI_6_3_PM_PROFILE_TABLET              8

+

+//

+// Fixed ACPI Description Table Boot Architecture Flags

+// All other bits are reserved and must be set to 0.

+//

+#define EFI_ACPI_6_3_LEGACY_DEVICES              BIT0

+#define EFI_ACPI_6_3_8042                        BIT1

+#define EFI_ACPI_6_3_VGA_NOT_PRESENT             BIT2

+#define EFI_ACPI_6_3_MSI_NOT_SUPPORTED           BIT3

+#define EFI_ACPI_6_3_PCIE_ASPM_CONTROLS          BIT4

+#define EFI_ACPI_6_3_CMOS_RTC_NOT_PRESENT        BIT5

+

+//

+// Fixed ACPI Description Table Arm Boot Architecture Flags

+// All other bits are reserved and must be set to 0.

+//

+#define EFI_ACPI_6_3_ARM_PSCI_COMPLIANT              BIT0

+#define EFI_ACPI_6_3_ARM_PSCI_USE_HVC                BIT1

+

+//

+// Fixed ACPI Description Table Fixed Feature Flags

+// All other bits are reserved and must be set to 0.

+//

+#define EFI_ACPI_6_3_WBINVD                                 BIT0

+#define EFI_ACPI_6_3_WBINVD_FLUSH                           BIT1

+#define EFI_ACPI_6_3_PROC_C1                                BIT2

+#define EFI_ACPI_6_3_P_LVL2_UP                              BIT3

+#define EFI_ACPI_6_3_PWR_BUTTON                             BIT4

+#define EFI_ACPI_6_3_SLP_BUTTON                             BIT5

+#define EFI_ACPI_6_3_FIX_RTC                                BIT6

+#define EFI_ACPI_6_3_RTC_S4                                 BIT7

+#define EFI_ACPI_6_3_TMR_VAL_EXT                            BIT8

+#define EFI_ACPI_6_3_DCK_CAP                                BIT9

+#define EFI_ACPI_6_3_RESET_REG_SUP                          BIT10

+#define EFI_ACPI_6_3_SEALED_CASE                            BIT11

+#define EFI_ACPI_6_3_HEADLESS                               BIT12

+#define EFI_ACPI_6_3_CPU_SW_SLP                             BIT13

+#define EFI_ACPI_6_3_PCI_EXP_WAK                            BIT14

+#define EFI_ACPI_6_3_USE_PLATFORM_CLOCK                     BIT15

+#define EFI_ACPI_6_3_S4_RTC_STS_VALID                       BIT16

+#define EFI_ACPI_6_3_REMOTE_POWER_ON_CAPABLE                BIT17

+#define EFI_ACPI_6_3_FORCE_APIC_CLUSTER_MODEL               BIT18

+#define EFI_ACPI_6_3_FORCE_APIC_PHYSICAL_DESTINATION_MODE   BIT19

+#define EFI_ACPI_6_3_HW_REDUCED_ACPI                        BIT20

+#define EFI_ACPI_6_3_LOW_POWER_S0_IDLE_CAPABLE              BIT21

+

+///

+/// Firmware ACPI Control Structure

+///

+typedef struct {

+  UINT32  Signature;

+  UINT32  Length;

+  UINT32  HardwareSignature;

+  UINT32  FirmwareWakingVector;

+  UINT32  GlobalLock;

+  UINT32  Flags;

+  UINT64  XFirmwareWakingVector;

+  UINT8   Version;

+  UINT8   Reserved0[3];

+  UINT32  OspmFlags;

+  UINT8   Reserved1[24];

+} EFI_ACPI_6_3_FIRMWARE_ACPI_CONTROL_STRUCTURE;

+

+///

+/// FACS Version (as defined in ACPI 6.3 spec.)

+///

+#define EFI_ACPI_6_3_FIRMWARE_ACPI_CONTROL_STRUCTURE_VERSION  0x02

+

+///

+/// Firmware Control Structure Feature Flags

+/// All other bits are reserved and must be set to 0.

+///

+#define EFI_ACPI_6_3_S4BIOS_F                     BIT0

+#define EFI_ACPI_6_3_64BIT_WAKE_SUPPORTED_F       BIT1

+

+///

+/// OSPM Enabled Firmware Control Structure Flags

+/// All other bits are reserved and must be set to 0.

+///

+#define EFI_ACPI_6_3_OSPM_64BIT_WAKE_F            BIT0

+

+//

+// Differentiated System Description Table,

+// Secondary System Description Table

+// and Persistent System Description Table,

+// no definition needed as they are common description table header, the same with

+// EFI_ACPI_DESCRIPTION_HEADER, followed by a definition block.

+//

+#define EFI_ACPI_6_3_DIFFERENTIATED_SYSTEM_DESCRIPTION_TABLE_REVISION   0x02

+#define EFI_ACPI_6_3_SECONDARY_SYSTEM_DESCRIPTION_TABLE_REVISION        0x02

+

+///

+/// Multiple APIC Description Table header definition.  The rest of the table

+/// must be defined in a platform specific manner.

+///

+typedef struct {

+  EFI_ACPI_DESCRIPTION_HEADER Header;

+  UINT32                      LocalApicAddress;

+  UINT32                      Flags;

+} EFI_ACPI_6_3_MULTIPLE_APIC_DESCRIPTION_TABLE_HEADER;

+

+///

+/// MADT Revision (as defined in ACPI 6.3 spec.)

+///

+#define EFI_ACPI_6_3_MULTIPLE_APIC_DESCRIPTION_TABLE_REVISION 0x05

+

+///

+/// Multiple APIC Flags

+/// All other bits are reserved and must be set to 0.

+///

+#define EFI_ACPI_6_3_PCAT_COMPAT         BIT0

+

+//

+// Multiple APIC Description Table APIC structure types

+// All other values between 0x0D and 0x7F are reserved and

+// will be ignored by OSPM. 0x80 ~ 0xFF are reserved for OEM.

+//

+#define EFI_ACPI_6_3_PROCESSOR_LOCAL_APIC           0x00

+#define EFI_ACPI_6_3_IO_APIC                        0x01

+#define EFI_ACPI_6_3_INTERRUPT_SOURCE_OVERRIDE      0x02

+#define EFI_ACPI_6_3_NON_MASKABLE_INTERRUPT_SOURCE  0x03

+#define EFI_ACPI_6_3_LOCAL_APIC_NMI                 0x04

+#define EFI_ACPI_6_3_LOCAL_APIC_ADDRESS_OVERRIDE    0x05

+#define EFI_ACPI_6_3_IO_SAPIC                       0x06

+#define EFI_ACPI_6_3_LOCAL_SAPIC                    0x07

+#define EFI_ACPI_6_3_PLATFORM_INTERRUPT_SOURCES     0x08

+#define EFI_ACPI_6_3_PROCESSOR_LOCAL_X2APIC         0x09

+#define EFI_ACPI_6_3_LOCAL_X2APIC_NMI               0x0A

+#define EFI_ACPI_6_3_GIC                            0x0B

+#define EFI_ACPI_6_3_GICD                           0x0C

+#define EFI_ACPI_6_3_GIC_MSI_FRAME                  0x0D

+#define EFI_ACPI_6_3_GICR                           0x0E

+#define EFI_ACPI_6_3_GIC_ITS                        0x0F

+

+//

+// APIC Structure Definitions

+//

+

+///

+/// Processor Local APIC Structure Definition

+///

+typedef struct {

+  UINT8   Type;

+  UINT8   Length;

+  UINT8   AcpiProcessorUid;

+  UINT8   ApicId;

+  UINT32  Flags;

+} EFI_ACPI_6_3_PROCESSOR_LOCAL_APIC_STRUCTURE;

+

+///

+/// Local APIC Flags.  All other bits are reserved and must be 0.

+///

+#define EFI_ACPI_6_3_LOCAL_APIC_ENABLED         BIT0

+#define EFI_ACPI_6_3_LOCAL_APIC_ONLINE_CAPABLE  BIT1

+

+///

+/// IO APIC Structure

+///

+typedef struct {

+  UINT8   Type;

+  UINT8   Length;

+  UINT8   IoApicId;

+  UINT8   Reserved;

+  UINT32  IoApicAddress;

+  UINT32  GlobalSystemInterruptBase;

+} EFI_ACPI_6_3_IO_APIC_STRUCTURE;

+

+///

+/// Interrupt Source Override Structure

+///

+typedef struct {

+  UINT8   Type;

+  UINT8   Length;

+  UINT8   Bus;

+  UINT8   Source;

+  UINT32  GlobalSystemInterrupt;

+  UINT16  Flags;

+} EFI_ACPI_6_3_INTERRUPT_SOURCE_OVERRIDE_STRUCTURE;

+

+///

+/// Platform Interrupt Sources Structure Definition

+///

+typedef struct {

+  UINT8   Type;

+  UINT8   Length;

+  UINT16  Flags;

+  UINT8   InterruptType;

+  UINT8   ProcessorId;

+  UINT8   ProcessorEid;

+  UINT8   IoSapicVector;

+  UINT32  GlobalSystemInterrupt;

+  UINT32  PlatformInterruptSourceFlags;

+  UINT8   CpeiProcessorOverride;

+  UINT8   Reserved[31];

+} EFI_ACPI_6_3_PLATFORM_INTERRUPT_APIC_STRUCTURE;

+

+//

+// MPS INTI flags.

+// All other bits are reserved and must be set to 0.

+//

+#define EFI_ACPI_6_3_POLARITY      (3 << 0)

+#define EFI_ACPI_6_3_TRIGGER_MODE  (3 << 2)

+

+///

+/// Non-Maskable Interrupt Source Structure

+///

+typedef struct {

+  UINT8   Type;

+  UINT8   Length;

+  UINT16  Flags;

+  UINT32  GlobalSystemInterrupt;

+} EFI_ACPI_6_3_NON_MASKABLE_INTERRUPT_SOURCE_STRUCTURE;

+

+///

+/// Local APIC NMI Structure

+///

+typedef struct {

+  UINT8   Type;

+  UINT8   Length;

+  UINT8   AcpiProcessorUid;

+  UINT16  Flags;

+  UINT8   LocalApicLint;

+} EFI_ACPI_6_3_LOCAL_APIC_NMI_STRUCTURE;

+

+///

+/// Local APIC Address Override Structure

+///

+typedef struct {

+  UINT8   Type;

+  UINT8   Length;

+  UINT16  Reserved;

+  UINT64  LocalApicAddress;

+} EFI_ACPI_6_3_LOCAL_APIC_ADDRESS_OVERRIDE_STRUCTURE;

+

+///

+/// IO SAPIC Structure

+///

+typedef struct {

+  UINT8   Type;

+  UINT8   Length;

+  UINT8   IoApicId;

+  UINT8   Reserved;

+  UINT32  GlobalSystemInterruptBase;

+  UINT64  IoSapicAddress;

+} EFI_ACPI_6_3_IO_SAPIC_STRUCTURE;

+

+///

+/// Local SAPIC Structure

+/// This struct followed by a null-terminated ASCII string - ACPI Processor UID String

+///

+typedef struct {

+  UINT8   Type;

+  UINT8   Length;

+  UINT8   AcpiProcessorId;

+  UINT8   LocalSapicId;

+  UINT8   LocalSapicEid;

+  UINT8   Reserved[3];

+  UINT32  Flags;

+  UINT32  ACPIProcessorUIDValue;

+} EFI_ACPI_6_3_PROCESSOR_LOCAL_SAPIC_STRUCTURE;

+

+///

+/// Platform Interrupt Sources Structure

+///

+typedef struct {

+  UINT8   Type;

+  UINT8   Length;

+  UINT16  Flags;

+  UINT8   InterruptType;

+  UINT8   ProcessorId;

+  UINT8   ProcessorEid;

+  UINT8   IoSapicVector;

+  UINT32  GlobalSystemInterrupt;

+  UINT32  PlatformInterruptSourceFlags;

+} EFI_ACPI_6_3_PLATFORM_INTERRUPT_SOURCES_STRUCTURE;

+

+///

+/// Platform Interrupt Source Flags.

+/// All other bits are reserved and must be set to 0.

+///

+#define EFI_ACPI_6_3_CPEI_PROCESSOR_OVERRIDE          BIT0

+

+///

+/// Processor Local x2APIC Structure Definition

+///

+typedef struct {

+  UINT8   Type;

+  UINT8   Length;

+  UINT8   Reserved[2];

+  UINT32  X2ApicId;

+  UINT32  Flags;

+  UINT32  AcpiProcessorUid;

+} EFI_ACPI_6_3_PROCESSOR_LOCAL_X2APIC_STRUCTURE;

+

+///

+/// Local x2APIC NMI Structure

+///

+typedef struct {

+  UINT8   Type;

+  UINT8   Length;

+  UINT16  Flags;

+  UINT32  AcpiProcessorUid;

+  UINT8   LocalX2ApicLint;

+  UINT8   Reserved[3];

+} EFI_ACPI_6_3_LOCAL_X2APIC_NMI_STRUCTURE;

+

+///

+/// GIC Structure

+///

+typedef struct {

+  UINT8   Type;

+  UINT8   Length;

+  UINT16  Reserved;

+  UINT32  CPUInterfaceNumber;

+  UINT32  AcpiProcessorUid;

+  UINT32  Flags;

+  UINT32  ParkingProtocolVersion;

+  UINT32  PerformanceInterruptGsiv;

+  UINT64  ParkedAddress;

+  UINT64  PhysicalBaseAddress;

+  UINT64  GICV;

+  UINT64  GICH;

+  UINT32  VGICMaintenanceInterrupt;

+  UINT64  GICRBaseAddress;

+  UINT64  MPIDR;

+  UINT8   ProcessorPowerEfficiencyClass;

+  UINT8   Reserved2;

+  UINT16  SpeOverflowInterrupt;

+} EFI_ACPI_6_3_GIC_STRUCTURE;

+

+///

+/// GIC Flags.  All other bits are reserved and must be 0.

+///

+#define EFI_ACPI_6_3_GIC_ENABLED                              BIT0

+#define EFI_ACPI_6_3_PERFORMANCE_INTERRUPT_MODEL              BIT1

+#define EFI_ACPI_6_3_VGIC_MAINTENANCE_INTERRUPT_MODE_FLAGS    BIT2

+

+///

+/// GIC Distributor Structure

+///

+typedef struct {

+  UINT8   Type;

+  UINT8   Length;

+  UINT16  Reserved1;

+  UINT32  GicId;

+  UINT64  PhysicalBaseAddress;

+  UINT32  SystemVectorBase;

+  UINT8   GicVersion;

+  UINT8   Reserved2[3];

+} EFI_ACPI_6_3_GIC_DISTRIBUTOR_STRUCTURE;

+

+///

+/// GIC Version

+///

+#define EFI_ACPI_6_3_GIC_V1                                   0x01

+#define EFI_ACPI_6_3_GIC_V2                                   0x02

+#define EFI_ACPI_6_3_GIC_V3                                   0x03

+#define EFI_ACPI_6_3_GIC_V4                                   0x04

+

+///

+/// GIC MSI Frame Structure

+///

+typedef struct {

+  UINT8   Type;

+  UINT8   Length;

+  UINT16  Reserved1;

+  UINT32  GicMsiFrameId;

+  UINT64  PhysicalBaseAddress;

+  UINT32  Flags;

+  UINT16  SPICount;

+  UINT16  SPIBase;

+} EFI_ACPI_6_3_GIC_MSI_FRAME_STRUCTURE;

+

+///

+/// GIC MSI Frame Flags.  All other bits are reserved and must be 0.

+///

+#define EFI_ACPI_6_3_SPI_COUNT_BASE_SELECT                    BIT0

+

+///

+/// GICR Structure

+///

+typedef struct {

+  UINT8   Type;

+  UINT8   Length;

+  UINT16  Reserved;

+  UINT64  DiscoveryRangeBaseAddress;

+  UINT32  DiscoveryRangeLength;

+} EFI_ACPI_6_3_GICR_STRUCTURE;

+

+///

+/// GIC Interrupt Translation Service Structure

+///

+typedef struct {

+  UINT8   Type;

+  UINT8   Length;

+  UINT16  Reserved;

+  UINT32  GicItsId;

+  UINT64  PhysicalBaseAddress;

+  UINT32  Reserved2;

+} EFI_ACPI_6_3_GIC_ITS_STRUCTURE;

+

+///

+/// Smart Battery Description Table (SBST)

+///

+typedef struct {

+  EFI_ACPI_DESCRIPTION_HEADER Header;

+  UINT32                      WarningEnergyLevel;

+  UINT32                      LowEnergyLevel;

+  UINT32                      CriticalEnergyLevel;

+} EFI_ACPI_6_3_SMART_BATTERY_DESCRIPTION_TABLE;

+

+///

+/// SBST Version (as defined in ACPI 6.3 spec.)

+///

+#define EFI_ACPI_6_3_SMART_BATTERY_DESCRIPTION_TABLE_REVISION 0x01

+

+///

+/// Embedded Controller Boot Resources Table (ECDT)

+/// The table is followed by a null terminated ASCII string that contains

+/// a fully qualified reference to the name space object.

+///

+typedef struct {

+  EFI_ACPI_DESCRIPTION_HEADER             Header;

+  EFI_ACPI_6_3_GENERIC_ADDRESS_STRUCTURE  EcControl;

+  EFI_ACPI_6_3_GENERIC_ADDRESS_STRUCTURE  EcData;

+  UINT32                                  Uid;

+  UINT8                                   GpeBit;

+} EFI_ACPI_6_3_EMBEDDED_CONTROLLER_BOOT_RESOURCES_TABLE;

+

+///

+/// ECDT Version (as defined in ACPI 6.3 spec.)

+///

+#define EFI_ACPI_6_3_EMBEDDED_CONTROLLER_BOOT_RESOURCES_TABLE_REVISION  0x01

+

+///

+/// System Resource Affinity Table (SRAT).  The rest of the table

+/// must be defined in a platform specific manner.

+///

+typedef struct {

+  EFI_ACPI_DESCRIPTION_HEADER Header;

+  UINT32                      Reserved1;  ///< Must be set to 1

+  UINT64                      Reserved2;

+} EFI_ACPI_6_3_SYSTEM_RESOURCE_AFFINITY_TABLE_HEADER;

+

+///

+/// SRAT Version (as defined in ACPI 6.3 spec.)

+///

+#define EFI_ACPI_6_3_SYSTEM_RESOURCE_AFFINITY_TABLE_REVISION  0x03

+

+//

+// SRAT structure types.

+// All other values between 0x06 an 0xFF are reserved and

+// will be ignored by OSPM.

+//

+#define EFI_ACPI_6_3_PROCESSOR_LOCAL_APIC_SAPIC_AFFINITY  0x00

+#define EFI_ACPI_6_3_MEMORY_AFFINITY                      0x01

+#define EFI_ACPI_6_3_PROCESSOR_LOCAL_X2APIC_AFFINITY      0x02

+#define EFI_ACPI_6_3_GICC_AFFINITY                        0x03

+#define EFI_ACPI_6_3_GIC_ITS_AFFINITY                     0x04

+#define EFI_ACPI_6_3_GENERIC_INITIATOR_AFFINITY           0x05

+

+///

+/// Processor Local APIC/SAPIC Affinity Structure Definition

+///

+typedef struct {

+  UINT8   Type;

+  UINT8   Length;

+  UINT8   ProximityDomain7To0;

+  UINT8   ApicId;

+  UINT32  Flags;

+  UINT8   LocalSapicEid;

+  UINT8   ProximityDomain31To8[3];

+  UINT32  ClockDomain;

+} EFI_ACPI_6_3_PROCESSOR_LOCAL_APIC_SAPIC_AFFINITY_STRUCTURE;

+

+///

+/// Local APIC/SAPIC Flags.  All other bits are reserved and must be 0.

+///

+#define EFI_ACPI_6_3_PROCESSOR_LOCAL_APIC_SAPIC_ENABLED (1 << 0)

+

+///

+/// Memory Affinity Structure Definition

+///

+typedef struct {

+  UINT8   Type;

+  UINT8   Length;

+  UINT32  ProximityDomain;

+  UINT16  Reserved1;

+  UINT32  AddressBaseLow;

+  UINT32  AddressBaseHigh;

+  UINT32  LengthLow;

+  UINT32  LengthHigh;

+  UINT32  Reserved2;

+  UINT32  Flags;

+  UINT64  Reserved3;

+} EFI_ACPI_6_3_MEMORY_AFFINITY_STRUCTURE;

+

+//

+// Memory Flags.  All other bits are reserved and must be 0.

+//

+#define EFI_ACPI_6_3_MEMORY_ENABLED       (1 << 0)

+#define EFI_ACPI_6_3_MEMORY_HOT_PLUGGABLE (1 << 1)

+#define EFI_ACPI_6_3_MEMORY_NONVOLATILE   (1 << 2)

+

+///

+/// Processor Local x2APIC Affinity Structure Definition

+///

+typedef struct {

+  UINT8   Type;

+  UINT8   Length;

+  UINT8   Reserved1[2];

+  UINT32  ProximityDomain;

+  UINT32  X2ApicId;

+  UINT32  Flags;

+  UINT32  ClockDomain;

+  UINT8   Reserved2[4];

+} EFI_ACPI_6_3_PROCESSOR_LOCAL_X2APIC_AFFINITY_STRUCTURE;

+

+///

+/// GICC Affinity Structure Definition

+///

+typedef struct {

+  UINT8   Type;

+  UINT8   Length;

+  UINT32  ProximityDomain;

+  UINT32  AcpiProcessorUid;

+  UINT32  Flags;

+  UINT32  ClockDomain;

+} EFI_ACPI_6_3_GICC_AFFINITY_STRUCTURE;

+

+///

+/// GICC Flags.  All other bits are reserved and must be 0.

+///

+#define EFI_ACPI_6_3_GICC_ENABLED (1 << 0)

+

+///

+/// GIC Interrupt Translation Service (ITS) Affinity Structure Definition

+///

+typedef struct {

+  UINT8   Type;

+  UINT8   Length;

+  UINT32  ProximityDomain;

+  UINT8   Reserved[2];

+  UINT32  ItsId;

+} EFI_ACPI_6_3_GIC_ITS_AFFINITY_STRUCTURE;

+

+//

+// Generic Initiator Affinity Structure Device Handle Types

+// All other values between 0x02 an 0xFF are reserved and

+// will be ignored by OSPM.

+//

+#define EFI_ACPI_6_3_ACPI_DEVICE_HANDLE     0x00

+#define EFI_ACPI_6_3_PCI_DEVICE_HANDLE      0x01

+

+///

+/// Device Handle - ACPI

+///

+typedef struct {

+  UINT64  AcpiHid;

+  UINT32  AcpiUid;

+  UINT8   Reserved[4];

+} EFI_ACPI_6_3_DEVICE_HANDLE_ACPI;

+

+///

+/// Device Handle - PCI

+///

+typedef struct {

+  UINT16  PciSegment;

+  UINT16  PciBdfNumber;

+  UINT8   Reserved[12];

+} EFI_ACPI_6_3_DEVICE_HANDLE_PCI;

+

+///

+/// Generic Initiator Affinity Structure

+///

+typedef struct {

+  UINT8   Type;

+  UINT8   Length;

+  UINT8   Reserved1;

+  UINT8   DeviceHandleType;

+  UINT32  ProximityDomain;

+

+  union {

+    EFI_ACPI_6_3_DEVICE_HANDLE_ACPI   Acpi;

+    EFI_ACPI_6_3_DEVICE_HANDLE_PCI    Pci;

+  } DeviceHandle;

+

+  UINT32  Flags;

+  UINT8   Reserved2[4];

+} EFI_ACPI_6_3_GENERIC_INITIATOR_AFFINITY_STRUCTURE;

+

+///

+/// Generic Initiator Affinity Structure Flags. All other bits are reserved

+/// and must be 0.

+///

+#define EFI_ACPI_6_3_GENERIC_INITIATOR_AFFINITY_STRUCTURE_ENABLED (1 << 0)

+

+///

+/// System Locality Distance Information Table (SLIT).

+/// The rest of the table is a matrix.

+///

+typedef struct {

+  EFI_ACPI_DESCRIPTION_HEADER Header;

+  UINT64                      NumberOfSystemLocalities;

+} EFI_ACPI_6_3_SYSTEM_LOCALITY_DISTANCE_INFORMATION_TABLE_HEADER;

+

+///

+/// SLIT Version (as defined in ACPI 6.3 spec.)

+///

+#define EFI_ACPI_6_3_SYSTEM_LOCALITY_DISTANCE_INFORMATION_TABLE_REVISION  0x01

+

+///

+/// Corrected Platform Error Polling Table (CPEP)

+///

+typedef struct {

+  EFI_ACPI_DESCRIPTION_HEADER Header;

+  UINT8                       Reserved[8];

+} EFI_ACPI_6_3_CORRECTED_PLATFORM_ERROR_POLLING_TABLE_HEADER;

+

+///

+/// CPEP Version (as defined in ACPI 6.3 spec.)

+///

+#define EFI_ACPI_6_3_CORRECTED_PLATFORM_ERROR_POLLING_TABLE_REVISION 0x01

+

+//

+// CPEP processor structure types.

+//

+#define EFI_ACPI_6_3_CPEP_PROCESSOR_APIC_SAPIC  0x00

+

+///

+/// Corrected Platform Error Polling Processor Structure Definition

+///

+typedef struct {

+  UINT8   Type;

+  UINT8   Length;

+  UINT8   ProcessorId;

+  UINT8   ProcessorEid;

+  UINT32  PollingInterval;

+} EFI_ACPI_6_3_CPEP_PROCESSOR_APIC_SAPIC_STRUCTURE;

+

+///

+/// Maximum System Characteristics Table (MSCT)

+///

+typedef struct {

+  EFI_ACPI_DESCRIPTION_HEADER Header;

+  UINT32                      OffsetProxDomInfo;

+  UINT32                      MaximumNumberOfProximityDomains;

+  UINT32                      MaximumNumberOfClockDomains;

+  UINT64                      MaximumPhysicalAddress;

+} EFI_ACPI_6_3_MAXIMUM_SYSTEM_CHARACTERISTICS_TABLE_HEADER;

+

+///

+/// MSCT Version (as defined in ACPI 6.3 spec.)

+///

+#define EFI_ACPI_6_3_MAXIMUM_SYSTEM_CHARACTERISTICS_TABLE_REVISION 0x01

+

+///

+/// Maximum Proximity Domain Information Structure Definition

+///

+typedef struct {

+  UINT8   Revision;

+  UINT8   Length;

+  UINT32  ProximityDomainRangeLow;

+  UINT32  ProximityDomainRangeHigh;

+  UINT32  MaximumProcessorCapacity;

+  UINT64  MaximumMemoryCapacity;

+} EFI_ACPI_6_3_MAXIMUM_PROXIMITY_DOMAIN_INFORMATION_STRUCTURE;

+

+///

+/// ACPI RAS Feature Table definition.

+///

+typedef struct {

+  EFI_ACPI_DESCRIPTION_HEADER Header;

+  UINT8                       PlatformCommunicationChannelIdentifier[12];

+} EFI_ACPI_6_3_RAS_FEATURE_TABLE;

+

+///

+/// RASF Version (as defined in ACPI 6.3 spec.)

+///

+#define EFI_ACPI_6_3_RAS_FEATURE_TABLE_REVISION 0x01

+

+///

+/// ACPI RASF Platform Communication Channel Shared Memory Region definition.

+///

+typedef struct {

+  UINT32                      Signature;

+  UINT16                      Command;

+  UINT16                      Status;

+  UINT16                      Version;

+  UINT8                       RASCapabilities[16];

+  UINT8                       SetRASCapabilities[16];

+  UINT16                      NumberOfRASFParameterBlocks;

+  UINT32                      SetRASCapabilitiesStatus;

+} EFI_ACPI_6_3_RASF_PLATFORM_COMMUNICATION_CHANNEL_SHARED_MEMORY_REGION;

+

+///

+/// ACPI RASF PCC command code

+///

+#define EFI_ACPI_6_3_RASF_PCC_COMMAND_CODE_EXECUTE_RASF_COMMAND  0x01

+

+///

+/// ACPI RASF Platform RAS Capabilities

+///

+#define EFI_ACPI_6_3_RASF_PLATFORM_RAS_CAPABILITY_HARDWARE_BASED_PATROL_SCRUB_SUPPORTED                         BIT0

+#define EFI_ACPI_6_3_RASF_PLATFORM_RAS_CAPABILITY_HARDWARE_BASED_PATROL_SCRUB_SUPPORTED_AND_EXPOSED_TO_SOFTWARE BIT1

+#define EFI_ACPI_6_3_RASF_PLATFORM_RAS_CAPABILITY_CPU_CACHE_FLUSH_TO_NVDIMM_DURABILITY_ON_POWER_LOSS            BIT2

+#define EFI_ACPI_6_3_RASF_PLATFORM_RAS_CAPABILITY_MEMORY_CONTROLLER_FLUSH_TO_NVDIMM_DURABILITY_ON_POWER_LOSS    BIT3

+#define EFI_ACPI_6_3_RASF_PLATFORM_RAS_CAPABILITY_BYTE_ADDRESSABLE_PERSISTENT_MEMORY_HARDWARE_MIRRORING         BIT4

+

+///

+/// ACPI RASF Parameter Block structure for PATROL_SCRUB

+///

+typedef struct {

+  UINT16                      Type;

+  UINT16                      Version;

+  UINT16                      Length;

+  UINT16                      PatrolScrubCommand;

+  UINT64                      RequestedAddressRange[2];

+  UINT64                      ActualAddressRange[2];

+  UINT16                      Flags;

+  UINT8                       RequestedSpeed;

+} EFI_ACPI_6_3_RASF_PATROL_SCRUB_PLATFORM_BLOCK_STRUCTURE;

+

+///

+/// ACPI RASF Patrol Scrub command

+///

+#define EFI_ACPI_6_3_RASF_PATROL_SCRUB_COMMAND_GET_PATROL_PARAMETERS   0x01

+#define EFI_ACPI_6_3_RASF_PATROL_SCRUB_COMMAND_START_PATROL_SCRUBBER   0x02

+#define EFI_ACPI_6_3_RASF_PATROL_SCRUB_COMMAND_STOP_PATROL_SCRUBBER    0x03

+

+///

+/// Memory Power State Table definition.

+///

+typedef struct {

+  EFI_ACPI_DESCRIPTION_HEADER Header;

+  UINT8                       PlatformCommunicationChannelIdentifier;

+  UINT8                       Reserved[3];

+// Memory Power Node Structure

+// Memory Power State Characteristics

+} EFI_ACPI_6_3_MEMORY_POWER_STATUS_TABLE;

+

+///

+/// MPST Version (as defined in ACPI 6.3 spec.)

+///

+#define EFI_ACPI_6_3_MEMORY_POWER_STATE_TABLE_REVISION 0x01

+

+///

+/// MPST Platform Communication Channel Shared Memory Region definition.

+///

+typedef struct {

+  UINT32                      Signature;

+  UINT16                      Command;

+  UINT16                      Status;

+  UINT32                      MemoryPowerCommandRegister;

+  UINT32                      MemoryPowerStatusRegister;

+  UINT32                      PowerStateId;

+  UINT32                      MemoryPowerNodeId;

+  UINT64                      MemoryEnergyConsumed;

+  UINT64                      ExpectedAveragePowerComsuned;

+} EFI_ACPI_6_3_MPST_PLATFORM_COMMUNICATION_CHANNEL_SHARED_MEMORY_REGION;

+

+///

+/// ACPI MPST PCC command code

+///

+#define EFI_ACPI_6_3_MPST_PCC_COMMAND_CODE_EXECUTE_MPST_COMMAND  0x03

+

+///

+/// ACPI MPST Memory Power command

+///

+#define EFI_ACPI_6_3_MPST_MEMORY_POWER_COMMAND_GET_MEMORY_POWER_STATE       0x01

+#define EFI_ACPI_6_3_MPST_MEMORY_POWER_COMMAND_SET_MEMORY_POWER_STATE       0x02

+#define EFI_ACPI_6_3_MPST_MEMORY_POWER_COMMAND_GET_AVERAGE_POWER_CONSUMED   0x03

+#define EFI_ACPI_6_3_MPST_MEMORY_POWER_COMMAND_GET_MEMORY_ENERGY_CONSUMED   0x04

+

+///

+/// MPST Memory Power Node Table

+///

+typedef struct {

+  UINT8                                             PowerStateValue;

+  UINT8                                             PowerStateInformationIndex;

+} EFI_ACPI_6_3_MPST_MEMORY_POWER_STATE;

+

+typedef struct {

+  UINT8                                             Flag;

+  UINT8                                             Reserved;

+  UINT16                                            MemoryPowerNodeId;

+  UINT32                                            Length;

+  UINT64                                            AddressBase;

+  UINT64                                            AddressLength;

+  UINT32                                            NumberOfPowerStates;

+  UINT32                                            NumberOfPhysicalComponents;

+//EFI_ACPI_6_3_MPST_MEMORY_POWER_STATE              MemoryPowerState[NumberOfPowerStates];

+//UINT16                                            PhysicalComponentIdentifier[NumberOfPhysicalComponents];

+} EFI_ACPI_6_3_MPST_MEMORY_POWER_STRUCTURE;

+

+#define EFI_ACPI_6_3_MPST_MEMORY_POWER_STRUCTURE_FLAG_ENABLE          0x01

+#define EFI_ACPI_6_3_MPST_MEMORY_POWER_STRUCTURE_FLAG_POWER_MANAGED   0x02

+#define EFI_ACPI_6_3_MPST_MEMORY_POWER_STRUCTURE_FLAG_HOT_PLUGGABLE   0x04

+

+typedef struct {

+  UINT16                      MemoryPowerNodeCount;

+  UINT8                       Reserved[2];

+} EFI_ACPI_6_3_MPST_MEMORY_POWER_NODE_TABLE;

+

+///

+/// MPST Memory Power State Characteristics Table

+///

+typedef struct {

+  UINT8                                             PowerStateStructureID;

+  UINT8                                             Flag;

+  UINT16                                            Reserved;

+  UINT32                                            AveragePowerConsumedInMPS0;

+  UINT32                                            RelativePowerSavingToMPS0;

+  UINT64                                            ExitLatencyToMPS0;

+} EFI_ACPI_6_3_MPST_MEMORY_POWER_STATE_CHARACTERISTICS_STRUCTURE;

+

+#define EFI_ACPI_6_3_MPST_MEMORY_POWER_STATE_CHARACTERISTICS_STRUCTURE_FLAG_MEMORY_CONTENT_PRESERVED              0x01

+#define EFI_ACPI_6_3_MPST_MEMORY_POWER_STATE_CHARACTERISTICS_STRUCTURE_FLAG_AUTONOMOUS_MEMORY_POWER_STATE_ENTRY   0x02

+#define EFI_ACPI_6_3_MPST_MEMORY_POWER_STATE_CHARACTERISTICS_STRUCTURE_FLAG_AUTONOMOUS_MEMORY_POWER_STATE_EXIT    0x04

+

+typedef struct {

+  UINT16                      MemoryPowerStateCharacteristicsCount;

+  UINT8                       Reserved[2];

+} EFI_ACPI_6_3_MPST_MEMORY_POWER_STATE_CHARACTERISTICS_TABLE;

+

+///

+/// Memory Topology Table definition.

+///

+typedef struct {

+  EFI_ACPI_DESCRIPTION_HEADER Header;

+  UINT32                      Reserved;

+} EFI_ACPI_6_3_MEMORY_TOPOLOGY_TABLE;

+

+///

+/// PMTT Version (as defined in ACPI 6.3 spec.)

+///

+#define EFI_ACPI_6_3_MEMORY_TOPOLOGY_TABLE_REVISION 0x01

+

+///

+/// Common Memory Aggregator Device Structure.

+///

+typedef struct {

+  UINT8                       Type;

+  UINT8                       Reserved;

+  UINT16                      Length;

+  UINT16                      Flags;

+  UINT16                      Reserved1;

+} EFI_ACPI_6_3_PMMT_COMMON_MEMORY_AGGREGATOR_DEVICE_STRUCTURE;

+

+///

+/// Memory Aggregator Device Type

+///

+#define EFI_ACPI_6_3_PMMT_MEMORY_AGGREGATOR_DEVICE_TYPE_SOCKET            0x1

+#define EFI_ACPI_6_3_PMMT_MEMORY_AGGREGATOR_DEVICE_TYPE_MEMORY_CONTROLLER 0x2

+#define EFI_ACPI_6_3_PMMT_MEMORY_AGGREGATOR_DEVICE_TYPE_DIMM              0x3

+

+///

+/// Socket Memory Aggregator Device Structure.

+///

+typedef struct {

+  EFI_ACPI_6_3_PMMT_COMMON_MEMORY_AGGREGATOR_DEVICE_STRUCTURE  Header;

+  UINT16                                                       SocketIdentifier;

+  UINT16                                                       Reserved;

+//EFI_ACPI_6_3_PMMT_MEMORY_CONTROLLER_MEMORY_AGGREGATOR_DEVICE_STRUCTURE  MemoryController[];

+} EFI_ACPI_6_3_PMMT_SOCKET_MEMORY_AGGREGATOR_DEVICE_STRUCTURE;

+

+///

+/// MemoryController Memory Aggregator Device Structure.

+///

+typedef struct {

+  EFI_ACPI_6_3_PMMT_COMMON_MEMORY_AGGREGATOR_DEVICE_STRUCTURE  Header;

+  UINT32                                                       ReadLatency;

+  UINT32                                                       WriteLatency;

+  UINT32                                                       ReadBandwidth;

+  UINT32                                                       WriteBandwidth;

+  UINT16                                                       OptimalAccessUnit;

+  UINT16                                                       OptimalAccessAlignment;

+  UINT16                                                       Reserved;

+  UINT16                                                       NumberOfProximityDomains;

+//UINT32                                                       ProximityDomain[NumberOfProximityDomains];

+//EFI_ACPI_6_3_PMMT_DIMM_MEMORY_AGGREGATOR_DEVICE_STRUCTURE    PhysicalComponent[];

+} EFI_ACPI_6_3_PMMT_MEMORY_CONTROLLER_MEMORY_AGGREGATOR_DEVICE_STRUCTURE;

+

+///

+/// DIMM Memory Aggregator Device Structure.

+///

+typedef struct {

+  EFI_ACPI_6_3_PMMT_COMMON_MEMORY_AGGREGATOR_DEVICE_STRUCTURE  Header;

+  UINT16                                                       PhysicalComponentIdentifier;

+  UINT16                                                       Reserved;

+  UINT32                                                       SizeOfDimm;

+  UINT32                                                       SmbiosHandle;

+} EFI_ACPI_6_3_PMMT_DIMM_MEMORY_AGGREGATOR_DEVICE_STRUCTURE;

+

+///

+/// Boot Graphics Resource Table definition.

+///

+typedef struct {

+  EFI_ACPI_DESCRIPTION_HEADER Header;

+  ///

+  /// 2-bytes (16 bit) version ID. This value must be 1.

+  ///

+  UINT16                      Version;

+  ///

+  /// 1-byte status field indicating current status about the table.

+  ///     Bits[7:1] = Reserved (must be zero)

+  ///     Bit [0] = Valid. A one indicates the boot image graphic is valid.

+  ///

+  UINT8                       Status;

+  ///

+  /// 1-byte enumerated type field indicating format of the image.

+  ///     0 = Bitmap

+  ///     1 - 255  Reserved (for future use)

+  ///

+  UINT8                       ImageType;

+  ///

+  /// 8-byte (64 bit) physical address pointing to the firmware's in-memory copy

+  /// of the image bitmap.

+  ///

+  UINT64                      ImageAddress;

+  ///

+  /// A 4-byte (32-bit) unsigned long describing the display X-offset of the boot image.

+  /// (X, Y) display offset of the top left corner of the boot image.

+  /// The top left corner of the display is at offset (0, 0).

+  ///

+  UINT32                      ImageOffsetX;

+  ///

+  /// A 4-byte (32-bit) unsigned long describing the display Y-offset of the boot image.

+  /// (X, Y) display offset of the top left corner of the boot image.

+  /// The top left corner of the display is at offset (0, 0).

+  ///

+  UINT32                      ImageOffsetY;

+} EFI_ACPI_6_3_BOOT_GRAPHICS_RESOURCE_TABLE;

+

+///

+/// BGRT Revision

+///

+#define EFI_ACPI_6_3_BOOT_GRAPHICS_RESOURCE_TABLE_REVISION 1

+

+///

+/// BGRT Version

+///

+#define EFI_ACPI_6_3_BGRT_VERSION         0x01

+

+///

+/// BGRT Status

+///

+#define EFI_ACPI_6_3_BGRT_STATUS_NOT_DISPLAYED 0x00

+#define EFI_ACPI_6_3_BGRT_STATUS_DISPLAYED     0x01

+

+///

+/// BGRT Image Type

+///

+#define EFI_ACPI_6_3_BGRT_IMAGE_TYPE_BMP  0x00

+

+///

+/// FPDT Version (as defined in ACPI 6.3 spec.)

+///

+#define EFI_ACPI_6_3_FIRMWARE_PERFORMANCE_DATA_TABLE_REVISION 0x01

+

+///

+/// FPDT Performance Record Types

+///

+#define EFI_ACPI_6_3_FPDT_RECORD_TYPE_FIRMWARE_BASIC_BOOT_POINTER      0x0000

+#define EFI_ACPI_6_3_FPDT_RECORD_TYPE_S3_PERFORMANCE_TABLE_POINTER     0x0001

+

+///

+/// FPDT Performance Record Revision

+///

+#define EFI_ACPI_6_3_FPDT_RECORD_REVISION_FIRMWARE_BASIC_BOOT_POINTER  0x01

+#define EFI_ACPI_6_3_FPDT_RECORD_REVISION_S3_PERFORMANCE_TABLE_POINTER 0x01

+

+///

+/// FPDT Runtime Performance Record Types

+///

+#define EFI_ACPI_6_3_FPDT_RUNTIME_RECORD_TYPE_S3_RESUME                0x0000

+#define EFI_ACPI_6_3_FPDT_RUNTIME_RECORD_TYPE_S3_SUSPEND               0x0001

+#define EFI_ACPI_6_3_FPDT_RUNTIME_RECORD_TYPE_FIRMWARE_BASIC_BOOT      0x0002

+

+///

+/// FPDT Runtime Performance Record Revision

+///

+#define EFI_ACPI_6_3_FPDT_RUNTIME_RECORD_REVISION_S3_RESUME            0x01

+#define EFI_ACPI_6_3_FPDT_RUNTIME_RECORD_REVISION_S3_SUSPEND           0x01

+#define EFI_ACPI_6_3_FPDT_RUNTIME_RECORD_REVISION_FIRMWARE_BASIC_BOOT  0x02

+

+///

+/// FPDT Performance Record header

+///

+typedef struct {

+  UINT16           Type;

+  UINT8            Length;

+  UINT8            Revision;

+} EFI_ACPI_6_3_FPDT_PERFORMANCE_RECORD_HEADER;

+

+///

+/// FPDT Performance Table header

+///

+typedef struct {

+  UINT32  Signature;

+  UINT32  Length;

+} EFI_ACPI_6_3_FPDT_PERFORMANCE_TABLE_HEADER;

+

+///

+/// FPDT Firmware Basic Boot Performance Pointer Record Structure

+///

+typedef struct {

+  EFI_ACPI_6_3_FPDT_PERFORMANCE_RECORD_HEADER     Header;

+  UINT32                                          Reserved;

+  ///

+  /// 64-bit processor-relative physical address of the Basic Boot Performance Table.

+  ///

+  UINT64                                          BootPerformanceTablePointer;

+} EFI_ACPI_6_3_FPDT_BOOT_PERFORMANCE_TABLE_POINTER_RECORD;

+

+///

+/// FPDT S3 Performance Table Pointer Record Structure

+///

+typedef struct {

+  EFI_ACPI_6_3_FPDT_PERFORMANCE_RECORD_HEADER     Header;

+  UINT32                                          Reserved;

+  ///

+  /// 64-bit processor-relative physical address of the S3 Performance Table.

+  ///

+  UINT64                                          S3PerformanceTablePointer;

+} EFI_ACPI_6_3_FPDT_S3_PERFORMANCE_TABLE_POINTER_RECORD;

+

+///

+/// FPDT Firmware Basic Boot Performance Record Structure

+///

+typedef struct {

+  EFI_ACPI_6_3_FPDT_PERFORMANCE_RECORD_HEADER     Header;

+  UINT32                                          Reserved;

+  ///

+  /// Timer value logged at the beginning of firmware image execution.

+  /// This may not always be zero or near zero.

+  ///

+  UINT64                                          ResetEnd;

+  ///

+  /// Timer value logged just prior to loading the OS boot loader into memory.

+  /// For non-UEFI compatible boots, this field must be zero.

+  ///

+  UINT64                                          OsLoaderLoadImageStart;

+  ///

+  /// Timer value logged just prior to launching the previously loaded OS boot loader image.

+  /// For non-UEFI compatible boots, the timer value logged will be just prior

+  /// to the INT 19h handler invocation.

+  ///

+  UINT64                                          OsLoaderStartImageStart;

+  ///

+  /// Timer value logged at the point when the OS loader calls the

+  /// ExitBootServices function for UEFI compatible firmware.

+  /// For non-UEFI compatible boots, this field must be zero.

+  ///

+  UINT64                                          ExitBootServicesEntry;

+  ///

+  /// Timer value logged at the point just prior towhen the OS loader gaining

+  /// control back from calls the ExitBootServices function for UEFI compatible firmware.

+  /// For non-UEFI compatible boots, this field must be zero.

+  ///

+  UINT64                                          ExitBootServicesExit;

+} EFI_ACPI_6_3_FPDT_FIRMWARE_BASIC_BOOT_RECORD;

+

+///

+/// FPDT Firmware Basic Boot Performance Table signature

+///

+#define EFI_ACPI_6_3_FPDT_BOOT_PERFORMANCE_TABLE_SIGNATURE  SIGNATURE_32('F', 'B', 'P', 'T')

+

+//

+// FPDT Firmware Basic Boot Performance Table

+//

+typedef struct {

+  EFI_ACPI_6_3_FPDT_PERFORMANCE_TABLE_HEADER      Header;

+  //

+  // one or more Performance Records.

+  //

+} EFI_ACPI_6_3_FPDT_FIRMWARE_BASIC_BOOT_TABLE;

+

+///

+/// FPDT "S3PT" S3 Performance Table

+///

+#define EFI_ACPI_6_3_FPDT_S3_PERFORMANCE_TABLE_SIGNATURE  SIGNATURE_32('S', '3', 'P', 'T')

+

+//

+// FPDT Firmware S3 Boot Performance Table

+//

+typedef struct {

+  EFI_ACPI_6_3_FPDT_PERFORMANCE_TABLE_HEADER      Header;

+  //

+  // one or more Performance Records.

+  //

+} EFI_ACPI_6_3_FPDT_FIRMWARE_S3_BOOT_TABLE;

+

+///

+/// FPDT Basic S3 Resume Performance Record

+///

+typedef struct {

+  EFI_ACPI_6_3_FPDT_PERFORMANCE_RECORD_HEADER     Header;

+  ///

+  /// A count of the number of S3 resume cycles since the last full boot sequence.

+  ///

+  UINT32                                          ResumeCount;

+  ///

+  /// Timer recorded at the end of BIOS S3 resume, just prior to handoff to the

+  /// OS waking vector. Only the most recent resume cycle's time is retained.

+  ///

+  UINT64                                          FullResume;

+  ///

+  /// Average timer value of all resume cycles logged since the last full boot

+  /// sequence, including the most recent resume.  Note that the entire log of

+  /// timer values does not need to be retained in order to calculate this average.

+  ///

+  UINT64                                          AverageResume;

+} EFI_ACPI_6_3_FPDT_S3_RESUME_RECORD;

+

+///

+/// FPDT Basic S3 Suspend Performance Record

+///

+typedef struct {

+  EFI_ACPI_6_3_FPDT_PERFORMANCE_RECORD_HEADER     Header;

+  ///

+  /// Timer value recorded at the OS write to SLP_TYP upon entry to S3.

+  /// Only the most recent suspend cycle's timer value is retained.

+  ///

+  UINT64                                          SuspendStart;

+  ///

+  /// Timer value recorded at the final firmware write to SLP_TYP (or other

+  /// mechanism) used to trigger hardware entry to S3.

+  /// Only the most recent suspend cycle's timer value is retained.

+  ///

+  UINT64                                          SuspendEnd;

+} EFI_ACPI_6_3_FPDT_S3_SUSPEND_RECORD;

+

+///

+/// Firmware Performance Record Table definition.

+///

+typedef struct {

+  EFI_ACPI_DESCRIPTION_HEADER Header;

+} EFI_ACPI_6_3_FIRMWARE_PERFORMANCE_RECORD_TABLE;

+

+///

+/// Generic Timer Description Table definition.

+///

+typedef struct {

+  EFI_ACPI_DESCRIPTION_HEADER Header;

+  UINT64                      CntControlBasePhysicalAddress;

+  UINT32                      Reserved;

+  UINT32                      SecurePL1TimerGSIV;

+  UINT32                      SecurePL1TimerFlags;

+  UINT32                      NonSecurePL1TimerGSIV;

+  UINT32                      NonSecurePL1TimerFlags;

+  UINT32                      VirtualTimerGSIV;

+  UINT32                      VirtualTimerFlags;

+  UINT32                      NonSecurePL2TimerGSIV;

+  UINT32                      NonSecurePL2TimerFlags;

+  UINT64                      CntReadBasePhysicalAddress;

+  UINT32                      PlatformTimerCount;

+  UINT32                      PlatformTimerOffset;

+  UINT32                      VirtualPL2TimerGSIV;

+  UINT32                      VirtualPL2TimerFlags;

+} EFI_ACPI_6_3_GENERIC_TIMER_DESCRIPTION_TABLE;

+

+///

+/// GTDT Version (as defined in ACPI 6.3 spec.)

+///

+#define EFI_ACPI_6_3_GENERIC_TIMER_DESCRIPTION_TABLE_REVISION 0x03

+

+///

+/// Timer Flags.  All other bits are reserved and must be 0.

+///

+#define EFI_ACPI_6_3_GTDT_TIMER_FLAG_TIMER_INTERRUPT_MODE          BIT0

+#define EFI_ACPI_6_3_GTDT_TIMER_FLAG_TIMER_INTERRUPT_POLARITY      BIT1

+#define EFI_ACPI_6_3_GTDT_TIMER_FLAG_ALWAYS_ON_CAPABILITY          BIT2

+

+///

+/// Platform Timer Type

+///

+#define EFI_ACPI_6_3_GTDT_GT_BLOCK                       0

+#define EFI_ACPI_6_3_GTDT_SBSA_GENERIC_WATCHDOG          1

+

+///

+/// GT Block Structure

+///

+typedef struct {

+  UINT8   Type;

+  UINT16  Length;

+  UINT8   Reserved;

+  UINT64  CntCtlBase;

+  UINT32  GTBlockTimerCount;

+  UINT32  GTBlockTimerOffset;

+} EFI_ACPI_6_3_GTDT_GT_BLOCK_STRUCTURE;

+

+///

+/// GT Block Timer Structure

+///

+typedef struct {

+  UINT8   GTFrameNumber;

+  UINT8   Reserved[3];

+  UINT64  CntBaseX;

+  UINT64  CntEL0BaseX;

+  UINT32  GTxPhysicalTimerGSIV;

+  UINT32  GTxPhysicalTimerFlags;

+  UINT32  GTxVirtualTimerGSIV;

+  UINT32  GTxVirtualTimerFlags;

+  UINT32  GTxCommonFlags;

+} EFI_ACPI_6_3_GTDT_GT_BLOCK_TIMER_STRUCTURE;

+

+///

+/// GT Block Physical Timers and Virtual Timers Flags.  All other bits are reserved and must be 0.

+///

+#define EFI_ACPI_6_3_GTDT_GT_BLOCK_TIMER_FLAG_TIMER_INTERRUPT_MODE          BIT0

+#define EFI_ACPI_6_3_GTDT_GT_BLOCK_TIMER_FLAG_TIMER_INTERRUPT_POLARITY      BIT1

+

+///

+/// Common Flags Flags.  All other bits are reserved and must be 0.

+///

+#define EFI_ACPI_6_3_GTDT_GT_BLOCK_COMMON_FLAG_SECURE_TIMER              BIT0

+#define EFI_ACPI_6_3_GTDT_GT_BLOCK_COMMON_FLAG_ALWAYS_ON_CAPABILITY      BIT1

+

+///

+/// SBSA Generic Watchdog Structure

+///

+typedef struct {

+  UINT8   Type;

+  UINT16  Length;

+  UINT8   Reserved;

+  UINT64  RefreshFramePhysicalAddress;

+  UINT64  WatchdogControlFramePhysicalAddress;

+  UINT32  WatchdogTimerGSIV;

+  UINT32  WatchdogTimerFlags;

+} EFI_ACPI_6_3_GTDT_SBSA_GENERIC_WATCHDOG_STRUCTURE;

+

+///

+/// SBSA Generic Watchdog Timer Flags.  All other bits are reserved and must be 0.

+///

+#define EFI_ACPI_6_3_GTDT_SBSA_GENERIC_WATCHDOG_FLAG_TIMER_INTERRUPT_MODE          BIT0

+#define EFI_ACPI_6_3_GTDT_SBSA_GENERIC_WATCHDOG_FLAG_TIMER_INTERRUPT_POLARITY      BIT1

+#define EFI_ACPI_6_3_GTDT_SBSA_GENERIC_WATCHDOG_FLAG_SECURE_TIMER                  BIT2

+

+//

+// NVDIMM Firmware Interface Table definition.

+//

+typedef struct {

+  EFI_ACPI_DESCRIPTION_HEADER    Header;

+  UINT32                         Reserved;

+} EFI_ACPI_6_3_NVDIMM_FIRMWARE_INTERFACE_TABLE;

+

+//

+// NFIT Version (as defined in ACPI 6.3 spec.)

+//

+#define EFI_ACPI_6_3_NVDIMM_FIRMWARE_INTERFACE_TABLE_REVISION 0x1

+

+//

+// Definition for NFIT Table Structure Types

+//

+#define EFI_ACPI_6_3_NFIT_SYSTEM_PHYSICAL_ADDRESS_RANGE_STRUCTURE_TYPE              0

+#define EFI_ACPI_6_3_NFIT_NVDIMM_REGION_MAPPING_STRUCTURE_TYPE                      1

+#define EFI_ACPI_6_3_NFIT_INTERLEAVE_STRUCTURE_TYPE                                 2

+#define EFI_ACPI_6_3_NFIT_SMBIOS_MANAGEMENT_INFORMATION_STRUCTURE_TYPE              3

+#define EFI_ACPI_6_3_NFIT_NVDIMM_CONTROL_REGION_STRUCTURE_TYPE                      4

+#define EFI_ACPI_6_3_NFIT_NVDIMM_BLOCK_DATA_WINDOW_REGION_STRUCTURE_TYPE            5

+#define EFI_ACPI_6_3_NFIT_FLUSH_HINT_ADDRESS_STRUCTURE_TYPE                         6

+

+//

+// Definition for NFIT Structure Header

+//

+typedef struct {

+  UINT16                                      Type;

+  UINT16                                      Length;

+} EFI_ACPI_6_3_NFIT_STRUCTURE_HEADER;

+

+//

+// Definition for System Physical Address Range Structure

+//

+#define EFI_ACPI_6_3_NFIT_SYSTEM_PHYSICAL_ADDRESS_RANGE_FLAGS_CONTROL_REGION_FOR_MANAGEMENT      BIT0

+#define EFI_ACPI_6_3_NFIT_SYSTEM_PHYSICAL_ADDRESS_RANGE_FLAGS_PROXIMITY_DOMAIN_VALID             BIT1

+#define EFI_ACPI_6_3_NFIT_GUID_VOLATILE_MEMORY_REGION                             { 0x7305944F, 0xFDDA, 0x44E3, { 0xB1, 0x6C, 0x3F, 0x22, 0xD2, 0x52, 0xE5, 0xD0 }}

+#define EFI_ACPI_6_3_NFIT_GUID_BYTE_ADDRESSABLE_PERSISTENT_MEMORY_REGION          { 0x66F0D379, 0xB4F3, 0x4074, { 0xAC, 0x43, 0x0D, 0x33, 0x18, 0xB7, 0x8C, 0xDB }}

+#define EFI_ACPI_6_3_NFIT_GUID_NVDIMM_CONTROL_REGION                              { 0x92F701F6, 0x13B4, 0x405D, { 0x91, 0x0B, 0x29, 0x93, 0x67, 0xE8, 0x23, 0x4C }}

+#define EFI_ACPI_6_3_NFIT_GUID_NVDIMM_BLOCK_DATA_WINDOW_REGION                    { 0x91AF0530, 0x5D86, 0x470E, { 0xA6, 0xB0, 0x0A, 0x2D, 0xB9, 0x40, 0x82, 0x49 }}

+#define EFI_ACPI_6_3_NFIT_GUID_RAM_DISK_SUPPORTING_VIRTUAL_DISK_REGION_VOLATILE   { 0x77AB535A, 0x45FC, 0x624B, { 0x55, 0x60, 0xF7, 0xB2, 0x81, 0xD1, 0xF9, 0x6E }}

+#define EFI_ACPI_6_3_NFIT_GUID_RAM_DISK_SUPPORTING_VIRTUAL_CD_REGION_VOLATILE     { 0x3D5ABD30, 0x4175, 0x87CE, { 0x6D, 0x64, 0xD2, 0xAD, 0xE5, 0x23, 0xC4, 0xBB }}

+#define EFI_ACPI_6_3_NFIT_GUID_RAM_DISK_SUPPORTING_VIRTUAL_DISK_REGION_PERSISTENT { 0x5CEA02C9, 0x4D07, 0x69D3, { 0x26, 0x9F ,0x44, 0x96, 0xFB, 0xE0, 0x96, 0xF9 }}

+#define EFI_ACPI_6_3_NFIT_GUID_RAM_DISK_SUPPORTING_VIRTUAL_CD_REGION_PERSISTENT   { 0x08018188, 0x42CD, 0xBB48, { 0x10, 0x0F, 0x53, 0x87, 0xD5, 0x3D, 0xED, 0x3D }}

+typedef struct {

+  UINT16                                      Type;

+  UINT16                                      Length;

+  UINT16                                      SPARangeStructureIndex;

+  UINT16                                      Flags;

+  UINT32                                      Reserved_8;

+  UINT32                                      ProximityDomain;

+  GUID                                        AddressRangeTypeGUID;

+  UINT64                                      SystemPhysicalAddressRangeBase;

+  UINT64                                      SystemPhysicalAddressRangeLength;

+  UINT64                                      AddressRangeMemoryMappingAttribute;

+} EFI_ACPI_6_3_NFIT_SYSTEM_PHYSICAL_ADDRESS_RANGE_STRUCTURE;

+

+//

+// Definition for Memory Device to System Physical Address Range Mapping Structure

+//

+typedef struct {

+  UINT32                                      DIMMNumber:4;

+  UINT32                                      MemoryChannelNumber:4;

+  UINT32                                      MemoryControllerID:4;

+  UINT32                                      SocketID:4;

+  UINT32                                      NodeControllerID:12;

+  UINT32                                      Reserved_28:4;

+} EFI_ACPI_6_3_NFIT_DEVICE_HANDLE;

+

+#define EFI_ACPI_6_3_NFIT_MEMORY_DEVICE_STATE_FLAGS_PREVIOUS_SAVE_FAIL                                      BIT0

+#define EFI_ACPI_6_3_NFIT_MEMORY_DEVICE_STATE_FLAGS_LAST_RESTORE_FAIL                                       BIT1

+#define EFI_ACPI_6_3_NFIT_MEMORY_DEVICE_STATE_FLAGS_PLATFORM_FLUSH_FAIL                                     BIT2

+#define EFI_ACPI_6_3_NFIT_MEMORY_DEVICE_STATE_FLAGS_NOT_ARMED_PRIOR_TO_OSPM_HAND_OFF                        BIT3

+#define EFI_ACPI_6_3_NFIT_MEMORY_DEVICE_STATE_FLAGS_SMART_HEALTH_EVENTS_PRIOR_OSPM_HAND_OFF                 BIT4

+#define EFI_ACPI_6_3_NFIT_MEMORY_DEVICE_STATE_FLAGS_FIRMWARE_ENABLED_TO_NOTIFY_OSPM_ON_SMART_HEALTH_EVENTS  BIT5

+#define EFI_ACPI_6_3_NFIT_MEMORY_DEVICE_STATE_FLAGS_FIRMWARE_NOT_MAP_NVDIMM_TO_SPA                          BIT6

+typedef struct {

+  UINT16                                      Type;

+  UINT16                                      Length;

+  EFI_ACPI_6_3_NFIT_DEVICE_HANDLE             NFITDeviceHandle;

+  UINT16                                      NVDIMMPhysicalID;

+  UINT16                                      NVDIMMRegionID;

+  UINT16                                      SPARangeStructureIndex ;

+  UINT16                                      NVDIMMControlRegionStructureIndex;

+  UINT64                                      NVDIMMRegionSize;

+  UINT64                                      RegionOffset;

+  UINT64                                      NVDIMMPhysicalAddressRegionBase;

+  UINT16                                      InterleaveStructureIndex;

+  UINT16                                      InterleaveWays;

+  UINT16                                      NVDIMMStateFlags;

+  UINT16                                      Reserved_46;

+} EFI_ACPI_6_3_NFIT_NVDIMM_REGION_MAPPING_STRUCTURE;

+

+//

+// Definition for Interleave Structure

+//

+typedef struct {

+  UINT16                                      Type;

+  UINT16                                      Length;

+  UINT16                                      InterleaveStructureIndex;

+  UINT16                                      Reserved_6;

+  UINT32                                      NumberOfLines;

+  UINT32                                      LineSize;

+//UINT32                                      LineOffset[NumberOfLines];

+} EFI_ACPI_6_3_NFIT_INTERLEAVE_STRUCTURE;

+

+//

+// Definition for SMBIOS Management Information Structure

+//

+typedef struct {

+  UINT16                                      Type;

+  UINT16                                      Length;

+  UINT32                                      Reserved_4;

+//UINT8                                       Data[];

+} EFI_ACPI_6_3_NFIT_SMBIOS_MANAGEMENT_INFORMATION_STRUCTURE;

+

+//

+// Definition for NVDIMM Control Region Structure

+//

+#define EFI_ACPI_6_3_NFIT_NVDIMM_CONTROL_REGION_VALID_FIELDS_MANUFACTURING           BIT0

+

+#define EFI_ACPI_6_3_NFIT_NVDIMM_CONTROL_REGION_FLAGS_BLOCK_DATA_WINDOWS_BUFFERED    BIT0

+typedef struct {

+  UINT16                                      Type;

+  UINT16                                      Length;

+  UINT16                                      NVDIMMControlRegionStructureIndex;

+  UINT16                                      VendorID;

+  UINT16                                      DeviceID;

+  UINT16                                      RevisionID;

+  UINT16                                      SubsystemVendorID;

+  UINT16                                      SubsystemDeviceID;

+  UINT16                                      SubsystemRevisionID;

+  UINT8                                       ValidFields;

+  UINT8                                       ManufacturingLocation;

+  UINT16                                      ManufacturingDate;

+  UINT8                                       Reserved_22[2];

+  UINT32                                      SerialNumber;

+  UINT16                                      RegionFormatInterfaceCode;

+  UINT16                                      NumberOfBlockControlWindows;

+  UINT64                                      SizeOfBlockControlWindow;

+  UINT64                                      CommandRegisterOffsetInBlockControlWindow;

+  UINT64                                      SizeOfCommandRegisterInBlockControlWindows;

+  UINT64                                      StatusRegisterOffsetInBlockControlWindow;

+  UINT64                                      SizeOfStatusRegisterInBlockControlWindows;

+  UINT16                                      NVDIMMControlRegionFlag;

+  UINT8                                       Reserved_74[6];

+} EFI_ACPI_6_3_NFIT_NVDIMM_CONTROL_REGION_STRUCTURE;

+

+//

+// Definition for NVDIMM Block Data Window Region Structure

+//

+typedef struct {

+  UINT16                                      Type;

+  UINT16                                      Length;

+  UINT16                                      NVDIMMControlRegionStructureIndex;

+  UINT16                                      NumberOfBlockDataWindows;

+  UINT64                                      BlockDataWindowStartOffset;

+  UINT64                                      SizeOfBlockDataWindow;

+  UINT64                                      BlockAccessibleMemoryCapacity;

+  UINT64                                      BeginningAddressOfFirstBlockInBlockAccessibleMemory;

+} EFI_ACPI_6_3_NFIT_NVDIMM_BLOCK_DATA_WINDOW_REGION_STRUCTURE;

+

+//

+// Definition for Flush Hint Address Structure

+//

+typedef struct {

+  UINT16                                      Type;

+  UINT16                                      Length;

+  EFI_ACPI_6_3_NFIT_DEVICE_HANDLE             NFITDeviceHandle;

+  UINT16                                      NumberOfFlushHintAddresses;

+  UINT8                                       Reserved_10[6];

+//UINT64                                      FlushHintAddress[NumberOfFlushHintAddresses];

+} EFI_ACPI_6_3_NFIT_FLUSH_HINT_ADDRESS_STRUCTURE;

+

+///

+/// Secure DEVices Table (SDEV)

+///

+typedef struct {

+  EFI_ACPI_DESCRIPTION_HEADER   Header;

+} EFI_ACPI_6_3_SECURE_DEVICES_TABLE_HEADER;

+

+///

+/// SDEV Revision (as defined in ACPI 6.3 spec.)

+///

+#define EFI_ACPI_6_3_SECURE_DEVICES_TABLE_REVISION      0x01

+

+///

+/// Secure Devcice types

+///

+#define EFI_ACPI_6_3_SDEV_TYPE_PCIE_ENDPOINT_DEVICE     0x01

+#define EFI_ACPI_6_3_SDEV_TYPE_ACPI_NAMESPACE_DEVICE    0x00

+

+///

+/// Secure Devcice flags

+///

+#define EFI_ACPI_6_3_SDEV_FLAG_ALLOW_HANDOFF            BIT0

+

+///

+/// SDEV Structure Header

+///

+typedef struct {

+  UINT8                         Type;

+  UINT8                         Flags;

+  UINT16                        Length;

+} EFI_ACPI_6_3_SDEV_STRUCTURE_HEADER;

+

+///

+/// PCIe Endpoint Device based Secure Device Structure

+///

+typedef struct {

+  UINT8                         Type;

+  UINT8                         Flags;

+  UINT16                        Length;

+  UINT16                        PciSegmentNumber;

+  UINT16                        StartBusNumber;

+  UINT16                        PciPathOffset;

+  UINT16                        PciPathLength;

+  UINT16                        VendorSpecificDataOffset;

+  UINT16                        VendorSpecificDataLength;

+} EFI_ACPI_6_3_SDEV_STRUCTURE_PCIE_ENDPOINT_DEVICE;

+

+///

+/// ACPI_NAMESPACE_DEVICE based Secure Device Structure

+///

+typedef struct {

+  UINT8                         Type;

+  UINT8                         Flags;

+  UINT16                        Length;

+  UINT16                        DeviceIdentifierOffset;

+  UINT16                        DeviceIdentifierLength;

+  UINT16                        VendorSpecificDataOffset;

+  UINT16                        VendorSpecificDataLength;

+} EFI_ACPI_6_3_SDEV_STRUCTURE_ACPI_NAMESPACE_DEVICE;

+

+///

+/// Boot Error Record Table (BERT)

+///

+typedef struct {

+  EFI_ACPI_DESCRIPTION_HEADER Header;

+  UINT32                      BootErrorRegionLength;

+  UINT64                      BootErrorRegion;

+} EFI_ACPI_6_3_BOOT_ERROR_RECORD_TABLE_HEADER;

+

+///

+/// BERT Version (as defined in ACPI 6.3 spec.)

+///

+#define EFI_ACPI_6_3_BOOT_ERROR_RECORD_TABLE_REVISION 0x01

+

+///

+/// Boot Error Region Block Status Definition

+///

+typedef struct {

+  UINT32       UncorrectableErrorValid:1;

+  UINT32       CorrectableErrorValid:1;

+  UINT32       MultipleUncorrectableErrors:1;

+  UINT32       MultipleCorrectableErrors:1;

+  UINT32       ErrorDataEntryCount:10;

+  UINT32       Reserved:18;

+} EFI_ACPI_6_3_ERROR_BLOCK_STATUS;

+

+///

+/// Boot Error Region Definition

+///

+typedef struct {

+  EFI_ACPI_6_3_ERROR_BLOCK_STATUS              BlockStatus;

+  UINT32                                       RawDataOffset;

+  UINT32                                       RawDataLength;

+  UINT32                                       DataLength;

+  UINT32                                       ErrorSeverity;

+} EFI_ACPI_6_3_BOOT_ERROR_REGION_STRUCTURE;

+

+//

+// Boot Error Severity types

+//

+#define EFI_ACPI_6_3_ERROR_SEVERITY_CORRECTABLE  0x00

+#define EFI_ACPI_6_3_ERROR_SEVERITY_FATAL        0x01

+#define EFI_ACPI_6_3_ERROR_SEVERITY_CORRECTED    0x02

+#define EFI_ACPI_6_3_ERROR_SEVERITY_NONE         0x03

+

+///

+/// Generic Error Data Entry Definition

+///

+typedef struct {

+  UINT8    SectionType[16];

+  UINT32   ErrorSeverity;

+  UINT16   Revision;

+  UINT8    ValidationBits;

+  UINT8    Flags;

+  UINT32   ErrorDataLength;

+  UINT8    FruId[16];

+  UINT8    FruText[20];

+  UINT8    Timestamp[8];

+} EFI_ACPI_6_3_GENERIC_ERROR_DATA_ENTRY_STRUCTURE;

+

+///

+/// Generic Error Data Entry Version (as defined in ACPI 6.3 spec.)

+///

+#define EFI_ACPI_6_3_GENERIC_ERROR_DATA_ENTRY_REVISION  0x0300

+

+///

+/// HEST - Hardware Error Source Table

+///

+typedef struct {

+  EFI_ACPI_DESCRIPTION_HEADER Header;

+  UINT32                      ErrorSourceCount;

+} EFI_ACPI_6_3_HARDWARE_ERROR_SOURCE_TABLE_HEADER;

+

+///

+/// HEST Version (as defined in ACPI 6.3 spec.)

+///

+#define EFI_ACPI_6_3_HARDWARE_ERROR_SOURCE_TABLE_REVISION 0x01

+

+//

+// Error Source structure types.

+//

+#define EFI_ACPI_6_3_IA32_ARCHITECTURE_MACHINE_CHECK_EXCEPTION  0x00

+#define EFI_ACPI_6_3_IA32_ARCHITECTURE_CORRECTED_MACHINE_CHECK  0x01

+#define EFI_ACPI_6_3_IA32_ARCHITECTURE_NMI_ERROR                0x02

+#define EFI_ACPI_6_3_PCI_EXPRESS_ROOT_PORT_AER                  0x06

+#define EFI_ACPI_6_3_PCI_EXPRESS_DEVICE_AER                     0x07

+#define EFI_ACPI_6_3_PCI_EXPRESS_BRIDGE_AER                     0x08

+#define EFI_ACPI_6_3_GENERIC_HARDWARE_ERROR                     0x09

+#define EFI_ACPI_6_3_GENERIC_HARDWARE_ERROR_VERSION_2           0x0A

+#define EFI_ACPI_6_3_IA32_ARCHITECTURE_DEFERRED_MACHINE_CHECK   0x0B

+

+//

+// Error Source structure flags.

+//

+#define EFI_ACPI_6_3_ERROR_SOURCE_FLAG_FIRMWARE_FIRST       (1 << 0)

+#define EFI_ACPI_6_3_ERROR_SOURCE_FLAG_GLOBAL               (1 << 1)

+#define EFI_ACPI_6_3_ERROR_SOURCE_FLAG_GHES_ASSIST          (1 << 2)

+

+///

+/// IA-32 Architecture Machine Check Exception Structure Definition

+///

+typedef struct {

+  UINT16  Type;

+  UINT16  SourceId;

+  UINT8   Reserved0[2];

+  UINT8   Flags;

+  UINT8   Enabled;

+  UINT32  NumberOfRecordsToPreAllocate;

+  UINT32  MaxSectionsPerRecord;

+  UINT64  GlobalCapabilityInitData;

+  UINT64  GlobalControlInitData;

+  UINT8   NumberOfHardwareBanks;

+  UINT8   Reserved1[7];

+} EFI_ACPI_6_3_IA32_ARCHITECTURE_MACHINE_CHECK_EXCEPTION_STRUCTURE;

+

+///

+/// IA-32 Architecture Machine Check Bank Structure Definition

+///

+typedef struct {

+  UINT8   BankNumber;

+  UINT8   ClearStatusOnInitialization;

+  UINT8   StatusDataFormat;

+  UINT8   Reserved0;

+  UINT32  ControlRegisterMsrAddress;

+  UINT64  ControlInitData;

+  UINT32  StatusRegisterMsrAddress;

+  UINT32  AddressRegisterMsrAddress;

+  UINT32  MiscRegisterMsrAddress;

+} EFI_ACPI_6_3_IA32_ARCHITECTURE_MACHINE_CHECK_ERROR_BANK_STRUCTURE;

+

+///

+/// IA-32 Architecture Machine Check Bank Structure MCA data format

+///

+#define EFI_ACPI_6_3_IA32_ARCHITECTURE_MACHINE_CHECK_ERROR_DATA_FORMAT_IA32      0x00

+#define EFI_ACPI_6_3_IA32_ARCHITECTURE_MACHINE_CHECK_ERROR_DATA_FORMAT_INTEL64   0x01

+#define EFI_ACPI_6_3_IA32_ARCHITECTURE_MACHINE_CHECK_ERROR_DATA_FORMAT_AMD64     0x02

+

+//

+// Hardware Error Notification types. All other values are reserved

+//

+#define EFI_ACPI_6_3_HARDWARE_ERROR_NOTIFICATION_POLLED                         0x00

+#define EFI_ACPI_6_3_HARDWARE_ERROR_NOTIFICATION_EXTERNAL_INTERRUPT             0x01

+#define EFI_ACPI_6_3_HARDWARE_ERROR_NOTIFICATION_LOCAL_INTERRUPT                0x02

+#define EFI_ACPI_6_3_HARDWARE_ERROR_NOTIFICATION_SCI                            0x03

+#define EFI_ACPI_6_3_HARDWARE_ERROR_NOTIFICATION_NMI                            0x04

+#define EFI_ACPI_6_3_HARDWARE_ERROR_NOTIFICATION_CMCI                           0x05

+#define EFI_ACPI_6_3_HARDWARE_ERROR_NOTIFICATION_MCE                            0x06

+#define EFI_ACPI_6_3_HARDWARE_ERROR_NOTIFICATION_GPIO_SIGNAL                    0x07

+#define EFI_ACPI_6_3_HARDWARE_ERROR_NOTIFICATION_ARMV8_SEA                      0x08

+#define EFI_ACPI_6_3_HARDWARE_ERROR_NOTIFICATION_ARMV8_SEI                      0x09

+#define EFI_ACPI_6_3_HARDWARE_ERROR_NOTIFICATION_GSIV                           0x0A

+#define EFI_ACPI_6_3_HARDWARE_ERROR_NOTIFICATION_SOFTWARE_DELEGATED_EXCEPTION   0x0B

+

+///

+/// Hardware Error Notification Configuration Write Enable Structure Definition

+///

+typedef struct {

+  UINT16    Type:1;

+  UINT16    PollInterval:1;

+  UINT16    SwitchToPollingThresholdValue:1;

+  UINT16    SwitchToPollingThresholdWindow:1;

+  UINT16    ErrorThresholdValue:1;

+  UINT16    ErrorThresholdWindow:1;

+  UINT16    Reserved:10;

+} EFI_ACPI_6_3_HARDWARE_ERROR_NOTIFICATION_CONFIGURATION_WRITE_ENABLE_STRUCTURE;

+

+///

+/// Hardware Error Notification Structure Definition

+///

+typedef struct {

+  UINT8                                                                          Type;

+  UINT8                                                                          Length;

+  EFI_ACPI_6_3_HARDWARE_ERROR_NOTIFICATION_CONFIGURATION_WRITE_ENABLE_STRUCTURE  ConfigurationWriteEnable;

+  UINT32                                                                         PollInterval;

+  UINT32                                                                         Vector;

+  UINT32                                                                         SwitchToPollingThresholdValue;

+  UINT32                                                                         SwitchToPollingThresholdWindow;

+  UINT32                                                                         ErrorThresholdValue;

+  UINT32                                                                         ErrorThresholdWindow;

+} EFI_ACPI_6_3_HARDWARE_ERROR_NOTIFICATION_STRUCTURE;

+

+///

+/// IA-32 Architecture Corrected Machine Check Structure Definition

+///

+typedef struct {

+  UINT16                                                 Type;

+  UINT16                                                 SourceId;

+  UINT8                                                  Reserved0[2];

+  UINT8                                                  Flags;

+  UINT8                                                  Enabled;

+  UINT32                                                 NumberOfRecordsToPreAllocate;

+  UINT32                                                 MaxSectionsPerRecord;

+  EFI_ACPI_6_3_HARDWARE_ERROR_NOTIFICATION_STRUCTURE     NotificationStructure;

+  UINT8                                                  NumberOfHardwareBanks;

+  UINT8                                                  Reserved1[3];

+} EFI_ACPI_6_3_IA32_ARCHITECTURE_CORRECTED_MACHINE_CHECK_STRUCTURE;

+

+///

+/// IA-32 Architecture NMI Error Structure Definition

+///

+typedef struct {

+  UINT16  Type;

+  UINT16  SourceId;

+  UINT8   Reserved0[2];

+  UINT32  NumberOfRecordsToPreAllocate;

+  UINT32  MaxSectionsPerRecord;

+  UINT32  MaxRawDataLength;

+} EFI_ACPI_6_3_IA32_ARCHITECTURE_NMI_ERROR_STRUCTURE;

+

+///

+/// PCI Express Root Port AER Structure Definition

+///

+typedef struct {

+  UINT16  Type;

+  UINT16  SourceId;

+  UINT8   Reserved0[2];

+  UINT8   Flags;

+  UINT8   Enabled;

+  UINT32  NumberOfRecordsToPreAllocate;

+  UINT32  MaxSectionsPerRecord;

+  UINT32  Bus;

+  UINT16  Device;

+  UINT16  Function;

+  UINT16  DeviceControl;

+  UINT8   Reserved1[2];

+  UINT32  UncorrectableErrorMask;

+  UINT32  UncorrectableErrorSeverity;

+  UINT32  CorrectableErrorMask;

+  UINT32  AdvancedErrorCapabilitiesAndControl;

+  UINT32  RootErrorCommand;

+} EFI_ACPI_6_3_PCI_EXPRESS_ROOT_PORT_AER_STRUCTURE;

+

+///

+/// PCI Express Device AER Structure Definition

+///

+typedef struct {

+  UINT16  Type;

+  UINT16  SourceId;

+  UINT8   Reserved0[2];

+  UINT8   Flags;

+  UINT8   Enabled;

+  UINT32  NumberOfRecordsToPreAllocate;

+  UINT32  MaxSectionsPerRecord;

+  UINT32  Bus;

+  UINT16  Device;

+  UINT16  Function;

+  UINT16  DeviceControl;

+  UINT8   Reserved1[2];

+  UINT32  UncorrectableErrorMask;

+  UINT32  UncorrectableErrorSeverity;

+  UINT32  CorrectableErrorMask;

+  UINT32  AdvancedErrorCapabilitiesAndControl;

+} EFI_ACPI_6_3_PCI_EXPRESS_DEVICE_AER_STRUCTURE;

+

+///

+/// PCI Express Bridge AER Structure Definition

+///

+typedef struct {

+  UINT16  Type;

+  UINT16  SourceId;

+  UINT8   Reserved0[2];

+  UINT8   Flags;

+  UINT8   Enabled;

+  UINT32  NumberOfRecordsToPreAllocate;

+  UINT32  MaxSectionsPerRecord;

+  UINT32  Bus;

+  UINT16  Device;

+  UINT16  Function;

+  UINT16  DeviceControl;

+  UINT8   Reserved1[2];

+  UINT32  UncorrectableErrorMask;

+  UINT32  UncorrectableErrorSeverity;

+  UINT32  CorrectableErrorMask;

+  UINT32  AdvancedErrorCapabilitiesAndControl;

+  UINT32  SecondaryUncorrectableErrorMask;

+  UINT32  SecondaryUncorrectableErrorSeverity;

+  UINT32  SecondaryAdvancedErrorCapabilitiesAndControl;

+} EFI_ACPI_6_3_PCI_EXPRESS_BRIDGE_AER_STRUCTURE;

+

+///

+/// Generic Hardware Error Source Structure Definition

+///

+typedef struct {

+  UINT16                                                 Type;

+  UINT16                                                 SourceId;

+  UINT16                                                 RelatedSourceId;

+  UINT8                                                  Flags;

+  UINT8                                                  Enabled;

+  UINT32                                                 NumberOfRecordsToPreAllocate;

+  UINT32                                                 MaxSectionsPerRecord;

+  UINT32                                                 MaxRawDataLength;

+  EFI_ACPI_6_3_GENERIC_ADDRESS_STRUCTURE                 ErrorStatusAddress;

+  EFI_ACPI_6_3_HARDWARE_ERROR_NOTIFICATION_STRUCTURE     NotificationStructure;

+  UINT32                                                 ErrorStatusBlockLength;

+} EFI_ACPI_6_3_GENERIC_HARDWARE_ERROR_SOURCE_STRUCTURE;

+

+///

+/// Generic Hardware Error Source Version 2 Structure Definition

+///

+typedef struct {

+  UINT16                                                 Type;

+  UINT16                                                 SourceId;

+  UINT16                                                 RelatedSourceId;

+  UINT8                                                  Flags;

+  UINT8                                                  Enabled;

+  UINT32                                                 NumberOfRecordsToPreAllocate;

+  UINT32                                                 MaxSectionsPerRecord;

+  UINT32                                                 MaxRawDataLength;

+  EFI_ACPI_6_3_GENERIC_ADDRESS_STRUCTURE                 ErrorStatusAddress;

+  EFI_ACPI_6_3_HARDWARE_ERROR_NOTIFICATION_STRUCTURE     NotificationStructure;

+  UINT32                                                 ErrorStatusBlockLength;

+  EFI_ACPI_6_3_GENERIC_ADDRESS_STRUCTURE                 ReadAckRegister;

+  UINT64                                                 ReadAckPreserve;

+  UINT64                                                 ReadAckWrite;

+} EFI_ACPI_6_3_GENERIC_HARDWARE_ERROR_SOURCE_VERSION_2_STRUCTURE;

+

+///

+/// Generic Error Status Definition

+///

+typedef struct {

+  EFI_ACPI_6_3_ERROR_BLOCK_STATUS              BlockStatus;

+  UINT32                                       RawDataOffset;

+  UINT32                                       RawDataLength;

+  UINT32                                       DataLength;

+  UINT32                                       ErrorSeverity;

+} EFI_ACPI_6_3_GENERIC_ERROR_STATUS_STRUCTURE;

+

+///

+/// IA-32 Architecture Deferred Machine Check Structure Definition

+///

+typedef struct {

+  UINT16                                                Type;

+  UINT16                                                SourceId;

+  UINT8                                                 Reserved0[2];

+  UINT8                                                 Flags;

+  UINT8                                                 Enabled;

+  UINT32                                                NumberOfRecordsToPreAllocate;

+  UINT32                                                MaxSectionsPerRecord;

+  EFI_ACPI_6_3_HARDWARE_ERROR_NOTIFICATION_STRUCTURE    NotificationStructure;

+  UINT8                                                 NumberOfHardwareBanks;

+  UINT8                                                 Reserved1[3];

+} EFI_ACPI_6_3_IA32_ARCHITECTURE_DEFERRED_MACHINE_CHECK_STRUCTURE;;

+

+///

+/// HMAT - Heterogeneous Memory Attribute Table

+///

+typedef struct {

+  EFI_ACPI_DESCRIPTION_HEADER Header;

+  UINT8                       Reserved[4];

+} EFI_ACPI_6_3_HETEROGENEOUS_MEMORY_ATTRIBUTE_TABLE_HEADER;

+

+///

+/// HMAT Revision (as defined in ACPI 6.3 spec.)

+///

+#define EFI_ACPI_6_3_HETEROGENEOUS_MEMORY_ATTRIBUTE_TABLE_REVISION 0x02

+

+///

+/// HMAT types

+///

+#define EFI_ACPI_6_3_HMAT_TYPE_MEMORY_PROXIMITY_DOMAIN_ATTRIBUTES           0x00

+#define EFI_ACPI_6_3_HMAT_TYPE_SYSTEM_LOCALITY_LATENCY_AND_BANDWIDTH_INFO   0x01

+#define EFI_ACPI_6_3_HMAT_TYPE_MEMORY_SIDE_CACHE_INFO                       0x02

+

+///

+/// HMAT Structure Header

+///

+typedef struct {

+  UINT16                        Type;

+  UINT8                         Reserved[2];

+  UINT32                        Length;

+} EFI_ACPI_6_3_HMAT_STRUCTURE_HEADER;

+

+///

+/// Memory Proximity Domain Attributes Structure flags

+///

+typedef struct {

+  UINT16                        InitiatorProximityDomainValid:1;

+  UINT16                        Reserved:15;

+} EFI_ACPI_6_3_HMAT_STRUCTURE_MEMORY_PROXIMITY_DOMAIN_ATTRIBUTES_FLAGS;

+

+///

+/// Memory Proximity Domain Attributes Structure

+///

+typedef struct {

+  UINT16                                                                Type;

+  UINT8                                                                 Reserved[2];

+  UINT32                                                                Length;

+  EFI_ACPI_6_3_HMAT_STRUCTURE_MEMORY_PROXIMITY_DOMAIN_ATTRIBUTES_FLAGS  Flags;

+  UINT8                                                                 Reserved1[2];

+  UINT32                                                                InitiatorProximityDomain;

+  UINT32                                                                MemoryProximityDomain;

+  UINT8                                                                 Reserved2[20];

+} EFI_ACPI_6_3_HMAT_STRUCTURE_MEMORY_PROXIMITY_DOMAIN_ATTRIBUTES;

+

+///

+/// System Locality Latency and Bandwidth Information Structure flags

+///

+typedef struct {

+  UINT8                         MemoryHierarchy:4;

+  UINT8                         Reserved:4;

+} EFI_ACPI_6_3_HMAT_STRUCTURE_SYSTEM_LOCALITY_LATENCY_AND_BANDWIDTH_INFO_FLAGS;

+

+///

+/// System Locality Latency and Bandwidth Information Structure

+///

+typedef struct {

+  UINT16                                                                        Type;

+  UINT8                                                                         Reserved[2];

+  UINT32                                                                        Length;

+  EFI_ACPI_6_3_HMAT_STRUCTURE_SYSTEM_LOCALITY_LATENCY_AND_BANDWIDTH_INFO_FLAGS  Flags;

+  UINT8                                                                         DataType;

+  UINT8                                                                         Reserved1[2];

+  UINT32                                                                        NumberOfInitiatorProximityDomains;

+  UINT32                                                                        NumberOfTargetProximityDomains;

+  UINT8                                                                         Reserved2[4];

+  UINT64                                                                        EntryBaseUnit;

+} EFI_ACPI_6_3_HMAT_STRUCTURE_SYSTEM_LOCALITY_LATENCY_AND_BANDWIDTH_INFO;

+

+///

+/// Memory Side Cache Information Structure cache attributes

+///

+typedef struct {

+  UINT32                        TotalCacheLevels:4;

+  UINT32                        CacheLevel:4;

+  UINT32                        CacheAssociativity:4;

+  UINT32                        WritePolicy:4;

+  UINT32                        CacheLineSize:16;

+} EFI_ACPI_6_3_HMAT_STRUCTURE_MEMORY_SIDE_CACHE_INFO_CACHE_ATTRIBUTES;

+

+///

+/// Memory Side Cache Information Structure

+///

+typedef struct {

+  UINT16                                                                Type;

+  UINT8                                                                 Reserved[2];

+  UINT32                                                                Length;

+  UINT32                                                                MemoryProximityDomain;

+  UINT8                                                                 Reserved1[4];

+  UINT64                                                                MemorySideCacheSize;

+  EFI_ACPI_6_3_HMAT_STRUCTURE_MEMORY_SIDE_CACHE_INFO_CACHE_ATTRIBUTES   CacheAttributes;

+  UINT8                                                                 Reserved2[2];

+  UINT16                                                                NumberOfSmbiosHandles;

+} EFI_ACPI_6_3_HMAT_STRUCTURE_MEMORY_SIDE_CACHE_INFO;

+

+///

+/// ERST - Error Record Serialization Table

+///

+typedef struct {

+  EFI_ACPI_DESCRIPTION_HEADER Header;

+  UINT32                      SerializationHeaderSize;

+  UINT8                       Reserved0[4];

+  UINT32                      InstructionEntryCount;

+} EFI_ACPI_6_3_ERROR_RECORD_SERIALIZATION_TABLE_HEADER;

+

+///

+/// ERST Version (as defined in ACPI 6.3 spec.)

+///

+#define EFI_ACPI_6_3_ERROR_RECORD_SERIALIZATION_TABLE_REVISION 0x01

+

+///

+/// ERST Serialization Actions

+///

+#define EFI_ACPI_6_3_ERST_BEGIN_WRITE_OPERATION                    0x00

+#define EFI_ACPI_6_3_ERST_BEGIN_READ_OPERATION                     0x01

+#define EFI_ACPI_6_3_ERST_BEGIN_CLEAR_OPERATION                    0x02

+#define EFI_ACPI_6_3_ERST_END_OPERATION                            0x03

+#define EFI_ACPI_6_3_ERST_SET_RECORD_OFFSET                        0x04

+#define EFI_ACPI_6_3_ERST_EXECUTE_OPERATION                        0x05

+#define EFI_ACPI_6_3_ERST_CHECK_BUSY_STATUS                        0x06

+#define EFI_ACPI_6_3_ERST_GET_COMMAND_STATUS                       0x07

+#define EFI_ACPI_6_3_ERST_GET_RECORD_IDENTIFIER                    0x08

+#define EFI_ACPI_6_3_ERST_SET_RECORD_IDENTIFIER                    0x09

+#define EFI_ACPI_6_3_ERST_GET_RECORD_COUNT                         0x0A

+#define EFI_ACPI_6_3_ERST_BEGIN_DUMMY_WRITE_OPERATION              0x0B

+#define EFI_ACPI_6_3_ERST_GET_ERROR_LOG_ADDRESS_RANGE              0x0D

+#define EFI_ACPI_6_3_ERST_GET_ERROR_LOG_ADDRESS_RANGE_LENGTH       0x0E

+#define EFI_ACPI_6_3_ERST_GET_ERROR_LOG_ADDRESS_RANGE_ATTRIBUTES   0x0F

+#define EFI_ACPI_6_3_ERST_GET_EXECUTE_OPERATION_TIMINGS            0x10

+

+///

+/// ERST Action Command Status

+///

+#define EFI_ACPI_6_3_ERST_STATUS_SUCCESS                           0x00

+#define EFI_ACPI_6_3_ERST_STATUS_NOT_ENOUGH_SPACE                  0x01

+#define EFI_ACPI_6_3_ERST_STATUS_HARDWARE_NOT_AVAILABLE            0x02

+#define EFI_ACPI_6_3_ERST_STATUS_FAILED                            0x03

+#define EFI_ACPI_6_3_ERST_STATUS_RECORD_STORE_EMPTY                0x04

+#define EFI_ACPI_6_3_ERST_STATUS_RECORD_NOT_FOUND                  0x05

+

+///

+/// ERST Serialization Instructions

+///

+#define EFI_ACPI_6_3_ERST_READ_REGISTER                            0x00

+#define EFI_ACPI_6_3_ERST_READ_REGISTER_VALUE                      0x01

+#define EFI_ACPI_6_3_ERST_WRITE_REGISTER                           0x02

+#define EFI_ACPI_6_3_ERST_WRITE_REGISTER_VALUE                     0x03

+#define EFI_ACPI_6_3_ERST_NOOP                                     0x04

+#define EFI_ACPI_6_3_ERST_LOAD_VAR1                                0x05

+#define EFI_ACPI_6_3_ERST_LOAD_VAR2                                0x06

+#define EFI_ACPI_6_3_ERST_STORE_VAR1                               0x07

+#define EFI_ACPI_6_3_ERST_ADD                                      0x08

+#define EFI_ACPI_6_3_ERST_SUBTRACT                                 0x09

+#define EFI_ACPI_6_3_ERST_ADD_VALUE                                0x0A

+#define EFI_ACPI_6_3_ERST_SUBTRACT_VALUE                           0x0B

+#define EFI_ACPI_6_3_ERST_STALL                                    0x0C

+#define EFI_ACPI_6_3_ERST_STALL_WHILE_TRUE                         0x0D

+#define EFI_ACPI_6_3_ERST_SKIP_NEXT_INSTRUCTION_IF_TRUE            0x0E

+#define EFI_ACPI_6_3_ERST_GOTO                                     0x0F

+#define EFI_ACPI_6_3_ERST_SET_SRC_ADDRESS_BASE                     0x10

+#define EFI_ACPI_6_3_ERST_SET_DST_ADDRESS_BASE                     0x11

+#define EFI_ACPI_6_3_ERST_MOVE_DATA                                0x12

+

+///

+/// ERST Instruction Flags

+///

+#define EFI_ACPI_6_3_ERST_PRESERVE_REGISTER                        0x01

+

+///

+/// ERST Serialization Instruction Entry

+///

+typedef struct {

+  UINT8                                    SerializationAction;

+  UINT8                                    Instruction;

+  UINT8                                    Flags;

+  UINT8                                    Reserved0;

+  EFI_ACPI_6_3_GENERIC_ADDRESS_STRUCTURE   RegisterRegion;

+  UINT64                                   Value;

+  UINT64                                   Mask;

+} EFI_ACPI_6_3_ERST_SERIALIZATION_INSTRUCTION_ENTRY;

+

+///

+/// EINJ - Error Injection Table

+///

+typedef struct {

+  EFI_ACPI_DESCRIPTION_HEADER Header;

+  UINT32                      InjectionHeaderSize;

+  UINT8                       InjectionFlags;

+  UINT8                       Reserved0[3];

+  UINT32                      InjectionEntryCount;

+} EFI_ACPI_6_3_ERROR_INJECTION_TABLE_HEADER;

+

+///

+/// EINJ Version (as defined in ACPI 6.3 spec.)

+///

+#define EFI_ACPI_6_3_ERROR_INJECTION_TABLE_REVISION 0x01

+

+///

+/// EINJ Error Injection Actions

+///

+#define EFI_ACPI_6_3_EINJ_BEGIN_INJECTION_OPERATION                0x00

+#define EFI_ACPI_6_3_EINJ_GET_TRIGGER_ERROR_ACTION_TABLE           0x01

+#define EFI_ACPI_6_3_EINJ_SET_ERROR_TYPE                           0x02

+#define EFI_ACPI_6_3_EINJ_GET_ERROR_TYPE                           0x03

+#define EFI_ACPI_6_3_EINJ_END_OPERATION                            0x04

+#define EFI_ACPI_6_3_EINJ_EXECUTE_OPERATION                        0x05

+#define EFI_ACPI_6_3_EINJ_CHECK_BUSY_STATUS                        0x06

+#define EFI_ACPI_6_3_EINJ_GET_COMMAND_STATUS                       0x07

+#define EFI_ACPI_6_3_EINJ_TRIGGER_ERROR                            0xFF

+

+///

+/// EINJ Action Command Status

+///

+#define EFI_ACPI_6_3_EINJ_STATUS_SUCCESS                           0x00

+#define EFI_ACPI_6_3_EINJ_STATUS_UNKNOWN_FAILURE                   0x01

+#define EFI_ACPI_6_3_EINJ_STATUS_INVALID_ACCESS                    0x02

+

+///

+/// EINJ Error Type Definition

+///

+#define EFI_ACPI_6_3_EINJ_ERROR_PROCESSOR_CORRECTABLE                 (1 << 0)

+#define EFI_ACPI_6_3_EINJ_ERROR_PROCESSOR_UNCORRECTABLE_NONFATAL      (1 << 1)

+#define EFI_ACPI_6_3_EINJ_ERROR_PROCESSOR_UNCORRECTABLE_FATAL         (1 << 2)

+#define EFI_ACPI_6_3_EINJ_ERROR_MEMORY_CORRECTABLE                    (1 << 3)

+#define EFI_ACPI_6_3_EINJ_ERROR_MEMORY_UNCORRECTABLE_NONFATAL         (1 << 4)

+#define EFI_ACPI_6_3_EINJ_ERROR_MEMORY_UNCORRECTABLE_FATAL            (1 << 5)

+#define EFI_ACPI_6_3_EINJ_ERROR_PCI_EXPRESS_CORRECTABLE               (1 << 6)

+#define EFI_ACPI_6_3_EINJ_ERROR_PCI_EXPRESS_UNCORRECTABLE_NONFATAL    (1 << 7)

+#define EFI_ACPI_6_3_EINJ_ERROR_PCI_EXPRESS_UNCORRECTABLE_FATAL       (1 << 8)

+#define EFI_ACPI_6_3_EINJ_ERROR_PLATFORM_CORRECTABLE                  (1 << 9)

+#define EFI_ACPI_6_3_EINJ_ERROR_PLATFORM_UNCORRECTABLE_NONFATAL       (1 << 10)

+#define EFI_ACPI_6_3_EINJ_ERROR_PLATFORM_UNCORRECTABLE_FATAL          (1 << 11)

+

+///

+/// EINJ Injection Instructions

+///

+#define EFI_ACPI_6_3_EINJ_READ_REGISTER                            0x00

+#define EFI_ACPI_6_3_EINJ_READ_REGISTER_VALUE                      0x01

+#define EFI_ACPI_6_3_EINJ_WRITE_REGISTER                           0x02

+#define EFI_ACPI_6_3_EINJ_WRITE_REGISTER_VALUE                     0x03

+#define EFI_ACPI_6_3_EINJ_NOOP                                     0x04

+

+///

+/// EINJ Instruction Flags

+///

+#define EFI_ACPI_6_3_EINJ_PRESERVE_REGISTER                        0x01

+

+///

+/// EINJ Injection Instruction Entry

+///

+typedef struct {

+  UINT8                                    InjectionAction;

+  UINT8                                    Instruction;

+  UINT8                                    Flags;

+  UINT8                                    Reserved0;

+  EFI_ACPI_6_3_GENERIC_ADDRESS_STRUCTURE   RegisterRegion;

+  UINT64                                   Value;

+  UINT64                                   Mask;

+} EFI_ACPI_6_3_EINJ_INJECTION_INSTRUCTION_ENTRY;

+

+///

+/// EINJ Trigger Action Table

+///

+typedef struct {

+  UINT32  HeaderSize;

+  UINT32  Revision;

+  UINT32  TableSize;

+  UINT32  EntryCount;

+} EFI_ACPI_6_3_EINJ_TRIGGER_ACTION_TABLE;

+

+///

+/// Platform Communications Channel Table (PCCT)

+///

+typedef struct {

+  EFI_ACPI_DESCRIPTION_HEADER Header;

+  UINT32                      Flags;

+  UINT64                      Reserved;

+} EFI_ACPI_6_3_PLATFORM_COMMUNICATION_CHANNEL_TABLE_HEADER;

+

+///

+/// PCCT Version (as defined in ACPI 6.3 spec.)

+///

+#define EFI_ACPI_6_3_PLATFORM_COMMUNICATION_CHANNEL_TABLE_REVISION 0x02

+

+///

+/// PCCT Global Flags

+///

+#define EFI_ACPI_6_3_PCCT_FLAGS_PLATFORM_INTERRUPT  BIT0

+

+//

+// PCCT Subspace type

+//

+#define EFI_ACPI_6_3_PCCT_SUBSPACE_TYPE_GENERIC                         0x00

+#define EFI_ACPI_6_3_PCCT_SUBSPACE_TYPE_1_HW_REDUCED_COMMUNICATIONS     0x01

+#define EFI_ACPI_6_3_PCCT_SUBSPACE_TYPE_2_HW_REDUCED_COMMUNICATIONS     0x02

+#define EFI_ACPI_6_3_PCCT_SUBSPACE_TYPE_3_EXTENDED_PCC                  0x03

+#define EFI_ACPI_6_3_PCCT_SUBSPACE_TYPE_4_EXTENDED_PCC                  0x04

+

+///

+/// PCC Subspace Structure Header

+///

+typedef struct {

+  UINT8        Type;

+  UINT8        Length;

+} EFI_ACPI_6_3_PCCT_SUBSPACE_HEADER;

+

+///

+/// Generic Communications Subspace Structure

+///

+typedef struct {

+  UINT8                                    Type;

+  UINT8                                    Length;

+  UINT8                                    Reserved[6];

+  UINT64                                   BaseAddress;

+  UINT64                                   AddressLength;

+  EFI_ACPI_6_3_GENERIC_ADDRESS_STRUCTURE   DoorbellRegister;

+  UINT64                                   DoorbellPreserve;

+  UINT64                                   DoorbellWrite;

+  UINT32                                   NominalLatency;

+  UINT32                                   MaximumPeriodicAccessRate;

+  UINT16                                   MinimumRequestTurnaroundTime;

+} EFI_ACPI_6_3_PCCT_SUBSPACE_GENERIC;

+

+///

+/// Generic Communications Channel Shared Memory Region

+///

+

+typedef struct {

+  UINT8                                    Command;

+  UINT8                                    Reserved:7;

+  UINT8                                    NotifyOnCompletion:1;

+} EFI_ACPI_6_3_PCCT_GENERIC_SHARED_MEMORY_REGION_COMMAND;

+

+typedef struct {

+  UINT8                                    CommandComplete:1;

+  UINT8                                    PlatformInterrupt:1;

+  UINT8                                    Error:1;

+  UINT8                                    PlatformNotification:1;

+  UINT8                                    Reserved:4;

+  UINT8                                    Reserved1;

+} EFI_ACPI_6_3_PCCT_GENERIC_SHARED_MEMORY_REGION_STATUS;

+

+typedef struct {

+  UINT32                                                    Signature;

+  EFI_ACPI_6_3_PCCT_GENERIC_SHARED_MEMORY_REGION_COMMAND    Command;

+  EFI_ACPI_6_3_PCCT_GENERIC_SHARED_MEMORY_REGION_STATUS     Status;

+} EFI_ACPI_6_3_PCCT_GENERIC_SHARED_MEMORY_REGION_HEADER;

+

+#define EFI_ACPI_6_3_PCCT_SUBSPACE_PLATFORM_INTERRUPT_FLAGS_POLARITY    BIT0

+#define EFI_ACPI_6_3_PCCT_SUBSPACE_PLATFORM_INTERRUPT_FLAGS_MODE        BIT1

+

+///

+/// Type 1 HW-Reduced Communications Subspace Structure

+///

+typedef struct {

+  UINT8                                    Type;

+  UINT8                                    Length;

+  UINT32                                   PlatformInterrupt;

+  UINT8                                    PlatformInterruptFlags;

+  UINT8                                    Reserved;

+  UINT64                                   BaseAddress;

+  UINT64                                   AddressLength;

+  EFI_ACPI_6_3_GENERIC_ADDRESS_STRUCTURE   DoorbellRegister;

+  UINT64                                   DoorbellPreserve;

+  UINT64                                   DoorbellWrite;

+  UINT32                                   NominalLatency;

+  UINT32                                   MaximumPeriodicAccessRate;

+  UINT16                                   MinimumRequestTurnaroundTime;

+} EFI_ACPI_6_3_PCCT_SUBSPACE_1_HW_REDUCED_COMMUNICATIONS;

+

+///

+/// Type 2 HW-Reduced Communications Subspace Structure

+///

+typedef struct {

+  UINT8                                    Type;

+  UINT8                                    Length;

+  UINT32                                   PlatformInterrupt;

+  UINT8                                    PlatformInterruptFlags;

+  UINT8                                    Reserved;

+  UINT64                                   BaseAddress;

+  UINT64                                   AddressLength;

+  EFI_ACPI_6_3_GENERIC_ADDRESS_STRUCTURE   DoorbellRegister;

+  UINT64                                   DoorbellPreserve;

+  UINT64                                   DoorbellWrite;

+  UINT32                                   NominalLatency;

+  UINT32                                   MaximumPeriodicAccessRate;

+  UINT16                                   MinimumRequestTurnaroundTime;

+  EFI_ACPI_6_3_GENERIC_ADDRESS_STRUCTURE   PlatformInterruptAckRegister;

+  UINT64                                   PlatformInterruptAckPreserve;

+  UINT64                                   PlatformInterruptAckWrite;

+} EFI_ACPI_6_3_PCCT_SUBSPACE_2_HW_REDUCED_COMMUNICATIONS;

+

+///

+/// Type 3 Extended PCC Subspace Structure

+///

+typedef struct {

+  UINT8                                    Type;

+  UINT8                                    Length;

+  UINT32                                   PlatformInterrupt;

+  UINT8                                    PlatformInterruptFlags;

+  UINT8                                    Reserved;

+  UINT64                                   BaseAddress;

+  UINT32                                   AddressLength;

+  EFI_ACPI_6_3_GENERIC_ADDRESS_STRUCTURE   DoorbellRegister;

+  UINT64                                   DoorbellPreserve;

+  UINT64                                   DoorbellWrite;

+  UINT32                                   NominalLatency;

+  UINT32                                   MaximumPeriodicAccessRate;

+  UINT32                                   MinimumRequestTurnaroundTime;

+  EFI_ACPI_6_3_GENERIC_ADDRESS_STRUCTURE   PlatformInterruptAckRegister;

+  UINT64                                   PlatformInterruptAckPreserve;

+  UINT64                                   PlatformInterruptAckSet;

+  UINT8                                    Reserved1[8];

+  EFI_ACPI_6_3_GENERIC_ADDRESS_STRUCTURE   CommandCompleteCheckRegister;

+  UINT64                                   CommandCompleteCheckMask;

+  EFI_ACPI_6_3_GENERIC_ADDRESS_STRUCTURE   CommandCompleteUpdateRegister;

+  UINT64                                   CommandCompleteUpdatePreserve;

+  UINT64                                   CommandCompleteUpdateSet;

+  EFI_ACPI_6_3_GENERIC_ADDRESS_STRUCTURE   ErrorStatusRegister;

+  UINT64                                   ErrorStatusMask;

+} EFI_ACPI_6_3_PCCT_SUBSPACE_3_EXTENDED_PCC;

+

+///

+/// Type 4 Extended PCC Subspace Structure

+///

+typedef EFI_ACPI_6_3_PCCT_SUBSPACE_3_EXTENDED_PCC EFI_ACPI_6_3_PCCT_SUBSPACE_4_EXTENDED_PCC;

+

+#define EFI_ACPI_6_3_PCCT_MASTER_SLAVE_COMMUNICATIONS_CHANNEL_FLAGS_NOTIFY_ON_COMPLETION BIT0

+

+typedef struct {

+  UINT32                                    Signature;

+  UINT32                                    Flags;

+  UINT32                                    Length;

+  UINT32                                    Command;

+} EFI_ACPI_6_3_PCCT_EXTENDED_PCC_SHARED_MEMORY_REGION_HEADER;

+

+///

+/// Platform Debug Trigger Table (PDTT)

+///

+typedef struct {

+  EFI_ACPI_DESCRIPTION_HEADER   Header;

+  UINT8                         TriggerCount;

+  UINT8                         Reserved[3];

+  UINT32                        TriggerIdentifierArrayOffset;

+} EFI_ACPI_6_3_PLATFORM_DEBUG_TRIGGER_TABLE_HEADER;

+

+///

+/// PDTT Revision (as defined in ACPI 6.3 spec.)

+///

+#define EFI_ACPI_6_3_PLATFORM_DEBUG_TRIGGER_TABLE_REVISION 0x00

+

+///

+/// PDTT Platform Communication Channel Identifier Structure

+///

+typedef struct {

+  UINT16                        SubChannelIdentifer:8;

+  UINT16                        Runtime:1;

+  UINT16                        WaitForCompletion:1;

+  UINT16                        TriggerOrder:1;

+  UINT16                        Reserved:5;

+} EFI_ACPI_6_3_PDTT_PCC_IDENTIFIER;

+

+///

+/// PCC Commands Codes used by Platform Debug Trigger Table

+///

+#define EFI_ACPI_6_3_PDTT_PCC_COMMAND_DOORBELL_ONLY     0x00

+#define EFI_ACPI_6_3_PDTT_PCC_COMMAND_VENDOR_SPECIFIC   0x01

+

+///

+/// PPTT Platform Communication Channel

+///

+typedef EFI_ACPI_6_3_PCCT_GENERIC_SHARED_MEMORY_REGION_HEADER EFI_ACPI_6_3_PDTT_PCC;

+

+///

+/// Processor Properties Topology Table (PPTT)

+///

+typedef struct {

+  EFI_ACPI_DESCRIPTION_HEADER   Header;

+} EFI_ACPI_6_3_PROCESSOR_PROPERTIES_TOPOLOGY_TABLE_HEADER;

+

+///

+/// PPTT Revision (as defined in ACPI 6.3 spec.)

+///

+#define EFI_ACPI_6_3_PROCESSOR_PROPERTIES_TOPOLOGY_TABLE_REVISION 0x02

+

+///

+/// PPTT types

+///

+#define EFI_ACPI_6_3_PPTT_TYPE_PROCESSOR     0x00

+#define EFI_ACPI_6_3_PPTT_TYPE_CACHE         0x01

+#define EFI_ACPI_6_3_PPTT_TYPE_ID            0x02

+

+///

+/// PPTT Structure Header

+///

+typedef struct {

+  UINT8                         Type;

+  UINT8                         Length;

+  UINT8                         Reserved[2];

+} EFI_ACPI_6_3_PPTT_STRUCTURE_HEADER;

+

+///

+/// For PPTT struct processor flags

+///

+#define EFI_ACPI_6_3_PPTT_PACKAGE_NOT_PHYSICAL          0x0

+#define EFI_ACPI_6_3_PPTT_PACKAGE_PHYSICAL              0x1

+#define EFI_ACPI_6_3_PPTT_PROCESSOR_ID_INVALID          0x0

+#define EFI_ACPI_6_3_PPTT_PROCESSOR_ID_VALID            0x1

+#define EFI_ACPI_6_3_PPTT_PROCESSOR_IS_NOT_THREAD       0x0

+#define EFI_ACPI_6_3_PPTT_PROCESSOR_IS_THREAD           0x1

+#define EFI_ACPI_6_3_PPTT_NODE_IS_NOT_LEAF              0x0

+#define EFI_ACPI_6_3_PPTT_NODE_IS_LEAF                  0x1

+#define EFI_ACPI_6_3_PPTT_IMPLEMENTATION_NOT_IDENTICAL  0x0

+#define EFI_ACPI_6_3_PPTT_IMPLEMENTATION_IDENTICAL      0x1

+

+///

+/// Processor hierarchy node structure flags

+///

+typedef struct {

+  UINT32                        PhysicalPackage:1;

+  UINT32                        AcpiProcessorIdValid:1;

+  UINT32                        ProcessorIsAThread:1;

+  UINT32                        NodeIsALeaf:1;

+  UINT32                        IdenticalImplementation:1;

+  UINT32                        Reserved:27;

+} EFI_ACPI_6_3_PPTT_STRUCTURE_PROCESSOR_FLAGS;

+

+///

+/// Processor hierarchy node structure

+///

+typedef struct {

+  UINT8                                         Type;

+  UINT8                                         Length;

+  UINT8                                         Reserved[2];

+  EFI_ACPI_6_3_PPTT_STRUCTURE_PROCESSOR_FLAGS   Flags;

+  UINT32                                        Parent;

+  UINT32                                        AcpiProcessorId;

+  UINT32                                        NumberOfPrivateResources;

+} EFI_ACPI_6_3_PPTT_STRUCTURE_PROCESSOR;

+

+///

+/// For PPTT struct cache flags

+///

+#define EFI_ACPI_6_3_PPTT_CACHE_SIZE_INVALID        0x0

+#define EFI_ACPI_6_3_PPTT_CACHE_SIZE_VALID          0x1

+#define EFI_ACPI_6_3_PPTT_NUMBER_OF_SETS_INVALID    0x0

+#define EFI_ACPI_6_3_PPTT_NUMBER_OF_SETS_VALID      0x1

+#define EFI_ACPI_6_3_PPTT_ASSOCIATIVITY_INVALID     0x0

+#define EFI_ACPI_6_3_PPTT_ASSOCIATIVITY_VALID       0x1

+#define EFI_ACPI_6_3_PPTT_ALLOCATION_TYPE_INVALID   0x0

+#define EFI_ACPI_6_3_PPTT_ALLOCATION_TYPE_VALID     0x1

+#define EFI_ACPI_6_3_PPTT_CACHE_TYPE_INVALID        0x0

+#define EFI_ACPI_6_3_PPTT_CACHE_TYPE_VALID          0x1

+#define EFI_ACPI_6_3_PPTT_WRITE_POLICY_INVALID      0x0

+#define EFI_ACPI_6_3_PPTT_WRITE_POLICY_VALID        0x1

+#define EFI_ACPI_6_3_PPTT_LINE_SIZE_INVALID         0x0

+#define EFI_ACPI_6_3_PPTT_LINE_SIZE_VALID           0x1

+

+///

+/// Cache Type Structure flags

+///

+typedef struct {

+  UINT32                        SizePropertyValid:1;

+  UINT32                        NumberOfSetsValid:1;

+  UINT32                        AssociativityValid:1;

+  UINT32                        AllocationTypeValid:1;

+  UINT32                        CacheTypeValid:1;

+  UINT32                        WritePolicyValid:1;

+  UINT32                        LineSizeValid:1;

+  UINT32                        Reserved:25;

+} EFI_ACPI_6_3_PPTT_STRUCTURE_CACHE_FLAGS;

+

+///

+/// For cache attributes

+///

+#define EFI_ACPI_6_3_CACHE_ATTRIBUTES_ALLOCATION_READ            0x0

+#define EFI_ACPI_6_3_CACHE_ATTRIBUTES_ALLOCATION_WRITE           0x1

+#define EFI_ACPI_6_3_CACHE_ATTRIBUTES_ALLOCATION_READ_WRITE      0x2

+#define EFI_ACPI_6_3_CACHE_ATTRIBUTES_CACHE_TYPE_DATA            0x0

+#define EFI_ACPI_6_3_CACHE_ATTRIBUTES_CACHE_TYPE_INSTRUCTION     0x1

+#define EFI_ACPI_6_3_CACHE_ATTRIBUTES_CACHE_TYPE_UNIFIED         0x2

+#define EFI_ACPI_6_3_CACHE_ATTRIBUTES_WRITE_POLICY_WRITE_BACK    0x0

+#define EFI_ACPI_6_3_CACHE_ATTRIBUTES_WRITE_POLICY_WRITE_THROUGH 0x1

+

+///

+/// Cache Type Structure cache attributes

+///

+typedef struct {

+  UINT8                         AllocationType:2;

+  UINT8                         CacheType:2;

+  UINT8                         WritePolicy:1;

+  UINT8                         Reserved:3;

+} EFI_ACPI_6_3_PPTT_STRUCTURE_CACHE_ATTRIBUTES;

+

+///

+/// Cache Type Structure

+///

+typedef struct {

+  UINT8                                         Type;

+  UINT8                                         Length;

+  UINT8                                         Reserved[2];

+  EFI_ACPI_6_3_PPTT_STRUCTURE_CACHE_FLAGS       Flags;

+  UINT32                                        NextLevelOfCache;

+  UINT32                                        Size;

+  UINT32                                        NumberOfSets;

+  UINT8                                         Associativity;

+  EFI_ACPI_6_3_PPTT_STRUCTURE_CACHE_ATTRIBUTES  Attributes;

+  UINT16                                        LineSize;

+} EFI_ACPI_6_3_PPTT_STRUCTURE_CACHE;

+

+///

+/// ID structure

+///

+typedef struct {

+  UINT8                         Type;

+  UINT8                         Length;

+  UINT8                         Reserved[2];

+  UINT32                        VendorId;

+  UINT64                        Level1Id;

+  UINT64                        Level2Id;

+  UINT16                        MajorRev;

+  UINT16                        MinorRev;

+  UINT16                        SpinRev;

+} EFI_ACPI_6_3_PPTT_STRUCTURE_ID;

+

+//

+// Known table signatures

+//

+

+///

+/// "RSD PTR " Root System Description Pointer

+///

+#define EFI_ACPI_6_3_ROOT_SYSTEM_DESCRIPTION_POINTER_SIGNATURE  SIGNATURE_64('R', 'S', 'D', ' ', 'P', 'T', 'R', ' ')

+

+///

+/// "APIC" Multiple APIC Description Table

+///

+#define EFI_ACPI_6_3_MULTIPLE_APIC_DESCRIPTION_TABLE_SIGNATURE  SIGNATURE_32('A', 'P', 'I', 'C')

+

+///

+/// "BERT" Boot Error Record Table

+///

+#define EFI_ACPI_6_3_BOOT_ERROR_RECORD_TABLE_SIGNATURE  SIGNATURE_32('B', 'E', 'R', 'T')

+

+///

+/// "BGRT" Boot Graphics Resource Table

+///

+#define EFI_ACPI_6_3_BOOT_GRAPHICS_RESOURCE_TABLE_SIGNATURE  SIGNATURE_32('B', 'G', 'R', 'T')

+

+///

+/// "CDIT" Component Distance Information Table

+///

+#define EFI_ACPI_6_3_COMPONENT_DISTANCE_INFORMATION_TABLE_SIGNATURE  SIGNATURE_32('C', 'D', 'I', 'T')

+

+///

+/// "CPEP" Corrected Platform Error Polling Table

+///

+#define EFI_ACPI_6_3_CORRECTED_PLATFORM_ERROR_POLLING_TABLE_SIGNATURE  SIGNATURE_32('C', 'P', 'E', 'P')

+

+///

+/// "CRAT" Component Resource Attribute Table

+///

+#define EFI_ACPI_6_3_COMPONENT_RESOURCE_ATTRIBUTE_TABLE_SIGNATURE  SIGNATURE_32('C', 'R', 'A', 'T')

+

+///

+/// "DSDT" Differentiated System Description Table

+///

+#define EFI_ACPI_6_3_DIFFERENTIATED_SYSTEM_DESCRIPTION_TABLE_SIGNATURE  SIGNATURE_32('D', 'S', 'D', 'T')

+

+///

+/// "ECDT" Embedded Controller Boot Resources Table

+///

+#define EFI_ACPI_6_3_EMBEDDED_CONTROLLER_BOOT_RESOURCES_TABLE_SIGNATURE  SIGNATURE_32('E', 'C', 'D', 'T')

+

+///

+/// "EINJ" Error Injection Table

+///

+#define EFI_ACPI_6_3_ERROR_INJECTION_TABLE_SIGNATURE  SIGNATURE_32('E', 'I', 'N', 'J')

+

+///

+/// "ERST" Error Record Serialization Table

+///

+#define EFI_ACPI_6_3_ERROR_RECORD_SERIALIZATION_TABLE_SIGNATURE  SIGNATURE_32('E', 'R', 'S', 'T')

+

+///

+/// "FACP" Fixed ACPI Description Table

+///

+#define EFI_ACPI_6_3_FIXED_ACPI_DESCRIPTION_TABLE_SIGNATURE  SIGNATURE_32('F', 'A', 'C', 'P')

+

+///

+/// "FACS" Firmware ACPI Control Structure

+///

+#define EFI_ACPI_6_3_FIRMWARE_ACPI_CONTROL_STRUCTURE_SIGNATURE  SIGNATURE_32('F', 'A', 'C', 'S')

+

+///

+/// "FPDT" Firmware Performance Data Table

+///

+#define EFI_ACPI_6_3_FIRMWARE_PERFORMANCE_DATA_TABLE_SIGNATURE  SIGNATURE_32('F', 'P', 'D', 'T')

+

+///

+/// "GTDT" Generic Timer Description Table

+///

+#define EFI_ACPI_6_3_GENERIC_TIMER_DESCRIPTION_TABLE_SIGNATURE  SIGNATURE_32('G', 'T', 'D', 'T')

+

+///

+/// "HEST" Hardware Error Source Table

+///

+#define EFI_ACPI_6_3_HARDWARE_ERROR_SOURCE_TABLE_SIGNATURE  SIGNATURE_32('H', 'E', 'S', 'T')

+

+///

+/// "HMAT" Heterogeneous Memory Attribute Table

+///

+#define EFI_ACPI_6_3_HETEROGENEOUS_MEMORY_ATTRIBUTE_TABLE_SIGNATURE  SIGNATURE_32('H', 'M', 'A', 'T')

+

+///

+/// "MPST" Memory Power State Table

+///

+#define EFI_ACPI_6_3_MEMORY_POWER_STATE_TABLE_SIGNATURE  SIGNATURE_32('M', 'P', 'S', 'T')

+

+///

+/// "MSCT" Maximum System Characteristics Table

+///

+#define EFI_ACPI_6_3_MAXIMUM_SYSTEM_CHARACTERISTICS_TABLE_SIGNATURE  SIGNATURE_32('M', 'S', 'C', 'T')

+

+///

+/// "NFIT" NVDIMM Firmware Interface Table

+///

+#define EFI_ACPI_6_3_NVDIMM_FIRMWARE_INTERFACE_TABLE_STRUCTURE_SIGNATURE  SIGNATURE_32('N', 'F', 'I', 'T')

+

+///

+/// "PDTT" Platform Debug Trigger Table

+///

+#define EFI_ACPI_6_3_PLATFORM_DEBUG_TRIGGER_TABLE_STRUCTURE_SIGNATURE  SIGNATURE_32('P', 'D', 'T', 'T')

+

+///

+/// "PMTT" Platform Memory Topology Table

+///

+#define EFI_ACPI_6_3_PLATFORM_MEMORY_TOPOLOGY_TABLE_SIGNATURE  SIGNATURE_32('P', 'M', 'T', 'T')

+

+///

+/// "PPTT" Processor Properties Topology Table

+///

+#define EFI_ACPI_6_3_PROCESSOR_PROPERTIES_TOPOLOGY_TABLE_STRUCTURE_SIGNATURE  SIGNATURE_32('P', 'P', 'T', 'T')

+

+///

+/// "PSDT" Persistent System Description Table

+///

+#define EFI_ACPI_6_3_PERSISTENT_SYSTEM_DESCRIPTION_TABLE_SIGNATURE  SIGNATURE_32('P', 'S', 'D', 'T')

+

+///

+/// "RASF" ACPI RAS Feature Table

+///

+#define EFI_ACPI_6_3_ACPI_RAS_FEATURE_TABLE_SIGNATURE  SIGNATURE_32('R', 'A', 'S', 'F')

+

+///

+/// "RSDT" Root System Description Table

+///

+#define EFI_ACPI_6_3_ROOT_SYSTEM_DESCRIPTION_TABLE_SIGNATURE  SIGNATURE_32('R', 'S', 'D', 'T')

+

+///

+/// "SBST" Smart Battery Specification Table

+///

+#define EFI_ACPI_6_3_SMART_BATTERY_SPECIFICATION_TABLE_SIGNATURE  SIGNATURE_32('S', 'B', 'S', 'T')

+

+///

+/// "SDEV" Secure DEVices Table

+///

+#define EFI_ACPI_6_3_SECURE_DEVICES_TABLE_SIGNATURE  SIGNATURE_32('S', 'D', 'E', 'V')

+

+///

+/// "SLIT" System Locality Information Table

+///

+#define EFI_ACPI_6_3_SYSTEM_LOCALITY_INFORMATION_TABLE_SIGNATURE  SIGNATURE_32('S', 'L', 'I', 'T')

+

+///

+/// "SRAT" System Resource Affinity Table

+///

+#define EFI_ACPI_6_3_SYSTEM_RESOURCE_AFFINITY_TABLE_SIGNATURE  SIGNATURE_32('S', 'R', 'A', 'T')

+

+///

+/// "SSDT" Secondary System Description Table

+///

+#define EFI_ACPI_6_3_SECONDARY_SYSTEM_DESCRIPTION_TABLE_SIGNATURE  SIGNATURE_32('S', 'S', 'D', 'T')

+

+///

+/// "XSDT" Extended System Description Table

+///

+#define EFI_ACPI_6_3_EXTENDED_SYSTEM_DESCRIPTION_TABLE_SIGNATURE  SIGNATURE_32('X', 'S', 'D', 'T')

+

+///

+/// "BOOT" MS Simple Boot Spec

+///

+#define EFI_ACPI_6_3_SIMPLE_BOOT_FLAG_TABLE_SIGNATURE  SIGNATURE_32('B', 'O', 'O', 'T')

+

+///

+/// "CSRT" MS Core System Resource Table

+///

+#define EFI_ACPI_6_3_CORE_SYSTEM_RESOURCE_TABLE_SIGNATURE  SIGNATURE_32('C', 'S', 'R', 'T')

+

+///

+/// "DBG2" MS Debug Port 2 Spec

+///

+#define EFI_ACPI_6_3_DEBUG_PORT_2_TABLE_SIGNATURE  SIGNATURE_32('D', 'B', 'G', '2')

+

+///

+/// "DBGP" MS Debug Port Spec

+///

+#define EFI_ACPI_6_3_DEBUG_PORT_TABLE_SIGNATURE  SIGNATURE_32('D', 'B', 'G', 'P')

+

+///

+/// "DMAR" DMA Remapping Table

+///

+#define EFI_ACPI_6_3_DMA_REMAPPING_TABLE_SIGNATURE  SIGNATURE_32('D', 'M', 'A', 'R')

+

+///

+/// "DPPT" DMA Protection Policy Table

+///

+#define EFI_ACPI_6_3_DMA_PROTECTION_POLICY_TABLE_SIGNATURE  SIGNATURE_32('D', 'P', 'P', 'T')

+

+///

+/// "DRTM" Dynamic Root of Trust for Measurement Table

+///

+#define EFI_ACPI_6_3_DYNAMIC_ROOT_OF_TRUST_FOR_MEASUREMENT_TABLE_SIGNATURE  SIGNATURE_32('D', 'R', 'T', 'M')

+

+///

+/// "ETDT" Event Timer Description Table

+///

+#define EFI_ACPI_6_3_EVENT_TIMER_DESCRIPTION_TABLE_SIGNATURE  SIGNATURE_32('E', 'T', 'D', 'T')

+

+///

+/// "HPET" IA-PC High Precision Event Timer Table

+///

+#define EFI_ACPI_6_3_HIGH_PRECISION_EVENT_TIMER_TABLE_SIGNATURE  SIGNATURE_32('H', 'P', 'E', 'T')

+

+///

+/// "iBFT" iSCSI Boot Firmware Table

+///

+#define EFI_ACPI_6_3_ISCSI_BOOT_FIRMWARE_TABLE_SIGNATURE  SIGNATURE_32('i', 'B', 'F', 'T')

+

+///

+/// "IORT" I/O Remapping Table

+///

+#define EFI_ACPI_6_3_IO_REMAPPING_TABLE_SIGNATURE  SIGNATURE_32('I', 'O', 'R', 'T')

+

+///

+/// "IVRS" I/O Virtualization Reporting Structure

+///

+#define EFI_ACPI_6_3_IO_VIRTUALIZATION_REPORTING_STRUCTURE_SIGNATURE  SIGNATURE_32('I', 'V', 'R', 'S')

+

+///

+/// "LPIT" Low Power Idle Table

+///

+#define EFI_ACPI_6_3_LOW_POWER_IDLE_TABLE_STRUCTURE_SIGNATURE  SIGNATURE_32('L', 'P', 'I', 'T')

+

+///

+/// "MCFG" PCI Express Memory Mapped Configuration Space Base Address Description Table

+///

+#define EFI_ACPI_6_3_PCI_EXPRESS_MEMORY_MAPPED_CONFIGURATION_SPACE_BASE_ADDRESS_DESCRIPTION_TABLE_SIGNATURE  SIGNATURE_32('M', 'C', 'F', 'G')

+

+///

+/// "MCHI" Management Controller Host Interface Table

+///

+#define EFI_ACPI_6_3_MANAGEMENT_CONTROLLER_HOST_INTERFACE_TABLE_SIGNATURE  SIGNATURE_32('M', 'C', 'H', 'I')

+

+///

+/// "MSDM" MS Data Management Table

+///

+#define EFI_ACPI_6_3_DATA_MANAGEMENT_TABLE_SIGNATURE  SIGNATURE_32('M', 'S', 'D', 'M')

+

+///

+/// "PCCT" Platform Communications Channel Table

+///

+#define EFI_ACPI_6_3_PLATFORM_COMMUNICATIONS_CHANNEL_TABLE_SIGNATURE  SIGNATURE_32('P', 'C', 'C', 'T')

+

+///

+/// "SDEI" Software Delegated Exceptions Interface Table

+///

+#define EFI_ACPI_6_3_SOFTWARE_DELEGATED_EXCEPTIONS_INTERFACE_TABLE_SIGNATURE  SIGNATURE_32('S', 'D', 'E', 'I')

+

+///

+/// "SLIC" MS Software Licensing Table Specification

+///

+#define EFI_ACPI_6_3_SOFTWARE_LICENSING_TABLE_SIGNATURE  SIGNATURE_32('S', 'L', 'I', 'C')

+

+///

+/// "SPCR" Serial Port Concole Redirection Table

+///

+#define EFI_ACPI_6_3_SERIAL_PORT_CONSOLE_REDIRECTION_TABLE_SIGNATURE  SIGNATURE_32('S', 'P', 'C', 'R')

+

+///

+/// "SPMI" Server Platform Management Interface Table

+///

+#define EFI_ACPI_6_3_SERVER_PLATFORM_MANAGEMENT_INTERFACE_TABLE_SIGNATURE  SIGNATURE_32('S', 'P', 'M', 'I')

+

+///

+/// "STAO" _STA Override Table

+///

+#define EFI_ACPI_6_3_STA_OVERRIDE_TABLE_SIGNATURE  SIGNATURE_32('S', 'T', 'A', 'O')

+

+///

+/// "TCPA" Trusted Computing Platform Alliance Capabilities Table

+///

+#define EFI_ACPI_6_3_TRUSTED_COMPUTING_PLATFORM_ALLIANCE_CAPABILITIES_TABLE_SIGNATURE  SIGNATURE_32('T', 'C', 'P', 'A')

+

+///

+/// "TPM2" Trusted Computing Platform 1 Table

+///

+#define EFI_ACPI_6_3_TRUSTED_COMPUTING_PLATFORM_2_TABLE_SIGNATURE  SIGNATURE_32('T', 'P', 'M', '2')

+

+///

+/// "UEFI" UEFI ACPI Data Table

+///

+#define EFI_ACPI_6_3_UEFI_ACPI_DATA_TABLE_SIGNATURE  SIGNATURE_32('U', 'E', 'F', 'I')

+

+///

+/// "WAET" Windows ACPI Emulated Devices Table

+///

+#define EFI_ACPI_6_3_WINDOWS_ACPI_EMULATED_DEVICES_TABLE_SIGNATURE  SIGNATURE_32('W', 'A', 'E', 'T')

+

+///

+/// "WDAT" Watchdog Action Table

+///

+#define EFI_ACPI_6_3_WATCHDOG_ACTION_TABLE_SIGNATURE  SIGNATURE_32('W', 'D', 'A', 'T')

+

+///

+/// "WDRT" Watchdog Resource Table

+///

+#define EFI_ACPI_6_3_WATCHDOG_RESOURCE_TABLE_SIGNATURE  SIGNATURE_32('W', 'D', 'R', 'T')

+

+///

+/// "WPBT" MS Platform Binary Table

+///

+#define EFI_ACPI_6_3_PLATFORM_BINARY_TABLE_SIGNATURE  SIGNATURE_32('W', 'P', 'B', 'T')

+

+///

+/// "WSMT" Windows SMM Security Mitigation Table

+///

+#define EFI_ACPI_6_3_WINDOWS_SMM_SECURITY_MITIGATION_TABLE_SIGNATURE  SIGNATURE_32('W', 'S', 'M', 'T')

+

+///

+/// "XENV" Xen Project Table

+///

+#define EFI_ACPI_6_3_XEN_PROJECT_TABLE_SIGNATURE  SIGNATURE_32('X', 'E', 'N', 'V')

+

+#pragma pack()

+

+#endif

diff --git a/debugging_demo/memtest86+/efi/Include/IndustryStandard/AcpiAml.h b/debugging_demo/memtest86+/efi/Include/IndustryStandard/AcpiAml.h
new file mode 100644
index 0000000..74622e9
--- /dev/null
+++ b/debugging_demo/memtest86+/efi/Include/IndustryStandard/AcpiAml.h
@@ -0,0 +1,179 @@
+/** @file

+  This file contains AML code definition in the latest ACPI spec.

+

+  Copyright (c) 2011, Intel Corporation. All rights reserved.<BR>

+  Copyright (c) 2019, ARM Limited. All rights reserved.<BR>

+  SPDX-License-Identifier: BSD-2-Clause-Patent

+

+**/

+

+#ifndef _ACPI_AML_H_

+#define _ACPI_AML_H_

+

+//

+// ACPI AML definition

+//

+

+//

+// Primary OpCode

+//

+#define AML_ZERO_OP                  0x00

+#define AML_ONE_OP                   0x01

+#define AML_ALIAS_OP                 0x06

+#define AML_NAME_OP                  0x08

+#define AML_BYTE_PREFIX              0x0a

+#define AML_WORD_PREFIX              0x0b

+#define AML_DWORD_PREFIX             0x0c

+#define AML_STRING_PREFIX            0x0d

+#define AML_QWORD_PREFIX             0x0e

+#define AML_SCOPE_OP                 0x10

+#define AML_BUFFER_OP                0x11

+#define AML_PACKAGE_OP               0x12

+#define AML_VAR_PACKAGE_OP           0x13

+#define AML_METHOD_OP                0x14

+#define AML_EXTERNAL_OP              0x15

+#define AML_DUAL_NAME_PREFIX         0x2e

+#define AML_MULTI_NAME_PREFIX        0x2f

+#define AML_NAME_CHAR_A              0x41

+#define AML_NAME_CHAR_B              0x42

+#define AML_NAME_CHAR_C              0x43

+#define AML_NAME_CHAR_D              0x44

+#define AML_NAME_CHAR_E              0x45

+#define AML_NAME_CHAR_F              0x46

+#define AML_NAME_CHAR_G              0x47

+#define AML_NAME_CHAR_H              0x48

+#define AML_NAME_CHAR_I              0x49

+#define AML_NAME_CHAR_J              0x4a

+#define AML_NAME_CHAR_K              0x4b

+#define AML_NAME_CHAR_L              0x4c

+#define AML_NAME_CHAR_M              0x4d

+#define AML_NAME_CHAR_N              0x4e

+#define AML_NAME_CHAR_O              0x4f

+#define AML_NAME_CHAR_P              0x50

+#define AML_NAME_CHAR_Q              0x51

+#define AML_NAME_CHAR_R              0x52

+#define AML_NAME_CHAR_S              0x53

+#define AML_NAME_CHAR_T              0x54

+#define AML_NAME_CHAR_U              0x55

+#define AML_NAME_CHAR_V              0x56

+#define AML_NAME_CHAR_W              0x57

+#define AML_NAME_CHAR_X              0x58

+#define AML_NAME_CHAR_Y              0x59

+#define AML_NAME_CHAR_Z              0x5a

+#define AML_ROOT_CHAR                0x5c

+#define AML_PARENT_PREFIX_CHAR       0x5e

+#define AML_NAME_CHAR__              0x5f

+#define AML_LOCAL0                   0x60

+#define AML_LOCAL1                   0x61

+#define AML_LOCAL2                   0x62

+#define AML_LOCAL3                   0x63

+#define AML_LOCAL4                   0x64

+#define AML_LOCAL5                   0x65

+#define AML_LOCAL6                   0x66

+#define AML_LOCAL7                   0x67

+#define AML_ARG0                     0x68

+#define AML_ARG1                     0x69

+#define AML_ARG2                     0x6a

+#define AML_ARG3                     0x6b

+#define AML_ARG4                     0x6c

+#define AML_ARG5                     0x6d

+#define AML_ARG6                     0x6e

+#define AML_STORE_OP                 0x70

+#define AML_REF_OF_OP                0x71

+#define AML_ADD_OP                   0x72

+#define AML_CONCAT_OP                0x73

+#define AML_SUBTRACT_OP              0x74

+#define AML_INCREMENT_OP             0x75

+#define AML_DECREMENT_OP             0x76

+#define AML_MULTIPLY_OP              0x77

+#define AML_DIVIDE_OP                0x78

+#define AML_SHIFT_LEFT_OP            0x79

+#define AML_SHIFT_RIGHT_OP           0x7a

+#define AML_AND_OP                   0x7b

+#define AML_NAND_OP                  0x7c

+#define AML_OR_OP                    0x7d

+#define AML_NOR_OP                   0x7e

+#define AML_XOR_OP                   0x7f

+#define AML_NOT_OP                   0x80

+#define AML_FIND_SET_LEFT_BIT_OP     0x81

+#define AML_FIND_SET_RIGHT_BIT_OP    0x82

+#define AML_DEREF_OF_OP              0x83

+#define AML_CONCAT_RES_OP            0x84

+#define AML_MOD_OP                   0x85

+#define AML_NOTIFY_OP                0x86

+#define AML_SIZE_OF_OP               0x87

+#define AML_INDEX_OP                 0x88

+#define AML_MATCH_OP                 0x89

+#define AML_CREATE_DWORD_FIELD_OP    0x8a

+#define AML_CREATE_WORD_FIELD_OP     0x8b

+#define AML_CREATE_BYTE_FIELD_OP     0x8c

+#define AML_CREATE_BIT_FIELD_OP      0x8d

+#define AML_OBJECT_TYPE_OP           0x8e

+#define AML_CREATE_QWORD_FIELD_OP    0x8f

+#define AML_LAND_OP                  0x90

+#define AML_LOR_OP                   0x91

+#define AML_LNOT_OP                  0x92

+#define AML_LEQUAL_OP                0x93

+#define AML_LGREATER_OP              0x94

+#define AML_LLESS_OP                 0x95

+#define AML_TO_BUFFER_OP             0x96

+#define AML_TO_DEC_STRING_OP         0x97

+#define AML_TO_HEX_STRING_OP         0x98

+#define AML_TO_INTEGER_OP            0x99

+#define AML_TO_STRING_OP             0x9c

+#define AML_COPY_OBJECT_OP           0x9d

+#define AML_MID_OP                   0x9e

+#define AML_CONTINUE_OP              0x9f

+#define AML_IF_OP                    0xa0

+#define AML_ELSE_OP                  0xa1

+#define AML_WHILE_OP                 0xa2

+#define AML_NOOP_OP                  0xa3

+#define AML_RETURN_OP                0xa4

+#define AML_BREAK_OP                 0xa5

+#define AML_BREAK_POINT_OP           0xcc

+#define AML_ONES_OP                  0xff

+

+//

+// Extended OpCode

+//

+#define AML_EXT_OP                   0x5b

+

+#define AML_EXT_MUTEX_OP             0x01

+#define AML_EXT_EVENT_OP             0x02

+#define AML_EXT_COND_REF_OF_OP       0x12

+#define AML_EXT_CREATE_FIELD_OP      0x13

+#define AML_EXT_LOAD_TABLE_OP        0x1f

+#define AML_EXT_LOAD_OP              0x20

+#define AML_EXT_STALL_OP             0x21

+#define AML_EXT_SLEEP_OP             0x22

+#define AML_EXT_ACQUIRE_OP           0x23

+#define AML_EXT_SIGNAL_OP            0x24

+#define AML_EXT_WAIT_OP              0x25

+#define AML_EXT_RESET_OP             0x26

+#define AML_EXT_RELEASE_OP           0x27

+#define AML_EXT_FROM_BCD_OP          0x28

+#define AML_EXT_TO_BCD_OP            0x29

+#define AML_EXT_UNLOAD_OP            0x2a

+#define AML_EXT_REVISION_OP          0x30

+#define AML_EXT_DEBUG_OP             0x31

+#define AML_EXT_FATAL_OP             0x32

+#define AML_EXT_TIMER_OP             0x33

+#define AML_EXT_REGION_OP            0x80

+#define AML_EXT_FIELD_OP             0x81

+#define AML_EXT_DEVICE_OP            0x82

+#define AML_EXT_PROCESSOR_OP         0x83

+#define AML_EXT_POWER_RES_OP         0x84

+#define AML_EXT_THERMAL_ZONE_OP      0x85

+#define AML_EXT_INDEX_FIELD_OP       0x86

+#define AML_EXT_BANK_FIELD_OP        0x87

+#define AML_EXT_DATA_REGION_OP       0x88

+

+//

+// FieldElement OpCode

+//

+#define AML_FIELD_RESERVED_OP        0x00

+#define AML_FIELD_ACCESS_OP          0x01

+#define AML_FIELD_CONNECTION_OP      0x02

+#define AML_FIELD_EXT_ACCESS_OP      0x03

+

+#endif

diff --git a/debugging_demo/memtest86+/efi/Include/IndustryStandard/Bluetooth.h b/debugging_demo/memtest86+/efi/Include/IndustryStandard/Bluetooth.h
new file mode 100644
index 0000000..7597f76
--- /dev/null
+++ b/debugging_demo/memtest86+/efi/Include/IndustryStandard/Bluetooth.h
@@ -0,0 +1,56 @@
+/** @file

+  This file contains the Bluetooth definitions that are consumed by drivers.

+  These definitions are from Bluetooth Core Specification Version 4.0 June, 2010

+

+  Copyright (c) 2015 - 2017, Intel Corporation. All rights reserved.<BR>

+  SPDX-License-Identifier: BSD-2-Clause-Patent

+

+**/

+

+#ifndef _BLUETOOTH_H_

+#define _BLUETOOTH_H_

+

+#pragma pack(1)

+

+///

+/// BLUETOOTH_ADDRESS

+///

+typedef struct {

+  ///

+  /// 48bit Bluetooth device address.

+  ///

+  UINT8      Address[6];

+} BLUETOOTH_ADDRESS;

+

+///

+/// BLUETOOTH_CLASS_OF_DEVICE. See Bluetooth specification for detail.

+///

+typedef struct {

+  UINT8      FormatType:2;

+  UINT8      MinorDeviceClass: 6;

+  UINT16     MajorDeviceClass: 5;

+  UINT16     MajorServiceClass:11;

+} BLUETOOTH_CLASS_OF_DEVICE;

+

+///

+/// BLUETOOTH_LE_ADDRESS

+///

+typedef struct {

+  ///

+  /// 48-bit Bluetooth device address

+  ///

+  UINT8      Address[6];

+  ///

+  /// 0x00 - Public Device Address

+  /// 0x01 - Random Device Address

+  ///

+  UINT8      Type;

+} BLUETOOTH_LE_ADDRESS;

+

+#pragma pack()

+

+#define BLUETOOTH_HCI_COMMAND_LOCAL_READABLE_NAME_MAX_SIZE    248

+

+#define BLUETOOTH_HCI_LINK_KEY_SIZE                           16

+

+#endif

diff --git a/debugging_demo/memtest86+/efi/Include/Library/BaseLib.h b/debugging_demo/memtest86+/efi/Include/Library/BaseLib.h
new file mode 100644
index 0000000..8e7b87c
--- /dev/null
+++ b/debugging_demo/memtest86+/efi/Include/Library/BaseLib.h
@@ -0,0 +1,7877 @@
+/** @file

+  Provides string functions, linked list functions, math functions, synchronization

+  functions, file path functions, and CPU architecture-specific functions.

+

+Copyright (c) 2006 - 2019, Intel Corporation. All rights reserved.<BR>

+Portions copyright (c) 2008 - 2009, Apple Inc. All rights reserved.<BR>

+Copyright (c) Microsoft Corporation.<BR>

+Portions Copyright (c) 2020, Hewlett Packard Enterprise Development LP. All rights reserved.<BR>

+

+SPDX-License-Identifier: BSD-2-Clause-Patent

+

+**/

+

+#ifndef __BASE_LIB__

+#define __BASE_LIB__

+

+//

+// Definitions for architecture-specific types

+//

+#if   defined (MDE_CPU_IA32)

+///

+/// The IA-32 architecture context buffer used by SetJump() and LongJump().

+///

+typedef struct {

+  UINT32                            Ebx;

+  UINT32                            Esi;

+  UINT32                            Edi;

+  UINT32                            Ebp;

+  UINT32                            Esp;

+  UINT32                            Eip;

+  UINT32                            Ssp;

+} BASE_LIBRARY_JUMP_BUFFER;

+

+#define BASE_LIBRARY_JUMP_BUFFER_ALIGNMENT 4

+

+#endif // defined (MDE_CPU_IA32)

+

+#if defined (MDE_CPU_X64)

+///

+/// The x64 architecture context buffer used by SetJump() and LongJump().

+///

+typedef struct {

+  UINT64                            Rbx;

+  UINT64                            Rsp;

+  UINT64                            Rbp;

+  UINT64                            Rdi;

+  UINT64                            Rsi;

+  UINT64                            R12;

+  UINT64                            R13;

+  UINT64                            R14;

+  UINT64                            R15;

+  UINT64                            Rip;

+  UINT64                            MxCsr;

+  UINT8                             XmmBuffer[160]; ///< XMM6-XMM15.

+  UINT64                            Ssp;

+} BASE_LIBRARY_JUMP_BUFFER;

+

+#define BASE_LIBRARY_JUMP_BUFFER_ALIGNMENT 8

+

+#endif // defined (MDE_CPU_X64)

+

+#if defined (MDE_CPU_EBC)

+///

+/// The EBC context buffer used by SetJump() and LongJump().

+///

+typedef struct {

+  UINT64                            R0;

+  UINT64                            R1;

+  UINT64                            R2;

+  UINT64                            R3;

+  UINT64                            IP;

+} BASE_LIBRARY_JUMP_BUFFER;

+

+#define BASE_LIBRARY_JUMP_BUFFER_ALIGNMENT 8

+

+#endif // defined (MDE_CPU_EBC)

+

+#if defined (MDE_CPU_ARM)

+

+typedef struct {

+  UINT32    R3;  ///< A copy of R13.

+  UINT32    R4;

+  UINT32    R5;

+  UINT32    R6;

+  UINT32    R7;

+  UINT32    R8;

+  UINT32    R9;

+  UINT32    R10;

+  UINT32    R11;

+  UINT32    R12;

+  UINT32    R14;

+} BASE_LIBRARY_JUMP_BUFFER;

+

+#define BASE_LIBRARY_JUMP_BUFFER_ALIGNMENT 4

+

+#endif  // defined (MDE_CPU_ARM)

+

+#if defined (MDE_CPU_AARCH64)

+typedef struct {

+  // GP regs

+  UINT64    X19;

+  UINT64    X20;

+  UINT64    X21;

+  UINT64    X22;

+  UINT64    X23;

+  UINT64    X24;

+  UINT64    X25;

+  UINT64    X26;

+  UINT64    X27;

+  UINT64    X28;

+  UINT64    FP;

+  UINT64    LR;

+  UINT64    IP0;

+

+  // FP regs

+  UINT64    D8;

+  UINT64    D9;

+  UINT64    D10;

+  UINT64    D11;

+  UINT64    D12;

+  UINT64    D13;

+  UINT64    D14;

+  UINT64    D15;

+} BASE_LIBRARY_JUMP_BUFFER;

+

+#define BASE_LIBRARY_JUMP_BUFFER_ALIGNMENT 8

+

+#endif  // defined (MDE_CPU_AARCH64)

+

+#if defined (MDE_CPU_RISCV64)

+///

+/// The RISC-V architecture context buffer used by SetJump() and LongJump().

+///

+typedef struct {

+  UINT64                            RA;

+  UINT64                            S0;

+  UINT64                            S1;

+  UINT64                            S2;

+  UINT64                            S3;

+  UINT64                            S4;

+  UINT64                            S5;

+  UINT64                            S6;

+  UINT64                            S7;

+  UINT64                            S8;

+  UINT64                            S9;

+  UINT64                            S10;

+  UINT64                            S11;

+  UINT64                            SP;

+} BASE_LIBRARY_JUMP_BUFFER;

+

+#define BASE_LIBRARY_JUMP_BUFFER_ALIGNMENT 8

+

+#endif // defined (MDE_CPU_RISCV64)

+

+//

+// String Services

+//

+

+

+/**

+  Returns the length of a Null-terminated Unicode string.

+

+  This function is similar as strlen_s defined in C11.

+

+  If String is not aligned on a 16-bit boundary, then ASSERT().

+

+  @param  String   A pointer to a Null-terminated Unicode string.

+  @param  MaxSize  The maximum number of Destination Unicode

+                   char, including terminating null char.

+

+  @retval 0        If String is NULL.

+  @retval MaxSize  If there is no null character in the first MaxSize characters of String.

+  @return The number of characters that percede the terminating null character.

+

+**/

+UINTN

+EFIAPI

+StrnLenS (

+  IN CONST CHAR16              *String,

+  IN UINTN                     MaxSize

+  );

+

+/**

+  Returns the size of a Null-terminated Unicode string in bytes, including the

+  Null terminator.

+

+  This function returns the size of the Null-terminated Unicode string

+  specified by String in bytes, including the Null terminator.

+

+  If String is not aligned on a 16-bit boundary, then ASSERT().

+

+  @param  String   A pointer to a Null-terminated Unicode string.

+  @param  MaxSize  The maximum number of Destination Unicode

+                   char, including the Null terminator.

+

+  @retval 0  If String is NULL.

+  @retval (sizeof (CHAR16) * (MaxSize + 1))

+             If there is no Null terminator in the first MaxSize characters of

+             String.

+  @return The size of the Null-terminated Unicode string in bytes, including

+          the Null terminator.

+

+**/

+UINTN

+EFIAPI

+StrnSizeS (

+  IN CONST CHAR16              *String,

+  IN UINTN                     MaxSize

+  );

+

+/**

+  Copies the string pointed to by Source (including the terminating null char)

+  to the array pointed to by Destination.

+

+  This function is similar as strcpy_s defined in C11.

+

+  If Destination is not aligned on a 16-bit boundary, then ASSERT().

+  If Source is not aligned on a 16-bit boundary, then ASSERT().

+

+  If an error is returned, then the Destination is unmodified.

+

+  @param  Destination              A pointer to a Null-terminated Unicode string.

+  @param  DestMax                  The maximum number of Destination Unicode

+                                   char, including terminating null char.

+  @param  Source                   A pointer to a Null-terminated Unicode string.

+

+  @retval RETURN_SUCCESS           String is copied.

+  @retval RETURN_BUFFER_TOO_SMALL  If DestMax is NOT greater than StrLen(Source).

+  @retval RETURN_INVALID_PARAMETER If Destination is NULL.

+                                   If Source is NULL.

+                                   If PcdMaximumUnicodeStringLength is not zero,

+                                    and DestMax is greater than

+                                    PcdMaximumUnicodeStringLength.

+                                   If DestMax is 0.

+  @retval RETURN_ACCESS_DENIED     If Source and Destination overlap.

+**/

+RETURN_STATUS

+EFIAPI

+StrCpyS (

+  OUT CHAR16       *Destination,

+  IN  UINTN        DestMax,

+  IN  CONST CHAR16 *Source

+  );

+

+/**

+  Copies not more than Length successive char from the string pointed to by

+  Source to the array pointed to by Destination. If no null char is copied from

+  Source, then Destination[Length] is always set to null.

+

+  This function is similar as strncpy_s defined in C11.

+

+  If Length > 0 and Destination is not aligned on a 16-bit boundary, then ASSERT().

+  If Length > 0 and Source is not aligned on a 16-bit boundary, then ASSERT().

+

+  If an error is returned, then the Destination is unmodified.

+

+  @param  Destination              A pointer to a Null-terminated Unicode string.

+  @param  DestMax                  The maximum number of Destination Unicode

+                                   char, including terminating null char.

+  @param  Source                   A pointer to a Null-terminated Unicode string.

+  @param  Length                   The maximum number of Unicode characters to copy.

+

+  @retval RETURN_SUCCESS           String is copied.

+  @retval RETURN_BUFFER_TOO_SMALL  If DestMax is NOT greater than

+                                   MIN(StrLen(Source), Length).

+  @retval RETURN_INVALID_PARAMETER If Destination is NULL.

+                                   If Source is NULL.

+                                   If PcdMaximumUnicodeStringLength is not zero,

+                                    and DestMax is greater than

+                                    PcdMaximumUnicodeStringLength.

+                                   If DestMax is 0.

+  @retval RETURN_ACCESS_DENIED     If Source and Destination overlap.

+**/

+RETURN_STATUS

+EFIAPI

+StrnCpyS (

+  OUT CHAR16       *Destination,

+  IN  UINTN        DestMax,

+  IN  CONST CHAR16 *Source,

+  IN  UINTN        Length

+  );

+

+/**

+  Appends a copy of the string pointed to by Source (including the terminating

+  null char) to the end of the string pointed to by Destination.

+

+  This function is similar as strcat_s defined in C11.

+

+  If Destination is not aligned on a 16-bit boundary, then ASSERT().

+  If Source is not aligned on a 16-bit boundary, then ASSERT().

+

+  If an error is returned, then the Destination is unmodified.

+

+  @param  Destination              A pointer to a Null-terminated Unicode string.

+  @param  DestMax                  The maximum number of Destination Unicode

+                                   char, including terminating null char.

+  @param  Source                   A pointer to a Null-terminated Unicode string.

+

+  @retval RETURN_SUCCESS           String is appended.

+  @retval RETURN_BAD_BUFFER_SIZE   If DestMax is NOT greater than

+                                   StrLen(Destination).

+  @retval RETURN_BUFFER_TOO_SMALL  If (DestMax - StrLen(Destination)) is NOT

+                                   greater than StrLen(Source).

+  @retval RETURN_INVALID_PARAMETER If Destination is NULL.

+                                   If Source is NULL.

+                                   If PcdMaximumUnicodeStringLength is not zero,

+                                    and DestMax is greater than

+                                    PcdMaximumUnicodeStringLength.

+                                   If DestMax is 0.

+  @retval RETURN_ACCESS_DENIED     If Source and Destination overlap.

+**/

+RETURN_STATUS

+EFIAPI

+StrCatS (

+  IN OUT CHAR16       *Destination,

+  IN     UINTN        DestMax,

+  IN     CONST CHAR16 *Source

+  );

+

+/**

+  Appends not more than Length successive char from the string pointed to by

+  Source to the end of the string pointed to by Destination. If no null char is

+  copied from Source, then Destination[StrLen(Destination) + Length] is always

+  set to null.

+

+  This function is similar as strncat_s defined in C11.

+

+  If Destination is not aligned on a 16-bit boundary, then ASSERT().

+  If Source is not aligned on a 16-bit boundary, then ASSERT().

+

+  If an error is returned, then the Destination is unmodified.

+

+  @param  Destination              A pointer to a Null-terminated Unicode string.

+  @param  DestMax                  The maximum number of Destination Unicode

+                                   char, including terminating null char.

+  @param  Source                   A pointer to a Null-terminated Unicode string.

+  @param  Length                   The maximum number of Unicode characters to copy.

+

+  @retval RETURN_SUCCESS           String is appended.

+  @retval RETURN_BAD_BUFFER_SIZE   If DestMax is NOT greater than

+                                   StrLen(Destination).

+  @retval RETURN_BUFFER_TOO_SMALL  If (DestMax - StrLen(Destination)) is NOT

+                                   greater than MIN(StrLen(Source), Length).

+  @retval RETURN_INVALID_PARAMETER If Destination is NULL.

+                                   If Source is NULL.

+                                   If PcdMaximumUnicodeStringLength is not zero,

+                                    and DestMax is greater than

+                                    PcdMaximumUnicodeStringLength.

+                                   If DestMax is 0.

+  @retval RETURN_ACCESS_DENIED     If Source and Destination overlap.

+**/

+RETURN_STATUS

+EFIAPI

+StrnCatS (

+  IN OUT CHAR16       *Destination,

+  IN     UINTN        DestMax,

+  IN     CONST CHAR16 *Source,

+  IN     UINTN        Length

+  );

+

+/**

+  Convert a Null-terminated Unicode decimal string to a value of type UINTN.

+

+  This function outputs a value of type UINTN by interpreting the contents of

+  the Unicode string specified by String as a decimal number. The format of the

+  input Unicode string String is:

+

+                  [spaces] [decimal digits].

+

+  The valid decimal digit character is in the range [0-9]. The function will

+  ignore the pad space, which includes spaces or tab characters, before

+  [decimal digits]. The running zero in the beginning of [decimal digits] will

+  be ignored. Then, the function stops at the first character that is a not a

+  valid decimal character or a Null-terminator, whichever one comes first.

+

+  If String is not aligned in a 16-bit boundary, then ASSERT().

+

+  If String has no valid decimal digits in the above format, then 0 is stored

+  at the location pointed to by Data.

+  If the number represented by String exceeds the range defined by UINTN, then

+  MAX_UINTN is stored at the location pointed to by Data.

+

+  If EndPointer is not NULL, a pointer to the character that stopped the scan

+  is stored at the location pointed to by EndPointer. If String has no valid

+  decimal digits right after the optional pad spaces, the value of String is

+  stored at the location pointed to by EndPointer.

+

+  @param  String                   Pointer to a Null-terminated Unicode string.

+  @param  EndPointer               Pointer to character that stops scan.

+  @param  Data                     Pointer to the converted value.

+

+  @retval RETURN_SUCCESS           Value is translated from String.

+  @retval RETURN_INVALID_PARAMETER If String is NULL.

+                                   If Data is NULL.

+                                   If PcdMaximumUnicodeStringLength is not

+                                   zero, and String contains more than

+                                   PcdMaximumUnicodeStringLength Unicode

+                                   characters, not including the

+                                   Null-terminator.

+  @retval RETURN_UNSUPPORTED       If the number represented by String exceeds

+                                   the range defined by UINTN.

+

+**/

+RETURN_STATUS

+EFIAPI

+StrDecimalToUintnS (

+  IN  CONST CHAR16             *String,

+  OUT       CHAR16             **EndPointer,  OPTIONAL

+  OUT       UINTN              *Data

+  );

+

+/**

+  Convert a Null-terminated Unicode decimal string to a value of type UINT64.

+

+  This function outputs a value of type UINT64 by interpreting the contents of

+  the Unicode string specified by String as a decimal number. The format of the

+  input Unicode string String is:

+

+                  [spaces] [decimal digits].

+

+  The valid decimal digit character is in the range [0-9]. The function will

+  ignore the pad space, which includes spaces or tab characters, before

+  [decimal digits]. The running zero in the beginning of [decimal digits] will

+  be ignored. Then, the function stops at the first character that is a not a

+  valid decimal character or a Null-terminator, whichever one comes first.

+

+  If String is not aligned in a 16-bit boundary, then ASSERT().

+

+  If String has no valid decimal digits in the above format, then 0 is stored

+  at the location pointed to by Data.

+  If the number represented by String exceeds the range defined by UINT64, then

+  MAX_UINT64 is stored at the location pointed to by Data.

+

+  If EndPointer is not NULL, a pointer to the character that stopped the scan

+  is stored at the location pointed to by EndPointer. If String has no valid

+  decimal digits right after the optional pad spaces, the value of String is

+  stored at the location pointed to by EndPointer.

+

+  @param  String                   Pointer to a Null-terminated Unicode string.

+  @param  EndPointer               Pointer to character that stops scan.

+  @param  Data                     Pointer to the converted value.

+

+  @retval RETURN_SUCCESS           Value is translated from String.

+  @retval RETURN_INVALID_PARAMETER If String is NULL.

+                                   If Data is NULL.

+                                   If PcdMaximumUnicodeStringLength is not

+                                   zero, and String contains more than

+                                   PcdMaximumUnicodeStringLength Unicode

+                                   characters, not including the

+                                   Null-terminator.

+  @retval RETURN_UNSUPPORTED       If the number represented by String exceeds

+                                   the range defined by UINT64.

+

+**/

+RETURN_STATUS

+EFIAPI

+StrDecimalToUint64S (

+  IN  CONST CHAR16             *String,

+  OUT       CHAR16             **EndPointer,  OPTIONAL

+  OUT       UINT64             *Data

+  );

+

+/**

+  Convert a Null-terminated Unicode hexadecimal string to a value of type

+  UINTN.

+

+  This function outputs a value of type UINTN by interpreting the contents of

+  the Unicode string specified by String as a hexadecimal number. The format of

+  the input Unicode string String is:

+

+                  [spaces][zeros][x][hexadecimal digits].

+

+  The valid hexadecimal digit character is in the range [0-9], [a-f] and [A-F].

+  The prefix "0x" is optional. Both "x" and "X" is allowed in "0x" prefix.

+  If "x" appears in the input string, it must be prefixed with at least one 0.

+  The function will ignore the pad space, which includes spaces or tab

+  characters, before [zeros], [x] or [hexadecimal digit]. The running zero

+  before [x] or [hexadecimal digit] will be ignored. Then, the decoding starts

+  after [x] or the first valid hexadecimal digit. Then, the function stops at

+  the first character that is a not a valid hexadecimal character or NULL,

+  whichever one comes first.

+

+  If String is not aligned in a 16-bit boundary, then ASSERT().

+

+  If String has no valid hexadecimal digits in the above format, then 0 is

+  stored at the location pointed to by Data.

+  If the number represented by String exceeds the range defined by UINTN, then

+  MAX_UINTN is stored at the location pointed to by Data.

+

+  If EndPointer is not NULL, a pointer to the character that stopped the scan

+  is stored at the location pointed to by EndPointer. If String has no valid

+  hexadecimal digits right after the optional pad spaces, the value of String

+  is stored at the location pointed to by EndPointer.

+

+  @param  String                   Pointer to a Null-terminated Unicode string.

+  @param  EndPointer               Pointer to character that stops scan.

+  @param  Data                     Pointer to the converted value.

+

+  @retval RETURN_SUCCESS           Value is translated from String.

+  @retval RETURN_INVALID_PARAMETER If String is NULL.

+                                   If Data is NULL.

+                                   If PcdMaximumUnicodeStringLength is not

+                                   zero, and String contains more than

+                                   PcdMaximumUnicodeStringLength Unicode

+                                   characters, not including the

+                                   Null-terminator.

+  @retval RETURN_UNSUPPORTED       If the number represented by String exceeds

+                                   the range defined by UINTN.

+

+**/

+RETURN_STATUS

+EFIAPI

+StrHexToUintnS (

+  IN  CONST CHAR16             *String,

+  OUT       CHAR16             **EndPointer,  OPTIONAL

+  OUT       UINTN              *Data

+  );

+

+/**

+  Convert a Null-terminated Unicode hexadecimal string to a value of type

+  UINT64.

+

+  This function outputs a value of type UINT64 by interpreting the contents of

+  the Unicode string specified by String as a hexadecimal number. The format of

+  the input Unicode string String is:

+

+                  [spaces][zeros][x][hexadecimal digits].

+

+  The valid hexadecimal digit character is in the range [0-9], [a-f] and [A-F].

+  The prefix "0x" is optional. Both "x" and "X" is allowed in "0x" prefix.

+  If "x" appears in the input string, it must be prefixed with at least one 0.

+  The function will ignore the pad space, which includes spaces or tab

+  characters, before [zeros], [x] or [hexadecimal digit]. The running zero

+  before [x] or [hexadecimal digit] will be ignored. Then, the decoding starts

+  after [x] or the first valid hexadecimal digit. Then, the function stops at

+  the first character that is a not a valid hexadecimal character or NULL,

+  whichever one comes first.

+

+  If String is not aligned in a 16-bit boundary, then ASSERT().

+

+  If String has no valid hexadecimal digits in the above format, then 0 is

+  stored at the location pointed to by Data.

+  If the number represented by String exceeds the range defined by UINT64, then

+  MAX_UINT64 is stored at the location pointed to by Data.

+

+  If EndPointer is not NULL, a pointer to the character that stopped the scan

+  is stored at the location pointed to by EndPointer. If String has no valid

+  hexadecimal digits right after the optional pad spaces, the value of String

+  is stored at the location pointed to by EndPointer.

+

+  @param  String                   Pointer to a Null-terminated Unicode string.

+  @param  EndPointer               Pointer to character that stops scan.

+  @param  Data                     Pointer to the converted value.

+

+  @retval RETURN_SUCCESS           Value is translated from String.

+  @retval RETURN_INVALID_PARAMETER If String is NULL.

+                                   If Data is NULL.

+                                   If PcdMaximumUnicodeStringLength is not

+                                   zero, and String contains more than

+                                   PcdMaximumUnicodeStringLength Unicode

+                                   characters, not including the

+                                   Null-terminator.

+  @retval RETURN_UNSUPPORTED       If the number represented by String exceeds

+                                   the range defined by UINT64.

+

+**/

+RETURN_STATUS

+EFIAPI

+StrHexToUint64S (

+  IN  CONST CHAR16             *String,

+  OUT       CHAR16             **EndPointer,  OPTIONAL

+  OUT       UINT64             *Data

+  );

+

+/**

+  Returns the length of a Null-terminated Ascii string.

+

+  This function is similar as strlen_s defined in C11.

+

+  @param  String   A pointer to a Null-terminated Ascii string.

+  @param  MaxSize  The maximum number of Destination Ascii

+                   char, including terminating null char.

+

+  @retval 0        If String is NULL.

+  @retval MaxSize  If there is no null character in the first MaxSize characters of String.

+  @return The number of characters that percede the terminating null character.

+

+**/

+UINTN

+EFIAPI

+AsciiStrnLenS (

+  IN CONST CHAR8               *String,

+  IN UINTN                     MaxSize

+  );

+

+/**

+  Returns the size of a Null-terminated Ascii string in bytes, including the

+  Null terminator.

+

+  This function returns the size of the Null-terminated Ascii string specified

+  by String in bytes, including the Null terminator.

+

+  @param  String   A pointer to a Null-terminated Ascii string.

+  @param  MaxSize  The maximum number of Destination Ascii

+                   char, including the Null terminator.

+

+  @retval 0  If String is NULL.

+  @retval (sizeof (CHAR8) * (MaxSize + 1))

+             If there is no Null terminator in the first MaxSize characters of

+             String.

+  @return The size of the Null-terminated Ascii string in bytes, including the

+          Null terminator.

+

+**/

+UINTN

+EFIAPI

+AsciiStrnSizeS (

+  IN CONST CHAR8               *String,

+  IN UINTN                     MaxSize

+  );

+

+/**

+  Copies the string pointed to by Source (including the terminating null char)

+  to the array pointed to by Destination.

+

+  This function is similar as strcpy_s defined in C11.

+

+  If an error is returned, then the Destination is unmodified.

+

+  @param  Destination              A pointer to a Null-terminated Ascii string.

+  @param  DestMax                  The maximum number of Destination Ascii

+                                   char, including terminating null char.

+  @param  Source                   A pointer to a Null-terminated Ascii string.

+

+  @retval RETURN_SUCCESS           String is copied.

+  @retval RETURN_BUFFER_TOO_SMALL  If DestMax is NOT greater than StrLen(Source).

+  @retval RETURN_INVALID_PARAMETER If Destination is NULL.

+                                   If Source is NULL.

+                                   If PcdMaximumAsciiStringLength is not zero,

+                                    and DestMax is greater than

+                                    PcdMaximumAsciiStringLength.

+                                   If DestMax is 0.

+  @retval RETURN_ACCESS_DENIED     If Source and Destination overlap.

+**/

+RETURN_STATUS

+EFIAPI

+AsciiStrCpyS (

+  OUT CHAR8        *Destination,

+  IN  UINTN        DestMax,

+  IN  CONST CHAR8  *Source

+  );

+

+/**

+  Copies not more than Length successive char from the string pointed to by

+  Source to the array pointed to by Destination. If no null char is copied from

+  Source, then Destination[Length] is always set to null.

+

+  This function is similar as strncpy_s defined in C11.

+

+  If an error is returned, then the Destination is unmodified.

+

+  @param  Destination              A pointer to a Null-terminated Ascii string.

+  @param  DestMax                  The maximum number of Destination Ascii

+                                   char, including terminating null char.

+  @param  Source                   A pointer to a Null-terminated Ascii string.

+  @param  Length                   The maximum number of Ascii characters to copy.

+

+  @retval RETURN_SUCCESS           String is copied.

+  @retval RETURN_BUFFER_TOO_SMALL  If DestMax is NOT greater than

+                                   MIN(StrLen(Source), Length).

+  @retval RETURN_INVALID_PARAMETER If Destination is NULL.

+                                   If Source is NULL.

+                                   If PcdMaximumAsciiStringLength is not zero,

+                                    and DestMax is greater than

+                                    PcdMaximumAsciiStringLength.

+                                   If DestMax is 0.

+  @retval RETURN_ACCESS_DENIED     If Source and Destination overlap.

+**/

+RETURN_STATUS

+EFIAPI

+AsciiStrnCpyS (

+  OUT CHAR8        *Destination,

+  IN  UINTN        DestMax,

+  IN  CONST CHAR8  *Source,

+  IN  UINTN        Length

+  );

+

+/**

+  Appends a copy of the string pointed to by Source (including the terminating

+  null char) to the end of the string pointed to by Destination.

+

+  This function is similar as strcat_s defined in C11.

+

+  If an error is returned, then the Destination is unmodified.

+

+  @param  Destination              A pointer to a Null-terminated Ascii string.

+  @param  DestMax                  The maximum number of Destination Ascii

+                                   char, including terminating null char.

+  @param  Source                   A pointer to a Null-terminated Ascii string.

+

+  @retval RETURN_SUCCESS           String is appended.

+  @retval RETURN_BAD_BUFFER_SIZE   If DestMax is NOT greater than

+                                   StrLen(Destination).

+  @retval RETURN_BUFFER_TOO_SMALL  If (DestMax - StrLen(Destination)) is NOT

+                                   greater than StrLen(Source).

+  @retval RETURN_INVALID_PARAMETER If Destination is NULL.

+                                   If Source is NULL.

+                                   If PcdMaximumAsciiStringLength is not zero,

+                                    and DestMax is greater than

+                                    PcdMaximumAsciiStringLength.

+                                   If DestMax is 0.

+  @retval RETURN_ACCESS_DENIED     If Source and Destination overlap.

+**/

+RETURN_STATUS

+EFIAPI

+AsciiStrCatS (

+  IN OUT CHAR8        *Destination,

+  IN     UINTN        DestMax,

+  IN     CONST CHAR8  *Source

+  );

+

+/**

+  Appends not more than Length successive char from the string pointed to by

+  Source to the end of the string pointed to by Destination. If no null char is

+  copied from Source, then Destination[StrLen(Destination) + Length] is always

+  set to null.

+

+  This function is similar as strncat_s defined in C11.

+

+  If an error is returned, then the Destination is unmodified.

+

+  @param  Destination              A pointer to a Null-terminated Ascii string.

+  @param  DestMax                  The maximum number of Destination Ascii

+                                   char, including terminating null char.

+  @param  Source                   A pointer to a Null-terminated Ascii string.

+  @param  Length                   The maximum number of Ascii characters to copy.

+

+  @retval RETURN_SUCCESS           String is appended.

+  @retval RETURN_BAD_BUFFER_SIZE   If DestMax is NOT greater than

+                                   StrLen(Destination).

+  @retval RETURN_BUFFER_TOO_SMALL  If (DestMax - StrLen(Destination)) is NOT

+                                   greater than MIN(StrLen(Source), Length).

+  @retval RETURN_INVALID_PARAMETER If Destination is NULL.

+                                   If Source is NULL.

+                                   If PcdMaximumAsciiStringLength is not zero,

+                                    and DestMax is greater than

+                                    PcdMaximumAsciiStringLength.

+                                   If DestMax is 0.

+  @retval RETURN_ACCESS_DENIED     If Source and Destination overlap.

+**/

+RETURN_STATUS

+EFIAPI

+AsciiStrnCatS (

+  IN OUT CHAR8        *Destination,

+  IN     UINTN        DestMax,

+  IN     CONST CHAR8  *Source,

+  IN     UINTN        Length

+  );

+

+/**

+  Convert a Null-terminated Ascii decimal string to a value of type UINTN.

+

+  This function outputs a value of type UINTN by interpreting the contents of

+  the Ascii string specified by String as a decimal number. The format of the

+  input Ascii string String is:

+

+                  [spaces] [decimal digits].

+

+  The valid decimal digit character is in the range [0-9]. The function will

+  ignore the pad space, which includes spaces or tab characters, before

+  [decimal digits]. The running zero in the beginning of [decimal digits] will

+  be ignored. Then, the function stops at the first character that is a not a

+  valid decimal character or a Null-terminator, whichever one comes first.

+

+  If String has no valid decimal digits in the above format, then 0 is stored

+  at the location pointed to by Data.

+  If the number represented by String exceeds the range defined by UINTN, then

+  MAX_UINTN is stored at the location pointed to by Data.

+

+  If EndPointer is not NULL, a pointer to the character that stopped the scan

+  is stored at the location pointed to by EndPointer. If String has no valid

+  decimal digits right after the optional pad spaces, the value of String is

+  stored at the location pointed to by EndPointer.

+

+  @param  String                   Pointer to a Null-terminated Ascii string.

+  @param  EndPointer               Pointer to character that stops scan.

+  @param  Data                     Pointer to the converted value.

+

+  @retval RETURN_SUCCESS           Value is translated from String.

+  @retval RETURN_INVALID_PARAMETER If String is NULL.

+                                   If Data is NULL.

+                                   If PcdMaximumAsciiStringLength is not zero,

+                                   and String contains more than

+                                   PcdMaximumAsciiStringLength Ascii

+                                   characters, not including the

+                                   Null-terminator.

+  @retval RETURN_UNSUPPORTED       If the number represented by String exceeds

+                                   the range defined by UINTN.

+

+**/

+RETURN_STATUS

+EFIAPI

+AsciiStrDecimalToUintnS (

+  IN  CONST CHAR8              *String,

+  OUT       CHAR8              **EndPointer,  OPTIONAL

+  OUT       UINTN              *Data

+  );

+

+/**

+  Convert a Null-terminated Ascii decimal string to a value of type UINT64.

+

+  This function outputs a value of type UINT64 by interpreting the contents of

+  the Ascii string specified by String as a decimal number. The format of the

+  input Ascii string String is:

+

+                  [spaces] [decimal digits].

+

+  The valid decimal digit character is in the range [0-9]. The function will

+  ignore the pad space, which includes spaces or tab characters, before

+  [decimal digits]. The running zero in the beginning of [decimal digits] will

+  be ignored. Then, the function stops at the first character that is a not a

+  valid decimal character or a Null-terminator, whichever one comes first.

+

+  If String has no valid decimal digits in the above format, then 0 is stored

+  at the location pointed to by Data.

+  If the number represented by String exceeds the range defined by UINT64, then

+  MAX_UINT64 is stored at the location pointed to by Data.

+

+  If EndPointer is not NULL, a pointer to the character that stopped the scan

+  is stored at the location pointed to by EndPointer. If String has no valid

+  decimal digits right after the optional pad spaces, the value of String is

+  stored at the location pointed to by EndPointer.

+

+  @param  String                   Pointer to a Null-terminated Ascii string.

+  @param  EndPointer               Pointer to character that stops scan.

+  @param  Data                     Pointer to the converted value.

+

+  @retval RETURN_SUCCESS           Value is translated from String.

+  @retval RETURN_INVALID_PARAMETER If String is NULL.

+                                   If Data is NULL.

+                                   If PcdMaximumAsciiStringLength is not zero,

+                                   and String contains more than

+                                   PcdMaximumAsciiStringLength Ascii

+                                   characters, not including the

+                                   Null-terminator.

+  @retval RETURN_UNSUPPORTED       If the number represented by String exceeds

+                                   the range defined by UINT64.

+

+**/

+RETURN_STATUS

+EFIAPI

+AsciiStrDecimalToUint64S (

+  IN  CONST CHAR8              *String,

+  OUT       CHAR8              **EndPointer,  OPTIONAL

+  OUT       UINT64             *Data

+  );

+

+/**

+  Convert a Null-terminated Ascii hexadecimal string to a value of type UINTN.

+

+  This function outputs a value of type UINTN by interpreting the contents of

+  the Ascii string specified by String as a hexadecimal number. The format of

+  the input Ascii string String is:

+

+                  [spaces][zeros][x][hexadecimal digits].

+

+  The valid hexadecimal digit character is in the range [0-9], [a-f] and [A-F].

+  The prefix "0x" is optional. Both "x" and "X" is allowed in "0x" prefix. If

+  "x" appears in the input string, it must be prefixed with at least one 0. The

+  function will ignore the pad space, which includes spaces or tab characters,

+  before [zeros], [x] or [hexadecimal digits]. The running zero before [x] or

+  [hexadecimal digits] will be ignored. Then, the decoding starts after [x] or

+  the first valid hexadecimal digit. Then, the function stops at the first

+  character that is a not a valid hexadecimal character or Null-terminator,

+  whichever on comes first.

+

+  If String has no valid hexadecimal digits in the above format, then 0 is

+  stored at the location pointed to by Data.

+  If the number represented by String exceeds the range defined by UINTN, then

+  MAX_UINTN is stored at the location pointed to by Data.

+

+  If EndPointer is not NULL, a pointer to the character that stopped the scan

+  is stored at the location pointed to by EndPointer. If String has no valid

+  hexadecimal digits right after the optional pad spaces, the value of String

+  is stored at the location pointed to by EndPointer.

+

+  @param  String                   Pointer to a Null-terminated Ascii string.

+  @param  EndPointer               Pointer to character that stops scan.

+  @param  Data                     Pointer to the converted value.

+

+  @retval RETURN_SUCCESS           Value is translated from String.

+  @retval RETURN_INVALID_PARAMETER If String is NULL.

+                                   If Data is NULL.

+                                   If PcdMaximumAsciiStringLength is not zero,

+                                   and String contains more than

+                                   PcdMaximumAsciiStringLength Ascii

+                                   characters, not including the

+                                   Null-terminator.

+  @retval RETURN_UNSUPPORTED       If the number represented by String exceeds

+                                   the range defined by UINTN.

+

+**/

+RETURN_STATUS

+EFIAPI

+AsciiStrHexToUintnS (

+  IN  CONST CHAR8              *String,

+  OUT       CHAR8              **EndPointer,  OPTIONAL

+  OUT       UINTN              *Data

+  );

+

+/**

+  Convert a Null-terminated Ascii hexadecimal string to a value of type UINT64.

+

+  This function outputs a value of type UINT64 by interpreting the contents of

+  the Ascii string specified by String as a hexadecimal number. The format of

+  the input Ascii string String is:

+

+                  [spaces][zeros][x][hexadecimal digits].

+

+  The valid hexadecimal digit character is in the range [0-9], [a-f] and [A-F].

+  The prefix "0x" is optional. Both "x" and "X" is allowed in "0x" prefix. If

+  "x" appears in the input string, it must be prefixed with at least one 0. The

+  function will ignore the pad space, which includes spaces or tab characters,

+  before [zeros], [x] or [hexadecimal digits]. The running zero before [x] or

+  [hexadecimal digits] will be ignored. Then, the decoding starts after [x] or

+  the first valid hexadecimal digit. Then, the function stops at the first

+  character that is a not a valid hexadecimal character or Null-terminator,

+  whichever on comes first.

+

+  If String has no valid hexadecimal digits in the above format, then 0 is

+  stored at the location pointed to by Data.

+  If the number represented by String exceeds the range defined by UINT64, then

+  MAX_UINT64 is stored at the location pointed to by Data.

+

+  If EndPointer is not NULL, a pointer to the character that stopped the scan

+  is stored at the location pointed to by EndPointer. If String has no valid

+  hexadecimal digits right after the optional pad spaces, the value of String

+  is stored at the location pointed to by EndPointer.

+

+  @param  String                   Pointer to a Null-terminated Ascii string.

+  @param  EndPointer               Pointer to character that stops scan.

+  @param  Data                     Pointer to the converted value.

+

+  @retval RETURN_SUCCESS           Value is translated from String.

+  @retval RETURN_INVALID_PARAMETER If String is NULL.

+                                   If Data is NULL.

+                                   If PcdMaximumAsciiStringLength is not zero,

+                                   and String contains more than

+                                   PcdMaximumAsciiStringLength Ascii

+                                   characters, not including the

+                                   Null-terminator.

+  @retval RETURN_UNSUPPORTED       If the number represented by String exceeds

+                                   the range defined by UINT64.

+

+**/

+RETURN_STATUS

+EFIAPI

+AsciiStrHexToUint64S (

+  IN  CONST CHAR8              *String,

+  OUT       CHAR8              **EndPointer,  OPTIONAL

+  OUT       UINT64             *Data

+  );

+

+

+#ifndef DISABLE_NEW_DEPRECATED_INTERFACES

+

+/**

+  [ATTENTION] This function is deprecated for security reason.

+

+  Copies one Null-terminated Unicode string to another Null-terminated Unicode

+  string and returns the new Unicode string.

+

+  This function copies the contents of the Unicode string Source to the Unicode

+  string Destination, and returns Destination. If Source and Destination

+  overlap, then the results are undefined.

+

+  If Destination is NULL, then ASSERT().

+  If Destination is not aligned on a 16-bit boundary, then ASSERT().

+  If Source is NULL, then ASSERT().

+  If Source is not aligned on a 16-bit boundary, then ASSERT().

+  If Source and Destination overlap, then ASSERT().

+  If PcdMaximumUnicodeStringLength is not zero, and Source contains more than

+  PcdMaximumUnicodeStringLength Unicode characters not including the

+  Null-terminator, then ASSERT().

+

+  @param  Destination The pointer to a Null-terminated Unicode string.

+  @param  Source      The pointer to a Null-terminated Unicode string.

+

+  @return Destination.

+

+**/

+CHAR16 *

+EFIAPI

+StrCpy (

+  OUT     CHAR16                    *Destination,

+  IN      CONST CHAR16              *Source

+  );

+

+

+/**

+  [ATTENTION] This function is deprecated for security reason.

+

+  Copies up to a specified length from one Null-terminated Unicode string to

+  another Null-terminated Unicode string and returns the new Unicode string.

+

+  This function copies the contents of the Unicode string Source to the Unicode

+  string Destination, and returns Destination. At most, Length Unicode

+  characters are copied from Source to Destination. If Length is 0, then

+  Destination is returned unmodified. If Length is greater that the number of

+  Unicode characters in Source, then Destination is padded with Null Unicode

+  characters. If Source and Destination overlap, then the results are

+  undefined.

+

+  If Length > 0 and Destination is NULL, then ASSERT().

+  If Length > 0 and Destination is not aligned on a 16-bit boundary, then ASSERT().

+  If Length > 0 and Source is NULL, then ASSERT().

+  If Length > 0 and Source is not aligned on a 16-bit boundary, then ASSERT().

+  If Source and Destination overlap, then ASSERT().

+  If PcdMaximumUnicodeStringLength is not zero, and Length is greater than

+  PcdMaximumUnicodeStringLength, then ASSERT().

+  If PcdMaximumUnicodeStringLength is not zero, and Source contains more than

+  PcdMaximumUnicodeStringLength Unicode characters, not including the Null-terminator,

+  then ASSERT().

+

+  @param  Destination The pointer to a Null-terminated Unicode string.

+  @param  Source      The pointer to a Null-terminated Unicode string.

+  @param  Length      The maximum number of Unicode characters to copy.

+

+  @return Destination.

+

+**/

+CHAR16 *

+EFIAPI

+StrnCpy (

+  OUT     CHAR16                    *Destination,

+  IN      CONST CHAR16              *Source,

+  IN      UINTN                     Length

+  );

+#endif // !defined (DISABLE_NEW_DEPRECATED_INTERFACES)

+

+/**

+  Returns the length of a Null-terminated Unicode string.

+

+  This function returns the number of Unicode characters in the Null-terminated

+  Unicode string specified by String.

+

+  If String is NULL, then ASSERT().

+  If String is not aligned on a 16-bit boundary, then ASSERT().

+  If PcdMaximumUnicodeStringLength is not zero, and String contains more than

+  PcdMaximumUnicodeStringLength Unicode characters not including the

+  Null-terminator, then ASSERT().

+

+  @param  String  Pointer to a Null-terminated Unicode string.

+

+  @return The length of String.

+

+**/

+UINTN

+EFIAPI

+StrLen (

+  IN      CONST CHAR16              *String

+  );

+

+

+/**

+  Returns the size of a Null-terminated Unicode string in bytes, including the

+  Null terminator.

+

+  This function returns the size, in bytes, of the Null-terminated Unicode string

+  specified by String.

+

+  If String is NULL, then ASSERT().

+  If String is not aligned on a 16-bit boundary, then ASSERT().

+  If PcdMaximumUnicodeStringLength is not zero, and String contains more than

+  PcdMaximumUnicodeStringLength Unicode characters not including the

+  Null-terminator, then ASSERT().

+

+  @param  String  The pointer to a Null-terminated Unicode string.

+

+  @return The size of String.

+

+**/

+UINTN

+EFIAPI

+StrSize (

+  IN      CONST CHAR16              *String

+  );

+

+

+/**

+  Compares two Null-terminated Unicode strings, and returns the difference

+  between the first mismatched Unicode characters.

+

+  This function compares the Null-terminated Unicode string FirstString to the

+  Null-terminated Unicode string SecondString. If FirstString is identical to

+  SecondString, then 0 is returned. Otherwise, the value returned is the first

+  mismatched Unicode character in SecondString subtracted from the first

+  mismatched Unicode character in FirstString.

+

+  If FirstString is NULL, then ASSERT().

+  If FirstString is not aligned on a 16-bit boundary, then ASSERT().

+  If SecondString is NULL, then ASSERT().

+  If SecondString is not aligned on a 16-bit boundary, then ASSERT().

+  If PcdMaximumUnicodeStringLength is not zero, and FirstString contains more

+  than PcdMaximumUnicodeStringLength Unicode characters not including the

+  Null-terminator, then ASSERT().

+  If PcdMaximumUnicodeStringLength is not zero, and SecondString contains more

+  than PcdMaximumUnicodeStringLength Unicode characters, not including the

+  Null-terminator, then ASSERT().

+

+  @param  FirstString   The pointer to a Null-terminated Unicode string.

+  @param  SecondString  The pointer to a Null-terminated Unicode string.

+

+  @retval 0      FirstString is identical to SecondString.

+  @return others FirstString is not identical to SecondString.

+

+**/

+INTN

+EFIAPI

+StrCmp (

+  IN      CONST CHAR16              *FirstString,

+  IN      CONST CHAR16              *SecondString

+  );

+

+

+/**

+  Compares up to a specified length the contents of two Null-terminated Unicode strings,

+  and returns the difference between the first mismatched Unicode characters.

+

+  This function compares the Null-terminated Unicode string FirstString to the

+  Null-terminated Unicode string SecondString. At most, Length Unicode

+  characters will be compared. If Length is 0, then 0 is returned. If

+  FirstString is identical to SecondString, then 0 is returned. Otherwise, the

+  value returned is the first mismatched Unicode character in SecondString

+  subtracted from the first mismatched Unicode character in FirstString.

+

+  If Length > 0 and FirstString is NULL, then ASSERT().

+  If Length > 0 and FirstString is not aligned on a 16-bit boundary, then ASSERT().

+  If Length > 0 and SecondString is NULL, then ASSERT().

+  If Length > 0 and SecondString is not aligned on a 16-bit boundary, then ASSERT().

+  If PcdMaximumUnicodeStringLength is not zero, and Length is greater than

+  PcdMaximumUnicodeStringLength, then ASSERT().

+  If PcdMaximumUnicodeStringLength is not zero, and FirstString contains more than

+  PcdMaximumUnicodeStringLength Unicode characters, not including the Null-terminator,

+  then ASSERT().

+  If PcdMaximumUnicodeStringLength is not zero, and SecondString contains more than

+  PcdMaximumUnicodeStringLength Unicode characters, not including the Null-terminator,

+  then ASSERT().

+

+  @param  FirstString   The pointer to a Null-terminated Unicode string.

+  @param  SecondString  The pointer to a Null-terminated Unicode string.

+  @param  Length        The maximum number of Unicode characters to compare.

+

+  @retval 0      FirstString is identical to SecondString.

+  @return others FirstString is not identical to SecondString.

+

+**/

+INTN

+EFIAPI

+StrnCmp (

+  IN      CONST CHAR16              *FirstString,

+  IN      CONST CHAR16              *SecondString,

+  IN      UINTN                     Length

+  );

+

+

+#ifndef DISABLE_NEW_DEPRECATED_INTERFACES

+

+/**

+  [ATTENTION] This function is deprecated for security reason.

+

+  Concatenates one Null-terminated Unicode string to another Null-terminated

+  Unicode string, and returns the concatenated Unicode string.

+

+  This function concatenates two Null-terminated Unicode strings. The contents

+  of Null-terminated Unicode string Source are concatenated to the end of

+  Null-terminated Unicode string Destination. The Null-terminated concatenated

+  Unicode String is returned. If Source and Destination overlap, then the

+  results are undefined.

+

+  If Destination is NULL, then ASSERT().

+  If Destination is not aligned on a 16-bit boundary, then ASSERT().

+  If Source is NULL, then ASSERT().

+  If Source is not aligned on a 16-bit boundary, then ASSERT().

+  If Source and Destination overlap, then ASSERT().

+  If PcdMaximumUnicodeStringLength is not zero, and Destination contains more

+  than PcdMaximumUnicodeStringLength Unicode characters, not including the

+  Null-terminator, then ASSERT().

+  If PcdMaximumUnicodeStringLength is not zero, and Source contains more than

+  PcdMaximumUnicodeStringLength Unicode characters, not including the

+  Null-terminator, then ASSERT().

+  If PcdMaximumUnicodeStringLength is not zero, and concatenating Destination

+  and Source results in a Unicode string with more than

+  PcdMaximumUnicodeStringLength Unicode characters, not including the

+  Null-terminator, then ASSERT().

+

+  @param  Destination The pointer to a Null-terminated Unicode string.

+  @param  Source      The pointer to a Null-terminated Unicode string.

+

+  @return Destination.

+

+**/

+CHAR16 *

+EFIAPI

+StrCat (

+  IN OUT  CHAR16                    *Destination,

+  IN      CONST CHAR16              *Source

+  );

+

+

+/**

+  [ATTENTION] This function is deprecated for security reason.

+

+  Concatenates up to a specified length one Null-terminated Unicode to the end

+  of another Null-terminated Unicode string, and returns the concatenated

+  Unicode string.

+

+  This function concatenates two Null-terminated Unicode strings. The contents

+  of Null-terminated Unicode string Source are concatenated to the end of

+  Null-terminated Unicode string Destination, and Destination is returned. At

+  most, Length Unicode characters are concatenated from Source to the end of

+  Destination, and Destination is always Null-terminated. If Length is 0, then

+  Destination is returned unmodified. If Source and Destination overlap, then

+  the results are undefined.

+

+  If Destination is NULL, then ASSERT().

+  If Length > 0 and Destination is not aligned on a 16-bit boundary, then ASSERT().

+  If Length > 0 and Source is NULL, then ASSERT().

+  If Length > 0 and Source is not aligned on a 16-bit boundary, then ASSERT().

+  If Source and Destination overlap, then ASSERT().

+  If PcdMaximumUnicodeStringLength is not zero, and Length is greater than

+  PcdMaximumUnicodeStringLength, then ASSERT().

+  If PcdMaximumUnicodeStringLength is not zero, and Destination contains more

+  than PcdMaximumUnicodeStringLength Unicode characters, not including the

+  Null-terminator, then ASSERT().

+  If PcdMaximumUnicodeStringLength is not zero, and Source contains more than

+  PcdMaximumUnicodeStringLength Unicode characters, not including the

+  Null-terminator, then ASSERT().

+  If PcdMaximumUnicodeStringLength is not zero, and concatenating Destination

+  and Source results in a Unicode string with more than PcdMaximumUnicodeStringLength

+  Unicode characters, not including the Null-terminator, then ASSERT().

+

+  @param  Destination The pointer to a Null-terminated Unicode string.

+  @param  Source      The pointer to a Null-terminated Unicode string.

+  @param  Length      The maximum number of Unicode characters to concatenate from

+                      Source.

+

+  @return Destination.

+

+**/

+CHAR16 *

+EFIAPI

+StrnCat (

+  IN OUT  CHAR16                    *Destination,

+  IN      CONST CHAR16              *Source,

+  IN      UINTN                     Length

+  );

+#endif // !defined (DISABLE_NEW_DEPRECATED_INTERFACES)

+

+/**

+  Returns the first occurrence of a Null-terminated Unicode sub-string

+  in a Null-terminated Unicode string.

+

+  This function scans the contents of the Null-terminated Unicode string

+  specified by String and returns the first occurrence of SearchString.

+  If SearchString is not found in String, then NULL is returned.  If

+  the length of SearchString is zero, then String is returned.

+

+  If String is NULL, then ASSERT().

+  If String is not aligned on a 16-bit boundary, then ASSERT().

+  If SearchString is NULL, then ASSERT().

+  If SearchString is not aligned on a 16-bit boundary, then ASSERT().

+

+  If PcdMaximumUnicodeStringLength is not zero, and SearchString

+  or String contains more than PcdMaximumUnicodeStringLength Unicode

+  characters, not including the Null-terminator, then ASSERT().

+

+  @param  String          The pointer to a Null-terminated Unicode string.

+  @param  SearchString    The pointer to a Null-terminated Unicode string to search for.

+

+  @retval NULL            If the SearchString does not appear in String.

+  @return others          If there is a match.

+

+**/

+CHAR16 *

+EFIAPI

+StrStr (

+  IN      CONST CHAR16              *String,

+  IN      CONST CHAR16              *SearchString

+  );

+

+/**

+  Convert a Null-terminated Unicode decimal string to a value of

+  type UINTN.

+

+  This function returns a value of type UINTN by interpreting the contents

+  of the Unicode string specified by String as a decimal number. The format

+  of the input Unicode string String is:

+

+                  [spaces] [decimal digits].

+

+  The valid decimal digit character is in the range [0-9]. The

+  function will ignore the pad space, which includes spaces or

+  tab characters, before [decimal digits]. The running zero in the

+  beginning of [decimal digits] will be ignored. Then, the function

+  stops at the first character that is a not a valid decimal character

+  or a Null-terminator, whichever one comes first.

+

+  If String is NULL, then ASSERT().

+  If String is not aligned in a 16-bit boundary, then ASSERT().

+  If String has only pad spaces, then 0 is returned.

+  If String has no pad spaces or valid decimal digits,

+  then 0 is returned.

+  If the number represented by String overflows according

+  to the range defined by UINTN, then MAX_UINTN is returned.

+

+  If PcdMaximumUnicodeStringLength is not zero, and String contains

+  more than PcdMaximumUnicodeStringLength Unicode characters not including

+  the Null-terminator, then ASSERT().

+

+  @param  String      The pointer to a Null-terminated Unicode string.

+

+  @retval Value translated from String.

+

+**/

+UINTN

+EFIAPI

+StrDecimalToUintn (

+  IN      CONST CHAR16              *String

+  );

+

+/**

+  Convert a Null-terminated Unicode decimal string to a value of

+  type UINT64.

+

+  This function returns a value of type UINT64 by interpreting the contents

+  of the Unicode string specified by String as a decimal number. The format

+  of the input Unicode string String is:

+

+                  [spaces] [decimal digits].

+

+  The valid decimal digit character is in the range [0-9]. The

+  function will ignore the pad space, which includes spaces or

+  tab characters, before [decimal digits]. The running zero in the

+  beginning of [decimal digits] will be ignored. Then, the function

+  stops at the first character that is a not a valid decimal character

+  or a Null-terminator, whichever one comes first.

+

+  If String is NULL, then ASSERT().

+  If String is not aligned in a 16-bit boundary, then ASSERT().

+  If String has only pad spaces, then 0 is returned.

+  If String has no pad spaces or valid decimal digits,

+  then 0 is returned.

+  If the number represented by String overflows according

+  to the range defined by UINT64, then MAX_UINT64 is returned.

+

+  If PcdMaximumUnicodeStringLength is not zero, and String contains

+  more than PcdMaximumUnicodeStringLength Unicode characters not including

+  the Null-terminator, then ASSERT().

+

+  @param  String          The pointer to a Null-terminated Unicode string.

+

+  @retval Value translated from String.

+

+**/

+UINT64

+EFIAPI

+StrDecimalToUint64 (

+  IN      CONST CHAR16              *String

+  );

+

+

+/**

+  Convert a Null-terminated Unicode hexadecimal string to a value of type UINTN.

+

+  This function returns a value of type UINTN by interpreting the contents

+  of the Unicode string specified by String as a hexadecimal number.

+  The format of the input Unicode string String is:

+

+                  [spaces][zeros][x][hexadecimal digits].

+

+  The valid hexadecimal digit character is in the range [0-9], [a-f] and [A-F].

+  The prefix "0x" is optional. Both "x" and "X" is allowed in "0x" prefix.

+  If "x" appears in the input string, it must be prefixed with at least one 0.

+  The function will ignore the pad space, which includes spaces or tab characters,

+  before [zeros], [x] or [hexadecimal digit]. The running zero before [x] or

+  [hexadecimal digit] will be ignored. Then, the decoding starts after [x] or the

+  first valid hexadecimal digit. Then, the function stops at the first character

+  that is a not a valid hexadecimal character or NULL, whichever one comes first.

+

+  If String is NULL, then ASSERT().

+  If String is not aligned in a 16-bit boundary, then ASSERT().

+  If String has only pad spaces, then zero is returned.

+  If String has no leading pad spaces, leading zeros or valid hexadecimal digits,

+  then zero is returned.

+  If the number represented by String overflows according to the range defined by

+  UINTN, then MAX_UINTN is returned.

+

+  If PcdMaximumUnicodeStringLength is not zero, and String contains more than

+  PcdMaximumUnicodeStringLength Unicode characters not including the Null-terminator,

+  then ASSERT().

+

+  @param  String          The pointer to a Null-terminated Unicode string.

+

+  @retval Value translated from String.

+

+**/

+UINTN

+EFIAPI

+StrHexToUintn (

+  IN      CONST CHAR16              *String

+  );

+

+

+/**

+  Convert a Null-terminated Unicode hexadecimal string to a value of type UINT64.

+

+  This function returns a value of type UINT64 by interpreting the contents

+  of the Unicode string specified by String as a hexadecimal number.

+  The format of the input Unicode string String is

+

+                  [spaces][zeros][x][hexadecimal digits].

+

+  The valid hexadecimal digit character is in the range [0-9], [a-f] and [A-F].

+  The prefix "0x" is optional. Both "x" and "X" is allowed in "0x" prefix.

+  If "x" appears in the input string, it must be prefixed with at least one 0.

+  The function will ignore the pad space, which includes spaces or tab characters,

+  before [zeros], [x] or [hexadecimal digit]. The running zero before [x] or

+  [hexadecimal digit] will be ignored. Then, the decoding starts after [x] or the

+  first valid hexadecimal digit. Then, the function stops at the first character that is

+  a not a valid hexadecimal character or NULL, whichever one comes first.

+

+  If String is NULL, then ASSERT().

+  If String is not aligned in a 16-bit boundary, then ASSERT().

+  If String has only pad spaces, then zero is returned.

+  If String has no leading pad spaces, leading zeros or valid hexadecimal digits,

+  then zero is returned.

+  If the number represented by String overflows according to the range defined by

+  UINT64, then MAX_UINT64 is returned.

+

+  If PcdMaximumUnicodeStringLength is not zero, and String contains more than

+  PcdMaximumUnicodeStringLength Unicode characters not including the Null-terminator,

+  then ASSERT().

+

+  @param  String          The pointer to a Null-terminated Unicode string.

+

+  @retval Value translated from String.

+

+**/

+UINT64

+EFIAPI

+StrHexToUint64 (

+  IN      CONST CHAR16             *String

+  );

+

+/**

+  Convert a Null-terminated Unicode string to IPv6 address and prefix length.

+

+  This function outputs a value of type IPv6_ADDRESS and may output a value

+  of type UINT8 by interpreting the contents of the Unicode string specified

+  by String. The format of the input Unicode string String is as follows:

+

+                  X:X:X:X:X:X:X:X[/P]

+

+  X contains one to four hexadecimal digit characters in the range [0-9], [a-f] and

+  [A-F]. X is converted to a value of type UINT16, whose low byte is stored in low

+  memory address and high byte is stored in high memory address. P contains decimal

+  digit characters in the range [0-9]. The running zero in the beginning of P will

+  be ignored. /P is optional.

+

+  When /P is not in the String, the function stops at the first character that is

+  not a valid hexadecimal digit character after eight X's are converted.

+

+  When /P is in the String, the function stops at the first character that is not

+  a valid decimal digit character after P is converted.

+

+  "::" can be used to compress one or more groups of X when X contains only 0.

+  The "::" can only appear once in the String.

+

+  If String is not aligned in a 16-bit boundary, then ASSERT().

+

+  If EndPointer is not NULL and Address is translated from String, a pointer

+  to the character that stopped the scan is stored at the location pointed to

+  by EndPointer.

+

+  @param  String                   Pointer to a Null-terminated Unicode string.

+  @param  EndPointer               Pointer to character that stops scan.

+  @param  Address                  Pointer to the converted IPv6 address.

+  @param  PrefixLength             Pointer to the converted IPv6 address prefix

+                                   length. MAX_UINT8 is returned when /P is

+                                   not in the String.

+

+  @retval RETURN_SUCCESS           Address is translated from String.

+  @retval RETURN_INVALID_PARAMETER If String is NULL.

+                                   If Data is NULL.

+  @retval RETURN_UNSUPPORTED       If X contains more than four hexadecimal

+                                    digit characters.

+                                   If String contains "::" and number of X

+                                    is not less than 8.

+                                   If P starts with character that is not a

+                                    valid decimal digit character.

+                                   If the decimal number converted from P

+                                    exceeds 128.

+

+**/

+RETURN_STATUS

+EFIAPI

+StrToIpv6Address (

+  IN  CONST CHAR16       *String,

+  OUT CHAR16             **EndPointer, OPTIONAL

+  OUT IPv6_ADDRESS       *Address,

+  OUT UINT8              *PrefixLength OPTIONAL

+  );

+

+/**

+  Convert a Null-terminated Unicode string to IPv4 address and prefix length.

+

+  This function outputs a value of type IPv4_ADDRESS and may output a value

+  of type UINT8 by interpreting the contents of the Unicode string specified

+  by String. The format of the input Unicode string String is as follows:

+

+                  D.D.D.D[/P]

+

+  D and P are decimal digit characters in the range [0-9]. The running zero in

+  the beginning of D and P will be ignored. /P is optional.

+

+  When /P is not in the String, the function stops at the first character that is

+  not a valid decimal digit character after four D's are converted.

+

+  When /P is in the String, the function stops at the first character that is not

+  a valid decimal digit character after P is converted.

+

+  If String is not aligned in a 16-bit boundary, then ASSERT().

+

+  If EndPointer is not NULL and Address is translated from String, a pointer

+  to the character that stopped the scan is stored at the location pointed to

+  by EndPointer.

+

+  @param  String                   Pointer to a Null-terminated Unicode string.

+  @param  EndPointer               Pointer to character that stops scan.

+  @param  Address                  Pointer to the converted IPv4 address.

+  @param  PrefixLength             Pointer to the converted IPv4 address prefix

+                                   length. MAX_UINT8 is returned when /P is

+                                   not in the String.

+

+  @retval RETURN_SUCCESS           Address is translated from String.

+  @retval RETURN_INVALID_PARAMETER If String is NULL.

+                                   If Data is NULL.

+  @retval RETURN_UNSUPPORTED       If String is not in the correct format.

+                                   If any decimal number converted from D

+                                    exceeds 255.

+                                   If the decimal number converted from P

+                                    exceeds 32.

+

+**/

+RETURN_STATUS

+EFIAPI

+StrToIpv4Address (

+  IN  CONST CHAR16       *String,

+  OUT CHAR16             **EndPointer, OPTIONAL

+  OUT IPv4_ADDRESS       *Address,

+  OUT UINT8              *PrefixLength OPTIONAL

+  );

+

+#define GUID_STRING_LENGTH  36

+

+/**

+  Convert a Null-terminated Unicode GUID string to a value of type

+  EFI_GUID.

+

+  This function outputs a GUID value by interpreting the contents of

+  the Unicode string specified by String. The format of the input

+  Unicode string String consists of 36 characters, as follows:

+

+                  aabbccdd-eeff-gghh-iijj-kkllmmnnoopp

+

+  The pairs aa - pp are two characters in the range [0-9], [a-f] and

+  [A-F], with each pair representing a single byte hexadecimal value.

+

+  The mapping between String and the EFI_GUID structure is as follows:

+                  aa          Data1[24:31]

+                  bb          Data1[16:23]

+                  cc          Data1[8:15]

+                  dd          Data1[0:7]

+                  ee          Data2[8:15]

+                  ff          Data2[0:7]

+                  gg          Data3[8:15]

+                  hh          Data3[0:7]

+                  ii          Data4[0:7]

+                  jj          Data4[8:15]

+                  kk          Data4[16:23]

+                  ll          Data4[24:31]

+                  mm          Data4[32:39]

+                  nn          Data4[40:47]

+                  oo          Data4[48:55]

+                  pp          Data4[56:63]

+

+  If String is not aligned in a 16-bit boundary, then ASSERT().

+

+  @param  String                   Pointer to a Null-terminated Unicode string.

+  @param  Guid                     Pointer to the converted GUID.

+

+  @retval RETURN_SUCCESS           Guid is translated from String.

+  @retval RETURN_INVALID_PARAMETER If String is NULL.

+                                   If Data is NULL.

+  @retval RETURN_UNSUPPORTED       If String is not as the above format.

+

+**/

+RETURN_STATUS

+EFIAPI

+StrToGuid (

+  IN  CONST CHAR16       *String,

+  OUT GUID               *Guid

+  );

+

+/**

+  Convert a Null-terminated Unicode hexadecimal string to a byte array.

+

+  This function outputs a byte array by interpreting the contents of

+  the Unicode string specified by String in hexadecimal format. The format of

+  the input Unicode string String is:

+

+                  [XX]*

+

+  X is a hexadecimal digit character in the range [0-9], [a-f] and [A-F].

+  The function decodes every two hexadecimal digit characters as one byte. The

+  decoding stops after Length of characters and outputs Buffer containing

+  (Length / 2) bytes.

+

+  If String is not aligned in a 16-bit boundary, then ASSERT().

+

+  @param  String                   Pointer to a Null-terminated Unicode string.

+  @param  Length                   The number of Unicode characters to decode.

+  @param  Buffer                   Pointer to the converted bytes array.

+  @param  MaxBufferSize            The maximum size of Buffer.

+

+  @retval RETURN_SUCCESS           Buffer is translated from String.

+  @retval RETURN_INVALID_PARAMETER If String is NULL.

+                                   If Data is NULL.

+                                   If Length is not multiple of 2.

+                                   If PcdMaximumUnicodeStringLength is not zero,

+                                    and Length is greater than

+                                    PcdMaximumUnicodeStringLength.

+  @retval RETURN_UNSUPPORTED       If Length of characters from String contain

+                                    a character that is not valid hexadecimal

+                                    digit characters, or a Null-terminator.

+  @retval RETURN_BUFFER_TOO_SMALL  If MaxBufferSize is less than (Length / 2).

+**/

+RETURN_STATUS

+EFIAPI

+StrHexToBytes (

+  IN  CONST CHAR16       *String,

+  IN  UINTN              Length,

+  OUT UINT8              *Buffer,

+  IN  UINTN              MaxBufferSize

+  );

+

+#ifndef DISABLE_NEW_DEPRECATED_INTERFACES

+

+/**

+  [ATTENTION] This function is deprecated for security reason.

+

+  Convert a Null-terminated Unicode string to a Null-terminated

+  ASCII string and returns the ASCII string.

+

+  This function converts the content of the Unicode string Source

+  to the ASCII string Destination by copying the lower 8 bits of

+  each Unicode character. It returns Destination.

+

+  The caller is responsible to make sure Destination points to a buffer with size

+  equal or greater than ((StrLen (Source) + 1) * sizeof (CHAR8)) in bytes.

+

+  If any Unicode characters in Source contain non-zero value in

+  the upper 8 bits, then ASSERT().

+

+  If Destination is NULL, then ASSERT().

+  If Source is NULL, then ASSERT().

+  If Source is not aligned on a 16-bit boundary, then ASSERT().

+  If Source and Destination overlap, then ASSERT().

+

+  If PcdMaximumUnicodeStringLength is not zero, and Source contains

+  more than PcdMaximumUnicodeStringLength Unicode characters not including

+  the Null-terminator, then ASSERT().

+

+  If PcdMaximumAsciiStringLength is not zero, and Source contains more

+  than PcdMaximumAsciiStringLength Unicode characters not including the

+  Null-terminator, then ASSERT().

+

+  @param  Source        The pointer to a Null-terminated Unicode string.

+  @param  Destination   The pointer to a Null-terminated ASCII string.

+

+  @return Destination.

+

+**/

+CHAR8 *

+EFIAPI

+UnicodeStrToAsciiStr (

+  IN      CONST CHAR16              *Source,

+  OUT     CHAR8                     *Destination

+  );

+

+#endif // !defined (DISABLE_NEW_DEPRECATED_INTERFACES)

+

+/**

+  Convert a Null-terminated Unicode string to a Null-terminated

+  ASCII string.

+

+  This function is similar to AsciiStrCpyS.

+

+  This function converts the content of the Unicode string Source

+  to the ASCII string Destination by copying the lower 8 bits of

+  each Unicode character. The function terminates the ASCII string

+  Destination by appending a Null-terminator character at the end.

+

+  The caller is responsible to make sure Destination points to a buffer with size

+  equal or greater than ((StrLen (Source) + 1) * sizeof (CHAR8)) in bytes.

+

+  If any Unicode characters in Source contain non-zero value in

+  the upper 8 bits, then ASSERT().

+

+  If Source is not aligned on a 16-bit boundary, then ASSERT().

+

+  If an error is returned, then the Destination is unmodified.

+

+  @param  Source        The pointer to a Null-terminated Unicode string.

+  @param  Destination   The pointer to a Null-terminated ASCII string.

+  @param  DestMax       The maximum number of Destination Ascii

+                        char, including terminating null char.

+

+  @retval RETURN_SUCCESS           String is converted.

+  @retval RETURN_BUFFER_TOO_SMALL  If DestMax is NOT greater than StrLen(Source).

+  @retval RETURN_INVALID_PARAMETER If Destination is NULL.

+                                   If Source is NULL.

+                                   If PcdMaximumAsciiStringLength is not zero,

+                                    and DestMax is greater than

+                                    PcdMaximumAsciiStringLength.

+                                   If PcdMaximumUnicodeStringLength is not zero,

+                                    and DestMax is greater than

+                                    PcdMaximumUnicodeStringLength.

+                                   If DestMax is 0.

+  @retval RETURN_ACCESS_DENIED     If Source and Destination overlap.

+

+**/

+RETURN_STATUS

+EFIAPI

+UnicodeStrToAsciiStrS (

+  IN      CONST CHAR16              *Source,

+  OUT     CHAR8                     *Destination,

+  IN      UINTN                     DestMax

+  );

+

+/**

+  Convert not more than Length successive characters from a Null-terminated

+  Unicode string to a Null-terminated Ascii string. If no null char is copied

+  from Source, then Destination[Length] is always set to null.

+

+  This function converts not more than Length successive characters from the

+  Unicode string Source to the Ascii string Destination by copying the lower 8

+  bits of each Unicode character. The function terminates the Ascii string

+  Destination by appending a Null-terminator character at the end.

+

+  The caller is responsible to make sure Destination points to a buffer with size

+  equal or greater than ((StrLen (Source) + 1) * sizeof (CHAR8)) in bytes.

+

+  If any Unicode characters in Source contain non-zero value in the upper 8

+  bits, then ASSERT().

+  If Source is not aligned on a 16-bit boundary, then ASSERT().

+

+  If an error is returned, then the Destination is unmodified.

+

+  @param  Source             The pointer to a Null-terminated Unicode string.

+  @param  Length             The maximum number of Unicode characters to

+                             convert.

+  @param  Destination        The pointer to a Null-terminated Ascii string.

+  @param  DestMax            The maximum number of Destination Ascii

+                             char, including terminating null char.

+  @param  DestinationLength  The number of Unicode characters converted.

+

+  @retval RETURN_SUCCESS            String is converted.

+  @retval RETURN_INVALID_PARAMETER  If Destination is NULL.

+                                    If Source is NULL.

+                                    If DestinationLength is NULL.

+                                    If PcdMaximumAsciiStringLength is not zero,

+                                    and Length or DestMax is greater than

+                                    PcdMaximumAsciiStringLength.

+                                    If PcdMaximumUnicodeStringLength is not

+                                    zero, and Length or DestMax is greater than

+                                    PcdMaximumUnicodeStringLength.

+                                    If DestMax is 0.

+  @retval RETURN_BUFFER_TOO_SMALL   If DestMax is NOT greater than

+                                    MIN(StrLen(Source), Length).

+  @retval RETURN_ACCESS_DENIED      If Source and Destination overlap.

+

+**/

+RETURN_STATUS

+EFIAPI

+UnicodeStrnToAsciiStrS (

+  IN      CONST CHAR16              *Source,

+  IN      UINTN                     Length,

+  OUT     CHAR8                     *Destination,

+  IN      UINTN                     DestMax,

+  OUT     UINTN                     *DestinationLength

+  );

+

+#ifndef DISABLE_NEW_DEPRECATED_INTERFACES

+

+/**

+  [ATTENTION] This function is deprecated for security reason.

+

+  Copies one Null-terminated ASCII string to another Null-terminated ASCII

+  string and returns the new ASCII string.

+

+  This function copies the contents of the ASCII string Source to the ASCII

+  string Destination, and returns Destination. If Source and Destination

+  overlap, then the results are undefined.

+

+  If Destination is NULL, then ASSERT().

+  If Source is NULL, then ASSERT().

+  If Source and Destination overlap, then ASSERT().

+  If PcdMaximumAsciiStringLength is not zero and Source contains more than

+  PcdMaximumAsciiStringLength ASCII characters not including the Null-terminator,

+  then ASSERT().

+

+  @param  Destination The pointer to a Null-terminated ASCII string.

+  @param  Source      The pointer to a Null-terminated ASCII string.

+

+  @return Destination

+

+**/

+CHAR8 *

+EFIAPI

+AsciiStrCpy (

+  OUT     CHAR8                     *Destination,

+  IN      CONST CHAR8               *Source

+  );

+

+

+/**

+  [ATTENTION] This function is deprecated for security reason.

+

+  Copies up to a specified length one Null-terminated ASCII string to another

+  Null-terminated ASCII string and returns the new ASCII string.

+

+  This function copies the contents of the ASCII string Source to the ASCII

+  string Destination, and returns Destination. At most, Length ASCII characters

+  are copied from Source to Destination. If Length is 0, then Destination is

+  returned unmodified. If Length is greater that the number of ASCII characters

+  in Source, then Destination is padded with Null ASCII characters. If Source

+  and Destination overlap, then the results are undefined.

+

+  If Destination is NULL, then ASSERT().

+  If Source is NULL, then ASSERT().

+  If Source and Destination overlap, then ASSERT().

+  If PcdMaximumAsciiStringLength is not zero, and Length is greater than

+  PcdMaximumAsciiStringLength, then ASSERT().

+  If PcdMaximumAsciiStringLength is not zero, and Source contains more than

+  PcdMaximumAsciiStringLength ASCII characters, not including the Null-terminator,

+  then ASSERT().

+

+  @param  Destination The pointer to a Null-terminated ASCII string.

+  @param  Source      The pointer to a Null-terminated ASCII string.

+  @param  Length      The maximum number of ASCII characters to copy.

+

+  @return Destination

+

+**/

+CHAR8 *

+EFIAPI

+AsciiStrnCpy (

+  OUT     CHAR8                     *Destination,

+  IN      CONST CHAR8               *Source,

+  IN      UINTN                     Length

+  );

+#endif // !defined (DISABLE_NEW_DEPRECATED_INTERFACES)

+

+/**

+  Returns the length of a Null-terminated ASCII string.

+

+  This function returns the number of ASCII characters in the Null-terminated

+  ASCII string specified by String.

+

+  If Length > 0 and Destination is NULL, then ASSERT().

+  If Length > 0 and Source is NULL, then ASSERT().

+  If PcdMaximumAsciiStringLength is not zero and String contains more than

+  PcdMaximumAsciiStringLength ASCII characters not including the Null-terminator,

+  then ASSERT().

+

+  @param  String  The pointer to a Null-terminated ASCII string.

+

+  @return The length of String.

+

+**/

+UINTN

+EFIAPI

+AsciiStrLen (

+  IN      CONST CHAR8               *String

+  );

+

+

+/**

+  Returns the size of a Null-terminated ASCII string in bytes, including the

+  Null terminator.

+

+  This function returns the size, in bytes, of the Null-terminated ASCII string

+  specified by String.

+

+  If String is NULL, then ASSERT().

+  If PcdMaximumAsciiStringLength is not zero and String contains more than

+  PcdMaximumAsciiStringLength ASCII characters not including the Null-terminator,

+  then ASSERT().

+

+  @param  String  The pointer to a Null-terminated ASCII string.

+

+  @return The size of String.

+

+**/

+UINTN

+EFIAPI

+AsciiStrSize (

+  IN      CONST CHAR8               *String

+  );

+

+

+/**

+  Compares two Null-terminated ASCII strings, and returns the difference

+  between the first mismatched ASCII characters.

+

+  This function compares the Null-terminated ASCII string FirstString to the

+  Null-terminated ASCII string SecondString. If FirstString is identical to

+  SecondString, then 0 is returned. Otherwise, the value returned is the first

+  mismatched ASCII character in SecondString subtracted from the first

+  mismatched ASCII character in FirstString.

+

+  If FirstString is NULL, then ASSERT().

+  If SecondString is NULL, then ASSERT().

+  If PcdMaximumAsciiStringLength is not zero and FirstString contains more than

+  PcdMaximumAsciiStringLength ASCII characters not including the Null-terminator,

+  then ASSERT().

+  If PcdMaximumAsciiStringLength is not zero and SecondString contains more

+  than PcdMaximumAsciiStringLength ASCII characters not including the

+  Null-terminator, then ASSERT().

+

+  @param  FirstString   The pointer to a Null-terminated ASCII string.

+  @param  SecondString  The pointer to a Null-terminated ASCII string.

+

+  @retval ==0      FirstString is identical to SecondString.

+  @retval !=0      FirstString is not identical to SecondString.

+

+**/

+INTN

+EFIAPI

+AsciiStrCmp (

+  IN      CONST CHAR8               *FirstString,

+  IN      CONST CHAR8               *SecondString

+  );

+

+

+/**

+  Performs a case insensitive comparison of two Null-terminated ASCII strings,

+  and returns the difference between the first mismatched ASCII characters.

+

+  This function performs a case insensitive comparison of the Null-terminated

+  ASCII string FirstString to the Null-terminated ASCII string SecondString. If

+  FirstString is identical to SecondString, then 0 is returned. Otherwise, the

+  value returned is the first mismatched lower case ASCII character in

+  SecondString subtracted from the first mismatched lower case ASCII character

+  in FirstString.

+

+  If FirstString is NULL, then ASSERT().

+  If SecondString is NULL, then ASSERT().

+  If PcdMaximumAsciiStringLength is not zero and FirstString contains more than

+  PcdMaximumAsciiStringLength ASCII characters not including the Null-terminator,

+  then ASSERT().

+  If PcdMaximumAsciiStringLength is not zero and SecondString contains more

+  than PcdMaximumAsciiStringLength ASCII characters not including the

+  Null-terminator, then ASSERT().

+

+  @param  FirstString   The pointer to a Null-terminated ASCII string.

+  @param  SecondString  The pointer to a Null-terminated ASCII string.

+

+  @retval ==0    FirstString is identical to SecondString using case insensitive

+                 comparisons.

+  @retval !=0    FirstString is not identical to SecondString using case

+                 insensitive comparisons.

+

+**/

+INTN

+EFIAPI

+AsciiStriCmp (

+  IN      CONST CHAR8               *FirstString,

+  IN      CONST CHAR8               *SecondString

+  );

+

+

+/**

+  Compares two Null-terminated ASCII strings with maximum lengths, and returns

+  the difference between the first mismatched ASCII characters.

+

+  This function compares the Null-terminated ASCII string FirstString to the

+  Null-terminated ASCII  string SecondString. At most, Length ASCII characters

+  will be compared. If Length is 0, then 0 is returned. If FirstString is

+  identical to SecondString, then 0 is returned. Otherwise, the value returned

+  is the first mismatched ASCII character in SecondString subtracted from the

+  first mismatched ASCII character in FirstString.

+

+  If Length > 0 and FirstString is NULL, then ASSERT().

+  If Length > 0 and SecondString is NULL, then ASSERT().

+  If PcdMaximumAsciiStringLength is not zero, and Length is greater than

+  PcdMaximumAsciiStringLength, then ASSERT().

+  If PcdMaximumAsciiStringLength is not zero, and FirstString contains more than

+  PcdMaximumAsciiStringLength ASCII characters, not including the Null-terminator,

+  then ASSERT().

+  If PcdMaximumAsciiStringLength is not zero, and SecondString contains more than

+  PcdMaximumAsciiStringLength ASCII characters, not including the Null-terminator,

+  then ASSERT().

+

+  @param  FirstString   The pointer to a Null-terminated ASCII string.

+  @param  SecondString  The pointer to a Null-terminated ASCII string.

+  @param  Length        The maximum number of ASCII characters for compare.

+

+  @retval ==0       FirstString is identical to SecondString.

+  @retval !=0       FirstString is not identical to SecondString.

+

+**/

+INTN

+EFIAPI

+AsciiStrnCmp (

+  IN      CONST CHAR8               *FirstString,

+  IN      CONST CHAR8               *SecondString,

+  IN      UINTN                     Length

+  );

+

+

+#ifndef DISABLE_NEW_DEPRECATED_INTERFACES

+

+/**

+  [ATTENTION] This function is deprecated for security reason.

+

+  Concatenates one Null-terminated ASCII string to another Null-terminated

+  ASCII string, and returns the concatenated ASCII string.

+

+  This function concatenates two Null-terminated ASCII strings. The contents of

+  Null-terminated ASCII string Source are concatenated to the end of Null-

+  terminated ASCII string Destination. The Null-terminated concatenated ASCII

+  String is returned.

+

+  If Destination is NULL, then ASSERT().

+  If Source is NULL, then ASSERT().

+  If PcdMaximumAsciiStringLength is not zero and Destination contains more than

+  PcdMaximumAsciiStringLength ASCII characters not including the Null-terminator,

+  then ASSERT().

+  If PcdMaximumAsciiStringLength is not zero and Source contains more than

+  PcdMaximumAsciiStringLength ASCII characters not including the Null-terminator,

+  then ASSERT().

+  If PcdMaximumAsciiStringLength is not zero and concatenating Destination and

+  Source results in a ASCII string with more than PcdMaximumAsciiStringLength

+  ASCII characters, then ASSERT().

+

+  @param  Destination The pointer to a Null-terminated ASCII string.

+  @param  Source      The pointer to a Null-terminated ASCII string.

+

+  @return Destination

+

+**/

+CHAR8 *

+EFIAPI

+AsciiStrCat (

+  IN OUT CHAR8    *Destination,

+  IN CONST CHAR8  *Source

+  );

+

+

+/**

+  [ATTENTION] This function is deprecated for security reason.

+

+  Concatenates up to a specified length one Null-terminated ASCII string to

+  the end of another Null-terminated ASCII string, and returns the

+  concatenated ASCII string.

+

+  This function concatenates two Null-terminated ASCII strings. The contents

+  of Null-terminated ASCII string Source are concatenated to the end of Null-

+  terminated ASCII string Destination, and Destination is returned. At most,

+  Length ASCII characters are concatenated from Source to the end of

+  Destination, and Destination is always Null-terminated. If Length is 0, then

+  Destination is returned unmodified. If Source and Destination overlap, then

+  the results are undefined.

+

+  If Length > 0 and Destination is NULL, then ASSERT().

+  If Length > 0 and Source is NULL, then ASSERT().

+  If Source and Destination overlap, then ASSERT().

+  If PcdMaximumAsciiStringLength is not zero, and Length is greater than

+  PcdMaximumAsciiStringLength, then ASSERT().

+  If PcdMaximumAsciiStringLength is not zero, and Destination contains more than

+  PcdMaximumAsciiStringLength ASCII characters, not including the Null-terminator,

+  then ASSERT().

+  If PcdMaximumAsciiStringLength is not zero, and Source contains more than

+  PcdMaximumAsciiStringLength ASCII characters, not including the Null-terminator,

+  then ASSERT().

+  If PcdMaximumAsciiStringLength is not zero, and concatenating Destination and

+  Source results in a ASCII string with more than PcdMaximumAsciiStringLength

+  ASCII characters, not including the Null-terminator, then ASSERT().

+

+  @param  Destination The pointer to a Null-terminated ASCII string.

+  @param  Source      The pointer to a Null-terminated ASCII string.

+  @param  Length      The maximum number of ASCII characters to concatenate from

+                      Source.

+

+  @return Destination

+

+**/

+CHAR8 *

+EFIAPI

+AsciiStrnCat (

+  IN OUT  CHAR8                     *Destination,

+  IN      CONST CHAR8               *Source,

+  IN      UINTN                     Length

+  );

+#endif // !defined (DISABLE_NEW_DEPRECATED_INTERFACES)

+

+/**

+  Returns the first occurrence of a Null-terminated ASCII sub-string

+  in a Null-terminated ASCII string.

+

+  This function scans the contents of the ASCII string specified by String

+  and returns the first occurrence of SearchString. If SearchString is not

+  found in String, then NULL is returned. If the length of SearchString is zero,

+  then String is returned.

+

+  If String is NULL, then ASSERT().

+  If SearchString is NULL, then ASSERT().

+

+  If PcdMaximumAsciiStringLength is not zero, and SearchString or

+  String contains more than PcdMaximumAsciiStringLength Unicode characters

+  not including the Null-terminator, then ASSERT().

+

+  @param  String          The pointer to a Null-terminated ASCII string.

+  @param  SearchString    The pointer to a Null-terminated ASCII string to search for.

+

+  @retval NULL            If the SearchString does not appear in String.

+  @retval others          If there is a match return the first occurrence of SearchingString.

+                          If the length of SearchString is zero,return String.

+

+**/

+CHAR8 *

+EFIAPI

+AsciiStrStr (

+  IN      CONST CHAR8               *String,

+  IN      CONST CHAR8               *SearchString

+  );

+

+

+/**

+  Convert a Null-terminated ASCII decimal string to a value of type

+  UINTN.

+

+  This function returns a value of type UINTN by interpreting the contents

+  of the ASCII string String as a decimal number. The format of the input

+  ASCII string String is:

+

+                    [spaces] [decimal digits].

+

+  The valid decimal digit character is in the range [0-9]. The function will

+  ignore the pad space, which includes spaces or tab characters, before the digits.

+  The running zero in the beginning of [decimal digits] will be ignored. Then, the

+  function stops at the first character that is a not a valid decimal character or

+  Null-terminator, whichever on comes first.

+

+  If String has only pad spaces, then 0 is returned.

+  If String has no pad spaces or valid decimal digits, then 0 is returned.

+  If the number represented by String overflows according to the range defined by

+  UINTN, then MAX_UINTN is returned.

+  If String is NULL, then ASSERT().

+  If PcdMaximumAsciiStringLength is not zero, and String contains more than

+  PcdMaximumAsciiStringLength ASCII characters not including the Null-terminator,

+  then ASSERT().

+

+  @param  String          The pointer to a Null-terminated ASCII string.

+

+  @retval The value translated from String.

+

+**/

+UINTN

+EFIAPI

+AsciiStrDecimalToUintn (

+  IN      CONST CHAR8               *String

+  );

+

+

+/**

+  Convert a Null-terminated ASCII decimal string to a value of type

+  UINT64.

+

+  This function returns a value of type UINT64 by interpreting the contents

+  of the ASCII string String as a decimal number. The format of the input

+  ASCII string String is:

+

+                    [spaces] [decimal digits].

+

+  The valid decimal digit character is in the range [0-9]. The function will

+  ignore the pad space, which includes spaces or tab characters, before the digits.

+  The running zero in the beginning of [decimal digits] will be ignored. Then, the

+  function stops at the first character that is a not a valid decimal character or

+  Null-terminator, whichever on comes first.

+

+  If String has only pad spaces, then 0 is returned.

+  If String has no pad spaces or valid decimal digits, then 0 is returned.

+  If the number represented by String overflows according to the range defined by

+  UINT64, then MAX_UINT64 is returned.

+  If String is NULL, then ASSERT().

+  If PcdMaximumAsciiStringLength is not zero, and String contains more than

+  PcdMaximumAsciiStringLength ASCII characters not including the Null-terminator,

+  then ASSERT().

+

+  @param  String          The pointer to a Null-terminated ASCII string.

+

+  @retval Value translated from String.

+

+**/

+UINT64

+EFIAPI

+AsciiStrDecimalToUint64 (

+  IN      CONST CHAR8               *String

+  );

+

+

+/**

+  Convert a Null-terminated ASCII hexadecimal string to a value of type UINTN.

+

+  This function returns a value of type UINTN by interpreting the contents of

+  the ASCII string String as a hexadecimal number. The format of the input ASCII

+  string String is:

+

+                  [spaces][zeros][x][hexadecimal digits].

+

+  The valid hexadecimal digit character is in the range [0-9], [a-f] and [A-F].

+  The prefix "0x" is optional. Both "x" and "X" is allowed in "0x" prefix. If "x"

+  appears in the input string, it must be prefixed with at least one 0. The function

+  will ignore the pad space, which includes spaces or tab characters, before [zeros],

+  [x] or [hexadecimal digits]. The running zero before [x] or [hexadecimal digits]

+  will be ignored. Then, the decoding starts after [x] or the first valid hexadecimal

+  digit. Then, the function stops at the first character that is a not a valid

+  hexadecimal character or Null-terminator, whichever on comes first.

+

+  If String has only pad spaces, then 0 is returned.

+  If String has no leading pad spaces, leading zeros or valid hexadecimal digits, then

+  0 is returned.

+

+  If the number represented by String overflows according to the range defined by UINTN,

+  then MAX_UINTN is returned.

+  If String is NULL, then ASSERT().

+  If PcdMaximumAsciiStringLength is not zero,

+  and String contains more than PcdMaximumAsciiStringLength ASCII characters not including

+  the Null-terminator, then ASSERT().

+

+  @param  String          The pointer to a Null-terminated ASCII string.

+

+  @retval Value translated from String.

+

+**/

+UINTN

+EFIAPI

+AsciiStrHexToUintn (

+  IN      CONST CHAR8               *String

+  );

+

+

+/**

+  Convert a Null-terminated ASCII hexadecimal string to a value of type UINT64.

+

+  This function returns a value of type UINT64 by interpreting the contents of

+  the ASCII string String as a hexadecimal number. The format of the input ASCII

+  string String is:

+

+                  [spaces][zeros][x][hexadecimal digits].

+

+  The valid hexadecimal digit character is in the range [0-9], [a-f] and [A-F].

+  The prefix "0x" is optional. Both "x" and "X" is allowed in "0x" prefix. If "x"

+  appears in the input string, it must be prefixed with at least one 0. The function

+  will ignore the pad space, which includes spaces or tab characters, before [zeros],

+  [x] or [hexadecimal digits]. The running zero before [x] or [hexadecimal digits]

+  will be ignored. Then, the decoding starts after [x] or the first valid hexadecimal

+  digit. Then, the function stops at the first character that is a not a valid

+  hexadecimal character or Null-terminator, whichever on comes first.

+

+  If String has only pad spaces, then 0 is returned.

+  If String has no leading pad spaces, leading zeros or valid hexadecimal digits, then

+  0 is returned.

+

+  If the number represented by String overflows according to the range defined by UINT64,

+  then MAX_UINT64 is returned.

+  If String is NULL, then ASSERT().

+  If PcdMaximumAsciiStringLength is not zero,

+  and String contains more than PcdMaximumAsciiStringLength ASCII characters not including

+  the Null-terminator, then ASSERT().

+

+  @param  String          The pointer to a Null-terminated ASCII string.

+

+  @retval Value translated from String.

+

+**/

+UINT64

+EFIAPI

+AsciiStrHexToUint64 (

+  IN      CONST CHAR8                *String

+  );

+

+/**

+  Convert a Null-terminated ASCII string to IPv6 address and prefix length.

+

+  This function outputs a value of type IPv6_ADDRESS and may output a value

+  of type UINT8 by interpreting the contents of the ASCII string specified

+  by String. The format of the input ASCII string String is as follows:

+

+                  X:X:X:X:X:X:X:X[/P]

+

+  X contains one to four hexadecimal digit characters in the range [0-9], [a-f] and

+  [A-F]. X is converted to a value of type UINT16, whose low byte is stored in low

+  memory address and high byte is stored in high memory address. P contains decimal

+  digit characters in the range [0-9]. The running zero in the beginning of P will

+  be ignored. /P is optional.

+

+  When /P is not in the String, the function stops at the first character that is

+  not a valid hexadecimal digit character after eight X's are converted.

+

+  When /P is in the String, the function stops at the first character that is not

+  a valid decimal digit character after P is converted.

+

+  "::" can be used to compress one or more groups of X when X contains only 0.

+  The "::" can only appear once in the String.

+

+  If EndPointer is not NULL and Address is translated from String, a pointer

+  to the character that stopped the scan is stored at the location pointed to

+  by EndPointer.

+

+  @param  String                   Pointer to a Null-terminated ASCII string.

+  @param  EndPointer               Pointer to character that stops scan.

+  @param  Address                  Pointer to the converted IPv6 address.

+  @param  PrefixLength             Pointer to the converted IPv6 address prefix

+                                   length. MAX_UINT8 is returned when /P is

+                                   not in the String.

+

+  @retval RETURN_SUCCESS           Address is translated from String.

+  @retval RETURN_INVALID_PARAMETER If String is NULL.

+                                   If Data is NULL.

+  @retval RETURN_UNSUPPORTED       If X contains more than four hexadecimal

+                                    digit characters.

+                                   If String contains "::" and number of X

+                                    is not less than 8.

+                                   If P starts with character that is not a

+                                    valid decimal digit character.

+                                   If the decimal number converted from P

+                                    exceeds 128.

+

+**/

+RETURN_STATUS

+EFIAPI

+AsciiStrToIpv6Address (

+  IN  CONST CHAR8        *String,

+  OUT CHAR8              **EndPointer, OPTIONAL

+  OUT IPv6_ADDRESS       *Address,

+  OUT UINT8              *PrefixLength OPTIONAL

+  );

+

+/**

+  Convert a Null-terminated ASCII string to IPv4 address and prefix length.

+

+  This function outputs a value of type IPv4_ADDRESS and may output a value

+  of type UINT8 by interpreting the contents of the ASCII string specified

+  by String. The format of the input ASCII string String is as follows:

+

+                  D.D.D.D[/P]

+

+  D and P are decimal digit characters in the range [0-9]. The running zero in

+  the beginning of D and P will be ignored. /P is optional.

+

+  When /P is not in the String, the function stops at the first character that is

+  not a valid decimal digit character after four D's are converted.

+

+  When /P is in the String, the function stops at the first character that is not

+  a valid decimal digit character after P is converted.

+

+  If EndPointer is not NULL and Address is translated from String, a pointer

+  to the character that stopped the scan is stored at the location pointed to

+  by EndPointer.

+

+  @param  String                   Pointer to a Null-terminated ASCII string.

+  @param  EndPointer               Pointer to character that stops scan.

+  @param  Address                  Pointer to the converted IPv4 address.

+  @param  PrefixLength             Pointer to the converted IPv4 address prefix

+                                   length. MAX_UINT8 is returned when /P is

+                                   not in the String.

+

+  @retval RETURN_SUCCESS           Address is translated from String.

+  @retval RETURN_INVALID_PARAMETER If String is NULL.

+                                   If Data is NULL.

+  @retval RETURN_UNSUPPORTED       If String is not in the correct format.

+                                   If any decimal number converted from D

+                                    exceeds 255.

+                                   If the decimal number converted from P

+                                    exceeds 32.

+

+**/

+RETURN_STATUS

+EFIAPI

+AsciiStrToIpv4Address (

+  IN  CONST CHAR8        *String,

+  OUT CHAR8              **EndPointer, OPTIONAL

+  OUT IPv4_ADDRESS       *Address,

+  OUT UINT8              *PrefixLength OPTIONAL

+  );

+

+/**

+  Convert a Null-terminated ASCII GUID string to a value of type

+  EFI_GUID.

+

+  This function outputs a GUID value by interpreting the contents of

+  the ASCII string specified by String. The format of the input

+  ASCII string String consists of 36 characters, as follows:

+

+                  aabbccdd-eeff-gghh-iijj-kkllmmnnoopp

+

+  The pairs aa - pp are two characters in the range [0-9], [a-f] and

+  [A-F], with each pair representing a single byte hexadecimal value.

+

+  The mapping between String and the EFI_GUID structure is as follows:

+                  aa          Data1[24:31]

+                  bb          Data1[16:23]

+                  cc          Data1[8:15]

+                  dd          Data1[0:7]

+                  ee          Data2[8:15]

+                  ff          Data2[0:7]

+                  gg          Data3[8:15]

+                  hh          Data3[0:7]

+                  ii          Data4[0:7]

+                  jj          Data4[8:15]

+                  kk          Data4[16:23]

+                  ll          Data4[24:31]

+                  mm          Data4[32:39]

+                  nn          Data4[40:47]

+                  oo          Data4[48:55]

+                  pp          Data4[56:63]

+

+  @param  String                   Pointer to a Null-terminated ASCII string.

+  @param  Guid                     Pointer to the converted GUID.

+

+  @retval RETURN_SUCCESS           Guid is translated from String.

+  @retval RETURN_INVALID_PARAMETER If String is NULL.

+                                   If Data is NULL.

+  @retval RETURN_UNSUPPORTED       If String is not as the above format.

+

+**/

+RETURN_STATUS

+EFIAPI

+AsciiStrToGuid (

+  IN  CONST CHAR8        *String,

+  OUT GUID               *Guid

+  );

+

+/**

+  Convert a Null-terminated ASCII hexadecimal string to a byte array.

+

+  This function outputs a byte array by interpreting the contents of

+  the ASCII string specified by String in hexadecimal format. The format of

+  the input ASCII string String is:

+

+                  [XX]*

+

+  X is a hexadecimal digit character in the range [0-9], [a-f] and [A-F].

+  The function decodes every two hexadecimal digit characters as one byte. The

+  decoding stops after Length of characters and outputs Buffer containing

+  (Length / 2) bytes.

+

+  @param  String                   Pointer to a Null-terminated ASCII string.

+  @param  Length                   The number of ASCII characters to decode.

+  @param  Buffer                   Pointer to the converted bytes array.

+  @param  MaxBufferSize            The maximum size of Buffer.

+

+  @retval RETURN_SUCCESS           Buffer is translated from String.

+  @retval RETURN_INVALID_PARAMETER If String is NULL.

+                                   If Data is NULL.

+                                   If Length is not multiple of 2.

+                                   If PcdMaximumAsciiStringLength is not zero,

+                                    and Length is greater than

+                                    PcdMaximumAsciiStringLength.

+  @retval RETURN_UNSUPPORTED       If Length of characters from String contain

+                                    a character that is not valid hexadecimal

+                                    digit characters, or a Null-terminator.

+  @retval RETURN_BUFFER_TOO_SMALL  If MaxBufferSize is less than (Length / 2).

+**/

+RETURN_STATUS

+EFIAPI

+AsciiStrHexToBytes (

+  IN  CONST CHAR8        *String,

+  IN  UINTN              Length,

+  OUT UINT8              *Buffer,

+  IN  UINTN              MaxBufferSize

+  );

+

+#ifndef DISABLE_NEW_DEPRECATED_INTERFACES

+

+/**

+  [ATTENTION] This function is deprecated for security reason.

+

+  Convert one Null-terminated ASCII string to a Null-terminated

+  Unicode string and returns the Unicode string.

+

+  This function converts the contents of the ASCII string Source to the Unicode

+  string Destination, and returns Destination.  The function terminates the

+  Unicode string Destination by appending a Null-terminator character at the end.

+  The caller is responsible to make sure Destination points to a buffer with size

+  equal or greater than ((AsciiStrLen (Source) + 1) * sizeof (CHAR16)) in bytes.

+

+  If Destination is NULL, then ASSERT().

+  If Destination is not aligned on a 16-bit boundary, then ASSERT().

+  If Source is NULL, then ASSERT().

+  If Source and Destination overlap, then ASSERT().

+  If PcdMaximumAsciiStringLength is not zero, and Source contains more than

+  PcdMaximumAsciiStringLength ASCII characters not including the Null-terminator,

+  then ASSERT().

+  If PcdMaximumUnicodeStringLength is not zero, and Source contains more than

+  PcdMaximumUnicodeStringLength ASCII characters not including the

+  Null-terminator, then ASSERT().

+

+  @param  Source        The pointer to a Null-terminated ASCII string.

+  @param  Destination   The pointer to a Null-terminated Unicode string.

+

+  @return Destination.

+

+**/

+CHAR16 *

+EFIAPI

+AsciiStrToUnicodeStr (

+  IN      CONST CHAR8               *Source,

+  OUT     CHAR16                    *Destination

+  );

+

+#endif // !defined (DISABLE_NEW_DEPRECATED_INTERFACES)

+

+/**

+  Convert one Null-terminated ASCII string to a Null-terminated

+  Unicode string.

+

+  This function is similar to StrCpyS.

+

+  This function converts the contents of the ASCII string Source to the Unicode

+  string Destination. The function terminates the Unicode string Destination by

+  appending a Null-terminator character at the end.

+

+  The caller is responsible to make sure Destination points to a buffer with size

+  equal or greater than ((AsciiStrLen (Source) + 1) * sizeof (CHAR16)) in bytes.

+

+  If Destination is not aligned on a 16-bit boundary, then ASSERT().

+

+  If an error is returned, then the Destination is unmodified.

+

+  @param  Source        The pointer to a Null-terminated ASCII string.

+  @param  Destination   The pointer to a Null-terminated Unicode string.

+  @param  DestMax       The maximum number of Destination Unicode

+                        char, including terminating null char.

+

+  @retval RETURN_SUCCESS           String is converted.

+  @retval RETURN_BUFFER_TOO_SMALL  If DestMax is NOT greater than StrLen(Source).

+  @retval RETURN_INVALID_PARAMETER If Destination is NULL.

+                                   If Source is NULL.

+                                   If PcdMaximumUnicodeStringLength is not zero,

+                                    and DestMax is greater than

+                                    PcdMaximumUnicodeStringLength.

+                                   If PcdMaximumAsciiStringLength is not zero,

+                                    and DestMax is greater than

+                                    PcdMaximumAsciiStringLength.

+                                   If DestMax is 0.

+  @retval RETURN_ACCESS_DENIED     If Source and Destination overlap.

+

+**/

+RETURN_STATUS

+EFIAPI

+AsciiStrToUnicodeStrS (

+  IN      CONST CHAR8               *Source,

+  OUT     CHAR16                    *Destination,

+  IN      UINTN                     DestMax

+  );

+

+/**

+  Convert not more than Length successive characters from a Null-terminated

+  Ascii string to a Null-terminated Unicode string. If no null char is copied

+  from Source, then Destination[Length] is always set to null.

+

+  This function converts not more than Length successive characters from the

+  Ascii string Source to the Unicode string Destination. The function

+  terminates the Unicode string Destination by appending a Null-terminator

+  character at the end.

+

+  The caller is responsible to make sure Destination points to a buffer with

+  size not smaller than

+  ((MIN(AsciiStrLen(Source), Length) + 1) * sizeof (CHAR8)) in bytes.

+

+  If Destination is not aligned on a 16-bit boundary, then ASSERT().

+

+  If an error is returned, then Destination and DestinationLength are

+  unmodified.

+

+  @param  Source             The pointer to a Null-terminated Ascii string.

+  @param  Length             The maximum number of Ascii characters to convert.

+  @param  Destination        The pointer to a Null-terminated Unicode string.

+  @param  DestMax            The maximum number of Destination Unicode char,

+                             including terminating null char.

+  @param  DestinationLength  The number of Ascii characters converted.

+

+  @retval RETURN_SUCCESS            String is converted.

+  @retval RETURN_INVALID_PARAMETER  If Destination is NULL.

+                                    If Source is NULL.

+                                    If DestinationLength is NULL.

+                                    If PcdMaximumUnicodeStringLength is not

+                                    zero, and Length or DestMax is greater than

+                                    PcdMaximumUnicodeStringLength.

+                                    If PcdMaximumAsciiStringLength is not zero,

+                                    and Length or DestMax is greater than

+                                    PcdMaximumAsciiStringLength.

+                                    If DestMax is 0.

+  @retval RETURN_BUFFER_TOO_SMALL   If DestMax is NOT greater than

+                                    MIN(AsciiStrLen(Source), Length).

+  @retval RETURN_ACCESS_DENIED      If Source and Destination overlap.

+

+**/

+RETURN_STATUS

+EFIAPI

+AsciiStrnToUnicodeStrS (

+  IN      CONST CHAR8               *Source,

+  IN      UINTN                     Length,

+  OUT     CHAR16                    *Destination,

+  IN      UINTN                     DestMax,

+  OUT     UINTN                     *DestinationLength

+  );

+

+/**

+  Convert a Unicode character to upper case only if

+  it maps to a valid small-case ASCII character.

+

+  This internal function only deal with Unicode character

+  which maps to a valid small-case ASCII character, i.e.

+  L'a' to L'z'. For other Unicode character, the input character

+  is returned directly.

+

+  @param  Char  The character to convert.

+

+  @retval LowerCharacter   If the Char is with range L'a' to L'z'.

+  @retval Unchanged        Otherwise.

+

+**/

+CHAR16

+EFIAPI

+CharToUpper (

+  IN      CHAR16                    Char

+  );

+

+/**

+  Converts a lowercase Ascii character to upper one.

+

+  If Chr is lowercase Ascii character, then converts it to upper one.

+

+  If Value >= 0xA0, then ASSERT().

+  If (Value & 0x0F) >= 0x0A, then ASSERT().

+

+  @param  Chr   one Ascii character

+

+  @return The uppercase value of Ascii character

+

+**/

+CHAR8

+EFIAPI

+AsciiCharToUpper (

+  IN      CHAR8                     Chr

+  );

+

+/**

+  Convert binary data to a Base64 encoded ascii string based on RFC4648.

+

+  Produce a Null-terminated Ascii string in the output buffer specified by Destination and DestinationSize.

+  The Ascii string is produced by converting the data string specified by Source and SourceLength.

+

+  @param Source           Input UINT8 data

+  @param SourceLength     Number of UINT8 bytes of data

+  @param Destination      Pointer to output string buffer

+  @param DestinationSize  Size of ascii buffer. Set to 0 to get the size needed.

+                          Caller is responsible for passing in buffer of DestinationSize

+

+  @retval RETURN_SUCCESS             When ascii buffer is filled in.

+  @retval RETURN_INVALID_PARAMETER   If Source is NULL or DestinationSize is NULL.

+  @retval RETURN_INVALID_PARAMETER   If SourceLength or DestinationSize is bigger than (MAX_ADDRESS - (UINTN)Destination).

+  @retval RETURN_BUFFER_TOO_SMALL    If SourceLength is 0 and DestinationSize is <1.

+  @retval RETURN_BUFFER_TOO_SMALL    If Destination is NULL or DestinationSize is smaller than required buffersize.

+

+**/

+RETURN_STATUS

+EFIAPI

+Base64Encode (

+  IN  CONST UINT8  *Source,

+  IN        UINTN   SourceLength,

+  OUT       CHAR8  *Destination  OPTIONAL,

+  IN OUT    UINTN  *DestinationSize

+  );

+

+/**

+  Decode Base64 ASCII encoded data to 8-bit binary representation, based on

+  RFC4648.

+

+  Decoding occurs according to "Table 1: The Base 64 Alphabet" in RFC4648.

+

+  Whitespace is ignored at all positions:

+  - 0x09 ('\t') horizontal tab

+  - 0x0A ('\n') new line

+  - 0x0B ('\v') vertical tab

+  - 0x0C ('\f') form feed

+  - 0x0D ('\r') carriage return

+  - 0x20 (' ')  space

+

+  The minimum amount of required padding (with ASCII 0x3D, '=') is tolerated

+  and enforced at the end of the Base64 ASCII encoded data, and only there.

+

+  Other characters outside of the encoding alphabet cause the function to

+  reject the Base64 ASCII encoded data.

+

+  @param[in] Source               Array of CHAR8 elements containing the Base64

+                                  ASCII encoding. May be NULL if SourceSize is

+                                  zero.

+

+  @param[in] SourceSize           Number of CHAR8 elements in Source.

+

+  @param[out] Destination         Array of UINT8 elements receiving the decoded

+                                  8-bit binary representation. Allocated by the

+                                  caller. May be NULL if DestinationSize is

+                                  zero on input. If NULL, decoding is

+                                  performed, but the 8-bit binary

+                                  representation is not stored. If non-NULL and

+                                  the function returns an error, the contents

+                                  of Destination are indeterminate.

+

+  @param[in,out] DestinationSize  On input, the number of UINT8 elements that

+                                  the caller allocated for Destination. On

+                                  output, if the function returns

+                                  RETURN_SUCCESS or RETURN_BUFFER_TOO_SMALL,

+                                  the number of UINT8 elements that are

+                                  required for decoding the Base64 ASCII

+                                  representation. If the function returns a

+                                  value different from both RETURN_SUCCESS and

+                                  RETURN_BUFFER_TOO_SMALL, then DestinationSize

+                                  is indeterminate on output.

+

+  @retval RETURN_SUCCESS            SourceSize CHAR8 elements at Source have

+                                    been decoded to on-output DestinationSize

+                                    UINT8 elements at Destination. Note that

+                                    RETURN_SUCCESS covers the case when

+                                    DestinationSize is zero on input, and

+                                    Source decodes to zero bytes (due to

+                                    containing at most ignored whitespace).

+

+  @retval RETURN_BUFFER_TOO_SMALL   The input value of DestinationSize is not

+                                    large enough for decoding SourceSize CHAR8

+                                    elements at Source. The required number of

+                                    UINT8 elements has been stored to

+                                    DestinationSize.

+

+  @retval RETURN_INVALID_PARAMETER  DestinationSize is NULL.

+

+  @retval RETURN_INVALID_PARAMETER  Source is NULL, but SourceSize is not zero.

+

+  @retval RETURN_INVALID_PARAMETER  Destination is NULL, but DestinationSize is

+                                    not zero on input.

+

+  @retval RETURN_INVALID_PARAMETER  Source is non-NULL, and (Source +

+                                    SourceSize) would wrap around MAX_ADDRESS.

+

+  @retval RETURN_INVALID_PARAMETER  Destination is non-NULL, and (Destination +

+                                    DestinationSize) would wrap around

+                                    MAX_ADDRESS, as specified on input.

+

+  @retval RETURN_INVALID_PARAMETER  None of Source and Destination are NULL,

+                                    and CHAR8[SourceSize] at Source overlaps

+                                    UINT8[DestinationSize] at Destination, as

+                                    specified on input.

+

+  @retval RETURN_INVALID_PARAMETER  Invalid CHAR8 element encountered in

+                                    Source.

+**/

+RETURN_STATUS

+EFIAPI

+Base64Decode (

+  IN     CONST CHAR8 *Source          OPTIONAL,

+  IN     UINTN       SourceSize,

+  OUT    UINT8       *Destination     OPTIONAL,

+  IN OUT UINTN       *DestinationSize

+  );

+

+/**

+  Converts an 8-bit value to an 8-bit BCD value.

+

+  Converts the 8-bit value specified by Value to BCD. The BCD value is

+  returned.

+

+  If Value >= 100, then ASSERT().

+

+  @param  Value The 8-bit value to convert to BCD. Range 0..99.

+

+  @return The BCD value.

+

+**/

+UINT8

+EFIAPI

+DecimalToBcd8 (

+  IN      UINT8                     Value

+  );

+

+

+/**

+  Converts an 8-bit BCD value to an 8-bit value.

+

+  Converts the 8-bit BCD value specified by Value to an 8-bit value. The 8-bit

+  value is returned.

+

+  If Value >= 0xA0, then ASSERT().

+  If (Value & 0x0F) >= 0x0A, then ASSERT().

+

+  @param  Value The 8-bit BCD value to convert to an 8-bit value.

+

+  @return The 8-bit value is returned.

+

+**/

+UINT8

+EFIAPI

+BcdToDecimal8 (

+  IN      UINT8                     Value

+  );

+

+//

+//  File Path Manipulation Functions

+//

+

+/**

+  Removes the last directory or file entry in a path.

+

+  @param[in, out] Path    The pointer to the path to modify.

+

+  @retval FALSE     Nothing was found to remove.

+  @retval TRUE      A directory or file was removed.

+**/

+BOOLEAN

+EFIAPI

+PathRemoveLastItem(

+  IN OUT CHAR16 *Path

+  );

+

+/**

+  Function to clean up paths.

+    - Single periods in the path are removed.

+    - Double periods in the path are removed along with a single parent directory.

+    - Forward slashes L'/' are converted to backward slashes L'\'.

+

+  This will be done inline and the existing buffer may be larger than required

+  upon completion.

+

+  @param[in] Path       The pointer to the string containing the path.

+

+  @return       Returns Path, otherwise returns NULL to indicate that an error has occurred.

+**/

+CHAR16*

+EFIAPI

+PathCleanUpDirectories(

+  IN CHAR16 *Path

+  );

+

+//

+// Linked List Functions and Macros

+//

+

+/**

+  Initializes the head node of a doubly linked list that is declared as a

+  global variable in a module.

+

+  Initializes the forward and backward links of a new linked list. After

+  initializing a linked list with this macro, the other linked list functions

+  may be used to add and remove nodes from the linked list. This macro results

+  in smaller executables by initializing the linked list in the data section,

+  instead if calling the InitializeListHead() function to perform the

+  equivalent operation.

+

+  @param  ListHead  The head note of a list to initialize.

+

+**/

+#define INITIALIZE_LIST_HEAD_VARIABLE(ListHead)  {&(ListHead), &(ListHead)}

+

+/**

+  Iterates over each node in a doubly linked list using each node's forward link.

+

+  @param  Entry     A pointer to a list node used as a loop cursor during iteration

+  @param  ListHead  The head node of the doubly linked list

+

+**/

+#define BASE_LIST_FOR_EACH(Entry, ListHead)    \

+  for(Entry = (ListHead)->ForwardLink; Entry != (ListHead); Entry = Entry->ForwardLink)

+

+/**

+  Iterates over each node in a doubly linked list using each node's forward link

+  with safety against node removal.

+

+  This macro uses NextEntry to temporarily store the next list node so the node

+  pointed to by Entry may be deleted in the current loop iteration step and

+  iteration can continue from the node pointed to by NextEntry.

+

+  @param  Entry     A pointer to a list node used as a loop cursor during iteration

+  @param  NextEntry A pointer to a list node used to temporarily store the next node

+  @param  ListHead  The head node of the doubly linked list

+

+**/

+#define BASE_LIST_FOR_EACH_SAFE(Entry, NextEntry, ListHead)            \

+  for(Entry = (ListHead)->ForwardLink, NextEntry = Entry->ForwardLink;\

+      Entry != (ListHead); Entry = NextEntry, NextEntry = Entry->ForwardLink)

+

+/**

+  Checks whether FirstEntry and SecondEntry are part of the same doubly-linked

+  list.

+

+  If FirstEntry is NULL, then ASSERT().

+  If FirstEntry->ForwardLink is NULL, then ASSERT().

+  If FirstEntry->BackLink is NULL, then ASSERT().

+  If SecondEntry is NULL, then ASSERT();

+  If PcdMaximumLinkedListLength is not zero, and List contains more than

+  PcdMaximumLinkedListLength nodes, then ASSERT().

+

+  @param  FirstEntry   A pointer to a node in a linked list.

+  @param  SecondEntry  A pointer to the node to locate.

+

+  @retval TRUE   SecondEntry is in the same doubly-linked list as FirstEntry.

+  @retval FALSE  SecondEntry isn't in the same doubly-linked list as FirstEntry,

+                 or FirstEntry is invalid.

+

+**/

+BOOLEAN

+EFIAPI

+IsNodeInList (

+  IN      CONST LIST_ENTRY      *FirstEntry,

+  IN      CONST LIST_ENTRY      *SecondEntry

+  );

+

+

+/**

+  Initializes the head node of a doubly linked list, and returns the pointer to

+  the head node of the doubly linked list.

+

+  Initializes the forward and backward links of a new linked list. After

+  initializing a linked list with this function, the other linked list

+  functions may be used to add and remove nodes from the linked list. It is up

+  to the caller of this function to allocate the memory for ListHead.

+

+  If ListHead is NULL, then ASSERT().

+

+  @param  ListHead  A pointer to the head node of a new doubly linked list.

+

+  @return ListHead

+

+**/

+LIST_ENTRY *

+EFIAPI

+InitializeListHead (

+  IN OUT  LIST_ENTRY                *ListHead

+  );

+

+

+/**

+  Adds a node to the beginning of a doubly linked list, and returns the pointer

+  to the head node of the doubly linked list.

+

+  Adds the node Entry at the beginning of the doubly linked list denoted by

+  ListHead, and returns ListHead.

+

+  If ListHead is NULL, then ASSERT().

+  If Entry is NULL, then ASSERT().

+  If ListHead was not initialized with INTIALIZE_LIST_HEAD_VARIABLE() or

+  InitializeListHead(), then ASSERT().

+  If PcdMaximumLinkedListLength is not zero, and prior to insertion the number

+  of nodes in ListHead, including the ListHead node, is greater than or

+  equal to PcdMaximumLinkedListLength, then ASSERT().

+

+  @param  ListHead  A pointer to the head node of a doubly linked list.

+  @param  Entry     A pointer to a node that is to be inserted at the beginning

+                    of a doubly linked list.

+

+  @return ListHead

+

+**/

+LIST_ENTRY *

+EFIAPI

+InsertHeadList (

+  IN OUT  LIST_ENTRY                *ListHead,

+  IN OUT  LIST_ENTRY                *Entry

+  );

+

+

+/**

+  Adds a node to the end of a doubly linked list, and returns the pointer to

+  the head node of the doubly linked list.

+

+  Adds the node Entry to the end of the doubly linked list denoted by ListHead,

+  and returns ListHead.

+

+  If ListHead is NULL, then ASSERT().

+  If Entry is NULL, then ASSERT().

+  If ListHead was not initialized with INTIALIZE_LIST_HEAD_VARIABLE() or

+  InitializeListHead(), then ASSERT().

+  If PcdMaximumLinkedListLength is not zero, and prior to insertion the number

+  of nodes in ListHead, including the ListHead node, is greater than or

+  equal to PcdMaximumLinkedListLength, then ASSERT().

+

+  @param  ListHead  A pointer to the head node of a doubly linked list.

+  @param  Entry     A pointer to a node that is to be added at the end of the

+                    doubly linked list.

+

+  @return ListHead

+

+**/

+LIST_ENTRY *

+EFIAPI

+InsertTailList (

+  IN OUT  LIST_ENTRY                *ListHead,

+  IN OUT  LIST_ENTRY                *Entry

+  );

+

+

+/**

+  Retrieves the first node of a doubly linked list.

+

+  Returns the first node of a doubly linked list.  List must have been

+  initialized with INTIALIZE_LIST_HEAD_VARIABLE() or InitializeListHead().

+  If List is empty, then List is returned.

+

+  If List is NULL, then ASSERT().

+  If List was not initialized with INTIALIZE_LIST_HEAD_VARIABLE() or

+  InitializeListHead(), then ASSERT().

+  If PcdMaximumLinkedListLength is not zero, and the number of nodes

+  in List, including the List node, is greater than or equal to

+  PcdMaximumLinkedListLength, then ASSERT().

+

+  @param  List  A pointer to the head node of a doubly linked list.

+

+  @return The first node of a doubly linked list.

+  @retval List  The list is empty.

+

+**/

+LIST_ENTRY *

+EFIAPI

+GetFirstNode (

+  IN      CONST LIST_ENTRY          *List

+  );

+

+

+/**

+  Retrieves the next node of a doubly linked list.

+

+  Returns the node of a doubly linked list that follows Node.

+  List must have been initialized with INTIALIZE_LIST_HEAD_VARIABLE()

+  or InitializeListHead().  If List is empty, then List is returned.

+

+  If List is NULL, then ASSERT().

+  If Node is NULL, then ASSERT().

+  If List was not initialized with INTIALIZE_LIST_HEAD_VARIABLE() or

+  InitializeListHead(), then ASSERT().

+  If PcdMaximumLinkedListLength is not zero, and List contains more than

+  PcdMaximumLinkedListLength nodes, then ASSERT().

+  If PcdVerifyNodeInList is TRUE and Node is not a node in List, then ASSERT().

+

+  @param  List  A pointer to the head node of a doubly linked list.

+  @param  Node  A pointer to a node in the doubly linked list.

+

+  @return The pointer to the next node if one exists. Otherwise List is returned.

+

+**/

+LIST_ENTRY *

+EFIAPI

+GetNextNode (

+  IN      CONST LIST_ENTRY          *List,

+  IN      CONST LIST_ENTRY          *Node

+  );

+

+

+/**

+  Retrieves the previous node of a doubly linked list.

+

+  Returns the node of a doubly linked list that precedes Node.

+  List must have been initialized with INTIALIZE_LIST_HEAD_VARIABLE()

+  or InitializeListHead().  If List is empty, then List is returned.

+

+  If List is NULL, then ASSERT().

+  If Node is NULL, then ASSERT().

+  If List was not initialized with INTIALIZE_LIST_HEAD_VARIABLE() or

+  InitializeListHead(), then ASSERT().

+  If PcdMaximumLinkedListLength is not zero, and List contains more than

+  PcdMaximumLinkedListLength nodes, then ASSERT().

+  If PcdVerifyNodeInList is TRUE and Node is not a node in List, then ASSERT().

+

+  @param  List  A pointer to the head node of a doubly linked list.

+  @param  Node  A pointer to a node in the doubly linked list.

+

+  @return The pointer to the previous node if one exists. Otherwise List is returned.

+

+**/

+LIST_ENTRY *

+EFIAPI

+GetPreviousNode (

+  IN      CONST LIST_ENTRY          *List,

+  IN      CONST LIST_ENTRY          *Node

+  );

+

+

+/**

+  Checks to see if a doubly linked list is empty or not.

+

+  Checks to see if the doubly linked list is empty. If the linked list contains

+  zero nodes, this function returns TRUE. Otherwise, it returns FALSE.

+

+  If ListHead is NULL, then ASSERT().

+  If ListHead was not initialized with INTIALIZE_LIST_HEAD_VARIABLE() or

+  InitializeListHead(), then ASSERT().

+  If PcdMaximumLinkedListLength is not zero, and the number of nodes

+  in List, including the List node, is greater than or equal to

+  PcdMaximumLinkedListLength, then ASSERT().

+

+  @param  ListHead  A pointer to the head node of a doubly linked list.

+

+  @retval TRUE  The linked list is empty.

+  @retval FALSE The linked list is not empty.

+

+**/

+BOOLEAN

+EFIAPI

+IsListEmpty (

+  IN      CONST LIST_ENTRY          *ListHead

+  );

+

+

+/**

+  Determines if a node in a doubly linked list is the head node of a the same

+  doubly linked list.  This function is typically used to terminate a loop that

+  traverses all the nodes in a doubly linked list starting with the head node.

+

+  Returns TRUE if Node is equal to List.  Returns FALSE if Node is one of the

+  nodes in the doubly linked list specified by List.  List must have been

+  initialized with INTIALIZE_LIST_HEAD_VARIABLE() or InitializeListHead().

+

+  If List is NULL, then ASSERT().

+  If Node is NULL, then ASSERT().

+  If List was not initialized with INTIALIZE_LIST_HEAD_VARIABLE() or InitializeListHead(),

+  then ASSERT().

+  If PcdMaximumLinkedListLength is not zero, and the number of nodes

+  in List, including the List node, is greater than or equal to

+  PcdMaximumLinkedListLength, then ASSERT().

+  If PcdVerifyNodeInList is TRUE and Node is not a node in List the and Node is not equal

+  to List, then ASSERT().

+

+  @param  List  A pointer to the head node of a doubly linked list.

+  @param  Node  A pointer to a node in the doubly linked list.

+

+  @retval TRUE  Node is the head of the doubly-linked list pointed by List.

+  @retval FALSE Node is not the head of the doubly-linked list pointed by List.

+

+**/

+BOOLEAN

+EFIAPI

+IsNull (

+  IN      CONST LIST_ENTRY          *List,

+  IN      CONST LIST_ENTRY          *Node

+  );

+

+

+/**

+  Determines if a node the last node in a doubly linked list.

+

+  Returns TRUE if Node is the last node in the doubly linked list specified by

+  List. Otherwise, FALSE is returned. List must have been initialized with

+  INTIALIZE_LIST_HEAD_VARIABLE() or InitializeListHead().

+

+  If List is NULL, then ASSERT().

+  If Node is NULL, then ASSERT().

+  If List was not initialized with INTIALIZE_LIST_HEAD_VARIABLE() or

+  InitializeListHead(), then ASSERT().

+  If PcdMaximumLinkedListLength is not zero, and the number of nodes

+  in List, including the List node, is greater than or equal to

+  PcdMaximumLinkedListLength, then ASSERT().

+  If PcdVerifyNodeInList is TRUE and Node is not a node in List, then ASSERT().

+

+  @param  List  A pointer to the head node of a doubly linked list.

+  @param  Node  A pointer to a node in the doubly linked list.

+

+  @retval TRUE  Node is the last node in the linked list.

+  @retval FALSE Node is not the last node in the linked list.

+

+**/

+BOOLEAN

+EFIAPI

+IsNodeAtEnd (

+  IN      CONST LIST_ENTRY          *List,

+  IN      CONST LIST_ENTRY          *Node

+  );

+

+

+/**

+  Swaps the location of two nodes in a doubly linked list, and returns the

+  first node after the swap.

+

+  If FirstEntry is identical to SecondEntry, then SecondEntry is returned.

+  Otherwise, the location of the FirstEntry node is swapped with the location

+  of the SecondEntry node in a doubly linked list. SecondEntry must be in the

+  same double linked list as FirstEntry and that double linked list must have

+  been initialized with INTIALIZE_LIST_HEAD_VARIABLE() or InitializeListHead().

+  SecondEntry is returned after the nodes are swapped.

+

+  If FirstEntry is NULL, then ASSERT().

+  If SecondEntry is NULL, then ASSERT().

+  If PcdVerifyNodeInList is TRUE and SecondEntry and FirstEntry are not in the

+  same linked list, then ASSERT().

+  If PcdMaximumLinkedListLength is not zero, and the number of nodes in the

+  linked list containing the FirstEntry and SecondEntry nodes, including

+  the FirstEntry and SecondEntry nodes, is greater than or equal to

+  PcdMaximumLinkedListLength, then ASSERT().

+

+  @param  FirstEntry  A pointer to a node in a linked list.

+  @param  SecondEntry A pointer to another node in the same linked list.

+

+  @return SecondEntry.

+

+**/

+LIST_ENTRY *

+EFIAPI

+SwapListEntries (

+  IN OUT  LIST_ENTRY                *FirstEntry,

+  IN OUT  LIST_ENTRY                *SecondEntry

+  );

+

+

+/**

+  Removes a node from a doubly linked list, and returns the node that follows

+  the removed node.

+

+  Removes the node Entry from a doubly linked list. It is up to the caller of

+  this function to release the memory used by this node if that is required. On

+  exit, the node following Entry in the doubly linked list is returned. If

+  Entry is the only node in the linked list, then the head node of the linked

+  list is returned.

+

+  If Entry is NULL, then ASSERT().

+  If Entry is the head node of an empty list, then ASSERT().

+  If PcdMaximumLinkedListLength is not zero, and the number of nodes in the

+  linked list containing Entry, including the Entry node, is greater than

+  or equal to PcdMaximumLinkedListLength, then ASSERT().

+

+  @param  Entry A pointer to a node in a linked list.

+

+  @return Entry.

+

+**/

+LIST_ENTRY *

+EFIAPI

+RemoveEntryList (

+  IN      CONST LIST_ENTRY          *Entry

+  );

+

+//

+// Math Services

+//

+

+/**

+  Shifts a 64-bit integer left between 0 and 63 bits. The low bits are filled

+  with zeros. The shifted value is returned.

+

+  This function shifts the 64-bit value Operand to the left by Count bits. The

+  low Count bits are set to zero. The shifted value is returned.

+

+  If Count is greater than 63, then ASSERT().

+

+  @param  Operand The 64-bit operand to shift left.

+  @param  Count   The number of bits to shift left.

+

+  @return Operand << Count.

+

+**/

+UINT64

+EFIAPI

+LShiftU64 (

+  IN      UINT64                    Operand,

+  IN      UINTN                     Count

+  );

+

+

+/**

+  Shifts a 64-bit integer right between 0 and 63 bits. This high bits are

+  filled with zeros. The shifted value is returned.

+

+  This function shifts the 64-bit value Operand to the right by Count bits. The

+  high Count bits are set to zero. The shifted value is returned.

+

+  If Count is greater than 63, then ASSERT().

+

+  @param  Operand The 64-bit operand to shift right.

+  @param  Count   The number of bits to shift right.

+

+  @return Operand >> Count

+

+**/

+UINT64

+EFIAPI

+RShiftU64 (

+  IN      UINT64                    Operand,

+  IN      UINTN                     Count

+  );

+

+

+/**

+  Shifts a 64-bit integer right between 0 and 63 bits. The high bits are filled

+  with original integer's bit 63. The shifted value is returned.

+

+  This function shifts the 64-bit value Operand to the right by Count bits. The

+  high Count bits are set to bit 63 of Operand.  The shifted value is returned.

+

+  If Count is greater than 63, then ASSERT().

+

+  @param  Operand The 64-bit operand to shift right.

+  @param  Count   The number of bits to shift right.

+

+  @return Operand >> Count

+

+**/

+UINT64

+EFIAPI

+ARShiftU64 (

+  IN      UINT64                    Operand,

+  IN      UINTN                     Count

+  );

+

+

+/**

+  Rotates a 32-bit integer left between 0 and 31 bits, filling the low bits

+  with the high bits that were rotated.

+

+  This function rotates the 32-bit value Operand to the left by Count bits. The

+  low Count bits are fill with the high Count bits of Operand. The rotated

+  value is returned.

+

+  If Count is greater than 31, then ASSERT().

+

+  @param  Operand The 32-bit operand to rotate left.

+  @param  Count   The number of bits to rotate left.

+

+  @return Operand << Count

+

+**/

+UINT32

+EFIAPI

+LRotU32 (

+  IN      UINT32                    Operand,

+  IN      UINTN                     Count

+  );

+

+

+/**

+  Rotates a 32-bit integer right between 0 and 31 bits, filling the high bits

+  with the low bits that were rotated.

+

+  This function rotates the 32-bit value Operand to the right by Count bits.

+  The high Count bits are fill with the low Count bits of Operand. The rotated

+  value is returned.

+

+  If Count is greater than 31, then ASSERT().

+

+  @param  Operand The 32-bit operand to rotate right.

+  @param  Count   The number of bits to rotate right.

+

+  @return Operand >> Count

+

+**/

+UINT32

+EFIAPI

+RRotU32 (

+  IN      UINT32                    Operand,

+  IN      UINTN                     Count

+  );

+

+

+/**

+  Rotates a 64-bit integer left between 0 and 63 bits, filling the low bits

+  with the high bits that were rotated.

+

+  This function rotates the 64-bit value Operand to the left by Count bits. The

+  low Count bits are fill with the high Count bits of Operand. The rotated

+  value is returned.

+

+  If Count is greater than 63, then ASSERT().

+

+  @param  Operand The 64-bit operand to rotate left.

+  @param  Count   The number of bits to rotate left.

+

+  @return Operand << Count

+

+**/

+UINT64

+EFIAPI

+LRotU64 (

+  IN      UINT64                    Operand,

+  IN      UINTN                     Count

+  );

+

+

+/**

+  Rotates a 64-bit integer right between 0 and 63 bits, filling the high bits

+  with the high low bits that were rotated.

+

+  This function rotates the 64-bit value Operand to the right by Count bits.

+  The high Count bits are fill with the low Count bits of Operand. The rotated

+  value is returned.

+

+  If Count is greater than 63, then ASSERT().

+

+  @param  Operand The 64-bit operand to rotate right.

+  @param  Count   The number of bits to rotate right.

+

+  @return Operand >> Count

+

+**/

+UINT64

+EFIAPI

+RRotU64 (

+  IN      UINT64                    Operand,

+  IN      UINTN                     Count

+  );

+

+

+/**

+  Returns the bit position of the lowest bit set in a 32-bit value.

+

+  This function computes the bit position of the lowest bit set in the 32-bit

+  value specified by Operand. If Operand is zero, then -1 is returned.

+  Otherwise, a value between 0 and 31 is returned.

+

+  @param  Operand The 32-bit operand to evaluate.

+

+  @retval 0..31  The lowest bit set in Operand was found.

+  @retval -1    Operand is zero.

+

+**/

+INTN

+EFIAPI

+LowBitSet32 (

+  IN      UINT32                    Operand

+  );

+

+

+/**

+  Returns the bit position of the lowest bit set in a 64-bit value.

+

+  This function computes the bit position of the lowest bit set in the 64-bit

+  value specified by Operand. If Operand is zero, then -1 is returned.

+  Otherwise, a value between 0 and 63 is returned.

+

+  @param  Operand The 64-bit operand to evaluate.

+

+  @retval 0..63  The lowest bit set in Operand was found.

+  @retval -1    Operand is zero.

+

+

+**/

+INTN

+EFIAPI

+LowBitSet64 (

+  IN      UINT64                    Operand

+  );

+

+

+/**

+  Returns the bit position of the highest bit set in a 32-bit value. Equivalent

+  to log2(x).

+

+  This function computes the bit position of the highest bit set in the 32-bit

+  value specified by Operand. If Operand is zero, then -1 is returned.

+  Otherwise, a value between 0 and 31 is returned.

+

+  @param  Operand The 32-bit operand to evaluate.

+

+  @retval 0..31  Position of the highest bit set in Operand if found.

+  @retval -1    Operand is zero.

+

+**/

+INTN

+EFIAPI

+HighBitSet32 (

+  IN      UINT32                    Operand

+  );

+

+

+/**

+  Returns the bit position of the highest bit set in a 64-bit value. Equivalent

+  to log2(x).

+

+  This function computes the bit position of the highest bit set in the 64-bit

+  value specified by Operand. If Operand is zero, then -1 is returned.

+  Otherwise, a value between 0 and 63 is returned.

+

+  @param  Operand The 64-bit operand to evaluate.

+

+  @retval 0..63   Position of the highest bit set in Operand if found.

+  @retval -1     Operand is zero.

+

+**/

+INTN

+EFIAPI

+HighBitSet64 (

+  IN      UINT64                    Operand

+  );

+

+

+/**

+  Returns the value of the highest bit set in a 32-bit value. Equivalent to

+  1 << log2(x).

+

+  This function computes the value of the highest bit set in the 32-bit value

+  specified by Operand. If Operand is zero, then zero is returned.

+

+  @param  Operand The 32-bit operand to evaluate.

+

+  @return 1 << HighBitSet32(Operand)

+  @retval 0 Operand is zero.

+

+**/

+UINT32

+EFIAPI

+GetPowerOfTwo32 (

+  IN      UINT32                    Operand

+  );

+

+

+/**

+  Returns the value of the highest bit set in a 64-bit value. Equivalent to

+  1 << log2(x).

+

+  This function computes the value of the highest bit set in the 64-bit value

+  specified by Operand. If Operand is zero, then zero is returned.

+

+  @param  Operand The 64-bit operand to evaluate.

+

+  @return 1 << HighBitSet64(Operand)

+  @retval 0 Operand is zero.

+

+**/

+UINT64

+EFIAPI

+GetPowerOfTwo64 (

+  IN      UINT64                    Operand

+  );

+

+

+/**

+  Switches the endianness of a 16-bit integer.

+

+  This function swaps the bytes in a 16-bit unsigned value to switch the value

+  from little endian to big endian or vice versa. The byte swapped value is

+  returned.

+

+  @param  Value A 16-bit unsigned value.

+

+  @return The byte swapped Value.

+

+**/

+UINT16

+EFIAPI

+SwapBytes16 (

+  IN      UINT16                    Value

+  );

+

+

+/**

+  Switches the endianness of a 32-bit integer.

+

+  This function swaps the bytes in a 32-bit unsigned value to switch the value

+  from little endian to big endian or vice versa. The byte swapped value is

+  returned.

+

+  @param  Value A 32-bit unsigned value.

+

+  @return The byte swapped Value.

+

+**/

+UINT32

+EFIAPI

+SwapBytes32 (

+  IN      UINT32                    Value

+  );

+

+

+/**

+  Switches the endianness of a 64-bit integer.

+

+  This function swaps the bytes in a 64-bit unsigned value to switch the value

+  from little endian to big endian or vice versa. The byte swapped value is

+  returned.

+

+  @param  Value A 64-bit unsigned value.

+

+  @return The byte swapped Value.

+

+**/

+UINT64

+EFIAPI

+SwapBytes64 (

+  IN      UINT64                    Value

+  );

+

+

+/**

+  Multiples a 64-bit unsigned integer by a 32-bit unsigned integer and

+  generates a 64-bit unsigned result.

+

+  This function multiples the 64-bit unsigned value Multiplicand by the 32-bit

+  unsigned value Multiplier and generates a 64-bit unsigned result. This 64-

+  bit unsigned result is returned.

+

+  @param  Multiplicand  A 64-bit unsigned value.

+  @param  Multiplier    A 32-bit unsigned value.

+

+  @return Multiplicand * Multiplier

+

+**/

+UINT64

+EFIAPI

+MultU64x32 (

+  IN      UINT64                    Multiplicand,

+  IN      UINT32                    Multiplier

+  );

+

+

+/**

+  Multiples a 64-bit unsigned integer by a 64-bit unsigned integer and

+  generates a 64-bit unsigned result.

+

+  This function multiples the 64-bit unsigned value Multiplicand by the 64-bit

+  unsigned value Multiplier and generates a 64-bit unsigned result. This 64-

+  bit unsigned result is returned.

+

+  @param  Multiplicand  A 64-bit unsigned value.

+  @param  Multiplier    A 64-bit unsigned value.

+

+  @return Multiplicand * Multiplier.

+

+**/

+UINT64

+EFIAPI

+MultU64x64 (

+  IN      UINT64                    Multiplicand,

+  IN      UINT64                    Multiplier

+  );

+

+

+/**

+  Multiples a 64-bit signed integer by a 64-bit signed integer and generates a

+  64-bit signed result.

+

+  This function multiples the 64-bit signed value Multiplicand by the 64-bit

+  signed value Multiplier and generates a 64-bit signed result. This 64-bit

+  signed result is returned.

+

+  @param  Multiplicand  A 64-bit signed value.

+  @param  Multiplier    A 64-bit signed value.

+

+  @return Multiplicand * Multiplier

+

+**/

+INT64

+EFIAPI

+MultS64x64 (

+  IN      INT64                     Multiplicand,

+  IN      INT64                     Multiplier

+  );

+

+

+/**

+  Divides a 64-bit unsigned integer by a 32-bit unsigned integer and generates

+  a 64-bit unsigned result.

+

+  This function divides the 64-bit unsigned value Dividend by the 32-bit

+  unsigned value Divisor and generates a 64-bit unsigned quotient. This

+  function returns the 64-bit unsigned quotient.

+

+  If Divisor is 0, then ASSERT().

+

+  @param  Dividend  A 64-bit unsigned value.

+  @param  Divisor   A 32-bit unsigned value.

+

+  @return Dividend / Divisor.

+

+**/

+UINT64

+EFIAPI

+DivU64x32 (

+  IN      UINT64                    Dividend,

+  IN      UINT32                    Divisor

+  );

+

+

+/**

+  Divides a 64-bit unsigned integer by a 32-bit unsigned integer and generates

+  a 32-bit unsigned remainder.

+

+  This function divides the 64-bit unsigned value Dividend by the 32-bit

+  unsigned value Divisor and generates a 32-bit remainder. This function

+  returns the 32-bit unsigned remainder.

+

+  If Divisor is 0, then ASSERT().

+

+  @param  Dividend  A 64-bit unsigned value.

+  @param  Divisor   A 32-bit unsigned value.

+

+  @return Dividend % Divisor.

+

+**/

+UINT32

+EFIAPI

+ModU64x32 (

+  IN      UINT64                    Dividend,

+  IN      UINT32                    Divisor

+  );

+

+

+/**

+  Divides a 64-bit unsigned integer by a 32-bit unsigned integer and generates

+  a 64-bit unsigned result and an optional 32-bit unsigned remainder.

+

+  This function divides the 64-bit unsigned value Dividend by the 32-bit

+  unsigned value Divisor and generates a 64-bit unsigned quotient. If Remainder

+  is not NULL, then the 32-bit unsigned remainder is returned in Remainder.

+  This function returns the 64-bit unsigned quotient.

+

+  If Divisor is 0, then ASSERT().

+

+  @param  Dividend  A 64-bit unsigned value.

+  @param  Divisor   A 32-bit unsigned value.

+  @param  Remainder A pointer to a 32-bit unsigned value. This parameter is

+                    optional and may be NULL.

+

+  @return Dividend / Divisor.

+

+**/

+UINT64

+EFIAPI

+DivU64x32Remainder (

+  IN      UINT64                    Dividend,

+  IN      UINT32                    Divisor,

+  OUT     UINT32                    *Remainder  OPTIONAL

+  );

+

+

+/**

+  Divides a 64-bit unsigned integer by a 64-bit unsigned integer and generates

+  a 64-bit unsigned result and an optional 64-bit unsigned remainder.

+

+  This function divides the 64-bit unsigned value Dividend by the 64-bit

+  unsigned value Divisor and generates a 64-bit unsigned quotient. If Remainder

+  is not NULL, then the 64-bit unsigned remainder is returned in Remainder.

+  This function returns the 64-bit unsigned quotient.

+

+  If Divisor is 0, then ASSERT().

+

+  @param  Dividend  A 64-bit unsigned value.

+  @param  Divisor   A 64-bit unsigned value.

+  @param  Remainder A pointer to a 64-bit unsigned value. This parameter is

+                    optional and may be NULL.

+

+  @return Dividend / Divisor.

+

+**/

+UINT64

+EFIAPI

+DivU64x64Remainder (

+  IN      UINT64                    Dividend,

+  IN      UINT64                    Divisor,

+  OUT     UINT64                    *Remainder  OPTIONAL

+  );

+

+

+/**

+  Divides a 64-bit signed integer by a 64-bit signed integer and generates a

+  64-bit signed result and a optional 64-bit signed remainder.

+

+  This function divides the 64-bit signed value Dividend by the 64-bit signed

+  value Divisor and generates a 64-bit signed quotient. If Remainder is not

+  NULL, then the 64-bit signed remainder is returned in Remainder. This

+  function returns the 64-bit signed quotient.

+

+  It is the caller's responsibility to not call this function with a Divisor of 0.

+  If Divisor is 0, then the quotient and remainder should be assumed to be

+  the largest negative integer.

+

+  If Divisor is 0, then ASSERT().

+

+  @param  Dividend  A 64-bit signed value.

+  @param  Divisor   A 64-bit signed value.

+  @param  Remainder A pointer to a 64-bit signed value. This parameter is

+                    optional and may be NULL.

+

+  @return Dividend / Divisor.

+

+**/

+INT64

+EFIAPI

+DivS64x64Remainder (

+  IN      INT64                     Dividend,

+  IN      INT64                     Divisor,

+  OUT     INT64                     *Remainder  OPTIONAL

+  );

+

+

+/**

+  Reads a 16-bit value from memory that may be unaligned.

+

+  This function returns the 16-bit value pointed to by Buffer. The function

+  guarantees that the read operation does not produce an alignment fault.

+

+  If the Buffer is NULL, then ASSERT().

+

+  @param  Buffer  The pointer to a 16-bit value that may be unaligned.

+

+  @return The 16-bit value read from Buffer.

+

+**/

+UINT16

+EFIAPI

+ReadUnaligned16 (

+  IN CONST UINT16              *Buffer

+  );

+

+

+/**

+  Writes a 16-bit value to memory that may be unaligned.

+

+  This function writes the 16-bit value specified by Value to Buffer. Value is

+  returned. The function guarantees that the write operation does not produce

+  an alignment fault.

+

+  If the Buffer is NULL, then ASSERT().

+

+  @param  Buffer  The pointer to a 16-bit value that may be unaligned.

+  @param  Value   16-bit value to write to Buffer.

+

+  @return The 16-bit value to write to Buffer.

+

+**/

+UINT16

+EFIAPI

+WriteUnaligned16 (

+  OUT UINT16                    *Buffer,

+  IN  UINT16                    Value

+  );

+

+

+/**

+  Reads a 24-bit value from memory that may be unaligned.

+

+  This function returns the 24-bit value pointed to by Buffer. The function

+  guarantees that the read operation does not produce an alignment fault.

+

+  If the Buffer is NULL, then ASSERT().

+

+  @param  Buffer  The pointer to a 24-bit value that may be unaligned.

+

+  @return The 24-bit value read from Buffer.

+

+**/

+UINT32

+EFIAPI

+ReadUnaligned24 (

+  IN CONST UINT32              *Buffer

+  );

+

+

+/**

+  Writes a 24-bit value to memory that may be unaligned.

+

+  This function writes the 24-bit value specified by Value to Buffer. Value is

+  returned. The function guarantees that the write operation does not produce

+  an alignment fault.

+

+  If the Buffer is NULL, then ASSERT().

+

+  @param  Buffer  The pointer to a 24-bit value that may be unaligned.

+  @param  Value   24-bit value to write to Buffer.

+

+  @return The 24-bit value to write to Buffer.

+

+**/

+UINT32

+EFIAPI

+WriteUnaligned24 (

+  OUT UINT32                    *Buffer,

+  IN  UINT32                    Value

+  );

+

+

+/**

+  Reads a 32-bit value from memory that may be unaligned.

+

+  This function returns the 32-bit value pointed to by Buffer. The function

+  guarantees that the read operation does not produce an alignment fault.

+

+  If the Buffer is NULL, then ASSERT().

+

+  @param  Buffer  The pointer to a 32-bit value that may be unaligned.

+

+  @return The 32-bit value read from Buffer.

+

+**/

+UINT32

+EFIAPI

+ReadUnaligned32 (

+  IN CONST UINT32              *Buffer

+  );

+

+

+/**

+  Writes a 32-bit value to memory that may be unaligned.

+

+  This function writes the 32-bit value specified by Value to Buffer. Value is

+  returned. The function guarantees that the write operation does not produce

+  an alignment fault.

+

+  If the Buffer is NULL, then ASSERT().

+

+  @param  Buffer  The pointer to a 32-bit value that may be unaligned.

+  @param  Value   32-bit value to write to Buffer.

+

+  @return The 32-bit value to write to Buffer.

+

+**/

+UINT32

+EFIAPI

+WriteUnaligned32 (

+  OUT UINT32                    *Buffer,

+  IN  UINT32                    Value

+  );

+

+

+/**

+  Reads a 64-bit value from memory that may be unaligned.

+

+  This function returns the 64-bit value pointed to by Buffer. The function

+  guarantees that the read operation does not produce an alignment fault.

+

+  If the Buffer is NULL, then ASSERT().

+

+  @param  Buffer  The pointer to a 64-bit value that may be unaligned.

+

+  @return The 64-bit value read from Buffer.

+

+**/

+UINT64

+EFIAPI

+ReadUnaligned64 (

+  IN CONST UINT64              *Buffer

+  );

+

+

+/**

+  Writes a 64-bit value to memory that may be unaligned.

+

+  This function writes the 64-bit value specified by Value to Buffer. Value is

+  returned. The function guarantees that the write operation does not produce

+  an alignment fault.

+

+  If the Buffer is NULL, then ASSERT().

+

+  @param  Buffer  The pointer to a 64-bit value that may be unaligned.

+  @param  Value   64-bit value to write to Buffer.

+

+  @return The 64-bit value to write to Buffer.

+

+**/

+UINT64

+EFIAPI

+WriteUnaligned64 (

+  OUT UINT64                    *Buffer,

+  IN  UINT64                    Value

+  );

+

+

+//

+// Bit Field Functions

+//

+

+/**

+  Returns a bit field from an 8-bit value.

+

+  Returns the bitfield specified by the StartBit and the EndBit from Operand.

+

+  If 8-bit operations are not supported, then ASSERT().

+  If StartBit is greater than 7, then ASSERT().

+  If EndBit is greater than 7, then ASSERT().

+  If EndBit is less than StartBit, then ASSERT().

+

+  @param  Operand   Operand on which to perform the bitfield operation.

+  @param  StartBit  The ordinal of the least significant bit in the bit field.

+                    Range 0..7.

+  @param  EndBit    The ordinal of the most significant bit in the bit field.

+                    Range 0..7.

+

+  @return The bit field read.

+

+**/

+UINT8

+EFIAPI

+BitFieldRead8 (

+  IN      UINT8                     Operand,

+  IN      UINTN                     StartBit,

+  IN      UINTN                     EndBit

+  );

+

+

+/**

+  Writes a bit field to an 8-bit value, and returns the result.

+

+  Writes Value to the bit field specified by the StartBit and the EndBit in

+  Operand. All other bits in Operand are preserved. The new 8-bit value is

+  returned.

+

+  If 8-bit operations are not supported, then ASSERT().

+  If StartBit is greater than 7, then ASSERT().

+  If EndBit is greater than 7, then ASSERT().

+  If EndBit is less than StartBit, then ASSERT().

+  If Value is larger than the bitmask value range specified by StartBit and EndBit, then ASSERT().

+

+  @param  Operand   Operand on which to perform the bitfield operation.

+  @param  StartBit  The ordinal of the least significant bit in the bit field.

+                    Range 0..7.

+  @param  EndBit    The ordinal of the most significant bit in the bit field.

+                    Range 0..7.

+  @param  Value     New value of the bit field.

+

+  @return The new 8-bit value.

+

+**/

+UINT8

+EFIAPI

+BitFieldWrite8 (

+  IN      UINT8                     Operand,

+  IN      UINTN                     StartBit,

+  IN      UINTN                     EndBit,

+  IN      UINT8                     Value

+  );

+

+

+/**

+  Reads a bit field from an 8-bit value, performs a bitwise OR, and returns the

+  result.

+

+  Performs a bitwise OR between the bit field specified by StartBit

+  and EndBit in Operand and the value specified by OrData. All other bits in

+  Operand are preserved. The new 8-bit value is returned.

+

+  If 8-bit operations are not supported, then ASSERT().

+  If StartBit is greater than 7, then ASSERT().

+  If EndBit is greater than 7, then ASSERT().

+  If EndBit is less than StartBit, then ASSERT().

+  If OrData is larger than the bitmask value range specified by StartBit and EndBit, then ASSERT().

+

+  @param  Operand   Operand on which to perform the bitfield operation.

+  @param  StartBit  The ordinal of the least significant bit in the bit field.

+                    Range 0..7.

+  @param  EndBit    The ordinal of the most significant bit in the bit field.

+                    Range 0..7.

+  @param  OrData    The value to OR with the read value from the value

+

+  @return The new 8-bit value.

+

+**/

+UINT8

+EFIAPI

+BitFieldOr8 (

+  IN      UINT8                     Operand,

+  IN      UINTN                     StartBit,

+  IN      UINTN                     EndBit,

+  IN      UINT8                     OrData

+  );

+

+

+/**

+  Reads a bit field from an 8-bit value, performs a bitwise AND, and returns

+  the result.

+

+  Performs a bitwise AND between the bit field specified by StartBit and EndBit

+  in Operand and the value specified by AndData. All other bits in Operand are

+  preserved. The new 8-bit value is returned.

+

+  If 8-bit operations are not supported, then ASSERT().

+  If StartBit is greater than 7, then ASSERT().

+  If EndBit is greater than 7, then ASSERT().

+  If EndBit is less than StartBit, then ASSERT().

+  If AndData is larger than the bitmask value range specified by StartBit and EndBit, then ASSERT().

+

+  @param  Operand   Operand on which to perform the bitfield operation.

+  @param  StartBit  The ordinal of the least significant bit in the bit field.

+                    Range 0..7.

+  @param  EndBit    The ordinal of the most significant bit in the bit field.

+                    Range 0..7.

+  @param  AndData   The value to AND with the read value from the value.

+

+  @return The new 8-bit value.

+

+**/

+UINT8

+EFIAPI

+BitFieldAnd8 (

+  IN      UINT8                     Operand,

+  IN      UINTN                     StartBit,

+  IN      UINTN                     EndBit,

+  IN      UINT8                     AndData

+  );

+

+

+/**

+  Reads a bit field from an 8-bit value, performs a bitwise AND followed by a

+  bitwise OR, and returns the result.

+

+  Performs a bitwise AND between the bit field specified by StartBit and EndBit

+  in Operand and the value specified by AndData, followed by a bitwise

+  OR with value specified by OrData. All other bits in Operand are

+  preserved. The new 8-bit value is returned.

+

+  If 8-bit operations are not supported, then ASSERT().

+  If StartBit is greater than 7, then ASSERT().

+  If EndBit is greater than 7, then ASSERT().

+  If EndBit is less than StartBit, then ASSERT().

+  If AndData is larger than the bitmask value range specified by StartBit and EndBit, then ASSERT().

+  If OrData is larger than the bitmask value range specified by StartBit and EndBit, then ASSERT().

+

+  @param  Operand   Operand on which to perform the bitfield operation.

+  @param  StartBit  The ordinal of the least significant bit in the bit field.

+                    Range 0..7.

+  @param  EndBit    The ordinal of the most significant bit in the bit field.

+                    Range 0..7.

+  @param  AndData   The value to AND with the read value from the value.

+  @param  OrData    The value to OR with the result of the AND operation.

+

+  @return The new 8-bit value.

+

+**/

+UINT8

+EFIAPI

+BitFieldAndThenOr8 (

+  IN      UINT8                     Operand,

+  IN      UINTN                     StartBit,

+  IN      UINTN                     EndBit,

+  IN      UINT8                     AndData,

+  IN      UINT8                     OrData

+  );

+

+

+/**

+  Returns a bit field from a 16-bit value.

+

+  Returns the bitfield specified by the StartBit and the EndBit from Operand.

+

+  If 16-bit operations are not supported, then ASSERT().

+  If StartBit is greater than 15, then ASSERT().

+  If EndBit is greater than 15, then ASSERT().

+  If EndBit is less than StartBit, then ASSERT().

+

+  @param  Operand   Operand on which to perform the bitfield operation.

+  @param  StartBit  The ordinal of the least significant bit in the bit field.

+                    Range 0..15.

+  @param  EndBit    The ordinal of the most significant bit in the bit field.

+                    Range 0..15.

+

+  @return The bit field read.

+

+**/

+UINT16

+EFIAPI

+BitFieldRead16 (

+  IN      UINT16                    Operand,

+  IN      UINTN                     StartBit,

+  IN      UINTN                     EndBit

+  );

+

+

+/**

+  Writes a bit field to a 16-bit value, and returns the result.

+

+  Writes Value to the bit field specified by the StartBit and the EndBit in

+  Operand. All other bits in Operand are preserved. The new 16-bit value is

+  returned.

+

+  If 16-bit operations are not supported, then ASSERT().

+  If StartBit is greater than 15, then ASSERT().

+  If EndBit is greater than 15, then ASSERT().

+  If EndBit is less than StartBit, then ASSERT().

+  If Value is larger than the bitmask value range specified by StartBit and EndBit, then ASSERT().

+

+  @param  Operand   Operand on which to perform the bitfield operation.

+  @param  StartBit  The ordinal of the least significant bit in the bit field.

+                    Range 0..15.

+  @param  EndBit    The ordinal of the most significant bit in the bit field.

+                    Range 0..15.

+  @param  Value     New value of the bit field.

+

+  @return The new 16-bit value.

+

+**/

+UINT16

+EFIAPI

+BitFieldWrite16 (

+  IN      UINT16                    Operand,

+  IN      UINTN                     StartBit,

+  IN      UINTN                     EndBit,

+  IN      UINT16                    Value

+  );

+

+

+/**

+  Reads a bit field from a 16-bit value, performs a bitwise OR, and returns the

+  result.

+

+  Performs a bitwise OR between the bit field specified by StartBit

+  and EndBit in Operand and the value specified by OrData. All other bits in

+  Operand are preserved. The new 16-bit value is returned.

+

+  If 16-bit operations are not supported, then ASSERT().

+  If StartBit is greater than 15, then ASSERT().

+  If EndBit is greater than 15, then ASSERT().

+  If EndBit is less than StartBit, then ASSERT().

+  If OrData is larger than the bitmask value range specified by StartBit and EndBit, then ASSERT().

+

+  @param  Operand   Operand on which to perform the bitfield operation.

+  @param  StartBit  The ordinal of the least significant bit in the bit field.

+                    Range 0..15.

+  @param  EndBit    The ordinal of the most significant bit in the bit field.

+                    Range 0..15.

+  @param  OrData    The value to OR with the read value from the value

+

+  @return The new 16-bit value.

+

+**/

+UINT16

+EFIAPI

+BitFieldOr16 (

+  IN      UINT16                    Operand,

+  IN      UINTN                     StartBit,

+  IN      UINTN                     EndBit,

+  IN      UINT16                    OrData

+  );

+

+

+/**

+  Reads a bit field from a 16-bit value, performs a bitwise AND, and returns

+  the result.

+

+  Performs a bitwise AND between the bit field specified by StartBit and EndBit

+  in Operand and the value specified by AndData. All other bits in Operand are

+  preserved. The new 16-bit value is returned.

+

+  If 16-bit operations are not supported, then ASSERT().

+  If StartBit is greater than 15, then ASSERT().

+  If EndBit is greater than 15, then ASSERT().

+  If EndBit is less than StartBit, then ASSERT().

+  If AndData is larger than the bitmask value range specified by StartBit and EndBit, then ASSERT().

+

+  @param  Operand   Operand on which to perform the bitfield operation.

+  @param  StartBit  The ordinal of the least significant bit in the bit field.

+                    Range 0..15.

+  @param  EndBit    The ordinal of the most significant bit in the bit field.

+                    Range 0..15.

+  @param  AndData   The value to AND with the read value from the value

+

+  @return The new 16-bit value.

+

+**/

+UINT16

+EFIAPI

+BitFieldAnd16 (

+  IN      UINT16                    Operand,

+  IN      UINTN                     StartBit,

+  IN      UINTN                     EndBit,

+  IN      UINT16                    AndData

+  );

+

+

+/**

+  Reads a bit field from a 16-bit value, performs a bitwise AND followed by a

+  bitwise OR, and returns the result.

+

+  Performs a bitwise AND between the bit field specified by StartBit and EndBit

+  in Operand and the value specified by AndData, followed by a bitwise

+  OR with value specified by OrData. All other bits in Operand are

+  preserved. The new 16-bit value is returned.

+

+  If 16-bit operations are not supported, then ASSERT().

+  If StartBit is greater than 15, then ASSERT().

+  If EndBit is greater than 15, then ASSERT().

+  If EndBit is less than StartBit, then ASSERT().

+  If AndData is larger than the bitmask value range specified by StartBit and EndBit, then ASSERT().

+  If OrData is larger than the bitmask value range specified by StartBit and EndBit, then ASSERT().

+

+  @param  Operand   Operand on which to perform the bitfield operation.

+  @param  StartBit  The ordinal of the least significant bit in the bit field.

+                    Range 0..15.

+  @param  EndBit    The ordinal of the most significant bit in the bit field.

+                    Range 0..15.

+  @param  AndData   The value to AND with the read value from the value.

+  @param  OrData    The value to OR with the result of the AND operation.

+

+  @return The new 16-bit value.

+

+**/

+UINT16

+EFIAPI

+BitFieldAndThenOr16 (

+  IN      UINT16                    Operand,

+  IN      UINTN                     StartBit,

+  IN      UINTN                     EndBit,

+  IN      UINT16                    AndData,

+  IN      UINT16                    OrData

+  );

+

+

+/**

+  Returns a bit field from a 32-bit value.

+

+  Returns the bitfield specified by the StartBit and the EndBit from Operand.

+

+  If 32-bit operations are not supported, then ASSERT().

+  If StartBit is greater than 31, then ASSERT().

+  If EndBit is greater than 31, then ASSERT().

+  If EndBit is less than StartBit, then ASSERT().

+

+  @param  Operand   Operand on which to perform the bitfield operation.

+  @param  StartBit  The ordinal of the least significant bit in the bit field.

+                    Range 0..31.

+  @param  EndBit    The ordinal of the most significant bit in the bit field.

+                    Range 0..31.

+

+  @return The bit field read.

+

+**/

+UINT32

+EFIAPI

+BitFieldRead32 (

+  IN      UINT32                    Operand,

+  IN      UINTN                     StartBit,

+  IN      UINTN                     EndBit

+  );

+

+

+/**

+  Writes a bit field to a 32-bit value, and returns the result.

+

+  Writes Value to the bit field specified by the StartBit and the EndBit in

+  Operand. All other bits in Operand are preserved. The new 32-bit value is

+  returned.

+

+  If 32-bit operations are not supported, then ASSERT().

+  If StartBit is greater than 31, then ASSERT().

+  If EndBit is greater than 31, then ASSERT().

+  If EndBit is less than StartBit, then ASSERT().

+  If Value is larger than the bitmask value range specified by StartBit and EndBit, then ASSERT().

+

+  @param  Operand   Operand on which to perform the bitfield operation.

+  @param  StartBit  The ordinal of the least significant bit in the bit field.

+                    Range 0..31.

+  @param  EndBit    The ordinal of the most significant bit in the bit field.

+                    Range 0..31.

+  @param  Value     New value of the bit field.

+

+  @return The new 32-bit value.

+

+**/

+UINT32

+EFIAPI

+BitFieldWrite32 (

+  IN      UINT32                    Operand,

+  IN      UINTN                     StartBit,

+  IN      UINTN                     EndBit,

+  IN      UINT32                    Value

+  );

+

+

+/**

+  Reads a bit field from a 32-bit value, performs a bitwise OR, and returns the

+  result.

+

+  Performs a bitwise OR between the bit field specified by StartBit

+  and EndBit in Operand and the value specified by OrData. All other bits in

+  Operand are preserved. The new 32-bit value is returned.

+

+  If 32-bit operations are not supported, then ASSERT().

+  If StartBit is greater than 31, then ASSERT().

+  If EndBit is greater than 31, then ASSERT().

+  If EndBit is less than StartBit, then ASSERT().

+  If OrData is larger than the bitmask value range specified by StartBit and EndBit, then ASSERT().

+

+  @param  Operand   Operand on which to perform the bitfield operation.

+  @param  StartBit  The ordinal of the least significant bit in the bit field.

+                    Range 0..31.

+  @param  EndBit    The ordinal of the most significant bit in the bit field.

+                    Range 0..31.

+  @param  OrData    The value to OR with the read value from the value.

+

+  @return The new 32-bit value.

+

+**/

+UINT32

+EFIAPI

+BitFieldOr32 (

+  IN      UINT32                    Operand,

+  IN      UINTN                     StartBit,

+  IN      UINTN                     EndBit,

+  IN      UINT32                    OrData

+  );

+

+

+/**

+  Reads a bit field from a 32-bit value, performs a bitwise AND, and returns

+  the result.

+

+  Performs a bitwise AND between the bit field specified by StartBit and EndBit

+  in Operand and the value specified by AndData. All other bits in Operand are

+  preserved. The new 32-bit value is returned.

+

+  If 32-bit operations are not supported, then ASSERT().

+  If StartBit is greater than 31, then ASSERT().

+  If EndBit is greater than 31, then ASSERT().

+  If EndBit is less than StartBit, then ASSERT().

+  If AndData is larger than the bitmask value range specified by StartBit and EndBit, then ASSERT().

+

+  @param  Operand   Operand on which to perform the bitfield operation.

+  @param  StartBit  The ordinal of the least significant bit in the bit field.

+                    Range 0..31.

+  @param  EndBit    The ordinal of the most significant bit in the bit field.

+                    Range 0..31.

+  @param  AndData   The value to AND with the read value from the value

+

+  @return The new 32-bit value.

+

+**/

+UINT32

+EFIAPI

+BitFieldAnd32 (

+  IN      UINT32                    Operand,

+  IN      UINTN                     StartBit,

+  IN      UINTN                     EndBit,

+  IN      UINT32                    AndData

+  );

+

+

+/**

+  Reads a bit field from a 32-bit value, performs a bitwise AND followed by a

+  bitwise OR, and returns the result.

+

+  Performs a bitwise AND between the bit field specified by StartBit and EndBit

+  in Operand and the value specified by AndData, followed by a bitwise

+  OR with value specified by OrData. All other bits in Operand are

+  preserved. The new 32-bit value is returned.

+

+  If 32-bit operations are not supported, then ASSERT().

+  If StartBit is greater than 31, then ASSERT().

+  If EndBit is greater than 31, then ASSERT().

+  If EndBit is less than StartBit, then ASSERT().

+  If AndData is larger than the bitmask value range specified by StartBit and EndBit, then ASSERT().

+  If OrData is larger than the bitmask value range specified by StartBit and EndBit, then ASSERT().

+

+  @param  Operand   Operand on which to perform the bitfield operation.

+  @param  StartBit  The ordinal of the least significant bit in the bit field.

+                    Range 0..31.

+  @param  EndBit    The ordinal of the most significant bit in the bit field.

+                    Range 0..31.

+  @param  AndData   The value to AND with the read value from the value.

+  @param  OrData    The value to OR with the result of the AND operation.

+

+  @return The new 32-bit value.

+

+**/

+UINT32

+EFIAPI

+BitFieldAndThenOr32 (

+  IN      UINT32                    Operand,

+  IN      UINTN                     StartBit,

+  IN      UINTN                     EndBit,

+  IN      UINT32                    AndData,

+  IN      UINT32                    OrData

+  );

+

+

+/**

+  Returns a bit field from a 64-bit value.

+

+  Returns the bitfield specified by the StartBit and the EndBit from Operand.

+

+  If 64-bit operations are not supported, then ASSERT().

+  If StartBit is greater than 63, then ASSERT().

+  If EndBit is greater than 63, then ASSERT().

+  If EndBit is less than StartBit, then ASSERT().

+

+  @param  Operand   Operand on which to perform the bitfield operation.

+  @param  StartBit  The ordinal of the least significant bit in the bit field.

+                    Range 0..63.

+  @param  EndBit    The ordinal of the most significant bit in the bit field.

+                    Range 0..63.

+

+  @return The bit field read.

+

+**/

+UINT64

+EFIAPI

+BitFieldRead64 (

+  IN      UINT64                    Operand,

+  IN      UINTN                     StartBit,

+  IN      UINTN                     EndBit

+  );

+

+

+/**

+  Writes a bit field to a 64-bit value, and returns the result.

+

+  Writes Value to the bit field specified by the StartBit and the EndBit in

+  Operand. All other bits in Operand are preserved. The new 64-bit value is

+  returned.

+

+  If 64-bit operations are not supported, then ASSERT().

+  If StartBit is greater than 63, then ASSERT().

+  If EndBit is greater than 63, then ASSERT().

+  If EndBit is less than StartBit, then ASSERT().

+  If Value is larger than the bitmask value range specified by StartBit and EndBit, then ASSERT().

+

+  @param  Operand   Operand on which to perform the bitfield operation.

+  @param  StartBit  The ordinal of the least significant bit in the bit field.

+                    Range 0..63.

+  @param  EndBit    The ordinal of the most significant bit in the bit field.

+                    Range 0..63.

+  @param  Value     New value of the bit field.

+

+  @return The new 64-bit value.

+

+**/

+UINT64

+EFIAPI

+BitFieldWrite64 (

+  IN      UINT64                    Operand,

+  IN      UINTN                     StartBit,

+  IN      UINTN                     EndBit,

+  IN      UINT64                    Value

+  );

+

+

+/**

+  Reads a bit field from a 64-bit value, performs a bitwise OR, and returns the

+  result.

+

+  Performs a bitwise OR between the bit field specified by StartBit

+  and EndBit in Operand and the value specified by OrData. All other bits in

+  Operand are preserved. The new 64-bit value is returned.

+

+  If 64-bit operations are not supported, then ASSERT().

+  If StartBit is greater than 63, then ASSERT().

+  If EndBit is greater than 63, then ASSERT().

+  If EndBit is less than StartBit, then ASSERT().

+  If OrData is larger than the bitmask value range specified by StartBit and EndBit, then ASSERT().

+

+  @param  Operand   Operand on which to perform the bitfield operation.

+  @param  StartBit  The ordinal of the least significant bit in the bit field.

+                    Range 0..63.

+  @param  EndBit    The ordinal of the most significant bit in the bit field.

+                    Range 0..63.

+  @param  OrData    The value to OR with the read value from the value

+

+  @return The new 64-bit value.

+

+**/

+UINT64

+EFIAPI

+BitFieldOr64 (

+  IN      UINT64                    Operand,

+  IN      UINTN                     StartBit,

+  IN      UINTN                     EndBit,

+  IN      UINT64                    OrData

+  );

+

+

+/**

+  Reads a bit field from a 64-bit value, performs a bitwise AND, and returns

+  the result.

+

+  Performs a bitwise AND between the bit field specified by StartBit and EndBit

+  in Operand and the value specified by AndData. All other bits in Operand are

+  preserved. The new 64-bit value is returned.

+

+  If 64-bit operations are not supported, then ASSERT().

+  If StartBit is greater than 63, then ASSERT().

+  If EndBit is greater than 63, then ASSERT().

+  If EndBit is less than StartBit, then ASSERT().

+  If AndData is larger than the bitmask value range specified by StartBit and EndBit, then ASSERT().

+

+  @param  Operand   Operand on which to perform the bitfield operation.

+  @param  StartBit  The ordinal of the least significant bit in the bit field.

+                    Range 0..63.

+  @param  EndBit    The ordinal of the most significant bit in the bit field.

+                    Range 0..63.

+  @param  AndData   The value to AND with the read value from the value

+

+  @return The new 64-bit value.

+

+**/

+UINT64

+EFIAPI

+BitFieldAnd64 (

+  IN      UINT64                    Operand,

+  IN      UINTN                     StartBit,

+  IN      UINTN                     EndBit,

+  IN      UINT64                    AndData

+  );

+

+

+/**

+  Reads a bit field from a 64-bit value, performs a bitwise AND followed by a

+  bitwise OR, and returns the result.

+

+  Performs a bitwise AND between the bit field specified by StartBit and EndBit

+  in Operand and the value specified by AndData, followed by a bitwise

+  OR with value specified by OrData. All other bits in Operand are

+  preserved. The new 64-bit value is returned.

+

+  If 64-bit operations are not supported, then ASSERT().

+  If StartBit is greater than 63, then ASSERT().

+  If EndBit is greater than 63, then ASSERT().

+  If EndBit is less than StartBit, then ASSERT().

+  If AndData is larger than the bitmask value range specified by StartBit and EndBit, then ASSERT().

+  If OrData is larger than the bitmask value range specified by StartBit and EndBit, then ASSERT().

+

+  @param  Operand   Operand on which to perform the bitfield operation.

+  @param  StartBit  The ordinal of the least significant bit in the bit field.

+                    Range 0..63.

+  @param  EndBit    The ordinal of the most significant bit in the bit field.

+                    Range 0..63.

+  @param  AndData   The value to AND with the read value from the value.

+  @param  OrData    The value to OR with the result of the AND operation.

+

+  @return The new 64-bit value.

+

+**/

+UINT64

+EFIAPI

+BitFieldAndThenOr64 (

+  IN      UINT64                    Operand,

+  IN      UINTN                     StartBit,

+  IN      UINTN                     EndBit,

+  IN      UINT64                    AndData,

+  IN      UINT64                    OrData

+  );

+

+/**

+  Reads a bit field from a 32-bit value, counts and returns

+  the number of set bits.

+

+  Counts the number of set bits in the  bit field specified by

+  StartBit and EndBit in Operand. The count is returned.

+

+  If StartBit is greater than 31, then ASSERT().

+  If EndBit is greater than 31, then ASSERT().

+  If EndBit is less than StartBit, then ASSERT().

+

+  @param  Operand   Operand on which to perform the bitfield operation.

+  @param  StartBit  The ordinal of the least significant bit in the bit field.

+                    Range 0..31.

+  @param  EndBit    The ordinal of the most significant bit in the bit field.

+                    Range 0..31.

+

+  @return The number of bits set between StartBit and EndBit.

+

+**/

+UINT8

+EFIAPI

+BitFieldCountOnes32 (

+  IN       UINT32                   Operand,

+  IN       UINTN                    StartBit,

+  IN       UINTN                    EndBit

+  );

+

+/**

+   Reads a bit field from a 64-bit value, counts and returns

+   the number of set bits.

+

+   Counts the number of set bits in the  bit field specified by

+   StartBit and EndBit in Operand. The count is returned.

+

+   If StartBit is greater than 63, then ASSERT().

+   If EndBit is greater than 63, then ASSERT().

+   If EndBit is less than StartBit, then ASSERT().

+

+   @param  Operand   Operand on which to perform the bitfield operation.

+   @param  StartBit  The ordinal of the least significant bit in the bit field.

+   Range 0..63.

+   @param  EndBit    The ordinal of the most significant bit in the bit field.

+   Range 0..63.

+

+   @return The number of bits set between StartBit and EndBit.

+

+**/

+UINT8

+EFIAPI

+BitFieldCountOnes64 (

+  IN       UINT64                   Operand,

+  IN       UINTN                    StartBit,

+  IN       UINTN                    EndBit

+  );

+

+//

+// Base Library Checksum Functions

+//

+

+/**

+  Returns the sum of all elements in a buffer in unit of UINT8.

+  During calculation, the carry bits are dropped.

+

+  This function calculates the sum of all elements in a buffer

+  in unit of UINT8. The carry bits in result of addition are dropped.

+  The result is returned as UINT8. If Length is Zero, then Zero is

+  returned.

+

+  If Buffer is NULL, then ASSERT().

+  If Length is greater than (MAX_ADDRESS - Buffer + 1), then ASSERT().

+

+  @param  Buffer      The pointer to the buffer to carry out the sum operation.

+  @param  Length      The size, in bytes, of Buffer.

+

+  @return Sum         The sum of Buffer with carry bits dropped during additions.

+

+**/

+UINT8

+EFIAPI

+CalculateSum8 (

+  IN      CONST UINT8              *Buffer,

+  IN      UINTN                     Length

+  );

+

+

+/**

+  Returns the two's complement checksum of all elements in a buffer

+  of 8-bit values.

+

+  This function first calculates the sum of the 8-bit values in the

+  buffer specified by Buffer and Length.  The carry bits in the result

+  of addition are dropped. Then, the two's complement of the sum is

+  returned.  If Length is 0, then 0 is returned.

+

+  If Buffer is NULL, then ASSERT().

+  If Length is greater than (MAX_ADDRESS - Buffer + 1), then ASSERT().

+

+  @param  Buffer      The pointer to the buffer to carry out the checksum operation.

+  @param  Length      The size, in bytes, of Buffer.

+

+  @return Checksum    The two's complement checksum of Buffer.

+

+**/

+UINT8

+EFIAPI

+CalculateCheckSum8 (

+  IN      CONST UINT8              *Buffer,

+  IN      UINTN                     Length

+  );

+

+

+/**

+  Returns the sum of all elements in a buffer of 16-bit values.  During

+  calculation, the carry bits are dropped.

+

+  This function calculates the sum of the 16-bit values in the buffer

+  specified by Buffer and Length. The carry bits in result of addition are dropped.

+  The 16-bit result is returned.  If Length is 0, then 0 is returned.

+

+  If Buffer is NULL, then ASSERT().

+  If Buffer is not aligned on a 16-bit boundary, then ASSERT().

+  If Length is not aligned on a 16-bit boundary, then ASSERT().

+  If Length is greater than (MAX_ADDRESS - Buffer + 1), then ASSERT().

+

+  @param  Buffer      The pointer to the buffer to carry out the sum operation.

+  @param  Length      The size, in bytes, of Buffer.

+

+  @return Sum         The sum of Buffer with carry bits dropped during additions.

+

+**/

+UINT16

+EFIAPI

+CalculateSum16 (

+  IN      CONST UINT16             *Buffer,

+  IN      UINTN                     Length

+  );

+

+

+/**

+  Returns the two's complement checksum of all elements in a buffer of

+  16-bit values.

+

+  This function first calculates the sum of the 16-bit values in the buffer

+  specified by Buffer and Length.  The carry bits in the result of addition

+  are dropped. Then, the two's complement of the sum is returned.  If Length

+  is 0, then 0 is returned.

+

+  If Buffer is NULL, then ASSERT().

+  If Buffer is not aligned on a 16-bit boundary, then ASSERT().

+  If Length is not aligned on a 16-bit boundary, then ASSERT().

+  If Length is greater than (MAX_ADDRESS - Buffer + 1), then ASSERT().

+

+  @param  Buffer      The pointer to the buffer to carry out the checksum operation.

+  @param  Length      The size, in bytes, of Buffer.

+

+  @return Checksum    The two's complement checksum of Buffer.

+

+**/

+UINT16

+EFIAPI

+CalculateCheckSum16 (

+  IN      CONST UINT16             *Buffer,

+  IN      UINTN                     Length

+  );

+

+

+/**

+  Returns the sum of all elements in a buffer of 32-bit values. During

+  calculation, the carry bits are dropped.

+

+  This function calculates the sum of the 32-bit values in the buffer

+  specified by Buffer and Length. The carry bits in result of addition are dropped.

+  The 32-bit result is returned. If Length is 0, then 0 is returned.

+

+  If Buffer is NULL, then ASSERT().

+  If Buffer is not aligned on a 32-bit boundary, then ASSERT().

+  If Length is not aligned on a 32-bit boundary, then ASSERT().

+  If Length is greater than (MAX_ADDRESS - Buffer + 1), then ASSERT().

+

+  @param  Buffer      The pointer to the buffer to carry out the sum operation.

+  @param  Length      The size, in bytes, of Buffer.

+

+  @return Sum         The sum of Buffer with carry bits dropped during additions.

+

+**/

+UINT32

+EFIAPI

+CalculateSum32 (

+  IN      CONST UINT32             *Buffer,

+  IN      UINTN                     Length

+  );

+

+

+/**

+  Returns the two's complement checksum of all elements in a buffer of

+  32-bit values.

+

+  This function first calculates the sum of the 32-bit values in the buffer

+  specified by Buffer and Length.  The carry bits in the result of addition

+  are dropped. Then, the two's complement of the sum is returned.  If Length

+  is 0, then 0 is returned.

+

+  If Buffer is NULL, then ASSERT().

+  If Buffer is not aligned on a 32-bit boundary, then ASSERT().

+  If Length is not aligned on a 32-bit boundary, then ASSERT().

+  If Length is greater than (MAX_ADDRESS - Buffer + 1), then ASSERT().

+

+  @param  Buffer      The pointer to the buffer to carry out the checksum operation.

+  @param  Length      The size, in bytes, of Buffer.

+

+  @return Checksum    The two's complement checksum of Buffer.

+

+**/

+UINT32

+EFIAPI

+CalculateCheckSum32 (

+  IN      CONST UINT32             *Buffer,

+  IN      UINTN                     Length

+  );

+

+

+/**

+  Returns the sum of all elements in a buffer of 64-bit values.  During

+  calculation, the carry bits are dropped.

+

+  This function calculates the sum of the 64-bit values in the buffer

+  specified by Buffer and Length. The carry bits in result of addition are dropped.

+  The 64-bit result is returned.  If Length is 0, then 0 is returned.

+

+  If Buffer is NULL, then ASSERT().

+  If Buffer is not aligned on a 64-bit boundary, then ASSERT().

+  If Length is not aligned on a 64-bit boundary, then ASSERT().

+  If Length is greater than (MAX_ADDRESS - Buffer + 1), then ASSERT().

+

+  @param  Buffer      The pointer to the buffer to carry out the sum operation.

+  @param  Length      The size, in bytes, of Buffer.

+

+  @return Sum         The sum of Buffer with carry bits dropped during additions.

+

+**/

+UINT64

+EFIAPI

+CalculateSum64 (

+  IN      CONST UINT64             *Buffer,

+  IN      UINTN                     Length

+  );

+

+

+/**

+  Returns the two's complement checksum of all elements in a buffer of

+  64-bit values.

+

+  This function first calculates the sum of the 64-bit values in the buffer

+  specified by Buffer and Length.  The carry bits in the result of addition

+  are dropped. Then, the two's complement of the sum is returned.  If Length

+  is 0, then 0 is returned.

+

+  If Buffer is NULL, then ASSERT().

+  If Buffer is not aligned on a 64-bit boundary, then ASSERT().

+  If Length is not aligned on a 64-bit boundary, then ASSERT().

+  If Length is greater than (MAX_ADDRESS - Buffer + 1), then ASSERT().

+

+  @param  Buffer      The pointer to the buffer to carry out the checksum operation.

+  @param  Length      The size, in bytes, of Buffer.

+

+  @return Checksum    The two's complement checksum of Buffer.

+

+**/

+UINT64

+EFIAPI

+CalculateCheckSum64 (

+  IN      CONST UINT64             *Buffer,

+  IN      UINTN                     Length

+  );

+

+/**

+  Computes and returns a 32-bit CRC for a data buffer.

+  CRC32 value bases on ITU-T V.42.

+

+  If Buffer is NULL, then ASSERT().

+  If Length is greater than (MAX_ADDRESS - Buffer + 1), then ASSERT().

+

+  @param[in]  Buffer       A pointer to the buffer on which the 32-bit CRC is to be computed.

+  @param[in]  Length       The number of bytes in the buffer Data.

+

+  @retval Crc32            The 32-bit CRC was computed for the data buffer.

+

+**/

+UINT32

+EFIAPI

+CalculateCrc32(

+  IN  VOID                         *Buffer,

+  IN  UINTN                        Length

+  );

+

+//

+// Base Library CPU Functions

+//

+

+/**

+  Function entry point used when a stack switch is requested with SwitchStack()

+

+  @param  Context1        Context1 parameter passed into SwitchStack().

+  @param  Context2        Context2 parameter passed into SwitchStack().

+

+**/

+typedef

+VOID

+(EFIAPI *SWITCH_STACK_ENTRY_POINT)(

+  IN      VOID                      *Context1,  OPTIONAL

+  IN      VOID                      *Context2   OPTIONAL

+  );

+

+

+/**

+  Used to serialize load and store operations.

+

+  All loads and stores that proceed calls to this function are guaranteed to be

+  globally visible when this function returns.

+

+**/

+VOID

+EFIAPI

+MemoryFence (

+  VOID

+  );

+

+

+/**

+  Saves the current CPU context that can be restored with a call to LongJump()

+  and returns 0.

+

+  Saves the current CPU context in the buffer specified by JumpBuffer and

+  returns 0. The initial call to SetJump() must always return 0. Subsequent

+  calls to LongJump() cause a non-zero value to be returned by SetJump().

+

+  If JumpBuffer is NULL, then ASSERT().

+  For Itanium processors, if JumpBuffer is not aligned on a 16-byte boundary, then ASSERT().

+

+  NOTE: The structure BASE_LIBRARY_JUMP_BUFFER is CPU architecture specific.

+  The same structure must never be used for more than one CPU architecture context.

+  For example, a BASE_LIBRARY_JUMP_BUFFER allocated by an IA-32 module must never be used from an x64 module.

+  SetJump()/LongJump() is not currently supported for the EBC processor type.

+

+  @param  JumpBuffer  A pointer to CPU context buffer.

+

+  @retval 0 Indicates a return from SetJump().

+

+**/

+RETURNS_TWICE

+UINTN

+EFIAPI

+SetJump (

+  OUT     BASE_LIBRARY_JUMP_BUFFER  *JumpBuffer

+  );

+

+

+/**

+  Restores the CPU context that was saved with SetJump().

+

+  Restores the CPU context from the buffer specified by JumpBuffer. This

+  function never returns to the caller. Instead is resumes execution based on

+  the state of JumpBuffer.

+

+  If JumpBuffer is NULL, then ASSERT().

+  For Itanium processors, if JumpBuffer is not aligned on a 16-byte boundary, then ASSERT().

+  If Value is 0, then ASSERT().

+

+  @param  JumpBuffer  A pointer to CPU context buffer.

+  @param  Value       The value to return when the SetJump() context is

+                      restored and must be non-zero.

+

+**/

+VOID

+EFIAPI

+LongJump (

+  IN      BASE_LIBRARY_JUMP_BUFFER  *JumpBuffer,

+  IN      UINTN                     Value

+  );

+

+

+/**

+  Enables CPU interrupts.

+

+**/

+VOID

+EFIAPI

+EnableInterrupts (

+  VOID

+  );

+

+

+/**

+  Disables CPU interrupts.

+

+**/

+VOID

+EFIAPI

+DisableInterrupts (

+  VOID

+  );

+

+

+/**

+  Disables CPU interrupts and returns the interrupt state prior to the disable

+  operation.

+

+  @retval TRUE  CPU interrupts were enabled on entry to this call.

+  @retval FALSE CPU interrupts were disabled on entry to this call.

+

+**/

+BOOLEAN

+EFIAPI

+SaveAndDisableInterrupts (

+  VOID

+  );

+

+

+/**

+  Enables CPU interrupts for the smallest window required to capture any

+  pending interrupts.

+

+**/

+VOID

+EFIAPI

+EnableDisableInterrupts (

+  VOID

+  );

+

+

+/**

+  Retrieves the current CPU interrupt state.

+

+  Returns TRUE if interrupts are currently enabled. Otherwise

+  returns FALSE.

+

+  @retval TRUE  CPU interrupts are enabled.

+  @retval FALSE CPU interrupts are disabled.

+

+**/

+BOOLEAN

+EFIAPI

+GetInterruptState (

+  VOID

+  );

+

+

+/**

+  Set the current CPU interrupt state.

+

+  Sets the current CPU interrupt state to the state specified by

+  InterruptState. If InterruptState is TRUE, then interrupts are enabled. If

+  InterruptState is FALSE, then interrupts are disabled. InterruptState is

+  returned.

+

+  @param  InterruptState  TRUE if interrupts should enabled. FALSE if

+                          interrupts should be disabled.

+

+  @return InterruptState

+

+**/

+BOOLEAN

+EFIAPI

+SetInterruptState (

+  IN      BOOLEAN                   InterruptState

+  );

+

+

+/**

+  Requests CPU to pause for a short period of time.

+

+  Requests CPU to pause for a short period of time. Typically used in MP

+  systems to prevent memory starvation while waiting for a spin lock.

+

+**/

+VOID

+EFIAPI

+CpuPause (

+  VOID

+  );

+

+

+/**

+  Transfers control to a function starting with a new stack.

+

+  Transfers control to the function specified by EntryPoint using the

+  new stack specified by NewStack and passing in the parameters specified

+  by Context1 and Context2.  Context1 and Context2 are optional and may

+  be NULL.  The function EntryPoint must never return.  This function

+  supports a variable number of arguments following the NewStack parameter.

+  These additional arguments are ignored on IA-32, x64, and EBC architectures.

+  Itanium processors expect one additional parameter of type VOID * that specifies

+  the new backing store pointer.

+

+  If EntryPoint is NULL, then ASSERT().

+  If NewStack is NULL, then ASSERT().

+

+  @param  EntryPoint  A pointer to function to call with the new stack.

+  @param  Context1    A pointer to the context to pass into the EntryPoint

+                      function.

+  @param  Context2    A pointer to the context to pass into the EntryPoint

+                      function.

+  @param  NewStack    A pointer to the new stack to use for the EntryPoint

+                      function.

+  @param  ...         This variable argument list is ignored for IA-32, x64, and

+                      EBC architectures.  For Itanium processors, this variable

+                      argument list is expected to contain a single parameter of

+                      type VOID * that specifies the new backing store pointer.

+

+

+**/

+VOID

+EFIAPI

+SwitchStack (

+  IN      SWITCH_STACK_ENTRY_POINT  EntryPoint,

+  IN      VOID                      *Context1,  OPTIONAL

+  IN      VOID                      *Context2,  OPTIONAL

+  IN      VOID                      *NewStack,

+  ...

+  );

+

+

+/**

+  Generates a breakpoint on the CPU.

+

+  Generates a breakpoint on the CPU. The breakpoint must be implemented such

+  that code can resume normal execution after the breakpoint.

+

+**/

+VOID

+EFIAPI

+CpuBreakpoint (

+  VOID

+  );

+

+

+/**

+  Executes an infinite loop.

+

+  Forces the CPU to execute an infinite loop. A debugger may be used to skip

+  past the loop and the code that follows the loop must execute properly. This

+  implies that the infinite loop must not cause the code that follow it to be

+  optimized away.

+

+**/

+VOID

+EFIAPI

+CpuDeadLoop (

+  VOID

+  );

+

+

+/**

+  Uses as a barrier to stop speculative execution.

+

+  Ensures that no later instruction will execute speculatively, until all prior

+  instructions have completed.

+

+**/

+VOID

+EFIAPI

+SpeculationBarrier (

+  VOID

+  );

+

+

+#if defined (MDE_CPU_IA32) || defined (MDE_CPU_X64)

+///

+/// IA32 and x64 Specific Functions.

+/// Byte packed structure for 16-bit Real Mode EFLAGS.

+///

+typedef union {

+  struct {

+    UINT32  CF:1;           ///< Carry Flag.

+    UINT32  Reserved_0:1;   ///< Reserved.

+    UINT32  PF:1;           ///< Parity Flag.

+    UINT32  Reserved_1:1;   ///< Reserved.

+    UINT32  AF:1;           ///< Auxiliary Carry Flag.

+    UINT32  Reserved_2:1;   ///< Reserved.

+    UINT32  ZF:1;           ///< Zero Flag.

+    UINT32  SF:1;           ///< Sign Flag.

+    UINT32  TF:1;           ///< Trap Flag.

+    UINT32  IF:1;           ///< Interrupt Enable Flag.

+    UINT32  DF:1;           ///< Direction Flag.

+    UINT32  OF:1;           ///< Overflow Flag.

+    UINT32  IOPL:2;         ///< I/O Privilege Level.

+    UINT32  NT:1;           ///< Nested Task.

+    UINT32  Reserved_3:1;   ///< Reserved.

+  } Bits;

+  UINT16    Uint16;

+} IA32_FLAGS16;

+

+///

+/// Byte packed structure for EFLAGS/RFLAGS.

+/// 32-bits on IA-32.

+/// 64-bits on x64.  The upper 32-bits on x64 are reserved.

+///

+typedef union {

+  struct {

+    UINT32  CF:1;           ///< Carry Flag.

+    UINT32  Reserved_0:1;   ///< Reserved.

+    UINT32  PF:1;           ///< Parity Flag.

+    UINT32  Reserved_1:1;   ///< Reserved.

+    UINT32  AF:1;           ///< Auxiliary Carry Flag.

+    UINT32  Reserved_2:1;   ///< Reserved.

+    UINT32  ZF:1;           ///< Zero Flag.

+    UINT32  SF:1;           ///< Sign Flag.

+    UINT32  TF:1;           ///< Trap Flag.

+    UINT32  IF:1;           ///< Interrupt Enable Flag.

+    UINT32  DF:1;           ///< Direction Flag.

+    UINT32  OF:1;           ///< Overflow Flag.

+    UINT32  IOPL:2;         ///< I/O Privilege Level.

+    UINT32  NT:1;           ///< Nested Task.

+    UINT32  Reserved_3:1;   ///< Reserved.

+    UINT32  RF:1;           ///< Resume Flag.

+    UINT32  VM:1;           ///< Virtual 8086 Mode.

+    UINT32  AC:1;           ///< Alignment Check.

+    UINT32  VIF:1;          ///< Virtual Interrupt Flag.

+    UINT32  VIP:1;          ///< Virtual Interrupt Pending.

+    UINT32  ID:1;           ///< ID Flag.

+    UINT32  Reserved_4:10;  ///< Reserved.

+  } Bits;

+  UINTN     UintN;

+} IA32_EFLAGS32;

+

+///

+/// Byte packed structure for Control Register 0 (CR0).

+/// 32-bits on IA-32.

+/// 64-bits on x64.  The upper 32-bits on x64 are reserved.

+///

+typedef union {

+  struct {

+    UINT32  PE:1;           ///< Protection Enable.

+    UINT32  MP:1;           ///< Monitor Coprocessor.

+    UINT32  EM:1;           ///< Emulation.

+    UINT32  TS:1;           ///< Task Switched.

+    UINT32  ET:1;           ///< Extension Type.

+    UINT32  NE:1;           ///< Numeric Error.

+    UINT32  Reserved_0:10;  ///< Reserved.

+    UINT32  WP:1;           ///< Write Protect.

+    UINT32  Reserved_1:1;   ///< Reserved.

+    UINT32  AM:1;           ///< Alignment Mask.

+    UINT32  Reserved_2:10;  ///< Reserved.

+    UINT32  NW:1;           ///< Mot Write-through.

+    UINT32  CD:1;           ///< Cache Disable.

+    UINT32  PG:1;           ///< Paging.

+  } Bits;

+  UINTN     UintN;

+} IA32_CR0;

+

+///

+/// Byte packed structure for Control Register 4 (CR4).

+/// 32-bits on IA-32.

+/// 64-bits on x64.  The upper 32-bits on x64 are reserved.

+///

+typedef union {

+  struct {

+    UINT32  VME:1;          ///< Virtual-8086 Mode Extensions.

+    UINT32  PVI:1;          ///< Protected-Mode Virtual Interrupts.

+    UINT32  TSD:1;          ///< Time Stamp Disable.

+    UINT32  DE:1;           ///< Debugging Extensions.

+    UINT32  PSE:1;          ///< Page Size Extensions.

+    UINT32  PAE:1;          ///< Physical Address Extension.

+    UINT32  MCE:1;          ///< Machine Check Enable.

+    UINT32  PGE:1;          ///< Page Global Enable.

+    UINT32  PCE:1;          ///< Performance Monitoring Counter

+                            ///< Enable.

+    UINT32  OSFXSR:1;       ///< Operating System Support for

+                            ///< FXSAVE and FXRSTOR instructions

+    UINT32  OSXMMEXCPT:1;   ///< Operating System Support for

+                            ///< Unmasked SIMD Floating Point

+                            ///< Exceptions.

+    UINT32  UMIP:1;         ///< User-Mode Instruction Prevention.

+    UINT32  LA57:1;         ///< Linear Address 57bit.

+    UINT32  VMXE:1;         ///< VMX Enable.

+    UINT32  SMXE:1;         ///< SMX Enable.

+    UINT32  Reserved_3:1;   ///< Reserved.

+    UINT32  FSGSBASE:1;     ///< FSGSBASE Enable.

+    UINT32  PCIDE:1;        ///< PCID Enable.

+    UINT32  OSXSAVE:1;      ///< XSAVE and Processor Extended States Enable.

+    UINT32  Reserved_4:1;   ///< Reserved.

+    UINT32  SMEP:1;         ///< SMEP Enable.

+    UINT32  SMAP:1;         ///< SMAP Enable.

+    UINT32  PKE:1;          ///< Protection-Key Enable.

+    UINT32  Reserved_5:9;   ///< Reserved.

+  } Bits;

+  UINTN     UintN;

+} IA32_CR4;

+

+///

+/// Byte packed structure for a segment descriptor in a GDT/LDT.

+///

+typedef union {

+  struct {

+    UINT32  LimitLow:16;

+    UINT32  BaseLow:16;

+    UINT32  BaseMid:8;

+    UINT32  Type:4;

+    UINT32  S:1;

+    UINT32  DPL:2;

+    UINT32  P:1;

+    UINT32  LimitHigh:4;

+    UINT32  AVL:1;

+    UINT32  L:1;

+    UINT32  DB:1;

+    UINT32  G:1;

+    UINT32  BaseHigh:8;

+  } Bits;

+  UINT64  Uint64;

+} IA32_SEGMENT_DESCRIPTOR;

+

+///

+/// Byte packed structure for an IDTR, GDTR, LDTR descriptor.

+///

+#pragma pack (1)

+typedef struct {

+  UINT16  Limit;

+  UINTN   Base;

+} IA32_DESCRIPTOR;

+#pragma pack ()

+

+#define IA32_IDT_GATE_TYPE_TASK          0x85

+#define IA32_IDT_GATE_TYPE_INTERRUPT_16  0x86

+#define IA32_IDT_GATE_TYPE_TRAP_16       0x87

+#define IA32_IDT_GATE_TYPE_INTERRUPT_32  0x8E

+#define IA32_IDT_GATE_TYPE_TRAP_32       0x8F

+

+#define IA32_GDT_TYPE_TSS               0x9

+#define IA32_GDT_ALIGNMENT              8

+

+#if defined (MDE_CPU_IA32)

+///

+/// Byte packed structure for an IA-32 Interrupt Gate Descriptor.

+///

+typedef union {

+  struct {

+    UINT32  OffsetLow:16;   ///< Offset bits 15..0.

+    UINT32  Selector:16;    ///< Selector.

+    UINT32  Reserved_0:8;   ///< Reserved.

+    UINT32  GateType:8;     ///< Gate Type.  See #defines above.

+    UINT32  OffsetHigh:16;  ///< Offset bits 31..16.

+  } Bits;

+  UINT64  Uint64;

+} IA32_IDT_GATE_DESCRIPTOR;

+

+#pragma pack (1)

+//

+// IA32 Task-State Segment Definition

+//

+typedef struct {

+  UINT16    PreviousTaskLink;

+  UINT16    Reserved_2;

+  UINT32    ESP0;

+  UINT16    SS0;

+  UINT16    Reserved_10;

+  UINT32    ESP1;

+  UINT16    SS1;

+  UINT16    Reserved_18;

+  UINT32    ESP2;

+  UINT16    SS2;

+  UINT16    Reserved_26;

+  UINT32    CR3;

+  UINT32    EIP;

+  UINT32    EFLAGS;

+  UINT32    EAX;

+  UINT32    ECX;

+  UINT32    EDX;

+  UINT32    EBX;

+  UINT32    ESP;

+  UINT32    EBP;

+  UINT32    ESI;

+  UINT32    EDI;

+  UINT16    ES;

+  UINT16    Reserved_74;

+  UINT16    CS;

+  UINT16    Reserved_78;

+  UINT16    SS;

+  UINT16    Reserved_82;

+  UINT16    DS;

+  UINT16    Reserved_86;

+  UINT16    FS;

+  UINT16    Reserved_90;

+  UINT16    GS;

+  UINT16    Reserved_94;

+  UINT16    LDTSegmentSelector;

+  UINT16    Reserved_98;

+  UINT16    T;

+  UINT16    IOMapBaseAddress;

+} IA32_TASK_STATE_SEGMENT;

+

+typedef union {

+  struct {

+    UINT32  LimitLow:16;    ///< Segment Limit 15..00

+    UINT32  BaseLow:16;     ///< Base Address  15..00

+    UINT32  BaseMid:8;      ///< Base Address  23..16

+    UINT32  Type:4;         ///< Type (1 0 B 1)

+    UINT32  Reserved_43:1;  ///< 0

+    UINT32  DPL:2;          ///< Descriptor Privilege Level

+    UINT32  P:1;            ///< Segment Present

+    UINT32  LimitHigh:4;    ///< Segment Limit 19..16

+    UINT32  AVL:1;          ///< Available for use by system software

+    UINT32  Reserved_52:2;  ///< 0 0

+    UINT32  G:1;            ///< Granularity

+    UINT32  BaseHigh:8;     ///< Base Address 31..24

+  } Bits;

+  UINT64  Uint64;

+} IA32_TSS_DESCRIPTOR;

+#pragma pack ()

+

+#endif // defined (MDE_CPU_IA32)

+

+#if defined (MDE_CPU_X64)

+///

+/// Byte packed structure for an x64 Interrupt Gate Descriptor.

+///

+typedef union {

+  struct {

+    UINT32  OffsetLow:16;   ///< Offset bits 15..0.

+    UINT32  Selector:16;    ///< Selector.

+    UINT32  Reserved_0:8;   ///< Reserved.

+    UINT32  GateType:8;     ///< Gate Type.  See #defines above.

+    UINT32  OffsetHigh:16;  ///< Offset bits 31..16.

+    UINT32  OffsetUpper:32; ///< Offset bits 63..32.

+    UINT32  Reserved_1:32;  ///< Reserved.

+  } Bits;

+  struct {

+    UINT64  Uint64;

+    UINT64  Uint64_1;

+  } Uint128;

+} IA32_IDT_GATE_DESCRIPTOR;

+

+#pragma pack (1)

+//

+// IA32 Task-State Segment Definition

+//

+typedef struct {

+  UINT32    Reserved_0;

+  UINT64    RSP0;

+  UINT64    RSP1;

+  UINT64    RSP2;

+  UINT64    Reserved_28;

+  UINT64    IST[7];

+  UINT64    Reserved_92;

+  UINT16    Reserved_100;

+  UINT16    IOMapBaseAddress;

+} IA32_TASK_STATE_SEGMENT;

+

+typedef union {

+  struct {

+    UINT32  LimitLow:16;    ///< Segment Limit 15..00

+    UINT32  BaseLow:16;     ///< Base Address  15..00

+    UINT32  BaseMidl:8;     ///< Base Address  23..16

+    UINT32  Type:4;         ///< Type (1 0 B 1)

+    UINT32  Reserved_43:1;  ///< 0

+    UINT32  DPL:2;          ///< Descriptor Privilege Level

+    UINT32  P:1;            ///< Segment Present

+    UINT32  LimitHigh:4;    ///< Segment Limit 19..16

+    UINT32  AVL:1;          ///< Available for use by system software

+    UINT32  Reserved_52:2;  ///< 0 0

+    UINT32  G:1;            ///< Granularity

+    UINT32  BaseMidh:8;     ///< Base Address  31..24

+    UINT32  BaseHigh:32;    ///< Base Address  63..32

+    UINT32  Reserved_96:32; ///< Reserved

+  } Bits;

+  struct {

+    UINT64  Uint64;

+    UINT64  Uint64_1;

+  } Uint128;

+} IA32_TSS_DESCRIPTOR;

+#pragma pack ()

+

+#endif // defined (MDE_CPU_X64)

+

+///

+/// Byte packed structure for an FP/SSE/SSE2 context.

+///

+typedef struct {

+  UINT8  Buffer[512];

+} IA32_FX_BUFFER;

+

+///

+/// Structures for the 16-bit real mode thunks.

+///

+typedef struct {

+  UINT32                            Reserved1;

+  UINT32                            Reserved2;

+  UINT32                            Reserved3;

+  UINT32                            Reserved4;

+  UINT8                             BL;

+  UINT8                             BH;

+  UINT16                            Reserved5;

+  UINT8                             DL;

+  UINT8                             DH;

+  UINT16                            Reserved6;

+  UINT8                             CL;

+  UINT8                             CH;

+  UINT16                            Reserved7;

+  UINT8                             AL;

+  UINT8                             AH;

+  UINT16                            Reserved8;

+} IA32_BYTE_REGS;

+

+typedef struct {

+  UINT16                            DI;

+  UINT16                            Reserved1;

+  UINT16                            SI;

+  UINT16                            Reserved2;

+  UINT16                            BP;

+  UINT16                            Reserved3;

+  UINT16                            SP;

+  UINT16                            Reserved4;

+  UINT16                            BX;

+  UINT16                            Reserved5;

+  UINT16                            DX;

+  UINT16                            Reserved6;

+  UINT16                            CX;

+  UINT16                            Reserved7;

+  UINT16                            AX;

+  UINT16                            Reserved8;

+} IA32_WORD_REGS;

+

+typedef struct {

+  UINT32                            EDI;

+  UINT32                            ESI;

+  UINT32                            EBP;

+  UINT32                            ESP;

+  UINT32                            EBX;

+  UINT32                            EDX;

+  UINT32                            ECX;

+  UINT32                            EAX;

+  UINT16                            DS;

+  UINT16                            ES;

+  UINT16                            FS;

+  UINT16                            GS;

+  IA32_EFLAGS32                     EFLAGS;

+  UINT32                            Eip;

+  UINT16                            CS;

+  UINT16                            SS;

+} IA32_DWORD_REGS;

+

+typedef union {

+  IA32_DWORD_REGS                   E;

+  IA32_WORD_REGS                    X;

+  IA32_BYTE_REGS                    H;

+} IA32_REGISTER_SET;

+

+///

+/// Byte packed structure for an 16-bit real mode thunks.

+///

+typedef struct {

+  IA32_REGISTER_SET                 *RealModeState;

+  VOID                              *RealModeBuffer;

+  UINT32                            RealModeBufferSize;

+  UINT32                            ThunkAttributes;

+} THUNK_CONTEXT;

+

+#define THUNK_ATTRIBUTE_BIG_REAL_MODE             0x00000001

+#define THUNK_ATTRIBUTE_DISABLE_A20_MASK_INT_15   0x00000002

+#define THUNK_ATTRIBUTE_DISABLE_A20_MASK_KBD_CTRL 0x00000004

+

+///

+/// Type definition for representing labels in NASM source code that allow for

+/// the patching of immediate operands of IA32 and X64 instructions.

+///

+/// While the type is technically defined as a function type (note: not a

+/// pointer-to-function type), such labels in NASM source code never stand for

+/// actual functions, and identifiers declared with this function type should

+/// never be called. This is also why the EFIAPI calling convention specifier

+/// is missing from the typedef, and why the typedef does not follow the usual

+/// edk2 coding style for function (or pointer-to-function) typedefs. The VOID

+/// return type and the VOID argument list are merely artifacts.

+///

+typedef VOID (X86_ASSEMBLY_PATCH_LABEL) (VOID);

+

+/**

+  Retrieves CPUID information.

+

+  Executes the CPUID instruction with EAX set to the value specified by Index.

+  This function always returns Index.

+  If Eax is not NULL, then the value of EAX after CPUID is returned in Eax.

+  If Ebx is not NULL, then the value of EBX after CPUID is returned in Ebx.

+  If Ecx is not NULL, then the value of ECX after CPUID is returned in Ecx.

+  If Edx is not NULL, then the value of EDX after CPUID is returned in Edx.

+  This function is only available on IA-32 and x64.

+

+  @param  Index The 32-bit value to load into EAX prior to invoking the CPUID

+                instruction.

+  @param  Eax   The pointer to the 32-bit EAX value returned by the CPUID

+                instruction. This is an optional parameter that may be NULL.

+  @param  Ebx   The pointer to the 32-bit EBX value returned by the CPUID

+                instruction. This is an optional parameter that may be NULL.

+  @param  Ecx   The pointer to the 32-bit ECX value returned by the CPUID

+                instruction. This is an optional parameter that may be NULL.

+  @param  Edx   The pointer to the 32-bit EDX value returned by the CPUID

+                instruction. This is an optional parameter that may be NULL.

+

+  @return Index.

+

+**/

+UINT32

+EFIAPI

+AsmCpuid (

+  IN      UINT32                    Index,

+  OUT     UINT32                    *Eax,  OPTIONAL

+  OUT     UINT32                    *Ebx,  OPTIONAL

+  OUT     UINT32                    *Ecx,  OPTIONAL

+  OUT     UINT32                    *Edx   OPTIONAL

+  );

+

+

+/**

+  Retrieves CPUID information using an extended leaf identifier.

+

+  Executes the CPUID instruction with EAX set to the value specified by Index

+  and ECX set to the value specified by SubIndex. This function always returns

+  Index. This function is only available on IA-32 and x64.

+

+  If Eax is not NULL, then the value of EAX after CPUID is returned in Eax.

+  If Ebx is not NULL, then the value of EBX after CPUID is returned in Ebx.

+  If Ecx is not NULL, then the value of ECX after CPUID is returned in Ecx.

+  If Edx is not NULL, then the value of EDX after CPUID is returned in Edx.

+

+  @param  Index     The 32-bit value to load into EAX prior to invoking the

+                    CPUID instruction.

+  @param  SubIndex  The 32-bit value to load into ECX prior to invoking the

+                    CPUID instruction.

+  @param  Eax       The pointer to the 32-bit EAX value returned by the CPUID

+                    instruction. This is an optional parameter that may be

+                    NULL.

+  @param  Ebx       The pointer to the 32-bit EBX value returned by the CPUID

+                    instruction. This is an optional parameter that may be

+                    NULL.

+  @param  Ecx       The pointer to the 32-bit ECX value returned by the CPUID

+                    instruction. This is an optional parameter that may be

+                    NULL.

+  @param  Edx       The pointer to the 32-bit EDX value returned by the CPUID

+                    instruction. This is an optional parameter that may be

+                    NULL.

+

+  @return Index.

+

+**/

+UINT32

+EFIAPI

+AsmCpuidEx (

+  IN      UINT32                    Index,

+  IN      UINT32                    SubIndex,

+  OUT     UINT32                    *Eax,  OPTIONAL

+  OUT     UINT32                    *Ebx,  OPTIONAL

+  OUT     UINT32                    *Ecx,  OPTIONAL

+  OUT     UINT32                    *Edx   OPTIONAL

+  );

+

+

+/**

+  Set CD bit and clear NW bit of CR0 followed by a WBINVD.

+

+  Disables the caches by setting the CD bit of CR0 to 1, clearing the NW bit of CR0 to 0,

+  and executing a WBINVD instruction.  This function is only available on IA-32 and x64.

+

+**/

+VOID

+EFIAPI

+AsmDisableCache (

+  VOID

+  );

+

+

+/**

+  Perform a WBINVD and clear both the CD and NW bits of CR0.

+

+  Enables the caches by executing a WBINVD instruction and then clear both the CD and NW

+  bits of CR0 to 0.  This function is only available on IA-32 and x64.

+

+**/

+VOID

+EFIAPI

+AsmEnableCache (

+  VOID

+  );

+

+

+/**

+  Returns the lower 32-bits of a Machine Specific Register(MSR).

+

+  Reads and returns the lower 32-bits of the MSR specified by Index.

+  No parameter checking is performed on Index, and some Index values may cause

+  CPU exceptions. The caller must either guarantee that Index is valid, or the

+  caller must set up exception handlers to catch the exceptions. This function

+  is only available on IA-32 and x64.

+

+  @param  Index The 32-bit MSR index to read.

+

+  @return The lower 32 bits of the MSR identified by Index.

+

+**/

+UINT32

+EFIAPI

+AsmReadMsr32 (

+  IN      UINT32                    Index

+  );

+

+

+/**

+  Writes a 32-bit value to a Machine Specific Register(MSR), and returns the value.

+  The upper 32-bits of the MSR are set to zero.

+

+  Writes the 32-bit value specified by Value to the MSR specified by Index. The

+  upper 32-bits of the MSR write are set to zero. The 32-bit value written to

+  the MSR is returned. No parameter checking is performed on Index or Value,

+  and some of these may cause CPU exceptions. The caller must either guarantee

+  that Index and Value are valid, or the caller must establish proper exception

+  handlers. This function is only available on IA-32 and x64.

+

+  @param  Index The 32-bit MSR index to write.

+  @param  Value The 32-bit value to write to the MSR.

+

+  @return Value

+

+**/

+UINT32

+EFIAPI

+AsmWriteMsr32 (

+  IN      UINT32                    Index,

+  IN      UINT32                    Value

+  );

+

+

+/**

+  Reads a 64-bit MSR, performs a bitwise OR on the lower 32-bits, and

+  writes the result back to the 64-bit MSR.

+

+  Reads the 64-bit MSR specified by Index, performs a bitwise OR

+  between the lower 32-bits of the read result and the value specified by

+  OrData, and writes the result to the 64-bit MSR specified by Index. The lower

+  32-bits of the value written to the MSR is returned. No parameter checking is

+  performed on Index or OrData, and some of these may cause CPU exceptions. The

+  caller must either guarantee that Index and OrData are valid, or the caller

+  must establish proper exception handlers. This function is only available on

+  IA-32 and x64.

+

+  @param  Index   The 32-bit MSR index to write.

+  @param  OrData  The value to OR with the read value from the MSR.

+

+  @return The lower 32-bit value written to the MSR.

+

+**/

+UINT32

+EFIAPI

+AsmMsrOr32 (

+  IN      UINT32                    Index,

+  IN      UINT32                    OrData

+  );

+

+

+/**

+  Reads a 64-bit MSR, performs a bitwise AND on the lower 32-bits, and writes

+  the result back to the 64-bit MSR.

+

+  Reads the 64-bit MSR specified by Index, performs a bitwise AND between the

+  lower 32-bits of the read result and the value specified by AndData, and

+  writes the result to the 64-bit MSR specified by Index. The lower 32-bits of

+  the value written to the MSR is returned. No parameter checking is performed

+  on Index or AndData, and some of these may cause CPU exceptions. The caller

+  must either guarantee that Index and AndData are valid, or the caller must

+  establish proper exception handlers. This function is only available on IA-32

+  and x64.

+

+  @param  Index   The 32-bit MSR index to write.

+  @param  AndData The value to AND with the read value from the MSR.

+

+  @return The lower 32-bit value written to the MSR.

+

+**/

+UINT32

+EFIAPI

+AsmMsrAnd32 (

+  IN      UINT32                    Index,

+  IN      UINT32                    AndData

+  );

+

+

+/**

+  Reads a 64-bit MSR, performs a bitwise AND followed by a bitwise OR

+  on the lower 32-bits, and writes the result back to the 64-bit MSR.

+

+  Reads the 64-bit MSR specified by Index, performs a bitwise AND between the

+  lower 32-bits of the read result and the value specified by AndData

+  preserving the upper 32-bits, performs a bitwise OR between the

+  result of the AND operation and the value specified by OrData, and writes the

+  result to the 64-bit MSR specified by Address. The lower 32-bits of the value

+  written to the MSR is returned. No parameter checking is performed on Index,

+  AndData, or OrData, and some of these may cause CPU exceptions. The caller

+  must either guarantee that Index, AndData, and OrData are valid, or the

+  caller must establish proper exception handlers. This function is only

+  available on IA-32 and x64.

+

+  @param  Index   The 32-bit MSR index to write.

+  @param  AndData The value to AND with the read value from the MSR.

+  @param  OrData  The value to OR with the result of the AND operation.

+

+  @return The lower 32-bit value written to the MSR.

+

+**/

+UINT32

+EFIAPI

+AsmMsrAndThenOr32 (

+  IN      UINT32                    Index,

+  IN      UINT32                    AndData,

+  IN      UINT32                    OrData

+  );

+

+

+/**

+  Reads a bit field of an MSR.

+

+  Reads the bit field in the lower 32-bits of a 64-bit MSR. The bit field is

+  specified by the StartBit and the EndBit. The value of the bit field is

+  returned. The caller must either guarantee that Index is valid, or the caller

+  must set up exception handlers to catch the exceptions. This function is only

+  available on IA-32 and x64.

+

+  If StartBit is greater than 31, then ASSERT().

+  If EndBit is greater than 31, then ASSERT().

+  If EndBit is less than StartBit, then ASSERT().

+

+  @param  Index     The 32-bit MSR index to read.

+  @param  StartBit  The ordinal of the least significant bit in the bit field.

+                    Range 0..31.

+  @param  EndBit    The ordinal of the most significant bit in the bit field.

+                    Range 0..31.

+

+  @return The bit field read from the MSR.

+

+**/

+UINT32

+EFIAPI

+AsmMsrBitFieldRead32 (

+  IN      UINT32                    Index,

+  IN      UINTN                     StartBit,

+  IN      UINTN                     EndBit

+  );

+

+

+/**

+  Writes a bit field to an MSR.

+

+  Writes Value to a bit field in the lower 32-bits of a 64-bit MSR. The bit

+  field is specified by the StartBit and the EndBit. All other bits in the

+  destination MSR are preserved. The lower 32-bits of the MSR written is

+  returned. The caller must either guarantee that Index and the data written

+  is valid, or the caller must set up exception handlers to catch the exceptions.

+  This function is only available on IA-32 and x64.

+

+  If StartBit is greater than 31, then ASSERT().

+  If EndBit is greater than 31, then ASSERT().

+  If EndBit is less than StartBit, then ASSERT().

+  If Value is larger than the bitmask value range specified by StartBit and EndBit, then ASSERT().

+

+  @param  Index     The 32-bit MSR index to write.

+  @param  StartBit  The ordinal of the least significant bit in the bit field.

+                    Range 0..31.

+  @param  EndBit    The ordinal of the most significant bit in the bit field.

+                    Range 0..31.

+  @param  Value     New value of the bit field.

+

+  @return The lower 32-bit of the value written to the MSR.

+

+**/

+UINT32

+EFIAPI

+AsmMsrBitFieldWrite32 (

+  IN      UINT32                    Index,

+  IN      UINTN                     StartBit,

+  IN      UINTN                     EndBit,

+  IN      UINT32                    Value

+  );

+

+

+/**

+  Reads a bit field in a 64-bit MSR, performs a bitwise OR, and writes the

+  result back to the bit field in the 64-bit MSR.

+

+  Reads the 64-bit MSR specified by Index, performs a bitwise OR

+  between the read result and the value specified by OrData, and writes the

+  result to the 64-bit MSR specified by Index. The lower 32-bits of the value

+  written to the MSR are returned. Extra left bits in OrData are stripped. The

+  caller must either guarantee that Index and the data written is valid, or

+  the caller must set up exception handlers to catch the exceptions. This

+  function is only available on IA-32 and x64.

+

+  If StartBit is greater than 31, then ASSERT().

+  If EndBit is greater than 31, then ASSERT().

+  If EndBit is less than StartBit, then ASSERT().

+  If OrData is larger than the bitmask value range specified by StartBit and EndBit, then ASSERT().

+

+  @param  Index     The 32-bit MSR index to write.

+  @param  StartBit  The ordinal of the least significant bit in the bit field.

+                    Range 0..31.

+  @param  EndBit    The ordinal of the most significant bit in the bit field.

+                    Range 0..31.

+  @param  OrData    The value to OR with the read value from the MSR.

+

+  @return The lower 32-bit of the value written to the MSR.

+

+**/

+UINT32

+EFIAPI

+AsmMsrBitFieldOr32 (

+  IN      UINT32                    Index,

+  IN      UINTN                     StartBit,

+  IN      UINTN                     EndBit,

+  IN      UINT32                    OrData

+  );

+

+

+/**

+  Reads a bit field in a 64-bit MSR, performs a bitwise AND, and writes the

+  result back to the bit field in the 64-bit MSR.

+

+  Reads the 64-bit MSR specified by Index, performs a bitwise AND between the

+  read result and the value specified by AndData, and writes the result to the

+  64-bit MSR specified by Index. The lower 32-bits of the value written to the

+  MSR are returned. Extra left bits in AndData are stripped. The caller must

+  either guarantee that Index and the data written is valid, or the caller must

+  set up exception handlers to catch the exceptions. This function is only

+  available on IA-32 and x64.

+

+  If StartBit is greater than 31, then ASSERT().

+  If EndBit is greater than 31, then ASSERT().

+  If EndBit is less than StartBit, then ASSERT().

+  If AndData is larger than the bitmask value range specified by StartBit and EndBit, then ASSERT().

+

+  @param  Index     The 32-bit MSR index to write.

+  @param  StartBit  The ordinal of the least significant bit in the bit field.

+                    Range 0..31.

+  @param  EndBit    The ordinal of the most significant bit in the bit field.

+                    Range 0..31.

+  @param  AndData   The value to AND with the read value from the MSR.

+

+  @return The lower 32-bit of the value written to the MSR.

+

+**/

+UINT32

+EFIAPI

+AsmMsrBitFieldAnd32 (

+  IN      UINT32                    Index,

+  IN      UINTN                     StartBit,

+  IN      UINTN                     EndBit,

+  IN      UINT32                    AndData

+  );

+

+

+/**

+  Reads a bit field in a 64-bit MSR, performs a bitwise AND followed by a

+  bitwise OR, and writes the result back to the bit field in the

+  64-bit MSR.

+

+  Reads the 64-bit MSR specified by Index, performs a bitwise AND followed by a

+  bitwise OR between the read result and the value specified by

+  AndData, and writes the result to the 64-bit MSR specified by Index. The

+  lower 32-bits of the value written to the MSR are returned. Extra left bits

+  in both AndData and OrData are stripped. The caller must either guarantee

+  that Index and the data written is valid, or the caller must set up exception

+  handlers to catch the exceptions. This function is only available on IA-32

+  and x64.

+

+  If StartBit is greater than 31, then ASSERT().

+  If EndBit is greater than 31, then ASSERT().

+  If EndBit is less than StartBit, then ASSERT().

+  If AndData is larger than the bitmask value range specified by StartBit and EndBit, then ASSERT().

+  If OrData is larger than the bitmask value range specified by StartBit and EndBit, then ASSERT().

+

+  @param  Index     The 32-bit MSR index to write.

+  @param  StartBit  The ordinal of the least significant bit in the bit field.

+                    Range 0..31.

+  @param  EndBit    The ordinal of the most significant bit in the bit field.

+                    Range 0..31.

+  @param  AndData   The value to AND with the read value from the MSR.

+  @param  OrData    The value to OR with the result of the AND operation.

+

+  @return The lower 32-bit of the value written to the MSR.

+

+**/

+UINT32

+EFIAPI

+AsmMsrBitFieldAndThenOr32 (

+  IN      UINT32                    Index,

+  IN      UINTN                     StartBit,

+  IN      UINTN                     EndBit,

+  IN      UINT32                    AndData,

+  IN      UINT32                    OrData

+  );

+

+

+/**

+  Returns a 64-bit Machine Specific Register(MSR).

+

+  Reads and returns the 64-bit MSR specified by Index. No parameter checking is

+  performed on Index, and some Index values may cause CPU exceptions. The

+  caller must either guarantee that Index is valid, or the caller must set up

+  exception handlers to catch the exceptions. This function is only available

+  on IA-32 and x64.

+

+  @param  Index The 32-bit MSR index to read.

+

+  @return The value of the MSR identified by Index.

+

+**/

+UINT64

+EFIAPI

+AsmReadMsr64 (

+  IN      UINT32                    Index

+  );

+

+

+/**

+  Writes a 64-bit value to a Machine Specific Register(MSR), and returns the

+  value.

+

+  Writes the 64-bit value specified by Value to the MSR specified by Index. The

+  64-bit value written to the MSR is returned. No parameter checking is

+  performed on Index or Value, and some of these may cause CPU exceptions. The

+  caller must either guarantee that Index and Value are valid, or the caller

+  must establish proper exception handlers. This function is only available on

+  IA-32 and x64.

+

+  @param  Index The 32-bit MSR index to write.

+  @param  Value The 64-bit value to write to the MSR.

+

+  @return Value

+

+**/

+UINT64

+EFIAPI

+AsmWriteMsr64 (

+  IN      UINT32                    Index,

+  IN      UINT64                    Value

+  );

+

+

+/**

+  Reads a 64-bit MSR, performs a bitwise OR, and writes the result

+  back to the 64-bit MSR.

+

+  Reads the 64-bit MSR specified by Index, performs a bitwise OR

+  between the read result and the value specified by OrData, and writes the

+  result to the 64-bit MSR specified by Index. The value written to the MSR is

+  returned. No parameter checking is performed on Index or OrData, and some of

+  these may cause CPU exceptions. The caller must either guarantee that Index

+  and OrData are valid, or the caller must establish proper exception handlers.

+  This function is only available on IA-32 and x64.

+

+  @param  Index   The 32-bit MSR index to write.

+  @param  OrData  The value to OR with the read value from the MSR.

+

+  @return The value written back to the MSR.

+

+**/

+UINT64

+EFIAPI

+AsmMsrOr64 (

+  IN      UINT32                    Index,

+  IN      UINT64                    OrData

+  );

+

+

+/**

+  Reads a 64-bit MSR, performs a bitwise AND, and writes the result back to the

+  64-bit MSR.

+

+  Reads the 64-bit MSR specified by Index, performs a bitwise AND between the

+  read result and the value specified by OrData, and writes the result to the

+  64-bit MSR specified by Index. The value written to the MSR is returned. No

+  parameter checking is performed on Index or OrData, and some of these may

+  cause CPU exceptions. The caller must either guarantee that Index and OrData

+  are valid, or the caller must establish proper exception handlers. This

+  function is only available on IA-32 and x64.

+

+  @param  Index   The 32-bit MSR index to write.

+  @param  AndData The value to AND with the read value from the MSR.

+

+  @return The value written back to the MSR.

+

+**/

+UINT64

+EFIAPI

+AsmMsrAnd64 (

+  IN      UINT32                    Index,

+  IN      UINT64                    AndData

+  );

+

+

+/**

+  Reads a 64-bit MSR, performs a bitwise AND followed by a bitwise

+  OR, and writes the result back to the 64-bit MSR.

+

+  Reads the 64-bit MSR specified by Index, performs a bitwise AND between read

+  result and the value specified by AndData, performs a bitwise OR

+  between the result of the AND operation and the value specified by OrData,

+  and writes the result to the 64-bit MSR specified by Index. The value written

+  to the MSR is returned. No parameter checking is performed on Index, AndData,

+  or OrData, and some of these may cause CPU exceptions. The caller must either

+  guarantee that Index, AndData, and OrData are valid, or the caller must

+  establish proper exception handlers. This function is only available on IA-32

+  and x64.

+

+  @param  Index   The 32-bit MSR index to write.

+  @param  AndData The value to AND with the read value from the MSR.

+  @param  OrData  The value to OR with the result of the AND operation.

+

+  @return The value written back to the MSR.

+

+**/

+UINT64

+EFIAPI

+AsmMsrAndThenOr64 (

+  IN      UINT32                    Index,

+  IN      UINT64                    AndData,

+  IN      UINT64                    OrData

+  );

+

+

+/**

+  Reads a bit field of an MSR.

+

+  Reads the bit field in the 64-bit MSR. The bit field is specified by the

+  StartBit and the EndBit. The value of the bit field is returned. The caller

+  must either guarantee that Index is valid, or the caller must set up

+  exception handlers to catch the exceptions. This function is only available

+  on IA-32 and x64.

+

+  If StartBit is greater than 63, then ASSERT().

+  If EndBit is greater than 63, then ASSERT().

+  If EndBit is less than StartBit, then ASSERT().

+

+  @param  Index     The 32-bit MSR index to read.

+  @param  StartBit  The ordinal of the least significant bit in the bit field.

+                    Range 0..63.

+  @param  EndBit    The ordinal of the most significant bit in the bit field.

+                    Range 0..63.

+

+  @return The value read from the MSR.

+

+**/

+UINT64

+EFIAPI

+AsmMsrBitFieldRead64 (

+  IN      UINT32                    Index,

+  IN      UINTN                     StartBit,

+  IN      UINTN                     EndBit

+  );

+

+

+/**

+  Writes a bit field to an MSR.

+

+  Writes Value to a bit field in a 64-bit MSR. The bit field is specified by

+  the StartBit and the EndBit. All other bits in the destination MSR are

+  preserved. The MSR written is returned. The caller must either guarantee

+  that Index and the data written is valid, or the caller must set up exception

+  handlers to catch the exceptions. This function is only available on IA-32 and x64.

+

+  If StartBit is greater than 63, then ASSERT().

+  If EndBit is greater than 63, then ASSERT().

+  If EndBit is less than StartBit, then ASSERT().

+  If Value is larger than the bitmask value range specified by StartBit and EndBit, then ASSERT().

+

+  @param  Index     The 32-bit MSR index to write.

+  @param  StartBit  The ordinal of the least significant bit in the bit field.

+                    Range 0..63.

+  @param  EndBit    The ordinal of the most significant bit in the bit field.

+                    Range 0..63.

+  @param  Value     New value of the bit field.

+

+  @return The value written back to the MSR.

+

+**/

+UINT64

+EFIAPI

+AsmMsrBitFieldWrite64 (

+  IN      UINT32                    Index,

+  IN      UINTN                     StartBit,

+  IN      UINTN                     EndBit,

+  IN      UINT64                    Value

+  );

+

+

+/**

+  Reads a bit field in a 64-bit MSR, performs a bitwise OR, and

+  writes the result back to the bit field in the 64-bit MSR.

+

+  Reads the 64-bit MSR specified by Index, performs a bitwise OR

+  between the read result and the value specified by OrData, and writes the

+  result to the 64-bit MSR specified by Index. The value written to the MSR is

+  returned. Extra left bits in OrData are stripped. The caller must either

+  guarantee that Index and the data written is valid, or the caller must set up

+  exception handlers to catch the exceptions. This function is only available

+  on IA-32 and x64.

+

+  If StartBit is greater than 63, then ASSERT().

+  If EndBit is greater than 63, then ASSERT().

+  If EndBit is less than StartBit, then ASSERT().

+  If OrData is larger than the bitmask value range specified by StartBit and EndBit, then ASSERT().

+

+  @param  Index     The 32-bit MSR index to write.

+  @param  StartBit  The ordinal of the least significant bit in the bit field.

+                    Range 0..63.

+  @param  EndBit    The ordinal of the most significant bit in the bit field.

+                    Range 0..63.

+  @param  OrData    The value to OR with the read value from the bit field.

+

+  @return The value written back to the MSR.

+

+**/

+UINT64

+EFIAPI

+AsmMsrBitFieldOr64 (

+  IN      UINT32                    Index,

+  IN      UINTN                     StartBit,

+  IN      UINTN                     EndBit,

+  IN      UINT64                    OrData

+  );

+

+

+/**

+  Reads a bit field in a 64-bit MSR, performs a bitwise AND, and writes the

+  result back to the bit field in the 64-bit MSR.

+

+  Reads the 64-bit MSR specified by Index, performs a bitwise AND between the

+  read result and the value specified by AndData, and writes the result to the

+  64-bit MSR specified by Index. The value written to the MSR is returned.

+  Extra left bits in AndData are stripped. The caller must either guarantee

+  that Index and the data written is valid, or the caller must set up exception

+  handlers to catch the exceptions. This function is only available on IA-32

+  and x64.

+

+  If StartBit is greater than 63, then ASSERT().

+  If EndBit is greater than 63, then ASSERT().

+  If EndBit is less than StartBit, then ASSERT().

+  If AndData is larger than the bitmask value range specified by StartBit and EndBit, then ASSERT().

+

+  @param  Index     The 32-bit MSR index to write.

+  @param  StartBit  The ordinal of the least significant bit in the bit field.

+                    Range 0..63.

+  @param  EndBit    The ordinal of the most significant bit in the bit field.

+                    Range 0..63.

+  @param  AndData   The value to AND with the read value from the bit field.

+

+  @return The value written back to the MSR.

+

+**/

+UINT64

+EFIAPI

+AsmMsrBitFieldAnd64 (

+  IN      UINT32                    Index,

+  IN      UINTN                     StartBit,

+  IN      UINTN                     EndBit,

+  IN      UINT64                    AndData

+  );

+

+

+/**

+  Reads a bit field in a 64-bit MSR, performs a bitwise AND followed by a

+  bitwise OR, and writes the result back to the bit field in the

+  64-bit MSR.

+

+  Reads the 64-bit MSR specified by Index, performs a bitwise AND followed by

+  a bitwise OR between the read result and the value specified by

+  AndData, and writes the result to the 64-bit MSR specified by Index. The

+  value written to the MSR is returned. Extra left bits in both AndData and

+  OrData are stripped. The caller must either guarantee that Index and the data

+  written is valid, or the caller must set up exception handlers to catch the

+  exceptions. This function is only available on IA-32 and x64.

+

+  If StartBit is greater than 63, then ASSERT().

+  If EndBit is greater than 63, then ASSERT().

+  If EndBit is less than StartBit, then ASSERT().

+  If AndData is larger than the bitmask value range specified by StartBit and EndBit, then ASSERT().

+  If OrData is larger than the bitmask value range specified by StartBit and EndBit, then ASSERT().

+

+  @param  Index     The 32-bit MSR index to write.

+  @param  StartBit  The ordinal of the least significant bit in the bit field.

+                    Range 0..63.

+  @param  EndBit    The ordinal of the most significant bit in the bit field.

+                    Range 0..63.

+  @param  AndData   The value to AND with the read value from the bit field.

+  @param  OrData    The value to OR with the result of the AND operation.

+

+  @return The value written back to the MSR.

+

+**/

+UINT64

+EFIAPI

+AsmMsrBitFieldAndThenOr64 (

+  IN      UINT32                    Index,

+  IN      UINTN                     StartBit,

+  IN      UINTN                     EndBit,

+  IN      UINT64                    AndData,

+  IN      UINT64                    OrData

+  );

+

+

+/**

+  Reads the current value of the EFLAGS register.

+

+  Reads and returns the current value of the EFLAGS register. This function is

+  only available on IA-32 and x64. This returns a 32-bit value on IA-32 and a

+  64-bit value on x64.

+

+  @return EFLAGS on IA-32 or RFLAGS on x64.

+

+**/

+UINTN

+EFIAPI

+AsmReadEflags (

+  VOID

+  );

+

+

+/**

+  Reads the current value of the Control Register 0 (CR0).

+

+  Reads and returns the current value of CR0. This function is only available

+  on IA-32 and x64. This returns a 32-bit value on IA-32 and a 64-bit value on

+  x64.

+

+  @return The value of the Control Register 0 (CR0).

+

+**/

+UINTN

+EFIAPI

+AsmReadCr0 (

+  VOID

+  );

+

+

+/**

+  Reads the current value of the Control Register 2 (CR2).

+

+  Reads and returns the current value of CR2. This function is only available

+  on IA-32 and x64. This returns a 32-bit value on IA-32 and a 64-bit value on

+  x64.

+

+  @return The value of the Control Register 2 (CR2).

+

+**/

+UINTN

+EFIAPI

+AsmReadCr2 (

+  VOID

+  );

+

+

+/**

+  Reads the current value of the Control Register 3 (CR3).

+

+  Reads and returns the current value of CR3. This function is only available

+  on IA-32 and x64. This returns a 32-bit value on IA-32 and a 64-bit value on

+  x64.

+

+  @return The value of the Control Register 3 (CR3).

+

+**/

+UINTN

+EFIAPI

+AsmReadCr3 (

+  VOID

+  );

+

+

+/**

+  Reads the current value of the Control Register 4 (CR4).

+

+  Reads and returns the current value of CR4. This function is only available

+  on IA-32 and x64. This returns a 32-bit value on IA-32 and a 64-bit value on

+  x64.

+

+  @return The value of the Control Register 4 (CR4).

+

+**/

+UINTN

+EFIAPI

+AsmReadCr4 (

+  VOID

+  );

+

+

+/**

+  Writes a value to Control Register 0 (CR0).

+

+  Writes and returns a new value to CR0. This function is only available on

+  IA-32 and x64. This writes a 32-bit value on IA-32 and a 64-bit value on x64.

+

+  @param  Cr0 The value to write to CR0.

+

+  @return The value written to CR0.

+

+**/

+UINTN

+EFIAPI

+AsmWriteCr0 (

+  UINTN  Cr0

+  );

+

+

+/**

+  Writes a value to Control Register 2 (CR2).

+

+  Writes and returns a new value to CR2. This function is only available on

+  IA-32 and x64. This writes a 32-bit value on IA-32 and a 64-bit value on x64.

+

+  @param  Cr2 The value to write to CR2.

+

+  @return The value written to CR2.

+

+**/

+UINTN

+EFIAPI

+AsmWriteCr2 (

+  UINTN  Cr2

+  );

+

+

+/**

+  Writes a value to Control Register 3 (CR3).

+

+  Writes and returns a new value to CR3. This function is only available on

+  IA-32 and x64. This writes a 32-bit value on IA-32 and a 64-bit value on x64.

+

+  @param  Cr3 The value to write to CR3.

+

+  @return The value written to CR3.

+

+**/

+UINTN

+EFIAPI

+AsmWriteCr3 (

+  UINTN  Cr3

+  );

+

+

+/**

+  Writes a value to Control Register 4 (CR4).

+

+  Writes and returns a new value to CR4. This function is only available on

+  IA-32 and x64. This writes a 32-bit value on IA-32 and a 64-bit value on x64.

+

+  @param  Cr4 The value to write to CR4.

+

+  @return The value written to CR4.

+

+**/

+UINTN

+EFIAPI

+AsmWriteCr4 (

+  UINTN  Cr4

+  );

+

+

+/**

+  Reads the current value of Debug Register 0 (DR0).

+

+  Reads and returns the current value of DR0. This function is only available

+  on IA-32 and x64. This returns a 32-bit value on IA-32 and a 64-bit value on

+  x64.

+

+  @return The value of Debug Register 0 (DR0).

+

+**/

+UINTN

+EFIAPI

+AsmReadDr0 (

+  VOID

+  );

+

+

+/**

+  Reads the current value of Debug Register 1 (DR1).

+

+  Reads and returns the current value of DR1. This function is only available

+  on IA-32 and x64. This returns a 32-bit value on IA-32 and a 64-bit value on

+  x64.

+

+  @return The value of Debug Register 1 (DR1).

+

+**/

+UINTN

+EFIAPI

+AsmReadDr1 (

+  VOID

+  );

+

+

+/**

+  Reads the current value of Debug Register 2 (DR2).

+

+  Reads and returns the current value of DR2. This function is only available

+  on IA-32 and x64. This returns a 32-bit value on IA-32 and a 64-bit value on

+  x64.

+

+  @return The value of Debug Register 2 (DR2).

+

+**/

+UINTN

+EFIAPI

+AsmReadDr2 (

+  VOID

+  );

+

+

+/**

+  Reads the current value of Debug Register 3 (DR3).

+

+  Reads and returns the current value of DR3. This function is only available

+  on IA-32 and x64. This returns a 32-bit value on IA-32 and a 64-bit value on

+  x64.

+

+  @return The value of Debug Register 3 (DR3).

+

+**/

+UINTN

+EFIAPI

+AsmReadDr3 (

+  VOID

+  );

+

+

+/**

+  Reads the current value of Debug Register 4 (DR4).

+

+  Reads and returns the current value of DR4. This function is only available

+  on IA-32 and x64. This returns a 32-bit value on IA-32 and a 64-bit value on

+  x64.

+

+  @return The value of Debug Register 4 (DR4).

+

+**/

+UINTN

+EFIAPI

+AsmReadDr4 (

+  VOID

+  );

+

+

+/**

+  Reads the current value of Debug Register 5 (DR5).

+

+  Reads and returns the current value of DR5. This function is only available

+  on IA-32 and x64. This returns a 32-bit value on IA-32 and a 64-bit value on

+  x64.

+

+  @return The value of Debug Register 5 (DR5).

+

+**/

+UINTN

+EFIAPI

+AsmReadDr5 (

+  VOID

+  );

+

+

+/**

+  Reads the current value of Debug Register 6 (DR6).

+

+  Reads and returns the current value of DR6. This function is only available

+  on IA-32 and x64. This returns a 32-bit value on IA-32 and a 64-bit value on

+  x64.

+

+  @return The value of Debug Register 6 (DR6).

+

+**/

+UINTN

+EFIAPI

+AsmReadDr6 (

+  VOID

+  );

+

+

+/**

+  Reads the current value of Debug Register 7 (DR7).

+

+  Reads and returns the current value of DR7. This function is only available

+  on IA-32 and x64. This returns a 32-bit value on IA-32 and a 64-bit value on

+  x64.

+

+  @return The value of Debug Register 7 (DR7).

+

+**/

+UINTN

+EFIAPI

+AsmReadDr7 (

+  VOID

+  );

+

+

+/**

+  Writes a value to Debug Register 0 (DR0).

+

+  Writes and returns a new value to DR0. This function is only available on

+  IA-32 and x64. This writes a 32-bit value on IA-32 and a 64-bit value on x64.

+

+  @param  Dr0 The value to write to Dr0.

+

+  @return The value written to Debug Register 0 (DR0).

+

+**/

+UINTN

+EFIAPI

+AsmWriteDr0 (

+  UINTN  Dr0

+  );

+

+

+/**

+  Writes a value to Debug Register 1 (DR1).

+

+  Writes and returns a new value to DR1. This function is only available on

+  IA-32 and x64. This writes a 32-bit value on IA-32 and a 64-bit value on x64.

+

+  @param  Dr1 The value to write to Dr1.

+

+  @return The value written to Debug Register 1 (DR1).

+

+**/

+UINTN

+EFIAPI

+AsmWriteDr1 (

+  UINTN  Dr1

+  );

+

+

+/**

+  Writes a value to Debug Register 2 (DR2).

+

+  Writes and returns a new value to DR2. This function is only available on

+  IA-32 and x64. This writes a 32-bit value on IA-32 and a 64-bit value on x64.

+

+  @param  Dr2 The value to write to Dr2.

+

+  @return The value written to Debug Register 2 (DR2).

+

+**/

+UINTN

+EFIAPI

+AsmWriteDr2 (

+  UINTN  Dr2

+  );

+

+

+/**

+  Writes a value to Debug Register 3 (DR3).

+

+  Writes and returns a new value to DR3. This function is only available on

+  IA-32 and x64. This writes a 32-bit value on IA-32 and a 64-bit value on x64.

+

+  @param  Dr3 The value to write to Dr3.

+

+  @return The value written to Debug Register 3 (DR3).

+

+**/

+UINTN

+EFIAPI

+AsmWriteDr3 (

+  UINTN  Dr3

+  );

+

+

+/**

+  Writes a value to Debug Register 4 (DR4).

+

+  Writes and returns a new value to DR4. This function is only available on

+  IA-32 and x64. This writes a 32-bit value on IA-32 and a 64-bit value on x64.

+

+  @param  Dr4 The value to write to Dr4.

+

+  @return The value written to Debug Register 4 (DR4).

+

+**/

+UINTN

+EFIAPI

+AsmWriteDr4 (

+  UINTN  Dr4

+  );

+

+

+/**

+  Writes a value to Debug Register 5 (DR5).

+

+  Writes and returns a new value to DR5. This function is only available on

+  IA-32 and x64. This writes a 32-bit value on IA-32 and a 64-bit value on x64.

+

+  @param  Dr5 The value to write to Dr5.

+

+  @return The value written to Debug Register 5 (DR5).

+

+**/

+UINTN

+EFIAPI

+AsmWriteDr5 (

+  UINTN  Dr5

+  );

+

+

+/**

+  Writes a value to Debug Register 6 (DR6).

+

+  Writes and returns a new value to DR6. This function is only available on

+  IA-32 and x64. This writes a 32-bit value on IA-32 and a 64-bit value on x64.

+

+  @param  Dr6 The value to write to Dr6.

+

+  @return The value written to Debug Register 6 (DR6).

+

+**/

+UINTN

+EFIAPI

+AsmWriteDr6 (

+  UINTN  Dr6

+  );

+

+

+/**

+  Writes a value to Debug Register 7 (DR7).

+

+  Writes and returns a new value to DR7. This function is only available on

+  IA-32 and x64. This writes a 32-bit value on IA-32 and a 64-bit value on x64.

+

+  @param  Dr7 The value to write to Dr7.

+

+  @return The value written to Debug Register 7 (DR7).

+

+**/

+UINTN

+EFIAPI

+AsmWriteDr7 (

+  UINTN  Dr7

+  );

+

+

+/**

+  Reads the current value of Code Segment Register (CS).

+

+  Reads and returns the current value of CS. This function is only available on

+  IA-32 and x64.

+

+  @return The current value of CS.

+

+**/

+UINT16

+EFIAPI

+AsmReadCs (

+  VOID

+  );

+

+

+/**

+  Reads the current value of Data Segment Register (DS).

+

+  Reads and returns the current value of DS. This function is only available on

+  IA-32 and x64.

+

+  @return The current value of DS.

+

+**/

+UINT16

+EFIAPI

+AsmReadDs (

+  VOID

+  );

+

+

+/**

+  Reads the current value of Extra Segment Register (ES).

+

+  Reads and returns the current value of ES. This function is only available on

+  IA-32 and x64.

+

+  @return The current value of ES.

+

+**/

+UINT16

+EFIAPI

+AsmReadEs (

+  VOID

+  );

+

+

+/**

+  Reads the current value of FS Data Segment Register (FS).

+

+  Reads and returns the current value of FS. This function is only available on

+  IA-32 and x64.

+

+  @return The current value of FS.

+

+**/

+UINT16

+EFIAPI

+AsmReadFs (

+  VOID

+  );

+

+

+/**

+  Reads the current value of GS Data Segment Register (GS).

+

+  Reads and returns the current value of GS. This function is only available on

+  IA-32 and x64.

+

+  @return The current value of GS.

+

+**/

+UINT16

+EFIAPI

+AsmReadGs (

+  VOID

+  );

+

+

+/**

+  Reads the current value of Stack Segment Register (SS).

+

+  Reads and returns the current value of SS. This function is only available on

+  IA-32 and x64.

+

+  @return The current value of SS.

+

+**/

+UINT16

+EFIAPI

+AsmReadSs (

+  VOID

+  );

+

+

+/**

+  Reads the current value of Task Register (TR).

+

+  Reads and returns the current value of TR. This function is only available on

+  IA-32 and x64.

+

+  @return The current value of TR.

+

+**/

+UINT16

+EFIAPI

+AsmReadTr (

+  VOID

+  );

+

+

+/**

+  Reads the current Global Descriptor Table Register(GDTR) descriptor.

+

+  Reads and returns the current GDTR descriptor and returns it in Gdtr. This

+  function is only available on IA-32 and x64.

+

+  If Gdtr is NULL, then ASSERT().

+

+  @param  Gdtr  The pointer to a GDTR descriptor.

+

+**/

+VOID

+EFIAPI

+AsmReadGdtr (

+  OUT     IA32_DESCRIPTOR           *Gdtr

+  );

+

+

+/**

+  Writes the current Global Descriptor Table Register (GDTR) descriptor.

+

+  Writes and the current GDTR descriptor specified by Gdtr. This function is

+  only available on IA-32 and x64.

+

+  If Gdtr is NULL, then ASSERT().

+

+  @param  Gdtr  The pointer to a GDTR descriptor.

+

+**/

+VOID

+EFIAPI

+AsmWriteGdtr (

+  IN      CONST IA32_DESCRIPTOR     *Gdtr

+  );

+

+

+/**

+  Reads the current Interrupt Descriptor Table Register(IDTR) descriptor.

+

+  Reads and returns the current IDTR descriptor and returns it in Idtr. This

+  function is only available on IA-32 and x64.

+

+  If Idtr is NULL, then ASSERT().

+

+  @param  Idtr  The pointer to a IDTR descriptor.

+

+**/

+VOID

+EFIAPI

+AsmReadIdtr (

+  OUT     IA32_DESCRIPTOR           *Idtr

+  );

+

+

+/**

+  Writes the current Interrupt Descriptor Table Register(IDTR) descriptor.

+

+  Writes the current IDTR descriptor and returns it in Idtr. This function is

+  only available on IA-32 and x64.

+

+  If Idtr is NULL, then ASSERT().

+

+  @param  Idtr  The pointer to a IDTR descriptor.

+

+**/

+VOID

+EFIAPI

+AsmWriteIdtr (

+  IN      CONST IA32_DESCRIPTOR     *Idtr

+  );

+

+

+/**

+  Reads the current Local Descriptor Table Register(LDTR) selector.

+

+  Reads and returns the current 16-bit LDTR descriptor value. This function is

+  only available on IA-32 and x64.

+

+  @return The current selector of LDT.

+

+**/

+UINT16

+EFIAPI

+AsmReadLdtr (

+  VOID

+  );

+

+

+/**

+  Writes the current Local Descriptor Table Register (LDTR) selector.

+

+  Writes and the current LDTR descriptor specified by Ldtr. This function is

+  only available on IA-32 and x64.

+

+  @param  Ldtr  16-bit LDTR selector value.

+

+**/

+VOID

+EFIAPI

+AsmWriteLdtr (

+  IN      UINT16                    Ldtr

+  );

+

+

+/**

+  Save the current floating point/SSE/SSE2 context to a buffer.

+

+  Saves the current floating point/SSE/SSE2 state to the buffer specified by

+  Buffer. Buffer must be aligned on a 16-byte boundary. This function is only

+  available on IA-32 and x64.

+

+  If Buffer is NULL, then ASSERT().

+  If Buffer is not aligned on a 16-byte boundary, then ASSERT().

+

+  @param  Buffer  The pointer to a buffer to save the floating point/SSE/SSE2 context.

+

+**/

+VOID

+EFIAPI

+AsmFxSave (

+  OUT     IA32_FX_BUFFER            *Buffer

+  );

+

+

+/**

+  Restores the current floating point/SSE/SSE2 context from a buffer.

+

+  Restores the current floating point/SSE/SSE2 state from the buffer specified

+  by Buffer. Buffer must be aligned on a 16-byte boundary. This function is

+  only available on IA-32 and x64.

+

+  If Buffer is NULL, then ASSERT().

+  If Buffer is not aligned on a 16-byte boundary, then ASSERT().

+  If Buffer was not saved with AsmFxSave(), then ASSERT().

+

+  @param  Buffer  The pointer to a buffer to save the floating point/SSE/SSE2 context.

+

+**/

+VOID

+EFIAPI

+AsmFxRestore (

+  IN      CONST IA32_FX_BUFFER      *Buffer

+  );

+

+

+/**

+  Reads the current value of 64-bit MMX Register #0 (MM0).

+

+  Reads and returns the current value of MM0. This function is only available

+  on IA-32 and x64.

+

+  @return The current value of MM0.

+

+**/

+UINT64

+EFIAPI

+AsmReadMm0 (

+  VOID

+  );

+

+

+/**

+  Reads the current value of 64-bit MMX Register #1 (MM1).

+

+  Reads and returns the current value of MM1. This function is only available

+  on IA-32 and x64.

+

+  @return The current value of MM1.

+

+**/

+UINT64

+EFIAPI

+AsmReadMm1 (

+  VOID

+  );

+

+

+/**

+  Reads the current value of 64-bit MMX Register #2 (MM2).

+

+  Reads and returns the current value of MM2. This function is only available

+  on IA-32 and x64.

+

+  @return The current value of MM2.

+

+**/

+UINT64

+EFIAPI

+AsmReadMm2 (

+  VOID

+  );

+

+

+/**

+  Reads the current value of 64-bit MMX Register #3 (MM3).

+

+  Reads and returns the current value of MM3. This function is only available

+  on IA-32 and x64.

+

+  @return The current value of MM3.

+

+**/

+UINT64

+EFIAPI

+AsmReadMm3 (

+  VOID

+  );

+

+

+/**

+  Reads the current value of 64-bit MMX Register #4 (MM4).

+

+  Reads and returns the current value of MM4. This function is only available

+  on IA-32 and x64.

+

+  @return The current value of MM4.

+

+**/

+UINT64

+EFIAPI

+AsmReadMm4 (

+  VOID

+  );

+

+

+/**

+  Reads the current value of 64-bit MMX Register #5 (MM5).

+

+  Reads and returns the current value of MM5. This function is only available

+  on IA-32 and x64.

+

+  @return The current value of MM5.

+

+**/

+UINT64

+EFIAPI

+AsmReadMm5 (

+  VOID

+  );

+

+

+/**

+  Reads the current value of 64-bit MMX Register #6 (MM6).

+

+  Reads and returns the current value of MM6. This function is only available

+  on IA-32 and x64.

+

+  @return The current value of MM6.

+

+**/

+UINT64

+EFIAPI

+AsmReadMm6 (

+  VOID

+  );

+

+

+/**

+  Reads the current value of 64-bit MMX Register #7 (MM7).

+

+  Reads and returns the current value of MM7. This function is only available

+  on IA-32 and x64.

+

+  @return The current value of MM7.

+

+**/

+UINT64

+EFIAPI

+AsmReadMm7 (

+  VOID

+  );

+

+

+/**

+  Writes the current value of 64-bit MMX Register #0 (MM0).

+

+  Writes the current value of MM0. This function is only available on IA32 and

+  x64.

+

+  @param  Value The 64-bit value to write to MM0.

+

+**/

+VOID

+EFIAPI

+AsmWriteMm0 (

+  IN      UINT64                    Value

+  );

+

+

+/**

+  Writes the current value of 64-bit MMX Register #1 (MM1).

+

+  Writes the current value of MM1. This function is only available on IA32 and

+  x64.

+

+  @param  Value The 64-bit value to write to MM1.

+

+**/

+VOID

+EFIAPI

+AsmWriteMm1 (

+  IN      UINT64                    Value

+  );

+

+

+/**

+  Writes the current value of 64-bit MMX Register #2 (MM2).

+

+  Writes the current value of MM2. This function is only available on IA32 and

+  x64.

+

+  @param  Value The 64-bit value to write to MM2.

+

+**/

+VOID

+EFIAPI

+AsmWriteMm2 (

+  IN      UINT64                    Value

+  );

+

+

+/**

+  Writes the current value of 64-bit MMX Register #3 (MM3).

+

+  Writes the current value of MM3. This function is only available on IA32 and

+  x64.

+

+  @param  Value The 64-bit value to write to MM3.

+

+**/

+VOID

+EFIAPI

+AsmWriteMm3 (

+  IN      UINT64                    Value

+  );

+

+

+/**

+  Writes the current value of 64-bit MMX Register #4 (MM4).

+

+  Writes the current value of MM4. This function is only available on IA32 and

+  x64.

+

+  @param  Value The 64-bit value to write to MM4.

+

+**/

+VOID

+EFIAPI

+AsmWriteMm4 (

+  IN      UINT64                    Value

+  );

+

+

+/**

+  Writes the current value of 64-bit MMX Register #5 (MM5).

+

+  Writes the current value of MM5. This function is only available on IA32 and

+  x64.

+

+  @param  Value The 64-bit value to write to MM5.

+

+**/

+VOID

+EFIAPI

+AsmWriteMm5 (

+  IN      UINT64                    Value

+  );

+

+

+/**

+  Writes the current value of 64-bit MMX Register #6 (MM6).

+

+  Writes the current value of MM6. This function is only available on IA32 and

+  x64.

+

+  @param  Value The 64-bit value to write to MM6.

+

+**/

+VOID

+EFIAPI

+AsmWriteMm6 (

+  IN      UINT64                    Value

+  );

+

+

+/**

+  Writes the current value of 64-bit MMX Register #7 (MM7).

+

+  Writes the current value of MM7. This function is only available on IA32 and

+  x64.

+

+  @param  Value The 64-bit value to write to MM7.

+

+**/

+VOID

+EFIAPI

+AsmWriteMm7 (

+  IN      UINT64                    Value

+  );

+

+

+/**

+  Reads the current value of Time Stamp Counter (TSC).

+

+  Reads and returns the current value of TSC. This function is only available

+  on IA-32 and x64.

+

+  @return The current value of TSC

+

+**/

+UINT64

+EFIAPI

+AsmReadTsc (

+  VOID

+  );

+

+

+/**

+  Reads the current value of a Performance Counter (PMC).

+

+  Reads and returns the current value of performance counter specified by

+  Index. This function is only available on IA-32 and x64.

+

+  @param  Index The 32-bit Performance Counter index to read.

+

+  @return The value of the PMC specified by Index.

+

+**/

+UINT64

+EFIAPI

+AsmReadPmc (

+  IN      UINT32                    Index

+  );

+

+

+/**

+  Sets up a monitor buffer that is used by AsmMwait().

+

+  Executes a MONITOR instruction with the register state specified by Eax, Ecx

+  and Edx. Returns Eax. This function is only available on IA-32 and x64.

+

+  @param  Eax The value to load into EAX or RAX before executing the MONITOR

+              instruction.

+  @param  Ecx The value to load into ECX or RCX before executing the MONITOR

+              instruction.

+  @param  Edx The value to load into EDX or RDX before executing the MONITOR

+              instruction.

+

+  @return Eax

+

+**/

+UINTN

+EFIAPI

+AsmMonitor (

+  IN      UINTN                     Eax,

+  IN      UINTN                     Ecx,

+  IN      UINTN                     Edx

+  );

+

+

+/**

+  Executes an MWAIT instruction.

+

+  Executes an MWAIT instruction with the register state specified by Eax and

+  Ecx. Returns Eax. This function is only available on IA-32 and x64.

+

+  @param  Eax The value to load into EAX or RAX before executing the MONITOR

+              instruction.

+  @param  Ecx The value to load into ECX or RCX before executing the MONITOR

+              instruction.

+

+  @return Eax

+

+**/

+UINTN

+EFIAPI

+AsmMwait (

+  IN      UINTN                     Eax,

+  IN      UINTN                     Ecx

+  );

+

+

+/**

+  Executes a WBINVD instruction.

+

+  Executes a WBINVD instruction. This function is only available on IA-32 and

+  x64.

+

+**/

+VOID

+EFIAPI

+AsmWbinvd (

+  VOID

+  );

+

+

+/**

+  Executes a INVD instruction.

+

+  Executes a INVD instruction. This function is only available on IA-32 and

+  x64.

+

+**/

+VOID

+EFIAPI

+AsmInvd (

+  VOID

+  );

+

+

+/**

+  Flushes a cache line from all the instruction and data caches within the

+  coherency domain of the CPU.

+

+  Flushed the cache line specified by LinearAddress, and returns LinearAddress.

+  This function is only available on IA-32 and x64.

+

+  @param  LinearAddress The address of the cache line to flush. If the CPU is

+                        in a physical addressing mode, then LinearAddress is a

+                        physical address. If the CPU is in a virtual

+                        addressing mode, then LinearAddress is a virtual

+                        address.

+

+  @return LinearAddress.

+**/

+VOID *

+EFIAPI

+AsmFlushCacheLine (

+  IN      VOID                      *LinearAddress

+  );

+

+

+/**

+  Enables the 32-bit paging mode on the CPU.

+

+  Enables the 32-bit paging mode on the CPU. CR0, CR3, CR4, and the page tables

+  must be properly initialized prior to calling this service. This function

+  assumes the current execution mode is 32-bit protected mode. This function is

+  only available on IA-32. After the 32-bit paging mode is enabled, control is

+  transferred to the function specified by EntryPoint using the new stack

+  specified by NewStack and passing in the parameters specified by Context1 and

+  Context2. Context1 and Context2 are optional and may be NULL. The function

+  EntryPoint must never return.

+

+  If the current execution mode is not 32-bit protected mode, then ASSERT().

+  If EntryPoint is NULL, then ASSERT().

+  If NewStack is NULL, then ASSERT().

+

+  There are a number of constraints that must be followed before calling this

+  function:

+  1)  Interrupts must be disabled.

+  2)  The caller must be in 32-bit protected mode with flat descriptors. This

+      means all descriptors must have a base of 0 and a limit of 4GB.

+  3)  CR0 and CR4 must be compatible with 32-bit protected mode with flat

+      descriptors.

+  4)  CR3 must point to valid page tables that will be used once the transition

+      is complete, and those page tables must guarantee that the pages for this

+      function and the stack are identity mapped.

+

+  @param  EntryPoint  A pointer to function to call with the new stack after

+                      paging is enabled.

+  @param  Context1    A pointer to the context to pass into the EntryPoint

+                      function as the first parameter after paging is enabled.

+  @param  Context2    A pointer to the context to pass into the EntryPoint

+                      function as the second parameter after paging is enabled.

+  @param  NewStack    A pointer to the new stack to use for the EntryPoint

+                      function after paging is enabled.

+

+**/

+VOID

+EFIAPI

+AsmEnablePaging32 (

+  IN      SWITCH_STACK_ENTRY_POINT  EntryPoint,

+  IN      VOID                      *Context1,  OPTIONAL

+  IN      VOID                      *Context2,  OPTIONAL

+  IN      VOID                      *NewStack

+  );

+

+

+/**

+  Disables the 32-bit paging mode on the CPU.

+

+  Disables the 32-bit paging mode on the CPU and returns to 32-bit protected

+  mode. This function assumes the current execution mode is 32-paged protected

+  mode. This function is only available on IA-32. After the 32-bit paging mode

+  is disabled, control is transferred to the function specified by EntryPoint

+  using the new stack specified by NewStack and passing in the parameters

+  specified by Context1 and Context2. Context1 and Context2 are optional and

+  may be NULL. The function EntryPoint must never return.

+

+  If the current execution mode is not 32-bit paged mode, then ASSERT().

+  If EntryPoint is NULL, then ASSERT().

+  If NewStack is NULL, then ASSERT().

+

+  There are a number of constraints that must be followed before calling this

+  function:

+  1)  Interrupts must be disabled.

+  2)  The caller must be in 32-bit paged mode.

+  3)  CR0, CR3, and CR4 must be compatible with 32-bit paged mode.

+  4)  CR3 must point to valid page tables that guarantee that the pages for

+      this function and the stack are identity mapped.

+

+  @param  EntryPoint  A pointer to function to call with the new stack after

+                      paging is disabled.

+  @param  Context1    A pointer to the context to pass into the EntryPoint

+                      function as the first parameter after paging is disabled.

+  @param  Context2    A pointer to the context to pass into the EntryPoint

+                      function as the second parameter after paging is

+                      disabled.

+  @param  NewStack    A pointer to the new stack to use for the EntryPoint

+                      function after paging is disabled.

+

+**/

+VOID

+EFIAPI

+AsmDisablePaging32 (

+  IN      SWITCH_STACK_ENTRY_POINT  EntryPoint,

+  IN      VOID                      *Context1,  OPTIONAL

+  IN      VOID                      *Context2,  OPTIONAL

+  IN      VOID                      *NewStack

+  );

+

+

+/**

+  Enables the 64-bit paging mode on the CPU.

+

+  Enables the 64-bit paging mode on the CPU. CR0, CR3, CR4, and the page tables

+  must be properly initialized prior to calling this service. This function

+  assumes the current execution mode is 32-bit protected mode with flat

+  descriptors. This function is only available on IA-32. After the 64-bit

+  paging mode is enabled, control is transferred to the function specified by

+  EntryPoint using the new stack specified by NewStack and passing in the

+  parameters specified by Context1 and Context2. Context1 and Context2 are

+  optional and may be 0. The function EntryPoint must never return.

+

+  If the current execution mode is not 32-bit protected mode with flat

+  descriptors, then ASSERT().

+  If EntryPoint is 0, then ASSERT().

+  If NewStack is 0, then ASSERT().

+

+  @param  Cs          The 16-bit selector to load in the CS before EntryPoint

+                      is called. The descriptor in the GDT that this selector

+                      references must be setup for long mode.

+  @param  EntryPoint  The 64-bit virtual address of the function to call with

+                      the new stack after paging is enabled.

+  @param  Context1    The 64-bit virtual address of the context to pass into

+                      the EntryPoint function as the first parameter after

+                      paging is enabled.

+  @param  Context2    The 64-bit virtual address of the context to pass into

+                      the EntryPoint function as the second parameter after

+                      paging is enabled.

+  @param  NewStack    The 64-bit virtual address of the new stack to use for

+                      the EntryPoint function after paging is enabled.

+

+**/

+VOID

+EFIAPI

+AsmEnablePaging64 (

+  IN      UINT16                    Cs,

+  IN      UINT64                    EntryPoint,

+  IN      UINT64                    Context1,  OPTIONAL

+  IN      UINT64                    Context2,  OPTIONAL

+  IN      UINT64                    NewStack

+  );

+

+

+/**

+  Disables the 64-bit paging mode on the CPU.

+

+  Disables the 64-bit paging mode on the CPU and returns to 32-bit protected

+  mode. This function assumes the current execution mode is 64-paging mode.

+  This function is only available on x64. After the 64-bit paging mode is

+  disabled, control is transferred to the function specified by EntryPoint

+  using the new stack specified by NewStack and passing in the parameters

+  specified by Context1 and Context2. Context1 and Context2 are optional and

+  may be 0. The function EntryPoint must never return.

+

+  If the current execution mode is not 64-bit paged mode, then ASSERT().

+  If EntryPoint is 0, then ASSERT().

+  If NewStack is 0, then ASSERT().

+

+  @param  Cs          The 16-bit selector to load in the CS before EntryPoint

+                      is called. The descriptor in the GDT that this selector

+                      references must be setup for 32-bit protected mode.

+  @param  EntryPoint  The 64-bit virtual address of the function to call with

+                      the new stack after paging is disabled.

+  @param  Context1    The 64-bit virtual address of the context to pass into

+                      the EntryPoint function as the first parameter after

+                      paging is disabled.

+  @param  Context2    The 64-bit virtual address of the context to pass into

+                      the EntryPoint function as the second parameter after

+                      paging is disabled.

+  @param  NewStack    The 64-bit virtual address of the new stack to use for

+                      the EntryPoint function after paging is disabled.

+

+**/

+VOID

+EFIAPI

+AsmDisablePaging64 (

+  IN      UINT16                    Cs,

+  IN      UINT32                    EntryPoint,

+  IN      UINT32                    Context1,  OPTIONAL

+  IN      UINT32                    Context2,  OPTIONAL

+  IN      UINT32                    NewStack

+  );

+

+

+//

+// 16-bit thunking services

+//

+

+/**

+  Retrieves the properties for 16-bit thunk functions.

+

+  Computes the size of the buffer and stack below 1MB required to use the

+  AsmPrepareThunk16(), AsmThunk16() and AsmPrepareAndThunk16() functions. This

+  buffer size is returned in RealModeBufferSize, and the stack size is returned

+  in ExtraStackSize. If parameters are passed to the 16-bit real mode code,

+  then the actual minimum stack size is ExtraStackSize plus the maximum number

+  of bytes that need to be passed to the 16-bit real mode code.

+

+  If RealModeBufferSize is NULL, then ASSERT().

+  If ExtraStackSize is NULL, then ASSERT().

+

+  @param  RealModeBufferSize  A pointer to the size of the buffer below 1MB

+                              required to use the 16-bit thunk functions.

+  @param  ExtraStackSize      A pointer to the extra size of stack below 1MB

+                              that the 16-bit thunk functions require for

+                              temporary storage in the transition to and from

+                              16-bit real mode.

+

+**/

+VOID

+EFIAPI

+AsmGetThunk16Properties (

+  OUT     UINT32                    *RealModeBufferSize,

+  OUT     UINT32                    *ExtraStackSize

+  );

+

+

+/**

+  Prepares all structures a code required to use AsmThunk16().

+

+  Prepares all structures and code required to use AsmThunk16().

+

+  This interface is limited to be used in either physical mode or virtual modes with paging enabled where the

+  virtual to physical mappings for ThunkContext.RealModeBuffer is mapped 1:1.

+

+  If ThunkContext is NULL, then ASSERT().

+

+  @param  ThunkContext  A pointer to the context structure that describes the

+                        16-bit real mode code to call.

+

+**/

+VOID

+EFIAPI

+AsmPrepareThunk16 (

+  IN OUT  THUNK_CONTEXT             *ThunkContext

+  );

+

+

+/**

+  Transfers control to a 16-bit real mode entry point and returns the results.

+

+  Transfers control to a 16-bit real mode entry point and returns the results.

+  AsmPrepareThunk16() must be called with ThunkContext before this function is used.

+  This function must be called with interrupts disabled.

+

+  The register state from the RealModeState field of ThunkContext is restored just prior

+  to calling the 16-bit real mode entry point.  This includes the EFLAGS field of RealModeState,

+  which is used to set the interrupt state when a 16-bit real mode entry point is called.

+  Control is transferred to the 16-bit real mode entry point specified by the CS and Eip fields of RealModeState.

+  The stack is initialized to the SS and ESP fields of RealModeState.  Any parameters passed to

+  the 16-bit real mode code must be populated by the caller at SS:ESP prior to calling this function.

+  The 16-bit real mode entry point is invoked with a 16-bit CALL FAR instruction,

+  so when accessing stack contents, the 16-bit real mode code must account for the 16-bit segment

+  and 16-bit offset of the return address that were pushed onto the stack. The 16-bit real mode entry

+  point must exit with a RETF instruction. The register state is captured into RealModeState immediately

+  after the RETF instruction is executed.

+

+  If EFLAGS specifies interrupts enabled, or any of the 16-bit real mode code enables interrupts,

+  or any of the 16-bit real mode code makes a SW interrupt, then the caller is responsible for making sure

+  the IDT at address 0 is initialized to handle any HW or SW interrupts that may occur while in 16-bit real mode.

+

+  If EFLAGS specifies interrupts enabled, or any of the 16-bit real mode code enables interrupts,

+  then the caller is responsible for making sure the 8259 PIC is in a state compatible with 16-bit real mode.

+  This includes the base vectors, the interrupt masks, and the edge/level trigger mode.

+

+  If THUNK_ATTRIBUTE_BIG_REAL_MODE is set in the ThunkAttributes field of ThunkContext, then the user code

+  is invoked in big real mode.  Otherwise, the user code is invoked in 16-bit real mode with 64KB segment limits.

+

+  If neither THUNK_ATTRIBUTE_DISABLE_A20_MASK_INT_15 nor THUNK_ATTRIBUTE_DISABLE_A20_MASK_KBD_CTRL are set in

+  ThunkAttributes, then it is assumed that the user code did not enable the A20 mask, and no attempt is made to

+  disable the A20 mask.

+

+  If THUNK_ATTRIBUTE_DISABLE_A20_MASK_INT_15 is set and THUNK_ATTRIBUTE_DISABLE_A20_MASK_KBD_CTRL is clear in

+  ThunkAttributes, then attempt to use the INT 15 service to disable the A20 mask.  If this INT 15 call fails,

+  then attempt to disable the A20 mask by directly accessing the 8042 keyboard controller I/O ports.

+

+  If THUNK_ATTRIBUTE_DISABLE_A20_MASK_INT_15 is clear and THUNK_ATTRIBUTE_DISABLE_A20_MASK_KBD_CTRL is set in

+  ThunkAttributes, then attempt to disable the A20 mask by directly accessing the 8042 keyboard controller I/O ports.

+

+  If ThunkContext is NULL, then ASSERT().

+  If AsmPrepareThunk16() was not previously called with ThunkContext, then ASSERT().

+  If both THUNK_ATTRIBUTE_DISABLE_A20_MASK_INT_15 and THUNK_ATTRIBUTE_DISABLE_A20_MASK_KBD_CTRL are set in

+  ThunkAttributes, then ASSERT().

+

+  This interface is limited to be used in either physical mode or virtual modes with paging enabled where the

+  virtual to physical mappings for ThunkContext.RealModeBuffer are mapped 1:1.

+

+  @param  ThunkContext  A pointer to the context structure that describes the

+                        16-bit real mode code to call.

+

+**/

+VOID

+EFIAPI

+AsmThunk16 (

+  IN OUT  THUNK_CONTEXT             *ThunkContext

+  );

+

+

+/**

+  Prepares all structures and code for a 16-bit real mode thunk, transfers

+  control to a 16-bit real mode entry point, and returns the results.

+

+  Prepares all structures and code for a 16-bit real mode thunk, transfers

+  control to a 16-bit real mode entry point, and returns the results. If the

+  caller only need to perform a single 16-bit real mode thunk, then this

+  service should be used. If the caller intends to make more than one 16-bit

+  real mode thunk, then it is more efficient if AsmPrepareThunk16() is called

+  once and AsmThunk16() can be called for each 16-bit real mode thunk.

+

+  This interface is limited to be used in either physical mode or virtual modes with paging enabled where the

+  virtual to physical mappings for ThunkContext.RealModeBuffer is mapped 1:1.

+

+  See AsmPrepareThunk16() and AsmThunk16() for the detailed description and ASSERT() conditions.

+

+  @param  ThunkContext  A pointer to the context structure that describes the

+                        16-bit real mode code to call.

+

+**/

+VOID

+EFIAPI

+AsmPrepareAndThunk16 (

+  IN OUT  THUNK_CONTEXT             *ThunkContext

+  );

+

+/**

+  Generates a 16-bit random number through RDRAND instruction.

+

+  if Rand is NULL, then ASSERT().

+

+  @param[out]  Rand     Buffer pointer to store the random result.

+

+  @retval TRUE          RDRAND call was successful.

+  @retval FALSE         Failed attempts to call RDRAND.

+

+ **/

+BOOLEAN

+EFIAPI

+AsmRdRand16 (

+  OUT     UINT16                    *Rand

+  );

+

+/**

+  Generates a 32-bit random number through RDRAND instruction.

+

+  if Rand is NULL, then ASSERT().

+

+  @param[out]  Rand     Buffer pointer to store the random result.

+

+  @retval TRUE          RDRAND call was successful.

+  @retval FALSE         Failed attempts to call RDRAND.

+

+**/

+BOOLEAN

+EFIAPI

+AsmRdRand32 (

+  OUT     UINT32                    *Rand

+  );

+

+/**

+  Generates a 64-bit random number through RDRAND instruction.

+

+  if Rand is NULL, then ASSERT().

+

+  @param[out]  Rand     Buffer pointer to store the random result.

+

+  @retval TRUE          RDRAND call was successful.

+  @retval FALSE         Failed attempts to call RDRAND.

+

+**/

+BOOLEAN

+EFIAPI

+AsmRdRand64  (

+  OUT     UINT64                    *Rand

+  );

+

+/**

+  Load given selector into TR register.

+

+  @param[in] Selector     Task segment selector

+**/

+VOID

+EFIAPI

+AsmWriteTr (

+  IN UINT16 Selector

+  );

+

+/**

+  Performs a serializing operation on all load-from-memory instructions that

+  were issued prior the AsmLfence function.

+

+  Executes a LFENCE instruction. This function is only available on IA-32 and x64.

+

+**/

+VOID

+EFIAPI

+AsmLfence (

+  VOID

+  );

+

+/**

+  Patch the immediate operand of an IA32 or X64 instruction such that the byte,

+  word, dword or qword operand is encoded at the end of the instruction's

+  binary representation.

+

+  This function should be used to update object code that was compiled with

+  NASM from assembly source code. Example:

+

+  NASM source code:

+

+        mov     eax, strict dword 0 ; the imm32 zero operand will be patched

+    ASM_PFX(gPatchCr3):

+        mov     cr3, eax

+

+  C source code:

+

+    X86_ASSEMBLY_PATCH_LABEL gPatchCr3;

+    PatchInstructionX86 (gPatchCr3, AsmReadCr3 (), 4);

+

+  @param[out] InstructionEnd  Pointer right past the instruction to patch. The

+                              immediate operand to patch is expected to

+                              comprise the trailing bytes of the instruction.

+                              If InstructionEnd is closer to address 0 than

+                              ValueSize permits, then ASSERT().

+

+  @param[in] PatchValue       The constant to write to the immediate operand.

+                              The caller is responsible for ensuring that

+                              PatchValue can be represented in the byte, word,

+                              dword or qword operand (as indicated through

+                              ValueSize); otherwise ASSERT().

+

+  @param[in] ValueSize        The size of the operand in bytes; must be 1, 2,

+                              4, or 8. ASSERT() otherwise.

+**/

+VOID

+EFIAPI

+PatchInstructionX86 (

+  OUT X86_ASSEMBLY_PATCH_LABEL *InstructionEnd,

+  IN  UINT64                   PatchValue,

+  IN  UINTN                    ValueSize

+  );

+

+#endif // defined (MDE_CPU_IA32) || defined (MDE_CPU_X64)

+#endif // !defined (__BASE_LIB__)

diff --git a/debugging_demo/memtest86+/efi/Include/Library/BaseMemoryLib.h b/debugging_demo/memtest86+/efi/Include/Library/BaseMemoryLib.h
new file mode 100644
index 0000000..a378ed1
--- /dev/null
+++ b/debugging_demo/memtest86+/efi/Include/Library/BaseMemoryLib.h
@@ -0,0 +1,484 @@
+/** @file

+  Provides copy memory, fill memory, zero memory, and GUID functions.

+

+  The Base Memory Library provides optimized implementations for common memory-based operations.

+  These functions should be used in place of coding your own loops to do equivalent common functions.

+  This allows optimized library implementations to help increase performance.

+

+Copyright (c) 2006 - 2018, Intel Corporation. All rights reserved.<BR>

+SPDX-License-Identifier: BSD-2-Clause-Patent

+

+**/

+#include "Base.h"

+

+#ifndef __BASE_MEMORY_LIB__

+#define __BASE_MEMORY_LIB__

+

+/**

+  Copies a source buffer to a destination buffer, and returns the destination buffer.

+

+  This function copies Length bytes from SourceBuffer to DestinationBuffer, and returns

+  DestinationBuffer.  The implementation must be reentrant, and it must handle the case

+  where SourceBuffer overlaps DestinationBuffer.

+

+  If Length is greater than (MAX_ADDRESS - DestinationBuffer + 1), then ASSERT().

+  If Length is greater than (MAX_ADDRESS - SourceBuffer + 1), then ASSERT().

+

+  @param  DestinationBuffer   The pointer to the destination buffer of the memory copy.

+  @param  SourceBuffer        The pointer to the source buffer of the memory copy.

+  @param  Length              The number of bytes to copy from SourceBuffer to DestinationBuffer.

+

+  @return DestinationBuffer.

+

+**/

+VOID *

+EFIAPI

+CopyMem (

+  OUT VOID       *DestinationBuffer,

+  IN CONST VOID  *SourceBuffer,

+  IN UINTN       Length

+  );

+

+/**

+  Fills a target buffer with a byte value, and returns the target buffer.

+

+  This function fills Length bytes of Buffer with Value, and returns Buffer.

+

+  If Length is greater than (MAX_ADDRESS - Buffer + 1), then ASSERT().

+

+  @param  Buffer    The memory to set.

+  @param  Length    The number of bytes to set.

+  @param  Value     The value with which to fill Length bytes of Buffer.

+

+  @return Buffer.

+

+**/

+VOID *

+EFIAPI

+SetMem (

+  OUT VOID  *Buffer,

+  IN UINTN  Length,

+  IN UINT8  Value

+  );

+

+/**

+  Fills a target buffer with a 16-bit value, and returns the target buffer.

+

+  This function fills Length bytes of Buffer with the 16-bit value specified by

+  Value, and returns Buffer. Value is repeated every 16-bits in for Length

+  bytes of Buffer.

+

+  If Length > 0 and Buffer is NULL, then ASSERT().

+  If Length is greater than (MAX_ADDRESS - Buffer + 1), then ASSERT().

+  If Buffer is not aligned on a 16-bit boundary, then ASSERT().

+  If Length is not aligned on a 16-bit boundary, then ASSERT().

+

+  @param  Buffer  The pointer to the target buffer to fill.

+  @param  Length  The number of bytes in Buffer to fill.

+  @param  Value   The value with which to fill Length bytes of Buffer.

+

+  @return Buffer.

+

+**/

+VOID *

+EFIAPI

+SetMem16 (

+  OUT VOID   *Buffer,

+  IN UINTN   Length,

+  IN UINT16  Value

+  );

+

+/**

+  Fills a target buffer with a 32-bit value, and returns the target buffer.

+

+  This function fills Length bytes of Buffer with the 32-bit value specified by

+  Value, and returns Buffer. Value is repeated every 32-bits in for Length

+  bytes of Buffer.

+

+  If Length > 0 and Buffer is NULL, then ASSERT().

+  If Length is greater than (MAX_ADDRESS - Buffer + 1), then ASSERT().

+  If Buffer is not aligned on a 32-bit boundary, then ASSERT().

+  If Length is not aligned on a 32-bit boundary, then ASSERT().

+

+  @param  Buffer  The pointer to the target buffer to fill.

+  @param  Length  The number of bytes in Buffer to fill.

+  @param  Value   The value with which to fill Length bytes of Buffer.

+

+  @return Buffer.

+

+**/

+VOID *

+EFIAPI

+SetMem32 (

+  OUT VOID   *Buffer,

+  IN UINTN   Length,

+  IN UINT32  Value

+  );

+

+/**

+  Fills a target buffer with a 64-bit value, and returns the target buffer.

+

+  This function fills Length bytes of Buffer with the 64-bit value specified by

+  Value, and returns Buffer. Value is repeated every 64-bits in for Length

+  bytes of Buffer.

+

+  If Length > 0 and Buffer is NULL, then ASSERT().

+  If Length is greater than (MAX_ADDRESS - Buffer + 1), then ASSERT().

+  If Buffer is not aligned on a 64-bit boundary, then ASSERT().

+  If Length is not aligned on a 64-bit boundary, then ASSERT().

+

+  @param  Buffer  The pointer to the target buffer to fill.

+  @param  Length  The number of bytes in Buffer to fill.

+  @param  Value   The value with which to fill Length bytes of Buffer.

+

+  @return Buffer.

+

+**/

+VOID *

+EFIAPI

+SetMem64 (

+  OUT VOID   *Buffer,

+  IN UINTN   Length,

+  IN UINT64  Value

+  );

+

+/**

+  Fills a target buffer with a value that is size UINTN, and returns the target buffer.

+

+  This function fills Length bytes of Buffer with the UINTN sized value specified by

+  Value, and returns Buffer. Value is repeated every sizeof(UINTN) bytes for Length

+  bytes of Buffer.

+

+  If Length > 0 and Buffer is NULL, then ASSERT().

+  If Length is greater than (MAX_ADDRESS - Buffer + 1), then ASSERT().

+  If Buffer is not aligned on a UINTN boundary, then ASSERT().

+  If Length is not aligned on a UINTN boundary, then ASSERT().

+

+  @param  Buffer  The pointer to the target buffer to fill.

+  @param  Length  The number of bytes in Buffer to fill.

+  @param  Value   The value with which to fill Length bytes of Buffer.

+

+  @return Buffer.

+

+**/

+VOID *

+EFIAPI

+SetMemN (

+  OUT VOID  *Buffer,

+  IN UINTN  Length,

+  IN UINTN  Value

+  );

+

+/**

+  Fills a target buffer with zeros, and returns the target buffer.

+

+  This function fills Length bytes of Buffer with zeros, and returns Buffer.

+

+  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 fill with zeros.

+  @param  Length      The number of bytes in Buffer to fill with zeros.

+

+  @return Buffer.

+

+**/

+VOID *

+EFIAPI

+ZeroMem (

+  OUT VOID  *Buffer,

+  IN UINTN  Length

+  );

+

+/**

+  Compares the contents of two buffers.

+

+  This function compares Length bytes of SourceBuffer to Length bytes of DestinationBuffer.

+  If all Length bytes of the two buffers are identical, then 0 is returned.  Otherwise, the

+  value returned is the first mismatched byte in SourceBuffer subtracted from the first

+  mismatched byte in DestinationBuffer.

+

+  If Length > 0 and DestinationBuffer is NULL, then ASSERT().

+  If Length > 0 and SourceBuffer is NULL, then ASSERT().

+  If Length is greater than (MAX_ADDRESS - DestinationBuffer + 1), then ASSERT().

+  If Length is greater than (MAX_ADDRESS - SourceBuffer + 1), then ASSERT().

+

+  @param  DestinationBuffer The pointer to the destination buffer to compare.

+  @param  SourceBuffer      The pointer to the source buffer to compare.

+  @param  Length            The number of bytes to compare.

+

+  @return 0                 All Length bytes of the two buffers are identical.

+  @retval Non-zero          The first mismatched byte in SourceBuffer subtracted from the first

+                            mismatched byte in DestinationBuffer.

+

+**/

+INTN

+EFIAPI

+CompareMem (

+  IN CONST VOID  *DestinationBuffer,

+  IN CONST VOID  *SourceBuffer,

+  IN UINTN       Length

+  );

+

+/**

+  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 target the 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, otherwise NULL.

+

+**/

+VOID *

+EFIAPI

+ScanMem8 (

+  IN CONST VOID  *Buffer,

+  IN UINTN       Length,

+  IN UINT8       Value

+  );

+

+/**

+  Scans a target buffer for a 16-bit value, and returns a pointer to the matching 16-bit value

+  in the target buffer.

+

+  This function searches target the buffer specified by Buffer and Length from the lowest

+  address to the highest address for a 16-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 Buffer is not aligned on a 16-bit boundary, then ASSERT().

+  If Length is not aligned on a 16-bit 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, otherwise NULL.

+

+**/

+VOID *

+EFIAPI

+ScanMem16 (

+  IN CONST VOID  *Buffer,

+  IN UINTN       Length,

+  IN UINT16      Value

+  );

+

+/**

+  Scans a target buffer for a 32-bit value, and returns a pointer to the matching 32-bit value

+  in the target buffer.

+

+  This function searches target the buffer specified by Buffer and Length from the lowest

+  address to the highest address for a 32-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 Buffer is not aligned on a 32-bit boundary, then ASSERT().

+  If Length is not aligned on a 32-bit 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, otherwise NULL.

+

+**/

+VOID *

+EFIAPI

+ScanMem32 (

+  IN CONST VOID  *Buffer,

+  IN UINTN       Length,

+  IN UINT32      Value

+  );

+

+/**

+  Scans a target buffer for a 64-bit value, and returns a pointer to the matching 64-bit value

+  in the target buffer.

+

+  This function searches target the buffer specified by Buffer and Length from the lowest

+  address to the highest address for a 64-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 Buffer is not aligned on a 64-bit boundary, then ASSERT().

+  If Length is not aligned on a 64-bit 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, otherwise NULL.

+

+**/

+VOID *

+EFIAPI

+ScanMem64 (

+  IN CONST VOID  *Buffer,

+  IN UINTN       Length,

+  IN UINT64      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 target the 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, otherwise NULL.

+

+**/

+VOID *

+EFIAPI

+ScanMemN (

+  IN CONST VOID  *Buffer,

+  IN UINTN       Length,

+  IN UINTN       Value

+  );

+

+/**

+  Copies a source GUID to a destination GUID.

+

+  This function copies the contents of the 128-bit GUID specified by SourceGuid to

+  DestinationGuid, and returns DestinationGuid.

+

+  If DestinationGuid is NULL, then ASSERT().

+  If SourceGuid is NULL, then ASSERT().

+

+  @param  DestinationGuid   The pointer to the destination GUID.

+  @param  SourceGuid        The pointer to the source GUID.

+

+  @return DestinationGuid.

+

+**/

+GUID *

+EFIAPI

+CopyGuid (

+  OUT GUID       *DestinationGuid,

+  IN CONST GUID  *SourceGuid

+  );

+

+/**

+  Compares two GUIDs.

+

+  This function compares Guid1 to Guid2.  If the GUIDs are identical then TRUE is returned.

+  If there are any bit differences in the two GUIDs, then FALSE is returned.

+

+  If Guid1 is NULL, then ASSERT().

+  If Guid2 is NULL, then ASSERT().

+

+  @param  Guid1       A pointer to a 128 bit GUID.

+  @param  Guid2       A pointer to a 128 bit GUID.

+

+  @retval TRUE        Guid1 and Guid2 are identical.

+  @retval FALSE       Guid1 and Guid2 are not identical.

+

+**/

+BOOLEAN

+EFIAPI

+CompareGuid (

+  IN CONST GUID  *Guid1,

+  IN CONST GUID  *Guid2

+  );

+

+/**

+  Scans a target buffer for a GUID, and returns a pointer to the matching GUID

+  in the target buffer.

+

+  This function searches target the buffer specified by Buffer and Length from

+  the lowest address to the highest address at 128-bit increments for the 128-bit

+  GUID value that matches Guid.  If a match is found, then a pointer to the matching

+  GUID 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 32-bit boundary, then ASSERT().

+  If Length is not aligned on a 128-bit 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  Guid    The value to search for in the target buffer.

+

+  @return A pointer to the matching Guid in the target buffer, otherwise NULL.

+

+**/

+VOID *

+EFIAPI

+ScanGuid (

+  IN CONST VOID  *Buffer,

+  IN UINTN       Length,

+  IN CONST GUID  *Guid

+  );

+

+/**

+  Checks if the given GUID is a zero GUID.

+

+  This function checks whether the given GUID is a zero GUID. If the GUID is

+  identical to a zero GUID then TRUE is returned. Otherwise, FALSE is returned.

+

+  If Guid is NULL, then ASSERT().

+

+  @param  Guid        The pointer to a 128 bit GUID.

+

+  @retval TRUE        Guid is a zero GUID.

+  @retval FALSE       Guid is not a zero GUID.

+

+**/

+BOOLEAN

+EFIAPI

+IsZeroGuid (

+  IN CONST GUID  *Guid

+  );

+

+/**

+  Checks if the contents of a buffer are all zeros.

+

+  This function checks whether the contents of a buffer are all zeros. If the

+  contents are all zeros, return TRUE. Otherwise, return FALSE.

+

+  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 buffer to be checked.

+  @param  Length      The size of the buffer (in bytes) to be checked.

+

+  @retval TRUE        Contents of the buffer are all zeros.

+  @retval FALSE       Contents of the buffer are not all zeros.

+

+**/

+BOOLEAN

+EFIAPI

+IsZeroBuffer (

+  IN CONST VOID  *Buffer,

+  IN UINTN       Length

+  );

+

+#endif

diff --git a/debugging_demo/memtest86+/efi/Include/Library/DebugLib.h b/debugging_demo/memtest86+/efi/Include/Library/DebugLib.h
new file mode 100644
index 0000000..baab34b
--- /dev/null
+++ b/debugging_demo/memtest86+/efi/Include/Library/DebugLib.h
@@ -0,0 +1,577 @@
+/** @file

+  Provides services to print debug and assert messages to a debug output device.

+

+  The Debug library supports debug print and asserts based on a combination of macros and code.

+  The debug library can be turned on and off so that the debug code does not increase the size of an image.

+

+  Note that a reserved macro named MDEPKG_NDEBUG is introduced for the intention

+  of size reduction when compiler optimization is disabled. If MDEPKG_NDEBUG is

+  defined, then debug and assert related macros wrapped by it are the NULL implementations.

+

+Copyright (c) 2006 - 2020, Intel Corporation. All rights reserved.<BR>

+SPDX-License-Identifier: BSD-2-Clause-Patent

+

+**/

+

+#ifndef __DEBUG_LIB_H__

+#define __DEBUG_LIB_H__

+

+//

+// Declare bits for PcdDebugPropertyMask

+//

+#define DEBUG_PROPERTY_DEBUG_ASSERT_ENABLED       0x01

+#define DEBUG_PROPERTY_DEBUG_PRINT_ENABLED        0x02

+#define DEBUG_PROPERTY_DEBUG_CODE_ENABLED         0x04

+#define DEBUG_PROPERTY_CLEAR_MEMORY_ENABLED       0x08

+#define DEBUG_PROPERTY_ASSERT_BREAKPOINT_ENABLED  0x10

+#define DEBUG_PROPERTY_ASSERT_DEADLOOP_ENABLED    0x20

+

+//

+// Declare bits for PcdDebugPrintErrorLevel and the ErrorLevel parameter of DebugPrint()

+//

+#define DEBUG_INIT      0x00000001  // Initialization

+#define DEBUG_WARN      0x00000002  // Warnings

+#define DEBUG_LOAD      0x00000004  // Load events

+#define DEBUG_FS        0x00000008  // EFI File system

+#define DEBUG_POOL      0x00000010  // Alloc & Free (pool)

+#define DEBUG_PAGE      0x00000020  // Alloc & Free (page)

+#define DEBUG_INFO      0x00000040  // Informational debug messages

+#define DEBUG_DISPATCH  0x00000080  // PEI/DXE/SMM Dispatchers

+#define DEBUG_VARIABLE  0x00000100  // Variable

+#define DEBUG_BM        0x00000400  // Boot Manager

+#define DEBUG_BLKIO     0x00001000  // BlkIo Driver

+#define DEBUG_NET       0x00004000  // Network Io Driver

+#define DEBUG_UNDI      0x00010000  // UNDI Driver

+#define DEBUG_LOADFILE  0x00020000  // LoadFile

+#define DEBUG_EVENT     0x00080000  // Event messages

+#define DEBUG_GCD       0x00100000  // Global Coherency Database changes

+#define DEBUG_CACHE     0x00200000  // Memory range cachability changes

+#define DEBUG_VERBOSE   0x00400000  // Detailed debug messages that may

+                                    // significantly impact boot performance

+#define DEBUG_ERROR     0x80000000  // Error

+

+//

+// Aliases of debug message mask bits

+//

+#define EFI_D_INIT      DEBUG_INIT

+#define EFI_D_WARN      DEBUG_WARN

+#define EFI_D_LOAD      DEBUG_LOAD

+#define EFI_D_FS        DEBUG_FS

+#define EFI_D_POOL      DEBUG_POOL

+#define EFI_D_PAGE      DEBUG_PAGE

+#define EFI_D_INFO      DEBUG_INFO

+#define EFI_D_DISPATCH  DEBUG_DISPATCH

+#define EFI_D_VARIABLE  DEBUG_VARIABLE

+#define EFI_D_BM        DEBUG_BM

+#define EFI_D_BLKIO     DEBUG_BLKIO

+#define EFI_D_NET       DEBUG_NET

+#define EFI_D_UNDI      DEBUG_UNDI

+#define EFI_D_LOADFILE  DEBUG_LOADFILE

+#define EFI_D_EVENT     DEBUG_EVENT

+#define EFI_D_VERBOSE   DEBUG_VERBOSE

+#define EFI_D_ERROR     DEBUG_ERROR

+

+/**

+  Prints a debug message to the debug output device if the specified error level is enabled.

+

+  If any bit in ErrorLevel is also set in DebugPrintErrorLevelLib function

+  GetDebugPrintErrorLevel (), then print the message specified by Format and the

+  associated variable argument list to the debug output device.

+

+  If Format is NULL, then ASSERT().

+

+  @param  ErrorLevel  The error level of the debug message.

+  @param  Format      The format string for the debug message to print.

+  @param  ...         The variable argument list whose contents are accessed

+                      based on the format string specified by Format.

+

+**/

+VOID

+EFIAPI

+DebugPrint (

+  IN  UINTN        ErrorLevel,

+  IN  CONST CHAR8  *Format,

+  ...

+  );

+

+

+/**

+  Prints a debug message to the debug output device if the specified

+  error level is enabled.

+

+  If any bit in ErrorLevel is also set in DebugPrintErrorLevelLib function

+  GetDebugPrintErrorLevel (), then print the message specified by Format and

+  the associated variable argument list to the debug output device.

+

+  If Format is NULL, then ASSERT().

+

+  @param  ErrorLevel    The error level of the debug message.

+  @param  Format        Format string for the debug message to print.

+  @param  VaListMarker  VA_LIST marker for the variable argument list.

+

+**/

+VOID

+EFIAPI

+DebugVPrint (

+  IN  UINTN         ErrorLevel,

+  IN  CONST CHAR8   *Format,

+  IN  VA_LIST       VaListMarker

+  );

+

+

+/**

+  Prints a debug message to the debug output device if the specified

+  error level is enabled.

+  This function use BASE_LIST which would provide a more compatible

+  service than VA_LIST.

+

+  If any bit in ErrorLevel is also set in DebugPrintErrorLevelLib function

+  GetDebugPrintErrorLevel (), then print the message specified by Format and

+  the associated variable argument list to the debug output device.

+

+  If Format is NULL, then ASSERT().

+

+  @param  ErrorLevel      The error level of the debug message.

+  @param  Format          Format string for the debug message to print.

+  @param  BaseListMarker  BASE_LIST marker for the variable argument list.

+

+**/

+VOID

+EFIAPI

+DebugBPrint (

+  IN  UINTN         ErrorLevel,

+  IN  CONST CHAR8   *Format,

+  IN  BASE_LIST     BaseListMarker

+  );

+

+

+/**

+  Prints an assert message containing a filename, line number, and description.

+  This may be followed by a breakpoint or a dead loop.

+

+  Print a message of the form "ASSERT <FileName>(<LineNumber>): <Description>\n"

+  to the debug output device.  If DEBUG_PROPERTY_ASSERT_BREAKPOINT_ENABLED bit of

+  PcdDebugProperyMask is set then CpuBreakpoint() is called. Otherwise, if

+  DEBUG_PROPERTY_ASSERT_DEADLOOP_ENABLED bit of PcdDebugProperyMask is set then

+  CpuDeadLoop() is called.  If neither of these bits are set, then this function

+  returns immediately after the message is printed to the debug output device.

+  DebugAssert() must actively prevent recursion.  If DebugAssert() is called while

+  processing another DebugAssert(), then DebugAssert() must return immediately.

+

+  If FileName is NULL, then a <FileName> string of "(NULL) Filename" is printed.

+  If Description is NULL, then a <Description> string of "(NULL) Description" is printed.

+

+  @param  FileName     The pointer to the name of the source file that generated the assert condition.

+  @param  LineNumber   The line number in the source file that generated the assert condition

+  @param  Description  The pointer to the description of the assert condition.

+

+**/

+VOID

+EFIAPI

+DebugAssert (

+  IN CONST CHAR8  *FileName,

+  IN UINTN        LineNumber,

+  IN CONST CHAR8  *Description

+  );

+

+

+/**

+  Fills a target buffer with PcdDebugClearMemoryValue, and returns the target buffer.

+

+  This function fills Length bytes of Buffer with the value specified by

+  PcdDebugClearMemoryValue, and returns Buffer.

+

+  If 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 be filled with PcdDebugClearMemoryValue.

+  @param   Length  The number of bytes in Buffer to fill with zeros PcdDebugClearMemoryValue.

+

+  @return  Buffer  The pointer to the target buffer filled with PcdDebugClearMemoryValue.

+

+**/

+VOID *

+EFIAPI

+DebugClearMemory (

+  OUT VOID  *Buffer,

+  IN UINTN  Length

+  );

+

+

+/**

+  Returns TRUE if ASSERT() macros are enabled.

+

+  This function returns TRUE if the DEBUG_PROPERTY_DEBUG_ASSERT_ENABLED bit of

+  PcdDebugProperyMask is set.  Otherwise, FALSE is returned.

+

+  @retval  TRUE    The DEBUG_PROPERTY_DEBUG_ASSERT_ENABLED bit of PcdDebugProperyMask is set.

+  @retval  FALSE   The DEBUG_PROPERTY_DEBUG_ASSERT_ENABLED bit of PcdDebugProperyMask is clear.

+

+**/

+BOOLEAN

+EFIAPI

+DebugAssertEnabled (

+  VOID

+  );

+

+

+/**

+  Returns TRUE if DEBUG() macros are enabled.

+

+  This function returns TRUE if the DEBUG_PROPERTY_DEBUG_PRINT_ENABLED bit of

+  PcdDebugProperyMask is set.  Otherwise, FALSE is returned.

+

+  @retval  TRUE    The DEBUG_PROPERTY_DEBUG_PRINT_ENABLED bit of PcdDebugProperyMask is set.

+  @retval  FALSE   The DEBUG_PROPERTY_DEBUG_PRINT_ENABLED bit of PcdDebugProperyMask is clear.

+

+**/

+BOOLEAN

+EFIAPI

+DebugPrintEnabled (

+  VOID

+  );

+

+

+/**

+  Returns TRUE if DEBUG_CODE() macros are enabled.

+

+  This function returns TRUE if the DEBUG_PROPERTY_DEBUG_CODE_ENABLED bit of

+  PcdDebugProperyMask is set.  Otherwise, FALSE is returned.

+

+  @retval  TRUE    The DEBUG_PROPERTY_DEBUG_CODE_ENABLED bit of PcdDebugProperyMask is set.

+  @retval  FALSE   The DEBUG_PROPERTY_DEBUG_CODE_ENABLED bit of PcdDebugProperyMask is clear.

+

+**/

+BOOLEAN

+EFIAPI

+DebugCodeEnabled (

+  VOID

+  );

+

+

+/**

+  Returns TRUE if DEBUG_CLEAR_MEMORY() macro is enabled.

+

+  This function returns TRUE if the DEBUG_PROPERTY_CLEAR_MEMORY_ENABLED bit of

+  PcdDebugProperyMask is set.  Otherwise, FALSE is returned.

+

+  @retval  TRUE    The DEBUG_PROPERTY_CLEAR_MEMORY_ENABLED bit of PcdDebugProperyMask is set.

+  @retval  FALSE   The DEBUG_PROPERTY_CLEAR_MEMORY_ENABLED bit of PcdDebugProperyMask is clear.

+

+**/

+BOOLEAN

+EFIAPI

+DebugClearMemoryEnabled (

+  VOID

+  );

+

+/**

+  Returns TRUE if any one of the bit is set both in ErrorLevel and PcdFixedDebugPrintErrorLevel.

+

+  This function compares the bit mask of ErrorLevel and PcdFixedDebugPrintErrorLevel.

+

+  @retval  TRUE    Current ErrorLevel is supported.

+  @retval  FALSE   Current ErrorLevel is not supported.

+

+**/

+BOOLEAN

+EFIAPI

+DebugPrintLevelEnabled (

+  IN  CONST UINTN        ErrorLevel

+  );

+

+/**

+  Internal worker macro that calls DebugAssert().

+

+  This macro calls DebugAssert(), passing in the filename, line number, and an

+  expression that evaluated to FALSE.

+

+  @param  Expression  Boolean expression that evaluated to FALSE

+

+**/

+#if defined(__clang__) && defined(__FILE_NAME__)

+#define _ASSERT(Expression)  DebugAssert (__FILE_NAME__, __LINE__, #Expression)

+#else

+#define _ASSERT(Expression)  DebugAssert (__FILE__, __LINE__, #Expression)

+#endif

+

+

+/**

+  Internal worker macro that calls DebugPrint().

+

+  This macro calls DebugPrint() passing in the debug error level, a format

+  string, and a variable argument list.

+  __VA_ARGS__ is not supported by EBC compiler, Microsoft Visual Studio .NET 2003

+  and Microsoft Windows Server 2003 Driver Development Kit (Microsoft WINDDK) version 3790.1830.

+

+  @param  Expression  Expression containing an error level, a format string,

+                      and a variable argument list based on the format string.

+

+**/

+

+#if !defined(MDE_CPU_EBC) && (!defined (_MSC_VER) || _MSC_VER > 1400)

+  #define _DEBUG_PRINT(PrintLevel, ...)              \

+    do {                                             \

+      if (DebugPrintLevelEnabled (PrintLevel)) {     \

+        DebugPrint (PrintLevel, ##__VA_ARGS__);      \

+      }                                              \

+    } while (FALSE)

+  #define _DEBUG(Expression)   _DEBUG_PRINT Expression

+#else

+#define _DEBUG(Expression)   DebugPrint Expression

+#endif

+

+/**

+  Macro that calls DebugAssert() if an expression evaluates to FALSE.

+

+  If MDEPKG_NDEBUG is not defined and the DEBUG_PROPERTY_DEBUG_ASSERT_ENABLED

+  bit of PcdDebugProperyMask is set, then this macro evaluates the Boolean

+  expression specified by Expression.  If Expression evaluates to FALSE, then

+  DebugAssert() is called passing in the source filename, source line number,

+  and Expression.

+

+  @param  Expression  Boolean expression.

+

+**/

+#if !defined(MDEPKG_NDEBUG)

+  #define ASSERT(Expression)        \

+    do {                            \

+      if (DebugAssertEnabled ()) {  \

+        if (!(Expression)) {        \

+          _ASSERT (Expression);     \

+          ANALYZER_UNREACHABLE ();  \

+        }                           \

+      }                             \

+    } while (FALSE)

+#else

+  #define ASSERT(Expression)

+#endif

+

+/**

+  Macro that calls DebugPrint().

+

+  If MDEPKG_NDEBUG is not defined and the DEBUG_PROPERTY_DEBUG_PRINT_ENABLED

+  bit of PcdDebugProperyMask is set, then this macro passes Expression to

+  DebugPrint().

+

+  @param  Expression  Expression containing an error level, a format string,

+                      and a variable argument list based on the format string.

+

+

+**/

+#if !defined(MDEPKG_NDEBUG)

+  #define DEBUG(Expression)        \

+    do {                           \

+      if (DebugPrintEnabled ()) {  \

+        _DEBUG (Expression);       \

+      }                            \

+    } while (FALSE)

+#else

+  #define DEBUG(Expression)

+#endif

+

+/**

+  Macro that calls DebugAssert() if an EFI_STATUS evaluates to an error code.

+

+  If MDEPKG_NDEBUG is not defined and the DEBUG_PROPERTY_DEBUG_ASSERT_ENABLED

+  bit of PcdDebugProperyMask is set, then this macro evaluates the EFI_STATUS

+  value specified by StatusParameter.  If StatusParameter is an error code,

+  then DebugAssert() is called passing in the source filename, source line

+  number, and StatusParameter.

+

+  @param  StatusParameter  EFI_STATUS value to evaluate.

+

+**/

+#if !defined(MDEPKG_NDEBUG)

+  #define ASSERT_EFI_ERROR(StatusParameter)                                              \

+    do {                                                                                 \

+      if (DebugAssertEnabled ()) {                                                       \

+        if (EFI_ERROR (StatusParameter)) {                                               \

+          DEBUG ((EFI_D_ERROR, "\nASSERT_EFI_ERROR (Status = %r)\n", StatusParameter));  \

+          _ASSERT (!EFI_ERROR (StatusParameter));                                        \

+        }                                                                                \

+      }                                                                                  \

+    } while (FALSE)

+#else

+  #define ASSERT_EFI_ERROR(StatusParameter)

+#endif

+

+/**

+  Macro that calls DebugAssert() if a RETURN_STATUS evaluates to an error code.

+

+  If MDEPKG_NDEBUG is not defined and the DEBUG_PROPERTY_DEBUG_ASSERT_ENABLED

+  bit of PcdDebugProperyMask is set, then this macro evaluates the

+  RETURN_STATUS value specified by StatusParameter.  If StatusParameter is an

+  error code, then DebugAssert() is called passing in the source filename,

+  source line number, and StatusParameter.

+

+  @param  StatusParameter  RETURN_STATUS value to evaluate.

+

+**/

+#if !defined(MDEPKG_NDEBUG)

+  #define ASSERT_RETURN_ERROR(StatusParameter)                          \

+    do {                                                                \

+      if (DebugAssertEnabled ()) {                                      \

+        if (RETURN_ERROR (StatusParameter)) {                           \

+          DEBUG ((DEBUG_ERROR, "\nASSERT_RETURN_ERROR (Status = %r)\n", \

+            StatusParameter));                                          \

+          _ASSERT (!RETURN_ERROR (StatusParameter));                    \

+        }                                                               \

+      }                                                                 \

+    } while (FALSE)

+#else

+  #define ASSERT_RETURN_ERROR(StatusParameter)

+#endif

+

+/**

+  Macro that calls DebugAssert() if a protocol is already installed in the

+  handle database.

+

+  If MDEPKG_NDEBUG is defined or the DEBUG_PROPERTY_DEBUG_ASSERT_ENABLED bit

+  of PcdDebugProperyMask is clear, then return.

+

+  If Handle is NULL, then a check is made to see if the protocol specified by Guid

+  is present on any handle in the handle database.  If Handle is not NULL, then

+  a check is made to see if the protocol specified by Guid is present on the

+  handle specified by Handle.  If the check finds the protocol, then DebugAssert()

+  is called passing in the source filename, source line number, and Guid.

+

+  If Guid is NULL, then ASSERT().

+

+  @param  Handle  The handle to check for the protocol.  This is an optional

+                  parameter that may be NULL.  If it is NULL, then the entire

+                  handle database is searched.

+

+  @param  Guid    The pointer to a protocol GUID.

+

+**/

+#if !defined(MDEPKG_NDEBUG)

+  #define ASSERT_PROTOCOL_ALREADY_INSTALLED(Handle, Guid)                               \

+    do {                                                                                \

+      if (DebugAssertEnabled ()) {                                                      \

+        VOID  *Instance;                                                                \

+        ASSERT (Guid != NULL);                                                          \

+        if (Handle == NULL) {                                                           \

+          if (!EFI_ERROR (gBS->LocateProtocol ((EFI_GUID *)Guid, NULL, &Instance))) {   \

+            _ASSERT (Guid already installed in database);                               \

+          }                                                                             \

+        } else {                                                                        \

+          if (!EFI_ERROR (gBS->HandleProtocol (Handle, (EFI_GUID *)Guid, &Instance))) { \

+            _ASSERT (Guid already installed on Handle);                                 \

+          }                                                                             \

+        }                                                                               \

+      }                                                                                 \

+    } while (FALSE)

+#else

+  #define ASSERT_PROTOCOL_ALREADY_INSTALLED(Handle, Guid)

+#endif

+

+/**

+  Macro that marks the beginning of debug source code.

+

+  If the DEBUG_PROPERTY_DEBUG_CODE_ENABLED bit of PcdDebugProperyMask is set,

+  then this macro marks the beginning of source code that is included in a module.

+  Otherwise, the source lines between DEBUG_CODE_BEGIN() and DEBUG_CODE_END()

+  are not included in a module.

+

+**/

+#define DEBUG_CODE_BEGIN()  do { if (DebugCodeEnabled ()) { UINT8  __DebugCodeLocal

+

+

+/**

+  The macro that marks the end of debug source code.

+

+  If the DEBUG_PROPERTY_DEBUG_CODE_ENABLED bit of PcdDebugProperyMask is set,

+  then this macro marks the end of source code that is included in a module.

+  Otherwise, the source lines between DEBUG_CODE_BEGIN() and DEBUG_CODE_END()

+  are not included in a module.

+

+**/

+#define DEBUG_CODE_END()    __DebugCodeLocal = 0; __DebugCodeLocal++; } } while (FALSE)

+

+

+/**

+  The macro that declares a section of debug source code.

+

+  If the DEBUG_PROPERTY_DEBUG_CODE_ENABLED bit of PcdDebugProperyMask is set,

+  then the source code specified by Expression is included in a module.

+  Otherwise, the source specified by Expression is not included in a module.

+

+**/

+#define DEBUG_CODE(Expression)  \

+  DEBUG_CODE_BEGIN ();          \

+  Expression                    \

+  DEBUG_CODE_END ()

+

+

+/**

+  The macro that calls DebugClearMemory() to clear a buffer to a default value.

+

+  If the DEBUG_PROPERTY_CLEAR_MEMORY_ENABLED bit of PcdDebugProperyMask is set,

+  then this macro calls DebugClearMemory() passing in Address and Length.

+

+  @param  Address  The pointer to a buffer.

+  @param  Length   The number of bytes in the buffer to set.

+

+**/

+#define DEBUG_CLEAR_MEMORY(Address, Length)  \

+  do {                                       \

+    if (DebugClearMemoryEnabled ()) {        \

+      DebugClearMemory (Address, Length);    \

+    }                                        \

+  } while (FALSE)

+

+

+/**

+  Macro that calls DebugAssert() if the containing record does not have a

+  matching signature.  If the signatures matches, then a pointer to the data

+  structure that contains a specified field of that data structure is returned.

+  This is a lightweight method hide information by placing a public data

+  structure inside a larger private data structure and using a pointer to the

+  public data structure to retrieve a pointer to the private data structure.

+

+  If MDEPKG_NDEBUG is defined or the DEBUG_PROPERTY_DEBUG_ASSERT_ENABLED bit

+  of PcdDebugProperyMask is clear, then this macro computes the offset, in bytes,

+  of the field specified by Field from the beginning of the data structure specified

+  by TYPE.  This offset is subtracted from Record, and is used to return a pointer

+  to a data structure of the type specified by TYPE.

+

+  If MDEPKG_NDEBUG is not defined and the DEBUG_PROPERTY_DEBUG_ASSERT_ENABLED bit

+  of PcdDebugProperyMask is set, then this macro computes the offset, in bytes,

+  of field specified by Field from the beginning of the data structure specified

+  by TYPE.  This offset is subtracted from Record, and is used to compute a pointer

+  to a data structure of the type specified by TYPE.  The Signature field of the

+  data structure specified by TYPE is compared to TestSignature.  If the signatures

+  match, then a pointer to the pointer to a data structure of the type specified by

+  TYPE is returned.  If the signatures do not match, then DebugAssert() is called

+  with a description of "CR has a bad signature" and Record is returned.

+

+  If the data type specified by TYPE does not contain the field specified by Field,

+  then the module will not compile.

+

+  If TYPE does not contain a field called Signature, then the module will not

+  compile.

+

+  @param  Record         The pointer to the field specified by Field within a data

+                         structure of type TYPE.

+

+  @param  TYPE           The name of the data structure type to return  This

+                         data structure must contain the field specified by Field.

+

+  @param  Field          The name of the field in the data structure specified

+                         by TYPE to which Record points.

+

+  @param  TestSignature  The 32-bit signature value to match.

+

+**/

+#if !defined(MDEPKG_NDEBUG)

+  #define CR(Record, TYPE, Field, TestSignature)                                              \

+    (DebugAssertEnabled () && (BASE_CR (Record, TYPE, Field)->Signature != TestSignature)) ?  \

+    (TYPE *) (_ASSERT (CR has Bad Signature), Record) :                                       \

+    BASE_CR (Record, TYPE, Field)

+#else

+  #define CR(Record, TYPE, Field, TestSignature)                                              \

+    BASE_CR (Record, TYPE, Field)

+#endif

+

+#endif

diff --git a/debugging_demo/memtest86+/efi/Include/Library/DebugPrintErrorLevelLib.h b/debugging_demo/memtest86+/efi/Include/Library/DebugPrintErrorLevelLib.h
new file mode 100644
index 0000000..6992ec8
--- /dev/null
+++ b/debugging_demo/memtest86+/efi/Include/Library/DebugPrintErrorLevelLib.h
@@ -0,0 +1,37 @@
+/** @file

+  Debug Print Error Level Library class

+

+  Copyright (c) 2011 - 2018, Intel Corporation. All rights reserved.<BR>

+  SPDX-License-Identifier: BSD-2-Clause-Patent

+

+**/

+#ifndef _DEBUG_PRINT_ERROR_LEVEL_LIB_H_

+#define _DEBUG_PRINT_ERROR_LEVEL_LIB_H_

+

+/**

+  Returns the debug print error level mask for the current module.

+

+  @return  Debug print error level mask for the current module.

+

+**/

+UINT32

+EFIAPI

+GetDebugPrintErrorLevel (

+  VOID

+  );

+

+/**

+  Sets the global debug print error level mask fpr the entire platform.

+

+  @param   ErrorLevel     Global debug print error level

+

+  @retval  TRUE           The debug print error level mask was successfully set.

+  @retval  FALSE          The debug print error level mask could not be set.

+

+**/

+BOOLEAN

+EFIAPI

+SetDebugPrintErrorLevel (

+  UINT32  ErrorLevel

+  );

+#endif

diff --git a/debugging_demo/memtest86+/efi/Include/Library/DevicePathLib.h b/debugging_demo/memtest86+/efi/Include/Library/DevicePathLib.h
new file mode 100644
index 0000000..26361fe
--- /dev/null
+++ b/debugging_demo/memtest86+/efi/Include/Library/DevicePathLib.h
@@ -0,0 +1,561 @@
+/** @file

+  Provides library functions to construct and parse UEFI Device Paths.

+

+  This library provides defines, macros, and functions to help create and parse

+  EFI_DEVICE_PATH_PROTOCOL structures.

+

+Copyright (c) 2006 - 2018, Intel Corporation. All rights reserved.<BR>

+SPDX-License-Identifier: BSD-2-Clause-Patent

+

+**/

+

+#ifndef __DEVICE_PATH_LIB_H__

+#define __DEVICE_PATH_LIB_H__

+

+#define END_DEVICE_PATH_LENGTH               (sizeof (EFI_DEVICE_PATH_PROTOCOL))

+

+/**

+  Determine whether a given device path is valid.

+

+  @param  DevicePath  A pointer to a device path data structure.

+  @param  MaxSize     The maximum size of the device path data structure.

+

+  @retval TRUE        DevicePath is valid.

+  @retval FALSE       DevicePath is NULL.

+  @retval FALSE       Maxsize is less than sizeof(EFI_DEVICE_PATH_PROTOCOL).

+  @retval FALSE       The length of any node node in the DevicePath is less

+                      than sizeof (EFI_DEVICE_PATH_PROTOCOL).

+  @retval FALSE       If MaxSize is not zero, the size of the DevicePath

+                      exceeds MaxSize.

+  @retval FALSE       If PcdMaximumDevicePathNodeCount is not zero, the node

+                      count of the DevicePath exceeds PcdMaximumDevicePathNodeCount.

+**/

+BOOLEAN

+EFIAPI

+IsDevicePathValid (

+  IN CONST EFI_DEVICE_PATH_PROTOCOL *DevicePath,

+  IN       UINTN                    MaxSize

+  );

+

+/**

+  Returns the Type field of a device path node.

+

+  Returns the Type field of the device path node specified by Node.

+

+  If Node is NULL, then ASSERT().

+

+  @param  Node      A pointer to a device path node data structure.

+

+  @return The Type field of the device path node specified by Node.

+

+**/

+UINT8

+EFIAPI

+DevicePathType (

+  IN CONST VOID  *Node

+  );

+

+/**

+  Returns the SubType field of a device path node.

+

+  Returns the SubType field of the device path node specified by Node.

+

+  If Node is NULL, then ASSERT().

+

+  @param  Node      A pointer to a device path node data structure.

+

+  @return The SubType field of the device path node specified by Node.

+

+**/

+UINT8

+EFIAPI

+DevicePathSubType (

+  IN CONST VOID  *Node

+  );

+

+/**

+  Returns the 16-bit Length field of a device path node.

+

+  Returns the 16-bit Length field of the device path node specified by Node.

+  Node is not required to be aligned on a 16-bit boundary, so it is recommended

+  that a function such as ReadUnaligned16() be used to extract the contents of

+  the Length field.

+

+  If Node is NULL, then ASSERT().

+

+  @param  Node      A pointer to a device path node data structure.

+

+  @return The 16-bit Length field of the device path node specified by Node.

+

+**/

+UINTN

+EFIAPI

+DevicePathNodeLength (

+  IN CONST VOID  *Node

+  );

+

+/**

+  Returns a pointer to the next node in a device path.

+

+  Returns a pointer to the device path node that follows the device path node specified by Node.

+

+  If Node is NULL, then ASSERT().

+

+  @param  Node      A pointer to a device path node data structure.

+

+  @return a pointer to the device path node that follows the device path node specified by Node.

+

+**/

+EFI_DEVICE_PATH_PROTOCOL *

+EFIAPI

+NextDevicePathNode (

+  IN CONST VOID  *Node

+  );

+

+/**

+  Determines if a device path node is an end node of a device path.

+  This includes nodes that are the end of a device path instance and nodes that

+  are the end of an entire device path.

+

+  Determines if the device path node specified by Node is an end node of a device path.

+  This includes nodes that are the end of a device path instance and nodes that are the

+  end of an entire device path.  If Node represents an end node of a device path,

+  then TRUE is returned.  Otherwise, FALSE is returned.

+

+  If Node is NULL, then ASSERT().

+

+  @param  Node      A pointer to a device path node data structure.

+

+  @retval TRUE      The device path node specified by Node is an end node of a device path.

+  @retval FALSE     The device path node specified by Node is not an end node of a device path.

+

+**/

+BOOLEAN

+EFIAPI

+IsDevicePathEndType (

+  IN CONST VOID  *Node

+  );

+

+/**

+  Determines if a device path node is an end node of an entire device path.

+

+  Determines if a device path node specified by Node is an end node of an entire device path.

+  If Node represents the end of an entire device path, then TRUE is returned.

+  Otherwise, FALSE is returned.

+

+  If Node is NULL, then ASSERT().

+

+  @param  Node      A pointer to a device path node data structure.

+

+  @retval TRUE      The device path node specified by Node is the end of an entire device path.

+  @retval FALSE     The device path node specified by Node is not the end of an entire device path.

+

+**/

+BOOLEAN

+EFIAPI

+IsDevicePathEnd (

+  IN CONST VOID  *Node

+  );

+

+/**

+  Determines if a device path node is an end node of a device path instance.

+

+  Determines if a device path node specified by Node is an end node of a device path instance.

+  If Node represents the end of a device path instance, then TRUE is returned.

+  Otherwise, FALSE is returned.

+

+  If Node is NULL, then ASSERT().

+

+  @param  Node      A pointer to a device path node data structure.

+

+  @retval TRUE      The device path node specified by Node is the end of a device path instance.

+  @retval FALSE     The device path node specified by Node is not the end of a device path instance.

+

+**/

+BOOLEAN

+EFIAPI

+IsDevicePathEndInstance (

+  IN CONST VOID  *Node

+  );

+

+/**

+  Sets the length, in bytes, of a device path node.

+

+  Sets the length of the device path node specified by Node to the value specified

+  by NodeLength.  NodeLength is returned.  Node is not required to be aligned on

+  a 16-bit boundary, so it is recommended that a function such as WriteUnaligned16()

+  be used to set the contents of the Length field.

+

+  If Node is NULL, then ASSERT().

+  If NodeLength >= 0x10000, then ASSERT().

+  If NodeLength < sizeof (EFI_DEVICE_PATH_PROTOCOL), then ASSERT().

+

+  @param  Node      A pointer to a device path node data structure.

+  @param  Length    The length, in bytes, of the device path node.

+

+  @return Length

+

+**/

+UINT16

+EFIAPI

+SetDevicePathNodeLength (

+  IN OUT VOID  *Node,

+  IN UINTN     Length

+  );

+

+/**

+  Fills in all the fields of a device path node that is the end of an entire device path.

+

+  Fills in all the fields of a device path node specified by Node so Node represents

+  the end of an entire device path.  The Type field of Node is set to

+  END_DEVICE_PATH_TYPE, the SubType field of Node is set to

+  END_ENTIRE_DEVICE_PATH_SUBTYPE, and the Length field of Node is set to

+  END_DEVICE_PATH_LENGTH.  Node is not required to be aligned on a 16-bit boundary,

+  so it is recommended that a function such as WriteUnaligned16() be used to set

+  the contents of the Length field.

+

+  If Node is NULL, then ASSERT().

+

+  @param  Node      A pointer to a device path node data structure.

+

+**/

+VOID

+EFIAPI

+SetDevicePathEndNode (

+  OUT VOID  *Node

+  );

+

+/**

+  Returns the size of a device path in bytes.

+

+  This function returns the size, in bytes, of the device path data structure

+  specified by DevicePath including the end of device path node.

+  If DevicePath is NULL or invalid, then 0 is returned.

+

+  @param  DevicePath  A pointer to a device path data structure.

+

+  @retval 0           If DevicePath is NULL or invalid.

+  @retval Others      The size of a device path in bytes.

+

+**/

+UINTN

+EFIAPI

+GetDevicePathSize (

+  IN CONST EFI_DEVICE_PATH_PROTOCOL  *DevicePath

+  );

+

+/**

+  Creates a new copy of an existing device path.

+

+  This function allocates space for a new copy of the device path specified by DevicePath.  If

+  DevicePath is NULL, then NULL is returned.  If the memory is successfully allocated, then the

+  contents of DevicePath are copied to the newly allocated buffer, and a pointer to that buffer

+  is returned.  Otherwise, NULL is returned.

+  The memory for the new device path is allocated from EFI boot services memory.

+  It is the responsibility of the caller to free the memory allocated.

+

+  @param  DevicePath                 A pointer to a device path data structure.

+

+  @retval NULL    DevicePath is NULL or invalid.

+  @retval Others  A pointer to the duplicated device path.

+

+**/

+EFI_DEVICE_PATH_PROTOCOL *

+EFIAPI

+DuplicateDevicePath (

+  IN CONST EFI_DEVICE_PATH_PROTOCOL  *DevicePath

+  );

+

+/**

+  Creates a new device path by appending a second device path to a first device path.

+

+  This function creates a new device path by appending a copy of SecondDevicePath to a copy of

+  FirstDevicePath in a newly allocated buffer.  Only the end-of-device-path device node from

+  SecondDevicePath is retained. The newly created device path is returned.

+  If FirstDevicePath is NULL, then it is ignored, and a duplicate of SecondDevicePath is returned.

+  If SecondDevicePath is NULL, then it is ignored, and a duplicate of FirstDevicePath is returned.

+  If both FirstDevicePath and SecondDevicePath are NULL, then a copy of an end-of-device-path is

+  returned.

+  If there is not enough memory for the newly allocated buffer, then NULL is returned.

+  The memory for the new device path is allocated from EFI boot services memory. It is the

+  responsibility of the caller to free the memory allocated.

+

+  @param  FirstDevicePath            A pointer to a device path data structure.

+  @param  SecondDevicePath           A pointer to a device path data structure.

+

+  @retval NULL      If there is not enough memory for the newly allocated buffer.

+  @retval NULL      If FirstDevicePath or SecondDevicePath is invalid.

+  @retval Others    A pointer to the new device path if success.

+                    Or a copy an end-of-device-path if both FirstDevicePath and SecondDevicePath are NULL.

+

+**/

+EFI_DEVICE_PATH_PROTOCOL *

+EFIAPI

+AppendDevicePath (

+  IN CONST EFI_DEVICE_PATH_PROTOCOL  *FirstDevicePath,  OPTIONAL

+  IN CONST EFI_DEVICE_PATH_PROTOCOL  *SecondDevicePath  OPTIONAL

+  );

+

+/**

+  Creates a new path by appending the device node to the device path.

+

+  This function creates a new device path by appending a copy of the device node specified by

+  DevicePathNode to a copy of the device path specified by DevicePath in an allocated buffer.

+  The end-of-device-path device node is moved after the end of the appended device node.

+  If DevicePathNode is NULL then a copy of DevicePath is returned.

+  If DevicePath is NULL then a copy of DevicePathNode, followed by an end-of-device path device

+  node is returned.

+  If both DevicePathNode and DevicePath are NULL then a copy of an end-of-device-path device node

+  is returned.

+  If there is not enough memory to allocate space for the new device path, then NULL is returned.

+  The memory is allocated from EFI boot services memory. It is the responsibility of the caller to

+  free the memory allocated.

+

+  @param  DevicePath                 A pointer to a device path data structure.

+  @param  DevicePathNode             A pointer to a single device path node.

+

+  @retval NULL      There is not enough memory for the new device path.

+  @retval Others    A pointer to the new device path if success.

+                    A copy of DevicePathNode followed by an end-of-device-path node

+                    if both FirstDevicePath and SecondDevicePath are NULL.

+                    A copy of an end-of-device-path node if both FirstDevicePath and SecondDevicePath are NULL.

+

+**/

+EFI_DEVICE_PATH_PROTOCOL *

+EFIAPI

+AppendDevicePathNode (

+  IN CONST EFI_DEVICE_PATH_PROTOCOL  *DevicePath,     OPTIONAL

+  IN CONST EFI_DEVICE_PATH_PROTOCOL  *DevicePathNode  OPTIONAL

+  );

+

+/**

+  Creates a new device path by appending the specified device path instance to the specified device

+  path.

+

+  This function creates a new device path by appending a copy of the device path instance specified

+  by DevicePathInstance to a copy of the device path secified by DevicePath in a allocated buffer.

+  The end-of-device-path device node is moved after the end of the appended device path instance

+  and a new end-of-device-path-instance node is inserted between.

+  If DevicePath is NULL, then a copy if DevicePathInstance is returned.

+  If DevicePathInstance is NULL, then NULL is returned.

+  If DevicePath or DevicePathInstance is invalid, then NULL is returned.

+  If there is not enough memory to allocate space for the new device path, then NULL is returned.

+  The memory is allocated from EFI boot services memory. It is the responsibility of the caller to

+  free the memory allocated.

+

+  @param  DevicePath                 A pointer to a device path data structure.

+  @param  DevicePathInstance         A pointer to a device path instance.

+

+  @return A pointer to the new device path.

+

+**/

+EFI_DEVICE_PATH_PROTOCOL *

+EFIAPI

+AppendDevicePathInstance (

+  IN CONST EFI_DEVICE_PATH_PROTOCOL  *DevicePath,        OPTIONAL

+  IN CONST EFI_DEVICE_PATH_PROTOCOL  *DevicePathInstance OPTIONAL

+  );

+

+/**

+  Creates a copy of the current device path instance and returns a pointer to the next device path

+  instance.

+

+  This function creates a copy of the current device path instance. It also updates DevicePath to

+  point to the next device path instance in the device path (or NULL if no more) and updates Size

+  to hold the size of the device path instance copy.

+  If DevicePath is NULL, then NULL is returned.

+  If DevicePath points to a invalid device path, then NULL is returned.

+  If there is not enough memory to allocate space for the new device path, then NULL is returned.

+  The memory is allocated from EFI boot services memory. It is the responsibility of the caller to

+  free the memory allocated.

+  If Size is NULL, then ASSERT().

+

+  @param  DevicePath                 On input, this holds the pointer to the current device path

+                                     instance. On output, this holds the pointer to the next device

+                                     path instance or NULL if there are no more device path

+                                     instances in the device path pointer to a device path data

+                                     structure.

+  @param  Size                       On output, this holds the size of the device path instance, in

+                                     bytes or zero, if DevicePath is NULL.

+

+  @return A pointer to the current device path instance.

+

+**/

+EFI_DEVICE_PATH_PROTOCOL *

+EFIAPI

+GetNextDevicePathInstance (

+  IN OUT EFI_DEVICE_PATH_PROTOCOL    **DevicePath,

+  OUT UINTN                          *Size

+  );

+

+/**

+  Creates a device node.

+

+  This function creates a new device node in a newly allocated buffer of size NodeLength and

+  initializes the device path node header with NodeType and NodeSubType.  The new device path node

+  is returned.

+  If NodeLength is smaller than a device path header, then NULL is returned.

+  If there is not enough memory to allocate space for the new device path, then NULL is returned.

+  The memory is allocated from EFI boot services memory. It is the responsibility of the caller to

+  free the memory allocated.

+

+  @param  NodeType                   The device node type for the new device node.

+  @param  NodeSubType                The device node sub-type for the new device node.

+  @param  NodeLength                 The length of the new device node.

+

+  @return The new device path.

+

+**/

+EFI_DEVICE_PATH_PROTOCOL *

+EFIAPI

+CreateDeviceNode (

+  IN UINT8                           NodeType,

+  IN UINT8                           NodeSubType,

+  IN UINT16                          NodeLength

+  );

+

+/**

+  Determines if a device path is single or multi-instance.

+

+  This function returns TRUE if the device path specified by DevicePath is multi-instance.

+  Otherwise, FALSE is returned.

+  If DevicePath is NULL or invalid, then FALSE is returned.

+

+  @param  DevicePath                 A pointer to a device path data structure.

+

+  @retval  TRUE                      DevicePath is multi-instance.

+  @retval  FALSE                     DevicePath is not multi-instance, or DevicePath is NULL or invalid.

+

+**/

+BOOLEAN

+EFIAPI

+IsDevicePathMultiInstance (

+  IN CONST EFI_DEVICE_PATH_PROTOCOL  *DevicePath

+  );

+

+/**

+  Retrieves the device path protocol from a handle.

+

+  This function returns the device path protocol from the handle specified by Handle.  If Handle is

+  NULL or Handle does not contain a device path protocol, then NULL is returned.

+

+  @param  Handle                     The handle from which to retrieve the device path protocol.

+

+  @return The device path protocol from the handle specified by Handle.

+

+**/

+EFI_DEVICE_PATH_PROTOCOL *

+EFIAPI

+DevicePathFromHandle (

+  IN EFI_HANDLE                      Handle

+  );

+

+/**

+  Allocates a device path for a file and appends it to an existing device path.

+

+  If Device is a valid device handle that contains a device path protocol, then a device path for

+  the file specified by FileName  is allocated and appended to the device path associated with the

+  handle Device.  The allocated device path is returned.  If Device is NULL or Device is a handle

+  that does not support the device path protocol, then a device path containing a single device

+  path node for the file specified by FileName is allocated and returned.

+  The memory for the new device path is allocated from EFI boot services memory. It is the responsibility

+  of the caller to free the memory allocated.

+

+  If FileName is NULL, then ASSERT().

+  If FileName is not aligned on a 16-bit boundary, then ASSERT().

+

+  @param  Device                     A pointer to a device handle.  This parameter is optional and

+                                     may be NULL.

+  @param  FileName                   A pointer to a Null-terminated Unicode string.

+

+  @return The allocated device path.

+

+**/

+EFI_DEVICE_PATH_PROTOCOL *

+EFIAPI

+FileDevicePath (

+  IN EFI_HANDLE                      Device,     OPTIONAL

+  IN CONST CHAR16                    *FileName

+  );

+

+/**

+  Converts a device path to its text representation.

+

+  @param DevicePath      A Pointer to the device to be converted.

+  @param DisplayOnly     If DisplayOnly is TRUE, then the shorter text representation

+                         of the display node is used, where applicable. If DisplayOnly

+                         is FALSE, then the longer text representation of the display node

+                         is used.

+  @param AllowShortcuts  If AllowShortcuts is TRUE, then the shortcut forms of text

+                         representation for a device node can be used, where applicable.

+

+  @return A pointer to the allocated text representation of the device path or

+          NULL if DeviceNode is NULL or there was insufficient memory.

+

+**/

+CHAR16 *

+EFIAPI

+ConvertDevicePathToText (

+  IN CONST EFI_DEVICE_PATH_PROTOCOL   *DevicePath,

+  IN BOOLEAN                          DisplayOnly,

+  IN BOOLEAN                          AllowShortcuts

+  );

+

+/**

+  Converts a device node to its string representation.

+

+  @param DeviceNode        A Pointer to the device node to be converted.

+  @param DisplayOnly       If DisplayOnly is TRUE, then the shorter text representation

+                           of the display node is used, where applicable. If DisplayOnly

+                           is FALSE, then the longer text representation of the display node

+                           is used.

+  @param AllowShortcuts    If AllowShortcuts is TRUE, then the shortcut forms of text

+                           representation for a device node can be used, where applicable.

+

+  @return A pointer to the allocated text representation of the device node or NULL if DeviceNode

+          is NULL or there was insufficient memory.

+

+**/

+CHAR16 *

+EFIAPI

+ConvertDeviceNodeToText (

+  IN CONST EFI_DEVICE_PATH_PROTOCOL  *DeviceNode,

+  IN BOOLEAN                         DisplayOnly,

+  IN BOOLEAN                         AllowShortcuts

+  );

+

+/**

+  Convert text to the binary representation of a device node.

+

+  @param TextDeviceNode  TextDeviceNode points to the text representation of a device

+                         node. Conversion starts with the first character and continues

+                         until the first non-device node character.

+

+  @return A pointer to the EFI device node or NULL if TextDeviceNode is NULL or there was

+          insufficient memory or text unsupported.

+

+**/

+EFI_DEVICE_PATH_PROTOCOL *

+EFIAPI

+ConvertTextToDeviceNode (

+  IN CONST CHAR16 *TextDeviceNode

+  );

+

+/**

+  Convert text to the binary representation of a device path.

+

+  @param TextDevicePath  TextDevicePath points to the text representation of a device

+                         path. Conversion starts with the first character and continues

+                         until the first non-device node character.

+

+  @return A pointer to the allocated device path or NULL if TextDeviceNode is NULL or

+          there was insufficient memory.

+

+**/

+EFI_DEVICE_PATH_PROTOCOL *

+EFIAPI

+ConvertTextToDevicePath (

+  IN CONST CHAR16 *TextDevicePath

+  );

+

+#endif

diff --git a/debugging_demo/memtest86+/efi/Include/Library/MemoryAllocationLib.h b/debugging_demo/memtest86+/efi/Include/Library/MemoryAllocationLib.h
new file mode 100644
index 0000000..65a30cf
--- /dev/null
+++ b/debugging_demo/memtest86+/efi/Include/Library/MemoryAllocationLib.h
@@ -0,0 +1,487 @@
+/** @file

+  Provides services to allocate and free memory buffers of various memory types and alignments.

+

+  The Memory Allocation Library abstracts various common memory allocation operations. This library

+  allows code to be written in a phase-independent manner because the allocation of memory in PEI, DXE,

+  and SMM (for example) is done via a different mechanism. Using a common library interface makes it

+  much easier to port algorithms from phase to phase.

+

+Copyright (c) 2006 - 2018, Intel Corporation. All rights reserved.<BR>

+SPDX-License-Identifier: BSD-2-Clause-Patent

+

+**/

+

+#ifndef __MEMORY_ALLOCATION_LIB_H__

+#define __MEMORY_ALLOCATION_LIB_H__

+

+/**

+  Allocates one or more 4KB pages of type EfiBootServicesData.

+

+  Allocates the number of 4KB pages of type EfiBootServicesData and returns a pointer to the

+  allocated buffer.  The buffer returned is aligned on a 4KB boundary.  If Pages is 0, then NULL

+  is returned.  If there is not enough memory remaining to satisfy the request, then NULL is

+  returned.

+

+  @param  Pages                 The number of 4 KB pages to allocate.

+

+  @return A pointer to the allocated buffer or NULL if allocation fails.

+

+**/

+VOID *

+EFIAPI

+AllocatePages (

+  IN UINTN  Pages

+  );

+

+/**

+  Allocates one or more 4KB pages of type EfiRuntimeServicesData.

+

+  Allocates the number of 4KB pages of type EfiRuntimeServicesData and returns a pointer to the

+  allocated buffer.  The buffer returned is aligned on a 4KB boundary.  If Pages is 0, then NULL

+  is returned.  If there is not enough memory remaining to satisfy the request, then NULL is

+  returned.

+

+  @param  Pages                 The number of 4 KB pages to allocate.

+

+  @return A pointer to the allocated buffer or NULL if allocation fails.

+

+**/

+VOID *

+EFIAPI

+AllocateRuntimePages (

+  IN UINTN  Pages

+  );

+

+/**

+  Allocates one or more 4KB pages of type EfiReservedMemoryType.

+

+  Allocates the number of 4KB pages of type EfiReservedMemoryType and returns a pointer to the

+  allocated buffer.  The buffer returned is aligned on a 4KB boundary.  If Pages is 0, then NULL

+  is returned.  If there is not enough memory remaining to satisfy the request, then NULL is

+  returned.

+

+  @param  Pages                 The number of 4 KB pages to allocate.

+

+  @return A pointer to the allocated buffer or NULL if allocation fails.

+

+**/

+VOID *

+EFIAPI

+AllocateReservedPages (

+  IN UINTN  Pages

+  );

+

+/**

+  Frees one or more 4KB pages that were previously allocated with one of the page allocation

+  functions in the Memory Allocation Library.

+

+  Frees the number of 4KB pages specified by Pages from the buffer specified by Buffer.  Buffer

+  must have been allocated on a previous call to the page allocation services of the Memory

+  Allocation Library.  If it is not possible to free allocated pages, then this function will

+  perform no actions.

+

+  If Buffer was not allocated with a page allocation function in the Memory Allocation Library,

+  then ASSERT().

+  If Pages is zero, then ASSERT().

+

+  @param  Buffer                Pointer to the buffer of pages to free.

+  @param  Pages                 The number of 4 KB pages to free.

+

+**/

+VOID

+EFIAPI

+FreePages (

+  IN VOID   *Buffer,

+  IN UINTN  Pages

+  );

+

+/**

+  Allocates one or more 4KB pages of type EfiBootServicesData at a specified alignment.

+

+  Allocates the number of 4KB pages specified by Pages of type EfiBootServicesData with an

+  alignment specified by Alignment.  The allocated buffer is returned.  If Pages is 0, then NULL is

+  returned.  If there is not enough memory at the specified alignment remaining to satisfy the

+  request, then NULL is returned.

+

+  If Alignment is not a power of two and Alignment is not zero, then ASSERT().

+  If Pages plus EFI_SIZE_TO_PAGES (Alignment) overflows, then ASSERT().

+

+  @param  Pages                 The number of 4 KB pages to allocate.

+  @param  Alignment             The requested alignment of the allocation.  Must be a power of two.

+                                If Alignment is zero, then byte alignment is used.

+

+  @return A pointer to the allocated buffer or NULL if allocation fails.

+

+**/

+VOID *

+EFIAPI

+AllocateAlignedPages (

+  IN UINTN  Pages,

+  IN UINTN  Alignment

+  );

+

+/**

+  Allocates one or more 4KB pages of type EfiRuntimeServicesData at a specified alignment.

+

+  Allocates the number of 4KB pages specified by Pages of type EfiRuntimeServicesData with an

+  alignment specified by Alignment.  The allocated buffer is returned.  If Pages is 0, then NULL is

+  returned.  If there is not enough memory at the specified alignment remaining to satisfy the

+  request, then NULL is returned.

+

+  If Alignment is not a power of two and Alignment is not zero, then ASSERT().

+  If Pages plus EFI_SIZE_TO_PAGES (Alignment) overflows, then ASSERT().

+

+  @param  Pages                 The number of 4 KB pages to allocate.

+  @param  Alignment             The requested alignment of the allocation.  Must be a power of two.

+                                If Alignment is zero, then byte alignment is used.

+

+  @return A pointer to the allocated buffer or NULL if allocation fails.

+

+**/

+VOID *

+EFIAPI

+AllocateAlignedRuntimePages (

+  IN UINTN  Pages,

+  IN UINTN  Alignment

+  );

+

+/**

+  Allocates one or more 4KB pages of type EfiReservedMemoryType at a specified alignment.

+

+  Allocates the number of 4KB pages specified by Pages of type EfiReservedMemoryType with an

+  alignment specified by Alignment.  The allocated buffer is returned.  If Pages is 0, then NULL is

+  returned.  If there is not enough memory at the specified alignment remaining to satisfy the

+  request, then NULL is returned.

+

+  If Alignment is not a power of two and Alignment is not zero, then ASSERT().

+  If Pages plus EFI_SIZE_TO_PAGES (Alignment) overflows, then ASSERT().

+

+  @param  Pages                 The number of 4 KB pages to allocate.

+  @param  Alignment             The requested alignment of the allocation.  Must be a power of two.

+                                If Alignment is zero, then byte alignment is used.

+

+  @return A pointer to the allocated buffer or NULL if allocation fails.

+

+**/

+VOID *

+EFIAPI

+AllocateAlignedReservedPages (

+  IN UINTN  Pages,

+  IN UINTN  Alignment

+  );

+

+/**

+  Frees one or more 4KB pages that were previously allocated with one of the aligned page

+  allocation functions in the Memory Allocation Library.

+

+  Frees the number of 4KB pages specified by Pages from the buffer specified by Buffer.  Buffer

+  must have been allocated on a previous call to the aligned page allocation services of the Memory

+  Allocation Library.  If it is not possible to free allocated pages, then this function will

+  perform no actions.

+

+  If Buffer was not allocated with an aligned page allocation function in the Memory Allocation

+  Library, then ASSERT().

+  If Pages is zero, then ASSERT().

+

+  @param  Buffer                Pointer to the buffer of pages to free.

+  @param  Pages                 The number of 4 KB pages to free.

+

+**/

+VOID

+EFIAPI

+FreeAlignedPages (

+  IN VOID   *Buffer,

+  IN UINTN  Pages

+  );

+

+/**

+  Allocates a buffer of type EfiBootServicesData.

+

+  Allocates the number bytes specified by AllocationSize of type EfiBootServicesData and returns a

+  pointer to the allocated buffer.  If AllocationSize is 0, then a valid buffer of 0 size is

+  returned.  If there is not enough memory remaining to satisfy the request, then NULL is returned.

+

+  @param  AllocationSize        The number of bytes to allocate.

+

+  @return A pointer to the allocated buffer or NULL if allocation fails.

+

+**/

+VOID *

+EFIAPI

+AllocatePool (

+  IN UINTN  AllocationSize

+  );

+

+/**

+  Allocates a buffer of type EfiRuntimeServicesData.

+

+  Allocates the number bytes specified by AllocationSize of type EfiRuntimeServicesData and returns

+  a pointer to the allocated buffer.  If AllocationSize is 0, then a valid buffer of 0 size is

+  returned.  If there is not enough memory remaining to satisfy the request, then NULL is returned.

+

+  @param  AllocationSize        The number of bytes to allocate.

+

+  @return A pointer to the allocated buffer or NULL if allocation fails.

+

+**/

+VOID *

+EFIAPI

+AllocateRuntimePool (

+  IN UINTN  AllocationSize

+  );

+

+/**

+  Allocates a buffer of type EfiReservedMemoryType.

+

+  Allocates the number bytes specified by AllocationSize of type EfiReservedMemoryType and returns

+  a pointer to the allocated buffer.  If AllocationSize is 0, then a valid buffer of 0 size is

+  returned.  If there is not enough memory remaining to satisfy the request, then NULL is returned.

+

+  @param  AllocationSize        The number of bytes to allocate.

+

+  @return A pointer to the allocated buffer or NULL if allocation fails.

+

+**/

+VOID *

+EFIAPI

+AllocateReservedPool (

+  IN UINTN  AllocationSize

+  );

+

+/**

+  Allocates and zeros a buffer of type EfiBootServicesData.

+

+  Allocates the number bytes specified by AllocationSize of type EfiBootServicesData, clears the

+  buffer with zeros, and returns a pointer to the allocated buffer.  If AllocationSize is 0, then a

+  valid buffer of 0 size is returned.  If there is not enough memory remaining to satisfy the

+  request, then NULL is returned.

+

+  @param  AllocationSize        The number of bytes to allocate and zero.

+

+  @return A pointer to the allocated buffer or NULL if allocation fails.

+

+**/

+VOID *

+EFIAPI

+AllocateZeroPool (

+  IN UINTN  AllocationSize

+  );

+

+/**

+  Allocates and zeros a buffer of type EfiRuntimeServicesData.

+

+  Allocates the number bytes specified by AllocationSize of type EfiRuntimeServicesData, clears the

+  buffer with zeros, and returns a pointer to the allocated buffer.  If AllocationSize is 0, then a

+  valid buffer of 0 size is returned.  If there is not enough memory remaining to satisfy the

+  request, then NULL is returned.

+

+  @param  AllocationSize        The number of bytes to allocate and zero.

+

+  @return A pointer to the allocated buffer or NULL if allocation fails.

+

+**/

+VOID *

+EFIAPI

+AllocateRuntimeZeroPool (

+  IN UINTN  AllocationSize

+  );

+

+/**

+  Allocates and zeros a buffer of type EfiReservedMemoryType.

+

+  Allocates the number bytes specified by AllocationSize of type EfiReservedMemoryType, clears the

+  buffer with zeros, and returns a pointer to the allocated buffer.  If AllocationSize is 0, then a

+  valid buffer of 0 size is returned.  If there is not enough memory remaining to satisfy the

+  request, then NULL is returned.

+

+  @param  AllocationSize        The number of bytes to allocate and zero.

+

+  @return A pointer to the allocated buffer or NULL if allocation fails.

+

+**/

+VOID *

+EFIAPI

+AllocateReservedZeroPool (

+  IN UINTN  AllocationSize

+  );

+

+/**

+  Copies a buffer to an allocated buffer of type EfiBootServicesData.

+

+  Allocates the number bytes specified by AllocationSize of type EfiBootServicesData, copies

+  AllocationSize bytes from Buffer to the newly allocated buffer, and returns a pointer to the

+  allocated buffer.  If AllocationSize is 0, then a valid buffer of 0 size is returned.  If there

+  is not enough memory remaining to satisfy the request, then NULL is returned.

+

+  If Buffer is NULL, then ASSERT().

+  If AllocationSize is greater than (MAX_ADDRESS - Buffer + 1), then ASSERT().

+

+  @param  AllocationSize        The number of bytes to allocate and zero.

+  @param  Buffer                The buffer to copy to the allocated buffer.

+

+  @return A pointer to the allocated buffer or NULL if allocation fails.

+

+**/

+VOID *

+EFIAPI

+AllocateCopyPool (

+  IN UINTN       AllocationSize,

+  IN CONST VOID  *Buffer

+  );

+

+/**

+  Copies a buffer to an allocated buffer of type EfiRuntimeServicesData.

+

+  Allocates the number bytes specified by AllocationSize of type EfiRuntimeServicesData, copies

+  AllocationSize bytes from Buffer to the newly allocated buffer, and returns a pointer to the

+  allocated buffer.  If AllocationSize is 0, then a valid buffer of 0 size is returned.  If there

+  is not enough memory remaining to satisfy the request, then NULL is returned.

+

+  If Buffer is NULL, then ASSERT().

+  If AllocationSize is greater than (MAX_ADDRESS - Buffer + 1), then ASSERT().

+

+  @param  AllocationSize        The number of bytes to allocate and zero.

+  @param  Buffer                The buffer to copy to the allocated buffer.

+

+  @return A pointer to the allocated buffer or NULL if allocation fails.

+

+**/

+VOID *

+EFIAPI

+AllocateRuntimeCopyPool (

+  IN UINTN       AllocationSize,

+  IN CONST VOID  *Buffer

+  );

+

+/**

+  Copies a buffer to an allocated buffer of type EfiReservedMemoryType.

+

+  Allocates the number bytes specified by AllocationSize of type EfiReservedMemoryType, copies

+  AllocationSize bytes from Buffer to the newly allocated buffer, and returns a pointer to the

+  allocated buffer.  If AllocationSize is 0, then a valid buffer of 0 size is returned.  If there

+  is not enough memory remaining to satisfy the request, then NULL is returned.

+

+  If Buffer is NULL, then ASSERT().

+  If AllocationSize is greater than (MAX_ADDRESS - Buffer + 1), then ASSERT().

+

+  @param  AllocationSize        The number of bytes to allocate and zero.

+  @param  Buffer                The buffer to copy to the allocated buffer.

+

+  @return A pointer to the allocated buffer or NULL if allocation fails.

+

+**/

+VOID *

+EFIAPI

+AllocateReservedCopyPool (

+  IN UINTN       AllocationSize,

+  IN CONST VOID  *Buffer

+  );

+

+/**

+  Reallocates a buffer of type EfiBootServicesData.

+

+  Allocates and zeros the number bytes specified by NewSize from memory of type

+  EfiBootServicesData.  If OldBuffer is not NULL, then the smaller of OldSize and

+  NewSize bytes are copied from OldBuffer to the newly allocated buffer, and

+  OldBuffer is freed.  A pointer to the newly allocated buffer is returned.

+  If NewSize is 0, then a valid buffer of 0 size is  returned.  If there is not

+  enough memory remaining to satisfy the request, then NULL is returned.

+

+  If the allocation of the new buffer is successful and the smaller of NewSize and OldSize

+  is greater than (MAX_ADDRESS - OldBuffer + 1), then ASSERT().

+

+  @param  OldSize        The size, in bytes, of OldBuffer.

+  @param  NewSize        The size, in bytes, of the buffer to reallocate.

+  @param  OldBuffer      The buffer to copy to the allocated buffer.  This is an optional

+                         parameter that may be NULL.

+

+  @return A pointer to the allocated buffer or NULL if allocation fails.

+

+**/

+VOID *

+EFIAPI

+ReallocatePool (

+  IN UINTN  OldSize,

+  IN UINTN  NewSize,

+  IN VOID   *OldBuffer  OPTIONAL

+  );

+

+/**

+  Reallocates a buffer of type EfiRuntimeServicesData.

+

+  Allocates and zeros the number bytes specified by NewSize from memory of type

+  EfiRuntimeServicesData.  If OldBuffer is not NULL, then the smaller of OldSize and

+  NewSize bytes are copied from OldBuffer to the newly allocated buffer, and

+  OldBuffer is freed.  A pointer to the newly allocated buffer is returned.

+  If NewSize is 0, then a valid buffer of 0 size is  returned.  If there is not

+  enough memory remaining to satisfy the request, then NULL is returned.

+

+  If the allocation of the new buffer is successful and the smaller of NewSize and OldSize

+  is greater than (MAX_ADDRESS - OldBuffer + 1), then ASSERT().

+

+  @param  OldSize        The size, in bytes, of OldBuffer.

+  @param  NewSize        The size, in bytes, of the buffer to reallocate.

+  @param  OldBuffer      The buffer to copy to the allocated buffer.  This is an optional

+                         parameter that may be NULL.

+

+  @return A pointer to the allocated buffer or NULL if allocation fails.

+

+**/

+VOID *

+EFIAPI

+ReallocateRuntimePool (

+  IN UINTN  OldSize,

+  IN UINTN  NewSize,

+  IN VOID   *OldBuffer  OPTIONAL

+  );

+

+/**

+  Reallocates a buffer of type EfiReservedMemoryType.

+

+  Allocates and zeros the number bytes specified by NewSize from memory of type

+  EfiReservedMemoryType.  If OldBuffer is not NULL, then the smaller of OldSize and

+  NewSize bytes are copied from OldBuffer to the newly allocated buffer, and

+  OldBuffer is freed.  A pointer to the newly allocated buffer is returned.

+  If NewSize is 0, then a valid buffer of 0 size is  returned.  If there is not

+  enough memory remaining to satisfy the request, then NULL is returned.

+

+  If the allocation of the new buffer is successful and the smaller of NewSize and OldSize

+  is greater than (MAX_ADDRESS - OldBuffer + 1), then ASSERT().

+

+  @param  OldSize        The size, in bytes, of OldBuffer.

+  @param  NewSize        The size, in bytes, of the buffer to reallocate.

+  @param  OldBuffer      The buffer to copy to the allocated buffer.  This is an optional

+                         parameter that may be NULL.

+

+  @return A pointer to the allocated buffer or NULL if allocation fails.

+

+**/

+VOID *

+EFIAPI

+ReallocateReservedPool (

+  IN UINTN  OldSize,

+  IN UINTN  NewSize,

+  IN VOID   *OldBuffer  OPTIONAL

+  );

+

+/**

+  Frees a buffer that was previously allocated with one of the pool allocation functions in the

+  Memory Allocation Library.

+

+  Frees the buffer specified by Buffer.  Buffer must have been allocated on a previous call to the

+  pool allocation services of the Memory Allocation Library.  If it is not possible to free pool

+  resources, then this function will perform no actions.

+

+  If Buffer was not allocated with a pool allocation function in the Memory Allocation Library,

+  then ASSERT().

+

+  @param  Buffer                Pointer to the buffer to free.

+

+**/

+VOID

+EFIAPI

+FreePool (

+  IN VOID   *Buffer

+  );

+

+#endif

diff --git a/debugging_demo/memtest86+/efi/Include/Library/PcdLib.h b/debugging_demo/memtest86+/efi/Include/Library/PcdLib.h
new file mode 100644
index 0000000..e8fd172
--- /dev/null
+++ b/debugging_demo/memtest86+/efi/Include/Library/PcdLib.h
@@ -0,0 +1,1736 @@
+/** @file

+  Provides library services to get and set Platform Configuration Database entries.

+

+  PCD Library Class provides a PCD usage macro interface for all PCD types.

+  It should be included in any module that uses PCD. If a module uses dynamic/dynamicex

+  PCD, module should be linked to a PEIM/DXE library instance to access that PCD.

+  If a module uses PatchableInModule type PCD, it also needs the library instance to produce

+  LibPatchPcdSetPtr() interface. For FeatureFlag/Fixed PCD, the macro interface is

+  translated to a variable or macro that is auto-generated by build tool in

+  module's autogen.h/autogen.c.

+  The PcdGetXX(), PcdSetXX(), PcdToken(), and PcdGetNextTokenSpace() operations are

+  only available prior to ExitBootServices().  If access to PCD values are required

+  at runtime, then their values must be collected prior to ExitBootServices().

+  There are no restrictions on the use of FeaturePcd(), FixedPcdGetXX(),

+  PatchPcdGetXX(), and PatchPcdSetXX().

+

+Copyright (c) 2006 - 2018, Intel Corporation. All rights reserved.<BR>

+SPDX-License-Identifier: BSD-2-Clause-Patent

+

+**/

+

+#include "Efi_Defs_Pcd.h"

+

+#ifndef __PCD_LIB_H__

+#define __PCD_LIB_H__

+

+

+/**

+  Retrieves a token number based on a token name.

+

+  Returns the token number associated with the PCD token specified by TokenName.

+  If TokenName is not a valid token in the token space, then the module will not build.

+

+  @param   TokenName  The name of the PCD token to retrieve the token number for.

+

+  @return  The token number associated with the PCD.

+

+**/

+#define PcdToken(TokenName)                 _PCD_TOKEN_##TokenName

+

+

+/**

+  Retrieves a Boolean PCD feature flag based on a token name.

+

+  Returns the Boolean value for the PCD feature flag specified by TokenName.

+  If TokenName is not a valid token in the token space, then the module will not build.

+  If TokenName is not a feature flag PCD, then the module will not build.

+

+  @param   TokenName  The name of the PCD token to retrieve a current value for.

+

+  @return  Boolean value for the PCD feature flag.

+

+**/

+#define FeaturePcdGet(TokenName)            _PCD_GET_MODE_BOOL_##TokenName

+

+

+/**

+  Retrieves an 8-bit fixed PCD token value based on a token name.

+

+  Returns the 8-bit value for the token specified by TokenName.

+  If TokenName is not a valid token in the token space, then the module will not build.

+  If TokenName is not a fixed at build PCD, then the module will not build.

+

+  @param   TokenName  The name of the PCD token to retrieve a current value for.

+

+  @return  8-bit value for the token specified by TokenName.

+

+**/

+#define FixedPcdGet8(TokenName)             _PCD_VALUE_##TokenName

+

+

+/**

+  Retrieves a 16-bit fixed PCD token value based on a token name.

+

+  Returns the 16-bit value for the token specified by TokenName.

+  If TokenName is not a valid token in the token space, then the module will not build.

+  If TokenName is not a fixed at build PCD, then the module will not build.

+

+  @param   TokenName  The name of the PCD token to retrieve a current value for.

+

+  @return  16-bit value for the token specified by TokenName.

+

+**/

+#define FixedPcdGet16(TokenName)            _PCD_VALUE_##TokenName

+

+

+/**

+  Retrieves a 32-bit fixed PCD token value based on a token name.

+

+  Returns the 32-bit value for the token specified by TokenName.

+  If TokenName is not a valid token in the token space, then the module will not build.

+  If TokenName is not a fixed at build PCD, then the module will not build.

+

+  @param   TokenName  The name of the PCD token to retrieve a current value for.

+

+  @return  32-bit value for the token specified by TokenName.

+

+**/

+#define FixedPcdGet32(TokenName)            _PCD_VALUE_##TokenName

+

+

+/**

+  Retrieves a 64-bit fixed PCD token value based on a token name.

+

+  Returns the 64-bit value for the token specified by TokenName.

+  If TokenName is not a valid token in the token space, then the module will not build.

+  If TokenName is not a fixed at build PCD, then the module will not build.

+

+  @param   TokenName  The name of the PCD token to retrieve a current value for.

+

+  @return  64-bit value for the token specified by TokenName.

+

+**/

+#define FixedPcdGet64(TokenName)            _PCD_VALUE_##TokenName

+

+

+/**

+  Retrieves a Boolean fixed PCD token value based on a token name.

+

+  Returns the Boolean value for the token specified by TokenName.

+  If TokenName is not a valid token in the token space, then the module will not build.

+  If TokenName is not a fixed at build PCD, then the module will not build.

+

+  @param   TokenName  The name of the PCD token to retrieve a current value for.

+

+  @return  The Boolean value for the token.

+

+**/

+#define FixedPcdGetBool(TokenName)          _PCD_VALUE_##TokenName

+

+

+/**

+  Retrieves a pointer to a fixed PCD token buffer based on a token name.

+

+  Returns a pointer to the buffer for the token specified by TokenName.

+  If TokenName is not a valid token in the token space, then the module will not build.

+  If TokenName is not a fixed at build PCD, then the module will not build.

+

+  @param   TokenName  The name of the PCD token to retrieve a current value for.

+

+  @return  A pointer to the buffer.

+

+**/

+#define FixedPcdGetPtr(TokenName)           ((VOID *)_PCD_VALUE_##TokenName)

+

+

+/**

+  Retrieves an 8-bit binary patchable PCD token value based on a token name.

+

+  Returns the 8-bit value for the token specified by TokenName.

+  If TokenName is not a valid token in the token space, then the module will not build.

+  If TokenName is not a patchable in module PCD, then the module will not build.

+

+  @param   TokenName  The name of the PCD token to retrieve a current value for.

+

+  @return  An 8-bit binary patchable PCD token value.

+

+**/

+#define PatchPcdGet8(TokenName)             _gPcd_BinaryPatch_##TokenName

+

+/**

+  Retrieves a 16-bit binary patchable PCD token value based on a token name.

+

+  Returns the 16-bit value for the token specified by TokenName.

+  If TokenName is not a valid token in the token space, then the module will not build.

+  If TokenName is not a patchable in module PCD, then the module will not build.

+

+  @param   TokenName  The name of the PCD token to retrieve a current value for.

+

+  @return  A 16-bit binary patchable PCD token value.

+

+**/

+#define PatchPcdGet16(TokenName)            _gPcd_BinaryPatch_##TokenName

+

+

+/**

+  Retrieves a 32-bit binary patchable PCD token value based on a token name.

+

+  Returns the 32-bit value for the token specified by TokenName.

+  If TokenName is not a valid token in the token space, then the module will not build.

+  If TokenName is not a patchable in module PCD, then the module will not build.

+

+  @param   TokenName  The name of the PCD token to retrieve a current value for.

+

+  @return  A 32-bit binary patchable PCD token value.

+

+**/

+#define PatchPcdGet32(TokenName)            _gPcd_BinaryPatch_##TokenName

+

+

+/**

+  Retrieves a 64-bit binary patchable PCD token value based on a token name.

+

+  Returns the 64-bit value for the token specified by TokenName.

+  If TokenName is not a valid token in the token space, then the module will not build.

+  If TokenName is not a patchable in module PCD, then the module will not build.

+

+  @param   TokenName  The name of the PCD token to retrieve a current value for.

+

+  @return  A 64-bit binary patchable PCD token value.

+

+**/

+#define PatchPcdGet64(TokenName)            _gPcd_BinaryPatch_##TokenName

+

+

+/**

+  Retrieves a Boolean binary patchable PCD token value based on a token name.

+

+  Returns the Boolean value for the token specified by TokenName.

+  If TokenName is not a valid token in the token space, then the module will not build.

+  If TokenName is not a patchable in module PCD, then the module will not build.

+

+  @param   TokenName  The name of the PCD token to retrieve a current value for.

+

+  @return  The Boolean value for the token.

+

+**/

+#define PatchPcdGetBool(TokenName)          _gPcd_BinaryPatch_##TokenName

+

+

+/**

+  Retrieves a pointer to a binary patchable PCD token buffer based on a token name.

+

+  Returns a pointer to the buffer for the token specified by TokenName.

+  If TokenName is not a valid token in the token space, then the module will not build.

+  If TokenName is not a patchable in module PCD, then the module will not build.

+

+  @param   TokenName  The name of the PCD token to retrieve a current value for.

+

+  @return  A pointer to the buffer for the token.

+

+**/

+#define PatchPcdGetPtr(TokenName)           ((VOID *)_gPcd_BinaryPatch_##TokenName)

+

+

+/**

+  Sets an 8-bit binary patchable PCD token value based on a token name.

+

+  Sets the 8-bit value for the token specified by TokenName. Value is returned.

+  If TokenName is not a valid token in the token space, then the module will not build.

+  If TokenName is not a patchable in module PCD, then the module will not build.

+

+  @param   TokenName  The name of the binary patchable PCD token to set the current value for.

+  @param   Value      The 8-bit value to set.

+

+  @return Return the Value that was set.

+

+**/

+#define PatchPcdSet8(TokenName, Value)      (_gPcd_BinaryPatch_##TokenName = (Value))

+

+

+/**

+  Sets a 16-bit binary patchable PCD token value based on a token name.

+

+  Sets the 16-bit value for the token specified by TokenName. Value is returned.

+  If TokenName is not a valid token in the token space, then the module will not build.

+  If TokenName is not a patchable in module PCD, then the module will not build.

+

+  @param   TokenName  The name of the binary patchable PCD token to set the current value for.

+  @param   Value      The 16-bit value to set.

+

+  @return Return the Value that was set.

+

+**/

+#define PatchPcdSet16(TokenName, Value)     (_gPcd_BinaryPatch_##TokenName = (Value))

+

+

+/**

+  Sets a 32-bit binary patchable PCD token value based on a token name.

+

+  Sets the 32-bit value for the token specified by TokenName. Value is returned.

+  If TokenName is not a valid token in the token space, then the module will not build.

+  If TokenName is not a patchable in module PCD, then the module will not build.

+

+  @param   TokenName  The name of the binary patchable PCD token to set the current value for.

+  @param   Value      The 32-bit value to set.

+

+  @return Return the Value that was set.

+

+**/

+#define PatchPcdSet32(TokenName, Value)     (_gPcd_BinaryPatch_##TokenName = (Value))

+

+

+/**

+  Sets a 64-bit binary patchable PCD token value based on a token name.

+

+  Sets the 64-bit value for the token specified by TokenName. Value is returned.

+  If TokenName is not a valid token in the token space, then the module will not build.

+  If TokenName is not a patchable in module PCD, then the module will not build.

+

+  @param   TokenName  The name of the binary patchable PCD token to set the current value for.

+  @param   Value      The 64-bit value to set.

+

+  @return Return the Value that was set.

+

+**/

+#define PatchPcdSet64(TokenName, Value)     (_gPcd_BinaryPatch_##TokenName = (Value))

+

+

+/**

+  Sets a Boolean binary patchable PCD token value based on a token name.

+

+  Sets the Boolean value for the token specified by TokenName. Value is returned.

+  If TokenName is not a valid token in the token space, then the module will not build.

+  If TokenName is not a patchable in module PCD, then the module will not build.

+

+  @param   TokenName  The name of the binary patchable PCD token to set the current value for.

+  @param   Value      The boolean value to set.

+

+  @return Return the Value that was set.

+

+**/

+#define PatchPcdSetBool(TokenName, Value)   (_gPcd_BinaryPatch_##TokenName = (Value))

+

+

+/**

+  Sets a pointer to a binary patchable PCD token buffer based on a token name.

+

+  Sets the buffer for the token specified by TokenName.  Buffer is returned.

+  If SizeOfBuffer is greater than the maximum size supported by TokenName, then set SizeOfBuffer

+  to the maximum size supported by TokenName and return NULL to indicate that the set operation

+  was not actually performed.  If SizeOfBuffer is set to MAX_ADDRESS, then SizeOfBuffer must be

+  set to the maximum size supported by TokenName and NULL must be returned.

+  If TokenName is not a valid token in the token space, then the module will not build.

+  If TokenName is not a patchable in module PCD, then the module will not build.

+

+  If SizeOfBuffer is NULL, then ASSERT().

+  If SizeOfBuffer > 0 and Buffer is NULL, then ASSERT().

+

+  @param   TokenName      The name of the binary patchable PCD token to set the current value for.

+  @param   SizeOfBuffer   A pointer to the size, in bytes, of Buffer.

+  @param   Buffer         Pointer to the value to set.

+

+  @return Return the pointer to the Buffer that was set.

+

+**/

+#define PatchPcdSetPtr(TokenName, Size, Buffer) \

+                                            LibPatchPcdSetPtrAndSize (                 \

+                                              (VOID *)_gPcd_BinaryPatch_##TokenName,   \

+                                              &_gPcd_BinaryPatch_Size_##TokenName,     \

+                                              (UINTN)_PCD_PATCHABLE_##TokenName##_SIZE, \

+                                              (Size),                                  \

+                                              (Buffer)                                 \

+                                              )

+/**

+  Retrieves an 8-bit PCD token value based on a token name.

+

+  Returns the 8-bit value for the token specified by TokenName.

+  If TokenName is not a valid token in the token space, then the module will not build.

+

+  @param   TokenName  The name of the PCD token to retrieve a current value for.

+

+  @return  8-bit value for the token specified by TokenName.

+

+**/

+#define PcdGet8(TokenName)                  _PCD_GET_MODE_8_##TokenName

+

+

+/**

+  Retrieves a 16-bit PCD token value based on a token name.

+

+  Returns the 16-bit value for the token specified by TokenName.

+  If TokenName is not a valid token in the token space, then the module will not build.

+

+  @param   TokenName  The name of the PCD token to retrieve a current value for.

+

+  @return  16-bit value for the token specified by TokenName.

+

+**/

+#define PcdGet16(TokenName)                 _PCD_GET_MODE_16_##TokenName

+

+

+/**

+  Retrieves a 32-bit PCD token value based on a token name.

+

+  Returns the 32-bit value for the token specified by TokenName.

+  If TokenName is not a valid token in the token space, then the module will not build.

+

+  @param   TokenName  The name of the PCD token to retrieve a current value for.

+

+  @return  32-bit value for the token specified by TokenName.

+

+**/

+#define PcdGet32(TokenName)                 _PCD_GET_MODE_32_##TokenName

+

+

+/**

+  Retrieves a 64-bit PCD token value based on a token name.

+

+  Returns the 64-bit value for the token specified by TokenName.

+  If TokenName is not a valid token in the token space, then the module will not build.

+

+  @param   TokenName  The name of the PCD token to retrieve a current value for.

+

+  @return  64-bit value for the token specified by TokenName.

+

+**/

+#define PcdGet64(TokenName)                 _PCD_GET_MODE_64_##TokenName

+

+

+/**

+  Retrieves a pointer to a PCD token buffer based on a token name.

+

+  Returns a pointer to the buffer for the token specified by TokenName.

+  If TokenName is not a valid token in the token space, then the module will not build.

+

+  @param   TokenName  The name of the PCD token to retrieve a current value for.

+

+  @return  A pointer to the buffer.

+

+**/

+#define PcdGetPtr(TokenName)                _PCD_GET_MODE_PTR_##TokenName

+

+

+/**

+  Retrieves a Boolean PCD token value based on a token name.

+

+  Returns the Boolean value for the token specified by TokenName.

+  If TokenName is not a valid token in the token space, then the module will not build.

+

+  @param   TokenName  The name of the PCD token to retrieve a current value for.

+

+  @return  A Boolean PCD token value.

+

+**/

+#define PcdGetBool(TokenName)               _PCD_GET_MODE_BOOL_##TokenName

+

+

+/**

+  Retrieves the size of a fixed PCD token based on a token name.

+

+  Returns the size of the token specified by TokenName.

+  If TokenName is not a valid token in the token space, then the module will not build.

+

+  @param[in]  TokenName  The name of the PCD token to retrieve a current value size for.

+

+  @return     Return the size

+

+**/

+#define FixedPcdGetSize(TokenName)    _PCD_SIZE_##TokenName

+

+

+/**

+  Retrieves the size of a binary patchable PCD token based on a token name.

+

+  Returns the size of the token specified by TokenName.

+  If TokenName is not a valid token in the token space, then the module will not build.

+

+  @param[in]  TokenName  The name of the PCD token to retrieve a current value size for.

+

+  @return     Return the size

+

+**/

+#define PatchPcdGetSize(TokenName)    _gPcd_BinaryPatch_Size_##TokenName

+

+

+/**

+  Retrieves the size of the PCD token based on a token name.

+

+  Returns the size of the token specified by TokenName.

+  If TokenName is not a valid token in the token space, then the module will not build.

+

+  @param[in]   TokenName  The name of the PCD token to retrieve a current value size for.

+

+  @return      Return the size

+

+**/

+#define PcdGetSize(TokenName)         _PCD_GET_MODE_SIZE_##TokenName

+

+

+/**

+  Retrieve the size of a given PCD token.

+

+  Returns the size of the token specified by TokenNumber and Guid.

+  If Guid is NULL, then ASSERT().

+

+  @param[in]  Guid          Pointer to a 128-bit unique value that designates

+                            which namespace to retrieve a value from.

+  @param[in]  TokenNumber   The PCD token number to retrieve a current value size for.

+

+  @return     Return the size.

+

+**/

+#define PcdGetExSize(Guid, TokenName) LibPcdGetExSize ((Guid), PcdTokenEx(Guid,TokenName))

+

+/**

+  Sets a 8-bit PCD token value based on a token name.

+

+  Sets the 8-bit value for the token specified by TokenName.

+  If TokenName is not a valid token in the token space, then the module will not build.

+

+  @param TokenName  The name of the PCD token to retrieve a current value for.

+  @param Value      The 8-bit value to set.

+

+  @return The status of the set operation.

+

+**/

+#define PcdSet8S(TokenName, Value)          _PCD_SET_MODE_8_S_##TokenName    ((Value))

+

+/**

+  Sets a 16-bit PCD token value based on a token name.

+

+  Sets the 16-bit value for the token specified by TokenName.

+  If TokenName is not a valid token in the token space, then the module will not build.

+

+  @param TokenName  The name of the PCD token to retrieve a current value for.

+  @param Value      The 16-bit value to set.

+

+  @return The status of the set operation.

+

+**/

+#define PcdSet16S(TokenName, Value)         _PCD_SET_MODE_16_S_##TokenName    ((Value))

+

+/**

+  Sets a 32-bit PCD token value based on a token name.

+

+  Sets the 32-bit value for the token specified by TokenName.

+  If TokenName is not a valid token in the token space, then the module will not build.

+

+  @param TokenName  The name of the PCD token to retrieve a current value for.

+  @param Value      The 32-bit value to set.

+

+  @return The status of the set operation.

+

+**/

+#define PcdSet32S(TokenName, Value)         _PCD_SET_MODE_32_S_##TokenName    ((Value))

+

+/**

+  Sets a 64-bit PCD token value based on a token name.

+

+  Sets the 64-bit value for the token specified by TokenName.

+  If TokenName is not a valid token in the token space, then the module will not build.

+

+  @param TokenName  The name of the PCD token to retrieve a current value for.

+  @param Value      The 64-bit value to set.

+

+  @return The status of the set operation.

+

+**/

+#define PcdSet64S(TokenName, Value)         _PCD_SET_MODE_64_S_##TokenName    ((Value))

+

+/**

+  Sets a pointer to a PCD token buffer based on a token name.

+

+  Sets the buffer for the token specified by TokenName.

+  If SizeOfBuffer is greater than the maximum size supported by TokenName,

+  then set SizeOfBuffer to the maximum size supported by TokenName and return

+  RETURN_INVALID_PARAMETER to indicate that the set operation was not actually performed.

+  If SizeOfBuffer is set to MAX_ADDRESS, then SizeOfBuffer must be set to the maximum size

+  supported by TokenName and RETURN_INVALID_PARAMETER must be returned.

+  If TokenName is not a valid token in the token space, then the module will not build.

+

+  If SizeOfBuffer is NULL, then ASSERT().

+  If SizeOfBuffer > 0 and Buffer is NULL, then ASSERT().

+

+  @param TokenName      The name of the PCD token to set the current value for.

+  @param SizeOfBuffer   A pointer to the size, in bytes, of Buffer.

+  @param Buffer         A pointer to the buffer to set.

+

+  @return The status of the set operation.

+

+**/

+#define PcdSetPtrS(TokenName, SizeOfBuffer, Buffer) \

+                                            _PCD_SET_MODE_PTR_S_##TokenName   ((SizeOfBuffer), (Buffer))

+

+

+

+/**

+  Sets a boolean PCD token value based on a token name.

+

+  Sets the boolean value for the token specified by TokenName.

+  If TokenName is not a valid token in the token space, then the module will not build.

+

+  @param TokenName  The name of the PCD token to retrieve a current value for.

+  @param Value      The boolean value to set.

+

+  @return The status of the set operation.

+

+**/

+#define PcdSetBoolS(TokenName, Value)       _PCD_SET_MODE_BOOL_S_##TokenName    ((Value))

+

+/**

+  Retrieves a token number based on a GUID and a token name.

+

+  Returns the token number for the token specified by Guid and TokenName.

+  If TokenName is not a valid token in the token space, then the module will not build.

+

+  @param   Guid        Pointer to a 128-bit unique value that designates

+                       which namespace to retrieve a value from.

+  @param   TokenName   The name of the PCD token to retrieve a current value for.

+

+  @return  Return the token number.

+

+**/

+#define PcdTokenEx(Guid,TokenName)  _PCD_TOKEN_EX_##TokenName(Guid)

+

+/**

+  Retrieves an 8-bit PCD token value based on a GUID and a token name.

+

+  Returns the 8-bit value for the token specified by Guid and TokenName.

+  If TokenName is not a valid token in the token space specified by Guid,

+  then the module will not build.

+

+  If Guid is NULL, then ASSERT().

+

+  @param   Guid        Pointer to a 128-bit unique value that designates

+                       which namespace to retrieve a value from.

+  @param   TokenName   The name of the PCD token to retrieve a current value for.

+

+  @return  An 8-bit PCD token value.

+

+**/

+#define PcdGetEx8(Guid, TokenName)          LibPcdGetEx8 ((Guid), PcdTokenEx(Guid,TokenName))

+

+/**

+  Retrieves a 16-bit PCD token value based on a GUID and a token name.

+

+  Returns the 16-bit value for the token specified by Guid and TokenName.

+  If TokenName is not a valid token in the token space specified by Guid,

+  then the module will not build.

+

+  If Guid is NULL, then ASSERT().

+

+  @param   Guid        Pointer to a 128-bit unique value that designates

+                       which namespace to retrieve a value from.

+  @param   TokenName   The name of the PCD token to retrieve a current value for.

+

+  @return  A 16-bit PCD token value.

+

+**/

+#define PcdGetEx16(Guid, TokenName)         LibPcdGetEx16 ((Guid), PcdTokenEx(Guid,TokenName))

+

+

+/**

+  Retrieves a 32-bit PCD token value based on a GUID and a token name.

+

+  Returns the 32-bit value for the token specified by Guid and TokenName.

+  If TokenName is not a valid token in the token space specified by Guid,

+  then the module will not build.

+

+  If Guid is NULL, then ASSERT().

+

+  @param   Guid        Pointer to a 128-bit unique value that designates

+                       which namespace to retrieve a value from.

+  @param   TokenName   The name of the PCD token to retrieve a current value for.

+

+  @return  A 32-bit PCD token value.

+

+**/

+#define PcdGetEx32(Guid, TokenName)         LibPcdGetEx32 ((Guid), PcdTokenEx(Guid,TokenName))

+

+

+/**

+  Retrieves a 64-bit PCD token value based on a GUID and a token name.

+

+  Returns the 64-bit value for the token specified by Guid and TokenName.

+  If TokenName is not a valid token in the token space specified by Guid,

+  then the module will not build.

+

+  If Guid is NULL, then ASSERT().

+

+  @param   Guid        Pointer to a 128-bit unique value that designates

+                       which namespace to retrieve a value from.

+  @param   TokenName   The name of the PCD token to retrieve a current value for.

+

+  @return  A 64-bit PCD token value.

+

+**/

+#define PcdGetEx64(Guid, TokenName)         LibPcdGetEx64 ((Guid), PcdTokenEx(Guid,TokenName))

+

+

+/**

+  Retrieves a pointer to a PCD token buffer based on a GUID and a token name.

+

+  Returns a pointer to the buffer for the token specified by Guid and TokenName.

+  If TokenName is not a valid token in the token space specified by Guid,

+  then the module will not build.

+

+  If Guid is NULL, then ASSERT().

+

+  @param   Guid        Pointer to a 128-bit unique value that designates

+                       which namespace to retrieve a value from.

+  @param   TokenName   The name of the PCD token to retrieve a current value for.

+

+  @return  A pointer to a PCD token buffer.

+

+**/

+#define PcdGetExPtr(Guid, TokenName)        LibPcdGetExPtr ((Guid), PcdTokenEx(Guid,TokenName))

+

+

+/**

+  Retrieves a Boolean PCD token value based on a GUID and a token name.

+

+  Returns the Boolean value for the token specified by Guid and TokenName.

+  If TokenName is not a valid token in the token space specified by Guid,

+  then the module will not build.

+

+  If Guid is NULL, then ASSERT().

+

+  @param   Guid        Pointer to a 128-bit unique value that designates

+                       which namespace to retrieve a value from.

+  @param   TokenName   The name of the PCD token to retrieve a current value for.

+

+  @return  A Boolean PCD token value.

+

+**/

+#define PcdGetExBool(Guid, TokenName)       LibPcdGetExBool  ((Guid), PcdTokenEx(Guid,TokenName))

+

+

+

+/**

+  Sets an 8-bit PCD token value based on a GUID and a token name.

+

+  Sets the 8-bit value for the token specified by Guid and TokenName.

+  If TokenName is not a valid token in the token space specified by Guid,

+  then the module will not build.

+

+  If Guid is NULL, then ASSERT().

+

+  @param Guid       Pointer to a 128-bit unique value that designates

+                    which namespace to retrieve a value from.

+  @param TokenName  The name of the PCD token to set the current value for.

+  @param Value      The 8-bit value to set.

+

+  @return The status of the set operation.

+

+**/

+#define PcdSetEx8S(Guid, TokenName, Value)     LibPcdSetEx8S ((Guid), PcdTokenEx(Guid,TokenName), (Value))

+

+/**

+  Sets an 16-bit PCD token value based on a GUID and a token name.

+

+  Sets the 16-bit value for the token specified by Guid and TokenName.

+  If TokenName is not a valid token in the token space specified by Guid,

+  then the module will not build.

+

+  If Guid is NULL, then ASSERT().

+

+  @param Guid       Pointer to a 128-bit unique value that designates

+                    which namespace to retrieve a value from.

+  @param TokenName  The name of the PCD token to set the current value for.

+  @param Value      The 16-bit value to set.

+

+  @return The status of the set operation.

+

+**/

+#define PcdSetEx16S(Guid, TokenName, Value)    LibPcdSetEx16S ((Guid), PcdTokenEx(Guid,TokenName), (Value))

+

+/**

+  Sets an 32-bit PCD token value based on a GUID and a token name.

+

+  Sets the 32-bit value for the token specified by Guid and TokenName.

+  If TokenName is not a valid token in the token space specified by Guid,

+  then the module will not build.

+

+  If Guid is NULL, then ASSERT().

+

+  @param Guid       Pointer to a 128-bit unique value that designates

+                    which namespace to retrieve a value from.

+  @param TokenName  The name of the PCD token to set the current value for.

+  @param Value      The 32-bit value to set.

+

+  @return The status of the set operation.

+

+**/

+#define PcdSetEx32S(Guid, TokenName, Value)    LibPcdSetEx32S ((Guid), PcdTokenEx(Guid,TokenName), (Value))

+

+/**

+  Sets an 64-bit PCD token value based on a GUID and a token name.

+

+  Sets the 64-bit value for the token specified by Guid and TokenName.

+  If TokenName is not a valid token in the token space specified by Guid,

+  then the module will not build.

+

+  If Guid is NULL, then ASSERT().

+

+  @param Guid       Pointer to a 128-bit unique value that designates

+                    which namespace to retrieve a value from.

+  @param TokenName  The name of the PCD token to set the current value for.

+  @param Value      The 64-bit value to set.

+

+  @return The status of the set operation.

+

+**/

+#define PcdSetEx64S(Guid, TokenName, Value)    LibPcdSetEx64S ((Guid), PcdTokenEx(Guid,TokenName), (Value))

+

+/**

+  Sets a pointer to a PCD token buffer based on a GUID and a token name.

+

+  Sets the buffer for the token specified by Guid and TokenName.

+  If SizeOfBuffer is greater than the maximum size supported by Guid and TokenName,

+  then set SizeOfBuffer to the maximum size supported by Guid and TokenName and return

+  RETURN_INVALID_PARAMETER to indicate that the set operation was not actually performed.

+  If SizeOfBuffer is set to MAX_ADDRESS, then SizeOfBuffer must be set to the maximum size

+  supported by Guid and TokenName and RETURN_INVALID_PARAMETER must be returned.

+  If TokenName is not a valid token in the token space specified by Guid,

+  then the module will not build.

+

+  If Guid is NULL, then ASSERT().

+  If SizeOfBuffer is NULL, then ASSERT().

+  If SizeOfBuffer > 0 and Buffer is NULL, then ASSERT().

+

+  @param Guid           Pointer to a 128-bit unique value that designates

+                        which namespace to retrieve a value from.

+  @param TokenName      The name of the PCD token to set the current value for.

+  @param SizeOfBuffer   A pointer to the size, in bytes, of Buffer.

+  @param Buffer         Pointer to the buffer to set.

+

+  @return The status of the set operation.

+

+**/

+#define PcdSetExPtrS(Guid, TokenName, SizeOfBuffer, Buffer) \

+                                            LibPcdSetExPtrS ((Guid), PcdTokenEx(Guid,TokenName), (SizeOfBuffer), (Buffer))

+

+

+/**

+  Sets an boolean PCD token value based on a GUID and a token name.

+

+  Sets the boolean value for the token specified by Guid and TokenName.

+  If TokenName is not a valid token in the token space specified by Guid,

+  then the module will not build.

+

+  If Guid is NULL, then ASSERT().

+

+  @param Guid       Pointer to a 128-bit unique value that designates

+                    which namespace to retrieve a value from.

+  @param TokenName  The name of the PCD token to set the current value for.

+  @param Value      The boolean value to set.

+

+  @return The status of the set operation.

+

+**/

+#define PcdSetExBoolS(Guid, TokenName, Value) \

+                                            LibPcdSetExBoolS ((Guid), PcdTokenEx(Guid,TokenName), (Value))

+

+/**

+  This function provides a means by which SKU support can be established in the PCD infrastructure.

+

+  Sets the current SKU in the PCD database to the value specified by SkuId.  SkuId is returned.

+

+  @param  SkuId   The SKU value that will be used when the PCD service retrieves and sets values

+                  associated with a PCD token.

+

+  @return  Return the SKU ID that was set.

+

+**/

+UINTN

+EFIAPI

+LibPcdSetSku (

+  IN UINTN   SkuId

+  );

+

+

+/**

+  This function provides a means by which to retrieve a value for a given PCD token.

+

+  Returns the 8-bit value for the token specified by TokenNumber.

+

+  @param[in]  TokenNumber The PCD token number to retrieve a current value for.

+

+  @return Returns the 8-bit value for the token specified by TokenNumber.

+

+**/

+UINT8

+EFIAPI

+LibPcdGet8 (

+  IN UINTN             TokenNumber

+  );

+

+

+/**

+  This function provides a means by which to retrieve a value for a given PCD token.

+

+  Returns the 16-bit value for the token specified by TokenNumber.

+

+  @param[in]  TokenNumber The PCD token number to retrieve a current value for.

+

+  @return Returns the 16-bit value for the token specified by TokenNumber.

+

+**/

+UINT16

+EFIAPI

+LibPcdGet16 (

+  IN UINTN             TokenNumber

+  );

+

+

+/**

+  This function provides a means by which to retrieve a value for a given PCD token.

+

+  Returns the 32-bit value for the token specified by TokenNumber.

+

+  @param[in]  TokenNumber The PCD token number to retrieve a current value for.

+

+  @return Returns the 32-bit value for the token specified by TokenNumber.

+

+**/

+UINT32

+EFIAPI

+LibPcdGet32 (

+  IN UINTN             TokenNumber

+  );

+

+

+/**

+  This function provides a means by which to retrieve a value for a given PCD token.

+

+  Returns the 64-bit value for the token specified by TokenNumber.

+

+  @param[in]  TokenNumber The PCD token number to retrieve a current value for.

+

+  @return Returns the 64-bit value for the token specified by TokenNumber.

+

+**/

+UINT64

+EFIAPI

+LibPcdGet64 (

+  IN UINTN             TokenNumber

+  );

+

+

+/**

+  This function provides a means by which to retrieve a value for a given PCD token.

+

+  Returns the pointer to the buffer of the token specified by TokenNumber.

+

+  @param[in]  TokenNumber The PCD token number to retrieve a current value for.

+

+  @return Returns the pointer to the token specified by TokenNumber.

+

+**/

+VOID *

+EFIAPI

+LibPcdGetPtr (

+  IN UINTN             TokenNumber

+  );

+

+

+/**

+  This function provides a means by which to retrieve a value for a given PCD token.

+

+  Returns the Boolean value of the token specified by TokenNumber.

+

+  @param[in]  TokenNumber The PCD token number to retrieve a current value for.

+

+  @return Returns the Boolean value of the token specified by TokenNumber.

+

+**/

+BOOLEAN

+EFIAPI

+LibPcdGetBool (

+  IN UINTN             TokenNumber

+  );

+

+

+/**

+  This function provides a means by which to retrieve the size of a given PCD token.

+

+  @param[in]  TokenNumber The PCD token number to retrieve a current value for.

+

+  @return Returns the size of the token specified by TokenNumber.

+

+**/

+UINTN

+EFIAPI

+LibPcdGetSize (

+  IN UINTN             TokenNumber

+  );

+

+

+/**

+  This function provides a means by which to retrieve a value for a given PCD token.

+

+  Returns the 8-bit value for the token specified by TokenNumber and Guid.

+

+  If Guid is NULL, then ASSERT().

+

+  @param[in]  Guid         Pointer to a 128-bit unique value that designates

+                           which namespace to retrieve a value from.

+  @param[in]  TokenNumber  The PCD token number to retrieve a current value for.

+

+  @return Return the UINT8.

+

+**/

+UINT8

+EFIAPI

+LibPcdGetEx8 (

+  IN CONST GUID        *Guid,

+  IN UINTN             TokenNumber

+  );

+

+

+/**

+  This function provides a means by which to retrieve a value for a given PCD token.

+

+  Returns the 16-bit value for the token specified by TokenNumber and Guid.

+

+  If Guid is NULL, then ASSERT().

+

+  @param[in]  Guid         Pointer to a 128-bit unique value that designates

+                           which namespace to retrieve a value from.

+  @param[in]  TokenNumber  The PCD token number to retrieve a current value for.

+

+  @return Return the UINT16.

+

+**/

+UINT16

+EFIAPI

+LibPcdGetEx16 (

+  IN CONST GUID        *Guid,

+  IN UINTN             TokenNumber

+  );

+

+

+/**

+  Returns the 32-bit value for the token specified by TokenNumber and Guid.

+  If Guid is NULL, then ASSERT().

+

+  @param[in]  Guid         Pointer to a 128-bit unique value that designates

+                           which namespace to retrieve a value from.

+  @param[in]  TokenNumber  The PCD token number to retrieve a current value for.

+

+  @return Return the UINT32.

+

+**/

+UINT32

+EFIAPI

+LibPcdGetEx32 (

+  IN CONST GUID        *Guid,

+  IN UINTN             TokenNumber

+  );

+

+

+/**

+  This function provides a means by which to retrieve a value for a given PCD token.

+

+  Returns the 64-bit value for the token specified by TokenNumber and Guid.

+

+  If Guid is NULL, then ASSERT().

+

+  @param[in]  Guid          Pointer to a 128-bit unique value that designates

+                            which namespace to retrieve a value from.

+  @param[in]  TokenNumber   The PCD token number to retrieve a current value for.

+

+  @return Return the UINT64.

+

+**/

+UINT64

+EFIAPI

+LibPcdGetEx64 (

+  IN CONST GUID        *Guid,

+  IN UINTN             TokenNumber

+  );

+

+

+/**

+  This function provides a means by which to retrieve a value for a given PCD token.

+

+  Returns the pointer to the buffer of token specified by TokenNumber and Guid.

+

+  If Guid is NULL, then ASSERT().

+

+  @param[in]  Guid          Pointer to a 128-bit unique value that designates

+                            which namespace to retrieve a value from.

+  @param[in]  TokenNumber   The PCD token number to retrieve a current value for.

+

+  @return Return the VOID* pointer.

+

+**/

+VOID *

+EFIAPI

+LibPcdGetExPtr (

+  IN CONST GUID        *Guid,

+  IN UINTN             TokenNumber

+  );

+

+

+/**

+  This function provides a means by which to retrieve a value for a given PCD token.

+

+  Returns the Boolean value of the token specified by TokenNumber and Guid.

+

+  If Guid is NULL, then ASSERT().

+

+  @param[in]  Guid          Pointer to a 128-bit unique value that designates

+                            which namespace to retrieve a value from.

+  @param[in]  TokenNumber   The PCD token number to retrieve a current value for.

+

+  @return Return the BOOLEAN.

+

+**/

+BOOLEAN

+EFIAPI

+LibPcdGetExBool (

+  IN CONST GUID        *Guid,

+  IN UINTN             TokenNumber

+  );

+

+

+/**

+  This function provides a means by which to retrieve the size of a given PCD token.

+

+  Returns the size of the token specified by TokenNumber and Guid.

+

+  If Guid is NULL, then ASSERT().

+

+  @param[in]  Guid          Pointer to a 128-bit unique value that designates

+                            which namespace to retrieve a value from.

+  @param[in]  TokenNumber   The PCD token number to retrieve a current value for.

+

+  @return Return the size.

+

+**/

+UINTN

+EFIAPI

+LibPcdGetExSize (

+  IN CONST GUID        *Guid,

+  IN UINTN             TokenNumber

+  );

+

+

+/**

+  This function provides a means by which to set a value for a given PCD token.

+

+  Sets the 8-bit value for the token specified by TokenNumber

+  to the value specified by Value.

+

+  @param[in] TokenNumber    The PCD token number to set a current value for.

+  @param[in] Value          The 8-bit value to set.

+

+  @return The status of the set operation.

+

+**/

+RETURN_STATUS

+EFIAPI

+LibPcdSet8S (

+  IN UINTN          TokenNumber,

+  IN UINT8          Value

+  );

+

+/**

+  This function provides a means by which to set a value for a given PCD token.

+

+  Sets the 16-bit value for the token specified by TokenNumber

+  to the value specified by Value.

+

+  @param[in] TokenNumber    The PCD token number to set a current value for.

+  @param[in] Value          The 16-bit value to set.

+

+  @return The status of the set operation.

+

+**/

+RETURN_STATUS

+EFIAPI

+LibPcdSet16S (

+  IN UINTN          TokenNumber,

+  IN UINT16         Value

+  );

+

+/**

+  This function provides a means by which to set a value for a given PCD token.

+

+  Sets the 32-bit value for the token specified by TokenNumber

+  to the value specified by Value.

+

+  @param[in] TokenNumber    The PCD token number to set a current value for.

+  @param[in] Value          The 32-bit value to set.

+

+  @return The status of the set operation.

+

+**/

+RETURN_STATUS

+EFIAPI

+LibPcdSet32S (

+  IN UINTN          TokenNumber,

+  IN UINT32         Value

+  );

+

+/**

+  This function provides a means by which to set a value for a given PCD token.

+

+  Sets the 64-bit value for the token specified by TokenNumber

+  to the value specified by Value.

+

+  @param[in] TokenNumber    The PCD token number to set a current value for.

+  @param[in] Value          The 64-bit value to set.

+

+  @return The status of the set operation.

+

+**/

+RETURN_STATUS

+EFIAPI

+LibPcdSet64S (

+  IN UINTN          TokenNumber,

+  IN UINT64         Value

+  );

+

+/**

+  This function provides a means by which to set a value for a given PCD token.

+

+  Sets a buffer for the token specified by TokenNumber to the value specified

+  by Buffer and SizeOfBuffer. If SizeOfBuffer is greater than the maximum size

+  support by TokenNumber, then set SizeOfBuffer to the maximum size supported by

+  TokenNumber and return RETURN_INVALID_PARAMETER to indicate that the set operation

+  was not actually performed.

+

+  If SizeOfBuffer is set to MAX_ADDRESS, then SizeOfBuffer must be set to the

+  maximum size supported by TokenName and RETURN_INVALID_PARAMETER must be returned.

+

+  If SizeOfBuffer is NULL, then ASSERT().

+  If SizeOfBuffer > 0 and Buffer is NULL, then ASSERT().

+

+  @param[in]      TokenNumber   The PCD token number to set a current value for.

+  @param[in, out] SizeOfBuffer  The size, in bytes, of Buffer.

+  @param[in]      Buffer        A pointer to the buffer to set.

+

+  @return The status of the set operation.

+

+**/

+RETURN_STATUS

+EFIAPI

+LibPcdSetPtrS (

+  IN       UINTN    TokenNumber,

+  IN OUT   UINTN    *SizeOfBuffer,

+  IN CONST VOID     *Buffer

+  );

+

+/**

+  This function provides a means by which to set a value for a given PCD token.

+

+  Sets the boolean value for the token specified by TokenNumber

+  to the value specified by Value.

+

+  @param[in] TokenNumber    The PCD token number to set a current value for.

+  @param[in] Value          The boolean value to set.

+

+  @return The status of the set operation.

+

+**/

+RETURN_STATUS

+EFIAPI

+LibPcdSetBoolS (

+  IN UINTN          TokenNumber,

+  IN BOOLEAN        Value

+  );

+

+/**

+  This function provides a means by which to set a value for a given PCD token.

+

+  Sets the 8-bit value for the token specified by TokenNumber

+  to the value specified by Value.

+

+  If Guid is NULL, then ASSERT().

+

+  @param[in] Guid           The pointer to a 128-bit unique value that

+                            designates which namespace to set a value from.

+  @param[in] TokenNumber    The PCD token number to set a current value for.

+  @param[in] Value          The 8-bit value to set.

+

+  @return The status of the set operation.

+

+**/

+RETURN_STATUS

+EFIAPI

+LibPcdSetEx8S (

+  IN CONST GUID     *Guid,

+  IN UINTN          TokenNumber,

+  IN UINT8          Value

+  );

+

+/**

+  This function provides a means by which to set a value for a given PCD token.

+

+  Sets the 16-bit value for the token specified by TokenNumber

+  to the value specified by Value.

+

+  If Guid is NULL, then ASSERT().

+

+  @param[in] Guid           The pointer to a 128-bit unique value that

+                            designates which namespace to set a value from.

+  @param[in] TokenNumber    The PCD token number to set a current value for.

+  @param[in] Value          The 16-bit value to set.

+

+  @return The status of the set operation.

+

+**/

+RETURN_STATUS

+EFIAPI

+LibPcdSetEx16S (

+  IN CONST GUID     *Guid,

+  IN UINTN          TokenNumber,

+  IN UINT16         Value

+  );

+

+/**

+  This function provides a means by which to set a value for a given PCD token.

+

+  Sets the 32-bit value for the token specified by TokenNumber

+  to the value specified by Value.

+

+  If Guid is NULL, then ASSERT().

+

+  @param[in] Guid           The pointer to a 128-bit unique value that

+                            designates which namespace to set a value from.

+  @param[in] TokenNumber    The PCD token number to set a current value for.

+  @param[in] Value          The 32-bit value to set.

+

+  @return The status of the set operation.

+

+**/

+RETURN_STATUS

+EFIAPI

+LibPcdSetEx32S (

+  IN CONST GUID     *Guid,

+  IN UINTN          TokenNumber,

+  IN UINT32         Value

+  );

+

+/**

+  This function provides a means by which to set a value for a given PCD token.

+

+  Sets the 64-bit value for the token specified by TokenNumber

+  to the value specified by Value.

+

+  If Guid is NULL, then ASSERT().

+

+  @param[in] Guid           The pointer to a 128-bit unique value that

+                            designates which namespace to set a value from.

+  @param[in] TokenNumber    The PCD token number to set a current value for.

+  @param[in] Value          The 64-bit value to set.

+

+  @return The status of the set operation.

+

+**/

+RETURN_STATUS

+EFIAPI

+LibPcdSetEx64S (

+  IN CONST GUID     *Guid,

+  IN UINTN          TokenNumber,

+  IN UINT64         Value

+  );

+

+/**

+  This function provides a means by which to set a value for a given PCD token.

+

+  Sets a buffer for the token specified by TokenNumber to the value specified by

+  Buffer and SizeOfBuffer. If SizeOfBuffer is greater than the maximum size

+  support by TokenNumber, then set SizeOfBuffer to the maximum size supported by

+  TokenNumber and return RETURN_INVALID_PARAMETER to indicate that the set operation

+  was not actually performed.

+

+  If Guid is NULL, then ASSERT().

+  If SizeOfBuffer is NULL, then ASSERT().

+  If SizeOfBuffer > 0 and Buffer is NULL, then ASSERT().

+

+  @param[in]      Guid          Pointer to a 128-bit unique value that

+                                designates which namespace to set a value from.

+  @param[in]      TokenNumber   The PCD token number to set a current value for.

+  @param[in, out] SizeOfBuffer  The size, in bytes, of Buffer.

+  @param[in]      Buffer        A pointer to the buffer to set.

+

+  @return The status of the set operation.

+

+**/

+RETURN_STATUS

+EFIAPI

+LibPcdSetExPtrS (

+  IN CONST GUID     *Guid,

+  IN       UINTN    TokenNumber,

+  IN OUT   UINTN    *SizeOfBuffer,

+  IN       VOID     *Buffer

+  );

+

+/**

+  This function provides a means by which to set a value for a given PCD token.

+

+  Sets the boolean value for the token specified by TokenNumber

+  to the value specified by Value.

+

+  If Guid is NULL, then ASSERT().

+

+  @param[in] Guid           The pointer to a 128-bit unique value that

+                            designates which namespace to set a value from.

+  @param[in] TokenNumber    The PCD token number to set a current value for.

+  @param[in] Value          The boolean value to set.

+

+  @return The status of the set operation.

+

+**/

+RETURN_STATUS

+EFIAPI

+LibPcdSetExBoolS (

+  IN CONST GUID     *Guid,

+  IN UINTN          TokenNumber,

+  IN BOOLEAN        Value

+  );

+

+/**

+  This notification function serves two purposes.

+

+  Firstly, it notifies the module that did the registration that the value of this

+  PCD token has been set.

+  Secondly, it provides a mechanism for the module that did the registration to intercept

+  the set operation and override the value been set if necessary. After the invocation of

+  the callback function, TokenData will be used by PCD service PEIM or driver to modify th

+  internal data in PCD database.

+

+  @param[in]      CallBackGuid    The PCD token GUID being set.

+  @param[in]      CallBackToken   The PCD token number being set.

+  @param[in, out] TokenData       A pointer to the token data being set.

+  @param[in]      TokenDataSize   The size, in bytes, of the data being set.

+

+**/

+typedef

+VOID

+(EFIAPI *PCD_CALLBACK)(

+  IN        CONST GUID        *CallBackGuid, OPTIONAL

+  IN        UINTN             CallBackToken,

+  IN  OUT   VOID              *TokenData,

+  IN        UINTN             TokenDataSize

+  );

+

+

+/**

+  Set up a notification function that is called when a specified token is set.

+

+  When the token specified by TokenNumber and Guid is set,

+  then notification function specified by NotificationFunction is called.

+  If Guid is NULL, then the default token space is used.

+  If NotificationFunction is NULL, then ASSERT().

+

+  @param[in]  Guid                  Pointer to a 128-bit unique value that designates which

+                                    namespace to set a value from.  If NULL, then the default

+                                    token space is used.

+  @param[in]  TokenNumber           The PCD token number to monitor.

+  @param[in]  NotificationFunction  The function to call when the token

+                                    specified by Guid and TokenNumber is set.

+

+**/

+VOID

+EFIAPI

+LibPcdCallbackOnSet (

+  IN CONST GUID               *Guid,       OPTIONAL

+  IN UINTN                    TokenNumber,

+  IN PCD_CALLBACK             NotificationFunction

+  );

+

+

+/**

+  Disable a notification function that was established with LibPcdCallbackonSet().

+

+  Disable a notification function that was previously established with LibPcdCallbackOnSet().

+  If NotificationFunction is NULL, then ASSERT().

+  If LibPcdCallbackOnSet() was not previously called with Guid, TokenNumber,

+  and NotificationFunction, then ASSERT().

+

+  @param[in]  Guid                 Specify the GUID token space.

+  @param[in]  TokenNumber          Specify the token number.

+  @param[in]  NotificationFunction The callback function to be unregistered.

+

+**/

+VOID

+EFIAPI

+LibPcdCancelCallback (

+  IN CONST GUID               *Guid,       OPTIONAL

+  IN UINTN                    TokenNumber,

+  IN PCD_CALLBACK             NotificationFunction

+  );

+

+

+/**

+  Retrieves the next token in a token space.

+

+  Retrieves the next PCD token number from the token space specified by Guid.

+  If Guid is NULL, then the default token space is used.  If TokenNumber is 0,

+  then the first token number is returned.  Otherwise, the token number that

+  follows TokenNumber in the token space is returned.  If TokenNumber is the last

+  token number in the token space, then 0 is returned.

+

+  If TokenNumber is not 0 and is not in the token space specified by Guid, then ASSERT().

+

+  @param[in]  Guid        Pointer to a 128-bit unique value that designates which namespace

+                          to set a value from.  If NULL, then the default token space is used.

+  @param[in]  TokenNumber The previous PCD token number.  If 0, then retrieves the first PCD

+                          token number.

+

+  @return The next valid token number.

+

+**/

+UINTN

+EFIAPI

+LibPcdGetNextToken (

+  IN CONST GUID               *Guid,       OPTIONAL

+  IN UINTN                    TokenNumber

+  );

+

+

+

+/**

+  Used to retrieve the list of available PCD token space GUIDs.

+

+  Returns the PCD token space GUID that follows TokenSpaceGuid in the list of token spaces

+  in the platform.

+  If TokenSpaceGuid is NULL, then a pointer to the first PCD token spaces returned.

+  If TokenSpaceGuid is the last PCD token space GUID in the list, then NULL is returned.

+

+  @param  TokenSpaceGuid  Pointer to the a PCD token space GUID

+

+  @return The next valid token namespace.

+

+**/

+GUID *

+EFIAPI

+LibPcdGetNextTokenSpace (

+  IN CONST GUID  *TokenSpaceGuid

+  );

+

+

+/**

+  Sets a value of a patchable PCD entry that is type pointer.

+

+  Sets the PCD entry specified by PatchVariable to the value specified by Buffer

+  and SizeOfBuffer.  Buffer is returned.  If SizeOfBuffer is greater than

+  MaximumDatumSize, then set SizeOfBuffer to MaximumDatumSize and return

+  NULL to indicate that the set operation was not actually performed.

+  If SizeOfBuffer is set to MAX_ADDRESS, then SizeOfBuffer must be set to

+  MaximumDatumSize and NULL must be returned.

+

+  If PatchVariable is NULL, then ASSERT().

+  If SizeOfBuffer is NULL, then ASSERT().

+  If SizeOfBuffer > 0 and Buffer is NULL, then ASSERT().

+

+  @param[out] PatchVariable     A pointer to the global variable in a module that is

+                                the target of the set operation.

+  @param[in] MaximumDatumSize   The maximum size allowed for the PCD entry specified by PatchVariable.

+  @param[in, out] SizeOfBuffer  A pointer to the size, in bytes, of Buffer.

+  @param[in] Buffer             A pointer to the buffer to used to set the target variable.

+

+  @return Return the pointer to the Buffer that was set.

+

+**/

+VOID *

+EFIAPI

+LibPatchPcdSetPtr (

+  OUT        VOID       *PatchVariable,

+  IN        UINTN       MaximumDatumSize,

+  IN OUT    UINTN       *SizeOfBuffer,

+  IN CONST  VOID        *Buffer

+  );

+

+/**

+  Sets a value of a patchable PCD entry that is type pointer.

+

+  Sets the PCD entry specified by PatchVariable to the value specified

+  by Buffer and SizeOfBuffer. If SizeOfBuffer is greater than MaximumDatumSize,

+  then set SizeOfBuffer to MaximumDatumSize and return RETURN_INVALID_PARAMETER

+  to indicate that the set operation was not actually performed.

+  If SizeOfBuffer is set to MAX_ADDRESS, then SizeOfBuffer must be set to

+  MaximumDatumSize and RETURN_INVALID_PARAMETER must be returned.

+

+  If PatchVariable is NULL, then ASSERT().

+  If SizeOfBuffer is NULL, then ASSERT().

+  If SizeOfBuffer > 0 and Buffer is NULL, then ASSERT().

+

+  @param[out] PatchVariable     A pointer to the global variable in a module that is

+                                the target of the set operation.

+  @param[in] MaximumDatumSize   The maximum size allowed for the PCD entry specified by PatchVariable.

+  @param[in, out] SizeOfBuffer  A pointer to the size, in bytes, of Buffer.

+  @param[in] Buffer             A pointer to the buffer to used to set the target variable.

+

+  @return The status of the set operation.

+

+**/

+RETURN_STATUS

+EFIAPI

+LibPatchPcdSetPtrS (

+  OUT      VOID     *PatchVariable,

+  IN       UINTN    MaximumDatumSize,

+  IN OUT   UINTN    *SizeOfBuffer,

+  IN CONST VOID     *Buffer

+  );

+

+/**

+  Sets a value and size of a patchable PCD entry that is type pointer.

+

+  Sets the PCD entry specified by PatchVariable to the value specified by Buffer

+  and SizeOfBuffer. Buffer is returned.  If SizeOfBuffer is greater than

+  MaximumDatumSize, then set SizeOfBuffer to MaximumDatumSize and return

+  NULL to indicate that the set operation was not actually performed.

+  If SizeOfBuffer is set to MAX_ADDRESS, then SizeOfBuffer must be set to

+  MaximumDatumSize and NULL must be returned.

+

+  If PatchVariable is NULL, then ASSERT().

+  If SizeOfPatchVariable is NULL, then ASSERT().

+  If SizeOfBuffer is NULL, then ASSERT().

+  If SizeOfBuffer > 0 and Buffer is NULL, then ASSERT().

+

+  @param[out] PatchVariable     A pointer to the global variable in a module that is

+                                the target of the set operation.

+  @param[out] SizeOfPatchVariable A pointer to the size, in bytes, of PatchVariable.

+  @param[in] MaximumDatumSize   The maximum size allowed for the PCD entry specified by PatchVariable.

+  @param[in, out] SizeOfBuffer  A pointer to the size, in bytes, of Buffer.

+  @param[in] Buffer             A pointer to the buffer to used to set the target variable.

+

+  @return Return the pointer to the Buffer that was set.

+

+**/

+VOID *

+EFIAPI

+LibPatchPcdSetPtrAndSize (

+  OUT       VOID        *PatchVariable,

+  OUT       UINTN       *SizeOfPatchVariable,

+  IN        UINTN       MaximumDatumSize,

+  IN OUT    UINTN       *SizeOfBuffer,

+  IN CONST  VOID        *Buffer

+  );

+

+/**

+  Sets a value and size of a patchable PCD entry that is type pointer.

+

+  Sets the PCD entry specified by PatchVariable to the value specified

+  by Buffer and SizeOfBuffer. If SizeOfBuffer is greater than MaximumDatumSize,

+  then set SizeOfBuffer to MaximumDatumSize and return RETURN_INVALID_PARAMETER

+  to indicate that the set operation was not actually performed.

+  If SizeOfBuffer is set to MAX_ADDRESS, then SizeOfBuffer must be set to

+  MaximumDatumSize and RETURN_INVALID_PARAMETER must be returned.

+

+  If PatchVariable is NULL, then ASSERT().

+  If SizeOfPatchVariable is NULL, then ASSERT().

+  If SizeOfBuffer is NULL, then ASSERT().

+  If SizeOfBuffer > 0 and Buffer is NULL, then ASSERT().

+

+  @param[out] PatchVariable     A pointer to the global variable in a module that is

+                                the target of the set operation.

+  @param[out] SizeOfPatchVariable A pointer to the size, in bytes, of PatchVariable.

+  @param[in] MaximumDatumSize   The maximum size allowed for the PCD entry specified by PatchVariable.

+  @param[in, out] SizeOfBuffer  A pointer to the size, in bytes, of Buffer.

+  @param[in] Buffer             A pointer to the buffer to used to set the target variable.

+

+  @return The status of the set operation.

+

+**/

+RETURN_STATUS

+EFIAPI

+LibPatchPcdSetPtrAndSizeS (

+  OUT      VOID     *PatchVariable,

+  OUT      UINTN    *SizeOfPatchVariable,

+  IN       UINTN    MaximumDatumSize,

+  IN OUT   UINTN    *SizeOfBuffer,

+  IN CONST VOID     *Buffer

+  );

+

+typedef enum {

+  PCD_TYPE_8,

+  PCD_TYPE_16,

+  PCD_TYPE_32,

+  PCD_TYPE_64,

+  PCD_TYPE_BOOL,

+  PCD_TYPE_PTR

+} PCD_TYPE;

+

+typedef struct {

+  ///

+  /// The returned information associated with the requested TokenNumber. If

+  /// TokenNumber is 0, then PcdType is set to PCD_TYPE_8.

+  ///

+  PCD_TYPE          PcdType;

+  ///

+  /// The size of the data in bytes associated with the TokenNumber specified. If

+  /// TokenNumber is 0, then PcdSize is set 0.

+  ///

+  UINTN             PcdSize;

+  ///

+  /// The null-terminated ASCII string associated with a given token. If the

+  /// TokenNumber specified was 0, then this field corresponds to the null-terminated

+  /// ASCII string associated with the token's namespace Guid. If NULL, there is no

+  /// name associated with this request.

+  ///

+  CHAR8             *PcdName;

+} PCD_INFO;

+

+

+/**

+  Retrieve additional information associated with a PCD token.

+

+  This includes information such as the type of value the TokenNumber is associated with as well as possible

+  human readable name that is associated with the token.

+

+  If TokenNumber is not in the default token space specified, then ASSERT().

+

+  @param[in]    TokenNumber The PCD token number.

+  @param[out]   PcdInfo     The returned information associated with the requested TokenNumber.

+                            The caller is responsible for freeing the buffer that is allocated by callee for PcdInfo->PcdName.

+**/

+VOID

+EFIAPI

+LibPcdGetInfo (

+  IN        UINTN           TokenNumber,

+  OUT       PCD_INFO        *PcdInfo

+  );

+

+/**

+  Retrieve additional information associated with a PCD token.

+

+  This includes information such as the type of value the TokenNumber is associated with as well as possible

+  human readable name that is associated with the token.

+

+  If TokenNumber is not in the token space specified by Guid, then ASSERT().

+

+  @param[in]    Guid        The 128-bit unique value that designates the namespace from which to extract the value.

+  @param[in]    TokenNumber The PCD token number.

+  @param[out]   PcdInfo     The returned information associated with the requested TokenNumber.

+                            The caller is responsible for freeing the buffer that is allocated by callee for PcdInfo->PcdName.

+**/

+VOID

+EFIAPI

+LibPcdGetInfoEx (

+  IN CONST  GUID            *Guid,

+  IN        UINTN           TokenNumber,

+  OUT       PCD_INFO        *PcdInfo

+  );

+

+/**

+  Retrieve the currently set SKU Id.

+

+  @return   The currently set SKU Id. If the platform has not set at a SKU Id, then the

+            default SKU Id value of 0 is returned. If the platform has set a SKU Id, then the currently set SKU

+            Id is returned.

+**/

+UINTN

+EFIAPI

+LibPcdGetSku (

+  VOID

+  );

+

+#endif

diff --git a/debugging_demo/memtest86+/efi/Include/Library/PrintLib.h b/debugging_demo/memtest86+/efi/Include/Library/PrintLib.h
new file mode 100644
index 0000000..0b38da6
--- /dev/null
+++ b/debugging_demo/memtest86+/efi/Include/Library/PrintLib.h
@@ -0,0 +1,935 @@
+/** @file

+  Provides services to print a formatted string to a buffer. All combinations of

+  Unicode and ASCII strings are supported.

+

+Copyright (c) 2006 - 2018, Intel Corporation. All rights reserved.<BR>

+SPDX-License-Identifier: BSD-2-Clause-Patent

+

+  The Print Library functions provide a simple means to produce formatted output

+  strings.  Many of the output functions use a format string to describe how to

+  format the output of variable arguments.  The format string consists of normal

+  text and argument descriptors.  There are no restrictions for how the normal

+  text and argument descriptors can be mixed.  The following end of line(EOL)

+  translations must be performed on the contents of the format string:

+

+     - '\\r' is translated to '\\r'

+     - '\\r\\n' is translated to '\\r\\n'

+     - '\\n' is translated to '\\r\\n'

+     - '\\n\\r' is translated to '\\r\\n'

+

+  This does not follow the ANSI C standard for sprint().  The format of argument

+  descriptors is described below.  The ANSI C standard for sprint() has been

+  followed for some of the format types, and has not been followed for others.

+  The exceptions are noted below.

+

+    %[flags][width][.precision]type

+

+  [flags]:

+    - -

+      - The field is left justified.  If not flag is not specified, then the

+        field is right justified.

+    - space

+      - Prefix a space character to a number.  Only valid for types X, x, and d.

+    - +

+      - Prefix a plus character to a number.  Only valid for types X, x, and d.

+        If both space and + are specified, then space is ignored.

+    - 0

+      - Pad with 0 characters to the left of a number.  Only valid for types

+        X, x, and d.

+    - ,

+      - Place a comma every 3rd digit of the number.  Only valid for type d.

+        If 0 is also specified, then 0 is ignored.

+    - L, l

+      - The number being printed is size UINT64.  Only valid for types X, x, and d.

+        If this flag is not specified, then the number being printed is size int.

+    - NOTE: All invalid flags are ignored.

+

+  [width]:

+

+    - *

+      - The width of the field is specified by a UINTN argument in the

+        argument list.

+    - number

+      - The number specified as a decimal value represents the width of

+        the field.

+    - NOTE: If [width] is not specified, then a field width of 0 is assumed.

+

+  [.precision]:

+

+    - *

+      - The precision of the field is specified by a UINTN argument in the

+        argument list.

+    - number

+      - The number specified as a decimal value represents the precision of

+        the field.

+    - NOTE: If [.precision] is not specified, then a precision of 0 is assumed.

+

+  type:

+

+    - %

+      - Print a %%.

+    - c

+      - The argument is a Unicode character.  ASCII characters can be printed

+        using this type too by making sure bits 8..15 of the argument are set to 0.

+    - x

+      - The argument is an unsigned hexadecimal number.  The characters used are 0..9 and

+        A..F.  If the flag 'L' is not specified, then the argument is assumed

+        to be size int.  This does not follow ANSI C.

+    - X

+      - The argument is an unsigned hexadecimal number and the number is padded with

+        zeros.  This is equivalent to a format string of "0x". If the flag

+        'L' is not specified, then the argument is assumed to be size int.

+        This does not follow ANSI C.

+    - d

+      - The argument is a signed decimal number.  If the flag 'L' is not specified,

+        then the argument is assumed to be size int.

+    - u

+      - The argument is a unsigned decimal number.  If the flag 'L' is not specified,

+        then the argument is assumed to be size int.

+    - p

+      - The argument is a pointer that is a (VOID *), and it is printed as an

+        unsigned hexadecimal number  The characters used are 0..9 and A..F.

+    - a

+      - The argument is a pointer to an ASCII string.

+        This does not follow ANSI C.

+    - S, s

+      - The argument is a pointer to a Unicode string.

+        This does not follow ANSI C.

+    - g

+      - The argument is a pointer to a GUID structure.  The GUID is printed

+        in the format XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX.

+        This does not follow ANSI C.

+    - t

+      - The argument is a pointer to an EFI_TIME structure.  The time and

+        date are printed in the format "mm/dd/yyyy hh:mm" where mm is the

+        month zero padded, dd is the day zero padded, yyyy is the year zero

+        padded, hh is the hour zero padded, and mm is minutes zero padded.

+        This does not follow ANSI C.

+    - r

+      - The argument is a RETURN_STATUS value.  This value is converted to

+        a string following the table below.  This does not follow ANSI C.

+      - RETURN_SUCCESS

+        - "Success"

+      - RETURN_LOAD_ERROR

+        - "Load Error"

+      - RETURN_INVALID_PARAMETER

+        - "Invalid Parameter"

+      - RETURN_UNSUPPORTED

+        - "Unsupported"

+      - RETURN_BAD_BUFFER_SIZE

+        - "Bad Buffer Size"

+      - RETURN_BUFFER_TOO_SMALL

+        - "Buffer Too Small"

+      - RETURN_NOT_READY

+        - "Not Ready"

+      - RETURN_DEVICE_ERROR

+        - "Device Error"

+      - RETURN_WRITE_PROTECTED

+        - "Write Protected"

+      - RETURN_OUT_OF_RESOURCES

+        - "Out of Resources"

+      - RETURN_VOLUME_CORRUPTED

+        - "Volume Corrupt"

+      - RETURN_VOLUME_FULL

+        - "Volume Full"

+      - RETURN_NO_MEDIA

+        - "No Media"

+      - RETURN_MEDIA_CHANGED

+        - "Media changed"

+      - RETURN_NOT_FOUND

+        - "Not Found"

+      - RETURN_ACCESS_DENIED

+        - "Access Denied"

+      - RETURN_NO_RESPONSE

+        - "No Response"

+      - RETURN_NO_MAPPING

+        - "No mapping"

+      - RETURN_TIMEOUT

+        - "Time out"

+      - RETURN_NOT_STARTED

+        - "Not started"

+      - RETURN_ALREADY_STARTED

+        - "Already started"

+      - RETURN_ABORTED

+        - "Aborted"

+      - RETURN_ICMP_ERROR

+        - "ICMP Error"

+      - RETURN_TFTP_ERROR

+        - "TFTP Error"

+      - RETURN_PROTOCOL_ERROR

+        - "Protocol Error"

+      - RETURN_WARN_UNKNOWN_GLYPH

+        - "Warning Unknown Glyph"

+      - RETURN_WARN_DELETE_FAILURE

+        - "Warning Delete Failure"

+      - RETURN_WARN_WRITE_FAILURE

+        - "Warning Write Failure"

+      - RETURN_WARN_BUFFER_TOO_SMALL

+        - "Warning Buffer Too Small"

+

+**/

+

+#ifndef __PRINT_LIB_H__

+#define __PRINT_LIB_H__

+

+///

+/// Define the maximum number of characters that are required to

+/// encode with a NULL terminator a decimal, hexadecimal, GUID,

+/// or TIME value.

+///

+///  Maximum Length Decimal String     = 28

+///    "-9,223,372,036,854,775,808"

+///  Maximum Length Hexadecimal String = 17

+///    "FFFFFFFFFFFFFFFF"

+///  Maximum Length GUID               = 37

+///    "00000000-0000-0000-0000-000000000000"

+///  Maximum Length TIME               = 18

+///    "12/12/2006  12:12"

+///

+#define MAXIMUM_VALUE_CHARACTERS  38

+

+///

+/// Flags bitmask values use in UnicodeValueToString() and

+/// AsciiValueToString()

+///

+#define LEFT_JUSTIFY      0x01

+#define COMMA_TYPE        0x08

+#define PREFIX_ZERO       0x20

+#define RADIX_HEX         0x80

+

+/**

+  Produces a Null-terminated Unicode string in an output buffer based on

+  a Null-terminated Unicode format string and a VA_LIST argument list.

+

+  This function is similar as vsnprintf_s defined in C11.

+

+  Produces a Null-terminated Unicode string in the output buffer specified by StartOfBuffer

+  and BufferSize.

+  The Unicode string is produced by parsing the format string specified by FormatString.

+  Arguments are pulled from the variable argument list specified by Marker based on the

+  contents of the format string.

+  The number of Unicode characters in the produced output buffer is returned not including

+  the Null-terminator.

+

+  If StartOfBuffer is not aligned on a 16-bit boundary, then ASSERT().

+  If FormatString is not aligned on a 16-bit boundary, then ASSERT().

+

+  If BufferSize > 1 and StartOfBuffer is NULL, then ASSERT(). Also, the output buffer is

+  unmodified and 0 is returned.

+  If BufferSize > 1 and FormatString is NULL, then ASSERT(). Also, the output buffer is

+  unmodified and 0 is returned.

+  If PcdMaximumUnicodeStringLength is not zero, and BufferSize >

+  (PcdMaximumUnicodeStringLength * sizeof (CHAR16) + 1), then ASSERT(). Also, the output

+  buffer is unmodified and 0 is returned.

+  If PcdMaximumUnicodeStringLength is not zero, and FormatString contains more than

+  PcdMaximumUnicodeStringLength Unicode characters not including the Null-terminator, then

+  ASSERT(). Also, the output buffer is unmodified and 0 is returned.

+

+  If BufferSize is 0 or 1, then the output buffer is unmodified and 0 is returned.

+

+  @param  StartOfBuffer   A pointer to the output buffer for the produced Null-terminated

+                          Unicode string.

+  @param  BufferSize      The size, in bytes, of the output buffer specified by StartOfBuffer.

+  @param  FormatString    A Null-terminated Unicode format string.

+  @param  Marker          VA_LIST marker for the variable argument list.

+

+  @return The number of Unicode characters in the produced output buffer not including the

+          Null-terminator.

+

+**/

+UINTN

+EFIAPI

+UnicodeVSPrint (

+  OUT CHAR16        *StartOfBuffer,

+  IN  UINTN         BufferSize,

+  IN  CONST CHAR16  *FormatString,

+  IN  VA_LIST       Marker

+  );

+

+/**

+  Produces a Null-terminated Unicode string in an output buffer based on

+  a Null-terminated Unicode format string and a BASE_LIST argument list.

+

+  Produces a Null-terminated Unicode string in the output buffer specified by StartOfBuffer

+  and BufferSize.

+  The Unicode string is produced by parsing the format string specified by FormatString.

+  Arguments are pulled from the variable argument list specified by Marker based on the

+  contents of the format string.

+  The number of Unicode characters in the produced output buffer is returned not including

+  the Null-terminator.

+

+  If StartOfBuffer is not aligned on a 16-bit boundary, then ASSERT().

+  If FormatString is not aligned on a 16-bit boundary, then ASSERT().

+

+  If BufferSize > 1 and StartOfBuffer is NULL, then ASSERT(). Also, the output buffer is

+  unmodified and 0 is returned.

+  If BufferSize > 1 and FormatString is NULL, then ASSERT(). Also, the output buffer is

+  unmodified and 0 is returned.

+  If PcdMaximumUnicodeStringLength is not zero, and BufferSize >

+  (PcdMaximumUnicodeStringLength * sizeof (CHAR16) + 1), then ASSERT(). Also, the output

+  buffer is unmodified and 0 is returned.

+  If PcdMaximumUnicodeStringLength is not zero, and FormatString contains more than

+  PcdMaximumUnicodeStringLength Unicode characters not including the Null-terminator, then

+  ASSERT(). Also, the output buffer is unmodified and 0 is returned.

+

+  If BufferSize is 0 or 1, then the output buffer is unmodified and 0 is returned.

+

+  @param  StartOfBuffer   A pointer to the output buffer for the produced Null-terminated

+                          Unicode string.

+  @param  BufferSize      The size, in bytes, of the output buffer specified by StartOfBuffer.

+  @param  FormatString    A Null-terminated Unicode format string.

+  @param  Marker          BASE_LIST marker for the variable argument list.

+

+  @return The number of Unicode characters in the produced output buffer not including the

+          Null-terminator.

+

+**/

+UINTN

+EFIAPI

+UnicodeBSPrint (

+  OUT CHAR16        *StartOfBuffer,

+  IN  UINTN         BufferSize,

+  IN  CONST CHAR16  *FormatString,

+  IN  BASE_LIST     Marker

+  );

+

+/**

+  Produces a Null-terminated Unicode string in an output buffer based on a Null-terminated

+  Unicode format string and variable argument list.

+

+  This function is similar as snprintf_s defined in C11.

+

+  Produces a Null-terminated Unicode string in the output buffer specified by StartOfBuffer

+  and BufferSize.

+  The Unicode string is produced by parsing the format string specified by FormatString.

+  Arguments are pulled from the variable argument list based on the contents of the format string.

+  The number of Unicode characters in the produced output buffer is returned not including

+  the Null-terminator.

+

+  If StartOfBuffer is not aligned on a 16-bit boundary, then ASSERT().

+  If FormatString is not aligned on a 16-bit boundary, then ASSERT().

+

+  If BufferSize > 1 and StartOfBuffer is NULL, then ASSERT(). Also, the output buffer is

+  unmodified and 0 is returned.

+  If BufferSize > 1 and FormatString is NULL, then ASSERT(). Also, the output buffer is

+  unmodified and 0 is returned.

+  If PcdMaximumUnicodeStringLength is not zero, and BufferSize >

+  (PcdMaximumUnicodeStringLength * sizeof (CHAR16) + 1), then ASSERT(). Also, the output

+  buffer is unmodified and 0 is returned.

+  If PcdMaximumUnicodeStringLength is not zero, and FormatString contains more than

+  PcdMaximumUnicodeStringLength Unicode characters not including the Null-terminator, then

+  ASSERT(). Also, the output buffer is unmodified and 0 is returned.

+

+  If BufferSize is 0 or 1, then the output buffer is unmodified and 0 is returned.

+

+  @param  StartOfBuffer   A pointer to the output buffer for the produced Null-terminated

+                          Unicode string.

+  @param  BufferSize      The size, in bytes, of the output buffer specified by StartOfBuffer.

+  @param  FormatString    A Null-terminated Unicode format string.

+  @param  ...             Variable argument list whose contents are accessed based on the

+                          format string specified by FormatString.

+

+  @return The number of Unicode characters in the produced output buffer not including the

+          Null-terminator.

+

+**/

+UINTN

+EFIAPI

+UnicodeSPrint (

+  OUT CHAR16        *StartOfBuffer,

+  IN  UINTN         BufferSize,

+  IN  CONST CHAR16  *FormatString,

+  ...

+  );

+

+/**

+  Produces a Null-terminated Unicode string in an output buffer based on a Null-terminated

+  ASCII format string and a VA_LIST argument list.

+

+  This function is similar as vsnprintf_s defined in C11.

+

+  Produces a Null-terminated Unicode string in the output buffer specified by StartOfBuffer

+  and BufferSize.

+  The Unicode string is produced by parsing the format string specified by FormatString.

+  Arguments are pulled from the variable argument list specified by Marker based on the

+  contents of the format string.

+  The number of Unicode characters in the produced output buffer is returned not including

+  the Null-terminator.

+

+  If StartOfBuffer is not aligned on a 16-bit boundary, then ASSERT().

+

+  If BufferSize > 1 and StartOfBuffer is NULL, then ASSERT(). Also, the output buffer is

+  unmodified and 0 is returned.

+  If BufferSize > 1 and FormatString is NULL, then ASSERT(). Also, the output buffer is

+  unmodified and 0 is returned.

+  If PcdMaximumUnicodeStringLength is not zero, and BufferSize >

+  (PcdMaximumUnicodeStringLength * sizeof (CHAR16) + 1), then ASSERT(). Also, the output

+  buffer is unmodified and 0 is returned.

+  If PcdMaximumAsciiStringLength is not zero, and FormatString contains more than

+  PcdMaximumAsciiStringLength Ascii characters not including the Null-terminator, then

+  ASSERT(). Also, the output buffer is unmodified and 0 is returned.

+

+  If BufferSize is 0 or 1, then no output buffer is produced and 0 is returned.

+

+  @param  StartOfBuffer   A pointer to the output buffer for the produced Null-terminated

+                          Unicode string.

+  @param  BufferSize      The size, in bytes, of the output buffer specified by StartOfBuffer.

+  @param  FormatString    A Null-terminated ASCII format string.

+  @param  Marker          VA_LIST marker for the variable argument list.

+

+  @return The number of Unicode characters in the produced output buffer not including the

+          Null-terminator.

+

+**/

+UINTN

+EFIAPI

+UnicodeVSPrintAsciiFormat (

+  OUT CHAR16       *StartOfBuffer,

+  IN  UINTN        BufferSize,

+  IN  CONST CHAR8  *FormatString,

+  IN  VA_LIST      Marker

+  );

+

+/**

+  Produces a Null-terminated Unicode string in an output buffer based on a Null-terminated

+  ASCII format string and a BASE_LIST argument list.

+

+  Produces a Null-terminated Unicode string in the output buffer specified by StartOfBuffer

+  and BufferSize.

+  The Unicode string is produced by parsing the format string specified by FormatString.

+  Arguments are pulled from the variable argument list specified by Marker based on the

+  contents of the format string.

+  The number of Unicode characters in the produced output buffer is returned not including

+  the Null-terminator.

+

+  If StartOfBuffer is not aligned on a 16-bit boundary, then ASSERT().

+

+  If BufferSize > 1 and StartOfBuffer is NULL, then ASSERT(). Also, the output buffer is

+  unmodified and 0 is returned.

+  If BufferSize > 1 and FormatString is NULL, then ASSERT(). Also, the output buffer is

+  unmodified and 0 is returned.

+  If PcdMaximumUnicodeStringLength is not zero, and BufferSize >

+  (PcdMaximumUnicodeStringLength * sizeof (CHAR16) + 1), then ASSERT(). Also, the output

+  buffer is unmodified and 0 is returned.

+  If PcdMaximumAsciiStringLength is not zero, and FormatString contains more than

+  PcdMaximumAsciiStringLength Ascii characters not including the Null-terminator, then

+  ASSERT(). Also, the output buffer is unmodified and 0 is returned.

+

+  If BufferSize is 0 or 1, then no output buffer is produced and 0 is returned.

+

+  @param  StartOfBuffer   A pointer to the output buffer for the produced Null-terminated

+                          Unicode string.

+  @param  BufferSize      The size, in bytes, of the output buffer specified by StartOfBuffer.

+  @param  FormatString    A Null-terminated ASCII format string.

+  @param  Marker          BASE_LIST marker for the variable argument list.

+

+  @return The number of Unicode characters in the produced output buffer not including the

+          Null-terminator.

+

+**/

+UINTN

+EFIAPI

+UnicodeBSPrintAsciiFormat (

+  OUT CHAR16       *StartOfBuffer,

+  IN  UINTN        BufferSize,

+  IN  CONST CHAR8  *FormatString,

+  IN  BASE_LIST    Marker

+  );

+

+/**

+  Produces a Null-terminated Unicode string in an output buffer based on a Null-terminated

+  ASCII format string and  variable argument list.

+

+  This function is similar as snprintf_s defined in C11.

+

+  Produces a Null-terminated Unicode string in the output buffer specified by StartOfBuffer

+  and BufferSize.

+  The Unicode string is produced by parsing the format string specified by FormatString.

+  Arguments are pulled from the variable argument list based on the contents of the

+  format string.

+  The number of Unicode characters in the produced output buffer is returned not including

+  the Null-terminator.

+

+  If StartOfBuffer is not aligned on a 16-bit boundary, then ASSERT().

+

+  If BufferSize > 1 and StartOfBuffer is NULL, then ASSERT(). Also, the output buffer is

+  unmodified and 0 is returned.

+  If BufferSize > 1 and FormatString is NULL, then ASSERT(). Also, the output buffer is

+  unmodified and 0 is returned.

+  If PcdMaximumUnicodeStringLength is not zero, and BufferSize >

+  (PcdMaximumUnicodeStringLength * sizeof (CHAR16) + 1), then ASSERT(). Also, the output

+  buffer is unmodified and 0 is returned.

+  If PcdMaximumAsciiStringLength is not zero, and FormatString contains more than

+  PcdMaximumAsciiStringLength Ascii characters not including the Null-terminator, then

+  ASSERT(). Also, the output buffer is unmodified and 0 is returned.

+

+  If BufferSize is 0 or 1, then no output buffer is produced and 0 is returned.

+

+  @param  StartOfBuffer   A pointer to the output buffer for the produced Null-terminated

+                          Unicode string.

+  @param  BufferSize      The size, in bytes, of the output buffer specified by StartOfBuffer.

+  @param  FormatString    A Null-terminated ASCII format string.

+  @param  ...             Variable argument list whose contents are accessed based on the

+                          format string specified by FormatString.

+

+  @return The number of Unicode characters in the produced output buffer not including the

+          Null-terminator.

+

+**/

+UINTN

+EFIAPI

+UnicodeSPrintAsciiFormat (

+  OUT CHAR16       *StartOfBuffer,

+  IN  UINTN        BufferSize,

+  IN  CONST CHAR8  *FormatString,

+  ...

+  );

+

+/**

+  Converts a decimal value to a Null-terminated Unicode string.

+

+  Converts the decimal number specified by Value to a Null-terminated Unicode

+  string specified by Buffer containing at most Width characters. No padding of

+  spaces is ever performed. If Width is 0 then a width of

+  MAXIMUM_VALUE_CHARACTERS is assumed. If the conversion contains more than

+  Width characters, then only the first Width characters are placed in Buffer.

+  Additional conversion parameters are specified in Flags.

+

+  The Flags bit LEFT_JUSTIFY is always ignored.

+  All conversions are left justified in Buffer.

+  If Width is 0, PREFIX_ZERO is ignored in Flags.

+  If COMMA_TYPE is set in Flags, then PREFIX_ZERO is ignored in Flags, and

+  commas are inserted every 3rd digit starting from the right.

+  If RADIX_HEX is set in Flags, then the output buffer will be formatted in

+  hexadecimal format.

+  If Value is < 0 and RADIX_HEX is not set in Flags, then the fist character in

+  Buffer is a '-'.

+  If PREFIX_ZERO is set in Flags and PREFIX_ZERO is not being ignored, then

+  Buffer is padded with '0' characters so the combination of the optional '-'

+  sign character, '0' characters, digit characters for Value, and the

+  Null-terminator add up to Width characters.

+

+  If Buffer is not aligned on a 16-bit boundary, then ASSERT().

+  If an error would be returned, then the function will also ASSERT().

+

+  @param  Buffer      The pointer to the output buffer for the produced

+                      Null-terminated Unicode string.

+  @param  BufferSize  The size of Buffer in bytes, including the

+                      Null-terminator.

+  @param  Flags       The bitmask of flags that specify left justification,

+                      zero pad, and commas.

+  @param  Value       The 64-bit signed value to convert to a string.

+  @param  Width       The maximum number of Unicode characters to place in

+                      Buffer, not including the Null-terminator.

+

+  @retval RETURN_SUCCESS           The decimal value is converted.

+  @retval RETURN_BUFFER_TOO_SMALL  If BufferSize cannot hold the converted

+                                   value.

+  @retval RETURN_INVALID_PARAMETER If Buffer is NULL.

+                                   If PcdMaximumUnicodeStringLength is not

+                                   zero, and BufferSize is greater than

+                                   (PcdMaximumUnicodeStringLength *

+                                   sizeof (CHAR16) + 1).

+                                   If unsupported bits are set in Flags.

+                                   If both COMMA_TYPE and RADIX_HEX are set in

+                                   Flags.

+                                   If Width >= MAXIMUM_VALUE_CHARACTERS.

+

+**/

+RETURN_STATUS

+EFIAPI

+UnicodeValueToStringS (

+  IN OUT CHAR16  *Buffer,

+  IN UINTN       BufferSize,

+  IN UINTN       Flags,

+  IN INT64       Value,

+  IN UINTN       Width

+  );

+

+/**

+  Produces a Null-terminated ASCII string in an output buffer based on a Null-terminated

+  ASCII format string and a VA_LIST argument list.

+

+  This function is similar as vsnprintf_s defined in C11.

+

+  Produces a Null-terminated ASCII string in the output buffer specified by StartOfBuffer

+  and BufferSize.

+  The ASCII string is produced by parsing the format string specified by FormatString.

+  Arguments are pulled from the variable argument list specified by Marker based on

+  the contents of the format string.

+  The number of ASCII characters in the produced output buffer is returned not including

+  the Null-terminator.

+

+  If BufferSize > 0 and StartOfBuffer is NULL, then ASSERT(). Also, the output buffer is

+  unmodified and 0 is returned.

+  If BufferSize > 0 and FormatString is NULL, then ASSERT(). Also, the output buffer is

+  unmodified and 0 is returned.

+  If PcdMaximumAsciiStringLength is not zero, and BufferSize >

+  (PcdMaximumAsciiStringLength * sizeof (CHAR8)), then ASSERT(). Also, the output buffer

+  is unmodified and 0 is returned.

+  If PcdMaximumAsciiStringLength is not zero, and FormatString contains more than

+  PcdMaximumAsciiStringLength Ascii characters not including the Null-terminator, then

+  ASSERT(). Also, the output buffer is unmodified and 0 is returned.

+

+  If BufferSize is 0, then no output buffer is produced and 0 is returned.

+

+  @param  StartOfBuffer   A pointer to the output buffer for the produced Null-terminated

+                          ASCII string.

+  @param  BufferSize      The size, in bytes, of the output buffer specified by StartOfBuffer.

+  @param  FormatString    A Null-terminated ASCII format string.

+  @param  Marker          VA_LIST marker for the variable argument list.

+

+  @return The number of ASCII characters in the produced output buffer not including the

+          Null-terminator.

+

+**/

+UINTN

+EFIAPI

+AsciiVSPrint (

+  OUT CHAR8         *StartOfBuffer,

+  IN  UINTN         BufferSize,

+  IN  CONST CHAR8   *FormatString,

+  IN  VA_LIST       Marker

+  );

+

+/**

+  Produces a Null-terminated ASCII string in an output buffer based on a Null-terminated

+  ASCII format string and a BASE_LIST argument list.

+

+  Produces a Null-terminated ASCII string in the output buffer specified by StartOfBuffer

+  and BufferSize.

+  The ASCII string is produced by parsing the format string specified by FormatString.

+  Arguments are pulled from the variable argument list specified by Marker based on

+  the contents of the format string.

+  The number of ASCII characters in the produced output buffer is returned not including

+  the Null-terminator.

+

+  If BufferSize > 0 and StartOfBuffer is NULL, then ASSERT(). Also, the output buffer is

+  unmodified and 0 is returned.

+  If BufferSize > 0 and FormatString is NULL, then ASSERT(). Also, the output buffer is

+  unmodified and 0 is returned.

+  If PcdMaximumAsciiStringLength is not zero, and BufferSize >

+  (PcdMaximumAsciiStringLength * sizeof (CHAR8)), then ASSERT(). Also, the output buffer

+  is unmodified and 0 is returned.

+  If PcdMaximumAsciiStringLength is not zero, and FormatString contains more than

+  PcdMaximumAsciiStringLength Ascii characters not including the Null-terminator, then

+  ASSERT(). Also, the output buffer is unmodified and 0 is returned.

+

+  If BufferSize is 0, then no output buffer is produced and 0 is returned.

+

+  @param  StartOfBuffer   A pointer to the output buffer for the produced Null-terminated

+                          ASCII string.

+  @param  BufferSize      The size, in bytes, of the output buffer specified by StartOfBuffer.

+  @param  FormatString    A Null-terminated ASCII format string.

+  @param  Marker          BASE_LIST marker for the variable argument list.

+

+  @return The number of ASCII characters in the produced output buffer not including the

+          Null-terminator.

+

+**/

+UINTN

+EFIAPI

+AsciiBSPrint (

+  OUT CHAR8         *StartOfBuffer,

+  IN  UINTN         BufferSize,

+  IN  CONST CHAR8   *FormatString,

+  IN  BASE_LIST     Marker

+  );

+

+/**

+  Produces a Null-terminated ASCII string in an output buffer based on a Null-terminated

+  ASCII format string and  variable argument list.

+

+  This function is similar as snprintf_s defined in C11.

+

+  Produces a Null-terminated ASCII string in the output buffer specified by StartOfBuffer

+  and BufferSize.

+  The ASCII string is produced by parsing the format string specified by FormatString.

+  Arguments are pulled from the variable argument list based on the contents of the

+  format string.

+  The number of ASCII characters in the produced output buffer is returned not including

+  the Null-terminator.

+

+  If BufferSize > 0 and StartOfBuffer is NULL, then ASSERT(). Also, the output buffer is

+  unmodified and 0 is returned.

+  If BufferSize > 0 and FormatString is NULL, then ASSERT(). Also, the output buffer is

+  unmodified and 0 is returned.

+  If PcdMaximumAsciiStringLength is not zero, and BufferSize >

+  (PcdMaximumAsciiStringLength * sizeof (CHAR8)), then ASSERT(). Also, the output buffer

+  is unmodified and 0 is returned.

+  If PcdMaximumAsciiStringLength is not zero, and FormatString contains more than

+  PcdMaximumAsciiStringLength Ascii characters not including the Null-terminator, then

+  ASSERT(). Also, the output buffer is unmodified and 0 is returned.

+

+  If BufferSize is 0, then no output buffer is produced and 0 is returned.

+

+  @param  StartOfBuffer   A pointer to the output buffer for the produced Null-terminated

+                          ASCII string.

+  @param  BufferSize      The size, in bytes, of the output buffer specified by StartOfBuffer.

+  @param  FormatString    A Null-terminated ASCII format string.

+  @param  ...             Variable argument list whose contents are accessed based on the

+                          format string specified by FormatString.

+

+  @return The number of ASCII characters in the produced output buffer not including the

+          Null-terminator.

+

+**/

+UINTN

+EFIAPI

+AsciiSPrint (

+  OUT CHAR8        *StartOfBuffer,

+  IN  UINTN        BufferSize,

+  IN  CONST CHAR8  *FormatString,

+  ...

+  );

+

+/**

+  Produces a Null-terminated ASCII string in an output buffer based on a Null-terminated

+  Unicode format string and a VA_LIST argument list.

+

+  This function is similar as vsnprintf_s defined in C11.

+

+  Produces a Null-terminated ASCII string in the output buffer specified by StartOfBuffer

+  and BufferSize.

+  The ASCII string is produced by parsing the format string specified by FormatString.

+  Arguments are pulled from the variable argument list specified by Marker based on

+  the contents of the format string.

+  The number of ASCII characters in the produced output buffer is returned not including

+  the Null-terminator.

+

+  If FormatString is not aligned on a 16-bit boundary, then ASSERT().

+

+  If BufferSize > 0 and StartOfBuffer is NULL, then ASSERT(). Also, the output buffer is

+  unmodified and 0 is returned.

+  If BufferSize > 0 and FormatString is NULL, then ASSERT(). Also, the output buffer is

+  unmodified and 0 is returned.

+  If PcdMaximumAsciiStringLength is not zero, and BufferSize >

+  (PcdMaximumAsciiStringLength * sizeof (CHAR8)), then ASSERT(). Also, the output buffer

+  is unmodified and 0 is returned.

+  If PcdMaximumUnicodeStringLength is not zero, and FormatString contains more than

+  PcdMaximumUnicodeStringLength Unicode characters not including the Null-terminator, then

+  ASSERT(). Also, the output buffer is unmodified and 0 is returned.

+

+  If BufferSize is 0, then no output buffer is produced and 0 is returned.

+

+  @param  StartOfBuffer   A pointer to the output buffer for the produced Null-terminated

+                          ASCII string.

+  @param  BufferSize      The size, in bytes, of the output buffer specified by StartOfBuffer.

+  @param  FormatString    A Null-terminated Unicode format string.

+  @param  Marker          VA_LIST marker for the variable argument list.

+

+  @return The number of ASCII characters in the produced output buffer not including the

+          Null-terminator.

+

+**/

+UINTN

+EFIAPI

+AsciiVSPrintUnicodeFormat (

+  OUT CHAR8         *StartOfBuffer,

+  IN  UINTN         BufferSize,

+  IN  CONST CHAR16  *FormatString,

+  IN  VA_LIST       Marker

+  );

+

+/**

+  Produces a Null-terminated ASCII string in an output buffer based on a Null-terminated

+  Unicode format string and a BASE_LIST argument list.

+

+  Produces a Null-terminated ASCII string in the output buffer specified by StartOfBuffer

+  and BufferSize.

+  The ASCII string is produced by parsing the format string specified by FormatString.

+  Arguments are pulled from the variable argument list specified by Marker based on

+  the contents of the format string.

+  The number of ASCII characters in the produced output buffer is returned not including

+  the Null-terminator.

+

+  If FormatString is not aligned on a 16-bit boundary, then ASSERT().

+

+  If BufferSize > 0 and StartOfBuffer is NULL, then ASSERT(). Also, the output buffer is

+  unmodified and 0 is returned.

+  If BufferSize > 0 and FormatString is NULL, then ASSERT(). Also, the output buffer is

+  unmodified and 0 is returned.

+  If PcdMaximumAsciiStringLength is not zero, and BufferSize >

+  (PcdMaximumAsciiStringLength * sizeof (CHAR8)), then ASSERT(). Also, the output buffer

+  is unmodified and 0 is returned.

+  If PcdMaximumUnicodeStringLength is not zero, and FormatString contains more than

+  PcdMaximumUnicodeStringLength Unicode characters not including the Null-terminator, then

+  ASSERT(). Also, the output buffer is unmodified and 0 is returned.

+

+  If BufferSize is 0, then no output buffer is produced and 0 is returned.

+

+  @param  StartOfBuffer   A pointer to the output buffer for the produced Null-terminated

+                          ASCII string.

+  @param  BufferSize      The size, in bytes, of the output buffer specified by StartOfBuffer.

+  @param  FormatString    A Null-terminated Unicode format string.

+  @param  Marker          BASE_LIST marker for the variable argument list.

+

+  @return The number of ASCII characters in the produced output buffer not including the

+          Null-terminator.

+

+**/

+UINTN

+EFIAPI

+AsciiBSPrintUnicodeFormat (

+  OUT CHAR8         *StartOfBuffer,

+  IN  UINTN         BufferSize,

+  IN  CONST CHAR16  *FormatString,

+  IN  BASE_LIST     Marker

+  );

+

+/**

+  Produces a Null-terminated ASCII string in an output buffer based on a Null-terminated

+  Unicode format string and  variable argument list.

+

+  This function is similar as snprintf_s defined in C11.

+

+  Produces a Null-terminated ASCII string in the output buffer specified by StartOfBuffer

+  and BufferSize.

+  The ASCII string is produced by parsing the format string specified by FormatString.

+  Arguments are pulled from the variable argument list based on the contents of the

+  format string.

+  The number of ASCII characters in the produced output buffer is returned not including

+  the Null-terminator.

+

+  If FormatString is not aligned on a 16-bit boundary, then ASSERT().

+

+  If BufferSize > 0 and StartOfBuffer is NULL, then ASSERT(). Also, the output buffer is

+  unmodified and 0 is returned.

+  If BufferSize > 0 and FormatString is NULL, then ASSERT(). Also, the output buffer is

+  unmodified and 0 is returned.

+  If PcdMaximumAsciiStringLength is not zero, and BufferSize >

+  (PcdMaximumAsciiStringLength * sizeof (CHAR8)), then ASSERT(). Also, the output buffer

+  is unmodified and 0 is returned.

+  If PcdMaximumUnicodeStringLength is not zero, and FormatString contains more than

+  PcdMaximumUnicodeStringLength Unicode characters not including the Null-terminator, then

+  ASSERT(). Also, the output buffer is unmodified and 0 is returned.

+

+  If BufferSize is 0, then no output buffer is produced and 0 is returned.

+

+  @param  StartOfBuffer   A pointer to the output buffer for the produced Null-terminated

+                          ASCII string.

+  @param  BufferSize      The size, in bytes, of the output buffer specified by StartOfBuffer.

+  @param  FormatString    A Null-terminated Unicode format string.

+  @param  ...             Variable argument list whose contents are accessed based on the

+                          format string specified by FormatString.

+

+  @return The number of ASCII characters in the produced output buffer not including the

+          Null-terminator.

+

+**/

+UINTN

+EFIAPI

+AsciiSPrintUnicodeFormat (

+  OUT CHAR8         *StartOfBuffer,

+  IN  UINTN         BufferSize,

+  IN  CONST CHAR16  *FormatString,

+  ...

+  );

+

+

+/**

+  Converts a decimal value to a Null-terminated Ascii string.

+

+  Converts the decimal number specified by Value to a Null-terminated Ascii

+  string specified by Buffer containing at most Width characters. No padding of

+  spaces is ever performed. If Width is 0 then a width of

+  MAXIMUM_VALUE_CHARACTERS is assumed. If the conversion contains more than

+  Width characters, then only the first Width characters are placed in Buffer.

+  Additional conversion parameters are specified in Flags.

+

+  The Flags bit LEFT_JUSTIFY is always ignored.

+  All conversions are left justified in Buffer.

+  If Width is 0, PREFIX_ZERO is ignored in Flags.

+  If COMMA_TYPE is set in Flags, then PREFIX_ZERO is ignored in Flags, and

+  commas are inserted every 3rd digit starting from the right.

+  If RADIX_HEX is set in Flags, then the output buffer will be formatted in

+  hexadecimal format.

+  If Value is < 0 and RADIX_HEX is not set in Flags, then the fist character in

+  Buffer is a '-'.

+  If PREFIX_ZERO is set in Flags and PREFIX_ZERO is not being ignored, then

+  Buffer is padded with '0' characters so the combination of the optional '-'

+  sign character, '0' characters, digit characters for Value, and the

+  Null-terminator add up to Width characters.

+

+  If an error would be returned, then the function will ASSERT().

+

+  @param  Buffer      The pointer to the output buffer for the produced

+                      Null-terminated Ascii string.

+  @param  BufferSize  The size of Buffer in bytes, including the

+                      Null-terminator.

+  @param  Flags       The bitmask of flags that specify left justification,

+                      zero pad, and commas.

+  @param  Value       The 64-bit signed value to convert to a string.

+  @param  Width       The maximum number of Ascii characters to place in

+                      Buffer, not including the Null-terminator.

+

+  @retval RETURN_SUCCESS           The decimal value is converted.

+  @retval RETURN_BUFFER_TOO_SMALL  If BufferSize cannot hold the converted

+                                   value.

+  @retval RETURN_INVALID_PARAMETER If Buffer is NULL.

+                                   If PcdMaximumAsciiStringLength is not

+                                   zero, and BufferSize is greater than

+                                   PcdMaximumAsciiStringLength.

+                                   If unsupported bits are set in Flags.

+                                   If both COMMA_TYPE and RADIX_HEX are set in

+                                   Flags.

+                                   If Width >= MAXIMUM_VALUE_CHARACTERS.

+

+**/

+RETURN_STATUS

+EFIAPI

+AsciiValueToStringS (

+  IN OUT CHAR8   *Buffer,

+  IN UINTN       BufferSize,

+  IN UINTN       Flags,

+  IN INT64       Value,

+  IN UINTN       Width

+  );

+

+/**

+  Returns the number of characters that would be produced by if the formatted

+  output were produced not including the Null-terminator.

+

+  If FormatString is not aligned on a 16-bit boundary, then ASSERT().

+

+  If FormatString is NULL, then ASSERT() and 0 is returned.

+  If PcdMaximumUnicodeStringLength is not zero, and FormatString contains more

+  than PcdMaximumUnicodeStringLength Unicode characters not including the

+  Null-terminator, then ASSERT() and 0 is returned.

+

+  @param[in]  FormatString    A Null-terminated Unicode format string.

+  @param[in]  Marker          VA_LIST marker for the variable argument list.

+

+  @return The number of characters that would be produced, not including the

+          Null-terminator.

+**/

+UINTN

+EFIAPI

+SPrintLength (

+  IN  CONST CHAR16   *FormatString,

+  IN  VA_LIST       Marker

+  );

+

+/**

+  Returns the number of characters that would be produced by if the formatted

+  output were produced not including the Null-terminator.

+

+  If FormatString is NULL, then ASSERT() and 0 is returned.

+  If PcdMaximumAsciiStringLength is not zero, and FormatString contains more

+  than PcdMaximumAsciiStringLength Ascii characters not including the

+  Null-terminator, then ASSERT() and 0 is returned.

+

+  @param[in]  FormatString    A Null-terminated ASCII format string.

+  @param[in]  Marker          VA_LIST marker for the variable argument list.

+

+  @return The number of characters that would be produced, not including the

+          Null-terminator.

+**/

+UINTN

+EFIAPI

+SPrintLengthAsciiFormat (

+  IN  CONST CHAR8   *FormatString,

+  IN  VA_LIST       Marker

+  );

+

+#endif

diff --git a/debugging_demo/memtest86+/efi/Include/Library/UefiApplicationEntryPoint.h b/debugging_demo/memtest86+/efi/Include/Library/UefiApplicationEntryPoint.h
new file mode 100644
index 0000000..e6bebe8
--- /dev/null
+++ b/debugging_demo/memtest86+/efi/Include/Library/UefiApplicationEntryPoint.h
@@ -0,0 +1,148 @@
+/** @file

+  Module entry point library for UEFI Applications.

+

+Copyright (c) 2007 - 2018, Intel Corporation. All rights reserved.<BR>

+SPDX-License-Identifier: BSD-2-Clause-Patent

+

+**/

+

+#ifndef __UEFI_APPLICATION_ENTRY_POINT_H__

+#define __UEFI_APPLICATION_ENTRY_POINT_H__

+

+///

+/// Declare the EFI/UEFI Specification Revision to which this driver is implemented

+///

+extern CONST UINT32        _gUefiDriverRevision;

+

+

+/**

+  Entry point to UEFI Application.

+

+  This function is the entry point for a UEFI Application. This function must call

+  ProcessLibraryConstructorList(), ProcessModuleEntryPointList(), and ProcessLibraryDestructorList().

+  The return value from ProcessModuleEntryPointList() is returned.

+  If _gUefiDriverRevision is not zero and SystemTable->Hdr.Revision is less than _gUefiDriverRevison,

+  then return EFI_INCOMPATIBLE_VERSION.

+

+  @param  ImageHandle  The image handle of the UEFI Application.

+  @param  SystemTable  A pointer to the EFI System Table.

+

+  @retval  EFI_SUCCESS               The UEFI Application exited normally.

+  @retval  EFI_INCOMPATIBLE_VERSION  _gUefiDriverRevision is greater than SystemTable->Hdr.Revision.

+  @retval  Other                     Return value from ProcessModuleEntryPointList().

+

+**/

+EFI_STATUS

+EFIAPI

+_ModuleEntryPoint (

+  IN EFI_HANDLE        ImageHandle,

+  IN EFI_SYSTEM_TABLE  *SystemTable

+  );

+

+

+/**

+  Required by the EBC compiler and identical in functionality to _ModuleEntryPoint().

+

+  @param  ImageHandle  The image handle of the UEFI Application.

+  @param  SystemTable  A pointer to the EFI System Table.

+

+  @retval  EFI_SUCCESS               The UEFI Application exited normally.

+  @retval  EFI_INCOMPATIBLE_VERSION  _gUefiDriverRevision is greater than SystemTable->Hdr.Revision.

+  @retval  Other                     Return value from ProcessModuleEntryPointList().

+

+**/

+EFI_STATUS

+EFIAPI

+EfiMain (

+  IN EFI_HANDLE        ImageHandle,

+  IN EFI_SYSTEM_TABLE  *SystemTable

+  );

+

+

+/**

+  Invokes the library destructors for all dependent libraries and terminates

+  the UEFI Application.

+

+  This function calls ProcessLibraryDestructorList() and the EFI Boot Service Exit()

+  with a status specified by Status.

+

+  @param  Status  Status returned by the application that is exiting.

+

+**/

+VOID

+EFIAPI

+Exit (

+  IN EFI_STATUS  Status

+  );

+

+

+/**

+  Autogenerated function that calls the library constructors for all of the module's

+  dependent libraries.

+

+  This function must be called by _ModuleEntryPoint().

+  This function calls the set of library constructors for the set of library instances

+  that a module depends on. This includes library instances that a module depends on

+  directly and library instances that a module depends on indirectly through other libraries.

+  This function is autogenerated by build tools and those build tools are responsible for

+  collecting the set of library instances, determine which ones have constructors, and

+  calling the library constructors in the proper order based upon each of the library

+  instances own dependencies.

+

+  @param  ImageHandle  The image handle of the UEFI Application.

+  @param  SystemTable  A pointer to the EFI System Table.

+

+**/

+VOID

+EFIAPI

+ProcessLibraryConstructorList (

+  IN EFI_HANDLE        ImageHandle,

+  IN EFI_SYSTEM_TABLE  *SystemTable

+  );

+

+

+/**

+  Autogenerated function that calls the library descructors for all of the module's

+  dependent libraries.

+

+  This function may be called by _ModuleEntryPoint()or Exit().

+  This function calls the set of library destructors for the set of library instances

+  that a module depends on.  This includes library instances that a module depends on

+  directly and library instances that a module depends on indirectly through other libraries.

+  This function is autogenerated by build tools and those build tools are responsible

+  for collecting the set of library instances, determine which ones have destructors,

+  and calling the library destructors in the proper order based upon each of the library

+  instances own dependencies.

+

+  @param  ImageHandle  The image handle of the UEFI Application.

+  @param  SystemTable  A pointer to the EFI System Table.

+

+**/

+VOID

+EFIAPI

+ProcessLibraryDestructorList (

+  IN EFI_HANDLE        ImageHandle,

+  IN EFI_SYSTEM_TABLE  *SystemTable

+  );

+

+/**

+  This function calls the set of module entry points. It must be called by _ModuleEntryPoint().

+

+  This function is autogenerated by build tools and those build tools are

+  responsible for collecting the module entry points and calling them in a specified order.

+

+  @param  ImageHandle    The image handle of the UEFI Application.

+  @param  SystemTable    A pointer to the EFI System Table.

+

+  @retval  EFI_SUCCESS   The UEFI Application executed normally.

+  @retval  !EFI_SUCCESS  The UEFI Application failed to execute normally.

+

+**/

+EFI_STATUS

+EFIAPI

+ProcessModuleEntryPointList (

+  IN EFI_HANDLE        ImageHandle,

+  IN EFI_SYSTEM_TABLE  *SystemTable

+  );

+

+#endif

diff --git a/debugging_demo/memtest86+/efi/Include/Library/UefiBootServicesTableLib.h b/debugging_demo/memtest86+/efi/Include/Library/UefiBootServicesTableLib.h
new file mode 100644
index 0000000..4fe5a9e
--- /dev/null
+++ b/debugging_demo/memtest86+/efi/Include/Library/UefiBootServicesTableLib.h
@@ -0,0 +1,28 @@
+/** @file

+  Provides a service to retrieve a pointer to the EFI Boot Services Table.

+  Only available to DXE and UEFI module types.

+

+Copyright (c) 2006 - 2008, Intel Corporation. All rights reserved.<BR>

+SPDX-License-Identifier: BSD-2-Clause-Patent

+

+**/

+

+#ifndef __UEFI_BOOT_SERVICES_TABLE_LIB_H__

+#define __UEFI_BOOT_SERVICES_TABLE_LIB_H__

+

+///

+/// Cache the Image Handle

+///

+extern EFI_HANDLE         gImageHandle;

+

+///

+/// Cache pointer to the EFI System Table

+///

+extern EFI_SYSTEM_TABLE   *gST;

+

+///

+/// Cache pointer to the EFI Boot Services Table

+///

+extern EFI_BOOT_SERVICES  *gBS;

+

+#endif

diff --git a/debugging_demo/memtest86+/efi/Include/Library/UefiLib.h b/debugging_demo/memtest86+/efi/Include/Library/UefiLib.h
new file mode 100644
index 0000000..0abb40d
--- /dev/null
+++ b/debugging_demo/memtest86+/efi/Include/Library/UefiLib.h
@@ -0,0 +1,1814 @@
+/** @file

+  Provides library functions for common UEFI operations. Only available to DXE

+  and UEFI module types.

+

+  The UEFI Library provides functions and macros that simplify the development of

+  UEFI Drivers and UEFI Applications.  These functions and macros help manage EFI

+  events, build simple locks utilizing EFI Task Priority Levels (TPLs), install

+  EFI Driver Model related protocols, manage Unicode string tables for UEFI Drivers,

+  and print messages on the console output and standard error devices.

+

+  Note that a reserved macro named MDEPKG_NDEBUG is introduced for the intention

+  of size reduction when compiler optimization is disabled. If MDEPKG_NDEBUG is

+  defined, then debug and assert related macros wrapped by it are the NULL implementations.

+

+Copyright (c) 2019, NVIDIA Corporation. All rights reserved.

+Copyright (c) 2006 - 2018, Intel Corporation. All rights reserved.<BR>

+SPDX-License-Identifier: BSD-2-Clause-Patent

+

+**/

+

+#ifndef __UEFI_LIB_H__

+#define __UEFI_LIB_H__

+

+#include <IndustryStandard/Acpi.h>

+

+#include <Protocol/DriverBinding.h>

+#include <Protocol/DriverConfiguration.h>

+#include <Protocol/ComponentName.h>

+#include <Protocol/ComponentName2.h>

+#include <Protocol/DriverDiagnostics.h>

+#include <Protocol/DriverDiagnostics2.h>

+#include <Protocol/GraphicsOutput.h>

+#include <Protocol/DevicePath.h>

+#include <Protocol/SimpleFileSystem.h>

+

+#include <Library/BaseLib.h>

+

+///

+/// Unicode String Table

+///

+typedef struct {

+  CHAR8   *Language;

+  CHAR16  *UnicodeString;

+} EFI_UNICODE_STRING_TABLE;

+

+///

+/// EFI Lock Status

+///

+typedef enum {

+  EfiLockUninitialized = 0,

+  EfiLockReleased      = 1,

+  EfiLockAcquired      = 2

+} EFI_LOCK_STATE;

+

+///

+/// EFI Lock

+///

+typedef struct {

+  EFI_TPL         Tpl;

+  EFI_TPL         OwnerTpl;

+  EFI_LOCK_STATE  Lock;

+} EFI_LOCK;

+

+/**

+  Macro that returns the number of 100 ns units for a specified number of microseconds.

+  This is useful for managing EFI timer events.

+

+  @param  Microseconds           The number of microseconds.

+

+  @return The number of 100 ns units equivalent to the number of microseconds specified

+          by Microseconds.

+

+**/

+#define EFI_TIMER_PERIOD_MICROSECONDS(Microseconds) MultU64x32((UINT64)(Microseconds), 10)

+

+/**

+  Macro that returns the number of 100 ns units for a specified number of milliseconds.

+  This is useful for managing EFI timer events.

+

+  @param  Milliseconds           The number of milliseconds.

+

+  @return The number of 100 ns units equivalent to the number of milliseconds specified

+          by Milliseconds.

+

+**/

+#define EFI_TIMER_PERIOD_MILLISECONDS(Milliseconds) MultU64x32((UINT64)(Milliseconds), 10000)

+

+/**

+  Macro that returns the number of 100 ns units for a specified number of seconds.

+  This is useful for managing EFI timer events.

+

+  @param  Seconds                The number of seconds.

+

+  @return The number of 100 ns units equivalent to the number of seconds specified

+          by Seconds.

+

+**/

+#define EFI_TIMER_PERIOD_SECONDS(Seconds)           MultU64x32((UINT64)(Seconds), 10000000)

+

+/**

+  Macro that returns the a pointer to the next EFI_MEMORY_DESCRIPTOR in an array

+  returned from GetMemoryMap().

+

+  @param  MemoryDescriptor  A pointer to an EFI_MEMORY_DESCRIPTOR.

+

+  @param  Size              The size, in bytes, of the current EFI_MEMORY_DESCRIPTOR.

+

+  @return A pointer to the next EFI_MEMORY_DESCRIPTOR.

+

+**/

+#define NEXT_MEMORY_DESCRIPTOR(MemoryDescriptor, Size) \

+  ((EFI_MEMORY_DESCRIPTOR *)((UINT8 *)(MemoryDescriptor) + (Size)))

+

+/**

+  Retrieves a pointer to the system configuration table from the EFI System Table

+  based on a specified GUID.

+

+  This function searches the list of configuration tables stored in the EFI System Table

+  for a table with a GUID that matches TableGuid. If a match is found, then a pointer to

+  the configuration table is returned in Table, and EFI_SUCCESS is returned. If a matching GUID

+  is not found, then EFI_NOT_FOUND is returned.

+  If TableGuid is NULL, then ASSERT().

+  If Table is NULL, then ASSERT().

+

+  @param  TableGuid       The pointer to table's GUID type..

+  @param  Table           The pointer to the table associated with TableGuid in the EFI System Table.

+

+  @retval EFI_SUCCESS     A configuration table matching TableGuid was found.

+  @retval EFI_NOT_FOUND   A configuration table matching TableGuid could not be found.

+

+**/

+EFI_STATUS

+EFIAPI

+EfiGetSystemConfigurationTable (

+  IN  EFI_GUID  *TableGuid,

+  OUT VOID      **Table

+  );

+

+/**

+  Creates and returns a notification event and registers that event with all the protocol

+  instances specified by ProtocolGuid.

+

+  This function causes the notification function to be executed for every protocol of type

+  ProtocolGuid instance that exists in the system when this function is invoked. If there are

+  no instances of ProtocolGuid in the handle database at the time this function is invoked,

+  then the notification function is still executed one time. In addition, every time a protocol

+  of type ProtocolGuid instance is installed or reinstalled, the notification function is also

+  executed. This function returns the notification event that was created.

+  If ProtocolGuid is NULL, then ASSERT().

+  If NotifyTpl is not a legal TPL value, then ASSERT().

+  If NotifyFunction is NULL, then ASSERT().

+  If Registration is NULL, then ASSERT().

+

+

+  @param  ProtocolGuid    Supplies GUID of the protocol upon whose installation the event is fired.

+  @param  NotifyTpl       Supplies the task priority level of the event notifications.

+  @param  NotifyFunction  Supplies the function to notify when the event is signaled.

+  @param  NotifyContext   The context parameter to pass to NotifyFunction.

+  @param  Registration    A pointer to a memory location to receive the registration value.

+                          This value is passed to LocateHandle() to obtain new handles that

+                          have been added that support the ProtocolGuid-specified protocol.

+

+  @return The notification event that was created.

+

+**/

+EFI_EVENT

+EFIAPI

+EfiCreateProtocolNotifyEvent(

+  IN  EFI_GUID          *ProtocolGuid,

+  IN  EFI_TPL           NotifyTpl,

+  IN  EFI_EVENT_NOTIFY  NotifyFunction,

+  IN  VOID              *NotifyContext,  OPTIONAL

+  OUT VOID              **Registration

+  );

+

+/**

+  Creates a named event that can be signaled with EfiNamedEventSignal().

+

+  This function creates an event using NotifyTpl, NoifyFunction, and NotifyContext.

+  This event is signaled with EfiNamedEventSignal(). This provides the ability for one or more

+  listeners on the same event named by the GUID specified by Name.

+  If Name is NULL, then ASSERT().

+  If NotifyTpl is not a legal TPL value, then ASSERT().

+  If NotifyFunction is NULL, then ASSERT().

+

+  @param  Name                  Supplies GUID name of the event.

+  @param  NotifyTpl             Supplies the task priority level of the event notifications.

+  @param  NotifyFunction        Supplies the function to notify when the event is signaled.

+  @param  NotifyContext         The context parameter to pass to NotifyFunction.

+  @param  Registration          A pointer to a memory location to receive the registration value.

+

+  @retval EFI_SUCCESS           A named event was created.

+  @retval EFI_OUT_OF_RESOURCES  There are not enough resources to create the named event.

+

+**/

+EFI_STATUS

+EFIAPI

+EfiNamedEventListen (

+  IN CONST EFI_GUID    *Name,

+  IN EFI_TPL           NotifyTpl,

+  IN EFI_EVENT_NOTIFY  NotifyFunction,

+  IN CONST VOID        *NotifyContext,  OPTIONAL

+  OUT VOID             *Registration OPTIONAL

+  );

+

+/**

+  Signals a named event created with EfiNamedEventListen().

+

+  This function signals the named event specified by Name. The named event must have been

+  created with EfiNamedEventListen().

+  If Name is NULL, then ASSERT().

+

+  @param  Name                  Supplies the GUID name of the event.

+

+  @retval EFI_SUCCESS           A named event was signaled.

+  @retval EFI_OUT_OF_RESOURCES  There are not enough resources to signal the named event.

+

+**/

+EFI_STATUS

+EFIAPI

+EfiNamedEventSignal (

+  IN CONST EFI_GUID  *Name

+  );

+

+/**

+  Signals an event group by placing a new event in the group temporarily and

+  signaling it.

+

+  @param[in] EventGroup          Supplies the unique identifier of the event

+                                 group to signal.

+

+  @retval EFI_SUCCESS            The event group was signaled successfully.

+  @retval EFI_INVALID_PARAMETER  EventGroup is NULL.

+  @return                        Error codes that report problems about event

+                                 creation or signaling.

+**/

+EFI_STATUS

+EFIAPI

+EfiEventGroupSignal (

+  IN CONST EFI_GUID *EventGroup

+  );

+

+/**

+  An empty function that can be used as NotifyFunction parameter of

+  CreateEvent() or CreateEventEx().

+

+  @param Event              Event whose notification function is being invoked.

+  @param Context            The pointer to the notification function's context,

+                            which is implementation-dependent.

+

+**/

+VOID

+EFIAPI

+EfiEventEmptyFunction (

+  IN EFI_EVENT              Event,

+  IN VOID                   *Context

+  );

+

+/**

+  Returns the current TPL.

+

+  This function returns the current TPL.  There is no EFI service to directly

+  retrieve the current TPL. Instead, the RaiseTPL() function is used to raise

+  the TPL to TPL_HIGH_LEVEL.  This will return the current TPL.  The TPL level

+  can then immediately be restored back to the current TPL level with a call

+  to RestoreTPL().

+

+  @return The current TPL.

+

+**/

+EFI_TPL

+EFIAPI

+EfiGetCurrentTpl (

+  VOID

+  );

+

+/**

+  Initializes a basic mutual exclusion lock.

+

+  This function initializes a basic mutual exclusion lock to the released state

+  and returns the lock.  Each lock provides mutual exclusion access at its task

+  priority level.  Since there is no preemption or multiprocessor support in EFI,

+  acquiring the lock only consists of raising to the locks TPL.

+  If Lock is NULL, then ASSERT().

+  If Priority is not a valid TPL value, then ASSERT().

+

+  @param  Lock       A pointer to the lock data structure to initialize.

+  @param  Priority   The EFI TPL associated with the lock.

+

+  @return The lock.

+

+**/

+EFI_LOCK *

+EFIAPI

+EfiInitializeLock (

+  IN OUT EFI_LOCK  *Lock,

+  IN EFI_TPL        Priority

+  );

+

+/**

+  Initializes a basic mutual exclusion lock.

+

+  This macro initializes the contents of a basic mutual exclusion lock to the

+  released state.  Each lock provides mutual exclusion access at its task

+  priority level.  Since there is no preemption or multiprocessor support in EFI,

+  acquiring the lock only consists of raising to the locks TPL.

+

+  @param  Priority  The task priority level of the lock.

+

+  @return The lock.

+

+**/

+#define EFI_INITIALIZE_LOCK_VARIABLE(Priority) \

+  {Priority, TPL_APPLICATION, EfiLockReleased }

+

+

+/**

+  Macro that calls DebugAssert() if an EFI_LOCK structure is not in the locked state.

+

+  If MDEPKG_NDEBUG is not defined and the DEBUG_PROPERTY_DEBUG_ASSERT_ENABLED

+  bit of PcdDebugProperyMask is set, then this macro evaluates the EFI_LOCK

+  structure specified by Lock.  If Lock is not in the locked state, then

+  DebugAssert() is called passing in the source filename, source line number,

+  and Lock.

+

+  If Lock is NULL, then ASSERT().

+

+  @param  LockParameter  A pointer to the lock to acquire.

+

+**/

+#if !defined(MDEPKG_NDEBUG)

+  #define ASSERT_LOCKED(LockParameter)                  \

+    do {                                                \

+      if (DebugAssertEnabled ()) {                      \

+        ASSERT (LockParameter != NULL);                 \

+        if ((LockParameter)->Lock != EfiLockAcquired) { \

+          _ASSERT (LockParameter not locked);           \

+        }                                               \

+      }                                                 \

+    } while (FALSE)

+#else

+  #define ASSERT_LOCKED(LockParameter)

+#endif

+

+

+/**

+  Acquires ownership of a lock.

+

+  This function raises the system's current task priority level to the task

+  priority level of the mutual exclusion lock.  Then, it places the lock in the

+  acquired state.

+  If Lock is NULL, then ASSERT().

+  If Lock is not initialized, then ASSERT().

+  If Lock is already in the acquired state, then ASSERT().

+

+  @param  Lock              A pointer to the lock to acquire.

+

+**/

+VOID

+EFIAPI

+EfiAcquireLock (

+  IN EFI_LOCK  *Lock

+  );

+

+/**

+  Acquires ownership of a lock.

+

+  This function raises the system's current task priority level to the task priority

+  level of the mutual exclusion lock.  Then, it attempts to place the lock in the acquired state.

+  If the lock is already in the acquired state, then EFI_ACCESS_DENIED is returned.

+  Otherwise, EFI_SUCCESS is returned.

+  If Lock is NULL, then ASSERT().

+  If Lock is not initialized, then ASSERT().

+

+  @param  Lock              A pointer to the lock to acquire.

+

+  @retval EFI_SUCCESS       The lock was acquired.

+  @retval EFI_ACCESS_DENIED The lock could not be acquired because it is already owned.

+

+**/

+EFI_STATUS

+EFIAPI

+EfiAcquireLockOrFail (

+  IN EFI_LOCK  *Lock

+  );

+

+/**

+  Releases ownership of a lock.

+

+  This function transitions a mutual exclusion lock from the acquired state to

+  the released state, and restores the system's task priority level to its

+  previous level.

+  If Lock is NULL, then ASSERT().

+  If Lock is not initialized, then ASSERT().

+  If Lock is already in the released state, then ASSERT().

+

+  @param  Lock  A pointer to the lock to release.

+

+**/

+VOID

+EFIAPI

+EfiReleaseLock (

+  IN EFI_LOCK  *Lock

+  );

+

+/**

+  Tests whether a controller handle is being managed by a specific driver.

+

+  This function tests whether the driver specified by DriverBindingHandle is

+  currently managing the controller specified by ControllerHandle.  This test

+  is performed by evaluating if the the protocol specified by ProtocolGuid is

+  present on ControllerHandle and is was opened by DriverBindingHandle with an

+  attribute of EFI_OPEN_PROTOCOL_BY_DRIVER.

+  If ProtocolGuid is NULL, then ASSERT().

+

+  @param  ControllerHandle     A handle for a controller to test.

+  @param  DriverBindingHandle  Specifies the driver binding handle for the

+                               driver.

+  @param  ProtocolGuid         Specifies the protocol that the driver specified

+                               by DriverBindingHandle opens in its Start()

+                               function.

+

+  @retval EFI_SUCCESS          ControllerHandle is managed by the driver

+                               specified by DriverBindingHandle.

+  @retval EFI_UNSUPPORTED      ControllerHandle is not managed by the driver

+                               specified by DriverBindingHandle.

+

+**/

+EFI_STATUS

+EFIAPI

+EfiTestManagedDevice (

+  IN CONST EFI_HANDLE       ControllerHandle,

+  IN CONST EFI_HANDLE       DriverBindingHandle,

+  IN CONST EFI_GUID         *ProtocolGuid

+  );

+

+/**

+  Tests whether a child handle is a child device of the controller.

+

+  This function tests whether ChildHandle is one of the children of

+  ControllerHandle.  This test is performed by checking to see if the protocol

+  specified by ProtocolGuid is present on ControllerHandle and opened by

+  ChildHandle with an attribute of EFI_OPEN_PROTOCOL_BY_CHILD_CONTROLLER.

+  If ProtocolGuid is NULL, then ASSERT().

+

+  @param  ControllerHandle     A handle for a (parent) controller to test.

+  @param  ChildHandle          A child handle to test.

+  @param  ProtocolGuid         Supplies the protocol that the child controller

+                               opens on its parent controller.

+

+  @retval EFI_SUCCESS          ChildHandle is a child of the ControllerHandle.

+  @retval EFI_UNSUPPORTED      ChildHandle is not a child of the

+                               ControllerHandle.

+

+**/

+EFI_STATUS

+EFIAPI

+EfiTestChildHandle (

+  IN CONST EFI_HANDLE       ControllerHandle,

+  IN CONST EFI_HANDLE       ChildHandle,

+  IN CONST EFI_GUID         *ProtocolGuid

+  );

+

+/**

+  This function checks the supported languages list for a target language,

+  This only supports RFC 4646 Languages.

+

+  @param  SupportedLanguages  The supported languages

+  @param  TargetLanguage      The target language

+

+  @retval Returns EFI_SUCCESS if the language is supported,

+          EFI_UNSUPPORTED otherwise

+

+**/

+EFI_STATUS

+EFIAPI

+IsLanguageSupported (

+  IN CONST CHAR8 *SupportedLanguages,

+  IN CONST CHAR8 *TargetLanguage

+  );

+

+/**

+  This function looks up a Unicode string in UnicodeStringTable.

+

+  If Language is a member of SupportedLanguages and a Unicode string is found in

+  UnicodeStringTable that matches the language code specified by Language, then it

+  is returned in UnicodeString.

+

+  @param  Language                A pointer to the ISO 639-2 language code for the

+                                  Unicode string to look up and return.

+  @param  SupportedLanguages      A pointer to the set of ISO 639-2 language codes

+                                  that the Unicode string table supports.  Language

+                                  must be a member of this set.

+  @param  UnicodeStringTable      A pointer to the table of Unicode strings.

+  @param  UnicodeString           A pointer to the Unicode string from UnicodeStringTable

+                                  that matches the language specified by Language.

+

+  @retval EFI_SUCCESS             The Unicode string that matches the language

+                                  specified by Language was found

+                                  in the table of Unicode strings UnicodeStringTable,

+                                  and it was returned in UnicodeString.

+  @retval EFI_INVALID_PARAMETER   Language is NULL.

+  @retval EFI_INVALID_PARAMETER   UnicodeString is NULL.

+  @retval EFI_UNSUPPORTED         SupportedLanguages is NULL.

+  @retval EFI_UNSUPPORTED         UnicodeStringTable is NULL.

+  @retval EFI_UNSUPPORTED         The language specified by Language is not a

+                                  member of SupportedLanguages.

+  @retval EFI_UNSUPPORTED         The language specified by Language is not

+                                  supported by UnicodeStringTable.

+

+**/

+EFI_STATUS

+EFIAPI

+LookupUnicodeString (

+  IN CONST CHAR8                     *Language,

+  IN CONST CHAR8                     *SupportedLanguages,

+  IN CONST EFI_UNICODE_STRING_TABLE  *UnicodeStringTable,

+  OUT CHAR16                         **UnicodeString

+  );

+

+/**

+  This function looks up a Unicode string in UnicodeStringTable.

+

+  If Language is a member of SupportedLanguages and a Unicode string is found in

+  UnicodeStringTable that matches the language code specified by Language, then

+  it is returned in UnicodeString.

+

+  @param  Language             A pointer to an ASCII string containing the ISO 639-2 or the

+                               RFC 4646 language code for the Unicode string to look up and

+                               return. If Iso639Language is TRUE, then this ASCII string is

+                               not assumed to be Null-terminated, and only the first three

+                               characters are used. If Iso639Language is FALSE, then this ASCII

+                               string must be Null-terminated.

+  @param  SupportedLanguages   A pointer to a Null-terminated ASCII string that contains a

+                               set of ISO 639-2 or RFC 4646 language codes that the Unicode

+                               string table supports.  Language must be a member of this set.

+                               If Iso639Language is TRUE, then this string contains one or more

+                               ISO 639-2 language codes with no separator characters. If Iso639Language

+                               is FALSE, then is string contains one or more RFC 4646 language

+                               codes separated by ';'.

+  @param  UnicodeStringTable   A pointer to the table of Unicode strings. Type EFI_UNICODE_STRING_TABLE

+                               is defined in "Related Definitions".

+  @param  UnicodeString        A pointer to the Null-terminated Unicode string from UnicodeStringTable

+                               that matches the language specified by Language.

+  @param  Iso639Language       Specifies the supported language code format. If it is TRUE, then

+                               Language and SupportedLanguages follow ISO 639-2 language code format.

+                               Otherwise, they follow the RFC 4646 language code format.

+

+

+  @retval  EFI_SUCCESS            The Unicode string that matches the language specified by Language

+                                  was found in the table of Unicode strings UnicodeStringTable, and

+                                  it was returned in UnicodeString.

+  @retval  EFI_INVALID_PARAMETER  Language is NULL.

+  @retval  EFI_INVALID_PARAMETER  UnicodeString is NULL.

+  @retval  EFI_UNSUPPORTED        SupportedLanguages is NULL.

+  @retval  EFI_UNSUPPORTED        UnicodeStringTable is NULL.

+  @retval  EFI_UNSUPPORTED        The language specified by Language is not a member of SupportedLanguages.

+  @retval  EFI_UNSUPPORTED        The language specified by Language is not supported by UnicodeStringTable.

+

+**/

+EFI_STATUS

+EFIAPI

+LookupUnicodeString2 (

+  IN CONST CHAR8                     *Language,

+  IN CONST CHAR8                     *SupportedLanguages,

+  IN CONST EFI_UNICODE_STRING_TABLE  *UnicodeStringTable,

+  OUT CHAR16                         **UnicodeString,

+  IN BOOLEAN                         Iso639Language

+  );

+

+/**

+  This function adds a Unicode string to UnicodeStringTable.

+

+  If Language is a member of SupportedLanguages then UnicodeString is added to

+  UnicodeStringTable.  New buffers are allocated for both Language and

+  UnicodeString.  The contents of Language and UnicodeString are copied into

+  these new buffers.  These buffers are automatically freed when

+  FreeUnicodeStringTable() is called.

+

+  @param  Language                A pointer to the ISO 639-2 language code for the Unicode

+                                  string to add.

+  @param  SupportedLanguages      A pointer to the set of ISO 639-2 language codes

+                                  that the Unicode string table supports.

+                                  Language must be a member of this set.

+  @param  UnicodeStringTable      A pointer to the table of Unicode strings.

+  @param  UnicodeString           A pointer to the Unicode string to add.

+

+  @retval EFI_SUCCESS             The Unicode string that matches the language

+                                  specified by Language was found in the table of

+                                  Unicode strings UnicodeStringTable, and it was

+                                  returned in UnicodeString.

+  @retval EFI_INVALID_PARAMETER   Language is NULL.

+  @retval EFI_INVALID_PARAMETER   UnicodeString is NULL.

+  @retval EFI_INVALID_PARAMETER   UnicodeString is an empty string.

+  @retval EFI_UNSUPPORTED         SupportedLanguages is NULL.

+  @retval EFI_ALREADY_STARTED     A Unicode string with language Language is

+                                  already present in UnicodeStringTable.

+  @retval EFI_OUT_OF_RESOURCES    There is not enough memory to add another

+                                  Unicode string to UnicodeStringTable.

+  @retval EFI_UNSUPPORTED         The language specified by Language is not a

+                                  member of SupportedLanguages.

+

+**/

+EFI_STATUS

+EFIAPI

+AddUnicodeString (

+  IN     CONST CHAR8               *Language,

+  IN     CONST CHAR8               *SupportedLanguages,

+  IN OUT EFI_UNICODE_STRING_TABLE  **UnicodeStringTable,

+  IN     CONST CHAR16              *UnicodeString

+  );

+

+/**

+  This function adds the Null-terminated Unicode string specified by UnicodeString

+  to UnicodeStringTable.

+

+  If Language is a member of SupportedLanguages then UnicodeString is added to

+  UnicodeStringTable.  New buffers are allocated for both Language and UnicodeString.

+  The contents of Language and UnicodeString are copied into these new buffers.

+  These buffers are automatically freed when EfiLibFreeUnicodeStringTable() is called.

+

+  @param  Language            A pointer to an ASCII string containing the ISO 639-2 or

+                              the RFC 4646 language code for the Unicode string to add.

+                              If Iso639Language is TRUE, then this ASCII string is not

+                              assumed to be Null-terminated, and only the first three

+                              chacters are used. If Iso639Language is FALSE, then this

+                              ASCII string must be Null-terminated.

+  @param  SupportedLanguages  A pointer to a Null-terminated ASCII string that contains

+                              a set of ISO 639-2 or RFC 4646 language codes that the Unicode

+                              string table supports.  Language must be a member of this set.

+                              If Iso639Language is TRUE, then this string contains one or more

+                              ISO 639-2 language codes with no separator characters.

+                              If Iso639Language is FALSE, then is string contains one or more

+                              RFC 4646 language codes separated by ';'.

+  @param  UnicodeStringTable  A pointer to the table of Unicode strings. Type EFI_UNICODE_STRING_TABLE

+                              is defined in "Related Definitions".

+  @param  UnicodeString       A pointer to the Unicode string to add.

+  @param  Iso639Language      Specifies the supported language code format. If it is TRUE,

+                              then Language and SupportedLanguages follow ISO 639-2 language code format.

+                              Otherwise, they follow RFC 4646 language code format.

+

+  @retval EFI_SUCCESS            The Unicode string that matches the language specified by

+                                 Language was found in the table of Unicode strings UnicodeStringTable,

+                                 and it was returned in UnicodeString.

+  @retval EFI_INVALID_PARAMETER  Language is NULL.

+  @retval EFI_INVALID_PARAMETER  UnicodeString is NULL.

+  @retval EFI_INVALID_PARAMETER  UnicodeString is an empty string.

+  @retval EFI_UNSUPPORTED        SupportedLanguages is NULL.

+  @retval EFI_ALREADY_STARTED    A Unicode string with language Language is already present in

+                                 UnicodeStringTable.

+  @retval EFI_OUT_OF_RESOURCES   There is not enough memory to add another Unicode string UnicodeStringTable.

+  @retval EFI_UNSUPPORTED        The language specified by Language is not a member of SupportedLanguages.

+

+**/

+EFI_STATUS

+EFIAPI

+AddUnicodeString2 (

+  IN     CONST CHAR8               *Language,

+  IN     CONST CHAR8               *SupportedLanguages,

+  IN OUT EFI_UNICODE_STRING_TABLE  **UnicodeStringTable,

+  IN     CONST CHAR16              *UnicodeString,

+  IN     BOOLEAN                   Iso639Language

+  );

+

+/**

+  This function frees the table of Unicode strings in UnicodeStringTable.

+

+  If UnicodeStringTable is NULL, then EFI_SUCCESS is returned.

+  Otherwise, each language code, and each Unicode string in the Unicode string

+  table are freed, and EFI_SUCCESS is returned.

+

+  @param  UnicodeStringTable  A pointer to the table of Unicode strings.

+

+  @retval EFI_SUCCESS         The Unicode string table was freed.

+

+**/

+EFI_STATUS

+EFIAPI

+FreeUnicodeStringTable (

+  IN EFI_UNICODE_STRING_TABLE  *UnicodeStringTable

+  );

+

+#ifndef DISABLE_NEW_DEPRECATED_INTERFACES

+

+/**

+  [ATTENTION] This function will be deprecated for security reason.

+

+  Returns a pointer to an allocated buffer that contains the contents of a

+  variable retrieved through the UEFI Runtime Service GetVariable().  The

+  returned buffer is allocated using AllocatePool().  The caller is responsible

+  for freeing this buffer with FreePool().

+

+  If Name is NULL, then ASSERT().

+  If Guid is NULL, then ASSERT().

+

+  @param[in]  Name  The pointer to a Null-terminated Unicode string.

+  @param[in]  Guid  The pointer to an EFI_GUID structure.

+

+  @retval NULL   The variable could not be retrieved.

+  @retval NULL   There are not enough resources available for the variable contents.

+  @retval Other  A pointer to allocated buffer containing the variable contents.

+

+**/

+VOID *

+EFIAPI

+GetVariable (

+  IN CONST CHAR16    *Name,

+  IN CONST EFI_GUID  *Guid

+  );

+

+/**

+  [ATTENTION] This function will be deprecated for security reason.

+

+  Returns a pointer to an allocated buffer that contains the contents of a

+  variable retrieved through the UEFI Runtime Service GetVariable().  This

+  function always uses the EFI_GLOBAL_VARIABLE GUID to retrieve variables.

+  The returned buffer is allocated using AllocatePool().  The caller is

+  responsible for freeing this buffer with FreePool().

+

+  If Name is NULL, then ASSERT().

+

+  @param[in]  Name  The pointer to a Null-terminated Unicode string.

+

+  @retval NULL   The variable could not be retrieved.

+  @retval NULL   There are not enough resources available for the variable contents.

+  @retval Other  A pointer to allocated buffer containing the variable contents.

+

+**/

+VOID *

+EFIAPI

+GetEfiGlobalVariable (

+  IN CONST CHAR16  *Name

+  );

+#endif

+

+

+/**

+  Returns the status whether get the variable success. The function retrieves

+  variable  through the UEFI Runtime Service GetVariable().  The

+  returned buffer is allocated using AllocatePool().  The caller is responsible

+  for freeing this buffer with FreePool().

+

+  If Name  is NULL, then ASSERT().

+  If Guid  is NULL, then ASSERT().

+  If Value is NULL, then ASSERT().

+

+  @param[in]  Name  The pointer to a Null-terminated Unicode string.

+  @param[in]  Guid  The pointer to an EFI_GUID structure

+  @param[out] Value The buffer point saved the variable info.

+  @param[out] Size  The buffer size of the variable.

+

+  @retval EFI_OUT_OF_RESOURCES      Allocate buffer failed.

+  @retval EFI_SUCCESS               Find the specified variable.

+  @retval Others Errors             Return errors from call to gRT->GetVariable.

+

+**/

+EFI_STATUS

+EFIAPI

+GetVariable2 (

+  IN CONST CHAR16    *Name,

+  IN CONST EFI_GUID  *Guid,

+  OUT VOID           **Value,

+  OUT UINTN          *Size OPTIONAL

+  );

+

+/**

+  Returns a pointer to an allocated buffer that contains the contents of a

+  variable retrieved through the UEFI Runtime Service GetVariable().  This

+  function always uses the EFI_GLOBAL_VARIABLE GUID to retrieve variables.

+  The returned buffer is allocated using AllocatePool().  The caller is

+  responsible for freeing this buffer with FreePool().

+

+  If Name  is NULL, then ASSERT().

+  If Value is NULL, then ASSERT().

+

+  @param[in]  Name  The pointer to a Null-terminated Unicode string.

+  @param[out] Value The buffer point saved the variable info.

+  @param[out] Size  The buffer size of the variable.

+

+  @retval EFI_OUT_OF_RESOURCES      Allocate buffer failed.

+  @retval EFI_SUCCESS               Find the specified variable.

+  @retval Others Errors             Return errors from call to gRT->GetVariable.

+

+**/

+EFI_STATUS

+EFIAPI

+GetEfiGlobalVariable2 (

+  IN CONST CHAR16    *Name,

+  OUT VOID           **Value,

+  OUT UINTN          *Size OPTIONAL

+  );

+

+/** Return the attributes of the variable.

+

+  Returns the status whether get the variable success. The function retrieves

+  variable  through the UEFI Runtime Service GetVariable().  The

+  returned buffer is allocated using AllocatePool().  The caller is responsible

+  for freeing this buffer with FreePool().  The attributes are returned if

+  the caller provides a valid Attribute parameter.

+

+  If Name  is NULL, then ASSERT().

+  If Guid  is NULL, then ASSERT().

+  If Value is NULL, then ASSERT().

+

+  @param[in]  Name  The pointer to a Null-terminated Unicode string.

+  @param[in]  Guid  The pointer to an EFI_GUID structure

+  @param[out] Value The buffer point saved the variable info.

+  @param[out] Size  The buffer size of the variable.

+  @param[out] Attr  The pointer to the variable attributes as found in var store

+

+  @retval EFI_OUT_OF_RESOURCES      Allocate buffer failed.

+  @retval EFI_SUCCESS               Find the specified variable.

+  @retval Others Errors             Return errors from call to gRT->GetVariable.

+

+**/

+EFI_STATUS

+EFIAPI

+GetVariable3(

+  IN CONST CHAR16       *Name,

+  IN CONST EFI_GUID     *Guid,

+     OUT VOID           **Value,

+     OUT UINTN          *Size OPTIONAL,

+     OUT UINT32         *Attr OPTIONAL

+  );

+

+/**

+  Returns a pointer to an allocated buffer that contains the best matching language

+  from a set of supported languages.

+

+  This function supports both ISO 639-2 and RFC 4646 language codes, but language

+  code types may not be mixed in a single call to this function.  The language

+  code returned is allocated using AllocatePool().  The caller is responsible for

+  freeing the allocated buffer using FreePool().  This function supports a variable

+  argument list that allows the caller to pass in a prioritized list of language

+  codes to test against all the language codes in SupportedLanguages.

+

+  If SupportedLanguages is NULL, then ASSERT().

+

+  @param[in]  SupportedLanguages  A pointer to a Null-terminated ASCII string that

+                                  contains a set of language codes in the format

+                                  specified by Iso639Language.

+  @param[in]  Iso639Language      If not zero, then all language codes are assumed to be

+                                  in ISO 639-2 format.  If zero, then all language

+                                  codes are assumed to be in RFC 4646 language format

+  @param[in]  ...                 A variable argument list that contains pointers to

+                                  Null-terminated ASCII strings that contain one or more

+                                  language codes in the format specified by Iso639Language.

+                                  The first language code from each of these language

+                                  code lists is used to determine if it is an exact or

+                                  close match to any of the language codes in

+                                  SupportedLanguages.  Close matches only apply to RFC 4646

+                                  language codes, and the matching algorithm from RFC 4647

+                                  is used to determine if a close match is present.  If

+                                  an exact or close match is found, then the matching

+                                  language code from SupportedLanguages is returned.  If

+                                  no matches are found, then the next variable argument

+                                  parameter is evaluated.  The variable argument list

+                                  is terminated by a NULL.

+

+  @retval NULL   The best matching language could not be found in SupportedLanguages.

+  @retval NULL   There are not enough resources available to return the best matching

+                 language.

+  @retval Other  A pointer to a Null-terminated ASCII string that is the best matching

+                 language in SupportedLanguages.

+

+**/

+CHAR8 *

+EFIAPI

+GetBestLanguage (

+  IN CONST CHAR8  *SupportedLanguages,

+  IN UINTN        Iso639Language,

+  ...

+  );

+

+/**

+  Draws a dialog box to the console output device specified by

+  ConOut defined in the EFI_SYSTEM_TABLE and waits for a keystroke

+  from the console input device specified by ConIn defined in the

+  EFI_SYSTEM_TABLE.

+

+  If there are no strings in the variable argument list, then ASSERT().

+  If all the strings in the variable argument list are empty, then ASSERT().

+

+  @param[in]   Attribute  Specifies the foreground and background color of the popup.

+  @param[out]  Key        A pointer to the EFI_KEY value of the key that was

+                          pressed.  This is an optional parameter that may be NULL.

+                          If it is NULL then no wait for a keypress will be performed.

+  @param[in]  ...         The variable argument list that contains pointers to Null-

+                          terminated Unicode strings to display in the dialog box.

+                          The variable argument list is terminated by a NULL.

+

+**/

+VOID

+EFIAPI

+CreatePopUp (

+  IN  UINTN          Attribute,

+  OUT EFI_INPUT_KEY  *Key,      OPTIONAL

+  ...

+  );

+

+/**

+  Retrieves the width of a Unicode character.

+

+  This function computes and returns the width of the Unicode character specified

+  by UnicodeChar.

+

+  @param  UnicodeChar   A Unicode character.

+

+  @retval 0             The width if UnicodeChar could not be determined.

+  @retval 1             UnicodeChar is a narrow glyph.

+  @retval 2             UnicodeChar is a wide glyph.

+

+**/

+UINTN

+EFIAPI

+GetGlyphWidth (

+  IN CHAR16  UnicodeChar

+  );

+

+/**

+  Computes the display length of a Null-terminated Unicode String.

+

+  This function computes and returns the display length of the Null-terminated Unicode

+  string specified by String.  If String is NULL then 0 is returned. If any of the widths

+  of the Unicode characters in String can not be determined, then 0 is returned. The display

+  width of String can be computed by summing the display widths of each Unicode character

+  in String.  Unicode characters that are narrow glyphs have a width of 1, and Unicode

+  characters that are width glyphs have a width of 2.

+  If String is not aligned on a 16-bit boundary, then ASSERT().

+

+  @param  String      A pointer to a Null-terminated Unicode string.

+

+  @return The display length of the Null-terminated Unicode string specified by String.

+

+**/

+UINTN

+EFIAPI

+UnicodeStringDisplayLength (

+  IN CONST CHAR16  *String

+  );

+

+//

+// Functions that abstract early Framework contamination of UEFI.

+//

+/**

+  Create, Signal, and Close the Ready to Boot event using EfiSignalEventReadyToBoot().

+

+  This function abstracts the signaling of the Ready to Boot Event. The Framework moved

+  from a proprietary to UEFI 2.0 based mechanism. This library abstracts the caller

+  from how this event is created to prevent to code form having to change with the

+  version of the specification supported.

+

+**/

+VOID

+EFIAPI

+EfiSignalEventReadyToBoot (

+  VOID

+  );

+

+/**

+  Create, Signal, and Close the Ready to Boot event using EfiSignalEventLegacyBoot().

+

+  This function abstracts the signaling of the Legacy Boot Event. The Framework moved from

+  a proprietary to UEFI 2.0 based mechanism.  This library abstracts the caller from how

+  this event is created to prevent to code form having to change with the version of the

+  specification supported.

+

+**/

+VOID

+EFIAPI

+EfiSignalEventLegacyBoot (

+  VOID

+  );

+

+/**

+  Creates an EFI event in the Legacy Boot Event Group.

+

+  Prior to UEFI 2.0 this was done via a non blessed UEFI extensions and this library

+  abstracts the implementation mechanism of this event from the caller. This function

+  abstracts the creation of the Legacy Boot Event. The Framework moved from a proprietary

+  to UEFI 2.0 based mechanism.  This library abstracts the caller from how this event

+  is created to prevent to code form having to change with the version of the

+  specification supported.

+  If LegacyBootEvent is NULL, then ASSERT().

+

+  @param  LegacyBootEvent   Returns the EFI event returned from gBS->CreateEvent(Ex).

+

+  @retval EFI_SUCCESS       The event was created.

+  @retval Other             The event was not created.

+

+**/

+EFI_STATUS

+EFIAPI

+EfiCreateEventLegacyBoot (

+  OUT EFI_EVENT  *LegacyBootEvent

+  );

+

+/**

+  Create an EFI event in the Legacy Boot Event Group and allows

+  the caller to specify a notification function.

+

+  This function abstracts the creation of the Legacy Boot Event.

+  The Framework moved from a proprietary to UEFI 2.0 based mechanism.

+  This library abstracts the caller from how this event is created to prevent

+  to code form having to change with the version of the specification supported.

+  If LegacyBootEvent is NULL, then ASSERT().

+

+  @param  NotifyTpl         The task priority level of the event.

+  @param  NotifyFunction    The notification function to call when the event is signaled.

+  @param  NotifyContext     The content to pass to NotifyFunction when the event is signaled.

+  @param  LegacyBootEvent   Returns the EFI event returned from gBS->CreateEvent(Ex).

+

+  @retval EFI_SUCCESS       The event was created.

+  @retval Other             The event was not created.

+

+**/

+EFI_STATUS

+EFIAPI

+EfiCreateEventLegacyBootEx (

+  IN  EFI_TPL           NotifyTpl,

+  IN  EFI_EVENT_NOTIFY  NotifyFunction,  OPTIONAL

+  IN  VOID              *NotifyContext,  OPTIONAL

+  OUT EFI_EVENT         *LegacyBootEvent

+  );

+

+/**

+  Create an EFI event in the Ready To Boot Event Group.

+

+  Prior to UEFI 2.0 this was done via a non-standard UEFI extension, and this library

+  abstracts the implementation mechanism of this event from the caller.

+  This function abstracts the creation of the Ready to Boot Event.  The Framework

+  moved from a proprietary to UEFI 2.0-based mechanism.  This library abstracts

+  the caller from how this event is created to prevent the code form having to

+  change with the version of the specification supported.

+  If ReadyToBootEvent is NULL, then ASSERT().

+

+  @param  ReadyToBootEvent   Returns the EFI event returned from gBS->CreateEvent(Ex).

+

+  @retval EFI_SUCCESS       The event was created.

+  @retval Other             The event was not created.

+

+**/

+EFI_STATUS

+EFIAPI

+EfiCreateEventReadyToBoot (

+  OUT EFI_EVENT  *ReadyToBootEvent

+  );

+

+/**

+  Create an EFI event in the Ready To Boot Event Group and allows

+  the caller to specify a notification function.

+

+  This function abstracts the creation of the Ready to Boot Event.

+  The Framework moved from a proprietary to UEFI 2.0 based mechanism.

+  This library abstracts the caller from how this event is created to prevent

+  to code form having to change with the version of the specification supported.

+  If ReadyToBootEvent is NULL, then ASSERT().

+

+  @param  NotifyTpl         The task priority level of the event.

+  @param  NotifyFunction    The notification function to call when the event is signaled.

+  @param  NotifyContext     The content to pass to NotifyFunction when the event is signaled.

+  @param  ReadyToBootEvent  Returns the EFI event returned from gBS->CreateEvent(Ex).

+

+  @retval EFI_SUCCESS       The event was created.

+  @retval Other             The event was not created.

+

+**/

+EFI_STATUS

+EFIAPI

+EfiCreateEventReadyToBootEx (

+  IN  EFI_TPL           NotifyTpl,

+  IN  EFI_EVENT_NOTIFY  NotifyFunction,  OPTIONAL

+  IN  VOID              *NotifyContext,  OPTIONAL

+  OUT EFI_EVENT         *ReadyToBootEvent

+  );

+

+/**

+  Initialize a Firmware Volume (FV) Media Device Path node.

+

+  The Framework FwVol Device Path changed to conform to the UEFI 2.0 specification.

+  This library function abstracts initializing a device path node.

+  Initialize the MEDIA_FW_VOL_FILEPATH_DEVICE_PATH data structure.  This device

+  path changed in the DXE CIS version 0.92 in a non back ward compatible way to

+  not conflict with the UEFI 2.0 specification.  This function abstracts the

+  differences from the caller.

+  If FvDevicePathNode is NULL, then ASSERT().

+  If NameGuid is NULL, then ASSERT().

+

+  @param  FvDevicePathNode  The pointer to a FV device path node to initialize

+  @param  NameGuid          FV file name to use in FvDevicePathNode

+

+**/

+VOID

+EFIAPI

+EfiInitializeFwVolDevicepathNode (

+  IN OUT MEDIA_FW_VOL_FILEPATH_DEVICE_PATH  *FvDevicePathNode,

+  IN CONST EFI_GUID                         *NameGuid

+  );

+

+/**

+  Check to see if the Firmware Volume (FV) Media Device Path is valid

+

+  The Framework FwVol Device Path changed to conform to the UEFI 2.0 specification.

+  This library function abstracts validating a device path node.

+  Check the MEDIA_FW_VOL_FILEPATH_DEVICE_PATH data structure to see if it's valid.

+  If it is valid, then return the GUID file name from the device path node.  Otherwise,

+  return NULL.  This device path changed in the DXE CIS version 0.92 in a non backward

+  compatible way to not conflict with the UEFI 2.0 specification.  This function abstracts

+  the differences from the caller.

+  If FvDevicePathNode is NULL, then ASSERT().

+

+  @param  FvDevicePathNode  The pointer to FV device path to check.

+

+  @retval NULL              FvDevicePathNode is not valid.

+  @retval Other             FvDevicePathNode is valid and pointer to NameGuid was returned.

+

+**/

+EFI_GUID *

+EFIAPI

+EfiGetNameGuidFromFwVolDevicePathNode (

+  IN CONST MEDIA_FW_VOL_FILEPATH_DEVICE_PATH  *FvDevicePathNode

+  );

+

+/**

+  Prints a formatted Unicode string to the console output device specified by

+  ConOut defined in the EFI_SYSTEM_TABLE.

+

+  This function prints a formatted Unicode string to the console output device

+  specified by ConOut in EFI_SYSTEM_TABLE and returns the number of Unicode

+  characters that printed to ConOut.  If the length of the formatted Unicode

+  string is greater than PcdUefiLibMaxPrintBufferSize, then only the first

+  PcdUefiLibMaxPrintBufferSize characters are sent to ConOut.

+  If Format is NULL, then ASSERT().

+  If Format is not aligned on a 16-bit boundary, then ASSERT().

+  If gST->ConOut is NULL, then ASSERT().

+

+  @param Format   A null-terminated Unicode format string.

+  @param ...      The variable argument list whose contents are accessed based

+                  on the format string specified by Format.

+

+  @return Number of Unicode characters printed to ConOut.

+

+**/

+UINTN

+EFIAPI

+Print (

+  IN CONST CHAR16  *Format,

+  ...

+  );

+

+/**

+  Prints a formatted Unicode string to the console output device specified by

+  StdErr defined in the EFI_SYSTEM_TABLE.

+

+  This function prints a formatted Unicode string to the console output device

+  specified by StdErr in EFI_SYSTEM_TABLE and returns the number of Unicode

+  characters that printed to StdErr.  If the length of the formatted Unicode

+  string is greater than PcdUefiLibMaxPrintBufferSize, then only the first

+  PcdUefiLibMaxPrintBufferSize characters are sent to StdErr.

+  If Format is NULL, then ASSERT().

+  If Format is not aligned on a 16-bit boundary, then ASSERT().

+  If gST->StdErr is NULL, then ASSERT().

+

+  @param Format   A null-terminated Unicode format string.

+  @param ...      The variable argument list whose contents are accessed based

+                  on the format string specified by Format.

+

+  @return Number of Unicode characters printed to StdErr.

+

+**/

+UINTN

+EFIAPI

+ErrorPrint (

+  IN CONST CHAR16  *Format,

+  ...

+  );

+

+/**

+  Prints a formatted ASCII string to the console output device specified by

+  ConOut defined in the EFI_SYSTEM_TABLE.

+

+  This function prints a formatted ASCII string to the console output device

+  specified by ConOut in EFI_SYSTEM_TABLE and returns the number of ASCII

+  characters that printed to ConOut.  If the length of the formatted ASCII

+  string is greater than PcdUefiLibMaxPrintBufferSize, then only the first

+  PcdUefiLibMaxPrintBufferSize characters are sent to ConOut.

+  If Format is NULL, then ASSERT().

+  If gST->ConOut is NULL, then ASSERT().

+

+  @param Format   A null-terminated ASCII format string.

+  @param ...      The variable argument list whose contents are accessed based

+                  on the format string specified by Format.

+

+  @return Number of ASCII characters printed to ConOut.

+

+**/

+UINTN

+EFIAPI

+AsciiPrint (

+  IN CONST CHAR8  *Format,

+  ...

+  );

+

+/**

+  Prints a formatted ASCII string to the console output device specified by

+  StdErr defined in the EFI_SYSTEM_TABLE.

+

+  This function prints a formatted ASCII string to the console output device

+  specified by StdErr in EFI_SYSTEM_TABLE and returns the number of ASCII

+  characters that printed to StdErr.  If the length of the formatted ASCII

+  string is greater than PcdUefiLibMaxPrintBufferSize, then only the first

+  PcdUefiLibMaxPrintBufferSize characters are sent to StdErr.

+  If Format is NULL, then ASSERT().

+  If gST->StdErr is NULL, then ASSERT().

+

+  @param Format   A null-terminated ASCII format string.

+  @param ...      The variable argument list whose contents are accessed based

+                  on the format string specified by Format.

+

+  @return Number of ASCII characters printed to ConErr.

+

+**/

+UINTN

+EFIAPI

+AsciiErrorPrint (

+  IN CONST CHAR8  *Format,

+  ...

+  );

+

+

+/**

+  Prints a formatted Unicode string to a graphics console device specified by

+  ConsoleOutputHandle defined in the EFI_SYSTEM_TABLE at the given (X,Y) coordinates.

+

+  This function prints a formatted Unicode string to the graphics console device

+  specified by ConsoleOutputHandle in EFI_SYSTEM_TABLE and returns the number of

+  Unicode characters displayed, not including partial characters that may be clipped

+  by the right edge of the display.  If the length of the formatted Unicode string is

+  greater than PcdUefiLibMaxPrintBufferSize, then at most the first

+  PcdUefiLibMaxPrintBufferSize characters are printed.  The EFI_HII_FONT_PROTOCOL

+  is used to convert the string to a bitmap using the glyphs registered with the

+  HII database.  No wrapping is performed, so any portions of the string the fall

+  outside the active display region will not be displayed.

+

+  If a graphics console device is not associated with the ConsoleOutputHandle

+  defined in the EFI_SYSTEM_TABLE then no string is printed, and 0 is returned.

+  If the EFI_HII_FONT_PROTOCOL is not present in the handle database, then no

+  string is printed, and 0 is returned.

+  If Format is NULL, then ASSERT().

+  If Format is not aligned on a 16-bit boundary, then ASSERT().

+  If gST->ConsoleOutputHandle is NULL, then ASSERT().

+

+  @param  PointX       X coordinate to print the string.

+  @param  PointY       Y coordinate to print the string.

+  @param  ForeGround   The foreground color of the string being printed.  This is

+                       an optional parameter that may be NULL.  If it is NULL,

+                       then the foreground color of the current ConOut device

+                       in the EFI_SYSTEM_TABLE is used.

+  @param  BackGround   The background color of the string being printed.  This is

+                       an optional parameter that may be NULL.  If it is NULL,

+                       then the background color of the current ConOut device

+                       in the EFI_SYSTEM_TABLE is used.

+  @param  Format       A null-terminated Unicode format string.  See Print Library

+                       for the supported format string syntax.

+  @param  ...          Variable argument list whose contents are accessed based on

+                       the format string specified by Format.

+

+  @return  The number of Unicode characters printed.

+

+**/

+UINTN

+EFIAPI

+PrintXY (

+  IN UINTN                            PointX,

+  IN UINTN                            PointY,

+  IN EFI_GRAPHICS_OUTPUT_BLT_PIXEL    *ForeGround, OPTIONAL

+  IN EFI_GRAPHICS_OUTPUT_BLT_PIXEL    *BackGround, OPTIONAL

+  IN CONST CHAR16                     *Format,

+  ...

+  );

+

+/**

+  Prints a formatted ASCII string to a graphics console device specified by

+  ConsoleOutputHandle defined in the EFI_SYSTEM_TABLE at the given (X,Y) coordinates.

+

+  This function prints a formatted ASCII string to the graphics console device

+  specified by ConsoleOutputHandle in EFI_SYSTEM_TABLE and returns the number of

+  ASCII characters displayed, not including partial characters that may be clipped

+  by the right edge of the display.  If the length of the formatted ASCII string is

+  greater than PcdUefiLibMaxPrintBufferSize, then at most the first

+  PcdUefiLibMaxPrintBufferSize characters are printed.  The EFI_HII_FONT_PROTOCOL

+  is used to convert the string to a bitmap using the glyphs registered with the

+  HII database.  No wrapping is performed, so any portions of the string the fall

+  outside the active display region will not be displayed.

+

+  If a graphics console device is not associated with the ConsoleOutputHandle

+  defined in the EFI_SYSTEM_TABLE then no string is printed, and 0 is returned.

+  If the EFI_HII_FONT_PROTOCOL is not present in the handle database, then no

+  string is printed, and 0 is returned.

+  If Format is NULL, then ASSERT().

+  If gST->ConsoleOutputHandle is NULL, then ASSERT().

+

+  @param  PointX       X coordinate to print the string.

+  @param  PointY       Y coordinate to print the string.

+  @param  ForeGround   The foreground color of the string being printed.  This is

+                       an optional parameter that may be NULL.  If it is NULL,

+                       then the foreground color of the current ConOut device

+                       in the EFI_SYSTEM_TABLE is used.

+  @param  BackGround   The background color of the string being printed.  This is

+                       an optional parameter that may be NULL.  If it is NULL,

+                       then the background color of the current ConOut device

+                       in the EFI_SYSTEM_TABLE is used.

+  @param  Format       A null-terminated ASCII format string.  See Print Library

+                       for the supported format string syntax.

+  @param  ...          The variable argument list whose contents are accessed based on

+                       the format string specified by Format.

+

+  @return  The number of ASCII characters printed.

+

+**/

+UINTN

+EFIAPI

+AsciiPrintXY (

+  IN UINTN                            PointX,

+  IN UINTN                            PointY,

+  IN EFI_GRAPHICS_OUTPUT_BLT_PIXEL    *ForeGround, OPTIONAL

+  IN EFI_GRAPHICS_OUTPUT_BLT_PIXEL    *BackGround, OPTIONAL

+  IN CONST CHAR8                      *Format,

+  ...

+  );

+

+

+/**

+  Installs and completes the initialization of a Driver Binding Protocol instance.

+

+  Installs the Driver Binding Protocol specified by DriverBinding onto the handle

+  specified by DriverBindingHandle. If DriverBindingHandle is NULL, then DriverBinding

+  is installed onto a newly created handle. DriverBindingHandle is typically the same

+  as the driver's ImageHandle, but it can be different if the driver produces multiple

+  Driver Binding Protocols.

+  If DriverBinding is NULL, then ASSERT().

+  If DriverBinding can not be installed onto a handle, then ASSERT().

+

+  @param  ImageHandle          The image handle of the driver.

+  @param  SystemTable          The EFI System Table that was passed to the driver's entry point.

+  @param  DriverBinding        A Driver Binding Protocol instance that this driver is producing.

+  @param  DriverBindingHandle  The handle that DriverBinding is to be installed onto.  If this

+                               parameter is NULL, then a new handle is created.

+

+  @retval EFI_SUCCESS           The protocol installation completed successfully.

+  @retval EFI_OUT_OF_RESOURCES  There was not enough system resources to install the protocol.

+  @retval Others                Status from gBS->InstallMultipleProtocolInterfaces().

+

+**/

+EFI_STATUS

+EFIAPI

+EfiLibInstallDriverBinding (

+  IN CONST EFI_HANDLE             ImageHandle,

+  IN CONST EFI_SYSTEM_TABLE       *SystemTable,

+  IN EFI_DRIVER_BINDING_PROTOCOL  *DriverBinding,

+  IN EFI_HANDLE                   DriverBindingHandle

+  );

+

+

+/**

+  Uninstalls a Driver Binding Protocol instance.

+

+  If DriverBinding is NULL, then ASSERT().

+  If DriverBinding can not be uninstalled, then ASSERT().

+

+  @param  DriverBinding        A Driver Binding Protocol instance that this driver produced.

+

+  @retval EFI_SUCCESS           The protocol uninstallation successfully completed.

+  @retval Others                Status from gBS->UninstallMultipleProtocolInterfaces().

+

+**/

+EFI_STATUS

+EFIAPI

+EfiLibUninstallDriverBinding (

+  IN EFI_DRIVER_BINDING_PROTOCOL  *DriverBinding

+  );

+

+

+/**

+  Installs and completes the initialization of a Driver Binding Protocol instance and

+  optionally installs the Component Name, Driver Configuration and Driver Diagnostics Protocols.

+

+  Initializes a driver by installing the Driver Binding Protocol together with the

+  optional Component Name, optional Driver Configure and optional Driver Diagnostic

+  Protocols onto the driver's DriverBindingHandle. If DriverBindingHandle is NULL,

+  then the protocols are installed onto a newly created handle. DriverBindingHandle

+  is typically the same as the driver's ImageHandle, but it can be different if the

+  driver produces multiple Driver Binding Protocols.

+  If DriverBinding is NULL, then ASSERT().

+  If the installation fails, then ASSERT().

+

+  @param  ImageHandle          The image handle of the driver.

+  @param  SystemTable          The EFI System Table that was passed to the driver's entry point.

+  @param  DriverBinding        A Driver Binding Protocol instance that this driver is producing.

+  @param  DriverBindingHandle  The handle that DriverBinding is to be installed onto.  If this

+                               parameter is NULL, then a new handle is created.

+  @param  ComponentName        A Component Name Protocol instance that this driver is producing.

+  @param  DriverConfiguration  A Driver Configuration Protocol instance that this driver is producing.

+  @param  DriverDiagnostics    A Driver Diagnostics Protocol instance that this driver is producing.

+

+  @retval EFI_SUCCESS           The protocol installation completed successfully.

+  @retval EFI_OUT_OF_RESOURCES  There was not enough memory in the pool to install all the protocols.

+

+**/

+EFI_STATUS

+EFIAPI

+EfiLibInstallAllDriverProtocols (

+  IN CONST EFI_HANDLE                         ImageHandle,

+  IN CONST EFI_SYSTEM_TABLE                   *SystemTable,

+  IN EFI_DRIVER_BINDING_PROTOCOL              *DriverBinding,

+  IN EFI_HANDLE                               DriverBindingHandle,

+  IN CONST EFI_COMPONENT_NAME_PROTOCOL        *ComponentName,       OPTIONAL

+  IN CONST EFI_DRIVER_CONFIGURATION_PROTOCOL  *DriverConfiguration, OPTIONAL

+  IN CONST EFI_DRIVER_DIAGNOSTICS_PROTOCOL    *DriverDiagnostics    OPTIONAL

+  );

+

+

+/**

+  Uninstalls a Driver Binding Protocol instance and optionally uninstalls the

+  Component Name, Driver Configuration and Driver Diagnostics Protocols.

+

+  If DriverBinding is NULL, then ASSERT().

+  If the uninstallation fails, then ASSERT().

+

+  @param  DriverBinding        A Driver Binding Protocol instance that this driver produced.

+  @param  ComponentName        A Component Name Protocol instance that this driver produced.

+  @param  DriverConfiguration  A Driver Configuration Protocol instance that this driver produced.

+  @param  DriverDiagnostics    A Driver Diagnostics Protocol instance that this driver produced.

+

+  @retval EFI_SUCCESS           The protocol uninstallation successfully completed.

+  @retval Others                Status from gBS->UninstallMultipleProtocolInterfaces().

+

+**/

+EFI_STATUS

+EFIAPI

+EfiLibUninstallAllDriverProtocols (

+  IN EFI_DRIVER_BINDING_PROTOCOL              *DriverBinding,

+  IN CONST EFI_COMPONENT_NAME_PROTOCOL        *ComponentName,       OPTIONAL

+  IN CONST EFI_DRIVER_CONFIGURATION_PROTOCOL  *DriverConfiguration, OPTIONAL

+  IN CONST EFI_DRIVER_DIAGNOSTICS_PROTOCOL    *DriverDiagnostics    OPTIONAL

+  );

+

+

+/**

+  Installs Driver Binding Protocol with optional Component Name and Component Name 2 Protocols.

+

+  Initializes a driver by installing the Driver Binding Protocol together with the

+  optional Component Name and optional Component Name 2 protocols onto the driver's

+  DriverBindingHandle.  If DriverBindingHandle is NULL, then the protocols are installed

+  onto a newly created handle.  DriverBindingHandle is typically the same as the driver's

+  ImageHandle, but it can be different if the driver produces multiple Driver Binding Protocols.

+  If DriverBinding is NULL, then ASSERT().

+  If the installation fails, then ASSERT().

+

+  @param  ImageHandle          The image handle of the driver.

+  @param  SystemTable          The EFI System Table that was passed to the driver's entry point.

+  @param  DriverBinding        A Driver Binding Protocol instance that this driver is producing.

+  @param  DriverBindingHandle  The handle that DriverBinding is to be installed onto.  If this

+                               parameter is NULL, then a new handle is created.

+  @param  ComponentName        A Component Name Protocol instance that this driver is producing.

+  @param  ComponentName2       A Component Name 2 Protocol instance that this driver is producing.

+

+  @retval EFI_SUCCESS           The protocol installation completed successfully.

+  @retval EFI_OUT_OF_RESOURCES  There was not enough memory in pool to install all the protocols.

+

+**/

+EFI_STATUS

+EFIAPI

+EfiLibInstallDriverBindingComponentName2 (

+  IN CONST EFI_HANDLE                         ImageHandle,

+  IN CONST EFI_SYSTEM_TABLE                   *SystemTable,

+  IN EFI_DRIVER_BINDING_PROTOCOL              *DriverBinding,

+  IN EFI_HANDLE                               DriverBindingHandle,

+  IN CONST EFI_COMPONENT_NAME_PROTOCOL        *ComponentName,       OPTIONAL

+  IN CONST EFI_COMPONENT_NAME2_PROTOCOL       *ComponentName2       OPTIONAL

+  );

+

+

+/**

+  Uninstalls Driver Binding Protocol with optional Component Name and Component Name 2 Protocols.

+

+  If DriverBinding is NULL, then ASSERT().

+  If the uninstallation fails, then ASSERT().

+

+  @param  DriverBinding        A Driver Binding Protocol instance that this driver produced.

+  @param  ComponentName        A Component Name Protocol instance that this driver produced.

+  @param  ComponentName2       A Component Name 2 Protocol instance that this driver produced.

+

+  @retval EFI_SUCCESS           The protocol installation successfully completed.

+  @retval Others                Status from gBS->UninstallMultipleProtocolInterfaces().

+

+**/

+EFI_STATUS

+EFIAPI

+EfiLibUninstallDriverBindingComponentName2 (

+  IN EFI_DRIVER_BINDING_PROTOCOL              *DriverBinding,

+  IN CONST EFI_COMPONENT_NAME_PROTOCOL        *ComponentName,       OPTIONAL

+  IN CONST EFI_COMPONENT_NAME2_PROTOCOL       *ComponentName2       OPTIONAL

+  );

+

+

+/**

+  Installs Driver Binding Protocol with optional Component Name, Component Name 2, Driver

+  Configuration, Driver Configuration 2, Driver Diagnostics, and Driver Diagnostics 2 Protocols.

+

+  Initializes a driver by installing the Driver Binding Protocol together with the optional

+  Component Name, optional Component Name 2, optional Driver Configuration, optional Driver Configuration 2,

+  optional Driver Diagnostic, and optional Driver Diagnostic 2 Protocols onto the driver's DriverBindingHandle.

+  DriverBindingHandle is typically the same as the driver's ImageHandle, but it can be different if the driver

+  produces multiple Driver Binding Protocols.

+  If DriverBinding is NULL, then ASSERT().

+  If the installation fails, then ASSERT().

+

+

+  @param  ImageHandle           The image handle of the driver.

+  @param  SystemTable           The EFI System Table that was passed to the driver's entry point.

+  @param  DriverBinding         A Driver Binding Protocol instance that this driver is producing.

+  @param  DriverBindingHandle   The handle that DriverBinding is to be installed onto.  If this

+                                parameter is NULL, then a new handle is created.

+  @param  ComponentName         A Component Name Protocol instance that this driver is producing.

+  @param  ComponentName2        A Component Name 2 Protocol instance that this driver is producing.

+  @param  DriverConfiguration   A Driver Configuration Protocol instance that this driver is producing.

+  @param  DriverConfiguration2  A Driver Configuration Protocol 2 instance that this driver is producing.

+  @param  DriverDiagnostics     A Driver Diagnostics Protocol instance that this driver is producing.

+  @param  DriverDiagnostics2    A Driver Diagnostics Protocol 2 instance that this driver is producing.

+

+  @retval EFI_SUCCESS           The protocol installation completed successfully.

+  @retval EFI_OUT_OF_RESOURCES  There was not enough memory in pool to install all the protocols.

+

+**/

+EFI_STATUS

+EFIAPI

+EfiLibInstallAllDriverProtocols2 (

+  IN CONST EFI_HANDLE                         ImageHandle,

+  IN CONST EFI_SYSTEM_TABLE                   *SystemTable,

+  IN EFI_DRIVER_BINDING_PROTOCOL              *DriverBinding,

+  IN EFI_HANDLE                               DriverBindingHandle,

+  IN CONST EFI_COMPONENT_NAME_PROTOCOL        *ComponentName,        OPTIONAL

+  IN CONST EFI_COMPONENT_NAME2_PROTOCOL       *ComponentName2,       OPTIONAL

+  IN CONST EFI_DRIVER_CONFIGURATION_PROTOCOL  *DriverConfiguration,  OPTIONAL

+  IN CONST EFI_DRIVER_CONFIGURATION2_PROTOCOL *DriverConfiguration2, OPTIONAL

+  IN CONST EFI_DRIVER_DIAGNOSTICS_PROTOCOL    *DriverDiagnostics,    OPTIONAL

+  IN CONST EFI_DRIVER_DIAGNOSTICS2_PROTOCOL   *DriverDiagnostics2    OPTIONAL

+  );

+

+

+/**

+  Uninstalls Driver Binding Protocol with optional Component Name, Component Name 2, Driver

+  Configuration, Driver Configuration 2, Driver Diagnostics, and Driver Diagnostics 2 Protocols.

+

+  If DriverBinding is NULL, then ASSERT().

+  If the installation fails, then ASSERT().

+

+

+  @param  DriverBinding         A Driver Binding Protocol instance that this driver produced.

+  @param  ComponentName         A Component Name Protocol instance that this driver produced.

+  @param  ComponentName2        A Component Name 2 Protocol instance that this driver produced.

+  @param  DriverConfiguration   A Driver Configuration Protocol instance that this driver produced.

+  @param  DriverConfiguration2  A Driver Configuration Protocol 2 instance that this driver produced.

+  @param  DriverDiagnostics     A Driver Diagnostics Protocol instance that this driver produced.

+  @param  DriverDiagnostics2    A Driver Diagnostics Protocol 2 instance that this driver produced.

+

+  @retval EFI_SUCCESS           The protocol uninstallation successfully completed.

+  @retval Others                Status from gBS->UninstallMultipleProtocolInterfaces().

+

+**/

+EFI_STATUS

+EFIAPI

+EfiLibUninstallAllDriverProtocols2 (

+  IN EFI_DRIVER_BINDING_PROTOCOL              *DriverBinding,

+  IN CONST EFI_COMPONENT_NAME_PROTOCOL        *ComponentName,        OPTIONAL

+  IN CONST EFI_COMPONENT_NAME2_PROTOCOL       *ComponentName2,       OPTIONAL

+  IN CONST EFI_DRIVER_CONFIGURATION_PROTOCOL  *DriverConfiguration,  OPTIONAL

+  IN CONST EFI_DRIVER_CONFIGURATION2_PROTOCOL *DriverConfiguration2, OPTIONAL

+  IN CONST EFI_DRIVER_DIAGNOSTICS_PROTOCOL    *DriverDiagnostics,    OPTIONAL

+  IN CONST EFI_DRIVER_DIAGNOSTICS2_PROTOCOL   *DriverDiagnostics2    OPTIONAL

+  );

+

+

+/**

+  Appends a formatted Unicode string to a Null-terminated Unicode string

+

+  This function appends a formatted Unicode string to the Null-terminated

+  Unicode string specified by String.   String is optional and may be NULL.

+  Storage for the formatted Unicode string returned is allocated using

+  AllocatePool().  The pointer to the appended string is returned.  The caller

+  is responsible for freeing the returned string.

+

+  If String is not NULL and not aligned on a 16-bit boundary, then ASSERT().

+  If FormatString is NULL, then ASSERT().

+  If FormatString is not aligned on a 16-bit boundary, then ASSERT().

+

+  @param[in] String         A Null-terminated Unicode string.

+  @param[in] FormatString   A Null-terminated Unicode format string.

+  @param[in]  Marker        VA_LIST marker for the variable argument list.

+

+  @retval NULL    There was not enough available memory.

+  @return         Null-terminated Unicode string is that is the formatted

+                  string appended to String.

+**/

+CHAR16*

+EFIAPI

+CatVSPrint (

+  IN  CHAR16  *String, OPTIONAL

+  IN  CONST CHAR16  *FormatString,

+  IN  VA_LIST       Marker

+  );

+

+/**

+  Appends a formatted Unicode string to a Null-terminated Unicode string

+

+  This function appends a formatted Unicode string to the Null-terminated

+  Unicode string specified by String.   String is optional and may be NULL.

+  Storage for the formatted Unicode string returned is allocated using

+  AllocatePool().  The pointer to the appended string is returned.  The caller

+  is responsible for freeing the returned string.

+

+  If String is not NULL and not aligned on a 16-bit boundary, then ASSERT().

+  If FormatString is NULL, then ASSERT().

+  If FormatString is not aligned on a 16-bit boundary, then ASSERT().

+

+  @param[in] String         A Null-terminated Unicode string.

+  @param[in] FormatString   A Null-terminated Unicode format string.

+  @param[in] ...            The variable argument list whose contents are

+                            accessed based on the format string specified by

+                            FormatString.

+

+  @retval NULL    There was not enough available memory.

+  @return         Null-terminated Unicode string is that is the formatted

+                  string appended to String.

+**/

+CHAR16 *

+EFIAPI

+CatSPrint (

+  IN  CHAR16  *String, OPTIONAL

+  IN  CONST CHAR16  *FormatString,

+  ...

+  );

+

+/**

+  Returns an array of protocol instance that matches the given protocol.

+

+  @param[in]  Protocol      Provides the protocol to search for.

+  @param[out] NoProtocols   The number of protocols returned in Buffer.

+  @param[out] Buffer        A pointer to the buffer to return the requested

+                            array of protocol instances that match Protocol.

+                            The returned buffer is allocated using

+                            EFI_BOOT_SERVICES.AllocatePool().  The caller is

+                            responsible for freeing this buffer with

+                            EFI_BOOT_SERVICES.FreePool().

+

+  @retval EFI_SUCCESS            The array of protocols was returned in Buffer,

+                                 and the number of protocols in Buffer was

+                                 returned in NoProtocols.

+  @retval EFI_NOT_FOUND          No protocols found.

+  @retval EFI_OUT_OF_RESOURCES   There is not enough pool memory to store the

+                                 matching results.

+  @retval EFI_INVALID_PARAMETER  Protocol is NULL.

+  @retval EFI_INVALID_PARAMETER  NoProtocols is NULL.

+  @retval EFI_INVALID_PARAMETER  Buffer is NULL.

+

+**/

+EFI_STATUS

+EFIAPI

+EfiLocateProtocolBuffer (

+  IN  EFI_GUID  *Protocol,

+  OUT UINTN     *NoProtocols,

+  OUT VOID      ***Buffer

+  );

+

+/**

+  Open or create a file or directory, possibly creating the chain of

+  directories leading up to the directory.

+

+  EfiOpenFileByDevicePath() first locates EFI_SIMPLE_FILE_SYSTEM_PROTOCOL on

+  FilePath, and opens the root directory of that filesystem with

+  EFI_SIMPLE_FILE_SYSTEM_PROTOCOL.OpenVolume().

+

+  On the remaining device path, the longest initial sequence of

+  FILEPATH_DEVICE_PATH nodes is node-wise traversed with

+  EFI_FILE_PROTOCOL.Open().

+

+  (As a consequence, if OpenMode includes EFI_FILE_MODE_CREATE, and Attributes

+  includes EFI_FILE_DIRECTORY, and each FILEPATH_DEVICE_PATH specifies a single

+  pathname component, then EfiOpenFileByDevicePath() ensures that the specified

+  series of subdirectories exist on return.)

+

+  The EFI_FILE_PROTOCOL identified by the last FILEPATH_DEVICE_PATH node is

+  output to the caller; intermediate EFI_FILE_PROTOCOL instances are closed. If

+  there are no FILEPATH_DEVICE_PATH nodes past the node that identifies the

+  filesystem, then the EFI_FILE_PROTOCOL of the root directory of the

+  filesystem is output to the caller. If a device path node that is different

+  from FILEPATH_DEVICE_PATH is encountered relative to the filesystem, the

+  traversal is stopped with an error, and a NULL EFI_FILE_PROTOCOL is output.

+

+  @param[in,out] FilePath  On input, the device path to the file or directory

+                           to open or create. The caller is responsible for

+                           ensuring that the device path pointed-to by FilePath

+                           is well-formed. On output, FilePath points one past

+                           the last node in the original device path that has

+                           been successfully processed. FilePath is set on

+                           output even if EfiOpenFileByDevicePath() returns an

+                           error.

+

+  @param[out] File         On error, File is set to NULL. On success, File is

+                           set to the EFI_FILE_PROTOCOL of the root directory

+                           of the filesystem, if there are no

+                           FILEPATH_DEVICE_PATH nodes in FilePath; otherwise,

+                           File is set to the EFI_FILE_PROTOCOL identified by

+                           the last node in FilePath.

+

+  @param[in] OpenMode      The OpenMode parameter to pass to

+                           EFI_FILE_PROTOCOL.Open().

+

+  @param[in] Attributes    The Attributes parameter to pass to

+                           EFI_FILE_PROTOCOL.Open().

+

+  @retval EFI_SUCCESS            The file or directory has been opened or

+                                 created.

+

+  @retval EFI_INVALID_PARAMETER  FilePath is NULL; or File is NULL; or FilePath

+                                 contains a device path node, past the node

+                                 that identifies

+                                 EFI_SIMPLE_FILE_SYSTEM_PROTOCOL, that is not a

+                                 FILEPATH_DEVICE_PATH node.

+

+  @retval EFI_OUT_OF_RESOURCES   Memory allocation failed.

+

+  @return                        Error codes propagated from the

+                                 LocateDevicePath() and OpenProtocol() boot

+                                 services, and from the

+                                 EFI_SIMPLE_FILE_SYSTEM_PROTOCOL.OpenVolume()

+                                 and EFI_FILE_PROTOCOL.Open() member functions.

+**/

+EFI_STATUS

+EFIAPI

+EfiOpenFileByDevicePath (

+  IN OUT EFI_DEVICE_PATH_PROTOCOL  **FilePath,

+  OUT    EFI_FILE_PROTOCOL         **File,

+  IN     UINT64                    OpenMode,

+  IN     UINT64                    Attributes

+  );

+

+/**

+  This function locates next ACPI table in XSDT/RSDT based on Signature and

+  previous returned Table.

+

+  If PreviousTable is NULL:

+  This function will locate the first ACPI table in XSDT/RSDT based on

+  Signature in gEfiAcpi20TableGuid system configuration table first, and then

+  gEfiAcpi10TableGuid system configuration table.

+  This function will locate in XSDT first, and then RSDT.

+  For DSDT, this function will locate XDsdt in FADT first, and then Dsdt in

+  FADT.

+  For FACS, this function will locate XFirmwareCtrl in FADT first, and then

+  FirmwareCtrl in FADT.

+

+  If PreviousTable is not NULL:

+  1. If it could be located in XSDT in gEfiAcpi20TableGuid system configuration

+     table, then this function will just locate next table in XSDT in

+     gEfiAcpi20TableGuid system configuration table.

+  2. If it could be located in RSDT in gEfiAcpi20TableGuid system configuration

+     table, then this function will just locate next table in RSDT in

+     gEfiAcpi20TableGuid system configuration table.

+  3. If it could be located in RSDT in gEfiAcpi10TableGuid system configuration

+     table, then this function will just locate next table in RSDT in

+     gEfiAcpi10TableGuid system configuration table.

+

+  It's not supported that PreviousTable is not NULL but PreviousTable->Signature

+  is not same with Signature, NULL will be returned.

+

+  @param Signature          ACPI table signature.

+  @param PreviousTable      Pointer to previous returned table to locate next

+                            table, or NULL to locate first table.

+

+  @return Next ACPI table or NULL if not found.

+

+**/

+EFI_ACPI_COMMON_HEADER *

+EFIAPI

+EfiLocateNextAcpiTable (

+  IN UINT32                     Signature,

+  IN EFI_ACPI_COMMON_HEADER     *PreviousTable OPTIONAL

+  );

+

+/**

+  This function locates first ACPI table in XSDT/RSDT based on Signature.

+

+  This function will locate the first ACPI table in XSDT/RSDT based on

+  Signature in gEfiAcpi20TableGuid system configuration table first, and then

+  gEfiAcpi10TableGuid system configuration table.

+  This function will locate in XSDT first, and then RSDT.

+  For DSDT, this function will locate XDsdt in FADT first, and then Dsdt in

+  FADT.

+  For FACS, this function will locate XFirmwareCtrl in FADT first, and then

+  FirmwareCtrl in FADT.

+

+  @param Signature          ACPI table signature.

+

+  @return First ACPI table or NULL if not found.

+

+**/

+EFI_ACPI_COMMON_HEADER *

+EFIAPI

+EfiLocateFirstAcpiTable (

+  IN UINT32                     Signature

+  );

+

+#endif

diff --git a/debugging_demo/memtest86+/efi/Include/Library/UefiRuntimeServicesTableLib.h b/debugging_demo/memtest86+/efi/Include/Library/UefiRuntimeServicesTableLib.h
new file mode 100644
index 0000000..39212ee
--- /dev/null
+++ b/debugging_demo/memtest86+/efi/Include/Library/UefiRuntimeServicesTableLib.h
@@ -0,0 +1,26 @@
+/** @file

+  Provides a service to retrieve a pointer to the EFI Runtime Services Table.

+

+  This library does not contain any functions or macros.  It simply exports the

+  global variable gRT that is a pointer to the EFI Runtime Services Table as defined

+  in the UEFI Specification.  The global variable gRT must be preinitialized to NULL.

+  The library constructor must set gRT to point at the EFI Runtime Services Table so

+  it is available at the module's entry point. Since there is overhead in initializing

+  this global variable, only those modules that actually require access to the EFI

+  Runtime Services Table should use this library.

+  Only available to DXE and UEFI module types.

+

+Copyright (c) 2006 - 2008, Intel Corporation. All rights reserved.<BR>

+SPDX-License-Identifier: BSD-2-Clause-Patent

+

+**/

+

+#ifndef __UEFI_RUNTIME_SERVICES_TABLE_LIB_H__

+#define __UEFI_RUNTIME_SERVICES_TABLE_LIB_H__

+

+///

+/// Cached copy of the EFI Runtime Services Table

+///

+extern EFI_RUNTIME_SERVICES  *gRT;

+

+#endif

diff --git a/debugging_demo/memtest86+/efi/Include/ProcessorBind.h b/debugging_demo/memtest86+/efi/Include/ProcessorBind.h
new file mode 100644
index 0000000..5d14316
--- /dev/null
+++ b/debugging_demo/memtest86+/efi/Include/ProcessorBind.h
@@ -0,0 +1,341 @@
+/** @file

+  Processor or Compiler specific defines and types x64 (Intel 64, AMD64).

+

+  Copyright (c) 2006 - 2019, Intel Corporation. All rights reserved.<BR>

+  SPDX-License-Identifier: BSD-2-Clause-Patent

+

+**/

+

+#ifndef __PROCESSOR_BIND_H__

+#define __PROCESSOR_BIND_H__

+

+///

+/// Define the processor type so other code can make processor based choices

+///

+#define MDE_CPU_X64

+

+//

+// Make sure we are using the correct packing rules per EFI specification

+//

+#if !defined(__GNUC__)

+#pragma pack()

+#endif

+

+#if defined(__GNUC__) && defined(__pic__) && !defined(USING_LTO)  && !defined(__APPLE__)

+//

+// Mark all symbol declarations and references as hidden, meaning they will

+// not be subject to symbol preemption. This allows the compiler to refer to

+// symbols directly using relative references rather than via the GOT, which

+// contains absolute symbol addresses that are subject to runtime relocation.

+//

+// The LTO linker will not emit GOT based relocations when all symbol

+// references can be resolved locally, and so there is no need to set the

+// pragma in that case (and doing so will cause other issues).

+//

+#pragma GCC visibility push (hidden)

+#endif

+

+#if defined(__INTEL_COMPILER)

+//

+// Disable ICC's remark #869: "Parameter" was never referenced warning.

+// This is legal ANSI C code so we disable the remark that is turned on with -Wall

+//

+#pragma warning ( disable : 869 )

+

+//

+// Disable ICC's remark #1418: external function definition with no prior declaration.

+// This is legal ANSI C code so we disable the remark that is turned on with /W4

+//

+#pragma warning ( disable : 1418 )

+

+//

+// Disable ICC's remark #1419: external declaration in primary source file

+// This is legal ANSI C code so we disable the remark that is turned on with /W4

+//

+#pragma warning ( disable : 1419 )

+

+//

+// Disable ICC's remark #593: "Variable" was set but never used.

+// This is legal ANSI C code so we disable the remark that is turned on with /W4

+//

+#pragma warning ( disable : 593 )

+

+#endif

+

+

+#if defined(_MSC_EXTENSIONS)

+

+//

+// Disable warning that make it impossible to compile at /W4

+// This only works for Microsoft* tools

+//

+

+//

+// Disabling bitfield type checking warnings.

+//

+#pragma warning ( disable : 4214 )

+

+//

+// Disabling the unreferenced formal parameter warnings.

+//

+#pragma warning ( disable : 4100 )

+

+//

+// Disable slightly different base types warning as CHAR8 * can not be set

+// to a constant string.

+//

+#pragma warning ( disable : 4057 )

+

+//

+// ASSERT(FALSE) or while (TRUE) are legal constructs so suppress this warning

+//

+#pragma warning ( disable : 4127 )

+

+//

+// This warning is caused by functions defined but not used. For precompiled header only.

+//

+#pragma warning ( disable : 4505 )

+

+//

+// This warning is caused by empty (after preprocessing) source file. For precompiled header only.

+//

+#pragma warning ( disable : 4206 )

+

+#if defined(_MSC_VER) && _MSC_VER >= 1800

+

+//

+// Disable these warnings for VS2013.

+//

+

+//

+// This warning is for potentially uninitialized local variable, and it may cause false

+// positive issues in VS2013 and VS2015 build

+//

+#pragma warning ( disable : 4701 )

+

+//

+// This warning is for potentially uninitialized local pointer variable, and it may cause

+// false positive issues in VS2013 and VS2015 build

+//

+#pragma warning ( disable : 4703 )

+

+#endif

+

+#endif

+

+

+#if defined(_MSC_EXTENSIONS)

+  //

+  // use Microsoft C compiler dependent integer width types

+  //

+

+  ///

+  /// 8-byte unsigned value

+  ///

+  typedef unsigned __int64    UINT64;

+  ///

+  /// 8-byte signed value

+  ///

+  typedef __int64             INT64;

+  ///

+  /// 4-byte unsigned value

+  ///

+  typedef unsigned __int32    UINT32;

+  ///

+  /// 4-byte signed value

+  ///

+  typedef __int32             INT32;

+  ///

+  /// 2-byte unsigned value

+  ///

+  typedef unsigned short      UINT16;

+  ///

+  /// 2-byte Character.  Unless otherwise specified all strings are stored in the

+  /// UTF-16 encoding format as defined by Unicode 2.1 and ISO/IEC 10646 standards.

+  ///

+  typedef unsigned short      CHAR16;

+  ///

+  /// 2-byte signed value

+  ///

+  typedef short               INT16;

+  ///

+  /// Logical Boolean.  1-byte value containing 0 for FALSE or a 1 for TRUE.  Other

+  /// values are undefined.

+  ///

+  typedef unsigned char       BOOLEAN;

+  ///

+  /// 1-byte unsigned value

+  ///

+  typedef unsigned char       UINT8;

+  ///

+  /// 1-byte Character

+  ///

+  typedef char                CHAR8;

+  ///

+  /// 1-byte signed value

+  ///

+  typedef signed char         INT8;

+#else

+  ///

+  /// 8-byte unsigned value

+  ///

+  typedef unsigned long long  UINT64;

+  ///

+  /// 8-byte signed value

+  ///

+  typedef long long           INT64;

+  ///

+  /// 4-byte unsigned value

+  ///

+  typedef unsigned int        UINT32;

+  ///

+  /// 4-byte signed value

+  ///

+  typedef int                 INT32;

+  ///

+  /// 2-byte unsigned value

+  ///

+  typedef unsigned short      UINT16;

+  ///

+  /// 2-byte Character.  Unless otherwise specified all strings are stored in the

+  /// UTF-16 encoding format as defined by Unicode 2.1 and ISO/IEC 10646 standards.

+  ///

+  typedef unsigned short      CHAR16;

+  ///

+  /// 2-byte signed value

+  ///

+  typedef short               INT16;

+  ///

+  /// Logical Boolean.  1-byte value containing 0 for FALSE or a 1 for TRUE.  Other

+  /// values are undefined.

+  ///

+  typedef unsigned char       BOOLEAN;

+  ///

+  /// 1-byte unsigned value

+  ///

+  typedef unsigned char       UINT8;

+  ///

+  /// 1-byte Character

+  ///

+  typedef char                CHAR8;

+  ///

+  /// 1-byte signed value

+  ///

+  typedef signed char         INT8;

+#endif

+

+///

+/// Unsigned value of native width.  (4 bytes on supported 32-bit processor instructions,

+/// 8 bytes on supported 64-bit processor instructions)

+///

+typedef UINT64  UINTN;

+///

+/// Signed value of native width.  (4 bytes on supported 32-bit processor instructions,

+/// 8 bytes on supported 64-bit processor instructions)

+///

+typedef INT64   INTN;

+

+

+//

+// Processor specific defines

+//

+

+///

+/// A value of native width with the highest bit set.

+///

+#define MAX_BIT     0x8000000000000000ULL

+///

+/// A value of native width with the two highest bits set.

+///

+#define MAX_2_BITS  0xC000000000000000ULL

+

+///

+/// Maximum legal x64 address

+///

+#define MAX_ADDRESS   0xFFFFFFFFFFFFFFFFULL

+

+///

+/// Maximum usable address at boot time

+///

+#define MAX_ALLOC_ADDRESS   MAX_ADDRESS

+

+///

+/// Maximum legal x64 INTN and UINTN values.

+///

+#define MAX_INTN   ((INTN)0x7FFFFFFFFFFFFFFFULL)

+#define MAX_UINTN  ((UINTN)0xFFFFFFFFFFFFFFFFULL)

+

+///

+/// Minimum legal x64 INTN value.

+///

+#define MIN_INTN   (((INTN)-9223372036854775807LL) - 1)

+

+///

+/// The stack alignment required for x64

+///

+#define CPU_STACK_ALIGNMENT   16

+

+///

+/// Page allocation granularity for x64

+///

+#define DEFAULT_PAGE_ALLOCATION_GRANULARITY   (0x1000)

+#define RUNTIME_PAGE_ALLOCATION_GRANULARITY   (0x1000)

+

+//

+// Modifier to ensure that all protocol member functions and EFI intrinsics

+// use the correct C calling convention. All protocol member functions and

+// EFI intrinsics are required to modify their member functions with EFIAPI.

+//

+#ifdef EFIAPI

+  ///

+  /// If EFIAPI is already defined, then we use that definition.

+  ///

+#elif defined(_MSC_EXTENSIONS)

+  ///

+  /// Microsoft* compiler specific method for EFIAPI calling convention.

+  ///

+  #define EFIAPI __cdecl

+#elif defined(__GNUC__)

+  ///

+  /// Define the standard calling convention regardless of optimization level.

+  /// The GCC support assumes a GCC compiler that supports the EFI ABI. The EFI

+  /// ABI is much closer to the x64 Microsoft* ABI than standard x64 (x86-64)

+  /// GCC ABI. Thus a standard x64 (x86-64) GCC compiler can not be used for

+  /// x64. Warning the assembly code in the MDE x64 does not follow the correct

+  /// ABI for the standard x64 (x86-64) GCC.

+  ///

+  #define EFIAPI

+#else

+  ///

+  /// The default for a non Microsoft* or GCC compiler is to assume the EFI ABI

+  /// is the standard.

+  ///

+  #define EFIAPI

+#endif

+

+#if defined(__GNUC__) || defined(__clang__)

+  ///

+  /// For GNU assembly code, .global or .globl can declare global symbols.

+  /// Define this macro to unify the usage.

+  ///

+  #define ASM_GLOBAL .globl

+#endif

+

+/**

+  Return the pointer to the first instruction of a function given a function pointer.

+  On x64 CPU architectures, these two pointer values are the same,

+  so the implementation of this macro is very simple.

+

+  @param  FunctionPointer   A pointer to a function.

+

+  @return The pointer to the first instruction of a function given a function pointer.

+

+**/

+#define FUNCTION_ENTRY_POINT(FunctionPointer) (VOID *)(UINTN)(FunctionPointer)

+

+#ifndef __USER_LABEL_PREFIX__

+#define __USER_LABEL_PREFIX__

+#endif

+

+#endif

+

diff --git a/debugging_demo/memtest86+/efi/Include/Protocol/ComponentName.h b/debugging_demo/memtest86+/efi/Include/Protocol/ComponentName.h
new file mode 100644
index 0000000..14c1343
--- /dev/null
+++ b/debugging_demo/memtest86+/efi/Include/Protocol/ComponentName.h
@@ -0,0 +1,123 @@
+/** @file

+  EFI Component Name Protocol as defined in the EFI 1.1 specification.

+  This protocol is used to retrieve user readable names of EFI Drivers

+  and controllers managed by EFI Drivers.

+

+Copyright (c) 2006 - 2018, Intel Corporation. All rights reserved.<BR>

+SPDX-License-Identifier: BSD-2-Clause-Patent

+

+**/

+

+#ifndef __EFI_COMPONENT_NAME_H__

+#define __EFI_COMPONENT_NAME_H__

+

+///

+/// The global ID for the Component Name Protocol.

+///

+#define EFI_COMPONENT_NAME_PROTOCOL_GUID \

+  { \

+    0x107a772c, 0xd5e1, 0x11d4, {0x9a, 0x46, 0x0, 0x90, 0x27, 0x3f, 0xc1, 0x4d } \

+  }

+

+typedef struct _EFI_COMPONENT_NAME_PROTOCOL  EFI_COMPONENT_NAME_PROTOCOL;

+

+

+/**

+  Retrieves a Unicode string that is the user-readable name of the EFI Driver.

+

+  @param  This       A pointer to the EFI_COMPONENT_NAME_PROTOCOL instance.

+  @param  Language   A pointer to a three-character ISO 639-2 language identifier.

+                     This is the language of the driver name that that the caller

+                     is requesting, and it must match one of the languages specified

+                     in SupportedLanguages.  The number of languages supported by a

+                     driver is up to the driver writer.

+  @param  DriverName A pointer to the Unicode string to return.  This Unicode string

+                     is the name of the driver specified by This in the language

+                     specified by Language.

+

+  @retval EFI_SUCCESS           The Unicode string for the Driver specified by This

+                                and the language specified by Language was returned

+                                in DriverName.

+  @retval EFI_INVALID_PARAMETER Language is NULL.

+  @retval EFI_INVALID_PARAMETER DriverName is NULL.

+  @retval EFI_UNSUPPORTED       The driver specified by This does not support the

+                                language specified by Language.

+

+**/

+typedef

+EFI_STATUS

+(EFIAPI *EFI_COMPONENT_NAME_GET_DRIVER_NAME)(

+  IN EFI_COMPONENT_NAME_PROTOCOL           *This,

+  IN  CHAR8                                *Language,

+  OUT CHAR16                               **DriverName

+  );

+

+

+/**

+  Retrieves a Unicode string that is the user readable name of the controller

+  that is being managed by an EFI Driver.

+

+  @param  This             A pointer to the EFI_COMPONENT_NAME_PROTOCOL instance.

+  @param  ControllerHandle The handle of a controller that the driver specified by

+                           This is managing.  This handle specifies the controller

+                           whose name is to be returned.

+  @param  ChildHandle      The handle of the child controller to retrieve the name

+                           of.  This is an optional parameter that may be NULL.  It

+                           will be NULL for device drivers.  It will also be NULL

+                           for a bus drivers that wish to retrieve the name of the

+                           bus controller.  It will not be NULL for a bus driver

+                           that wishes to retrieve the name of a child controller.

+  @param  Language         A pointer to a three character ISO 639-2 language

+                           identifier.  This is the language of the controller name

+                           that the caller is requesting, and it must match one

+                           of the languages specified in SupportedLanguages.  The

+                           number of languages supported by a driver is up to the

+                           driver writer.

+  @param  ControllerName   A pointer to the Unicode string to return.  This Unicode

+                           string is the name of the controller specified by

+                           ControllerHandle and ChildHandle in the language specified

+                           by Language, from the point of view of the driver specified

+                           by This.

+

+  @retval EFI_SUCCESS           The Unicode string for the user-readable name in the

+                                language specified by Language for the driver

+                                specified by This was returned in DriverName.

+  @retval EFI_INVALID_PARAMETER ControllerHandle is NULL.

+  @retval EFI_INVALID_PARAMETER ChildHandle is not NULL and it is not a valid EFI_HANDLE.

+  @retval EFI_INVALID_PARAMETER Language is NULL.

+  @retval EFI_INVALID_PARAMETER ControllerName is NULL.

+  @retval EFI_UNSUPPORTED       The driver specified by This is not currently managing

+                                the controller specified by ControllerHandle and

+                                ChildHandle.

+  @retval EFI_UNSUPPORTED       The driver specified by This does not support the

+                                language specified by Language.

+

+**/

+typedef

+EFI_STATUS

+(EFIAPI *EFI_COMPONENT_NAME_GET_CONTROLLER_NAME)(

+  IN EFI_COMPONENT_NAME_PROTOCOL                              *This,

+  IN  EFI_HANDLE                                              ControllerHandle,

+  IN  EFI_HANDLE                                              ChildHandle        OPTIONAL,

+  IN  CHAR8                                                   *Language,

+  OUT CHAR16                                                  **ControllerName

+  );

+

+///

+/// This protocol is used to retrieve user readable names of drivers

+/// and controllers managed by UEFI Drivers.

+///

+struct _EFI_COMPONENT_NAME_PROTOCOL {

+  EFI_COMPONENT_NAME_GET_DRIVER_NAME      GetDriverName;

+  EFI_COMPONENT_NAME_GET_CONTROLLER_NAME  GetControllerName;

+  ///

+  /// A Null-terminated ASCII string that contains one or more

+  /// ISO 639-2 language codes. This is the list of language codes

+  /// that this protocol supports.

+  ///

+  CHAR8                                   *SupportedLanguages;

+};

+

+extern EFI_GUID gEfiComponentNameProtocolGuid;

+

+#endif

diff --git a/debugging_demo/memtest86+/efi/Include/Protocol/ComponentName2.h b/debugging_demo/memtest86+/efi/Include/Protocol/ComponentName2.h
new file mode 100644
index 0000000..1ebebfd
--- /dev/null
+++ b/debugging_demo/memtest86+/efi/Include/Protocol/ComponentName2.h
@@ -0,0 +1,166 @@
+/** @file

+  UEFI Component Name 2 Protocol as defined in the UEFI 2.1 specification.

+  This protocol is used to retrieve user readable names of drivers

+  and controllers managed by UEFI Drivers.

+

+  Copyright (c) 2006 - 2018, Intel Corporation. All rights reserved.<BR>

+  SPDX-License-Identifier: BSD-2-Clause-Patent

+

+**/

+

+#ifndef __EFI_COMPONENT_NAME2_H__

+#define __EFI_COMPONENT_NAME2_H__

+

+///

+/// Global ID for the Component Name Protocol

+///

+#define EFI_COMPONENT_NAME2_PROTOCOL_GUID \

+  {0x6a7a5cff, 0xe8d9, 0x4f70, { 0xba, 0xda, 0x75, 0xab, 0x30, 0x25, 0xce, 0x14 } }

+

+typedef struct _EFI_COMPONENT_NAME2_PROTOCOL  EFI_COMPONENT_NAME2_PROTOCOL;

+

+

+/**

+  Retrieves a string that is the user readable name of

+  the EFI Driver.

+

+  @param  This       A pointer to the

+                     EFI_COMPONENT_NAME2_PROTOCOL instance.

+

+  @param  Language   A pointer to a Null-terminated ASCII string

+                     array indicating the language. This is the

+                     language of the driver name that the caller

+                     is requesting, and it must match one of the

+                     languages specified in SupportedLanguages.

+                     The number of languages supported by a

+                     driver is up to the driver writer. Language

+                     is specified in RFC 4646 language code

+                     format.

+

+  @param  DriverName A pointer to the string to return.

+                     This string is the name of the

+                     driver specified by This in the language

+                     specified by Language.

+

+  @retval EFI_SUCCESS           The string for the

+                                Driver specified by This and the

+                                language specified by Language

+                                was returned in DriverName.

+

+  @retval EFI_INVALID_PARAMETER Language is NULL.

+

+  @retval EFI_INVALID_PARAMETER DriverName is NULL.

+

+  @retval EFI_UNSUPPORTED       The driver specified by This

+                                does not support the language

+                                specified by Language.

+

+**/

+typedef

+EFI_STATUS

+(EFIAPI *EFI_COMPONENT_NAME2_GET_DRIVER_NAME)(

+  IN EFI_COMPONENT_NAME2_PROTOCOL          *This,

+  IN  CHAR8                                *Language,

+  OUT CHAR16                               **DriverName

+  );

+

+

+/**

+  Retrieves a string that is the user readable name of

+  the controller that is being managed by an EFI Driver.

+

+  @param  This             A pointer to the

+                           EFI_COMPONENT_NAME2_PROTOCOL instance.

+

+  @param  ControllerHandle The handle of a controller that the

+                           driver specified by This is managing.

+                           This handle specifies the controller

+                           whose name is to be returned.

+

+  @param  ChildHandle      The handle of the child controller to

+                           retrieve the name of.  This is an

+                           optional parameter that may be NULL.

+                           It will be NULL for device drivers.

+                           It will also be NULL for bus

+                           drivers that wish to retrieve the

+                           name of the bus controller.  It will

+                           not be NULL for a bus driver that

+                           wishes to retrieve the name of a

+                           child controller.

+

+  @param  Language         A pointer to a Null-terminated ASCII

+                           string array indicating the language.

+                           This is the language of the driver

+                           name that the caller is requesting,

+                           and it must match one of the

+                           languages specified in

+                           SupportedLanguages. The number of

+                           languages supported by a driver is up

+                           to the driver writer. Language is

+                           specified in RFC 4646 language code

+                           format.

+

+  @param  ControllerName   A pointer to the string to return.

+                           This string is the name of the controller

+                           specified by ControllerHandle and ChildHandle

+                           in the language specified by Language

+                           from the point of view of the driver

+                           specified by This.

+

+  @retval EFI_SUCCESS           The string for the user

+                                readable name in the language

+                                specified by Language for the

+                                driver specified by This was

+                                returned in DriverName.

+

+  @retval EFI_INVALID_PARAMETER ControllerHandle is NULL.

+

+  @retval EFI_INVALID_PARAMETER ChildHandle is not NULL and it

+                                is not a valid EFI_HANDLE.

+

+  @retval EFI_INVALID_PARAMETER Language is NULL.

+

+  @retval EFI_INVALID_PARAMETER ControllerName is NULL.

+

+  @retval EFI_UNSUPPORTED       The driver specified by This is

+                                not currently managing the

+                                controller specified by

+                                ControllerHandle and

+                                ChildHandle.

+

+  @retval EFI_UNSUPPORTED       The driver specified by This

+                                does not support the language

+                                specified by Language.

+

+**/

+typedef

+EFI_STATUS

+(EFIAPI *EFI_COMPONENT_NAME2_GET_CONTROLLER_NAME)(

+  IN EFI_COMPONENT_NAME2_PROTOCOL *This,

+  IN  EFI_HANDLE                  ControllerHandle,

+  IN  EFI_HANDLE                  ChildHandle        OPTIONAL,

+  IN  CHAR8                       *Language,

+  OUT CHAR16                      **ControllerName

+  );

+

+///

+/// This protocol is used to retrieve user readable names of drivers

+/// and controllers managed by UEFI Drivers.

+///

+struct _EFI_COMPONENT_NAME2_PROTOCOL {

+  EFI_COMPONENT_NAME2_GET_DRIVER_NAME      GetDriverName;

+  EFI_COMPONENT_NAME2_GET_CONTROLLER_NAME  GetControllerName;

+

+  ///

+  /// A Null-terminated ASCII string array that contains one or more

+  /// supported language codes. This is the list of language codes that

+  /// this protocol supports. The number of languages supported by a

+  /// driver is up to the driver writer. SupportedLanguages is

+  /// specified in RFC 4646 format.

+  ///

+  CHAR8                                    *SupportedLanguages;

+};

+

+extern EFI_GUID gEfiComponentName2ProtocolGuid;

+

+#endif

diff --git a/debugging_demo/memtest86+/efi/Include/Protocol/DebugPort.h b/debugging_demo/memtest86+/efi/Include/Protocol/DebugPort.h
new file mode 100644
index 0000000..d6accb5
--- /dev/null
+++ b/debugging_demo/memtest86+/efi/Include/Protocol/DebugPort.h
@@ -0,0 +1,140 @@
+/** @file

+

+  The file defines the EFI Debugport protocol.

+  This protocol is used by debug agent to communicate with the

+  remote debug host.

+

+  Copyright (c) 2006 - 2018, Intel Corporation. All rights reserved.<BR>

+  SPDX-License-Identifier: BSD-2-Clause-Patent

+

+**/

+

+#ifndef __DEBUG_PORT_H__

+#define __DEBUG_PORT_H__

+

+

+///

+/// DebugPortIo protocol {EBA4E8D2-3858-41EC-A281-2647BA9660D0}

+///

+#define EFI_DEBUGPORT_PROTOCOL_GUID \

+  { \

+    0xEBA4E8D2, 0x3858, 0x41EC, {0xA2, 0x81, 0x26, 0x47, 0xBA, 0x96, 0x60, 0xD0 } \

+  }

+

+extern EFI_GUID gEfiDebugPortProtocolGuid;

+

+typedef struct _EFI_DEBUGPORT_PROTOCOL EFI_DEBUGPORT_PROTOCOL;

+

+//

+// DebugPort member functions

+//

+

+/**

+  Resets the debugport.

+

+  @param  This                  A pointer to the EFI_DEBUGPORT_PROTOCOL instance.

+

+  @retval EFI_SUCCESS           The debugport device was reset and is in usable state.

+  @retval EFI_DEVICE_ERROR      The debugport device could not be reset and is unusable.

+

+**/

+typedef

+EFI_STATUS

+(EFIAPI *EFI_DEBUGPORT_RESET)(

+  IN EFI_DEBUGPORT_PROTOCOL               *This

+  );

+

+/**

+  Writes data to the debugport.

+

+  @param  This                  A pointer to the EFI_DEBUGPORT_PROTOCOL instance.

+  @param  Timeout               The number of microseconds to wait before timing out a write operation.

+  @param  BufferSize            On input, the requested number of bytes of data to write. On output, the

+                                number of bytes of data actually written.

+  @param  Buffer                A pointer to a buffer containing the data to write.

+

+  @retval EFI_SUCCESS           The data was written.

+  @retval EFI_DEVICE_ERROR      The device reported an error.

+  @retval EFI_TIMEOUT           The data write was stopped due to a timeout.

+

+**/

+typedef

+EFI_STATUS

+(EFIAPI *EFI_DEBUGPORT_WRITE)(

+  IN EFI_DEBUGPORT_PROTOCOL               *This,

+  IN UINT32                               Timeout,

+  IN OUT UINTN                            *BufferSize,

+  IN VOID                                 *Buffer

+  );

+

+/**

+  Reads data from the debugport.

+

+  @param  This                  A pointer to the EFI_DEBUGPORT_PROTOCOL instance.

+  @param  Timeout               The number of microseconds to wait before timing out a read operation.

+  @param  BufferSize            On input, the requested number of bytes of data to read. On output, the

+                                number of bytes of data actually number of bytes

+                                of data read and returned in Buffer.

+  @param  Buffer                A pointer to a buffer into which the data read will be saved.

+

+  @retval EFI_SUCCESS           The data was read.

+  @retval EFI_DEVICE_ERROR      The device reported an error.

+  @retval EFI_TIMEOUT           The operation was stopped due to a timeout or overrun.

+

+**/

+typedef

+EFI_STATUS

+(EFIAPI *EFI_DEBUGPORT_READ)(

+  IN EFI_DEBUGPORT_PROTOCOL               *This,

+  IN UINT32                               Timeout,

+  IN OUT UINTN                            *BufferSize,

+  OUT VOID                                *Buffer

+  );

+

+/**

+  Checks to see if any data is available to be read from the debugport device.

+

+  @param  This                  A pointer to the EFI_DEBUGPORT_PROTOCOL instance.

+

+  @retval EFI_SUCCESS           At least one byte of data is available to be read.

+  @retval EFI_DEVICE_ERROR      The debugport device is not functioning correctly.

+  @retval EFI_NOT_READY         No data is available to be read.

+

+**/

+typedef

+EFI_STATUS

+(EFIAPI *EFI_DEBUGPORT_POLL)(

+  IN EFI_DEBUGPORT_PROTOCOL               *This

+  );

+

+///

+/// This protocol provides the communication link between the debug agent and the remote host.

+///

+struct _EFI_DEBUGPORT_PROTOCOL {

+  EFI_DEBUGPORT_RESET Reset;

+  EFI_DEBUGPORT_WRITE Write;

+  EFI_DEBUGPORT_READ  Read;

+  EFI_DEBUGPORT_POLL  Poll;

+};

+

+//

+// DEBUGPORT variable definitions...

+//

+#define EFI_DEBUGPORT_VARIABLE_NAME L"DEBUGPORT"

+#define EFI_DEBUGPORT_VARIABLE_GUID EFI_DEBUGPORT_PROTOCOL_GUID

+

+extern EFI_GUID  gEfiDebugPortVariableGuid;

+

+//

+// DebugPort device path definitions...

+//

+#define DEVICE_PATH_MESSAGING_DEBUGPORT EFI_DEBUGPORT_PROTOCOL_GUID

+

+extern EFI_GUID  gEfiDebugPortDevicePathGuid;

+

+typedef struct {

+  EFI_DEVICE_PATH_PROTOCOL  Header;

+  EFI_GUID                  Guid;

+} DEBUGPORT_DEVICE_PATH;

+

+#endif

diff --git a/debugging_demo/memtest86+/efi/Include/Protocol/DevicePath.h b/debugging_demo/memtest86+/efi/Include/Protocol/DevicePath.h
new file mode 100644
index 0000000..d826208
--- /dev/null
+++ b/debugging_demo/memtest86+/efi/Include/Protocol/DevicePath.h
@@ -0,0 +1,1378 @@
+/** @file

+  The device path protocol as defined in UEFI 2.0.

+

+  The device path represents a programmatic path to a device,

+  from a software point of view. The path must persist from boot to boot, so

+  it can not contain things like PCI bus numbers that change from boot to boot.

+

+Copyright (c) 2006 - 2018, Intel Corporation. All rights reserved.<BR>

+SPDX-License-Identifier: BSD-2-Clause-Patent

+

+**/

+

+#ifndef __EFI_DEVICE_PATH_PROTOCOL_H__

+#define __EFI_DEVICE_PATH_PROTOCOL_H__

+

+#include <IndustryStandard/Bluetooth.h>

+#include <IndustryStandard/Acpi60.h>

+

+///

+/// Device Path protocol.

+///

+#define EFI_DEVICE_PATH_PROTOCOL_GUID \

+  { \

+    0x9576e91, 0x6d3f, 0x11d2, {0x8e, 0x39, 0x0, 0xa0, 0xc9, 0x69, 0x72, 0x3b } \

+  }

+

+///

+/// Device Path guid definition for backward-compatible with EFI1.1.

+///

+#define DEVICE_PATH_PROTOCOL  EFI_DEVICE_PATH_PROTOCOL_GUID

+

+#pragma pack(1)

+

+/**

+  This protocol can be used on any device handle to obtain generic path/location

+  information concerning the physical device or logical device. If the handle does

+  not logically map to a physical device, the handle may not necessarily support

+  the device path protocol. The device path describes the location of the device

+  the handle is for. The size of the Device Path can be determined from the structures

+  that make up the Device Path.

+**/

+typedef struct {

+  UINT8 Type;       ///< 0x01 Hardware Device Path.

+                    ///< 0x02 ACPI Device Path.

+                    ///< 0x03 Messaging Device Path.

+                    ///< 0x04 Media Device Path.

+                    ///< 0x05 BIOS Boot Specification Device Path.

+                    ///< 0x7F End of Hardware Device Path.

+

+  UINT8 SubType;    ///< Varies by Type

+                    ///< 0xFF End Entire Device Path, or

+                    ///< 0x01 End This Instance of a Device Path and start a new

+                    ///< Device Path.

+

+  UINT8 Length[2];  ///< Specific Device Path data. Type and Sub-Type define

+                    ///< type of data. Size of data is included in Length.

+

+} EFI_DEVICE_PATH_PROTOCOL;

+

+///

+/// Device Path protocol definition for backward-compatible with EFI1.1.

+///

+typedef EFI_DEVICE_PATH_PROTOCOL  EFI_DEVICE_PATH;

+

+///

+/// Hardware Device Paths.

+///

+#define HARDWARE_DEVICE_PATH      0x01

+

+///

+/// PCI Device Path SubType.

+///

+#define HW_PCI_DP                 0x01

+

+///

+/// PCI Device Path.

+///

+typedef struct {

+  EFI_DEVICE_PATH_PROTOCOL        Header;

+  ///

+  /// PCI Function Number.

+  ///

+  UINT8                           Function;

+  ///

+  /// PCI Device Number.

+  ///

+  UINT8                           Device;

+} PCI_DEVICE_PATH;

+

+///

+/// PCCARD Device Path SubType.

+///

+#define HW_PCCARD_DP              0x02

+

+///

+/// PCCARD Device Path.

+///

+typedef struct {

+  EFI_DEVICE_PATH_PROTOCOL        Header;

+  ///

+  /// Function Number (0 = First Function).

+  ///

+  UINT8                           FunctionNumber;

+} PCCARD_DEVICE_PATH;

+

+///

+/// Memory Mapped Device Path SubType.

+///

+#define HW_MEMMAP_DP              0x03

+

+///

+/// Memory Mapped Device Path.

+///

+typedef struct {

+  EFI_DEVICE_PATH_PROTOCOL        Header;

+  ///

+  /// EFI_MEMORY_TYPE

+  ///

+  UINT32                          MemoryType;

+  ///

+  /// Starting Memory Address.

+  ///

+  EFI_PHYSICAL_ADDRESS            StartingAddress;

+  ///

+  /// Ending Memory Address.

+  ///

+  EFI_PHYSICAL_ADDRESS            EndingAddress;

+} MEMMAP_DEVICE_PATH;

+

+///

+/// Hardware Vendor Device Path SubType.

+///

+#define HW_VENDOR_DP              0x04

+

+///

+/// The Vendor Device Path allows the creation of vendor-defined Device Paths. A vendor must

+/// allocate a Vendor GUID for a Device Path. The Vendor GUID can then be used to define the

+/// contents on the n bytes that follow in the Vendor Device Path node.

+///

+typedef struct {

+  EFI_DEVICE_PATH_PROTOCOL        Header;

+  ///

+  /// Vendor-assigned GUID that defines the data that follows.

+  ///

+  EFI_GUID                        Guid;

+  ///

+  /// Vendor-defined variable size data.

+  ///

+} VENDOR_DEVICE_PATH;

+

+///

+/// Controller Device Path SubType.

+///

+#define HW_CONTROLLER_DP          0x05

+

+///

+/// Controller Device Path.

+///

+typedef struct {

+  EFI_DEVICE_PATH_PROTOCOL        Header;

+  ///

+  /// Controller number.

+  ///

+  UINT32                          ControllerNumber;

+} CONTROLLER_DEVICE_PATH;

+

+///

+/// BMC Device Path SubType.

+///

+#define HW_BMC_DP                 0x06

+

+///

+/// BMC Device Path.

+///

+typedef struct {

+  EFI_DEVICE_PATH_PROTOCOL        Header;

+  ///

+  /// Interface Type.

+  ///

+  UINT8                           InterfaceType;

+  ///

+  /// Base Address.

+  ///

+  UINT8                           BaseAddress[8];

+} BMC_DEVICE_PATH;

+

+///

+/// ACPI Device Paths.

+///

+#define ACPI_DEVICE_PATH          0x02

+

+///

+/// ACPI Device Path SubType.

+///

+#define ACPI_DP                   0x01

+typedef struct {

+  EFI_DEVICE_PATH_PROTOCOL        Header;

+  ///

+  /// Device's PnP hardware ID stored in a numeric 32-bit

+  /// compressed EISA-type ID. This value must match the

+  /// corresponding _HID in the ACPI name space.

+  ///

+  UINT32                          HID;

+  ///

+  /// Unique ID that is required by ACPI if two devices have the

+  /// same _HID. This value must also match the corresponding

+  /// _UID/_HID pair in the ACPI name space. Only the 32-bit

+  /// numeric value type of _UID is supported. Thus, strings must

+  /// not be used for the _UID in the ACPI name space.

+  ///

+  UINT32                          UID;

+} ACPI_HID_DEVICE_PATH;

+

+///

+/// Expanded ACPI Device Path SubType.

+///

+#define ACPI_EXTENDED_DP          0x02

+typedef struct {

+  EFI_DEVICE_PATH_PROTOCOL        Header;

+  ///

+  /// Device's PnP hardware ID stored in a numeric 32-bit

+  /// compressed EISA-type ID. This value must match the

+  /// corresponding _HID in the ACPI name space.

+  ///

+  UINT32                          HID;

+  ///

+  /// Unique ID that is required by ACPI if two devices have the

+  /// same _HID. This value must also match the corresponding

+  /// _UID/_HID pair in the ACPI name space.

+  ///

+  UINT32                          UID;

+  ///

+  /// Device's compatible PnP hardware ID stored in a numeric

+  /// 32-bit compressed EISA-type ID. This value must match at

+  /// least one of the compatible device IDs returned by the

+  /// corresponding _CID in the ACPI name space.

+  ///

+  UINT32                          CID;

+  ///

+  /// Optional variable length _HIDSTR.

+  /// Optional variable length _UIDSTR.

+  /// Optional variable length _CIDSTR.

+  ///

+} ACPI_EXTENDED_HID_DEVICE_PATH;

+

+//

+//  EISA ID Macro

+//  EISA ID Definition 32-bits

+//   bits[15:0] - three character compressed ASCII EISA ID.

+//   bits[31:16] - binary number

+//    Compressed ASCII is 5 bits per character 0b00001 = 'A' 0b11010 = 'Z'

+//

+#define PNP_EISA_ID_CONST         0x41d0

+#define EISA_ID(_Name, _Num)      ((UINT32)((_Name) | (_Num) << 16))

+#define EISA_PNP_ID(_PNPId)       (EISA_ID(PNP_EISA_ID_CONST, (_PNPId)))

+#define EFI_PNP_ID(_PNPId)        (EISA_ID(PNP_EISA_ID_CONST, (_PNPId)))

+

+#define PNP_EISA_ID_MASK          0xffff

+#define EISA_ID_TO_NUM(_Id)       ((_Id) >> 16)

+

+///

+/// ACPI _ADR Device Path SubType.

+///

+#define ACPI_ADR_DP               0x03

+

+///

+/// The _ADR device path is used to contain video output device attributes to support the Graphics

+/// Output Protocol. The device path can contain multiple _ADR entries if multiple video output

+/// devices are displaying the same output.

+///

+typedef struct {

+  EFI_DEVICE_PATH_PROTOCOL        Header;

+  ///

+  /// _ADR value. For video output devices the value of this

+  /// field comes from Table B-2 of the ACPI 3.0 specification. At

+  /// least one _ADR value is required.

+  ///

+  UINT32                          ADR;

+  //

+  // This device path may optionally contain more than one _ADR entry.

+  //

+} ACPI_ADR_DEVICE_PATH;

+

+///

+/// ACPI NVDIMM Device Path SubType.

+///

+#define ACPI_NVDIMM_DP               0x04

+///

+///

+typedef struct {

+  EFI_DEVICE_PATH_PROTOCOL        Header;

+  ///

+  /// NFIT Device Handle, the _ADR of the NVDIMM device.

+  /// The value of this field comes from Section 9.20.3 of the ACPI 6.2A specification.

+  ///

+  UINT32                          NFITDeviceHandle;

+} ACPI_NVDIMM_DEVICE_PATH;

+

+#define ACPI_ADR_DISPLAY_TYPE_OTHER             0

+#define ACPI_ADR_DISPLAY_TYPE_VGA               1

+#define ACPI_ADR_DISPLAY_TYPE_TV                2

+#define ACPI_ADR_DISPLAY_TYPE_EXTERNAL_DIGITAL  3

+#define ACPI_ADR_DISPLAY_TYPE_INTERNAL_DIGITAL  4

+

+#define ACPI_DISPLAY_ADR(_DeviceIdScheme, _HeadId, _NonVgaOutput, _BiosCanDetect, _VendorInfo, _Type, _Port, _Index) \

+          ((UINT32)(  ((UINT32)((_DeviceIdScheme) & 0x1) << 31) |  \

+                      (((_HeadId)                 & 0x7) << 18) |  \

+                      (((_NonVgaOutput)           & 0x1) << 17) |  \

+                      (((_BiosCanDetect)          & 0x1) << 16) |  \

+                      (((_VendorInfo)             & 0xf) << 12) |  \

+                      (((_Type)                   & 0xf) << 8)  |  \

+                      (((_Port)                   & 0xf) << 4)  |  \

+                       ((_Index)                  & 0xf) ))

+

+///

+/// Messaging Device Paths.

+/// This Device Path is used to describe the connection of devices outside the resource domain of the

+/// system. This Device Path can describe physical messaging information like SCSI ID, or abstract

+/// information like networking protocol IP addresses.

+///

+#define MESSAGING_DEVICE_PATH     0x03

+

+///

+/// ATAPI Device Path SubType

+///

+#define MSG_ATAPI_DP              0x01

+typedef struct {

+  EFI_DEVICE_PATH_PROTOCOL        Header;

+  ///

+  /// Set to zero for primary, or one for secondary.

+  ///

+  UINT8                           PrimarySecondary;

+  ///

+  /// Set to zero for master, or one for slave mode.

+  ///

+  UINT8                           SlaveMaster;

+  ///

+  /// Logical Unit Number.

+  ///

+  UINT16                          Lun;

+} ATAPI_DEVICE_PATH;

+

+///

+/// SCSI Device Path SubType.

+///

+#define MSG_SCSI_DP               0x02

+typedef struct {

+  EFI_DEVICE_PATH_PROTOCOL        Header;

+  ///

+  /// Target ID on the SCSI bus (PUN).

+  ///

+  UINT16                          Pun;

+  ///

+  /// Logical Unit Number (LUN).

+  ///

+  UINT16                          Lun;

+} SCSI_DEVICE_PATH;

+

+///

+/// Fibre Channel SubType.

+///

+#define MSG_FIBRECHANNEL_DP       0x03

+typedef struct {

+  EFI_DEVICE_PATH_PROTOCOL        Header;

+  ///

+  /// Reserved for the future.

+  ///

+  UINT32                          Reserved;

+  ///

+  /// Fibre Channel World Wide Number.

+  ///

+  UINT64                          WWN;

+  ///

+  /// Fibre Channel Logical Unit Number.

+  ///

+  UINT64                          Lun;

+} FIBRECHANNEL_DEVICE_PATH;

+

+///

+/// Fibre Channel Ex SubType.

+///

+#define MSG_FIBRECHANNELEX_DP     0x15

+typedef struct {

+  EFI_DEVICE_PATH_PROTOCOL        Header;

+  ///

+  /// Reserved for the future.

+  ///

+  UINT32                          Reserved;

+  ///

+  /// 8 byte array containing Fibre Channel End Device Port Name.

+  ///

+  UINT8                           WWN[8];

+  ///

+  /// 8 byte array containing Fibre Channel Logical Unit Number.

+  ///

+  UINT8                           Lun[8];

+} FIBRECHANNELEX_DEVICE_PATH;

+

+///

+/// 1394 Device Path SubType

+///

+#define MSG_1394_DP               0x04

+typedef struct {

+  EFI_DEVICE_PATH_PROTOCOL        Header;

+  ///

+  /// Reserved for the future.

+  ///

+  UINT32                          Reserved;

+  ///

+  /// 1394 Global Unique ID (GUID).

+  ///

+  UINT64                          Guid;

+} F1394_DEVICE_PATH;

+

+///

+/// USB Device Path SubType.

+///

+#define MSG_USB_DP                0x05

+typedef struct {

+  EFI_DEVICE_PATH_PROTOCOL      Header;

+  ///

+  /// USB Parent Port Number.

+  ///

+  UINT8                         ParentPortNumber;

+  ///

+  /// USB Interface Number.

+  ///

+  UINT8                         InterfaceNumber;

+} USB_DEVICE_PATH;

+

+///

+/// USB Class Device Path SubType.

+///

+#define MSG_USB_CLASS_DP          0x0f

+typedef struct {

+  EFI_DEVICE_PATH_PROTOCOL      Header;

+  ///

+  /// Vendor ID assigned by USB-IF. A value of 0xFFFF will

+  /// match any Vendor ID.

+  ///

+  UINT16                        VendorId;

+  ///

+  /// Product ID assigned by USB-IF. A value of 0xFFFF will

+  /// match any Product ID.

+  ///

+  UINT16                        ProductId;

+  ///

+  /// The class code assigned by the USB-IF. A value of 0xFF

+  /// will match any class code.

+  ///

+  UINT8                         DeviceClass;

+  ///

+  /// The subclass code assigned by the USB-IF. A value of

+  /// 0xFF will match any subclass code.

+  ///

+  UINT8                         DeviceSubClass;

+  ///

+  /// The protocol code assigned by the USB-IF. A value of

+  /// 0xFF will match any protocol code.

+  ///

+  UINT8                         DeviceProtocol;

+} USB_CLASS_DEVICE_PATH;

+

+///

+/// USB WWID Device Path SubType.

+///

+#define MSG_USB_WWID_DP           0x10

+

+///

+/// This device path describes a USB device using its serial number.

+///

+typedef struct {

+  EFI_DEVICE_PATH_PROTOCOL      Header;

+  ///

+  /// USB interface number.

+  ///

+  UINT16                        InterfaceNumber;

+  ///

+  /// USB vendor id of the device.

+  ///

+  UINT16                        VendorId;

+  ///

+  /// USB product id of the device.

+  ///

+  UINT16                        ProductId;

+  ///

+  /// Last 64-or-fewer UTF-16 characters of the USB

+  /// serial number. The length of the string is

+  /// determined by the Length field less the offset of the

+  /// Serial Number field (10)

+  ///

+  /// CHAR16                     SerialNumber[...];

+} USB_WWID_DEVICE_PATH;

+

+///

+/// Device Logical Unit SubType.

+///

+#define MSG_DEVICE_LOGICAL_UNIT_DP  0x11

+typedef struct {

+  EFI_DEVICE_PATH_PROTOCOL      Header;

+  ///

+  /// Logical Unit Number for the interface.

+  ///

+  UINT8                         Lun;

+} DEVICE_LOGICAL_UNIT_DEVICE_PATH;

+

+///

+/// SATA Device Path SubType.

+///

+#define MSG_SATA_DP               0x12

+typedef struct {

+  EFI_DEVICE_PATH_PROTOCOL        Header;

+  ///

+  /// The HBA port number that facilitates the connection to the

+  /// device or a port multiplier. The value 0xFFFF is reserved.

+  ///

+  UINT16                          HBAPortNumber;

+  ///

+  /// The Port multiplier port number that facilitates the connection

+  /// to the device. Must be set to 0xFFFF if the device is directly

+  /// connected to the HBA.

+  ///

+  UINT16                          PortMultiplierPortNumber;

+  ///

+  /// Logical Unit Number.

+  ///

+  UINT16                          Lun;

+} SATA_DEVICE_PATH;

+

+///

+/// Flag for if the device is directly connected to the HBA.

+///

+#define SATA_HBA_DIRECT_CONNECT_FLAG 0x8000

+

+///

+/// I2O Device Path SubType.

+///

+#define MSG_I2O_DP                0x06

+typedef struct {

+  EFI_DEVICE_PATH_PROTOCOL        Header;

+  ///

+  /// Target ID (TID) for a device.

+  ///

+  UINT32                          Tid;

+} I2O_DEVICE_PATH;

+

+///

+/// MAC Address Device Path SubType.

+///

+#define MSG_MAC_ADDR_DP           0x0b

+typedef struct {

+  EFI_DEVICE_PATH_PROTOCOL        Header;

+  ///

+  /// The MAC address for a network interface padded with 0s.

+  ///

+  EFI_MAC_ADDRESS                 MacAddress;

+  ///

+  /// Network interface type(i.e. 802.3, FDDI).

+  ///

+  UINT8                           IfType;

+} MAC_ADDR_DEVICE_PATH;

+

+///

+/// IPv4 Device Path SubType

+///

+#define MSG_IPv4_DP               0x0c

+typedef struct {

+  EFI_DEVICE_PATH_PROTOCOL        Header;

+  ///

+  /// The local IPv4 address.

+  ///

+  EFI_IPv4_ADDRESS                LocalIpAddress;

+  ///

+  /// The remote IPv4 address.

+  ///

+  EFI_IPv4_ADDRESS                RemoteIpAddress;

+  ///

+  /// The local port number.

+  ///

+  UINT16                          LocalPort;

+  ///

+  /// The remote port number.

+  ///

+  UINT16                          RemotePort;

+  ///

+  /// The network protocol(i.e. UDP, TCP).

+  ///

+  UINT16                          Protocol;

+  ///

+  /// 0x00 - The Source IP Address was assigned though DHCP.

+  /// 0x01 - The Source IP Address is statically bound.

+  ///

+  BOOLEAN                         StaticIpAddress;

+  ///

+  /// The gateway IP address

+  ///

+  EFI_IPv4_ADDRESS                GatewayIpAddress;

+  ///

+  /// The subnet mask

+  ///

+  EFI_IPv4_ADDRESS                SubnetMask;

+} IPv4_DEVICE_PATH;

+

+///

+/// IPv6 Device Path SubType.

+///

+#define MSG_IPv6_DP               0x0d

+typedef struct {

+  EFI_DEVICE_PATH_PROTOCOL        Header;

+  ///

+  /// The local IPv6 address.

+  ///

+  EFI_IPv6_ADDRESS                LocalIpAddress;

+  ///

+  /// The remote IPv6 address.

+  ///

+  EFI_IPv6_ADDRESS                RemoteIpAddress;

+  ///

+  /// The local port number.

+  ///

+  UINT16                          LocalPort;

+  ///

+  /// The remote port number.

+  ///

+  UINT16                          RemotePort;

+  ///

+  /// The network protocol(i.e. UDP, TCP).

+  ///

+  UINT16                          Protocol;

+  ///

+  /// 0x00 - The Local IP Address was manually configured.

+  /// 0x01 - The Local IP Address is assigned through IPv6

+  /// stateless auto-configuration.

+  /// 0x02 - The Local IP Address is assigned through IPv6

+  /// stateful configuration.

+  ///

+  UINT8                           IpAddressOrigin;

+  ///

+  /// The prefix length

+  ///

+  UINT8                           PrefixLength;

+  ///

+  /// The gateway IP address

+  ///

+  EFI_IPv6_ADDRESS                GatewayIpAddress;

+} IPv6_DEVICE_PATH;

+

+///

+/// InfiniBand Device Path SubType.

+///

+#define MSG_INFINIBAND_DP         0x09

+typedef struct {

+  EFI_DEVICE_PATH_PROTOCOL        Header;

+  ///

+  /// Flags to help identify/manage InfiniBand device path elements:

+  /// Bit 0 - IOC/Service (0b = IOC, 1b = Service).

+  /// Bit 1 - Extend Boot Environment.

+  /// Bit 2 - Console Protocol.

+  /// Bit 3 - Storage Protocol.

+  /// Bit 4 - Network Protocol.

+  /// All other bits are reserved.

+  ///

+  UINT32                          ResourceFlags;

+  ///

+  /// 128-bit Global Identifier for remote fabric port.

+  ///

+  UINT8                           PortGid[16];

+  ///

+  /// 64-bit unique identifier to remote IOC or server process.

+  /// Interpretation of field specified by Resource Flags (bit 0).

+  ///

+  UINT64                          ServiceId;

+  ///

+  /// 64-bit persistent ID of remote IOC port.

+  ///

+  UINT64                          TargetPortId;

+  ///

+  /// 64-bit persistent ID of remote device.

+  ///

+  UINT64                          DeviceId;

+} INFINIBAND_DEVICE_PATH;

+

+#define INFINIBAND_RESOURCE_FLAG_IOC_SERVICE                0x01

+#define INFINIBAND_RESOURCE_FLAG_EXTENDED_BOOT_ENVIRONMENT  0x02

+#define INFINIBAND_RESOURCE_FLAG_CONSOLE_PROTOCOL           0x04

+#define INFINIBAND_RESOURCE_FLAG_STORAGE_PROTOCOL           0x08

+#define INFINIBAND_RESOURCE_FLAG_NETWORK_PROTOCOL           0x10

+

+///

+/// UART Device Path SubType.

+///

+#define MSG_UART_DP               0x0e

+typedef struct {

+  EFI_DEVICE_PATH_PROTOCOL        Header;

+  ///

+  /// Reserved.

+  ///

+  UINT32                          Reserved;

+  ///

+  /// The baud rate setting for the UART style device. A value of 0

+  /// means that the device's default baud rate will be used.

+  ///

+  UINT64                          BaudRate;

+  ///

+  /// The number of data bits for the UART style device. A value

+  /// of 0 means that the device's default number of data bits will be used.

+  ///

+  UINT8                           DataBits;

+  ///

+  /// The parity setting for the UART style device.

+  /// Parity 0x00 - Default Parity.

+  /// Parity 0x01 - No Parity.

+  /// Parity 0x02 - Even Parity.

+  /// Parity 0x03 - Odd Parity.

+  /// Parity 0x04 - Mark Parity.

+  /// Parity 0x05 - Space Parity.

+  ///

+  UINT8                           Parity;

+  ///

+  /// The number of stop bits for the UART style device.

+  /// Stop Bits 0x00 - Default Stop Bits.

+  /// Stop Bits 0x01 - 1 Stop Bit.

+  /// Stop Bits 0x02 - 1.5 Stop Bits.

+  /// Stop Bits 0x03 - 2 Stop Bits.

+  ///

+  UINT8                           StopBits;

+} UART_DEVICE_PATH;

+

+///

+/// NVDIMM Namespace Device Path SubType.

+///

+#define NVDIMM_NAMESPACE_DP               0x20

+typedef struct {

+  EFI_DEVICE_PATH_PROTOCOL        Header;

+  ///

+  /// Namespace unique label identifier UUID.

+  ///

+  EFI_GUID Uuid;

+} NVDIMM_NAMESPACE_DEVICE_PATH;

+

+//

+// Use VENDOR_DEVICE_PATH struct

+//

+#define MSG_VENDOR_DP             0x0a

+typedef VENDOR_DEVICE_PATH        VENDOR_DEFINED_DEVICE_PATH;

+

+#define DEVICE_PATH_MESSAGING_PC_ANSI     EFI_PC_ANSI_GUID

+#define DEVICE_PATH_MESSAGING_VT_100      EFI_VT_100_GUID

+#define DEVICE_PATH_MESSAGING_VT_100_PLUS EFI_VT_100_PLUS_GUID

+#define DEVICE_PATH_MESSAGING_VT_UTF8     EFI_VT_UTF8_GUID

+

+///

+/// A new device path node is defined to declare flow control characteristics.

+/// UART Flow Control Messaging Device Path

+///

+typedef struct {

+  EFI_DEVICE_PATH_PROTOCOL        Header;

+  ///

+  /// DEVICE_PATH_MESSAGING_UART_FLOW_CONTROL GUID.

+  ///

+  EFI_GUID                        Guid;

+  ///

+  /// Bitmap of supported flow control types.

+  /// Bit 0 set indicates hardware flow control.

+  /// Bit 1 set indicates Xon/Xoff flow control.

+  /// All other bits are reserved and are clear.

+  ///

+  UINT32                          FlowControlMap;

+} UART_FLOW_CONTROL_DEVICE_PATH;

+

+#define UART_FLOW_CONTROL_HARDWARE         0x00000001

+#define UART_FLOW_CONTROL_XON_XOFF         0x00000010

+

+#define DEVICE_PATH_MESSAGING_SAS          EFI_SAS_DEVICE_PATH_GUID

+///

+/// Serial Attached SCSI (SAS) Device Path.

+///

+typedef struct {

+  EFI_DEVICE_PATH_PROTOCOL        Header;

+  ///

+  /// DEVICE_PATH_MESSAGING_SAS GUID.

+  ///

+  EFI_GUID                        Guid;

+  ///

+  /// Reserved for future use.

+  ///

+  UINT32                          Reserved;

+  ///

+  /// SAS Address for Serial Attached SCSI Target.

+  ///

+  UINT64                          SasAddress;

+  ///

+  /// SAS Logical Unit Number.

+  ///

+  UINT64                          Lun;

+  ///

+  /// More Information about the device and its interconnect.

+  ///

+  UINT16                          DeviceTopology;

+  ///

+  /// Relative Target Port (RTP).

+  ///

+  UINT16                          RelativeTargetPort;

+} SAS_DEVICE_PATH;

+

+///

+/// Serial Attached SCSI (SAS) Ex Device Path SubType

+///

+#define MSG_SASEX_DP              0x16

+typedef struct {

+  EFI_DEVICE_PATH_PROTOCOL        Header;

+  ///

+  /// 8-byte array of the SAS Address for Serial Attached SCSI Target Port.

+  ///

+  UINT8                           SasAddress[8];

+  ///

+  /// 8-byte array of the SAS Logical Unit Number.

+  ///

+  UINT8                           Lun[8];

+  ///

+  /// More Information about the device and its interconnect.

+  ///

+  UINT16                          DeviceTopology;

+  ///

+  /// Relative Target Port (RTP).

+  ///

+  UINT16                          RelativeTargetPort;

+} SASEX_DEVICE_PATH;

+

+///

+/// NvmExpress Namespace Device Path SubType.

+///

+#define MSG_NVME_NAMESPACE_DP     0x17

+typedef struct {

+  EFI_DEVICE_PATH_PROTOCOL        Header;

+  UINT32                          NamespaceId;

+  UINT64                          NamespaceUuid;

+} NVME_NAMESPACE_DEVICE_PATH;

+

+///

+/// DNS Device Path SubType

+///

+#define MSG_DNS_DP                0x1F

+typedef struct {

+  EFI_DEVICE_PATH_PROTOCOL        Header;

+  ///

+  /// Indicates the DNS server address is IPv4 or IPv6 address.

+  ///

+  UINT8                           IsIPv6;

+  ///

+  /// Instance of the DNS server address.

+  ///

+  EFI_IP_ADDRESS                  DnsServerIp[];

+} DNS_DEVICE_PATH;

+

+///

+/// Uniform Resource Identifiers (URI) Device Path SubType

+///

+#define MSG_URI_DP                0x18

+typedef struct {

+  EFI_DEVICE_PATH_PROTOCOL        Header;

+  ///

+  /// Instance of the URI pursuant to RFC 3986.

+  ///

+  CHAR8                           Uri[];

+} URI_DEVICE_PATH;

+

+///

+/// Universal Flash Storage (UFS) Device Path SubType.

+///

+#define MSG_UFS_DP                0x19

+typedef struct {

+  EFI_DEVICE_PATH_PROTOCOL        Header;

+  ///

+  /// Target ID on the UFS bus (PUN).

+  ///

+  UINT8                           Pun;

+  ///

+  /// Logical Unit Number (LUN).

+  ///

+  UINT8                           Lun;

+} UFS_DEVICE_PATH;

+

+///

+/// SD (Secure Digital) Device Path SubType.

+///

+#define MSG_SD_DP                 0x1A

+typedef struct {

+  EFI_DEVICE_PATH_PROTOCOL        Header;

+  UINT8                           SlotNumber;

+} SD_DEVICE_PATH;

+

+///

+/// EMMC (Embedded MMC) Device Path SubType.

+///

+#define MSG_EMMC_DP                 0x1D

+typedef struct {

+  EFI_DEVICE_PATH_PROTOCOL        Header;

+  UINT8                           SlotNumber;

+} EMMC_DEVICE_PATH;

+

+///

+/// iSCSI Device Path SubType

+///

+#define MSG_ISCSI_DP              0x13

+typedef struct {

+  EFI_DEVICE_PATH_PROTOCOL        Header;

+  ///

+  /// Network Protocol (0 = TCP, 1+ = reserved).

+  ///

+  UINT16                          NetworkProtocol;

+  ///

+  /// iSCSI Login Options.

+  ///

+  UINT16                          LoginOption;

+  ///

+  /// iSCSI Logical Unit Number.

+  ///

+  UINT64                          Lun;

+  ///

+  /// iSCSI Target Portal group tag the initiator intends

+  /// to establish a session with.

+  ///

+  UINT16                          TargetPortalGroupTag;

+  ///

+  /// iSCSI NodeTarget Name. The length of the name

+  /// is determined by subtracting the offset of this field from Length.

+  ///

+  /// CHAR8                        iSCSI Target Name.

+} ISCSI_DEVICE_PATH;

+

+#define ISCSI_LOGIN_OPTION_NO_HEADER_DIGEST             0x0000

+#define ISCSI_LOGIN_OPTION_HEADER_DIGEST_USING_CRC32C   0x0002

+#define ISCSI_LOGIN_OPTION_NO_DATA_DIGEST               0x0000

+#define ISCSI_LOGIN_OPTION_DATA_DIGEST_USING_CRC32C     0x0008

+#define ISCSI_LOGIN_OPTION_AUTHMETHOD_CHAP              0x0000

+#define ISCSI_LOGIN_OPTION_AUTHMETHOD_NON               0x1000

+#define ISCSI_LOGIN_OPTION_CHAP_BI                      0x0000

+#define ISCSI_LOGIN_OPTION_CHAP_UNI                     0x2000

+

+///

+/// VLAN Device Path SubType.

+///

+#define MSG_VLAN_DP               0x14

+typedef struct {

+  EFI_DEVICE_PATH_PROTOCOL        Header;

+  ///

+  /// VLAN identifier (0-4094).

+  ///

+  UINT16                          VlanId;

+} VLAN_DEVICE_PATH;

+

+///

+/// Bluetooth Device Path SubType.

+///

+#define MSG_BLUETOOTH_DP     0x1b

+typedef struct {

+  EFI_DEVICE_PATH_PROTOCOL        Header;

+  ///

+  /// 48bit Bluetooth device address.

+  ///

+  BLUETOOTH_ADDRESS               BD_ADDR;

+} BLUETOOTH_DEVICE_PATH;

+

+///

+/// Wi-Fi Device Path SubType.

+///

+#define MSG_WIFI_DP               0x1C

+typedef struct {

+  EFI_DEVICE_PATH_PROTOCOL        Header;

+  ///

+  /// Service set identifier. A 32-byte octets string.

+  ///

+  UINT8                           SSId[32];

+} WIFI_DEVICE_PATH;

+

+///

+/// Bluetooth LE Device Path SubType.

+///

+#define MSG_BLUETOOTH_LE_DP       0x1E

+typedef struct {

+  EFI_DEVICE_PATH_PROTOCOL        Header;

+  BLUETOOTH_LE_ADDRESS            Address;

+} BLUETOOTH_LE_DEVICE_PATH;

+

+//

+// Media Device Path

+//

+#define MEDIA_DEVICE_PATH         0x04

+

+///

+/// Hard Drive Media Device Path SubType.

+///

+#define MEDIA_HARDDRIVE_DP        0x01

+

+///

+/// The Hard Drive Media Device Path is used to represent a partition on a hard drive.

+///

+typedef struct {

+  EFI_DEVICE_PATH_PROTOCOL        Header;

+  ///

+  /// Describes the entry in a partition table, starting with entry 1.

+  /// Partition number zero represents the entire device. Valid

+  /// partition numbers for a MBR partition are [1, 4]. Valid

+  /// partition numbers for a GPT partition are [1, NumberOfPartitionEntries].

+  ///

+  UINT32                          PartitionNumber;

+  ///

+  /// Starting LBA of the partition on the hard drive.

+  ///

+  UINT64                          PartitionStart;

+  ///

+  /// Size of the partition in units of Logical Blocks.

+  ///

+  UINT64                          PartitionSize;

+  ///

+  /// Signature unique to this partition:

+  /// If SignatureType is 0, this field has to be initialized with 16 zeros.

+  /// If SignatureType is 1, the MBR signature is stored in the first 4 bytes of this field.

+  /// The other 12 bytes are initialized with zeros.

+  /// If SignatureType is 2, this field contains a 16 byte signature.

+  ///

+  UINT8                           Signature[16];

+  ///

+  /// Partition Format: (Unused values reserved).

+  /// 0x01 - PC-AT compatible legacy MBR.

+  /// 0x02 - GUID Partition Table.

+  ///

+  UINT8                           MBRType;

+  ///

+  /// Type of Disk Signature: (Unused values reserved).

+  /// 0x00 - No Disk Signature.

+  /// 0x01 - 32-bit signature from address 0x1b8 of the type 0x01 MBR.

+  /// 0x02 - GUID signature.

+  ///

+  UINT8                           SignatureType;

+} HARDDRIVE_DEVICE_PATH;

+

+#define MBR_TYPE_PCAT             0x01

+#define MBR_TYPE_EFI_PARTITION_TABLE_HEADER 0x02

+

+#define NO_DISK_SIGNATURE         0x00

+#define SIGNATURE_TYPE_MBR        0x01

+#define SIGNATURE_TYPE_GUID       0x02

+

+///

+/// CD-ROM Media Device Path SubType.

+///

+#define MEDIA_CDROM_DP            0x02

+

+///

+/// The CD-ROM Media Device Path is used to define a system partition that exists on a CD-ROM.

+///

+typedef struct {

+  EFI_DEVICE_PATH_PROTOCOL        Header;

+  ///

+  /// Boot Entry number from the Boot Catalog. The Initial/Default entry is defined as zero.

+  ///

+  UINT32                          BootEntry;

+  ///

+  /// Starting RBA of the partition on the medium. CD-ROMs use Relative logical Block Addressing.

+  ///

+  UINT64                          PartitionStart;

+  ///

+  /// Size of the partition in units of Blocks, also called Sectors.

+  ///

+  UINT64                          PartitionSize;

+} CDROM_DEVICE_PATH;

+

+//

+// Use VENDOR_DEVICE_PATH struct

+//

+#define MEDIA_VENDOR_DP           0x03  ///< Media vendor device path subtype.

+

+///

+/// File Path Media Device Path SubType

+///

+#define MEDIA_FILEPATH_DP         0x04

+typedef struct {

+  EFI_DEVICE_PATH_PROTOCOL        Header;

+  ///

+  /// A NULL-terminated Path string including directory and file names.

+  ///

+  CHAR16                          PathName[1];

+} FILEPATH_DEVICE_PATH;

+

+#define SIZE_OF_FILEPATH_DEVICE_PATH  OFFSET_OF(FILEPATH_DEVICE_PATH,PathName)

+

+///

+/// Media Protocol Device Path SubType.

+///

+#define MEDIA_PROTOCOL_DP         0x05

+

+///

+/// The Media Protocol Device Path is used to denote the protocol that is being

+/// used in a device path at the location of the path specified.

+/// Many protocols are inherent to the style of device path.

+///

+typedef struct {

+  EFI_DEVICE_PATH_PROTOCOL        Header;

+  ///

+  /// The ID of the protocol.

+  ///

+  EFI_GUID                        Protocol;

+} MEDIA_PROTOCOL_DEVICE_PATH;

+

+///

+/// PIWG Firmware File SubType.

+///

+#define MEDIA_PIWG_FW_FILE_DP     0x06

+

+///

+/// This device path is used by systems implementing the UEFI PI Specification 1.0 to describe a firmware file.

+///

+typedef struct {

+  EFI_DEVICE_PATH_PROTOCOL        Header;

+  ///

+  /// Firmware file name

+  ///

+  EFI_GUID                        FvFileName;

+} MEDIA_FW_VOL_FILEPATH_DEVICE_PATH;

+

+///

+/// PIWG Firmware Volume Device Path SubType.

+///

+#define MEDIA_PIWG_FW_VOL_DP      0x07

+

+///

+/// This device path is used by systems implementing the UEFI PI Specification 1.0 to describe a firmware volume.

+///

+typedef struct {

+  EFI_DEVICE_PATH_PROTOCOL        Header;

+  ///

+  /// Firmware volume name.

+  ///

+  EFI_GUID                        FvName;

+} MEDIA_FW_VOL_DEVICE_PATH;

+

+///

+/// Media relative offset range device path.

+///

+#define MEDIA_RELATIVE_OFFSET_RANGE_DP 0x08

+

+///

+/// Used to describe the offset range of media relative.

+///

+typedef struct {

+  EFI_DEVICE_PATH_PROTOCOL  Header;

+  UINT32                    Reserved;

+  UINT64                    StartingOffset;

+  UINT64                    EndingOffset;

+} MEDIA_RELATIVE_OFFSET_RANGE_DEVICE_PATH;

+

+///

+/// This GUID defines a RAM Disk supporting a raw disk format in volatile memory.

+///

+#define EFI_VIRTUAL_DISK_GUID               EFI_ACPI_6_0_NFIT_GUID_RAM_DISK_SUPPORTING_VIRTUAL_DISK_REGION_VOLATILE

+

+extern  EFI_GUID                            gEfiVirtualDiskGuid;

+

+///

+/// This GUID defines a RAM Disk supporting an ISO image in volatile memory.

+///

+#define EFI_VIRTUAL_CD_GUID                 EFI_ACPI_6_0_NFIT_GUID_RAM_DISK_SUPPORTING_VIRTUAL_CD_REGION_VOLATILE

+

+extern  EFI_GUID                            gEfiVirtualCdGuid;

+

+///

+/// This GUID defines a RAM Disk supporting a raw disk format in persistent memory.

+///

+#define EFI_PERSISTENT_VIRTUAL_DISK_GUID    EFI_ACPI_6_0_NFIT_GUID_RAM_DISK_SUPPORTING_VIRTUAL_DISK_REGION_PERSISTENT

+

+extern  EFI_GUID                            gEfiPersistentVirtualDiskGuid;

+

+///

+/// This GUID defines a RAM Disk supporting an ISO image in persistent memory.

+///

+#define EFI_PERSISTENT_VIRTUAL_CD_GUID      EFI_ACPI_6_0_NFIT_GUID_RAM_DISK_SUPPORTING_VIRTUAL_CD_REGION_PERSISTENT

+

+extern  EFI_GUID                            gEfiPersistentVirtualCdGuid;

+

+///

+/// Media ram disk device path.

+///

+#define MEDIA_RAM_DISK_DP         0x09

+

+///

+/// Used to describe the ram disk device path.

+///

+typedef struct {

+  EFI_DEVICE_PATH_PROTOCOL        Header;

+  ///

+  /// Starting Memory Address.

+  ///

+  UINT32                          StartingAddr[2];

+  ///

+  /// Ending Memory Address.

+  ///

+  UINT32                          EndingAddr[2];

+  ///

+  /// GUID that defines the type of the RAM Disk.

+  ///

+  EFI_GUID                        TypeGuid;

+  ///

+  /// RAM Diskinstance number, if supported. The default value is zero.

+  ///

+  UINT16                          Instance;

+} MEDIA_RAM_DISK_DEVICE_PATH;

+

+///

+/// BIOS Boot Specification Device Path.

+///

+#define BBS_DEVICE_PATH           0x05

+

+///

+/// BIOS Boot Specification Device Path SubType.

+///

+#define BBS_BBS_DP                0x01

+

+///

+/// This Device Path is used to describe the booting of non-EFI-aware operating systems.

+///

+typedef struct {

+  EFI_DEVICE_PATH_PROTOCOL        Header;

+  ///

+  /// Device Type as defined by the BIOS Boot Specification.

+  ///

+  UINT16                          DeviceType;

+  ///

+  /// Status Flags as defined by the BIOS Boot Specification.

+  ///

+  UINT16                          StatusFlag;

+  ///

+  /// Null-terminated ASCII string that describes the boot device to a user.

+  ///

+  CHAR8                           String[1];

+} BBS_BBS_DEVICE_PATH;

+

+//

+// DeviceType definitions - from BBS specification

+//

+#define BBS_TYPE_FLOPPY           0x01

+#define BBS_TYPE_HARDDRIVE        0x02

+#define BBS_TYPE_CDROM            0x03

+#define BBS_TYPE_PCMCIA           0x04

+#define BBS_TYPE_USB              0x05

+#define BBS_TYPE_EMBEDDED_NETWORK 0x06

+#define BBS_TYPE_BEV              0x80

+#define BBS_TYPE_UNKNOWN          0xFF

+

+

+///

+/// Union of all possible Device Paths and pointers to Device Paths.

+///

+typedef union {

+  EFI_DEVICE_PATH_PROTOCOL                   DevPath;

+  PCI_DEVICE_PATH                            Pci;

+  PCCARD_DEVICE_PATH                         PcCard;

+  MEMMAP_DEVICE_PATH                         MemMap;

+  VENDOR_DEVICE_PATH                         Vendor;

+

+  CONTROLLER_DEVICE_PATH                     Controller;

+  BMC_DEVICE_PATH                            Bmc;

+  ACPI_HID_DEVICE_PATH                       Acpi;

+  ACPI_EXTENDED_HID_DEVICE_PATH              ExtendedAcpi;

+  ACPI_ADR_DEVICE_PATH                       AcpiAdr;

+

+  ATAPI_DEVICE_PATH                          Atapi;

+  SCSI_DEVICE_PATH                           Scsi;

+  ISCSI_DEVICE_PATH                          Iscsi;

+  FIBRECHANNEL_DEVICE_PATH                   FibreChannel;

+  FIBRECHANNELEX_DEVICE_PATH                 FibreChannelEx;

+

+  F1394_DEVICE_PATH                          F1394;

+  USB_DEVICE_PATH                            Usb;

+  SATA_DEVICE_PATH                           Sata;

+  USB_CLASS_DEVICE_PATH                      UsbClass;

+  USB_WWID_DEVICE_PATH                       UsbWwid;

+  DEVICE_LOGICAL_UNIT_DEVICE_PATH            LogicUnit;

+  I2O_DEVICE_PATH                            I2O;

+  MAC_ADDR_DEVICE_PATH                       MacAddr;

+  IPv4_DEVICE_PATH                           Ipv4;

+  IPv6_DEVICE_PATH                           Ipv6;

+  VLAN_DEVICE_PATH                           Vlan;

+  INFINIBAND_DEVICE_PATH                     InfiniBand;

+  UART_DEVICE_PATH                           Uart;

+  UART_FLOW_CONTROL_DEVICE_PATH              UartFlowControl;

+  SAS_DEVICE_PATH                            Sas;

+  SASEX_DEVICE_PATH                          SasEx;

+  NVME_NAMESPACE_DEVICE_PATH                 NvmeNamespace;

+  DNS_DEVICE_PATH                            Dns;

+  URI_DEVICE_PATH                            Uri;

+  BLUETOOTH_DEVICE_PATH                      Bluetooth;

+  WIFI_DEVICE_PATH                           WiFi;

+  UFS_DEVICE_PATH                            Ufs;

+  SD_DEVICE_PATH                             Sd;

+  EMMC_DEVICE_PATH                           Emmc;

+  HARDDRIVE_DEVICE_PATH                      HardDrive;

+  CDROM_DEVICE_PATH                          CD;

+

+  FILEPATH_DEVICE_PATH                       FilePath;

+  MEDIA_PROTOCOL_DEVICE_PATH                 MediaProtocol;

+

+  MEDIA_FW_VOL_DEVICE_PATH                   FirmwareVolume;

+  MEDIA_FW_VOL_FILEPATH_DEVICE_PATH          FirmwareFile;

+  MEDIA_RELATIVE_OFFSET_RANGE_DEVICE_PATH    Offset;

+  MEDIA_RAM_DISK_DEVICE_PATH                 RamDisk;

+  BBS_BBS_DEVICE_PATH                        Bbs;

+} EFI_DEV_PATH;

+

+

+

+typedef union {

+  EFI_DEVICE_PATH_PROTOCOL                   *DevPath;

+  PCI_DEVICE_PATH                            *Pci;

+  PCCARD_DEVICE_PATH                         *PcCard;

+  MEMMAP_DEVICE_PATH                         *MemMap;

+  VENDOR_DEVICE_PATH                         *Vendor;

+

+  CONTROLLER_DEVICE_PATH                     *Controller;

+  BMC_DEVICE_PATH                            *Bmc;

+  ACPI_HID_DEVICE_PATH                       *Acpi;

+  ACPI_EXTENDED_HID_DEVICE_PATH              *ExtendedAcpi;

+  ACPI_ADR_DEVICE_PATH                       *AcpiAdr;

+

+  ATAPI_DEVICE_PATH                          *Atapi;

+  SCSI_DEVICE_PATH                           *Scsi;

+  ISCSI_DEVICE_PATH                          *Iscsi;

+  FIBRECHANNEL_DEVICE_PATH                   *FibreChannel;

+  FIBRECHANNELEX_DEVICE_PATH                 *FibreChannelEx;

+

+  F1394_DEVICE_PATH                          *F1394;

+  USB_DEVICE_PATH                            *Usb;

+  SATA_DEVICE_PATH                           *Sata;

+  USB_CLASS_DEVICE_PATH                      *UsbClass;

+  USB_WWID_DEVICE_PATH                       *UsbWwid;

+  DEVICE_LOGICAL_UNIT_DEVICE_PATH            *LogicUnit;

+  I2O_DEVICE_PATH                            *I2O;

+  MAC_ADDR_DEVICE_PATH                       *MacAddr;

+  IPv4_DEVICE_PATH                           *Ipv4;

+  IPv6_DEVICE_PATH                           *Ipv6;

+  VLAN_DEVICE_PATH                           *Vlan;

+  INFINIBAND_DEVICE_PATH                     *InfiniBand;

+  UART_DEVICE_PATH                           *Uart;

+  UART_FLOW_CONTROL_DEVICE_PATH              *UartFlowControl;

+  SAS_DEVICE_PATH                            *Sas;

+  SASEX_DEVICE_PATH                          *SasEx;

+  NVME_NAMESPACE_DEVICE_PATH                 *NvmeNamespace;

+  DNS_DEVICE_PATH                            *Dns;

+  URI_DEVICE_PATH                            *Uri;

+  BLUETOOTH_DEVICE_PATH                      *Bluetooth;

+  WIFI_DEVICE_PATH                           *WiFi;

+  UFS_DEVICE_PATH                            *Ufs;

+  SD_DEVICE_PATH                             *Sd;

+  EMMC_DEVICE_PATH                           *Emmc;

+  HARDDRIVE_DEVICE_PATH                      *HardDrive;

+  CDROM_DEVICE_PATH                          *CD;

+

+  FILEPATH_DEVICE_PATH                       *FilePath;

+  MEDIA_PROTOCOL_DEVICE_PATH                 *MediaProtocol;

+

+  MEDIA_FW_VOL_DEVICE_PATH                   *FirmwareVolume;

+  MEDIA_FW_VOL_FILEPATH_DEVICE_PATH          *FirmwareFile;

+  MEDIA_RELATIVE_OFFSET_RANGE_DEVICE_PATH    *Offset;

+  MEDIA_RAM_DISK_DEVICE_PATH                 *RamDisk;

+  BBS_BBS_DEVICE_PATH                        *Bbs;

+  UINT8                                      *Raw;

+} EFI_DEV_PATH_PTR;

+

+#pragma pack()

+

+#define END_DEVICE_PATH_TYPE                 0x7f

+#define END_ENTIRE_DEVICE_PATH_SUBTYPE       0xFF

+#define END_INSTANCE_DEVICE_PATH_SUBTYPE     0x01

+

+extern EFI_GUID gEfiDevicePathProtocolGuid;

+

+#endif

diff --git a/debugging_demo/memtest86+/efi/Include/Protocol/DevicePathFromText.h b/debugging_demo/memtest86+/efi/Include/Protocol/DevicePathFromText.h
new file mode 100644
index 0000000..5698020
--- /dev/null
+++ b/debugging_demo/memtest86+/efi/Include/Protocol/DevicePathFromText.h
@@ -0,0 +1,66 @@
+/** @file

+  EFI_DEVICE_PATH_FROM_TEXT_PROTOCOL as defined in UEFI 2.0.

+  This protocol provides service to convert text to device paths and device nodes.

+

+  Copyright (c) 2006 - 2018, Intel Corporation. All rights reserved.<BR>

+  SPDX-License-Identifier: BSD-2-Clause-Patent

+

+**/

+

+#ifndef __DEVICE_PATH_FROM_TEXT_PROTOCOL_H__

+#define __DEVICE_PATH_FROM_TEXT_PROTOCOL_H__

+

+///

+/// Device Path From Text protocol

+///

+#define EFI_DEVICE_PATH_FROM_TEXT_PROTOCOL_GUID \

+  { \

+    0x5c99a21, 0xc70f, 0x4ad2, {0x8a, 0x5f, 0x35, 0xdf, 0x33, 0x43, 0xf5, 0x1e  } \

+  }

+

+/**

+  Convert text to the binary representation of a device node.

+

+  @param  TextDeviceNode TextDeviceNode points to the text representation of a device

+                         node. Conversion starts with the first character and continues

+                         until the first non-device node character.

+

+  @retval a_pointer      Pointer to the EFI device node.

+  @retval NULL           if TextDeviceNode is NULL or there was insufficient memory.

+

+**/

+typedef

+EFI_DEVICE_PATH_PROTOCOL*

+(EFIAPI *EFI_DEVICE_PATH_FROM_TEXT_NODE)(

+  IN CONST CHAR16                 *TextDeviceNode

+  );

+

+

+/**

+  Convert text to the binary representation of a device node.

+

+  @param  TextDeviceNode TextDevicePath points to the text representation of a device

+                         path. Conversion starts with the first character and continues

+                         until the first non-device path character.

+

+  @retval a_pointer      Pointer to the allocated device path.

+  @retval NULL           if TextDeviceNode is NULL or there was insufficient memory.

+

+**/

+typedef

+EFI_DEVICE_PATH_PROTOCOL*

+(EFIAPI *EFI_DEVICE_PATH_FROM_TEXT_PATH)(

+  IN CONST CHAR16                 *TextDevicePath

+  );

+

+///

+/// This protocol converts text to device paths and device nodes.

+///

+typedef struct {

+  EFI_DEVICE_PATH_FROM_TEXT_NODE  ConvertTextToDeviceNode;

+  EFI_DEVICE_PATH_FROM_TEXT_PATH  ConvertTextToDevicePath;

+} EFI_DEVICE_PATH_FROM_TEXT_PROTOCOL;

+

+extern EFI_GUID gEfiDevicePathFromTextProtocolGuid;

+

+#endif

diff --git a/debugging_demo/memtest86+/efi/Include/Protocol/DevicePathToText.h b/debugging_demo/memtest86+/efi/Include/Protocol/DevicePathToText.h
new file mode 100644
index 0000000..245dae4
--- /dev/null
+++ b/debugging_demo/memtest86+/efi/Include/Protocol/DevicePathToText.h
@@ -0,0 +1,79 @@
+/** @file

+  EFI_DEVICE_PATH_TO_TEXT_PROTOCOL as defined in UEFI 2.0.

+  This protocol provides service to convert device nodes and paths to text.

+

+  Copyright (c) 2006 - 2018, Intel Corporation. All rights reserved.<BR>

+  SPDX-License-Identifier: BSD-2-Clause-Patent

+

+**/

+

+#ifndef __DEVICE_PATH_TO_TEXT_PROTOCOL_H__

+#define __DEVICE_PATH_TO_TEXT_PROTOCOL_H__

+

+///

+/// Device Path To Text protocol

+///

+#define EFI_DEVICE_PATH_TO_TEXT_PROTOCOL_GUID \

+  { \

+    0x8b843e20, 0x8132, 0x4852, {0x90, 0xcc, 0x55, 0x1a, 0x4e, 0x4a, 0x7f, 0x1c } \

+  }

+

+/**

+  Convert a device node to its text representation.

+

+  @param  DeviceNode     Points to the device node to be converted.

+  @param  DisplayOnly    If DisplayOnly is TRUE, then the shorter text representation

+                         of the display node is used, where applicable. If DisplayOnly

+                         is FALSE, then the longer text representation of the display node

+                         is used.

+  @param  AllowShortcuts If AllowShortcuts is TRUE, then the shortcut forms of text

+                         representation for a device node can be used, where applicable.

+

+  @retval a_pointer      a pointer to the allocated text representation of the device node data

+  @retval NULL           if DeviceNode is NULL or there was insufficient memory.

+

+**/

+typedef

+CHAR16*

+(EFIAPI *EFI_DEVICE_PATH_TO_TEXT_NODE)(

+  IN CONST EFI_DEVICE_PATH_PROTOCOL   *DeviceNode,

+  IN BOOLEAN                          DisplayOnly,

+  IN BOOLEAN                          AllowShortcuts

+  );

+

+/**

+  Convert a device path to its text representation.

+

+  @param  DevicePath     Points to the device path to be converted.

+  @param  DisplayOnly    If DisplayOnly is TRUE, then the shorter text representation

+                         of the display node is used, where applicable. If DisplayOnly

+                         is FALSE, then the longer text representation of the display node

+                         is used.

+  @param  AllowShortcuts The AllowShortcuts is FALSE, then the shortcut forms of

+                         text representation for a device node cannot be used.

+

+  @retval a_pointer      a pointer to the allocated text representation of the device node.

+  @retval NULL           if DevicePath is NULL or there was insufficient memory.

+

+**/

+typedef

+CHAR16*

+(EFIAPI *EFI_DEVICE_PATH_TO_TEXT_PATH)(

+  IN CONST EFI_DEVICE_PATH_PROTOCOL   *DevicePath,

+  IN BOOLEAN                          DisplayOnly,

+  IN BOOLEAN                          AllowShortcuts

+  );

+

+///

+/// This protocol converts device paths and device nodes to text.

+///

+typedef struct {

+  EFI_DEVICE_PATH_TO_TEXT_NODE        ConvertDeviceNodeToText;

+  EFI_DEVICE_PATH_TO_TEXT_PATH        ConvertDevicePathToText;

+} EFI_DEVICE_PATH_TO_TEXT_PROTOCOL;

+

+extern EFI_GUID gEfiDevicePathToTextProtocolGuid;

+

+#endif

+

+

diff --git a/debugging_demo/memtest86+/efi/Include/Protocol/DevicePathUtilities.h b/debugging_demo/memtest86+/efi/Include/Protocol/DevicePathUtilities.h
new file mode 100644
index 0000000..be12f2b
--- /dev/null
+++ b/debugging_demo/memtest86+/efi/Include/Protocol/DevicePathUtilities.h
@@ -0,0 +1,186 @@
+/** @file

+  EFI_DEVICE_PATH_UTILITIES_PROTOCOL as defined in UEFI 2.0.

+  Use to create and manipulate device paths and device nodes.

+

+  Copyright (c) 2006 - 2018, Intel Corporation. All rights reserved.<BR>

+  SPDX-License-Identifier: BSD-2-Clause-Patent

+

+**/

+

+#ifndef __DEVICE_PATH_UTILITIES_PROTOCOL_H__

+#define __DEVICE_PATH_UTILITIES_PROTOCOL_H__

+

+///

+/// Device Path Utilities protocol

+///

+#define EFI_DEVICE_PATH_UTILITIES_PROTOCOL_GUID \

+  { \

+    0x379be4e, 0xd706, 0x437d, {0xb0, 0x37, 0xed, 0xb8, 0x2f, 0xb7, 0x72, 0xa4 } \

+  }

+

+/**

+  Returns the size of the device path, in bytes.

+

+  @param  DevicePath Points to the start of the EFI device path.

+

+  @return Size  Size of the specified device path, in bytes, including the end-of-path tag.

+  @retval 0     DevicePath is NULL

+

+**/

+typedef

+UINTN

+(EFIAPI *EFI_DEVICE_PATH_UTILS_GET_DEVICE_PATH_SIZE)(

+  IN CONST EFI_DEVICE_PATH_PROTOCOL *DevicePath

+  );

+

+

+/**

+  Create a duplicate of the specified path.

+

+  @param  DevicePath Points to the source EFI device path.

+

+  @retval Pointer    A pointer to the duplicate device path.

+  @retval NULL       insufficient memory or DevicePath is NULL

+

+**/

+typedef

+EFI_DEVICE_PATH_PROTOCOL*

+(EFIAPI *EFI_DEVICE_PATH_UTILS_DUP_DEVICE_PATH)(

+  IN CONST EFI_DEVICE_PATH_PROTOCOL *DevicePath

+  );

+

+/**

+  Create a new path by appending the second device path to the first.

+  If Src1 is NULL and Src2 is non-NULL, then a duplicate of Src2 is returned.

+  If Src1 is non-NULL and Src2 is NULL, then a duplicate of Src1 is returned.

+  If Src1 and Src2 are both NULL, then a copy of an end-of-device-path is returned.

+

+  @param  Src1 Points to the first device path.

+  @param  Src2 Points to the second device path.

+

+  @retval Pointer  A pointer to the newly created device path.

+  @retval NULL     Memory could not be allocated

+

+**/

+typedef

+EFI_DEVICE_PATH_PROTOCOL*

+(EFIAPI *EFI_DEVICE_PATH_UTILS_APPEND_PATH)(

+  IN CONST EFI_DEVICE_PATH_PROTOCOL *Src1,

+  IN CONST EFI_DEVICE_PATH_PROTOCOL *Src2

+  );

+

+/**

+  Creates a new path by appending the device node to the device path.

+  If DeviceNode is NULL then a copy of DevicePath is returned.

+  If DevicePath is NULL then a copy of DeviceNode, followed by an end-of-device path device node is returned.

+  If both DeviceNode and DevicePath are NULL then a copy of an end-of-device-path device node is returned.

+

+  @param  DevicePath Points to the device path.

+  @param  DeviceNode Points to the device node.

+

+  @retval Pointer    A pointer to the allocated device node.

+  @retval NULL       There was insufficient memory.

+

+**/

+typedef

+EFI_DEVICE_PATH_PROTOCOL*

+(EFIAPI *EFI_DEVICE_PATH_UTILS_APPEND_NODE)(

+  IN CONST EFI_DEVICE_PATH_PROTOCOL *DevicePath,

+  IN CONST EFI_DEVICE_PATH_PROTOCOL *DeviceNode

+  );

+

+/**

+  Creates a new path by appending the specified device path instance to the specified device path.

+

+  @param  DevicePath         Points to the device path. If NULL, then ignored.

+  @param  DevicePathInstance Points to the device path instance.

+

+  @retval Pointer            A pointer to the newly created device path

+  @retval NULL               Memory could not be allocated or DevicePathInstance is NULL.

+

+**/

+typedef

+EFI_DEVICE_PATH_PROTOCOL*

+(EFIAPI *EFI_DEVICE_PATH_UTILS_APPEND_INSTANCE)(

+  IN CONST EFI_DEVICE_PATH_PROTOCOL *DevicePath,

+  IN CONST EFI_DEVICE_PATH_PROTOCOL *DevicePathInstance

+  );

+

+/**

+  Creates a copy of the current device path instance and returns a pointer to the next device path

+  instance.

+

+  @param  DevicePathInstance     On input, this holds the pointer to the current device path

+                                 instance. On output, this holds the pointer to the next

+                                 device path instance or NULL if there are no more device

+                                 path instances in the device path.

+  @param  DevicePathInstanceSize On output, this holds the size of the device path instance,

+                                 in bytes or zero, if DevicePathInstance is NULL.

+                                 If NULL, then the instance size is not output.

+

+  @retval Pointer                A pointer to the copy of the current device path instance.

+  @retval NULL                   DevicePathInstace was NULL on entry or there was insufficient memory.

+

+**/

+typedef

+EFI_DEVICE_PATH_PROTOCOL*

+(EFIAPI *EFI_DEVICE_PATH_UTILS_GET_NEXT_INSTANCE)(

+  IN  OUT EFI_DEVICE_PATH_PROTOCOL  **DevicePathInstance,

+  OUT UINTN                         *DevicePathInstanceSize

+  );

+

+/**

+  Creates a device node

+

+  @param  NodeType    NodeType is the device node type (EFI_DEVICE_PATH.Type) for

+                      the new device node.

+  @param  NodeSubType NodeSubType is the device node sub-type

+                      EFI_DEVICE_PATH.SubType) for the new device node.

+  @param  NodeLength  NodeLength is the length of the device node

+                      (EFI_DEVICE_PATH.Length) for the new device node.

+

+  @retval Pointer     A pointer to the newly created device node.

+  @retval NULL        NodeLength is less than

+                      the size of the header or there was insufficient memory.

+

+**/

+typedef

+EFI_DEVICE_PATH_PROTOCOL*

+(EFIAPI *EFI_DEVICE_PATH_UTILS_CREATE_NODE)(

+  IN UINT8                          NodeType,

+  IN UINT8                          NodeSubType,

+  IN UINT16                         NodeLength

+);

+

+/**

+  Returns whether a device path is multi-instance.

+

+  @param  DevicePath Points to the device path. If NULL, then ignored.

+

+  @retval TRUE       The device path has more than one instance

+  @retval FALSE      The device path is empty or contains only a single instance.

+

+**/

+typedef

+BOOLEAN

+(EFIAPI *EFI_DEVICE_PATH_UTILS_IS_MULTI_INSTANCE)(

+  IN CONST EFI_DEVICE_PATH_PROTOCOL         *DevicePath

+  );

+

+///

+/// This protocol is used to creates and manipulates device paths and device nodes.

+///

+typedef struct {

+  EFI_DEVICE_PATH_UTILS_GET_DEVICE_PATH_SIZE GetDevicePathSize;

+  EFI_DEVICE_PATH_UTILS_DUP_DEVICE_PATH      DuplicateDevicePath;

+  EFI_DEVICE_PATH_UTILS_APPEND_PATH          AppendDevicePath;

+  EFI_DEVICE_PATH_UTILS_APPEND_NODE          AppendDeviceNode;

+  EFI_DEVICE_PATH_UTILS_APPEND_INSTANCE      AppendDevicePathInstance;

+  EFI_DEVICE_PATH_UTILS_GET_NEXT_INSTANCE    GetNextDevicePathInstance;

+  EFI_DEVICE_PATH_UTILS_IS_MULTI_INSTANCE    IsDevicePathMultiInstance;

+  EFI_DEVICE_PATH_UTILS_CREATE_NODE          CreateDeviceNode;

+} EFI_DEVICE_PATH_UTILITIES_PROTOCOL;

+

+extern EFI_GUID gEfiDevicePathUtilitiesProtocolGuid;

+

+#endif

diff --git a/debugging_demo/memtest86+/efi/Include/Protocol/DriverBinding.h b/debugging_demo/memtest86+/efi/Include/Protocol/DriverBinding.h
new file mode 100644
index 0000000..a58e812
--- /dev/null
+++ b/debugging_demo/memtest86+/efi/Include/Protocol/DriverBinding.h
@@ -0,0 +1,195 @@
+/** @file

+  UEFI DriverBinding Protocol is defined in UEFI specification.

+

+  This protocol is produced by every driver that follows the UEFI Driver Model,

+  and it is the central component that allows drivers and controllers to be managed.

+

+Copyright (c) 2006 - 2018, Intel Corporation. All rights reserved.<BR>

+SPDX-License-Identifier: BSD-2-Clause-Patent

+

+**/

+

+#ifndef __EFI_DRIVER_BINDING_H__

+#define __EFI_DRIVER_BINDING_H__

+

+///

+/// The global ID for the ControllerHandle Driver Protocol.

+///

+#define EFI_DRIVER_BINDING_PROTOCOL_GUID \

+  { \

+    0x18a031ab, 0xb443, 0x4d1a, {0xa5, 0xc0, 0xc, 0x9, 0x26, 0x1e, 0x9f, 0x71 } \

+  }

+

+typedef struct _EFI_DRIVER_BINDING_PROTOCOL  EFI_DRIVER_BINDING_PROTOCOL;

+

+/**

+  Tests to see if this driver supports a given controller. If a child device is provided,

+  it further tests to see if this driver supports creating a handle for the specified child device.

+

+  This function checks to see if the driver specified by This supports the device specified by

+  ControllerHandle. Drivers will typically use the device path attached to

+  ControllerHandle and/or the services from the bus I/O abstraction attached to

+  ControllerHandle to determine if the driver supports ControllerHandle. This function

+  may be called many times during platform initialization. In order to reduce boot times, the tests

+  performed by this function must be very small, and take as little time as possible to execute. This

+  function must not change the state of any hardware devices, and this function must be aware that the

+  device specified by ControllerHandle may already be managed by the same driver or a

+  different driver. This function must match its calls to AllocatePages() with FreePages(),

+  AllocatePool() with FreePool(), and OpenProtocol() with CloseProtocol().

+  Because ControllerHandle may have been previously started by the same driver, if a protocol is

+  already in the opened state, then it must not be closed with CloseProtocol(). This is required

+  to guarantee the state of ControllerHandle is not modified by this function.

+

+  @param[in]  This                 A pointer to the EFI_DRIVER_BINDING_PROTOCOL instance.

+  @param[in]  ControllerHandle     The handle of the controller to test. This handle

+                                   must support a protocol interface that supplies

+                                   an I/O abstraction to the driver.

+  @param[in]  RemainingDevicePath  A pointer to the remaining portion of a device path.  This

+                                   parameter is ignored by device drivers, and is optional for bus

+                                   drivers. For bus drivers, if this parameter is not NULL, then

+                                   the bus driver must determine if the bus controller specified

+                                   by ControllerHandle and the child controller specified

+                                   by RemainingDevicePath are both supported by this

+                                   bus driver.

+

+  @retval EFI_SUCCESS              The device specified by ControllerHandle and

+                                   RemainingDevicePath is supported by the driver specified by This.

+  @retval EFI_ALREADY_STARTED      The device specified by ControllerHandle and

+                                   RemainingDevicePath is already being managed by the driver

+                                   specified by This.

+  @retval EFI_ACCESS_DENIED        The device specified by ControllerHandle and

+                                   RemainingDevicePath is already being managed by a different

+                                   driver or an application that requires exclusive access.

+                                   Currently not implemented.

+  @retval EFI_UNSUPPORTED          The device specified by ControllerHandle and

+                                   RemainingDevicePath is not supported by the driver specified by This.

+**/

+typedef

+EFI_STATUS

+(EFIAPI *EFI_DRIVER_BINDING_SUPPORTED)(

+  IN EFI_DRIVER_BINDING_PROTOCOL            *This,

+  IN EFI_HANDLE                             ControllerHandle,

+  IN EFI_DEVICE_PATH_PROTOCOL               *RemainingDevicePath OPTIONAL

+  );

+

+/**

+  Starts a device controller or a bus controller.

+

+  The Start() function is designed to be invoked from the EFI boot service ConnectController().

+  As a result, much of the error checking on the parameters to Start() has been moved into this

+  common boot service. It is legal to call Start() from other locations,

+  but the following calling restrictions must be followed, or the system behavior will not be deterministic.

+  1. ControllerHandle must be a valid EFI_HANDLE.

+  2. If RemainingDevicePath is not NULL, then it must be a pointer to a naturally aligned

+     EFI_DEVICE_PATH_PROTOCOL.

+  3. Prior to calling Start(), the Supported() function for the driver specified by This must

+     have been called with the same calling parameters, and Supported() must have returned EFI_SUCCESS.

+

+  @param[in]  This                 A pointer to the EFI_DRIVER_BINDING_PROTOCOL instance.

+  @param[in]  ControllerHandle     The handle of the controller to start. This handle

+                                   must support a protocol interface that supplies

+                                   an I/O abstraction to the driver.

+  @param[in]  RemainingDevicePath  A pointer to the remaining portion of a device path.  This

+                                   parameter is ignored by device drivers, and is optional for bus

+                                   drivers. For a bus driver, if this parameter is NULL, then handles

+                                   for all the children of Controller are created by this driver.

+                                   If this parameter is not NULL and the first Device Path Node is

+                                   not the End of Device Path Node, then only the handle for the

+                                   child device specified by the first Device Path Node of

+                                   RemainingDevicePath is created by this driver.

+                                   If the first Device Path Node of RemainingDevicePath is

+                                   the End of Device Path Node, no child handle is created by this

+                                   driver.

+

+  @retval EFI_SUCCESS              The device was started.

+  @retval EFI_DEVICE_ERROR         The device could not be started due to a device error.Currently not implemented.

+  @retval EFI_OUT_OF_RESOURCES     The request could not be completed due to a lack of resources.

+  @retval Others                   The driver failded to start the device.

+

+**/

+typedef

+EFI_STATUS

+(EFIAPI *EFI_DRIVER_BINDING_START)(

+  IN EFI_DRIVER_BINDING_PROTOCOL            *This,

+  IN EFI_HANDLE                             ControllerHandle,

+  IN EFI_DEVICE_PATH_PROTOCOL               *RemainingDevicePath OPTIONAL

+  );

+

+/**

+  Stops a device controller or a bus controller.

+

+  The Stop() function is designed to be invoked from the EFI boot service DisconnectController().

+  As a result, much of the error checking on the parameters to Stop() has been moved

+  into this common boot service. It is legal to call Stop() from other locations,

+  but the following calling restrictions must be followed, or the system behavior will not be deterministic.

+  1. ControllerHandle must be a valid EFI_HANDLE that was used on a previous call to this

+     same driver's Start() function.

+  2. The first NumberOfChildren handles of ChildHandleBuffer must all be a valid

+     EFI_HANDLE. In addition, all of these handles must have been created in this driver's

+     Start() function, and the Start() function must have called OpenProtocol() on

+     ControllerHandle with an Attribute of EFI_OPEN_PROTOCOL_BY_CHILD_CONTROLLER.

+

+  @param[in]  This              A pointer to the EFI_DRIVER_BINDING_PROTOCOL instance.

+  @param[in]  ControllerHandle  A handle to the device being stopped. The handle must

+                                support a bus specific I/O protocol for the driver

+                                to use to stop the device.

+  @param[in]  NumberOfChildren  The number of child device handles in ChildHandleBuffer.

+  @param[in]  ChildHandleBuffer An array of child handles to be freed. May be NULL

+                                if NumberOfChildren is 0.

+

+  @retval EFI_SUCCESS           The device was stopped.

+  @retval EFI_DEVICE_ERROR      The device could not be stopped due to a device error.

+

+**/

+typedef

+EFI_STATUS

+(EFIAPI *EFI_DRIVER_BINDING_STOP)(

+  IN EFI_DRIVER_BINDING_PROTOCOL            *This,

+  IN  EFI_HANDLE                            ControllerHandle,

+  IN  UINTN                                 NumberOfChildren,

+  IN  EFI_HANDLE                            *ChildHandleBuffer OPTIONAL

+  );

+

+///

+/// This protocol provides the services required to determine if a driver supports a given controller.

+/// If a controller is supported, then it also provides routines to start and stop the controller.

+///

+struct _EFI_DRIVER_BINDING_PROTOCOL {

+  EFI_DRIVER_BINDING_SUPPORTED  Supported;

+  EFI_DRIVER_BINDING_START      Start;

+  EFI_DRIVER_BINDING_STOP       Stop;

+

+  ///

+  /// The version number of the UEFI driver that produced the

+  /// EFI_DRIVER_BINDING_PROTOCOL. This field is used by

+  /// the EFI boot service ConnectController() to determine

+  /// the order that driver's Supported() service will be used when

+  /// a controller needs to be started. EFI Driver Binding Protocol

+  /// instances with higher Version values will be used before ones

+  /// with lower Version values. The Version values of 0x0-

+  /// 0x0f and 0xfffffff0-0xffffffff are reserved for

+  /// platform/OEM specific drivers. The Version values of 0x10-

+  /// 0xffffffef are reserved for IHV-developed drivers.

+  ///

+  UINT32                        Version;

+

+  ///

+  /// The image handle of the UEFI driver that produced this instance

+  /// of the EFI_DRIVER_BINDING_PROTOCOL.

+  ///

+  EFI_HANDLE                    ImageHandle;

+

+  ///

+  /// The handle on which this instance of the

+  /// EFI_DRIVER_BINDING_PROTOCOL is installed. In most

+  /// cases, this is the same handle as ImageHandle. However, for

+  /// UEFI drivers that produce more than one instance of the

+  /// EFI_DRIVER_BINDING_PROTOCOL, this value may not be

+  /// the same as ImageHandle.

+  ///

+  EFI_HANDLE                    DriverBindingHandle;

+};

+

+extern EFI_GUID gEfiDriverBindingProtocolGuid;

+

+#endif

diff --git a/debugging_demo/memtest86+/efi/Include/Protocol/DriverConfiguration.h b/debugging_demo/memtest86+/efi/Include/Protocol/DriverConfiguration.h
new file mode 100644
index 0000000..4b0076d
--- /dev/null
+++ b/debugging_demo/memtest86+/efi/Include/Protocol/DriverConfiguration.h
@@ -0,0 +1,161 @@
+/** @file

+  EFI Driver Configuration Protocol

+

+  Copyright (c) 2006 - 2018, Intel Corporation. All rights reserved.<BR>

+  SPDX-License-Identifier: BSD-2-Clause-Patent

+

+**/

+

+#ifndef __EFI_DRIVER_CONFIGURATION_H__

+#define __EFI_DRIVER_CONFIGURATION_H__

+

+#include <Protocol/DriverConfiguration2.h>

+

+///

+/// Global ID for the Driver Configuration Protocol defined in EFI 1.1

+///

+#define EFI_DRIVER_CONFIGURATION_PROTOCOL_GUID \

+  { \

+    0x107a772b, 0xd5e1, 0x11d4, {0x9a, 0x46, 0x0, 0x90, 0x27, 0x3f, 0xc1, 0x4d } \

+  }

+

+typedef struct _EFI_DRIVER_CONFIGURATION_PROTOCOL  EFI_DRIVER_CONFIGURATION_PROTOCOL;

+

+/**

+  Allows the user to set controller specific options for a controller that a

+  driver is currently managing.

+

+  @param  This             A pointer to the EFI_DRIVER_CONFIGURATION_PROTOCOL instance.

+  @param  ControllerHandle The handle of the controller to set options on.

+  @param  ChildHandle      The handle of the child controller to set options on.  This

+                           is an optional parameter that may be NULL.  It will be NULL

+                           for device drivers, and for bus drivers that wish to set

+                           options for the bus controller.  It will not be NULL for a

+                           bus driver that wishes to set options for one of its child

+                           controllers.

+  @param  Language         A pointer to a three character ISO 639-2 language identifier.

+                           This is the language of the user interface that should be

+                           presented to the user, and it must match one of the languages

+                           specified in SupportedLanguages.  The number of languages

+                           supported by a driver is up to the driver writer.

+  @param  ActionRequired   A pointer to the action that the calling agent is required

+                           to perform when this function returns.  See "Related

+                           Definitions" for a list of the actions that the calling

+                           agent is required to perform prior to accessing

+                           ControllerHandle again.

+

+  @retval EFI_SUCCESS           The driver specified by This successfully set the

+                                configuration options for the controller specified

+                                by ControllerHandle..

+  @retval EFI_INVALID_PARAMETER ControllerHandle is not a valid EFI_HANDLE.

+  @retval EFI_INVALID_PARAMETER ChildHandle is not NULL and it is not a valid EFI_HANDLE.

+  @retval EFI_INVALID_PARAMETER ActionRequired is NULL.

+  @retval EFI_UNSUPPORTED       The driver specified by This does not support setting

+                                configuration options for the controller specified by

+                                ControllerHandle and ChildHandle.

+  @retval EFI_UNSUPPORTED       The driver specified by This does not support the

+                                language specified by Language.

+  @retval EFI_DEVICE_ERROR      A device error occurred while attempt to set the

+                                configuration options for the controller specified

+                                by ControllerHandle and ChildHandle.

+  @retval EFI_OUT_RESOURCES     There are not enough resources available to set the

+                                configuration options for the controller specified

+                                by ControllerHandle and ChildHandle.

+

+**/

+typedef

+EFI_STATUS

+(EFIAPI *EFI_DRIVER_CONFIGURATION_SET_OPTIONS)(

+  IN EFI_DRIVER_CONFIGURATION_PROTOCOL                        *This,

+  IN  EFI_HANDLE                                              ControllerHandle,

+  IN  EFI_HANDLE                                              ChildHandle  OPTIONAL,

+  IN  CHAR8                                                   *Language,

+  OUT EFI_DRIVER_CONFIGURATION_ACTION_REQUIRED                *ActionRequired

+  );

+

+/**

+  Tests to see if a controller's current configuration options are valid.

+

+  @param  This             A pointer to the EFI_DRIVER_CONFIGURATION_PROTOCOL instance.

+  @param  ControllerHandle The handle of the controller to test if it's current

+                           configuration options are valid.

+  @param  ChildHandle      The handle of the child controller to test if it's current

+                           configuration options are valid.  This is an optional

+                           parameter that may be NULL.  It will be NULL for device

+                           drivers.  It will also be NULL for bus drivers that wish

+                           to test the configuration options for the bus controller.

+                           It will not be NULL for a bus driver that wishes to test

+                           configuration options for one of its child controllers.

+

+  @retval EFI_SUCCESS           The controller specified by ControllerHandle and

+                                ChildHandle that is being managed by the driver

+                                specified by This has a valid set of  configuration

+                                options.

+  @retval EFI_INVALID_PARAMETER ControllerHandle is not a valid EFI_HANDLE.

+  @retval EFI_INVALID_PARAMETER ChildHandle is not NULL and it is not a valid EFI_HANDLE.

+  @retval EFI_UNSUPPORTED       The driver specified by This is not currently

+                                managing the controller specified by ControllerHandle

+                                and ChildHandle.

+  @retval EFI_DEVICE_ERROR      The controller specified by ControllerHandle and

+                                ChildHandle that is being managed by the driver

+                                specified by This has an invalid set of configuration

+                                options.

+

+**/

+typedef

+EFI_STATUS

+(EFIAPI *EFI_DRIVER_CONFIGURATION_OPTIONS_VALID)(

+  IN EFI_DRIVER_CONFIGURATION_PROTOCOL                        *This,

+  IN  EFI_HANDLE                                              ControllerHandle,

+  IN  EFI_HANDLE                                              ChildHandle  OPTIONAL

+  );

+

+/**

+  Forces a driver to set the default configuration options for a controller.

+

+  @param  This             A pointer to the EFI_DRIVER_CONFIGURATION_PROTOCOL instance.

+  @param  ControllerHandle The handle of the controller to force default configuration options on.

+  @param  ChildHandle      The handle of the child controller to force default configuration options on  This is an optional parameter that may be NULL.  It will be NULL for device drivers.  It will also be NULL for bus drivers that wish to force default configuration options for the bus controller.  It will not be NULL for a bus driver that wishes to force default configuration options for one of its child controllers.

+  @param  DefaultType      The type of default configuration options to force on the controller specified by ControllerHandle and ChildHandle.  See Table 9-1 for legal values.  A DefaultType of 0x00000000 must be supported by this protocol.

+  @param  ActionRequired   A pointer to the action that the calling agent is required to perform when this function returns.  See "Related Definitions" in Section 9.1 for a list of the actions that the calling agent is required to perform prior to accessing ControllerHandle again.

+

+  @retval EFI_SUCCESS           The driver specified by This successfully forced the default configuration options on the controller specified by ControllerHandle and ChildHandle.

+  @retval EFI_INVALID_PARAMETER ControllerHandle is not a valid EFI_HANDLE.

+  @retval EFI_INVALID_PARAMETER ChildHandle is not NULL and it is not a valid EFI_HANDLE.

+  @retval EFI_INVALID_PARAMETER ActionRequired is NULL.

+  @retval EFI_UNSUPPORTED       The driver specified by This does not support forcing the default configuration options on the controller specified by ControllerHandle and ChildHandle.

+  @retval EFI_UNSUPPORTED       The driver specified by This does not support the configuration type specified by DefaultType.

+  @retval EFI_DEVICE_ERROR      A device error occurred while attempt to force the default configuration options on the controller specified by  ControllerHandle and ChildHandle.

+  @retval EFI_OUT_RESOURCES     There are not enough resources available to force the default configuration options on the controller specified by ControllerHandle and ChildHandle.

+

+**/

+typedef

+EFI_STATUS

+(EFIAPI *EFI_DRIVER_CONFIGURATION_FORCE_DEFAULTS)(

+  IN EFI_DRIVER_CONFIGURATION_PROTOCOL                        *This,

+  IN  EFI_HANDLE                                              ControllerHandle,

+  IN  EFI_HANDLE                                              ChildHandle  OPTIONAL,

+  IN  UINT32                                                  DefaultType,

+  OUT EFI_DRIVER_CONFIGURATION_ACTION_REQUIRED                *ActionRequired

+  );

+

+

+///

+/// Used to set configuration options for a controller that an EFI Driver is managing.

+///

+struct _EFI_DRIVER_CONFIGURATION_PROTOCOL {

+  EFI_DRIVER_CONFIGURATION_SET_OPTIONS    SetOptions;

+  EFI_DRIVER_CONFIGURATION_OPTIONS_VALID  OptionsValid;

+  EFI_DRIVER_CONFIGURATION_FORCE_DEFAULTS ForceDefaults;

+  ///

+  /// A Null-terminated ASCII string that contains one or more

+  /// ISO 639-2 language codes.  This is the list of language

+  /// codes that this protocol supports.

+  ///

+  CHAR8                                   *SupportedLanguages;

+};

+

+

+extern EFI_GUID gEfiDriverConfigurationProtocolGuid;

+

+#endif

diff --git a/debugging_demo/memtest86+/efi/Include/Protocol/DriverConfiguration2.h b/debugging_demo/memtest86+/efi/Include/Protocol/DriverConfiguration2.h
new file mode 100644
index 0000000..ed4a65d
--- /dev/null
+++ b/debugging_demo/memtest86+/efi/Include/Protocol/DriverConfiguration2.h
@@ -0,0 +1,184 @@
+/** @file

+  UEFI Driver Configuration2 Protocol

+

+  Copyright (c) 2006 - 2018, Intel Corporation. All rights reserved.<BR>

+  SPDX-License-Identifier: BSD-2-Clause-Patent

+

+**/

+

+#ifndef __EFI_DRIVER_CONFIGURATION2_H__

+#define __EFI_DRIVER_CONFIGURATION2_H__

+

+///

+/// Global ID for the Driver Configuration Protocol defined in UEFI 2.0

+///

+#define EFI_DRIVER_CONFIGURATION2_PROTOCOL_GUID \

+  { \

+    0xbfd7dc1d, 0x24f1, 0x40d9, {0x82, 0xe7, 0x2e, 0x09, 0xbb, 0x6b, 0x4e, 0xbe } \

+  }

+

+typedef struct _EFI_DRIVER_CONFIGURATION2_PROTOCOL  EFI_DRIVER_CONFIGURATION2_PROTOCOL;

+

+typedef enum {

+  ///

+  /// The controller is still in a usable state. No actions

+  /// are required before this controller can be used again.

+  ///

+  EfiDriverConfigurationActionNone              = 0,

+  ///

+  /// The driver has detected that the controller is not in a

+  /// usable state, and it needs to be stopped.

+  ///

+  EfiDriverConfigurationActionStopController    = 1,

+  ///

+  /// This controller needs to be stopped and restarted

+  /// before it can be used again.

+  ///

+  EfiDriverConfigurationActionRestartController = 2,

+  ///

+  /// A configuration change has been made that requires the platform to be restarted before

+  /// the controller can be used again.

+  ///

+  EfiDriverConfigurationActionRestartPlatform   = 3,

+  EfiDriverConfigurationActionMaximum

+} EFI_DRIVER_CONFIGURATION_ACTION_REQUIRED;

+

+#define EFI_DRIVER_CONFIGURATION_SAFE_DEFAULTS          0x00000000

+#define EFI_DRIVER_CONFIGURATION_MANUFACTURING_DEFAULTS 0x00000001

+#define EFI_DRIVER_CONFIGURATION_CUSTOM_DEFAULTS        0x00000002

+#define EFI_DRIVER_CONFIGURATION_PERORMANCE_DEFAULTS    0x00000003

+

+/**

+  Allows the user to set controller specific options for a controller that a

+  driver is currently managing.

+

+  @param  This             A pointer to the EFI_DRIVER_CONFIGURATION2_PROTOCOL instance.

+  @param  ControllerHandle The handle of the controller to set options on.

+  @param  ChildHandle      The handle of the child controller to set options on.  This

+                           is an optional parameter that may be NULL.  It will be NULL

+                           for device drivers, and for bus drivers that wish to set

+                           options for the bus controller.  It will not be NULL for a

+                           bus driver that wishes to set options for one of its child

+                           controllers.

+  @param  Language         A Null-terminated ASCII string that contains one or more RFC 4646

+                           language codes. This is the list of language codes that this

+                           protocol supports. The number of languages

+                           supported by a driver is up to the driver writer.

+  @param  ActionRequired   A pointer to the action that the calling agent is required

+                           to perform when this function returns.  See "Related

+                           Definitions" for a list of the actions that the calling

+                           agent is required to perform prior to accessing

+                           ControllerHandle again.

+

+  @retval EFI_SUCCESS           The driver specified by This successfully set the

+                                configuration options for the controller specified

+                                by ControllerHandle.

+  @retval EFI_INVALID_PARAMETER ControllerHandle is not a valid EFI_HANDLE.

+  @retval EFI_INVALID_PARAMETER ChildHandle is not NULL and it is not a valid EFI_HANDLE.

+  @retval EFI_INVALID_PARAMETER ActionRequired is NULL.

+  @retval EFI_UNSUPPORTED       The driver specified by This does not support setting

+                                configuration options for the controller specified by

+                                ControllerHandle and ChildHandle.

+  @retval EFI_UNSUPPORTED       The driver specified by This does not support the

+                                language specified by Language.

+  @retval EFI_DEVICE_ERROR      A device error occurred while attempting to set the

+                                configuration options for the controller specified

+                                by ControllerHandle and ChildHandle.

+  @retval EFI_OUT_RESOURCES     There are not enough resources available to set the

+                                configuration options for the controller specified

+                                by ControllerHandle and ChildHandle.

+

+**/

+typedef

+EFI_STATUS

+(EFIAPI *EFI_DRIVER_CONFIGURATION2_SET_OPTIONS)(

+  IN EFI_DRIVER_CONFIGURATION2_PROTOCOL                       *This,

+  IN  EFI_HANDLE                                              ControllerHandle,

+  IN  EFI_HANDLE                                              ChildHandle  OPTIONAL,

+  IN  CHAR8                                                   *Language,

+  OUT EFI_DRIVER_CONFIGURATION_ACTION_REQUIRED                *ActionRequired

+  );

+

+/**

+  Tests to see if a controller's current configuration options are valid.

+

+  @param  This             A pointer to the EFI_DRIVER_CONFIGURATION2_PROTOCOL instance.

+  @param  ControllerHandle The handle of the controller to test if it's current

+                           configuration options are valid.

+  @param  ChildHandle      The handle of the child controller to test if it's current

+                           configuration options are valid.  This is an optional

+                           parameter that may be NULL.  It will be NULL for device

+                           drivers.  It will also be NULL for bus drivers that wish

+                           to test the configuration options for the bus controller.

+                           It will not be NULL for a bus driver that wishes to test

+                           configuration options for one of its child controllers.

+

+  @retval EFI_SUCCESS           The controller specified by ControllerHandle and

+                                ChildHandle that is being managed by the driver

+                                specified by This has a valid set of  configuration

+                                options.

+  @retval EFI_INVALID_PARAMETER ControllerHandle is not a valid EFI_HANDLE.

+  @retval EFI_INVALID_PARAMETER ChildHandle is not NULL and it is not a valid EFI_HANDLE.

+  @retval EFI_UNSUPPORTED       The driver specified by This is not currently

+                                managing the controller specified by ControllerHandle

+                                and ChildHandle.

+  @retval EFI_DEVICE_ERROR      The controller specified by ControllerHandle and

+                                ChildHandle that is being managed by the driver

+                                specified by This has an invalid set of configuration

+                                options.

+

+**/

+typedef

+EFI_STATUS

+(EFIAPI *EFI_DRIVER_CONFIGURATION2_OPTIONS_VALID)(

+  IN EFI_DRIVER_CONFIGURATION2_PROTOCOL                       *This,

+  IN  EFI_HANDLE                                              ControllerHandle,

+  IN  EFI_HANDLE                                              ChildHandle  OPTIONAL

+  );

+

+/**

+  Forces a driver to set the default configuration options for a controller.

+

+  @param  This             A pointer to the EFI_DRIVER_CONFIGURATION2_PROTOCOL instance.

+  @param  ControllerHandle The handle of the controller to force default configuration options on.

+  @param  ChildHandle      The handle of the child controller to force default configuration options on  This is an optional parameter that may be NULL.  It will be NULL for device drivers.  It will also be NULL for bus drivers that wish to force default configuration options for the bus controller.  It will not be NULL for a bus driver that wishes to force default configuration options for one of its child controllers.

+  @param  DefaultType      The type of default configuration options to force on the controller specified by ControllerHandle and ChildHandle.  See Table 9-1 for legal values.  A DefaultType of 0x00000000 must be supported by this protocol.

+  @param  ActionRequired   A pointer to the action that the calling agent is required to perform when this function returns.  See "Related Definitions" in Section 9.1 for a list of the actions that the calling agent is required to perform prior to accessing ControllerHandle again.

+

+  @retval EFI_SUCCESS           The driver specified by This successfully forced the default configuration options on the controller specified by ControllerHandle and ChildHandle.

+  @retval EFI_INVALID_PARAMETER ControllerHandle is not a valid EFI_HANDLE.

+  @retval EFI_INVALID_PARAMETER ChildHandle is not NULL and it is not a valid EFI_HANDLE.

+  @retval EFI_INVALID_PARAMETER ActionRequired is NULL.

+  @retval EFI_UNSUPPORTED       The driver specified by This does not support forcing the default configuration options on the controller specified by ControllerHandle and ChildHandle.

+  @retval EFI_UNSUPPORTED       The driver specified by This does not support the configuration type specified by DefaultType.

+  @retval EFI_DEVICE_ERROR      A device error occurred while attempt to force the default configuration options on the controller specified by  ControllerHandle and ChildHandle.

+  @retval EFI_OUT_RESOURCES     There are not enough resources available to force the default configuration options on the controller specified by ControllerHandle and ChildHandle.

+

+**/

+typedef

+EFI_STATUS

+(EFIAPI *EFI_DRIVER_CONFIGURATION2_FORCE_DEFAULTS)(

+  IN EFI_DRIVER_CONFIGURATION2_PROTOCOL                        *This,

+  IN  EFI_HANDLE                                              ControllerHandle,

+  IN  EFI_HANDLE                                              ChildHandle  OPTIONAL,

+  IN  UINT32                                                  DefaultType,

+  OUT EFI_DRIVER_CONFIGURATION_ACTION_REQUIRED                *ActionRequired

+  );

+

+///

+/// Used to set configuration options for a controller that an EFI Driver is managing.

+///

+struct _EFI_DRIVER_CONFIGURATION2_PROTOCOL {

+  EFI_DRIVER_CONFIGURATION2_SET_OPTIONS     SetOptions;

+  EFI_DRIVER_CONFIGURATION2_OPTIONS_VALID   OptionsValid;

+  EFI_DRIVER_CONFIGURATION2_FORCE_DEFAULTS  ForceDefaults;

+  ///

+  /// A Null-terminated ASCII string that contains one or more RFC 4646

+  /// language codes.  This is the list of language codes that this protocol supports.

+  ///

+  CHAR8                                     *SupportedLanguages;

+};

+

+extern EFI_GUID gEfiDriverConfiguration2ProtocolGuid;

+

+#endif

diff --git a/debugging_demo/memtest86+/efi/Include/Protocol/DriverDiagnostics.h b/debugging_demo/memtest86+/efi/Include/Protocol/DriverDiagnostics.h
new file mode 100644
index 0000000..8139c99
--- /dev/null
+++ b/debugging_demo/memtest86+/efi/Include/Protocol/DriverDiagnostics.h
@@ -0,0 +1,125 @@
+/** @file

+  EFI Driver Diagnostics Protocol

+

+Copyright (c) 2006 - 2018, Intel Corporation. All rights reserved.<BR>

+SPDX-License-Identifier: BSD-2-Clause-Patent

+

+**/

+

+#ifndef __EFI_DRIVER_DIAGNOSTICS_H__

+#define __EFI_DRIVER_DIAGNOSTICS_H__

+

+///

+/// The global ID for the Driver Diagnostics Protocol as defined in EFI 1.1.

+///

+#define EFI_DRIVER_DIAGNOSTICS_PROTOCOL_GUID \

+  { \

+    0x0784924f, 0xe296, 0x11d4, {0x9a, 0x49, 0x0, 0x90, 0x27, 0x3f, 0xc1, 0x4d } \

+  }

+

+typedef struct _EFI_DRIVER_DIAGNOSTICS_PROTOCOL  EFI_DRIVER_DIAGNOSTICS_PROTOCOL;

+

+typedef enum {

+  ///

+  /// Performs standard diagnostics on the controller.

+  ///

+  EfiDriverDiagnosticTypeStandard     = 0,

+  ///

+  /// This is an optional diagnostic type that performs diagnostics on the controller that may

+  /// take an extended amount of time to execute.

+  ///

+  EfiDriverDiagnosticTypeExtended     = 1,

+  ///

+  /// This is an optional diagnostic type that performs diagnostics on the controller that are

+  /// suitable for a manufacturing and test environment.

+  ///

+  EfiDriverDiagnosticTypeManufacturing= 2,

+  ///

+  /// This is an optional diagnostic type that would only be used in the situation where an

+  /// EFI_NOT_READY had been returned by a previous call to RunDiagnostics()

+  /// and there is a desire to cancel the current running diagnostics operation.

+  ///

+  EfiDriverDiagnosticTypeCancel       = 3,

+  EfiDriverDiagnosticTypeMaximum

+} EFI_DRIVER_DIAGNOSTIC_TYPE;

+

+/**

+  Runs diagnostics on a controller.

+

+  @param  This             A pointer to the EFI_DRIVER_DIAGNOSTICS_PROTOCOL instance.

+  @param  ControllerHandle The handle of the controller to run diagnostics on.

+  @param  ChildHandle      The handle of the child controller to run diagnostics on

+                           This is an optional parameter that may be NULL.  It will

+                           be NULL for device drivers.  It will also be NULL for a

+                           bus drivers that wish to run diagnostics on the bus

+                           controller.  It will not be NULL for a bus driver that

+                           wishes to run diagnostics on one of its child controllers.

+  @param  DiagnosticType   Indicates type of diagnostics to perform on the controller

+                           specified by ControllerHandle and ChildHandle.   See

+                           "Related Definitions" for the list of supported types.

+  @param  Language         A pointer to a three character ISO 639-2 language

+                           identifier.  This is the language in which the optional

+                           error message should be returned in Buffer, and it must

+                           match one of the languages specified in SupportedLanguages.

+                           The number of languages supported by a driver is up to

+                           the driver writer.

+  @param  ErrorType        A GUID that defines the format of the data returned in Buffer.

+  @param  BufferSize       The size, in bytes, of the data returned in Buffer.

+  @param  Buffer           A buffer that contains a Null-terminated string

+                           plus some additional data whose format is defined by

+                           ErrorType.  Buffer is allocated by this function with

+                           AllocatePool(), and it is the caller's responsibility

+                           to free it with a call to FreePool().

+

+  @retval EFI_SUCCESS           The controller specified by ControllerHandle and

+                                ChildHandle passed the diagnostic.

+  @retval EFI_INVALID_PARAMETER ControllerHandle is NULL.

+  @retval EFI_INVALID_PARAMETER ChildHandle is not NULL, and it is not a valid EFI_HANDLE.

+  @retval EFI_INVALID_PARAMETER Language is NULL.

+  @retval EFI_INVALID_PARAMETER ErrorType is NULL.

+  @retval EFI_INVALID_PARAMETER BufferType is NULL.

+  @retval EFI_INVALID_PARAMETER Buffer is NULL.

+  @retval EFI_UNSUPPORTED       The driver specified by This does not support

+                                running diagnostics for the controller specified

+                                by ControllerHandle and ChildHandle.

+  @retval EFI_UNSUPPORTED       The driver specified by This does not support the

+                                type of diagnostic specified by DiagnosticType.

+  @retval EFI_UNSUPPORTED       The driver specified by This does not support the

+                                language specified by Language.

+  @retval EFI_OUT_OF_RESOURCES  There are not enough resources available to complete

+                                the diagnostics.

+  @retval EFI_OUT_OF_RESOURCES  There are not enough resources available to return

+                                the status information in ErrorType, BufferSize,

+                                and Buffer.

+  @retval EFI_DEVICE_ERROR      The controller specified by ControllerHandle and

+                                ChildHandle did not pass the diagnostic.

+

+**/

+typedef

+EFI_STATUS

+(EFIAPI *EFI_DRIVER_DIAGNOSTICS_RUN_DIAGNOSTICS)(

+  IN EFI_DRIVER_DIAGNOSTICS_PROTOCOL                        *This,

+  IN  EFI_HANDLE                                            ControllerHandle,

+  IN  EFI_HANDLE                                            ChildHandle  OPTIONAL,

+  IN  EFI_DRIVER_DIAGNOSTIC_TYPE                            DiagnosticType,

+  IN  CHAR8                                                 *Language,

+  OUT EFI_GUID                                              **ErrorType,

+  OUT UINTN                                                 *BufferSize,

+  OUT CHAR16                                                **Buffer

+  );

+

+///

+/// Used to perform diagnostics on a controller that an EFI Driver is managing.

+///

+struct _EFI_DRIVER_DIAGNOSTICS_PROTOCOL {

+  EFI_DRIVER_DIAGNOSTICS_RUN_DIAGNOSTICS  RunDiagnostics;

+  ///

+  /// A Null-terminated ASCII string that contains one or more ISO 639-2

+  /// language codes.  This is the list of language codes that this protocol supports.

+  ///

+  CHAR8                                   *SupportedLanguages;

+};

+

+extern EFI_GUID gEfiDriverDiagnosticsProtocolGuid;

+

+#endif

diff --git a/debugging_demo/memtest86+/efi/Include/Protocol/DriverDiagnostics2.h b/debugging_demo/memtest86+/efi/Include/Protocol/DriverDiagnostics2.h
new file mode 100644
index 0000000..9babeb1
--- /dev/null
+++ b/debugging_demo/memtest86+/efi/Include/Protocol/DriverDiagnostics2.h
@@ -0,0 +1,105 @@
+/** @file

+  UEFI Driver Diagnostics2 Protocol

+

+  Copyright (c) 2006 - 2018, Intel Corporation. All rights reserved.<BR>

+  SPDX-License-Identifier: BSD-2-Clause-Patent

+

+**/

+

+#ifndef __EFI_DRIVER_DIAGNOSTICS2_H__

+#define __EFI_DRIVER_DIAGNOSTICS2_H__

+

+#include <Protocol/DriverDiagnostics.h>

+

+#define EFI_DRIVER_DIAGNOSTICS2_PROTOCOL_GUID \

+  { \

+    0x4d330321, 0x025f, 0x4aac, {0x90, 0xd8, 0x5e, 0xd9, 0x00, 0x17, 0x3b, 0x63 } \

+  }

+

+typedef struct _EFI_DRIVER_DIAGNOSTICS2_PROTOCOL  EFI_DRIVER_DIAGNOSTICS2_PROTOCOL;

+

+/**

+  Runs diagnostics on a controller.

+

+  @param  This             A pointer to the EFI_DRIVER_DIAGNOSTICS2_PROTOCOL instance.

+  @param  ControllerHandle The handle of the controller to run diagnostics on.

+  @param  ChildHandle      The handle of the child controller to run diagnostics on

+                           This is an optional parameter that may be NULL.  It will

+                           be NULL for device drivers.  It will also be NULL for

+                           bus drivers that wish to run diagnostics on the bus

+                           controller.  It will not be NULL for a bus driver that

+                           wishes to run diagnostics on one of its child controllers.

+  @param  DiagnosticType   Indicates the type of diagnostics to perform on the controller

+                           specified by ControllerHandle and ChildHandle.   See

+                           "Related Definitions" for the list of supported types.

+  @param  Language         A pointer to a Null-terminated ASCII string

+                           array indicating the language. This is the

+                           language of the driver name that the caller

+                           is requesting, and it must match one of the

+                           languages specified in SupportedLanguages.

+                           The number of languages supported by a

+                           driver is up to the driver writer. Language

+                           is specified in RFC 4646 language code format.

+  @param  ErrorType        A GUID that defines the format of the data returned in Buffer.

+  @param  BufferSize       The size, in bytes, of the data returned in Buffer.

+  @param  Buffer           A buffer that contains a Null-terminated Unicode string

+                           plus some additional data whose format is defined by

+                           ErrorType.  Buffer is allocated by this function with

+                           AllocatePool(), and it is the caller's responsibility

+                           to free it with a call to FreePool().

+

+  @retval EFI_SUCCESS           The controller specified by ControllerHandle and

+                                ChildHandle passed the diagnostic.

+  @retval EFI_ACCESS_DENIED     The request for initiating diagnostics was unable

+                                to be complete due to some underlying hardware or

+                                software state.

+  @retval EFI_INVALID_PARAMETER ControllerHandle is NULL.

+  @retval EFI_INVALID_PARAMETER ChildHandle is not NULL and it is not a valid EFI_HANDLE.

+  @retval EFI_INVALID_PARAMETER Language is NULL.

+  @retval EFI_INVALID_PARAMETER ErrorType is NULL.

+  @retval EFI_INVALID_PARAMETER BufferType is NULL.

+  @retval EFI_INVALID_PARAMETER Buffer is NULL.

+  @retval EFI_UNSUPPORTED       The driver specified by This does not support

+                                running diagnostics for the controller specified

+                                by ControllerHandle and ChildHandle.

+  @retval EFI_UNSUPPORTED       The driver specified by This does not support the

+                                type of diagnostic specified by DiagnosticType.

+  @retval EFI_UNSUPPORTED       The driver specified by This does not support the

+                                language specified by Language.

+  @retval EFI_OUT_OF_RESOURCES  There are not enough resources available to complete

+                                the diagnostics.

+  @retval EFI_OUT_OF_RESOURCES  There are not enough resources available to return

+                                the status information in ErrorType, BufferSize,

+                                and Buffer.

+  @retval EFI_DEVICE_ERROR      The controller specified by ControllerHandle and

+                                ChildHandle did not pass the diagnostic.

+

+**/

+typedef

+EFI_STATUS

+(EFIAPI *EFI_DRIVER_DIAGNOSTICS2_RUN_DIAGNOSTICS)(

+  IN EFI_DRIVER_DIAGNOSTICS2_PROTOCOL                       *This,

+  IN  EFI_HANDLE                                            ControllerHandle,

+  IN  EFI_HANDLE                                            ChildHandle  OPTIONAL,

+  IN  EFI_DRIVER_DIAGNOSTIC_TYPE                            DiagnosticType,

+  IN  CHAR8                                                 *Language,

+  OUT EFI_GUID                                              **ErrorType,

+  OUT UINTN                                                 *BufferSize,

+  OUT CHAR16                                                **Buffer

+  );

+

+///

+/// Used to perform diagnostics on a controller that an EFI Driver is managing.

+///

+struct _EFI_DRIVER_DIAGNOSTICS2_PROTOCOL {

+  EFI_DRIVER_DIAGNOSTICS2_RUN_DIAGNOSTICS RunDiagnostics;

+  ///

+  /// A Null-terminated ASCII string that contains one or more RFC 4646

+  /// language codes.  This is the list of language codes that this protocol supports.

+  ///

+  CHAR8                                   *SupportedLanguages;

+};

+

+extern EFI_GUID gEfiDriverDiagnostics2ProtocolGuid;

+

+#endif

diff --git a/debugging_demo/memtest86+/efi/Include/Protocol/GraphicsOutput.h b/debugging_demo/memtest86+/efi/Include/Protocol/GraphicsOutput.h
new file mode 100644
index 0000000..1115646
--- /dev/null
+++ b/debugging_demo/memtest86+/efi/Include/Protocol/GraphicsOutput.h
@@ -0,0 +1,265 @@
+/** @file

+  Graphics Output Protocol from the UEFI 2.0 specification.

+

+  Abstraction of a very simple graphics device.

+

+  Copyright (c) 2006 - 2018, Intel Corporation. All rights reserved.<BR>

+  SPDX-License-Identifier: BSD-2-Clause-Patent

+

+**/

+

+#ifndef __GRAPHICS_OUTPUT_H__

+#define __GRAPHICS_OUTPUT_H__

+

+typedef struct _EFI_GRAPHICS_OUTPUT_PROTOCOL EFI_GRAPHICS_OUTPUT_PROTOCOL;

+

+typedef struct {

+  UINT32            RedMask;

+  UINT32            GreenMask;

+  UINT32            BlueMask;

+  UINT32            ReservedMask;

+} EFI_PIXEL_BITMASK;

+

+typedef enum {

+  ///

+  /// A pixel is 32-bits and byte zero represents red, byte one represents green,

+  /// byte two represents blue, and byte three is reserved. This is the definition

+  /// for the physical frame buffer. The byte values for the red, green, and blue

+  /// components represent the color intensity. This color intensity value range

+  /// from a minimum intensity of 0 to maximum intensity of 255.

+  ///

+  PixelRedGreenBlueReserved8BitPerColor,

+  ///

+  /// A pixel is 32-bits and byte zero represents blue, byte one represents green,

+  /// byte two represents red, and byte three is reserved. This is the definition

+  /// for the physical frame buffer. The byte values for the red, green, and blue

+  /// components represent the color intensity. This color intensity value range

+  /// from a minimum intensity of 0 to maximum intensity of 255.

+  ///

+  PixelBlueGreenRedReserved8BitPerColor,

+  ///

+  /// The Pixel definition of the physical frame buffer.

+  ///

+  PixelBitMask,

+  ///

+  /// This mode does not support a physical frame buffer.

+  ///

+  PixelBltOnly,

+  ///

+  /// Valid EFI_GRAPHICS_PIXEL_FORMAT enum values are less than this value.

+  ///

+  PixelFormatMax

+} EFI_GRAPHICS_PIXEL_FORMAT;

+

+typedef struct {

+  ///

+  /// The version of this data structure. A value of zero represents the

+  /// EFI_GRAPHICS_OUTPUT_MODE_INFORMATION structure as defined in this specification.

+  ///

+  UINT32                     Version;

+  ///

+  /// The size of video screen in pixels in the X dimension.

+  ///

+  UINT32                     HorizontalResolution;

+  ///

+  /// The size of video screen in pixels in the Y dimension.

+  ///

+  UINT32                     VerticalResolution;

+  ///

+  /// Enumeration that defines the physical format of the pixel. A value of PixelBltOnly

+  /// implies that a linear frame buffer is not available for this mode.

+  ///

+  EFI_GRAPHICS_PIXEL_FORMAT  PixelFormat;

+  ///

+  /// This bit-mask is only valid if PixelFormat is set to PixelPixelBitMask.

+  /// A bit being set defines what bits are used for what purpose such as Red, Green, Blue, or Reserved.

+  ///

+  EFI_PIXEL_BITMASK          PixelInformation;

+  ///

+  /// Defines the number of pixel elements per video memory line.

+  ///

+  UINT32                     PixelsPerScanLine;

+} EFI_GRAPHICS_OUTPUT_MODE_INFORMATION;

+

+/**

+  Returns information for an available graphics mode that the graphics device

+  and the set of active video output devices supports.

+

+  @param  This                  The EFI_GRAPHICS_OUTPUT_PROTOCOL instance.

+  @param  ModeNumber            The mode number to return information on.

+  @param  SizeOfInfo            A pointer to the size, in bytes, of the Info buffer.

+  @param  Info                  A pointer to callee allocated buffer that returns information about ModeNumber.

+

+  @retval EFI_SUCCESS           Valid mode information was returned.

+  @retval EFI_DEVICE_ERROR      A hardware error occurred trying to retrieve the video mode.

+  @retval EFI_INVALID_PARAMETER ModeNumber is not valid.

+

+**/

+typedef

+EFI_STATUS

+(EFIAPI *EFI_GRAPHICS_OUTPUT_PROTOCOL_QUERY_MODE)(

+  IN  EFI_GRAPHICS_OUTPUT_PROTOCOL          *This,

+  IN  UINT32                                ModeNumber,

+  OUT UINTN                                 *SizeOfInfo,

+  OUT EFI_GRAPHICS_OUTPUT_MODE_INFORMATION  **Info

+  );

+

+/**

+  Set the video device into the specified mode and clears the visible portions of

+  the output display to black.

+

+  @param  This              The EFI_GRAPHICS_OUTPUT_PROTOCOL instance.

+  @param  ModeNumber        Abstraction that defines the current video mode.

+

+  @retval EFI_SUCCESS       The graphics mode specified by ModeNumber was selected.

+  @retval EFI_DEVICE_ERROR  The device had an error and could not complete the request.

+  @retval EFI_UNSUPPORTED   ModeNumber is not supported by this device.

+

+**/

+typedef

+EFI_STATUS

+(EFIAPI *EFI_GRAPHICS_OUTPUT_PROTOCOL_SET_MODE)(

+  IN  EFI_GRAPHICS_OUTPUT_PROTOCOL *This,

+  IN  UINT32                       ModeNumber

+  );

+

+typedef struct {

+  UINT8 Blue;

+  UINT8 Green;

+  UINT8 Red;

+  UINT8 Reserved;

+} EFI_GRAPHICS_OUTPUT_BLT_PIXEL;

+

+typedef union {

+  EFI_GRAPHICS_OUTPUT_BLT_PIXEL Pixel;

+  UINT32                        Raw;

+} EFI_GRAPHICS_OUTPUT_BLT_PIXEL_UNION;

+

+///

+/// actions for BltOperations

+///

+typedef enum {

+  ///

+  /// Write data from the BltBuffer pixel (0, 0)

+  /// directly to every pixel of the video display rectangle

+  /// (DestinationX, DestinationY) (DestinationX + Width, DestinationY + Height).

+  /// Only one pixel will be used from the BltBuffer. Delta is NOT used.

+  ///

+  EfiBltVideoFill,

+

+  ///

+  /// Read data from the video display rectangle

+  /// (SourceX, SourceY) (SourceX + Width, SourceY + Height) and place it in

+  /// the BltBuffer rectangle (DestinationX, DestinationY )

+  /// (DestinationX + Width, DestinationY + Height). If DestinationX or

+  /// DestinationY is not zero then Delta must be set to the length in bytes

+  /// of a row in the BltBuffer.

+  ///

+  EfiBltVideoToBltBuffer,

+

+  ///

+  /// Write data from the BltBuffer rectangle

+  /// (SourceX, SourceY) (SourceX + Width, SourceY + Height) directly to the

+  /// video display rectangle (DestinationX, DestinationY)

+  /// (DestinationX + Width, DestinationY + Height). If SourceX or SourceY is

+  /// not zero then Delta must be set to the length in bytes of a row in the

+  /// BltBuffer.

+  ///

+  EfiBltBufferToVideo,

+

+  ///

+  /// Copy from the video display rectangle (SourceX, SourceY)

+  /// (SourceX + Width, SourceY + Height) to the video display rectangle

+  /// (DestinationX, DestinationY) (DestinationX + Width, DestinationY + Height).

+  /// The BltBuffer and Delta are not used in this mode.

+  ///

+  EfiBltVideoToVideo,

+

+  EfiGraphicsOutputBltOperationMax

+} EFI_GRAPHICS_OUTPUT_BLT_OPERATION;

+

+/**

+  Blt a rectangle of pixels on the graphics screen. Blt stands for BLock Transfer.

+

+  @param  This         Protocol instance pointer.

+  @param  BltBuffer    The data to transfer to the graphics screen.

+                       Size is at least Width*Height*sizeof(EFI_GRAPHICS_OUTPUT_BLT_PIXEL).

+  @param  BltOperation The operation to perform when copying BltBuffer on to the graphics screen.

+  @param  SourceX      The X coordinate of source for the BltOperation.

+  @param  SourceY      The Y coordinate of source for the BltOperation.

+  @param  DestinationX The X coordinate of destination for the BltOperation.

+  @param  DestinationY The Y coordinate of destination for the BltOperation.

+  @param  Width        The width of a rectangle in the blt rectangle in pixels.

+  @param  Height       The height of a rectangle in the blt rectangle in pixels.

+  @param  Delta        Not used for EfiBltVideoFill or the EfiBltVideoToVideo operation.

+                       If a Delta of zero is used, the entire BltBuffer is being operated on.

+                       If a subrectangle of the BltBuffer is being used then Delta

+                       represents the number of bytes in a row of the BltBuffer.

+

+  @retval EFI_SUCCESS           BltBuffer was drawn to the graphics screen.

+  @retval EFI_INVALID_PARAMETER BltOperation is not valid.

+  @retval EFI_DEVICE_ERROR      The device had an error and could not complete the request.

+

+**/

+typedef

+EFI_STATUS

+(EFIAPI *EFI_GRAPHICS_OUTPUT_PROTOCOL_BLT)(

+  IN  EFI_GRAPHICS_OUTPUT_PROTOCOL            *This,

+  IN  EFI_GRAPHICS_OUTPUT_BLT_PIXEL           *BltBuffer,   OPTIONAL

+  IN  EFI_GRAPHICS_OUTPUT_BLT_OPERATION       BltOperation,

+  IN  UINTN                                   SourceX,

+  IN  UINTN                                   SourceY,

+  IN  UINTN                                   DestinationX,

+  IN  UINTN                                   DestinationY,

+  IN  UINTN                                   Width,

+  IN  UINTN                                   Height,

+  IN  UINTN                                   Delta         OPTIONAL

+  );

+

+typedef struct {

+  ///

+  /// The number of modes supported by QueryMode() and SetMode().

+  ///

+  UINT32                                 MaxMode;

+  ///

+  /// Current Mode of the graphics device. Valid mode numbers are 0 to MaxMode -1.

+  ///

+  UINT32                                 Mode;

+  ///

+  /// Pointer to read-only EFI_GRAPHICS_OUTPUT_MODE_INFORMATION data.

+  ///

+  EFI_GRAPHICS_OUTPUT_MODE_INFORMATION   *Info;

+  ///

+  /// Size of Info structure in bytes.

+  ///

+  UINTN                                  SizeOfInfo;

+  ///

+  /// Base address of graphics linear frame buffer.

+  /// Offset zero in FrameBufferBase represents the upper left pixel of the display.

+  ///

+  EFI_PHYSICAL_ADDRESS                   FrameBufferBase;

+  ///

+  /// Amount of frame buffer needed to support the active mode as defined by

+  /// PixelsPerScanLine xVerticalResolution x PixelElementSize.

+  ///

+  UINTN                                  FrameBufferSize;

+} EFI_GRAPHICS_OUTPUT_PROTOCOL_MODE;

+

+///

+/// Provides a basic abstraction to set video modes and copy pixels to and from

+/// the graphics controller's frame buffer. The linear address of the hardware

+/// frame buffer is also exposed so software can write directly to the video hardware.

+///

+struct _EFI_GRAPHICS_OUTPUT_PROTOCOL {

+  EFI_GRAPHICS_OUTPUT_PROTOCOL_QUERY_MODE  QueryMode;

+  EFI_GRAPHICS_OUTPUT_PROTOCOL_SET_MODE    SetMode;

+  EFI_GRAPHICS_OUTPUT_PROTOCOL_BLT         Blt;

+  ///

+  /// Pointer to EFI_GRAPHICS_OUTPUT_PROTOCOL_MODE data.

+  ///

+  EFI_GRAPHICS_OUTPUT_PROTOCOL_MODE        *Mode;

+};

+

+extern EFI_GUID gEfiGraphicsOutputProtocolGuid;

+

+#endif

diff --git a/debugging_demo/memtest86+/efi/Include/Protocol/HiiFont.h b/debugging_demo/memtest86+/efi/Include/Protocol/HiiFont.h
new file mode 100644
index 0000000..1f2e321
--- /dev/null
+++ b/debugging_demo/memtest86+/efi/Include/Protocol/HiiFont.h
@@ -0,0 +1,469 @@
+/** @file

+  The file provides services to retrieve font information.

+

+Copyright (c) 2006 - 2018, Intel Corporation. All rights reserved.<BR>

+SPDX-License-Identifier: BSD-2-Clause-Patent

+

+  @par Revision Reference:

+  This Protocol was introduced in UEFI Specification 2.1.

+

+**/

+

+#ifndef __HII_FONT_H__

+#define __HII_FONT_H__

+

+#include <Protocol/GraphicsOutput.h>

+#include <Protocol/HiiImage.h>

+

+#define EFI_HII_FONT_PROTOCOL_GUID \

+{ 0xe9ca4775, 0x8657, 0x47fc, { 0x97, 0xe7, 0x7e, 0xd6, 0x5a, 0x8, 0x43, 0x24 } }

+

+typedef struct _EFI_HII_FONT_PROTOCOL EFI_HII_FONT_PROTOCOL;

+

+typedef VOID    *EFI_FONT_HANDLE;

+

+///

+/// EFI_HII_OUT_FLAGS.

+///

+typedef UINT32  EFI_HII_OUT_FLAGS;

+

+#define EFI_HII_OUT_FLAG_CLIP         0x00000001

+#define EFI_HII_OUT_FLAG_WRAP         0x00000002

+#define EFI_HII_OUT_FLAG_CLIP_CLEAN_Y 0x00000004

+#define EFI_HII_OUT_FLAG_CLIP_CLEAN_X 0x00000008

+#define EFI_HII_OUT_FLAG_TRANSPARENT  0x00000010

+#define EFI_HII_IGNORE_IF_NO_GLYPH    0x00000020

+#define EFI_HII_IGNORE_LINE_BREAK     0x00000040

+#define EFI_HII_DIRECT_TO_SCREEN      0x00000080

+

+/**

+  Definition of EFI_HII_ROW_INFO.

+**/

+typedef struct _EFI_HII_ROW_INFO {

+  ///

+  /// The index of the first character in the string which is displayed on the line.

+  ///

+  UINTN   StartIndex;

+  ///

+  /// The index of the last character in the string which is displayed on the line.

+  /// If this is the same as StartIndex, then no characters are displayed.

+  ///

+  UINTN   EndIndex;

+  UINTN   LineHeight; ///< The height of the line, in pixels.

+  UINTN   LineWidth;  ///< The width of the text on the line, in pixels.

+

+  ///

+  /// The font baseline offset in pixels from the bottom of the row, or 0 if none.

+  ///

+  UINTN   BaselineOffset;

+} EFI_HII_ROW_INFO;

+

+///

+/// Font info flag. All flags (FONT, SIZE, STYLE, and COLOR) are defined.

+/// They are defined as EFI_FONT_INFO_***

+///

+typedef UINT32  EFI_FONT_INFO_MASK;

+

+#define EFI_FONT_INFO_SYS_FONT        0x00000001

+#define EFI_FONT_INFO_SYS_SIZE        0x00000002

+#define EFI_FONT_INFO_SYS_STYLE       0x00000004

+#define EFI_FONT_INFO_SYS_FORE_COLOR  0x00000010

+#define EFI_FONT_INFO_SYS_BACK_COLOR  0x00000020

+#define EFI_FONT_INFO_RESIZE          0x00001000

+#define EFI_FONT_INFO_RESTYLE         0x00002000

+#define EFI_FONT_INFO_ANY_FONT        0x00010000

+#define EFI_FONT_INFO_ANY_SIZE        0x00020000

+#define EFI_FONT_INFO_ANY_STYLE       0x00040000

+

+//

+// EFI_FONT_INFO

+//

+typedef struct {

+  EFI_HII_FONT_STYLE FontStyle;

+  UINT16             FontSize;      ///< character cell height in pixels

+  CHAR16             FontName[1];

+} EFI_FONT_INFO;

+

+/**

+  Describes font output-related information.

+

+  This structure is used for describing the way in which a string

+  should be rendered in a particular font. FontInfo specifies the

+  basic font information and ForegroundColor and BackgroundColor

+  specify the color in which they should be displayed. The flags

+  in FontInfoMask describe where the system default should be

+  supplied instead of the specified information. The flags also

+  describe what options can be used to make a match between the

+  font requested and the font available.

+**/

+typedef struct _EFI_FONT_DISPLAY_INFO {

+  EFI_GRAPHICS_OUTPUT_BLT_PIXEL ForegroundColor;

+  EFI_GRAPHICS_OUTPUT_BLT_PIXEL BackgroundColor;

+  EFI_FONT_INFO_MASK            FontInfoMask;

+  EFI_FONT_INFO                 FontInfo;

+} EFI_FONT_DISPLAY_INFO;

+

+/**

+

+  This function renders a string to a bitmap or the screen using

+  the specified font, color and options. It either draws the

+  string and glyphs on an existing bitmap, allocates a new bitmap,

+  or uses the screen. The strings can be clipped or wrapped.

+  Optionally, the function also returns the information about each

+  row and the character position on that row. If

+  EFI_HII_OUT_FLAG_CLIP is set, then text will be formatted only

+  based on explicit line breaks and all pixels which would lie

+  outside the bounding box specified by Width and Height are

+  ignored. The information in the RowInfoArray only describes

+  characters which are at least partially displayed. For the final

+  row, the LineHeight and BaseLine may describe pixels that are

+  outside the limit specified by Height (unless

+  EFI_HII_OUT_FLAG_CLIP_CLEAN_Y is specified) even though those

+  pixels were not drawn. The LineWidth may describe pixels which

+  are outside the limit specified by Width (unless

+  EFI_HII_OUT_FLAG_CLIP_CLEAN_X is specified) even though those

+  pixels were not drawn. If EFI_HII_OUT_FLAG_CLIP_CLEAN_X is set,

+  then it modifies the behavior of EFI_HII_OUT_FLAG_CLIP so that

+  if a character's right-most on pixel cannot fit, then it will

+  not be drawn at all. This flag requires that

+  EFI_HII_OUT_FLAG_CLIP be set. If EFI_HII_OUT_FLAG_CLIP_CLEAN_Y

+  is set, then it modifies the behavior of EFI_HII_OUT_FLAG_CLIP

+  so that if a row's bottom-most pixel cannot fit, then it will

+  not be drawn at all. This flag requires that

+  EFI_HII_OUT_FLAG_CLIP be set. If EFI_HII_OUT_FLAG_WRAP is set,

+  then text will be wrapped at the right-most line-break

+  opportunity prior to a character whose right-most extent would

+  exceed Width. If no line-break opportunity can be found, then

+  the text will behave as if EFI_HII_OUT_FLAG_CLIP_CLEAN_X is set.

+  This flag cannot be used with EFI_HII_OUT_FLAG_CLIP_CLEAN_X. If

+  EFI_HII_OUT_FLAG_TRANSPARENT is set, then BackgroundColor is

+  ignored and all 'off' pixels in the character's drawn

+  will use the pixel value from Blt. This flag cannot be used if

+  Blt is NULL upon entry. If EFI_HII_IGNORE_IF_NO_GLYPH is set,

+  then characters which have no glyphs are not drawn. Otherwise,

+  they are replaced with Unicode character code 0xFFFD (REPLACEMENT

+  CHARACTER). If EFI_HII_IGNORE_LINE_BREAK is set, then explicit

+  line break characters will be ignored. If

+  EFI_HII_DIRECT_TO_SCREEN is set, then the string will be written

+  directly to the output device specified by Screen. Otherwise the

+  string will be rendered to the bitmap specified by Bitmap.

+

+  @param This             A pointer to the EFI_HII_FONT_PROTOCOL instance.

+

+  @param Flags            Describes how the string is to be drawn.

+

+  @param String           Points to the null-terminated string to be

+

+  @param StringInfo       Points to the string output information,

+                          including the color and font. If NULL, then

+                          the string will be output in the default

+                          system font and color.

+

+  @param Blt              If this points to a non-NULL on entry, this points

+                          to the image, which is Width pixels wide and

+                          Height pixels high. The string will be drawn onto

+                          this image and EFI_HII_OUT_FLAG_CLIP is implied.

+                          If this points to a NULL on entry, then a buffer

+                          will be allocated to hold the generated image and

+                          the pointer updated on exit. It is the caller's

+                          responsibility to free this buffer.

+

+  @param BltX, BltY       Specifies the offset from the left and top

+                          edge of the image of the first character

+                          cell in the image.

+

+  @param RowInfoArray     If this is non-NULL on entry, then on

+                          exit, this will point to an allocated buffer

+                          containing row information and

+                          RowInfoArraySize will be updated to contain

+                          the number of elements. This array describes

+                          the characters that were at least partially

+                          drawn and the heights of the rows. It is the

+                          caller's responsibility to free this buffer.

+

+  @param RowInfoArraySize If this is non-NULL on entry, then on

+                          exit it contains the number of

+                          elements in RowInfoArray.

+

+  @param ColumnInfoArray  If this is non-NULL, then on return it

+                          will be filled with the horizontal

+                          offset for each character in the

+                          string on the row where it is

+                          displayed. Non-printing characters

+                          will have the offset ~0. The caller is

+                          responsible for allocating a buffer large

+                          enough so that there is one entry for

+                          each character in the string, not

+                          including the null-terminator. It is

+                          possible when character display is

+                          normalized that some character cells

+                          overlap.

+

+  @retval EFI_SUCCESS           The string was successfully updated.

+

+  @retval EFI_OUT_OF_RESOURCES  Unable to allocate an output buffer for RowInfoArray or Blt.

+

+  @retval EFI_INVALID_PARAMETER The String or Blt was NULL.

+

+  @retval EFI_INVALID_PARAMETER Flags were invalid combination.

+**/

+typedef

+EFI_STATUS

+(EFIAPI *EFI_HII_STRING_TO_IMAGE)(

+  IN CONST  EFI_HII_FONT_PROTOCOL *This,

+  IN        EFI_HII_OUT_FLAGS     Flags,

+  IN CONST  EFI_STRING            String,

+  IN CONST  EFI_FONT_DISPLAY_INFO *StringInfo,

+  IN OUT    EFI_IMAGE_OUTPUT      **Blt,

+  IN        UINTN                 BltX,

+  IN        UINTN                 BltY,

+  OUT       EFI_HII_ROW_INFO      **RowInfoArray OPTIONAL,

+  OUT       UINTN                 *RowInfoArraySize OPTIONAL,

+  OUT       UINTN                 *ColumnInfoArray OPTIONAL

+);

+

+

+

+/**

+

+  This function renders a string as a bitmap or to the screen

+  and can clip or wrap the string. The bitmap is either supplied

+  by the caller or allocated by the function. The

+  strings are drawn with the font, size and style specified and

+  can be drawn transparently or opaquely. The function can also

+  return information about each row and each character's

+  position on the row. If EFI_HII_OUT_FLAG_CLIP is set, then

+  text will be formatted based only on explicit line breaks, and

+  all pixels that would lie outside the bounding box specified

+  by Width and Height are ignored. The information in the

+  RowInfoArray only describes characters which are at least

+  partially displayed. For the final row, the LineHeight and

+  BaseLine may describe pixels which are outside the limit

+  specified by Height (unless EFI_HII_OUT_FLAG_CLIP_CLEAN_Y is

+  specified) even though those pixels were not drawn. If

+  EFI_HII_OUT_FLAG_CLIP_CLEAN_X is set, then it modifies the

+  behavior of EFI_HII_OUT_FLAG_CLIP so that if a character's

+  right-most on pixel cannot fit, then it will not be drawn at

+  all. This flag requires that EFI_HII_OUT_FLAG_CLIP be set. If

+  EFI_HII_OUT_FLAG_CLIP_CLEAN_Y is set, then it modifies the

+  behavior of EFI_HII_OUT_FLAG_CLIP so that if a row's bottom

+  most pixel cannot fit, then it will not be drawn at all. This

+  flag requires that EFI_HII_OUT_FLAG_CLIP be set. If

+  EFI_HII_OUT_FLAG_WRAP is set, then text will be wrapped at the

+  right-most line-break opportunity prior to a character whose

+  right-most extent would exceed Width. If no line-break

+  opportunity can be found, then the text will behave as if

+  EFI_HII_OUT_FLAG_CLIP_CLEAN_X is set. This flag cannot be used

+  with EFI_HII_OUT_FLAG_CLIP_CLEAN_X. If

+  EFI_HII_OUT_FLAG_TRANSPARENT is set, then BackgroundColor is

+  ignored and all off" pixels in the character's glyph will

+  use the pixel value from Blt. This flag cannot be used if Blt

+  is NULL upon entry. If EFI_HII_IGNORE_IF_NO_GLYPH is set, then

+  characters which have no glyphs are not drawn. Otherwise, they

+  are replaced with Unicode character code 0xFFFD (REPLACEMENT

+  CHARACTER). If EFI_HII_IGNORE_LINE_BREAK is set, then explicit

+  line break characters will be ignored. If

+  EFI_HII_DIRECT_TO_SCREEN is set, then the string will be

+  written directly to the output device specified by Screen.

+  Otherwise the string will be rendered to the bitmap specified

+  by Bitmap.

+

+

+  @param This       A pointer to the EFI_HII_FONT_PROTOCOL instance.

+

+  @param Flags      Describes how the string is to be drawn.

+

+  @param PackageList

+                    The package list in the HII database to

+                    search for the specified string.

+

+  @param StringId   The string's id, which is unique within

+                    PackageList.

+

+  @param Language   Points to the language for the retrieved

+                    string. If NULL, then the current system

+                    language is used.

+

+  @param StringInfo Points to the string output information,

+                    including the color and font. If NULL, then

+                    the string will be output in the default

+                    system font and color.

+

+  @param Blt        If this points to a non-NULL on entry, this points

+                    to the image, which is Width pixels wide and

+                    Height pixels high. The string will be drawn onto

+                    this image and EFI_HII_OUT_FLAG_CLIP is implied.

+                    If this points to a NULL on entry, then a buffer

+                    will be allocated to hold the generated image and

+                    the pointer updated on exit. It is the caller's

+                    responsibility to free this buffer.

+

+  @param BltX, BltY Specifies the offset from the left and top

+                    edge of the output image of the first

+                    character cell in the image.

+

+  @param RowInfoArray     If this is non-NULL on entry, then on

+                          exit, this will point to an allocated

+                          buffer containing row information and

+                          RowInfoArraySize will be updated to

+                          contain the number of elements. This array

+                          describes the characters which were at

+                          least partially drawn and the heights of

+                          the rows. It is the caller's

+                          responsibility to free this buffer.

+

+  @param RowInfoArraySize If this is non-NULL on entry, then on

+                          exit it contains the number of

+                          elements in RowInfoArray.

+

+  @param ColumnInfoArray  If non-NULL, on return it is filled

+                          with the horizontal offset for each

+                          character in the string on the row

+                          where it is displayed. Non-printing

+                          characters will have the offset ~0.

+                          The caller is responsible to allocate

+                          a buffer large enough so that there is

+                          one entry for each character in the

+                          string, not including the

+                          null-terminator. It is possible when

+                          character display is normalized that

+                          some character cells overlap.

+

+

+  @retval EFI_SUCCESS           The string was successfully updated.

+

+  @retval EFI_OUT_OF_RESOURCES  Unable to allocate an output

+                                buffer for RowInfoArray or Blt.

+

+  @retval EFI_INVALID_PARAMETER The String, or Blt, or Height, or

+                                Width was NULL.

+  @retval EFI_INVALID_PARAMETER The Blt or PackageList was NULL.

+  @retval EFI_INVALID_PARAMETER Flags were invalid combination.

+  @retval EFI_NOT_FOUND         The specified PackageList is not in the Database,

+                                or the stringid is not in the specified PackageList.

+

+**/

+typedef

+EFI_STATUS

+(EFIAPI *EFI_HII_STRING_ID_TO_IMAGE)(

+  IN CONST  EFI_HII_FONT_PROTOCOL *This,

+  IN        EFI_HII_OUT_FLAGS     Flags,

+  IN        EFI_HII_HANDLE        PackageList,

+  IN        EFI_STRING_ID         StringId,

+  IN CONST  CHAR8                 *Language,

+  IN CONST  EFI_FONT_DISPLAY_INFO *StringInfo       OPTIONAL,

+  IN OUT    EFI_IMAGE_OUTPUT      **Blt,

+  IN        UINTN                 BltX,

+  IN        UINTN                 BltY,

+  OUT       EFI_HII_ROW_INFO      **RowInfoArray    OPTIONAL,

+  OUT       UINTN                 *RowInfoArraySize OPTIONAL,

+  OUT       UINTN                 *ColumnInfoArray  OPTIONAL

+);

+

+

+/**

+

+  Convert the glyph for a single character into a bitmap.

+

+  @param This       A pointer to the EFI_HII_FONT_PROTOCOL instance.

+

+  @param Char       The character to retrieve.

+

+  @param StringInfo Points to the string font and color

+                    information or NULL if the string should use

+                    the default system font and color.

+

+  @param Blt        This must point to a NULL on entry. A buffer will

+                    be allocated to hold the output and the pointer

+                    updated on exit. It is the caller's responsibility

+                    to free this buffer.

+

+  @param Baseline   The number of pixels from the bottom of the bitmap

+                    to the baseline.

+

+

+  @retval EFI_SUCCESS             The glyph bitmap created.

+

+  @retval EFI_OUT_OF_RESOURCES    Unable to allocate the output buffer Blt.

+

+  @retval EFI_WARN_UNKNOWN_GLYPH  The glyph was unknown and was

+                                  replaced with the glyph for

+                                  Unicode character code 0xFFFD.

+

+  @retval EFI_INVALID_PARAMETER   Blt is NULL, or Width is NULL, or

+                                  Height is NULL

+

+

+**/

+typedef

+EFI_STATUS

+(EFIAPI *EFI_HII_GET_GLYPH)(

+  IN CONST  EFI_HII_FONT_PROTOCOL *This,

+  IN CONST  CHAR16                Char,

+  IN CONST  EFI_FONT_DISPLAY_INFO *StringInfo,

+  OUT       EFI_IMAGE_OUTPUT      **Blt,

+  OUT       UINTN                 *Baseline OPTIONAL

+);

+

+/**

+

+  This function iterates through fonts which match the specified

+  font, using the specified criteria. If String is non-NULL, then

+  all of the characters in the string must exist in order for a

+  candidate font to be returned.

+

+  @param This           A pointer to the EFI_HII_FONT_PROTOCOL instance.

+

+  @param FontHandle     On entry, points to the font handle returned

+                        by a previous call to GetFontInfo() or NULL

+                        to start with the first font. On return,

+                        points to the returned font handle or points

+                        to NULL if there are no more matching fonts.

+

+  @param StringInfoIn   Upon entry, points to the font to return

+                        information about. If NULL, then the information

+                        about the system default font will be returned.

+

+  @param  StringInfoOut Upon return, contains the matching font's information.

+                        If NULL, then no information is returned. This buffer

+                        is allocated with a call to the Boot Service AllocatePool().

+                        It is the caller's responsibility to call the Boot

+                        Service FreePool() when the caller no longer requires

+                        the contents of StringInfoOut.

+

+  @param String         Points to the string which will be tested to

+                        determine if all characters are available. If

+                        NULL, then any font is acceptable.

+

+  @retval EFI_SUCCESS            Matching font returned successfully.

+

+  @retval EFI_NOT_FOUND          No matching font was found.

+

+  @retval EFI_OUT_OF_RESOURCES   There were insufficient resources to complete the request.

+

+**/

+typedef

+EFI_STATUS

+(EFIAPI *EFI_HII_GET_FONT_INFO)(

+  IN CONST  EFI_HII_FONT_PROTOCOL *This,

+  IN OUT    EFI_FONT_HANDLE       *FontHandle,

+  IN CONST  EFI_FONT_DISPLAY_INFO *StringInfoIn, OPTIONAL

+  OUT       EFI_FONT_DISPLAY_INFO **StringInfoOut,

+  IN CONST  EFI_STRING            String OPTIONAL

+);

+

+///

+/// The protocol provides the service to retrieve the font informations.

+///

+struct _EFI_HII_FONT_PROTOCOL {

+  EFI_HII_STRING_TO_IMAGE     StringToImage;

+  EFI_HII_STRING_ID_TO_IMAGE  StringIdToImage;

+  EFI_HII_GET_GLYPH           GetGlyph;

+  EFI_HII_GET_FONT_INFO       GetFontInfo;

+};

+

+extern EFI_GUID gEfiHiiFontProtocolGuid;

+

+

+#endif

+

diff --git a/debugging_demo/memtest86+/efi/Include/Protocol/HiiImage.h b/debugging_demo/memtest86+/efi/Include/Protocol/HiiImage.h
new file mode 100644
index 0000000..d72ac76
--- /dev/null
+++ b/debugging_demo/memtest86+/efi/Include/Protocol/HiiImage.h
@@ -0,0 +1,353 @@
+/** @file

+  The file provides services to access to images in the images database.

+

+  Copyright (c) 2006 - 2018, Intel Corporation. All rights reserved.<BR>

+  SPDX-License-Identifier: BSD-2-Clause-Patent

+

+  @par Revision Reference:

+  This Protocol was introduced in UEFI Specification 2.1.

+

+**/

+

+#ifndef __HII_IMAGE_H__

+#define __HII_IMAGE_H__

+

+#include <Protocol/GraphicsOutput.h>

+

+#define EFI_HII_IMAGE_PROTOCOL_GUID \

+  { 0x31a6406a, 0x6bdf, 0x4e46, { 0xb2, 0xa2, 0xeb, 0xaa, 0x89, 0xc4, 0x9, 0x20 } }

+

+typedef struct _EFI_HII_IMAGE_PROTOCOL EFI_HII_IMAGE_PROTOCOL;

+

+

+///

+/// Flags in EFI_IMAGE_INPUT

+///

+#define EFI_IMAGE_TRANSPARENT 0x00000001

+

+/**

+

+  Definition of EFI_IMAGE_INPUT.

+

+  @param Flags  Describe image characteristics. If

+                EFI_IMAGE_TRANSPARENT is set, then the image was

+                designed for transparent display.

+

+  @param Width  Image width, in pixels.

+

+  @param Height Image height, in pixels.

+

+  @param Bitmap A pointer to the actual bitmap, organized left-to-right,

+                top-to-bottom. The size of the bitmap is

+                Width*Height*sizeof(EFI_GRAPHICS_OUTPUT_BLT_PIXEL).

+

+

+**/

+typedef struct _EFI_IMAGE_INPUT {

+  UINT32                          Flags;

+  UINT16                          Width;

+  UINT16                          Height;

+  EFI_GRAPHICS_OUTPUT_BLT_PIXEL   *Bitmap;

+} EFI_IMAGE_INPUT;

+

+

+/**

+

+  This function adds the image Image to the group of images

+  owned by PackageList, and returns a new image identifier

+  (ImageId).

+

+  @param This        A pointer to the EFI_HII_IMAGE_PROTOCOL instance.

+

+  @param PackageList Handle of the package list where this image will be added.

+

+  @param ImageId     On return, contains the new image id, which is

+                     unique within PackageList.

+

+  @param Image       Points to the image.

+

+  @retval EFI_SUCCESS             The new image was added

+                                  successfully

+

+  @retval EFI_OUT_OF_RESOURCES    Could not add the image.

+

+  @retval EFI_INVALID_PARAMETER   Image is NULL or ImageId is

+                                  NULL.

+

+

+**/

+typedef

+EFI_STATUS

+(EFIAPI *EFI_HII_NEW_IMAGE)(

+  IN CONST  EFI_HII_IMAGE_PROTOCOL  *This,

+  IN        EFI_HII_HANDLE          PackageList,

+  OUT       EFI_IMAGE_ID            *ImageId,

+  IN CONST  EFI_IMAGE_INPUT         *Image

+);

+

+/**

+

+  This function retrieves the image specified by ImageId which

+  is associated with the specified PackageList and copies it

+  into the buffer specified by Image. If the image specified by

+  ImageId is not present in the specified PackageList, then

+  EFI_NOT_FOUND is returned. If the buffer specified by

+  ImageSize is too small to hold the image, then

+  EFI_BUFFER_TOO_SMALL will be returned. ImageSize will be

+  updated to the size of buffer actually required to hold the

+  image.

+

+  @param This         A pointer to the EFI_HII_IMAGE_PROTOCOL instance.

+

+  @param PackageList  The package list in the HII database to

+                      search for the specified image.

+

+  @param ImageId      The image's id, which is unique within

+                      PackageList.

+

+  @param Image        Points to the new image.

+

+  @retval EFI_SUCCESS            The image was returned successfully.

+

+  @retval EFI_NOT_FOUND          The image specified by ImageId is not

+                                 available. Or The specified PackageList is not in the database.

+

+  @retval EFI_INVALID_PARAMETER  The Image or Langugae was NULL.

+  @retval EFI_OUT_OF_RESOURCES   The bitmap could not be retrieved because there was not

+                                 enough memory.

+

+

+**/

+typedef

+EFI_STATUS

+(EFIAPI *EFI_HII_GET_IMAGE)(

+  IN CONST  EFI_HII_IMAGE_PROTOCOL  *This,

+  IN        EFI_HII_HANDLE          PackageList,

+  IN        EFI_IMAGE_ID            ImageId,

+  OUT       EFI_IMAGE_INPUT         *Image

+);

+

+/**

+

+  This function updates the image specified by ImageId in the

+  specified PackageListHandle to the image specified by Image.

+

+

+  @param This         A pointer to the EFI_HII_IMAGE_PROTOCOL instance.

+

+  @param PackageList  The package list containing the images.

+

+  @param ImageId      The image id, which is unique within PackageList.

+

+  @param Image        Points to the image.

+

+  @retval EFI_SUCCESS           The image was successfully updated.

+

+  @retval EFI_NOT_FOUND         The image specified by ImageId is not in the database.

+                                The specified PackageList is not in the database.

+

+  @retval EFI_INVALID_PARAMETER The Image or Language was NULL.

+

+**/

+typedef

+EFI_STATUS

+(EFIAPI *EFI_HII_SET_IMAGE)(

+  IN CONST  EFI_HII_IMAGE_PROTOCOL  *This,

+  IN        EFI_HII_HANDLE          PackageList,

+  IN        EFI_IMAGE_ID            ImageId,

+  IN CONST  EFI_IMAGE_INPUT         *Image

+);

+

+

+///

+/// EFI_HII_DRAW_FLAGS describes how the image is to be drawn.

+/// These flags are defined as EFI_HII_DRAW_FLAG_***

+///

+typedef UINT32  EFI_HII_DRAW_FLAGS;

+

+#define EFI_HII_DRAW_FLAG_CLIP          0x00000001

+#define EFI_HII_DRAW_FLAG_TRANSPARENT   0x00000030

+#define EFI_HII_DRAW_FLAG_DEFAULT       0x00000000

+#define EFI_HII_DRAW_FLAG_FORCE_TRANS   0x00000010

+#define EFI_HII_DRAW_FLAG_FORCE_OPAQUE  0x00000020

+#define EFI_HII_DIRECT_TO_SCREEN        0x00000080

+

+/**

+

+  Definition of EFI_IMAGE_OUTPUT.

+

+  @param Width  Width of the output image.

+

+  @param Height Height of the output image.

+

+  @param Bitmap Points to the output bitmap.

+

+  @param Screen Points to the EFI_GRAPHICS_OUTPUT_PROTOCOL which

+                describes the screen on which to draw the

+                specified image.

+

+**/

+typedef struct _EFI_IMAGE_OUTPUT {

+  UINT16  Width;

+  UINT16  Height;

+  union {

+    EFI_GRAPHICS_OUTPUT_BLT_PIXEL *Bitmap;

+    EFI_GRAPHICS_OUTPUT_PROTOCOL  *Screen;

+  } Image;

+} EFI_IMAGE_OUTPUT;

+

+

+/**

+

+  This function renders an image to a bitmap or the screen using

+  the specified color and options. It draws the image on an

+  existing bitmap, allocates a new bitmap or uses the screen. The

+  images can be clipped. If EFI_HII_DRAW_FLAG_CLIP is set, then

+  all pixels drawn outside the bounding box specified by Width and

+  Height are ignored. If EFI_HII_DRAW_FLAG_TRANSPARENT is set,

+  then all 'off' pixels in the images drawn will use the

+  pixel value from Blt. This flag cannot be used if Blt is NULL

+  upon entry. If EFI_HII_DIRECT_TO_SCREEN is set, then the image

+  will be written directly to the output device specified by

+  Screen. Otherwise the image will be rendered to the bitmap

+  specified by Bitmap.

+

+

+  @param This       A pointer to the EFI_HII_IMAGE_PROTOCOL instance.

+

+  @param Flags      Describes how the image is to be drawn.

+                    EFI_HII_DRAW_FLAGS is defined in Related

+                    Definitions, below.

+

+  @param Image      Points to the image to be displayed.

+

+  @param Blt        If this points to a non-NULL on entry, this points

+                    to the image, which is Width pixels wide and

+                    Height pixels high. The image will be drawn onto

+                    this image and EFI_HII_DRAW_FLAG_CLIP is implied.

+                    If this points to a NULL on entry, then a buffer

+                    will be allocated to hold the generated image and

+                    the pointer updated on exit. It is the caller's

+                    responsibility to free this buffer.

+

+  @param BltX, BltY Specifies the offset from the left and top

+                    edge of the image of the first pixel in

+                    the image.

+

+  @retval EFI_SUCCESS           The image was successfully updated.

+

+  @retval EFI_OUT_OF_RESOURCES  Unable to allocate an output

+                                buffer for RowInfoArray or Blt.

+

+  @retval EFI_INVALID_PARAMETER The Image or Blt or Height or

+                                Width was NULL.

+

+

+**/

+typedef

+EFI_STATUS

+(EFIAPI *EFI_HII_DRAW_IMAGE)(

+  IN CONST  EFI_HII_IMAGE_PROTOCOL  *This,

+  IN        EFI_HII_DRAW_FLAGS      Flags,

+  IN CONST  EFI_IMAGE_INPUT         *Image,

+  IN OUT    EFI_IMAGE_OUTPUT        **Blt,

+  IN        UINTN                   BltX,

+  IN        UINTN                   BltY

+);

+

+/**

+

+  This function renders an image as a bitmap or to the screen and

+  can clip the image. The bitmap is either supplied by the caller

+  or else is allocated by the function. The images can be drawn

+  transparently or opaquely. If EFI_HII_DRAW_FLAG_CLIP is set,

+  then all pixels drawn outside the bounding box specified by

+  Width and Height are ignored. If EFI_HII_DRAW_FLAG_TRANSPARENT

+  is set, then all "off" pixels in the character's glyph will

+  use the pixel value from Blt. This flag cannot be used if Blt

+  is NULL upon entry. If EFI_HII_DIRECT_TO_SCREEN is set, then

+  the image will be written directly to the output device

+  specified by Screen. Otherwise the image will be rendered to

+  the bitmap specified by Bitmap.

+  This function renders an image to a bitmap or the screen using

+  the specified color and options. It draws the image on an

+  existing bitmap, allocates a new bitmap or uses the screen. The

+  images can be clipped. If EFI_HII_DRAW_FLAG_CLIP is set, then

+  all pixels drawn outside the bounding box specified by Width and

+  Height are ignored. The EFI_HII_DRAW_FLAG_TRANSPARENT flag

+  determines whether the image will be drawn transparent or

+  opaque. If EFI_HII_DRAW_FLAG_FORCE_TRANS is set, then the image

+  will be drawn so that all 'off' pixels in the image will

+  be drawn using the pixel value from Blt and all other pixels

+  will be copied. If EFI_HII_DRAW_FLAG_FORCE_OPAQUE is set, then

+  the image's pixels will be copied directly to the

+  destination. If EFI_HII_DRAW_FLAG_DEFAULT is set, then the image

+  will be drawn transparently or opaque, depending on the

+  image's transparency setting (see EFI_IMAGE_TRANSPARENT).

+  Images cannot be drawn transparently if Blt is NULL. If

+  EFI_HII_DIRECT_TO_SCREEN is set, then the image will be written

+  directly to the output device specified by Screen. Otherwise the

+  image will be rendered to the bitmap specified by Bitmap.

+

+  @param This         A pointer to the EFI_HII_IMAGE_PROTOCOL instance.

+

+  @param Flags        Describes how the image is to be drawn.

+

+  @param PackageList  The package list in the HII database to

+                      search for the specified image.

+

+  @param ImageId      The image's id, which is unique within PackageList.

+

+  @param Blt          If this points to a non-NULL on entry, this points

+                      to the image, which is Width pixels wide and

+                      Height pixels high. The image will be drawn onto

+                      this image and EFI_HII_DRAW_FLAG_CLIP is implied.

+                      If this points to a NULL on entry, then a buffer

+                      will be allocated to hold the generated image and

+                      the pointer updated on exit. It is the caller's

+                      responsibility to free this buffer.

+

+  @param BltX, BltY   Specifies the offset from the left and top

+                      edge of the output image of the first

+                      pixel in the image.

+

+  @retval EFI_SUCCESS           The image was successfully updated.

+

+  @retval EFI_OUT_OF_RESOURCES  Unable to allocate an output

+                                buffer for RowInfoArray or Blt.

+

+  @retval EFI_NOT_FOUND         The image specified by ImageId is not in the database.

+                                Or The specified PackageList is not in the database.

+

+  @retval EFI_INVALID_PARAMETER The Blt was NULL.

+

+**/

+typedef

+EFI_STATUS

+(EFIAPI *EFI_HII_DRAW_IMAGE_ID)(

+IN CONST  EFI_HII_IMAGE_PROTOCOL  *This,

+IN        EFI_HII_DRAW_FLAGS      Flags,

+IN        EFI_HII_HANDLE          PackageList,

+IN        EFI_IMAGE_ID            ImageId,

+IN OUT    EFI_IMAGE_OUTPUT        **Blt,

+IN        UINTN                   BltX,

+IN        UINTN                   BltY

+);

+

+

+///

+/// Services to access to images in the images database.

+///

+struct _EFI_HII_IMAGE_PROTOCOL {

+  EFI_HII_NEW_IMAGE     NewImage;

+  EFI_HII_GET_IMAGE     GetImage;

+  EFI_HII_SET_IMAGE     SetImage;

+  EFI_HII_DRAW_IMAGE    DrawImage;

+  EFI_HII_DRAW_IMAGE_ID DrawImageId;

+};

+

+extern EFI_GUID gEfiHiiImageProtocolGuid;

+

+#endif

+

+

diff --git a/debugging_demo/memtest86+/efi/Include/Protocol/LoadedImage.h b/debugging_demo/memtest86+/efi/Include/Protocol/LoadedImage.h
new file mode 100644
index 0000000..9195785
--- /dev/null
+++ b/debugging_demo/memtest86+/efi/Include/Protocol/LoadedImage.h
@@ -0,0 +1,79 @@
+/** @file

+  UEFI 2.0 Loaded image protocol definition.

+

+  Every EFI driver and application is passed an image handle when it is loaded.

+  This image handle will contain a Loaded Image Protocol.

+

+  Copyright (c) 2006 - 2018, Intel Corporation. All rights reserved.<BR>

+  SPDX-License-Identifier: BSD-2-Clause-Patent

+

+**/

+

+#include "Efi_Defs_GUID.h"

+

+#ifndef __LOADED_IMAGE_PROTOCOL_H__

+#define __LOADED_IMAGE_PROTOCOL_H__

+

+#define EFI_LOADED_IMAGE_DEVICE_PATH_PROTOCOL_GUID \

+  { \

+    0xbc62157e, 0x3e33, 0x4fec, {0x99, 0x20, 0x2d, 0x3b, 0x36, 0xd7, 0x50, 0xdf } \

+  }

+

+///

+/// Protocol GUID defined in EFI1.1.

+///

+#define LOADED_IMAGE_PROTOCOL   EFI_LOADED_IMAGE_PROTOCOL_GUID

+

+///

+/// EFI_SYSTEM_TABLE & EFI_IMAGE_UNLOAD are defined in EfiApi.h

+///

+#define EFI_LOADED_IMAGE_PROTOCOL_REVISION  0x1000

+

+///

+/// Revision defined in EFI1.1.

+///

+#define EFI_LOADED_IMAGE_INFORMATION_REVISION    EFI_LOADED_IMAGE_PROTOCOL_REVISION

+

+///

+/// Can be used on any image handle to obtain information about the loaded image.

+///

+typedef struct {

+  UINT32            Revision;       ///< Defines the revision of the EFI_LOADED_IMAGE_PROTOCOL structure.

+                                    ///< All future revisions will be backward compatible to the current revision.

+  EFI_HANDLE        ParentHandle;   ///< Parent image's image handle. NULL if the image is loaded directly from

+                                    ///< the firmware's boot manager.

+  EFI_SYSTEM_TABLE  *SystemTable;   ///< the image's EFI system table pointer.

+

+  //

+  // Source location of image

+  //

+  EFI_HANDLE        DeviceHandle;   ///< The device handle that the EFI Image was loaded from.

+  EFI_DEVICE_PATH_PROTOCOL  *FilePath;  ///< A pointer to the file path portion specific to DeviceHandle

+                                        ///< that the EFI Image was loaded from.

+  VOID              *Reserved;      ///< Reserved. DO NOT USE.

+

+  //

+  // Images load options

+  //

+  UINT32            LoadOptionsSize;///< The size in bytes of LoadOptions.

+  VOID              *LoadOptions;   ///< A pointer to the image's binary load options.

+

+  //

+  // Location of where image was loaded

+  //

+  VOID              *ImageBase;     ///< The base address at which the image was loaded.

+  UINT64            ImageSize;      ///< The size in bytes of the loaded image.

+  EFI_MEMORY_TYPE   ImageCodeType;  ///< The memory type that the code sections were loaded as.

+  EFI_MEMORY_TYPE   ImageDataType;  ///< The memory type that the data sections were loaded as.

+  EFI_IMAGE_UNLOAD  Unload;

+} EFI_LOADED_IMAGE_PROTOCOL;

+

+//

+// For backward-compatible with EFI1.1.

+//

+typedef EFI_LOADED_IMAGE_PROTOCOL EFI_LOADED_IMAGE;

+

+extern EFI_GUID gEfiLoadedImageProtocolGuid;

+extern EFI_GUID gEfiLoadedImageDevicePathProtocolGuid;

+

+#endif

diff --git a/debugging_demo/memtest86+/efi/Include/Protocol/SimpleFileSystem.h b/debugging_demo/memtest86+/efi/Include/Protocol/SimpleFileSystem.h
new file mode 100644
index 0000000..73aa92e
--- /dev/null
+++ b/debugging_demo/memtest86+/efi/Include/Protocol/SimpleFileSystem.h
@@ -0,0 +1,551 @@
+/** @file

+  SimpleFileSystem protocol as defined in the UEFI 2.0 specification.

+

+  The SimpleFileSystem protocol is the programmatic access to the FAT (12,16,32)

+  file system specified in UEFI 2.0. It can also be used to abstract a file

+  system other than FAT.

+

+  UEFI 2.0 can boot from any valid EFI image contained in a SimpleFileSystem.

+

+Copyright (c) 2006 - 2018, Intel Corporation. All rights reserved.<BR>

+SPDX-License-Identifier: BSD-2-Clause-Patent

+

+**/

+

+#ifndef __SIMPLE_FILE_SYSTEM_H__

+#define __SIMPLE_FILE_SYSTEM_H__

+

+typedef struct _EFI_SIMPLE_FILE_SYSTEM_PROTOCOL  EFI_SIMPLE_FILE_SYSTEM_PROTOCOL;

+

+typedef struct _EFI_FILE_PROTOCOL         EFI_FILE_PROTOCOL;

+typedef struct _EFI_FILE_PROTOCOL         *EFI_FILE_HANDLE;

+

+///

+/// Protocol GUID name defined in EFI1.1.

+///

+#define SIMPLE_FILE_SYSTEM_PROTOCOL       EFI_SIMPLE_FILE_SYSTEM_PROTOCOL_GUID

+

+///

+/// Protocol name defined in EFI1.1.

+///

+typedef EFI_SIMPLE_FILE_SYSTEM_PROTOCOL   EFI_FILE_IO_INTERFACE;

+typedef EFI_FILE_PROTOCOL                 EFI_FILE;

+

+/**

+  Open the root directory on a volume.

+

+  @param  This A pointer to the volume to open the root directory.

+  @param  Root A pointer to the location to return the opened file handle for the

+               root directory.

+

+  @retval EFI_SUCCESS          The device was opened.

+  @retval EFI_UNSUPPORTED      This volume does not support the requested file system type.

+  @retval EFI_NO_MEDIA         The device has no medium.

+  @retval EFI_DEVICE_ERROR     The device reported an error.

+  @retval EFI_VOLUME_CORRUPTED The file system structures are corrupted.

+  @retval EFI_ACCESS_DENIED    The service denied access to the file.

+  @retval EFI_OUT_OF_RESOURCES The volume was not opened due to lack of resources.

+  @retval EFI_MEDIA_CHANGED    The device has a different medium in it or the medium is no

+                               longer supported. Any existing file handles for this volume are

+                               no longer valid. To access the files on the new medium, the

+                               volume must be reopened with OpenVolume().

+

+**/

+typedef

+EFI_STATUS

+(EFIAPI *EFI_SIMPLE_FILE_SYSTEM_PROTOCOL_OPEN_VOLUME)(

+  IN EFI_SIMPLE_FILE_SYSTEM_PROTOCOL    *This,

+  OUT EFI_FILE_PROTOCOL                 **Root

+  );

+

+#define EFI_SIMPLE_FILE_SYSTEM_PROTOCOL_REVISION  0x00010000

+

+///

+/// Revision defined in EFI1.1

+///

+#define EFI_FILE_IO_INTERFACE_REVISION  EFI_SIMPLE_FILE_SYSTEM_PROTOCOL_REVISION

+

+struct _EFI_SIMPLE_FILE_SYSTEM_PROTOCOL {

+  ///

+  /// The version of the EFI_SIMPLE_FILE_SYSTEM_PROTOCOL. The version

+  /// specified by this specification is 0x00010000. All future revisions

+  /// must be backwards compatible.

+  ///

+  UINT64                                      Revision;

+  EFI_SIMPLE_FILE_SYSTEM_PROTOCOL_OPEN_VOLUME OpenVolume;

+};

+

+/**

+  Opens a new file relative to the source file's location.

+

+  @param  This       A pointer to the EFI_FILE_PROTOCOL instance that is the file

+                     handle to the source location. This would typically be an open

+                     handle to a directory.

+  @param  NewHandle  A pointer to the location to return the opened handle for the new

+                     file.

+  @param  FileName   The Null-terminated string of the name of the file to be opened.

+                     The file name may contain the following path modifiers: "\", ".",

+                     and "..".

+  @param  OpenMode   The mode to open the file. The only valid combinations that the

+                     file may be opened with are: Read, Read/Write, or Create/Read/Write.

+  @param  Attributes Only valid for EFI_FILE_MODE_CREATE, in which case these are the

+                     attribute bits for the newly created file.

+

+  @retval EFI_SUCCESS          The file was opened.

+  @retval EFI_NOT_FOUND        The specified file could not be found on the device.

+  @retval EFI_NO_MEDIA         The device has no medium.

+  @retval EFI_MEDIA_CHANGED    The device has a different medium in it or the medium is no

+                               longer supported.

+  @retval EFI_DEVICE_ERROR     The device reported an error.

+  @retval EFI_VOLUME_CORRUPTED The file system structures are corrupted.

+  @retval EFI_WRITE_PROTECTED  An attempt was made to create a file, or open a file for write

+                               when the media is write-protected.

+  @retval EFI_ACCESS_DENIED    The service denied access to the file.

+  @retval EFI_OUT_OF_RESOURCES Not enough resources were available to open the file.

+  @retval EFI_VOLUME_FULL      The volume is full.

+

+**/

+typedef

+EFI_STATUS

+(EFIAPI *EFI_FILE_OPEN)(

+  IN EFI_FILE_PROTOCOL        *This,

+  OUT EFI_FILE_PROTOCOL       **NewHandle,

+  IN CHAR16                   *FileName,

+  IN UINT64                   OpenMode,

+  IN UINT64                   Attributes

+  );

+

+//

+// Open modes

+//

+#define EFI_FILE_MODE_READ    0x0000000000000001ULL

+#define EFI_FILE_MODE_WRITE   0x0000000000000002ULL

+#define EFI_FILE_MODE_CREATE  0x8000000000000000ULL

+

+//

+// File attributes

+//

+#define EFI_FILE_READ_ONLY  0x0000000000000001ULL

+#define EFI_FILE_HIDDEN     0x0000000000000002ULL

+#define EFI_FILE_SYSTEM     0x0000000000000004ULL

+#define EFI_FILE_RESERVED   0x0000000000000008ULL

+#define EFI_FILE_DIRECTORY  0x0000000000000010ULL

+#define EFI_FILE_ARCHIVE    0x0000000000000020ULL

+#define EFI_FILE_VALID_ATTR 0x0000000000000037ULL

+

+/**

+  Closes a specified file handle.

+

+  @param  This          A pointer to the EFI_FILE_PROTOCOL instance that is the file

+                        handle to close.

+

+  @retval EFI_SUCCESS   The file was closed.

+

+**/

+typedef

+EFI_STATUS

+(EFIAPI *EFI_FILE_CLOSE)(

+  IN EFI_FILE_PROTOCOL  *This

+  );

+

+/**

+  Close and delete the file handle.

+

+  @param  This                     A pointer to the EFI_FILE_PROTOCOL instance that is the

+                                   handle to the file to delete.

+

+  @retval EFI_SUCCESS              The file was closed and deleted, and the handle was closed.

+  @retval EFI_WARN_DELETE_FAILURE  The handle was closed, but the file was not deleted.

+

+**/

+typedef

+EFI_STATUS

+(EFIAPI *EFI_FILE_DELETE)(

+  IN EFI_FILE_PROTOCOL  *This

+  );

+

+/**

+  Reads data from a file.

+

+  @param  This       A pointer to the EFI_FILE_PROTOCOL instance that is the file

+                     handle to read data from.

+  @param  BufferSize On input, the size of the Buffer. On output, the amount of data

+                     returned in Buffer. In both cases, the size is measured in bytes.

+  @param  Buffer     The buffer into which the data is read.

+

+  @retval EFI_SUCCESS          Data was read.

+  @retval EFI_NO_MEDIA         The device has no medium.

+  @retval EFI_DEVICE_ERROR     The device reported an error.

+  @retval EFI_DEVICE_ERROR     An attempt was made to read from a deleted file.

+  @retval EFI_DEVICE_ERROR     On entry, the current file position is beyond the end of the file.

+  @retval EFI_VOLUME_CORRUPTED The file system structures are corrupted.

+  @retval EFI_BUFFER_TOO_SMALL The BufferSize is too small to read the current directory

+                               entry. BufferSize has been updated with the size

+                               needed to complete the request.

+

+**/

+typedef

+EFI_STATUS

+(EFIAPI *EFI_FILE_READ)(

+  IN EFI_FILE_PROTOCOL        *This,

+  IN OUT UINTN                *BufferSize,

+  OUT VOID                    *Buffer

+  );

+

+/**

+  Writes data to a file.

+

+  @param  This       A pointer to the EFI_FILE_PROTOCOL instance that is the file

+                     handle to write data to.

+  @param  BufferSize On input, the size of the Buffer. On output, the amount of data

+                     actually written. In both cases, the size is measured in bytes.

+  @param  Buffer     The buffer of data to write.

+

+  @retval EFI_SUCCESS          Data was written.

+  @retval EFI_UNSUPPORTED      Writes to open directory files are not supported.

+  @retval EFI_NO_MEDIA         The device has no medium.

+  @retval EFI_DEVICE_ERROR     The device reported an error.

+  @retval EFI_DEVICE_ERROR     An attempt was made to write to a deleted file.

+  @retval EFI_VOLUME_CORRUPTED The file system structures are corrupted.

+  @retval EFI_WRITE_PROTECTED  The file or medium is write-protected.

+  @retval EFI_ACCESS_DENIED    The file was opened read only.

+  @retval EFI_VOLUME_FULL      The volume is full.

+

+**/

+typedef

+EFI_STATUS

+(EFIAPI *EFI_FILE_WRITE)(

+  IN EFI_FILE_PROTOCOL        *This,

+  IN OUT UINTN                *BufferSize,

+  IN VOID                     *Buffer

+  );

+

+/**

+  Sets a file's current position.

+

+  @param  This            A pointer to the EFI_FILE_PROTOCOL instance that is the

+                          file handle to set the requested position on.

+  @param  Position        The byte position from the start of the file to set.

+

+  @retval EFI_SUCCESS      The position was set.

+  @retval EFI_UNSUPPORTED  The seek request for nonzero is not valid on open

+                           directories.

+  @retval EFI_DEVICE_ERROR An attempt was made to set the position of a deleted file.

+

+**/

+typedef

+EFI_STATUS

+(EFIAPI *EFI_FILE_SET_POSITION)(

+  IN EFI_FILE_PROTOCOL        *This,

+  IN UINT64                   Position

+  );

+

+/**

+  Returns a file's current position.

+

+  @param  This            A pointer to the EFI_FILE_PROTOCOL instance that is the file

+                          handle to get the current position on.

+  @param  Position        The address to return the file's current position value.

+

+  @retval EFI_SUCCESS      The position was returned.

+  @retval EFI_UNSUPPORTED  The request is not valid on open directories.

+  @retval EFI_DEVICE_ERROR An attempt was made to get the position from a deleted file.

+

+**/

+typedef

+EFI_STATUS

+(EFIAPI *EFI_FILE_GET_POSITION)(

+  IN EFI_FILE_PROTOCOL        *This,

+  OUT UINT64                  *Position

+  );

+

+/**

+  Returns information about a file.

+

+  @param  This            A pointer to the EFI_FILE_PROTOCOL instance that is the file

+                          handle the requested information is for.

+  @param  InformationType The type identifier for the information being requested.

+  @param  BufferSize      On input, the size of Buffer. On output, the amount of data

+                          returned in Buffer. In both cases, the size is measured in bytes.

+  @param  Buffer          A pointer to the data buffer to return. The buffer's type is

+                          indicated by InformationType.

+

+  @retval EFI_SUCCESS          The information was returned.

+  @retval EFI_UNSUPPORTED      The InformationType is not known.

+  @retval EFI_NO_MEDIA         The device has no medium.

+  @retval EFI_DEVICE_ERROR     The device reported an error.

+  @retval EFI_VOLUME_CORRUPTED The file system structures are corrupted.

+  @retval EFI_BUFFER_TOO_SMALL The BufferSize is too small to read the current directory entry.

+                               BufferSize has been updated with the size needed to complete

+                               the request.

+**/

+typedef

+EFI_STATUS

+(EFIAPI *EFI_FILE_GET_INFO)(

+  IN EFI_FILE_PROTOCOL        *This,

+  IN EFI_GUID                 *InformationType,

+  IN OUT UINTN                *BufferSize,

+  OUT VOID                    *Buffer

+  );

+

+/**

+  Sets information about a file.

+

+  @param  File            A pointer to the EFI_FILE_PROTOCOL instance that is the file

+                          handle the information is for.

+  @param  InformationType The type identifier for the information being set.

+  @param  BufferSize      The size, in bytes, of Buffer.

+  @param  Buffer          A pointer to the data buffer to write. The buffer's type is

+                          indicated by InformationType.

+

+  @retval EFI_SUCCESS          The information was set.

+  @retval EFI_UNSUPPORTED      The InformationType is not known.

+  @retval EFI_NO_MEDIA         The device has no medium.

+  @retval EFI_DEVICE_ERROR     The device reported an error.

+  @retval EFI_VOLUME_CORRUPTED The file system structures are corrupted.

+  @retval EFI_WRITE_PROTECTED  InformationType is EFI_FILE_INFO_ID and the media is

+                               read-only.

+  @retval EFI_WRITE_PROTECTED  InformationType is EFI_FILE_PROTOCOL_SYSTEM_INFO_ID

+                               and the media is read only.

+  @retval EFI_WRITE_PROTECTED  InformationType is EFI_FILE_SYSTEM_VOLUME_LABEL_ID

+                               and the media is read-only.

+  @retval EFI_ACCESS_DENIED    An attempt is made to change the name of a file to a

+                               file that is already present.

+  @retval EFI_ACCESS_DENIED    An attempt is being made to change the EFI_FILE_DIRECTORY

+                               Attribute.

+  @retval EFI_ACCESS_DENIED    An attempt is being made to change the size of a directory.

+  @retval EFI_ACCESS_DENIED    InformationType is EFI_FILE_INFO_ID and the file was opened

+                               read-only and an attempt is being made to modify a field

+                               other than Attribute.

+  @retval EFI_VOLUME_FULL      The volume is full.

+  @retval EFI_BAD_BUFFER_SIZE  BufferSize is smaller than the size of the type indicated

+                               by InformationType.

+

+**/

+typedef

+EFI_STATUS

+(EFIAPI *EFI_FILE_SET_INFO)(

+  IN EFI_FILE_PROTOCOL        *This,

+  IN EFI_GUID                 *InformationType,

+  IN UINTN                    BufferSize,

+  IN VOID                     *Buffer

+  );

+

+/**

+  Flushes all modified data associated with a file to a device.

+

+  @param  This A pointer to the EFI_FILE_PROTOCOL instance that is the file

+               handle to flush.

+

+  @retval EFI_SUCCESS          The data was flushed.

+  @retval EFI_NO_MEDIA         The device has no medium.

+  @retval EFI_DEVICE_ERROR     The device reported an error.

+  @retval EFI_VOLUME_CORRUPTED The file system structures are corrupted.

+  @retval EFI_WRITE_PROTECTED  The file or medium is write-protected.

+  @retval EFI_ACCESS_DENIED    The file was opened read-only.

+  @retval EFI_VOLUME_FULL      The volume is full.

+

+**/

+typedef

+EFI_STATUS

+(EFIAPI *EFI_FILE_FLUSH)(

+  IN EFI_FILE_PROTOCOL  *This

+  );

+

+typedef struct {

+  //

+  // If Event is NULL, then blocking I/O is performed.

+  // If Event is not NULL and non-blocking I/O is supported, then non-blocking I/O is performed,

+  // and Event will be signaled when the read request is completed.

+  // The caller must be prepared to handle the case where the callback associated with Event

+  // occurs before the original asynchronous I/O request call returns.

+  //

+  EFI_EVENT                   Event;

+

+  //

+  // Defines whether or not the signaled event encountered an error.

+  //

+  EFI_STATUS                  Status;

+

+  //

+  // For OpenEx():  Not Used, ignored.

+  // For ReadEx():  On input, the size of the Buffer. On output, the amount of data returned in Buffer.

+  //                In both cases, the size is measured in bytes.

+  // For WriteEx(): On input, the size of the Buffer. On output, the amount of data actually written.

+  //                In both cases, the size is measured in bytes.

+  // For FlushEx(): Not used, ignored.

+  //

+  UINTN                       BufferSize;

+

+  //

+  // For OpenEx():  Not Used, ignored.

+  // For ReadEx():  The buffer into which the data is read.

+  // For WriteEx(): The buffer of data to write.

+  // For FlushEx(): Not Used, ignored.

+  //

+  VOID                        *Buffer;

+} EFI_FILE_IO_TOKEN;

+

+/**

+  Opens a new file relative to the source directory's location.

+

+  @param  This       A pointer to the EFI_FILE_PROTOCOL instance that is the file

+                     handle to the source location.

+  @param  NewHandle  A pointer to the location to return the opened handle for the new

+                     file.

+  @param  FileName   The Null-terminated string of the name of the file to be opened.

+                     The file name may contain the following path modifiers: "\", ".",

+                     and "..".

+  @param  OpenMode   The mode to open the file. The only valid combinations that the

+                     file may be opened with are: Read, Read/Write, or Create/Read/Write.

+  @param  Attributes Only valid for EFI_FILE_MODE_CREATE, in which case these are the

+                     attribute bits for the newly created file.

+  @param  Token      A pointer to the token associated with the transaction.

+

+  @retval EFI_SUCCESS          If Event is NULL (blocking I/O): The data was read successfully.

+                               If Event is not NULL (asynchronous I/O): The request was successfully

+                                                                        queued for processing.

+  @retval EFI_NOT_FOUND        The specified file could not be found on the device.

+  @retval EFI_NO_MEDIA         The device has no medium.

+  @retval EFI_MEDIA_CHANGED    The device has a different medium in it or the medium is no

+                               longer supported.

+  @retval EFI_DEVICE_ERROR     The device reported an error.

+  @retval EFI_VOLUME_CORRUPTED The file system structures are corrupted.

+  @retval EFI_WRITE_PROTECTED  An attempt was made to create a file, or open a file for write

+                               when the media is write-protected.

+  @retval EFI_ACCESS_DENIED    The service denied access to the file.

+  @retval EFI_OUT_OF_RESOURCES Not enough resources were available to open the file.

+  @retval EFI_VOLUME_FULL      The volume is full.

+

+**/

+typedef

+EFI_STATUS

+(EFIAPI *EFI_FILE_OPEN_EX)(

+  IN EFI_FILE_PROTOCOL        *This,

+  OUT EFI_FILE_PROTOCOL       **NewHandle,

+  IN CHAR16                   *FileName,

+  IN UINT64                   OpenMode,

+  IN UINT64                   Attributes,

+  IN OUT EFI_FILE_IO_TOKEN    *Token

+  );

+

+

+/**

+  Reads data from a file.

+

+  @param  This       A pointer to the EFI_FILE_PROTOCOL instance that is the file handle to read data from.

+  @param  Token      A pointer to the token associated with the transaction.

+

+  @retval EFI_SUCCESS          If Event is NULL (blocking I/O): The data was read successfully.

+                               If Event is not NULL (asynchronous I/O): The request was successfully

+                                                                        queued for processing.

+  @retval EFI_NO_MEDIA         The device has no medium.

+  @retval EFI_DEVICE_ERROR     The device reported an error.

+  @retval EFI_DEVICE_ERROR     An attempt was made to read from a deleted file.

+  @retval EFI_DEVICE_ERROR     On entry, the current file position is beyond the end of the file.

+  @retval EFI_VOLUME_CORRUPTED The file system structures are corrupted.

+  @retval EFI_OUT_OF_RESOURCES Unable to queue the request due to lack of resources.

+**/

+typedef

+EFI_STATUS

+(EFIAPI *EFI_FILE_READ_EX) (

+  IN EFI_FILE_PROTOCOL        *This,

+  IN OUT EFI_FILE_IO_TOKEN    *Token

+);

+

+

+/**

+  Writes data to a file.

+

+  @param  This       A pointer to the EFI_FILE_PROTOCOL instance that is the file handle to write data to.

+  @param  Token      A pointer to the token associated with the transaction.

+

+  @retval EFI_SUCCESS          If Event is NULL (blocking I/O): The data was read successfully.

+                               If Event is not NULL (asynchronous I/O): The request was successfully

+                                                                        queued for processing.

+  @retval EFI_UNSUPPORTED      Writes to open directory files are not supported.

+  @retval EFI_NO_MEDIA         The device has no medium.

+  @retval EFI_DEVICE_ERROR     The device reported an error.

+  @retval EFI_DEVICE_ERROR     An attempt was made to write to a deleted file.

+  @retval EFI_VOLUME_CORRUPTED The file system structures are corrupted.

+  @retval EFI_WRITE_PROTECTED  The file or medium is write-protected.

+  @retval EFI_ACCESS_DENIED    The file was opened read only.

+  @retval EFI_VOLUME_FULL      The volume is full.

+  @retval EFI_OUT_OF_RESOURCES Unable to queue the request due to lack of resources.

+**/

+typedef

+EFI_STATUS

+(EFIAPI *EFI_FILE_WRITE_EX) (

+  IN EFI_FILE_PROTOCOL        *This,

+  IN OUT EFI_FILE_IO_TOKEN    *Token

+);

+

+/**

+  Flushes all modified data associated with a file to a device.

+

+  @param  This  A pointer to the EFI_FILE_PROTOCOL instance that is the file

+                handle to flush.

+  @param  Token A pointer to the token associated with the transaction.

+

+  @retval EFI_SUCCESS          If Event is NULL (blocking I/O): The data was read successfully.

+                               If Event is not NULL (asynchronous I/O): The request was successfully

+                                                                        queued for processing.

+  @retval EFI_NO_MEDIA         The device has no medium.

+  @retval EFI_DEVICE_ERROR     The device reported an error.

+  @retval EFI_VOLUME_CORRUPTED The file system structures are corrupted.

+  @retval EFI_WRITE_PROTECTED  The file or medium is write-protected.

+  @retval EFI_ACCESS_DENIED    The file was opened read-only.

+  @retval EFI_VOLUME_FULL      The volume is full.

+  @retval EFI_OUT_OF_RESOURCES Unable to queue the request due to lack of resources.

+

+**/

+typedef

+EFI_STATUS

+(EFIAPI *EFI_FILE_FLUSH_EX) (

+  IN EFI_FILE_PROTOCOL        *This,

+  IN OUT EFI_FILE_IO_TOKEN    *Token

+  );

+

+#define EFI_FILE_PROTOCOL_REVISION        0x00010000

+#define EFI_FILE_PROTOCOL_REVISION2       0x00020000

+#define EFI_FILE_PROTOCOL_LATEST_REVISION EFI_FILE_PROTOCOL_REVISION2

+

+//

+// Revision defined in EFI1.1.

+//

+#define EFI_FILE_REVISION   EFI_FILE_PROTOCOL_REVISION

+

+///

+/// The EFI_FILE_PROTOCOL provides file IO access to supported file systems.

+/// An EFI_FILE_PROTOCOL provides access to a file's or directory's contents,

+/// and is also a reference to a location in the directory tree of the file system

+/// in which the file resides. With any given file handle, other files may be opened

+/// relative to this file's location, yielding new file handles.

+///

+struct _EFI_FILE_PROTOCOL {

+  ///

+  /// The version of the EFI_FILE_PROTOCOL interface. The version specified

+  /// by this specification is EFI_FILE_PROTOCOL_LATEST_REVISION.

+  /// Future versions are required to be backward compatible to version 1.0.

+  ///

+  UINT64                Revision;

+  EFI_FILE_OPEN         Open;

+  EFI_FILE_CLOSE        Close;

+  EFI_FILE_DELETE       Delete;

+  EFI_FILE_READ         Read;

+  EFI_FILE_WRITE        Write;

+  EFI_FILE_GET_POSITION GetPosition;

+  EFI_FILE_SET_POSITION SetPosition;

+  EFI_FILE_GET_INFO     GetInfo;

+  EFI_FILE_SET_INFO     SetInfo;

+  EFI_FILE_FLUSH        Flush;

+  EFI_FILE_OPEN_EX      OpenEx;

+  EFI_FILE_READ_EX      ReadEx;

+  EFI_FILE_WRITE_EX     WriteEx;

+  EFI_FILE_FLUSH_EX     FlushEx;

+};

+

+

+extern EFI_GUID gEfiSimpleFileSystemProtocolGuid;

+

+#endif

diff --git a/debugging_demo/memtest86+/efi/Include/Protocol/SimpleTextIn.h b/debugging_demo/memtest86+/efi/Include/Protocol/SimpleTextIn.h
new file mode 100644
index 0000000..e22e05e
--- /dev/null
+++ b/debugging_demo/memtest86+/efi/Include/Protocol/SimpleTextIn.h
@@ -0,0 +1,127 @@
+/** @file

+  Simple Text Input protocol from the UEFI 2.0 specification.

+

+  Abstraction of a very simple input device like a keyboard or serial

+  terminal.

+

+  Copyright (c) 2006 - 2011, Intel Corporation. All rights reserved.<BR>

+  SPDX-License-Identifier: BSD-2-Clause-Patent

+

+**/

+

+#ifndef __SIMPLE_TEXT_IN_PROTOCOL_H__

+#define __SIMPLE_TEXT_IN_PROTOCOL_H__

+

+#define EFI_SIMPLE_TEXT_INPUT_PROTOCOL_GUID \

+  { \

+    0x387477c1, 0x69c7, 0x11d2, {0x8e, 0x39, 0x0, 0xa0, 0xc9, 0x69, 0x72, 0x3b } \

+  }

+

+typedef struct _EFI_SIMPLE_TEXT_INPUT_PROTOCOL  EFI_SIMPLE_TEXT_INPUT_PROTOCOL;

+

+///

+/// Protocol GUID name defined in EFI1.1.

+///

+#define SIMPLE_INPUT_PROTOCOL   EFI_SIMPLE_TEXT_INPUT_PROTOCOL_GUID

+

+///

+/// Protocol name in EFI1.1 for backward-compatible.

+///

+typedef struct _EFI_SIMPLE_TEXT_INPUT_PROTOCOL  SIMPLE_INPUT_INTERFACE;

+

+///

+/// The keystroke information for the key that was pressed.

+///

+typedef struct {

+  UINT16  ScanCode;

+  CHAR16  UnicodeChar;

+} EFI_INPUT_KEY;

+

+//

+// Required unicode control chars

+//

+#define CHAR_BACKSPACE        0x0008

+#define CHAR_TAB              0x0009

+#define CHAR_LINEFEED         0x000A

+#define CHAR_CARRIAGE_RETURN  0x000D

+

+//

+// EFI Scan codes

+//

+#define SCAN_NULL       0x0000

+#define SCAN_UP         0x0001

+#define SCAN_DOWN       0x0002

+#define SCAN_RIGHT      0x0003

+#define SCAN_LEFT       0x0004

+#define SCAN_HOME       0x0005

+#define SCAN_END        0x0006

+#define SCAN_INSERT     0x0007

+#define SCAN_DELETE     0x0008

+#define SCAN_PAGE_UP    0x0009

+#define SCAN_PAGE_DOWN  0x000A

+#define SCAN_F1         0x000B

+#define SCAN_F2         0x000C

+#define SCAN_F3         0x000D

+#define SCAN_F4         0x000E

+#define SCAN_F5         0x000F

+#define SCAN_F6         0x0010

+#define SCAN_F7         0x0011

+#define SCAN_F8         0x0012

+#define SCAN_F9         0x0013

+#define SCAN_F10        0x0014

+#define SCAN_ESC        0x0017

+

+/**

+  Reset the input device and optionally run diagnostics

+

+  @param  This                 Protocol instance pointer.

+  @param  ExtendedVerification Driver may perform diagnostics on reset.

+

+  @retval EFI_SUCCESS          The device was reset.

+  @retval EFI_DEVICE_ERROR     The device is not functioning properly and could not be reset.

+

+**/

+typedef

+EFI_STATUS

+(EFIAPI *EFI_INPUT_RESET)(

+  IN EFI_SIMPLE_TEXT_INPUT_PROTOCOL       *This,

+  IN BOOLEAN                              ExtendedVerification

+  );

+

+/**

+  Reads the next keystroke from the input device. The WaitForKey Event can

+  be used to test for existence of a keystroke via WaitForEvent () call.

+

+  @param  This  Protocol instance pointer.

+  @param  Key   A pointer to a buffer that is filled in with the keystroke

+                information for the key that was pressed.

+

+  @retval EFI_SUCCESS      The keystroke information was returned.

+  @retval EFI_NOT_READY    There was no keystroke data available.

+  @retval EFI_DEVICE_ERROR The keystroke information was not returned due to

+                           hardware errors.

+

+**/

+typedef

+EFI_STATUS

+(EFIAPI *EFI_INPUT_READ_KEY)(

+  IN EFI_SIMPLE_TEXT_INPUT_PROTOCOL       *This,

+  OUT EFI_INPUT_KEY                       *Key

+  );

+

+///

+/// The EFI_SIMPLE_TEXT_INPUT_PROTOCOL is used on the ConsoleIn device.

+/// It is the minimum required protocol for ConsoleIn.

+///

+struct _EFI_SIMPLE_TEXT_INPUT_PROTOCOL {

+  EFI_INPUT_RESET     Reset;

+  EFI_INPUT_READ_KEY  ReadKeyStroke;

+  ///

+  /// Event to use with WaitForEvent() to wait for a key to be available

+  ///

+  EFI_EVENT           WaitForKey;

+};

+

+extern EFI_GUID gEfiSimpleTextInProtocolGuid;

+

+#endif

diff --git a/debugging_demo/memtest86+/efi/Include/Protocol/SimpleTextInEx.h b/debugging_demo/memtest86+/efi/Include/Protocol/SimpleTextInEx.h
new file mode 100644
index 0000000..2df583e
--- /dev/null
+++ b/debugging_demo/memtest86+/efi/Include/Protocol/SimpleTextInEx.h
@@ -0,0 +1,317 @@
+/** @file

+  Simple Text Input Ex protocol from the UEFI 2.0 specification.

+

+  This protocol defines an extension to the EFI_SIMPLE_TEXT_INPUT_PROTOCOL

+  which exposes much more state and modifier information from the input device,

+  also allows one to register a notification for a particular keystroke.

+

+  Copyright (c) 2006 - 2018, Intel Corporation. All rights reserved.<BR>

+  SPDX-License-Identifier: BSD-2-Clause-Patent

+

+**/

+

+#ifndef __SIMPLE_TEXT_IN_EX_H__

+#define __SIMPLE_TEXT_IN_EX_H__

+

+#include <Protocol/SimpleTextIn.h>

+

+#define EFI_SIMPLE_TEXT_INPUT_EX_PROTOCOL_GUID \

+  {0xdd9e7534, 0x7762, 0x4698, { 0x8c, 0x14, 0xf5, 0x85, 0x17, 0xa6, 0x25, 0xaa } }

+

+

+typedef struct _EFI_SIMPLE_TEXT_INPUT_EX_PROTOCOL EFI_SIMPLE_TEXT_INPUT_EX_PROTOCOL;

+

+/**

+  The Reset() function resets the input device hardware. As part

+  of initialization process, the firmware/device will make a quick

+  but reasonable attempt to verify that the device is functioning.

+  If the ExtendedVerification flag is TRUE the firmware may take

+  an extended amount of time to verify the device is operating on

+  reset. Otherwise the reset operation is to occur as quickly as

+  possible. The hardware verification process is not defined by

+  this specification and is left up to the platform firmware or

+  driver to implement.

+

+  @param This                 A pointer to the EFI_SIMPLE_TEXT_INPUT_EX_PROTOCOL instance.

+

+  @param ExtendedVerification Indicates that the driver may

+                              perform a more exhaustive

+                              verification operation of the

+                              device during reset.

+

+

+  @retval EFI_SUCCESS       The device was reset.

+

+  @retval EFI_DEVICE_ERROR  The device is not functioning

+                            correctly and could not be reset.

+

+**/

+typedef

+EFI_STATUS

+(EFIAPI *EFI_INPUT_RESET_EX)(

+  IN EFI_SIMPLE_TEXT_INPUT_EX_PROTOCOL *This,

+  IN BOOLEAN                           ExtendedVerification

+);

+

+

+///

+/// EFI_KEY_TOGGLE_STATE. The toggle states are defined.

+/// They are: EFI_TOGGLE_STATE_VALID, EFI_SCROLL_LOCK_ACTIVE

+/// EFI_NUM_LOCK_ACTIVE, EFI_CAPS_LOCK_ACTIVE

+///

+typedef UINT8 EFI_KEY_TOGGLE_STATE;

+

+typedef struct _EFI_KEY_STATE {

+  ///

+  /// Reflects the currently pressed shift

+  /// modifiers for the input device. The

+  /// returned value is valid only if the high

+  /// order bit has been set.

+  ///

+  UINT32                KeyShiftState;

+  ///

+  /// Reflects the current internal state of

+  /// various toggled attributes. The returned

+  /// value is valid only if the high order

+  /// bit has been set.

+  ///

+  EFI_KEY_TOGGLE_STATE  KeyToggleState;

+} EFI_KEY_STATE;

+

+typedef struct {

+  ///

+  /// The EFI scan code and Unicode value returned from the input device.

+  ///

+  EFI_INPUT_KEY   Key;

+  ///

+  /// The current state of various toggled attributes as well as input modifier values.

+  ///

+  EFI_KEY_STATE   KeyState;

+} EFI_KEY_DATA;

+

+//

+// Any Shift or Toggle State that is valid should have

+// high order bit set.

+//

+// Shift state

+//

+#define EFI_SHIFT_STATE_VALID     0x80000000

+#define EFI_RIGHT_SHIFT_PRESSED   0x00000001

+#define EFI_LEFT_SHIFT_PRESSED    0x00000002

+#define EFI_RIGHT_CONTROL_PRESSED 0x00000004

+#define EFI_LEFT_CONTROL_PRESSED  0x00000008

+#define EFI_RIGHT_ALT_PRESSED     0x00000010

+#define EFI_LEFT_ALT_PRESSED      0x00000020

+#define EFI_RIGHT_LOGO_PRESSED    0x00000040

+#define EFI_LEFT_LOGO_PRESSED     0x00000080

+#define EFI_MENU_KEY_PRESSED      0x00000100

+#define EFI_SYS_REQ_PRESSED       0x00000200

+

+//

+// Toggle state

+//

+#define EFI_TOGGLE_STATE_VALID    0x80

+#define EFI_KEY_STATE_EXPOSED     0x40

+#define EFI_SCROLL_LOCK_ACTIVE    0x01

+#define EFI_NUM_LOCK_ACTIVE       0x02

+#define EFI_CAPS_LOCK_ACTIVE      0x04

+

+//

+// EFI Scan codes

+//

+#define SCAN_F11                  0x0015

+#define SCAN_F12                  0x0016

+#define SCAN_PAUSE                0x0048

+#define SCAN_F13                  0x0068

+#define SCAN_F14                  0x0069

+#define SCAN_F15                  0x006A

+#define SCAN_F16                  0x006B

+#define SCAN_F17                  0x006C

+#define SCAN_F18                  0x006D

+#define SCAN_F19                  0x006E

+#define SCAN_F20                  0x006F

+#define SCAN_F21                  0x0070

+#define SCAN_F22                  0x0071

+#define SCAN_F23                  0x0072

+#define SCAN_F24                  0x0073

+#define SCAN_MUTE                 0x007F

+#define SCAN_VOLUME_UP            0x0080

+#define SCAN_VOLUME_DOWN          0x0081

+#define SCAN_BRIGHTNESS_UP        0x0100

+#define SCAN_BRIGHTNESS_DOWN      0x0101

+#define SCAN_SUSPEND              0x0102

+#define SCAN_HIBERNATE            0x0103

+#define SCAN_TOGGLE_DISPLAY       0x0104

+#define SCAN_RECOVERY             0x0105

+#define SCAN_EJECT                0x0106

+

+/**

+  The function reads the next keystroke from the input device. If

+  there is no pending keystroke the function returns

+  EFI_NOT_READY. If there is a pending keystroke, then

+  KeyData.Key.ScanCode is the EFI scan code defined in Error!

+  Reference source not found. The KeyData.Key.UnicodeChar is the

+  actual printable character or is zero if the key does not

+  represent a printable character (control key, function key,

+  etc.). The KeyData.KeyState is shift state for the character

+  reflected in KeyData.Key.UnicodeChar or KeyData.Key.ScanCode .

+  When interpreting the data from this function, it should be

+  noted that if a class of printable characters that are

+  normally adjusted by shift modifiers (e.g. Shift Key + "f"

+  key) would be presented solely as a KeyData.Key.UnicodeChar

+  without the associated shift state. So in the previous example

+  of a Shift Key + "f" key being pressed, the only pertinent

+  data returned would be KeyData.Key.UnicodeChar with the value

+  of "F". This of course would not typically be the case for

+  non-printable characters such as the pressing of the Right

+  Shift Key + F10 key since the corresponding returned data

+  would be reflected both in the KeyData.KeyState.KeyShiftState

+  and KeyData.Key.ScanCode values. UEFI drivers which implement

+  the EFI_SIMPLE_TEXT_INPUT_EX protocol are required to return

+  KeyData.Key and KeyData.KeyState values. These drivers must

+  always return the most current state of

+  KeyData.KeyState.KeyShiftState and

+  KeyData.KeyState.KeyToggleState. It should also be noted that

+  certain input devices may not be able to produce shift or toggle

+  state information, and in those cases the high order bit in the

+  respective Toggle and Shift state fields should not be active.

+

+

+  @param This     A pointer to the EFI_SIMPLE_TEXT_INPUT_EX_PROTOCOL instance.

+

+  @param KeyData  A pointer to a buffer that is filled in with

+                  the keystroke state data for the key that was

+                  pressed.

+

+

+  @retval EFI_SUCCESS      The keystroke information was returned.

+  @retval EFI_NOT_READY    There was no keystroke data available.

+  @retval EFI_DEVICE_ERROR The keystroke information was not returned due to

+                           hardware errors.

+

+

+**/

+typedef

+EFI_STATUS

+(EFIAPI *EFI_INPUT_READ_KEY_EX)(

+  IN  EFI_SIMPLE_TEXT_INPUT_EX_PROTOCOL *This,

+  OUT EFI_KEY_DATA                      *KeyData

+);

+

+/**

+  The SetState() function allows the input device hardware to

+  have state settings adjusted.

+

+  @param This           A pointer to the EFI_SIMPLE_TEXT_INPUT_EX_PROTOCOL instance.

+

+  @param KeyToggleState Pointer to the EFI_KEY_TOGGLE_STATE to

+                        set the state for the input device.

+

+

+  @retval EFI_SUCCESS       The device state was set appropriately.

+

+  @retval EFI_DEVICE_ERROR  The device is not functioning

+                            correctly and could not have the

+                            setting adjusted.

+

+  @retval EFI_UNSUPPORTED   The device does not support the

+                            ability to have its state set.

+

+**/

+typedef

+EFI_STATUS

+(EFIAPI *EFI_SET_STATE)(

+  IN EFI_SIMPLE_TEXT_INPUT_EX_PROTOCOL *This,

+  IN EFI_KEY_TOGGLE_STATE              *KeyToggleState

+);

+

+///

+/// The function will be called when the key sequence is typed specified by KeyData.

+///

+typedef

+EFI_STATUS

+(EFIAPI *EFI_KEY_NOTIFY_FUNCTION)(

+  IN EFI_KEY_DATA *KeyData

+);

+

+/**

+  The RegisterKeystrokeNotify() function registers a function

+  which will be called when a specified keystroke will occur.

+

+  @param This                     A pointer to the EFI_SIMPLE_TEXT_INPUT_EX_PROTOCOL instance.

+

+  @param KeyData                  A pointer to a buffer that is filled in with

+                                  the keystroke information for the key that was

+                                  pressed. If KeyData.Key, KeyData.KeyState.KeyToggleState

+                                  and KeyData.KeyState.KeyShiftState are 0, then any incomplete

+                                  keystroke will trigger a notification of the KeyNotificationFunction.

+

+  @param KeyNotificationFunction  Points to the function to be called when the key sequence

+                                  is typed specified by KeyData. This notification function

+                                  should be called at <=TPL_CALLBACK.

+

+

+  @param NotifyHandle             Points to the unique handle assigned to

+                                  the registered notification.

+

+  @retval EFI_SUCCESS           Key notify was registered successfully.

+

+  @retval EFI_OUT_OF_RESOURCES  Unable to allocate necessary

+                                data structures.

+

+**/

+typedef

+EFI_STATUS

+(EFIAPI *EFI_REGISTER_KEYSTROKE_NOTIFY)(

+  IN  EFI_SIMPLE_TEXT_INPUT_EX_PROTOCOL *This,

+  IN  EFI_KEY_DATA                      *KeyData,

+  IN  EFI_KEY_NOTIFY_FUNCTION           KeyNotificationFunction,

+  OUT VOID                              **NotifyHandle

+);

+

+/**

+  The UnregisterKeystrokeNotify() function removes the

+  notification which was previously registered.

+

+  @param This               A pointer to the EFI_SIMPLE_TEXT_INPUT_EX_PROTOCOL instance.

+

+  @param NotificationHandle The handle of the notification

+                            function being unregistered.

+

+  @retval EFI_SUCCESS           Key notify was unregistered successfully.

+

+  @retval EFI_INVALID_PARAMETER The NotificationHandle is

+                                invalid.

+

+**/

+typedef

+EFI_STATUS

+(EFIAPI *EFI_UNREGISTER_KEYSTROKE_NOTIFY)(

+  IN EFI_SIMPLE_TEXT_INPUT_EX_PROTOCOL  *This,

+  IN VOID                               *NotificationHandle

+);

+

+

+///

+/// The EFI_SIMPLE_TEXT_INPUT_EX_PROTOCOL is used on the ConsoleIn

+/// device. It is an extension to the Simple Text Input protocol

+/// which allows a variety of extended shift state information to be

+/// returned.

+///

+struct _EFI_SIMPLE_TEXT_INPUT_EX_PROTOCOL{

+  EFI_INPUT_RESET_EX              Reset;

+  EFI_INPUT_READ_KEY_EX           ReadKeyStrokeEx;

+  ///

+  /// Event to use with WaitForEvent() to wait for a key to be available.

+  ///

+  EFI_EVENT                       WaitForKeyEx;

+  EFI_SET_STATE                   SetState;

+  EFI_REGISTER_KEYSTROKE_NOTIFY   RegisterKeyNotify;

+  EFI_UNREGISTER_KEYSTROKE_NOTIFY UnregisterKeyNotify;

+};

+

+

+extern EFI_GUID gEfiSimpleTextInputExProtocolGuid;

+

+#endif

+

diff --git a/debugging_demo/memtest86+/efi/Include/Protocol/SimpleTextOut.h b/debugging_demo/memtest86+/efi/Include/Protocol/SimpleTextOut.h
new file mode 100644
index 0000000..a849c08
--- /dev/null
+++ b/debugging_demo/memtest86+/efi/Include/Protocol/SimpleTextOut.h
@@ -0,0 +1,409 @@
+/** @file

+  Simple Text Out protocol from the UEFI 2.0 specification.

+

+  Abstraction of a very simple text based output device like VGA text mode or

+  a serial terminal. The Simple Text Out protocol instance can represent

+  a single hardware device or a virtual device that is an aggregation

+  of multiple physical devices.

+

+Copyright (c) 2006 - 2018, Intel Corporation. All rights reserved.<BR>

+SPDX-License-Identifier: BSD-2-Clause-Patent

+

+**/

+

+#ifndef __SIMPLE_TEXT_OUT_H__

+#define __SIMPLE_TEXT_OUT_H__

+

+#define EFI_SIMPLE_TEXT_OUTPUT_PROTOCOL_GUID \

+  { \

+    0x387477c2, 0x69c7, 0x11d2, {0x8e, 0x39, 0x0, 0xa0, 0xc9, 0x69, 0x72, 0x3b } \

+  }

+

+///

+/// Protocol GUID defined in EFI1.1.

+///

+#define SIMPLE_TEXT_OUTPUT_PROTOCOL   EFI_SIMPLE_TEXT_OUTPUT_PROTOCOL_GUID

+

+typedef struct _EFI_SIMPLE_TEXT_OUTPUT_PROTOCOL EFI_SIMPLE_TEXT_OUTPUT_PROTOCOL;

+

+///

+/// Backward-compatible with EFI1.1.

+///

+typedef EFI_SIMPLE_TEXT_OUTPUT_PROTOCOL   SIMPLE_TEXT_OUTPUT_INTERFACE;

+

+//

+// Define's for required EFI Unicode Box Draw characters

+//

+#define BOXDRAW_HORIZONTAL                  0x2500

+#define BOXDRAW_VERTICAL                    0x2502

+#define BOXDRAW_DOWN_RIGHT                  0x250c

+#define BOXDRAW_DOWN_LEFT                   0x2510

+#define BOXDRAW_UP_RIGHT                    0x2514

+#define BOXDRAW_UP_LEFT                     0x2518

+#define BOXDRAW_VERTICAL_RIGHT              0x251c

+#define BOXDRAW_VERTICAL_LEFT               0x2524

+#define BOXDRAW_DOWN_HORIZONTAL             0x252c

+#define BOXDRAW_UP_HORIZONTAL               0x2534

+#define BOXDRAW_VERTICAL_HORIZONTAL         0x253c

+#define BOXDRAW_DOUBLE_HORIZONTAL           0x2550

+#define BOXDRAW_DOUBLE_VERTICAL             0x2551

+#define BOXDRAW_DOWN_RIGHT_DOUBLE           0x2552

+#define BOXDRAW_DOWN_DOUBLE_RIGHT           0x2553

+#define BOXDRAW_DOUBLE_DOWN_RIGHT           0x2554

+#define BOXDRAW_DOWN_LEFT_DOUBLE            0x2555

+#define BOXDRAW_DOWN_DOUBLE_LEFT            0x2556

+#define BOXDRAW_DOUBLE_DOWN_LEFT            0x2557

+#define BOXDRAW_UP_RIGHT_DOUBLE             0x2558

+#define BOXDRAW_UP_DOUBLE_RIGHT             0x2559

+#define BOXDRAW_DOUBLE_UP_RIGHT             0x255a

+#define BOXDRAW_UP_LEFT_DOUBLE              0x255b

+#define BOXDRAW_UP_DOUBLE_LEFT              0x255c

+#define BOXDRAW_DOUBLE_UP_LEFT              0x255d

+#define BOXDRAW_VERTICAL_RIGHT_DOUBLE       0x255e

+#define BOXDRAW_VERTICAL_DOUBLE_RIGHT       0x255f

+#define BOXDRAW_DOUBLE_VERTICAL_RIGHT       0x2560

+#define BOXDRAW_VERTICAL_LEFT_DOUBLE        0x2561

+#define BOXDRAW_VERTICAL_DOUBLE_LEFT        0x2562

+#define BOXDRAW_DOUBLE_VERTICAL_LEFT        0x2563

+#define BOXDRAW_DOWN_HORIZONTAL_DOUBLE      0x2564

+#define BOXDRAW_DOWN_DOUBLE_HORIZONTAL      0x2565

+#define BOXDRAW_DOUBLE_DOWN_HORIZONTAL      0x2566

+#define BOXDRAW_UP_HORIZONTAL_DOUBLE        0x2567

+#define BOXDRAW_UP_DOUBLE_HORIZONTAL        0x2568

+#define BOXDRAW_DOUBLE_UP_HORIZONTAL        0x2569

+#define BOXDRAW_VERTICAL_HORIZONTAL_DOUBLE  0x256a

+#define BOXDRAW_VERTICAL_DOUBLE_HORIZONTAL  0x256b

+#define BOXDRAW_DOUBLE_VERTICAL_HORIZONTAL  0x256c

+

+//

+// EFI Required Block Elements Code Chart

+//

+#define BLOCKELEMENT_FULL_BLOCK   0x2588

+#define BLOCKELEMENT_LIGHT_SHADE  0x2591

+

+//

+// EFI Required Geometric Shapes Code Chart

+//

+#define GEOMETRICSHAPE_UP_TRIANGLE    0x25b2

+#define GEOMETRICSHAPE_RIGHT_TRIANGLE 0x25ba

+#define GEOMETRICSHAPE_DOWN_TRIANGLE  0x25bc

+#define GEOMETRICSHAPE_LEFT_TRIANGLE  0x25c4

+

+//

+// EFI Required Arrow shapes

+//

+#define ARROW_LEFT  0x2190

+#define ARROW_UP    0x2191

+#define ARROW_RIGHT 0x2192

+#define ARROW_DOWN  0x2193

+

+//

+// EFI Console Colours

+//

+#define EFI_BLACK                 0x00

+#define EFI_BLUE                  0x01

+#define EFI_GREEN                 0x02

+#define EFI_CYAN                  (EFI_BLUE | EFI_GREEN)

+#define EFI_RED                   0x04

+#define EFI_MAGENTA               (EFI_BLUE | EFI_RED)

+#define EFI_BROWN                 (EFI_GREEN | EFI_RED)

+#define EFI_LIGHTGRAY             (EFI_BLUE | EFI_GREEN | EFI_RED)

+#define EFI_BRIGHT                0x08

+#define EFI_DARKGRAY              (EFI_BLACK | EFI_BRIGHT)

+#define EFI_LIGHTBLUE             (EFI_BLUE | EFI_BRIGHT)

+#define EFI_LIGHTGREEN            (EFI_GREEN | EFI_BRIGHT)

+#define EFI_LIGHTCYAN             (EFI_CYAN | EFI_BRIGHT)

+#define EFI_LIGHTRED              (EFI_RED | EFI_BRIGHT)

+#define EFI_LIGHTMAGENTA          (EFI_MAGENTA | EFI_BRIGHT)

+#define EFI_YELLOW                (EFI_BROWN | EFI_BRIGHT)

+#define EFI_WHITE                 (EFI_BLUE | EFI_GREEN | EFI_RED | EFI_BRIGHT)

+

+//

+// Macro to accept color values in their raw form to create

+// a value that represents both a foreground and background

+// color in a single byte.

+// For Foreground, and EFI_* value is valid from EFI_BLACK(0x00) to

+// EFI_WHITE (0x0F).

+// For Background, only EFI_BLACK, EFI_BLUE, EFI_GREEN, EFI_CYAN,

+// EFI_RED, EFI_MAGENTA, EFI_BROWN, and EFI_LIGHTGRAY are acceptable

+//

+// Do not use EFI_BACKGROUND_xxx values with this macro.

+//

+#define EFI_TEXT_ATTR(Foreground,Background) ((Foreground) | ((Background) << 4))

+

+#define EFI_BACKGROUND_BLACK      0x00

+#define EFI_BACKGROUND_BLUE       0x10

+#define EFI_BACKGROUND_GREEN      0x20

+#define EFI_BACKGROUND_CYAN       (EFI_BACKGROUND_BLUE | EFI_BACKGROUND_GREEN)

+#define EFI_BACKGROUND_RED        0x40

+#define EFI_BACKGROUND_MAGENTA    (EFI_BACKGROUND_BLUE | EFI_BACKGROUND_RED)

+#define EFI_BACKGROUND_BROWN      (EFI_BACKGROUND_GREEN | EFI_BACKGROUND_RED)

+#define EFI_BACKGROUND_LIGHTGRAY  (EFI_BACKGROUND_BLUE | EFI_BACKGROUND_GREEN | EFI_BACKGROUND_RED)

+

+//

+// We currently define attributes from 0 - 7F for color manipulations

+// To internally handle the local display characteristics for a particular character,

+// Bit 7 signifies the local glyph representation for a character.  If turned on, glyphs will be

+// pulled from the wide glyph database and will display locally as a wide character (16 X 19 versus 8 X 19)

+// If bit 7 is off, the narrow glyph database will be used.  This does NOT affect information that is sent to

+// non-local displays, such as serial or LAN consoles.

+//

+#define EFI_WIDE_ATTRIBUTE  0x80

+

+/**

+  Reset the text output device hardware and optionaly run diagnostics

+

+  @param  This                 The protocol instance pointer.

+  @param  ExtendedVerification Driver may perform more exhaustive verification

+                               operation of the device during reset.

+

+  @retval EFI_SUCCESS          The text output device was reset.

+  @retval EFI_DEVICE_ERROR     The text output device is not functioning correctly and

+                               could not be reset.

+

+**/

+typedef

+EFI_STATUS

+(EFIAPI *EFI_TEXT_RESET)(

+  IN EFI_SIMPLE_TEXT_OUTPUT_PROTOCOL        *This,

+  IN BOOLEAN                                ExtendedVerification

+  );

+

+/**

+  Write a string to the output device.

+

+  @param  This   The protocol instance pointer.

+  @param  String The NULL-terminated string to be displayed on the output

+                 device(s). All output devices must also support the Unicode

+                 drawing character codes defined in this file.

+

+  @retval EFI_SUCCESS             The string was output to the device.

+  @retval EFI_DEVICE_ERROR        The device reported an error while attempting to output

+                                  the text.

+  @retval EFI_UNSUPPORTED         The output device's mode is not currently in a

+                                  defined text mode.

+  @retval EFI_WARN_UNKNOWN_GLYPH  This warning code indicates that some of the

+                                  characters in the string could not be

+                                  rendered and were skipped.

+

+**/

+typedef

+EFI_STATUS

+(EFIAPI *EFI_TEXT_STRING)(

+  IN EFI_SIMPLE_TEXT_OUTPUT_PROTOCOL        *This,

+  IN CHAR16                                 *String

+  );

+

+/**

+  Verifies that all characters in a string can be output to the

+  target device.

+

+  @param  This   The protocol instance pointer.

+  @param  String The NULL-terminated string to be examined for the output

+                 device(s).

+

+  @retval EFI_SUCCESS      The device(s) are capable of rendering the output string.

+  @retval EFI_UNSUPPORTED  Some of the characters in the string cannot be

+                           rendered by one or more of the output devices mapped

+                           by the EFI handle.

+

+**/

+typedef

+EFI_STATUS

+(EFIAPI *EFI_TEXT_TEST_STRING)(

+  IN EFI_SIMPLE_TEXT_OUTPUT_PROTOCOL        *This,

+  IN CHAR16                                 *String

+  );

+

+/**

+  Returns information for an available text mode that the output device(s)

+  supports.

+

+  @param  This       The protocol instance pointer.

+  @param  ModeNumber The mode number to return information on.

+  @param  Columns    Returns the geometry of the text output device for the

+                     requested ModeNumber.

+  @param  Rows       Returns the geometry of the text output device for the

+                     requested ModeNumber.

+

+  @retval EFI_SUCCESS      The requested mode information was returned.

+  @retval EFI_DEVICE_ERROR The device had an error and could not complete the request.

+  @retval EFI_UNSUPPORTED  The mode number was not valid.

+

+**/

+typedef

+EFI_STATUS

+(EFIAPI *EFI_TEXT_QUERY_MODE)(

+  IN EFI_SIMPLE_TEXT_OUTPUT_PROTOCOL        *This,

+  IN UINTN                                  ModeNumber,

+  OUT UINTN                                 *Columns,

+  OUT UINTN                                 *Rows

+  );

+

+/**

+  Sets the output device(s) to a specified mode.

+

+  @param  This       The protocol instance pointer.

+  @param  ModeNumber The mode number to set.

+

+  @retval EFI_SUCCESS      The requested text mode was set.

+  @retval EFI_DEVICE_ERROR The device had an error and could not complete the request.

+  @retval EFI_UNSUPPORTED  The mode number was not valid.

+

+**/

+typedef

+EFI_STATUS

+(EFIAPI *EFI_TEXT_SET_MODE)(

+  IN EFI_SIMPLE_TEXT_OUTPUT_PROTOCOL        *This,

+  IN UINTN                                  ModeNumber

+  );

+

+/**

+  Sets the background and foreground colors for the OutputString () and

+  ClearScreen () functions.

+

+  @param  This      The protocol instance pointer.

+  @param  Attribute The attribute to set. Bits 0..3 are the foreground color, and

+                    bits 4..6 are the background color. All other bits are undefined

+                    and must be zero. The valid Attributes are defined in this file.

+

+  @retval EFI_SUCCESS       The attribute was set.

+  @retval EFI_DEVICE_ERROR  The device had an error and could not complete the request.

+  @retval EFI_UNSUPPORTED   The attribute requested is not defined.

+

+**/

+typedef

+EFI_STATUS

+(EFIAPI *EFI_TEXT_SET_ATTRIBUTE)(

+  IN EFI_SIMPLE_TEXT_OUTPUT_PROTOCOL        *This,

+  IN UINTN                                  Attribute

+  );

+

+/**

+  Clears the output device(s) display to the currently selected background

+  color.

+

+  @param  This              The protocol instance pointer.

+

+  @retval  EFI_SUCCESS      The operation completed successfully.

+  @retval  EFI_DEVICE_ERROR The device had an error and could not complete the request.

+  @retval  EFI_UNSUPPORTED  The output device is not in a valid text mode.

+

+**/

+typedef

+EFI_STATUS

+(EFIAPI *EFI_TEXT_CLEAR_SCREEN)(

+  IN EFI_SIMPLE_TEXT_OUTPUT_PROTOCOL   *This

+  );

+

+/**

+  Sets the current coordinates of the cursor position

+

+  @param  This        The protocol instance pointer.

+  @param  Column      The position to set the cursor to. Must be greater than or

+                      equal to zero and less than the number of columns and rows

+                      by QueryMode ().

+  @param  Row         The position to set the cursor to. Must be greater than or

+                      equal to zero and less than the number of columns and rows

+                      by QueryMode ().

+

+  @retval EFI_SUCCESS      The operation completed successfully.

+  @retval EFI_DEVICE_ERROR The device had an error and could not complete the request.

+  @retval EFI_UNSUPPORTED  The output device is not in a valid text mode, or the

+                           cursor position is invalid for the current mode.

+

+**/

+typedef

+EFI_STATUS

+(EFIAPI *EFI_TEXT_SET_CURSOR_POSITION)(

+  IN EFI_SIMPLE_TEXT_OUTPUT_PROTOCOL        *This,

+  IN UINTN                                  Column,

+  IN UINTN                                  Row

+  );

+

+/**

+  Makes the cursor visible or invisible

+

+  @param  This    The protocol instance pointer.

+  @param  Visible If TRUE, the cursor is set to be visible. If FALSE, the cursor is

+                  set to be invisible.

+

+  @retval EFI_SUCCESS      The operation completed successfully.

+  @retval EFI_DEVICE_ERROR The device had an error and could not complete the

+                           request, or the device does not support changing

+                           the cursor mode.

+  @retval EFI_UNSUPPORTED  The output device is not in a valid text mode.

+

+**/

+typedef

+EFI_STATUS

+(EFIAPI *EFI_TEXT_ENABLE_CURSOR)(

+  IN EFI_SIMPLE_TEXT_OUTPUT_PROTOCOL        *This,

+  IN BOOLEAN                                Visible

+  );

+

+/**

+  @par Data Structure Description:

+  Mode Structure pointed to by Simple Text Out protocol.

+**/

+typedef struct {

+  ///

+  /// The number of modes supported by QueryMode () and SetMode ().

+  ///

+  INT32   MaxMode;

+

+  //

+  // current settings

+  //

+

+  ///

+  /// The text mode of the output device(s).

+  ///

+  INT32   Mode;

+  ///

+  /// The current character output attribute.

+  ///

+  INT32   Attribute;

+  ///

+  /// The cursor's column.

+  ///

+  INT32   CursorColumn;

+  ///

+  /// The cursor's row.

+  ///

+  INT32   CursorRow;

+  ///

+  /// The cursor is currently visbile or not.

+  ///

+  BOOLEAN CursorVisible;

+} EFI_SIMPLE_TEXT_OUTPUT_MODE;

+

+///

+/// The SIMPLE_TEXT_OUTPUT protocol is used to control text-based output devices.

+/// It is the minimum required protocol for any handle supplied as the ConsoleOut

+/// or StandardError device. In addition, the minimum supported text mode of such

+/// devices is at least 80 x 25 characters.

+///

+struct _EFI_SIMPLE_TEXT_OUTPUT_PROTOCOL {

+  EFI_TEXT_RESET                Reset;

+

+  EFI_TEXT_STRING               OutputString;

+  EFI_TEXT_TEST_STRING          TestString;

+

+  EFI_TEXT_QUERY_MODE           QueryMode;

+  EFI_TEXT_SET_MODE             SetMode;

+  EFI_TEXT_SET_ATTRIBUTE        SetAttribute;

+

+  EFI_TEXT_CLEAR_SCREEN         ClearScreen;

+  EFI_TEXT_SET_CURSOR_POSITION  SetCursorPosition;

+  EFI_TEXT_ENABLE_CURSOR        EnableCursor;

+

+  ///

+  /// Pointer to SIMPLE_TEXT_OUTPUT_MODE data.

+  ///

+  EFI_SIMPLE_TEXT_OUTPUT_MODE   *Mode;

+};

+

+extern EFI_GUID gEfiSimpleTextOutProtocolGuid;

+

+#endif

diff --git a/debugging_demo/memtest86+/efi/Include/Protocol/UgaDraw.h b/debugging_demo/memtest86+/efi/Include/Protocol/UgaDraw.h
new file mode 100644
index 0000000..47286bb
--- /dev/null
+++ b/debugging_demo/memtest86+/efi/Include/Protocol/UgaDraw.h
@@ -0,0 +1,160 @@
+/** @file

+  UGA Draw protocol from the EFI 1.10 specification.

+

+  Abstraction of a very simple graphics device.

+

+  Copyright (c) 2006 - 2018, Intel Corporation. All rights reserved.<BR>

+  SPDX-License-Identifier: BSD-2-Clause-Patent

+

+**/

+

+#ifndef __UGA_DRAW_H__

+#define __UGA_DRAW_H__

+

+

+#define EFI_UGA_DRAW_PROTOCOL_GUID \

+  { \

+    0x982c298b, 0xf4fa, 0x41cb, {0xb8, 0x38, 0x77, 0xaa, 0x68, 0x8f, 0xb8, 0x39 } \

+  }

+

+typedef struct _EFI_UGA_DRAW_PROTOCOL EFI_UGA_DRAW_PROTOCOL;

+

+/**

+  Return the current video mode information.

+

+  @param  This                  The EFI_UGA_DRAW_PROTOCOL instance.

+  @param  HorizontalResolution  The size of video screen in pixels in the X dimension.

+  @param  VerticalResolution    The size of video screen in pixels in the Y dimension.

+  @param  ColorDepth            Number of bits per pixel, currently defined to be 32.

+  @param  RefreshRate           The refresh rate of the monitor in Hertz.

+

+  @retval EFI_SUCCESS           Mode information returned.

+  @retval EFI_NOT_STARTED       Video display is not initialized. Call SetMode ()

+  @retval EFI_INVALID_PARAMETER One of the input args was NULL.

+

+**/

+typedef

+EFI_STATUS

+(EFIAPI *EFI_UGA_DRAW_PROTOCOL_GET_MODE)(

+  IN  EFI_UGA_DRAW_PROTOCOL *This,

+  OUT UINT32                *HorizontalResolution,

+  OUT UINT32                *VerticalResolution,

+  OUT UINT32                *ColorDepth,

+  OUT UINT32                *RefreshRate

+  );

+

+/**

+  Set the current video mode information.

+

+  @param  This                 The EFI_UGA_DRAW_PROTOCOL instance.

+  @param  HorizontalResolution The size of video screen in pixels in the X dimension.

+  @param  VerticalResolution   The size of video screen in pixels in the Y dimension.

+  @param  ColorDepth           Number of bits per pixel, currently defined to be 32.

+  @param  RefreshRate          The refresh rate of the monitor in Hertz.

+

+  @retval EFI_SUCCESS          Mode information returned.

+  @retval EFI_NOT_STARTED      Video display is not initialized. Call SetMode ()

+

+**/

+typedef

+EFI_STATUS

+(EFIAPI *EFI_UGA_DRAW_PROTOCOL_SET_MODE)(

+  IN  EFI_UGA_DRAW_PROTOCOL *This,

+  IN  UINT32                HorizontalResolution,

+  IN  UINT32                VerticalResolution,

+  IN  UINT32                ColorDepth,

+  IN  UINT32                RefreshRate

+  );

+

+typedef struct {

+  UINT8 Blue;

+  UINT8 Green;

+  UINT8 Red;

+  UINT8 Reserved;

+} EFI_UGA_PIXEL;

+

+typedef union {

+  EFI_UGA_PIXEL Pixel;

+  UINT32        Raw;

+} EFI_UGA_PIXEL_UNION;

+

+///

+/// Enumration value for actions of Blt operations.

+///

+typedef enum {

+  EfiUgaVideoFill,          ///< Write data from the  BltBuffer pixel (SourceX, SourceY)

+                            ///< directly to every pixel of the video display rectangle

+                            ///< (DestinationX, DestinationY) (DestinationX + Width, DestinationY + Height).

+                            ///< Only one pixel will be used from the BltBuffer. Delta is NOT used.

+

+  EfiUgaVideoToBltBuffer,   ///< Read data from the video display rectangle

+                            ///< (SourceX, SourceY) (SourceX + Width, SourceY + Height) and place it in

+                            ///< the BltBuffer rectangle (DestinationX, DestinationY )

+                            ///< (DestinationX + Width, DestinationY + Height). If DestinationX or

+                            ///< DestinationY is not zero then Delta must be set to the length in bytes

+                            ///< of a row in the BltBuffer.

+

+  EfiUgaBltBufferToVideo,   ///< Write data from the  BltBuffer rectangle

+                            ///< (SourceX, SourceY) (SourceX + Width, SourceY + Height) directly to the

+                            ///< video display rectangle (DestinationX, DestinationY)

+                            ///< (DestinationX + Width, DestinationY + Height). If SourceX or SourceY is

+                            ///< not zero then Delta must be set to the length in bytes of a row in the

+                            ///< BltBuffer.

+

+  EfiUgaVideoToVideo,       ///< Copy from the video display rectangle (SourceX, SourceY)

+                            ///< (SourceX + Width, SourceY + Height) .to the video display rectangle

+                            ///< (DestinationX, DestinationY) (DestinationX + Width, DestinationY + Height).

+                            ///< The BltBuffer and Delta  are not used in this mode.

+

+  EfiUgaBltMax              ///< Maxmimum value for enumration value of Blt operation. If a Blt operation

+                            ///< larger or equal to this enumration value, it is invalid.

+} EFI_UGA_BLT_OPERATION;

+

+/**

+    Blt a rectangle of pixels on the graphics screen.

+

+    @param[in] This          - Protocol instance pointer.

+    @param[in] BltBuffer     - Buffer containing data to blit into video buffer. This

+                               buffer has a size of Width*Height*sizeof(EFI_UGA_PIXEL)

+    @param[in] BltOperation  - Operation to perform on BlitBuffer and video memory

+    @param[in] SourceX       - X coordinate of source for the BltBuffer.

+    @param[in] SourceY       - Y coordinate of source for the BltBuffer.

+    @param[in] DestinationX  - X coordinate of destination for the BltBuffer.

+    @param[in] DestinationY  - Y coordinate of destination for the BltBuffer.

+    @param[in] Width         - Width of rectangle in BltBuffer in pixels.

+    @param[in] Height        - Hight of rectangle in BltBuffer in pixels.

+    @param[in] Delta         - OPTIONAL

+

+    @retval EFI_SUCCESS           - The Blt operation completed.

+    @retval EFI_INVALID_PARAMETER - BltOperation is not valid.

+    @retval EFI_DEVICE_ERROR      - A hardware error occurred writting to the video buffer.

+

+**/

+typedef

+EFI_STATUS

+(EFIAPI *EFI_UGA_DRAW_PROTOCOL_BLT)(

+  IN  EFI_UGA_DRAW_PROTOCOL                   * This,

+  IN  EFI_UGA_PIXEL                           * BltBuffer, OPTIONAL

+  IN  EFI_UGA_BLT_OPERATION                   BltOperation,

+  IN  UINTN                                   SourceX,

+  IN  UINTN                                   SourceY,

+  IN  UINTN                                   DestinationX,

+  IN  UINTN                                   DestinationY,

+  IN  UINTN                                   Width,

+  IN  UINTN                                   Height,

+  IN  UINTN                                   Delta         OPTIONAL

+  );

+

+///

+/// This protocol provides a basic abstraction to set video modes and

+/// copy pixels to and from the graphics controller's frame buffer.

+///

+struct _EFI_UGA_DRAW_PROTOCOL {

+  EFI_UGA_DRAW_PROTOCOL_GET_MODE  GetMode;

+  EFI_UGA_DRAW_PROTOCOL_SET_MODE  SetMode;

+  EFI_UGA_DRAW_PROTOCOL_BLT       Blt;

+};

+

+extern EFI_GUID gEfiUgaDrawProtocolGuid;

+

+#endif

diff --git a/debugging_demo/memtest86+/efi/Include/Switch/environment.h b/debugging_demo/memtest86+/efi/Include/Switch/environment.h
new file mode 100644
index 0000000..26406dd
--- /dev/null
+++ b/debugging_demo/memtest86+/efi/Include/Switch/environment.h
@@ -0,0 +1,22 @@
+
+#include "stdin.h"
+
+#if __linux__   //  or #if __GNUC__
+    #if __x86_64__ || __ppc64__
+        #define ENVIRONMENT64
+    #else
+        #define ENVIRONMENT32
+    #endif
+#else
+    #if _WIN32
+        #define ENVIRONMENT32
+    #else
+        #define ENVIRONMENT64
+    #endif
+#endif // __linux__
+
+#ifdef ENVIRONMENT64
+    #define MAX_BLOCK_SIZE uint64_t
+#else
+    #define MAX_BLOCK_SIZE uint32_t
+#endif // ENVIRONMENT64
\ No newline at end of file
diff --git a/debugging_demo/memtest86+/efi/Include/Uefi.h b/debugging_demo/memtest86+/efi/Include/Uefi.h
new file mode 100644
index 0000000..f049f2a
--- /dev/null
+++ b/debugging_demo/memtest86+/efi/Include/Uefi.h
@@ -0,0 +1,21 @@
+/** @file

+

+  Root include file for Mde Package UEFI, UEFI_APPLICATION type modules.

+

+  This is the include file for any module of type UEFI and UEFI_APPLICATION. Uefi modules only use

+  types defined via this include file and can be ported easily to any

+  environment.

+

+Copyright (c) 2006 - 2018, Intel Corporation. All rights reserved.<BR>

+SPDX-License-Identifier: BSD-2-Clause-Patent

+

+**/

+

+#ifndef __PI_UEFI_H__

+#define __PI_UEFI_H__

+

+#include <Uefi/UefiBaseType.h>

+#include <Uefi/UefiSpec.h>

+

+#endif

+

diff --git a/debugging_demo/memtest86+/efi/Include/Uefi/UefiBaseType.h b/debugging_demo/memtest86+/efi/Include/Uefi/UefiBaseType.h
new file mode 100644
index 0000000..934fc07
--- /dev/null
+++ b/debugging_demo/memtest86+/efi/Include/Uefi/UefiBaseType.h
@@ -0,0 +1,298 @@
+/** @file

+  Defines data types and constants introduced in UEFI.

+

+Copyright (c) 2006 - 2018, Intel Corporation. All rights reserved.<BR>

+Portions copyright (c) 2011 - 2016, ARM Ltd. All rights reserved.<BR>

+Copyright (c) 2020, Hewlett Packard Enterprise Development LP. All rights reserved.<BR>

+

+SPDX-License-Identifier: BSD-2-Clause-Patent

+

+**/

+

+#ifndef __UEFI_BASETYPE_H__

+#define __UEFI_BASETYPE_H__

+

+#include <Base.h>

+

+//

+// Basic data type definitions introduced in UEFI.

+//

+

+///

+/// 128-bit buffer containing a unique identifier value.

+///

+typedef GUID                      EFI_GUID;

+///

+/// Function return status for EFI API.

+///

+typedef RETURN_STATUS             EFI_STATUS;

+///

+/// A collection of related interfaces.

+///

+typedef VOID                      *EFI_HANDLE;

+///

+/// Handle to an event structure.

+///

+typedef VOID                      *EFI_EVENT;

+///

+/// Task priority level.

+///

+typedef UINTN                     EFI_TPL;

+///

+/// Logical block address.

+///

+typedef UINT64                    EFI_LBA;

+

+///

+/// 64-bit physical memory address.

+///

+typedef UINT64                    EFI_PHYSICAL_ADDRESS;

+

+///

+/// 64-bit virtual memory address.

+///

+typedef UINT64                    EFI_VIRTUAL_ADDRESS;

+

+///

+/// EFI Time Abstraction:

+///  Year:       1900 - 9999

+///  Month:      1 - 12

+///  Day:        1 - 31

+///  Hour:       0 - 23

+///  Minute:     0 - 59

+///  Second:     0 - 59

+///  Nanosecond: 0 - 999,999,999

+///  TimeZone:   -1440 to 1440 or 2047

+///

+typedef struct {

+  UINT16  Year;

+  UINT8   Month;

+  UINT8   Day;

+  UINT8   Hour;

+  UINT8   Minute;

+  UINT8   Second;

+  UINT8   Pad1;

+  UINT32  Nanosecond;

+  INT16   TimeZone;

+  UINT8   Daylight;

+  UINT8   Pad2;

+} EFI_TIME;

+

+

+///

+/// 4-byte buffer. An IPv4 internet protocol address.

+///

+typedef IPv4_ADDRESS EFI_IPv4_ADDRESS;

+

+///

+/// 16-byte buffer. An IPv6 internet protocol address.

+///

+typedef IPv6_ADDRESS EFI_IPv6_ADDRESS;

+

+///

+/// 32-byte buffer containing a network Media Access Control address.

+///

+typedef struct {

+  UINT8 Addr[32];

+} EFI_MAC_ADDRESS;

+

+///

+/// 16-byte buffer aligned on a 4-byte boundary.

+/// An IPv4 or IPv6 internet protocol address.

+///

+typedef union {

+  UINT32            Addr[4];

+  EFI_IPv4_ADDRESS  v4;

+  EFI_IPv6_ADDRESS  v6;

+} EFI_IP_ADDRESS;

+

+

+///

+/// Enumeration of EFI_STATUS.

+///@{

+#define EFI_SUCCESS               RETURN_SUCCESS

+#define EFI_LOAD_ERROR            RETURN_LOAD_ERROR

+#define EFI_INVALID_PARAMETER     RETURN_INVALID_PARAMETER

+#define EFI_UNSUPPORTED           RETURN_UNSUPPORTED

+#define EFI_BAD_BUFFER_SIZE       RETURN_BAD_BUFFER_SIZE

+#define EFI_BUFFER_TOO_SMALL      RETURN_BUFFER_TOO_SMALL

+#define EFI_NOT_READY             RETURN_NOT_READY

+#define EFI_DEVICE_ERROR          RETURN_DEVICE_ERROR

+#define EFI_WRITE_PROTECTED       RETURN_WRITE_PROTECTED

+#define EFI_OUT_OF_RESOURCES      RETURN_OUT_OF_RESOURCES

+#define EFI_VOLUME_CORRUPTED      RETURN_VOLUME_CORRUPTED

+#define EFI_VOLUME_FULL           RETURN_VOLUME_FULL

+#define EFI_NO_MEDIA              RETURN_NO_MEDIA

+#define EFI_MEDIA_CHANGED         RETURN_MEDIA_CHANGED

+#define EFI_NOT_FOUND             RETURN_NOT_FOUND

+#define EFI_ACCESS_DENIED         RETURN_ACCESS_DENIED

+#define EFI_NO_RESPONSE           RETURN_NO_RESPONSE

+#define EFI_NO_MAPPING            RETURN_NO_MAPPING

+#define EFI_TIMEOUT               RETURN_TIMEOUT

+#define EFI_NOT_STARTED           RETURN_NOT_STARTED

+#define EFI_ALREADY_STARTED       RETURN_ALREADY_STARTED

+#define EFI_ABORTED               RETURN_ABORTED

+#define EFI_ICMP_ERROR            RETURN_ICMP_ERROR

+#define EFI_TFTP_ERROR            RETURN_TFTP_ERROR

+#define EFI_PROTOCOL_ERROR        RETURN_PROTOCOL_ERROR

+#define EFI_INCOMPATIBLE_VERSION  RETURN_INCOMPATIBLE_VERSION

+#define EFI_SECURITY_VIOLATION    RETURN_SECURITY_VIOLATION

+#define EFI_CRC_ERROR             RETURN_CRC_ERROR

+#define EFI_END_OF_MEDIA          RETURN_END_OF_MEDIA

+#define EFI_END_OF_FILE           RETURN_END_OF_FILE

+#define EFI_INVALID_LANGUAGE      RETURN_INVALID_LANGUAGE

+#define EFI_COMPROMISED_DATA      RETURN_COMPROMISED_DATA

+#define EFI_HTTP_ERROR            RETURN_HTTP_ERROR

+

+#define EFI_WARN_UNKNOWN_GLYPH    RETURN_WARN_UNKNOWN_GLYPH

+#define EFI_WARN_DELETE_FAILURE   RETURN_WARN_DELETE_FAILURE

+#define EFI_WARN_WRITE_FAILURE    RETURN_WARN_WRITE_FAILURE

+#define EFI_WARN_BUFFER_TOO_SMALL RETURN_WARN_BUFFER_TOO_SMALL

+#define EFI_WARN_STALE_DATA       RETURN_WARN_STALE_DATA

+#define EFI_WARN_FILE_SYSTEM      RETURN_WARN_FILE_SYSTEM

+///@}

+

+///

+/// Define macro to encode the status code.

+///

+#define EFIERR(_a)                ENCODE_ERROR(_a)

+

+#define EFI_ERROR(A)              RETURN_ERROR(A)

+

+///

+/// ICMP error definitions

+///@{

+#define EFI_NETWORK_UNREACHABLE   EFIERR(100)

+#define EFI_HOST_UNREACHABLE      EFIERR(101)

+#define EFI_PROTOCOL_UNREACHABLE  EFIERR(102)

+#define EFI_PORT_UNREACHABLE      EFIERR(103)

+///@}

+

+///

+/// Tcp connection status definitions

+///@{

+#define EFI_CONNECTION_FIN        EFIERR(104)

+#define EFI_CONNECTION_RESET      EFIERR(105)

+#define EFI_CONNECTION_REFUSED    EFIERR(106)

+///@}

+

+//

+// The EFI memory allocation functions work in units of EFI_PAGEs that are

+// 4KB. This should in no way be confused with the page size of the processor.

+// An EFI_PAGE is just the quanta of memory in EFI.

+//

+#define EFI_PAGE_SIZE             SIZE_4KB

+#define EFI_PAGE_MASK             0xFFF

+#define EFI_PAGE_SHIFT            12

+

+/**

+  Macro that converts a size, in bytes, to a number of EFI_PAGESs.

+

+  @param  Size      A size in bytes.  This parameter is assumed to be type UINTN.

+                    Passing in a parameter that is larger than UINTN may produce

+                    unexpected results.

+

+  @return  The number of EFI_PAGESs associated with the number of bytes specified

+           by Size.

+

+**/

+#define EFI_SIZE_TO_PAGES(Size)  (((Size) >> EFI_PAGE_SHIFT) + (((Size) & EFI_PAGE_MASK) ? 1 : 0))

+

+/**

+  Macro that converts a number of EFI_PAGEs to a size in bytes.

+

+  @param  Pages     The number of EFI_PAGES.  This parameter is assumed to be

+                    type UINTN.  Passing in a parameter that is larger than

+                    UINTN may produce unexpected results.

+

+  @return  The number of bytes associated with the number of EFI_PAGEs specified

+           by Pages.

+

+**/

+#define EFI_PAGES_TO_SIZE(Pages)  ((Pages) << EFI_PAGE_SHIFT)

+

+///

+/// PE32+ Machine type for IA32 UEFI images.

+///

+#define EFI_IMAGE_MACHINE_IA32            0x014C

+

+///

+/// PE32+ Machine type for IA64 UEFI images.

+///

+#define EFI_IMAGE_MACHINE_IA64            0x0200

+

+///

+/// PE32+ Machine type for EBC UEFI images.

+///

+#define EFI_IMAGE_MACHINE_EBC             0x0EBC

+

+///

+/// PE32+ Machine type for X64 UEFI images.

+///

+#define EFI_IMAGE_MACHINE_X64             0x8664

+

+///

+/// PE32+ Machine type for ARM mixed ARM and Thumb/Thumb2 images.

+///

+#define EFI_IMAGE_MACHINE_ARMTHUMB_MIXED  0x01C2

+

+///

+/// PE32+ Machine type for AARCH64 A64 images.

+///

+#define EFI_IMAGE_MACHINE_AARCH64  0xAA64

+

+///

+/// PE32+ Machine type for RISC-V 32/64/128

+///

+#define EFI_IMAGE_MACHINE_RISCV32   0x5032

+#define EFI_IMAGE_MACHINE_RISCV64   0x5064

+#define EFI_IMAGE_MACHINE_RISCV128  0x5128

+

+#if   defined (MDE_CPU_IA32)

+

+#define EFI_IMAGE_MACHINE_TYPE_SUPPORTED(Machine) \

+  ((Machine) == EFI_IMAGE_MACHINE_IA32)

+

+#define EFI_IMAGE_MACHINE_CROSS_TYPE_SUPPORTED(Machine) ((Machine) == EFI_IMAGE_MACHINE_X64)

+

+#elif defined (MDE_CPU_X64)

+

+#define EFI_IMAGE_MACHINE_TYPE_SUPPORTED(Machine) \

+  ((Machine) == EFI_IMAGE_MACHINE_X64)

+

+#define EFI_IMAGE_MACHINE_CROSS_TYPE_SUPPORTED(Machine) ((Machine) == EFI_IMAGE_MACHINE_IA32)

+

+#elif defined (MDE_CPU_ARM)

+

+#define EFI_IMAGE_MACHINE_TYPE_SUPPORTED(Machine) ((Machine) == EFI_IMAGE_MACHINE_ARMTHUMB_MIXED)

+

+#define EFI_IMAGE_MACHINE_CROSS_TYPE_SUPPORTED(Machine) (FALSE)

+

+#elif defined (MDE_CPU_AARCH64)

+

+#define EFI_IMAGE_MACHINE_TYPE_SUPPORTED(Machine) \

+  ((Machine) == EFI_IMAGE_MACHINE_AARCH64)

+

+#define EFI_IMAGE_MACHINE_CROSS_TYPE_SUPPORTED(Machine) (FALSE)

+

+#elif defined (MDE_CPU_RISCV64)

+#define EFI_IMAGE_MACHINE_TYPE_SUPPORTED(Machine) \

+  ((Machine) == EFI_IMAGE_MACHINE_RISCV64)

+

+#define EFI_IMAGE_MACHINE_CROSS_TYPE_SUPPORTED(Machine) (FALSE)

+

+#elif defined (MDE_CPU_EBC)

+

+///

+/// This is just to make sure you can cross compile with the EBC compiler.

+/// It does not make sense to have a PE loader coded in EBC.

+///

+#define EFI_IMAGE_MACHINE_TYPE_SUPPORTED(Machine) ((Machine) == EFI_IMAGE_MACHINE_EBC)

+

+#define EFI_IMAGE_MACHINE_CROSS_TYPE_SUPPORTED(Machine) (FALSE)

+

+#else

+#error Unknown Processor Type

+#endif

+

+#endif

diff --git a/debugging_demo/memtest86+/efi/Include/Uefi/UefiGpt.h b/debugging_demo/memtest86+/efi/Include/Uefi/UefiGpt.h
new file mode 100644
index 0000000..af7fb2f
--- /dev/null
+++ b/debugging_demo/memtest86+/efi/Include/Uefi/UefiGpt.h
@@ -0,0 +1,139 @@
+/** @file

+  EFI Guid Partition Table Format Definition.

+

+Copyright (c) 2006 - 2019, Intel Corporation. All rights reserved.<BR>

+SPDX-License-Identifier: BSD-2-Clause-Patent

+

+**/

+

+#ifndef __UEFI_GPT_H__

+#define __UEFI_GPT_H__

+

+///

+/// The primary GUID Partition Table Header must be

+/// located in LBA 1 (i.e., the second logical block).

+///

+#define PRIMARY_PART_HEADER_LBA 1

+///

+/// EFI Partition Table Signature: "EFI PART".

+///

+#define EFI_PTAB_HEADER_ID      SIGNATURE_64 ('E','F','I',' ','P','A','R','T')

+///

+/// Minimum bytes reserve for EFI entry array buffer.

+///

+#define EFI_GPT_PART_ENTRY_MIN_SIZE 16384

+

+#pragma pack(1)

+

+///

+/// GPT Partition Table Header.

+///

+typedef struct {

+  ///

+  /// The table header for the GPT partition Table.

+  /// This header contains EFI_PTAB_HEADER_ID.

+  ///

+  EFI_TABLE_HEADER  Header;

+  ///

+  /// The LBA that contains this data structure.

+  ///

+  EFI_LBA           MyLBA;

+  ///

+  /// LBA address of the alternate GUID Partition Table Header.

+  ///

+  EFI_LBA           AlternateLBA;

+  ///

+  /// The first usable logical block that may be used

+  /// by a partition described by a GUID Partition Entry.

+  ///

+  EFI_LBA           FirstUsableLBA;

+  ///

+  /// The last usable logical block that may be used

+  /// by a partition described by a GUID Partition Entry.

+  ///

+  EFI_LBA           LastUsableLBA;

+  ///

+  /// GUID that can be used to uniquely identify the disk.

+  ///

+  EFI_GUID          DiskGUID;

+  ///

+  /// The starting LBA of the GUID Partition Entry array.

+  ///

+  EFI_LBA           PartitionEntryLBA;

+  ///

+  /// The number of Partition Entries in the GUID Partition Entry array.

+  ///

+  UINT32            NumberOfPartitionEntries;

+  ///

+  /// The size, in bytes, of each the GUID Partition

+  /// Entry structures in the GUID Partition Entry

+  /// array. This field shall be set to a value of 128 x 2^n where n is

+  /// an integer greater than or equal to zero (e.g., 128, 256, 512, etc.).

+  ///

+  UINT32            SizeOfPartitionEntry;

+  ///

+  /// The CRC32 of the GUID Partition Entry array.

+  /// Starts at PartitionEntryLBA and is

+  /// computed over a byte length of

+  /// NumberOfPartitionEntries * SizeOfPartitionEntry.

+  ///

+  UINT32            PartitionEntryArrayCRC32;

+} EFI_PARTITION_TABLE_HEADER;

+

+///

+/// GPT Partition Entry.

+///

+typedef struct {

+  ///

+  /// Unique ID that defines the purpose and type of this Partition. A value of

+  /// zero defines that this partition entry is not being used.

+  ///

+  EFI_GUID  PartitionTypeGUID;

+  ///

+  /// GUID that is unique for every partition entry. Every partition ever

+  /// created will have a unique GUID.

+  /// This GUID must be assigned when the GUID Partition Entry is created.

+  ///

+  EFI_GUID  UniquePartitionGUID;

+  ///

+  /// Starting LBA of the partition defined by this entry

+  ///

+  EFI_LBA   StartingLBA;

+  ///

+  /// Ending LBA of the partition defined by this entry.

+  ///

+  EFI_LBA   EndingLBA;

+  ///

+  /// Attribute bits, all bits reserved by UEFI

+  /// Bit 0:      If this bit is set, the partition is required for the platform to function. The owner/creator of the

+  ///             partition indicates that deletion or modification of the contents can result in loss of platform

+  ///             features or failure for the platform to boot or operate. The system cannot function normally if

+  ///             this partition is removed, and it should be considered part of the hardware of the system.

+  ///             Actions such as running diagnostics, system recovery, or even OS install or boot, could

+  ///             potentially stop working if this partition is removed. Unless OS software or firmware

+  ///             recognizes this partition, it should never be removed or modified as the UEFI firmware or

+  ///             platform hardware may become non-functional.

+  /// Bit 1:      If this bit is set, then firmware must not produce an EFI_BLOCK_IO_PROTOCOL device for

+  ///             this partition. By not producing an EFI_BLOCK_IO_PROTOCOL partition, file system

+  ///             mappings will not be created for this partition in UEFI.

+  /// Bit 2:      This bit is set aside to let systems with traditional PC-AT BIOS firmware implementations

+  ///             inform certain limited, special-purpose software running on these systems that a GPT

+  ///             partition may be bootable. The UEFI boot manager must ignore this bit when selecting

+  ///             a UEFI-compliant application, e.g., an OS loader.

+  /// Bits 3-47:  Undefined and must be zero. Reserved for expansion by future versions of the UEFI

+  ///             specification.

+  /// Bits 48-63: Reserved for GUID specific use. The use of these bits will vary depending on the

+  ///             PartitionTypeGUID. Only the owner of the PartitionTypeGUID is allowed

+  ///             to modify these bits. They must be preserved if Bits 0-47 are modified..

+  ///

+  UINT64    Attributes;

+  ///

+  /// Null-terminated name of the partition.

+  ///

+  CHAR16    PartitionName[36];

+} EFI_PARTITION_ENTRY;

+

+#pragma pack()

+#endif

+

+

diff --git a/debugging_demo/memtest86+/efi/Include/Uefi/UefiInternalFormRepresentation.h b/debugging_demo/memtest86+/efi/Include/Uefi/UefiInternalFormRepresentation.h
new file mode 100644
index 0000000..1535ca6
--- /dev/null
+++ b/debugging_demo/memtest86+/efi/Include/Uefi/UefiInternalFormRepresentation.h
@@ -0,0 +1,2128 @@
+/** @file

+  This file defines the encoding for the VFR (Visual Form Representation) language.

+  IFR is primarily consumed by the EFI presentation engine, and produced by EFI

+  internal application and drivers as well as all add-in card option-ROM drivers

+

+Copyright (c) 2006 - 2018, Intel Corporation. All rights reserved.<BR>

+(C) Copyright 2016 Hewlett Packard Enterprise Development LP<BR>

+SPDX-License-Identifier: BSD-2-Clause-Patent

+

+  @par Revision Reference:

+  These definitions are from UEFI 2.1 and 2.2.

+

+**/

+

+#ifndef __UEFI_INTERNAL_FORMREPRESENTATION_H__

+#define __UEFI_INTERNAL_FORMREPRESENTATION_H__

+

+///

+/// The following types are currently defined:

+///

+typedef VOID*   EFI_HII_HANDLE;

+typedef CHAR16* EFI_STRING;

+typedef UINT16  EFI_IMAGE_ID;

+typedef UINT16  EFI_QUESTION_ID;

+typedef UINT16  EFI_STRING_ID;

+typedef UINT16  EFI_FORM_ID;

+typedef UINT16  EFI_VARSTORE_ID;

+typedef UINT16  EFI_ANIMATION_ID;

+

+typedef UINT16  EFI_DEFAULT_ID;

+

+typedef UINT32  EFI_HII_FONT_STYLE;

+

+

+

+#pragma pack(1)

+

+//

+// Definitions for Package Lists and Package Headers

+// Section 27.3.1

+//

+

+///

+/// The header found at the start of each package list.

+///

+typedef struct {

+  EFI_GUID               PackageListGuid;

+  UINT32                 PackageLength;

+} EFI_HII_PACKAGE_LIST_HEADER;

+

+///

+/// The header found at the start of each package.

+///

+typedef struct {

+  UINT32  Length:24;

+  UINT32  Type:8;

+  // UINT8  Data[...];

+} EFI_HII_PACKAGE_HEADER;

+

+//

+// Value of HII package type

+//

+#define EFI_HII_PACKAGE_TYPE_ALL             0x00

+#define EFI_HII_PACKAGE_TYPE_GUID            0x01

+#define EFI_HII_PACKAGE_FORMS                0x02

+#define EFI_HII_PACKAGE_STRINGS              0x04

+#define EFI_HII_PACKAGE_FONTS                0x05

+#define EFI_HII_PACKAGE_IMAGES               0x06

+#define EFI_HII_PACKAGE_SIMPLE_FONTS         0x07

+#define EFI_HII_PACKAGE_DEVICE_PATH          0x08

+#define EFI_HII_PACKAGE_KEYBOARD_LAYOUT      0x09

+#define EFI_HII_PACKAGE_ANIMATIONS           0x0A

+#define EFI_HII_PACKAGE_END                  0xDF

+#define EFI_HII_PACKAGE_TYPE_SYSTEM_BEGIN    0xE0

+#define EFI_HII_PACKAGE_TYPE_SYSTEM_END      0xFF

+

+//

+// Definitions for Simplified Font Package

+//

+

+///

+/// Contents of EFI_NARROW_GLYPH.Attributes.

+///@{

+#define EFI_GLYPH_NON_SPACING                0x01

+#define EFI_GLYPH_WIDE                       0x02

+#define EFI_GLYPH_HEIGHT                     19

+#define EFI_GLYPH_WIDTH                      8

+///@}

+

+///

+/// The EFI_NARROW_GLYPH has a preferred dimension (w x h) of 8 x 19 pixels.

+///

+typedef struct {

+  ///

+  /// The Unicode representation of the glyph. The term weight is the

+  /// technical term for a character code.

+  ///

+  CHAR16                 UnicodeWeight;

+  ///

+  /// The data element containing the glyph definitions.

+  ///

+  UINT8                  Attributes;

+  ///

+  /// The column major glyph representation of the character. Bits

+  /// with values of one indicate that the corresponding pixel is to be

+  /// on when normally displayed; those with zero are off.

+  ///

+  UINT8                  GlyphCol1[EFI_GLYPH_HEIGHT];

+} EFI_NARROW_GLYPH;

+

+///

+/// The EFI_WIDE_GLYPH has a preferred dimension (w x h) of 16 x 19 pixels, which is large enough

+/// to accommodate logographic characters.

+///

+typedef struct {

+  ///

+  /// The Unicode representation of the glyph. The term weight is the

+  /// technical term for a character code.

+  ///

+  CHAR16                 UnicodeWeight;

+  ///

+  /// The data element containing the glyph definitions.

+  ///

+  UINT8                  Attributes;

+  ///

+  /// The column major glyph representation of the character. Bits

+  /// with values of one indicate that the corresponding pixel is to be

+  /// on when normally displayed; those with zero are off.

+  ///

+  UINT8                  GlyphCol1[EFI_GLYPH_HEIGHT];

+  ///

+  /// The column major glyph representation of the character. Bits

+  /// with values of one indicate that the corresponding pixel is to be

+  /// on when normally displayed; those with zero are off.

+  ///

+  UINT8                  GlyphCol2[EFI_GLYPH_HEIGHT];

+  ///

+  /// Ensures that sizeof (EFI_WIDE_GLYPH) is twice the

+  /// sizeof (EFI_NARROW_GLYPH). The contents of Pad must

+  /// be zero.

+  ///

+  UINT8                  Pad[3];

+} EFI_WIDE_GLYPH;

+

+///

+/// A simplified font package consists of a font header

+/// followed by a series of glyph structures.

+///

+typedef struct _EFI_HII_SIMPLE_FONT_PACKAGE_HDR {

+  EFI_HII_PACKAGE_HEADER Header;

+  UINT16                 NumberOfNarrowGlyphs;

+  UINT16                 NumberOfWideGlyphs;

+  // EFI_NARROW_GLYPH       NarrowGlyphs[];

+  // EFI_WIDE_GLYPH         WideGlyphs[];

+} EFI_HII_SIMPLE_FONT_PACKAGE_HDR;

+

+//

+// Definitions for Font Package

+// Section 27.3.3

+//

+

+//

+// Value for font style

+//

+#define EFI_HII_FONT_STYLE_NORMAL            0x00000000

+#define EFI_HII_FONT_STYLE_BOLD              0x00000001

+#define EFI_HII_FONT_STYLE_ITALIC            0x00000002

+#define EFI_HII_FONT_STYLE_EMBOSS            0x00010000

+#define EFI_HII_FONT_STYLE_OUTLINE           0x00020000

+#define EFI_HII_FONT_STYLE_SHADOW            0x00040000

+#define EFI_HII_FONT_STYLE_UNDERLINE         0x00080000

+#define EFI_HII_FONT_STYLE_DBL_UNDER         0x00100000

+

+typedef struct _EFI_HII_GLYPH_INFO {

+  UINT16                 Width;

+  UINT16                 Height;

+  INT16                  OffsetX;

+  INT16                  OffsetY;

+  INT16                  AdvanceX;

+} EFI_HII_GLYPH_INFO;

+

+///

+/// The fixed header consists of a standard record header,

+/// then the character values in this section, the flags

+/// (including the encoding method) and the offsets of the glyph

+/// information, the glyph bitmaps and the character map.

+///

+typedef struct _EFI_HII_FONT_PACKAGE_HDR {

+  EFI_HII_PACKAGE_HEADER Header;

+  UINT32                 HdrSize;

+  UINT32                 GlyphBlockOffset;

+  EFI_HII_GLYPH_INFO     Cell;

+  EFI_HII_FONT_STYLE     FontStyle;

+  CHAR16                 FontFamily[1];

+} EFI_HII_FONT_PACKAGE_HDR;

+

+//

+// Value of different glyph info block types

+//

+#define EFI_HII_GIBT_END                  0x00

+#define EFI_HII_GIBT_GLYPH                0x10

+#define EFI_HII_GIBT_GLYPHS               0x11

+#define EFI_HII_GIBT_GLYPH_DEFAULT        0x12

+#define EFI_HII_GIBT_GLYPHS_DEFAULT       0x13

+#define EFI_HII_GIBT_GLYPH_VARIABILITY    0x14

+#define EFI_HII_GIBT_DUPLICATE            0x20

+#define EFI_HII_GIBT_SKIP2                0x21

+#define EFI_HII_GIBT_SKIP1                0x22

+#define EFI_HII_GIBT_DEFAULTS             0x23

+#define EFI_HII_GIBT_EXT1                 0x30

+#define EFI_HII_GIBT_EXT2                 0x31

+#define EFI_HII_GIBT_EXT4                 0x32

+

+typedef struct _EFI_HII_GLYPH_BLOCK {

+  UINT8                  BlockType;

+} EFI_HII_GLYPH_BLOCK;

+

+//

+// Definition of different glyph info block types

+//

+

+typedef struct _EFI_HII_GIBT_DEFAULTS_BLOCK {

+  EFI_HII_GLYPH_BLOCK    Header;

+  EFI_HII_GLYPH_INFO     Cell;

+} EFI_HII_GIBT_DEFAULTS_BLOCK;

+

+typedef struct _EFI_HII_GIBT_DUPLICATE_BLOCK {

+  EFI_HII_GLYPH_BLOCK    Header;

+  CHAR16                 CharValue;

+} EFI_HII_GIBT_DUPLICATE_BLOCK;

+

+typedef struct _EFI_GLYPH_GIBT_END_BLOCK {

+  EFI_HII_GLYPH_BLOCK    Header;

+} EFI_GLYPH_GIBT_END_BLOCK;

+

+typedef struct _EFI_HII_GIBT_EXT1_BLOCK {

+  EFI_HII_GLYPH_BLOCK    Header;

+  UINT8                  BlockType2;

+  UINT8                  Length;

+} EFI_HII_GIBT_EXT1_BLOCK;

+

+typedef struct _EFI_HII_GIBT_EXT2_BLOCK {

+  EFI_HII_GLYPH_BLOCK    Header;

+  UINT8                  BlockType2;

+  UINT16                 Length;

+} EFI_HII_GIBT_EXT2_BLOCK;

+

+typedef struct _EFI_HII_GIBT_EXT4_BLOCK {

+  EFI_HII_GLYPH_BLOCK    Header;

+  UINT8                  BlockType2;

+  UINT32                 Length;

+} EFI_HII_GIBT_EXT4_BLOCK;

+

+typedef struct _EFI_HII_GIBT_GLYPH_BLOCK {

+  EFI_HII_GLYPH_BLOCK    Header;

+  EFI_HII_GLYPH_INFO     Cell;

+  UINT8                  BitmapData[1];

+} EFI_HII_GIBT_GLYPH_BLOCK;

+

+typedef struct _EFI_HII_GIBT_GLYPHS_BLOCK {

+  EFI_HII_GLYPH_BLOCK    Header;

+  EFI_HII_GLYPH_INFO     Cell;

+  UINT16                 Count;

+  UINT8                  BitmapData[1];

+} EFI_HII_GIBT_GLYPHS_BLOCK;

+

+typedef struct _EFI_HII_GIBT_GLYPH_DEFAULT_BLOCK {

+  EFI_HII_GLYPH_BLOCK    Header;

+  UINT8                  BitmapData[1];

+} EFI_HII_GIBT_GLYPH_DEFAULT_BLOCK;

+

+typedef struct _EFI_HII_GIBT_GLYPHS_DEFAULT_BLOCK {

+  EFI_HII_GLYPH_BLOCK    Header;

+  UINT16                 Count;

+  UINT8                  BitmapData[1];

+} EFI_HII_GIBT_GLYPHS_DEFAULT_BLOCK;

+

+typedef struct _EFI_HII_GIBT_VARIABILITY_BLOCK {

+  EFI_HII_GLYPH_BLOCK    Header;

+  EFI_HII_GLYPH_INFO     Cell;

+  UINT8                  GlyphPackInBits;

+  UINT8                  BitmapData [1];

+} EFI_HII_GIBT_VARIABILITY_BLOCK;

+

+typedef struct _EFI_HII_GIBT_SKIP1_BLOCK {

+  EFI_HII_GLYPH_BLOCK    Header;

+  UINT8                  SkipCount;

+} EFI_HII_GIBT_SKIP1_BLOCK;

+

+typedef struct _EFI_HII_GIBT_SKIP2_BLOCK {

+  EFI_HII_GLYPH_BLOCK    Header;

+  UINT16                 SkipCount;

+} EFI_HII_GIBT_SKIP2_BLOCK;

+

+//

+// Definitions for Device Path Package

+// Section 27.3.4

+//

+

+///

+/// The device path package is used to carry a device path

+/// associated with the package list.

+///

+typedef struct _EFI_HII_DEVICE_PATH_PACKAGE_HDR {

+  EFI_HII_PACKAGE_HEADER   Header;

+  // EFI_DEVICE_PATH_PROTOCOL DevicePath[];

+} EFI_HII_DEVICE_PATH_PACKAGE_HDR;

+

+//

+// Definitions for GUID Package

+// Section 27.3.5

+//

+

+///

+/// The GUID package is used to carry data where the format is defined by a GUID.

+///

+typedef struct _EFI_HII_GUID_PACKAGE_HDR {

+  EFI_HII_PACKAGE_HEADER  Header;

+  EFI_GUID                Guid;

+  // Data per GUID definition may follow

+} EFI_HII_GUID_PACKAGE_HDR;

+

+//

+// Definitions for String Package

+// Section 27.3.6

+//

+

+#define UEFI_CONFIG_LANG   "x-UEFI"

+#define UEFI_CONFIG_LANG_2 "x-i-UEFI"

+

+///

+/// The fixed header consists of a standard record header and then the string identifiers

+/// contained in this section and the offsets of the string and language information.

+///

+typedef struct _EFI_HII_STRING_PACKAGE_HDR {

+  EFI_HII_PACKAGE_HEADER  Header;

+  UINT32                  HdrSize;

+  UINT32                  StringInfoOffset;

+  CHAR16                  LanguageWindow[16];

+  EFI_STRING_ID           LanguageName;

+  CHAR8                   Language[1];

+} EFI_HII_STRING_PACKAGE_HDR;

+

+typedef struct {

+  UINT8                   BlockType;

+} EFI_HII_STRING_BLOCK;

+

+//

+// Value of different string information block types

+//

+#define EFI_HII_SIBT_END                     0x00

+#define EFI_HII_SIBT_STRING_SCSU             0x10

+#define EFI_HII_SIBT_STRING_SCSU_FONT        0x11

+#define EFI_HII_SIBT_STRINGS_SCSU            0x12

+#define EFI_HII_SIBT_STRINGS_SCSU_FONT       0x13

+#define EFI_HII_SIBT_STRING_UCS2             0x14

+#define EFI_HII_SIBT_STRING_UCS2_FONT        0x15

+#define EFI_HII_SIBT_STRINGS_UCS2            0x16

+#define EFI_HII_SIBT_STRINGS_UCS2_FONT       0x17

+#define EFI_HII_SIBT_DUPLICATE               0x20

+#define EFI_HII_SIBT_SKIP2                   0x21

+#define EFI_HII_SIBT_SKIP1                   0x22

+#define EFI_HII_SIBT_EXT1                    0x30

+#define EFI_HII_SIBT_EXT2                    0x31

+#define EFI_HII_SIBT_EXT4                    0x32

+#define EFI_HII_SIBT_FONT                    0x40

+

+//

+// Definition of different string information block types

+//

+

+typedef struct _EFI_HII_SIBT_DUPLICATE_BLOCK {

+  EFI_HII_STRING_BLOCK    Header;

+  EFI_STRING_ID           StringId;

+} EFI_HII_SIBT_DUPLICATE_BLOCK;

+

+typedef struct _EFI_HII_SIBT_END_BLOCK {

+  EFI_HII_STRING_BLOCK    Header;

+} EFI_HII_SIBT_END_BLOCK;

+

+typedef struct _EFI_HII_SIBT_EXT1_BLOCK {

+  EFI_HII_STRING_BLOCK    Header;

+  UINT8                   BlockType2;

+  UINT8                   Length;

+} EFI_HII_SIBT_EXT1_BLOCK;

+

+typedef struct _EFI_HII_SIBT_EXT2_BLOCK {

+  EFI_HII_STRING_BLOCK    Header;

+  UINT8                   BlockType2;

+  UINT16                  Length;

+} EFI_HII_SIBT_EXT2_BLOCK;

+

+typedef struct _EFI_HII_SIBT_EXT4_BLOCK {

+  EFI_HII_STRING_BLOCK    Header;

+  UINT8                   BlockType2;

+  UINT32                  Length;

+} EFI_HII_SIBT_EXT4_BLOCK;

+

+typedef struct _EFI_HII_SIBT_FONT_BLOCK {

+  EFI_HII_SIBT_EXT2_BLOCK Header;

+  UINT8                   FontId;

+  UINT16                  FontSize;

+  EFI_HII_FONT_STYLE      FontStyle;

+  CHAR16                  FontName[1];

+} EFI_HII_SIBT_FONT_BLOCK;

+

+typedef struct _EFI_HII_SIBT_SKIP1_BLOCK {

+  EFI_HII_STRING_BLOCK    Header;

+  UINT8                   SkipCount;

+} EFI_HII_SIBT_SKIP1_BLOCK;

+

+typedef struct _EFI_HII_SIBT_SKIP2_BLOCK {

+  EFI_HII_STRING_BLOCK    Header;

+  UINT16                  SkipCount;

+} EFI_HII_SIBT_SKIP2_BLOCK;

+

+typedef struct _EFI_HII_SIBT_STRING_SCSU_BLOCK {

+  EFI_HII_STRING_BLOCK    Header;

+  UINT8                   StringText[1];

+} EFI_HII_SIBT_STRING_SCSU_BLOCK;

+

+typedef struct _EFI_HII_SIBT_STRING_SCSU_FONT_BLOCK {

+  EFI_HII_STRING_BLOCK    Header;

+  UINT8                   FontIdentifier;

+  UINT8                   StringText[1];

+} EFI_HII_SIBT_STRING_SCSU_FONT_BLOCK;

+

+typedef struct _EFI_HII_SIBT_STRINGS_SCSU_BLOCK {

+  EFI_HII_STRING_BLOCK    Header;

+  UINT16                  StringCount;

+  UINT8                   StringText[1];

+} EFI_HII_SIBT_STRINGS_SCSU_BLOCK;

+

+typedef struct _EFI_HII_SIBT_STRINGS_SCSU_FONT_BLOCK {

+  EFI_HII_STRING_BLOCK    Header;

+  UINT8                   FontIdentifier;

+  UINT16                  StringCount;

+  UINT8                   StringText[1];

+} EFI_HII_SIBT_STRINGS_SCSU_FONT_BLOCK;

+

+typedef struct _EFI_HII_SIBT_STRING_UCS2_BLOCK {

+  EFI_HII_STRING_BLOCK    Header;

+  CHAR16                  StringText[1];

+} EFI_HII_SIBT_STRING_UCS2_BLOCK;

+

+typedef struct _EFI_HII_SIBT_STRING_UCS2_FONT_BLOCK {

+  EFI_HII_STRING_BLOCK    Header;

+  UINT8                   FontIdentifier;

+  CHAR16                  StringText[1];

+} EFI_HII_SIBT_STRING_UCS2_FONT_BLOCK;

+

+typedef struct _EFI_HII_SIBT_STRINGS_UCS2_BLOCK {

+  EFI_HII_STRING_BLOCK    Header;

+  UINT16                  StringCount;

+  CHAR16                  StringText[1];

+} EFI_HII_SIBT_STRINGS_UCS2_BLOCK;

+

+typedef struct _EFI_HII_SIBT_STRINGS_UCS2_FONT_BLOCK {

+  EFI_HII_STRING_BLOCK    Header;

+  UINT8                   FontIdentifier;

+  UINT16                  StringCount;

+  CHAR16                  StringText[1];

+} EFI_HII_SIBT_STRINGS_UCS2_FONT_BLOCK;

+

+//

+// Definitions for Image Package

+// Section 27.3.7

+//

+

+typedef struct _EFI_HII_IMAGE_PACKAGE_HDR {

+  EFI_HII_PACKAGE_HEADER  Header;

+  UINT32                  ImageInfoOffset;

+  UINT32                  PaletteInfoOffset;

+} EFI_HII_IMAGE_PACKAGE_HDR;

+

+typedef struct _EFI_HII_IMAGE_BLOCK {

+  UINT8                   BlockType;

+} EFI_HII_IMAGE_BLOCK;

+

+//

+// Value of different image information block types

+//

+#define EFI_HII_IIBT_END               0x00

+#define EFI_HII_IIBT_IMAGE_1BIT        0x10

+#define EFI_HII_IIBT_IMAGE_1BIT_TRANS  0x11

+#define EFI_HII_IIBT_IMAGE_4BIT        0x12

+#define EFI_HII_IIBT_IMAGE_4BIT_TRANS  0x13

+#define EFI_HII_IIBT_IMAGE_8BIT        0x14

+#define EFI_HII_IIBT_IMAGE_8BIT_TRANS  0x15

+#define EFI_HII_IIBT_IMAGE_24BIT       0x16

+#define EFI_HII_IIBT_IMAGE_24BIT_TRANS 0x17

+#define EFI_HII_IIBT_IMAGE_JPEG        0x18

+#define EFI_HII_IIBT_IMAGE_PNG         0x19

+#define EFI_HII_IIBT_DUPLICATE         0x20

+#define EFI_HII_IIBT_SKIP2             0x21

+#define EFI_HII_IIBT_SKIP1             0x22

+#define EFI_HII_IIBT_EXT1              0x30

+#define EFI_HII_IIBT_EXT2              0x31

+#define EFI_HII_IIBT_EXT4              0x32

+

+//

+// Definition of different image information block types

+//

+

+typedef struct _EFI_HII_IIBT_END_BLOCK {

+  EFI_HII_IMAGE_BLOCK          Header;

+} EFI_HII_IIBT_END_BLOCK;

+

+typedef struct _EFI_HII_IIBT_EXT1_BLOCK {

+  EFI_HII_IMAGE_BLOCK          Header;

+  UINT8                        BlockType2;

+  UINT8                        Length;

+} EFI_HII_IIBT_EXT1_BLOCK;

+

+typedef struct _EFI_HII_IIBT_EXT2_BLOCK {

+  EFI_HII_IMAGE_BLOCK          Header;

+  UINT8                        BlockType2;

+  UINT16                       Length;

+} EFI_HII_IIBT_EXT2_BLOCK;

+

+typedef struct _EFI_HII_IIBT_EXT4_BLOCK {

+  EFI_HII_IMAGE_BLOCK          Header;

+  UINT8                        BlockType2;

+  UINT32                       Length;

+} EFI_HII_IIBT_EXT4_BLOCK;

+

+typedef struct _EFI_HII_IIBT_IMAGE_1BIT_BASE {

+  UINT16                       Width;

+  UINT16                       Height;

+  UINT8                        Data[1];

+} EFI_HII_IIBT_IMAGE_1BIT_BASE;

+

+typedef struct _EFI_HII_IIBT_IMAGE_1BIT_BLOCK {

+  EFI_HII_IMAGE_BLOCK          Header;

+  UINT8                        PaletteIndex;

+  EFI_HII_IIBT_IMAGE_1BIT_BASE Bitmap;

+} EFI_HII_IIBT_IMAGE_1BIT_BLOCK;

+

+typedef struct _EFI_HII_IIBT_IMAGE_1BIT_TRANS_BLOCK {

+  EFI_HII_IMAGE_BLOCK          Header;

+  UINT8                        PaletteIndex;

+  EFI_HII_IIBT_IMAGE_1BIT_BASE Bitmap;

+} EFI_HII_IIBT_IMAGE_1BIT_TRANS_BLOCK;

+

+typedef struct _EFI_HII_RGB_PIXEL {

+  UINT8                        b;

+  UINT8                        g;

+  UINT8                        r;

+} EFI_HII_RGB_PIXEL;

+

+typedef struct _EFI_HII_IIBT_IMAGE_24BIT_BASE {

+  UINT16                       Width;

+  UINT16                       Height;

+  EFI_HII_RGB_PIXEL            Bitmap[1];

+} EFI_HII_IIBT_IMAGE_24BIT_BASE;

+

+typedef struct _EFI_HII_IIBT_IMAGE_24BIT_BLOCK {

+  EFI_HII_IMAGE_BLOCK           Header;

+  EFI_HII_IIBT_IMAGE_24BIT_BASE Bitmap;

+} EFI_HII_IIBT_IMAGE_24BIT_BLOCK;

+

+typedef struct _EFI_HII_IIBT_IMAGE_24BIT_TRANS_BLOCK {

+  EFI_HII_IMAGE_BLOCK           Header;

+  EFI_HII_IIBT_IMAGE_24BIT_BASE Bitmap;

+} EFI_HII_IIBT_IMAGE_24BIT_TRANS_BLOCK;

+

+typedef struct _EFI_HII_IIBT_IMAGE_4BIT_BASE {

+  UINT16                       Width;

+  UINT16                       Height;

+  UINT8                        Data[1];

+} EFI_HII_IIBT_IMAGE_4BIT_BASE;

+

+typedef struct _EFI_HII_IIBT_IMAGE_4BIT_BLOCK {

+  EFI_HII_IMAGE_BLOCK          Header;

+  UINT8                        PaletteIndex;

+  EFI_HII_IIBT_IMAGE_4BIT_BASE Bitmap;

+} EFI_HII_IIBT_IMAGE_4BIT_BLOCK;

+

+typedef struct _EFI_HII_IIBT_IMAGE_4BIT_TRANS_BLOCK {

+  EFI_HII_IMAGE_BLOCK          Header;

+  UINT8                        PaletteIndex;

+  EFI_HII_IIBT_IMAGE_4BIT_BASE Bitmap;

+} EFI_HII_IIBT_IMAGE_4BIT_TRANS_BLOCK;

+

+typedef struct _EFI_HII_IIBT_IMAGE_8BIT_BASE {

+  UINT16                       Width;

+  UINT16                       Height;

+  UINT8                        Data[1];

+} EFI_HII_IIBT_IMAGE_8BIT_BASE;

+

+typedef struct _EFI_HII_IIBT_IMAGE_8BIT_PALETTE_BLOCK {

+  EFI_HII_IMAGE_BLOCK          Header;

+  UINT8                        PaletteIndex;

+  EFI_HII_IIBT_IMAGE_8BIT_BASE Bitmap;

+} EFI_HII_IIBT_IMAGE_8BIT_BLOCK;

+

+typedef struct _EFI_HII_IIBT_IMAGE_8BIT_TRANS_BLOCK {

+  EFI_HII_IMAGE_BLOCK          Header;

+  UINT8                        PaletteIndex;

+  EFI_HII_IIBT_IMAGE_8BIT_BASE Bitmap;

+} EFI_HII_IIBT_IMAGE_8BIT_TRAN_BLOCK;

+

+typedef struct _EFI_HII_IIBT_DUPLICATE_BLOCK {

+  EFI_HII_IMAGE_BLOCK          Header;

+  EFI_IMAGE_ID                 ImageId;

+} EFI_HII_IIBT_DUPLICATE_BLOCK;

+

+typedef struct _EFI_HII_IIBT_JPEG_BLOCK {

+  EFI_HII_IMAGE_BLOCK          Header;

+  UINT32                       Size;

+  UINT8                        Data[1];

+} EFI_HII_IIBT_JPEG_BLOCK;

+

+typedef struct _EFI_HII_IIBT_PNG_BLOCK {

+  EFI_HII_IMAGE_BLOCK          Header;

+  UINT32                       Size;

+  UINT8                        Data[1];

+} EFI_HII_IIBT_PNG_BLOCK;

+

+typedef struct _EFI_HII_IIBT_SKIP1_BLOCK {

+  EFI_HII_IMAGE_BLOCK          Header;

+  UINT8                        SkipCount;

+} EFI_HII_IIBT_SKIP1_BLOCK;

+

+typedef struct _EFI_HII_IIBT_SKIP2_BLOCK {

+  EFI_HII_IMAGE_BLOCK          Header;

+  UINT16                       SkipCount;

+} EFI_HII_IIBT_SKIP2_BLOCK;

+

+//

+// Definitions for Palette Information

+//

+

+typedef struct _EFI_HII_IMAGE_PALETTE_INFO_HEADER {

+  UINT16                       PaletteCount;

+} EFI_HII_IMAGE_PALETTE_INFO_HEADER;

+

+typedef struct _EFI_HII_IMAGE_PALETTE_INFO {

+  UINT16                       PaletteSize;

+  EFI_HII_RGB_PIXEL            PaletteValue[1];

+} EFI_HII_IMAGE_PALETTE_INFO;

+

+//

+// Definitions for Forms Package

+// Section 27.3.8

+//

+

+///

+/// The Form package is used to carry form-based encoding data.

+///

+typedef struct _EFI_HII_FORM_PACKAGE_HDR {

+  EFI_HII_PACKAGE_HEADER       Header;

+  // EFI_IFR_OP_HEADER         OpCodeHeader;

+  // More op-codes follow

+} EFI_HII_FORM_PACKAGE_HDR;

+

+typedef struct {

+  UINT8 Hour;

+  UINT8 Minute;

+  UINT8 Second;

+} EFI_HII_TIME;

+

+typedef struct {

+  UINT16 Year;

+  UINT8  Month;

+  UINT8  Day;

+} EFI_HII_DATE;

+

+typedef struct {

+  EFI_QUESTION_ID QuestionId;

+  EFI_FORM_ID     FormId;

+  EFI_GUID        FormSetGuid;

+  EFI_STRING_ID   DevicePath;

+} EFI_HII_REF;

+

+typedef union {

+  UINT8           u8;

+  UINT16          u16;

+  UINT32          u32;

+  UINT64          u64;

+  BOOLEAN         b;

+  EFI_HII_TIME    time;

+  EFI_HII_DATE    date;

+  EFI_STRING_ID   string; ///< EFI_IFR_TYPE_STRING, EFI_IFR_TYPE_ACTION

+  EFI_HII_REF     ref;    ///< EFI_IFR_TYPE_REF

+  // UINT8 buffer[];      ///< EFI_IFR_TYPE_BUFFER

+} EFI_IFR_TYPE_VALUE;

+

+//

+// IFR Opcodes

+//

+#define EFI_IFR_FORM_OP                0x01

+#define EFI_IFR_SUBTITLE_OP            0x02

+#define EFI_IFR_TEXT_OP                0x03

+#define EFI_IFR_IMAGE_OP               0x04

+#define EFI_IFR_ONE_OF_OP              0x05

+#define EFI_IFR_CHECKBOX_OP            0x06

+#define EFI_IFR_NUMERIC_OP             0x07

+#define EFI_IFR_PASSWORD_OP            0x08

+#define EFI_IFR_ONE_OF_OPTION_OP       0x09

+#define EFI_IFR_SUPPRESS_IF_OP         0x0A

+#define EFI_IFR_LOCKED_OP              0x0B

+#define EFI_IFR_ACTION_OP              0x0C

+#define EFI_IFR_RESET_BUTTON_OP        0x0D

+#define EFI_IFR_FORM_SET_OP            0x0E

+#define EFI_IFR_REF_OP                 0x0F

+#define EFI_IFR_NO_SUBMIT_IF_OP        0x10

+#define EFI_IFR_INCONSISTENT_IF_OP     0x11

+#define EFI_IFR_EQ_ID_VAL_OP           0x12

+#define EFI_IFR_EQ_ID_ID_OP            0x13

+#define EFI_IFR_EQ_ID_VAL_LIST_OP      0x14

+#define EFI_IFR_AND_OP                 0x15

+#define EFI_IFR_OR_OP                  0x16

+#define EFI_IFR_NOT_OP                 0x17

+#define EFI_IFR_RULE_OP                0x18

+#define EFI_IFR_GRAY_OUT_IF_OP         0x19

+#define EFI_IFR_DATE_OP                0x1A

+#define EFI_IFR_TIME_OP                0x1B

+#define EFI_IFR_STRING_OP              0x1C

+#define EFI_IFR_REFRESH_OP             0x1D

+#define EFI_IFR_DISABLE_IF_OP          0x1E

+#define EFI_IFR_ANIMATION_OP           0x1F

+#define EFI_IFR_TO_LOWER_OP            0x20

+#define EFI_IFR_TO_UPPER_OP            0x21

+#define EFI_IFR_MAP_OP                 0x22

+#define EFI_IFR_ORDERED_LIST_OP        0x23

+#define EFI_IFR_VARSTORE_OP            0x24

+#define EFI_IFR_VARSTORE_NAME_VALUE_OP 0x25

+#define EFI_IFR_VARSTORE_EFI_OP        0x26

+#define EFI_IFR_VARSTORE_DEVICE_OP     0x27

+#define EFI_IFR_VERSION_OP             0x28

+#define EFI_IFR_END_OP                 0x29

+#define EFI_IFR_MATCH_OP               0x2A

+#define EFI_IFR_GET_OP                 0x2B

+#define EFI_IFR_SET_OP                 0x2C

+#define EFI_IFR_READ_OP                0x2D

+#define EFI_IFR_WRITE_OP               0x2E

+#define EFI_IFR_EQUAL_OP               0x2F

+#define EFI_IFR_NOT_EQUAL_OP           0x30

+#define EFI_IFR_GREATER_THAN_OP        0x31

+#define EFI_IFR_GREATER_EQUAL_OP       0x32

+#define EFI_IFR_LESS_THAN_OP           0x33

+#define EFI_IFR_LESS_EQUAL_OP          0x34

+#define EFI_IFR_BITWISE_AND_OP         0x35

+#define EFI_IFR_BITWISE_OR_OP          0x36

+#define EFI_IFR_BITWISE_NOT_OP         0x37

+#define EFI_IFR_SHIFT_LEFT_OP          0x38

+#define EFI_IFR_SHIFT_RIGHT_OP         0x39

+#define EFI_IFR_ADD_OP                 0x3A

+#define EFI_IFR_SUBTRACT_OP            0x3B

+#define EFI_IFR_MULTIPLY_OP            0x3C

+#define EFI_IFR_DIVIDE_OP              0x3D

+#define EFI_IFR_MODULO_OP              0x3E

+#define EFI_IFR_RULE_REF_OP            0x3F

+#define EFI_IFR_QUESTION_REF1_OP       0x40

+#define EFI_IFR_QUESTION_REF2_OP       0x41

+#define EFI_IFR_UINT8_OP               0x42

+#define EFI_IFR_UINT16_OP              0x43

+#define EFI_IFR_UINT32_OP              0x44

+#define EFI_IFR_UINT64_OP              0x45

+#define EFI_IFR_TRUE_OP                0x46

+#define EFI_IFR_FALSE_OP               0x47

+#define EFI_IFR_TO_UINT_OP             0x48

+#define EFI_IFR_TO_STRING_OP           0x49

+#define EFI_IFR_TO_BOOLEAN_OP          0x4A

+#define EFI_IFR_MID_OP                 0x4B

+#define EFI_IFR_FIND_OP                0x4C

+#define EFI_IFR_TOKEN_OP               0x4D

+#define EFI_IFR_STRING_REF1_OP         0x4E

+#define EFI_IFR_STRING_REF2_OP         0x4F

+#define EFI_IFR_CONDITIONAL_OP         0x50

+#define EFI_IFR_QUESTION_REF3_OP       0x51

+#define EFI_IFR_ZERO_OP                0x52

+#define EFI_IFR_ONE_OP                 0x53

+#define EFI_IFR_ONES_OP                0x54

+#define EFI_IFR_UNDEFINED_OP           0x55

+#define EFI_IFR_LENGTH_OP              0x56

+#define EFI_IFR_DUP_OP                 0x57

+#define EFI_IFR_THIS_OP                0x58

+#define EFI_IFR_SPAN_OP                0x59

+#define EFI_IFR_VALUE_OP               0x5A

+#define EFI_IFR_DEFAULT_OP             0x5B

+#define EFI_IFR_DEFAULTSTORE_OP        0x5C

+#define EFI_IFR_FORM_MAP_OP            0x5D

+#define EFI_IFR_CATENATE_OP            0x5E

+#define EFI_IFR_GUID_OP                0x5F

+#define EFI_IFR_SECURITY_OP            0x60

+#define EFI_IFR_MODAL_TAG_OP           0x61

+#define EFI_IFR_REFRESH_ID_OP          0x62

+#define EFI_IFR_WARNING_IF_OP          0x63

+#define EFI_IFR_MATCH2_OP              0x64

+

+//

+// Definitions of IFR Standard Headers

+// Section 27.3.8.2

+//

+

+typedef struct _EFI_IFR_OP_HEADER {

+  UINT8                    OpCode;

+  UINT8                    Length:7;

+  UINT8                    Scope:1;

+} EFI_IFR_OP_HEADER;

+

+typedef struct _EFI_IFR_STATEMENT_HEADER {

+  EFI_STRING_ID            Prompt;

+  EFI_STRING_ID            Help;

+} EFI_IFR_STATEMENT_HEADER;

+

+typedef struct _EFI_IFR_QUESTION_HEADER {

+  EFI_IFR_STATEMENT_HEADER Header;

+  EFI_QUESTION_ID          QuestionId;

+  EFI_VARSTORE_ID          VarStoreId;

+  union {

+    EFI_STRING_ID          VarName;

+    UINT16                 VarOffset;

+  }                        VarStoreInfo;

+  UINT8                    Flags;

+} EFI_IFR_QUESTION_HEADER;

+

+//

+// Flag values of EFI_IFR_QUESTION_HEADER

+//

+#define EFI_IFR_FLAG_READ_ONLY          0x01

+#define EFI_IFR_FLAG_CALLBACK           0x04

+#define EFI_IFR_FLAG_RESET_REQUIRED     0x10

+#define EFI_IFR_FLAG_REST_STYLE         0x20

+#define EFI_IFR_FLAG_RECONNECT_REQUIRED 0x40

+#define EFI_IFR_FLAG_OPTIONS_ONLY       0x80

+

+//

+// Definition for Opcode Reference

+// Section 27.3.8.3

+//

+typedef struct _EFI_IFR_DEFAULTSTORE {

+  EFI_IFR_OP_HEADER        Header;

+  EFI_STRING_ID            DefaultName;

+  UINT16                   DefaultId;

+} EFI_IFR_DEFAULTSTORE;

+

+//

+// Default Identifier of default store

+//

+#define EFI_HII_DEFAULT_CLASS_STANDARD       0x0000

+#define EFI_HII_DEFAULT_CLASS_MANUFACTURING  0x0001

+#define EFI_HII_DEFAULT_CLASS_SAFE           0x0002

+#define EFI_HII_DEFAULT_CLASS_PLATFORM_BEGIN 0x4000

+#define EFI_HII_DEFAULT_CLASS_PLATFORM_END   0x7fff

+#define EFI_HII_DEFAULT_CLASS_HARDWARE_BEGIN 0x8000

+#define EFI_HII_DEFAULT_CLASS_HARDWARE_END   0xbfff

+#define EFI_HII_DEFAULT_CLASS_FIRMWARE_BEGIN 0xc000

+#define EFI_HII_DEFAULT_CLASS_FIRMWARE_END   0xffff

+

+typedef struct _EFI_IFR_VARSTORE {

+  EFI_IFR_OP_HEADER        Header;

+  EFI_GUID                 Guid;

+  EFI_VARSTORE_ID          VarStoreId;

+  UINT16                   Size;

+  UINT8                    Name[1];

+} EFI_IFR_VARSTORE;

+

+typedef struct _EFI_IFR_VARSTORE_EFI {

+  EFI_IFR_OP_HEADER        Header;

+  EFI_VARSTORE_ID          VarStoreId;

+  EFI_GUID                 Guid;

+  UINT32                   Attributes;

+  UINT16                   Size;

+  UINT8                    Name[1];

+} EFI_IFR_VARSTORE_EFI;

+

+typedef struct _EFI_IFR_VARSTORE_NAME_VALUE {

+  EFI_IFR_OP_HEADER        Header;

+  EFI_VARSTORE_ID          VarStoreId;

+  EFI_GUID                 Guid;

+} EFI_IFR_VARSTORE_NAME_VALUE;

+

+typedef struct _EFI_IFR_FORM_SET {

+  EFI_IFR_OP_HEADER        Header;

+  EFI_GUID                 Guid;

+  EFI_STRING_ID            FormSetTitle;

+  EFI_STRING_ID            Help;

+  UINT8                    Flags;

+  // EFI_GUID              ClassGuid[];

+} EFI_IFR_FORM_SET;

+

+typedef struct _EFI_IFR_END {

+  EFI_IFR_OP_HEADER        Header;

+} EFI_IFR_END;

+

+typedef struct _EFI_IFR_FORM {

+  EFI_IFR_OP_HEADER        Header;

+  UINT16                   FormId;

+  EFI_STRING_ID            FormTitle;

+} EFI_IFR_FORM;

+

+typedef struct _EFI_IFR_IMAGE {

+  EFI_IFR_OP_HEADER        Header;

+  EFI_IMAGE_ID             Id;

+} EFI_IFR_IMAGE;

+

+typedef struct _EFI_IFR_MODAL_TAG {

+  EFI_IFR_OP_HEADER        Header;

+} EFI_IFR_MODAL_TAG;

+

+typedef struct _EFI_IFR_LOCKED {

+  EFI_IFR_OP_HEADER        Header;

+} EFI_IFR_LOCKED;

+

+typedef struct _EFI_IFR_RULE {

+  EFI_IFR_OP_HEADER        Header;

+  UINT8                    RuleId;

+} EFI_IFR_RULE;

+

+typedef struct _EFI_IFR_DEFAULT {

+  EFI_IFR_OP_HEADER        Header;

+  UINT16                   DefaultId;

+  UINT8                    Type;

+  EFI_IFR_TYPE_VALUE       Value;

+} EFI_IFR_DEFAULT;

+

+typedef struct _EFI_IFR_DEFAULT_2 {

+  EFI_IFR_OP_HEADER        Header;

+  UINT16                   DefaultId;

+  UINT8                    Type;

+} EFI_IFR_DEFAULT_2;

+

+typedef struct _EFI_IFR_VALUE {

+  EFI_IFR_OP_HEADER        Header;

+} EFI_IFR_VALUE;

+

+typedef struct _EFI_IFR_SUBTITLE {

+  EFI_IFR_OP_HEADER        Header;

+  EFI_IFR_STATEMENT_HEADER Statement;

+  UINT8                    Flags;

+} EFI_IFR_SUBTITLE;

+

+#define EFI_IFR_FLAGS_HORIZONTAL       0x01

+

+typedef struct _EFI_IFR_CHECKBOX {

+  EFI_IFR_OP_HEADER        Header;

+  EFI_IFR_QUESTION_HEADER  Question;

+  UINT8                    Flags;

+} EFI_IFR_CHECKBOX;

+

+#define EFI_IFR_CHECKBOX_DEFAULT       0x01

+#define EFI_IFR_CHECKBOX_DEFAULT_MFG   0x02

+

+typedef struct _EFI_IFR_TEXT {

+  EFI_IFR_OP_HEADER        Header;

+  EFI_IFR_STATEMENT_HEADER Statement;

+  EFI_STRING_ID            TextTwo;

+} EFI_IFR_TEXT;

+

+typedef struct _EFI_IFR_REF {

+  EFI_IFR_OP_HEADER        Header;

+  EFI_IFR_QUESTION_HEADER  Question;

+  EFI_FORM_ID              FormId;

+} EFI_IFR_REF;

+

+typedef struct _EFI_IFR_REF2 {

+  EFI_IFR_OP_HEADER        Header;

+  EFI_IFR_QUESTION_HEADER  Question;

+  EFI_FORM_ID              FormId;

+  EFI_QUESTION_ID          QuestionId;

+} EFI_IFR_REF2;

+

+typedef struct _EFI_IFR_REF3 {

+  EFI_IFR_OP_HEADER        Header;

+  EFI_IFR_QUESTION_HEADER  Question;

+  EFI_FORM_ID              FormId;

+  EFI_QUESTION_ID          QuestionId;

+  EFI_GUID                 FormSetId;

+} EFI_IFR_REF3;

+

+typedef struct _EFI_IFR_REF4 {

+  EFI_IFR_OP_HEADER        Header;

+  EFI_IFR_QUESTION_HEADER  Question;

+  EFI_FORM_ID              FormId;

+  EFI_QUESTION_ID          QuestionId;

+  EFI_GUID                 FormSetId;

+  EFI_STRING_ID            DevicePath;

+} EFI_IFR_REF4;

+

+typedef struct _EFI_IFR_REF5 {

+  EFI_IFR_OP_HEADER Header;

+  EFI_IFR_QUESTION_HEADER Question;

+} EFI_IFR_REF5;

+

+typedef struct _EFI_IFR_RESET_BUTTON {

+  EFI_IFR_OP_HEADER        Header;

+  EFI_IFR_STATEMENT_HEADER Statement;

+  EFI_DEFAULT_ID           DefaultId;

+} EFI_IFR_RESET_BUTTON;

+

+typedef struct _EFI_IFR_ACTION {

+  EFI_IFR_OP_HEADER        Header;

+  EFI_IFR_QUESTION_HEADER  Question;

+  EFI_STRING_ID            QuestionConfig;

+} EFI_IFR_ACTION;

+

+typedef struct _EFI_IFR_ACTION_1 {

+  EFI_IFR_OP_HEADER        Header;

+  EFI_IFR_QUESTION_HEADER  Question;

+} EFI_IFR_ACTION_1;

+

+typedef struct _EFI_IFR_DATE {

+  EFI_IFR_OP_HEADER        Header;

+  EFI_IFR_QUESTION_HEADER  Question;

+  UINT8                    Flags;

+} EFI_IFR_DATE;

+

+//

+// Flags that describe the behavior of the question.

+//

+#define EFI_QF_DATE_YEAR_SUPPRESS      0x01

+#define EFI_QF_DATE_MONTH_SUPPRESS     0x02

+#define EFI_QF_DATE_DAY_SUPPRESS       0x04

+

+#define EFI_QF_DATE_STORAGE            0x30

+#define     QF_DATE_STORAGE_NORMAL     0x00

+#define     QF_DATE_STORAGE_TIME       0x10

+#define     QF_DATE_STORAGE_WAKEUP     0x20

+

+typedef union {

+  struct {

+    UINT8 MinValue;

+    UINT8 MaxValue;

+    UINT8 Step;

+  } u8;

+  struct {

+    UINT16 MinValue;

+    UINT16 MaxValue;

+    UINT16 Step;

+  } u16;

+  struct {

+    UINT32 MinValue;

+    UINT32 MaxValue;

+    UINT32 Step;

+  } u32;

+  struct {

+    UINT64 MinValue;

+    UINT64 MaxValue;

+    UINT64 Step;

+  } u64;

+} MINMAXSTEP_DATA;

+

+typedef struct _EFI_IFR_NUMERIC {

+  EFI_IFR_OP_HEADER        Header;

+  EFI_IFR_QUESTION_HEADER  Question;

+  UINT8                    Flags;

+  MINMAXSTEP_DATA          data;

+} EFI_IFR_NUMERIC;

+

+//

+// Flags related to the numeric question

+//

+#define EFI_IFR_NUMERIC_SIZE           0x03

+#define   EFI_IFR_NUMERIC_SIZE_1       0x00

+#define   EFI_IFR_NUMERIC_SIZE_2       0x01

+#define   EFI_IFR_NUMERIC_SIZE_4       0x02

+#define   EFI_IFR_NUMERIC_SIZE_8       0x03

+

+#define EFI_IFR_DISPLAY                0x30

+#define   EFI_IFR_DISPLAY_INT_DEC      0x00

+#define   EFI_IFR_DISPLAY_UINT_DEC     0x10

+#define   EFI_IFR_DISPLAY_UINT_HEX     0x20

+

+typedef struct _EFI_IFR_ONE_OF {

+  EFI_IFR_OP_HEADER        Header;

+  EFI_IFR_QUESTION_HEADER  Question;

+  UINT8                    Flags;

+  MINMAXSTEP_DATA          data;

+} EFI_IFR_ONE_OF;

+

+typedef struct _EFI_IFR_STRING {

+  EFI_IFR_OP_HEADER        Header;

+  EFI_IFR_QUESTION_HEADER  Question;

+  UINT8                    MinSize;

+  UINT8                    MaxSize;

+  UINT8                    Flags;

+} EFI_IFR_STRING;

+

+#define EFI_IFR_STRING_MULTI_LINE      0x01

+

+typedef struct _EFI_IFR_PASSWORD {

+  EFI_IFR_OP_HEADER        Header;

+  EFI_IFR_QUESTION_HEADER  Question;

+  UINT16                   MinSize;

+  UINT16                   MaxSize;

+} EFI_IFR_PASSWORD;

+

+typedef struct _EFI_IFR_ORDERED_LIST {

+  EFI_IFR_OP_HEADER        Header;

+  EFI_IFR_QUESTION_HEADER  Question;

+  UINT8                    MaxContainers;

+  UINT8                    Flags;

+} EFI_IFR_ORDERED_LIST;

+

+#define EFI_IFR_UNIQUE_SET             0x01

+#define EFI_IFR_NO_EMPTY_SET           0x02

+

+typedef struct _EFI_IFR_TIME {

+  EFI_IFR_OP_HEADER        Header;

+  EFI_IFR_QUESTION_HEADER  Question;

+  UINT8                    Flags;

+} EFI_IFR_TIME;

+

+//

+// A bit-mask that determines which unique settings are active for this opcode.

+//

+#define QF_TIME_HOUR_SUPPRESS          0x01

+#define QF_TIME_MINUTE_SUPPRESS        0x02

+#define QF_TIME_SECOND_SUPPRESS        0x04

+

+#define QF_TIME_STORAGE                0x30

+#define   QF_TIME_STORAGE_NORMAL       0x00

+#define   QF_TIME_STORAGE_TIME         0x10

+#define   QF_TIME_STORAGE_WAKEUP       0x20

+

+typedef struct _EFI_IFR_DISABLE_IF {

+  EFI_IFR_OP_HEADER        Header;

+} EFI_IFR_DISABLE_IF;

+

+typedef struct _EFI_IFR_SUPPRESS_IF {

+  EFI_IFR_OP_HEADER        Header;

+} EFI_IFR_SUPPRESS_IF;

+

+typedef struct _EFI_IFR_GRAY_OUT_IF {

+  EFI_IFR_OP_HEADER        Header;

+} EFI_IFR_GRAY_OUT_IF;

+

+typedef struct _EFI_IFR_INCONSISTENT_IF {

+  EFI_IFR_OP_HEADER        Header;

+  EFI_STRING_ID            Error;

+} EFI_IFR_INCONSISTENT_IF;

+

+typedef struct _EFI_IFR_NO_SUBMIT_IF {

+  EFI_IFR_OP_HEADER        Header;

+  EFI_STRING_ID            Error;

+} EFI_IFR_NO_SUBMIT_IF;

+

+typedef struct _EFI_IFR_WARNING_IF {

+  EFI_IFR_OP_HEADER        Header;

+  EFI_STRING_ID            Warning;

+  UINT8                    TimeOut;

+} EFI_IFR_WARNING_IF;

+

+typedef struct _EFI_IFR_REFRESH {

+  EFI_IFR_OP_HEADER        Header;

+  UINT8                    RefreshInterval;

+} EFI_IFR_REFRESH;

+

+typedef struct _EFI_IFR_VARSTORE_DEVICE {

+  EFI_IFR_OP_HEADER        Header;

+  EFI_STRING_ID            DevicePath;

+} EFI_IFR_VARSTORE_DEVICE;

+

+typedef struct _EFI_IFR_ONE_OF_OPTION {

+  EFI_IFR_OP_HEADER        Header;

+  EFI_STRING_ID            Option;

+  UINT8                    Flags;

+  UINT8                    Type;

+  EFI_IFR_TYPE_VALUE       Value;

+} EFI_IFR_ONE_OF_OPTION;

+

+//

+// Types of the option's value.

+//

+#define EFI_IFR_TYPE_NUM_SIZE_8        0x00

+#define EFI_IFR_TYPE_NUM_SIZE_16       0x01

+#define EFI_IFR_TYPE_NUM_SIZE_32       0x02

+#define EFI_IFR_TYPE_NUM_SIZE_64       0x03

+#define EFI_IFR_TYPE_BOOLEAN           0x04

+#define EFI_IFR_TYPE_TIME              0x05

+#define EFI_IFR_TYPE_DATE              0x06

+#define EFI_IFR_TYPE_STRING            0x07

+#define EFI_IFR_TYPE_OTHER             0x08

+#define EFI_IFR_TYPE_UNDEFINED         0x09

+#define EFI_IFR_TYPE_ACTION            0x0A

+#define EFI_IFR_TYPE_BUFFER            0x0B

+#define EFI_IFR_TYPE_REF               0x0C

+

+#define EFI_IFR_OPTION_DEFAULT         0x10

+#define EFI_IFR_OPTION_DEFAULT_MFG     0x20

+

+typedef struct _EFI_IFR_GUID {

+  EFI_IFR_OP_HEADER        Header;

+  EFI_GUID                 Guid;

+  //Optional Data Follows

+} EFI_IFR_GUID;

+

+typedef struct _EFI_IFR_REFRESH_ID {

+  EFI_IFR_OP_HEADER Header;

+  EFI_GUID          RefreshEventGroupId;

+} EFI_IFR_REFRESH_ID;

+

+typedef struct _EFI_IFR_DUP {

+  EFI_IFR_OP_HEADER        Header;

+} EFI_IFR_DUP;

+

+typedef struct _EFI_IFR_EQ_ID_ID {

+  EFI_IFR_OP_HEADER        Header;

+  EFI_QUESTION_ID          QuestionId1;

+  EFI_QUESTION_ID          QuestionId2;

+} EFI_IFR_EQ_ID_ID;

+

+typedef struct _EFI_IFR_EQ_ID_VAL {

+  EFI_IFR_OP_HEADER        Header;

+  EFI_QUESTION_ID          QuestionId;

+  UINT16                   Value;

+} EFI_IFR_EQ_ID_VAL;

+

+typedef struct _EFI_IFR_EQ_ID_VAL_LIST {

+  EFI_IFR_OP_HEADER        Header;

+  EFI_QUESTION_ID          QuestionId;

+  UINT16                   ListLength;

+  UINT16                   ValueList[1];

+} EFI_IFR_EQ_ID_VAL_LIST;

+

+typedef struct _EFI_IFR_UINT8 {

+  EFI_IFR_OP_HEADER        Header;

+  UINT8 Value;

+} EFI_IFR_UINT8;

+

+typedef struct _EFI_IFR_UINT16 {

+  EFI_IFR_OP_HEADER        Header;

+  UINT16                   Value;

+} EFI_IFR_UINT16;

+

+typedef struct _EFI_IFR_UINT32 {

+  EFI_IFR_OP_HEADER        Header;

+  UINT32                   Value;

+} EFI_IFR_UINT32;

+

+typedef struct _EFI_IFR_UINT64 {

+  EFI_IFR_OP_HEADER        Header;

+  UINT64 Value;

+} EFI_IFR_UINT64;

+

+typedef struct _EFI_IFR_QUESTION_REF1 {

+  EFI_IFR_OP_HEADER        Header;

+  EFI_QUESTION_ID          QuestionId;

+} EFI_IFR_QUESTION_REF1;

+

+typedef struct _EFI_IFR_QUESTION_REF2 {

+  EFI_IFR_OP_HEADER        Header;

+} EFI_IFR_QUESTION_REF2;

+

+typedef struct _EFI_IFR_QUESTION_REF3 {

+  EFI_IFR_OP_HEADER        Header;

+} EFI_IFR_QUESTION_REF3;

+

+typedef struct _EFI_IFR_QUESTION_REF3_2 {

+  EFI_IFR_OP_HEADER        Header;

+  EFI_STRING_ID            DevicePath;

+} EFI_IFR_QUESTION_REF3_2;

+

+typedef struct _EFI_IFR_QUESTION_REF3_3 {

+  EFI_IFR_OP_HEADER        Header;

+  EFI_STRING_ID            DevicePath;

+  EFI_GUID                 Guid;

+} EFI_IFR_QUESTION_REF3_3;

+

+typedef struct _EFI_IFR_RULE_REF {

+  EFI_IFR_OP_HEADER        Header;

+  UINT8                    RuleId;

+} EFI_IFR_RULE_REF;

+

+typedef struct _EFI_IFR_STRING_REF1 {

+  EFI_IFR_OP_HEADER        Header;

+  EFI_STRING_ID            StringId;

+} EFI_IFR_STRING_REF1;

+

+typedef struct _EFI_IFR_STRING_REF2 {

+  EFI_IFR_OP_HEADER        Header;

+} EFI_IFR_STRING_REF2;

+

+typedef struct _EFI_IFR_THIS {

+  EFI_IFR_OP_HEADER        Header;

+} EFI_IFR_THIS;

+

+typedef struct _EFI_IFR_TRUE {

+  EFI_IFR_OP_HEADER        Header;

+} EFI_IFR_TRUE;

+

+typedef struct _EFI_IFR_FALSE {

+  EFI_IFR_OP_HEADER        Header;

+} EFI_IFR_FALSE;

+

+typedef struct _EFI_IFR_ONE {

+  EFI_IFR_OP_HEADER        Header;

+} EFI_IFR_ONE;

+

+typedef struct _EFI_IFR_ONES {

+  EFI_IFR_OP_HEADER        Header;

+} EFI_IFR_ONES;

+

+typedef struct _EFI_IFR_ZERO {

+  EFI_IFR_OP_HEADER        Header;

+} EFI_IFR_ZERO;

+

+typedef struct _EFI_IFR_UNDEFINED {

+  EFI_IFR_OP_HEADER        Header;

+} EFI_IFR_UNDEFINED;

+

+typedef struct _EFI_IFR_VERSION {

+  EFI_IFR_OP_HEADER        Header;

+} EFI_IFR_VERSION;

+

+typedef struct _EFI_IFR_LENGTH {

+  EFI_IFR_OP_HEADER        Header;

+} EFI_IFR_LENGTH;

+

+typedef struct _EFI_IFR_NOT {

+  EFI_IFR_OP_HEADER        Header;

+} EFI_IFR_NOT;

+

+typedef struct _EFI_IFR_BITWISE_NOT {

+  EFI_IFR_OP_HEADER        Header;

+} EFI_IFR_BITWISE_NOT;

+

+typedef struct _EFI_IFR_TO_BOOLEAN {

+  EFI_IFR_OP_HEADER        Header;

+} EFI_IFR_TO_BOOLEAN;

+

+///

+/// For EFI_IFR_TO_STRING, when converting from

+/// unsigned integers, these flags control the format:

+/// 0 = unsigned decimal.

+/// 1 = signed decimal.

+/// 2 = hexadecimal (lower-case alpha).

+/// 3 = hexadecimal (upper-case alpha).

+///@{

+#define EFI_IFR_STRING_UNSIGNED_DEC      0

+#define EFI_IFR_STRING_SIGNED_DEC        1

+#define EFI_IFR_STRING_LOWERCASE_HEX     2

+#define EFI_IFR_STRING_UPPERCASE_HEX     3

+///@}

+

+///

+/// When converting from a buffer, these flags control the format:

+/// 0 = ASCII.

+/// 8 = Unicode.

+///@{

+#define EFI_IFR_STRING_ASCII             0

+#define EFI_IFR_STRING_UNICODE           8

+///@}

+

+typedef struct _EFI_IFR_TO_STRING {

+  EFI_IFR_OP_HEADER        Header;

+  UINT8                    Format;

+} EFI_IFR_TO_STRING;

+

+typedef struct _EFI_IFR_TO_UINT {

+  EFI_IFR_OP_HEADER        Header;

+} EFI_IFR_TO_UINT;

+

+typedef struct _EFI_IFR_TO_UPPER {

+  EFI_IFR_OP_HEADER        Header;

+} EFI_IFR_TO_UPPER;

+

+typedef struct _EFI_IFR_TO_LOWER {

+  EFI_IFR_OP_HEADER        Header;

+} EFI_IFR_TO_LOWER;

+

+typedef struct _EFI_IFR_ADD {

+  EFI_IFR_OP_HEADER        Header;

+} EFI_IFR_ADD;

+

+typedef struct _EFI_IFR_AND {

+  EFI_IFR_OP_HEADER        Header;

+} EFI_IFR_AND;

+

+typedef struct _EFI_IFR_BITWISE_AND {

+  EFI_IFR_OP_HEADER        Header;

+} EFI_IFR_BITWISE_AND;

+

+typedef struct _EFI_IFR_BITWISE_OR {

+  EFI_IFR_OP_HEADER        Header;

+} EFI_IFR_BITWISE_OR;

+

+typedef struct _EFI_IFR_CATENATE {

+  EFI_IFR_OP_HEADER        Header;

+} EFI_IFR_CATENATE;

+

+typedef struct _EFI_IFR_DIVIDE {

+  EFI_IFR_OP_HEADER        Header;

+} EFI_IFR_DIVIDE;

+

+typedef struct _EFI_IFR_EQUAL {

+  EFI_IFR_OP_HEADER        Header;

+} EFI_IFR_EQUAL;

+

+typedef struct _EFI_IFR_GREATER_EQUAL {

+  EFI_IFR_OP_HEADER        Header;

+} EFI_IFR_GREATER_EQUAL;

+

+typedef struct _EFI_IFR_GREATER_THAN {

+  EFI_IFR_OP_HEADER        Header;

+} EFI_IFR_GREATER_THAN;

+

+typedef struct _EFI_IFR_LESS_EQUAL {

+  EFI_IFR_OP_HEADER        Header;

+} EFI_IFR_LESS_EQUAL;

+

+typedef struct _EFI_IFR_LESS_THAN {

+  EFI_IFR_OP_HEADER        Header;

+} EFI_IFR_LESS_THAN;

+

+typedef struct _EFI_IFR_MATCH {

+  EFI_IFR_OP_HEADER        Header;

+} EFI_IFR_MATCH;

+

+typedef struct _EFI_IFR_MATCH2 {

+  EFI_IFR_OP_HEADER        Header;

+  EFI_GUID                 SyntaxType;

+} EFI_IFR_MATCH2;

+

+typedef struct _EFI_IFR_MULTIPLY {

+  EFI_IFR_OP_HEADER        Header;

+} EFI_IFR_MULTIPLY;

+

+typedef struct _EFI_IFR_MODULO {

+  EFI_IFR_OP_HEADER        Header;

+} EFI_IFR_MODULO;

+

+typedef struct _EFI_IFR_NOT_EQUAL {

+  EFI_IFR_OP_HEADER        Header;

+} EFI_IFR_NOT_EQUAL;

+

+typedef struct _EFI_IFR_OR {

+  EFI_IFR_OP_HEADER        Header;

+} EFI_IFR_OR;

+

+typedef struct _EFI_IFR_SHIFT_LEFT {

+  EFI_IFR_OP_HEADER        Header;

+} EFI_IFR_SHIFT_LEFT;

+

+typedef struct _EFI_IFR_SHIFT_RIGHT {

+  EFI_IFR_OP_HEADER        Header;

+} EFI_IFR_SHIFT_RIGHT;

+

+typedef struct _EFI_IFR_SUBTRACT {

+  EFI_IFR_OP_HEADER        Header;

+} EFI_IFR_SUBTRACT;

+

+typedef struct _EFI_IFR_CONDITIONAL {

+  EFI_IFR_OP_HEADER        Header;

+} EFI_IFR_CONDITIONAL;

+

+//

+// Flags governing the matching criteria of EFI_IFR_FIND

+//

+#define EFI_IFR_FF_CASE_SENSITIVE    0x00

+#define EFI_IFR_FF_CASE_INSENSITIVE  0x01

+

+typedef struct _EFI_IFR_FIND {

+  EFI_IFR_OP_HEADER        Header;

+  UINT8                    Format;

+} EFI_IFR_FIND;

+

+typedef struct _EFI_IFR_MID {

+  EFI_IFR_OP_HEADER        Header;

+} EFI_IFR_MID;

+

+typedef struct _EFI_IFR_TOKEN {

+  EFI_IFR_OP_HEADER        Header;

+} EFI_IFR_TOKEN;

+

+//

+// Flags specifying whether to find the first matching string

+// or the first non-matching string.

+//

+#define EFI_IFR_FLAGS_FIRST_MATCHING     0x00

+#define EFI_IFR_FLAGS_FIRST_NON_MATCHING 0x01

+

+typedef struct _EFI_IFR_SPAN {

+  EFI_IFR_OP_HEADER        Header;

+  UINT8                    Flags;

+} EFI_IFR_SPAN;

+

+typedef struct _EFI_IFR_SECURITY {

+  ///

+  /// Standard opcode header, where Header.Op = EFI_IFR_SECURITY_OP.

+  ///

+  EFI_IFR_OP_HEADER        Header;

+  ///

+  /// Security permission level.

+  ///

+  EFI_GUID                 Permissions;

+} EFI_IFR_SECURITY;

+

+typedef struct _EFI_IFR_FORM_MAP_METHOD {

+  ///

+  /// The string identifier which provides the human-readable name of

+  /// the configuration method for this standards map form.

+  ///

+  EFI_STRING_ID            MethodTitle;

+  ///

+  /// Identifier which uniquely specifies the configuration methods

+  /// associated with this standards map form.

+  ///

+  EFI_GUID                 MethodIdentifier;

+} EFI_IFR_FORM_MAP_METHOD;

+

+typedef struct _EFI_IFR_FORM_MAP {

+  ///

+  /// The sequence that defines the type of opcode as well as the length

+  /// of the opcode being defined. Header.OpCode = EFI_IFR_FORM_MAP_OP.

+  ///

+  EFI_IFR_OP_HEADER        Header;

+  ///

+  /// The unique identifier for this particular form.

+  ///

+  EFI_FORM_ID              FormId;

+  ///

+  /// One or more configuration method's name and unique identifier.

+  ///

+  // EFI_IFR_FORM_MAP_METHOD  Methods[];

+} EFI_IFR_FORM_MAP;

+

+typedef struct _EFI_IFR_SET {

+  ///

+  /// The sequence that defines the type of opcode as well as the length

+  /// of the opcode being defined. Header.OpCode = EFI_IFR_SET_OP.

+  ///

+  EFI_IFR_OP_HEADER  Header;

+  ///

+  /// Specifies the identifier of a previously declared variable store to

+  /// use when storing the question's value.

+  ///

+  EFI_VARSTORE_ID    VarStoreId;

+  union {

+    ///

+    /// A 16-bit Buffer Storage offset.

+    ///

+    EFI_STRING_ID    VarName;

+    ///

+    /// A Name Value or EFI Variable name (VarName).

+    ///

+    UINT16           VarOffset;

+  }                  VarStoreInfo;

+  ///

+  /// Specifies the type used for storage.

+  ///

+  UINT8              VarStoreType;

+} EFI_IFR_SET;

+

+typedef struct _EFI_IFR_GET {

+  ///

+  /// The sequence that defines the type of opcode as well as the length

+  /// of the opcode being defined. Header.OpCode = EFI_IFR_GET_OP.

+  ///

+  EFI_IFR_OP_HEADER  Header;

+  ///

+  /// Specifies the identifier of a previously declared variable store to

+  /// use when retrieving the value.

+  ///

+  EFI_VARSTORE_ID    VarStoreId;

+  union {

+    ///

+    /// A 16-bit Buffer Storage offset.

+    ///

+    EFI_STRING_ID    VarName;

+    ///

+    /// A Name Value or EFI Variable name (VarName).

+    ///

+    UINT16           VarOffset;

+  }                  VarStoreInfo;

+  ///

+  /// Specifies the type used for storage.

+  ///

+  UINT8              VarStoreType;

+} EFI_IFR_GET;

+

+typedef struct _EFI_IFR_READ {

+  EFI_IFR_OP_HEADER       Header;

+} EFI_IFR_READ;

+

+typedef struct _EFI_IFR_WRITE {

+  EFI_IFR_OP_HEADER      Header;

+} EFI_IFR_WRITE;

+

+typedef struct _EFI_IFR_MAP {

+  EFI_IFR_OP_HEADER      Header;

+} EFI_IFR_MAP;

+//

+// Definitions for Keyboard Package

+// Releated definitions are in Section of EFI_HII_DATABASE_PROTOCOL

+//

+

+///

+/// Each enumeration values maps a physical key on a keyboard.

+///

+typedef enum {

+  EfiKeyLCtrl,

+  EfiKeyA0,

+  EfiKeyLAlt,

+  EfiKeySpaceBar,

+  EfiKeyA2,

+  EfiKeyA3,

+  EfiKeyA4,

+  EfiKeyRCtrl,

+  EfiKeyLeftArrow,

+  EfiKeyDownArrow,

+  EfiKeyRightArrow,

+  EfiKeyZero,

+  EfiKeyPeriod,

+  EfiKeyEnter,

+  EfiKeyLShift,

+  EfiKeyB0,

+  EfiKeyB1,

+  EfiKeyB2,

+  EfiKeyB3,

+  EfiKeyB4,

+  EfiKeyB5,

+  EfiKeyB6,

+  EfiKeyB7,

+  EfiKeyB8,

+  EfiKeyB9,

+  EfiKeyB10,

+  EfiKeyRShift,

+  EfiKeyUpArrow,

+  EfiKeyOne,

+  EfiKeyTwo,

+  EfiKeyThree,

+  EfiKeyCapsLock,

+  EfiKeyC1,

+  EfiKeyC2,

+  EfiKeyC3,

+  EfiKeyC4,

+  EfiKeyC5,

+  EfiKeyC6,

+  EfiKeyC7,

+  EfiKeyC8,

+  EfiKeyC9,

+  EfiKeyC10,

+  EfiKeyC11,

+  EfiKeyC12,

+  EfiKeyFour,

+  EfiKeyFive,

+  EfiKeySix,

+  EfiKeyPlus,

+  EfiKeyTab,

+  EfiKeyD1,

+  EfiKeyD2,

+  EfiKeyD3,

+  EfiKeyD4,

+  EfiKeyD5,

+  EfiKeyD6,

+  EfiKeyD7,

+  EfiKeyD8,

+  EfiKeyD9,

+  EfiKeyD10,

+  EfiKeyD11,

+  EfiKeyD12,

+  EfiKeyD13,

+  EfiKeyDel,

+  EfiKeyEnd,

+  EfiKeyPgDn,

+  EfiKeySeven,

+  EfiKeyEight,

+  EfiKeyNine,

+  EfiKeyE0,

+  EfiKeyE1,

+  EfiKeyE2,

+  EfiKeyE3,

+  EfiKeyE4,

+  EfiKeyE5,

+  EfiKeyE6,

+  EfiKeyE7,

+  EfiKeyE8,

+  EfiKeyE9,

+  EfiKeyE10,

+  EfiKeyE11,

+  EfiKeyE12,

+  EfiKeyBackSpace,

+  EfiKeyIns,

+  EfiKeyHome,

+  EfiKeyPgUp,

+  EfiKeyNLck,

+  EfiKeySlash,

+  EfiKeyAsterisk,

+  EfiKeyMinus,

+  EfiKeyEsc,

+  EfiKeyF1,

+  EfiKeyF2,

+  EfiKeyF3,

+  EfiKeyF4,

+  EfiKeyF5,

+  EfiKeyF6,

+  EfiKeyF7,

+  EfiKeyF8,

+  EfiKeyF9,

+  EfiKeyF10,

+  EfiKeyF11,

+  EfiKeyF12,

+  EfiKeyPrint,

+  EfiKeySLck,

+  EfiKeyPause

+} EFI_KEY;

+

+typedef struct {

+  ///

+  /// Used to describe a physical key on a keyboard.

+  ///

+  EFI_KEY                 Key;

+  ///

+  /// Unicode character code for the Key.

+  ///

+  CHAR16                  Unicode;

+  ///

+  /// Unicode character code for the key with the shift key being held down.

+  ///

+  CHAR16                  ShiftedUnicode;

+  ///

+  /// Unicode character code for the key with the Alt-GR being held down.

+  ///

+  CHAR16                  AltGrUnicode;

+  ///

+  /// Unicode character code for the key with the Alt-GR and shift keys being held down.

+  ///

+  CHAR16                  ShiftedAltGrUnicode;

+  ///

+  /// Modifier keys are defined to allow for special functionality that is not necessarily

+  /// accomplished by a printable character. Many of these modifier keys are flags to toggle

+  /// certain state bits on and off inside of a keyboard driver.

+  ///

+  UINT16                  Modifier;

+  UINT16                  AffectedAttribute;

+} EFI_KEY_DESCRIPTOR;

+

+///

+/// A key which is affected by all the standard shift modifiers.

+/// Most keys would be expected to have this bit active.

+///

+#define EFI_AFFECTED_BY_STANDARD_SHIFT       0x0001

+

+///

+/// This key is affected by the caps lock so that if a keyboard driver

+/// would need to disambiguate between a key which had a "1" defined

+/// versus an "a" character.  Having this bit turned on would tell

+/// the keyboard driver to use the appropriate shifted state or not.

+///

+#define EFI_AFFECTED_BY_CAPS_LOCK            0x0002

+

+///

+/// Similar to the case of CAPS lock, if this bit is active, the key

+/// is affected by the num lock being turned on.

+///

+#define EFI_AFFECTED_BY_NUM_LOCK             0x0004

+

+typedef struct {

+  UINT16                  LayoutLength;

+  EFI_GUID                Guid;

+  UINT32                  LayoutDescriptorStringOffset;

+  UINT8                   DescriptorCount;

+  // EFI_KEY_DESCRIPTOR    Descriptors[];

+} EFI_HII_KEYBOARD_LAYOUT;

+

+typedef struct {

+  EFI_HII_PACKAGE_HEADER  Header;

+  UINT16                  LayoutCount;

+  // EFI_HII_KEYBOARD_LAYOUT Layout[];

+} EFI_HII_KEYBOARD_PACKAGE_HDR;

+

+//

+// Modifier values

+//

+#define EFI_NULL_MODIFIER                0x0000

+#define EFI_LEFT_CONTROL_MODIFIER        0x0001

+#define EFI_RIGHT_CONTROL_MODIFIER       0x0002

+#define EFI_LEFT_ALT_MODIFIER            0x0003

+#define EFI_RIGHT_ALT_MODIFIER           0x0004

+#define EFI_ALT_GR_MODIFIER              0x0005

+#define EFI_INSERT_MODIFIER              0x0006

+#define EFI_DELETE_MODIFIER              0x0007

+#define EFI_PAGE_DOWN_MODIFIER           0x0008

+#define EFI_PAGE_UP_MODIFIER             0x0009

+#define EFI_HOME_MODIFIER                0x000A

+#define EFI_END_MODIFIER                 0x000B

+#define EFI_LEFT_SHIFT_MODIFIER          0x000C

+#define EFI_RIGHT_SHIFT_MODIFIER         0x000D

+#define EFI_CAPS_LOCK_MODIFIER           0x000E

+#define EFI_NUM_LOCK_MODIFIER            0x000F

+#define EFI_LEFT_ARROW_MODIFIER          0x0010

+#define EFI_RIGHT_ARROW_MODIFIER         0x0011

+#define EFI_DOWN_ARROW_MODIFIER          0x0012

+#define EFI_UP_ARROW_MODIFIER            0x0013

+#define EFI_NS_KEY_MODIFIER              0x0014

+#define EFI_NS_KEY_DEPENDENCY_MODIFIER   0x0015

+#define EFI_FUNCTION_KEY_ONE_MODIFIER    0x0016

+#define EFI_FUNCTION_KEY_TWO_MODIFIER    0x0017

+#define EFI_FUNCTION_KEY_THREE_MODIFIER  0x0018

+#define EFI_FUNCTION_KEY_FOUR_MODIFIER   0x0019

+#define EFI_FUNCTION_KEY_FIVE_MODIFIER   0x001A

+#define EFI_FUNCTION_KEY_SIX_MODIFIER    0x001B

+#define EFI_FUNCTION_KEY_SEVEN_MODIFIER  0x001C

+#define EFI_FUNCTION_KEY_EIGHT_MODIFIER  0x001D

+#define EFI_FUNCTION_KEY_NINE_MODIFIER   0x001E

+#define EFI_FUNCTION_KEY_TEN_MODIFIER    0x001F

+#define EFI_FUNCTION_KEY_ELEVEN_MODIFIER 0x0020

+#define EFI_FUNCTION_KEY_TWELVE_MODIFIER 0x0021

+

+//

+// Keys that have multiple control functions based on modifier

+// settings are handled in the keyboard driver implementation.

+// For instance, PRINT_KEY might have a modifier held down and

+// is still a nonprinting character, but might have an alternate

+// control function like SYSREQUEST

+//

+#define EFI_PRINT_MODIFIER               0x0022

+#define EFI_SYS_REQUEST_MODIFIER         0x0023

+#define EFI_SCROLL_LOCK_MODIFIER         0x0024

+#define EFI_PAUSE_MODIFIER               0x0025

+#define EFI_BREAK_MODIFIER               0x0026

+

+#define EFI_LEFT_LOGO_MODIFIER           0x0027

+#define EFI_RIGHT_LOGO_MODIFIER          0x0028

+#define EFI_MENU_MODIFIER                0x0029

+

+///

+/// Animation IFR opcode

+///

+typedef struct _EFI_IFR_ANIMATION {

+  ///

+  /// Standard opcode header, where Header.OpCode is

+  /// EFI_IFR_ANIMATION_OP.

+  ///

+  EFI_IFR_OP_HEADER        Header;

+  ///

+  /// Animation identifier in the HII database.

+  ///

+  EFI_ANIMATION_ID         Id;

+} EFI_IFR_ANIMATION;

+

+///

+/// HII animation package header.

+///

+typedef struct _EFI_HII_ANIMATION_PACKAGE_HDR {

+  ///

+  /// Standard package header, where Header.Type = EFI_HII_PACKAGE_ANIMATIONS.

+  ///

+  EFI_HII_PACKAGE_HEADER  Header;

+  ///

+  /// Offset, relative to this header, of the animation information. If

+  /// this is zero, then there are no animation sequences in the package.

+  ///

+  UINT32                  AnimationInfoOffset;

+} EFI_HII_ANIMATION_PACKAGE_HDR;

+

+///

+/// Animation information is encoded as a series of blocks,

+/// with each block prefixed by a single byte header EFI_HII_ANIMATION_BLOCK.

+///

+typedef struct _EFI_HII_ANIMATION_BLOCK {

+  UINT8  BlockType;

+  //UINT8  BlockBody[];

+} EFI_HII_ANIMATION_BLOCK;

+

+///

+/// Animation block types.

+///

+#define EFI_HII_AIBT_END                 0x00

+#define EFI_HII_AIBT_OVERLAY_IMAGES      0x10

+#define EFI_HII_AIBT_CLEAR_IMAGES        0x11

+#define EFI_HII_AIBT_RESTORE_SCRN        0x12

+#define EFI_HII_AIBT_OVERLAY_IMAGES_LOOP 0x18

+#define EFI_HII_AIBT_CLEAR_IMAGES_LOOP   0x19

+#define EFI_HII_AIBT_RESTORE_SCRN_LOOP   0x1A

+#define EFI_HII_AIBT_DUPLICATE           0x20

+#define EFI_HII_AIBT_SKIP2               0x21

+#define EFI_HII_AIBT_SKIP1               0x22

+#define EFI_HII_AIBT_EXT1                0x30

+#define EFI_HII_AIBT_EXT2                0x31

+#define EFI_HII_AIBT_EXT4                0x32

+

+///

+/// Extended block headers used for variable sized animation records

+/// which need an explicit length.

+///

+

+typedef struct _EFI_HII_AIBT_EXT1_BLOCK  {

+  ///

+  /// Standard animation header, where Header.BlockType = EFI_HII_AIBT_EXT1.

+  ///

+  EFI_HII_ANIMATION_BLOCK  Header;

+  ///

+  /// The block type.

+  ///

+  UINT8                    BlockType2;

+  ///

+  /// Size of the animation block, in bytes, including the animation block header.

+  ///

+  UINT8                    Length;

+} EFI_HII_AIBT_EXT1_BLOCK;

+

+typedef struct _EFI_HII_AIBT_EXT2_BLOCK {

+  ///

+  /// Standard animation header, where Header.BlockType = EFI_HII_AIBT_EXT2.

+  ///

+  EFI_HII_ANIMATION_BLOCK  Header;

+  ///

+  /// The block type

+  ///

+  UINT8                    BlockType2;

+  ///

+  /// Size of the animation block, in bytes, including the animation block header.

+  ///

+  UINT16                   Length;

+} EFI_HII_AIBT_EXT2_BLOCK;

+

+typedef struct _EFI_HII_AIBT_EXT4_BLOCK {

+  ///

+  /// Standard animation header, where Header.BlockType = EFI_HII_AIBT_EXT4.

+  ///

+  EFI_HII_ANIMATION_BLOCK  Header;

+  ///

+  /// The block type

+  ///

+  UINT8                    BlockType2;

+  ///

+  /// Size of the animation block, in bytes, including the animation block header.

+  ///

+  UINT32                   Length;

+} EFI_HII_AIBT_EXT4_BLOCK;

+

+typedef struct _EFI_HII_ANIMATION_CELL {

+  ///

+  /// The X offset from the upper left hand corner of the logical

+  /// window to position the indexed image.

+  ///

+  UINT16                    OffsetX;

+  ///

+  /// The Y offset from the upper left hand corner of the logical

+  /// window to position the indexed image.

+  ///

+  UINT16                    OffsetY;

+  ///

+  /// The image to display at the specified offset from the upper left

+  /// hand corner of the logical window.

+  ///

+  EFI_IMAGE_ID              ImageId;

+  ///

+  /// The number of milliseconds to delay after displaying the indexed

+  /// image and before continuing on to the next linked image.  If value

+  /// is zero, no delay.

+  ///

+  UINT16                    Delay;

+} EFI_HII_ANIMATION_CELL;

+

+///

+/// An animation block to describe an animation sequence that does not cycle, and

+/// where one image is simply displayed over the previous image.

+///

+typedef struct _EFI_HII_AIBT_OVERLAY_IMAGES_BLOCK {

+  ///

+  /// This is image that is to be reference by the image protocols, if the

+  /// animation function is not supported or disabled. This image can

+  /// be one particular image from the animation sequence (if any one

+  /// of the animation frames has a complete image) or an alternate

+  /// image that can be displayed alone. If the value is zero, no image

+  /// is displayed.

+  ///

+  EFI_IMAGE_ID            DftImageId;

+  ///

+  /// The overall width of the set of images (logical window width).

+  ///

+  UINT16                  Width;

+  ///

+  /// The overall height of the set of images (logical window height).

+  ///

+  UINT16                  Height;

+  ///

+  /// The number of EFI_HII_ANIMATION_CELL contained in the

+  /// animation sequence.

+  ///

+  UINT16                  CellCount;

+  ///

+  /// An array of CellCount animation cells.

+  ///

+  EFI_HII_ANIMATION_CELL  AnimationCell[1];

+} EFI_HII_AIBT_OVERLAY_IMAGES_BLOCK;

+

+///

+/// An animation block to describe an animation sequence that does not cycle,

+/// and where the logical window is cleared to the specified color before

+/// the next image is displayed.

+///

+typedef struct _EFI_HII_AIBT_CLEAR_IMAGES_BLOCK {

+  ///

+  /// This is image that is to be reference by the image protocols, if the

+  /// animation function is not supported or disabled. This image can

+  /// be one particular image from the animation sequence (if any one

+  /// of the animation frames has a complete image) or an alternate

+  /// image that can be displayed alone. If the value is zero, no image

+  /// is displayed.

+  ///

+  EFI_IMAGE_ID       DftImageId;

+  ///

+  /// The overall width of the set of images (logical window width).

+  ///

+  UINT16             Width;

+  ///

+  /// The overall height of the set of images (logical window height).

+  ///

+  UINT16             Height;

+  ///

+  /// The number of EFI_HII_ANIMATION_CELL contained in the

+  /// animation sequence.

+  ///

+  UINT16             CellCount;

+  ///

+  /// The color to clear the logical window to before displaying the

+  /// indexed image.

+  ///

+  EFI_HII_RGB_PIXEL  BackgndColor;

+  ///

+  /// An array of CellCount animation cells.

+  ///

+  EFI_HII_ANIMATION_CELL AnimationCell[1];

+} EFI_HII_AIBT_CLEAR_IMAGES_BLOCK;

+

+///

+/// An animation block to describe an animation sequence that does not cycle,

+/// and where the screen is restored to the original state before the next

+/// image is displayed.

+///

+typedef struct _EFI_HII_AIBT_RESTORE_SCRN_BLOCK {

+  ///

+  /// This is image that is to be reference by the image protocols, if the

+  /// animation function is not supported or disabled. This image can

+  /// be one particular image from the animation sequence (if any one

+  /// of the animation frames has a complete image) or an alternate

+  /// image that can be displayed alone. If the value is zero, no image

+  /// is displayed.

+  ///

+  EFI_IMAGE_ID            DftImageId;

+  ///

+  /// The overall width of the set of images (logical window width).

+  ///

+  UINT16                  Width;

+  ///

+  /// The overall height of the set of images (logical window height).

+  ///

+  UINT16                  Height;

+  ///

+  /// The number of EFI_HII_ANIMATION_CELL contained in the

+  /// animation sequence.

+  ///

+  UINT16                  CellCount;

+  ///

+  /// An array of CellCount animation cells.

+  ///

+  EFI_HII_ANIMATION_CELL  AnimationCell[1];

+} EFI_HII_AIBT_RESTORE_SCRN_BLOCK;

+

+///

+/// An animation block to describe an animation sequence that continuously cycles,

+/// and where one image is simply displayed over the previous image.

+///

+typedef EFI_HII_AIBT_OVERLAY_IMAGES_BLOCK  EFI_HII_AIBT_OVERLAY_IMAGES_LOOP_BLOCK;

+

+///

+/// An animation block to describe an animation sequence that continuously cycles,

+/// and where the logical window is cleared to the specified color before

+/// the next image is displayed.

+///

+typedef EFI_HII_AIBT_CLEAR_IMAGES_BLOCK    EFI_HII_AIBT_CLEAR_IMAGES_LOOP_BLOCK;

+

+///

+/// An animation block to describe an animation sequence that continuously cycles,

+/// and where the screen is restored to the original state before

+/// the next image is displayed.

+///

+typedef EFI_HII_AIBT_RESTORE_SCRN_BLOCK    EFI_HII_AIBT_RESTORE_SCRN_LOOP_BLOCK;

+

+///

+/// Assigns a new character value to a previously defined animation sequence.

+///

+typedef struct _EFI_HII_AIBT_DUPLICATE_BLOCK {

+  ///

+  /// The previously defined animation ID with the exact same

+  /// animation information.

+  ///

+  EFI_ANIMATION_ID  AnimationId;

+} EFI_HII_AIBT_DUPLICATE_BLOCK;

+

+///

+/// Skips animation IDs.

+///

+typedef struct _EFI_HII_AIBT_SKIP1_BLOCK {

+  ///

+  /// The unsigned 8-bit value to add to AnimationIdCurrent.

+  ///

+  UINT8  SkipCount;

+} EFI_HII_AIBT_SKIP1_BLOCK;

+

+///

+/// Skips animation IDs.

+///

+typedef struct _EFI_HII_AIBT_SKIP2_BLOCK {

+  ///

+  /// The unsigned 16-bit value to add to AnimationIdCurrent.

+  ///

+  UINT16  SkipCount;

+} EFI_HII_AIBT_SKIP2_BLOCK;

+

+#pragma pack()

+

+

+

+///

+/// References to string tokens must use this macro to enable scanning for

+/// token usages.

+///

+///

+/// STRING_TOKEN is not defined in UEFI specification. But it is placed

+/// here for the easy access by C files and VFR source files.

+///

+#define STRING_TOKEN(t) t

+

+///

+/// IMAGE_TOKEN is not defined in UEFI specification. But it is placed

+/// here for the easy access by C files and VFR source files.

+///

+#define IMAGE_TOKEN(t) t

+

+#endif

diff --git a/debugging_demo/memtest86+/efi/Include/Uefi/UefiMultiPhase.h b/debugging_demo/memtest86+/efi/Include/Uefi/UefiMultiPhase.h
new file mode 100644
index 0000000..50e4d70
--- /dev/null
+++ b/debugging_demo/memtest86+/efi/Include/Uefi/UefiMultiPhase.h
@@ -0,0 +1,229 @@
+/** @file

+  This includes some definitions introduced in UEFI that will be used in both PEI and DXE phases.

+

+Copyright (c) 2006 - 2018, Intel Corporation. All rights reserved.<BR>

+SPDX-License-Identifier: BSD-2-Clause-Patent

+

+**/

+

+#ifndef __UEFI_MULTIPHASE_H__

+#define __UEFI_MULTIPHASE_H__

+

+///

+/// Attributes of variable.

+///

+#define EFI_VARIABLE_NON_VOLATILE                            0x00000001

+#define EFI_VARIABLE_BOOTSERVICE_ACCESS                      0x00000002

+#define EFI_VARIABLE_RUNTIME_ACCESS                          0x00000004

+///

+/// This attribute is identified by the mnemonic 'HR'

+/// elsewhere in this specification.

+///

+#define EFI_VARIABLE_HARDWARE_ERROR_RECORD                   0x00000008

+///

+/// Attributes of Authenticated Variable

+///

+#define EFI_VARIABLE_TIME_BASED_AUTHENTICATED_WRITE_ACCESS   0x00000020

+#define EFI_VARIABLE_APPEND_WRITE                            0x00000040

+///

+/// NOTE: EFI_VARIABLE_AUTHENTICATED_WRITE_ACCESS is deprecated and should be considered reserved.

+///

+#define EFI_VARIABLE_AUTHENTICATED_WRITE_ACCESS              0x00000010

+

+#ifndef VFRCOMPILE

+#include <Guid/WinCertificate.h>

+///

+/// Enumeration of memory types introduced in UEFI.

+///

+typedef enum {

+  ///

+  /// Not used.

+  ///

+  EfiReservedMemoryType,

+  ///

+  /// The code portions of a loaded application.

+  /// (Note that UEFI OS loaders are UEFI applications.)

+  ///

+  EfiLoaderCode,

+  ///

+  /// The data portions of a loaded application and the default data allocation

+  /// type used by an application to allocate pool memory.

+  ///

+  EfiLoaderData,

+  ///

+  /// The code portions of a loaded Boot Services Driver.

+  ///

+  EfiBootServicesCode,

+  ///

+  /// The data portions of a loaded Boot Serves Driver, and the default data

+  /// allocation type used by a Boot Services Driver to allocate pool memory.

+  ///

+  EfiBootServicesData,

+  ///

+  /// The code portions of a loaded Runtime Services Driver.

+  ///

+  EfiRuntimeServicesCode,

+  ///

+  /// The data portions of a loaded Runtime Services Driver and the default

+  /// data allocation type used by a Runtime Services Driver to allocate pool memory.

+  ///

+  EfiRuntimeServicesData,

+  ///

+  /// Free (unallocated) memory.

+  ///

+  EfiConventionalMemory,

+  ///

+  /// Memory in which errors have been detected.

+  ///

+  EfiUnusableMemory,

+  ///

+  /// Memory that holds the ACPI tables.

+  ///

+  EfiACPIReclaimMemory,

+  ///

+  /// Address space reserved for use by the firmware.

+  ///

+  EfiACPIMemoryNVS,

+  ///

+  /// Used by system firmware to request that a memory-mapped IO region

+  /// be mapped by the OS to a virtual address so it can be accessed by EFI runtime services.

+  ///

+  EfiMemoryMappedIO,

+  ///

+  /// System memory-mapped IO region that is used to translate memory

+  /// cycles to IO cycles by the processor.

+  ///

+  EfiMemoryMappedIOPortSpace,

+  ///

+  /// Address space reserved by the firmware for code that is part of the processor.

+  ///

+  EfiPalCode,

+  ///

+  /// A memory region that operates as EfiConventionalMemory,

+  /// however it happens to also support byte-addressable non-volatility.

+  ///

+  EfiPersistentMemory,

+  EfiMaxMemoryType

+} EFI_MEMORY_TYPE;

+

+///

+/// Enumeration of reset types.

+///

+typedef enum {

+  ///

+  /// Used to induce a system-wide reset. This sets all circuitry within the

+  /// system to its initial state.  This type of reset is asynchronous to system

+  /// operation and operates withgout regard to cycle boundaries.  EfiColdReset

+  /// is tantamount to a system power cycle.

+  ///

+  EfiResetCold,

+  ///

+  /// Used to induce a system-wide initialization. The processors are set to their

+  /// initial state, and pending cycles are not corrupted.  If the system does

+  /// not support this reset type, then an EfiResetCold must be performed.

+  ///

+  EfiResetWarm,

+  ///

+  /// Used to induce an entry into a power state equivalent to the ACPI G2/S5 or G3

+  /// state.  If the system does not support this reset type, then when the system

+  /// is rebooted, it should exhibit the EfiResetCold attributes.

+  ///

+  EfiResetShutdown,

+  ///

+  /// Used to induce a system-wide 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.

+  ///

+  EfiResetPlatformSpecific

+} EFI_RESET_TYPE;

+

+///

+/// Data structure that precedes all of the standard EFI table types.

+///

+typedef struct {

+  ///

+  /// A 64-bit signature that identifies the type of table that follows.

+  /// Unique signatures have been generated for the EFI System Table,

+  /// the EFI Boot Services Table, and the EFI Runtime Services Table.

+  ///

+  UINT64  Signature;

+  ///

+  /// The revision of the EFI Specification to which this table

+  /// conforms. The upper 16 bits of this field contain the major

+  /// revision value, and the lower 16 bits contain the minor revision

+  /// value. The minor revision values are limited to the range of 00..99.

+  ///

+  UINT32  Revision;

+  ///

+  /// The size, in bytes, of the entire table including the EFI_TABLE_HEADER.

+  ///

+  UINT32  HeaderSize;

+  ///

+  /// The 32-bit CRC for the entire table. This value is computed by

+  /// setting this field to 0, and computing the 32-bit CRC for HeaderSize bytes.

+  ///

+  UINT32  CRC32;

+  ///

+  /// Reserved field that must be set to 0.

+  ///

+  UINT32  Reserved;

+} EFI_TABLE_HEADER;

+

+///

+/// AuthInfo is a WIN_CERTIFICATE using the wCertificateType

+/// WIN_CERTIFICATE_UEFI_GUID and the CertType

+/// EFI_CERT_TYPE_RSA2048_SHA256_GUID. If the attribute specifies

+/// authenticated access, then the Data buffer should begin with an

+/// authentication descriptor prior to the data payload and DataSize

+/// should reflect the the data.and descriptor size. The caller

+/// shall digest the Monotonic Count value and the associated data

+/// for the variable update using the SHA-256 1-way hash algorithm.

+/// The ensuing the 32-byte digest will be signed using the private

+/// key associated w/ the public/private 2048-bit RSA key-pair. The

+/// WIN_CERTIFICATE shall be used to describe the signature of the

+/// Variable data *Data. In addition, the signature will also

+/// include the MonotonicCount value to guard against replay attacks.

+///

+typedef struct {

+  ///

+  /// Included in the signature of

+  /// AuthInfo.Used to ensure freshness/no

+  /// replay. Incremented during each

+  /// "Write" access.

+  ///

+  UINT64                      MonotonicCount;

+  ///

+  /// Provides the authorization for the variable

+  /// access. It is a signature across the

+  /// variable data and the  Monotonic Count

+  /// value. Caller uses Private key that is

+  /// associated with a public key that has been

+  /// provisioned via the key exchange.

+  ///

+  WIN_CERTIFICATE_UEFI_GUID   AuthInfo;

+} EFI_VARIABLE_AUTHENTICATION;

+

+///

+/// When the attribute EFI_VARIABLE_TIME_BASED_AUTHENTICATED_WRITE_ACCESS is

+/// set, then the Data buffer shall begin with an instance of a complete (and serialized)

+/// EFI_VARIABLE_AUTHENTICATION_2 descriptor. The descriptor shall be followed by the new

+/// variable value and DataSize shall reflect the combined size of the descriptor and the new

+/// variable value. The authentication descriptor is not part of the variable data and is not

+/// returned by subsequent calls to GetVariable().

+///

+typedef struct {

+  ///

+  /// For the TimeStamp value, components Pad1, Nanosecond, TimeZone, Daylight and

+  /// Pad2 shall be set to 0. This means that the time shall always be expressed in GMT.

+  ///

+  EFI_TIME                    TimeStamp;

+  ///

+  /// Only a CertType of  EFI_CERT_TYPE_PKCS7_GUID is accepted.

+  ///

+  WIN_CERTIFICATE_UEFI_GUID   AuthInfo;

+ } EFI_VARIABLE_AUTHENTICATION_2;

+#endif // VFRCOMPILE

+

+#endif

diff --git a/debugging_demo/memtest86+/efi/Include/Uefi/UefiPxe.h b/debugging_demo/memtest86+/efi/Include/Uefi/UefiPxe.h
new file mode 100644
index 0000000..6b63c0e
--- /dev/null
+++ b/debugging_demo/memtest86+/efi/Include/Uefi/UefiPxe.h
@@ -0,0 +1,1786 @@
+/** @file

+  This header file contains all of the PXE type definitions,

+  structure prototypes, global variables and constants that

+  are needed for porting PXE to EFI.

+

+Copyright (c) 2006 - 2018, Intel Corporation. All rights reserved.<BR>

+SPDX-License-Identifier: BSD-2-Clause-Patent

+

+  @par Revision Reference:

+  32/64-bit PXE specification:

+  alpha-4, 99-Dec-17.

+

+**/

+

+#ifndef __EFI_PXE_H__

+#define __EFI_PXE_H__

+

+#pragma pack(1)

+

+#define PXE_BUSTYPE(a, b, c, d) \

+    ( \

+      (((PXE_UINT32) (d) & 0xFF) << 24) | (((PXE_UINT32) (c) & 0xFF) << 16) | (((PXE_UINT32) (b) & 0xFF) << 8) | \

+        ((PXE_UINT32) (a) & 0xFF) \

+    )

+

+///

+/// UNDI ROM ID and devive ID signature.

+///

+#define PXE_BUSTYPE_PXE PXE_BUSTYPE ('!', 'P', 'X', 'E')

+

+///

+/// BUS ROM ID signatures.

+///

+#define PXE_BUSTYPE_PCI     PXE_BUSTYPE ('P', 'C', 'I', 'R')

+#define PXE_BUSTYPE_PC_CARD PXE_BUSTYPE ('P', 'C', 'C', 'R')

+#define PXE_BUSTYPE_USB     PXE_BUSTYPE ('U', 'S', 'B', 'R')

+#define PXE_BUSTYPE_1394    PXE_BUSTYPE ('1', '3', '9', '4')

+

+#define PXE_SWAP_UINT16(n)  ((((PXE_UINT16) (n) & 0x00FF) << 8) | (((PXE_UINT16) (n) & 0xFF00) >> 8))

+

+#define PXE_SWAP_UINT32(n) \

+  ((((PXE_UINT32)(n) & 0x000000FF) << 24) | \

+   (((PXE_UINT32)(n) & 0x0000FF00) << 8)  | \

+   (((PXE_UINT32)(n) & 0x00FF0000) >> 8)  | \

+   (((PXE_UINT32)(n) & 0xFF000000) >> 24))

+

+#define PXE_SWAP_UINT64(n) \

+  ((((PXE_UINT64)(n) & 0x00000000000000FFULL) << 56) | \

+   (((PXE_UINT64)(n) & 0x000000000000FF00ULL) << 40) | \

+   (((PXE_UINT64)(n) & 0x0000000000FF0000ULL) << 24) | \

+   (((PXE_UINT64)(n) & 0x00000000FF000000ULL) << 8)  | \

+   (((PXE_UINT64)(n) & 0x000000FF00000000ULL) >> 8)  | \

+   (((PXE_UINT64)(n) & 0x0000FF0000000000ULL) >> 24) | \

+   (((PXE_UINT64)(n) & 0x00FF000000000000ULL) >> 40) | \

+   (((PXE_UINT64)(n) & 0xFF00000000000000ULL) >> 56))

+

+

+#define PXE_CPBSIZE_NOT_USED  0               ///< zero

+#define PXE_DBSIZE_NOT_USED   0               ///< zero

+#define PXE_CPBADDR_NOT_USED  (PXE_UINT64) 0  ///< zero

+#define PXE_DBADDR_NOT_USED   (PXE_UINT64) 0  ///< zero

+#define PXE_CONST             CONST

+

+#define PXE_VOLATILE          volatile

+

+typedef VOID           PXE_VOID;

+typedef UINT8          PXE_UINT8;

+typedef UINT16         PXE_UINT16;

+typedef UINT32         PXE_UINT32;

+typedef UINTN          PXE_UINTN;

+

+///

+/// Typedef unsigned long PXE_UINT64.

+///

+typedef UINT64      PXE_UINT64;

+

+typedef PXE_UINT8 PXE_BOOL;

+#define PXE_FALSE 0            ///< zero

+#define PXE_TRUE  (!PXE_FALSE)

+

+typedef PXE_UINT16      PXE_OPCODE;

+

+///

+/// Return UNDI operational state.

+///

+#define PXE_OPCODE_GET_STATE  0x0000

+

+///

+/// Change UNDI operational state from Stopped to Started.

+///

+#define PXE_OPCODE_START  0x0001

+

+///

+/// Change UNDI operational state from Started to Stopped.

+///

+#define PXE_OPCODE_STOP 0x0002

+

+///

+/// Get UNDI initialization information.

+///

+#define PXE_OPCODE_GET_INIT_INFO  0x0003

+

+///

+/// Get NIC configuration information.

+///

+#define PXE_OPCODE_GET_CONFIG_INFO  0x0004

+

+///

+/// Changed UNDI operational state from Started to Initialized.

+///

+#define PXE_OPCODE_INITIALIZE 0x0005

+

+///

+/// Re-initialize the NIC H/W.

+///

+#define PXE_OPCODE_RESET  0x0006

+

+///

+/// Change the UNDI operational state from Initialized to Started.

+///

+#define PXE_OPCODE_SHUTDOWN 0x0007

+

+///

+/// Read & change state of external interrupt enables.

+///

+#define PXE_OPCODE_INTERRUPT_ENABLES  0x0008

+

+///

+/// Read & change state of packet receive filters.

+///

+#define PXE_OPCODE_RECEIVE_FILTERS  0x0009

+

+///

+/// Read & change station MAC address.

+///

+#define PXE_OPCODE_STATION_ADDRESS  0x000A

+

+///

+/// Read traffic statistics.

+///

+#define PXE_OPCODE_STATISTICS 0x000B

+

+///

+/// Convert multicast IP address to multicast MAC address.

+///

+#define PXE_OPCODE_MCAST_IP_TO_MAC  0x000C

+

+///

+/// Read or change non-volatile storage on the NIC.

+///

+#define PXE_OPCODE_NVDATA 0x000D

+

+///

+/// Get & clear interrupt status.

+///

+#define PXE_OPCODE_GET_STATUS 0x000E

+

+///

+/// Fill media header in packet for transmit.

+///

+#define PXE_OPCODE_FILL_HEADER  0x000F

+

+///

+/// Transmit packet(s).

+///

+#define PXE_OPCODE_TRANSMIT 0x0010

+

+///

+/// Receive packet.

+///

+#define PXE_OPCODE_RECEIVE  0x0011

+

+///

+/// Last valid PXE UNDI OpCode number.

+///

+#define PXE_OPCODE_LAST_VALID 0x0011

+

+typedef PXE_UINT16  PXE_OPFLAGS;

+

+#define PXE_OPFLAGS_NOT_USED  0x0000

+

+//

+// //////////////////////////////////////

+// UNDI Get State

+//

+// No OpFlags

+

+////////////////////////////////////////

+// UNDI Start

+//

+// No OpFlags

+

+////////////////////////////////////////

+// UNDI Stop

+//

+// No OpFlags

+

+////////////////////////////////////////

+// UNDI Get Init Info

+//

+// No Opflags

+

+////////////////////////////////////////

+// UNDI Get Config Info

+//

+// No Opflags

+

+///

+/// UNDI Initialize

+///

+#define PXE_OPFLAGS_INITIALIZE_CABLE_DETECT_MASK    0x0001

+#define PXE_OPFLAGS_INITIALIZE_DETECT_CABLE         0x0000

+#define PXE_OPFLAGS_INITIALIZE_DO_NOT_DETECT_CABLE  0x0001

+

+///

+///

+/// UNDI Reset

+///

+#define PXE_OPFLAGS_RESET_DISABLE_INTERRUPTS  0x0001

+#define PXE_OPFLAGS_RESET_DISABLE_FILTERS     0x0002

+

+///

+/// UNDI Shutdown.

+///

+/// No OpFlags.

+

+///

+/// UNDI Interrupt Enables.

+///

+///

+/// Select whether to enable or disable external interrupt signals.

+/// Setting both enable and disable will return PXE_STATCODE_INVALID_OPFLAGS.

+///

+#define PXE_OPFLAGS_INTERRUPT_OPMASK  0xC000

+#define PXE_OPFLAGS_INTERRUPT_ENABLE  0x8000

+#define PXE_OPFLAGS_INTERRUPT_DISABLE 0x4000

+#define PXE_OPFLAGS_INTERRUPT_READ    0x0000

+

+///

+/// Enable receive interrupts.  An external interrupt will be generated

+/// after a complete non-error packet has been received.

+///

+#define PXE_OPFLAGS_INTERRUPT_RECEIVE 0x0001

+

+///

+/// Enable transmit interrupts.  An external interrupt will be generated

+/// after a complete non-error packet has been transmitted.

+///

+#define PXE_OPFLAGS_INTERRUPT_TRANSMIT  0x0002

+

+///

+/// Enable command interrupts.  An external interrupt will be generated

+/// when command execution stops.

+///

+#define PXE_OPFLAGS_INTERRUPT_COMMAND 0x0004

+

+///

+/// Generate software interrupt.  Setting this bit generates an external

+/// interrupt, if it is supported by the hardware.

+///

+#define PXE_OPFLAGS_INTERRUPT_SOFTWARE  0x0008

+

+///

+/// UNDI Receive Filters.

+///

+///

+/// Select whether to enable or disable receive filters.

+/// Setting both enable and disable will return PXE_STATCODE_INVALID_OPCODE.

+///

+#define PXE_OPFLAGS_RECEIVE_FILTER_OPMASK   0xC000

+#define PXE_OPFLAGS_RECEIVE_FILTER_ENABLE   0x8000

+#define PXE_OPFLAGS_RECEIVE_FILTER_DISABLE  0x4000

+#define PXE_OPFLAGS_RECEIVE_FILTER_READ     0x0000

+

+///

+/// To reset the contents of the multicast MAC address filter list,

+/// set this OpFlag:

+///

+#define PXE_OPFLAGS_RECEIVE_FILTER_RESET_MCAST_LIST 0x2000

+

+///

+/// Enable unicast packet receiving.  Packets sent to the current station

+/// MAC address will be received.

+///

+#define PXE_OPFLAGS_RECEIVE_FILTER_UNICAST  0x0001

+

+///

+/// Enable broadcast packet receiving.  Packets sent to the broadcast

+/// MAC address will be received.

+///

+#define PXE_OPFLAGS_RECEIVE_FILTER_BROADCAST  0x0002

+

+///

+/// Enable filtered multicast packet receiving.  Packets sent to any

+/// of the multicast MAC addresses in the multicast MAC address filter

+/// list will be received.  If the filter list is empty, no multicast

+///

+#define PXE_OPFLAGS_RECEIVE_FILTER_FILTERED_MULTICAST 0x0004

+

+///

+/// Enable promiscuous packet receiving.  All packets will be received.

+///

+#define PXE_OPFLAGS_RECEIVE_FILTER_PROMISCUOUS  0x0008

+

+///

+/// Enable promiscuous multicast packet receiving.  All multicast

+/// packets will be received.

+///

+#define PXE_OPFLAGS_RECEIVE_FILTER_ALL_MULTICAST  0x0010

+

+///

+/// UNDI Station Address.

+///

+#define PXE_OPFLAGS_STATION_ADDRESS_READ   0x0000

+#define PXE_OPFLAGS_STATION_ADDRESS_WRITE  0x0000

+#define PXE_OPFLAGS_STATION_ADDRESS_RESET  0x0001

+

+///

+/// UNDI Statistics.

+///

+#define PXE_OPFLAGS_STATISTICS_READ   0x0000

+#define PXE_OPFLAGS_STATISTICS_RESET  0x0001

+

+///

+/// UNDI MCast IP to MAC.

+///

+///

+/// Identify the type of IP address in the CPB.

+///

+#define PXE_OPFLAGS_MCAST_IP_TO_MAC_OPMASK  0x0003

+#define PXE_OPFLAGS_MCAST_IPV4_TO_MAC       0x0000

+#define PXE_OPFLAGS_MCAST_IPV6_TO_MAC       0x0001

+

+///

+/// UNDI NvData.

+///

+///

+/// Select the type of non-volatile data operation.

+///

+#define PXE_OPFLAGS_NVDATA_OPMASK 0x0001

+#define PXE_OPFLAGS_NVDATA_READ   0x0000

+#define PXE_OPFLAGS_NVDATA_WRITE  0x0001

+

+///

+/// UNDI Get Status.

+///

+///

+/// Return current interrupt status.  This will also clear any interrupts

+/// that are currently set.  This can be used in a polling routine.  The

+/// interrupt flags are still set and cleared even when the interrupts

+/// are disabled.

+///

+#define PXE_OPFLAGS_GET_INTERRUPT_STATUS  0x0001

+

+///

+/// Return list of transmitted buffers for recycling.  Transmit buffers

+/// must not be changed or unallocated until they have recycled.  After

+/// issuing a transmit command, wait for a transmit complete interrupt.

+/// When a transmit complete interrupt is received, read the transmitted

+/// buffers.  Do not plan on getting one buffer per interrupt.  Some

+/// NICs and UNDIs may transmit multiple buffers per interrupt.

+///

+#define PXE_OPFLAGS_GET_TRANSMITTED_BUFFERS 0x0002

+

+///

+/// Return current media status.

+///

+#define PXE_OPFLAGS_GET_MEDIA_STATUS    0x0004

+

+///

+/// UNDI Fill Header.

+///

+#define PXE_OPFLAGS_FILL_HEADER_OPMASK      0x0001

+#define PXE_OPFLAGS_FILL_HEADER_FRAGMENTED  0x0001

+#define PXE_OPFLAGS_FILL_HEADER_WHOLE       0x0000

+

+///

+/// UNDI Transmit.

+///

+///

+/// S/W UNDI only.  Return after the packet has been transmitted.  A

+/// transmit complete interrupt will still be generated and the transmit

+/// buffer will have to be recycled.

+///

+#define PXE_OPFLAGS_SWUNDI_TRANSMIT_OPMASK  0x0001

+#define PXE_OPFLAGS_TRANSMIT_BLOCK          0x0001

+#define PXE_OPFLAGS_TRANSMIT_DONT_BLOCK     0x0000

+

+#define PXE_OPFLAGS_TRANSMIT_OPMASK     0x0002

+#define PXE_OPFLAGS_TRANSMIT_FRAGMENTED 0x0002

+#define PXE_OPFLAGS_TRANSMIT_WHOLE      0x0000

+

+///

+/// UNDI Receive.

+///

+/// No OpFlags.

+///

+

+///

+/// PXE STATFLAGS.

+///

+typedef PXE_UINT16  PXE_STATFLAGS;

+

+#define PXE_STATFLAGS_INITIALIZE  0x0000

+

+///

+/// Common StatFlags that can be returned by all commands.

+///

+///

+/// The COMMAND_COMPLETE and COMMAND_FAILED status flags must be

+/// implemented by all UNDIs.  COMMAND_QUEUED is only needed by UNDIs

+/// that support command queuing.

+///

+#define PXE_STATFLAGS_STATUS_MASK       0xC000

+#define PXE_STATFLAGS_COMMAND_COMPLETE  0xC000

+#define PXE_STATFLAGS_COMMAND_FAILED    0x8000

+#define PXE_STATFLAGS_COMMAND_QUEUED    0x4000

+

+///

+/// UNDI Get State.

+///

+#define PXE_STATFLAGS_GET_STATE_MASK        0x0003

+#define PXE_STATFLAGS_GET_STATE_INITIALIZED 0x0002

+#define PXE_STATFLAGS_GET_STATE_STARTED     0x0001

+#define PXE_STATFLAGS_GET_STATE_STOPPED     0x0000

+

+///

+/// UNDI Start.

+///

+/// No additional StatFlags.

+///

+

+///

+/// UNDI Get Init Info.

+///

+#define PXE_STATFLAGS_CABLE_DETECT_MASK           0x0001

+#define PXE_STATFLAGS_CABLE_DETECT_NOT_SUPPORTED  0x0000

+#define PXE_STATFLAGS_CABLE_DETECT_SUPPORTED      0x0001

+

+#define PXE_STATFLAGS_GET_STATUS_NO_MEDIA_MASK           0x0002

+#define PXE_STATFLAGS_GET_STATUS_NO_MEDIA_NOT_SUPPORTED  0x0000

+#define PXE_STATFLAGS_GET_STATUS_NO_MEDIA_SUPPORTED      0x0002

+

+///

+/// UNDI Initialize.

+///

+#define PXE_STATFLAGS_INITIALIZED_NO_MEDIA  0x0001

+

+///

+/// UNDI Reset.

+///

+#define PXE_STATFLAGS_RESET_NO_MEDIA  0x0001

+

+///

+/// UNDI Shutdown.

+///

+/// No additional StatFlags.

+

+///

+/// UNDI Interrupt Enables.

+///

+///

+/// If set, receive interrupts are enabled.

+///

+#define PXE_STATFLAGS_INTERRUPT_RECEIVE 0x0001

+

+///

+/// If set, transmit interrupts are enabled.

+///

+#define PXE_STATFLAGS_INTERRUPT_TRANSMIT  0x0002

+

+///

+/// If set, command interrupts are enabled.

+///

+#define PXE_STATFLAGS_INTERRUPT_COMMAND 0x0004

+

+///

+/// UNDI Receive Filters.

+///

+

+///

+/// If set, unicast packets will be received.

+///

+#define PXE_STATFLAGS_RECEIVE_FILTER_UNICAST  0x0001

+

+///

+/// If set, broadcast packets will be received.

+///

+#define PXE_STATFLAGS_RECEIVE_FILTER_BROADCAST  0x0002

+

+///

+/// If set, multicast packets that match up with the multicast address

+/// filter list will be received.

+///

+#define PXE_STATFLAGS_RECEIVE_FILTER_FILTERED_MULTICAST 0x0004

+

+///

+/// If set, all packets will be received.

+///

+#define PXE_STATFLAGS_RECEIVE_FILTER_PROMISCUOUS  0x0008

+

+///

+/// If set, all multicast packets will be received.

+///

+#define PXE_STATFLAGS_RECEIVE_FILTER_ALL_MULTICAST  0x0010

+

+///

+/// UNDI Station Address.

+///

+/// No additional StatFlags.

+///

+

+///

+/// UNDI Statistics.

+///

+/// No additional StatFlags.

+///

+

+///

+//// UNDI MCast IP to MAC.

+////

+//// No additional StatFlags.

+

+///

+/// UNDI NvData.

+///

+/// No additional StatFlags.

+///

+

+///

+/// UNDI Get Status.

+///

+

+///

+/// Use to determine if an interrupt has occurred.

+///

+#define PXE_STATFLAGS_GET_STATUS_INTERRUPT_MASK 0x000F

+#define PXE_STATFLAGS_GET_STATUS_NO_INTERRUPTS  0x0000

+

+///

+/// If set, at least one receive interrupt occurred.

+///

+#define PXE_STATFLAGS_GET_STATUS_RECEIVE  0x0001

+

+///

+/// If set, at least one transmit interrupt occurred.

+///

+#define PXE_STATFLAGS_GET_STATUS_TRANSMIT 0x0002

+

+///

+/// If set, at least one command interrupt occurred.

+///

+#define PXE_STATFLAGS_GET_STATUS_COMMAND  0x0004

+

+///

+/// If set, at least one software interrupt occurred.

+///

+#define PXE_STATFLAGS_GET_STATUS_SOFTWARE 0x0008

+

+///

+/// This flag is set if the transmitted buffer queue is empty.  This flag

+/// will be set if all transmitted buffer addresses get written into the DB.

+///

+#define PXE_STATFLAGS_GET_STATUS_TXBUF_QUEUE_EMPTY  0x0010

+

+///

+/// This flag is set if no transmitted buffer addresses were written

+/// into the DB.  (This could be because DBsize was too small.)

+///

+#define PXE_STATFLAGS_GET_STATUS_NO_TXBUFS_WRITTEN  0x0020

+

+///

+/// This flag is set if there is no media detected.

+///

+#define PXE_STATFLAGS_GET_STATUS_NO_MEDIA  0x0040

+

+///

+/// UNDI Fill Header.

+///

+/// No additional StatFlags.

+///

+

+///

+/// UNDI Transmit.

+///

+/// No additional StatFlags.

+

+///

+/// UNDI Receive

+///.

+

+///

+/// No additional StatFlags.

+///

+typedef PXE_UINT16  PXE_STATCODE;

+

+#define PXE_STATCODE_INITIALIZE 0x0000

+

+///

+/// Common StatCodes returned by all UNDI commands, UNDI protocol functions

+/// and BC protocol functions.

+///

+#define PXE_STATCODE_SUCCESS              0x0000

+

+#define PXE_STATCODE_INVALID_CDB          0x0001

+#define PXE_STATCODE_INVALID_CPB          0x0002

+#define PXE_STATCODE_BUSY                 0x0003

+#define PXE_STATCODE_QUEUE_FULL           0x0004

+#define PXE_STATCODE_ALREADY_STARTED      0x0005

+#define PXE_STATCODE_NOT_STARTED          0x0006

+#define PXE_STATCODE_NOT_SHUTDOWN         0x0007

+#define PXE_STATCODE_ALREADY_INITIALIZED  0x0008

+#define PXE_STATCODE_NOT_INITIALIZED      0x0009

+#define PXE_STATCODE_DEVICE_FAILURE       0x000A

+#define PXE_STATCODE_NVDATA_FAILURE       0x000B

+#define PXE_STATCODE_UNSUPPORTED          0x000C

+#define PXE_STATCODE_BUFFER_FULL          0x000D

+#define PXE_STATCODE_INVALID_PARAMETER    0x000E

+#define PXE_STATCODE_INVALID_UNDI         0x000F

+#define PXE_STATCODE_IPV4_NOT_SUPPORTED   0x0010

+#define PXE_STATCODE_IPV6_NOT_SUPPORTED   0x0011

+#define PXE_STATCODE_NOT_ENOUGH_MEMORY    0x0012

+#define PXE_STATCODE_NO_DATA              0x0013

+

+typedef PXE_UINT16  PXE_IFNUM;

+

+///

+/// This interface number must be passed to the S/W UNDI Start command.

+///

+#define PXE_IFNUM_START 0x0000

+

+///

+/// This interface number is returned by the S/W UNDI Get State and

+/// Start commands if information in the CDB, CPB or DB is invalid.

+///

+#define PXE_IFNUM_INVALID 0x0000

+

+typedef PXE_UINT16  PXE_CONTROL;

+

+///

+/// Setting this flag directs the UNDI to queue this command for later

+/// execution if the UNDI is busy and it supports command queuing.

+/// If queuing is not supported, a PXE_STATCODE_INVALID_CONTROL error

+/// is returned.  If the queue is full, a PXE_STATCODE_CDB_QUEUE_FULL

+/// error is returned.

+///

+#define PXE_CONTROL_QUEUE_IF_BUSY 0x0002

+

+///

+/// These two bit values are used to determine if there are more UNDI

+/// CDB structures following this one.  If the link bit is set, there

+/// must be a CDB structure following this one.  Execution will start

+/// on the next CDB structure as soon as this one completes successfully.

+/// If an error is generated by this command, execution will stop.

+///

+#define PXE_CONTROL_LINK              0x0001

+#define PXE_CONTROL_LAST_CDB_IN_LIST  0x0000

+

+typedef PXE_UINT8   PXE_FRAME_TYPE;

+

+#define PXE_FRAME_TYPE_NONE                     0x00

+#define PXE_FRAME_TYPE_UNICAST                  0x01

+#define PXE_FRAME_TYPE_BROADCAST                0x02

+#define PXE_FRAME_TYPE_FILTERED_MULTICAST       0x03

+#define PXE_FRAME_TYPE_PROMISCUOUS              0x04

+#define PXE_FRAME_TYPE_PROMISCUOUS_MULTICAST    0x05

+

+#define PXE_FRAME_TYPE_MULTICAST                PXE_FRAME_TYPE_FILTERED_MULTICAST

+

+typedef PXE_UINT32  PXE_IPV4;

+

+typedef PXE_UINT32  PXE_IPV6[4];

+#define PXE_MAC_LENGTH  32

+

+typedef PXE_UINT8   PXE_MAC_ADDR[PXE_MAC_LENGTH];

+

+typedef PXE_UINT8   PXE_IFTYPE;

+typedef UINT16      PXE_MEDIA_PROTOCOL;

+

+///

+/// This information is from the ARP section of RFC 1700.

+///

+///     1 Ethernet (10Mb)                                    [JBP]

+///     2 Experimental Ethernet (3Mb)                        [JBP]

+///     3 Amateur Radio AX.25                                [PXK]

+///     4 Proteon ProNET Token Ring                          [JBP]

+///     5 Chaos                                              [GXP]

+///     6 IEEE 802 Networks                                  [JBP]

+///     7 ARCNET                                             [JBP]

+///     8 Hyperchannel                                       [JBP]

+///     9 Lanstar                                             [TU]

+///    10 Autonet Short Address                             [MXB1]

+///    11 LocalTalk                                         [JKR1]

+///    12 LocalNet (IBM* PCNet or SYTEK* LocalNET)           [JXM]

+///    13 Ultra link                                        [RXD2]

+///    14 SMDS                                              [GXC1]

+///    15 Frame Relay                                        [AGM]

+///    16 Asynchronous Transmission Mode (ATM)              [JXB2]

+///    17 HDLC                                               [JBP]

+///    18 Fibre Channel                            [Yakov Rekhter]

+///    19 Asynchronous Transmission Mode (ATM)      [Mark Laubach]

+///    20 Serial Line                                        [JBP]

+///    21 Asynchronous Transmission Mode (ATM)              [MXB1]

+///

+/// * Other names and brands may be claimed as the property of others.

+///

+#define PXE_IFTYPE_ETHERNET       0x01

+#define PXE_IFTYPE_TOKENRING      0x04

+#define PXE_IFTYPE_FIBRE_CHANNEL  0x12

+

+typedef struct s_pxe_hw_undi {

+  PXE_UINT32  Signature;      ///< PXE_ROMID_SIGNATURE.

+  PXE_UINT8   Len;            ///< sizeof(PXE_HW_UNDI).

+  PXE_UINT8   Fudge;          ///< makes 8-bit cksum equal zero.

+  PXE_UINT8   Rev;            ///< PXE_ROMID_REV.

+  PXE_UINT8   IFcnt;          ///< physical connector count lower byte.

+  PXE_UINT8   MajorVer;       ///< PXE_ROMID_MAJORVER.

+  PXE_UINT8   MinorVer;       ///< PXE_ROMID_MINORVER.

+  PXE_UINT8   IFcntExt;       ///< physical connector count upper byte.

+  PXE_UINT8   reserved;       ///< zero, not used.

+  PXE_UINT32  Implementation; ///< implementation flags.

+  ///< reserved             ///< vendor use.

+  ///< UINT32 Status;       ///< status port.

+  ///< UINT32 Command;      ///< command port.

+  ///< UINT64 CDBaddr;      ///< CDB address port.

+  ///<

+} PXE_HW_UNDI;

+

+///

+/// Status port bit definitions.

+///

+

+///

+/// UNDI operation state.

+///

+#define PXE_HWSTAT_STATE_MASK   0xC0000000

+#define PXE_HWSTAT_BUSY         0xC0000000

+#define PXE_HWSTAT_INITIALIZED  0x80000000

+#define PXE_HWSTAT_STARTED      0x40000000

+#define PXE_HWSTAT_STOPPED      0x00000000

+

+///

+/// If set, last command failed.

+///

+#define PXE_HWSTAT_COMMAND_FAILED 0x20000000

+

+///

+/// If set, identifies enabled receive filters.

+///

+#define PXE_HWSTAT_PROMISCUOUS_MULTICAST_RX_ENABLED 0x00001000

+#define PXE_HWSTAT_PROMISCUOUS_RX_ENABLED           0x00000800

+#define PXE_HWSTAT_BROADCAST_RX_ENABLED             0x00000400

+#define PXE_HWSTAT_MULTICAST_RX_ENABLED             0x00000200

+#define PXE_HWSTAT_UNICAST_RX_ENABLED               0x00000100

+

+///

+/// If set, identifies enabled external interrupts.

+///

+#define PXE_HWSTAT_SOFTWARE_INT_ENABLED     0x00000080

+#define PXE_HWSTAT_TX_COMPLETE_INT_ENABLED  0x00000040

+#define PXE_HWSTAT_PACKET_RX_INT_ENABLED    0x00000020

+#define PXE_HWSTAT_CMD_COMPLETE_INT_ENABLED 0x00000010

+

+///

+/// If set, identifies pending interrupts.

+///

+#define PXE_HWSTAT_SOFTWARE_INT_PENDING     0x00000008

+#define PXE_HWSTAT_TX_COMPLETE_INT_PENDING  0x00000004

+#define PXE_HWSTAT_PACKET_RX_INT_PENDING    0x00000002

+#define PXE_HWSTAT_CMD_COMPLETE_INT_PENDING 0x00000001

+

+///

+/// Command port definitions.

+///

+

+///

+/// If set, CDB identified in CDBaddr port is given to UNDI.

+/// If not set, other bits in this word will be processed.

+///

+#define PXE_HWCMD_ISSUE_COMMAND   0x80000000

+#define PXE_HWCMD_INTS_AND_FILTS  0x00000000

+

+///

+/// Use these to enable/disable receive filters.

+///

+#define PXE_HWCMD_PROMISCUOUS_MULTICAST_RX_ENABLE 0x00001000

+#define PXE_HWCMD_PROMISCUOUS_RX_ENABLE           0x00000800

+#define PXE_HWCMD_BROADCAST_RX_ENABLE             0x00000400

+#define PXE_HWCMD_MULTICAST_RX_ENABLE             0x00000200

+#define PXE_HWCMD_UNICAST_RX_ENABLE               0x00000100

+

+///

+/// Use these to enable/disable external interrupts.

+///

+#define PXE_HWCMD_SOFTWARE_INT_ENABLE     0x00000080

+#define PXE_HWCMD_TX_COMPLETE_INT_ENABLE  0x00000040

+#define PXE_HWCMD_PACKET_RX_INT_ENABLE    0x00000020

+#define PXE_HWCMD_CMD_COMPLETE_INT_ENABLE 0x00000010

+

+///

+/// Use these to clear pending external interrupts.

+///

+#define PXE_HWCMD_CLEAR_SOFTWARE_INT      0x00000008

+#define PXE_HWCMD_CLEAR_TX_COMPLETE_INT   0x00000004

+#define PXE_HWCMD_CLEAR_PACKET_RX_INT     0x00000002

+#define PXE_HWCMD_CLEAR_CMD_COMPLETE_INT  0x00000001

+

+typedef struct s_pxe_sw_undi {

+  PXE_UINT32  Signature;      ///< PXE_ROMID_SIGNATURE.

+  PXE_UINT8   Len;            ///< sizeof(PXE_SW_UNDI).

+  PXE_UINT8   Fudge;          ///< makes 8-bit cksum zero.

+  PXE_UINT8   Rev;            ///< PXE_ROMID_REV.

+  PXE_UINT8   IFcnt;          ///< physical connector count lower byte.

+  PXE_UINT8   MajorVer;       ///< PXE_ROMID_MAJORVER.

+  PXE_UINT8   MinorVer;       ///< PXE_ROMID_MINORVER.

+  PXE_UINT8   IFcntExt;       ///< physical connector count upper byte.

+  PXE_UINT8   reserved1;      ///< zero, not used.

+  PXE_UINT32  Implementation; ///< Implementation flags.

+  PXE_UINT64  EntryPoint;     ///< API entry point.

+  PXE_UINT8   reserved2[3];   ///< zero, not used.

+  PXE_UINT8   BusCnt;         ///< number of bustypes supported.

+  PXE_UINT32  BusType[1];     ///< list of supported bustypes.

+} PXE_SW_UNDI;

+

+typedef union u_pxe_undi {

+  PXE_HW_UNDI hw;

+  PXE_SW_UNDI sw;

+} PXE_UNDI;

+

+///

+/// Signature of !PXE structure.

+///

+#define PXE_ROMID_SIGNATURE PXE_BUSTYPE ('!', 'P', 'X', 'E')

+

+///

+/// !PXE structure format revision

+///.

+#define PXE_ROMID_REV 0x02

+

+///

+/// UNDI command interface revision.  These are the values that get sent

+/// in option 94 (Client Network Interface Identifier) in the DHCP Discover

+/// and PXE Boot Server Request packets.

+///

+#define PXE_ROMID_MAJORVER    0x03

+#define PXE_ROMID_MINORVER    0x01

+

+///

+/// Implementation flags.

+///

+#define PXE_ROMID_IMP_HW_UNDI                             0x80000000

+#define PXE_ROMID_IMP_SW_VIRT_ADDR                        0x40000000

+#define PXE_ROMID_IMP_64BIT_DEVICE                        0x00010000

+#define PXE_ROMID_IMP_FRAG_SUPPORTED                      0x00008000

+#define PXE_ROMID_IMP_CMD_LINK_SUPPORTED                  0x00004000

+#define PXE_ROMID_IMP_CMD_QUEUE_SUPPORTED                 0x00002000

+#define PXE_ROMID_IMP_MULTI_FRAME_SUPPORTED               0x00001000

+#define PXE_ROMID_IMP_NVDATA_SUPPORT_MASK                 0x00000C00

+#define PXE_ROMID_IMP_NVDATA_BULK_WRITABLE                0x00000C00

+#define PXE_ROMID_IMP_NVDATA_SPARSE_WRITABLE              0x00000800

+#define PXE_ROMID_IMP_NVDATA_READ_ONLY                    0x00000400

+#define PXE_ROMID_IMP_NVDATA_NOT_AVAILABLE                0x00000000

+#define PXE_ROMID_IMP_STATISTICS_SUPPORTED                0x00000200

+#define PXE_ROMID_IMP_STATION_ADDR_SETTABLE               0x00000100

+#define PXE_ROMID_IMP_PROMISCUOUS_MULTICAST_RX_SUPPORTED  0x00000080

+#define PXE_ROMID_IMP_PROMISCUOUS_RX_SUPPORTED            0x00000040

+#define PXE_ROMID_IMP_BROADCAST_RX_SUPPORTED              0x00000020

+#define PXE_ROMID_IMP_FILTERED_MULTICAST_RX_SUPPORTED     0x00000010

+#define PXE_ROMID_IMP_SOFTWARE_INT_SUPPORTED              0x00000008

+#define PXE_ROMID_IMP_TX_COMPLETE_INT_SUPPORTED           0x00000004

+#define PXE_ROMID_IMP_PACKET_RX_INT_SUPPORTED             0x00000002

+#define PXE_ROMID_IMP_CMD_COMPLETE_INT_SUPPORTED          0x00000001

+

+typedef struct s_pxe_cdb {

+  PXE_OPCODE    OpCode;

+  PXE_OPFLAGS   OpFlags;

+  PXE_UINT16    CPBsize;

+  PXE_UINT16    DBsize;

+  PXE_UINT64    CPBaddr;

+  PXE_UINT64    DBaddr;

+  PXE_STATCODE  StatCode;

+  PXE_STATFLAGS StatFlags;

+  PXE_UINT16    IFnum;

+  PXE_CONTROL   Control;

+} PXE_CDB;

+

+typedef union u_pxe_ip_addr {

+  PXE_IPV6  IPv6;

+  PXE_IPV4  IPv4;

+} PXE_IP_ADDR;

+

+typedef union pxe_device {

+  ///

+  /// PCI and PC Card NICs are both identified using bus, device

+  /// and function numbers.  For PC Card, this may require PC

+  /// Card services to be loaded in the BIOS or preboot

+  /// environment.

+  ///

+  struct {

+    ///

+    /// See S/W UNDI ROMID structure definition for PCI and

+    /// PCC BusType definitions.

+    ///

+    PXE_UINT32  BusType;

+

+    ///

+    /// Bus, device & function numbers that locate this device.

+    ///

+    PXE_UINT16  Bus;

+    PXE_UINT8   Device;

+    PXE_UINT8   Function;

+  }

+  PCI, PCC;

+

+} PXE_DEVICE;

+

+///

+/// cpb and db definitions

+///

+#define MAX_PCI_CONFIG_LEN    64  ///< # of dwords.

+#define MAX_EEPROM_LEN        128 ///< # of dwords.

+#define MAX_XMIT_BUFFERS      32  ///< recycling Q length for xmit_done.

+#define MAX_MCAST_ADDRESS_CNT 8

+

+typedef struct s_pxe_cpb_start_30 {

+  ///

+  /// PXE_VOID Delay(UINTN microseconds);

+  ///

+  /// UNDI will never request a delay smaller than 10 microseconds

+  /// and will always request delays in increments of 10 microseconds.

+  /// The Delay() CallBack routine must delay between n and n + 10

+  /// microseconds before returning control to the UNDI.

+  ///

+  /// This field cannot be set to zero.

+  ///

+  UINT64  Delay;

+

+  ///

+  /// PXE_VOID Block(UINT32 enable);

+  ///

+  /// UNDI may need to block multi-threaded/multi-processor access to

+  /// critical code sections when programming or accessing the network

+  /// device.  To this end, a blocking service is needed by the UNDI.

+  /// When UNDI needs a block, it will call Block() passing a non-zero

+  /// value.  When UNDI no longer needs a block, it will call Block()

+  /// with a zero value.  When called, if the Block() is already enabled,

+  /// do not return control to the UNDI until the previous Block() is

+  /// disabled.

+  ///

+  /// This field cannot be set to zero.

+  ///

+  UINT64  Block;

+

+  ///

+  /// PXE_VOID Virt2Phys(UINT64 virtual, UINT64 physical_ptr);

+  ///

+  /// UNDI will pass the virtual address of a buffer and the virtual

+  /// address of a 64-bit physical buffer.  Convert the virtual address

+  /// to a physical address and write the result to the physical address

+  /// buffer.  If virtual and physical addresses are the same, just

+  /// copy the virtual address to the physical address buffer.

+  ///

+  /// This field can be set to zero if virtual and physical addresses

+  /// are equal.

+  ///

+  UINT64  Virt2Phys;

+  ///

+  /// PXE_VOID Mem_IO(UINT8 read_write, UINT8 len, UINT64 port,

+  ///              UINT64 buf_addr);

+  ///

+  /// UNDI will read or write the device io space using this call back

+  /// function. It passes the number of bytes as the len parameter and it

+  /// will be either 1,2,4 or 8.

+  ///

+  /// This field can not be set to zero.

+  ///

+  UINT64  Mem_IO;

+} PXE_CPB_START_30;

+

+typedef struct s_pxe_cpb_start_31 {

+  ///

+  /// PXE_VOID Delay(UINT64 UnqId, UINTN microseconds);

+  ///

+  /// UNDI will never request a delay smaller than 10 microseconds

+  /// and will always request delays in increments of 10 microseconds.

+  /// The Delay() CallBack routine must delay between n and n + 10

+  /// microseconds before returning control to the UNDI.

+  ///

+  /// This field cannot be set to zero.

+  ///

+  UINT64  Delay;

+

+  ///

+  /// PXE_VOID Block(UINT64 unq_id, UINT32 enable);

+  ///

+  /// UNDI may need to block multi-threaded/multi-processor access to

+  /// critical code sections when programming or accessing the network

+  /// device.  To this end, a blocking service is needed by the UNDI.

+  /// When UNDI needs a block, it will call Block() passing a non-zero

+  /// value.  When UNDI no longer needs a block, it will call Block()

+  /// with a zero value.  When called, if the Block() is already enabled,

+  /// do not return control to the UNDI until the previous Block() is

+  /// disabled.

+  ///

+  /// This field cannot be set to zero.

+  ///

+  UINT64  Block;

+

+  ///

+  /// PXE_VOID Virt2Phys(UINT64 UnqId, UINT64 virtual, UINT64 physical_ptr);

+  ///

+  /// UNDI will pass the virtual address of a buffer and the virtual

+  /// address of a 64-bit physical buffer.  Convert the virtual address

+  /// to a physical address and write the result to the physical address

+  /// buffer.  If virtual and physical addresses are the same, just

+  /// copy the virtual address to the physical address buffer.

+  ///

+  /// This field can be set to zero if virtual and physical addresses

+  /// are equal.

+  ///

+  UINT64  Virt2Phys;

+  ///

+  /// PXE_VOID Mem_IO(UINT64 UnqId, UINT8 read_write, UINT8 len, UINT64 port,

+  ///              UINT64 buf_addr);

+  ///

+  /// UNDI will read or write the device io space using this call back

+  /// function. It passes the number of bytes as the len parameter and it

+  /// will be either 1,2,4 or 8.

+  ///

+  /// This field can not be set to zero.

+  ///

+  UINT64  Mem_IO;

+  ///

+  /// PXE_VOID Map_Mem(UINT64 unq_id, UINT64 virtual_addr, UINT32 size,

+  ///                 UINT32 Direction, UINT64 mapped_addr);

+  ///

+  /// UNDI will pass the virtual address of a buffer, direction of the data

+  /// flow from/to the mapped buffer (the constants are defined below)

+  /// and a place holder (pointer) for the mapped address.

+  /// This call will Map the given address to a physical DMA address and write

+  /// the result to the mapped_addr pointer.  If there is no need to

+  /// map the given address to a lower address (i.e. the given address is

+  /// associated with a physical address that is already compatible to be

+  /// used with the DMA, it converts the given virtual address to it's

+  /// physical address and write that in the mapped address pointer.

+  ///

+  /// This field can be set to zero if there is no mapping service available.

+  ///

+  UINT64  Map_Mem;

+

+  ///

+  /// PXE_VOID UnMap_Mem(UINT64 unq_id, UINT64 virtual_addr, UINT32 size,

+  ///            UINT32 Direction, UINT64 mapped_addr);

+  ///

+  /// UNDI will pass the virtual and mapped addresses of a buffer.

+  /// This call will un map the given address.

+  ///

+  /// This field can be set to zero if there is no unmapping service available.

+  ///

+  UINT64  UnMap_Mem;

+

+  ///

+  /// PXE_VOID Sync_Mem(UINT64 unq_id, UINT64 virtual,

+  ///            UINT32 size, UINT32 Direction, UINT64 mapped_addr);

+  ///

+  /// UNDI will pass the virtual and mapped addresses of a buffer.

+  /// This call will synchronize the contents of both the virtual and mapped.

+  /// buffers for the given Direction.

+  ///

+  /// This field can be set to zero if there is no service available.

+  ///

+  UINT64  Sync_Mem;

+

+  ///

+  /// protocol driver can provide anything for this Unique_ID, UNDI remembers

+  /// that as just a 64bit value associated to the interface specified by

+  /// the ifnum and gives it back as a parameter to all the call-back routines

+  /// when calling for that interface!

+  ///

+  UINT64  Unique_ID;

+} PXE_CPB_START_31;

+

+#define TO_AND_FROM_DEVICE    0

+#define FROM_DEVICE           1

+#define TO_DEVICE             2

+

+#define PXE_DELAY_MILLISECOND 1000

+#define PXE_DELAY_SECOND      1000000

+#define PXE_IO_READ           0

+#define PXE_IO_WRITE          1

+#define PXE_MEM_READ          2

+#define PXE_MEM_WRITE         4

+

+typedef struct s_pxe_db_get_init_info {

+  ///

+  /// Minimum length of locked memory buffer that must be given to

+  /// the Initialize command. Giving UNDI more memory will generally

+  /// give better performance.

+  ///

+  /// If MemoryRequired is zero, the UNDI does not need and will not

+  /// use system memory to receive and transmit packets.

+  ///

+  PXE_UINT32  MemoryRequired;

+

+  ///

+  /// Maximum frame data length for Tx/Rx excluding the media header.

+  ///

+  PXE_UINT32  FrameDataLen;

+

+  ///

+  /// Supported link speeds are in units of mega bits.  Common ethernet

+  /// values are 10, 100 and 1000.  Unused LinkSpeeds[] entries are zero

+  /// filled.

+  ///

+  PXE_UINT32  LinkSpeeds[4];

+

+  ///

+  /// Number of non-volatile storage items.

+  ///

+  PXE_UINT32  NvCount;

+

+  ///

+  /// Width of non-volatile storage item in bytes.  0, 1, 2 or 4

+  ///

+  PXE_UINT16  NvWidth;

+

+  ///

+  /// Media header length.  This is the typical media header length for

+  /// this UNDI.  This information is needed when allocating receive

+  /// and transmit buffers.

+  ///

+  PXE_UINT16  MediaHeaderLen;

+

+  ///

+  /// Number of bytes in the NIC hardware (MAC) address.

+  ///

+  PXE_UINT16  HWaddrLen;

+

+  ///

+  /// Maximum number of multicast MAC addresses in the multicast

+  /// MAC address filter list.

+  ///

+  PXE_UINT16  MCastFilterCnt;

+

+  ///

+  /// Default number and size of transmit and receive buffers that will

+  /// be allocated by the UNDI.  If MemoryRequired is non-zero, this

+  /// allocation will come out of the memory buffer given to the Initialize

+  /// command.  If MemoryRequired is zero, this allocation will come out of

+  /// memory on the NIC.

+  ///

+  PXE_UINT16  TxBufCnt;

+  PXE_UINT16  TxBufSize;

+  PXE_UINT16  RxBufCnt;

+  PXE_UINT16  RxBufSize;

+

+  ///

+  /// Hardware interface types defined in the Assigned Numbers RFC

+  /// and used in DHCP and ARP packets.

+  /// See the PXE_IFTYPE typedef and PXE_IFTYPE_xxx macros.

+  ///

+  PXE_UINT8   IFtype;

+

+  ///

+  /// Supported duplex.  See PXE_DUPLEX_xxxxx #defines below.

+  ///

+  PXE_UINT8   SupportedDuplexModes;

+

+  ///

+  /// Supported loopback options.  See PXE_LOOPBACK_xxxxx #defines below.

+  ///

+  PXE_UINT8   SupportedLoopBackModes;

+} PXE_DB_GET_INIT_INFO;

+

+#define PXE_MAX_TXRX_UNIT_ETHER           1500

+

+#define PXE_HWADDR_LEN_ETHER              0x0006

+#define PXE_MAC_HEADER_LEN_ETHER          0x000E

+

+#define PXE_DUPLEX_ENABLE_FULL_SUPPORTED  1

+#define PXE_DUPLEX_FORCE_FULL_SUPPORTED   2

+

+#define PXE_LOOPBACK_INTERNAL_SUPPORTED   1

+#define PXE_LOOPBACK_EXTERNAL_SUPPORTED   2

+

+typedef struct s_pxe_pci_config_info {

+  ///

+  /// This is the flag field for the PXE_DB_GET_CONFIG_INFO union.

+  /// For PCI bus devices, this field is set to PXE_BUSTYPE_PCI.

+  ///

+  UINT32  BusType;

+

+  ///

+  /// This identifies the PCI network device that this UNDI interface.

+  /// is bound to.

+  ///

+  UINT16  Bus;

+  UINT8   Device;

+  UINT8   Function;

+

+  ///

+  /// This is a copy of the PCI configuration space for this

+  /// network device.

+  ///

+  union {

+    UINT8   Byte[256];

+    UINT16  Word[128];

+    UINT32  Dword[64];

+  } Config;

+} PXE_PCI_CONFIG_INFO;

+

+typedef struct s_pxe_pcc_config_info {

+  ///

+  /// This is the flag field for the PXE_DB_GET_CONFIG_INFO union.

+  /// For PCC bus devices, this field is set to PXE_BUSTYPE_PCC.

+  ///

+  PXE_UINT32  BusType;

+

+  ///

+  /// This identifies the PCC network device that this UNDI interface

+  /// is bound to.

+  ///

+  PXE_UINT16  Bus;

+  PXE_UINT8   Device;

+  PXE_UINT8   Function;

+

+  ///

+  /// This is a copy of the PCC configuration space for this

+  /// network device.

+  ///

+  union {

+    PXE_UINT8   Byte[256];

+    PXE_UINT16  Word[128];

+    PXE_UINT32  Dword[64];

+  } Config;

+} PXE_PCC_CONFIG_INFO;

+

+typedef union u_pxe_db_get_config_info {

+  PXE_PCI_CONFIG_INFO   pci;

+  PXE_PCC_CONFIG_INFO   pcc;

+} PXE_DB_GET_CONFIG_INFO;

+

+typedef struct s_pxe_cpb_initialize {

+  ///

+  /// Address of first (lowest) byte of the memory buffer.  This buffer must

+  /// be in contiguous physical memory and cannot be swapped out.  The UNDI

+  /// will be using this for transmit and receive buffering.

+  ///

+  PXE_UINT64  MemoryAddr;

+

+  ///

+  /// MemoryLength must be greater than or equal to MemoryRequired

+  /// returned by the Get Init Info command.

+  ///

+  PXE_UINT32  MemoryLength;

+

+  ///

+  /// Desired link speed in Mbit/sec.  Common ethernet values are 10, 100

+  /// and 1000.  Setting a value of zero will auto-detect and/or use the

+  /// default link speed (operation depends on UNDI/NIC functionality).

+  ///

+  PXE_UINT32  LinkSpeed;

+

+  ///

+  /// Suggested number and size of receive and transmit buffers to

+  /// allocate.  If MemoryAddr and MemoryLength are non-zero, this

+  /// allocation comes out of the supplied memory buffer.  If MemoryAddr

+  /// and MemoryLength are zero, this allocation comes out of memory

+  /// on the NIC.

+  ///

+  /// If these fields are set to zero, the UNDI will allocate buffer

+  /// counts and sizes as it sees fit.

+  ///

+  PXE_UINT16  TxBufCnt;

+  PXE_UINT16  TxBufSize;

+  PXE_UINT16  RxBufCnt;

+  PXE_UINT16  RxBufSize;

+

+  ///

+  /// The following configuration parameters are optional and must be zero

+  /// to use the default values.

+  ///

+  PXE_UINT8   DuplexMode;

+

+  PXE_UINT8   LoopBackMode;

+} PXE_CPB_INITIALIZE;

+

+#define PXE_DUPLEX_DEFAULT      0x00

+#define PXE_FORCE_FULL_DUPLEX   0x01

+#define PXE_ENABLE_FULL_DUPLEX  0x02

+#define PXE_FORCE_HALF_DUPLEX   0x04

+#define PXE_DISABLE_FULL_DUPLEX 0x08

+

+#define LOOPBACK_NORMAL         0

+#define LOOPBACK_INTERNAL       1

+#define LOOPBACK_EXTERNAL       2

+

+typedef struct s_pxe_db_initialize {

+  ///

+  /// Actual amount of memory used from the supplied memory buffer.  This

+  /// may be less that the amount of memory suppllied and may be zero if

+  /// the UNDI and network device do not use external memory buffers.

+  ///

+  /// Memory used by the UNDI and network device is allocated from the

+  /// lowest memory buffer address.

+  ///

+  PXE_UINT32  MemoryUsed;

+

+  ///

+  /// Actual number and size of receive and transmit buffers that were

+  /// allocated.

+  ///

+  PXE_UINT16  TxBufCnt;

+  PXE_UINT16  TxBufSize;

+  PXE_UINT16  RxBufCnt;

+  PXE_UINT16  RxBufSize;

+} PXE_DB_INITIALIZE;

+

+typedef struct s_pxe_cpb_receive_filters {

+  ///

+  /// List of multicast MAC addresses.  This list, if present, will

+  /// replace the existing multicast MAC address filter list.

+  ///

+  PXE_MAC_ADDR  MCastList[MAX_MCAST_ADDRESS_CNT];

+} PXE_CPB_RECEIVE_FILTERS;

+

+typedef struct s_pxe_db_receive_filters {

+  ///

+  /// Filtered multicast MAC address list.

+  ///

+  PXE_MAC_ADDR  MCastList[MAX_MCAST_ADDRESS_CNT];

+} PXE_DB_RECEIVE_FILTERS;

+

+typedef struct s_pxe_cpb_station_address {

+  ///

+  /// If supplied and supported, the current station MAC address

+  /// will be changed.

+  ///

+  PXE_MAC_ADDR  StationAddr;

+} PXE_CPB_STATION_ADDRESS;

+

+typedef struct s_pxe_dpb_station_address {

+  ///

+  /// Current station MAC address.

+  ///

+  PXE_MAC_ADDR  StationAddr;

+

+  ///

+  /// Station broadcast MAC address.

+  ///

+  PXE_MAC_ADDR  BroadcastAddr;

+

+  ///

+  /// Permanent station MAC address.

+  ///

+  PXE_MAC_ADDR  PermanentAddr;

+} PXE_DB_STATION_ADDRESS;

+

+typedef struct s_pxe_db_statistics {

+  ///

+  /// Bit field identifying what statistic data is collected by the

+  /// UNDI/NIC.

+  /// If bit 0x00 is set, Data[0x00] is collected.

+  /// If bit 0x01 is set, Data[0x01] is collected.

+  /// If bit 0x20 is set, Data[0x20] is collected.

+  /// If bit 0x21 is set, Data[0x21] is collected.

+  /// Etc.

+  ///

+  PXE_UINT64  Supported;

+

+  ///

+  /// Statistic data.

+  ///

+  PXE_UINT64  Data[64];

+} PXE_DB_STATISTICS;

+

+///

+/// Total number of frames received.  Includes frames with errors and

+/// dropped frames.

+///

+#define PXE_STATISTICS_RX_TOTAL_FRAMES  0x00

+

+///

+/// Number of valid frames received and copied into receive buffers.

+///

+#define PXE_STATISTICS_RX_GOOD_FRAMES 0x01

+

+///

+/// Number of frames below the minimum length for the media.

+/// This would be <64 for ethernet.

+///

+#define PXE_STATISTICS_RX_UNDERSIZE_FRAMES  0x02

+

+///

+/// Number of frames longer than the maxminum length for the

+/// media.  This would be >1500 for ethernet.

+///

+#define PXE_STATISTICS_RX_OVERSIZE_FRAMES 0x03

+

+///

+/// Valid frames that were dropped because receive buffers were full.

+///

+#define PXE_STATISTICS_RX_DROPPED_FRAMES  0x04

+

+///

+/// Number of valid unicast frames received and not dropped.

+///

+#define PXE_STATISTICS_RX_UNICAST_FRAMES  0x05

+

+///

+/// Number of valid broadcast frames received and not dropped.

+///

+#define PXE_STATISTICS_RX_BROADCAST_FRAMES  0x06

+

+///

+/// Number of valid mutlicast frames received and not dropped.

+///

+#define PXE_STATISTICS_RX_MULTICAST_FRAMES  0x07

+

+///

+/// Number of frames w/ CRC or alignment errors.

+///

+#define PXE_STATISTICS_RX_CRC_ERROR_FRAMES  0x08

+

+///

+/// Total number of bytes received.  Includes frames with errors

+/// and dropped frames.

+///

+#define PXE_STATISTICS_RX_TOTAL_BYTES 0x09

+

+///

+/// Transmit statistics.

+///

+#define PXE_STATISTICS_TX_TOTAL_FRAMES      0x0A

+#define PXE_STATISTICS_TX_GOOD_FRAMES       0x0B

+#define PXE_STATISTICS_TX_UNDERSIZE_FRAMES  0x0C

+#define PXE_STATISTICS_TX_OVERSIZE_FRAMES   0x0D

+#define PXE_STATISTICS_TX_DROPPED_FRAMES    0x0E

+#define PXE_STATISTICS_TX_UNICAST_FRAMES    0x0F

+#define PXE_STATISTICS_TX_BROADCAST_FRAMES  0x10

+#define PXE_STATISTICS_TX_MULTICAST_FRAMES  0x11

+#define PXE_STATISTICS_TX_CRC_ERROR_FRAMES  0x12

+#define PXE_STATISTICS_TX_TOTAL_BYTES       0x13

+

+///

+/// Number of collisions detection on this subnet.

+///

+#define PXE_STATISTICS_COLLISIONS 0x14

+

+///

+/// Number of frames destined for unsupported protocol.

+///

+#define PXE_STATISTICS_UNSUPPORTED_PROTOCOL 0x15

+

+///

+/// Number of valid frames received that were duplicated.

+///

+#define PXE_STATISTICS_RX_DUPLICATED_FRAMES 0x16

+

+///

+/// Number of encrypted frames received that failed to decrypt.

+///

+#define PXE_STATISTICS_RX_DECRYPT_ERROR_FRAMES 0x17

+

+///

+/// Number of frames that failed to transmit after exceeding the retry limit.

+///

+#define PXE_STATISTICS_TX_ERROR_FRAMES 0x18

+

+///

+/// Number of frames transmitted successfully after more than one attempt.

+///

+#define PXE_STATISTICS_TX_RETRY_FRAMES 0x19

+

+typedef struct s_pxe_cpb_mcast_ip_to_mac {

+  ///

+  /// Multicast IP address to be converted to multicast MAC address.

+  ///

+  PXE_IP_ADDR IP;

+} PXE_CPB_MCAST_IP_TO_MAC;

+

+typedef struct s_pxe_db_mcast_ip_to_mac {

+  ///

+  /// Multicast MAC address.

+  ///

+  PXE_MAC_ADDR  MAC;

+} PXE_DB_MCAST_IP_TO_MAC;

+

+typedef struct s_pxe_cpb_nvdata_sparse {

+  ///

+  /// NvData item list.  Only items in this list will be updated.

+  ///

+  struct {

+    ///

+    ///  Non-volatile storage address to be changed.

+    ///

+    PXE_UINT32  Addr;

+

+    ///

+    /// Data item to write into above storage address.

+    ///

+    union {

+      PXE_UINT8   Byte;

+      PXE_UINT16  Word;

+      PXE_UINT32  Dword;

+    } Data;

+  } Item[MAX_EEPROM_LEN];

+} PXE_CPB_NVDATA_SPARSE;

+

+///

+/// When using bulk update, the size of the CPB structure must be

+/// the same size as the non-volatile NIC storage.

+///

+typedef union u_pxe_cpb_nvdata_bulk {

+  ///

+  /// Array of byte-wide data items.

+  ///

+  PXE_UINT8   Byte[MAX_EEPROM_LEN << 2];

+

+  ///

+  /// Array of word-wide data items.

+  ///

+  PXE_UINT16  Word[MAX_EEPROM_LEN << 1];

+

+  ///

+  /// Array of dword-wide data items.

+  ///

+  PXE_UINT32  Dword[MAX_EEPROM_LEN];

+} PXE_CPB_NVDATA_BULK;

+

+typedef struct s_pxe_db_nvdata {

+  ///

+  /// Arrays of data items from non-volatile storage.

+  ///

+  union {

+    ///

+    /// Array of byte-wide data items.

+    ///

+    PXE_UINT8   Byte[MAX_EEPROM_LEN << 2];

+

+    ///

+    /// Array of word-wide data items.

+    ///

+    PXE_UINT16  Word[MAX_EEPROM_LEN << 1];

+

+    ///

+    /// Array of dword-wide data items.

+    ///

+    PXE_UINT32  Dword[MAX_EEPROM_LEN];

+  } Data;

+} PXE_DB_NVDATA;

+

+typedef struct s_pxe_db_get_status {

+  ///

+  /// Length of next receive frame (header + data).  If this is zero,

+  /// there is no next receive frame available.

+  ///

+  PXE_UINT32  RxFrameLen;

+

+  ///

+  /// Reserved, set to zero.

+  ///

+  PXE_UINT32  reserved;

+

+  ///

+  ///  Addresses of transmitted buffers that need to be recycled.

+  ///

+  PXE_UINT64  TxBuffer[MAX_XMIT_BUFFERS];

+} PXE_DB_GET_STATUS;

+

+typedef struct s_pxe_cpb_fill_header {

+  ///

+  /// Source and destination MAC addresses.  These will be copied into

+  /// the media header without doing byte swapping.

+  ///

+  PXE_MAC_ADDR  SrcAddr;

+  PXE_MAC_ADDR  DestAddr;

+

+  ///

+  /// Address of first byte of media header.  The first byte of packet data

+  /// follows the last byte of the media header.

+  ///

+  PXE_UINT64        MediaHeader;

+

+  ///

+  /// Length of packet data in bytes (not including the media header).

+  ///

+  PXE_UINT32        PacketLen;

+

+  ///

+  /// Protocol type.  This will be copied into the media header without

+  /// doing byte swapping.  Protocol type numbers can be obtained from

+  /// the Assigned Numbers RFC 1700.

+  ///

+  PXE_UINT16        Protocol;

+

+  ///

+  /// Length of the media header in bytes.

+  ///

+  PXE_UINT16        MediaHeaderLen;

+} PXE_CPB_FILL_HEADER;

+

+#define PXE_PROTOCOL_ETHERNET_IP  0x0800

+#define PXE_PROTOCOL_ETHERNET_ARP 0x0806

+#define MAX_XMIT_FRAGMENTS        16

+

+typedef struct s_pxe_cpb_fill_header_fragmented {

+  ///

+  /// Source and destination MAC addresses.  These will be copied into

+  /// the media header without doing byte swapping.

+  ///

+  PXE_MAC_ADDR        SrcAddr;

+  PXE_MAC_ADDR        DestAddr;

+

+  ///

+  /// Length of packet data in bytes (not including the media header).

+  ///

+  PXE_UINT32          PacketLen;

+

+  ///

+  /// Protocol type.  This will be copied into the media header without

+  /// doing byte swapping.  Protocol type numbers can be obtained from

+  /// the Assigned Numbers RFC 1700.

+  ///

+  PXE_MEDIA_PROTOCOL  Protocol;

+

+  ///

+  /// Length of the media header in bytes.

+  ///

+  PXE_UINT16          MediaHeaderLen;

+

+  ///

+  /// Number of packet fragment descriptors.

+  ///

+  PXE_UINT16          FragCnt;

+

+  ///

+  /// Reserved, must be set to zero.

+  ///

+  PXE_UINT16          reserved;

+

+  ///

+  /// Array of packet fragment descriptors.  The first byte of the media

+  /// header is the first byte of the first fragment.

+  ///

+  struct {

+    ///

+    /// Address of this packet fragment.

+    ///

+    PXE_UINT64  FragAddr;

+

+    ///

+    /// Length of this packet fragment.

+    ///

+    PXE_UINT32  FragLen;

+

+    ///

+    /// Reserved, must be set to zero.

+    ///

+    PXE_UINT32  reserved;

+  } FragDesc[MAX_XMIT_FRAGMENTS];

+}

+PXE_CPB_FILL_HEADER_FRAGMENTED;

+

+typedef struct s_pxe_cpb_transmit {

+  ///

+  /// Address of first byte of frame buffer.  This is also the first byte

+  /// of the media header.

+  ///

+  PXE_UINT64  FrameAddr;

+

+  ///

+  /// Length of the data portion of the frame buffer in bytes.  Do not

+  /// include the length of the media header.

+  ///

+  PXE_UINT32  DataLen;

+

+  ///

+  /// Length of the media header in bytes.

+  ///

+  PXE_UINT16  MediaheaderLen;

+

+  ///

+  /// Reserved, must be zero.

+  ///

+  PXE_UINT16  reserved;

+} PXE_CPB_TRANSMIT;

+

+typedef struct s_pxe_cpb_transmit_fragments {

+  ///

+  /// Length of packet data in bytes (not including the media header).

+  ///

+  PXE_UINT32  FrameLen;

+

+  ///

+  /// Length of the media header in bytes.

+  ///

+  PXE_UINT16  MediaheaderLen;

+

+  ///

+  /// Number of packet fragment descriptors.

+  ///

+  PXE_UINT16  FragCnt;

+

+  ///

+  /// Array of frame fragment descriptors.  The first byte of the first

+  /// fragment is also the first byte of the media header.

+  ///

+  struct {

+    ///

+    /// Address of this frame fragment.

+    ///

+    PXE_UINT64  FragAddr;

+

+    ///

+    /// Length of this frame fragment.

+    ///

+    PXE_UINT32  FragLen;

+

+    ///

+    /// Reserved, must be set to zero.

+    ///

+    PXE_UINT32  reserved;

+  } FragDesc[MAX_XMIT_FRAGMENTS];

+}

+PXE_CPB_TRANSMIT_FRAGMENTS;

+

+typedef struct s_pxe_cpb_receive {

+  ///

+  /// Address of first byte of receive buffer.  This is also the first byte

+  /// of the frame header.

+  ///

+  PXE_UINT64  BufferAddr;

+

+  ///

+  /// Length of receive buffer.  This must be large enough to hold the

+  /// received frame (media header + data).  If the length of smaller than

+  /// the received frame, data will be lost.

+  ///

+  PXE_UINT32  BufferLen;

+

+  ///

+  /// Reserved, must be set to zero.

+  ///

+  PXE_UINT32  reserved;

+} PXE_CPB_RECEIVE;

+

+typedef struct s_pxe_db_receive {

+  ///

+  /// Source and destination MAC addresses from media header.

+  ///

+  PXE_MAC_ADDR        SrcAddr;

+  PXE_MAC_ADDR        DestAddr;

+

+  ///

+  /// Length of received frame.  May be larger than receive buffer size.

+  /// The receive buffer will not be overwritten.  This is how to tell

+  /// if data was lost because the receive buffer was too small.

+  ///

+  PXE_UINT32          FrameLen;

+

+  ///

+  /// Protocol type from media header.

+  ///

+  PXE_MEDIA_PROTOCOL  Protocol;

+

+  ///

+  /// Length of media header in received frame.

+  ///

+  PXE_UINT16          MediaHeaderLen;

+

+  ///

+  /// Type of receive frame.

+  ///

+  PXE_FRAME_TYPE      Type;

+

+  ///

+  /// Reserved, must be zero.

+  ///

+  PXE_UINT8           reserved[7];

+

+} PXE_DB_RECEIVE;

+

+#pragma pack()

+

+#endif

diff --git a/debugging_demo/memtest86+/efi/Include/Uefi/UefiSpec.h b/debugging_demo/memtest86+/efi/Include/Uefi/UefiSpec.h
new file mode 100644
index 0000000..558e1bc
--- /dev/null
+++ b/debugging_demo/memtest86+/efi/Include/Uefi/UefiSpec.h
@@ -0,0 +1,2231 @@
+/** @file

+  Include file that supports UEFI.

+

+  This include file must contain things defined in the UEFI 2.7 specification.

+  If a code construct is defined in the UEFI 2.7 specification it must be included

+  by this include file.

+

+Copyright (c) 2006 - 2019, Intel Corporation. All rights reserved.<BR>

+Portions Copyright (c) 2020, Hewlett Packard Enterprise Development LP. All rights reserved.<BR>

+

+SPDX-License-Identifier: BSD-2-Clause-Patent

+

+**/

+

+#ifndef __UEFI_SPEC_H__

+#define __UEFI_SPEC_H__

+

+#include <Uefi/UefiMultiPhase.h>

+

+#include <Protocol/DevicePath.h>

+#include <Protocol/SimpleTextIn.h>

+#include <Protocol/SimpleTextInEx.h>

+#include <Protocol/SimpleTextOut.h>

+

+///

+/// Enumeration of EFI memory allocation types.

+///

+typedef enum {

+  ///

+  /// Allocate any available range of pages that satisfies the request.

+  ///

+  AllocateAnyPages,

+  ///

+  /// Allocate any available range of pages whose uppermost address is less than

+  /// or equal to a specified maximum address.

+  ///

+  AllocateMaxAddress,

+  ///

+  /// Allocate pages at a specified address.

+  ///

+  AllocateAddress,

+  ///

+  /// Maximum enumeration value that may be used for bounds checking.

+  ///

+  MaxAllocateType

+} EFI_ALLOCATE_TYPE;

+

+//

+// Bit definitions for EFI_TIME.Daylight

+//

+#define EFI_TIME_ADJUST_DAYLIGHT  0x01

+#define EFI_TIME_IN_DAYLIGHT      0x02

+

+///

+/// Value definition for EFI_TIME.TimeZone.

+///

+#define EFI_UNSPECIFIED_TIMEZONE  0x07FF

+

+//

+// Memory cacheability attributes

+//

+#define EFI_MEMORY_UC               0x0000000000000001ULL

+#define EFI_MEMORY_WC               0x0000000000000002ULL

+#define EFI_MEMORY_WT               0x0000000000000004ULL

+#define EFI_MEMORY_WB               0x0000000000000008ULL

+#define EFI_MEMORY_UCE              0x0000000000000010ULL

+//

+// Physical memory protection attributes

+//

+// Note: UEFI spec 2.5 and following: use EFI_MEMORY_RO as write-protected physical memory

+// protection attribute. Also, EFI_MEMORY_WP means cacheability attribute.

+//

+#define EFI_MEMORY_WP               0x0000000000001000ULL

+#define EFI_MEMORY_RP               0x0000000000002000ULL

+#define EFI_MEMORY_XP               0x0000000000004000ULL

+#define EFI_MEMORY_RO               0x0000000000020000ULL

+//

+// Physical memory persistence attribute.

+// The memory region supports byte-addressable non-volatility.

+//

+#define EFI_MEMORY_NV               0x0000000000008000ULL

+//

+// The memory region provides higher reliability relative to other memory in the system.

+// If all memory has the same reliability, then this bit is not used.

+//

+#define EFI_MEMORY_MORE_RELIABLE    0x0000000000010000ULL

+

+//

+// Note: UEFI spec 2.8 and following:

+//

+// Specific-purpose memory (SPM). The memory is earmarked for

+// specific purposes such as for specific device drivers or applications.

+// The SPM attribute serves as a hint to the OS to avoid allocating this

+// memory for core OS data or code that can not be relocated.

+//

+#define EFI_MEMORY_SP               0x0000000000040000ULL

+//

+// If this flag is set, the memory region is capable of being

+// protected with the CPU?s memory cryptographic

+// capabilities. If this flag is clear, the memory region is not

+// capable of being protected with the CPU?s memory

+// cryptographic capabilities or the CPU does not support CPU

+// memory cryptographic capabilities.

+//

+#define EFI_MEMORY_CPU_CRYPTO       0x0000000000080000ULL

+

+//

+// Runtime memory attribute

+//

+#define EFI_MEMORY_RUNTIME          0x8000000000000000ULL

+

+///

+/// Memory descriptor version number.

+///

+#define EFI_MEMORY_DESCRIPTOR_VERSION 1

+

+///

+/// Definition of an EFI memory descriptor.

+///

+typedef struct {

+  ///

+  /// Type of the memory region.

+  /// Type EFI_MEMORY_TYPE is defined in the

+  /// AllocatePages() function description.

+  ///

+  UINT32                Type;

+  ///

+  /// Physical address of the first byte in the memory region. PhysicalStart must be

+  /// aligned on a 4 KiB boundary, and must not be above 0xfffffffffffff000. Type

+  /// EFI_PHYSICAL_ADDRESS is defined in the AllocatePages() function description

+  ///

+  EFI_PHYSICAL_ADDRESS  PhysicalStart;

+  ///

+  /// Virtual address of the first byte in the memory region.

+  /// VirtualStart must be aligned on a 4 KiB boundary,

+  /// and must not be above 0xfffffffffffff000.

+  ///

+  EFI_VIRTUAL_ADDRESS   VirtualStart;

+  ///

+  /// NumberOfPagesNumber of 4 KiB pages in the memory region.

+  /// NumberOfPages must not be 0, and must not be any value

+  /// that would represent a memory page with a start address,

+  /// either physical or virtual, above 0xfffffffffffff000.

+  ///

+  UINT64                NumberOfPages;

+  ///

+  /// Attributes of the memory region that describe the bit mask of capabilities

+  /// for that memory region, and not necessarily the current settings for that

+  /// memory region.

+  ///

+  UINT64                Attribute;

+} EFI_MEMORY_DESCRIPTOR;

+

+/**

+  Allocates memory pages from the system.

+

+  @param[in]       Type         The type of allocation to perform.

+  @param[in]       MemoryType   The type of memory to allocate.

+                                MemoryType values in the range 0x70000000..0x7FFFFFFF

+                                are reserved for OEM use. MemoryType values in the range

+                                0x80000000..0xFFFFFFFF are reserved for use by UEFI OS loaders

+                                that are provided by operating system vendors.

+  @param[in]       Pages        The number of contiguous 4 KB pages to allocate.

+  @param[in, out]  Memory       The pointer to a physical address. On input, the way in which the address is

+                                used depends on the value of Type.

+

+  @retval EFI_SUCCESS           The requested pages were allocated.

+  @retval EFI_INVALID_PARAMETER 1) Type is not AllocateAnyPages or

+                                AllocateMaxAddress or AllocateAddress.

+                                2) MemoryType is in the range

+                                EfiMaxMemoryType..0x6FFFFFFF.

+                                3) Memory is NULL.

+                                4) MemoryType is EfiPersistentMemory.

+  @retval EFI_OUT_OF_RESOURCES  The pages could not be allocated.

+  @retval EFI_NOT_FOUND         The requested pages could not be found.

+

+**/

+typedef

+EFI_STATUS

+(EFIAPI *EFI_ALLOCATE_PAGES)(

+  IN     EFI_ALLOCATE_TYPE            Type,

+  IN     EFI_MEMORY_TYPE              MemoryType,

+  IN     UINTN                        Pages,

+  IN OUT EFI_PHYSICAL_ADDRESS         *Memory

+  );

+

+/**

+  Frees memory pages.

+

+  @param[in]  Memory      The base physical address of the pages to be freed.

+  @param[in]  Pages       The number of contiguous 4 KB pages to free.

+

+  @retval EFI_SUCCESS           The requested pages were freed.

+  @retval EFI_INVALID_PARAMETER Memory is not a page-aligned address or Pages is invalid.

+  @retval EFI_NOT_FOUND         The requested memory pages were not allocated with

+                                AllocatePages().

+

+**/

+typedef

+EFI_STATUS

+(EFIAPI *EFI_FREE_PAGES)(

+  IN  EFI_PHYSICAL_ADDRESS         Memory,

+  IN  UINTN                        Pages

+  );

+

+/**

+  Returns the current memory map.

+

+  @param[in, out]  MemoryMapSize         A pointer to the size, in bytes, of the MemoryMap buffer.

+                                         On input, this is the size of the buffer allocated by the caller.

+                                         On output, it is the size of the buffer returned by the firmware if

+                                         the buffer was large enough, or the size of the buffer needed to contain

+                                         the map if the buffer was too small.

+  @param[out]      MemoryMap             A pointer to the buffer in which firmware places the current memory

+                                         map.

+  @param[out]      MapKey                A pointer to the location in which firmware returns the key for the

+                                         current memory map.

+  @param[out]      DescriptorSize        A pointer to the location in which firmware returns the size, in bytes, of

+                                         an individual EFI_MEMORY_DESCRIPTOR.

+  @param[out]      DescriptorVersion     A pointer to the location in which firmware returns the version number

+                                         associated with the EFI_MEMORY_DESCRIPTOR.

+

+  @retval EFI_SUCCESS           The memory map was returned in the MemoryMap buffer.

+  @retval EFI_BUFFER_TOO_SMALL  The MemoryMap buffer was too small. The current buffer size

+                                needed to hold the memory map is returned in MemoryMapSize.

+  @retval EFI_INVALID_PARAMETER 1) MemoryMapSize is NULL.

+                                2) The MemoryMap buffer is not too small and MemoryMap is

+                                   NULL.

+

+**/

+typedef

+EFI_STATUS

+(EFIAPI *EFI_GET_MEMORY_MAP)(

+  IN OUT UINTN                       *MemoryMapSize,

+  OUT    EFI_MEMORY_DESCRIPTOR       *MemoryMap,

+  OUT    UINTN                       *MapKey,

+  OUT    UINTN                       *DescriptorSize,

+  OUT    UINT32                      *DescriptorVersion

+  );

+

+/**

+  Allocates pool memory.

+

+  @param[in]   PoolType         The type of pool to allocate.

+                                MemoryType values in the range 0x70000000..0x7FFFFFFF

+                                are reserved for OEM use. MemoryType values in the range

+                                0x80000000..0xFFFFFFFF are reserved for use by UEFI OS loaders

+                                that are provided by operating system vendors.

+  @param[in]   Size             The number of bytes to allocate from the pool.

+  @param[out]  Buffer           A pointer to a pointer to the allocated buffer if the call succeeds;

+                                undefined otherwise.

+

+  @retval EFI_SUCCESS           The requested number of bytes was allocated.

+  @retval EFI_OUT_OF_RESOURCES  The pool requested could not be allocated.

+  @retval EFI_INVALID_PARAMETER Buffer is NULL.

+                                PoolType is in the range EfiMaxMemoryType..0x6FFFFFFF.

+                                PoolType is EfiPersistentMemory.

+

+**/

+typedef

+EFI_STATUS

+(EFIAPI *EFI_ALLOCATE_POOL)(

+  IN  EFI_MEMORY_TYPE              PoolType,

+  IN  UINTN                        Size,

+  OUT VOID                         **Buffer

+  );

+

+/**

+  Returns pool memory to the system.

+

+  @param[in]  Buffer            The pointer to the buffer to free.

+

+  @retval EFI_SUCCESS           The memory was returned to the system.

+  @retval EFI_INVALID_PARAMETER Buffer was invalid.

+

+**/

+typedef

+EFI_STATUS

+(EFIAPI *EFI_FREE_POOL)(

+  IN  VOID                         *Buffer

+  );

+

+/**

+  Changes the runtime addressing mode of EFI firmware from physical to virtual.

+

+  @param[in]  MemoryMapSize     The size in bytes of VirtualMap.

+  @param[in]  DescriptorSize    The size in bytes of an entry in the VirtualMap.

+  @param[in]  DescriptorVersion The version of the structure entries in VirtualMap.

+  @param[in]  VirtualMap        An array of memory descriptors which contain new virtual

+                                address mapping information for all runtime ranges.

+

+  @retval EFI_SUCCESS           The virtual address map has been applied.

+  @retval EFI_UNSUPPORTED       EFI firmware is not at runtime, or the EFI firmware is already in

+                                virtual address mapped mode.

+  @retval EFI_INVALID_PARAMETER DescriptorSize or DescriptorVersion is invalid.

+  @retval EFI_NO_MAPPING        A virtual address was not supplied for a range in the memory

+                                map that requires a mapping.

+  @retval EFI_NOT_FOUND         A virtual address was supplied for an address that is not found

+                                in the memory map.

+

+**/

+typedef

+EFI_STATUS

+(EFIAPI *EFI_SET_VIRTUAL_ADDRESS_MAP)(

+  IN  UINTN                        MemoryMapSize,

+  IN  UINTN                        DescriptorSize,

+  IN  UINT32                       DescriptorVersion,

+  IN  EFI_MEMORY_DESCRIPTOR        *VirtualMap

+  );

+

+/**

+  Connects one or more drivers to a controller.

+

+  @param[in]  ControllerHandle      The handle of the controller to which driver(s) are to be connected.

+  @param[in]  DriverImageHandle     A pointer to an ordered list handles that support the

+                                    EFI_DRIVER_BINDING_PROTOCOL.

+  @param[in]  RemainingDevicePath   A pointer to the device path that specifies a child of the

+                                    controller specified by ControllerHandle.

+  @param[in]  Recursive             If TRUE, then ConnectController() is called recursively

+                                    until the entire tree of controllers below the controller specified

+                                    by ControllerHandle have been created. If FALSE, then

+                                    the tree of controllers is only expanded one level.

+

+  @retval EFI_SUCCESS           1) One or more drivers were connected to ControllerHandle.

+                                2) No drivers were connected to ControllerHandle, but

+                                RemainingDevicePath is not NULL, and it is an End Device

+                                Path Node.

+  @retval EFI_INVALID_PARAMETER ControllerHandle is NULL.

+  @retval EFI_NOT_FOUND         1) There are no EFI_DRIVER_BINDING_PROTOCOL instances

+                                present in the system.

+                                2) No drivers were connected to ControllerHandle.

+  @retval EFI_SECURITY_VIOLATION

+                                The user has no permission to start UEFI device drivers on the device path

+                                associated with the ControllerHandle or specified by the RemainingDevicePath.

+**/

+typedef

+EFI_STATUS

+(EFIAPI *EFI_CONNECT_CONTROLLER)(

+  IN  EFI_HANDLE                    ControllerHandle,

+  IN  EFI_HANDLE                    *DriverImageHandle,   OPTIONAL

+  IN  EFI_DEVICE_PATH_PROTOCOL      *RemainingDevicePath, OPTIONAL

+  IN  BOOLEAN                       Recursive

+  );

+

+/**

+  Disconnects one or more drivers from a controller.

+

+  @param[in]  ControllerHandle      The handle of the controller from which driver(s) are to be disconnected.

+  @param[in]  DriverImageHandle     The driver to disconnect from ControllerHandle.

+                                    If DriverImageHandle is NULL, then all the drivers currently managing

+                                    ControllerHandle are disconnected from ControllerHandle.

+  @param[in]  ChildHandle           The handle of the child to destroy.

+                                    If ChildHandle is NULL, then all the children of ControllerHandle are

+                                    destroyed before the drivers are disconnected from ControllerHandle.

+

+  @retval EFI_SUCCESS           1) One or more drivers were disconnected from the controller.

+                                2) On entry, no drivers are managing ControllerHandle.

+                                3) DriverImageHandle is not NULL, and on entry

+                                   DriverImageHandle is not managing ControllerHandle.

+  @retval EFI_INVALID_PARAMETER 1) ControllerHandle is NULL.

+                                2) DriverImageHandle is not NULL, and it is not a valid EFI_HANDLE.

+                                3) ChildHandle is not NULL, and it is not a valid EFI_HANDLE.

+                                4) DriverImageHandle does not support the EFI_DRIVER_BINDING_PROTOCOL.

+  @retval EFI_OUT_OF_RESOURCES  There are not enough resources available to disconnect any drivers from

+                                ControllerHandle.

+  @retval EFI_DEVICE_ERROR      The controller could not be disconnected because of a device error.

+

+**/

+typedef

+EFI_STATUS

+(EFIAPI *EFI_DISCONNECT_CONTROLLER)(

+  IN  EFI_HANDLE                     ControllerHandle,

+  IN  EFI_HANDLE                     DriverImageHandle, OPTIONAL

+  IN  EFI_HANDLE                     ChildHandle        OPTIONAL

+  );

+

+

+

+//

+// ConvertPointer DebugDisposition type.

+//

+#define EFI_OPTIONAL_PTR     0x00000001

+

+/**

+  Determines the new virtual address that is to be used on subsequent memory accesses.

+

+  @param[in]       DebugDisposition  Supplies type information for the pointer being converted.

+  @param[in, out]  Address           A pointer to a pointer that is to be fixed to be the value needed

+                                     for the new virtual address mappings being applied.

+

+  @retval EFI_SUCCESS           The pointer pointed to by Address was modified.

+  @retval EFI_INVALID_PARAMETER 1) Address is NULL.

+                                2) *Address is NULL and DebugDisposition does

+                                not have the EFI_OPTIONAL_PTR bit set.

+  @retval EFI_NOT_FOUND         The pointer pointed to by Address was not found to be part

+                                of the current memory map. This is normally fatal.

+

+**/

+typedef

+EFI_STATUS

+(EFIAPI *EFI_CONVERT_POINTER)(

+  IN     UINTN                      DebugDisposition,

+  IN OUT VOID                       **Address

+  );

+

+

+//

+// These types can be ORed together as needed - for example,

+// EVT_TIMER might be Ored with EVT_NOTIFY_WAIT or

+// EVT_NOTIFY_SIGNAL.

+//

+#define EVT_TIMER                         0x80000000

+#define EVT_RUNTIME                       0x40000000

+#define EVT_NOTIFY_WAIT                   0x00000100

+#define EVT_NOTIFY_SIGNAL                 0x00000200

+

+#define EVT_SIGNAL_EXIT_BOOT_SERVICES     0x00000201

+#define EVT_SIGNAL_VIRTUAL_ADDRESS_CHANGE 0x60000202

+

+//

+// The event's NotifyContext pointer points to a runtime memory

+// address.

+// The event is deprecated in UEFI2.0 and later specifications.

+//

+#define EVT_RUNTIME_CONTEXT               0x20000000

+

+

+/**

+  Invoke a notification event

+

+  @param[in]  Event                 Event whose notification function is being invoked.

+  @param[in]  Context               The pointer to the notification function's context,

+                                    which is implementation-dependent.

+

+**/

+typedef

+VOID

+(EFIAPI *EFI_EVENT_NOTIFY)(

+  IN  EFI_EVENT                Event,

+  IN  VOID                     *Context

+  );

+

+/**

+  Creates an event.

+

+  @param[in]   Type             The type of event to create and its mode and attributes.

+  @param[in]   NotifyTpl        The task priority level of event notifications, if needed.

+  @param[in]   NotifyFunction   The pointer to the event's notification function, if any.

+  @param[in]   NotifyContext    The pointer to the notification function's context; corresponds to parameter

+                                Context in the notification function.

+  @param[out]  Event            The pointer to the newly created event if the call succeeds; undefined

+                                otherwise.

+

+  @retval EFI_SUCCESS           The event structure was created.

+  @retval EFI_INVALID_PARAMETER One or more parameters are invalid.

+  @retval EFI_OUT_OF_RESOURCES  The event could not be allocated.

+

+**/

+typedef

+EFI_STATUS

+(EFIAPI *EFI_CREATE_EVENT)(

+  IN  UINT32                       Type,

+  IN  EFI_TPL                      NotifyTpl,

+  IN  EFI_EVENT_NOTIFY             NotifyFunction,

+  IN  VOID                         *NotifyContext,

+  OUT EFI_EVENT                    *Event

+  );

+

+/**

+  Creates an event in a group.

+

+  @param[in]   Type             The type of event to create and its mode and attributes.

+  @param[in]   NotifyTpl        The task priority level of event notifications,if needed.

+  @param[in]   NotifyFunction   The pointer to the event's notification function, if any.

+  @param[in]   NotifyContext    The pointer to the notification function's context; corresponds to parameter

+                                Context in the notification function.

+  @param[in]   EventGroup       The pointer to the unique identifier of the group to which this event belongs.

+                                If this is NULL, then the function behaves as if the parameters were passed

+                                to CreateEvent.

+  @param[out]  Event            The pointer to the newly created event if the call succeeds; undefined

+                                otherwise.

+

+  @retval EFI_SUCCESS           The event structure was created.

+  @retval EFI_INVALID_PARAMETER One or more parameters are invalid.

+  @retval EFI_OUT_OF_RESOURCES  The event could not be allocated.

+

+**/

+typedef

+EFI_STATUS

+(EFIAPI *EFI_CREATE_EVENT_EX)(

+  IN       UINT32                 Type,

+  IN       EFI_TPL                NotifyTpl,

+  IN       EFI_EVENT_NOTIFY       NotifyFunction OPTIONAL,

+  IN CONST VOID                   *NotifyContext OPTIONAL,

+  IN CONST EFI_GUID               *EventGroup    OPTIONAL,

+  OUT      EFI_EVENT              *Event

+  );

+

+///

+/// Timer delay types

+///

+typedef enum {

+  ///

+  /// An event's timer settings is to be cancelled and not trigger time is to be set/

+  ///

+  TimerCancel,

+  ///

+  /// An event is to be signaled periodically at a specified interval from the current time.

+  ///

+  TimerPeriodic,

+  ///

+  /// An event is to be signaled once at a specified interval from the current time.

+  ///

+  TimerRelative

+} EFI_TIMER_DELAY;

+

+/**

+  Sets the type of timer and the trigger time for a timer event.

+

+  @param[in]  Event             The timer event that is to be signaled at the specified time.

+  @param[in]  Type              The type of time that is specified in TriggerTime.

+  @param[in]  TriggerTime       The number of 100ns units until the timer expires.

+                                A TriggerTime of 0 is legal.

+                                If Type is TimerRelative and TriggerTime is 0, then the timer

+                                event will be signaled on the next timer tick.

+                                If Type is TimerPeriodic and TriggerTime is 0, then the timer

+                                event will be signaled on every timer tick.

+

+  @retval EFI_SUCCESS           The event has been set to be signaled at the requested time.

+  @retval EFI_INVALID_PARAMETER Event or Type is not valid.

+

+**/

+typedef

+EFI_STATUS

+(EFIAPI *EFI_SET_TIMER)(

+  IN  EFI_EVENT                Event,

+  IN  EFI_TIMER_DELAY          Type,

+  IN  UINT64                   TriggerTime

+  );

+

+/**

+  Signals an event.

+

+  @param[in]  Event             The event to signal.

+

+  @retval EFI_SUCCESS           The event has been signaled.

+

+**/

+typedef

+EFI_STATUS

+(EFIAPI *EFI_SIGNAL_EVENT)(

+  IN  EFI_EVENT                Event

+  );

+

+/**

+  Stops execution until an event is signaled.

+

+  @param[in]   NumberOfEvents   The number of events in the Event array.

+  @param[in]   Event            An array of EFI_EVENT.

+  @param[out]  Index            The pointer to the index of the event which satisfied the wait condition.

+

+  @retval EFI_SUCCESS           The event indicated by Index was signaled.

+  @retval EFI_INVALID_PARAMETER 1) NumberOfEvents is 0.

+                                2) The event indicated by Index is of type

+                                   EVT_NOTIFY_SIGNAL.

+  @retval EFI_UNSUPPORTED       The current TPL is not TPL_APPLICATION.

+

+**/

+typedef

+EFI_STATUS

+(EFIAPI *EFI_WAIT_FOR_EVENT)(

+  IN  UINTN                    NumberOfEvents,

+  IN  EFI_EVENT                *Event,

+  OUT UINTN                    *Index

+  );

+

+/**

+  Closes an event.

+

+  @param[in]  Event             The event to close.

+

+  @retval EFI_SUCCESS           The event has been closed.

+

+**/

+typedef

+EFI_STATUS

+(EFIAPI *EFI_CLOSE_EVENT)(

+  IN EFI_EVENT                Event

+  );

+

+/**

+  Checks whether an event is in the signaled state.

+

+  @param[in]  Event             The event to check.

+

+  @retval EFI_SUCCESS           The event is in the signaled state.

+  @retval EFI_NOT_READY         The event is not in the signaled state.

+  @retval EFI_INVALID_PARAMETER Event is of type EVT_NOTIFY_SIGNAL.

+

+**/

+typedef

+EFI_STATUS

+(EFIAPI *EFI_CHECK_EVENT)(

+  IN EFI_EVENT                Event

+  );

+

+

+//

+// Task priority level

+//

+#define TPL_APPLICATION       4

+#define TPL_CALLBACK          8

+#define TPL_NOTIFY            16

+#define TPL_HIGH_LEVEL        31

+

+

+/**

+  Raises a task's priority level and returns its previous level.

+

+  @param[in]  NewTpl          The new task priority level.

+

+  @return Previous task priority level

+

+**/

+typedef

+EFI_TPL

+(EFIAPI *EFI_RAISE_TPL)(

+  IN EFI_TPL      NewTpl

+  );

+

+/**

+  Restores a task's priority level to its previous value.

+

+  @param[in]  OldTpl          The previous task priority level to restore.

+

+**/

+typedef

+VOID

+(EFIAPI *EFI_RESTORE_TPL)(

+  IN EFI_TPL      OldTpl

+  );

+

+/**

+  Returns the value of a variable.

+

+  @param[in]       VariableName  A Null-terminated string that is the name of the vendor's

+                                 variable.

+  @param[in]       VendorGuid    A unique identifier for the vendor.

+  @param[out]      Attributes    If not NULL, a pointer to the memory location to return the

+                                 attributes bitmask for the variable.

+  @param[in, out]  DataSize      On input, the size in bytes of the return Data buffer.

+                                 On output the size of data returned in Data.

+  @param[out]      Data          The buffer to return the contents of the variable. May be NULL

+                                 with a zero DataSize in order to determine the size buffer needed.

+

+  @retval EFI_SUCCESS            The function completed successfully.

+  @retval EFI_NOT_FOUND          The variable was not found.

+  @retval EFI_BUFFER_TOO_SMALL   The DataSize is too small for the result.

+  @retval EFI_INVALID_PARAMETER  VariableName is NULL.

+  @retval EFI_INVALID_PARAMETER  VendorGuid is NULL.

+  @retval EFI_INVALID_PARAMETER  DataSize is NULL.

+  @retval EFI_INVALID_PARAMETER  The DataSize is not too small and Data is NULL.

+  @retval EFI_DEVICE_ERROR       The variable could not be retrieved due to a hardware error.

+  @retval EFI_SECURITY_VIOLATION The variable could not be retrieved due to an authentication failure.

+

+**/

+typedef

+EFI_STATUS

+(EFIAPI *EFI_GET_VARIABLE)(

+  IN     CHAR16                      *VariableName,

+  IN     EFI_GUID                    *VendorGuid,

+  OUT    UINT32                      *Attributes,    OPTIONAL

+  IN OUT UINTN                       *DataSize,

+  OUT    VOID                        *Data           OPTIONAL

+  );

+

+/**

+  Enumerates the current variable names.

+

+  @param[in, out]  VariableNameSize The size of the VariableName buffer. The size must be large

+                                    enough to fit input string supplied in VariableName buffer.

+  @param[in, out]  VariableName     On input, supplies the last VariableName that was returned

+                                    by GetNextVariableName(). On output, returns the Nullterminated

+                                    string of the current variable.

+  @param[in, out]  VendorGuid       On input, supplies the last VendorGuid that was returned by

+                                    GetNextVariableName(). On output, returns the

+                                    VendorGuid of the current variable.

+

+  @retval EFI_SUCCESS           The function completed successfully.

+  @retval EFI_NOT_FOUND         The next variable was not found.

+  @retval EFI_BUFFER_TOO_SMALL  The VariableNameSize is too small for the result.

+                                VariableNameSize has been updated with the size needed to complete the request.

+  @retval EFI_INVALID_PARAMETER VariableNameSize is NULL.

+  @retval EFI_INVALID_PARAMETER VariableName is NULL.

+  @retval EFI_INVALID_PARAMETER VendorGuid is NULL.

+  @retval EFI_INVALID_PARAMETER The input values of VariableName and VendorGuid are not a name and

+                                GUID of an existing variable.

+  @retval EFI_INVALID_PARAMETER Null-terminator is not found in the first VariableNameSize bytes of

+                                the input VariableName buffer.

+  @retval EFI_DEVICE_ERROR      The variable could not be retrieved due to a hardware error.

+

+**/

+typedef

+EFI_STATUS

+(EFIAPI *EFI_GET_NEXT_VARIABLE_NAME)(

+  IN OUT UINTN                    *VariableNameSize,

+  IN OUT CHAR16                   *VariableName,

+  IN OUT EFI_GUID                 *VendorGuid

+  );

+

+/**

+  Sets the value of a variable.

+

+  @param[in]  VariableName       A Null-terminated string that is the name of the vendor's variable.

+                                 Each VariableName is unique for each VendorGuid. VariableName must

+                                 contain 1 or more characters. If VariableName is an empty string,

+                                 then EFI_INVALID_PARAMETER is returned.

+  @param[in]  VendorGuid         A unique identifier for the vendor.

+  @param[in]  Attributes         Attributes bitmask to set for the variable.

+  @param[in]  DataSize           The size in bytes of the Data buffer. Unless the EFI_VARIABLE_APPEND_WRITE or

+                                 EFI_VARIABLE_TIME_BASED_AUTHENTICATED_WRITE_ACCESS attribute is set, a size of zero

+                                 causes the variable to be deleted. When the EFI_VARIABLE_APPEND_WRITE attribute is

+                                 set, then a SetVariable() call with a DataSize of zero will not cause any change to

+                                 the variable value (the timestamp associated with the variable may be updated however

+                                 even if no new data value is provided,see the description of the

+                                 EFI_VARIABLE_AUTHENTICATION_2 descriptor below. In this case the DataSize will not

+                                 be zero since the EFI_VARIABLE_AUTHENTICATION_2 descriptor will be populated).

+  @param[in]  Data               The contents for the variable.

+

+  @retval EFI_SUCCESS            The firmware has successfully stored the variable and its data as

+                                 defined by the Attributes.

+  @retval EFI_INVALID_PARAMETER  An invalid combination of attribute bits, name, and GUID was supplied, or the

+                                 DataSize exceeds the maximum allowed.

+  @retval EFI_INVALID_PARAMETER  VariableName is an empty string.

+  @retval EFI_OUT_OF_RESOURCES   Not enough storage is available to hold the variable and its data.

+  @retval EFI_DEVICE_ERROR       The variable could not be retrieved due to a hardware error.

+  @retval EFI_WRITE_PROTECTED    The variable in question is read-only.

+  @retval EFI_WRITE_PROTECTED    The variable in question cannot be deleted.

+  @retval EFI_SECURITY_VIOLATION The variable could not be written due to EFI_VARIABLE_TIME_BASED_AUTHENTICATED_WRITE_ACESS being set,

+                                 but the AuthInfo does NOT pass the validation check carried out by the firmware.

+

+  @retval EFI_NOT_FOUND          The variable trying to be updated or deleted was not found.

+

+**/

+typedef

+EFI_STATUS

+(EFIAPI *EFI_SET_VARIABLE)(

+  IN  CHAR16                       *VariableName,

+  IN  EFI_GUID                     *VendorGuid,

+  IN  UINT32                       Attributes,

+  IN  UINTN                        DataSize,

+  IN  VOID                         *Data

+  );

+

+

+///

+/// This provides the capabilities of the

+/// real time clock device as exposed through the EFI interfaces.

+///

+typedef struct {

+  ///

+  /// Provides the reporting resolution of the real-time clock device in

+  /// counts per second. For a normal PC-AT CMOS RTC device, this

+  /// value would be 1 Hz, or 1, to indicate that the device only reports

+  /// the time to the resolution of 1 second.

+  ///

+  UINT32    Resolution;

+  ///

+  /// Provides the timekeeping accuracy of the real-time clock in an

+  /// error rate of 1E-6 parts per million. For a clock with an accuracy

+  /// of 50 parts per million, the value in this field would be

+  /// 50,000,000.

+  ///

+  UINT32    Accuracy;

+  ///

+  /// A TRUE indicates that a time set operation clears the device's

+  /// time below the Resolution reporting level. A FALSE

+  /// indicates that the state below the Resolution level of the

+  /// device is not cleared when the time is set. Normal PC-AT CMOS

+  /// RTC devices set this value to FALSE.

+  ///

+  BOOLEAN   SetsToZero;

+} EFI_TIME_CAPABILITIES;

+

+/**

+  Returns the current time and date information, and the time-keeping capabilities

+  of the hardware platform.

+

+  @param[out]  Time             A pointer to storage to receive a snapshot of the current time.

+  @param[out]  Capabilities     An optional pointer to a buffer to receive the real time clock

+                                device's capabilities.

+

+  @retval EFI_SUCCESS           The operation completed successfully.

+  @retval EFI_INVALID_PARAMETER Time is NULL.

+  @retval EFI_DEVICE_ERROR      The time could not be retrieved due to hardware error.

+

+**/

+typedef

+EFI_STATUS

+(EFIAPI *EFI_GET_TIME)(

+  OUT  EFI_TIME                    *Time,

+  OUT  EFI_TIME_CAPABILITIES       *Capabilities OPTIONAL

+  );

+

+/**

+  Sets the current local time and date information.

+

+  @param[in]  Time              A pointer to the current time.

+

+  @retval EFI_SUCCESS           The operation completed successfully.

+  @retval EFI_INVALID_PARAMETER A time field is out of range.

+  @retval EFI_DEVICE_ERROR      The time could not be set due due to hardware error.

+

+**/

+typedef

+EFI_STATUS

+(EFIAPI *EFI_SET_TIME)(

+  IN  EFI_TIME                     *Time

+  );

+

+/**

+  Returns the current wakeup alarm clock setting.

+

+  @param[out]  Enabled          Indicates if the alarm is currently enabled or disabled.

+  @param[out]  Pending          Indicates if the alarm signal is pending and requires acknowledgement.

+  @param[out]  Time             The current alarm setting.

+

+  @retval EFI_SUCCESS           The alarm settings were returned.

+  @retval EFI_INVALID_PARAMETER Enabled is NULL.

+  @retval EFI_INVALID_PARAMETER Pending is NULL.

+  @retval EFI_INVALID_PARAMETER Time is NULL.

+  @retval EFI_DEVICE_ERROR      The wakeup time could not be retrieved due to a hardware error.

+  @retval EFI_UNSUPPORTED       A wakeup timer is not supported on this platform.

+

+**/

+typedef

+EFI_STATUS

+(EFIAPI *EFI_GET_WAKEUP_TIME)(

+  OUT BOOLEAN                     *Enabled,

+  OUT BOOLEAN                     *Pending,

+  OUT EFI_TIME                    *Time

+  );

+

+/**

+  Sets the system wakeup alarm clock time.

+

+  @param[in]  Enable            Enable or disable the wakeup alarm.

+  @param[in]  Time              If Enable is TRUE, the time to set the wakeup alarm for.

+                                If Enable is FALSE, then this parameter is optional, and may be NULL.

+

+  @retval EFI_SUCCESS           If Enable is TRUE, then the wakeup alarm was enabled. If

+                                Enable is FALSE, then the wakeup alarm was disabled.

+  @retval EFI_INVALID_PARAMETER A time field is out of range.

+  @retval EFI_DEVICE_ERROR      The wakeup time could not be set due to a hardware error.

+  @retval EFI_UNSUPPORTED       A wakeup timer is not supported on this platform.

+

+**/

+typedef

+EFI_STATUS

+(EFIAPI *EFI_SET_WAKEUP_TIME)(

+  IN  BOOLEAN                      Enable,

+  IN  EFI_TIME                     *Time   OPTIONAL

+  );

+

+/**

+  Loads an EFI image into memory.

+

+  @param[in]   BootPolicy        If TRUE, indicates that the request originates from the boot

+                                 manager, and that the boot manager is attempting to load

+                                 FilePath as a boot selection. Ignored if SourceBuffer is

+                                 not NULL.

+  @param[in]   ParentImageHandle The caller's image handle.

+  @param[in]   DevicePath        The DeviceHandle specific file path from which the image is

+                                 loaded.

+  @param[in]   SourceBuffer      If not NULL, a pointer to the memory location containing a copy

+                                 of the image to be loaded.

+  @param[in]   SourceSize        The size in bytes of SourceBuffer. Ignored if SourceBuffer is NULL.

+  @param[out]  ImageHandle       The pointer to the returned image handle that is created when the

+                                 image is successfully loaded.

+

+  @retval EFI_SUCCESS            Image was loaded into memory correctly.

+  @retval EFI_NOT_FOUND          Both SourceBuffer and DevicePath are NULL.

+  @retval EFI_INVALID_PARAMETER  One or more parametes are invalid.

+  @retval EFI_UNSUPPORTED        The image type is not supported.

+  @retval EFI_OUT_OF_RESOURCES   Image was not loaded due to insufficient resources.

+  @retval EFI_LOAD_ERROR         Image was not loaded because the image format was corrupt or not

+                                 understood.

+  @retval EFI_DEVICE_ERROR       Image was not loaded because the device returned a read error.

+  @retval EFI_ACCESS_DENIED      Image was not loaded because the platform policy prohibits the

+                                 image from being loaded. NULL is returned in *ImageHandle.

+  @retval EFI_SECURITY_VIOLATION Image was loaded and an ImageHandle was created with a

+                                 valid EFI_LOADED_IMAGE_PROTOCOL. However, the current

+                                 platform policy specifies that the image should not be started.

+**/

+typedef

+EFI_STATUS

+(EFIAPI *EFI_IMAGE_LOAD)(

+  IN  BOOLEAN                      BootPolicy,

+  IN  EFI_HANDLE                   ParentImageHandle,

+  IN  EFI_DEVICE_PATH_PROTOCOL     *DevicePath,

+  IN  VOID                         *SourceBuffer OPTIONAL,

+  IN  UINTN                        SourceSize,

+  OUT EFI_HANDLE                   *ImageHandle

+  );

+

+/**

+  Transfers control to a loaded image's entry point.

+

+  @param[in]   ImageHandle       Handle of image to be started.

+  @param[out]  ExitDataSize      The pointer to the size, in bytes, of ExitData.

+  @param[out]  ExitData          The pointer to a pointer to a data buffer that includes a Null-terminated

+                                 string, optionally followed by additional binary data.

+

+  @retval EFI_INVALID_PARAMETER  ImageHandle is either an invalid image handle or the image

+                                 has already been initialized with StartImage.

+  @retval EFI_SECURITY_VIOLATION The current platform policy specifies that the image should not be started.

+  @return Exit code from image

+

+**/

+typedef

+EFI_STATUS

+(EFIAPI *EFI_IMAGE_START)(

+  IN  EFI_HANDLE                  ImageHandle,

+  OUT UINTN                       *ExitDataSize,

+  OUT CHAR16                      **ExitData    OPTIONAL

+  );

+

+/**

+  Terminates a loaded EFI image and returns control to boot services.

+

+  @param[in]  ImageHandle       Handle that identifies the image. This parameter is passed to the

+                                image on entry.

+  @param[in]  ExitStatus        The image's exit code.

+  @param[in]  ExitDataSize      The size, in bytes, of ExitData. Ignored if ExitStatus is EFI_SUCCESS.

+  @param[in]  ExitData          The pointer to a data buffer that includes 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 image's exit. ExitData is only valid if ExitStatus

+                                is something other than EFI_SUCCESS. The ExitData buffer

+                                must be allocated by calling AllocatePool().

+

+  @retval EFI_SUCCESS           The image specified by ImageHandle was unloaded.

+  @retval EFI_INVALID_PARAMETER The image specified by ImageHandle has been loaded and

+                                started with LoadImage() and StartImage(), but the

+                                image is not the currently executing image.

+

+**/

+typedef

+EFI_STATUS

+(EFIAPI *EFI_EXIT)(

+  IN  EFI_HANDLE                   ImageHandle,

+  IN  EFI_STATUS                   ExitStatus,

+  IN  UINTN                        ExitDataSize,

+  IN  CHAR16                       *ExitData     OPTIONAL

+  );

+

+/**

+  Unloads an image.

+

+  @param[in]  ImageHandle       Handle that identifies the image to be unloaded.

+

+  @retval EFI_SUCCESS           The image has been unloaded.

+  @retval EFI_INVALID_PARAMETER ImageHandle is not a valid image handle.

+

+**/

+typedef

+EFI_STATUS

+(EFIAPI *EFI_IMAGE_UNLOAD)(

+  IN  EFI_HANDLE                   ImageHandle

+  );

+

+/**

+  Terminates all boot services.

+

+  @param[in]  ImageHandle       Handle that identifies the exiting image.

+  @param[in]  MapKey            Key to the latest memory map.

+

+  @retval EFI_SUCCESS           Boot services have been terminated.

+  @retval EFI_INVALID_PARAMETER MapKey is incorrect.

+

+**/

+typedef

+EFI_STATUS

+(EFIAPI *EFI_EXIT_BOOT_SERVICES)(

+  IN  EFI_HANDLE                   ImageHandle,

+  IN  UINTN                        MapKey

+  );

+

+/**

+  Induces a fine-grained stall.

+

+  @param[in]  Microseconds      The number of microseconds to stall execution.

+

+  @retval EFI_SUCCESS           Execution was stalled at least the requested number of

+                                Microseconds.

+

+**/

+typedef

+EFI_STATUS

+(EFIAPI *EFI_STALL)(

+  IN  UINTN                    Microseconds

+  );

+

+/**

+  Sets the system's watchdog timer.

+

+  @param[in]  Timeout           The number of seconds to set the watchdog timer to.

+  @param[in]  WatchdogCode      The numeric code to log on a watchdog timer timeout event.

+  @param[in]  DataSize          The size, in bytes, of WatchdogData.

+  @param[in]  WatchdogData      A data buffer that includes a Null-terminated string, optionally

+                                followed by additional binary data.

+

+  @retval EFI_SUCCESS           The timeout has been set.

+  @retval EFI_INVALID_PARAMETER The supplied WatchdogCode is invalid.

+  @retval EFI_UNSUPPORTED       The system does not have a watchdog timer.

+  @retval EFI_DEVICE_ERROR      The watchdog timer could not be programmed due to a hardware

+                                error.

+

+**/

+typedef

+EFI_STATUS

+(EFIAPI *EFI_SET_WATCHDOG_TIMER)(

+  IN UINTN                    Timeout,

+  IN UINT64                   WatchdogCode,

+  IN UINTN                    DataSize,

+  IN CHAR16                   *WatchdogData OPTIONAL

+  );

+

+/**

+  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.

+                                For a ResetType of EfiResetPlatformSpecific the data buffer

+                                also starts with a Null-terminated string that is followed

+                                by an EFI_GUID that describes the specific type of reset to perform.

+**/

+typedef

+VOID

+(EFIAPI *EFI_RESET_SYSTEM)(

+  IN EFI_RESET_TYPE           ResetType,

+  IN EFI_STATUS               ResetStatus,

+  IN UINTN                    DataSize,

+  IN VOID                     *ResetData OPTIONAL

+  );

+

+/**

+  Returns a monotonically increasing count for the platform.

+

+  @param[out]  Count            The pointer to returned value.

+

+  @retval EFI_SUCCESS           The next monotonic count was returned.

+  @retval EFI_INVALID_PARAMETER Count is NULL.

+  @retval EFI_DEVICE_ERROR      The device is not functioning properly.

+

+**/

+typedef

+EFI_STATUS

+(EFIAPI *EFI_GET_NEXT_MONOTONIC_COUNT)(

+  OUT UINT64                  *Count

+  );

+

+/**

+  Returns the next high 32 bits of the platform's monotonic counter.

+

+  @param[out]  HighCount        The pointer to returned value.

+

+  @retval EFI_SUCCESS           The next high monotonic count was returned.

+  @retval EFI_INVALID_PARAMETER HighCount is NULL.

+  @retval EFI_DEVICE_ERROR      The device is not functioning properly.

+

+**/

+typedef

+EFI_STATUS

+(EFIAPI *EFI_GET_NEXT_HIGH_MONO_COUNT)(

+  OUT UINT32                  *HighCount

+  );

+

+/**

+  Computes and returns a 32-bit CRC for a data buffer.

+

+  @param[in]   Data             A pointer to the buffer on which the 32-bit CRC is to be computed.

+  @param[in]   DataSize         The number of bytes in the buffer Data.

+  @param[out]  Crc32            The 32-bit CRC that was computed for the data buffer specified by Data

+                                and DataSize.

+

+  @retval EFI_SUCCESS           The 32-bit CRC was computed for the data buffer and returned in

+                                Crc32.

+  @retval EFI_INVALID_PARAMETER Data is NULL.

+  @retval EFI_INVALID_PARAMETER Crc32 is NULL.

+  @retval EFI_INVALID_PARAMETER DataSize is 0.

+

+**/

+typedef

+EFI_STATUS

+(EFIAPI *EFI_CALCULATE_CRC32)(

+  IN  VOID                              *Data,

+  IN  UINTN                             DataSize,

+  OUT UINT32                            *Crc32

+  );

+

+/**

+  Copies the contents of one buffer to another buffer.

+

+  @param[in]  Destination       The pointer to the destination buffer of the memory copy.

+  @param[in]  Source            The pointer to the source buffer of the memory copy.

+  @param[in]  Length            Number of bytes to copy from Source to Destination.

+

+**/

+typedef

+VOID

+(EFIAPI *EFI_COPY_MEM)(

+  IN VOID     *Destination,

+  IN VOID     *Source,

+  IN UINTN    Length

+  );

+

+/**

+  The SetMem() function fills a buffer with a specified value.

+

+  @param[in]  Buffer            The pointer to the buffer to fill.

+  @param[in]  Size              Number of bytes in Buffer to fill.

+  @param[in]  Value             Value to fill Buffer with.

+

+**/

+typedef

+VOID

+(EFIAPI *EFI_SET_MEM)(

+  IN VOID     *Buffer,

+  IN UINTN    Size,

+  IN UINT8    Value

+  );

+

+///

+/// Enumeration of EFI Interface Types

+///

+typedef enum {

+  ///

+  /// Indicates that the supplied protocol interface is supplied in native form.

+  ///

+  EFI_NATIVE_INTERFACE

+} EFI_INTERFACE_TYPE;

+

+/**

+  Installs a protocol interface on a device handle. If the handle does not exist, it is created and added

+  to the list of handles in the system. InstallMultipleProtocolInterfaces() performs

+  more error checking than InstallProtocolInterface(), so it is recommended that

+  InstallMultipleProtocolInterfaces() be used in place of

+  InstallProtocolInterface()

+

+  @param[in, out]  Handle         A pointer to the EFI_HANDLE on which the interface is to be installed.

+  @param[in]       Protocol       The numeric ID of the protocol interface.

+  @param[in]       InterfaceType  Indicates whether Interface is supplied in native form.

+  @param[in]       Interface      A pointer to the protocol interface.

+

+  @retval EFI_SUCCESS           The protocol interface was installed.

+  @retval EFI_OUT_OF_RESOURCES  Space for a new handle could not be allocated.

+  @retval EFI_INVALID_PARAMETER Handle is NULL.

+  @retval EFI_INVALID_PARAMETER Protocol is NULL.

+  @retval EFI_INVALID_PARAMETER InterfaceType is not EFI_NATIVE_INTERFACE.

+  @retval EFI_INVALID_PARAMETER Protocol is already installed on the handle specified by Handle.

+

+**/

+typedef

+EFI_STATUS

+(EFIAPI *EFI_INSTALL_PROTOCOL_INTERFACE)(

+  IN OUT EFI_HANDLE               *Handle,

+  IN     EFI_GUID                 *Protocol,

+  IN     EFI_INTERFACE_TYPE       InterfaceType,

+  IN     VOID                     *Interface

+  );

+

+/**

+  Installs one or more protocol interfaces into the boot services environment.

+

+  @param[in, out]  Handle       The pointer to a handle to install the new protocol interfaces on,

+                                or a pointer to NULL if a new handle is to be allocated.

+  @param  ...                   A variable argument list containing pairs of protocol GUIDs and protocol

+                                interfaces.

+

+  @retval EFI_SUCCESS           All the protocol interface was installed.

+  @retval EFI_OUT_OF_RESOURCES  There was not enough memory in pool to install all the protocols.

+  @retval EFI_ALREADY_STARTED   A Device Path Protocol instance was passed in that is already present in

+                                the handle database.

+  @retval EFI_INVALID_PARAMETER Handle is NULL.

+  @retval EFI_INVALID_PARAMETER Protocol is already installed on the handle specified by Handle.

+

+**/

+typedef

+EFI_STATUS

+(EFIAPI *EFI_INSTALL_MULTIPLE_PROTOCOL_INTERFACES)(

+  IN OUT EFI_HANDLE           *Handle,

+  ...

+  );

+

+/**

+  Reinstalls a protocol interface on a device handle.

+

+  @param[in]  Handle            Handle on which the interface is to be reinstalled.

+  @param[in]  Protocol          The numeric ID of the interface.

+  @param[in]  OldInterface      A pointer to the old interface. NULL can be used if a structure is not

+                                associated with Protocol.

+  @param[in]  NewInterface      A pointer to the new interface.

+

+  @retval EFI_SUCCESS           The protocol interface was reinstalled.

+  @retval EFI_NOT_FOUND         The OldInterface on the handle was not found.

+  @retval EFI_ACCESS_DENIED     The protocol interface could not be reinstalled,

+                                because OldInterface is still being used by a

+                                driver that will not release it.

+  @retval EFI_INVALID_PARAMETER Handle is NULL.

+  @retval EFI_INVALID_PARAMETER Protocol is NULL.

+

+**/

+typedef

+EFI_STATUS

+(EFIAPI *EFI_REINSTALL_PROTOCOL_INTERFACE)(

+  IN EFI_HANDLE               Handle,

+  IN EFI_GUID                 *Protocol,

+  IN VOID                     *OldInterface,

+  IN VOID                     *NewInterface

+  );

+

+/**

+  Removes a protocol interface from a device handle. It is recommended that

+  UninstallMultipleProtocolInterfaces() be used in place of

+  UninstallProtocolInterface().

+

+  @param[in]  Handle            The handle on which the interface was installed.

+  @param[in]  Protocol          The numeric ID of the interface.

+  @param[in]  Interface         A pointer to the interface.

+

+  @retval EFI_SUCCESS           The interface was removed.

+  @retval EFI_NOT_FOUND         The interface was not found.

+  @retval EFI_ACCESS_DENIED     The interface was not removed because the interface

+                                is still being used by a driver.

+  @retval EFI_INVALID_PARAMETER Handle is NULL.

+  @retval EFI_INVALID_PARAMETER Protocol is NULL.

+

+**/

+typedef

+EFI_STATUS

+(EFIAPI *EFI_UNINSTALL_PROTOCOL_INTERFACE)(

+  IN EFI_HANDLE               Handle,

+  IN EFI_GUID                 *Protocol,

+  IN VOID                     *Interface

+  );

+

+/**

+  Removes one or more protocol interfaces into the boot services environment.

+

+  @param[in]  Handle            The handle to remove the protocol interfaces from.

+  @param  ...                   A variable argument list containing pairs of protocol GUIDs and

+                                protocol interfaces.

+

+  @retval EFI_SUCCESS           All the protocol interfaces were removed.

+  @retval EFI_INVALID_PARAMETER One of the protocol interfaces was not previously installed on Handle.

+

+**/

+typedef

+EFI_STATUS

+(EFIAPI *EFI_UNINSTALL_MULTIPLE_PROTOCOL_INTERFACES)(

+  IN EFI_HANDLE           Handle,

+  ...

+  );

+

+/**

+  Queries a handle to determine if it supports a specified protocol.

+

+  @param[in]   Handle           The handle being queried.

+  @param[in]   Protocol         The published unique identifier of the protocol.

+  @param[out]  Interface        Supplies the address where a pointer to the corresponding Protocol

+                                Interface is returned.

+

+  @retval EFI_SUCCESS           The interface information for the specified protocol was returned.

+  @retval EFI_UNSUPPORTED       The device does not support the specified protocol.

+  @retval EFI_INVALID_PARAMETER Handle is NULL.

+  @retval EFI_INVALID_PARAMETER Protocol is NULL.

+  @retval EFI_INVALID_PARAMETER Interface is NULL.

+

+**/

+typedef

+EFI_STATUS

+(EFIAPI *EFI_HANDLE_PROTOCOL)(

+  IN  EFI_HANDLE               Handle,

+  IN  EFI_GUID                 *Protocol,

+  OUT VOID                     **Interface

+  );

+

+#define EFI_OPEN_PROTOCOL_BY_HANDLE_PROTOCOL  0x00000001

+#define EFI_OPEN_PROTOCOL_GET_PROTOCOL        0x00000002

+#define EFI_OPEN_PROTOCOL_TEST_PROTOCOL       0x00000004

+#define EFI_OPEN_PROTOCOL_BY_CHILD_CONTROLLER 0x00000008

+#define EFI_OPEN_PROTOCOL_BY_DRIVER           0x00000010

+#define EFI_OPEN_PROTOCOL_EXCLUSIVE           0x00000020

+

+/**

+  Queries a handle to determine if it supports a specified protocol. If the protocol is supported by the

+  handle, it opens the protocol on behalf of the calling agent.

+

+  @param[in]   Handle           The handle for the protocol interface that is being opened.

+  @param[in]   Protocol         The published unique identifier of the protocol.

+  @param[out]  Interface        Supplies the address where a pointer to the corresponding Protocol

+                                Interface is returned.

+  @param[in]   AgentHandle      The handle of the agent that is opening the protocol interface

+                                specified by Protocol and Interface.

+  @param[in]   ControllerHandle If the agent that is opening a protocol is a driver that follows the

+                                UEFI Driver Model, then this parameter is the controller handle

+                                that requires the protocol interface. If the agent does not follow

+                                the UEFI Driver Model, then this parameter is optional and may

+                                be NULL.

+  @param[in]   Attributes       The open mode of the protocol interface specified by Handle

+                                and Protocol.

+

+  @retval EFI_SUCCESS           An item was added to the open list for the protocol interface, and the

+                                protocol interface was returned in Interface.

+  @retval EFI_UNSUPPORTED       Handle does not support Protocol.

+  @retval EFI_INVALID_PARAMETER One or more parameters are invalid.

+  @retval EFI_ACCESS_DENIED     Required attributes can't be supported in current environment.

+  @retval EFI_ALREADY_STARTED   Item on the open list already has requierd attributes whose agent

+                                handle is the same as AgentHandle.

+

+**/

+typedef

+EFI_STATUS

+(EFIAPI *EFI_OPEN_PROTOCOL)(

+  IN  EFI_HANDLE                Handle,

+  IN  EFI_GUID                  *Protocol,

+  OUT VOID                      **Interface, OPTIONAL

+  IN  EFI_HANDLE                AgentHandle,

+  IN  EFI_HANDLE                ControllerHandle,

+  IN  UINT32                    Attributes

+  );

+

+

+/**

+  Closes a protocol on a handle that was opened using OpenProtocol().

+

+  @param[in]  Handle            The handle for the protocol interface that was previously opened

+                                with OpenProtocol(), and is now being closed.

+  @param[in]  Protocol          The published unique identifier of the protocol.

+  @param[in]  AgentHandle       The handle of the agent that is closing the protocol interface.

+  @param[in]  ControllerHandle  If the agent that opened a protocol is a driver that follows the

+                                UEFI Driver Model, then this parameter is the controller handle

+                                that required the protocol interface.

+

+  @retval EFI_SUCCESS           The protocol instance was closed.

+  @retval EFI_INVALID_PARAMETER 1) Handle is NULL.

+                                2) AgentHandle is NULL.

+                                3) ControllerHandle is not NULL and ControllerHandle is not a valid EFI_HANDLE.

+                                4) Protocol is NULL.

+  @retval EFI_NOT_FOUND         1) Handle does not support the protocol specified by Protocol.

+                                2) The protocol interface specified by Handle and Protocol is not

+                                   currently open by AgentHandle and ControllerHandle.

+

+**/

+typedef

+EFI_STATUS

+(EFIAPI *EFI_CLOSE_PROTOCOL)(

+  IN EFI_HANDLE               Handle,

+  IN EFI_GUID                 *Protocol,

+  IN EFI_HANDLE               AgentHandle,

+  IN EFI_HANDLE               ControllerHandle

+  );

+

+///

+/// EFI Oprn Protocol Information Entry

+///

+typedef struct {

+  EFI_HANDLE  AgentHandle;

+  EFI_HANDLE  ControllerHandle;

+  UINT32      Attributes;

+  UINT32      OpenCount;

+} EFI_OPEN_PROTOCOL_INFORMATION_ENTRY;

+

+/**

+  Retrieves the list of agents that currently have a protocol interface opened.

+

+  @param[in]   Handle           The handle for the protocol interface that is being queried.

+  @param[in]   Protocol         The published unique identifier of the protocol.

+  @param[out]  EntryBuffer      A pointer to a buffer of open protocol information in the form of

+                                EFI_OPEN_PROTOCOL_INFORMATION_ENTRY structures.

+  @param[out]  EntryCount       A pointer to the number of entries in EntryBuffer.

+

+  @retval EFI_SUCCESS           The open protocol information was returned in EntryBuffer, and the

+                                number of entries was returned EntryCount.

+  @retval EFI_OUT_OF_RESOURCES  There are not enough resources available to allocate EntryBuffer.

+  @retval EFI_NOT_FOUND         Handle does not support the protocol specified by Protocol.

+

+**/

+typedef

+EFI_STATUS

+(EFIAPI *EFI_OPEN_PROTOCOL_INFORMATION)(

+  IN  EFI_HANDLE                          Handle,

+  IN  EFI_GUID                            *Protocol,

+  OUT EFI_OPEN_PROTOCOL_INFORMATION_ENTRY **EntryBuffer,

+  OUT UINTN                               *EntryCount

+  );

+

+/**

+  Retrieves the list of protocol interface GUIDs that are installed on a handle in a buffer allocated

+  from pool.

+

+  @param[in]   Handle              The handle from which to retrieve the list of protocol interface

+                                   GUIDs.

+  @param[out]  ProtocolBuffer      A pointer to the list of protocol interface GUID pointers that are

+                                   installed on Handle.

+  @param[out]  ProtocolBufferCount A pointer to the number of GUID pointers present in

+                                   ProtocolBuffer.

+

+  @retval EFI_SUCCESS           The list of protocol interface GUIDs installed on Handle was returned in

+                                ProtocolBuffer. The number of protocol interface GUIDs was

+                                returned in ProtocolBufferCount.

+  @retval EFI_OUT_OF_RESOURCES  There is not enough pool memory to store the results.

+  @retval EFI_INVALID_PARAMETER Handle is NULL.

+  @retval EFI_INVALID_PARAMETER Handle is not a valid EFI_HANDLE.

+  @retval EFI_INVALID_PARAMETER ProtocolBuffer is NULL.

+  @retval EFI_INVALID_PARAMETER ProtocolBufferCount is NULL.

+

+**/

+typedef

+EFI_STATUS

+(EFIAPI *EFI_PROTOCOLS_PER_HANDLE)(

+  IN  EFI_HANDLE      Handle,

+  OUT EFI_GUID        ***ProtocolBuffer,

+  OUT UINTN           *ProtocolBufferCount

+  );

+

+/**

+  Creates an event that is to be signaled whenever an interface is installed for a specified protocol.

+

+  @param[in]   Protocol         The numeric ID of the protocol for which the event is to be registered.

+  @param[in]   Event            Event that is to be signaled whenever a protocol interface is registered

+                                for Protocol.

+  @param[out]  Registration     A pointer to a memory location to receive the registration value.

+

+  @retval EFI_SUCCESS           The notification event has been registered.

+  @retval EFI_OUT_OF_RESOURCES  Space for the notification event could not be allocated.

+  @retval EFI_INVALID_PARAMETER Protocol is NULL.

+  @retval EFI_INVALID_PARAMETER Event is NULL.

+  @retval EFI_INVALID_PARAMETER Registration is NULL.

+

+**/

+typedef

+EFI_STATUS

+(EFIAPI *EFI_REGISTER_PROTOCOL_NOTIFY)(

+  IN  EFI_GUID                 *Protocol,

+  IN  EFI_EVENT                Event,

+  OUT VOID                     **Registration

+  );

+

+///

+/// Enumeration of EFI Locate Search Types

+///

+typedef enum {

+  ///

+  /// Retrieve all the handles in the handle database.

+  ///

+  AllHandles,

+  ///

+  /// Retrieve the next handle fron a RegisterProtocolNotify() event.

+  ///

+  ByRegisterNotify,

+  ///

+  /// Retrieve the set of handles from the handle database that support a

+  /// specified protocol.

+  ///

+  ByProtocol

+} EFI_LOCATE_SEARCH_TYPE;

+

+/**

+  Returns an array of handles that support a specified protocol.

+

+  @param[in]       SearchType   Specifies which handle(s) are to be returned.

+  @param[in]       Protocol     Specifies the protocol to search by.

+  @param[in]       SearchKey    Specifies the search key.

+  @param[in, out]  BufferSize   On input, the size in bytes of Buffer. On output, the size in bytes of

+                                the array returned in Buffer (if the buffer was large enough) or the

+                                size, in bytes, of the buffer needed to obtain the array (if the buffer was

+                                not large enough).

+  @param[out]      Buffer       The buffer in which the array is returned.

+

+  @retval EFI_SUCCESS           The array of handles was returned.

+  @retval EFI_NOT_FOUND         No handles match the search.

+  @retval EFI_BUFFER_TOO_SMALL  The BufferSize is too small for the result.

+  @retval EFI_INVALID_PARAMETER SearchType is not a member of EFI_LOCATE_SEARCH_TYPE.

+  @retval EFI_INVALID_PARAMETER SearchType is ByRegisterNotify and SearchKey is NULL.

+  @retval EFI_INVALID_PARAMETER SearchType is ByProtocol and Protocol is NULL.

+  @retval EFI_INVALID_PARAMETER One or more matches are found and BufferSize is NULL.

+  @retval EFI_INVALID_PARAMETER BufferSize is large enough for the result and Buffer is NULL.

+

+**/

+typedef

+EFI_STATUS

+(EFIAPI *EFI_LOCATE_HANDLE)(

+  IN     EFI_LOCATE_SEARCH_TYPE   SearchType,

+  IN     EFI_GUID                 *Protocol,    OPTIONAL

+  IN     VOID                     *SearchKey,   OPTIONAL

+  IN OUT UINTN                    *BufferSize,

+  OUT    EFI_HANDLE               *Buffer

+  );

+

+/**

+  Locates the handle to a device on the device path that supports the specified protocol.

+

+  @param[in]       Protocol     Specifies the protocol to search for.

+  @param[in, out]  DevicePath   On input, a pointer to a pointer to the device path. On output, the device

+                                path pointer is modified to point to the remaining part of the device

+                                path.

+  @param[out]      Device       A pointer to the returned device handle.

+

+  @retval EFI_SUCCESS           The resulting handle was returned.

+  @retval EFI_NOT_FOUND         No handles match the search.

+  @retval EFI_INVALID_PARAMETER Protocol is NULL.

+  @retval EFI_INVALID_PARAMETER DevicePath is NULL.

+  @retval EFI_INVALID_PARAMETER A handle matched the search and Device is NULL.

+

+**/

+typedef

+EFI_STATUS

+(EFIAPI *EFI_LOCATE_DEVICE_PATH)(

+  IN     EFI_GUID                         *Protocol,

+  IN OUT EFI_DEVICE_PATH_PROTOCOL         **DevicePath,

+  OUT    EFI_HANDLE                       *Device

+  );

+

+/**

+  Adds, updates, or removes a configuration table entry from the EFI System Table.

+

+  @param[in]  Guid              A pointer to the GUID for the entry to add, update, or remove.

+  @param[in]  Table             A pointer to the configuration table for the entry to add, update, or

+                                remove. May be NULL.

+

+  @retval EFI_SUCCESS           The (Guid, Table) pair was added, updated, or removed.

+  @retval EFI_NOT_FOUND         An attempt was made to delete a nonexistent entry.

+  @retval EFI_INVALID_PARAMETER Guid is NULL.

+  @retval EFI_OUT_OF_RESOURCES  There is not enough memory available to complete the operation.

+

+**/

+typedef

+EFI_STATUS

+(EFIAPI *EFI_INSTALL_CONFIGURATION_TABLE)(

+  IN EFI_GUID                 *Guid,

+  IN VOID                     *Table

+  );

+

+/**

+  Returns an array of handles that support the requested protocol in a buffer allocated from pool.

+

+  @param[in]       SearchType   Specifies which handle(s) are to be returned.

+  @param[in]       Protocol     Provides the protocol to search by.

+                                This parameter is only valid for a SearchType of ByProtocol.

+  @param[in]       SearchKey    Supplies the search key depending on the SearchType.

+  @param[out]      NoHandles    The number of handles returned in Buffer.

+  @param[out]      Buffer       A pointer to the buffer to return the requested array of handles that

+                                support Protocol.

+

+  @retval EFI_SUCCESS           The array of handles was returned in Buffer, and the number of

+                                handles in Buffer was returned in NoHandles.

+  @retval EFI_NOT_FOUND         No handles match the search.

+  @retval EFI_OUT_OF_RESOURCES  There is not enough pool memory to store the matching results.

+  @retval EFI_INVALID_PARAMETER NoHandles is NULL.

+  @retval EFI_INVALID_PARAMETER Buffer is NULL.

+

+**/

+typedef

+EFI_STATUS

+(EFIAPI *EFI_LOCATE_HANDLE_BUFFER)(

+  IN     EFI_LOCATE_SEARCH_TYPE       SearchType,

+  IN     EFI_GUID                     *Protocol,      OPTIONAL

+  IN     VOID                         *SearchKey,     OPTIONAL

+  OUT    UINTN                        *NoHandles,

+  OUT    EFI_HANDLE                   **Buffer

+  );

+

+/**

+  Returns the first protocol instance that matches the given protocol.

+

+  @param[in]  Protocol          Provides the protocol to search for.

+  @param[in]  Registration      Optional registration key returned from

+                                RegisterProtocolNotify().

+  @param[out]  Interface        On return, a pointer to the first interface that matches Protocol and

+                                Registration.

+

+  @retval EFI_SUCCESS           A protocol instance matching Protocol was found and returned in

+                                Interface.

+  @retval EFI_NOT_FOUND         No protocol instances were found that match Protocol and

+                                Registration.

+  @retval EFI_INVALID_PARAMETER Interface is NULL.

+                                Protocol is NULL.

+

+**/

+typedef

+EFI_STATUS

+(EFIAPI *EFI_LOCATE_PROTOCOL)(

+  IN  EFI_GUID  *Protocol,

+  IN  VOID      *Registration, OPTIONAL

+  OUT VOID      **Interface

+  );

+

+///

+/// EFI Capsule Block Descriptor

+///

+typedef struct {

+  ///

+  /// Length in bytes of the data pointed to by DataBlock/ContinuationPointer.

+  ///

+  UINT64                  Length;

+  union {

+    ///

+    /// Physical address of the data block. This member of the union is

+    /// used if Length is not equal to zero.

+    ///

+    EFI_PHYSICAL_ADDRESS  DataBlock;

+    ///

+    /// Physical address of another block of

+    /// EFI_CAPSULE_BLOCK_DESCRIPTOR structures. This

+    /// member of the union is used if Length is equal to zero. If

+    /// ContinuationPointer is zero this entry represents the end of the list.

+    ///

+    EFI_PHYSICAL_ADDRESS  ContinuationPointer;

+  } Union;

+} EFI_CAPSULE_BLOCK_DESCRIPTOR;

+

+///

+/// EFI Capsule Header.

+///

+typedef struct {

+  ///

+  /// A GUID that defines the contents of a capsule.

+  ///

+  EFI_GUID          CapsuleGuid;

+  ///

+  /// The size of the capsule header. This may be larger than the size of

+  /// the EFI_CAPSULE_HEADER since CapsuleGuid may imply

+  /// extended header entries

+  ///

+  UINT32            HeaderSize;

+  ///

+  /// Bit-mapped list describing the capsule attributes. The Flag values

+  /// of 0x0000 - 0xFFFF are defined by CapsuleGuid. Flag values

+  /// of 0x10000 - 0xFFFFFFFF are defined by this specification

+  ///

+  UINT32            Flags;

+  ///

+  /// Size in bytes of the capsule.

+  ///

+  UINT32            CapsuleImageSize;

+} EFI_CAPSULE_HEADER;

+

+///

+/// The EFI System Table entry must point to an array of capsules

+/// that contain the same CapsuleGuid value. The array must be

+/// prefixed by a UINT32 that represents the size of the array of capsules.

+///

+typedef struct {

+  ///

+  /// the size of the array of capsules.

+  ///

+  UINT32   CapsuleArrayNumber;

+  ///

+  /// Point to an array of capsules that contain the same CapsuleGuid value.

+  ///

+  VOID*    CapsulePtr[1];

+} EFI_CAPSULE_TABLE;

+

+#define CAPSULE_FLAGS_PERSIST_ACROSS_RESET          0x00010000

+#define CAPSULE_FLAGS_POPULATE_SYSTEM_TABLE         0x00020000

+#define CAPSULE_FLAGS_INITIATE_RESET                0x00040000

+

+/**

+  Passes capsules to the firmware with both virtual and physical mapping. Depending on the intended

+  consumption, the firmware may process the capsule immediately. If the payload should persist

+  across a system reset, the reset value returned from EFI_QueryCapsuleCapabilities must

+  be passed into ResetSystem() and will cause the capsule to be processed by the firmware as

+  part of the reset process.

+

+  @param[in]  CapsuleHeaderArray Virtual pointer to an array of virtual pointers to the capsules

+                                 being passed into update capsule.

+  @param[in]  CapsuleCount       Number of pointers to EFI_CAPSULE_HEADER in

+                                 CaspuleHeaderArray.

+  @param[in]  ScatterGatherList  Physical pointer to a set of

+                                 EFI_CAPSULE_BLOCK_DESCRIPTOR that describes the

+                                 location in physical memory of a set of capsules.

+

+  @retval EFI_SUCCESS           Valid capsule was passed. If

+                                CAPSULE_FLAGS_PERSIT_ACROSS_RESET is not set, the

+                                capsule has been successfully processed by the firmware.

+  @retval EFI_INVALID_PARAMETER CapsuleSize is NULL, or an incompatible set of flags were

+                                set in the capsule header.

+  @retval EFI_INVALID_PARAMETER CapsuleCount is 0.

+  @retval EFI_DEVICE_ERROR      The capsule update was started, but failed due to a device error.

+  @retval EFI_UNSUPPORTED       The capsule type is not supported on this platform.

+  @retval EFI_OUT_OF_RESOURCES  When ExitBootServices() has been previously called this error indicates the capsule

+                                is compatible with this platform but is not capable of being submitted or processed

+                                in runtime. The caller may resubmit the capsule prior to ExitBootServices().

+  @retval EFI_OUT_OF_RESOURCES  When ExitBootServices() has not been previously called then this error indicates

+                                the capsule is compatible with this platform but there are insufficient resources to process.

+

+**/

+typedef

+EFI_STATUS

+(EFIAPI *EFI_UPDATE_CAPSULE)(

+  IN EFI_CAPSULE_HEADER     **CapsuleHeaderArray,

+  IN UINTN                  CapsuleCount,

+  IN EFI_PHYSICAL_ADDRESS   ScatterGatherList   OPTIONAL

+  );

+

+/**

+  Returns if the capsule can be supported via UpdateCapsule().

+

+  @param[in]   CapsuleHeaderArray  Virtual pointer to an array of virtual pointers to the capsules

+                                   being passed into update capsule.

+  @param[in]   CapsuleCount        Number of pointers to EFI_CAPSULE_HEADER in

+                                   CaspuleHeaderArray.

+  @param[out]  MaxiumCapsuleSize   On output the maximum size that UpdateCapsule() can

+                                   support as an argument to UpdateCapsule() via

+                                   CapsuleHeaderArray and ScatterGatherList.

+  @param[out]  ResetType           Returns the type of reset required for the capsule update.

+

+  @retval EFI_SUCCESS           Valid answer returned.

+  @retval EFI_UNSUPPORTED       The capsule type is not supported on this platform, and

+                                MaximumCapsuleSize and ResetType are undefined.

+  @retval EFI_INVALID_PARAMETER MaximumCapsuleSize is NULL.

+  @retval EFI_OUT_OF_RESOURCES  When ExitBootServices() has been previously called this error indicates the capsule

+                                is compatible with this platform but is not capable of being submitted or processed

+                                in runtime. The caller may resubmit the capsule prior to ExitBootServices().

+  @retval EFI_OUT_OF_RESOURCES  When ExitBootServices() has not been previously called then this error indicates

+                                the capsule is compatible with this platform but there are insufficient resources to process.

+

+**/

+typedef

+EFI_STATUS

+(EFIAPI *EFI_QUERY_CAPSULE_CAPABILITIES)(

+  IN  EFI_CAPSULE_HEADER     **CapsuleHeaderArray,

+  IN  UINTN                  CapsuleCount,

+  OUT UINT64                 *MaximumCapsuleSize,

+  OUT EFI_RESET_TYPE         *ResetType

+  );

+

+/**

+  Returns information about the EFI variables.

+

+  @param[in]   Attributes                   Attributes bitmask to specify the type of variables on

+                                            which to return information.

+  @param[out]  MaximumVariableStorageSize   On output the maximum size of the storage space

+                                            available for the EFI variables associated with the

+                                            attributes specified.

+  @param[out]  RemainingVariableStorageSize Returns the remaining size of the storage space

+                                            available for the EFI variables associated with the

+                                            attributes specified.

+  @param[out]  MaximumVariableSize          Returns the maximum size of the individual EFI

+                                            variables associated with the attributes specified.

+

+  @retval EFI_SUCCESS                  Valid answer returned.

+  @retval EFI_INVALID_PARAMETER        An invalid combination of attribute bits was supplied

+  @retval EFI_UNSUPPORTED              The attribute is not supported on this platform, and the

+                                       MaximumVariableStorageSize,

+                                       RemainingVariableStorageSize, MaximumVariableSize

+                                       are undefined.

+

+**/

+typedef

+EFI_STATUS

+(EFIAPI *EFI_QUERY_VARIABLE_INFO)(

+  IN  UINT32            Attributes,

+  OUT UINT64            *MaximumVariableStorageSize,

+  OUT UINT64            *RemainingVariableStorageSize,

+  OUT UINT64            *MaximumVariableSize

+  );

+

+//

+// Firmware should stop at a firmware user interface on next boot

+//

+#define EFI_OS_INDICATIONS_BOOT_TO_FW_UI                    0x0000000000000001

+#define EFI_OS_INDICATIONS_TIMESTAMP_REVOCATION             0x0000000000000002

+#define EFI_OS_INDICATIONS_FILE_CAPSULE_DELIVERY_SUPPORTED  0x0000000000000004

+#define EFI_OS_INDICATIONS_FMP_CAPSULE_SUPPORTED            0x0000000000000008

+#define EFI_OS_INDICATIONS_CAPSULE_RESULT_VAR_SUPPORTED     0x0000000000000010

+#define EFI_OS_INDICATIONS_START_PLATFORM_RECOVERY          0x0000000000000040

+#define EFI_OS_INDICATIONS_JSON_CONFIG_DATA_REFRESH         0x0000000000000080

+

+//

+// EFI Runtime Services Table

+//

+#define EFI_SYSTEM_TABLE_SIGNATURE      SIGNATURE_64 ('I','B','I',' ','S','Y','S','T')

+#define EFI_2_80_SYSTEM_TABLE_REVISION  ((2 << 16) | (80))

+#define EFI_2_70_SYSTEM_TABLE_REVISION  ((2 << 16) | (70))

+#define EFI_2_60_SYSTEM_TABLE_REVISION  ((2 << 16) | (60))

+#define EFI_2_50_SYSTEM_TABLE_REVISION  ((2 << 16) | (50))

+#define EFI_2_40_SYSTEM_TABLE_REVISION  ((2 << 16) | (40))

+#define EFI_2_31_SYSTEM_TABLE_REVISION  ((2 << 16) | (31))

+#define EFI_2_30_SYSTEM_TABLE_REVISION  ((2 << 16) | (30))

+#define EFI_2_20_SYSTEM_TABLE_REVISION  ((2 << 16) | (20))

+#define EFI_2_10_SYSTEM_TABLE_REVISION  ((2 << 16) | (10))

+#define EFI_2_00_SYSTEM_TABLE_REVISION  ((2 << 16) | (00))

+#define EFI_1_10_SYSTEM_TABLE_REVISION  ((1 << 16) | (10))

+#define EFI_1_02_SYSTEM_TABLE_REVISION  ((1 << 16) | (02))

+#define EFI_SYSTEM_TABLE_REVISION       EFI_2_70_SYSTEM_TABLE_REVISION

+#define EFI_SPECIFICATION_VERSION       EFI_SYSTEM_TABLE_REVISION

+

+#define EFI_RUNTIME_SERVICES_SIGNATURE  SIGNATURE_64 ('R','U','N','T','S','E','R','V')

+#define EFI_RUNTIME_SERVICES_REVISION   EFI_SPECIFICATION_VERSION

+

+///

+/// EFI Runtime Services Table.

+///

+typedef struct {

+  ///

+  /// The table header for the EFI Runtime Services Table.

+  ///

+  EFI_TABLE_HEADER                Hdr;

+

+  //

+  // Time Services

+  //

+  EFI_GET_TIME                    GetTime;

+  EFI_SET_TIME                    SetTime;

+  EFI_GET_WAKEUP_TIME             GetWakeupTime;

+  EFI_SET_WAKEUP_TIME             SetWakeupTime;

+

+  //

+  // Virtual Memory Services

+  //

+  EFI_SET_VIRTUAL_ADDRESS_MAP     SetVirtualAddressMap;

+  EFI_CONVERT_POINTER             ConvertPointer;

+

+  //

+  // Variable Services

+  //

+  EFI_GET_VARIABLE                GetVariable;

+  EFI_GET_NEXT_VARIABLE_NAME      GetNextVariableName;

+  EFI_SET_VARIABLE                SetVariable;

+

+  //

+  // Miscellaneous Services

+  //

+  EFI_GET_NEXT_HIGH_MONO_COUNT    GetNextHighMonotonicCount;

+  EFI_RESET_SYSTEM                ResetSystem;

+

+  //

+  // UEFI 2.0 Capsule Services

+  //

+  EFI_UPDATE_CAPSULE              UpdateCapsule;

+  EFI_QUERY_CAPSULE_CAPABILITIES  QueryCapsuleCapabilities;

+

+  //

+  // Miscellaneous UEFI 2.0 Service

+  //

+  EFI_QUERY_VARIABLE_INFO         QueryVariableInfo;

+} EFI_RUNTIME_SERVICES;

+

+

+#define EFI_BOOT_SERVICES_SIGNATURE   SIGNATURE_64 ('B','O','O','T','S','E','R','V')

+#define EFI_BOOT_SERVICES_REVISION    EFI_SPECIFICATION_VERSION

+

+///

+/// EFI Boot Services Table.

+///

+typedef struct {

+  ///

+  /// The table header for the EFI Boot Services Table.

+  ///

+  EFI_TABLE_HEADER                Hdr;

+

+  //

+  // Task Priority Services

+  //

+  EFI_RAISE_TPL                   RaiseTPL;

+  EFI_RESTORE_TPL                 RestoreTPL;

+

+  //

+  // Memory Services

+  //

+  EFI_ALLOCATE_PAGES              AllocatePages;

+  EFI_FREE_PAGES                  FreePages;

+  EFI_GET_MEMORY_MAP              GetMemoryMap;

+  EFI_ALLOCATE_POOL               AllocatePool;

+  EFI_FREE_POOL                   FreePool;

+

+  //

+  // Event & Timer Services

+  //

+  EFI_CREATE_EVENT                  CreateEvent;

+  EFI_SET_TIMER                     SetTimer;

+  EFI_WAIT_FOR_EVENT                WaitForEvent;

+  EFI_SIGNAL_EVENT                  SignalEvent;

+  EFI_CLOSE_EVENT                   CloseEvent;

+  EFI_CHECK_EVENT                   CheckEvent;

+

+  //

+  // Protocol Handler Services

+  //

+  EFI_INSTALL_PROTOCOL_INTERFACE    InstallProtocolInterface;

+  EFI_REINSTALL_PROTOCOL_INTERFACE  ReinstallProtocolInterface;

+  EFI_UNINSTALL_PROTOCOL_INTERFACE  UninstallProtocolInterface;

+  EFI_HANDLE_PROTOCOL               HandleProtocol;

+  VOID                              *Reserved;

+  EFI_REGISTER_PROTOCOL_NOTIFY      RegisterProtocolNotify;

+  EFI_LOCATE_HANDLE                 LocateHandle;

+  EFI_LOCATE_DEVICE_PATH            LocateDevicePath;

+  EFI_INSTALL_CONFIGURATION_TABLE   InstallConfigurationTable;

+

+  //

+  // Image Services

+  //

+  EFI_IMAGE_LOAD                    LoadImage;

+  EFI_IMAGE_START                   StartImage;

+  EFI_EXIT                          Exit;

+  EFI_IMAGE_UNLOAD                  UnloadImage;

+  EFI_EXIT_BOOT_SERVICES            ExitBootServices;

+

+  //

+  // Miscellaneous Services

+  //

+  EFI_GET_NEXT_MONOTONIC_COUNT      GetNextMonotonicCount;

+  EFI_STALL                         Stall;

+  EFI_SET_WATCHDOG_TIMER            SetWatchdogTimer;

+

+  //

+  // DriverSupport Services

+  //

+  EFI_CONNECT_CONTROLLER            ConnectController;

+  EFI_DISCONNECT_CONTROLLER         DisconnectController;

+

+  //

+  // Open and Close Protocol Services

+  //

+  EFI_OPEN_PROTOCOL                 OpenProtocol;

+  EFI_CLOSE_PROTOCOL                CloseProtocol;

+  EFI_OPEN_PROTOCOL_INFORMATION     OpenProtocolInformation;

+

+  //

+  // Library Services

+  //

+  EFI_PROTOCOLS_PER_HANDLE          ProtocolsPerHandle;

+  EFI_LOCATE_HANDLE_BUFFER          LocateHandleBuffer;

+  EFI_LOCATE_PROTOCOL               LocateProtocol;

+  EFI_INSTALL_MULTIPLE_PROTOCOL_INTERFACES    InstallMultipleProtocolInterfaces;

+  EFI_UNINSTALL_MULTIPLE_PROTOCOL_INTERFACES  UninstallMultipleProtocolInterfaces;

+

+  //

+  // 32-bit CRC Services

+  //

+  EFI_CALCULATE_CRC32               CalculateCrc32;

+

+  //

+  // Miscellaneous Services

+  //

+  EFI_COPY_MEM                      CopyMem;

+  EFI_SET_MEM                       SetMem;

+  EFI_CREATE_EVENT_EX               CreateEventEx;

+} EFI_BOOT_SERVICES;

+

+///

+/// Contains a set of GUID/pointer pairs comprised of the ConfigurationTable field in the

+/// EFI System Table.

+///

+typedef struct {

+  ///

+  /// The 128-bit GUID value that uniquely identifies the system configuration table.

+  ///

+  EFI_GUID                          VendorGuid;

+  ///

+  /// A pointer to the table associated with VendorGuid.

+  ///

+  VOID                              *VendorTable;

+} EFI_CONFIGURATION_TABLE;

+

+///

+/// EFI System Table

+///

+typedef struct {

+  ///

+  /// The table header for the EFI System Table.

+  ///

+  EFI_TABLE_HEADER                  Hdr;

+  ///

+  /// A pointer to a null terminated string that identifies the vendor

+  /// that produces the system firmware for the platform.

+  ///

+  CHAR16                            *FirmwareVendor;

+  ///

+  /// A firmware vendor specific value that identifies the revision

+  /// of the system firmware for the platform.

+  ///

+  UINT32                            FirmwareRevision;

+  ///

+  /// The handle for the active console input device. This handle must support

+  /// EFI_SIMPLE_TEXT_INPUT_PROTOCOL and EFI_SIMPLE_TEXT_INPUT_EX_PROTOCOL.

+  ///

+  EFI_HANDLE                        ConsoleInHandle;

+  ///

+  /// A pointer to the EFI_SIMPLE_TEXT_INPUT_PROTOCOL interface that is

+  /// associated with ConsoleInHandle.

+  ///

+  EFI_SIMPLE_TEXT_INPUT_PROTOCOL    *ConIn;

+  ///

+  /// The handle for the active console output device.

+  ///

+  EFI_HANDLE                        ConsoleOutHandle;

+  ///

+  /// A pointer to the EFI_SIMPLE_TEXT_OUTPUT_PROTOCOL interface

+  /// that is associated with ConsoleOutHandle.

+  ///

+  EFI_SIMPLE_TEXT_OUTPUT_PROTOCOL   *ConOut;

+  ///

+  /// The handle for the active standard error console device.

+  /// This handle must support the EFI_SIMPLE_TEXT_OUTPUT_PROTOCOL.

+  ///

+  EFI_HANDLE                        StandardErrorHandle;

+  ///

+  /// A pointer to the EFI_SIMPLE_TEXT_OUTPUT_PROTOCOL interface

+  /// that is associated with StandardErrorHandle.

+  ///

+  EFI_SIMPLE_TEXT_OUTPUT_PROTOCOL   *StdErr;

+  ///

+  /// A pointer to the EFI Runtime Services Table.

+  ///

+  EFI_RUNTIME_SERVICES              *RuntimeServices;

+  ///

+  /// A pointer to the EFI Boot Services Table.

+  ///

+  EFI_BOOT_SERVICES                 *BootServices;

+  ///

+  /// The number of system configuration tables in the buffer ConfigurationTable.

+  ///

+  UINTN                             NumberOfTableEntries;

+  ///

+  /// A pointer to the system configuration tables.

+  /// The number of entries in the table is NumberOfTableEntries.

+  ///

+  EFI_CONFIGURATION_TABLE           *ConfigurationTable;

+} EFI_SYSTEM_TABLE;

+

+/**

+  This is the declaration of an EFI image entry point. This entry point is

+  the same for UEFI Applications, UEFI OS Loaders, and UEFI Drivers including

+  both device drivers and bus drivers.

+

+  @param[in]  ImageHandle       The firmware allocated handle for the UEFI image.

+  @param[in]  SystemTable       A pointer to the EFI System Table.

+

+  @retval EFI_SUCCESS           The operation completed successfully.

+  @retval Others                An unexpected error occurred.

+**/

+typedef

+EFI_STATUS

+(EFIAPI *EFI_IMAGE_ENTRY_POINT)(

+  IN  EFI_HANDLE                   ImageHandle,

+  IN  EFI_SYSTEM_TABLE             *SystemTable

+  );

+

+//

+// EFI Load Option. This data structure describes format of UEFI boot option variables.

+//

+// NOTE: EFI Load Option is a byte packed buffer of variable length fields.

+// The first two fields have fixed length. They are declared as members of the

+// EFI_LOAD_OPTION structure. All the other fields are variable length fields.

+// They are listed in the comment block below for reference purposes.

+//

+#pragma pack(1)

+typedef struct _EFI_LOAD_OPTION {

+  ///

+  /// The attributes for this load option entry. All unused bits must be zero

+  /// and are reserved by the UEFI specification for future growth.

+  ///

+  UINT32                           Attributes;

+  ///

+  /// Length in bytes of the FilePathList. OptionalData starts at offset

+  /// sizeof(UINT32) + sizeof(UINT16) + StrSize(Description) + FilePathListLength

+  /// of the EFI_LOAD_OPTION descriptor.

+  ///

+  UINT16                           FilePathListLength;

+  ///

+  /// The user readable description for the load option.

+  /// This field ends with a Null character.

+  ///

+  // CHAR16                        Description[];

+  ///

+  /// A packed array of UEFI device paths. The first element of the array is a

+  /// device path that describes the device and location of the Image for this

+  /// load option. The FilePathList[0] is specific to the device type. Other

+  /// device paths may optionally exist in the FilePathList, but their usage is

+  /// OSV specific. Each element in the array is variable length, and ends at

+  /// the device path end structure. Because the size of Description is

+  /// arbitrary, this data structure is not guaranteed to be aligned on a

+  /// natural boundary. This data structure may have to be copied to an aligned

+  /// natural boundary before it is used.

+  ///

+  // EFI_DEVICE_PATH_PROTOCOL      FilePathList[];

+  ///

+  /// The remaining bytes in the load option descriptor are a binary data buffer

+  /// that is passed to the loaded image. If the field is zero bytes long, a

+  /// NULL pointer is passed to the loaded image. The number of bytes in

+  /// OptionalData can be computed by subtracting the starting offset of

+  /// OptionalData from total size in bytes of the EFI_LOAD_OPTION.

+  ///

+  // UINT8                         OptionalData[];

+} EFI_LOAD_OPTION;

+#pragma pack()

+

+//

+// EFI Load Options Attributes

+//

+#define LOAD_OPTION_ACTIVE              0x00000001

+#define LOAD_OPTION_FORCE_RECONNECT     0x00000002

+#define LOAD_OPTION_HIDDEN              0x00000008

+#define LOAD_OPTION_CATEGORY            0x00001F00

+

+#define LOAD_OPTION_CATEGORY_BOOT       0x00000000

+#define LOAD_OPTION_CATEGORY_APP        0x00000100

+

+#define EFI_BOOT_OPTION_SUPPORT_KEY     0x00000001

+#define EFI_BOOT_OPTION_SUPPORT_APP     0x00000002

+#define EFI_BOOT_OPTION_SUPPORT_SYSPREP 0x00000010

+#define EFI_BOOT_OPTION_SUPPORT_COUNT   0x00000300

+

+///

+/// EFI Boot Key Data

+///

+typedef union {

+  struct {

+    ///

+    /// Indicates the revision of the EFI_KEY_OPTION structure. This revision level should be 0.

+    ///

+    UINT32  Revision        : 8;

+    ///

+    /// Either the left or right Shift keys must be pressed (1) or must not be pressed (0).

+    ///

+    UINT32  ShiftPressed    : 1;

+    ///

+    /// Either the left or right Control keys must be pressed (1) or must not be pressed (0).

+    ///

+    UINT32  ControlPressed  : 1;

+    ///

+    /// Either the left or right Alt keys must be pressed (1) or must not be pressed (0).

+    ///

+    UINT32  AltPressed      : 1;

+    ///

+    /// Either the left or right Logo keys must be pressed (1) or must not be pressed (0).

+    ///

+    UINT32  LogoPressed     : 1;

+    ///

+    /// The Menu key must be pressed (1) or must not be pressed (0).

+    ///

+    UINT32  MenuPressed     : 1;

+    ///

+    /// The SysReq key must be pressed (1) or must not be pressed (0).

+    ///

+    UINT32  SysReqPressed    : 1;

+    UINT32  Reserved        : 16;

+    ///

+    /// Specifies the actual number of entries in EFI_KEY_OPTION.Keys, from 0-3. If

+    /// zero, then only the shift state is considered. If more than one, then the boot option will

+    /// only be launched if all of the specified keys are pressed with the same shift state.

+    ///

+    UINT32  InputKeyCount   : 2;

+  } Options;

+  UINT32  PackedValue;

+} EFI_BOOT_KEY_DATA;

+

+///

+/// EFI Key Option.

+///

+#pragma pack(1)

+typedef struct {

+  ///

+  /// Specifies options about how the key will be processed.

+  ///

+  EFI_BOOT_KEY_DATA  KeyData;

+  ///

+  /// The CRC-32 which should match the CRC-32 of the entire EFI_LOAD_OPTION to

+  /// which BootOption refers. If the CRC-32s do not match this value, then this key

+  /// option is ignored.

+  ///

+  UINT32             BootOptionCrc;

+  ///

+  /// The Boot#### option which will be invoked if this key is pressed and the boot option

+  /// is active (LOAD_OPTION_ACTIVE is set).

+  ///

+  UINT16             BootOption;

+  ///

+  /// The key codes to compare against those returned by the

+  /// EFI_SIMPLE_TEXT_INPUT and EFI_SIMPLE_TEXT_INPUT_EX protocols.

+  /// The number of key codes (0-3) is specified by the EFI_KEY_CODE_COUNT field in KeyOptions.

+  ///

+  //EFI_INPUT_KEY      Keys[];

+} EFI_KEY_OPTION;

+#pragma pack()

+

+//

+// EFI File location to boot from on removable media devices

+//

+#define EFI_REMOVABLE_MEDIA_FILE_NAME_IA32    L"\\EFI\\BOOT\\BOOTIA32.EFI"

+#define EFI_REMOVABLE_MEDIA_FILE_NAME_IA64    L"\\EFI\\BOOT\\BOOTIA64.EFI"

+#define EFI_REMOVABLE_MEDIA_FILE_NAME_X64     L"\\EFI\\BOOT\\BOOTX64.EFI"

+#define EFI_REMOVABLE_MEDIA_FILE_NAME_ARM     L"\\EFI\\BOOT\\BOOTARM.EFI"

+#define EFI_REMOVABLE_MEDIA_FILE_NAME_AARCH64 L"\\EFI\\BOOT\\BOOTAA64.EFI"

+#define EFI_REMOVABLE_MEDIA_FILE_NAME_RISCV64 L"\\EFI\\BOOT\\BOOTRISCV64.EFI"

+

+#if   defined (MDE_CPU_IA32)

+  #define EFI_REMOVABLE_MEDIA_FILE_NAME   EFI_REMOVABLE_MEDIA_FILE_NAME_IA32

+#elif defined (MDE_CPU_X64)

+  #define EFI_REMOVABLE_MEDIA_FILE_NAME   EFI_REMOVABLE_MEDIA_FILE_NAME_X64

+#elif defined (MDE_CPU_EBC)

+#elif defined (MDE_CPU_ARM)

+  #define EFI_REMOVABLE_MEDIA_FILE_NAME   EFI_REMOVABLE_MEDIA_FILE_NAME_ARM

+#elif defined (MDE_CPU_AARCH64)

+  #define EFI_REMOVABLE_MEDIA_FILE_NAME   EFI_REMOVABLE_MEDIA_FILE_NAME_AARCH64

+#elif defined (MDE_CPU_RISCV64)

+  #define EFI_REMOVABLE_MEDIA_FILE_NAME   EFI_REMOVABLE_MEDIA_FILE_NAME_RISCV64

+#else

+  #error Unknown Processor Type

+#endif

+

+//

+// The directory within the active EFI System Partition defined for delivery of capsule to firmware

+//

+#define EFI_CAPSULE_FILE_DIRECTORY            L"\\EFI\\UpdateCapsule\\"

+

+#include <Uefi/UefiPxe.h>

+#include <Uefi/UefiGpt.h>

+#include <Uefi/UefiInternalFormRepresentation.h>

+

+#endif

diff --git a/debugging_demo/memtest86+/efi/Include/src/ApplicationEntryPoint.c b/debugging_demo/memtest86+/efi/Include/src/ApplicationEntryPoint.c
new file mode 100644
index 0000000..324e88c
--- /dev/null
+++ b/debugging_demo/memtest86+/efi/Include/src/ApplicationEntryPoint.c
@@ -0,0 +1,115 @@
+/** @file

+  Entry point library instance to a UEFI application.

+

+Copyright (c) 2007 - 2018, Intel Corporation. All rights reserved.<BR>

+SPDX-License-Identifier: BSD-2-Clause-Patent

+

+**/

+

+#include <Uefi.h>

+#include <Library/UefiApplicationEntryPoint.h>

+#include <Library/BaseLib.h>

+#include <Library/DebugLib.h>

+#include <Library/UefiBootServicesTableLib.h>

+

+

+/**

+  Entry point to UEFI Application.

+

+  This function is the entry point for a UEFI Application. This function must call

+  ProcessLibraryConstructorList(), ProcessModuleEntryPointList(), and ProcessLibraryDestructorList().

+  The return value from ProcessModuleEntryPointList() is returned.

+  If _gUefiDriverRevision is not zero and SystemTable->Hdr.Revision is less than _gUefiDriverRevison,

+  then return EFI_INCOMPATIBLE_VERSION.

+

+  @param  ImageHandle                The image handle of the UEFI Application.

+  @param  SystemTable                A pointer to the EFI System Table.

+

+  @retval  EFI_SUCCESS               The UEFI Application exited normally.

+  @retval  EFI_INCOMPATIBLE_VERSION  _gUefiDriverRevision is greater than SystemTable->Hdr.Revision.

+  @retval  Other                     Return value from ProcessModuleEntryPointList().

+

+**/

+EFI_STATUS

+EFIAPI

+_ModuleEntryPoint (

+  IN EFI_HANDLE        ImageHandle,

+  IN EFI_SYSTEM_TABLE  *SystemTable

+  )

+{

+  EFI_STATUS                 Status;

+

+  if (_gUefiDriverRevision != 0) {

+    //

+    // Make sure that the EFI/UEFI spec revision of the platform is >= EFI/UEFI spec revision of the application.

+    //

+    if (SystemTable->Hdr.Revision < _gUefiDriverRevision) {

+      return EFI_INCOMPATIBLE_VERSION;

+    }

+  }

+

+  //

+  // Call constructor for all libraries.

+  //

+  ProcessLibraryConstructorList (ImageHandle, SystemTable);

+

+  //

+  // Call the module's entry point

+  //

+  Status = ProcessModuleEntryPointList (ImageHandle, SystemTable);

+

+  //

+  // Process destructor for all libraries.

+  //

+  ProcessLibraryDestructorList (ImageHandle, SystemTable);

+

+  //

+  // Return the return status code from the driver entry point

+  //

+  return Status;

+}

+

+

+/**

+  Invokes the library destructors for all dependent libraries and terminates

+  the UEFI Application.

+

+  This function calls ProcessLibraryDestructorList() and the EFI Boot Service Exit()

+  with a status specified by Status.

+

+  @param  Status  Status returned by the application that is exiting.

+

+**/

+VOID

+EFIAPI

+Exit (

+  IN EFI_STATUS  Status

+  )

+

+{

+  ProcessLibraryDestructorList (gImageHandle, gST);

+

+  gBS->Exit (gImageHandle, Status, 0, NULL);

+}

+

+

+/**

+  Required by the EBC compiler and identical in functionality to _ModuleEntryPoint().

+

+  @param  ImageHandle  The image handle of the UEFI Application.

+  @param  SystemTable  A pointer to the EFI System Table.

+

+  @retval  EFI_SUCCESS               The UEFI Application exited normally.

+  @retval  EFI_INCOMPATIBLE_VERSION  _gUefiDriverRevision is greater than SystemTable->Hdr.Revision.

+  @retval  Other                     Return value from ProcessModuleEntryPointList().

+

+**/

+EFI_STATUS

+EFIAPI

+EfiMain (

+  IN EFI_HANDLE        ImageHandle,

+  IN EFI_SYSTEM_TABLE  *SystemTable

+  )

+{

+  return _ModuleEntryPoint (ImageHandle, SystemTable);

+}

diff --git a/debugging_demo/memtest86+/efi/Include/src/BaseDebugPrintErrorLevelLib.c b/debugging_demo/memtest86+/efi/Include/src/BaseDebugPrintErrorLevelLib.c
new file mode 100644
index 0000000..265d6a0
--- /dev/null
+++ b/debugging_demo/memtest86+/efi/Include/src/BaseDebugPrintErrorLevelLib.c
@@ -0,0 +1,55 @@
+/** @file

+  Debug Print Error Level library instance that retrieves the current error

+  level from PcdDebugPrintErrorLevel.  This generic library instance does not

+  support the setting of the global debug print error level mask for the platform.

+

+  Copyright (c) 2011 - 2018, Intel Corporation. All rights reserved.<BR>

+  SPDX-License-Identifier: BSD-2-Clause-Patent

+

+**/

+

+#include <Base.h>

+#include <Library/DebugPrintErrorLevelLib.h>

+#include <Library/PcdLib.h>

+

+#include "Efi_Defs.h"

+

+/**

+  Returns the debug print error level mask for the current module.

+

+  @return  Debug print error level mask for the current module.

+

+**/

+UINT32

+EFIAPI

+GetDebugPrintErrorLevel (

+  VOID

+  )

+{

+  //

+  // Retrieve the current debug print error level mask from PcdDebugPrintErrorLevel.

+  //

+  return PcdGet32 (PcdDebugPrintErrorLevel);

+}

+

+/**

+  Sets the global debug print error level mask fpr the entire platform.

+

+  @param   ErrorLevel     Global debug print error level.

+

+  @retval  TRUE           The debug print error level mask was sucessfully set.

+  @retval  FALSE          The debug print error level mask could not be set.

+

+**/

+BOOLEAN

+EFIAPI

+SetDebugPrintErrorLevel (

+  UINT32  ErrorLevel

+  )

+{

+  //

+  // This library uinstance does not support setting the global debug print error

+  // level mask.

+  //

+  return FALSE;

+}

diff --git a/debugging_demo/memtest86+/efi/Include/src/BaseLib/ARShiftU64.c b/debugging_demo/memtest86+/efi/Include/src/BaseLib/ARShiftU64.c
new file mode 100644
index 0000000..9928854
--- /dev/null
+++ b/debugging_demo/memtest86+/efi/Include/src/BaseLib/ARShiftU64.c
@@ -0,0 +1,35 @@
+/** @file

+  Math worker functions.

+

+  Copyright (c) 2006 - 2010, Intel Corporation. All rights reserved.<BR>

+  SPDX-License-Identifier: BSD-2-Clause-Patent

+

+**/

+

+#include "BaseLibInternals.h"

+

+/**

+  Shifts a 64-bit integer right between 0 and 63 bits. The high bits are filled

+  with the original integer's bit 63. The shifted value is returned.

+

+  This function shifts the 64-bit value Operand to the right by Count bits. The

+  high Count bits are set to bit 63 of Operand.  The shifted value is returned.

+

+  If Count is greater than 63, then ASSERT().

+

+  @param  Operand The 64-bit operand to shift right.

+  @param  Count   The number of bits to shift right.

+

+  @return Operand >> Count

+

+**/

+UINT64

+EFIAPI

+ARShiftU64 (

+  IN      UINT64                    Operand,

+  IN      UINTN                     Count

+  )

+{

+  ASSERT (Count < 64);

+  return InternalMathARShiftU64 (Operand, Count);

+}

diff --git a/debugging_demo/memtest86+/efi/Include/src/BaseLib/BaseLibInternals.h b/debugging_demo/memtest86+/efi/Include/src/BaseLib/BaseLibInternals.h
new file mode 100644
index 0000000..6837d67
--- /dev/null
+++ b/debugging_demo/memtest86+/efi/Include/src/BaseLib/BaseLibInternals.h
@@ -0,0 +1,869 @@
+/** @file

+  Declaration of internal functions in BaseLib.

+

+  Copyright (c) 2006 - 2019, Intel Corporation. All rights reserved.<BR>

+  SPDX-License-Identifier: BSD-2-Clause-Patent

+

+**/

+

+#ifndef __BASE_LIB_INTERNALS__

+#define __BASE_LIB_INTERNALS__

+

+#include <Base.h>

+#include <Library/BaseLib.h>

+#include <Library/BaseMemoryLib.h>

+#include <Library/DebugLib.h>

+#include <Library/PcdLib.h>

+

+//

+// Math functions

+//

+

+/**

+  Shifts a 64-bit integer left between 0 and 63 bits. The low bits

+  are filled with zeros. The shifted value is returned.

+

+  This function shifts the 64-bit value Operand to the left by Count bits. The

+  low Count bits are set to zero. The shifted value is returned.

+

+  @param  Operand The 64-bit operand to shift left.

+  @param  Count   The number of bits to shift left.

+

+  @return Operand << Count

+

+**/

+UINT64

+EFIAPI

+InternalMathLShiftU64 (

+  IN      UINT64                    Operand,

+  IN      UINTN                     Count

+  );

+

+/**

+  Shifts a 64-bit integer right between 0 and 63 bits. The high bits

+  are filled with zeros. The shifted value is returned.

+

+  This function shifts the 64-bit value Operand to the right by Count bits. The

+  high Count bits are set to zero. The shifted value is returned.

+

+  @param  Operand The 64-bit operand to shift right.

+  @param  Count   The number of bits to shift right.

+

+  @return Operand >> Count

+

+**/

+UINT64

+EFIAPI

+InternalMathRShiftU64 (

+  IN      UINT64                    Operand,

+  IN      UINTN                     Count

+  );

+

+/**

+  Shifts a 64-bit integer right between 0 and 63 bits. The high bits

+  are filled with original integer's bit 63. The shifted value is returned.

+

+  This function shifts the 64-bit value Operand to the right by Count bits. The

+  high Count bits are set to bit 63 of Operand.  The shifted value is returned.

+

+  @param  Operand The 64-bit operand to shift right.

+  @param  Count   The number of bits to shift right.

+

+  @return Operand arithmetically shifted right by Count

+

+**/

+UINT64

+EFIAPI

+InternalMathARShiftU64 (

+  IN      UINT64                    Operand,

+  IN      UINTN                     Count

+  );

+

+/**

+  Rotates a 64-bit integer left between 0 and 63 bits, filling

+  the low bits with the high bits that were rotated.

+

+  This function rotates the 64-bit value Operand to the left by Count bits. The

+  low Count bits are filled with the high Count bits of Operand. The rotated

+  value is returned.

+

+  @param  Operand The 64-bit operand to rotate left.

+  @param  Count   The number of bits to rotate left.

+

+  @return Operand <<< Count

+

+**/

+UINT64

+EFIAPI

+InternalMathLRotU64 (

+  IN      UINT64                    Operand,

+  IN      UINTN                     Count

+  );

+

+/**

+  Rotates a 64-bit integer right between 0 and 63 bits, filling

+  the high bits with the high low bits that were rotated.

+

+  This function rotates the 64-bit value Operand to the right by Count bits.

+  The high Count bits are filled with the low Count bits of Operand. The rotated

+  value is returned.

+

+  @param  Operand The 64-bit operand to rotate right.

+  @param  Count   The number of bits to rotate right.

+

+  @return Operand >>> Count

+

+**/

+UINT64

+EFIAPI

+InternalMathRRotU64 (

+  IN      UINT64                    Operand,

+  IN      UINTN                     Count

+  );

+

+/**

+  Switches the endianess of a 64-bit integer.

+

+  This function swaps the bytes in a 64-bit unsigned value to switch the value

+  from little endian to big endian or vice versa. The byte swapped value is

+  returned.

+

+  @param  Operand A 64-bit unsigned value.

+

+  @return The byte swapped Operand.

+

+**/

+UINT64

+EFIAPI

+InternalMathSwapBytes64 (

+  IN      UINT64                    Operand

+  );

+

+/**

+  Multiplies a 64-bit unsigned integer by a 32-bit unsigned integer

+  and generates a 64-bit unsigned result.

+

+  This function multiplies the 64-bit unsigned value Multiplicand by the 32-bit

+  unsigned value Multiplier and generates a 64-bit unsigned result. This 64-

+  bit unsigned result is returned.

+

+  @param  Multiplicand  A 64-bit unsigned value.

+  @param  Multiplier    A 32-bit unsigned value.

+

+  @return Multiplicand * Multiplier

+

+**/

+UINT64

+EFIAPI

+InternalMathMultU64x32 (

+  IN      UINT64                    Multiplicand,

+  IN      UINT32                    Multiplier

+  );

+

+/**

+  Multiplies a 64-bit unsigned integer by a 64-bit unsigned integer

+  and generates a 64-bit unsigned result.

+

+  This function multiples the 64-bit unsigned value Multiplicand by the 64-bit

+  unsigned value Multiplier and generates a 64-bit unsigned result. This 64-

+  bit unsigned result is returned.

+

+  @param  Multiplicand  A 64-bit unsigned value.

+  @param  Multiplier    A 64-bit unsigned value.

+

+  @return Multiplicand * Multiplier

+

+**/

+UINT64

+EFIAPI

+InternalMathMultU64x64 (

+  IN      UINT64                    Multiplicand,

+  IN      UINT64                    Multiplier

+  );

+

+/**

+  Divides a 64-bit unsigned integer by a 32-bit unsigned integer and

+  generates a 64-bit unsigned result.

+

+  This function divides the 64-bit unsigned value Dividend by the 32-bit

+  unsigned value Divisor and generates a 64-bit unsigned quotient. This

+  function returns the 64-bit unsigned quotient.

+

+  @param  Dividend  A 64-bit unsigned value.

+  @param  Divisor   A 32-bit unsigned value.

+

+  @return Dividend / Divisor

+

+**/

+UINT64

+EFIAPI

+InternalMathDivU64x32 (

+  IN      UINT64                    Dividend,

+  IN      UINT32                    Divisor

+  );

+

+/**

+  Divides a 64-bit unsigned integer by a 32-bit unsigned integer and

+  generates a 32-bit unsigned remainder.

+

+  This function divides the 64-bit unsigned value Dividend by the 32-bit

+  unsigned value Divisor and generates a 32-bit remainder. This function

+  returns the 32-bit unsigned remainder.

+

+  @param  Dividend  A 64-bit unsigned value.

+  @param  Divisor   A 32-bit unsigned value.

+

+  @return Dividend % Divisor

+

+**/

+UINT32

+EFIAPI

+InternalMathModU64x32 (

+  IN      UINT64                    Dividend,

+  IN      UINT32                    Divisor

+  );

+

+/**

+  Divides a 64-bit unsigned integer by a 32-bit unsigned integer and

+  generates a 64-bit unsigned result and an optional 32-bit unsigned remainder.

+

+  This function divides the 64-bit unsigned value Dividend by the 32-bit

+  unsigned value Divisor and generates a 64-bit unsigned quotient. If Remainder

+  is not NULL, then the 32-bit unsigned remainder is returned in Remainder.

+  This function returns the 64-bit unsigned quotient.

+

+  @param  Dividend  A 64-bit unsigned value.

+  @param  Divisor   A 32-bit unsigned value.

+  @param  Remainder A pointer to a 32-bit unsigned value. This parameter is

+                    optional and may be NULL.

+

+  @return Dividend / Divisor

+

+**/

+UINT64

+EFIAPI

+InternalMathDivRemU64x32 (

+  IN      UINT64                    Dividend,

+  IN      UINT32                    Divisor,

+  OUT     UINT32                    *Remainder OPTIONAL

+  );

+

+/**

+  Divides a 64-bit unsigned integer by a 64-bit unsigned integer and

+  generates a 64-bit unsigned result and an optional 64-bit unsigned remainder.

+

+  This function divides the 64-bit unsigned value Dividend by the 64-bit

+  unsigned value Divisor and generates a 64-bit unsigned quotient. If Remainder

+  is not NULL, then the 64-bit unsigned remainder is returned in Remainder.

+  This function returns the 64-bit unsigned quotient.

+

+  @param  Dividend  A 64-bit unsigned value.

+  @param  Divisor   A 64-bit unsigned value.

+  @param  Remainder A pointer to a 64-bit unsigned value. This parameter is

+                    optional and may be NULL.

+

+  @return Dividend / Divisor

+

+**/

+UINT64

+EFIAPI

+InternalMathDivRemU64x64 (

+  IN      UINT64                    Dividend,

+  IN      UINT64                    Divisor,

+  OUT     UINT64                    *Remainder OPTIONAL

+  );

+

+/**

+  Divides a 64-bit signed integer by a 64-bit signed integer and

+  generates a 64-bit signed result and an optional 64-bit signed remainder.

+

+  This function divides the 64-bit signed value Dividend by the 64-bit

+  signed value Divisor and generates a 64-bit signed quotient. If Remainder

+  is not NULL, then the 64-bit signed remainder is returned in Remainder.

+  This function returns the 64-bit signed quotient.

+

+  @param  Dividend  A 64-bit signed value.

+  @param  Divisor   A 64-bit signed value.

+  @param  Remainder A pointer to a 64-bit signed value. This parameter is

+                    optional and may be NULL.

+

+  @return Dividend / Divisor

+

+**/

+INT64

+EFIAPI

+InternalMathDivRemS64x64 (

+  IN      INT64                     Dividend,

+  IN      INT64                     Divisor,

+  OUT     INT64                     *Remainder  OPTIONAL

+  );

+

+/**

+  Transfers control to a function starting with a new stack.

+

+  Transfers control to the function specified by EntryPoint using the

+  new stack specified by NewStack and passing in the parameters specified

+  by Context1 and Context2.  Context1 and Context2 are optional and may

+  be NULL.  The function EntryPoint must never return.

+  Marker will be ignored on IA-32, x64, and EBC.

+  IPF CPUs expect one additional parameter of type VOID * that specifies

+  the new backing store pointer.

+

+  If EntryPoint is NULL, then ASSERT().

+  If NewStack is NULL, then ASSERT().

+

+  @param  EntryPoint  A pointer to function to call with the new stack.

+  @param  Context1    A pointer to the context to pass into the EntryPoint

+                      function.

+  @param  Context2    A pointer to the context to pass into the EntryPoint

+                      function.

+  @param  NewStack    A pointer to the new stack to use for the EntryPoint

+                      function.

+  @param  Marker      VA_LIST marker for the variable argument list.

+

+**/

+VOID

+EFIAPI

+InternalSwitchStack (

+  IN      SWITCH_STACK_ENTRY_POINT  EntryPoint,

+  IN      VOID                      *Context1,   OPTIONAL

+  IN      VOID                      *Context2,   OPTIONAL

+  IN      VOID                      *NewStack,

+  IN      VA_LIST                   Marker

+  );

+

+

+/**

+  Worker function that returns a bit field from Operand.

+

+  Returns the bitfield specified by the StartBit and the EndBit from Operand.

+

+  @param  Operand   Operand on which to perform the bitfield operation.

+  @param  StartBit  The ordinal of the least significant bit in the bit field.

+  @param  EndBit    The ordinal of the most significant bit in the bit field.

+

+  @return The bit field read.

+

+**/

+UINTN

+EFIAPI

+BitFieldReadUint (

+  IN      UINTN                     Operand,

+  IN      UINTN                     StartBit,

+  IN      UINTN                     EndBit

+  );

+

+

+/**

+  Worker function that reads a bit field from Operand, performs a bitwise OR,

+  and returns the result.

+

+  Performs a bitwise OR between the bit field specified by StartBit and EndBit

+  in Operand and the value specified by AndData. All other bits in Operand are

+  preserved. The new value is returned.

+

+  @param  Operand   Operand on which to perform the bitfield operation.

+  @param  StartBit  The ordinal of the least significant bit in the bit field.

+  @param  EndBit    The ordinal of the most significant bit in the bit field.

+  @param  OrData    The value to OR with the read value from the value

+

+  @return The new value.

+

+**/

+UINTN

+EFIAPI

+BitFieldOrUint (

+  IN      UINTN                     Operand,

+  IN      UINTN                     StartBit,

+  IN      UINTN                     EndBit,

+  IN      UINTN                     OrData

+  );

+

+

+/**

+  Worker function that reads a bit field from Operand, performs a bitwise AND,

+  and returns the result.

+

+  Performs a bitwise AND between the bit field specified by StartBit and EndBit

+  in Operand and the value specified by AndData. All other bits in Operand are

+  preserved. The new value is returned.

+

+  @param  Operand   Operand on which to perform the bitfield operation.

+  @param  StartBit  The ordinal of the least significant bit in the bit field.

+  @param  EndBit    The ordinal of the most significant bit in the bit field.

+  @param  AndData    The value to And with the read value from the value

+

+  @return The new value.

+

+**/

+UINTN

+EFIAPI

+BitFieldAndUint (

+  IN      UINTN                     Operand,

+  IN      UINTN                     StartBit,

+  IN      UINTN                     EndBit,

+  IN      UINTN                     AndData

+  );

+

+

+/**

+  Worker function that checks ASSERT condition for JumpBuffer

+

+  Checks ASSERT condition for JumpBuffer.

+

+  If JumpBuffer is NULL, then ASSERT().

+  For IPF CPUs, if JumpBuffer is not aligned on a 16-byte boundary, then ASSERT().

+

+  @param  JumpBuffer    A pointer to CPU context buffer.

+

+**/

+VOID

+EFIAPI

+InternalAssertJumpBuffer (

+  IN      BASE_LIBRARY_JUMP_BUFFER  *JumpBuffer

+  );

+

+

+/**

+  Restores the CPU context that was saved with SetJump().

+

+  Restores the CPU context from the buffer specified by JumpBuffer.

+  This function never returns to the caller.

+  Instead is resumes execution based on the state of JumpBuffer.

+

+  @param  JumpBuffer    A pointer to CPU context buffer.

+  @param  Value         The value to return when the SetJump() context is restored.

+

+**/

+VOID

+EFIAPI

+InternalLongJump (

+  IN      BASE_LIBRARY_JUMP_BUFFER  *JumpBuffer,

+  IN      UINTN                     Value

+  );

+

+

+/**

+  Check if a Unicode character is a decimal character.

+

+  This internal function checks if a Unicode character is a

+  decimal character. The valid decimal character is from

+  L'0' to L'9'.

+

+  @param  Char  The character to check against.

+

+  @retval TRUE  If the Char is a decmial character.

+  @retval FALSE If the Char is not a decmial character.

+

+**/

+BOOLEAN

+EFIAPI

+InternalIsDecimalDigitCharacter (

+  IN      CHAR16                    Char

+  );

+

+

+/**

+  Convert a Unicode character to numerical value.

+

+  This internal function only deal with Unicode character

+  which maps to a valid hexadecimal ASII character, i.e.

+  L'0' to L'9', L'a' to L'f' or L'A' to L'F'. For other

+  Unicode character, the value returned does not make sense.

+

+  @param  Char  The character to convert.

+

+  @return The numerical value converted.

+

+**/

+UINTN

+EFIAPI

+InternalHexCharToUintn (

+  IN      CHAR16                    Char

+  );

+

+

+/**

+  Check if a Unicode character is a hexadecimal character.

+

+  This internal function checks if a Unicode character is a

+  decimal character.  The valid hexadecimal character is

+  L'0' to L'9', L'a' to L'f', or L'A' to L'F'.

+

+

+  @param  Char  The character to check against.

+

+  @retval TRUE  If the Char is a hexadecmial character.

+  @retval FALSE If the Char is not a hexadecmial character.

+

+**/

+BOOLEAN

+EFIAPI

+InternalIsHexaDecimalDigitCharacter (

+  IN      CHAR16                    Char

+  );

+

+

+/**

+  Check if a ASCII character is a decimal character.

+

+  This internal function checks if a Unicode character is a

+  decimal character. The valid decimal character is from

+  '0' to '9'.

+

+  @param  Char  The character to check against.

+

+  @retval TRUE  If the Char is a decmial character.

+  @retval FALSE If the Char is not a decmial character.

+

+**/

+BOOLEAN

+EFIAPI

+InternalAsciiIsDecimalDigitCharacter (

+  IN      CHAR8                     Char

+  );

+

+

+/**

+  Check if a ASCII character is a hexadecimal character.

+

+  This internal function checks if a ASCII character is a

+  decimal character.  The valid hexadecimal character is

+  L'0' to L'9', L'a' to L'f', or L'A' to L'F'.

+

+

+  @param  Char  The character to check against.

+

+  @retval TRUE  If the Char is a hexadecmial character.

+  @retval FALSE If the Char is not a hexadecmial character.

+

+**/

+BOOLEAN

+EFIAPI

+InternalAsciiIsHexaDecimalDigitCharacter (

+  IN      CHAR8                    Char

+  );

+

+

+/**

+  Convert a ASCII character to numerical value.

+

+  This internal function only deal with Unicode character

+  which maps to a valid hexadecimal ASII character, i.e.

+  '0' to '9', 'a' to 'f' or 'A' to 'F'. For other

+  ASCII character, the value returned does not make sense.

+

+  @param  Char  The character to convert.

+

+  @return The numerical value converted.

+

+**/

+UINTN

+EFIAPI

+InternalAsciiHexCharToUintn (

+  IN      CHAR8                    Char

+  );

+

+

+//

+// Ia32 and x64 specific functions

+//

+#if defined (MDE_CPU_IA32) || defined (MDE_CPU_X64)

+

+/**

+  Reads the current Global Descriptor Table Register(GDTR) descriptor.

+

+  Reads and returns the current GDTR descriptor and returns it in Gdtr. This

+  function is only available on IA-32 and x64.

+

+  @param  Gdtr  The pointer to a GDTR descriptor.

+

+**/

+VOID

+EFIAPI

+InternalX86ReadGdtr (

+  OUT     IA32_DESCRIPTOR           *Gdtr

+  );

+

+/**

+  Writes the current Global Descriptor Table Register (GDTR) descriptor.

+

+  Writes and the current GDTR descriptor specified by Gdtr. This function is

+  only available on IA-32 and x64.

+

+  @param  Gdtr  The pointer to a GDTR descriptor.

+

+**/

+VOID

+EFIAPI

+InternalX86WriteGdtr (

+  IN      CONST IA32_DESCRIPTOR     *Gdtr

+  );

+

+/**

+  Reads the current Interrupt Descriptor Table Register(GDTR) descriptor.

+

+  Reads and returns the current IDTR descriptor and returns it in Idtr. This

+  function is only available on IA-32 and x64.

+

+  @param  Idtr  The pointer to an IDTR descriptor.

+

+**/

+VOID

+EFIAPI

+InternalX86ReadIdtr (

+  OUT     IA32_DESCRIPTOR           *Idtr

+  );

+

+/**

+  Writes the current Interrupt Descriptor Table Register(GDTR) descriptor.

+

+  Writes the current IDTR descriptor and returns it in Idtr. This function is

+  only available on IA-32 and x64.

+

+  @param  Idtr  The pointer to an IDTR descriptor.

+

+**/

+VOID

+EFIAPI

+InternalX86WriteIdtr (

+  IN      CONST IA32_DESCRIPTOR     *Idtr

+  );

+

+/**

+  Save the current floating point/SSE/SSE2 context to a buffer.

+

+  Saves the current floating point/SSE/SSE2 state to the buffer specified by

+  Buffer. Buffer must be aligned on a 16-byte boundary. This function is only

+  available on IA-32 and x64.

+

+  @param  Buffer  The pointer to a buffer to save the floating point/SSE/SSE2 context.

+

+**/

+VOID

+EFIAPI

+InternalX86FxSave (

+  OUT     IA32_FX_BUFFER            *Buffer

+  );

+

+/**

+  Restores the current floating point/SSE/SSE2 context from a buffer.

+

+  Restores the current floating point/SSE/SSE2 state from the buffer specified

+  by Buffer. Buffer must be aligned on a 16-byte boundary. This function is

+  only available on IA-32 and x64.

+

+  @param  Buffer  The pointer to a buffer to save the floating point/SSE/SSE2 context.

+

+**/

+VOID

+EFIAPI

+InternalX86FxRestore (

+  IN      CONST IA32_FX_BUFFER      *Buffer

+  );

+

+/**

+  Enables the 32-bit paging mode on the CPU.

+

+  Enables the 32-bit paging mode on the CPU. CR0, CR3, CR4, and the page tables

+  must be properly initialized prior to calling this service. This function

+  assumes the current execution mode is 32-bit protected mode. This function is

+  only available on IA-32. After the 32-bit paging mode is enabled, control is

+  transferred to the function specified by EntryPoint using the new stack

+  specified by NewStack and passing in the parameters specified by Context1 and

+  Context2. Context1 and Context2 are optional and may be NULL. The function

+  EntryPoint must never return.

+

+  There are a number of constraints that must be followed before calling this

+  function:

+  1)  Interrupts must be disabled.

+  2)  The caller must be in 32-bit protected mode with flat descriptors. This

+      means all descriptors must have a base of 0 and a limit of 4GB.

+  3)  CR0 and CR4 must be compatible with 32-bit protected mode with flat

+      descriptors.

+  4)  CR3 must point to valid page tables that will be used once the transition

+      is complete, and those page tables must guarantee that the pages for this

+      function and the stack are identity mapped.

+

+  @param  EntryPoint  A pointer to function to call with the new stack after

+                      paging is enabled.

+  @param  Context1    A pointer to the context to pass into the EntryPoint

+                      function as the first parameter after paging is enabled.

+  @param  Context2    A pointer to the context to pass into the EntryPoint

+                      function as the second parameter after paging is enabled.

+  @param  NewStack    A pointer to the new stack to use for the EntryPoint

+                      function after paging is enabled.

+

+**/

+VOID

+EFIAPI

+InternalX86EnablePaging32 (

+  IN      SWITCH_STACK_ENTRY_POINT  EntryPoint,

+  IN      VOID                      *Context1,  OPTIONAL

+  IN      VOID                      *Context2,  OPTIONAL

+  IN      VOID                      *NewStack

+  );

+

+/**

+  Disables the 32-bit paging mode on the CPU.

+

+  Disables the 32-bit paging mode on the CPU and returns to 32-bit protected

+  mode. This function assumes the current execution mode is 32-paged protected

+  mode. This function is only available on IA-32. After the 32-bit paging mode

+  is disabled, control is transferred to the function specified by EntryPoint

+  using the new stack specified by NewStack and passing in the parameters

+  specified by Context1 and Context2. Context1 and Context2 are optional and

+  may be NULL. The function EntryPoint must never return.

+

+  There are a number of constraints that must be followed before calling this

+  function:

+  1)  Interrupts must be disabled.

+  2)  The caller must be in 32-bit paged mode.

+  3)  CR0, CR3, and CR4 must be compatible with 32-bit paged mode.

+  4)  CR3 must point to valid page tables that guarantee that the pages for

+      this function and the stack are identity mapped.

+

+  @param  EntryPoint  A pointer to function to call with the new stack after

+                      paging is disabled.

+  @param  Context1    A pointer to the context to pass into the EntryPoint

+                      function as the first parameter after paging is disabled.

+  @param  Context2    A pointer to the context to pass into the EntryPoint

+                      function as the second parameter after paging is

+                      disabled.

+  @param  NewStack    A pointer to the new stack to use for the EntryPoint

+                      function after paging is disabled.

+

+**/

+VOID

+EFIAPI

+InternalX86DisablePaging32 (

+  IN      SWITCH_STACK_ENTRY_POINT  EntryPoint,

+  IN      VOID                      *Context1,  OPTIONAL

+  IN      VOID                      *Context2,  OPTIONAL

+  IN      VOID                      *NewStack

+  );

+

+/**

+  Enables the 64-bit paging mode on the CPU.

+

+  Enables the 64-bit paging mode on the CPU. CR0, CR3, CR4, and the page tables

+  must be properly initialized prior to calling this service. This function

+  assumes the current execution mode is 32-bit protected mode with flat

+  descriptors. This function is only available on IA-32. After the 64-bit

+  paging mode is enabled, control is transferred to the function specified by

+  EntryPoint using the new stack specified by NewStack and passing in the

+  parameters specified by Context1 and Context2. Context1 and Context2 are

+  optional and may be 0. The function EntryPoint must never return.

+

+  @param  Cs          The 16-bit selector to load in the CS before EntryPoint

+                      is called. The descriptor in the GDT that this selector

+                      references must be setup for long mode.

+  @param  EntryPoint  The 64-bit virtual address of the function to call with

+                      the new stack after paging is enabled.

+  @param  Context1    The 64-bit virtual address of the context to pass into

+                      the EntryPoint function as the first parameter after

+                      paging is enabled.

+  @param  Context2    The 64-bit virtual address of the context to pass into

+                      the EntryPoint function as the second parameter after

+                      paging is enabled.

+  @param  NewStack    The 64-bit virtual address of the new stack to use for

+                      the EntryPoint function after paging is enabled.

+

+**/

+VOID

+EFIAPI

+InternalX86EnablePaging64 (

+  IN      UINT16                    Cs,

+  IN      UINT64                    EntryPoint,

+  IN      UINT64                    Context1,  OPTIONAL

+  IN      UINT64                    Context2,  OPTIONAL

+  IN      UINT64                    NewStack

+  );

+

+/**

+  Disables the 64-bit paging mode on the CPU.

+

+  Disables the 64-bit paging mode on the CPU and returns to 32-bit protected

+  mode. This function assumes the current execution mode is 64-paging mode.

+  This function is only available on x64. After the 64-bit paging mode is

+  disabled, control is transferred to the function specified by EntryPoint

+  using the new stack specified by NewStack and passing in the parameters

+  specified by Context1 and Context2. Context1 and Context2 are optional and

+  may be 0. The function EntryPoint must never return.

+

+  @param  Cs          The 16-bit selector to load in the CS before EntryPoint

+                      is called. The descriptor in the GDT that this selector

+                      references must be setup for 32-bit protected mode.

+  @param  EntryPoint  The 64-bit virtual address of the function to call with

+                      the new stack after paging is disabled.

+  @param  Context1    The 64-bit virtual address of the context to pass into

+                      the EntryPoint function as the first parameter after

+                      paging is disabled.

+  @param  Context2    The 64-bit virtual address of the context to pass into

+                      the EntryPoint function as the second parameter after

+                      paging is disabled.

+  @param  NewStack    The 64-bit virtual address of the new stack to use for

+                      the EntryPoint function after paging is disabled.

+

+**/

+VOID

+EFIAPI

+InternalX86DisablePaging64 (

+  IN      UINT16                    Cs,

+  IN      UINT32                    EntryPoint,

+  IN      UINT32                    Context1,  OPTIONAL

+  IN      UINT32                    Context2,  OPTIONAL

+  IN      UINT32                    NewStack

+  );

+

+/**

+  Generates a 16-bit random number through RDRAND instruction.

+

+  @param[out]  Rand     Buffer pointer to store the random result.

+

+  @retval TRUE          RDRAND call was successful.

+  @retval FALSE         Failed attempts to call RDRAND.

+

+ **/

+BOOLEAN

+EFIAPI

+InternalX86RdRand16 (

+  OUT     UINT16                    *Rand

+  );

+

+/**

+  Generates a 32-bit random number through RDRAND instruction.

+

+  @param[out]  Rand     Buffer pointer to store the random result.

+

+  @retval TRUE          RDRAND call was successful.

+  @retval FALSE         Failed attempts to call RDRAND.

+

+**/

+BOOLEAN

+EFIAPI

+InternalX86RdRand32 (

+  OUT     UINT32                    *Rand

+  );

+

+/**

+  Generates a 64-bit random number through RDRAND instruction.

+

+

+  @param[out]  Rand     Buffer pointer to store the random result.

+

+  @retval TRUE          RDRAND call was successful.

+  @retval FALSE         Failed attempts to call RDRAND.

+

+**/

+BOOLEAN

+EFIAPI

+InternalX86RdRand64  (

+  OUT     UINT64                    *Rand

+  );

+

+#else

+

+#endif

+

+#endif

diff --git a/debugging_demo/memtest86+/efi/Include/src/BaseLib/BitField.c b/debugging_demo/memtest86+/efi/Include/src/BaseLib/BitField.c
new file mode 100644
index 0000000..0f48a03
--- /dev/null
+++ b/debugging_demo/memtest86+/efi/Include/src/BaseLib/BitField.c
@@ -0,0 +1,1002 @@
+/** @file

+  Bit field functions of BaseLib.

+

+  Copyright (c) 2006 - 2018, Intel Corporation. All rights reserved.<BR>

+  SPDX-License-Identifier: BSD-2-Clause-Patent

+

+**/

+

+#include "BaseLibInternals.h"

+

+/**

+  Worker function that returns a bit field from Operand.

+

+  Returns the bitfield specified by the StartBit and the EndBit from Operand.

+

+  @param  Operand   Operand on which to perform the bitfield operation.

+  @param  StartBit  The ordinal of the least significant bit in the bit field.

+  @param  EndBit    The ordinal of the most significant bit in the bit field.

+

+  @return The bit field read.

+

+**/

+UINTN

+EFIAPI

+InternalBaseLibBitFieldReadUint (

+  IN      UINTN                     Operand,

+  IN      UINTN                     StartBit,

+  IN      UINTN                     EndBit

+  )

+{

+  //

+  // ~((UINTN)-2 << EndBit) is a mask in which bit[0] thru bit[EndBit]

+  // are 1's while bit[EndBit + 1] thru the most significant bit are 0's.

+  //

+  return (Operand & ~((UINTN)-2 << EndBit)) >> StartBit;

+}

+

+/**

+  Worker function that reads a bit field from Operand, performs a bitwise OR,

+  and returns the result.

+

+  Performs a bitwise OR between the bit field specified by StartBit and EndBit

+  in Operand and the value specified by AndData. All other bits in Operand are

+  preserved. The new value is returned.

+

+  If OrData is larger than the bitmask value range specified by StartBit and EndBit, then ASSERT().

+

+  @param  Operand   Operand on which to perform the bitfield operation.

+  @param  StartBit  The ordinal of the least significant bit in the bit field.

+  @param  EndBit    The ordinal of the most significant bit in the bit field.

+  @param  OrData    The value to OR with the read value from the value.

+

+  @return The new value.

+

+**/

+UINTN

+EFIAPI

+InternalBaseLibBitFieldOrUint (

+  IN      UINTN                     Operand,

+  IN      UINTN                     StartBit,

+  IN      UINTN                     EndBit,

+  IN      UINTN                     OrData

+  )

+{

+  //

+  // Higher bits in OrData those are not used must be zero.

+  //

+  // EndBit - StartBit + 1 might be 32 while the result right shifting 32 on a 32bit integer is undefined,

+  // So the logic is updated to right shift (EndBit - StartBit) bits and compare the last bit directly.

+  //

+  ASSERT ((OrData >> (EndBit - StartBit)) == ((OrData >> (EndBit - StartBit)) & 1));

+

+  //

+  // ~((UINTN)-2 << EndBit) is a mask in which bit[0] thru bit[EndBit]

+  // are 1's while bit[EndBit + 1] thru the most significant bit are 0's.

+  //

+  return Operand | ((OrData << StartBit) & ~((UINTN) -2 << EndBit));

+}

+

+/**

+  Worker function that reads a bit field from Operand, performs a bitwise AND,

+  and returns the result.

+

+  Performs a bitwise AND between the bit field specified by StartBit and EndBit

+  in Operand and the value specified by AndData. All other bits in Operand are

+  preserved. The new value is returned.

+

+  If AndData is larger than the bitmask value range specified by StartBit and EndBit, then ASSERT().

+

+  @param  Operand   Operand on which to perform the bitfield operation.

+  @param  StartBit  The ordinal of the least significant bit in the bit field.

+  @param  EndBit    The ordinal of the most significant bit in the bit field.

+  @param  AndData    The value to And with the read value from the value.

+

+  @return The new value.

+

+**/

+UINTN

+EFIAPI

+InternalBaseLibBitFieldAndUint (

+  IN      UINTN                     Operand,

+  IN      UINTN                     StartBit,

+  IN      UINTN                     EndBit,

+  IN      UINTN                     AndData

+  )

+{

+  //

+  // Higher bits in AndData those are not used must be zero.

+  //

+  // EndBit - StartBit + 1 might be 32 while the result right shifting 32 on a 32bit integer is undefined,

+  // So the logic is updated to right shift (EndBit - StartBit) bits and compare the last bit directly.

+  //

+  ASSERT ((AndData >> (EndBit - StartBit)) == ((AndData >> (EndBit - StartBit)) & 1));

+

+  //

+  // ~((UINTN)-2 << EndBit) is a mask in which bit[0] thru bit[EndBit]

+  // are 1's while bit[EndBit + 1] thru the most significant bit are 0's.

+  //

+  return Operand & ~((~AndData << StartBit) & ~((UINTN)-2 << EndBit));

+}

+

+/**

+  Returns a bit field from an 8-bit value.

+

+  Returns the bitfield specified by the StartBit and the EndBit from Operand.

+

+  If 8-bit operations are not supported, then ASSERT().

+  If StartBit is greater than 7, then ASSERT().

+  If EndBit is greater than 7, then ASSERT().

+  If EndBit is less than StartBit, then ASSERT().

+

+  @param  Operand   Operand on which to perform the bitfield operation.

+  @param  StartBit  The ordinal of the least significant bit in the bit field.

+                    Range 0..7.

+  @param  EndBit    The ordinal of the most significant bit in the bit field.

+                    Range 0..7.

+

+  @return The bit field read.

+

+**/

+UINT8

+EFIAPI

+BitFieldRead8 (

+  IN      UINT8                     Operand,

+  IN      UINTN                     StartBit,

+  IN      UINTN                     EndBit

+  )

+{

+  ASSERT (EndBit < 8);

+  ASSERT (StartBit <= EndBit);

+  return (UINT8)InternalBaseLibBitFieldReadUint (Operand, StartBit, EndBit);

+}

+

+/**

+  Writes a bit field to an 8-bit value, and returns the result.

+

+  Writes Value to the bit field specified by the StartBit and the EndBit in

+  Operand. All other bits in Operand are preserved. The new 8-bit value is

+  returned.

+

+  If 8-bit operations are not supported, then ASSERT().

+  If StartBit is greater than 7, then ASSERT().

+  If EndBit is greater than 7, then ASSERT().

+  If EndBit is less than StartBit, then ASSERT().

+  If Value is larger than the bitmask value range specified by StartBit and EndBit, then ASSERT().

+

+  @param  Operand   Operand on which to perform the bitfield operation.

+  @param  StartBit  The ordinal of the least significant bit in the bit field.

+                    Range 0..7.

+  @param  EndBit    The ordinal of the most significant bit in the bit field.

+                    Range 0..7.

+  @param  Value     The new value of the bit field.

+

+  @return The new 8-bit value.

+

+**/

+UINT8

+EFIAPI

+BitFieldWrite8 (

+  IN      UINT8                     Operand,

+  IN      UINTN                     StartBit,

+  IN      UINTN                     EndBit,

+  IN      UINT8                     Value

+  )

+{

+  ASSERT (EndBit < 8);

+  ASSERT (StartBit <= EndBit);

+  return BitFieldAndThenOr8 (Operand, StartBit, EndBit, 0, Value);

+}

+

+/**

+  Reads a bit field from an 8-bit value, performs a bitwise OR, and returns the

+  result.

+

+  Performs a bitwise OR between the bit field specified by StartBit

+  and EndBit in Operand and the value specified by OrData. All other bits in

+  Operand are preserved. The new 8-bit value is returned.

+

+  If 8-bit operations are not supported, then ASSERT().

+  If StartBit is greater than 7, then ASSERT().

+  If EndBit is greater than 7, then ASSERT().

+  If EndBit is less than StartBit, then ASSERT().

+  If OrData is larger than the bitmask value range specified by StartBit and EndBit, then ASSERT().

+

+  @param  Operand   Operand on which to perform the bitfield operation.

+  @param  StartBit  The ordinal of the least significant bit in the bit field.

+                    Range 0..7.

+  @param  EndBit    The ordinal of the most significant bit in the bit field.

+                    Range 0..7.

+  @param  OrData    The value to OR with the read value from the value.

+

+  @return The new 8-bit value.

+

+**/

+UINT8

+EFIAPI

+BitFieldOr8 (

+  IN      UINT8                     Operand,

+  IN      UINTN                     StartBit,

+  IN      UINTN                     EndBit,

+  IN      UINT8                     OrData

+  )

+{

+  ASSERT (EndBit < 8);

+  ASSERT (StartBit <= EndBit);

+  return (UINT8)InternalBaseLibBitFieldOrUint (Operand, StartBit, EndBit, OrData);

+}

+

+/**

+  Reads a bit field from an 8-bit value, performs a bitwise AND, and returns

+  the result.

+

+  Performs a bitwise AND between the bit field specified by StartBit and EndBit

+  in Operand and the value specified by AndData. All other bits in Operand are

+  preserved. The new 8-bit value is returned.

+

+  If 8-bit operations are not supported, then ASSERT().

+  If StartBit is greater than 7, then ASSERT().

+  If EndBit is greater than 7, then ASSERT().

+  If EndBit is less than StartBit, then ASSERT().

+  If AndData is larger than the bitmask value range specified by StartBit and EndBit, then ASSERT().

+

+  @param  Operand   Operand on which to perform the bitfield operation.

+  @param  StartBit  The ordinal of the least significant bit in the bit field.

+                    Range 0..7.

+  @param  EndBit    The ordinal of the most significant bit in the bit field.

+                    Range 0..7.

+  @param  AndData   The value to AND with the read value from the value.

+

+  @return The new 8-bit value.

+

+**/

+UINT8

+EFIAPI

+BitFieldAnd8 (

+  IN      UINT8                     Operand,

+  IN      UINTN                     StartBit,

+  IN      UINTN                     EndBit,

+  IN      UINT8                     AndData

+  )

+{

+  ASSERT (EndBit < 8);

+  ASSERT (StartBit <= EndBit);

+  return (UINT8)InternalBaseLibBitFieldAndUint (Operand, StartBit, EndBit, AndData);

+}

+

+/**

+  Reads a bit field from an 8-bit value, performs a bitwise AND followed by a

+  bitwise OR, and returns the result.

+

+  Performs a bitwise AND between the bit field specified by StartBit and EndBit

+  in Operand and the value specified by AndData, followed by a bitwise

+  OR with value specified by OrData. All other bits in Operand are

+  preserved. The new 8-bit value is returned.

+

+  If 8-bit operations are not supported, then ASSERT().

+  If StartBit is greater than 7, then ASSERT().

+  If EndBit is greater than 7, then ASSERT().

+  If EndBit is less than StartBit, then ASSERT().

+  If AndData is larger than the bitmask value range specified by StartBit and EndBit, then ASSERT().

+  If OrData is larger than the bitmask value range specified by StartBit and EndBit, then ASSERT().

+

+  @param  Operand   Operand on which to perform the bitfield operation.

+  @param  StartBit  The ordinal of the least significant bit in the bit field.

+                    Range 0..7.

+  @param  EndBit    The ordinal of the most significant bit in the bit field.

+                    Range 0..7.

+  @param  AndData   The value to AND with the read value from the value.

+  @param  OrData    The value to OR with the result of the AND operation.

+

+  @return The new 8-bit value.

+

+**/

+UINT8

+EFIAPI

+BitFieldAndThenOr8 (

+  IN      UINT8                     Operand,

+  IN      UINTN                     StartBit,

+  IN      UINTN                     EndBit,

+  IN      UINT8                     AndData,

+  IN      UINT8                     OrData

+  )

+{

+  ASSERT (EndBit < 8);

+  ASSERT (StartBit <= EndBit);

+  return BitFieldOr8 (

+           BitFieldAnd8 (Operand, StartBit, EndBit, AndData),

+           StartBit,

+           EndBit,

+           OrData

+           );

+}

+

+/**

+  Returns a bit field from a 16-bit value.

+

+  Returns the bitfield specified by the StartBit and the EndBit from Operand.

+

+  If 16-bit operations are not supported, then ASSERT().

+  If StartBit is greater than 15, then ASSERT().

+  If EndBit is greater than 15, then ASSERT().

+  If EndBit is less than StartBit, then ASSERT().

+

+  @param  Operand   Operand on which to perform the bitfield operation.

+  @param  StartBit  The ordinal of the least significant bit in the bit field.

+                    Range 0..15.

+  @param  EndBit    The ordinal of the most significant bit in the bit field.

+                    Range 0..15.

+

+  @return The bit field read.

+

+**/

+UINT16

+EFIAPI

+BitFieldRead16 (

+  IN      UINT16                    Operand,

+  IN      UINTN                     StartBit,

+  IN      UINTN                     EndBit

+  )

+{

+  ASSERT (EndBit < 16);

+  ASSERT (StartBit <= EndBit);

+  return (UINT16)InternalBaseLibBitFieldReadUint (Operand, StartBit, EndBit);

+}

+

+/**

+  Writes a bit field to a 16-bit value, and returns the result.

+

+  Writes Value to the bit field specified by the StartBit and the EndBit in

+  Operand. All other bits in Operand are preserved. The new 16-bit value is

+  returned.

+

+  If 16-bit operations are not supported, then ASSERT().

+  If StartBit is greater than 15, then ASSERT().

+  If EndBit is greater than 15, then ASSERT().

+  If EndBit is less than StartBit, then ASSERT().

+  If Value is larger than the bitmask value range specified by StartBit and EndBit, then ASSERT().

+

+  @param  Operand   Operand on which to perform the bitfield operation.

+  @param  StartBit  The ordinal of the least significant bit in the bit field.

+                    Range 0..15.

+  @param  EndBit    The ordinal of the most significant bit in the bit field.

+                    Range 0..15.

+  @param  Value     The new value of the bit field.

+

+  @return The new 16-bit value.

+

+**/

+UINT16

+EFIAPI

+BitFieldWrite16 (

+  IN      UINT16                    Operand,

+  IN      UINTN                     StartBit,

+  IN      UINTN                     EndBit,

+  IN      UINT16                    Value

+  )

+{

+  ASSERT (EndBit < 16);

+  ASSERT (StartBit <= EndBit);

+  return BitFieldAndThenOr16 (Operand, StartBit, EndBit, 0, Value);

+}

+

+/**

+  Reads a bit field from a 16-bit value, performs a bitwise OR, and returns the

+  result.

+

+  Performs a bitwise OR between the bit field specified by StartBit

+  and EndBit in Operand and the value specified by OrData. All other bits in

+  Operand are preserved. The new 16-bit value is returned.

+

+  If 16-bit operations are not supported, then ASSERT().

+  If StartBit is greater than 15, then ASSERT().

+  If EndBit is greater than 15, then ASSERT().

+  If EndBit is less than StartBit, then ASSERT().

+  If OrData is larger than the bitmask value range specified by StartBit and EndBit, then ASSERT().

+

+  @param  Operand   Operand on which to perform the bitfield operation.

+  @param  StartBit  The ordinal of the least significant bit in the bit field.

+                    Range 0..15.

+  @param  EndBit    The ordinal of the most significant bit in the bit field.

+                    Range 0..15.

+  @param  OrData    The value to OR with the read value from the value.

+

+  @return The new 16-bit value.

+

+**/

+UINT16

+EFIAPI

+BitFieldOr16 (

+  IN      UINT16                    Operand,

+  IN      UINTN                     StartBit,

+  IN      UINTN                     EndBit,

+  IN      UINT16                    OrData

+  )

+{

+  ASSERT (EndBit < 16);

+  ASSERT (StartBit <= EndBit);

+  return (UINT16)InternalBaseLibBitFieldOrUint (Operand, StartBit, EndBit, OrData);

+}

+

+/**

+  Reads a bit field from a 16-bit value, performs a bitwise AND, and returns

+  the result.

+

+  Performs a bitwise AND between the bit field specified by StartBit and EndBit

+  in Operand and the value specified by AndData. All other bits in Operand are

+  preserved. The new 16-bit value is returned.

+

+  If 16-bit operations are not supported, then ASSERT().

+  If StartBit is greater than 15, then ASSERT().

+  If EndBit is greater than 15, then ASSERT().

+  If EndBit is less than StartBit, then ASSERT().

+  If AndData is larger than the bitmask value range specified by StartBit and EndBit, then ASSERT().

+

+  @param  Operand   Operand on which to perform the bitfield operation.

+  @param  StartBit  The ordinal of the least significant bit in the bit field.

+                    Range 0..15.

+  @param  EndBit    The ordinal of the most significant bit in the bit field.

+                    Range 0..15.

+  @param  AndData   The value to AND with the read value from the value.

+

+  @return The new 16-bit value.

+

+**/

+UINT16

+EFIAPI

+BitFieldAnd16 (

+  IN      UINT16                    Operand,

+  IN      UINTN                     StartBit,

+  IN      UINTN                     EndBit,

+  IN      UINT16                    AndData

+  )

+{

+  ASSERT (EndBit < 16);

+  ASSERT (StartBit <= EndBit);

+  return (UINT16)InternalBaseLibBitFieldAndUint (Operand, StartBit, EndBit, AndData);

+}

+

+/**

+  Reads a bit field from a 16-bit value, performs a bitwise AND followed by a

+  bitwise OR, and returns the result.

+

+  Performs a bitwise AND between the bit field specified by StartBit and EndBit

+  in Operand and the value specified by AndData, followed by a bitwise

+  OR with value specified by OrData. All other bits in Operand are

+  preserved. The new 16-bit value is returned.

+

+  If 16-bit operations are not supported, then ASSERT().

+  If StartBit is greater than 15, then ASSERT().

+  If EndBit is greater than 15, then ASSERT().

+  If EndBit is less than StartBit, then ASSERT().

+  If AndData is larger than the bitmask value range specified by StartBit and EndBit, then ASSERT().

+  If OrData is larger than the bitmask value range specified by StartBit and EndBit, then ASSERT().

+

+  @param  Operand   Operand on which to perform the bitfield operation.

+  @param  StartBit  The ordinal of the least significant bit in the bit field.

+                    Range 0..15.

+  @param  EndBit    The ordinal of the most significant bit in the bit field.

+                    Range 0..15.

+  @param  AndData   The value to AND with the read value from the value.

+  @param  OrData    The value to OR with the result of the AND operation.

+

+  @return The new 16-bit value.

+

+**/

+UINT16

+EFIAPI

+BitFieldAndThenOr16 (

+  IN      UINT16                    Operand,

+  IN      UINTN                     StartBit,

+  IN      UINTN                     EndBit,

+  IN      UINT16                    AndData,

+  IN      UINT16                    OrData

+  )

+{

+  ASSERT (EndBit < 16);

+  ASSERT (StartBit <= EndBit);

+  return BitFieldOr16 (

+           BitFieldAnd16 (Operand, StartBit, EndBit, AndData),

+           StartBit,

+           EndBit,

+           OrData

+           );

+}

+

+/**

+  Returns a bit field from a 32-bit value.

+

+  Returns the bitfield specified by the StartBit and the EndBit from Operand.

+

+  If 32-bit operations are not supported, then ASSERT().

+  If StartBit is greater than 31, then ASSERT().

+  If EndBit is greater than 31, then ASSERT().

+  If EndBit is less than StartBit, then ASSERT().

+

+  @param  Operand   Operand on which to perform the bitfield operation.

+  @param  StartBit  The ordinal of the least significant bit in the bit field.

+                    Range 0..31.

+  @param  EndBit    The ordinal of the most significant bit in the bit field.

+                    Range 0..31.

+

+  @return The bit field read.

+

+**/

+UINT32

+EFIAPI

+BitFieldRead32 (

+  IN      UINT32                    Operand,

+  IN      UINTN                     StartBit,

+  IN      UINTN                     EndBit

+  )

+{

+  ASSERT (EndBit < 32);

+  ASSERT (StartBit <= EndBit);

+  return (UINT32)InternalBaseLibBitFieldReadUint (Operand, StartBit, EndBit);

+}

+

+/**

+  Writes a bit field to a 32-bit value, and returns the result.

+

+  Writes Value to the bit field specified by the StartBit and the EndBit in

+  Operand. All other bits in Operand are preserved. The new 32-bit value is

+  returned.

+

+  If 32-bit operations are not supported, then ASSERT().

+  If StartBit is greater than 31, then ASSERT().

+  If EndBit is greater than 31, then ASSERT().

+  If EndBit is less than StartBit, then ASSERT().

+  If Value is larger than the bitmask value range specified by StartBit and EndBit, then ASSERT().

+

+  @param  Operand   Operand on which to perform the bitfield operation.

+  @param  StartBit  The ordinal of the least significant bit in the bit field.

+                    Range 0..31.

+  @param  EndBit    The ordinal of the most significant bit in the bit field.

+                    Range 0..31.

+  @param  Value     The new value of the bit field.

+

+  @return The new 32-bit value.

+

+**/

+UINT32

+EFIAPI

+BitFieldWrite32 (

+  IN      UINT32                    Operand,

+  IN      UINTN                     StartBit,

+  IN      UINTN                     EndBit,

+  IN      UINT32                    Value

+  )

+{

+  ASSERT (EndBit < 32);

+  ASSERT (StartBit <= EndBit);

+  return BitFieldAndThenOr32 (Operand, StartBit, EndBit, 0, Value);

+}

+

+/**

+  Reads a bit field from a 32-bit value, performs a bitwise OR, and returns the

+  result.

+

+  Performs a bitwise OR between the bit field specified by StartBit

+  and EndBit in Operand and the value specified by OrData. All other bits in

+  Operand are preserved. The new 32-bit value is returned.

+

+  If 32-bit operations are not supported, then ASSERT().

+  If StartBit is greater than 31, then ASSERT().

+  If EndBit is greater than 31, then ASSERT().

+  If EndBit is less than StartBit, then ASSERT().

+  If OrData is larger than the bitmask value range specified by StartBit and EndBit, then ASSERT().

+

+  @param  Operand   Operand on which to perform the bitfield operation.

+  @param  StartBit  The ordinal of the least significant bit in the bit field.

+                    Range 0..31.

+  @param  EndBit    The ordinal of the most significant bit in the bit field.

+                    Range 0..31.

+  @param  OrData    The value to OR with the read value from the value.

+

+  @return The new 32-bit value.

+

+**/

+UINT32

+EFIAPI

+BitFieldOr32 (

+  IN      UINT32                    Operand,

+  IN      UINTN                     StartBit,

+  IN      UINTN                     EndBit,

+  IN      UINT32                    OrData

+  )

+{

+  ASSERT (EndBit < 32);

+  ASSERT (StartBit <= EndBit);

+  return (UINT32)InternalBaseLibBitFieldOrUint (Operand, StartBit, EndBit, OrData);

+}

+

+/**

+  Reads a bit field from a 32-bit value, performs a bitwise AND, and returns

+  the result.

+

+  Performs a bitwise AND between the bit field specified by StartBit and EndBit

+  in Operand and the value specified by AndData. All other bits in Operand are

+  preserved. The new 32-bit value is returned.

+

+  If 32-bit operations are not supported, then ASSERT().

+  If StartBit is greater than 31, then ASSERT().

+  If EndBit is greater than 31, then ASSERT().

+  If EndBit is less than StartBit, then ASSERT().

+  If AndData is larger than the bitmask value range specified by StartBit and EndBit, then ASSERT().

+

+  @param  Operand   Operand on which to perform the bitfield operation.

+  @param  StartBit  The ordinal of the least significant bit in the bit field.

+                    Range 0..31.

+  @param  EndBit    The ordinal of the most significant bit in the bit field.

+                    Range 0..31.

+  @param  AndData   The value to AND with the read value from the value.

+

+  @return The new 32-bit value.

+

+**/

+UINT32

+EFIAPI

+BitFieldAnd32 (

+  IN      UINT32                    Operand,

+  IN      UINTN                     StartBit,

+  IN      UINTN                     EndBit,

+  IN      UINT32                    AndData

+  )

+{

+  ASSERT (EndBit < 32);

+  ASSERT (StartBit <= EndBit);

+  return (UINT32)InternalBaseLibBitFieldAndUint (Operand, StartBit, EndBit, AndData);

+}

+

+/**

+  Reads a bit field from a 32-bit value, performs a bitwise AND followed by a

+  bitwise OR, and returns the result.

+

+  Performs a bitwise AND between the bit field specified by StartBit and EndBit

+  in Operand and the value specified by AndData, followed by a bitwise

+  OR with value specified by OrData. All other bits in Operand are

+  preserved. The new 32-bit value is returned.

+

+  If 32-bit operations are not supported, then ASSERT().

+  If StartBit is greater than 31, then ASSERT().

+  If EndBit is greater than 31, then ASSERT().

+  If EndBit is less than StartBit, then ASSERT().

+  If AndData is larger than the bitmask value range specified by StartBit and EndBit, then ASSERT().

+  If OrData is larger than the bitmask value range specified by StartBit and EndBit, then ASSERT().

+

+  @param  Operand   Operand on which to perform the bitfield operation.

+  @param  StartBit  The ordinal of the least significant bit in the bit field.

+                    Range 0..31.

+  @param  EndBit    The ordinal of the most significant bit in the bit field.

+                    Range 0..31.

+  @param  AndData   The value to AND with the read value from the value.

+  @param  OrData    The value to OR with the result of the AND operation.

+

+  @return The new 32-bit value.

+

+**/

+UINT32

+EFIAPI

+BitFieldAndThenOr32 (

+  IN      UINT32                    Operand,

+  IN      UINTN                     StartBit,

+  IN      UINTN                     EndBit,

+  IN      UINT32                    AndData,

+  IN      UINT32                    OrData

+  )

+{

+  ASSERT (EndBit < 32);

+  ASSERT (StartBit <= EndBit);

+  return BitFieldOr32 (

+           BitFieldAnd32 (Operand, StartBit, EndBit, AndData),

+           StartBit,

+           EndBit,

+           OrData

+           );

+}

+

+/**

+  Returns a bit field from a 64-bit value.

+

+  Returns the bitfield specified by the StartBit and the EndBit from Operand.

+

+  If 64-bit operations are not supported, then ASSERT().

+  If StartBit is greater than 63, then ASSERT().

+  If EndBit is greater than 63, then ASSERT().

+  If EndBit is less than StartBit, then ASSERT().

+

+  @param  Operand   Operand on which to perform the bitfield operation.

+  @param  StartBit  The ordinal of the least significant bit in the bit field.

+                    Range 0..63.

+  @param  EndBit    The ordinal of the most significant bit in the bit field.

+                    Range 0..63.

+

+  @return The bit field read.

+

+**/

+UINT64

+EFIAPI

+BitFieldRead64 (

+  IN      UINT64                    Operand,

+  IN      UINTN                     StartBit,

+  IN      UINTN                     EndBit

+  )

+{

+  ASSERT (EndBit < 64);

+  ASSERT (StartBit <= EndBit);

+  return RShiftU64 (Operand & ~LShiftU64 ((UINT64)-2, EndBit), StartBit);

+}

+

+/**

+  Writes a bit field to a 64-bit value, and returns the result.

+

+  Writes Value to the bit field specified by the StartBit and the EndBit in

+  Operand. All other bits in Operand are preserved. The new 64-bit value is

+  returned.

+

+  If 64-bit operations are not supported, then ASSERT().

+  If StartBit is greater than 63, then ASSERT().

+  If EndBit is greater than 63, then ASSERT().

+  If EndBit is less than StartBit, then ASSERT().

+  If Value is larger than the bitmask value range specified by StartBit and EndBit, then ASSERT().

+

+  @param  Operand   Operand on which to perform the bitfield operation.

+  @param  StartBit  The ordinal of the least significant bit in the bit field.

+                    Range 0..63.

+  @param  EndBit    The ordinal of the most significant bit in the bit field.

+                    Range 0..63.

+  @param  Value     The new value of the bit field.

+

+  @return The new 64-bit value.

+

+**/

+UINT64

+EFIAPI

+BitFieldWrite64 (

+  IN      UINT64                    Operand,

+  IN      UINTN                     StartBit,

+  IN      UINTN                     EndBit,

+  IN      UINT64                    Value

+  )

+{

+  ASSERT (EndBit < 64);

+  ASSERT (StartBit <= EndBit);

+  return BitFieldAndThenOr64 (Operand, StartBit, EndBit, 0, Value);

+}

+

+/**

+  Reads a bit field from a 64-bit value, performs a bitwise OR, and returns the

+  result.

+

+  Performs a bitwise OR between the bit field specified by StartBit

+  and EndBit in Operand and the value specified by OrData. All other bits in

+  Operand are preserved. The new 64-bit value is returned.

+

+  If 64-bit operations are not supported, then ASSERT().

+  If StartBit is greater than 63, then ASSERT().

+  If EndBit is greater than 63, then ASSERT().

+  If EndBit is less than StartBit, then ASSERT().

+  If OrData is larger than the bitmask value range specified by StartBit and EndBit, then ASSERT().

+

+  @param  Operand   Operand on which to perform the bitfield operation.

+  @param  StartBit  The ordinal of the least significant bit in the bit field.

+                    Range 0..63.

+  @param  EndBit    The ordinal of the most significant bit in the bit field.

+                    Range 0..63.

+  @param  OrData    The value to OR with the read value from the value

+

+  @return The new 64-bit value.

+

+**/

+UINT64

+EFIAPI

+BitFieldOr64 (

+  IN      UINT64                    Operand,

+  IN      UINTN                     StartBit,

+  IN      UINTN                     EndBit,

+  IN      UINT64                    OrData

+  )

+{

+  UINT64  Value1;

+  UINT64  Value2;

+

+  ASSERT (EndBit < 64);

+  ASSERT (StartBit <= EndBit);

+  //

+  // Higher bits in OrData those are not used must be zero.

+  //

+  // EndBit - StartBit + 1 might be 64 while the result right shifting 64 on RShiftU64() API is invalid,

+  // So the logic is updated to right shift (EndBit - StartBit) bits and compare the last bit directly.

+  //

+  ASSERT (RShiftU64 (OrData, EndBit - StartBit) == (RShiftU64 (OrData, EndBit - StartBit) & 1));

+

+  Value1 = LShiftU64 (OrData, StartBit);

+  Value2 = LShiftU64 ((UINT64) - 2, EndBit);

+

+  return Operand | (Value1 & ~Value2);

+}

+

+/**

+  Reads a bit field from a 64-bit value, performs a bitwise AND, and returns

+  the result.

+

+  Performs a bitwise AND between the bit field specified by StartBit and EndBit

+  in Operand and the value specified by AndData. All other bits in Operand are

+  preserved. The new 64-bit value is returned.

+

+  If 64-bit operations are not supported, then ASSERT().

+  If StartBit is greater than 63, then ASSERT().

+  If EndBit is greater than 63, then ASSERT().

+  If EndBit is less than StartBit, then ASSERT().

+  If AndData is larger than the bitmask value range specified by StartBit and EndBit, then ASSERT().

+

+  @param  Operand   Operand on which to perform the bitfield operation.

+  @param  StartBit  The ordinal of the least significant bit in the bit field.

+                    Range 0..63.

+  @param  EndBit    The ordinal of the most significant bit in the bit field.

+                    Range 0..63.

+  @param  AndData   The value to AND with the read value from the value.

+

+  @return The new 64-bit value.

+

+**/

+UINT64

+EFIAPI

+BitFieldAnd64 (

+  IN      UINT64                    Operand,

+  IN      UINTN                     StartBit,

+  IN      UINTN                     EndBit,

+  IN      UINT64                    AndData

+  )

+{

+  UINT64  Value1;

+  UINT64  Value2;

+

+  ASSERT (EndBit < 64);

+  ASSERT (StartBit <= EndBit);

+  //

+  // Higher bits in AndData those are not used must be zero.

+  //

+  // EndBit - StartBit + 1 might be 64 while the right shifting 64 on RShiftU64() API is invalid,

+  // So the logic is updated to right shift (EndBit - StartBit) bits and compare the last bit directly.

+  //

+  ASSERT (RShiftU64 (AndData, EndBit - StartBit) == (RShiftU64 (AndData, EndBit - StartBit) & 1));

+

+  Value1 = LShiftU64 (~AndData, StartBit);

+  Value2 = LShiftU64 ((UINT64)-2, EndBit);

+

+  return Operand & ~(Value1 & ~Value2);

+}

+

+/**

+  Reads a bit field from a 64-bit value, performs a bitwise AND followed by a

+  bitwise OR, and returns the result.

+

+  Performs a bitwise AND between the bit field specified by StartBit and EndBit

+  in Operand and the value specified by AndData, followed by a bitwise

+  OR with value specified by OrData. All other bits in Operand are

+  preserved. The new 64-bit value is returned.

+

+  If 64-bit operations are not supported, then ASSERT().

+  If StartBit is greater than 63, then ASSERT().

+  If EndBit is greater than 63, then ASSERT().

+  If EndBit is less than StartBit, then ASSERT().

+  If AndData is larger than the bitmask value range specified by StartBit and EndBit, then ASSERT().

+  If OrData is larger than the bitmask value range specified by StartBit and EndBit, then ASSERT().

+

+  @param  Operand   Operand on which to perform the bitfield operation.

+  @param  StartBit  The ordinal of the least significant bit in the bit field.

+                    Range 0..63.

+  @param  EndBit    The ordinal of the most significant bit in the bit field.

+                    Range 0..63.

+  @param  AndData   The value to AND with the read value from the value.

+  @param  OrData    The value to OR with the result of the AND operation.

+

+  @return The new 64-bit value.

+

+**/

+UINT64

+EFIAPI

+BitFieldAndThenOr64 (

+  IN      UINT64                    Operand,

+  IN      UINTN                     StartBit,

+  IN      UINTN                     EndBit,

+  IN      UINT64                    AndData,

+  IN      UINT64                    OrData

+  )

+{

+  ASSERT (EndBit < 64);

+  ASSERT (StartBit <= EndBit);

+  return BitFieldOr64 (

+           BitFieldAnd64 (Operand, StartBit, EndBit, AndData),

+           StartBit,

+           EndBit,

+           OrData

+           );

+}

+

+/**

+  Reads a bit field from a 32-bit value, counts and returns

+  the number of set bits.

+

+  Counts the number of set bits in the  bit field specified by

+  StartBit and EndBit in Operand. The count is returned.

+

+  If StartBit is greater than 31, then ASSERT().

+  If EndBit is greater than 31, then ASSERT().

+  If EndBit is less than StartBit, then ASSERT().

+

+  @param  Operand   Operand on which to perform the bitfield operation.

+  @param  StartBit  The ordinal of the least significant bit in the bit field.

+                    Range 0..31.

+  @param  EndBit    The ordinal of the most significant bit in the bit field.

+                    Range 0..31.

+

+  @return The number of bits set between StartBit and EndBit.

+

+**/

+UINT8

+EFIAPI

+BitFieldCountOnes32 (

+  IN       UINT32                   Operand,

+  IN       UINTN                    StartBit,

+  IN       UINTN                    EndBit

+  )

+{

+  UINT32 Count;

+

+  ASSERT (EndBit < 32);

+  ASSERT (StartBit <= EndBit);

+

+  Count = BitFieldRead32 (Operand, StartBit, EndBit);

+  Count -= ((Count >> 1) & 0x55555555);

+  Count = (Count & 0x33333333) + ((Count >> 2) & 0x33333333);

+  Count += Count >> 4;

+  Count &= 0x0F0F0F0F;

+  Count += Count >> 8;

+  Count += Count >> 16;

+

+  return (UINT8) Count & 0x3F;

+}

+

+/**

+   Reads a bit field from a 64-bit value, counts and returns

+   the number of set bits.

+

+   Counts the number of set bits in the  bit field specified by

+   StartBit and EndBit in Operand. The count is returned.

+

+   If StartBit is greater than 63, then ASSERT().

+   If EndBit is greater than 63, then ASSERT().

+   If EndBit is less than StartBit, then ASSERT().

+

+   @param  Operand   Operand on which to perform the bitfield operation.

+   @param  StartBit  The ordinal of the least significant bit in the bit field.

+   Range 0..63.

+   @param  EndBit    The ordinal of the most significant bit in the bit field.

+   Range 0..63.

+

+   @return The number of bits set between StartBit and EndBit.

+

+**/

+UINT8

+EFIAPI

+BitFieldCountOnes64 (

+  IN       UINT64                   Operand,

+  IN       UINTN                    StartBit,

+  IN       UINTN                    EndBit

+  )

+{

+  UINT64 BitField;

+  UINT8 Count;

+

+  ASSERT (EndBit < 64);

+  ASSERT (StartBit <= EndBit);

+

+  BitField = BitFieldRead64 (Operand, StartBit, EndBit);

+  Count = BitFieldCountOnes32 ((UINT32) BitField, 0, 31);

+  Count += BitFieldCountOnes32 ((UINT32) RShiftU64(BitField, 32), 0, 31);

+

+  return Count;

+}

+

diff --git a/debugging_demo/memtest86+/efi/Include/src/BaseLib/CheckSum.c b/debugging_demo/memtest86+/efi/Include/src/BaseLib/CheckSum.c
new file mode 100644
index 0000000..d91a7a0
--- /dev/null
+++ b/debugging_demo/memtest86+/efi/Include/src/BaseLib/CheckSum.c
@@ -0,0 +1,626 @@
+/** @file

+  Utility functions to generate checksum based on 2's complement

+  algorithm.

+

+  Copyright (c) 2007 - 2018, Intel Corporation. All rights reserved.<BR>

+  SPDX-License-Identifier: BSD-2-Clause-Patent

+

+**/

+

+#include "BaseLibInternals.h"

+

+/**

+  Returns the sum of all elements in a buffer in unit of UINT8.

+  During calculation, the carry bits are dropped.

+

+  This function calculates the sum of all elements in a buffer

+  in unit of UINT8. The carry bits in result of addition are dropped.

+  The result is returned as UINT8. If Length is Zero, then Zero is

+  returned.

+

+  If Buffer is NULL, then ASSERT().

+  If Length is greater than (MAX_ADDRESS - Buffer + 1), then ASSERT().

+

+  @param  Buffer      The pointer to the buffer to carry out the sum operation.

+  @param  Length      The size, in bytes, of Buffer.

+

+  @return Sum         The sum of Buffer with carry bits dropped during additions.

+

+**/

+UINT8

+EFIAPI

+CalculateSum8 (

+  IN      CONST UINT8              *Buffer,

+  IN      UINTN                     Length

+  )

+{

+  UINT8     Sum;

+  UINTN     Count;

+

+  ASSERT (Buffer != NULL);

+  ASSERT (Length <= (MAX_ADDRESS - ((UINTN) Buffer) + 1));

+

+  for (Sum = 0, Count = 0; Count < Length; Count++) {

+    Sum = (UINT8) (Sum + *(Buffer + Count));

+  }

+

+  return Sum;

+}

+

+

+/**

+  Returns the two's complement checksum of all elements in a buffer

+  of 8-bit values.

+

+  This function first calculates the sum of the 8-bit values in the

+  buffer specified by Buffer and Length.  The carry bits in the result

+  of addition are dropped. Then, the two's complement of the sum is

+  returned.  If Length is 0, then 0 is returned.

+

+  If Buffer is NULL, then ASSERT().

+  If Length is greater than (MAX_ADDRESS - Buffer + 1), then ASSERT().

+

+  @param  Buffer      The pointer to the buffer to carry out the checksum operation.

+  @param  Length      The size, in bytes, of Buffer.

+

+  @return Checksum    The 2's complement checksum of Buffer.

+

+**/

+UINT8

+EFIAPI

+CalculateCheckSum8 (

+  IN      CONST UINT8              *Buffer,

+  IN      UINTN                     Length

+  )

+{

+  UINT8     CheckSum;

+

+  CheckSum = CalculateSum8 (Buffer, Length);

+

+  //

+  // Return the checksum based on 2's complement.

+  //

+  return (UINT8) (0x100 - CheckSum);

+}

+

+/**

+  Returns the sum of all elements in a buffer of 16-bit values.  During

+  calculation, the carry bits are dropped.

+

+  This function calculates the sum of the 16-bit values in the buffer

+  specified by Buffer and Length. The carry bits in result of addition are dropped.

+  The 16-bit result is returned.  If Length is 0, then 0 is returned.

+

+  If Buffer is NULL, then ASSERT().

+  If Buffer is not aligned on a 16-bit boundary, then ASSERT().

+  If Length is not aligned on a 16-bit boundary, then ASSERT().

+  If Length is greater than (MAX_ADDRESS - Buffer + 1), then ASSERT().

+

+  @param  Buffer      The pointer to the buffer to carry out the sum operation.

+  @param  Length      The size, in bytes, of Buffer.

+

+  @return Sum         The sum of Buffer with carry bits dropped during additions.

+

+**/

+UINT16

+EFIAPI

+CalculateSum16 (

+  IN      CONST UINT16             *Buffer,

+  IN      UINTN                     Length

+  )

+{

+  UINT16    Sum;

+  UINTN     Count;

+  UINTN     Total;

+

+  ASSERT (Buffer != NULL);

+  ASSERT (((UINTN) Buffer & 0x1) == 0);

+  ASSERT ((Length & 0x1) == 0);

+  ASSERT (Length <= (MAX_ADDRESS - ((UINTN) Buffer) + 1));

+

+  Total = Length / sizeof (*Buffer);

+  for (Sum = 0, Count = 0; Count < Total; Count++) {

+    Sum = (UINT16) (Sum + *(Buffer + Count));

+  }

+

+  return Sum;

+}

+

+

+/**

+  Returns the two's complement checksum of all elements in a buffer of

+  16-bit values.

+

+  This function first calculates the sum of the 16-bit values in the buffer

+  specified by Buffer and Length.  The carry bits in the result of addition

+  are dropped. Then, the two's complement of the sum is returned.  If Length

+  is 0, then 0 is returned.

+

+  If Buffer is NULL, then ASSERT().

+  If Buffer is not aligned on a 16-bit boundary, then ASSERT().

+  If Length is not aligned on a 16-bit boundary, then ASSERT().

+  If Length is greater than (MAX_ADDRESS - Buffer + 1), then ASSERT().

+

+  @param  Buffer      The pointer to the buffer to carry out the checksum operation.

+  @param  Length      The size, in bytes, of Buffer.

+

+  @return Checksum    The 2's complement checksum of Buffer.

+

+**/

+UINT16

+EFIAPI

+CalculateCheckSum16 (

+  IN      CONST UINT16             *Buffer,

+  IN      UINTN                     Length

+  )

+{

+  UINT16     CheckSum;

+

+  CheckSum = CalculateSum16 (Buffer, Length);

+

+  //

+  // Return the checksum based on 2's complement.

+  //

+  return (UINT16) (0x10000 - CheckSum);

+}

+

+

+/**

+  Returns the sum of all elements in a buffer of 32-bit values. During

+  calculation, the carry bits are dropped.

+

+  This function calculates the sum of the 32-bit values in the buffer

+  specified by Buffer and Length. The carry bits in result of addition are dropped.

+  The 32-bit result is returned. If Length is 0, then 0 is returned.

+

+  If Buffer is NULL, then ASSERT().

+  If Buffer is not aligned on a 32-bit boundary, then ASSERT().

+  If Length is not aligned on a 32-bit boundary, then ASSERT().

+  If Length is greater than (MAX_ADDRESS - Buffer + 1), then ASSERT().

+

+  @param  Buffer      The pointer to the buffer to carry out the sum operation.

+  @param  Length      The size, in bytes, of Buffer.

+

+  @return Sum         The sum of Buffer with carry bits dropped during additions.

+

+**/

+UINT32

+EFIAPI

+CalculateSum32 (

+  IN      CONST UINT32             *Buffer,

+  IN      UINTN                     Length

+  )

+{

+  UINT32    Sum;

+  UINTN     Count;

+  UINTN     Total;

+

+  ASSERT (Buffer != NULL);

+  ASSERT (((UINTN) Buffer & 0x3) == 0);

+  ASSERT ((Length & 0x3) == 0);

+  ASSERT (Length <= (MAX_ADDRESS - ((UINTN) Buffer) + 1));

+

+  Total = Length / sizeof (*Buffer);

+  for (Sum = 0, Count = 0; Count < Total; Count++) {

+    Sum = Sum + *(Buffer + Count);

+  }

+

+  return Sum;

+}

+

+

+/**

+  Returns the two's complement checksum of all elements in a buffer of

+  32-bit values.

+

+  This function first calculates the sum of the 32-bit values in the buffer

+  specified by Buffer and Length.  The carry bits in the result of addition

+  are dropped. Then, the two's complement of the sum is returned.  If Length

+  is 0, then 0 is returned.

+

+  If Buffer is NULL, then ASSERT().

+  If Buffer is not aligned on a 32-bit boundary, then ASSERT().

+  If Length is not aligned on a 32-bit boundary, then ASSERT().

+  If Length is greater than (MAX_ADDRESS - Buffer + 1), then ASSERT().

+

+  @param  Buffer      The pointer to the buffer to carry out the checksum operation.

+  @param  Length      The size, in bytes, of Buffer.

+

+  @return Checksum    The 2's complement checksum of Buffer.

+

+**/

+UINT32

+EFIAPI

+CalculateCheckSum32 (

+  IN      CONST UINT32             *Buffer,

+  IN      UINTN                     Length

+  )

+{

+  UINT32     CheckSum;

+

+  CheckSum = CalculateSum32 (Buffer, Length);

+

+  //

+  // Return the checksum based on 2's complement.

+  //

+  return (UINT32) ((UINT32)(-1) - CheckSum + 1);

+}

+

+

+/**

+  Returns the sum of all elements in a buffer of 64-bit values.  During

+  calculation, the carry bits are dropped.

+

+  This function calculates the sum of the 64-bit values in the buffer

+  specified by Buffer and Length. The carry bits in result of addition are dropped.

+  The 64-bit result is returned.  If Length is 0, then 0 is returned.

+

+  If Buffer is NULL, then ASSERT().

+  If Buffer is not aligned on a 64-bit boundary, then ASSERT().

+  If Length is not aligned on a 64-bit boundary, then ASSERT().

+  If Length is greater than (MAX_ADDRESS - Buffer + 1), then ASSERT().

+

+  @param  Buffer      The pointer to the buffer to carry out the sum operation.

+  @param  Length      The size, in bytes, of Buffer.

+

+  @return Sum         The sum of Buffer with carry bits dropped during additions.

+

+**/

+UINT64

+EFIAPI

+CalculateSum64 (

+  IN      CONST UINT64             *Buffer,

+  IN      UINTN                     Length

+  )

+{

+  UINT64    Sum;

+  UINTN     Count;

+  UINTN     Total;

+

+  ASSERT (Buffer != NULL);

+  ASSERT (((UINTN) Buffer & 0x7) == 0);

+  ASSERT ((Length & 0x7) == 0);

+  ASSERT (Length <= (MAX_ADDRESS - ((UINTN) Buffer) + 1));

+

+  Total = Length / sizeof (*Buffer);

+  for (Sum = 0, Count = 0; Count < Total; Count++) {

+    Sum = Sum + *(Buffer + Count);

+  }

+

+  return Sum;

+}

+

+

+/**

+  Returns the two's complement checksum of all elements in a buffer of

+  64-bit values.

+

+  This function first calculates the sum of the 64-bit values in the buffer

+  specified by Buffer and Length.  The carry bits in the result of addition

+  are dropped. Then, the two's complement of the sum is returned.  If Length

+  is 0, then 0 is returned.

+

+  If Buffer is NULL, then ASSERT().

+  If Buffer is not aligned on a 64-bit boundary, then ASSERT().

+  If Length is not aligned on a 64-bit boundary, then ASSERT().

+  If Length is greater than (MAX_ADDRESS - Buffer + 1), then ASSERT().

+

+  @param  Buffer      The pointer to the buffer to carry out the checksum operation.

+  @param  Length      The size, in bytes, of Buffer.

+

+  @return Checksum    The 2's complement checksum of Buffer.

+

+**/

+UINT64

+EFIAPI

+CalculateCheckSum64 (

+  IN      CONST UINT64             *Buffer,

+  IN      UINTN                     Length

+  )

+{

+  UINT64     CheckSum;

+

+  CheckSum = CalculateSum64 (Buffer, Length);

+

+  //

+  // Return the checksum based on 2's complement.

+  //

+  return (UINT64) ((UINT64)(-1) - CheckSum + 1);

+}

+

+GLOBAL_REMOVE_IF_UNREFERENCED CONST UINT32  mCrcTable[256] = {

+  0x00000000,

+  0x77073096,

+  0xEE0E612C,

+  0x990951BA,

+  0x076DC419,

+  0x706AF48F,

+  0xE963A535,

+  0x9E6495A3,

+  0x0EDB8832,

+  0x79DCB8A4,

+  0xE0D5E91E,

+  0x97D2D988,

+  0x09B64C2B,

+  0x7EB17CBD,

+  0xE7B82D07,

+  0x90BF1D91,

+  0x1DB71064,

+  0x6AB020F2,

+  0xF3B97148,

+  0x84BE41DE,

+  0x1ADAD47D,

+  0x6DDDE4EB,

+  0xF4D4B551,

+  0x83D385C7,

+  0x136C9856,

+  0x646BA8C0,

+  0xFD62F97A,

+  0x8A65C9EC,

+  0x14015C4F,

+  0x63066CD9,

+  0xFA0F3D63,

+  0x8D080DF5,

+  0x3B6E20C8,

+  0x4C69105E,

+  0xD56041E4,

+  0xA2677172,

+  0x3C03E4D1,

+  0x4B04D447,

+  0xD20D85FD,

+  0xA50AB56B,

+  0x35B5A8FA,

+  0x42B2986C,

+  0xDBBBC9D6,

+  0xACBCF940,

+  0x32D86CE3,

+  0x45DF5C75,

+  0xDCD60DCF,

+  0xABD13D59,

+  0x26D930AC,

+  0x51DE003A,

+  0xC8D75180,

+  0xBFD06116,

+  0x21B4F4B5,

+  0x56B3C423,

+  0xCFBA9599,

+  0xB8BDA50F,

+  0x2802B89E,

+  0x5F058808,

+  0xC60CD9B2,

+  0xB10BE924,

+  0x2F6F7C87,

+  0x58684C11,

+  0xC1611DAB,

+  0xB6662D3D,

+  0x76DC4190,

+  0x01DB7106,

+  0x98D220BC,

+  0xEFD5102A,

+  0x71B18589,

+  0x06B6B51F,

+  0x9FBFE4A5,

+  0xE8B8D433,

+  0x7807C9A2,

+  0x0F00F934,

+  0x9609A88E,

+  0xE10E9818,

+  0x7F6A0DBB,

+  0x086D3D2D,

+  0x91646C97,

+  0xE6635C01,

+  0x6B6B51F4,

+  0x1C6C6162,

+  0x856530D8,

+  0xF262004E,

+  0x6C0695ED,

+  0x1B01A57B,

+  0x8208F4C1,

+  0xF50FC457,

+  0x65B0D9C6,

+  0x12B7E950,

+  0x8BBEB8EA,

+  0xFCB9887C,

+  0x62DD1DDF,

+  0x15DA2D49,

+  0x8CD37CF3,

+  0xFBD44C65,

+  0x4DB26158,

+  0x3AB551CE,

+  0xA3BC0074,

+  0xD4BB30E2,

+  0x4ADFA541,

+  0x3DD895D7,

+  0xA4D1C46D,

+  0xD3D6F4FB,

+  0x4369E96A,

+  0x346ED9FC,

+  0xAD678846,

+  0xDA60B8D0,

+  0x44042D73,

+  0x33031DE5,

+  0xAA0A4C5F,

+  0xDD0D7CC9,

+  0x5005713C,

+  0x270241AA,

+  0xBE0B1010,

+  0xC90C2086,

+  0x5768B525,

+  0x206F85B3,

+  0xB966D409,

+  0xCE61E49F,

+  0x5EDEF90E,

+  0x29D9C998,

+  0xB0D09822,

+  0xC7D7A8B4,

+  0x59B33D17,

+  0x2EB40D81,

+  0xB7BD5C3B,

+  0xC0BA6CAD,

+  0xEDB88320,

+  0x9ABFB3B6,

+  0x03B6E20C,

+  0x74B1D29A,

+  0xEAD54739,

+  0x9DD277AF,

+  0x04DB2615,

+  0x73DC1683,

+  0xE3630B12,

+  0x94643B84,

+  0x0D6D6A3E,

+  0x7A6A5AA8,

+  0xE40ECF0B,

+  0x9309FF9D,

+  0x0A00AE27,

+  0x7D079EB1,

+  0xF00F9344,

+  0x8708A3D2,

+  0x1E01F268,

+  0x6906C2FE,

+  0xF762575D,

+  0x806567CB,

+  0x196C3671,

+  0x6E6B06E7,

+  0xFED41B76,

+  0x89D32BE0,

+  0x10DA7A5A,

+  0x67DD4ACC,

+  0xF9B9DF6F,

+  0x8EBEEFF9,

+  0x17B7BE43,

+  0x60B08ED5,

+  0xD6D6A3E8,

+  0xA1D1937E,

+  0x38D8C2C4,

+  0x4FDFF252,

+  0xD1BB67F1,

+  0xA6BC5767,

+  0x3FB506DD,

+  0x48B2364B,

+  0xD80D2BDA,

+  0xAF0A1B4C,

+  0x36034AF6,

+  0x41047A60,

+  0xDF60EFC3,

+  0xA867DF55,

+  0x316E8EEF,

+  0x4669BE79,

+  0xCB61B38C,

+  0xBC66831A,

+  0x256FD2A0,

+  0x5268E236,

+  0xCC0C7795,

+  0xBB0B4703,

+  0x220216B9,

+  0x5505262F,

+  0xC5BA3BBE,

+  0xB2BD0B28,

+  0x2BB45A92,

+  0x5CB36A04,

+  0xC2D7FFA7,

+  0xB5D0CF31,

+  0x2CD99E8B,

+  0x5BDEAE1D,

+  0x9B64C2B0,

+  0xEC63F226,

+  0x756AA39C,

+  0x026D930A,

+  0x9C0906A9,

+  0xEB0E363F,

+  0x72076785,

+  0x05005713,

+  0x95BF4A82,

+  0xE2B87A14,

+  0x7BB12BAE,

+  0x0CB61B38,

+  0x92D28E9B,

+  0xE5D5BE0D,

+  0x7CDCEFB7,

+  0x0BDBDF21,

+  0x86D3D2D4,

+  0xF1D4E242,

+  0x68DDB3F8,

+  0x1FDA836E,

+  0x81BE16CD,

+  0xF6B9265B,

+  0x6FB077E1,

+  0x18B74777,

+  0x88085AE6,

+  0xFF0F6A70,

+  0x66063BCA,

+  0x11010B5C,

+  0x8F659EFF,

+  0xF862AE69,

+  0x616BFFD3,

+  0x166CCF45,

+  0xA00AE278,

+  0xD70DD2EE,

+  0x4E048354,

+  0x3903B3C2,

+  0xA7672661,

+  0xD06016F7,

+  0x4969474D,

+  0x3E6E77DB,

+  0xAED16A4A,

+  0xD9D65ADC,

+  0x40DF0B66,

+  0x37D83BF0,

+  0xA9BCAE53,

+  0xDEBB9EC5,

+  0x47B2CF7F,

+  0x30B5FFE9,

+  0xBDBDF21C,

+  0xCABAC28A,

+  0x53B39330,

+  0x24B4A3A6,

+  0xBAD03605,

+  0xCDD70693,

+  0x54DE5729,

+  0x23D967BF,

+  0xB3667A2E,

+  0xC4614AB8,

+  0x5D681B02,

+  0x2A6F2B94,

+  0xB40BBE37,

+  0xC30C8EA1,

+  0x5A05DF1B,

+  0x2D02EF8D

+};

+

+/**

+  Computes and returns a 32-bit CRC for a data buffer.

+  CRC32 value bases on ITU-T V.42.

+

+  If Buffer is NULL, then ASSERT().

+  If Length is greater than (MAX_ADDRESS - Buffer + 1), then ASSERT().

+

+  @param[in]  Buffer       A pointer to the buffer on which the 32-bit CRC is to be computed.

+  @param[in]  Length       The number of bytes in the buffer Data.

+

+  @retval Crc32            The 32-bit CRC was computed for the data buffer.

+

+**/

+UINT32

+EFIAPI

+CalculateCrc32(

+  IN  VOID                         *Buffer,

+  IN  UINTN                        Length

+  )

+{

+  UINTN   Index;

+  UINT32  Crc;

+  UINT8   *Ptr;

+

+  ASSERT (Buffer != NULL);

+  ASSERT (Length <= (MAX_ADDRESS - ((UINTN) Buffer) + 1));

+

+  //

+  // Compute CRC

+  //

+  Crc = 0xffffffff;

+  for (Index = 0, Ptr = Buffer; Index < Length; Index++, Ptr++) {

+    Crc = (Crc >> 8) ^ mCrcTable[(UINT8) Crc ^ *Ptr];

+  }

+

+  return Crc ^ 0xffffffff;

+}

diff --git a/debugging_demo/memtest86+/efi/Include/src/BaseLib/ChkStkGcc.c b/debugging_demo/memtest86+/efi/Include/src/BaseLib/ChkStkGcc.c
new file mode 100644
index 0000000..7f07ba2
--- /dev/null
+++ b/debugging_demo/memtest86+/efi/Include/src/BaseLib/ChkStkGcc.c
@@ -0,0 +1,18 @@
+/** @file

+  Provides hack function for passng GCC build.

+

+  Copyright (c) 2006 - 2018, Intel Corporation. All rights reserved.<BR>

+  SPDX-License-Identifier: BSD-2-Clause-Patent

+

+**/

+

+#include "BaseLibInternals.h"

+

+/**

+  Hack function for passing GCC build.

+**/

+VOID

+__chkstk()

+{

+}

+

diff --git a/debugging_demo/memtest86+/efi/Include/src/BaseLib/Cpu.c b/debugging_demo/memtest86+/efi/Include/src/BaseLib/Cpu.c
new file mode 100644
index 0000000..689246f
--- /dev/null
+++ b/debugging_demo/memtest86+/efi/Include/src/BaseLib/Cpu.c
@@ -0,0 +1,59 @@
+/** @file

+  Base Library CPU Functions for all architectures.

+

+  Copyright (c) 2006 - 2010, Intel Corporation. All rights reserved.<BR>

+  SPDX-License-Identifier: BSD-2-Clause-Patent

+

+**/

+

+#include "BaseLibInternals.h"

+

+

+/**

+  Disables CPU interrupts and returns the interrupt state prior to the disable

+  operation.

+

+  @retval TRUE  CPU interrupts were enabled on entry to this call.

+  @retval FALSE CPU interrupts were disabled on entry to this call.

+

+**/

+BOOLEAN

+EFIAPI

+SaveAndDisableInterrupts (

+  VOID

+  )

+{

+  BOOLEAN                           InterruptState;

+

+  InterruptState = GetInterruptState ();

+  DisableInterrupts ();

+  return InterruptState;

+}

+

+/**

+  Set the current CPU interrupt state.

+

+  Sets the current CPU interrupt state to the state specified by

+  InterruptState. If InterruptState is TRUE, then interrupts are enabled. If

+  InterruptState is FALSE, then interrupts are disabled. InterruptState is

+  returned.

+

+  @param  InterruptState  TRUE if interrupts should be enabled. FALSE if

+                          interrupts should be disabled.

+

+  @return InterruptState

+

+**/

+BOOLEAN

+EFIAPI

+SetInterruptState (

+  IN      BOOLEAN                   InterruptState

+  )

+{

+  if (InterruptState) {

+    EnableInterrupts ();

+  } else {

+    DisableInterrupts ();

+  }

+  return InterruptState;

+}

diff --git a/debugging_demo/memtest86+/efi/Include/src/BaseLib/CpuDeadLoop.c b/debugging_demo/memtest86+/efi/Include/src/BaseLib/CpuDeadLoop.c
new file mode 100644
index 0000000..3cd3043
--- /dev/null
+++ b/debugging_demo/memtest86+/efi/Include/src/BaseLib/CpuDeadLoop.c
@@ -0,0 +1,34 @@
+/** @file

+  Base Library CPU Functions for all architectures.

+

+  Copyright (c) 2006 - 2008, Intel Corporation. All rights reserved.<BR>

+  SPDX-License-Identifier: BSD-2-Clause-Patent

+

+**/

+

+

+

+#include <Base.h>

+#include <Library/BaseLib.h>

+

+/**

+  Executes an infinite loop.

+

+  Forces the CPU to execute an infinite loop. A debugger may be used to skip

+  past the loop and the code that follows the loop must execute properly. This

+  implies that the infinite loop must not cause the code that follow it to be

+  optimized away.

+

+**/

+VOID

+EFIAPI

+CpuDeadLoop (

+  VOID

+  )

+{

+  volatile UINTN  Index;

+

+  for (Index = 0; Index == 0;) {

+    CpuPause();

+  }

+}

diff --git a/debugging_demo/memtest86+/efi/Include/src/BaseLib/DivS64x64Remainder.c b/debugging_demo/memtest86+/efi/Include/src/BaseLib/DivS64x64Remainder.c
new file mode 100644
index 0000000..bdf25b8
--- /dev/null
+++ b/debugging_demo/memtest86+/efi/Include/src/BaseLib/DivS64x64Remainder.c
@@ -0,0 +1,47 @@
+/** @file

+  Math worker functions.

+

+  Copyright (c) 2006 - 2018, Intel Corporation. All rights reserved.<BR>

+  SPDX-License-Identifier: BSD-2-Clause-Patent

+

+**/

+

+

+

+

+#include "BaseLibInternals.h"

+

+/**

+  Divides a 64-bit signed integer by a 64-bit signed integer and generates a

+  64-bit signed result and a optional 64-bit signed remainder.

+

+  This function divides the 64-bit signed value Dividend by the 64-bit signed

+  value Divisor and generates a 64-bit signed quotient. If Remainder is not

+  NULL, then the 64-bit signed remainder is returned in Remainder. This

+  function returns the 64-bit signed quotient.

+

+  It is the caller's responsibility to not call this function with a Divisor of 0.

+  If Divisor is 0, then the quotient and remainder should be assumed to be

+  the largest negative integer.

+

+  If Divisor is 0, then ASSERT().

+

+  @param  Dividend  A 64-bit signed value.

+  @param  Divisor   A 64-bit signed value.

+  @param  Remainder A pointer to a 64-bit signed value. This parameter is

+                    optional and may be NULL.

+

+  @return Dividend / Divisor

+

+**/

+INT64

+EFIAPI

+DivS64x64Remainder (

+  IN      INT64                     Dividend,

+  IN      INT64                     Divisor,

+  OUT     INT64                     *Remainder  OPTIONAL

+  )

+{

+  ASSERT (Divisor != 0);

+  return InternalMathDivRemS64x64 (Dividend, Divisor, Remainder);

+}

diff --git a/debugging_demo/memtest86+/efi/Include/src/BaseLib/DivU64x32.c b/debugging_demo/memtest86+/efi/Include/src/BaseLib/DivU64x32.c
new file mode 100644
index 0000000..fa377ec
--- /dev/null
+++ b/debugging_demo/memtest86+/efi/Include/src/BaseLib/DivU64x32.c
@@ -0,0 +1,39 @@
+/** @file

+  Math worker functions.

+

+  Copyright (c) 2006 - 2008, Intel Corporation. All rights reserved.<BR>

+  SPDX-License-Identifier: BSD-2-Clause-Patent

+

+**/

+

+

+

+

+#include "BaseLibInternals.h"

+

+/**

+  Divides a 64-bit unsigned integer by a 32-bit unsigned integer and generates

+  a 64-bit unsigned result.

+

+  This function divides the 64-bit unsigned value Dividend by the 32-bit

+  unsigned value Divisor and generates a 64-bit unsigned quotient. This

+  function returns the 64-bit unsigned quotient.

+

+  If Divisor is 0, then ASSERT().

+

+  @param  Dividend  A 64-bit unsigned value.

+  @param  Divisor   A 32-bit unsigned value.

+

+  @return Dividend / Divisor

+

+**/

+UINT64

+EFIAPI

+DivU64x32 (

+  IN      UINT64                    Dividend,

+  IN      UINT32                    Divisor

+  )

+{

+  ASSERT (Divisor != 0);

+  return InternalMathDivU64x32 (Dividend, Divisor);

+}

diff --git a/debugging_demo/memtest86+/efi/Include/src/BaseLib/DivU64x32Remainder.c b/debugging_demo/memtest86+/efi/Include/src/BaseLib/DivU64x32Remainder.c
new file mode 100644
index 0000000..df9d331
--- /dev/null
+++ b/debugging_demo/memtest86+/efi/Include/src/BaseLib/DivU64x32Remainder.c
@@ -0,0 +1,43 @@
+/** @file

+  Math worker functions.

+

+  Copyright (c) 2006 - 2008, Intel Corporation. All rights reserved.<BR>

+  SPDX-License-Identifier: BSD-2-Clause-Patent

+

+**/

+

+

+

+

+#include "BaseLibInternals.h"

+

+/**

+  Divides a 64-bit unsigned integer by a 32-bit unsigned integer and generates

+  a 64-bit unsigned result and an optional 32-bit unsigned remainder.

+

+  This function divides the 64-bit unsigned value Dividend by the 32-bit

+  unsigned value Divisor and generates a 64-bit unsigned quotient. If Remainder

+  is not NULL, then the 32-bit unsigned remainder is returned in Remainder.

+  This function returns the 64-bit unsigned quotient.

+

+  If Divisor is 0, then ASSERT().

+

+  @param  Dividend  A 64-bit unsigned value.

+  @param  Divisor   A 32-bit unsigned value.

+  @param  Remainder A pointer to a 32-bit unsigned value. This parameter is

+                    optional and may be NULL.

+

+  @return Dividend / Divisor

+

+**/

+UINT64

+EFIAPI

+DivU64x32Remainder (

+  IN      UINT64                    Dividend,

+  IN      UINT32                    Divisor,

+  OUT     UINT32                    *Remainder  OPTIONAL

+  )

+{

+  ASSERT (Divisor != 0);

+  return InternalMathDivRemU64x32 (Dividend, Divisor, Remainder);

+}

diff --git a/debugging_demo/memtest86+/efi/Include/src/BaseLib/DivU64x64Remainder.c b/debugging_demo/memtest86+/efi/Include/src/BaseLib/DivU64x64Remainder.c
new file mode 100644
index 0000000..94dc2b1
--- /dev/null
+++ b/debugging_demo/memtest86+/efi/Include/src/BaseLib/DivU64x64Remainder.c
@@ -0,0 +1,43 @@
+/** @file

+  Math worker functions.

+

+  Copyright (c) 2006 - 2008, Intel Corporation. All rights reserved.<BR>

+  SPDX-License-Identifier: BSD-2-Clause-Patent

+

+**/

+

+

+

+

+#include "BaseLibInternals.h"

+

+/**

+  Divides a 64-bit unsigned integer by a 64-bit unsigned integer and generates

+  a 64-bit unsigned result and an optional 64-bit unsigned remainder.

+

+  This function divides the 64-bit unsigned value Dividend by the 64-bit

+  unsigned value Divisor and generates a 64-bit unsigned quotient. If Remainder

+  is not NULL, then the 64-bit unsigned remainder is returned in Remainder.

+  This function returns the 64-bit unsigned quotient.

+

+  If Divisor is 0, then ASSERT().

+

+  @param  Dividend  A 64-bit unsigned value.

+  @param  Divisor   A 64-bit unsigned value.

+  @param  Remainder A pointer to a 64-bit unsigned value. This parameter is

+                    optional and may be NULL.

+

+  @return Dividend / Divisor

+

+**/

+UINT64

+EFIAPI

+DivU64x64Remainder (

+  IN      UINT64                    Dividend,

+  IN      UINT64                    Divisor,

+  OUT     UINT64                    *Remainder  OPTIONAL

+  )

+{

+  ASSERT (Divisor != 0);

+  return InternalMathDivRemU64x64 (Dividend, Divisor, Remainder);

+}

diff --git a/debugging_demo/memtest86+/efi/Include/src/BaseLib/FilePaths.c b/debugging_demo/memtest86+/efi/Include/src/BaseLib/FilePaths.c
new file mode 100644
index 0000000..c2c561a
--- /dev/null
+++ b/debugging_demo/memtest86+/efi/Include/src/BaseLib/FilePaths.c
@@ -0,0 +1,115 @@
+/** @file

+  Defines file-path manipulation functions.

+

+  Copyright (c) 2011 - 2017, Intel Corporation. All rights reserved.<BR>

+  Copyright (c) 2018, Dell Technologies. All rights reserved.<BR>

+  SPDX-License-Identifier: BSD-2-Clause-Patent

+**/

+#include  <Library/BaseMemoryLib.h>

+#include  <Library/BaseLib.h>

+

+/**

+  Removes the last directory or file entry in a path. For a path which is

+  like L"fs0:startup.nsh", it's converted to L"fs0:".

+

+  @param[in,out] Path     A pointer to the path to modify.

+

+  @retval FALSE     Nothing was found to remove.

+  @retval TRUE      A directory or file was removed.

+**/

+BOOLEAN

+EFIAPI

+PathRemoveLastItem(

+  IN OUT CHAR16 *Path

+  )

+{

+  CHAR16        *Walker;

+  CHAR16        *LastSlash;

+  //

+  // get directory name from path... ('chop' off extra)

+  //

+  for ( Walker = Path, LastSlash = NULL

+      ; Walker != NULL && *Walker != CHAR_NULL

+      ; Walker++

+     ){

+    if (*Walker == L'\\' && *(Walker + 1) != CHAR_NULL) {

+      LastSlash = Walker+1;

+    } else if (*Walker == L':' && *(Walker + 1) != L'\\' && *(Walker + 1) != CHAR_NULL) {

+      LastSlash = Walker+1;

+    }

+  }

+  if (LastSlash != NULL) {

+    *LastSlash = CHAR_NULL;

+    return (TRUE);

+  }

+  return (FALSE);

+}

+

+/**

+  Function to clean up paths.

+

+  - Single periods in the path are removed.

+  - Double periods in the path are removed along with a single parent directory.

+  - Forward slashes L'/' are converted to backward slashes L'\'.

+

+  This will be done inline and the existing buffer may be larger than required

+  upon completion.

+

+  @param[in] Path       The pointer to the string containing the path.

+

+  @return       Returns Path, otherwise returns NULL to indicate that an error has occurred.

+**/

+CHAR16*

+EFIAPI

+PathCleanUpDirectories(

+  IN CHAR16 *Path

+)

+{

+  CHAR16  *TempString;

+

+  if (Path == NULL) {

+    return NULL;

+  }

+

+  //

+  // Replace the '/' with '\'

+  //

+  for (TempString = Path; *TempString != CHAR_NULL; TempString++) {

+    if (*TempString == L'/') {

+      *TempString = L'\\';

+    }

+  }

+

+  //

+  // Replace the "\\" with "\"

+  //

+  while ((TempString = StrStr (Path, L"\\\\")) != NULL) {

+    CopyMem (TempString, TempString + 1, StrSize (TempString + 1));

+  }

+

+  //

+  // Remove all the "\.". E.g.: fs0:\abc\.\def\.

+  //

+  while ((TempString = StrStr (Path, L"\\.\\")) != NULL) {

+    CopyMem (TempString, TempString + 2, StrSize (TempString + 2));

+  }

+  if ((StrLen (Path) >= 2) && (StrCmp (Path + StrLen (Path) - 2, L"\\.") == 0)) {

+    Path[StrLen (Path) - 1] = CHAR_NULL;

+  }

+

+  //

+  // Remove all the "\..". E.g.: fs0:\abc\..\def\..

+  //

+  while (((TempString = StrStr(Path, L"\\..")) != NULL) &&

+         ((*(TempString + 3) == L'\\') || (*(TempString + 3) == CHAR_NULL))

+        ) {

+    *(TempString + 1) = CHAR_NULL;

+    PathRemoveLastItem(Path);

+    if (*(TempString + 3) != CHAR_NULL) {

+      CopyMem (Path + StrLen (Path), TempString + 4, StrSize (TempString + 4));

+    }

+  }

+

+  return Path;

+}

+

diff --git a/debugging_demo/memtest86+/efi/Include/src/BaseLib/GetPowerOfTwo32.c b/debugging_demo/memtest86+/efi/Include/src/BaseLib/GetPowerOfTwo32.c
new file mode 100644
index 0000000..76f5e3c
--- /dev/null
+++ b/debugging_demo/memtest86+/efi/Include/src/BaseLib/GetPowerOfTwo32.c
@@ -0,0 +1,38 @@
+/** @file

+  Math worker functions.

+

+  Copyright (c) 2006 - 2008, Intel Corporation. All rights reserved.<BR>

+  SPDX-License-Identifier: BSD-2-Clause-Patent

+

+**/

+

+

+

+

+#include "BaseLibInternals.h"

+

+/**

+  Returns the value of the highest bit set in a 32-bit value. Equivalent to

+  1 << log2(x).

+

+  This function computes the value of the highest bit set in the 32-bit value

+  specified by Operand. If Operand is zero, then zero is returned.

+

+  @param  Operand The 32-bit operand to evaluate.

+

+  @return 1 << HighBitSet32(Operand)

+  @retval 0 Operand is zero.

+

+**/

+UINT32

+EFIAPI

+GetPowerOfTwo32 (

+  IN      UINT32                    Operand

+  )

+{

+  if (0 == Operand) {

+    return 0;

+  }

+

+  return 1ul << HighBitSet32 (Operand);

+}

diff --git a/debugging_demo/memtest86+/efi/Include/src/BaseLib/GetPowerOfTwo64.c b/debugging_demo/memtest86+/efi/Include/src/BaseLib/GetPowerOfTwo64.c
new file mode 100644
index 0000000..5033076
--- /dev/null
+++ b/debugging_demo/memtest86+/efi/Include/src/BaseLib/GetPowerOfTwo64.c
@@ -0,0 +1,38 @@
+/** @file

+  Math worker functions.

+

+  Copyright (c) 2006 - 2010, Intel Corporation. All rights reserved.<BR>

+  SPDX-License-Identifier: BSD-2-Clause-Patent

+

+**/

+

+

+

+

+#include "BaseLibInternals.h"

+

+/**

+  Returns the value of the highest bit set in a 64-bit value. Equivalent to

+  1 << log2(x).

+

+  This function computes the value of the highest bit set in the 64-bit value

+  specified by Operand. If Operand is zero, then zero is returned.

+

+  @param  Operand The 64-bit operand to evaluate.

+

+  @return 1 << HighBitSet64(Operand)

+  @retval 0 Operand is zero.

+

+**/

+UINT64

+EFIAPI

+GetPowerOfTwo64 (

+  IN      UINT64                    Operand

+  )

+{

+  if (Operand == 0) {

+    return 0;

+  }

+

+  return LShiftU64 (1, (UINTN) HighBitSet64 (Operand));

+}

diff --git a/debugging_demo/memtest86+/efi/Include/src/BaseLib/HighBitSet32.c b/debugging_demo/memtest86+/efi/Include/src/BaseLib/HighBitSet32.c
new file mode 100644
index 0000000..b3c9ed1
--- /dev/null
+++ b/debugging_demo/memtest86+/efi/Include/src/BaseLib/HighBitSet32.c
@@ -0,0 +1,41 @@
+/** @file

+  Math worker functions.

+

+  Copyright (c) 2006 - 2008, Intel Corporation. All rights reserved.<BR>

+  SPDX-License-Identifier: BSD-2-Clause-Patent

+

+**/

+

+

+

+

+#include "BaseLibInternals.h"

+

+/**

+  Returns the bit position of the highest bit set in a 32-bit value. Equivalent

+  to log2(x).

+

+  This function computes the bit position of the highest bit set in the 32-bit

+  value specified by Operand. If Operand is zero, then -1 is returned.

+  Otherwise, a value between 0 and 31 is returned.

+

+  @param  Operand The 32-bit operand to evaluate.

+

+  @retval 0..31  Position of the highest bit set in Operand if found.

+  @retval -1     Operand is zero.

+

+**/

+INTN

+EFIAPI

+HighBitSet32 (

+  IN      UINT32                    Operand

+  )

+{

+  INTN                              BitIndex;

+

+  if (Operand == 0) {

+    return - 1;

+  }

+  for (BitIndex = 31; (INT32)Operand > 0; BitIndex--, Operand <<= 1);

+  return BitIndex;

+}

diff --git a/debugging_demo/memtest86+/efi/Include/src/BaseLib/HighBitSet64.c b/debugging_demo/memtest86+/efi/Include/src/BaseLib/HighBitSet64.c
new file mode 100644
index 0000000..4f06dfc
--- /dev/null
+++ b/debugging_demo/memtest86+/efi/Include/src/BaseLib/HighBitSet64.c
@@ -0,0 +1,49 @@
+/** @file

+  Math worker functions.

+

+  Copyright (c) 2006 - 2008, Intel Corporation. All rights reserved.<BR>

+  SPDX-License-Identifier: BSD-2-Clause-Patent

+

+**/

+

+

+

+

+#include "BaseLibInternals.h"

+

+/**

+  Returns the bit position of the highest bit set in a 64-bit value. Equivalent

+  to log2(x).

+

+  This function computes the bit position of the highest bit set in the 64-bit

+  value specified by Operand. If Operand is zero, then -1 is returned.

+  Otherwise, a value between 0 and 63 is returned.

+

+  @param  Operand The 64-bit operand to evaluate.

+

+  @retval 0..63   Position of the highest bit set in Operand if found.

+  @retval -1      Operand is zero.

+

+**/

+INTN

+EFIAPI

+HighBitSet64 (

+  IN      UINT64                    Operand

+  )

+{

+  if (Operand == (UINT32)Operand) {

+    //

+    // Operand is just a 32-bit integer

+    //

+    return HighBitSet32 ((UINT32)Operand);

+  }

+

+  //

+  // Operand is really a 64-bit integer

+  //

+  if (sizeof (UINTN) == sizeof (UINT32)) {

+    return HighBitSet32 (((UINT32*)&Operand)[1]) + 32;

+  } else {

+    return HighBitSet32 ((UINT32)RShiftU64 (Operand, 32)) + 32;

+  }

+}

diff --git a/debugging_demo/memtest86+/efi/Include/src/BaseLib/LRotU32.c b/debugging_demo/memtest86+/efi/Include/src/BaseLib/LRotU32.c
new file mode 100644
index 0000000..4e671a3
--- /dev/null
+++ b/debugging_demo/memtest86+/efi/Include/src/BaseLib/LRotU32.c
@@ -0,0 +1,36 @@
+/** @file

+  Math worker functions.

+

+  Copyright (c) 2006 - 2008, Intel Corporation. All rights reserved.<BR>

+  SPDX-License-Identifier: BSD-2-Clause-Patent

+

+**/

+

+#include "BaseLibInternals.h"

+

+/**

+  Rotates a 32-bit integer left between 0 and 31 bits, filling the low bits

+  with the high bits that were rotated.

+

+  This function rotates the 32-bit value Operand to the left by Count bits. The

+  low Count bits are fill with the high Count bits of Operand. The rotated

+  value is returned.

+

+  If Count is greater than 31, then ASSERT().

+

+  @param  Operand The 32-bit operand to rotate left.

+  @param  Count   The number of bits to rotate left.

+

+  @return Operand << Count

+

+**/

+UINT32

+EFIAPI

+LRotU32 (

+  IN      UINT32                    Operand,

+  IN      UINTN                     Count

+  )

+{

+  ASSERT (Count < 32);

+  return (Operand << Count) | (Operand >> (32 - Count));

+}

diff --git a/debugging_demo/memtest86+/efi/Include/src/BaseLib/LRotU64.c b/debugging_demo/memtest86+/efi/Include/src/BaseLib/LRotU64.c
new file mode 100644
index 0000000..48f35dc
--- /dev/null
+++ b/debugging_demo/memtest86+/efi/Include/src/BaseLib/LRotU64.c
@@ -0,0 +1,36 @@
+/** @file

+  Math worker functions.

+

+  Copyright (c) 2006 - 2008, Intel Corporation. All rights reserved.<BR>

+  SPDX-License-Identifier: BSD-2-Clause-Patent

+

+**/

+

+#include "BaseLibInternals.h"

+

+/**

+  Rotates a 64-bit integer left between 0 and 63 bits, filling the low bits

+  with the high bits that were rotated.

+

+  This function rotates the 64-bit value Operand to the left by Count bits. The

+  low Count bits are fill with the high Count bits of Operand. The rotated

+  value is returned.

+

+  If Count is greater than 63, then ASSERT().

+

+  @param  Operand The 64-bit operand to rotate left.

+  @param  Count   The number of bits to rotate left.

+

+  @return Operand << Count

+

+**/

+UINT64

+EFIAPI

+LRotU64 (

+  IN      UINT64                    Operand,

+  IN      UINTN                     Count

+  )

+{

+  ASSERT (Count < 64);

+  return InternalMathLRotU64 (Operand, Count);

+}

diff --git a/debugging_demo/memtest86+/efi/Include/src/BaseLib/LShiftU64.c b/debugging_demo/memtest86+/efi/Include/src/BaseLib/LShiftU64.c
new file mode 100644
index 0000000..7b41a3e
--- /dev/null
+++ b/debugging_demo/memtest86+/efi/Include/src/BaseLib/LShiftU64.c
@@ -0,0 +1,35 @@
+/** @file

+  Math worker functions.

+

+  Copyright (c) 2006 - 2008, Intel Corporation. All rights reserved.<BR>

+  SPDX-License-Identifier: BSD-2-Clause-Patent

+

+**/

+

+#include "BaseLibInternals.h"

+

+/**

+  Shifts a 64-bit integer left between 0 and 63 bits. The low bits are filled

+  with zeros. The shifted value is returned.

+

+  This function shifts the 64-bit value Operand to the left by Count bits. The

+  low Count bits are set to zero. The shifted value is returned.

+

+  If Count is greater than 63, then ASSERT().

+

+  @param  Operand The 64-bit operand to shift left.

+  @param  Count   The number of bits to shift left.

+

+  @return Operand << Count.

+

+**/

+UINT64

+EFIAPI

+LShiftU64 (

+  IN      UINT64                    Operand,

+  IN      UINTN                     Count

+  )

+{

+  ASSERT (Count < 64);

+  return InternalMathLShiftU64 (Operand, Count);

+}

diff --git a/debugging_demo/memtest86+/efi/Include/src/BaseLib/LinkedList.c b/debugging_demo/memtest86+/efi/Include/src/BaseLib/LinkedList.c
new file mode 100644
index 0000000..5648c18
--- /dev/null
+++ b/debugging_demo/memtest86+/efi/Include/src/BaseLib/LinkedList.c
@@ -0,0 +1,599 @@
+/** @file

+  Linked List Library Functions.

+

+  Copyright (c) 2006 - 2018, Intel Corporation. All rights reserved.<BR>

+  SPDX-License-Identifier: BSD-2-Clause-Patent

+

+**/

+

+#include "BaseLibInternals.h"

+

+/**

+  If PcdVerifyNodeInList is TRUE, ASSERTs when SecondEntry is or is not part of

+  the same doubly-linked list as FirstEntry depending on the value of InList.

+  Independent of PcdVerifyNodeInList, ASSERTs when FirstEntry is not part of a

+  valid list.

+

+  If FirstEntry is NULL, then ASSERT().

+  If FirstEntry->ForwardLink is NULL, then ASSERT().

+  If FirstEntry->BackLink is NULL, then ASSERT().

+  If PcdMaximumLinkedListLength is not zero, and List contains more than

+  PcdMaximumLinkedListLength nodes, then ASSERT().

+  If PcdVerifyNodeInList is TRUE and SecondEntry is NULL, then ASSERT().

+

+  @param  FirstEntry   A pointer to a node in a linked list.

+  @param  SecondEntry  A pointer to the node to locate.

+  @param  InList       Defines whether to check if SecondEntry is or is not part

+                       of the same doubly-linked list as FirstEntry.

+

+**/

+#if !defined (MDEPKG_NDEBUG)

+  #define ASSERT_VERIFY_NODE_IN_VALID_LIST(FirstEntry, SecondEntry, InList)  \

+    do {                                                                     \

+      if (FeaturePcdGet (PcdVerifyNodeInList)) {                             \

+        ASSERT (InList == IsNodeInList ((FirstEntry), (SecondEntry)));       \

+      } else {                                                               \

+        ASSERT (InternalBaseLibIsListValid (FirstEntry));                    \

+      }                                                                      \

+    } while (FALSE)

+#else

+  #define ASSERT_VERIFY_NODE_IN_VALID_LIST(FirstEntry, SecondEntry, InList)

+#endif

+

+/**

+  Worker function that verifies the validity of this list.

+

+  If List is NULL, then ASSERT().

+  If List->ForwardLink is NULL, then ASSERT().

+  If List->BackLink is NULL, then ASSERT().

+  If PcdMaximumLinkedListLength is not zero, and List contains more than

+  PcdMaximumLinkedListLength nodes, then ASSERT().

+

+  @param  List              A pointer to a node in a linked list.

+

+  @retval   TRUE if PcdVerifyNodeInList is FALSE

+  @retval   TRUE if DoMembershipCheck is FALSE

+  @retval   TRUE if PcdVerifyNodeInList is TRUE and DoMembershipCheck is TRUE

+            and Node is a member of List.

+  @retval   FALSE if PcdVerifyNodeInList is TRUE and DoMembershipCheck is TRUE

+            and Node is in not a member of List.

+

+**/

+BOOLEAN

+EFIAPI

+InternalBaseLibIsListValid (

+  IN CONST LIST_ENTRY  *List

+  )

+{

+  UINTN             Count;

+  CONST LIST_ENTRY  *Ptr;

+

+  //

+  // Test the validity of List and Node

+  //

+  ASSERT (List != NULL);

+  ASSERT (List->ForwardLink != NULL);

+  ASSERT (List->BackLink != NULL);

+

+  if (PcdGet32 (PcdMaximumLinkedListLength) > 0) {

+    Count = 0;

+    Ptr   = List;

+

+    //

+    // Count the total number of nodes in List.

+    // Exit early if the number of nodes in List >= PcdMaximumLinkedListLength

+    //

+    do {

+      Ptr = Ptr->ForwardLink;

+      Count++;

+    } while ((Ptr != List) && (Count < PcdGet32 (PcdMaximumLinkedListLength)));

+

+    //

+    // return whether linked list is too long

+    //

+    return (BOOLEAN)(Count < PcdGet32 (PcdMaximumLinkedListLength));

+  }

+

+  return TRUE;

+}

+

+/**

+  Checks whether FirstEntry and SecondEntry are part of the same doubly-linked

+  list.

+

+  If FirstEntry is NULL, then ASSERT().

+  If FirstEntry->ForwardLink is NULL, then ASSERT().

+  If FirstEntry->BackLink is NULL, then ASSERT().

+  If SecondEntry is NULL, then ASSERT();

+  If PcdMaximumLinkedListLength is not zero, and List contains more than

+  PcdMaximumLinkedListLength nodes, then ASSERT().

+

+  @param  FirstEntry   A pointer to a node in a linked list.

+  @param  SecondEntry  A pointer to the node to locate.

+

+  @retval TRUE   SecondEntry is in the same doubly-linked list as FirstEntry.

+  @retval FALSE  SecondEntry isn't in the same doubly-linked list as FirstEntry,

+                 or FirstEntry is invalid.

+

+**/

+BOOLEAN

+EFIAPI

+IsNodeInList (

+  IN      CONST LIST_ENTRY      *FirstEntry,

+  IN      CONST LIST_ENTRY      *SecondEntry

+  )

+{

+  UINTN             Count;

+  CONST LIST_ENTRY  *Ptr;

+

+  //

+  // ASSERT List not too long

+  //

+  ASSERT (InternalBaseLibIsListValid (FirstEntry));

+

+  ASSERT (SecondEntry != NULL);

+

+  Count = 0;

+  Ptr   = FirstEntry;

+

+  //

+  // Check to see if SecondEntry is a member of FirstEntry.

+  // Exit early if the number of nodes in List >= PcdMaximumLinkedListLength

+  //

+  do {

+    Ptr = Ptr->ForwardLink;

+    if (PcdGet32 (PcdMaximumLinkedListLength) > 0) {

+      Count++;

+

+      //

+      // Return if the linked list is too long

+      //

+      if (Count == PcdGet32 (PcdMaximumLinkedListLength)) {

+        return (BOOLEAN)(Ptr == SecondEntry);

+      }

+    }

+

+    if (Ptr == SecondEntry) {

+      return TRUE;

+    }

+  } while (Ptr != FirstEntry);

+

+  return FALSE;

+}

+

+/**

+  Initializes the head node of a doubly-linked list, and returns the pointer to

+  the head node of the doubly-linked list.

+

+  Initializes the forward and backward links of a new linked list. After

+  initializing a linked list with this function, the other linked list

+  functions may be used to add and remove nodes from the linked list. It is up

+  to the caller of this function to allocate the memory for ListHead.

+

+  If ListHead is NULL, then ASSERT().

+

+  @param  ListHead  A pointer to the head node of a new doubly-linked list.

+

+  @return ListHead

+

+**/

+LIST_ENTRY *

+EFIAPI

+InitializeListHead (

+  IN OUT  LIST_ENTRY                *ListHead

+  )

+

+{

+  ASSERT (ListHead != NULL);

+

+  ListHead->ForwardLink = ListHead;

+  ListHead->BackLink = ListHead;

+  return ListHead;

+}

+

+/**

+  Adds a node to the beginning of a doubly-linked list, and returns the pointer

+  to the head node of the doubly-linked list.

+

+  Adds the node Entry at the beginning of the doubly-linked list denoted by

+  ListHead, and returns ListHead.

+

+  If ListHead is NULL, then ASSERT().

+  If Entry is NULL, then ASSERT().

+  If ListHead was not initialized with INTIALIZE_LIST_HEAD_VARIABLE() or

+  InitializeListHead(), then ASSERT().

+  If PcdMaximumLinkedListLength is not zero, and prior to insertion the number

+  of nodes in ListHead, including the ListHead node, is greater than or

+  equal to PcdMaximumLinkedListLength, then ASSERT().

+

+  @param  ListHead  A pointer to the head node of a doubly-linked list.

+  @param  Entry     A pointer to a node that is to be inserted at the beginning

+                    of a doubly-linked list.

+

+  @return ListHead

+

+**/

+LIST_ENTRY *

+EFIAPI

+InsertHeadList (

+  IN OUT  LIST_ENTRY                *ListHead,

+  IN OUT  LIST_ENTRY                *Entry

+  )

+{

+  //

+  // ASSERT List not too long and Entry is not one of the nodes of List

+  //

+  ASSERT_VERIFY_NODE_IN_VALID_LIST (ListHead, Entry, FALSE);

+

+  Entry->ForwardLink = ListHead->ForwardLink;

+  Entry->BackLink = ListHead;

+  Entry->ForwardLink->BackLink = Entry;

+  ListHead->ForwardLink = Entry;

+  return ListHead;

+}

+

+/**

+  Adds a node to the end of a doubly-linked list, and returns the pointer to

+  the head node of the doubly-linked list.

+

+  Adds the node Entry to the end of the doubly-linked list denoted by ListHead,

+  and returns ListHead.

+

+  If ListHead is NULL, then ASSERT().

+  If Entry is NULL, then ASSERT().

+  If ListHead was not initialized with INTIALIZE_LIST_HEAD_VARIABLE() or

+  InitializeListHead(), then ASSERT().

+  If PcdMaximumLinkedListLength is not zero, and prior to insertion the number

+  of nodes in ListHead, including the ListHead node, is greater than or

+  equal to PcdMaximumLinkedListLength, then ASSERT().

+

+  @param  ListHead  A pointer to the head node of a doubly-linked list.

+  @param  Entry     A pointer to a node that is to be added at the end of the

+                    doubly-linked list.

+

+  @return ListHead

+

+**/

+LIST_ENTRY *

+EFIAPI

+InsertTailList (

+  IN OUT  LIST_ENTRY                *ListHead,

+  IN OUT  LIST_ENTRY                *Entry

+  )

+{

+  //

+  // ASSERT List not too long and Entry is not one of the nodes of List

+  //

+  ASSERT_VERIFY_NODE_IN_VALID_LIST (ListHead, Entry, FALSE);

+

+  Entry->ForwardLink = ListHead;

+  Entry->BackLink = ListHead->BackLink;

+  Entry->BackLink->ForwardLink = Entry;

+  ListHead->BackLink = Entry;

+  return ListHead;

+}

+

+/**

+  Retrieves the first node of a doubly-linked list.

+

+  Returns the first node of a doubly-linked list.  List must have been

+  initialized with INTIALIZE_LIST_HEAD_VARIABLE() or InitializeListHead().

+  If List is empty, then List is returned.

+

+  If List is NULL, then ASSERT().

+  If List was not initialized with INTIALIZE_LIST_HEAD_VARIABLE() or

+  InitializeListHead(), then ASSERT().

+  If PcdMaximumLinkedListLength is not zero, and the number of nodes

+  in List, including the List node, is greater than or equal to

+  PcdMaximumLinkedListLength, then ASSERT().

+

+  @param  List  A pointer to the head node of a doubly-linked list.

+

+  @return The first node of a doubly-linked list.

+  @retval List  The list is empty.

+

+**/

+LIST_ENTRY *

+EFIAPI

+GetFirstNode (

+  IN      CONST LIST_ENTRY          *List

+  )

+{

+  //

+  // ASSERT List not too long

+  //

+  ASSERT (InternalBaseLibIsListValid (List));

+

+  return List->ForwardLink;

+}

+

+/**

+  Retrieves the next node of a doubly-linked list.

+

+  Returns the node of a doubly-linked list that follows Node.

+  List must have been initialized with INTIALIZE_LIST_HEAD_VARIABLE()

+  or InitializeListHead().  If List is empty, then List is returned.

+

+  If List is NULL, then ASSERT().

+  If Node is NULL, then ASSERT().

+  If List was not initialized with INTIALIZE_LIST_HEAD_VARIABLE() or

+  InitializeListHead(), then ASSERT().

+  If PcdMaximumLinkedListLength is not zero, and List contains more than

+  PcdMaximumLinkedListLength nodes, then ASSERT().

+  If PcdVerifyNodeInList is TRUE and Node is not a node in List, then ASSERT().

+

+  @param  List  A pointer to the head node of a doubly-linked list.

+  @param  Node  A pointer to a node in the doubly-linked list.

+

+  @return A pointer to the next node if one exists. Otherwise List is returned.

+

+**/

+LIST_ENTRY *

+EFIAPI

+GetNextNode (

+  IN      CONST LIST_ENTRY          *List,

+  IN      CONST LIST_ENTRY          *Node

+  )

+{

+  //

+  // ASSERT List not too long and Node is one of the nodes of List

+  //

+  ASSERT_VERIFY_NODE_IN_VALID_LIST (List, Node, TRUE);

+

+  return Node->ForwardLink;

+}

+

+/**

+  Retrieves the previous node of a doubly-linked list.

+

+  Returns the node of a doubly-linked list that precedes Node.

+  List must have been initialized with INTIALIZE_LIST_HEAD_VARIABLE()

+  or InitializeListHead().  If List is empty, then List is returned.

+

+  If List is NULL, then ASSERT().

+  If Node is NULL, then ASSERT().

+  If List was not initialized with INTIALIZE_LIST_HEAD_VARIABLE() or

+  InitializeListHead(), then ASSERT().

+  If PcdMaximumLinkedListLength is not zero, and List contains more than

+  PcdMaximumLinkedListLength nodes, then ASSERT().

+  If PcdVerifyNodeInList is TRUE and Node is not a node in List, then ASSERT().

+

+  @param  List  A pointer to the head node of a doubly-linked list.

+  @param  Node  A pointer to a node in the doubly-linked list.

+

+  @return A pointer to the previous node if one exists. Otherwise List is returned.

+

+**/

+LIST_ENTRY *

+EFIAPI

+GetPreviousNode (

+  IN      CONST LIST_ENTRY          *List,

+  IN      CONST LIST_ENTRY          *Node

+  )

+{

+  //

+  // ASSERT List not too long and Node is one of the nodes of List

+  //

+  ASSERT_VERIFY_NODE_IN_VALID_LIST (List, Node, TRUE);

+

+  return Node->BackLink;

+}

+

+/**

+  Checks to see if a doubly-linked list is empty or not.

+

+  Checks to see if the doubly-linked list is empty. If the linked list contains

+  zero nodes, this function returns TRUE. Otherwise, it returns FALSE.

+

+  If ListHead is NULL, then ASSERT().

+  If ListHead was not initialized with INTIALIZE_LIST_HEAD_VARIABLE() or

+  InitializeListHead(), then ASSERT().

+  If PcdMaximumLinkedListLength is not zero, and the number of nodes

+  in List, including the List node, is greater than or equal to

+  PcdMaximumLinkedListLength, then ASSERT().

+

+  @param  ListHead  A pointer to the head node of a doubly-linked list.

+

+  @retval TRUE  The linked list is empty.

+  @retval FALSE The linked list is not empty.

+

+**/

+BOOLEAN

+EFIAPI

+IsListEmpty (

+  IN      CONST LIST_ENTRY          *ListHead

+  )

+{

+  //

+  // ASSERT List not too long

+  //

+  ASSERT (InternalBaseLibIsListValid (ListHead));

+

+  return (BOOLEAN)(ListHead->ForwardLink == ListHead);

+}

+

+/**

+  Determines if a node in a doubly-linked list is the head node of a the same

+  doubly-linked list.  This function is typically used to terminate a loop that

+  traverses all the nodes in a doubly-linked list starting with the head node.

+

+  Returns TRUE if Node is equal to List.  Returns FALSE if Node is one of the

+  nodes in the doubly-linked list specified by List.  List must have been

+  initialized with INTIALIZE_LIST_HEAD_VARIABLE() or InitializeListHead().

+

+  If List is NULL, then ASSERT().

+  If Node is NULL, then ASSERT().

+  If List was not initialized with INTIALIZE_LIST_HEAD_VARIABLE() or InitializeListHead(),

+  then ASSERT().

+  If PcdMaximumLinkedListLength is not zero, and the number of nodes

+  in List, including the List node, is greater than or equal to

+  PcdMaximumLinkedListLength, then ASSERT().

+  If PcdVerifyNodeInList is TRUE and Node is not a node in List and Node is not

+  equal to List, then ASSERT().

+

+  @param  List  A pointer to the head node of a doubly-linked list.

+  @param  Node  A pointer to a node in the doubly-linked list.

+

+  @retval TRUE  Node is the head of the doubly-linked list pointed by List.

+  @retval FALSE Node is not the head of the doubly-linked list pointed by List.

+

+**/

+BOOLEAN

+EFIAPI

+IsNull (

+  IN      CONST LIST_ENTRY          *List,

+  IN      CONST LIST_ENTRY          *Node

+  )

+{

+  //

+  // ASSERT List not too long and Node is one of the nodes of List

+  //

+  ASSERT_VERIFY_NODE_IN_VALID_LIST (List, Node, TRUE);

+

+  return (BOOLEAN)(Node == List);

+}

+

+/**

+  Determines if a node the last node in a doubly-linked list.

+

+  Returns TRUE if Node is the last node in the doubly-linked list specified by

+  List. Otherwise, FALSE is returned. List must have been initialized with

+  INTIALIZE_LIST_HEAD_VARIABLE() or InitializeListHead().

+

+  If List is NULL, then ASSERT().

+  If Node is NULL, then ASSERT().

+  If List was not initialized with INTIALIZE_LIST_HEAD_VARIABLE() or

+  InitializeListHead(), then ASSERT().

+  If PcdMaximumLinkedListLength is not zero, and the number of nodes

+  in List, including the List node, is greater than or equal to

+  PcdMaximumLinkedListLength, then ASSERT().

+  If PcdVerifyNodeInList is TRUE and Node is not a node in List, then ASSERT().

+

+  @param  List  A pointer to the head node of a doubly-linked list.

+  @param  Node  A pointer to a node in the doubly-linked list.

+

+  @retval TRUE  Node is the last node in the linked list.

+  @retval FALSE Node is not the last node in the linked list.

+

+**/

+BOOLEAN

+EFIAPI

+IsNodeAtEnd (

+  IN      CONST LIST_ENTRY          *List,

+  IN      CONST LIST_ENTRY          *Node

+  )

+{

+  //

+  // ASSERT List not too long and Node is one of the nodes of List

+  //

+  ASSERT_VERIFY_NODE_IN_VALID_LIST (List, Node, TRUE);

+

+  return (BOOLEAN)(!IsNull (List, Node) && List->BackLink == Node);

+}

+

+/**

+  Swaps the location of two nodes in a doubly-linked list, and returns the

+  first node after the swap.

+

+  If FirstEntry is identical to SecondEntry, then SecondEntry is returned.

+  Otherwise, the location of the FirstEntry node is swapped with the location

+  of the SecondEntry node in a doubly-linked list. SecondEntry must be in the

+  same double linked list as FirstEntry and that double linked list must have

+  been initialized with INTIALIZE_LIST_HEAD_VARIABLE() or InitializeListHead().

+  SecondEntry is returned after the nodes are swapped.

+

+  If FirstEntry is NULL, then ASSERT().

+  If SecondEntry is NULL, then ASSERT().

+  If PcdVerifyNodeInList is TRUE and SecondEntry and FirstEntry are not in the

+  same linked list, then ASSERT().

+  If PcdMaximumLinkedListLength is not zero, and the number of nodes in the

+  linked list containing the FirstEntry and SecondEntry nodes, including

+  the FirstEntry and SecondEntry nodes, is greater than or equal to

+  PcdMaximumLinkedListLength, then ASSERT().

+

+  @param  FirstEntry  A pointer to a node in a linked list.

+  @param  SecondEntry A pointer to another node in the same linked list.

+

+  @return SecondEntry.

+

+**/

+LIST_ENTRY *

+EFIAPI

+SwapListEntries (

+  IN OUT  LIST_ENTRY                *FirstEntry,

+  IN OUT  LIST_ENTRY                *SecondEntry

+  )

+{

+  LIST_ENTRY                    *Ptr;

+

+  if (FirstEntry == SecondEntry) {

+    return SecondEntry;

+  }

+

+  //

+  // ASSERT Entry1 and Entry2 are in the same linked list

+  //

+  ASSERT_VERIFY_NODE_IN_VALID_LIST (FirstEntry, SecondEntry, TRUE);

+

+  //

+  // Ptr is the node pointed to by FirstEntry->ForwardLink

+  //

+  Ptr = RemoveEntryList (FirstEntry);

+

+  //

+  // If FirstEntry immediately follows SecondEntry, FirstEntry will be placed

+  // immediately in front of SecondEntry

+  //

+  if (Ptr->BackLink == SecondEntry) {

+    return InsertTailList (SecondEntry, FirstEntry);

+  }

+

+  //

+  // Ptr == SecondEntry means SecondEntry immediately follows FirstEntry,

+  // then there are no further steps necessary

+  //

+  if (Ptr == InsertHeadList (SecondEntry, FirstEntry)) {

+    return Ptr;

+  }

+

+  //

+  // Move SecondEntry to the front of Ptr

+  //

+  RemoveEntryList (SecondEntry);

+  InsertTailList (Ptr, SecondEntry);

+  return SecondEntry;

+}

+

+/**

+  Removes a node from a doubly-linked list, and returns the node that follows

+  the removed node.

+

+  Removes the node Entry from a doubly-linked list. It is up to the caller of

+  this function to release the memory used by this node if that is required. On

+  exit, the node following Entry in the doubly-linked list is returned. If

+  Entry is the only node in the linked list, then the head node of the linked

+  list is returned.

+

+  If Entry is NULL, then ASSERT().

+  If Entry is the head node of an empty list, then ASSERT().

+  If PcdMaximumLinkedListLength is not zero, and the number of nodes in the

+  linked list containing Entry, including the Entry node, is greater than

+  or equal to PcdMaximumLinkedListLength, then ASSERT().

+

+  @param  Entry A pointer to a node in a linked list.

+

+  @return Entry.

+

+**/

+LIST_ENTRY *

+EFIAPI

+RemoveEntryList (

+  IN      CONST LIST_ENTRY          *Entry

+  )

+{

+  ASSERT (!IsListEmpty (Entry));

+

+  Entry->ForwardLink->BackLink = Entry->BackLink;

+  Entry->BackLink->ForwardLink = Entry->ForwardLink;

+  return Entry->ForwardLink;

+}

diff --git a/debugging_demo/memtest86+/efi/Include/src/BaseLib/LongJump.c b/debugging_demo/memtest86+/efi/Include/src/BaseLib/LongJump.c
new file mode 100644
index 0000000..1d88e41
--- /dev/null
+++ b/debugging_demo/memtest86+/efi/Include/src/BaseLib/LongJump.c
@@ -0,0 +1,41 @@
+/** @file

+  Long Jump functions.

+

+  Copyright (c) 2006 - 2008, Intel Corporation. All rights reserved.<BR>

+  SPDX-License-Identifier: BSD-2-Clause-Patent

+

+**/

+

+

+

+

+#include "BaseLibInternals.h"

+

+/**

+  Restores the CPU context that was saved with SetJump().

+

+  Restores the CPU context from the buffer specified by JumpBuffer. This

+  function never returns to the caller. Instead is resumes execution based on

+  the state of JumpBuffer.

+

+  If JumpBuffer is NULL, then ASSERT().

+  For IPF CPUs, if JumpBuffer is not aligned on a 16-byte boundary, then ASSERT().

+  If Value is 0, then ASSERT().

+

+  @param  JumpBuffer  A pointer to CPU context buffer.

+  @param  Value       The value to return when the SetJump() context is

+                      restored and must be non-zero.

+

+**/

+VOID

+EFIAPI

+LongJump (

+  IN      BASE_LIBRARY_JUMP_BUFFER  *JumpBuffer,

+  IN      UINTN                     Value

+  )

+{

+  InternalAssertJumpBuffer (JumpBuffer);

+  ASSERT (Value != 0);

+

+  InternalLongJump (JumpBuffer, Value);

+}

diff --git a/debugging_demo/memtest86+/efi/Include/src/BaseLib/LowBitSet32.c b/debugging_demo/memtest86+/efi/Include/src/BaseLib/LowBitSet32.c
new file mode 100644
index 0000000..8383c79
--- /dev/null
+++ b/debugging_demo/memtest86+/efi/Include/src/BaseLib/LowBitSet32.c
@@ -0,0 +1,41 @@
+/** @file

+  Math worker functions.

+

+  Copyright (c) 2006 - 2008, Intel Corporation. All rights reserved.<BR>

+  SPDX-License-Identifier: BSD-2-Clause-Patent

+

+**/

+

+

+

+

+#include "BaseLibInternals.h"

+

+/**

+  Returns the bit position of the lowest bit set in a 32-bit value.

+

+  This function computes the bit position of the lowest bit set in the 32-bit

+  value specified by Operand. If Operand is zero, then -1 is returned.

+  Otherwise, a value between 0 and 31 is returned.

+

+  @param  Operand The 32-bit operand to evaluate.

+

+  @retval 0..31  The lowest bit set in Operand was found.

+  @retval -1     Operand is zero.

+

+**/

+INTN

+EFIAPI

+LowBitSet32 (

+  IN      UINT32                    Operand

+  )

+{

+  INTN                              BitIndex;

+

+  if (Operand == 0) {

+    return -1;

+  }

+

+  for (BitIndex = 0; 0 == (Operand & 1); BitIndex++, Operand >>= 1);

+  return BitIndex;

+}

diff --git a/debugging_demo/memtest86+/efi/Include/src/BaseLib/LowBitSet64.c b/debugging_demo/memtest86+/efi/Include/src/BaseLib/LowBitSet64.c
new file mode 100644
index 0000000..349ed52
--- /dev/null
+++ b/debugging_demo/memtest86+/efi/Include/src/BaseLib/LowBitSet64.c
@@ -0,0 +1,44 @@
+/** @file

+  Math worker functions.

+

+  Copyright (c) 2006 - 2008, Intel Corporation. All rights reserved.<BR>

+  SPDX-License-Identifier: BSD-2-Clause-Patent

+

+**/

+

+

+

+

+#include "BaseLibInternals.h"

+

+/**

+  Returns the bit position of the lowest bit set in a 64-bit value.

+

+  This function computes the bit position of the lowest bit set in the 64-bit

+  value specified by Operand. If Operand is zero, then -1 is returned.

+  Otherwise, a value between 0 and 63 is returned.

+

+  @param  Operand The 64-bit operand to evaluate.

+

+  @retval 0..63  The lowest bit set in Operand was found.

+  @retval -1     Operand is zero.

+

+

+**/

+INTN

+EFIAPI

+LowBitSet64 (

+  IN      UINT64                    Operand

+  )

+{

+  INTN                              BitIndex;

+

+  if (Operand == 0) {

+    return -1;

+  }

+

+  for (BitIndex = 0;

+       (Operand & 1) == 0;

+       BitIndex++, Operand = RShiftU64 (Operand, 1));

+  return BitIndex;

+}

diff --git a/debugging_demo/memtest86+/efi/Include/src/BaseLib/Math64.c b/debugging_demo/memtest86+/efi/Include/src/BaseLib/Math64.c
new file mode 100644
index 0000000..154b97a
--- /dev/null
+++ b/debugging_demo/memtest86+/efi/Include/src/BaseLib/Math64.c
@@ -0,0 +1,362 @@
+/** @file

+  Leaf math worker functions that require 64-bit arithmetic support from the

+  compiler.

+

+  Copyright (c) 2006 - 2010, Intel Corporation. All rights reserved.<BR>

+  SPDX-License-Identifier: BSD-2-Clause-Patent

+

+**/

+

+#include "BaseLibInternals.h"

+

+/**

+  Shifts a 64-bit integer left between 0 and 63 bits. The low bits

+  are filled with zeros. The shifted value is returned.

+

+  This function shifts the 64-bit value Operand to the left by Count bits. The

+  low Count bits are set to zero. The shifted value is returned.

+

+  @param  Operand The 64-bit operand to shift left.

+  @param  Count   The number of bits to shift left.

+

+  @return Operand << Count.

+

+**/

+UINT64

+EFIAPI

+InternalMathLShiftU64 (

+  IN      UINT64                    Operand,

+  IN      UINTN                     Count

+  )

+{

+  return Operand << Count;

+}

+

+/**

+  Shifts a 64-bit integer right between 0 and 63 bits. This high bits

+  are filled with zeros. The shifted value is returned.

+

+  This function shifts the 64-bit value Operand to the right by Count bits. The

+  high Count bits are set to zero. The shifted value is returned.

+

+  @param  Operand The 64-bit operand to shift right.

+  @param  Count   The number of bits to shift right.

+

+  @return Operand >> Count.

+

+**/

+UINT64

+EFIAPI

+InternalMathRShiftU64 (

+  IN      UINT64                    Operand,

+  IN      UINTN                     Count

+  )

+{

+  return Operand >> Count;

+}

+

+/**

+  Shifts a 64-bit integer right between 0 and 63 bits. The high bits

+  are filled with original integer's bit 63. The shifted value is returned.

+

+  This function shifts the 64-bit value Operand to the right by Count bits. The

+  high Count bits are set to bit 63 of Operand.  The shifted value is returned.

+

+  @param  Operand The 64-bit operand to shift right.

+  @param  Count   The number of bits to shift right.

+

+  @return Operand arithmetically shifted right by Count.

+

+**/

+UINT64

+EFIAPI

+InternalMathARShiftU64 (

+  IN      UINT64                    Operand,

+  IN      UINTN                     Count

+  )

+{

+  INTN  TestValue;

+

+  //

+  // Test if this compiler supports arithmetic shift

+  //

+  TestValue = (INTN)((INT64)(1ULL << 63) >> 63);

+  if (TestValue == -1) {

+    //

+    // Arithmetic shift is supported

+    //

+    return (UINT64)((INT64)Operand >> Count);

+  }

+

+  //

+  // Arithmetic is not supported

+  //

+  return (Operand >> Count) |

+         ((INTN)Operand < 0 ? ~((UINTN)-1 >> Count) : 0);

+}

+

+

+/**

+  Rotates a 64-bit integer left between 0 and 63 bits, filling

+  the low bits with the high bits that were rotated.

+

+  This function rotates the 64-bit value Operand to the left by Count bits. The

+  low Count bits are fill with the high Count bits of Operand. The rotated

+  value is returned.

+

+  @param  Operand The 64-bit operand to rotate left.

+  @param  Count   The number of bits to rotate left.

+

+  @return Operand <<< Count.

+

+**/

+UINT64

+EFIAPI

+InternalMathLRotU64 (

+  IN      UINT64                    Operand,

+  IN      UINTN                     Count

+  )

+{

+  return (Operand << Count) | (Operand >> (64 - Count));

+}

+

+/**

+  Rotates a 64-bit integer right between 0 and 63 bits, filling

+  the high bits with the high low bits that were rotated.

+

+  This function rotates the 64-bit value Operand to the right by Count bits.

+  The high Count bits are fill with the low Count bits of Operand. The rotated

+  value is returned.

+

+  @param  Operand The 64-bit operand to rotate right.

+  @param  Count   The number of bits to rotate right.

+

+  @return Operand >>> Count.

+

+**/

+UINT64

+EFIAPI

+InternalMathRRotU64 (

+  IN      UINT64                    Operand,

+  IN      UINTN                     Count

+  )

+{

+  return (Operand >> Count) | (Operand << (64 - Count));

+}

+

+/**

+  Switches the endianess of a 64-bit integer.

+

+  This function swaps the bytes in a 64-bit unsigned value to switch the value

+  from little endian to big endian or vice versa. The byte swapped value is

+  returned.

+

+  @param  Operand A 64-bit unsigned value.

+

+  @return The byte swapped Operand.

+

+**/

+UINT64

+EFIAPI

+InternalMathSwapBytes64 (

+  IN      UINT64                    Operand

+  )

+{

+  UINT64  LowerBytes;

+  UINT64  HigherBytes;

+

+  LowerBytes  = (UINT64) SwapBytes32 ((UINT32) Operand);

+  HigherBytes = (UINT64) SwapBytes32 ((UINT32) (Operand >> 32));

+

+  return (LowerBytes << 32 | HigherBytes);

+}

+

+/**

+  Multiplies a 64-bit unsigned integer by a 32-bit unsigned integer

+  and generates a 64-bit unsigned result.

+

+  This function multiplies the 64-bit unsigned value Multiplicand by the 32-bit

+  unsigned value Multiplier and generates a 64-bit unsigned result. This 64-

+  bit unsigned result is returned.

+

+  @param  Multiplicand  A 64-bit unsigned value.

+  @param  Multiplier    A 32-bit unsigned value.

+

+  @return Multiplicand * Multiplier

+

+**/

+UINT64

+EFIAPI

+InternalMathMultU64x32 (

+  IN      UINT64                    Multiplicand,

+  IN      UINT32                    Multiplier

+  )

+{

+  return Multiplicand * Multiplier;

+}

+

+

+/**

+  Multiplies a 64-bit unsigned integer by a 64-bit unsigned integer

+  and generates a 64-bit unsigned result.

+

+  This function multiplies the 64-bit unsigned value Multiplicand by the 64-bit

+  unsigned value Multiplier and generates a 64-bit unsigned result. This 64-

+  bit unsigned result is returned.

+

+  @param  Multiplicand  A 64-bit unsigned value.

+  @param  Multiplier    A 64-bit unsigned value.

+

+  @return Multiplicand * Multiplier.

+

+**/

+UINT64

+EFIAPI

+InternalMathMultU64x64 (

+  IN      UINT64                    Multiplicand,

+  IN      UINT64                    Multiplier

+  )

+{

+  return Multiplicand * Multiplier;

+}

+

+/**

+  Divides a 64-bit unsigned integer by a 32-bit unsigned integer and

+  generates a 64-bit unsigned result.

+

+  This function divides the 64-bit unsigned value Dividend by the 32-bit

+  unsigned value Divisor and generates a 64-bit unsigned quotient. This

+  function returns the 64-bit unsigned quotient.

+

+  @param  Dividend  A 64-bit unsigned value.

+  @param  Divisor   A 32-bit unsigned value.

+

+  @return Dividend / Divisor.

+

+**/

+UINT64

+EFIAPI

+InternalMathDivU64x32 (

+  IN      UINT64                    Dividend,

+  IN      UINT32                    Divisor

+  )

+{

+  return Dividend / Divisor;

+}

+

+/**

+  Divides a 64-bit unsigned integer by a 32-bit unsigned integer and

+  generates a 32-bit unsigned remainder.

+

+  This function divides the 64-bit unsigned value Dividend by the 32-bit

+  unsigned value Divisor and generates a 32-bit remainder. This function

+  returns the 32-bit unsigned remainder.

+

+  @param  Dividend  A 64-bit unsigned value.

+  @param  Divisor   A 32-bit unsigned value.

+

+  @return Dividend % Divisor.

+

+**/

+UINT32

+EFIAPI

+InternalMathModU64x32 (

+  IN      UINT64                    Dividend,

+  IN      UINT32                    Divisor

+  )

+{

+  return (UINT32)(Dividend % Divisor);

+}

+

+/**

+  Divides a 64-bit unsigned integer by a 32-bit unsigned integer and

+  generates a 64-bit unsigned result and an optional 32-bit unsigned remainder.

+

+  This function divides the 64-bit unsigned value Dividend by the 32-bit

+  unsigned value Divisor and generates a 64-bit unsigned quotient. If Remainder

+  is not NULL, then the 32-bit unsigned remainder is returned in Remainder.

+  This function returns the 64-bit unsigned quotient.

+

+  @param  Dividend  A 64-bit unsigned value.

+  @param  Divisor   A 32-bit unsigned value.

+  @param  Remainder A pointer to a 32-bit unsigned value. This parameter is

+                    optional and may be NULL.

+

+  @return Dividend / Divisor.

+

+**/

+UINT64

+EFIAPI

+InternalMathDivRemU64x32 (

+  IN      UINT64                    Dividend,

+  IN      UINT32                    Divisor,

+  OUT     UINT32                    *Remainder OPTIONAL

+  )

+{

+  if (Remainder != NULL) {

+    *Remainder = (UINT32)(Dividend % Divisor);

+  }

+  return Dividend / Divisor;

+}

+

+/**

+  Divides a 64-bit unsigned integer by a 64-bit unsigned integer and

+  generates a 64-bit unsigned result and an optional 64-bit unsigned remainder.

+

+  This function divides the 64-bit unsigned value Dividend by the 64-bit

+  unsigned value Divisor and generates a 64-bit unsigned quotient. If Remainder

+  is not NULL, then the 64-bit unsigned remainder is returned in Remainder.

+  This function returns the 64-bit unsigned quotient.

+

+  @param  Dividend  A 64-bit unsigned value.

+  @param  Divisor   A 64-bit unsigned value.

+  @param  Remainder A pointer to a 64-bit unsigned value. This parameter is

+                    optional and may be NULL.

+

+  @return Dividend / Divisor

+

+**/

+UINT64

+EFIAPI

+InternalMathDivRemU64x64 (

+  IN      UINT64                    Dividend,

+  IN      UINT64                    Divisor,

+  OUT     UINT64                    *Remainder OPTIONAL

+  )

+{

+  if (Remainder != NULL) {

+    *Remainder = Dividend % Divisor;

+  }

+  return Dividend / Divisor;

+}

+

+/**

+  Divides a 64-bit signed integer by a 64-bit signed integer and

+  generates a 64-bit signed result and an optional 64-bit signed remainder.

+

+  This function divides the 64-bit signed value Dividend by the 64-bit

+  signed value Divisor and generates a 64-bit signed quotient. If Remainder

+  is not NULL, then the 64-bit signed remainder is returned in Remainder.

+  This function returns the 64-bit signed quotient.

+

+  @param  Dividend  A 64-bit signed value.

+  @param  Divisor   A 64-bit signed value.

+  @param  Remainder A pointer to a 64-bit signed value. This parameter is

+                    optional and may be NULL.

+

+  @return Dividend / Divisor.

+

+**/

+INT64

+EFIAPI

+InternalMathDivRemS64x64 (

+  IN      INT64                     Dividend,

+  IN      INT64                     Divisor,

+  OUT     INT64                     *Remainder  OPTIONAL

+  )

+{

+  if (Remainder != NULL) {

+    *Remainder = Dividend % Divisor;

+  }

+  return Dividend / Divisor;

+}

diff --git a/debugging_demo/memtest86+/efi/Include/src/BaseLib/ModU64x32.c b/debugging_demo/memtest86+/efi/Include/src/BaseLib/ModU64x32.c
new file mode 100644
index 0000000..ee99ab3
--- /dev/null
+++ b/debugging_demo/memtest86+/efi/Include/src/BaseLib/ModU64x32.c
@@ -0,0 +1,39 @@
+/** @file

+  Math worker functions.

+

+  Copyright (c) 2006 - 2008, Intel Corporation. All rights reserved.<BR>

+  SPDX-License-Identifier: BSD-2-Clause-Patent

+

+**/

+

+

+

+

+#include "BaseLibInternals.h"

+

+/**

+  Divides a 64-bit unsigned integer by a 32-bit unsigned integer and generates

+  a 32-bit unsigned remainder.

+

+  This function divides the 64-bit unsigned value Dividend by the 32-bit

+  unsigned value Divisor and generates a 32-bit remainder. This function

+  returns the 32-bit unsigned remainder.

+

+  If Divisor is 0, then ASSERT().

+

+  @param  Dividend  A 64-bit unsigned value.

+  @param  Divisor   A 32-bit unsigned value.

+

+  @return Dividend % Divisor.

+

+**/

+UINT32

+EFIAPI

+ModU64x32 (

+  IN      UINT64                    Dividend,

+  IN      UINT32                    Divisor

+  )

+{

+  ASSERT (Divisor != 0);

+  return InternalMathModU64x32 (Dividend, Divisor);

+}

diff --git a/debugging_demo/memtest86+/efi/Include/src/BaseLib/MultS64x64.c b/debugging_demo/memtest86+/efi/Include/src/BaseLib/MultS64x64.c
new file mode 100644
index 0000000..b5c745f
--- /dev/null
+++ b/debugging_demo/memtest86+/efi/Include/src/BaseLib/MultS64x64.c
@@ -0,0 +1,36 @@
+/** @file

+  Math worker functions.

+

+  Copyright (c) 2006 - 2010, Intel Corporation. All rights reserved.<BR>

+  SPDX-License-Identifier: BSD-2-Clause-Patent

+

+**/

+

+

+

+

+#include "BaseLibInternals.h"

+

+/**

+  Multiplies a 64-bit signed integer by a 64-bit signed integer and generates a

+  64-bit signed result.

+

+  This function multiplies the 64-bit signed value Multiplicand by the 64-bit

+  signed value Multiplier and generates a 64-bit signed result. This 64-bit

+  signed result is returned.

+

+  @param  Multiplicand  A 64-bit signed value.

+  @param  Multiplier    A 64-bit signed value.

+

+  @return Multiplicand * Multiplier.

+

+**/

+INT64

+EFIAPI

+MultS64x64 (

+  IN      INT64                     Multiplicand,

+  IN      INT64                     Multiplier

+  )

+{

+  return (INT64)MultU64x64 ((UINT64) Multiplicand, (UINT64) Multiplier);

+}

diff --git a/debugging_demo/memtest86+/efi/Include/src/BaseLib/MultU64x32.c b/debugging_demo/memtest86+/efi/Include/src/BaseLib/MultU64x32.c
new file mode 100644
index 0000000..2bbff51
--- /dev/null
+++ b/debugging_demo/memtest86+/efi/Include/src/BaseLib/MultU64x32.c
@@ -0,0 +1,40 @@
+/** @file

+  Math worker functions.

+

+  Copyright (c) 2006 - 2010, Intel Corporation. All rights reserved.<BR>

+  SPDX-License-Identifier: BSD-2-Clause-Patent

+

+**/

+

+

+

+

+#include "BaseLibInternals.h"

+

+/**

+  Multiplies a 64-bit unsigned integer by a 32-bit unsigned integer and

+  generates a 64-bit unsigned result.

+

+  This function multiplies the 64-bit unsigned value Multiplicand by the 32-bit

+  unsigned value Multiplier and generates a 64-bit unsigned result. This 64-

+  bit unsigned result is returned.

+

+  @param  Multiplicand  A 64-bit unsigned value.

+  @param  Multiplier    A 32-bit unsigned value.

+

+  @return Multiplicand * Multiplier.

+

+**/

+UINT64

+EFIAPI

+MultU64x32 (

+  IN      UINT64                    Multiplicand,

+  IN      UINT32                    Multiplier

+  )

+{

+  UINT64                            Result;

+

+  Result = InternalMathMultU64x32 (Multiplicand, Multiplier);

+

+  return Result;

+}

diff --git a/debugging_demo/memtest86+/efi/Include/src/BaseLib/MultU64x64.c b/debugging_demo/memtest86+/efi/Include/src/BaseLib/MultU64x64.c
new file mode 100644
index 0000000..e1ee9f1
--- /dev/null
+++ b/debugging_demo/memtest86+/efi/Include/src/BaseLib/MultU64x64.c
@@ -0,0 +1,40 @@
+/** @file

+  Math worker functions.

+

+  Copyright (c) 2006 - 2010, Intel Corporation. All rights reserved.<BR>

+  SPDX-License-Identifier: BSD-2-Clause-Patent

+

+**/

+

+

+

+

+#include "BaseLibInternals.h"

+

+/**

+  Multiplies a 64-bit unsigned integer by a 64-bit unsigned integer and

+  generates a 64-bit unsigned result.

+

+  This function multiplies the 64-bit unsigned value Multiplicand by the 64-bit

+  unsigned value Multiplier and generates a 64-bit unsigned result. This 64-

+  bit unsigned result is returned.

+

+  @param  Multiplicand  A 64-bit unsigned value.

+  @param  Multiplier    A 64-bit unsigned value.

+

+  @return Multiplicand * Multiplier.

+

+**/

+UINT64

+EFIAPI

+MultU64x64 (

+  IN      UINT64                    Multiplicand,

+  IN      UINT64                    Multiplier

+  )

+{

+  UINT64                            Result;

+

+  Result = InternalMathMultU64x64 (Multiplicand, Multiplier);

+

+  return Result;

+}

diff --git a/debugging_demo/memtest86+/efi/Include/src/BaseLib/RRotU32.c b/debugging_demo/memtest86+/efi/Include/src/BaseLib/RRotU32.c
new file mode 100644
index 0000000..3956fad
--- /dev/null
+++ b/debugging_demo/memtest86+/efi/Include/src/BaseLib/RRotU32.c
@@ -0,0 +1,36 @@
+/** @file

+  Math worker functions.

+

+  Copyright (c) 2006 - 2008, Intel Corporation. All rights reserved.<BR>

+  SPDX-License-Identifier: BSD-2-Clause-Patent

+

+**/

+

+#include "BaseLibInternals.h"

+

+/**

+  Rotates a 32-bit integer right between 0 and 31 bits, filling the high bits

+  with the low bits that were rotated.

+

+  This function rotates the 32-bit value Operand to the right by Count bits.

+  The high Count bits are fill with the low Count bits of Operand. The rotated

+  value is returned.

+

+  If Count is greater than 31, then ASSERT().

+

+  @param  Operand The 32-bit operand to rotate right.

+  @param  Count   The number of bits to rotate right.

+

+  @return Operand >> Count.

+

+**/

+UINT32

+EFIAPI

+RRotU32 (

+  IN      UINT32                    Operand,

+  IN      UINTN                     Count

+  )

+{

+  ASSERT (Count < 32);

+  return (Operand >> Count) | (Operand << (32 - Count));

+}

diff --git a/debugging_demo/memtest86+/efi/Include/src/BaseLib/RRotU64.c b/debugging_demo/memtest86+/efi/Include/src/BaseLib/RRotU64.c
new file mode 100644
index 0000000..e07ffd6
--- /dev/null
+++ b/debugging_demo/memtest86+/efi/Include/src/BaseLib/RRotU64.c
@@ -0,0 +1,36 @@
+/** @file

+  Math worker functions.

+

+  Copyright (c) 2006 - 2008, Intel Corporation. All rights reserved.<BR>

+  SPDX-License-Identifier: BSD-2-Clause-Patent

+

+**/

+

+#include "BaseLibInternals.h"

+

+/**

+  Rotates a 64-bit integer right between 0 and 63 bits, filling the high bits

+  with the high low bits that were rotated.

+

+  This function rotates the 64-bit value Operand to the right by Count bits.

+  The high Count bits are fill with the low Count bits of Operand. The rotated

+  value is returned.

+

+  If Count is greater than 63, then ASSERT().

+

+  @param  Operand The 64-bit operand to rotate right.

+  @param  Count   The number of bits to rotate right.

+

+  @return Operand >> Count.

+

+**/

+UINT64

+EFIAPI

+RRotU64 (

+  IN      UINT64                    Operand,

+  IN      UINTN                     Count

+  )

+{

+  ASSERT (Count < 64);

+  return InternalMathRRotU64 (Operand, Count);

+}

diff --git a/debugging_demo/memtest86+/efi/Include/src/BaseLib/RShiftU64.c b/debugging_demo/memtest86+/efi/Include/src/BaseLib/RShiftU64.c
new file mode 100644
index 0000000..20f94f7
--- /dev/null
+++ b/debugging_demo/memtest86+/efi/Include/src/BaseLib/RShiftU64.c
@@ -0,0 +1,35 @@
+/** @file

+  Math worker functions.

+

+  Copyright (c) 2006 - 2008, Intel Corporation. All rights reserved.<BR>

+  SPDX-License-Identifier: BSD-2-Clause-Patent

+

+**/

+

+#include "BaseLibInternals.h"

+

+/**

+  Shifts a 64-bit integer right between 0 and 63 bits. This high bits are

+  filled with zeros. The shifted value is returned.

+

+  This function shifts the 64-bit value Operand to the right by Count bits. The

+  high Count bits are set to zero. The shifted value is returned.

+

+  If Count is greater than 63, then ASSERT().

+

+  @param  Operand The 64-bit operand to shift right.

+  @param  Count   The number of bits to shift right.

+

+  @return Operand >> Count.

+

+**/

+UINT64

+EFIAPI

+RShiftU64 (

+  IN      UINT64                    Operand,

+  IN      UINTN                     Count

+  )

+{

+  ASSERT (Count < 64);

+  return InternalMathRShiftU64 (Operand, Count);

+}

diff --git a/debugging_demo/memtest86+/efi/Include/src/BaseLib/SafeString.c b/debugging_demo/memtest86+/efi/Include/src/BaseLib/SafeString.c
new file mode 100644
index 0000000..3bb23ca
--- /dev/null
+++ b/debugging_demo/memtest86+/efi/Include/src/BaseLib/SafeString.c
@@ -0,0 +1,3535 @@
+/** @file

+  Safe String functions.

+

+  Copyright (c) 2014 - 2019, Intel Corporation. All rights reserved.<BR>

+  SPDX-License-Identifier: BSD-2-Clause-Patent

+

+**/

+

+#include "BaseLibInternals.h"

+

+#define RSIZE_MAX  (PcdGet32 (PcdMaximumUnicodeStringLength))

+

+#define ASCII_RSIZE_MAX  (PcdGet32 (PcdMaximumAsciiStringLength))

+

+#define SAFE_STRING_CONSTRAINT_CHECK(Expression, Status)  \

+  do { \

+    if (!(Expression)) { \

+      DEBUG ((DEBUG_VERBOSE, \

+        "%a(%d) %a: SAFE_STRING_CONSTRAINT_CHECK(%a) failed.  Return %r\n", \

+        __FILE__, __LINE__, __FUNCTION__, #Expression, Status)); \

+      return Status; \

+    } \

+  } while (FALSE)

+

+/**

+  Returns if 2 memory blocks are overlapped.

+

+  @param  Base1  Base address of 1st memory block.

+  @param  Size1  Size of 1st memory block.

+  @param  Base2  Base address of 2nd memory block.

+  @param  Size2  Size of 2nd memory block.

+

+  @retval TRUE  2 memory blocks are overlapped.

+  @retval FALSE 2 memory blocks are not overlapped.

+**/

+BOOLEAN

+InternalSafeStringIsOverlap (

+  IN VOID    *Base1,

+  IN UINTN   Size1,

+  IN VOID    *Base2,

+  IN UINTN   Size2

+  )

+{

+  if ((((UINTN)Base1 >= (UINTN)Base2) && ((UINTN)Base1 < (UINTN)Base2 + Size2)) ||

+      (((UINTN)Base2 >= (UINTN)Base1) && ((UINTN)Base2 < (UINTN)Base1 + Size1))) {

+    return TRUE;

+  }

+  return FALSE;

+}

+

+/**

+  Returns if 2 Unicode strings are not overlapped.

+

+  @param  Str1   Start address of 1st Unicode string.

+  @param  Size1  The number of char in 1st Unicode string,

+                 including terminating null char.

+  @param  Str2   Start address of 2nd Unicode string.

+  @param  Size2  The number of char in 2nd Unicode string,

+                 including terminating null char.

+

+  @retval TRUE  2 Unicode strings are NOT overlapped.

+  @retval FALSE 2 Unicode strings are overlapped.

+**/

+BOOLEAN

+InternalSafeStringNoStrOverlap (

+  IN CHAR16  *Str1,

+  IN UINTN   Size1,

+  IN CHAR16  *Str2,

+  IN UINTN   Size2

+  )

+{

+  return !InternalSafeStringIsOverlap (Str1, Size1 * sizeof(CHAR16), Str2, Size2 * sizeof(CHAR16));

+}

+

+/**

+  Returns if 2 Ascii strings are not overlapped.

+

+  @param  Str1   Start address of 1st Ascii string.

+  @param  Size1  The number of char in 1st Ascii string,

+                 including terminating null char.

+  @param  Str2   Start address of 2nd Ascii string.

+  @param  Size2  The number of char in 2nd Ascii string,

+                 including terminating null char.

+

+  @retval TRUE  2 Ascii strings are NOT overlapped.

+  @retval FALSE 2 Ascii strings are overlapped.

+**/

+BOOLEAN

+InternalSafeStringNoAsciiStrOverlap (

+  IN CHAR8   *Str1,

+  IN UINTN   Size1,

+  IN CHAR8   *Str2,

+  IN UINTN   Size2

+  )

+{

+  return !InternalSafeStringIsOverlap (Str1, Size1, Str2, Size2);

+}

+

+/**

+  Returns the length of a Null-terminated Unicode string.

+

+  This function is similar as strlen_s defined in C11.

+

+  If String is not aligned on a 16-bit boundary, then ASSERT().

+

+  @param  String   A pointer to a Null-terminated Unicode string.

+  @param  MaxSize  The maximum number of Destination Unicode

+                   char, including terminating null char.

+

+  @retval 0        If String is NULL.

+  @retval MaxSize  If there is no null character in the first MaxSize characters of String.

+  @return The number of characters that percede the terminating null character.

+

+**/

+UINTN

+EFIAPI

+StrnLenS (

+  IN CONST CHAR16              *String,

+  IN UINTN                     MaxSize

+  )

+{

+  UINTN                             Length;

+

+  ASSERT (((UINTN) String & BIT0) == 0);

+

+  //

+  // If String is a null pointer or MaxSize is 0, then the StrnLenS function returns zero.

+  //

+  if ((String == NULL) || (MaxSize == 0)) {

+    return 0;

+  }

+

+  //

+  // Otherwise, the StrnLenS function returns the number of characters that precede the

+  // terminating null character. If there is no null character in the first MaxSize characters of

+  // String then StrnLenS returns MaxSize. At most the first MaxSize characters of String shall

+  // be accessed by StrnLenS.

+  //

+  Length = 0;

+  while (String[Length] != 0) {

+    if (Length >= MaxSize - 1) {

+      return MaxSize;

+    }

+    Length++;

+  }

+  return Length;

+}

+

+/**

+  Returns the size of a Null-terminated Unicode string in bytes, including the

+  Null terminator.

+

+  This function returns the size of the Null-terminated Unicode string

+  specified by String in bytes, including the Null terminator.

+

+  If String is not aligned on a 16-bit boundary, then ASSERT().

+

+  @param  String   A pointer to a Null-terminated Unicode string.

+  @param  MaxSize  The maximum number of Destination Unicode

+                   char, including the Null terminator.

+

+  @retval 0  If String is NULL.

+  @retval (sizeof (CHAR16) * (MaxSize + 1))

+             If there is no Null terminator in the first MaxSize characters of

+             String.

+  @return The size of the Null-terminated Unicode string in bytes, including

+          the Null terminator.

+

+**/

+UINTN

+EFIAPI

+StrnSizeS (

+  IN CONST CHAR16              *String,

+  IN UINTN                     MaxSize

+  )

+{

+  //

+  // If String is a null pointer, then the StrnSizeS function returns zero.

+  //

+  if (String == NULL) {

+    return 0;

+  }

+

+  //

+  // Otherwise, the StrnSizeS function returns the size of the Null-terminated

+  // Unicode string in bytes, including the Null terminator. If there is no

+  // Null terminator in the first MaxSize characters of String, then StrnSizeS

+  // returns (sizeof (CHAR16) * (MaxSize + 1)) to keep a consistent map with

+  // the StrnLenS function.

+  //

+  return (StrnLenS (String, MaxSize) + 1) * sizeof (*String);

+}

+

+/**

+  Copies the string pointed to by Source (including the terminating null char)

+  to the array pointed to by Destination.

+

+  This function is similar as strcpy_s defined in C11.

+

+  If Destination is not aligned on a 16-bit boundary, then ASSERT().

+  If Source is not aligned on a 16-bit boundary, then ASSERT().

+

+  If an error is returned, then the Destination is unmodified.

+

+  @param  Destination              A pointer to a Null-terminated Unicode string.

+  @param  DestMax                  The maximum number of Destination Unicode

+                                   char, including terminating null char.

+  @param  Source                   A pointer to a Null-terminated Unicode string.

+

+  @retval RETURN_SUCCESS           String is copied.

+  @retval RETURN_BUFFER_TOO_SMALL  If DestMax is NOT greater than StrLen(Source).

+  @retval RETURN_INVALID_PARAMETER If Destination is NULL.

+                                   If Source is NULL.

+                                   If PcdMaximumUnicodeStringLength is not zero,

+                                    and DestMax is greater than

+                                    PcdMaximumUnicodeStringLength.

+                                   If DestMax is 0.

+  @retval RETURN_ACCESS_DENIED     If Source and Destination overlap.

+**/

+RETURN_STATUS

+EFIAPI

+StrCpyS (

+  OUT CHAR16       *Destination,

+  IN  UINTN        DestMax,

+  IN  CONST CHAR16 *Source

+  )

+{

+  UINTN            SourceLen;

+

+  ASSERT (((UINTN) Destination & BIT0) == 0);

+  ASSERT (((UINTN) Source & BIT0) == 0);

+

+  //

+  // 1. Neither Destination nor Source shall be a null pointer.

+  //

+  SAFE_STRING_CONSTRAINT_CHECK ((Destination != NULL), RETURN_INVALID_PARAMETER);

+  SAFE_STRING_CONSTRAINT_CHECK ((Source != NULL), RETURN_INVALID_PARAMETER);

+

+  //

+  // 2. DestMax shall not be greater than RSIZE_MAX.

+  //

+  if (RSIZE_MAX != 0) {

+    SAFE_STRING_CONSTRAINT_CHECK ((DestMax <= RSIZE_MAX), RETURN_INVALID_PARAMETER);

+  }

+

+  //

+  // 3. DestMax shall not equal zero.

+  //

+  SAFE_STRING_CONSTRAINT_CHECK ((DestMax != 0), RETURN_INVALID_PARAMETER);

+

+  //

+  // 4. DestMax shall be greater than StrnLenS(Source, DestMax).

+  //

+  SourceLen = StrnLenS (Source, DestMax);

+  SAFE_STRING_CONSTRAINT_CHECK ((DestMax > SourceLen), RETURN_BUFFER_TOO_SMALL);

+

+  //

+  // 5. Copying shall not take place between objects that overlap.

+  //

+  SAFE_STRING_CONSTRAINT_CHECK (InternalSafeStringNoStrOverlap (Destination, DestMax, (CHAR16 *)Source, SourceLen + 1), RETURN_ACCESS_DENIED);

+

+  //

+  // The StrCpyS function copies the string pointed to by Source (including the terminating

+  // null character) into the array pointed to by Destination.

+  //

+  while (*Source != 0) {

+    *(Destination++) = *(Source++);

+  }

+  *Destination = 0;

+

+  return RETURN_SUCCESS;

+}

+

+/**

+  Copies not more than Length successive char from the string pointed to by

+  Source to the array pointed to by Destination. If no null char is copied from

+  Source, then Destination[Length] is always set to null.

+

+  This function is similar as strncpy_s defined in C11.

+

+  If Length > 0 and Destination is not aligned on a 16-bit boundary, then ASSERT().

+  If Length > 0 and Source is not aligned on a 16-bit boundary, then ASSERT().

+

+  If an error is returned, then the Destination is unmodified.

+

+  @param  Destination              A pointer to a Null-terminated Unicode string.

+  @param  DestMax                  The maximum number of Destination Unicode

+                                   char, including terminating null char.

+  @param  Source                   A pointer to a Null-terminated Unicode string.

+  @param  Length                   The maximum number of Unicode characters to copy.

+

+  @retval RETURN_SUCCESS           String is copied.

+  @retval RETURN_BUFFER_TOO_SMALL  If DestMax is NOT greater than

+                                   MIN(StrLen(Source), Length).

+  @retval RETURN_INVALID_PARAMETER If Destination is NULL.

+                                   If Source is NULL.

+                                   If PcdMaximumUnicodeStringLength is not zero,

+                                    and DestMax is greater than

+                                    PcdMaximumUnicodeStringLength.

+                                   If DestMax is 0.

+  @retval RETURN_ACCESS_DENIED     If Source and Destination overlap.

+**/

+RETURN_STATUS

+EFIAPI

+StrnCpyS (

+  OUT CHAR16       *Destination,

+  IN  UINTN        DestMax,

+  IN  CONST CHAR16 *Source,

+  IN  UINTN        Length

+  )

+{

+  UINTN            SourceLen;

+

+  ASSERT (((UINTN) Destination & BIT0) == 0);

+  ASSERT (((UINTN) Source & BIT0) == 0);

+

+  //

+  // 1. Neither Destination nor Source shall be a null pointer.

+  //

+  SAFE_STRING_CONSTRAINT_CHECK ((Destination != NULL), RETURN_INVALID_PARAMETER);

+  SAFE_STRING_CONSTRAINT_CHECK ((Source != NULL), RETURN_INVALID_PARAMETER);

+

+  //

+  // 2. Neither DestMax nor Length shall be greater than RSIZE_MAX

+  //

+  if (RSIZE_MAX != 0) {

+    SAFE_STRING_CONSTRAINT_CHECK ((DestMax <= RSIZE_MAX), RETURN_INVALID_PARAMETER);

+    SAFE_STRING_CONSTRAINT_CHECK ((Length <= RSIZE_MAX), RETURN_INVALID_PARAMETER);

+  }

+

+  //

+  // 3. DestMax shall not equal zero.

+  //

+  SAFE_STRING_CONSTRAINT_CHECK ((DestMax != 0), RETURN_INVALID_PARAMETER);

+

+  //

+  // 4. If Length is not less than DestMax, then DestMax shall be greater than StrnLenS(Source, DestMax).

+  //

+  SourceLen = StrnLenS (Source, MIN (DestMax, Length));

+  if (Length >= DestMax) {

+    SAFE_STRING_CONSTRAINT_CHECK ((DestMax > SourceLen), RETURN_BUFFER_TOO_SMALL);

+  }

+

+  //

+  // 5. Copying shall not take place between objects that overlap.

+  //

+  if (SourceLen > Length) {

+    SourceLen = Length;

+  }

+  SAFE_STRING_CONSTRAINT_CHECK (InternalSafeStringNoStrOverlap (Destination, DestMax, (CHAR16 *)Source, SourceLen + 1), RETURN_ACCESS_DENIED);

+

+  //

+  // The StrnCpyS function copies not more than Length successive characters (characters that

+  // follow a null character are not copied) from the array pointed to by Source to the array

+  // pointed to by Destination. If no null character was copied from Source, then Destination[Length] is set to a null

+  // character.

+  //

+  while ((SourceLen > 0) && (*Source != 0)) {

+    *(Destination++) = *(Source++);

+    SourceLen--;

+  }

+  *Destination = 0;

+

+  return RETURN_SUCCESS;

+}

+

+/**

+  Appends a copy of the string pointed to by Source (including the terminating

+  null char) to the end of the string pointed to by Destination.

+

+  This function is similar as strcat_s defined in C11.

+

+  If Destination is not aligned on a 16-bit boundary, then ASSERT().

+  If Source is not aligned on a 16-bit boundary, then ASSERT().

+

+  If an error is returned, then the Destination is unmodified.

+

+  @param  Destination              A pointer to a Null-terminated Unicode string.

+  @param  DestMax                  The maximum number of Destination Unicode

+                                   char, including terminating null char.

+  @param  Source                   A pointer to a Null-terminated Unicode string.

+

+  @retval RETURN_SUCCESS           String is appended.

+  @retval RETURN_BAD_BUFFER_SIZE   If DestMax is NOT greater than

+                                   StrLen(Destination).

+  @retval RETURN_BUFFER_TOO_SMALL  If (DestMax - StrLen(Destination)) is NOT

+                                   greater than StrLen(Source).

+  @retval RETURN_INVALID_PARAMETER If Destination is NULL.

+                                   If Source is NULL.

+                                   If PcdMaximumUnicodeStringLength is not zero,

+                                    and DestMax is greater than

+                                    PcdMaximumUnicodeStringLength.

+                                   If DestMax is 0.

+  @retval RETURN_ACCESS_DENIED     If Source and Destination overlap.

+**/

+RETURN_STATUS

+EFIAPI

+StrCatS (

+  IN OUT CHAR16       *Destination,

+  IN     UINTN        DestMax,

+  IN     CONST CHAR16 *Source

+  )

+{

+  UINTN               DestLen;

+  UINTN               CopyLen;

+  UINTN               SourceLen;

+

+  ASSERT (((UINTN) Destination & BIT0) == 0);

+  ASSERT (((UINTN) Source & BIT0) == 0);

+

+  //

+  // Let CopyLen denote the value DestMax - StrnLenS(Destination, DestMax) upon entry to StrCatS.

+  //

+  DestLen = StrnLenS (Destination, DestMax);

+  CopyLen = DestMax - DestLen;

+

+  //

+  // 1. Neither Destination nor Source shall be a null pointer.

+  //

+  SAFE_STRING_CONSTRAINT_CHECK ((Destination != NULL), RETURN_INVALID_PARAMETER);

+  SAFE_STRING_CONSTRAINT_CHECK ((Source != NULL), RETURN_INVALID_PARAMETER);

+

+  //

+  // 2. DestMax shall not be greater than RSIZE_MAX.

+  //

+  if (RSIZE_MAX != 0) {

+    SAFE_STRING_CONSTRAINT_CHECK ((DestMax <= RSIZE_MAX), RETURN_INVALID_PARAMETER);

+  }

+

+  //

+  // 3. DestMax shall not equal zero.

+  //

+  SAFE_STRING_CONSTRAINT_CHECK ((DestMax != 0), RETURN_INVALID_PARAMETER);

+

+  //

+  // 4. CopyLen shall not equal zero.

+  //

+  SAFE_STRING_CONSTRAINT_CHECK ((CopyLen != 0), RETURN_BAD_BUFFER_SIZE);

+

+  //

+  // 5. CopyLen shall be greater than StrnLenS(Source, CopyLen).

+  //

+  SourceLen = StrnLenS (Source, CopyLen);

+  SAFE_STRING_CONSTRAINT_CHECK ((CopyLen > SourceLen), RETURN_BUFFER_TOO_SMALL);

+

+  //

+  // 6. Copying shall not take place between objects that overlap.

+  //

+  SAFE_STRING_CONSTRAINT_CHECK (InternalSafeStringNoStrOverlap (Destination, DestMax, (CHAR16 *)Source, SourceLen + 1), RETURN_ACCESS_DENIED);

+

+  //

+  // The StrCatS function appends a copy of the string pointed to by Source (including the

+  // terminating null character) to the end of the string pointed to by Destination. The initial character

+  // from Source overwrites the null character at the end of Destination.

+  //

+  Destination = Destination + DestLen;

+  while (*Source != 0) {

+    *(Destination++) = *(Source++);

+  }

+  *Destination = 0;

+

+  return RETURN_SUCCESS;

+}

+

+/**

+  Appends not more than Length successive char from the string pointed to by

+  Source to the end of the string pointed to by Destination. If no null char is

+  copied from Source, then Destination[StrLen(Destination) + Length] is always

+  set to null.

+

+  This function is similar as strncat_s defined in C11.

+

+  If Destination is not aligned on a 16-bit boundary, then ASSERT().

+  If Source is not aligned on a 16-bit boundary, then ASSERT().

+

+  If an error is returned, then the Destination is unmodified.

+

+  @param  Destination              A pointer to a Null-terminated Unicode string.

+  @param  DestMax                  The maximum number of Destination Unicode

+                                   char, including terminating null char.

+  @param  Source                   A pointer to a Null-terminated Unicode string.

+  @param  Length                   The maximum number of Unicode characters to copy.

+

+  @retval RETURN_SUCCESS           String is appended.

+  @retval RETURN_BAD_BUFFER_SIZE   If DestMax is NOT greater than

+                                   StrLen(Destination).

+  @retval RETURN_BUFFER_TOO_SMALL  If (DestMax - StrLen(Destination)) is NOT

+                                   greater than MIN(StrLen(Source), Length).

+  @retval RETURN_INVALID_PARAMETER If Destination is NULL.

+                                   If Source is NULL.

+                                   If PcdMaximumUnicodeStringLength is not zero,

+                                    and DestMax is greater than

+                                    PcdMaximumUnicodeStringLength.

+                                   If DestMax is 0.

+  @retval RETURN_ACCESS_DENIED     If Source and Destination overlap.

+**/

+RETURN_STATUS

+EFIAPI

+StrnCatS (

+  IN OUT CHAR16       *Destination,

+  IN     UINTN        DestMax,

+  IN     CONST CHAR16 *Source,

+  IN     UINTN        Length

+  )

+{

+  UINTN               DestLen;

+  UINTN               CopyLen;

+  UINTN               SourceLen;

+

+  ASSERT (((UINTN) Destination & BIT0) == 0);

+  ASSERT (((UINTN) Source & BIT0) == 0);

+

+  //

+  // Let CopyLen denote the value DestMax - StrnLenS(Destination, DestMax) upon entry to StrnCatS.

+  //

+  DestLen = StrnLenS (Destination, DestMax);

+  CopyLen = DestMax - DestLen;

+

+  //

+  // 1. Neither Destination nor Source shall be a null pointer.

+  //

+  SAFE_STRING_CONSTRAINT_CHECK ((Destination != NULL), RETURN_INVALID_PARAMETER);

+  SAFE_STRING_CONSTRAINT_CHECK ((Source != NULL), RETURN_INVALID_PARAMETER);

+

+  //

+  // 2. Neither DestMax nor Length shall be greater than RSIZE_MAX.

+  //

+  if (RSIZE_MAX != 0) {

+    SAFE_STRING_CONSTRAINT_CHECK ((DestMax <= RSIZE_MAX), RETURN_INVALID_PARAMETER);

+    SAFE_STRING_CONSTRAINT_CHECK ((Length <= RSIZE_MAX), RETURN_INVALID_PARAMETER);

+  }

+

+  //

+  // 3. DestMax shall not equal zero.

+  //

+  SAFE_STRING_CONSTRAINT_CHECK ((DestMax != 0), RETURN_INVALID_PARAMETER);

+

+  //

+  // 4. CopyLen shall not equal zero.

+  //

+  SAFE_STRING_CONSTRAINT_CHECK ((CopyLen != 0), RETURN_BAD_BUFFER_SIZE);

+

+  //

+  // 5. If Length is not less than CopyLen, then CopyLen shall be greater than StrnLenS(Source, CopyLen).

+  //

+  SourceLen = StrnLenS (Source, MIN (CopyLen, Length));

+  if (Length >= CopyLen) {

+    SAFE_STRING_CONSTRAINT_CHECK ((CopyLen > SourceLen), RETURN_BUFFER_TOO_SMALL);

+  }

+

+  //

+  // 6. Copying shall not take place between objects that overlap.

+  //

+  if (SourceLen > Length) {

+    SourceLen = Length;

+  }

+  SAFE_STRING_CONSTRAINT_CHECK (InternalSafeStringNoStrOverlap (Destination, DestMax, (CHAR16 *)Source, SourceLen + 1), RETURN_ACCESS_DENIED);

+

+  //

+  // The StrnCatS function appends not more than Length successive characters (characters

+  // that follow a null character are not copied) from the array pointed to by Source to the end of

+  // the string pointed to by Destination. The initial character from Source overwrites the null character at

+  // the end of Destination. If no null character was copied from Source, then Destination[DestMax-CopyLen+Length] is set to

+  // a null character.

+  //

+  Destination = Destination + DestLen;

+  while ((SourceLen > 0) && (*Source != 0)) {

+    *(Destination++) = *(Source++);

+    SourceLen--;

+  }

+  *Destination = 0;

+

+  return RETURN_SUCCESS;

+}

+

+/**

+  Convert a Null-terminated Unicode decimal string to a value of type UINTN.

+

+  This function outputs a value of type UINTN by interpreting the contents of

+  the Unicode string specified by String as a decimal number. The format of the

+  input Unicode string String is:

+

+                  [spaces] [decimal digits].

+

+  The valid decimal digit character is in the range [0-9]. The function will

+  ignore the pad space, which includes spaces or tab characters, before

+  [decimal digits]. The running zero in the beginning of [decimal digits] will

+  be ignored. Then, the function stops at the first character that is a not a

+  valid decimal character or a Null-terminator, whichever one comes first.

+

+  If String is not aligned in a 16-bit boundary, then ASSERT().

+

+  If String has no valid decimal digits in the above format, then 0 is stored

+  at the location pointed to by Data.

+  If the number represented by String exceeds the range defined by UINTN, then

+  MAX_UINTN is stored at the location pointed to by Data.

+

+  If EndPointer is not NULL, a pointer to the character that stopped the scan

+  is stored at the location pointed to by EndPointer. If String has no valid

+  decimal digits right after the optional pad spaces, the value of String is

+  stored at the location pointed to by EndPointer.

+

+  @param  String                   Pointer to a Null-terminated Unicode string.

+  @param  EndPointer               Pointer to character that stops scan.

+  @param  Data                     Pointer to the converted value.

+

+  @retval RETURN_SUCCESS           Value is translated from String.

+  @retval RETURN_INVALID_PARAMETER If String is NULL.

+                                   If Data is NULL.

+                                   If PcdMaximumUnicodeStringLength is not

+                                   zero, and String contains more than

+                                   PcdMaximumUnicodeStringLength Unicode

+                                   characters, not including the

+                                   Null-terminator.

+  @retval RETURN_UNSUPPORTED       If the number represented by String exceeds

+                                   the range defined by UINTN.

+

+**/

+RETURN_STATUS

+EFIAPI

+StrDecimalToUintnS (

+  IN  CONST CHAR16             *String,

+  OUT       CHAR16             **EndPointer,  OPTIONAL

+  OUT       UINTN              *Data

+  )

+{

+  ASSERT (((UINTN) String & BIT0) == 0);

+

+  //

+  // 1. Neither String nor Data shall be a null pointer.

+  //

+  SAFE_STRING_CONSTRAINT_CHECK ((String != NULL), RETURN_INVALID_PARAMETER);

+  SAFE_STRING_CONSTRAINT_CHECK ((Data != NULL), RETURN_INVALID_PARAMETER);

+

+  //

+  // 2. The length of String shall not be greater than RSIZE_MAX.

+  //

+  if (RSIZE_MAX != 0) {

+    SAFE_STRING_CONSTRAINT_CHECK ((StrnLenS (String, RSIZE_MAX + 1) <= RSIZE_MAX), RETURN_INVALID_PARAMETER);

+  }

+

+  if (EndPointer != NULL) {

+    *EndPointer = (CHAR16 *) String;

+  }

+

+  //

+  // Ignore the pad spaces (space or tab)

+  //

+  while ((*String == L' ') || (*String == L'\t')) {

+    String++;

+  }

+

+  //

+  // Ignore leading Zeros after the spaces

+  //

+  while (*String == L'0') {

+    String++;

+  }

+

+  *Data = 0;

+

+  while (InternalIsDecimalDigitCharacter (*String)) {

+    //

+    // If the number represented by String overflows according to the range

+    // defined by UINTN, then MAX_UINTN is stored in *Data and

+    // RETURN_UNSUPPORTED is returned.

+    //

+    if (*Data > ((MAX_UINTN - (*String - L'0')) / 10)) {

+      *Data = MAX_UINTN;

+      if (EndPointer != NULL) {

+        *EndPointer = (CHAR16 *) String;

+      }

+      return RETURN_UNSUPPORTED;

+    }

+

+    *Data = *Data * 10 + (*String - L'0');

+    String++;

+  }

+

+  if (EndPointer != NULL) {

+    *EndPointer = (CHAR16 *) String;

+  }

+  return RETURN_SUCCESS;

+}

+

+/**

+  Convert a Null-terminated Unicode decimal string to a value of type UINT64.

+

+  This function outputs a value of type UINT64 by interpreting the contents of

+  the Unicode string specified by String as a decimal number. The format of the

+  input Unicode string String is:

+

+                  [spaces] [decimal digits].

+

+  The valid decimal digit character is in the range [0-9]. The function will

+  ignore the pad space, which includes spaces or tab characters, before

+  [decimal digits]. The running zero in the beginning of [decimal digits] will

+  be ignored. Then, the function stops at the first character that is a not a

+  valid decimal character or a Null-terminator, whichever one comes first.

+

+  If String is not aligned in a 16-bit boundary, then ASSERT().

+

+  If String has no valid decimal digits in the above format, then 0 is stored

+  at the location pointed to by Data.

+  If the number represented by String exceeds the range defined by UINT64, then

+  MAX_UINT64 is stored at the location pointed to by Data.

+

+  If EndPointer is not NULL, a pointer to the character that stopped the scan

+  is stored at the location pointed to by EndPointer. If String has no valid

+  decimal digits right after the optional pad spaces, the value of String is

+  stored at the location pointed to by EndPointer.

+

+  @param  String                   Pointer to a Null-terminated Unicode string.

+  @param  EndPointer               Pointer to character that stops scan.

+  @param  Data                     Pointer to the converted value.

+

+  @retval RETURN_SUCCESS           Value is translated from String.

+  @retval RETURN_INVALID_PARAMETER If String is NULL.

+                                   If Data is NULL.

+                                   If PcdMaximumUnicodeStringLength is not

+                                   zero, and String contains more than

+                                   PcdMaximumUnicodeStringLength Unicode

+                                   characters, not including the

+                                   Null-terminator.

+  @retval RETURN_UNSUPPORTED       If the number represented by String exceeds

+                                   the range defined by UINT64.

+

+**/

+RETURN_STATUS

+EFIAPI

+StrDecimalToUint64S (

+  IN  CONST CHAR16             *String,

+  OUT       CHAR16             **EndPointer,  OPTIONAL

+  OUT       UINT64             *Data

+  )

+{

+  ASSERT (((UINTN) String & BIT0) == 0);

+

+  //

+  // 1. Neither String nor Data shall be a null pointer.

+  //

+  SAFE_STRING_CONSTRAINT_CHECK ((String != NULL), RETURN_INVALID_PARAMETER);

+  SAFE_STRING_CONSTRAINT_CHECK ((Data != NULL), RETURN_INVALID_PARAMETER);

+

+  //

+  // 2. The length of String shall not be greater than RSIZE_MAX.

+  //

+  if (RSIZE_MAX != 0) {

+    SAFE_STRING_CONSTRAINT_CHECK ((StrnLenS (String, RSIZE_MAX + 1) <= RSIZE_MAX), RETURN_INVALID_PARAMETER);

+  }

+

+  if (EndPointer != NULL) {

+    *EndPointer = (CHAR16 *) String;

+  }

+

+  //

+  // Ignore the pad spaces (space or tab)

+  //

+  while ((*String == L' ') || (*String == L'\t')) {

+    String++;

+  }

+

+  //

+  // Ignore leading Zeros after the spaces

+  //

+  while (*String == L'0') {

+    String++;

+  }

+

+  *Data = 0;

+

+  while (InternalIsDecimalDigitCharacter (*String)) {

+    //

+    // If the number represented by String overflows according to the range

+    // defined by UINT64, then MAX_UINT64 is stored in *Data and

+    // RETURN_UNSUPPORTED is returned.

+    //

+    if (*Data > DivU64x32 (MAX_UINT64 - (*String - L'0'), 10)) {

+      *Data = MAX_UINT64;

+      if (EndPointer != NULL) {

+        *EndPointer = (CHAR16 *) String;

+      }

+      return RETURN_UNSUPPORTED;

+    }

+

+    *Data = MultU64x32 (*Data, 10) + (*String - L'0');

+    String++;

+  }

+

+  if (EndPointer != NULL) {

+    *EndPointer = (CHAR16 *) String;

+  }

+  return RETURN_SUCCESS;

+}

+

+/**

+  Convert a Null-terminated Unicode hexadecimal string to a value of type

+  UINTN.

+

+  This function outputs a value of type UINTN by interpreting the contents of

+  the Unicode string specified by String as a hexadecimal number. The format of

+  the input Unicode string String is:

+

+                  [spaces][zeros][x][hexadecimal digits].

+

+  The valid hexadecimal digit character is in the range [0-9], [a-f] and [A-F].

+  The prefix "0x" is optional. Both "x" and "X" is allowed in "0x" prefix.

+  If "x" appears in the input string, it must be prefixed with at least one 0.

+  The function will ignore the pad space, which includes spaces or tab

+  characters, before [zeros], [x] or [hexadecimal digit]. The running zero

+  before [x] or [hexadecimal digit] will be ignored. Then, the decoding starts

+  after [x] or the first valid hexadecimal digit. Then, the function stops at

+  the first character that is a not a valid hexadecimal character or NULL,

+  whichever one comes first.

+

+  If String is not aligned in a 16-bit boundary, then ASSERT().

+

+  If String has no valid hexadecimal digits in the above format, then 0 is

+  stored at the location pointed to by Data.

+  If the number represented by String exceeds the range defined by UINTN, then

+  MAX_UINTN is stored at the location pointed to by Data.

+

+  If EndPointer is not NULL, a pointer to the character that stopped the scan

+  is stored at the location pointed to by EndPointer. If String has no valid

+  hexadecimal digits right after the optional pad spaces, the value of String

+  is stored at the location pointed to by EndPointer.

+

+  @param  String                   Pointer to a Null-terminated Unicode string.

+  @param  EndPointer               Pointer to character that stops scan.

+  @param  Data                     Pointer to the converted value.

+

+  @retval RETURN_SUCCESS           Value is translated from String.

+  @retval RETURN_INVALID_PARAMETER If String is NULL.

+                                   If Data is NULL.

+                                   If PcdMaximumUnicodeStringLength is not

+                                   zero, and String contains more than

+                                   PcdMaximumUnicodeStringLength Unicode

+                                   characters, not including the

+                                   Null-terminator.

+  @retval RETURN_UNSUPPORTED       If the number represented by String exceeds

+                                   the range defined by UINTN.

+

+**/

+RETURN_STATUS

+EFIAPI

+StrHexToUintnS (

+  IN  CONST CHAR16             *String,

+  OUT       CHAR16             **EndPointer,  OPTIONAL

+  OUT       UINTN              *Data

+  )

+{

+  ASSERT (((UINTN) String & BIT0) == 0);

+

+  //

+  // 1. Neither String nor Data shall be a null pointer.

+  //

+  SAFE_STRING_CONSTRAINT_CHECK ((String != NULL), RETURN_INVALID_PARAMETER);

+  SAFE_STRING_CONSTRAINT_CHECK ((Data != NULL), RETURN_INVALID_PARAMETER);

+

+  //

+  // 2. The length of String shall not be greater than RSIZE_MAX.

+  //

+  if (RSIZE_MAX != 0) {

+    SAFE_STRING_CONSTRAINT_CHECK ((StrnLenS (String, RSIZE_MAX + 1) <= RSIZE_MAX), RETURN_INVALID_PARAMETER);

+  }

+

+  if (EndPointer != NULL) {

+    *EndPointer = (CHAR16 *) String;

+  }

+

+  //

+  // Ignore the pad spaces (space or tab)

+  //

+  while ((*String == L' ') || (*String == L'\t')) {

+    String++;

+  }

+

+  //

+  // Ignore leading Zeros after the spaces

+  //

+  while (*String == L'0') {

+    String++;

+  }

+

+  if (CharToUpper (*String) == L'X') {

+    if (*(String - 1) != L'0') {

+      *Data = 0;

+      return RETURN_SUCCESS;

+    }

+    //

+    // Skip the 'X'

+    //

+    String++;

+  }

+

+  *Data = 0;

+

+  while (InternalIsHexaDecimalDigitCharacter (*String)) {

+    //

+    // If the number represented by String overflows according to the range

+    // defined by UINTN, then MAX_UINTN is stored in *Data and

+    // RETURN_UNSUPPORTED is returned.

+    //

+    if (*Data > ((MAX_UINTN - InternalHexCharToUintn (*String)) >> 4)) {

+      *Data = MAX_UINTN;

+      if (EndPointer != NULL) {

+        *EndPointer = (CHAR16 *) String;

+      }

+      return RETURN_UNSUPPORTED;

+    }

+

+    *Data = (*Data << 4) + InternalHexCharToUintn (*String);

+    String++;

+  }

+

+  if (EndPointer != NULL) {

+    *EndPointer = (CHAR16 *) String;

+  }

+  return RETURN_SUCCESS;

+}

+

+/**

+  Convert a Null-terminated Unicode hexadecimal string to a value of type

+  UINT64.

+

+  This function outputs a value of type UINT64 by interpreting the contents of

+  the Unicode string specified by String as a hexadecimal number. The format of

+  the input Unicode string String is:

+

+                  [spaces][zeros][x][hexadecimal digits].

+

+  The valid hexadecimal digit character is in the range [0-9], [a-f] and [A-F].

+  The prefix "0x" is optional. Both "x" and "X" is allowed in "0x" prefix.

+  If "x" appears in the input string, it must be prefixed with at least one 0.

+  The function will ignore the pad space, which includes spaces or tab

+  characters, before [zeros], [x] or [hexadecimal digit]. The running zero

+  before [x] or [hexadecimal digit] will be ignored. Then, the decoding starts

+  after [x] or the first valid hexadecimal digit. Then, the function stops at

+  the first character that is a not a valid hexadecimal character or NULL,

+  whichever one comes first.

+

+  If String is not aligned in a 16-bit boundary, then ASSERT().

+

+  If String has no valid hexadecimal digits in the above format, then 0 is

+  stored at the location pointed to by Data.

+  If the number represented by String exceeds the range defined by UINT64, then

+  MAX_UINT64 is stored at the location pointed to by Data.

+

+  If EndPointer is not NULL, a pointer to the character that stopped the scan

+  is stored at the location pointed to by EndPointer. If String has no valid

+  hexadecimal digits right after the optional pad spaces, the value of String

+  is stored at the location pointed to by EndPointer.

+

+  @param  String                   Pointer to a Null-terminated Unicode string.

+  @param  EndPointer               Pointer to character that stops scan.

+  @param  Data                     Pointer to the converted value.

+

+  @retval RETURN_SUCCESS           Value is translated from String.

+  @retval RETURN_INVALID_PARAMETER If String is NULL.

+                                   If Data is NULL.

+                                   If PcdMaximumUnicodeStringLength is not

+                                   zero, and String contains more than

+                                   PcdMaximumUnicodeStringLength Unicode

+                                   characters, not including the

+                                   Null-terminator.

+  @retval RETURN_UNSUPPORTED       If the number represented by String exceeds

+                                   the range defined by UINT64.

+

+**/

+RETURN_STATUS

+EFIAPI

+StrHexToUint64S (

+  IN  CONST CHAR16             *String,

+  OUT       CHAR16             **EndPointer,  OPTIONAL

+  OUT       UINT64             *Data

+  )

+{

+  ASSERT (((UINTN) String & BIT0) == 0);

+

+  //

+  // 1. Neither String nor Data shall be a null pointer.

+  //

+  SAFE_STRING_CONSTRAINT_CHECK ((String != NULL), RETURN_INVALID_PARAMETER);

+  SAFE_STRING_CONSTRAINT_CHECK ((Data != NULL), RETURN_INVALID_PARAMETER);

+

+  //

+  // 2. The length of String shall not be greater than RSIZE_MAX.

+  //

+  if (RSIZE_MAX != 0) {

+    SAFE_STRING_CONSTRAINT_CHECK ((StrnLenS (String, RSIZE_MAX + 1) <= RSIZE_MAX), RETURN_INVALID_PARAMETER);

+  }

+

+  if (EndPointer != NULL) {

+    *EndPointer = (CHAR16 *) String;

+  }

+

+  //

+  // Ignore the pad spaces (space or tab)

+  //

+  while ((*String == L' ') || (*String == L'\t')) {

+    String++;

+  }

+

+  //

+  // Ignore leading Zeros after the spaces

+  //

+  while (*String == L'0') {

+    String++;

+  }

+

+  if (CharToUpper (*String) == L'X') {

+    if (*(String - 1) != L'0') {

+      *Data = 0;

+      return RETURN_SUCCESS;

+    }

+    //

+    // Skip the 'X'

+    //

+    String++;

+  }

+

+  *Data = 0;

+

+  while (InternalIsHexaDecimalDigitCharacter (*String)) {

+    //

+    // If the number represented by String overflows according to the range

+    // defined by UINT64, then MAX_UINT64 is stored in *Data and

+    // RETURN_UNSUPPORTED is returned.

+    //

+    if (*Data > RShiftU64 (MAX_UINT64 - InternalHexCharToUintn (*String), 4)) {

+      *Data = MAX_UINT64;

+      if (EndPointer != NULL) {

+        *EndPointer = (CHAR16 *) String;

+      }

+      return RETURN_UNSUPPORTED;

+    }

+

+    *Data = LShiftU64 (*Data, 4) + InternalHexCharToUintn (*String);

+    String++;

+  }

+

+  if (EndPointer != NULL) {

+    *EndPointer = (CHAR16 *) String;

+  }

+  return RETURN_SUCCESS;

+}

+

+/**

+  Convert a Null-terminated Unicode string to IPv6 address and prefix length.

+

+  This function outputs a value of type IPv6_ADDRESS and may output a value

+  of type UINT8 by interpreting the contents of the Unicode string specified

+  by String. The format of the input Unicode string String is as follows:

+

+                  X:X:X:X:X:X:X:X[/P]

+

+  X contains one to four hexadecimal digit characters in the range [0-9], [a-f] and

+  [A-F]. X is converted to a value of type UINT16, whose low byte is stored in low

+  memory address and high byte is stored in high memory address. P contains decimal

+  digit characters in the range [0-9]. The running zero in the beginning of P will

+  be ignored. /P is optional.

+

+  When /P is not in the String, the function stops at the first character that is

+  not a valid hexadecimal digit character after eight X's are converted.

+

+  When /P is in the String, the function stops at the first character that is not

+  a valid decimal digit character after P is converted.

+

+  "::" can be used to compress one or more groups of X when X contains only 0.

+  The "::" can only appear once in the String.

+

+  If String is not aligned in a 16-bit boundary, then ASSERT().

+

+  If EndPointer is not NULL and Address is translated from String, a pointer

+  to the character that stopped the scan is stored at the location pointed to

+  by EndPointer.

+

+  @param  String                   Pointer to a Null-terminated Unicode string.

+  @param  EndPointer               Pointer to character that stops scan.

+  @param  Address                  Pointer to the converted IPv6 address.

+  @param  PrefixLength             Pointer to the converted IPv6 address prefix

+                                   length. MAX_UINT8 is returned when /P is

+                                   not in the String.

+

+  @retval RETURN_SUCCESS           Address is translated from String.

+  @retval RETURN_INVALID_PARAMETER If String is NULL.

+                                   If Data is NULL.

+  @retval RETURN_UNSUPPORTED       If X contains more than four hexadecimal

+                                    digit characters.

+                                   If String contains "::" and number of X

+                                    is not less than 8.

+                                   If P starts with character that is not a

+                                    valid decimal digit character.

+                                   If the decimal number converted from P

+                                    exceeds 128.

+

+**/

+RETURN_STATUS

+EFIAPI

+StrToIpv6Address (

+  IN  CONST CHAR16       *String,

+  OUT CHAR16             **EndPointer, OPTIONAL

+  OUT IPv6_ADDRESS       *Address,

+  OUT UINT8              *PrefixLength OPTIONAL

+  )

+{

+  RETURN_STATUS          Status;

+  UINTN                  AddressIndex;

+  UINTN                  Uintn;

+  IPv6_ADDRESS           LocalAddress;

+  UINT8                  LocalPrefixLength;

+  CONST CHAR16           *Pointer;

+  CHAR16                 *End;

+  UINTN                  CompressStart;

+  BOOLEAN                ExpectPrefix;

+

+  LocalPrefixLength = MAX_UINT8;

+  CompressStart     = ARRAY_SIZE (Address->Addr);

+  ExpectPrefix      = FALSE;

+

+  ASSERT (((UINTN) String & BIT0) == 0);

+

+  //

+  // 1. None of String or Guid shall be a null pointer.

+  //

+  SAFE_STRING_CONSTRAINT_CHECK ((String != NULL), RETURN_INVALID_PARAMETER);

+  SAFE_STRING_CONSTRAINT_CHECK ((Address != NULL), RETURN_INVALID_PARAMETER);

+

+  for (Pointer = String, AddressIndex = 0; AddressIndex < ARRAY_SIZE (Address->Addr) + 1;) {

+    if (!InternalIsHexaDecimalDigitCharacter (*Pointer)) {

+      if (*Pointer != L':') {

+        //

+        // ":" or "/" should be followed by digit characters.

+        //

+        return RETURN_UNSUPPORTED;

+      }

+

+      //

+      // Meet second ":" after previous ":" or "/"

+      // or meet first ":" in the beginning of String.

+      //

+      if (ExpectPrefix) {

+        //

+        // ":" shall not be after "/"

+        //

+        return RETURN_UNSUPPORTED;

+      }

+

+      if (CompressStart != ARRAY_SIZE (Address->Addr) || AddressIndex == ARRAY_SIZE (Address->Addr)) {

+        //

+        // "::" can only appear once.

+        // "::" can only appear when address is not full length.

+        //

+        return RETURN_UNSUPPORTED;

+      } else {

+        //

+        // Remember the start of zero compressing.

+        //

+        CompressStart = AddressIndex;

+        Pointer++;

+

+        if (CompressStart == 0) {

+          if (*Pointer != L':') {

+            //

+            // Single ":" shall not be in the beginning of String.

+            //

+            return RETURN_UNSUPPORTED;

+          }

+          Pointer++;

+        }

+      }

+    }

+

+    if (!InternalIsHexaDecimalDigitCharacter (*Pointer)) {

+      if (*Pointer == L'/') {

+        //

+        // Might be optional "/P" after "::".

+        //

+        if (CompressStart != AddressIndex) {

+          return RETURN_UNSUPPORTED;

+        }

+      } else {

+        break;

+      }

+    } else {

+      if (!ExpectPrefix) {

+        //

+        // Get X.

+        //

+        Status = StrHexToUintnS (Pointer, &End, &Uintn);

+        if (RETURN_ERROR (Status) || End - Pointer > 4) {

+          //

+          // Number of hexadecimal digit characters is no more than 4.

+          //

+          return RETURN_UNSUPPORTED;

+        }

+        Pointer = End;

+        //

+        // Uintn won't exceed MAX_UINT16 if number of hexadecimal digit characters is no more than 4.

+        //

+        ASSERT (AddressIndex + 1 < ARRAY_SIZE (Address->Addr));

+        LocalAddress.Addr[AddressIndex] = (UINT8) ((UINT16) Uintn >> 8);

+        LocalAddress.Addr[AddressIndex + 1] = (UINT8) Uintn;

+        AddressIndex += 2;

+      } else {

+        //

+        // Get P, then exit the loop.

+        //

+        Status = StrDecimalToUintnS (Pointer, &End, &Uintn);

+        if (RETURN_ERROR (Status) || End == Pointer || Uintn > 128) {

+          //

+          // Prefix length should not exceed 128.

+          //

+          return RETURN_UNSUPPORTED;

+        }

+        LocalPrefixLength = (UINT8) Uintn;

+        Pointer = End;

+        break;

+      }

+    }

+

+    //

+    // Skip ':' or "/"

+    //

+    if (*Pointer == L'/') {

+      ExpectPrefix = TRUE;

+    } else if (*Pointer == L':') {

+      if (AddressIndex == ARRAY_SIZE (Address->Addr)) {

+        //

+        // Meet additional ":" after all 8 16-bit address

+        //

+        break;

+      }

+    } else {

+      //

+      // Meet other character that is not "/" or ":" after all 8 16-bit address

+      //

+      break;

+    }

+    Pointer++;

+  }

+

+  if ((AddressIndex == ARRAY_SIZE (Address->Addr) && CompressStart != ARRAY_SIZE (Address->Addr)) ||

+    (AddressIndex != ARRAY_SIZE (Address->Addr) && CompressStart == ARRAY_SIZE (Address->Addr))

+      ) {

+    //

+    // Full length of address shall not have compressing zeros.

+    // Non-full length of address shall have compressing zeros.

+    //

+    return RETURN_UNSUPPORTED;

+  }

+  CopyMem (&Address->Addr[0], &LocalAddress.Addr[0], CompressStart);

+  ZeroMem (&Address->Addr[CompressStart], ARRAY_SIZE (Address->Addr) - AddressIndex);

+  if (AddressIndex > CompressStart) {

+    CopyMem (

+      &Address->Addr[CompressStart + ARRAY_SIZE (Address->Addr) - AddressIndex],

+      &LocalAddress.Addr[CompressStart],

+      AddressIndex - CompressStart

+      );

+  }

+

+  if (PrefixLength != NULL) {

+    *PrefixLength = LocalPrefixLength;

+  }

+  if (EndPointer != NULL) {

+    *EndPointer = (CHAR16 *) Pointer;

+  }

+

+  return RETURN_SUCCESS;

+}

+

+/**

+  Convert a Null-terminated Unicode string to IPv4 address and prefix length.

+

+  This function outputs a value of type IPv4_ADDRESS and may output a value

+  of type UINT8 by interpreting the contents of the Unicode string specified

+  by String. The format of the input Unicode string String is as follows:

+

+                  D.D.D.D[/P]

+

+  D and P are decimal digit characters in the range [0-9]. The running zero in

+  the beginning of D and P will be ignored. /P is optional.

+

+  When /P is not in the String, the function stops at the first character that is

+  not a valid decimal digit character after four D's are converted.

+

+  When /P is in the String, the function stops at the first character that is not

+  a valid decimal digit character after P is converted.

+

+  If String is not aligned in a 16-bit boundary, then ASSERT().

+

+  If EndPointer is not NULL and Address is translated from String, a pointer

+  to the character that stopped the scan is stored at the location pointed to

+  by EndPointer.

+

+  @param  String                   Pointer to a Null-terminated Unicode string.

+  @param  EndPointer               Pointer to character that stops scan.

+  @param  Address                  Pointer to the converted IPv4 address.

+  @param  PrefixLength             Pointer to the converted IPv4 address prefix

+                                   length. MAX_UINT8 is returned when /P is

+                                   not in the String.

+

+  @retval RETURN_SUCCESS           Address is translated from String.

+  @retval RETURN_INVALID_PARAMETER If String is NULL.

+                                   If Data is NULL.

+  @retval RETURN_UNSUPPORTED       If String is not in the correct format.

+                                   If any decimal number converted from D

+                                    exceeds 255.

+                                   If the decimal number converted from P

+                                    exceeds 32.

+

+**/

+RETURN_STATUS

+EFIAPI

+StrToIpv4Address (

+  IN  CONST CHAR16       *String,

+  OUT CHAR16             **EndPointer, OPTIONAL

+  OUT IPv4_ADDRESS       *Address,

+  OUT UINT8              *PrefixLength OPTIONAL

+  )

+{

+  RETURN_STATUS          Status;

+  UINTN                  AddressIndex;

+  UINTN                  Uintn;

+  IPv4_ADDRESS           LocalAddress;

+  UINT8                  LocalPrefixLength;

+  CHAR16                 *Pointer;

+

+  LocalPrefixLength = MAX_UINT8;

+

+  ASSERT (((UINTN) String & BIT0) == 0);

+

+  //

+  // 1. None of String or Guid shall be a null pointer.

+  //

+  SAFE_STRING_CONSTRAINT_CHECK ((String != NULL), RETURN_INVALID_PARAMETER);

+  SAFE_STRING_CONSTRAINT_CHECK ((Address != NULL), RETURN_INVALID_PARAMETER);

+

+  for (Pointer = (CHAR16 *) String, AddressIndex = 0; AddressIndex < ARRAY_SIZE (Address->Addr) + 1;) {

+    if (!InternalIsDecimalDigitCharacter (*Pointer)) {

+      //

+      // D or P contains invalid characters.

+      //

+      break;

+    }

+

+    //

+    // Get D or P.

+    //

+    Status = StrDecimalToUintnS ((CONST CHAR16 *) Pointer, &Pointer, &Uintn);

+    if (RETURN_ERROR (Status)) {

+      return RETURN_UNSUPPORTED;

+    }

+    if (AddressIndex == ARRAY_SIZE (Address->Addr)) {

+      //

+      // It's P.

+      //

+      if (Uintn > 32) {

+        return RETURN_UNSUPPORTED;

+      }

+      LocalPrefixLength = (UINT8) Uintn;

+    } else {

+      //

+      // It's D.

+      //

+      if (Uintn > MAX_UINT8) {

+        return RETURN_UNSUPPORTED;

+      }

+      LocalAddress.Addr[AddressIndex] = (UINT8) Uintn;

+      AddressIndex++;

+    }

+

+    //

+    // Check the '.' or '/', depending on the AddressIndex.

+    //

+    if (AddressIndex == ARRAY_SIZE (Address->Addr)) {

+      if (*Pointer == L'/') {

+        //

+        // '/P' is in the String.

+        // Skip "/" and get P in next loop.

+        //

+        Pointer++;

+      } else {

+        //

+        // '/P' is not in the String.

+        //

+        break;

+      }

+    } else if (AddressIndex < ARRAY_SIZE (Address->Addr)) {

+      if (*Pointer == L'.') {

+        //

+        // D should be followed by '.'

+        //

+        Pointer++;

+      } else {

+        return RETURN_UNSUPPORTED;

+      }

+    }

+  }

+

+  if (AddressIndex < ARRAY_SIZE (Address->Addr)) {

+    return RETURN_UNSUPPORTED;

+  }

+

+  CopyMem (Address, &LocalAddress, sizeof (*Address));

+  if (PrefixLength != NULL) {

+    *PrefixLength = LocalPrefixLength;

+  }

+  if (EndPointer != NULL) {

+    *EndPointer = Pointer;

+  }

+

+  return RETURN_SUCCESS;

+}

+

+/**

+  Convert a Null-terminated Unicode GUID string to a value of type

+  EFI_GUID.

+

+  This function outputs a GUID value by interpreting the contents of

+  the Unicode string specified by String. The format of the input

+  Unicode string String consists of 36 characters, as follows:

+

+                  aabbccdd-eeff-gghh-iijj-kkllmmnnoopp

+

+  The pairs aa - pp are two characters in the range [0-9], [a-f] and

+  [A-F], with each pair representing a single byte hexadecimal value.

+

+  The mapping between String and the EFI_GUID structure is as follows:

+                  aa          Data1[24:31]

+                  bb          Data1[16:23]

+                  cc          Data1[8:15]

+                  dd          Data1[0:7]

+                  ee          Data2[8:15]

+                  ff          Data2[0:7]

+                  gg          Data3[8:15]

+                  hh          Data3[0:7]

+                  ii          Data4[0:7]

+                  jj          Data4[8:15]

+                  kk          Data4[16:23]

+                  ll          Data4[24:31]

+                  mm          Data4[32:39]

+                  nn          Data4[40:47]

+                  oo          Data4[48:55]

+                  pp          Data4[56:63]

+

+  If String is not aligned in a 16-bit boundary, then ASSERT().

+

+  @param  String                   Pointer to a Null-terminated Unicode string.

+  @param  Guid                     Pointer to the converted GUID.

+

+  @retval RETURN_SUCCESS           Guid is translated from String.

+  @retval RETURN_INVALID_PARAMETER If String is NULL.

+                                   If Data is NULL.

+  @retval RETURN_UNSUPPORTED       If String is not as the above format.

+

+**/

+RETURN_STATUS

+EFIAPI

+StrToGuid (

+  IN  CONST CHAR16       *String,

+  OUT GUID               *Guid

+  )

+{

+  RETURN_STATUS          Status;

+  GUID                   LocalGuid;

+

+  ASSERT (((UINTN) String & BIT0) == 0);

+

+  //

+  // 1. None of String or Guid shall be a null pointer.

+  //

+  SAFE_STRING_CONSTRAINT_CHECK ((String != NULL), RETURN_INVALID_PARAMETER);

+  SAFE_STRING_CONSTRAINT_CHECK ((Guid != NULL), RETURN_INVALID_PARAMETER);

+

+  //

+  // Get aabbccdd in big-endian.

+  //

+  Status = StrHexToBytes (String, 2 * sizeof (LocalGuid.Data1), (UINT8 *) &LocalGuid.Data1, sizeof (LocalGuid.Data1));

+  if (RETURN_ERROR (Status) || String[2 * sizeof (LocalGuid.Data1)] != L'-') {

+    return RETURN_UNSUPPORTED;

+  }

+  //

+  // Convert big-endian to little-endian.

+  //

+  LocalGuid.Data1 = SwapBytes32 (LocalGuid.Data1);

+  String += 2 * sizeof (LocalGuid.Data1) + 1;

+

+  //

+  // Get eeff in big-endian.

+  //

+  Status = StrHexToBytes (String, 2 * sizeof (LocalGuid.Data2), (UINT8 *) &LocalGuid.Data2, sizeof (LocalGuid.Data2));

+  if (RETURN_ERROR (Status) || String[2 * sizeof (LocalGuid.Data2)] != L'-') {

+    return RETURN_UNSUPPORTED;

+  }

+  //

+  // Convert big-endian to little-endian.

+  //

+  LocalGuid.Data2 = SwapBytes16 (LocalGuid.Data2);

+  String += 2 * sizeof (LocalGuid.Data2) + 1;

+

+  //

+  // Get gghh in big-endian.

+  //

+  Status = StrHexToBytes (String, 2 * sizeof (LocalGuid.Data3), (UINT8 *) &LocalGuid.Data3, sizeof (LocalGuid.Data3));

+  if (RETURN_ERROR (Status) || String[2 * sizeof (LocalGuid.Data3)] != L'-') {

+    return RETURN_UNSUPPORTED;

+  }

+  //

+  // Convert big-endian to little-endian.

+  //

+  LocalGuid.Data3 = SwapBytes16 (LocalGuid.Data3);

+  String += 2 * sizeof (LocalGuid.Data3) + 1;

+

+  //

+  // Get iijj.

+  //

+  Status = StrHexToBytes (String, 2 * 2, &LocalGuid.Data4[0], 2);

+  if (RETURN_ERROR (Status) || String[2 * 2] != L'-') {

+    return RETURN_UNSUPPORTED;

+  }

+  String += 2 * 2 + 1;

+

+  //

+  // Get kkllmmnnoopp.

+  //

+  Status = StrHexToBytes (String, 2 * 6, &LocalGuid.Data4[2], 6);

+  if (RETURN_ERROR (Status)) {

+    return RETURN_UNSUPPORTED;

+  }

+

+  CopyGuid (Guid, &LocalGuid);

+  return RETURN_SUCCESS;

+}

+

+/**

+  Convert a Null-terminated Unicode hexadecimal string to a byte array.

+

+  This function outputs a byte array by interpreting the contents of

+  the Unicode string specified by String in hexadecimal format. The format of

+  the input Unicode string String is:

+

+                  [XX]*

+

+  X is a hexadecimal digit character in the range [0-9], [a-f] and [A-F].

+  The function decodes every two hexadecimal digit characters as one byte. The

+  decoding stops after Length of characters and outputs Buffer containing

+  (Length / 2) bytes.

+

+  If String is not aligned in a 16-bit boundary, then ASSERT().

+

+  @param  String                   Pointer to a Null-terminated Unicode string.

+  @param  Length                   The number of Unicode characters to decode.

+  @param  Buffer                   Pointer to the converted bytes array.

+  @param  MaxBufferSize            The maximum size of Buffer.

+

+  @retval RETURN_SUCCESS           Buffer is translated from String.

+  @retval RETURN_INVALID_PARAMETER If String is NULL.

+                                   If Data is NULL.

+                                   If Length is not multiple of 2.

+                                   If PcdMaximumUnicodeStringLength is not zero,

+                                    and Length is greater than

+                                    PcdMaximumUnicodeStringLength.

+  @retval RETURN_UNSUPPORTED       If Length of characters from String contain

+                                    a character that is not valid hexadecimal

+                                    digit characters, or a Null-terminator.

+  @retval RETURN_BUFFER_TOO_SMALL  If MaxBufferSize is less than (Length / 2).

+**/

+RETURN_STATUS

+EFIAPI

+StrHexToBytes (

+  IN  CONST CHAR16       *String,

+  IN  UINTN              Length,

+  OUT UINT8              *Buffer,

+  IN  UINTN              MaxBufferSize

+  )

+{

+  UINTN                  Index;

+

+  ASSERT (((UINTN) String & BIT0) == 0);

+

+  //

+  // 1. None of String or Buffer shall be a null pointer.

+  //

+  SAFE_STRING_CONSTRAINT_CHECK ((String != NULL), RETURN_INVALID_PARAMETER);

+  SAFE_STRING_CONSTRAINT_CHECK ((Buffer != NULL), RETURN_INVALID_PARAMETER);

+

+  //

+  // 2. Length shall not be greater than RSIZE_MAX.

+  //

+  if (RSIZE_MAX != 0) {

+    SAFE_STRING_CONSTRAINT_CHECK ((Length <= RSIZE_MAX), RETURN_INVALID_PARAMETER);

+  }

+

+  //

+  // 3. Length shall not be odd.

+  //

+  SAFE_STRING_CONSTRAINT_CHECK (((Length & BIT0) == 0), RETURN_INVALID_PARAMETER);

+

+  //

+  // 4. MaxBufferSize shall equal to or greater than Length / 2.

+  //

+  SAFE_STRING_CONSTRAINT_CHECK ((MaxBufferSize >= Length / 2), RETURN_BUFFER_TOO_SMALL);

+

+  //

+  // 5. String shall not contains invalid hexadecimal digits.

+  //

+  for (Index = 0; Index < Length; Index++) {

+    if (!InternalIsHexaDecimalDigitCharacter (String[Index])) {

+      break;

+    }

+  }

+  if (Index != Length) {

+    return RETURN_UNSUPPORTED;

+  }

+

+  //

+  // Convert the hex string to bytes.

+  //

+  for(Index = 0; Index < Length; Index++) {

+

+    //

+    // For even characters, write the upper nibble for each buffer byte,

+    // and for even characters, the lower nibble.

+    //

+    if ((Index & BIT0) == 0) {

+      Buffer[Index / 2]  = (UINT8) InternalHexCharToUintn (String[Index]) << 4;

+    } else {

+      Buffer[Index / 2] |= (UINT8) InternalHexCharToUintn (String[Index]);

+    }

+  }

+  return RETURN_SUCCESS;

+}

+

+/**

+  Returns the length of a Null-terminated Ascii string.

+

+  This function is similar as strlen_s defined in C11.

+

+  @param  String   A pointer to a Null-terminated Ascii string.

+  @param  MaxSize  The maximum number of Destination Ascii

+                   char, including terminating null char.

+

+  @retval 0        If String is NULL.

+  @retval MaxSize  If there is no null character in the first MaxSize characters of String.

+  @return The number of characters that percede the terminating null character.

+

+**/

+UINTN

+EFIAPI

+AsciiStrnLenS (

+  IN CONST CHAR8               *String,

+  IN UINTN                     MaxSize

+  )

+{

+  UINTN                             Length;

+

+  //

+  // If String is a null pointer or MaxSize is 0, then the AsciiStrnLenS function returns zero.

+  //

+  if ((String == NULL) || (MaxSize == 0)) {

+    return 0;

+  }

+

+  //

+  // Otherwise, the AsciiStrnLenS function returns the number of characters that precede the

+  // terminating null character. If there is no null character in the first MaxSize characters of

+  // String then AsciiStrnLenS returns MaxSize. At most the first MaxSize characters of String shall

+  // be accessed by AsciiStrnLenS.

+  //

+  Length = 0;

+  while (String[Length] != 0) {

+    if (Length >= MaxSize - 1) {

+      return MaxSize;

+    }

+    Length++;

+  }

+  return Length;

+}

+

+/**

+  Returns the size of a Null-terminated Ascii string in bytes, including the

+  Null terminator.

+

+  This function returns the size of the Null-terminated Ascii string specified

+  by String in bytes, including the Null terminator.

+

+  @param  String   A pointer to a Null-terminated Ascii string.

+  @param  MaxSize  The maximum number of Destination Ascii

+                   char, including the Null terminator.

+

+  @retval 0  If String is NULL.

+  @retval (sizeof (CHAR8) * (MaxSize + 1))

+             If there is no Null terminator in the first MaxSize characters of

+             String.

+  @return The size of the Null-terminated Ascii string in bytes, including the

+          Null terminator.

+

+**/

+UINTN

+EFIAPI

+AsciiStrnSizeS (

+  IN CONST CHAR8               *String,

+  IN UINTN                     MaxSize

+  )

+{

+  //

+  // If String is a null pointer, then the AsciiStrnSizeS function returns

+  // zero.

+  //

+  if (String == NULL) {

+    return 0;

+  }

+

+  //

+  // Otherwise, the AsciiStrnSizeS function returns the size of the

+  // Null-terminated Ascii string in bytes, including the Null terminator. If

+  // there is no Null terminator in the first MaxSize characters of String,

+  // then AsciiStrnSizeS returns (sizeof (CHAR8) * (MaxSize + 1)) to keep a

+  // consistent map with the AsciiStrnLenS function.

+  //

+  return (AsciiStrnLenS (String, MaxSize) + 1) * sizeof (*String);

+}

+

+/**

+  Copies the string pointed to by Source (including the terminating null char)

+  to the array pointed to by Destination.

+

+  This function is similar as strcpy_s defined in C11.

+

+  If an error is returned, then the Destination is unmodified.

+

+  @param  Destination              A pointer to a Null-terminated Ascii string.

+  @param  DestMax                  The maximum number of Destination Ascii

+                                   char, including terminating null char.

+  @param  Source                   A pointer to a Null-terminated Ascii string.

+

+  @retval RETURN_SUCCESS           String is copied.

+  @retval RETURN_BUFFER_TOO_SMALL  If DestMax is NOT greater than StrLen(Source).

+  @retval RETURN_INVALID_PARAMETER If Destination is NULL.

+                                   If Source is NULL.

+                                   If PcdMaximumAsciiStringLength is not zero,

+                                    and DestMax is greater than

+                                    PcdMaximumAsciiStringLength.

+                                   If DestMax is 0.

+  @retval RETURN_ACCESS_DENIED     If Source and Destination overlap.

+**/

+RETURN_STATUS

+EFIAPI

+AsciiStrCpyS (

+  OUT CHAR8        *Destination,

+  IN  UINTN        DestMax,

+  IN  CONST CHAR8  *Source

+  )

+{

+  UINTN            SourceLen;

+

+  //

+  // 1. Neither Destination nor Source shall be a null pointer.

+  //

+  SAFE_STRING_CONSTRAINT_CHECK ((Destination != NULL), RETURN_INVALID_PARAMETER);

+  SAFE_STRING_CONSTRAINT_CHECK ((Source != NULL), RETURN_INVALID_PARAMETER);

+

+  //

+  // 2. DestMax shall not be greater than ASCII_RSIZE_MAX.

+  //

+  if (ASCII_RSIZE_MAX != 0) {

+    SAFE_STRING_CONSTRAINT_CHECK ((DestMax <= ASCII_RSIZE_MAX), RETURN_INVALID_PARAMETER);

+  }

+

+  //

+  // 3. DestMax shall not equal zero.

+  //

+  SAFE_STRING_CONSTRAINT_CHECK ((DestMax != 0), RETURN_INVALID_PARAMETER);

+

+  //

+  // 4. DestMax shall be greater than AsciiStrnLenS(Source, DestMax).

+  //

+  SourceLen = AsciiStrnLenS (Source, DestMax);

+  SAFE_STRING_CONSTRAINT_CHECK ((DestMax > SourceLen), RETURN_BUFFER_TOO_SMALL);

+

+  //

+  // 5. Copying shall not take place between objects that overlap.

+  //

+  SAFE_STRING_CONSTRAINT_CHECK (InternalSafeStringNoAsciiStrOverlap (Destination, DestMax, (CHAR8 *)Source, SourceLen + 1), RETURN_ACCESS_DENIED);

+

+  //

+  // The AsciiStrCpyS function copies the string pointed to by Source (including the terminating

+  // null character) into the array pointed to by Destination.

+  //

+  while (*Source != 0) {

+    *(Destination++) = *(Source++);

+  }

+  *Destination = 0;

+

+  return RETURN_SUCCESS;

+}

+

+/**

+  Copies not more than Length successive char from the string pointed to by

+  Source to the array pointed to by Destination. If no null char is copied from

+  Source, then Destination[Length] is always set to null.

+

+  This function is similar as strncpy_s defined in C11.

+

+  If an error is returned, then the Destination is unmodified.

+

+  @param  Destination              A pointer to a Null-terminated Ascii string.

+  @param  DestMax                  The maximum number of Destination Ascii

+                                   char, including terminating null char.

+  @param  Source                   A pointer to a Null-terminated Ascii string.

+  @param  Length                   The maximum number of Ascii characters to copy.

+

+  @retval RETURN_SUCCESS           String is copied.

+  @retval RETURN_BUFFER_TOO_SMALL  If DestMax is NOT greater than

+                                   MIN(StrLen(Source), Length).

+  @retval RETURN_INVALID_PARAMETER If Destination is NULL.

+                                   If Source is NULL.

+                                   If PcdMaximumAsciiStringLength is not zero,

+                                    and DestMax is greater than

+                                    PcdMaximumAsciiStringLength.

+                                   If DestMax is 0.

+  @retval RETURN_ACCESS_DENIED     If Source and Destination overlap.

+**/

+RETURN_STATUS

+EFIAPI

+AsciiStrnCpyS (

+  OUT CHAR8        *Destination,

+  IN  UINTN        DestMax,

+  IN  CONST CHAR8  *Source,

+  IN  UINTN        Length

+  )

+{

+  UINTN            SourceLen;

+

+  //

+  // 1. Neither Destination nor Source shall be a null pointer.

+  //

+  SAFE_STRING_CONSTRAINT_CHECK ((Destination != NULL), RETURN_INVALID_PARAMETER);

+  SAFE_STRING_CONSTRAINT_CHECK ((Source != NULL), RETURN_INVALID_PARAMETER);

+

+  //

+  // 2. Neither DestMax nor Length shall be greater than ASCII_RSIZE_MAX

+  //

+  if (ASCII_RSIZE_MAX != 0) {

+    SAFE_STRING_CONSTRAINT_CHECK ((DestMax <= ASCII_RSIZE_MAX), RETURN_INVALID_PARAMETER);

+    SAFE_STRING_CONSTRAINT_CHECK ((Length <= ASCII_RSIZE_MAX), RETURN_INVALID_PARAMETER);

+  }

+

+  //

+  // 3. DestMax shall not equal zero.

+  //

+  SAFE_STRING_CONSTRAINT_CHECK ((DestMax != 0), RETURN_INVALID_PARAMETER);

+

+  //

+  // 4. If Length is not less than DestMax, then DestMax shall be greater than AsciiStrnLenS(Source, DestMax).

+  //

+  SourceLen = AsciiStrnLenS (Source, MIN (DestMax, Length));

+  if (Length >= DestMax) {

+    SAFE_STRING_CONSTRAINT_CHECK ((DestMax > SourceLen), RETURN_BUFFER_TOO_SMALL);

+  }

+

+  //

+  // 5. Copying shall not take place between objects that overlap.

+  //

+  if (SourceLen > Length) {

+    SourceLen = Length;

+  }

+  SAFE_STRING_CONSTRAINT_CHECK (InternalSafeStringNoAsciiStrOverlap (Destination, DestMax, (CHAR8 *)Source, SourceLen + 1), RETURN_ACCESS_DENIED);

+

+  //

+  // The AsciiStrnCpyS function copies not more than Length successive characters (characters that

+  // follow a null character are not copied) from the array pointed to by Source to the array

+  // pointed to by Destination. If no null character was copied from Source, then Destination[Length] is set to a null

+  // character.

+  //

+  while ((SourceLen > 0) && (*Source != 0)) {

+    *(Destination++) = *(Source++);

+    SourceLen--;

+  }

+  *Destination = 0;

+

+  return RETURN_SUCCESS;

+}

+

+/**

+  Appends a copy of the string pointed to by Source (including the terminating

+  null char) to the end of the string pointed to by Destination.

+

+  This function is similar as strcat_s defined in C11.

+

+  If an error is returned, then the Destination is unmodified.

+

+  @param  Destination              A pointer to a Null-terminated Ascii string.

+  @param  DestMax                  The maximum number of Destination Ascii

+                                   char, including terminating null char.

+  @param  Source                   A pointer to a Null-terminated Ascii string.

+

+  @retval RETURN_SUCCESS           String is appended.

+  @retval RETURN_BAD_BUFFER_SIZE   If DestMax is NOT greater than

+                                   StrLen(Destination).

+  @retval RETURN_BUFFER_TOO_SMALL  If (DestMax - StrLen(Destination)) is NOT

+                                   greater than StrLen(Source).

+  @retval RETURN_INVALID_PARAMETER If Destination is NULL.

+                                   If Source is NULL.

+                                   If PcdMaximumAsciiStringLength is not zero,

+                                    and DestMax is greater than

+                                    PcdMaximumAsciiStringLength.

+                                   If DestMax is 0.

+  @retval RETURN_ACCESS_DENIED     If Source and Destination overlap.

+**/

+RETURN_STATUS

+EFIAPI

+AsciiStrCatS (

+  IN OUT CHAR8        *Destination,

+  IN     UINTN        DestMax,

+  IN     CONST CHAR8  *Source

+  )

+{

+  UINTN               DestLen;

+  UINTN               CopyLen;

+  UINTN               SourceLen;

+

+  //

+  // Let CopyLen denote the value DestMax - AsciiStrnLenS(Destination, DestMax) upon entry to AsciiStrCatS.

+  //

+  DestLen = AsciiStrnLenS (Destination, DestMax);

+  CopyLen = DestMax - DestLen;

+

+  //

+  // 1. Neither Destination nor Source shall be a null pointer.

+  //

+  SAFE_STRING_CONSTRAINT_CHECK ((Destination != NULL), RETURN_INVALID_PARAMETER);

+  SAFE_STRING_CONSTRAINT_CHECK ((Source != NULL), RETURN_INVALID_PARAMETER);

+

+  //

+  // 2. DestMax shall not be greater than ASCII_RSIZE_MAX.

+  //

+  if (ASCII_RSIZE_MAX != 0) {

+    SAFE_STRING_CONSTRAINT_CHECK ((DestMax <= ASCII_RSIZE_MAX), RETURN_INVALID_PARAMETER);

+  }

+

+  //

+  // 3. DestMax shall not equal zero.

+  //

+  SAFE_STRING_CONSTRAINT_CHECK ((DestMax != 0), RETURN_INVALID_PARAMETER);

+

+  //

+  // 4. CopyLen shall not equal zero.

+  //

+  SAFE_STRING_CONSTRAINT_CHECK ((CopyLen != 0), RETURN_BAD_BUFFER_SIZE);

+

+  //

+  // 5. CopyLen shall be greater than AsciiStrnLenS(Source, CopyLen).

+  //

+  SourceLen = AsciiStrnLenS (Source, CopyLen);

+  SAFE_STRING_CONSTRAINT_CHECK ((CopyLen > SourceLen), RETURN_BUFFER_TOO_SMALL);

+

+  //

+  // 6. Copying shall not take place between objects that overlap.

+  //

+  SAFE_STRING_CONSTRAINT_CHECK (InternalSafeStringNoAsciiStrOverlap (Destination, DestMax, (CHAR8 *)Source, SourceLen + 1), RETURN_ACCESS_DENIED);

+

+  //

+  // The AsciiStrCatS function appends a copy of the string pointed to by Source (including the

+  // terminating null character) to the end of the string pointed to by Destination. The initial character

+  // from Source overwrites the null character at the end of Destination.

+  //

+  Destination = Destination + DestLen;

+  while (*Source != 0) {

+    *(Destination++) = *(Source++);

+  }

+  *Destination = 0;

+

+  return RETURN_SUCCESS;

+}

+

+/**

+  Appends not more than Length successive char from the string pointed to by

+  Source to the end of the string pointed to by Destination. If no null char is

+  copied from Source, then Destination[StrLen(Destination) + Length] is always

+  set to null.

+

+  This function is similar as strncat_s defined in C11.

+

+  If an error is returned, then the Destination is unmodified.

+

+  @param  Destination              A pointer to a Null-terminated Ascii string.

+  @param  DestMax                  The maximum number of Destination Ascii

+                                   char, including terminating null char.

+  @param  Source                   A pointer to a Null-terminated Ascii string.

+  @param  Length                   The maximum number of Ascii characters to copy.

+

+  @retval RETURN_SUCCESS           String is appended.

+  @retval RETURN_BAD_BUFFER_SIZE   If DestMax is NOT greater than

+                                   StrLen(Destination).

+  @retval RETURN_BUFFER_TOO_SMALL  If (DestMax - StrLen(Destination)) is NOT

+                                   greater than MIN(StrLen(Source), Length).

+  @retval RETURN_INVALID_PARAMETER If Destination is NULL.

+                                   If Source is NULL.

+                                   If PcdMaximumAsciiStringLength is not zero,

+                                    and DestMax is greater than

+                                    PcdMaximumAsciiStringLength.

+                                   If DestMax is 0.

+  @retval RETURN_ACCESS_DENIED     If Source and Destination overlap.

+**/

+RETURN_STATUS

+EFIAPI

+AsciiStrnCatS (

+  IN OUT CHAR8        *Destination,

+  IN     UINTN        DestMax,

+  IN     CONST CHAR8  *Source,

+  IN     UINTN        Length

+  )

+{

+  UINTN               DestLen;

+  UINTN               CopyLen;

+  UINTN               SourceLen;

+

+  //

+  // Let CopyLen denote the value DestMax - AsciiStrnLenS(Destination, DestMax) upon entry to AsciiStrnCatS.

+  //

+  DestLen = AsciiStrnLenS (Destination, DestMax);

+  CopyLen = DestMax - DestLen;

+

+  //

+  // 1. Neither Destination nor Source shall be a null pointer.

+  //

+  SAFE_STRING_CONSTRAINT_CHECK ((Destination != NULL), RETURN_INVALID_PARAMETER);

+  SAFE_STRING_CONSTRAINT_CHECK ((Source != NULL), RETURN_INVALID_PARAMETER);

+

+  //

+  // 2. Neither DestMax nor Length shall be greater than ASCII_RSIZE_MAX.

+  //

+  if (ASCII_RSIZE_MAX != 0) {

+    SAFE_STRING_CONSTRAINT_CHECK ((DestMax <= ASCII_RSIZE_MAX), RETURN_INVALID_PARAMETER);

+    SAFE_STRING_CONSTRAINT_CHECK ((Length <= ASCII_RSIZE_MAX), RETURN_INVALID_PARAMETER);

+  }

+

+  //

+  // 3. DestMax shall not equal zero.

+  //

+  SAFE_STRING_CONSTRAINT_CHECK ((DestMax != 0), RETURN_INVALID_PARAMETER);

+

+  //

+  // 4. CopyLen shall not equal zero.

+  //

+  SAFE_STRING_CONSTRAINT_CHECK ((CopyLen != 0), RETURN_BAD_BUFFER_SIZE);

+

+  //

+  // 5. If Length is not less than CopyLen, then CopyLen shall be greater than AsciiStrnLenS(Source, CopyLen).

+  //

+  SourceLen = AsciiStrnLenS (Source, MIN (CopyLen, Length));

+  if (Length >= CopyLen) {

+    SAFE_STRING_CONSTRAINT_CHECK ((CopyLen > SourceLen), RETURN_BUFFER_TOO_SMALL);

+  }

+

+  //

+  // 6. Copying shall not take place between objects that overlap.

+  //

+  if (SourceLen > Length) {

+    SourceLen = Length;

+  }

+  SAFE_STRING_CONSTRAINT_CHECK (InternalSafeStringNoAsciiStrOverlap (Destination, DestMax, (CHAR8 *)Source, SourceLen + 1), RETURN_ACCESS_DENIED);

+

+  //

+  // The AsciiStrnCatS function appends not more than Length successive characters (characters

+  // that follow a null character are not copied) from the array pointed to by Source to the end of

+  // the string pointed to by Destination. The initial character from Source overwrites the null character at

+  // the end of Destination. If no null character was copied from Source, then Destination[DestMax-CopyLen+Length] is set to

+  // a null character.

+  //

+  Destination = Destination + DestLen;

+  while ((SourceLen > 0) && (*Source != 0)) {

+    *(Destination++) = *(Source++);

+    SourceLen--;

+  }

+  *Destination = 0;

+

+  return RETURN_SUCCESS;

+}

+

+/**

+  Convert a Null-terminated Ascii decimal string to a value of type UINTN.

+

+  This function outputs a value of type UINTN by interpreting the contents of

+  the Ascii string specified by String as a decimal number. The format of the

+  input Ascii string String is:

+

+                  [spaces] [decimal digits].

+

+  The valid decimal digit character is in the range [0-9]. The function will

+  ignore the pad space, which includes spaces or tab characters, before

+  [decimal digits]. The running zero in the beginning of [decimal digits] will

+  be ignored. Then, the function stops at the first character that is a not a

+  valid decimal character or a Null-terminator, whichever one comes first.

+

+  If String has no valid decimal digits in the above format, then 0 is stored

+  at the location pointed to by Data.

+  If the number represented by String exceeds the range defined by UINTN, then

+  MAX_UINTN is stored at the location pointed to by Data.

+

+  If EndPointer is not NULL, a pointer to the character that stopped the scan

+  is stored at the location pointed to by EndPointer. If String has no valid

+  decimal digits right after the optional pad spaces, the value of String is

+  stored at the location pointed to by EndPointer.

+

+  @param  String                   Pointer to a Null-terminated Ascii string.

+  @param  EndPointer               Pointer to character that stops scan.

+  @param  Data                     Pointer to the converted value.

+

+  @retval RETURN_SUCCESS           Value is translated from String.

+  @retval RETURN_INVALID_PARAMETER If String is NULL.

+                                   If Data is NULL.

+                                   If PcdMaximumAsciiStringLength is not zero,

+                                   and String contains more than

+                                   PcdMaximumAsciiStringLength Ascii

+                                   characters, not including the

+                                   Null-terminator.

+  @retval RETURN_UNSUPPORTED       If the number represented by String exceeds

+                                   the range defined by UINTN.

+

+**/

+RETURN_STATUS

+EFIAPI

+AsciiStrDecimalToUintnS (

+  IN  CONST CHAR8              *String,

+  OUT       CHAR8              **EndPointer,  OPTIONAL

+  OUT       UINTN              *Data

+  )

+{

+  //

+  // 1. Neither String nor Data shall be a null pointer.

+  //

+  SAFE_STRING_CONSTRAINT_CHECK ((String != NULL), RETURN_INVALID_PARAMETER);

+  SAFE_STRING_CONSTRAINT_CHECK ((Data != NULL), RETURN_INVALID_PARAMETER);

+

+  //

+  // 2. The length of String shall not be greater than ASCII_RSIZE_MAX.

+  //

+  if (ASCII_RSIZE_MAX != 0) {

+    SAFE_STRING_CONSTRAINT_CHECK ((AsciiStrnLenS (String, ASCII_RSIZE_MAX + 1) <= ASCII_RSIZE_MAX), RETURN_INVALID_PARAMETER);

+  }

+

+  if (EndPointer != NULL) {

+    *EndPointer = (CHAR8 *) String;

+  }

+

+  //

+  // Ignore the pad spaces (space or tab)

+  //

+  while ((*String == ' ') || (*String == '\t')) {

+    String++;

+  }

+

+  //

+  // Ignore leading Zeros after the spaces

+  //

+  while (*String == '0') {

+    String++;

+  }

+

+  *Data = 0;

+

+  while (InternalAsciiIsDecimalDigitCharacter (*String)) {

+    //

+    // If the number represented by String overflows according to the range

+    // defined by UINTN, then MAX_UINTN is stored in *Data and

+    // RETURN_UNSUPPORTED is returned.

+    //

+    if (*Data > ((MAX_UINTN - (*String - '0')) / 10)) {

+      *Data = MAX_UINTN;

+      if (EndPointer != NULL) {

+        *EndPointer = (CHAR8 *) String;

+      }

+      return RETURN_UNSUPPORTED;

+    }

+

+    *Data = *Data * 10 + (*String - '0');

+    String++;

+  }

+

+  if (EndPointer != NULL) {

+    *EndPointer = (CHAR8 *) String;

+  }

+  return RETURN_SUCCESS;

+}

+

+/**

+  Convert a Null-terminated Ascii decimal string to a value of type UINT64.

+

+  This function outputs a value of type UINT64 by interpreting the contents of

+  the Ascii string specified by String as a decimal number. The format of the

+  input Ascii string String is:

+

+                  [spaces] [decimal digits].

+

+  The valid decimal digit character is in the range [0-9]. The function will

+  ignore the pad space, which includes spaces or tab characters, before

+  [decimal digits]. The running zero in the beginning of [decimal digits] will

+  be ignored. Then, the function stops at the first character that is a not a

+  valid decimal character or a Null-terminator, whichever one comes first.

+

+  If String has no valid decimal digits in the above format, then 0 is stored

+  at the location pointed to by Data.

+  If the number represented by String exceeds the range defined by UINT64, then

+  MAX_UINT64 is stored at the location pointed to by Data.

+

+  If EndPointer is not NULL, a pointer to the character that stopped the scan

+  is stored at the location pointed to by EndPointer. If String has no valid

+  decimal digits right after the optional pad spaces, the value of String is

+  stored at the location pointed to by EndPointer.

+

+  @param  String                   Pointer to a Null-terminated Ascii string.

+  @param  EndPointer               Pointer to character that stops scan.

+  @param  Data                     Pointer to the converted value.

+

+  @retval RETURN_SUCCESS           Value is translated from String.

+  @retval RETURN_INVALID_PARAMETER If String is NULL.

+                                   If Data is NULL.

+                                   If PcdMaximumAsciiStringLength is not zero,

+                                   and String contains more than

+                                   PcdMaximumAsciiStringLength Ascii

+                                   characters, not including the

+                                   Null-terminator.

+  @retval RETURN_UNSUPPORTED       If the number represented by String exceeds

+                                   the range defined by UINT64.

+

+**/

+RETURN_STATUS

+EFIAPI

+AsciiStrDecimalToUint64S (

+  IN  CONST CHAR8              *String,

+  OUT       CHAR8              **EndPointer,  OPTIONAL

+  OUT       UINT64             *Data

+  )

+{

+  //

+  // 1. Neither String nor Data shall be a null pointer.

+  //

+  SAFE_STRING_CONSTRAINT_CHECK ((String != NULL), RETURN_INVALID_PARAMETER);

+  SAFE_STRING_CONSTRAINT_CHECK ((Data != NULL), RETURN_INVALID_PARAMETER);

+

+  //

+  // 2. The length of String shall not be greater than ASCII_RSIZE_MAX.

+  //

+  if (ASCII_RSIZE_MAX != 0) {

+    SAFE_STRING_CONSTRAINT_CHECK ((AsciiStrnLenS (String, ASCII_RSIZE_MAX + 1) <= ASCII_RSIZE_MAX), RETURN_INVALID_PARAMETER);

+  }

+

+  if (EndPointer != NULL) {

+    *EndPointer = (CHAR8 *) String;

+  }

+

+  //

+  // Ignore the pad spaces (space or tab)

+  //

+  while ((*String == ' ') || (*String == '\t')) {

+    String++;

+  }

+

+  //

+  // Ignore leading Zeros after the spaces

+  //

+  while (*String == '0') {

+    String++;

+  }

+

+  *Data = 0;

+

+  while (InternalAsciiIsDecimalDigitCharacter (*String)) {

+    //

+    // If the number represented by String overflows according to the range

+    // defined by UINT64, then MAX_UINT64 is stored in *Data and

+    // RETURN_UNSUPPORTED is returned.

+    //

+    if (*Data > DivU64x32 (MAX_UINT64 - (*String - '0'), 10)) {

+      *Data = MAX_UINT64;

+      if (EndPointer != NULL) {

+        *EndPointer = (CHAR8 *) String;

+      }

+      return RETURN_UNSUPPORTED;

+    }

+

+    *Data = MultU64x32 (*Data, 10) + (*String - '0');

+    String++;

+  }

+

+  if (EndPointer != NULL) {

+    *EndPointer = (CHAR8 *) String;

+  }

+  return RETURN_SUCCESS;

+}

+

+/**

+  Convert a Null-terminated Ascii hexadecimal string to a value of type UINTN.

+

+  This function outputs a value of type UINTN by interpreting the contents of

+  the Ascii string specified by String as a hexadecimal number. The format of

+  the input Ascii string String is:

+

+                  [spaces][zeros][x][hexadecimal digits].

+

+  The valid hexadecimal digit character is in the range [0-9], [a-f] and [A-F].

+  The prefix "0x" is optional. Both "x" and "X" is allowed in "0x" prefix. If

+  "x" appears in the input string, it must be prefixed with at least one 0. The

+  function will ignore the pad space, which includes spaces or tab characters,

+  before [zeros], [x] or [hexadecimal digits]. The running zero before [x] or

+  [hexadecimal digits] will be ignored. Then, the decoding starts after [x] or

+  the first valid hexadecimal digit. Then, the function stops at the first

+  character that is a not a valid hexadecimal character or Null-terminator,

+  whichever on comes first.

+

+  If String has no valid hexadecimal digits in the above format, then 0 is

+  stored at the location pointed to by Data.

+  If the number represented by String exceeds the range defined by UINTN, then

+  MAX_UINTN is stored at the location pointed to by Data.

+

+  If EndPointer is not NULL, a pointer to the character that stopped the scan

+  is stored at the location pointed to by EndPointer. If String has no valid

+  hexadecimal digits right after the optional pad spaces, the value of String

+  is stored at the location pointed to by EndPointer.

+

+  @param  String                   Pointer to a Null-terminated Ascii string.

+  @param  EndPointer               Pointer to character that stops scan.

+  @param  Data                     Pointer to the converted value.

+

+  @retval RETURN_SUCCESS           Value is translated from String.

+  @retval RETURN_INVALID_PARAMETER If String is NULL.

+                                   If Data is NULL.

+                                   If PcdMaximumAsciiStringLength is not zero,

+                                   and String contains more than

+                                   PcdMaximumAsciiStringLength Ascii

+                                   characters, not including the

+                                   Null-terminator.

+  @retval RETURN_UNSUPPORTED       If the number represented by String exceeds

+                                   the range defined by UINTN.

+

+**/

+RETURN_STATUS

+EFIAPI

+AsciiStrHexToUintnS (

+  IN  CONST CHAR8              *String,

+  OUT       CHAR8              **EndPointer,  OPTIONAL

+  OUT       UINTN              *Data

+  )

+{

+  //

+  // 1. Neither String nor Data shall be a null pointer.

+  //

+  SAFE_STRING_CONSTRAINT_CHECK ((String != NULL), RETURN_INVALID_PARAMETER);

+  SAFE_STRING_CONSTRAINT_CHECK ((Data != NULL), RETURN_INVALID_PARAMETER);

+

+  //

+  // 2. The length of String shall not be greater than ASCII_RSIZE_MAX.

+  //

+  if (ASCII_RSIZE_MAX != 0) {

+    SAFE_STRING_CONSTRAINT_CHECK ((AsciiStrnLenS (String, ASCII_RSIZE_MAX + 1) <= ASCII_RSIZE_MAX), RETURN_INVALID_PARAMETER);

+  }

+

+  if (EndPointer != NULL) {

+    *EndPointer = (CHAR8 *) String;

+  }

+

+  //

+  // Ignore the pad spaces (space or tab)

+  //

+  while ((*String == ' ') || (*String == '\t')) {

+    String++;

+  }

+

+  //

+  // Ignore leading Zeros after the spaces

+  //

+  while (*String == '0') {

+    String++;

+  }

+

+  if (AsciiCharToUpper (*String) == 'X') {

+    if (*(String - 1) != '0') {

+      *Data = 0;

+      return RETURN_SUCCESS;

+    }

+    //

+    // Skip the 'X'

+    //

+    String++;

+  }

+

+  *Data = 0;

+

+  while (InternalAsciiIsHexaDecimalDigitCharacter (*String)) {

+    //

+    // If the number represented by String overflows according to the range

+    // defined by UINTN, then MAX_UINTN is stored in *Data and

+    // RETURN_UNSUPPORTED is returned.

+    //

+    if (*Data > ((MAX_UINTN - InternalAsciiHexCharToUintn (*String)) >> 4)) {

+      *Data = MAX_UINTN;

+      if (EndPointer != NULL) {

+        *EndPointer = (CHAR8 *) String;

+      }

+      return RETURN_UNSUPPORTED;

+    }

+

+    *Data = (*Data << 4) + InternalAsciiHexCharToUintn (*String);

+    String++;

+  }

+

+  if (EndPointer != NULL) {

+    *EndPointer = (CHAR8 *) String;

+  }

+  return RETURN_SUCCESS;

+}

+

+/**

+  Convert a Null-terminated Ascii hexadecimal string to a value of type UINT64.

+

+  This function outputs a value of type UINT64 by interpreting the contents of

+  the Ascii string specified by String as a hexadecimal number. The format of

+  the input Ascii string String is:

+

+                  [spaces][zeros][x][hexadecimal digits].

+

+  The valid hexadecimal digit character is in the range [0-9], [a-f] and [A-F].

+  The prefix "0x" is optional. Both "x" and "X" is allowed in "0x" prefix. If

+  "x" appears in the input string, it must be prefixed with at least one 0. The

+  function will ignore the pad space, which includes spaces or tab characters,

+  before [zeros], [x] or [hexadecimal digits]. The running zero before [x] or

+  [hexadecimal digits] will be ignored. Then, the decoding starts after [x] or

+  the first valid hexadecimal digit. Then, the function stops at the first

+  character that is a not a valid hexadecimal character or Null-terminator,

+  whichever on comes first.

+

+  If String has no valid hexadecimal digits in the above format, then 0 is

+  stored at the location pointed to by Data.

+  If the number represented by String exceeds the range defined by UINT64, then

+  MAX_UINT64 is stored at the location pointed to by Data.

+

+  If EndPointer is not NULL, a pointer to the character that stopped the scan

+  is stored at the location pointed to by EndPointer. If String has no valid

+  hexadecimal digits right after the optional pad spaces, the value of String

+  is stored at the location pointed to by EndPointer.

+

+  @param  String                   Pointer to a Null-terminated Ascii string.

+  @param  EndPointer               Pointer to character that stops scan.

+  @param  Data                     Pointer to the converted value.

+

+  @retval RETURN_SUCCESS           Value is translated from String.

+  @retval RETURN_INVALID_PARAMETER If String is NULL.

+                                   If Data is NULL.

+                                   If PcdMaximumAsciiStringLength is not zero,

+                                   and String contains more than

+                                   PcdMaximumAsciiStringLength Ascii

+                                   characters, not including the

+                                   Null-terminator.

+  @retval RETURN_UNSUPPORTED       If the number represented by String exceeds

+                                   the range defined by UINT64.

+

+**/

+RETURN_STATUS

+EFIAPI

+AsciiStrHexToUint64S (

+  IN  CONST CHAR8              *String,

+  OUT       CHAR8              **EndPointer,  OPTIONAL

+  OUT       UINT64             *Data

+  )

+{

+  //

+  // 1. Neither String nor Data shall be a null pointer.

+  //

+  SAFE_STRING_CONSTRAINT_CHECK ((String != NULL), RETURN_INVALID_PARAMETER);

+  SAFE_STRING_CONSTRAINT_CHECK ((Data != NULL), RETURN_INVALID_PARAMETER);

+

+  //

+  // 2. The length of String shall not be greater than ASCII_RSIZE_MAX.

+  //

+  if (ASCII_RSIZE_MAX != 0) {

+    SAFE_STRING_CONSTRAINT_CHECK ((AsciiStrnLenS (String, ASCII_RSIZE_MAX + 1) <= ASCII_RSIZE_MAX), RETURN_INVALID_PARAMETER);

+  }

+

+  if (EndPointer != NULL) {

+    *EndPointer = (CHAR8 *) String;

+  }

+

+  //

+  // Ignore the pad spaces (space or tab)

+  //

+  while ((*String == ' ') || (*String == '\t')) {

+    String++;

+  }

+

+  //

+  // Ignore leading Zeros after the spaces

+  //

+  while (*String == '0') {

+    String++;

+  }

+

+  if (AsciiCharToUpper (*String) == 'X') {

+    if (*(String - 1) != '0') {

+      *Data = 0;

+      return RETURN_SUCCESS;

+    }

+    //

+    // Skip the 'X'

+    //

+    String++;

+  }

+

+  *Data = 0;

+

+  while (InternalAsciiIsHexaDecimalDigitCharacter (*String)) {

+    //

+    // If the number represented by String overflows according to the range

+    // defined by UINT64, then MAX_UINT64 is stored in *Data and

+    // RETURN_UNSUPPORTED is returned.

+    //

+    if (*Data > RShiftU64 (MAX_UINT64 - InternalAsciiHexCharToUintn (*String), 4)) {

+      *Data = MAX_UINT64;

+      if (EndPointer != NULL) {

+        *EndPointer = (CHAR8 *) String;

+      }

+      return RETURN_UNSUPPORTED;

+    }

+

+    *Data = LShiftU64 (*Data, 4) + InternalAsciiHexCharToUintn (*String);

+    String++;

+  }

+

+  if (EndPointer != NULL) {

+    *EndPointer = (CHAR8 *) String;

+  }

+  return RETURN_SUCCESS;

+}

+

+/**

+  Convert a Null-terminated Unicode string to a Null-terminated

+  ASCII string.

+

+  This function is similar to AsciiStrCpyS.

+

+  This function converts the content of the Unicode string Source

+  to the ASCII string Destination by copying the lower 8 bits of

+  each Unicode character. The function terminates the ASCII string

+  Destination by appending a Null-terminator character at the end.

+

+  The caller is responsible to make sure Destination points to a buffer with size

+  equal or greater than ((StrLen (Source) + 1) * sizeof (CHAR8)) in bytes.

+

+  If any Unicode characters in Source contain non-zero value in

+  the upper 8 bits, then ASSERT().

+

+  If Source is not aligned on a 16-bit boundary, then ASSERT().

+

+  If an error is returned, then the Destination is unmodified.

+

+  @param  Source        The pointer to a Null-terminated Unicode string.

+  @param  Destination   The pointer to a Null-terminated ASCII string.

+  @param  DestMax       The maximum number of Destination Ascii

+                        char, including terminating null char.

+

+  @retval RETURN_SUCCESS           String is converted.

+  @retval RETURN_BUFFER_TOO_SMALL  If DestMax is NOT greater than StrLen(Source).

+  @retval RETURN_INVALID_PARAMETER If Destination is NULL.

+                                   If Source is NULL.

+                                   If PcdMaximumAsciiStringLength is not zero,

+                                    and DestMax is greater than

+                                    PcdMaximumAsciiStringLength.

+                                   If PcdMaximumUnicodeStringLength is not zero,

+                                    and DestMax is greater than

+                                    PcdMaximumUnicodeStringLength.

+                                   If DestMax is 0.

+  @retval RETURN_ACCESS_DENIED     If Source and Destination overlap.

+

+**/

+RETURN_STATUS

+EFIAPI

+UnicodeStrToAsciiStrS (

+  IN      CONST CHAR16              *Source,

+  OUT     CHAR8                     *Destination,

+  IN      UINTN                     DestMax

+  )

+{

+  UINTN            SourceLen;

+

+  ASSERT (((UINTN) Source & BIT0) == 0);

+

+  //

+  // 1. Neither Destination nor Source shall be a null pointer.

+  //

+  SAFE_STRING_CONSTRAINT_CHECK ((Destination != NULL), RETURN_INVALID_PARAMETER);

+  SAFE_STRING_CONSTRAINT_CHECK ((Source != NULL), RETURN_INVALID_PARAMETER);

+

+  //

+  // 2. DestMax shall not be greater than ASCII_RSIZE_MAX or RSIZE_MAX.

+  //

+  if (ASCII_RSIZE_MAX != 0) {

+    SAFE_STRING_CONSTRAINT_CHECK ((DestMax <= ASCII_RSIZE_MAX), RETURN_INVALID_PARAMETER);

+  }

+  if (RSIZE_MAX != 0) {

+    SAFE_STRING_CONSTRAINT_CHECK ((DestMax <= RSIZE_MAX), RETURN_INVALID_PARAMETER);

+  }

+

+  //

+  // 3. DestMax shall not equal zero.

+  //

+  SAFE_STRING_CONSTRAINT_CHECK ((DestMax != 0), RETURN_INVALID_PARAMETER);

+

+  //

+  // 4. DestMax shall be greater than StrnLenS (Source, DestMax).

+  //

+  SourceLen = StrnLenS (Source, DestMax);

+  SAFE_STRING_CONSTRAINT_CHECK ((DestMax > SourceLen), RETURN_BUFFER_TOO_SMALL);

+

+  //

+  // 5. Copying shall not take place between objects that overlap.

+  //

+  SAFE_STRING_CONSTRAINT_CHECK (!InternalSafeStringIsOverlap (Destination, DestMax, (VOID *)Source, (SourceLen + 1) * sizeof(CHAR16)), RETURN_ACCESS_DENIED);

+

+  //

+  // convert string

+  //

+  while (*Source != '\0') {

+    //

+    // If any Unicode characters in Source contain

+    // non-zero value in the upper 8 bits, then ASSERT().

+    //

+    ASSERT (*Source < 0x100);

+    *(Destination++) = (CHAR8) *(Source++);

+  }

+  *Destination = '\0';

+

+  return RETURN_SUCCESS;

+}

+

+/**

+  Convert not more than Length successive characters from a Null-terminated

+  Unicode string to a Null-terminated Ascii string. If no null char is copied

+  from Source, then Destination[Length] is always set to null.

+

+  This function converts not more than Length successive characters from the

+  Unicode string Source to the Ascii string Destination by copying the lower 8

+  bits of each Unicode character. The function terminates the Ascii string

+  Destination by appending a Null-terminator character at the end.

+

+  The caller is responsible to make sure Destination points to a buffer with

+  size not smaller than ((MIN(StrLen(Source), Length) + 1) * sizeof (CHAR8))

+  in bytes.

+

+  If any Unicode characters in Source contain non-zero value in the upper 8

+  bits, then ASSERT().

+  If Source is not aligned on a 16-bit boundary, then ASSERT().

+

+  If an error is returned, then Destination and DestinationLength are

+  unmodified.

+

+  @param  Source             The pointer to a Null-terminated Unicode string.

+  @param  Length             The maximum number of Unicode characters to

+                             convert.

+  @param  Destination        The pointer to a Null-terminated Ascii string.

+  @param  DestMax            The maximum number of Destination Ascii char,

+                             including terminating null char.

+  @param  DestinationLength  The number of Unicode characters converted.

+

+  @retval RETURN_SUCCESS            String is converted.

+  @retval RETURN_INVALID_PARAMETER  If Destination is NULL.

+                                    If Source is NULL.

+                                    If DestinationLength is NULL.

+                                    If PcdMaximumAsciiStringLength is not zero,

+                                    and Length or DestMax is greater than

+                                    PcdMaximumAsciiStringLength.

+                                    If PcdMaximumUnicodeStringLength is not

+                                    zero, and Length or DestMax is greater than

+                                    PcdMaximumUnicodeStringLength.

+                                    If DestMax is 0.

+  @retval RETURN_BUFFER_TOO_SMALL   If DestMax is NOT greater than

+                                    MIN(StrLen(Source), Length).

+  @retval RETURN_ACCESS_DENIED      If Source and Destination overlap.

+

+**/

+RETURN_STATUS

+EFIAPI

+UnicodeStrnToAsciiStrS (

+  IN      CONST CHAR16              *Source,

+  IN      UINTN                     Length,

+  OUT     CHAR8                     *Destination,

+  IN      UINTN                     DestMax,

+  OUT     UINTN                     *DestinationLength

+  )

+{

+  UINTN            SourceLen;

+

+  ASSERT (((UINTN) Source & BIT0) == 0);

+

+  //

+  // 1. None of Destination, Source or DestinationLength shall be a null

+  // pointer.

+  //

+  SAFE_STRING_CONSTRAINT_CHECK ((Destination != NULL), RETURN_INVALID_PARAMETER);

+  SAFE_STRING_CONSTRAINT_CHECK ((Source != NULL), RETURN_INVALID_PARAMETER);

+  SAFE_STRING_CONSTRAINT_CHECK ((DestinationLength != NULL), RETURN_INVALID_PARAMETER);

+

+  //

+  // 2. Neither Length nor DestMax shall be greater than ASCII_RSIZE_MAX or

+  // RSIZE_MAX.

+  //

+  if (ASCII_RSIZE_MAX != 0) {

+    SAFE_STRING_CONSTRAINT_CHECK ((Length <= ASCII_RSIZE_MAX), RETURN_INVALID_PARAMETER);

+    SAFE_STRING_CONSTRAINT_CHECK ((DestMax <= ASCII_RSIZE_MAX), RETURN_INVALID_PARAMETER);

+  }

+  if (RSIZE_MAX != 0) {

+    SAFE_STRING_CONSTRAINT_CHECK ((Length <= RSIZE_MAX), RETURN_INVALID_PARAMETER);

+    SAFE_STRING_CONSTRAINT_CHECK ((DestMax <= RSIZE_MAX), RETURN_INVALID_PARAMETER);

+  }

+

+  //

+  // 3. DestMax shall not equal zero.

+  //

+  SAFE_STRING_CONSTRAINT_CHECK ((DestMax != 0), RETURN_INVALID_PARAMETER);

+

+  //

+  // 4. If Length is not less than DestMax, then DestMax shall be greater than

+  // StrnLenS(Source, DestMax).

+  //

+  SourceLen = StrnLenS (Source, DestMax);

+  if (Length >= DestMax) {

+    SAFE_STRING_CONSTRAINT_CHECK ((DestMax > SourceLen), RETURN_BUFFER_TOO_SMALL);

+  }

+

+  //

+  // 5. Copying shall not take place between objects that overlap.

+  //

+  if (SourceLen > Length) {

+    SourceLen = Length;

+  }

+  SAFE_STRING_CONSTRAINT_CHECK (!InternalSafeStringIsOverlap (Destination, DestMax, (VOID *)Source, (SourceLen + 1) * sizeof(CHAR16)), RETURN_ACCESS_DENIED);

+

+  *DestinationLength = 0;

+

+  //

+  // Convert string

+  //

+  while ((*Source != 0) && (SourceLen > 0)) {

+    //

+    // If any Unicode characters in Source contain non-zero value in the upper

+    // 8 bits, then ASSERT().

+    //

+    ASSERT (*Source < 0x100);

+    *(Destination++) = (CHAR8) *(Source++);

+    SourceLen--;

+    (*DestinationLength)++;

+  }

+  *Destination = 0;

+

+  return RETURN_SUCCESS;

+}

+

+/**

+  Convert one Null-terminated ASCII string to a Null-terminated

+  Unicode string.

+

+  This function is similar to StrCpyS.

+

+  This function converts the contents of the ASCII string Source to the Unicode

+  string Destination. The function terminates the Unicode string Destination by

+  appending a Null-terminator character at the end.

+

+  The caller is responsible to make sure Destination points to a buffer with size

+  equal or greater than ((AsciiStrLen (Source) + 1) * sizeof (CHAR16)) in bytes.

+

+  If Destination is not aligned on a 16-bit boundary, then ASSERT().

+

+  If an error is returned, then the Destination is unmodified.

+

+  @param  Source        The pointer to a Null-terminated ASCII string.

+  @param  Destination   The pointer to a Null-terminated Unicode string.

+  @param  DestMax       The maximum number of Destination Unicode

+                        char, including terminating null char.

+

+  @retval RETURN_SUCCESS           String is converted.

+  @retval RETURN_BUFFER_TOO_SMALL  If DestMax is NOT greater than StrLen(Source).

+  @retval RETURN_INVALID_PARAMETER If Destination is NULL.

+                                   If Source is NULL.

+                                   If PcdMaximumUnicodeStringLength is not zero,

+                                    and DestMax is greater than

+                                    PcdMaximumUnicodeStringLength.

+                                   If PcdMaximumAsciiStringLength is not zero,

+                                    and DestMax is greater than

+                                    PcdMaximumAsciiStringLength.

+                                   If DestMax is 0.

+  @retval RETURN_ACCESS_DENIED     If Source and Destination overlap.

+

+**/

+RETURN_STATUS

+EFIAPI

+AsciiStrToUnicodeStrS (

+  IN      CONST CHAR8               *Source,

+  OUT     CHAR16                    *Destination,

+  IN      UINTN                     DestMax

+  )

+{

+  UINTN            SourceLen;

+

+  ASSERT (((UINTN) Destination & BIT0) == 0);

+

+  //

+  // 1. Neither Destination nor Source shall be a null pointer.

+  //

+  SAFE_STRING_CONSTRAINT_CHECK ((Destination != NULL), RETURN_INVALID_PARAMETER);

+  SAFE_STRING_CONSTRAINT_CHECK ((Source != NULL), RETURN_INVALID_PARAMETER);

+

+  //

+  // 2. DestMax shall not be greater than RSIZE_MAX or ASCII_RSIZE_MAX.

+  //

+  if (RSIZE_MAX != 0) {

+    SAFE_STRING_CONSTRAINT_CHECK ((DestMax <= RSIZE_MAX), RETURN_INVALID_PARAMETER);

+  }

+  if (ASCII_RSIZE_MAX != 0) {

+    SAFE_STRING_CONSTRAINT_CHECK ((DestMax <= ASCII_RSIZE_MAX), RETURN_INVALID_PARAMETER);

+  }

+

+  //

+  // 3. DestMax shall not equal zero.

+  //

+  SAFE_STRING_CONSTRAINT_CHECK ((DestMax != 0), RETURN_INVALID_PARAMETER);

+

+  //

+  // 4. DestMax shall be greater than AsciiStrnLenS(Source, DestMax).

+  //

+  SourceLen = AsciiStrnLenS (Source, DestMax);

+  SAFE_STRING_CONSTRAINT_CHECK ((DestMax > SourceLen), RETURN_BUFFER_TOO_SMALL);

+

+  //

+  // 5. Copying shall not take place between objects that overlap.

+  //

+  SAFE_STRING_CONSTRAINT_CHECK (!InternalSafeStringIsOverlap (Destination, DestMax * sizeof(CHAR16), (VOID *)Source, SourceLen + 1), RETURN_ACCESS_DENIED);

+

+  //

+  // Convert string

+  //

+  while (*Source != '\0') {

+    *(Destination++) = (CHAR16)(UINT8)*(Source++);

+  }

+  *Destination = '\0';

+

+  return RETURN_SUCCESS;

+}

+

+/**

+  Convert not more than Length successive characters from a Null-terminated

+  Ascii string to a Null-terminated Unicode string. If no null char is copied

+  from Source, then Destination[Length] is always set to null.

+

+  This function converts not more than Length successive characters from the

+  Ascii string Source to the Unicode string Destination. The function

+  terminates the Unicode string Destination by appending a Null-terminator

+  character at the end.

+

+  The caller is responsible to make sure Destination points to a buffer with

+  size not smaller than

+  ((MIN(AsciiStrLen(Source), Length) + 1) * sizeof (CHAR8)) in bytes.

+

+  If Destination is not aligned on a 16-bit boundary, then ASSERT().

+

+  If an error is returned, then Destination and DestinationLength are

+  unmodified.

+

+  @param  Source             The pointer to a Null-terminated Ascii string.

+  @param  Length             The maximum number of Ascii characters to convert.

+  @param  Destination        The pointer to a Null-terminated Unicode string.

+  @param  DestMax            The maximum number of Destination Unicode char,

+                             including terminating null char.

+  @param  DestinationLength  The number of Ascii characters converted.

+

+  @retval RETURN_SUCCESS            String is converted.

+  @retval RETURN_INVALID_PARAMETER  If Destination is NULL.

+                                    If Source is NULL.

+                                    If DestinationLength is NULL.

+                                    If PcdMaximumUnicodeStringLength is not

+                                    zero, and Length or DestMax is greater than

+                                    PcdMaximumUnicodeStringLength.

+                                    If PcdMaximumAsciiStringLength is not zero,

+                                    and Length or DestMax is greater than

+                                    PcdMaximumAsciiStringLength.

+                                    If DestMax is 0.

+  @retval RETURN_BUFFER_TOO_SMALL   If DestMax is NOT greater than

+                                    MIN(AsciiStrLen(Source), Length).

+  @retval RETURN_ACCESS_DENIED      If Source and Destination overlap.

+

+**/

+RETURN_STATUS

+EFIAPI

+AsciiStrnToUnicodeStrS (

+  IN      CONST CHAR8               *Source,

+  IN      UINTN                     Length,

+  OUT     CHAR16                    *Destination,

+  IN      UINTN                     DestMax,

+  OUT     UINTN                     *DestinationLength

+  )

+{

+  UINTN            SourceLen;

+

+  ASSERT (((UINTN) Destination & BIT0) == 0);

+

+  //

+  // 1. None of Destination, Source or DestinationLength shall be a null

+  // pointer.

+  //

+  SAFE_STRING_CONSTRAINT_CHECK ((Destination != NULL), RETURN_INVALID_PARAMETER);

+  SAFE_STRING_CONSTRAINT_CHECK ((Source != NULL), RETURN_INVALID_PARAMETER);

+  SAFE_STRING_CONSTRAINT_CHECK ((DestinationLength != NULL), RETURN_INVALID_PARAMETER);

+

+  //

+  // 2. Neither Length nor DestMax shall be greater than ASCII_RSIZE_MAX or

+  // RSIZE_MAX.

+  //

+  if (RSIZE_MAX != 0) {

+    SAFE_STRING_CONSTRAINT_CHECK ((Length <= RSIZE_MAX), RETURN_INVALID_PARAMETER);

+    SAFE_STRING_CONSTRAINT_CHECK ((DestMax <= RSIZE_MAX), RETURN_INVALID_PARAMETER);

+  }

+  if (ASCII_RSIZE_MAX != 0) {

+    SAFE_STRING_CONSTRAINT_CHECK ((Length <= ASCII_RSIZE_MAX), RETURN_INVALID_PARAMETER);

+    SAFE_STRING_CONSTRAINT_CHECK ((DestMax <= ASCII_RSIZE_MAX), RETURN_INVALID_PARAMETER);

+  }

+

+  //

+  // 3. DestMax shall not equal zero.

+  //

+  SAFE_STRING_CONSTRAINT_CHECK ((DestMax != 0), RETURN_INVALID_PARAMETER);

+

+  //

+  // 4. If Length is not less than DestMax, then DestMax shall be greater than

+  // AsciiStrnLenS(Source, DestMax).

+  //

+  SourceLen = AsciiStrnLenS (Source, DestMax);

+  if (Length >= DestMax) {

+    SAFE_STRING_CONSTRAINT_CHECK ((DestMax > SourceLen), RETURN_BUFFER_TOO_SMALL);

+  }

+

+  //

+  // 5. Copying shall not take place between objects that overlap.

+  //

+  if (SourceLen > Length) {

+    SourceLen = Length;

+  }

+  SAFE_STRING_CONSTRAINT_CHECK (!InternalSafeStringIsOverlap (Destination, DestMax * sizeof(CHAR16), (VOID *)Source, SourceLen + 1), RETURN_ACCESS_DENIED);

+

+  *DestinationLength = 0;

+

+  //

+  // Convert string

+  //

+  while ((*Source != 0) && (SourceLen > 0)) {

+    *(Destination++) = (CHAR16)(UINT8)*(Source++);

+    SourceLen--;

+    (*DestinationLength)++;

+  }

+  *Destination = 0;

+

+  return RETURN_SUCCESS;

+}

+

+/**

+  Convert a Null-terminated ASCII string to IPv6 address and prefix length.

+

+  This function outputs a value of type IPv6_ADDRESS and may output a value

+  of type UINT8 by interpreting the contents of the ASCII string specified

+  by String. The format of the input ASCII string String is as follows:

+

+                  X:X:X:X:X:X:X:X[/P]

+

+  X contains one to four hexadecimal digit characters in the range [0-9], [a-f] and

+  [A-F]. X is converted to a value of type UINT16, whose low byte is stored in low

+  memory address and high byte is stored in high memory address. P contains decimal

+  digit characters in the range [0-9]. The running zero in the beginning of P will

+  be ignored. /P is optional.

+

+  When /P is not in the String, the function stops at the first character that is

+  not a valid hexadecimal digit character after eight X's are converted.

+

+  When /P is in the String, the function stops at the first character that is not

+  a valid decimal digit character after P is converted.

+

+  "::" can be used to compress one or more groups of X when X contains only 0.

+  The "::" can only appear once in the String.

+

+  If EndPointer is not NULL and Address is translated from String, a pointer

+  to the character that stopped the scan is stored at the location pointed to

+  by EndPointer.

+

+  @param  String                   Pointer to a Null-terminated ASCII string.

+  @param  EndPointer               Pointer to character that stops scan.

+  @param  Address                  Pointer to the converted IPv6 address.

+  @param  PrefixLength             Pointer to the converted IPv6 address prefix

+                                   length. MAX_UINT8 is returned when /P is

+                                   not in the String.

+

+  @retval RETURN_SUCCESS           Address is translated from String.

+  @retval RETURN_INVALID_PARAMETER If String is NULL.

+                                   If Data is NULL.

+  @retval RETURN_UNSUPPORTED       If X contains more than four hexadecimal

+                                    digit characters.

+                                   If String contains "::" and number of X

+                                    is not less than 8.

+                                   If P starts with character that is not a

+                                    valid decimal digit character.

+                                   If the decimal number converted from P

+                                    exceeds 128.

+

+**/

+RETURN_STATUS

+EFIAPI

+AsciiStrToIpv6Address (

+  IN  CONST CHAR8        *String,

+  OUT CHAR8              **EndPointer, OPTIONAL

+  OUT IPv6_ADDRESS       *Address,

+  OUT UINT8              *PrefixLength OPTIONAL

+  )

+{

+  RETURN_STATUS          Status;

+  UINTN                  AddressIndex;

+  UINTN                  Uintn;

+  IPv6_ADDRESS           LocalAddress;

+  UINT8                  LocalPrefixLength;

+  CONST CHAR8            *Pointer;

+  CHAR8                  *End;

+  UINTN                  CompressStart;

+  BOOLEAN                ExpectPrefix;

+

+  LocalPrefixLength = MAX_UINT8;

+  CompressStart     = ARRAY_SIZE (Address->Addr);

+  ExpectPrefix      = FALSE;

+

+  //

+  // None of String or Address shall be a null pointer.

+  //

+  SAFE_STRING_CONSTRAINT_CHECK ((String != NULL), RETURN_INVALID_PARAMETER);

+  SAFE_STRING_CONSTRAINT_CHECK ((Address != NULL), RETURN_INVALID_PARAMETER);

+

+  for (Pointer = String, AddressIndex = 0; AddressIndex < ARRAY_SIZE (Address->Addr) + 1;) {

+    if (!InternalAsciiIsHexaDecimalDigitCharacter (*Pointer)) {

+      if (*Pointer != ':') {

+        //

+        // ":" or "/" should be followed by digit characters.

+        //

+        return RETURN_UNSUPPORTED;

+      }

+

+      //

+      // Meet second ":" after previous ":" or "/"

+      // or meet first ":" in the beginning of String.

+      //

+      if (ExpectPrefix) {

+        //

+        // ":" shall not be after "/"

+        //

+        return RETURN_UNSUPPORTED;

+      }

+

+      if (CompressStart != ARRAY_SIZE (Address->Addr) || AddressIndex == ARRAY_SIZE (Address->Addr)) {

+        //

+        // "::" can only appear once.

+        // "::" can only appear when address is not full length.

+        //

+        return RETURN_UNSUPPORTED;

+      } else {

+        //

+        // Remember the start of zero compressing.

+        //

+        CompressStart = AddressIndex;

+        Pointer++;

+

+        if (CompressStart == 0) {

+          if (*Pointer != ':') {

+            //

+            // Single ":" shall not be in the beginning of String.

+            //

+            return RETURN_UNSUPPORTED;

+          }

+          Pointer++;

+        }

+      }

+    }

+

+    if (!InternalAsciiIsHexaDecimalDigitCharacter (*Pointer)) {

+      if (*Pointer == '/') {

+        //

+        // Might be optional "/P" after "::".

+        //

+        if (CompressStart != AddressIndex) {

+          return RETURN_UNSUPPORTED;

+        }

+      } else {

+        break;

+      }

+    } else {

+      if (!ExpectPrefix) {

+        //

+        // Get X.

+        //

+        Status = AsciiStrHexToUintnS (Pointer, &End, &Uintn);

+        if (RETURN_ERROR (Status) || End - Pointer > 4) {

+          //

+          // Number of hexadecimal digit characters is no more than 4.

+          //

+          return RETURN_UNSUPPORTED;

+        }

+        Pointer = End;

+        //

+        // Uintn won't exceed MAX_UINT16 if number of hexadecimal digit characters is no more than 4.

+        //

+        ASSERT (AddressIndex + 1 < ARRAY_SIZE (Address->Addr));

+        LocalAddress.Addr[AddressIndex] = (UINT8) ((UINT16) Uintn >> 8);

+        LocalAddress.Addr[AddressIndex + 1] = (UINT8) Uintn;

+        AddressIndex += 2;

+      } else {

+        //

+        // Get P, then exit the loop.

+        //

+        Status = AsciiStrDecimalToUintnS (Pointer, &End, &Uintn);

+        if (RETURN_ERROR (Status) || End == Pointer || Uintn > 128) {

+          //

+          // Prefix length should not exceed 128.

+          //

+          return RETURN_UNSUPPORTED;

+        }

+        LocalPrefixLength = (UINT8) Uintn;

+        Pointer = End;

+        break;

+      }

+    }

+

+    //

+    // Skip ':' or "/"

+    //

+    if (*Pointer == '/') {

+      ExpectPrefix = TRUE;

+    } else if (*Pointer == ':') {

+      if (AddressIndex == ARRAY_SIZE (Address->Addr)) {

+        //

+        // Meet additional ":" after all 8 16-bit address

+        //

+        break;

+      }

+    } else {

+      //

+      // Meet other character that is not "/" or ":" after all 8 16-bit address

+      //

+      break;

+    }

+    Pointer++;

+  }

+

+  if ((AddressIndex == ARRAY_SIZE (Address->Addr) && CompressStart != ARRAY_SIZE (Address->Addr)) ||

+    (AddressIndex != ARRAY_SIZE (Address->Addr) && CompressStart == ARRAY_SIZE (Address->Addr))

+      ) {

+    //

+    // Full length of address shall not have compressing zeros.

+    // Non-full length of address shall have compressing zeros.

+    //

+    return RETURN_UNSUPPORTED;

+  }

+  CopyMem (&Address->Addr[0], &LocalAddress.Addr[0], CompressStart);

+  ZeroMem (&Address->Addr[CompressStart], ARRAY_SIZE (Address->Addr) - AddressIndex);

+  if (AddressIndex > CompressStart) {

+    CopyMem (

+      &Address->Addr[CompressStart + ARRAY_SIZE (Address->Addr) - AddressIndex],

+      &LocalAddress.Addr[CompressStart],

+      AddressIndex - CompressStart

+      );

+

+  }

+

+  if (PrefixLength != NULL) {

+    *PrefixLength = LocalPrefixLength;

+  }

+  if (EndPointer != NULL) {

+    *EndPointer = (CHAR8 *) Pointer;

+  }

+

+  return RETURN_SUCCESS;

+}

+

+/**

+  Convert a Null-terminated ASCII string to IPv4 address and prefix length.

+

+  This function outputs a value of type IPv4_ADDRESS and may output a value

+  of type UINT8 by interpreting the contents of the ASCII string specified

+  by String. The format of the input ASCII string String is as follows:

+

+                  D.D.D.D[/P]

+

+  D and P are decimal digit characters in the range [0-9]. The running zero in

+  the beginning of D and P will be ignored. /P is optional.

+

+  When /P is not in the String, the function stops at the first character that is

+  not a valid decimal digit character after four D's are converted.

+

+  When /P is in the String, the function stops at the first character that is not

+  a valid decimal digit character after P is converted.

+

+  If EndPointer is not NULL and Address is translated from String, a pointer

+  to the character that stopped the scan is stored at the location pointed to

+  by EndPointer.

+

+  @param  String                   Pointer to a Null-terminated ASCII string.

+  @param  EndPointer               Pointer to character that stops scan.

+  @param  Address                  Pointer to the converted IPv4 address.

+  @param  PrefixLength             Pointer to the converted IPv4 address prefix

+                                   length. MAX_UINT8 is returned when /P is

+                                   not in the String.

+

+  @retval RETURN_SUCCESS           Address is translated from String.

+  @retval RETURN_INVALID_PARAMETER If String is NULL.

+                                   If Data is NULL.

+  @retval RETURN_UNSUPPORTED       If String is not in the correct format.

+                                   If any decimal number converted from D

+                                    exceeds 255.

+                                   If the decimal number converted from P

+                                    exceeds 32.

+

+**/

+RETURN_STATUS

+EFIAPI

+AsciiStrToIpv4Address (

+  IN  CONST CHAR8        *String,

+  OUT CHAR8              **EndPointer, OPTIONAL

+  OUT IPv4_ADDRESS       *Address,

+  OUT UINT8              *PrefixLength OPTIONAL

+  )

+{

+  RETURN_STATUS          Status;

+  UINTN                  AddressIndex;

+  UINTN                  Uintn;

+  IPv4_ADDRESS           LocalAddress;

+  UINT8                  LocalPrefixLength;

+  CHAR8                  *Pointer;

+

+  LocalPrefixLength = MAX_UINT8;

+

+  //

+  // None of String or Address shall be a null pointer.

+  //

+  SAFE_STRING_CONSTRAINT_CHECK ((String != NULL), RETURN_INVALID_PARAMETER);

+  SAFE_STRING_CONSTRAINT_CHECK ((Address != NULL), RETURN_INVALID_PARAMETER);

+

+  for (Pointer = (CHAR8 *) String, AddressIndex = 0; AddressIndex < ARRAY_SIZE (Address->Addr) + 1;) {

+    if (!InternalAsciiIsDecimalDigitCharacter (*Pointer)) {

+      //

+      // D or P contains invalid characters.

+      //

+      break;

+    }

+

+    //

+    // Get D or P.

+    //

+    Status = AsciiStrDecimalToUintnS ((CONST CHAR8 *) Pointer, &Pointer, &Uintn);

+    if (RETURN_ERROR (Status)) {

+      return RETURN_UNSUPPORTED;

+    }

+    if (AddressIndex == ARRAY_SIZE (Address->Addr)) {

+      //

+      // It's P.

+      //

+      if (Uintn > 32) {

+        return RETURN_UNSUPPORTED;

+      }

+      LocalPrefixLength = (UINT8) Uintn;

+    } else {

+      //

+      // It's D.

+      //

+      if (Uintn > MAX_UINT8) {

+        return RETURN_UNSUPPORTED;

+      }

+      LocalAddress.Addr[AddressIndex] = (UINT8) Uintn;

+      AddressIndex++;

+    }

+

+    //

+    // Check the '.' or '/', depending on the AddressIndex.

+    //

+    if (AddressIndex == ARRAY_SIZE (Address->Addr)) {

+      if (*Pointer == '/') {

+        //

+        // '/P' is in the String.

+        // Skip "/" and get P in next loop.

+        //

+        Pointer++;

+      } else {

+        //

+        // '/P' is not in the String.

+        //

+        break;

+      }

+    } else if (AddressIndex < ARRAY_SIZE (Address->Addr)) {

+      if (*Pointer == '.') {

+        //

+        // D should be followed by '.'

+        //

+        Pointer++;

+      } else {

+        return RETURN_UNSUPPORTED;

+      }

+    }

+  }

+

+  if (AddressIndex < ARRAY_SIZE (Address->Addr)) {

+    return RETURN_UNSUPPORTED;

+  }

+

+  CopyMem (Address, &LocalAddress, sizeof (*Address));

+  if (PrefixLength != NULL) {

+    *PrefixLength = LocalPrefixLength;

+  }

+  if (EndPointer != NULL) {

+    *EndPointer = Pointer;

+  }

+

+  return RETURN_SUCCESS;

+}

+

+/**

+  Convert a Null-terminated ASCII GUID string to a value of type

+  EFI_GUID.

+

+  This function outputs a GUID value by interpreting the contents of

+  the ASCII string specified by String. The format of the input

+  ASCII string String consists of 36 characters, as follows:

+

+                  aabbccdd-eeff-gghh-iijj-kkllmmnnoopp

+

+  The pairs aa - pp are two characters in the range [0-9], [a-f] and

+  [A-F], with each pair representing a single byte hexadecimal value.

+

+  The mapping between String and the EFI_GUID structure is as follows:

+                  aa          Data1[24:31]

+                  bb          Data1[16:23]

+                  cc          Data1[8:15]

+                  dd          Data1[0:7]

+                  ee          Data2[8:15]

+                  ff          Data2[0:7]

+                  gg          Data3[8:15]

+                  hh          Data3[0:7]

+                  ii          Data4[0:7]

+                  jj          Data4[8:15]

+                  kk          Data4[16:23]

+                  ll          Data4[24:31]

+                  mm          Data4[32:39]

+                  nn          Data4[40:47]

+                  oo          Data4[48:55]

+                  pp          Data4[56:63]

+

+  @param  String                   Pointer to a Null-terminated ASCII string.

+  @param  Guid                     Pointer to the converted GUID.

+

+  @retval RETURN_SUCCESS           Guid is translated from String.

+  @retval RETURN_INVALID_PARAMETER If String is NULL.

+                                   If Data is NULL.

+  @retval RETURN_UNSUPPORTED       If String is not as the above format.

+

+**/

+RETURN_STATUS

+EFIAPI

+AsciiStrToGuid (

+  IN  CONST CHAR8        *String,

+  OUT GUID               *Guid

+  )

+{

+  RETURN_STATUS          Status;

+  GUID                   LocalGuid;

+

+  //

+  // None of String or Guid shall be a null pointer.

+  //

+  SAFE_STRING_CONSTRAINT_CHECK ((String != NULL), RETURN_INVALID_PARAMETER);

+  SAFE_STRING_CONSTRAINT_CHECK ((Guid != NULL), RETURN_INVALID_PARAMETER);

+

+  //

+  // Get aabbccdd in big-endian.

+  //

+  Status = AsciiStrHexToBytes (String, 2 * sizeof (LocalGuid.Data1), (UINT8 *) &LocalGuid.Data1, sizeof (LocalGuid.Data1));

+  if (RETURN_ERROR (Status) || String[2 * sizeof (LocalGuid.Data1)] != '-') {

+    return RETURN_UNSUPPORTED;

+  }

+  //

+  // Convert big-endian to little-endian.

+  //

+  LocalGuid.Data1 = SwapBytes32 (LocalGuid.Data1);

+  String += 2 * sizeof (LocalGuid.Data1) + 1;

+

+  //

+  // Get eeff in big-endian.

+  //

+  Status = AsciiStrHexToBytes (String, 2 * sizeof (LocalGuid.Data2), (UINT8 *) &LocalGuid.Data2, sizeof (LocalGuid.Data2));

+  if (RETURN_ERROR (Status) || String[2 * sizeof (LocalGuid.Data2)] != '-') {

+    return RETURN_UNSUPPORTED;

+  }

+  //

+  // Convert big-endian to little-endian.

+  //

+  LocalGuid.Data2 = SwapBytes16 (LocalGuid.Data2);

+  String += 2 * sizeof (LocalGuid.Data2) + 1;

+

+  //

+  // Get gghh in big-endian.

+  //

+  Status = AsciiStrHexToBytes (String, 2 * sizeof (LocalGuid.Data3), (UINT8 *) &LocalGuid.Data3, sizeof (LocalGuid.Data3));

+  if (RETURN_ERROR (Status) || String[2 * sizeof (LocalGuid.Data3)] != '-') {

+    return RETURN_UNSUPPORTED;

+  }

+  //

+  // Convert big-endian to little-endian.

+  //

+  LocalGuid.Data3 = SwapBytes16 (LocalGuid.Data3);

+  String += 2 * sizeof (LocalGuid.Data3) + 1;

+

+  //

+  // Get iijj.

+  //

+  Status = AsciiStrHexToBytes (String, 2 * 2, &LocalGuid.Data4[0], 2);

+  if (RETURN_ERROR (Status) || String[2 * 2] != '-') {

+    return RETURN_UNSUPPORTED;

+  }

+  String += 2 * 2 + 1;

+

+  //

+  // Get kkllmmnnoopp.

+  //

+  Status = AsciiStrHexToBytes (String, 2 * 6, &LocalGuid.Data4[2], 6);

+  if (RETURN_ERROR (Status)) {

+    return RETURN_UNSUPPORTED;

+  }

+

+  CopyGuid (Guid, &LocalGuid);

+  return RETURN_SUCCESS;

+}

+

+/**

+  Convert a Null-terminated ASCII hexadecimal string to a byte array.

+

+  This function outputs a byte array by interpreting the contents of

+  the ASCII string specified by String in hexadecimal format. The format of

+  the input ASCII string String is:

+

+                  [XX]*

+

+  X is a hexadecimal digit character in the range [0-9], [a-f] and [A-F].

+  The function decodes every two hexadecimal digit characters as one byte. The

+  decoding stops after Length of characters and outputs Buffer containing

+  (Length / 2) bytes.

+

+  @param  String                   Pointer to a Null-terminated ASCII string.

+  @param  Length                   The number of ASCII characters to decode.

+  @param  Buffer                   Pointer to the converted bytes array.

+  @param  MaxBufferSize            The maximum size of Buffer.

+

+  @retval RETURN_SUCCESS           Buffer is translated from String.

+  @retval RETURN_INVALID_PARAMETER If String is NULL.

+                                   If Data is NULL.

+                                   If Length is not multiple of 2.

+                                   If PcdMaximumAsciiStringLength is not zero,

+                                    and Length is greater than

+                                    PcdMaximumAsciiStringLength.

+  @retval RETURN_UNSUPPORTED       If Length of characters from String contain

+                                    a character that is not valid hexadecimal

+                                    digit characters, or a Null-terminator.

+  @retval RETURN_BUFFER_TOO_SMALL  If MaxBufferSize is less than (Length / 2).

+**/

+RETURN_STATUS

+EFIAPI

+AsciiStrHexToBytes (

+  IN  CONST CHAR8        *String,

+  IN  UINTN              Length,

+  OUT UINT8              *Buffer,

+  IN  UINTN              MaxBufferSize

+  )

+{

+  UINTN                  Index;

+

+  //

+  // 1. None of String or Buffer shall be a null pointer.

+  //

+  SAFE_STRING_CONSTRAINT_CHECK ((String != NULL), RETURN_INVALID_PARAMETER);

+  SAFE_STRING_CONSTRAINT_CHECK ((Buffer != NULL), RETURN_INVALID_PARAMETER);

+

+  //

+  // 2. Length shall not be greater than ASCII_RSIZE_MAX.

+  //

+  if (ASCII_RSIZE_MAX != 0) {

+    SAFE_STRING_CONSTRAINT_CHECK ((Length <= ASCII_RSIZE_MAX), RETURN_INVALID_PARAMETER);

+  }

+

+  //

+  // 3. Length shall not be odd.

+  //

+  SAFE_STRING_CONSTRAINT_CHECK (((Length & BIT0) == 0), RETURN_INVALID_PARAMETER);

+

+  //

+  // 4. MaxBufferSize shall equal to or greater than Length / 2.

+  //

+  SAFE_STRING_CONSTRAINT_CHECK ((MaxBufferSize >= Length / 2), RETURN_BUFFER_TOO_SMALL);

+

+  //

+  // 5. String shall not contains invalid hexadecimal digits.

+  //

+  for (Index = 0; Index < Length; Index++) {

+    if (!InternalAsciiIsHexaDecimalDigitCharacter (String[Index])) {

+      break;

+    }

+  }

+  if (Index != Length) {

+    return RETURN_UNSUPPORTED;

+  }

+

+  //

+  // Convert the hex string to bytes.

+  //

+  for(Index = 0; Index < Length; Index++) {

+

+    //

+    // For even characters, write the upper nibble for each buffer byte,

+    // and for even characters, the lower nibble.

+    //

+    if ((Index & BIT0) == 0) {

+      Buffer[Index / 2]  = (UINT8) InternalAsciiHexCharToUintn (String[Index]) << 4;

+    } else {

+      Buffer[Index / 2] |= (UINT8) InternalAsciiHexCharToUintn (String[Index]);

+    }

+  }

+  return RETURN_SUCCESS;

+}

+

diff --git a/debugging_demo/memtest86+/efi/Include/src/BaseLib/SetJump.c b/debugging_demo/memtest86+/efi/Include/src/BaseLib/SetJump.c
new file mode 100644
index 0000000..516f92f
--- /dev/null
+++ b/debugging_demo/memtest86+/efi/Include/src/BaseLib/SetJump.c
@@ -0,0 +1,34 @@
+/** @file

+  Internal ASSERT () functions for SetJump.

+

+  Copyright (c) 2006 - 2008, Intel Corporation. All rights reserved.<BR>

+  SPDX-License-Identifier: BSD-2-Clause-Patent

+

+**/

+

+

+

+

+#include "BaseLibInternals.h"

+

+/**

+  Worker function that checks ASSERT condition for JumpBuffer

+

+  Checks ASSERT condition for JumpBuffer.

+

+  If JumpBuffer is NULL, then ASSERT().

+  For IPF CPUs, if JumpBuffer is not aligned on a 16-byte boundary, then ASSERT().

+

+  @param  JumpBuffer    A pointer to CPU context buffer.

+

+**/

+VOID

+EFIAPI

+InternalAssertJumpBuffer (

+  IN      BASE_LIBRARY_JUMP_BUFFER  *JumpBuffer

+  )

+{

+  ASSERT (JumpBuffer != NULL);

+

+  ASSERT (((UINTN)JumpBuffer & (BASE_LIBRARY_JUMP_BUFFER_ALIGNMENT - 1)) == 0);

+}

diff --git a/debugging_demo/memtest86+/efi/Include/src/BaseLib/String.c b/debugging_demo/memtest86+/efi/Include/src/BaseLib/String.c
new file mode 100644
index 0000000..f4854f3
--- /dev/null
+++ b/debugging_demo/memtest86+/efi/Include/src/BaseLib/String.c
@@ -0,0 +1,1644 @@
+/** @file

+  Unicode and ASCII string primitives.

+

+  Copyright (c) 2006 - 2019, Intel Corporation. All rights reserved.<BR>

+  SPDX-License-Identifier: BSD-2-Clause-Patent

+

+**/

+

+#include "BaseLibInternals.h"

+

+

+/**

+  Returns the length of a Null-terminated Unicode string.

+

+  This function returns the number of Unicode characters in the Null-terminated

+  Unicode string specified by String.

+

+  If String is NULL, then ASSERT().

+  If String is not aligned on a 16-bit boundary, then ASSERT().

+  If PcdMaximumUnicodeStringLength is not zero, and String contains more than

+  PcdMaximumUnicodeStringLength Unicode characters, not including the

+  Null-terminator, then ASSERT().

+

+  @param  String  A pointer to a Null-terminated Unicode string.

+

+  @return The length of String.

+

+**/

+UINTN

+EFIAPI

+StrLen (

+  IN      CONST CHAR16              *String

+  )

+{

+  UINTN                             Length;

+

+  ASSERT (String != NULL);

+  ASSERT (((UINTN) String & BIT0) == 0);

+

+  for (Length = 0; *String != L'\0'; String++, Length++) {

+    //

+    // If PcdMaximumUnicodeStringLength is not zero,

+    // length should not more than PcdMaximumUnicodeStringLength

+    //

+    if (PcdGet32 (PcdMaximumUnicodeStringLength) != 0) {

+      ASSERT (Length < PcdGet32 (PcdMaximumUnicodeStringLength));

+    }

+  }

+  return Length;

+}

+

+/**

+  Returns the size of a Null-terminated Unicode string in bytes, including the

+  Null terminator.

+

+  This function returns the size, in bytes, of the Null-terminated Unicode string

+  specified by String.

+

+  If String is NULL, then ASSERT().

+  If String is not aligned on a 16-bit boundary, then ASSERT().

+  If PcdMaximumUnicodeStringLength is not zero, and String contains more than

+  PcdMaximumUnicodeStringLength Unicode characters, not including the

+  Null-terminator, then ASSERT().

+

+  @param  String  A pointer to a Null-terminated Unicode string.

+

+  @return The size of String.

+

+**/

+UINTN

+EFIAPI

+StrSize (

+  IN      CONST CHAR16              *String

+  )

+{

+  return (StrLen (String) + 1) * sizeof (*String);

+}

+

+/**

+  Compares two Null-terminated Unicode strings, and returns the difference

+  between the first mismatched Unicode characters.

+

+  This function compares the Null-terminated Unicode string FirstString to the

+  Null-terminated Unicode string SecondString. If FirstString is identical to

+  SecondString, then 0 is returned. Otherwise, the value returned is the first

+  mismatched Unicode character in SecondString subtracted from the first

+  mismatched Unicode character in FirstString.

+

+  If FirstString is NULL, then ASSERT().

+  If FirstString is not aligned on a 16-bit boundary, then ASSERT().

+  If SecondString is NULL, then ASSERT().

+  If SecondString is not aligned on a 16-bit boundary, then ASSERT().

+  If PcdMaximumUnicodeStringLength is not zero, and FirstString contains more

+  than PcdMaximumUnicodeStringLength Unicode characters, not including the

+  Null-terminator, then ASSERT().

+  If PcdMaximumUnicodeStringLength is not zero, and SecondString contains more

+  than PcdMaximumUnicodeStringLength Unicode characters, not including the

+  Null-terminator, then ASSERT().

+

+  @param  FirstString   A pointer to a Null-terminated Unicode string.

+  @param  SecondString  A pointer to a Null-terminated Unicode string.

+

+  @retval 0      FirstString is identical to SecondString.

+  @return others FirstString is not identical to SecondString.

+

+**/

+INTN

+EFIAPI

+StrCmp (

+  IN      CONST CHAR16              *FirstString,

+  IN      CONST CHAR16              *SecondString

+  )

+{

+  //

+  // ASSERT both strings are less long than PcdMaximumUnicodeStringLength

+  //

+  ASSERT (StrSize (FirstString) != 0);

+  ASSERT (StrSize (SecondString) != 0);

+

+  while ((*FirstString != L'\0') && (*FirstString == *SecondString)) {

+    FirstString++;

+    SecondString++;

+  }

+  return *FirstString - *SecondString;

+}

+

+/**

+  Compares up to a specified length the contents of two Null-terminated Unicode strings,

+  and returns the difference between the first mismatched Unicode characters.

+

+  This function compares the Null-terminated Unicode string FirstString to the

+  Null-terminated Unicode string SecondString. At most, Length Unicode

+  characters will be compared. If Length is 0, then 0 is returned. If

+  FirstString is identical to SecondString, then 0 is returned. Otherwise, the

+  value returned is the first mismatched Unicode character in SecondString

+  subtracted from the first mismatched Unicode character in FirstString.

+

+  If Length > 0 and FirstString is NULL, then ASSERT().

+  If Length > 0 and FirstString is not aligned on a 16-bit boundary, then ASSERT().

+  If Length > 0 and SecondString is NULL, then ASSERT().

+  If Length > 0 and SecondString is not aligned on a 16-bit boundary, then ASSERT().

+  If PcdMaximumUnicodeStringLength is not zero, and Length is greater than

+  PcdMaximumUnicodeStringLength, then ASSERT().

+  If PcdMaximumUnicodeStringLength is not zero, and FirstString contains more than

+  PcdMaximumUnicodeStringLength Unicode characters, not including the Null-terminator,

+  then ASSERT().

+  If PcdMaximumUnicodeStringLength is not zero, and SecondString contains more than

+  PcdMaximumUnicodeStringLength Unicode characters, not including the Null-terminator,

+  then ASSERT().

+

+  @param  FirstString   A pointer to a Null-terminated Unicode string.

+  @param  SecondString  A pointer to a Null-terminated Unicode string.

+  @param  Length        The maximum number of Unicode characters to compare.

+

+  @retval 0      FirstString is identical to SecondString.

+  @return others FirstString is not identical to SecondString.

+

+**/

+INTN

+EFIAPI

+StrnCmp (

+  IN      CONST CHAR16              *FirstString,

+  IN      CONST CHAR16              *SecondString,

+  IN      UINTN                     Length

+  )

+{

+  if (Length == 0) {

+    return 0;

+  }

+

+  //

+  // ASSERT both strings are less long than PcdMaximumUnicodeStringLength.

+  // Length tests are performed inside StrLen().

+  //

+  ASSERT (StrSize (FirstString) != 0);

+  ASSERT (StrSize (SecondString) != 0);

+

+  if (PcdGet32 (PcdMaximumUnicodeStringLength) != 0) {

+    ASSERT (Length <= PcdGet32 (PcdMaximumUnicodeStringLength));

+  }

+

+  while ((*FirstString != L'\0') &&

+         (*SecondString != L'\0') &&

+         (*FirstString == *SecondString) &&

+         (Length > 1)) {

+    FirstString++;

+    SecondString++;

+    Length--;

+  }

+

+  return *FirstString - *SecondString;

+}

+

+

+/**

+  Returns the first occurrence of a Null-terminated Unicode sub-string

+  in a Null-terminated Unicode string.

+

+  This function scans the contents of the Null-terminated Unicode string

+  specified by String and returns the first occurrence of SearchString.

+  If SearchString is not found in String, then NULL is returned.  If

+  the length of SearchString is zero, then String is

+  returned.

+

+  If String is NULL, then ASSERT().

+  If String is not aligned on a 16-bit boundary, then ASSERT().

+  If SearchString is NULL, then ASSERT().

+  If SearchString is not aligned on a 16-bit boundary, then ASSERT().

+

+  If PcdMaximumUnicodeStringLength is not zero, and SearchString

+  or String contains more than PcdMaximumUnicodeStringLength Unicode

+  characters, not including the Null-terminator, then ASSERT().

+

+  @param  String          A pointer to a Null-terminated Unicode string.

+  @param  SearchString    A pointer to a Null-terminated Unicode string to search for.

+

+  @retval NULL            If the SearchString does not appear in String.

+  @return others          If there is a match.

+

+**/

+CHAR16 *

+EFIAPI

+StrStr (

+  IN      CONST CHAR16              *String,

+  IN      CONST CHAR16              *SearchString

+  )

+{

+  CONST CHAR16 *FirstMatch;

+  CONST CHAR16 *SearchStringTmp;

+

+  //

+  // ASSERT both strings are less long than PcdMaximumUnicodeStringLength.

+  // Length tests are performed inside StrLen().

+  //

+  ASSERT (StrSize (String) != 0);

+  ASSERT (StrSize (SearchString) != 0);

+

+  if (*SearchString == L'\0') {

+    return (CHAR16 *) String;

+  }

+

+  while (*String != L'\0') {

+    SearchStringTmp = SearchString;

+    FirstMatch = String;

+

+    while ((*String == *SearchStringTmp)

+            && (*String != L'\0')) {

+      String++;

+      SearchStringTmp++;

+    }

+

+    if (*SearchStringTmp == L'\0') {

+      return (CHAR16 *) FirstMatch;

+    }

+

+    if (*String == L'\0') {

+      return NULL;

+    }

+

+    String = FirstMatch + 1;

+  }

+

+  return NULL;

+}

+

+/**

+  Check if a Unicode character is a decimal character.

+

+  This internal function checks if a Unicode character is a

+  decimal character. The valid decimal character is from

+  L'0' to L'9'.

+

+  @param  Char  The character to check against.

+

+  @retval TRUE  If the Char is a decmial character.

+  @retval FALSE If the Char is not a decmial character.

+

+**/

+BOOLEAN

+EFIAPI

+InternalIsDecimalDigitCharacter (

+  IN      CHAR16                    Char

+  )

+{

+  return (BOOLEAN) (Char >= L'0' && Char <= L'9');

+}

+

+/**

+  Convert a Unicode character to upper case only if

+  it maps to a valid small-case ASCII character.

+

+  This internal function only deal with Unicode character

+  which maps to a valid small-case ASCII character, i.e.

+  L'a' to L'z'. For other Unicode character, the input character

+  is returned directly.

+

+  @param  Char  The character to convert.

+

+  @retval LowerCharacter   If the Char is with range L'a' to L'z'.

+  @retval Unchanged        Otherwise.

+

+**/

+CHAR16

+EFIAPI

+CharToUpper (

+  IN      CHAR16                    Char

+  )

+{

+  if (Char >= L'a' && Char <= L'z') {

+    return (CHAR16) (Char - (L'a' - L'A'));

+  }

+

+  return Char;

+}

+

+/**

+  Convert a Unicode character to numerical value.

+

+  This internal function only deal with Unicode character

+  which maps to a valid hexadecimal ASII character, i.e.

+  L'0' to L'9', L'a' to L'f' or L'A' to L'F'. For other

+  Unicode character, the value returned does not make sense.

+

+  @param  Char  The character to convert.

+

+  @return The numerical value converted.

+

+**/

+UINTN

+EFIAPI

+InternalHexCharToUintn (

+  IN      CHAR16                    Char

+  )

+{

+  if (InternalIsDecimalDigitCharacter (Char)) {

+    return Char - L'0';

+  }

+

+  return (10 + CharToUpper (Char) - L'A');

+}

+

+/**

+  Check if a Unicode character is a hexadecimal character.

+

+  This internal function checks if a Unicode character is a

+  decimal character.  The valid hexadecimal character is

+  L'0' to L'9', L'a' to L'f', or L'A' to L'F'.

+

+

+  @param  Char  The character to check against.

+

+  @retval TRUE  If the Char is a hexadecmial character.

+  @retval FALSE If the Char is not a hexadecmial character.

+

+**/

+BOOLEAN

+EFIAPI

+InternalIsHexaDecimalDigitCharacter (

+  IN      CHAR16                    Char

+  )

+{

+

+  return (BOOLEAN) (InternalIsDecimalDigitCharacter (Char) ||

+    (Char >= L'A' && Char <= L'F') ||

+    (Char >= L'a' && Char <= L'f'));

+}

+

+/**

+  Convert a Null-terminated Unicode decimal string to a value of

+  type UINTN.

+

+  This function returns a value of type UINTN by interpreting the contents

+  of the Unicode string specified by String as a decimal number. The format

+  of the input Unicode string String is:

+

+                  [spaces] [decimal digits].

+

+  The valid decimal digit character is in the range [0-9]. The

+  function will ignore the pad space, which includes spaces or

+  tab characters, before [decimal digits]. The running zero in the

+  beginning of [decimal digits] will be ignored. Then, the function

+  stops at the first character that is a not a valid decimal character

+  or a Null-terminator, whichever one comes first.

+

+  If String is NULL, then ASSERT().

+  If String is not aligned in a 16-bit boundary, then ASSERT().

+  If String has only pad spaces, then 0 is returned.

+  If String has no pad spaces or valid decimal digits,

+  then 0 is returned.

+  If the number represented by String overflows according

+  to the range defined by UINTN, then MAX_UINTN is returned.

+

+  If PcdMaximumUnicodeStringLength is not zero, and String contains

+  more than PcdMaximumUnicodeStringLength Unicode characters, not including

+  the Null-terminator, then ASSERT().

+

+  @param  String      A pointer to a Null-terminated Unicode string.

+

+  @retval Value translated from String.

+

+**/

+UINTN

+EFIAPI

+StrDecimalToUintn (

+  IN      CONST CHAR16              *String

+  )

+{

+  UINTN     Result;

+

+  StrDecimalToUintnS (String, (CHAR16 **) NULL, &Result);

+  return Result;

+}

+

+

+/**

+  Convert a Null-terminated Unicode decimal string to a value of

+  type UINT64.

+

+  This function returns a value of type UINT64 by interpreting the contents

+  of the Unicode string specified by String as a decimal number. The format

+  of the input Unicode string String is:

+

+                  [spaces] [decimal digits].

+

+  The valid decimal digit character is in the range [0-9]. The

+  function will ignore the pad space, which includes spaces or

+  tab characters, before [decimal digits]. The running zero in the

+  beginning of [decimal digits] will be ignored. Then, the function

+  stops at the first character that is a not a valid decimal character

+  or a Null-terminator, whichever one comes first.

+

+  If String is NULL, then ASSERT().

+  If String is not aligned in a 16-bit boundary, then ASSERT().

+  If String has only pad spaces, then 0 is returned.

+  If String has no pad spaces or valid decimal digits,

+  then 0 is returned.

+  If the number represented by String overflows according

+  to the range defined by UINT64, then MAX_UINT64 is returned.

+

+  If PcdMaximumUnicodeStringLength is not zero, and String contains

+  more than PcdMaximumUnicodeStringLength Unicode characters, not including

+  the Null-terminator, then ASSERT().

+

+  @param  String          A pointer to a Null-terminated Unicode string.

+

+  @retval Value translated from String.

+

+**/

+UINT64

+EFIAPI

+StrDecimalToUint64 (

+  IN      CONST CHAR16              *String

+  )

+{

+  UINT64     Result;

+

+  StrDecimalToUint64S (String, (CHAR16 **) NULL, &Result);

+  return Result;

+}

+

+/**

+  Convert a Null-terminated Unicode hexadecimal string to a value of type UINTN.

+

+  This function returns a value of type UINTN by interpreting the contents

+  of the Unicode string specified by String as a hexadecimal number.

+  The format of the input Unicode string String is:

+

+                  [spaces][zeros][x][hexadecimal digits].

+

+  The valid hexadecimal digit character is in the range [0-9], [a-f] and [A-F].

+  The prefix "0x" is optional. Both "x" and "X" is allowed in "0x" prefix.

+  If "x" appears in the input string, it must be prefixed with at least one 0.

+  The function will ignore the pad space, which includes spaces or tab characters,

+  before [zeros], [x] or [hexadecimal digit]. The running zero before [x] or

+  [hexadecimal digit] will be ignored. Then, the decoding starts after [x] or the

+  first valid hexadecimal digit. Then, the function stops at the first character that is

+  a not a valid hexadecimal character or NULL, whichever one comes first.

+

+  If String is NULL, then ASSERT().

+  If String is not aligned in a 16-bit boundary, then ASSERT().

+  If String has only pad spaces, then zero is returned.

+  If String has no leading pad spaces, leading zeros or valid hexadecimal digits,

+  then zero is returned.

+  If the number represented by String overflows according to the range defined by

+  UINTN, then MAX_UINTN is returned.

+

+  If PcdMaximumUnicodeStringLength is not zero, and String contains more than

+  PcdMaximumUnicodeStringLength Unicode characters, not including the Null-terminator,

+  then ASSERT().

+

+  @param  String          A pointer to a Null-terminated Unicode string.

+

+  @retval Value translated from String.

+

+**/

+UINTN

+EFIAPI

+StrHexToUintn (

+  IN      CONST CHAR16              *String

+  )

+{

+  UINTN     Result;

+

+  StrHexToUintnS (String, (CHAR16 **) NULL, &Result);

+  return Result;

+}

+

+

+/**

+  Convert a Null-terminated Unicode hexadecimal string to a value of type UINT64.

+

+  This function returns a value of type UINT64 by interpreting the contents

+  of the Unicode string specified by String as a hexadecimal number.

+  The format of the input Unicode string String is

+

+                  [spaces][zeros][x][hexadecimal digits].

+

+  The valid hexadecimal digit character is in the range [0-9], [a-f] and [A-F].

+  The prefix "0x" is optional. Both "x" and "X" is allowed in "0x" prefix.

+  If "x" appears in the input string, it must be prefixed with at least one 0.

+  The function will ignore the pad space, which includes spaces or tab characters,

+  before [zeros], [x] or [hexadecimal digit]. The running zero before [x] or

+  [hexadecimal digit] will be ignored. Then, the decoding starts after [x] or the

+  first valid hexadecimal digit. Then, the function stops at the first character that is

+  a not a valid hexadecimal character or NULL, whichever one comes first.

+

+  If String is NULL, then ASSERT().

+  If String is not aligned in a 16-bit boundary, then ASSERT().

+  If String has only pad spaces, then zero is returned.

+  If String has no leading pad spaces, leading zeros or valid hexadecimal digits,

+  then zero is returned.

+  If the number represented by String overflows according to the range defined by

+  UINT64, then MAX_UINT64 is returned.

+

+  If PcdMaximumUnicodeStringLength is not zero, and String contains more than

+  PcdMaximumUnicodeStringLength Unicode characters, not including the Null-terminator,

+  then ASSERT().

+

+  @param  String          A pointer to a Null-terminated Unicode string.

+

+  @retval Value translated from String.

+

+**/

+UINT64

+EFIAPI

+StrHexToUint64 (

+  IN      CONST CHAR16             *String

+  )

+{

+  UINT64    Result;

+

+  StrHexToUint64S (String, (CHAR16 **) NULL, &Result);

+  return Result;

+}

+

+/**

+  Check if a ASCII character is a decimal character.

+

+  This internal function checks if a Unicode character is a

+  decimal character. The valid decimal character is from

+  '0' to '9'.

+

+  @param  Char  The character to check against.

+

+  @retval TRUE  If the Char is a decmial character.

+  @retval FALSE If the Char is not a decmial character.

+

+**/

+BOOLEAN

+EFIAPI

+InternalAsciiIsDecimalDigitCharacter (

+  IN      CHAR8                     Char

+  )

+{

+  return (BOOLEAN) (Char >= '0' && Char <= '9');

+}

+

+/**

+  Check if a ASCII character is a hexadecimal character.

+

+  This internal function checks if a ASCII character is a

+  decimal character.  The valid hexadecimal character is

+  L'0' to L'9', L'a' to L'f', or L'A' to L'F'.

+

+

+  @param  Char  The character to check against.

+

+  @retval TRUE  If the Char is a hexadecmial character.

+  @retval FALSE If the Char is not a hexadecmial character.

+

+**/

+BOOLEAN

+EFIAPI

+InternalAsciiIsHexaDecimalDigitCharacter (

+  IN      CHAR8                    Char

+  )

+{

+

+  return (BOOLEAN) (InternalAsciiIsDecimalDigitCharacter (Char) ||

+    (Char >= 'A' && Char <= 'F') ||

+    (Char >= 'a' && Char <= 'f'));

+}

+

+

+/**

+  Returns the length of a Null-terminated ASCII string.

+

+  This function returns the number of ASCII characters in the Null-terminated

+  ASCII string specified by String.

+

+  If Length > 0 and Destination is NULL, then ASSERT().

+  If Length > 0 and Source is NULL, then ASSERT().

+  If PcdMaximumAsciiStringLength is not zero and String contains more than

+  PcdMaximumAsciiStringLength ASCII characters, not including the Null-terminator,

+  then ASSERT().

+

+  @param  String  A pointer to a Null-terminated ASCII string.

+

+  @return The length of String.

+

+**/

+UINTN

+EFIAPI

+AsciiStrLen (

+  IN      CONST CHAR8               *String

+  )

+{

+  UINTN                             Length;

+

+  ASSERT (String != NULL);

+

+  for (Length = 0; *String != '\0'; String++, Length++) {

+    //

+    // If PcdMaximumUnicodeStringLength is not zero,

+    // length should not more than PcdMaximumUnicodeStringLength

+    //

+    if (PcdGet32 (PcdMaximumAsciiStringLength) != 0) {

+      ASSERT (Length < PcdGet32 (PcdMaximumAsciiStringLength));

+    }

+  }

+  return Length;

+}

+

+/**

+  Returns the size of a Null-terminated ASCII string in bytes, including the

+  Null terminator.

+

+  This function returns the size, in bytes, of the Null-terminated ASCII string

+  specified by String.

+

+  If String is NULL, then ASSERT().

+  If PcdMaximumAsciiStringLength is not zero and String contains more than

+  PcdMaximumAsciiStringLength ASCII characters, not including the Null-terminator,

+  then ASSERT().

+

+  @param  String  A pointer to a Null-terminated ASCII string.

+

+  @return The size of String.

+

+**/

+UINTN

+EFIAPI

+AsciiStrSize (

+  IN      CONST CHAR8               *String

+  )

+{

+  return (AsciiStrLen (String) + 1) * sizeof (*String);

+}

+

+/**

+  Compares two Null-terminated ASCII strings, and returns the difference

+  between the first mismatched ASCII characters.

+

+  This function compares the Null-terminated ASCII string FirstString to the

+  Null-terminated ASCII string SecondString. If FirstString is identical to

+  SecondString, then 0 is returned. Otherwise, the value returned is the first

+  mismatched ASCII character in SecondString subtracted from the first

+  mismatched ASCII character in FirstString.

+

+  If FirstString is NULL, then ASSERT().

+  If SecondString is NULL, then ASSERT().

+  If PcdMaximumAsciiStringLength is not zero and FirstString contains more than

+  PcdMaximumAsciiStringLength ASCII characters, not including the Null-terminator,

+  then ASSERT().

+  If PcdMaximumAsciiStringLength is not zero and SecondString contains more

+  than PcdMaximumAsciiStringLength ASCII characters, not including the

+  Null-terminator, then ASSERT().

+

+  @param  FirstString   A pointer to a Null-terminated ASCII string.

+  @param  SecondString  A pointer to a Null-terminated ASCII string.

+

+  @retval ==0      FirstString is identical to SecondString.

+  @retval !=0      FirstString is not identical to SecondString.

+

+**/

+INTN

+EFIAPI

+AsciiStrCmp (

+  IN      CONST CHAR8               *FirstString,

+  IN      CONST CHAR8               *SecondString

+  )

+{

+  //

+  // ASSERT both strings are less long than PcdMaximumAsciiStringLength

+  //

+  ASSERT (AsciiStrSize (FirstString));

+  ASSERT (AsciiStrSize (SecondString));

+

+  while ((*FirstString != '\0') && (*FirstString == *SecondString)) {

+    FirstString++;

+    SecondString++;

+  }

+

+  return *FirstString - *SecondString;

+}

+

+/**

+  Converts a lowercase Ascii character to upper one.

+

+  If Chr is lowercase Ascii character, then converts it to upper one.

+

+  If Value >= 0xA0, then ASSERT().

+  If (Value & 0x0F) >= 0x0A, then ASSERT().

+

+  @param  Chr   one Ascii character

+

+  @return The uppercase value of Ascii character

+

+**/

+CHAR8

+EFIAPI

+AsciiCharToUpper (

+  IN      CHAR8                     Chr

+  )

+{

+  return (UINT8) ((Chr >= 'a' && Chr <= 'z') ? Chr - ('a' - 'A') : Chr);

+}

+

+/**

+  Convert a ASCII character to numerical value.

+

+  This internal function only deal with Unicode character

+  which maps to a valid hexadecimal ASII character, i.e.

+  '0' to '9', 'a' to 'f' or 'A' to 'F'. For other

+  ASCII character, the value returned does not make sense.

+

+  @param  Char  The character to convert.

+

+  @return The numerical value converted.

+

+**/

+UINTN

+EFIAPI

+InternalAsciiHexCharToUintn (

+  IN      CHAR8                    Char

+  )

+{

+  if (InternalIsDecimalDigitCharacter (Char)) {

+    return Char - '0';

+  }

+

+  return (10 + AsciiCharToUpper (Char) - 'A');

+}

+

+

+/**

+  Performs a case insensitive comparison of two Null-terminated ASCII strings,

+  and returns the difference between the first mismatched ASCII characters.

+

+  This function performs a case insensitive comparison of the Null-terminated

+  ASCII string FirstString to the Null-terminated ASCII string SecondString. If

+  FirstString is identical to SecondString, then 0 is returned. Otherwise, the

+  value returned is the first mismatched lower case ASCII character in

+  SecondString subtracted from the first mismatched lower case ASCII character

+  in FirstString.

+

+  If FirstString is NULL, then ASSERT().

+  If SecondString is NULL, then ASSERT().

+  If PcdMaximumAsciiStringLength is not zero and FirstString contains more than

+  PcdMaximumAsciiStringLength ASCII characters, not including the Null-terminator,

+  then ASSERT().

+  If PcdMaximumAsciiStringLength is not zero and SecondString contains more

+  than PcdMaximumAsciiStringLength ASCII characters, not including the

+  Null-terminator, then ASSERT().

+

+  @param  FirstString   A pointer to a Null-terminated ASCII string.

+  @param  SecondString  A pointer to a Null-terminated ASCII string.

+

+  @retval ==0    FirstString is identical to SecondString using case insensitive

+                 comparisons.

+  @retval !=0    FirstString is not identical to SecondString using case

+                 insensitive comparisons.

+

+**/

+INTN

+EFIAPI

+AsciiStriCmp (

+  IN      CONST CHAR8               *FirstString,

+  IN      CONST CHAR8               *SecondString

+  )

+{

+  CHAR8  UpperFirstString;

+  CHAR8  UpperSecondString;

+

+  //

+  // ASSERT both strings are less long than PcdMaximumAsciiStringLength

+  //

+  ASSERT (AsciiStrSize (FirstString));

+  ASSERT (AsciiStrSize (SecondString));

+

+  UpperFirstString  = AsciiCharToUpper (*FirstString);

+  UpperSecondString = AsciiCharToUpper (*SecondString);

+  while ((*FirstString != '\0') && (*SecondString != '\0') && (UpperFirstString == UpperSecondString)) {

+    FirstString++;

+    SecondString++;

+    UpperFirstString  = AsciiCharToUpper (*FirstString);

+    UpperSecondString = AsciiCharToUpper (*SecondString);

+  }

+

+  return UpperFirstString - UpperSecondString;

+}

+

+/**

+  Compares two Null-terminated ASCII strings with maximum lengths, and returns

+  the difference between the first mismatched ASCII characters.

+

+  This function compares the Null-terminated ASCII string FirstString to the

+  Null-terminated ASCII  string SecondString. At most, Length ASCII characters

+  will be compared. If Length is 0, then 0 is returned. If FirstString is

+  identical to SecondString, then 0 is returned. Otherwise, the value returned

+  is the first mismatched ASCII character in SecondString subtracted from the

+  first mismatched ASCII character in FirstString.

+

+  If Length > 0 and FirstString is NULL, then ASSERT().

+  If Length > 0 and SecondString is NULL, then ASSERT().

+  If PcdMaximumAsciiStringLength is not zero, and Length is greater than

+  PcdMaximumAsciiStringLength, then ASSERT().

+  If PcdMaximumAsciiStringLength is not zero, and FirstString contains more than

+  PcdMaximumAsciiStringLength ASCII characters, not including the Null-terminator,

+  then ASSERT().

+  If PcdMaximumAsciiStringLength is not zero, and SecondString contains more than

+  PcdMaximumAsciiStringLength ASCII characters, not including the Null-terminator,

+  then ASSERT().

+

+  @param  FirstString   A pointer to a Null-terminated ASCII string.

+  @param  SecondString  A pointer to a Null-terminated ASCII string.

+  @param  Length        The maximum number of ASCII characters for compare.

+

+  @retval ==0       FirstString is identical to SecondString.

+  @retval !=0       FirstString is not identical to SecondString.

+

+**/

+INTN

+EFIAPI

+AsciiStrnCmp (

+  IN      CONST CHAR8               *FirstString,

+  IN      CONST CHAR8               *SecondString,

+  IN      UINTN                     Length

+  )

+{

+  if (Length == 0) {

+    return 0;

+  }

+

+  //

+  // ASSERT both strings are less long than PcdMaximumAsciiStringLength

+  //

+  ASSERT (AsciiStrSize (FirstString));

+  ASSERT (AsciiStrSize (SecondString));

+

+  if (PcdGet32 (PcdMaximumAsciiStringLength) != 0) {

+    ASSERT (Length <= PcdGet32 (PcdMaximumAsciiStringLength));

+  }

+

+  while ((*FirstString != '\0') &&

+         (*SecondString != '\0') &&

+         (*FirstString == *SecondString) &&

+         (Length > 1)) {

+    FirstString++;

+    SecondString++;

+    Length--;

+  }

+  return *FirstString - *SecondString;

+}

+

+

+/**

+  Returns the first occurrence of a Null-terminated ASCII sub-string

+  in a Null-terminated ASCII string.

+

+  This function scans the contents of the ASCII string specified by String

+  and returns the first occurrence of SearchString. If SearchString is not

+  found in String, then NULL is returned. If the length of SearchString is zero,

+  then String is returned.

+

+  If String is NULL, then ASSERT().

+  If SearchString is NULL, then ASSERT().

+

+  If PcdMaximumAsciiStringLength is not zero, and SearchString or

+  String contains more than PcdMaximumAsciiStringLength Unicode characters

+  not including the Null-terminator, then ASSERT().

+

+  @param  String          A pointer to a Null-terminated ASCII string.

+  @param  SearchString    A pointer to a Null-terminated ASCII string to search for.

+

+  @retval NULL            If the SearchString does not appear in String.

+  @retval others          If there is a match return the first occurrence of SearchingString.

+                          If the length of SearchString is zero,return String.

+

+**/

+CHAR8 *

+EFIAPI

+AsciiStrStr (

+  IN      CONST CHAR8               *String,

+  IN      CONST CHAR8               *SearchString

+  )

+{

+  CONST CHAR8 *FirstMatch;

+  CONST CHAR8 *SearchStringTmp;

+

+  //

+  // ASSERT both strings are less long than PcdMaximumAsciiStringLength

+  //

+  ASSERT (AsciiStrSize (String) != 0);

+  ASSERT (AsciiStrSize (SearchString) != 0);

+

+  if (*SearchString == '\0') {

+    return (CHAR8 *) String;

+  }

+

+  while (*String != '\0') {

+    SearchStringTmp = SearchString;

+    FirstMatch = String;

+

+    while ((*String == *SearchStringTmp)

+            && (*String != '\0')) {

+      String++;

+      SearchStringTmp++;

+    }

+

+    if (*SearchStringTmp == '\0') {

+      return (CHAR8 *) FirstMatch;

+    }

+

+    if (*String == '\0') {

+      return NULL;

+    }

+

+    String = FirstMatch + 1;

+  }

+

+  return NULL;

+}

+

+/**

+  Convert a Null-terminated ASCII decimal string to a value of type

+  UINTN.

+

+  This function returns a value of type UINTN by interpreting the contents

+  of the ASCII string String as a decimal number. The format of the input

+  ASCII string String is:

+

+                    [spaces] [decimal digits].

+

+  The valid decimal digit character is in the range [0-9]. The function will

+  ignore the pad space, which includes spaces or tab characters, before the digits.

+  The running zero in the beginning of [decimal digits] will be ignored. Then, the

+  function stops at the first character that is a not a valid decimal character or

+  Null-terminator, whichever on comes first.

+

+  If String has only pad spaces, then 0 is returned.

+  If String has no pad spaces or valid decimal digits, then 0 is returned.

+  If the number represented by String overflows according to the range defined by

+  UINTN, then MAX_UINTN is returned.

+  If String is NULL, then ASSERT().

+  If PcdMaximumAsciiStringLength is not zero, and String contains more than

+  PcdMaximumAsciiStringLength ASCII characters not including the Null-terminator,

+  then ASSERT().

+

+  @param  String          A pointer to a Null-terminated ASCII string.

+

+  @retval Value translated from String.

+

+**/

+UINTN

+EFIAPI

+AsciiStrDecimalToUintn (

+  IN      CONST CHAR8               *String

+  )

+{

+  UINTN     Result;

+

+  AsciiStrDecimalToUintnS (String, (CHAR8 **) NULL, &Result);

+  return Result;

+}

+

+

+/**

+  Convert a Null-terminated ASCII decimal string to a value of type

+  UINT64.

+

+  This function returns a value of type UINT64 by interpreting the contents

+  of the ASCII string String as a decimal number. The format of the input

+  ASCII string String is:

+

+                    [spaces] [decimal digits].

+

+  The valid decimal digit character is in the range [0-9]. The function will

+  ignore the pad space, which includes spaces or tab characters, before the digits.

+  The running zero in the beginning of [decimal digits] will be ignored. Then, the

+  function stops at the first character that is a not a valid decimal character or

+  Null-terminator, whichever on comes first.

+

+  If String has only pad spaces, then 0 is returned.

+  If String has no pad spaces or valid decimal digits, then 0 is returned.

+  If the number represented by String overflows according to the range defined by

+  UINT64, then MAX_UINT64 is returned.

+  If String is NULL, then ASSERT().

+  If PcdMaximumAsciiStringLength is not zero, and String contains more than

+  PcdMaximumAsciiStringLength ASCII characters not including the Null-terminator,

+  then ASSERT().

+

+  @param  String          A pointer to a Null-terminated ASCII string.

+

+  @retval Value translated from String.

+

+**/

+UINT64

+EFIAPI

+AsciiStrDecimalToUint64 (

+  IN      CONST CHAR8               *String

+  )

+{

+  UINT64     Result;

+

+  AsciiStrDecimalToUint64S (String, (CHAR8 **) NULL, &Result);

+  return Result;

+}

+

+/**

+  Convert a Null-terminated ASCII hexadecimal string to a value of type UINTN.

+

+  This function returns a value of type UINTN by interpreting the contents of

+  the ASCII string String as a hexadecimal number. The format of the input ASCII

+  string String is:

+

+                  [spaces][zeros][x][hexadecimal digits].

+

+  The valid hexadecimal digit character is in the range [0-9], [a-f] and [A-F].

+  The prefix "0x" is optional. Both "x" and "X" is allowed in "0x" prefix. If "x"

+  appears in the input string, it must be prefixed with at least one 0. The function

+  will ignore the pad space, which includes spaces or tab characters, before [zeros],

+  [x] or [hexadecimal digits]. The running zero before [x] or [hexadecimal digits]

+  will be ignored. Then, the decoding starts after [x] or the first valid hexadecimal

+  digit. Then, the function stops at the first character that is a not a valid

+  hexadecimal character or Null-terminator, whichever on comes first.

+

+  If String has only pad spaces, then 0 is returned.

+  If String has no leading pad spaces, leading zeros or valid hexadecimal digits, then

+  0 is returned.

+

+  If the number represented by String overflows according to the range defined by UINTN,

+  then MAX_UINTN is returned.

+  If String is NULL, then ASSERT().

+  If PcdMaximumAsciiStringLength is not zero,

+  and String contains more than PcdMaximumAsciiStringLength ASCII characters not including

+  the Null-terminator, then ASSERT().

+

+  @param  String          A pointer to a Null-terminated ASCII string.

+

+  @retval Value translated from String.

+

+**/

+UINTN

+EFIAPI

+AsciiStrHexToUintn (

+  IN      CONST CHAR8               *String

+  )

+{

+  UINTN     Result;

+

+  AsciiStrHexToUintnS (String, (CHAR8 **) NULL, &Result);

+  return Result;

+}

+

+

+/**

+  Convert a Null-terminated ASCII hexadecimal string to a value of type UINT64.

+

+  This function returns a value of type UINT64 by interpreting the contents of

+  the ASCII string String as a hexadecimal number. The format of the input ASCII

+  string String is:

+

+                  [spaces][zeros][x][hexadecimal digits].

+

+  The valid hexadecimal digit character is in the range [0-9], [a-f] and [A-F].

+  The prefix "0x" is optional. Both "x" and "X" is allowed in "0x" prefix. If "x"

+  appears in the input string, it must be prefixed with at least one 0. The function

+  will ignore the pad space, which includes spaces or tab characters, before [zeros],

+  [x] or [hexadecimal digits]. The running zero before [x] or [hexadecimal digits]

+  will be ignored. Then, the decoding starts after [x] or the first valid hexadecimal

+  digit. Then, the function stops at the first character that is a not a valid

+  hexadecimal character or Null-terminator, whichever on comes first.

+

+  If String has only pad spaces, then 0 is returned.

+  If String has no leading pad spaces, leading zeros or valid hexadecimal digits, then

+  0 is returned.

+

+  If the number represented by String overflows according to the range defined by UINT64,

+  then MAX_UINT64 is returned.

+  If String is NULL, then ASSERT().

+  If PcdMaximumAsciiStringLength is not zero,

+  and String contains more than PcdMaximumAsciiStringLength ASCII characters not including

+  the Null-terminator, then ASSERT().

+

+  @param  String          A pointer to a Null-terminated ASCII string.

+

+  @retval Value translated from String.

+

+**/

+UINT64

+EFIAPI

+AsciiStrHexToUint64 (

+  IN      CONST CHAR8                *String

+  )

+{

+  UINT64    Result;

+

+  AsciiStrHexToUint64S (String, (CHAR8 **) NULL, &Result);

+  return Result;

+}

+

+

+STATIC CHAR8 EncodingTable[] = "ABCDEFGHIJKLMNOPQRSTUVWXYZ"

+                                "abcdefghijklmnopqrstuvwxyz"

+                                "0123456789+/";

+

+/**

+  Convert binary data to a Base64 encoded ascii string based on RFC4648.

+

+  Produce a Null-terminated Ascii string in the output buffer specified by Destination and DestinationSize.

+  The Ascii string is produced by converting the data string specified by Source and SourceLength.

+

+  @param Source            Input UINT8 data

+  @param SourceLength      Number of UINT8 bytes of data

+  @param Destination       Pointer to output string buffer

+  @param DestinationSize   Size of ascii buffer. Set to 0 to get the size needed.

+                           Caller is responsible for passing in buffer of DestinationSize

+

+  @retval RETURN_SUCCESS             When ascii buffer is filled in.

+  @retval RETURN_INVALID_PARAMETER   If Source is NULL or DestinationSize is NULL.

+  @retval RETURN_INVALID_PARAMETER   If SourceLength or DestinationSize is bigger than (MAX_ADDRESS - (UINTN)Destination).

+  @retval RETURN_BUFFER_TOO_SMALL    If SourceLength is 0 and DestinationSize is <1.

+  @retval RETURN_BUFFER_TOO_SMALL    If Destination is NULL or DestinationSize is smaller than required buffersize.

+

+**/

+RETURN_STATUS

+EFIAPI

+Base64Encode (

+  IN  CONST UINT8  *Source,

+  IN        UINTN   SourceLength,

+  OUT       CHAR8  *Destination   OPTIONAL,

+  IN OUT    UINTN  *DestinationSize

+  )

+{

+

+  UINTN          RequiredSize;

+  UINTN          Left;

+

+  //

+  // Check pointers, and SourceLength is valid

+  //

+  if ((Source == NULL) || (DestinationSize == NULL)) {

+    return RETURN_INVALID_PARAMETER;

+  }

+

+  //

+  // Allow for RFC 4648 test vector 1

+  //

+  if (SourceLength == 0) {

+    if (*DestinationSize < 1) {

+      *DestinationSize = 1;

+      return RETURN_BUFFER_TOO_SMALL;

+    }

+    *DestinationSize = 1;

+    *Destination = '\0';

+    return RETURN_SUCCESS;

+  }

+

+  //

+  // Check if SourceLength or  DestinationSize is valid

+  //

+  if ((SourceLength >= (MAX_ADDRESS - (UINTN)Source)) || (*DestinationSize >= (MAX_ADDRESS - (UINTN)Destination))){

+    return RETURN_INVALID_PARAMETER;

+  }

+

+  //

+  // 4 ascii per 3 bytes + NULL

+  //

+  RequiredSize = ((SourceLength + 2) / 3) * 4 + 1;

+  if ((Destination == NULL) || *DestinationSize < RequiredSize) {

+    *DestinationSize = RequiredSize;

+    return RETURN_BUFFER_TOO_SMALL;

+  }

+

+  Left = SourceLength;

+

+  //

+  // Encode 24 bits (three bytes) into 4 ascii characters

+  //

+  while (Left >= 3) {

+

+    *Destination++ = EncodingTable[( Source[0] & 0xfc) >> 2 ];

+    *Destination++ = EncodingTable[((Source[0] & 0x03) << 4) + ((Source[1] & 0xf0) >> 4)];

+    *Destination++ = EncodingTable[((Source[1] & 0x0f) << 2) + ((Source[2] & 0xc0) >> 6)];

+    *Destination++ = EncodingTable[( Source[2] & 0x3f)];

+    Left -= 3;

+    Source += 3;

+  }

+

+  //

+  // Handle the remainder, and add padding '=' characters as necessary.

+  //

+  switch (Left) {

+    case 0:

+

+      //

+      // No bytes Left, done.

+      //

+      break;

+    case 1:

+

+      //

+      // One more data byte, two pad characters

+      //

+      *Destination++ = EncodingTable[( Source[0] & 0xfc) >> 2];

+      *Destination++ = EncodingTable[((Source[0] & 0x03) << 4)];

+      *Destination++ = '=';

+      *Destination++ = '=';

+      break;

+    case 2:

+

+      //

+      // Two more data bytes, and one pad character

+      //

+      *Destination++ = EncodingTable[( Source[0] & 0xfc) >> 2];

+      *Destination++ = EncodingTable[((Source[0] & 0x03) << 4) + ((Source[1] & 0xf0) >> 4)];

+      *Destination++ = EncodingTable[((Source[1] & 0x0f) << 2)];

+      *Destination++ = '=';

+      break;

+    }

+  //

+  // Add terminating NULL

+  //

+  *Destination = '\0';

+  return RETURN_SUCCESS;

+}

+

+/**

+  Decode Base64 ASCII encoded data to 8-bit binary representation, based on

+  RFC4648.

+

+  Decoding occurs according to "Table 1: The Base 64 Alphabet" in RFC4648.

+

+  Whitespace is ignored at all positions:

+  - 0x09 ('\t') horizontal tab

+  - 0x0A ('\n') new line

+  - 0x0B ('\v') vertical tab

+  - 0x0C ('\f') form feed

+  - 0x0D ('\r') carriage return

+  - 0x20 (' ')  space

+

+  The minimum amount of required padding (with ASCII 0x3D, '=') is tolerated

+  and enforced at the end of the Base64 ASCII encoded data, and only there.

+

+  Other characters outside of the encoding alphabet cause the function to

+  reject the Base64 ASCII encoded data.

+

+  @param[in] Source               Array of CHAR8 elements containing the Base64

+                                  ASCII encoding. May be NULL if SourceSize is

+                                  zero.

+

+  @param[in] SourceSize           Number of CHAR8 elements in Source.

+

+  @param[out] Destination         Array of UINT8 elements receiving the decoded

+                                  8-bit binary representation. Allocated by the

+                                  caller. May be NULL if DestinationSize is

+                                  zero on input. If NULL, decoding is

+                                  performed, but the 8-bit binary

+                                  representation is not stored. If non-NULL and

+                                  the function returns an error, the contents

+                                  of Destination are indeterminate.

+

+  @param[in,out] DestinationSize  On input, the number of UINT8 elements that

+                                  the caller allocated for Destination. On

+                                  output, if the function returns

+                                  RETURN_SUCCESS or RETURN_BUFFER_TOO_SMALL,

+                                  the number of UINT8 elements that are

+                                  required for decoding the Base64 ASCII

+                                  representation. If the function returns a

+                                  value different from both RETURN_SUCCESS and

+                                  RETURN_BUFFER_TOO_SMALL, then DestinationSize

+                                  is indeterminate on output.

+

+  @retval RETURN_SUCCESS            SourceSize CHAR8 elements at Source have

+                                    been decoded to on-output DestinationSize

+                                    UINT8 elements at Destination. Note that

+                                    RETURN_SUCCESS covers the case when

+                                    DestinationSize is zero on input, and

+                                    Source decodes to zero bytes (due to

+                                    containing at most ignored whitespace).

+

+  @retval RETURN_BUFFER_TOO_SMALL   The input value of DestinationSize is not

+                                    large enough for decoding SourceSize CHAR8

+                                    elements at Source. The required number of

+                                    UINT8 elements has been stored to

+                                    DestinationSize.

+

+  @retval RETURN_INVALID_PARAMETER  DestinationSize is NULL.

+

+  @retval RETURN_INVALID_PARAMETER  Source is NULL, but SourceSize is not zero.

+

+  @retval RETURN_INVALID_PARAMETER  Destination is NULL, but DestinationSize is

+                                    not zero on input.

+

+  @retval RETURN_INVALID_PARAMETER  Source is non-NULL, and (Source +

+                                    SourceSize) would wrap around MAX_ADDRESS.

+

+  @retval RETURN_INVALID_PARAMETER  Destination is non-NULL, and (Destination +

+                                    DestinationSize) would wrap around

+                                    MAX_ADDRESS, as specified on input.

+

+  @retval RETURN_INVALID_PARAMETER  None of Source and Destination are NULL,

+                                    and CHAR8[SourceSize] at Source overlaps

+                                    UINT8[DestinationSize] at Destination, as

+                                    specified on input.

+

+  @retval RETURN_INVALID_PARAMETER  Invalid CHAR8 element encountered in

+                                    Source.

+**/

+RETURN_STATUS

+EFIAPI

+Base64Decode (

+  IN     CONST CHAR8 *Source          OPTIONAL,

+  IN     UINTN       SourceSize,

+  OUT    UINT8       *Destination     OPTIONAL,

+  IN OUT UINTN       *DestinationSize

+  )

+{

+  BOOLEAN PaddingMode;

+  UINTN   SixBitGroupsConsumed;

+  UINT32  Accumulator;

+  UINTN   OriginalDestinationSize;

+  UINTN   SourceIndex;

+  CHAR8   SourceChar;

+  UINT32  Base64Value;

+  UINT8   DestinationOctet;

+

+  if (DestinationSize == NULL) {

+    return RETURN_INVALID_PARAMETER;

+  }

+

+  //

+  // Check Source array validity.

+  //

+  if (Source == NULL) {

+    if (SourceSize > 0) {

+      //

+      // At least one CHAR8 element at NULL Source.

+      //

+      return RETURN_INVALID_PARAMETER;

+    }

+  } else if (SourceSize > MAX_ADDRESS - (UINTN)Source) {

+    //

+    // Non-NULL Source, but it wraps around.

+    //

+    return RETURN_INVALID_PARAMETER;

+  }

+

+  //

+  // Check Destination array validity.

+  //

+  if (Destination == NULL) {

+    if (*DestinationSize > 0) {

+      //

+      // At least one UINT8 element at NULL Destination.

+      //

+      return RETURN_INVALID_PARAMETER;

+    }

+  } else if (*DestinationSize > MAX_ADDRESS - (UINTN)Destination) {

+    //

+    // Non-NULL Destination, but it wraps around.

+    //

+    return RETURN_INVALID_PARAMETER;

+  }

+

+  //

+  // Check for overlap.

+  //

+  if (Source != NULL && Destination != NULL) {

+    //

+    // Both arrays have been provided, and we know from earlier that each array

+    // is valid in itself.

+    //

+    if ((UINTN)Source + SourceSize <= (UINTN)Destination) {

+      //

+      // Source array precedes Destination array, OK.

+      //

+    } else if ((UINTN)Destination + *DestinationSize <= (UINTN)Source) {

+      //

+      // Destination array precedes Source array, OK.

+      //

+    } else {

+      //

+      // Overlap.

+      //

+      return RETURN_INVALID_PARAMETER;

+    }

+  }

+

+  //

+  // Decoding loop setup.

+  //

+  PaddingMode             = FALSE;

+  SixBitGroupsConsumed    = 0;

+  Accumulator             = 0;

+  OriginalDestinationSize = *DestinationSize;

+  *DestinationSize        = 0;

+

+  //

+  // Decoding loop.

+  //

+  for (SourceIndex = 0; SourceIndex < SourceSize; SourceIndex++) {

+    SourceChar = Source[SourceIndex];

+

+    //

+    // Whitespace is ignored at all positions (regardless of padding mode).

+    //

+    if (SourceChar == '\t' || SourceChar == '\n' || SourceChar == '\v' ||

+        SourceChar == '\f' || SourceChar == '\r' || SourceChar == ' ') {

+      continue;

+    }

+

+    //

+    // If we're in padding mode, accept another padding character, as long as

+    // that padding character completes the quantum. This completes case (2)

+    // from RFC4648, Chapter 4. "Base 64 Encoding":

+    //

+    // (2) The final quantum of encoding input is exactly 8 bits; here, the

+    //     final unit of encoded output will be two characters followed by two

+    //     "=" padding characters.

+    //

+    if (PaddingMode) {

+      if (SourceChar == '=' && SixBitGroupsConsumed == 3) {

+        SixBitGroupsConsumed = 0;

+        continue;

+      }

+      return RETURN_INVALID_PARAMETER;

+    }

+

+    //

+    // When not in padding mode, decode Base64Value based on RFC4648, "Table 1:

+    // The Base 64 Alphabet".

+    //

+    if ('A' <= SourceChar && SourceChar <= 'Z') {

+      Base64Value = SourceChar - 'A';

+    } else if ('a' <= SourceChar && SourceChar <= 'z') {

+      Base64Value = 26 + (SourceChar - 'a');

+    } else if ('0' <= SourceChar && SourceChar <= '9') {

+      Base64Value = 52 + (SourceChar - '0');

+    } else if (SourceChar == '+') {

+      Base64Value = 62;

+    } else if (SourceChar == '/') {

+      Base64Value = 63;

+    } else if (SourceChar == '=') {

+      //

+      // Enter padding mode.

+      //

+      PaddingMode = TRUE;

+

+      if (SixBitGroupsConsumed == 2) {

+        //

+        // If we have consumed two 6-bit groups from the current quantum before

+        // encountering the first padding character, then this is case (2) from

+        // RFC4648, Chapter 4. "Base 64 Encoding". Bump SixBitGroupsConsumed,

+        // and we'll enforce another padding character.

+        //

+        SixBitGroupsConsumed = 3;

+      } else if (SixBitGroupsConsumed == 3) {

+        //

+        // If we have consumed three 6-bit groups from the current quantum

+        // before encountering the first padding character, then this is case

+        // (3) from RFC4648, Chapter 4. "Base 64 Encoding". The quantum is now

+        // complete.

+        //

+        SixBitGroupsConsumed = 0;

+      } else {

+        //

+        // Padding characters are not allowed at the first two positions of a

+        // quantum.

+        //

+        return RETURN_INVALID_PARAMETER;

+      }

+

+      //

+      // Wherever in a quantum we enter padding mode, we enforce the padding

+      // bits pending in the accumulator -- from the last 6-bit group just

+      // preceding the padding character -- to be zero. Refer to RFC4648,

+      // Chapter 3.5. "Canonical Encoding".

+      //

+      if (Accumulator != 0) {

+        return RETURN_INVALID_PARAMETER;

+      }

+

+      //

+      // Advance to the next source character.

+      //

+      continue;

+    } else {

+      //

+      // Other characters outside of the encoding alphabet are rejected.

+      //

+      return RETURN_INVALID_PARAMETER;

+    }

+

+    //

+    // Feed the bits of the current 6-bit group of the quantum to the

+    // accumulator.

+    //

+    Accumulator = (Accumulator << 6) | Base64Value;

+    SixBitGroupsConsumed++;

+    switch (SixBitGroupsConsumed) {

+    case 1:

+      //

+      // No octet to spill after consuming the first 6-bit group of the

+      // quantum; advance to the next source character.

+      //

+      continue;

+    case 2:

+      //

+      // 12 bits accumulated (6 pending + 6 new); prepare for spilling an

+      // octet. 4 bits remain pending.

+      //

+      DestinationOctet = (UINT8)(Accumulator >> 4);

+      Accumulator &= 0xF;

+      break;

+    case 3:

+      //

+      // 10 bits accumulated (4 pending + 6 new); prepare for spilling an

+      // octet. 2 bits remain pending.

+      //

+      DestinationOctet = (UINT8)(Accumulator >> 2);

+      Accumulator &= 0x3;

+      break;

+    default:

+      ASSERT (SixBitGroupsConsumed == 4);

+      //

+      // 8 bits accumulated (2 pending + 6 new); prepare for spilling an octet.

+      // The quantum is complete, 0 bits remain pending.

+      //

+      DestinationOctet = (UINT8)Accumulator;

+      Accumulator = 0;

+      SixBitGroupsConsumed = 0;

+      break;

+    }

+

+    //

+    // Store the decoded octet if there's room left. Increment

+    // (*DestinationSize) unconditionally.

+    //

+    if (*DestinationSize < OriginalDestinationSize) {

+      ASSERT (Destination != NULL);

+      Destination[*DestinationSize] = DestinationOctet;

+    }

+    (*DestinationSize)++;

+

+    //

+    // Advance to the next source character.

+    //

+  }

+

+  //

+  // If Source terminates mid-quantum, then Source is invalid.

+  //

+  if (SixBitGroupsConsumed != 0) {

+    return RETURN_INVALID_PARAMETER;

+  }

+

+  //

+  // Done.

+  //

+  if (*DestinationSize <= OriginalDestinationSize) {

+    return RETURN_SUCCESS;

+  }

+  return RETURN_BUFFER_TOO_SMALL;

+}

+

+/**

+  Converts an 8-bit value to an 8-bit BCD value.

+

+  Converts the 8-bit value specified by Value to BCD. The BCD value is

+  returned.

+

+  If Value >= 100, then ASSERT().

+

+  @param  Value The 8-bit value to convert to BCD. Range 0..99.

+

+  @return The BCD value.

+

+**/

+UINT8

+EFIAPI

+DecimalToBcd8 (

+  IN      UINT8                     Value

+  )

+{

+  ASSERT (Value < 100);

+  return (UINT8) (((Value / 10) << 4) | (Value % 10));

+}

+

+/**

+  Converts an 8-bit BCD value to an 8-bit value.

+

+  Converts the 8-bit BCD value specified by Value to an 8-bit value. The 8-bit

+  value is returned.

+

+  If Value >= 0xA0, then ASSERT().

+  If (Value & 0x0F) >= 0x0A, then ASSERT().

+

+  @param  Value The 8-bit BCD value to convert to an 8-bit value.

+

+  @return The 8-bit value is returned.

+

+**/

+UINT8

+EFIAPI

+BcdToDecimal8 (

+  IN      UINT8                     Value

+  )

+{

+  ASSERT (Value < 0xa0);

+  ASSERT ((Value & 0xf) < 0xa);

+  return (UINT8) ((Value >> 4) * 10 + (Value & 0xf));

+}

diff --git a/debugging_demo/memtest86+/efi/Include/src/BaseLib/SwapBytes16.c b/debugging_demo/memtest86+/efi/Include/src/BaseLib/SwapBytes16.c
new file mode 100644
index 0000000..52e7f71
--- /dev/null
+++ b/debugging_demo/memtest86+/efi/Include/src/BaseLib/SwapBytes16.c
@@ -0,0 +1,33 @@
+/** @file

+  Math worker functions.

+

+  Copyright (c) 2006 - 2008, Intel Corporation. All rights reserved.<BR>

+  SPDX-License-Identifier: BSD-2-Clause-Patent

+

+**/

+

+

+

+

+#include "BaseLibInternals.h"

+

+/**

+  Switches the endianess of a 16-bit integer.

+

+  This function swaps the bytes in a 16-bit unsigned value to switch the value

+  from little endian to big endian or vice versa. The byte swapped value is

+  returned.

+

+  @param  Value A 16-bit unsigned value.

+

+  @return The byte swapped Value.

+

+**/

+UINT16

+EFIAPI

+SwapBytes16 (

+  IN      UINT16                    Value

+  )

+{

+  return (UINT16) ((Value<< 8) | (Value>> 8));

+}

diff --git a/debugging_demo/memtest86+/efi/Include/src/BaseLib/SwapBytes32.c b/debugging_demo/memtest86+/efi/Include/src/BaseLib/SwapBytes32.c
new file mode 100644
index 0000000..5109ad5
--- /dev/null
+++ b/debugging_demo/memtest86+/efi/Include/src/BaseLib/SwapBytes32.c
@@ -0,0 +1,39 @@
+/** @file

+  Math worker functions.

+

+  Copyright (c) 2006 - 2008, Intel Corporation. All rights reserved.<BR>

+  SPDX-License-Identifier: BSD-2-Clause-Patent

+

+**/

+

+

+

+

+#include "BaseLibInternals.h"

+

+/**

+  Switches the endianess of a 32-bit integer.

+

+  This function swaps the bytes in a 32-bit unsigned value to switch the value

+  from little endian to big endian or vice versa. The byte swapped value is

+  returned.

+

+  @param  Value A 32-bit unsigned value.

+

+  @return The byte swapped Value.

+

+**/

+UINT32

+EFIAPI

+SwapBytes32 (

+  IN      UINT32                    Value

+  )

+{

+  UINT32  LowerBytes;

+  UINT32  HigherBytes;

+

+  LowerBytes  = (UINT32) SwapBytes16 ((UINT16) Value);

+  HigherBytes = (UINT32) SwapBytes16 ((UINT16) (Value >> 16));

+

+  return (LowerBytes << 16 | HigherBytes);

+}

diff --git a/debugging_demo/memtest86+/efi/Include/src/BaseLib/SwapBytes64.c b/debugging_demo/memtest86+/efi/Include/src/BaseLib/SwapBytes64.c
new file mode 100644
index 0000000..500f76d
--- /dev/null
+++ b/debugging_demo/memtest86+/efi/Include/src/BaseLib/SwapBytes64.c
@@ -0,0 +1,33 @@
+/** @file

+  Math worker functions.

+

+  Copyright (c) 2006 - 2008, Intel Corporation. All rights reserved.<BR>

+  SPDX-License-Identifier: BSD-2-Clause-Patent

+

+**/

+

+

+

+

+#include "BaseLibInternals.h"

+

+/**

+  Switches the endianess of a 64-bit integer.

+

+  This function swaps the bytes in a 64-bit unsigned value to switch the value

+  from little endian to big endian or vice versa. The byte swapped value is

+  returned.

+

+  @param  Value A 64-bit unsigned value.

+

+  @return The byte swapped Value.

+

+**/

+UINT64

+EFIAPI

+SwapBytes64 (

+  IN      UINT64                    Value

+  )

+{

+  return InternalMathSwapBytes64 (Value);

+}

diff --git a/debugging_demo/memtest86+/efi/Include/src/BaseLib/SwitchStack.c b/debugging_demo/memtest86+/efi/Include/src/BaseLib/SwitchStack.c
new file mode 100644
index 0000000..cb9f69f
--- /dev/null
+++ b/debugging_demo/memtest86+/efi/Include/src/BaseLib/SwitchStack.c
@@ -0,0 +1,70 @@
+/** @file

+  Switch Stack functions.

+

+  Copyright (c) 2006 - 2018, Intel Corporation. All rights reserved.<BR>

+  SPDX-License-Identifier: BSD-2-Clause-Patent

+

+**/

+

+#include "BaseLibInternals.h"

+

+/**

+  Transfers control to a function starting with a new stack.

+

+  Transfers control to the function specified by EntryPoint using the

+  new stack specified by NewStack and passing in the parameters specified

+  by Context1 and Context2.  Context1 and Context2 are optional and may

+  be NULL.  The function EntryPoint must never return.  This function

+  supports a variable number of arguments following the NewStack parameter.

+  These additional arguments are ignored on IA-32, x64, and EBC.

+  IPF CPUs expect one additional parameter of type VOID * that specifies

+  the new backing store pointer.

+

+  If EntryPoint is NULL, then ASSERT().

+  If NewStack is NULL, then ASSERT().

+

+  @param  EntryPoint  A pointer to function to call with the new stack.

+  @param  Context1    A pointer to the context to pass into the EntryPoint

+                      function.

+  @param  Context2    A pointer to the context to pass into the EntryPoint

+                      function.

+  @param  NewStack    A pointer to the new stack to use for the EntryPoint

+                      function.

+  @param  ...         This variable argument list is ignored for IA32, x64, and EBC.

+                      For IPF, this variable argument list is expected to contain

+                      a single parameter of type VOID * that specifies the new backing

+                      store pointer.

+

+

+**/

+VOID

+EFIAPI

+SwitchStack (

+  IN      SWITCH_STACK_ENTRY_POINT  EntryPoint,

+  IN      VOID                      *Context1,  OPTIONAL

+  IN      VOID                      *Context2,  OPTIONAL

+  IN      VOID                      *NewStack,

+  ...

+  )

+{

+  VA_LIST    Marker;

+

+  ASSERT (EntryPoint != NULL);

+  ASSERT (NewStack != NULL);

+

+  //

+  // New stack must be aligned with CPU_STACK_ALIGNMENT

+  //

+  ASSERT (((UINTN)NewStack & (CPU_STACK_ALIGNMENT - 1)) == 0);

+

+  VA_START (Marker, NewStack);

+

+  InternalSwitchStack (EntryPoint, Context1, Context2, NewStack, Marker);

+

+  VA_END (Marker);

+

+  //

+  // InternalSwitchStack () will never return

+  //

+  ASSERT (FALSE);

+}

diff --git a/debugging_demo/memtest86+/efi/Include/src/BaseLib/Unaligned.c b/debugging_demo/memtest86+/efi/Include/src/BaseLib/Unaligned.c
new file mode 100644
index 0000000..a419cb8
--- /dev/null
+++ b/debugging_demo/memtest86+/efi/Include/src/BaseLib/Unaligned.c
@@ -0,0 +1,216 @@
+/** @file

+  Unaligned access functions of BaseLib.

+

+  Copyright (c) 2006 - 2010, Intel Corporation. All rights reserved.<BR>

+  SPDX-License-Identifier: BSD-2-Clause-Patent

+

+**/

+

+

+#include "BaseLibInternals.h"

+

+

+/**

+  Reads a 16-bit value from memory that may be unaligned.

+

+  This function returns the 16-bit value pointed to by Buffer. The function

+  guarantees that the read operation does not produce an alignment fault.

+

+  If the Buffer is NULL, then ASSERT().

+

+  @param  Buffer  A pointer to a 16-bit value that may be unaligned.

+

+  @return The 16-bit value read from Buffer.

+

+**/

+UINT16

+EFIAPI

+ReadUnaligned16 (

+  IN CONST UINT16              *Buffer

+  )

+{

+  ASSERT (Buffer != NULL);

+

+  return *Buffer;

+}

+

+/**

+  Writes a 16-bit value to memory that may be unaligned.

+

+  This function writes the 16-bit value specified by Value to Buffer. Value is

+  returned. The function guarantees that the write operation does not produce

+  an alignment fault.

+

+  If the Buffer is NULL, then ASSERT().

+

+  @param  Buffer  A pointer to a 16-bit value that may be unaligned.

+  @param  Value   16-bit value to write to Buffer.

+

+  @return The 16-bit value to write to Buffer.

+

+**/

+UINT16

+EFIAPI

+WriteUnaligned16 (

+  OUT UINT16                    *Buffer,

+  IN  UINT16                    Value

+  )

+{

+  ASSERT (Buffer != NULL);

+

+  return *Buffer = Value;

+}

+

+/**

+  Reads a 24-bit value from memory that may be unaligned.

+

+  This function returns the 24-bit value pointed to by Buffer. The function

+  guarantees that the read operation does not produce an alignment fault.

+

+  If the Buffer is NULL, then ASSERT().

+

+  @param  Buffer  A pointer to a 24-bit value that may be unaligned.

+

+  @return The 24-bit value read from Buffer.

+

+**/

+UINT32

+EFIAPI

+ReadUnaligned24 (

+  IN CONST UINT32              *Buffer

+  )

+{

+  ASSERT (Buffer != NULL);

+

+  return *Buffer & 0xffffff;

+}

+

+/**

+  Writes a 24-bit value to memory that may be unaligned.

+

+  This function writes the 24-bit value specified by Value to Buffer. Value is

+  returned. The function guarantees that the write operation does not produce

+  an alignment fault.

+

+  If the Buffer is NULL, then ASSERT().

+

+  @param  Buffer  A pointer to a 24-bit value that may be unaligned.

+  @param  Value   24-bit value to write to Buffer.

+

+  @return The 24-bit value to write to Buffer.

+

+**/

+UINT32

+EFIAPI

+WriteUnaligned24 (

+  OUT UINT32                    *Buffer,

+  IN  UINT32                    Value

+  )

+{

+  ASSERT (Buffer != NULL);

+

+  *Buffer = BitFieldWrite32 (*Buffer, 0, 23, Value);

+  return Value;

+}

+

+/**

+  Reads a 32-bit value from memory that may be unaligned.

+

+  This function returns the 32-bit value pointed to by Buffer. The function

+  guarantees that the read operation does not produce an alignment fault.

+

+  If the Buffer is NULL, then ASSERT().

+

+  @param  Buffer  A pointer to a 32-bit value that may be unaligned.

+

+  @return The 32-bit value read from Buffer.

+

+**/

+UINT32

+EFIAPI

+ReadUnaligned32 (

+  IN CONST UINT32              *Buffer

+  )

+{

+  ASSERT (Buffer != NULL);

+

+  return *Buffer;

+}

+

+/**

+  Writes a 32-bit value to memory that may be unaligned.

+

+  This function writes the 32-bit value specified by Value to Buffer. Value is

+  returned. The function guarantees that the write operation does not produce

+  an alignment fault.

+

+  If the Buffer is NULL, then ASSERT().

+

+  @param  Buffer  A pointer to a 32-bit value that may be unaligned.

+  @param  Value   The 32-bit value to write to Buffer.

+

+  @return The 32-bit value to write to Buffer.

+

+**/

+UINT32

+EFIAPI

+WriteUnaligned32 (

+  OUT UINT32                    *Buffer,

+  IN  UINT32                    Value

+  )

+{

+  ASSERT (Buffer != NULL);

+

+  return *Buffer = Value;

+}

+

+/**

+  Reads a 64-bit value from memory that may be unaligned.

+

+  This function returns the 64-bit value pointed to by Buffer. The function

+  guarantees that the read operation does not produce an alignment fault.

+

+  If the Buffer is NULL, then ASSERT().

+

+  @param  Buffer  A pointer to a 64-bit value that may be unaligned.

+

+  @return The 64-bit value read from Buffer.

+

+**/

+UINT64

+EFIAPI

+ReadUnaligned64 (

+  IN CONST UINT64              *Buffer

+  )

+{

+  ASSERT (Buffer != NULL);

+

+  return *Buffer;

+}

+

+/**

+  Writes a 64-bit value to memory that may be unaligned.

+

+  This function writes the 64-bit value specified by Value to Buffer. Value is

+  returned. The function guarantees that the write operation does not produce

+  an alignment fault.

+

+  If the Buffer is NULL, then ASSERT().

+

+  @param  Buffer  A pointer to a 64-bit value that may be unaligned.

+  @param  Value   The 64-bit value to write to Buffer.

+

+  @return The 64-bit value to write to Buffer.

+

+**/

+UINT64

+EFIAPI

+WriteUnaligned64 (

+  OUT UINT64                    *Buffer,

+  IN  UINT64                    Value

+  )

+{

+  ASSERT (Buffer != NULL);

+

+  return *Buffer = Value;

+}

diff --git a/debugging_demo/memtest86+/efi/Include/src/BaseLib/UnitTestHost.c b/debugging_demo/memtest86+/efi/Include/src/BaseLib/UnitTestHost.c
new file mode 100644
index 0000000..79eec7c
--- /dev/null
+++ b/debugging_demo/memtest86+/efi/Include/src/BaseLib/UnitTestHost.c
@@ -0,0 +1,140 @@
+/** @file

+  Common Unit Test Host functions.

+

+  Copyright (c) 2020, Intel Corporation. All rights reserved.<BR>

+  SPDX-License-Identifier: BSD-2-Clause-Patent

+

+**/

+

+#include "UnitTestHost.h"

+

+///

+/// Module global variable for simple system emulation of interrupt state

+///

+STATIC BOOLEAN          mUnitTestHostBaseLibInterruptState;

+

+/**

+  Enables CPU interrupts.

+

+**/

+VOID

+EFIAPI

+UnitTestHostBaseLibEnableInterrupts (

+  VOID

+  )

+{

+  mUnitTestHostBaseLibInterruptState = TRUE;

+}

+

+/**

+  Disables CPU interrupts.

+

+**/

+VOID

+EFIAPI

+UnitTestHostBaseLibDisableInterrupts (

+  VOID

+  )

+{

+  mUnitTestHostBaseLibInterruptState = FALSE;

+}

+

+/**

+  Enables CPU interrupts for the smallest window required to capture any

+  pending interrupts.

+

+**/

+VOID

+EFIAPI

+UnitTestHostBaseLibEnableDisableInterrupts (

+  VOID

+  )

+{

+  mUnitTestHostBaseLibInterruptState = FALSE;

+}

+

+/**

+  Set the current CPU interrupt state.

+

+  Sets the current CPU interrupt state to the state specified by

+  InterruptState. If InterruptState is TRUE, then interrupts are enabled. If

+  InterruptState is FALSE, then interrupts are disabled. InterruptState is

+  returned.

+

+  @param  InterruptState  TRUE if interrupts should enabled. FALSE if

+                          interrupts should be disabled.

+

+  @return InterruptState

+

+**/

+BOOLEAN

+EFIAPI

+UnitTestHostBaseLibGetInterruptState (

+  VOID

+  )

+{

+  return mUnitTestHostBaseLibInterruptState;

+}

+

+/**

+  Enables CPU interrupts.

+

+**/

+VOID

+EFIAPI

+EnableInterrupts (

+  VOID

+  )

+{

+  gUnitTestHostBaseLib.Common->EnableInterrupts ();

+}

+

+/**

+  Disables CPU interrupts.

+

+**/

+VOID

+EFIAPI

+DisableInterrupts (

+  VOID

+  )

+{

+  gUnitTestHostBaseLib.Common->DisableInterrupts ();

+}

+

+/**

+  Enables CPU interrupts for the smallest window required to capture any

+  pending interrupts.

+

+**/

+VOID

+EFIAPI

+EnableDisableInterrupts (

+  VOID

+  )

+{

+  gUnitTestHostBaseLib.Common->EnableDisableInterrupts ();

+}

+

+/**

+  Set the current CPU interrupt state.

+

+  Sets the current CPU interrupt state to the state specified by

+  InterruptState. If InterruptState is TRUE, then interrupts are enabled. If

+  InterruptState is FALSE, then interrupts are disabled. InterruptState is

+  returned.

+

+  @param  InterruptState  TRUE if interrupts should enabled. FALSE if

+                          interrupts should be disabled.

+

+  @return InterruptState

+

+**/

+BOOLEAN

+EFIAPI

+GetInterruptState (

+  VOID

+  )

+{

+  return gUnitTestHostBaseLib.Common->GetInterruptState ();

+}

diff --git a/debugging_demo/memtest86+/efi/Include/src/BaseLib/UnitTestHost.h b/debugging_demo/memtest86+/efi/Include/src/BaseLib/UnitTestHost.h
new file mode 100644
index 0000000..42bc6b7
--- /dev/null
+++ b/debugging_demo/memtest86+/efi/Include/src/BaseLib/UnitTestHost.h
@@ -0,0 +1,66 @@
+/** @file

+  Unit Test Host functions.

+

+  Copyright (c) 2020, Intel Corporation. All rights reserved.<BR>

+  SPDX-License-Identifier: BSD-2-Clause-Patent

+

+**/

+

+#ifndef __UNIT_TEST_HOST_H__

+#define __UNIT_TEST_HOST_H__

+

+#include "BaseLibInternals.h"

+#include <Library/UnitTestHostBaseLib.h>

+

+/**

+  Enables CPU interrupts.

+

+**/

+VOID

+EFIAPI

+UnitTestHostBaseLibEnableInterrupts (

+  VOID

+  );

+

+/**

+  Disables CPU interrupts.

+

+**/

+VOID

+EFIAPI

+UnitTestHostBaseLibDisableInterrupts (

+  VOID

+  );

+

+/**

+  Enables CPU interrupts for the smallest window required to capture any

+  pending interrupts.

+

+**/

+VOID

+EFIAPI

+UnitTestHostBaseLibEnableDisableInterrupts (

+  VOID

+  );

+

+/**

+  Set the current CPU interrupt state.

+

+  Sets the current CPU interrupt state to the state specified by

+  InterruptState. If InterruptState is TRUE, then interrupts are enabled. If

+  InterruptState is FALSE, then interrupts are disabled. InterruptState is

+  returned.

+

+  @param  InterruptState  TRUE if interrupts should enabled. FALSE if

+                          interrupts should be disabled.

+

+  @return InterruptState

+

+**/

+BOOLEAN

+EFIAPI

+UnitTestHostBaseLibGetInterruptState (

+  VOID

+  );

+

+#endif

diff --git a/debugging_demo/memtest86+/efi/Include/src/BaseLib/X64/CpuBreakpoint.c b/debugging_demo/memtest86+/efi/Include/src/BaseLib/X64/CpuBreakpoint.c
new file mode 100644
index 0000000..c626ef8
--- /dev/null
+++ b/debugging_demo/memtest86+/efi/Include/src/BaseLib/X64/CpuBreakpoint.c
@@ -0,0 +1,33 @@
+/** @file

+  CpuBreakpoint function.

+

+  Copyright (c) 2006 - 2008, Intel Corporation. All rights reserved.<BR>

+  SPDX-License-Identifier: BSD-2-Clause-Patent

+

+**/

+

+

+/**

+  Microsoft Visual Studio 7.1 Function Prototypes for I/O Intrinsics.

+**/

+

+void __debugbreak (VOID);

+

+#pragma intrinsic(__debugbreak)

+

+/**

+  Generates a breakpoint on the CPU.

+

+  Generates a breakpoint on the CPU. The breakpoint must be implemented such

+  that code can resume normal execution after the breakpoint.

+

+**/

+VOID

+EFIAPI

+CpuBreakpoint (

+  VOID

+  )

+{

+  __debugbreak ();

+}

+

diff --git a/debugging_demo/memtest86+/efi/Include/src/BaseLib/X64/CpuBreakpoint.nasm b/debugging_demo/memtest86+/efi/Include/src/BaseLib/X64/CpuBreakpoint.nasm
new file mode 100644
index 0000000..5bdbe32
--- /dev/null
+++ b/debugging_demo/memtest86+/efi/Include/src/BaseLib/X64/CpuBreakpoint.nasm
@@ -0,0 +1,31 @@
+;------------------------------------------------------------------------------ ;

+; Copyright (c) 2006, Intel Corporation. All rights reserved.<BR>

+; SPDX-License-Identifier: BSD-2-Clause-Patent

+;

+; Module Name:

+;

+;   CpuBreakpoint.Asm

+;

+; Abstract:

+;

+;   CpuBreakpoint function

+;

+; Notes:

+;

+;------------------------------------------------------------------------------

+

+    DEFAULT REL

+    SECTION .text

+

+;------------------------------------------------------------------------------

+; VOID

+; EFIAPI

+; CpuBreakpoint (

+;   VOID

+;   );

+;------------------------------------------------------------------------------

+global ASM_PFX(CpuBreakpoint)

+ASM_PFX(CpuBreakpoint):

+    int  3

+    ret

+

diff --git a/debugging_demo/memtest86+/efi/Include/src/BaseLib/X64/CpuId.nasm b/debugging_demo/memtest86+/efi/Include/src/BaseLib/X64/CpuId.nasm
new file mode 100644
index 0000000..bb83017
--- /dev/null
+++ b/debugging_demo/memtest86+/efi/Include/src/BaseLib/X64/CpuId.nasm
@@ -0,0 +1,58 @@
+;------------------------------------------------------------------------------

+;

+; Copyright (c) 2006 - 2008, Intel Corporation. All rights reserved.<BR>

+; SPDX-License-Identifier: BSD-2-Clause-Patent

+;

+; Module Name:

+;

+;   CpuId.Asm

+;

+; Abstract:

+;

+;   AsmCpuid function

+;

+; Notes:

+;

+;------------------------------------------------------------------------------

+

+    DEFAULT REL

+    SECTION .text

+

+;------------------------------------------------------------------------------

+;  VOID

+;  EFIAPI

+;  AsmCpuid (

+;    IN   UINT32  RegisterInEax,

+;    OUT  UINT32  *RegisterOutEax  OPTIONAL,

+;    OUT  UINT32  *RegisterOutEbx  OPTIONAL,

+;    OUT  UINT32  *RegisterOutEcx  OPTIONAL,

+;    OUT  UINT32  *RegisterOutEdx  OPTIONAL

+;    )

+;------------------------------------------------------------------------------

+global ASM_PFX(AsmCpuid)

+ASM_PFX(AsmCpuid):

+    push    rbx

+    mov     eax, ecx

+    push    rax                         ; save Index on stack

+    push    rdx

+    cpuid

+    test    r9, r9

+    jz      .0

+    mov     [r9], ecx

+.0:

+    pop     rcx

+    jrcxz   .1

+    mov     [rcx], eax

+.1:

+    mov     rcx, r8

+    jrcxz   .2

+    mov     [rcx], ebx

+.2:

+    mov     rcx, [rsp + 0x38]

+    jrcxz   .3

+    mov     [rcx], edx

+.3:

+    pop     rax                         ; restore Index to rax as return value

+    pop     rbx

+    ret

+

diff --git a/debugging_demo/memtest86+/efi/Include/src/BaseLib/X64/CpuIdEx.nasm b/debugging_demo/memtest86+/efi/Include/src/BaseLib/X64/CpuIdEx.nasm
new file mode 100644
index 0000000..fd5caa3
--- /dev/null
+++ b/debugging_demo/memtest86+/efi/Include/src/BaseLib/X64/CpuIdEx.nasm
@@ -0,0 +1,60 @@
+;------------------------------------------------------------------------------

+;

+; Copyright (c) 2006 - 2008, Intel Corporation. All rights reserved.<BR>

+; SPDX-License-Identifier: BSD-2-Clause-Patent

+;

+; Module Name:

+;

+;   CpuIdEx.Asm

+;

+; Abstract:

+;

+;   AsmCpuidEx function

+;

+; Notes:

+;

+;------------------------------------------------------------------------------

+

+    DEFAULT REL

+    SECTION .text

+

+;------------------------------------------------------------------------------

+;  UINT32

+;  EFIAPI

+;  AsmCpuidEx (

+;    IN   UINT32  RegisterInEax,

+;    IN   UINT32  RegisterInEcx,

+;    OUT  UINT32  *RegisterOutEax  OPTIONAL,

+;    OUT  UINT32  *RegisterOutEbx  OPTIONAL,

+;    OUT  UINT32  *RegisterOutEcx  OPTIONAL,

+;    OUT  UINT32  *RegisterOutEdx  OPTIONAL

+;    )

+;------------------------------------------------------------------------------

+global ASM_PFX(AsmCpuidEx)

+ASM_PFX(AsmCpuidEx):

+    push    rbx

+    mov     eax, ecx

+    mov     ecx, edx

+    push    rax                         ; save Index on stack

+    cpuid

+    mov     r10, [rsp + 0x38]

+    test    r10, r10

+    jz      .0

+    mov     [r10], ecx

+.0:

+    mov     rcx, r8

+    jrcxz   .1

+    mov     [rcx], eax

+.1:

+    mov     rcx, r9

+    jrcxz   .2

+    mov     [rcx], ebx

+.2:

+    mov     rcx, [rsp + 0x40]

+    jrcxz   .3

+    mov     [rcx], edx

+.3:

+    pop     rax                         ; restore Index to rax as return value

+    pop     rbx

+    ret

+

diff --git a/debugging_demo/memtest86+/efi/Include/src/BaseLib/X64/CpuPause.nasm b/debugging_demo/memtest86+/efi/Include/src/BaseLib/X64/CpuPause.nasm
new file mode 100644
index 0000000..ca35197
--- /dev/null
+++ b/debugging_demo/memtest86+/efi/Include/src/BaseLib/X64/CpuPause.nasm
@@ -0,0 +1,31 @@
+;------------------------------------------------------------------------------ ;

+; Copyright (c) 2006, Intel Corporation. All rights reserved.<BR>

+; SPDX-License-Identifier: BSD-2-Clause-Patent

+;

+; Module Name:

+;

+;   CpuPause.Asm

+;

+; Abstract:

+;

+;   CpuPause function

+;

+; Notes:

+;

+;------------------------------------------------------------------------------

+

+    DEFAULT REL

+    SECTION .text

+

+;------------------------------------------------------------------------------

+; VOID

+; EFIAPI

+; CpuPause (

+;   VOID

+;   );

+;------------------------------------------------------------------------------

+global ASM_PFX(CpuPause)

+ASM_PFX(CpuPause):

+    pause

+    ret

+

diff --git a/debugging_demo/memtest86+/efi/Include/src/BaseLib/X64/DisableCache.nasm b/debugging_demo/memtest86+/efi/Include/src/BaseLib/X64/DisableCache.nasm
new file mode 100644
index 0000000..93f5f75
--- /dev/null
+++ b/debugging_demo/memtest86+/efi/Include/src/BaseLib/X64/DisableCache.nasm
@@ -0,0 +1,37 @@
+;------------------------------------------------------------------------------

+;

+; Copyright (c) 2006 - 2008, Intel Corporation. All rights reserved.<BR>

+; SPDX-License-Identifier: BSD-2-Clause-Patent

+;

+; Module Name:

+;

+;   DisableCache.Asm

+;

+; Abstract:

+;

+;   Set the CD bit of CR0 to 1, clear the NW bit of CR0 to 0, and flush all caches with a

+;   WBINVD instruction.

+;

+; Notes:

+;

+;------------------------------------------------------------------------------

+

+    DEFAULT REL

+    SECTION .text

+

+;------------------------------------------------------------------------------

+; VOID

+; EFIAPI

+; AsmDisableCache (

+;   VOID

+;   );

+;------------------------------------------------------------------------------

+global ASM_PFX(AsmDisableCache)

+ASM_PFX(AsmDisableCache):

+    mov     rax, cr0

+    bts     rax, 30

+    btr     rax, 29

+    mov     cr0, rax

+    wbinvd

+    ret

+

diff --git a/debugging_demo/memtest86+/efi/Include/src/BaseLib/X64/DisableInterrupts.nasm b/debugging_demo/memtest86+/efi/Include/src/BaseLib/X64/DisableInterrupts.nasm
new file mode 100644
index 0000000..43c7e5d
--- /dev/null
+++ b/debugging_demo/memtest86+/efi/Include/src/BaseLib/X64/DisableInterrupts.nasm
@@ -0,0 +1,32 @@
+;------------------------------------------------------------------------------

+;

+; Copyright (c) 2006, Intel Corporation. All rights reserved.<BR>

+; SPDX-License-Identifier: BSD-2-Clause-Patent

+;

+; Module Name:

+;

+;   DisableInterrupts.Asm

+;

+; Abstract:

+;

+;   DisableInterrupts function

+;

+; Notes:

+;

+;------------------------------------------------------------------------------

+

+    DEFAULT REL

+    SECTION .text

+

+;------------------------------------------------------------------------------

+; VOID

+; EFIAPI

+; DisableInterrupts (

+;   VOID

+;   );

+;------------------------------------------------------------------------------

+global ASM_PFX(DisableInterrupts)

+ASM_PFX(DisableInterrupts):

+    cli

+    ret

+

diff --git a/debugging_demo/memtest86+/efi/Include/src/BaseLib/X64/DisablePaging64.nasm b/debugging_demo/memtest86+/efi/Include/src/BaseLib/X64/DisablePaging64.nasm
new file mode 100644
index 0000000..c76ed1a
--- /dev/null
+++ b/debugging_demo/memtest86+/efi/Include/src/BaseLib/X64/DisablePaging64.nasm
@@ -0,0 +1,78 @@
+;------------------------------------------------------------------------------

+;

+; Copyright (c) 2006 - 2008, Intel Corporation. All rights reserved.<BR>

+; SPDX-License-Identifier: BSD-2-Clause-Patent

+;

+; Module Name:

+;

+;   DisablePaging64.Asm

+;

+; Abstract:

+;

+;   AsmDisablePaging64 function

+;

+; Notes:

+;

+;------------------------------------------------------------------------------

+

+    DEFAULT REL

+    SECTION .text

+

+;------------------------------------------------------------------------------

+; VOID

+; EFIAPI

+; InternalX86DisablePaging64 (

+;   IN      UINT16                    Cs,

+;   IN      UINT32                    EntryPoint,

+;   IN      UINT32                    Context1,  OPTIONAL

+;   IN      UINT32                    Context2,  OPTIONAL

+;   IN      UINT32                    NewStack

+;   );

+;------------------------------------------------------------------------------

+global ASM_PFX(InternalX86DisablePaging64)

+ASM_PFX(InternalX86DisablePaging64):

+    cli

+    lea     rsi, [.0]                     ; rsi <- The start address of transition code

+    mov     edi, [rsp + 0x28]            ; rdi <- New stack

+    lea     rax, [mTransitionEnd]         ; rax <- end of transition code

+    sub     rax, rsi                    ; rax <- The size of transition piece code

+    add     rax, 4                      ; Round RAX up to the next 4 byte boundary

+    and     al, 0xfc

+    sub     rdi, rax                    ; rdi <- Use stack to hold transition code

+    mov     r10d, edi                   ; r10 <- The start address of transicition code below 4G

+    push    rcx                         ; save rcx to stack

+    mov     rcx, rax                    ; rcx <- The size of transition piece code

+    rep     movsb                       ; copy transition code to top of new stack which must be below 4GB

+    pop     rcx                         ; restore rcx

+

+    mov     esi, r8d

+    mov     edi, r9d

+    mov     eax, r10d                   ; eax <- start of the transition code on the stack

+    sub     eax, 4                      ; eax <- One slot below transition code on the stack

+    push    rcx                         ; push Cs to stack

+    push    r10                         ; push address of tansition code on stack

+    DB      0x48                         ; prefix to composite "retq" with next "retf"

+    retf                                ; Use far return to load CS register from stack

+

+; Start of transition code

+.0:

+    mov     esp, eax                    ; set up new stack

+    mov     rax, cr0

+    btr     eax, 31                     ; Clear CR0.PG

+    mov     cr0, rax                    ; disable paging and caches

+

+    mov     ebx, edx                    ; save EntryPoint to rbx, for rdmsr will overwrite rdx

+    mov     ecx, 0xc0000080

+    rdmsr

+    and     ah, ~ 1                   ; clear LME

+    wrmsr

+    mov     rax, cr4

+    and     al, ~ (1 << 5)           ; clear PAE

+    mov     cr4, rax

+    push    rdi                         ; push Context2

+    push    rsi                         ; push Context1

+    call    rbx                         ; transfer control to EntryPoint

+    hlt                                 ; no one should get here

+

+mTransitionEnd:

+

diff --git a/debugging_demo/memtest86+/efi/Include/src/BaseLib/X64/EnableCache.nasm b/debugging_demo/memtest86+/efi/Include/src/BaseLib/X64/EnableCache.nasm
new file mode 100644
index 0000000..b6fae3c
--- /dev/null
+++ b/debugging_demo/memtest86+/efi/Include/src/BaseLib/X64/EnableCache.nasm
@@ -0,0 +1,37 @@
+;------------------------------------------------------------------------------

+;

+; Copyright (c) 2006 - 2008, Intel Corporation. All rights reserved.<BR>

+; SPDX-License-Identifier: BSD-2-Clause-Patent

+;

+; Module Name:

+;

+;   EnableCache.Asm

+;

+; Abstract:

+;

+;  Flush all caches with a WBINVD instruction, clear the CD bit of CR0 to 0, and clear

+;  the NW bit of CR0 to 0

+;

+; Notes:

+;

+;------------------------------------------------------------------------------

+

+    DEFAULT REL

+    SECTION .text

+

+;------------------------------------------------------------------------------

+; VOID

+; EFIAPI

+; AsmEnableCache (

+;   VOID

+;   );

+;------------------------------------------------------------------------------

+global ASM_PFX(AsmEnableCache)

+ASM_PFX(AsmEnableCache):

+    wbinvd

+    mov     rax, cr0

+    btr     rax, 29

+    btr     rax, 30

+    mov     cr0, rax

+    ret

+

diff --git a/debugging_demo/memtest86+/efi/Include/src/BaseLib/X64/EnableDisableInterrupts.nasm b/debugging_demo/memtest86+/efi/Include/src/BaseLib/X64/EnableDisableInterrupts.nasm
new file mode 100644
index 0000000..3c7e9e7
--- /dev/null
+++ b/debugging_demo/memtest86+/efi/Include/src/BaseLib/X64/EnableDisableInterrupts.nasm
@@ -0,0 +1,33 @@
+;------------------------------------------------------------------------------

+;

+; Copyright (c) 2006, Intel Corporation. All rights reserved.<BR>

+; SPDX-License-Identifier: BSD-2-Clause-Patent

+;

+; Module Name:

+;

+;   EnableDisableInterrupts.Asm

+;

+; Abstract:

+;

+;   EnableDisableInterrupts function

+;

+; Notes:

+;

+;------------------------------------------------------------------------------

+

+    DEFAULT REL

+    SECTION .text

+

+;------------------------------------------------------------------------------

+; VOID

+; EFIAPI

+; EnableDisableInterrupts (

+;   VOID

+;   );

+;------------------------------------------------------------------------------

+global ASM_PFX(EnableDisableInterrupts)

+ASM_PFX(EnableDisableInterrupts):

+    sti

+    cli

+    ret

+

diff --git a/debugging_demo/memtest86+/efi/Include/src/BaseLib/X64/EnableInterrupts.nasm b/debugging_demo/memtest86+/efi/Include/src/BaseLib/X64/EnableInterrupts.nasm
new file mode 100644
index 0000000..6057afd
--- /dev/null
+++ b/debugging_demo/memtest86+/efi/Include/src/BaseLib/X64/EnableInterrupts.nasm
@@ -0,0 +1,32 @@
+;------------------------------------------------------------------------------

+;

+; Copyright (c) 2006, Intel Corporation. All rights reserved.<BR>

+; SPDX-License-Identifier: BSD-2-Clause-Patent

+;

+; Module Name:

+;

+;   EnableInterrupts.Asm

+;

+; Abstract:

+;

+;   EnableInterrupts function

+;

+; Notes:

+;

+;------------------------------------------------------------------------------

+

+    DEFAULT REL

+    SECTION .text

+

+;------------------------------------------------------------------------------

+; VOID

+; EFIAPI

+; EnableInterrupts (

+;   VOID

+;   );

+;------------------------------------------------------------------------------

+global ASM_PFX(EnableInterrupts)

+ASM_PFX(EnableInterrupts):

+    sti

+    ret

+

diff --git a/debugging_demo/memtest86+/efi/Include/src/BaseLib/X64/FlushCacheLine.nasm b/debugging_demo/memtest86+/efi/Include/src/BaseLib/X64/FlushCacheLine.nasm
new file mode 100644
index 0000000..1effabe
--- /dev/null
+++ b/debugging_demo/memtest86+/efi/Include/src/BaseLib/X64/FlushCacheLine.nasm
@@ -0,0 +1,33 @@
+;------------------------------------------------------------------------------

+;

+; Copyright (c) 2006, Intel Corporation. All rights reserved.<BR>

+; SPDX-License-Identifier: BSD-2-Clause-Patent

+;

+; Module Name:

+;

+;   FlushCacheLine.Asm

+;

+; Abstract:

+;

+;   AsmFlushCacheLine function

+;

+; Notes:

+;

+;------------------------------------------------------------------------------

+

+    DEFAULT REL

+    SECTION .text

+

+;------------------------------------------------------------------------------

+; VOID *

+; EFIAPI

+; AsmFlushCacheLine (

+;   IN      VOID                      *LinearAddress

+;   );

+;------------------------------------------------------------------------------

+global ASM_PFX(AsmFlushCacheLine)

+ASM_PFX(AsmFlushCacheLine):

+    clflush [rcx]

+    mov     rax, rcx

+    ret

+

diff --git a/debugging_demo/memtest86+/efi/Include/src/BaseLib/X64/FxRestore.nasm b/debugging_demo/memtest86+/efi/Include/src/BaseLib/X64/FxRestore.nasm
new file mode 100644
index 0000000..261981e
--- /dev/null
+++ b/debugging_demo/memtest86+/efi/Include/src/BaseLib/X64/FxRestore.nasm
@@ -0,0 +1,32 @@
+;------------------------------------------------------------------------------

+;

+; Copyright (c) 2006, Intel Corporation. All rights reserved.<BR>

+; SPDX-License-Identifier: BSD-2-Clause-Patent

+;

+; Module Name:

+;

+;   FxRestore.Asm

+;

+; Abstract:

+;

+;   AsmFxRestore function

+;

+; Notes:

+;

+;------------------------------------------------------------------------------

+

+    DEFAULT REL

+    SECTION .text

+

+;------------------------------------------------------------------------------

+; VOID

+; EFIAPI

+; InternalX86FxRestore (

+;   IN CONST IA32_FX_BUFFER *Buffer

+;   );

+;------------------------------------------------------------------------------

+global ASM_PFX(InternalX86FxRestore)

+ASM_PFX(InternalX86FxRestore):

+    fxrstor [rcx]

+    ret

+

diff --git a/debugging_demo/memtest86+/efi/Include/src/BaseLib/X64/FxSave.nasm b/debugging_demo/memtest86+/efi/Include/src/BaseLib/X64/FxSave.nasm
new file mode 100644
index 0000000..fafe24d
--- /dev/null
+++ b/debugging_demo/memtest86+/efi/Include/src/BaseLib/X64/FxSave.nasm
@@ -0,0 +1,32 @@
+;------------------------------------------------------------------------------

+;

+; Copyright (c) 2006, Intel Corporation. All rights reserved.<BR>

+; SPDX-License-Identifier: BSD-2-Clause-Patent

+;

+; Module Name:

+;

+;   FxSave.Asm

+;

+; Abstract:

+;

+;   AsmFxSave function

+;

+; Notes:

+;

+;------------------------------------------------------------------------------

+

+    DEFAULT REL

+    SECTION .text

+

+;------------------------------------------------------------------------------

+; VOID

+; EFIAPI

+; InternalX86FxSave (

+;   OUT IA32_FX_BUFFER *Buffer

+;   );

+;------------------------------------------------------------------------------

+global ASM_PFX(InternalX86FxSave)

+ASM_PFX(InternalX86FxSave):

+    fxsave  [rcx]

+    ret

+

diff --git a/debugging_demo/memtest86+/efi/Include/src/BaseLib/X64/GccInline.c b/debugging_demo/memtest86+/efi/Include/src/BaseLib/X64/GccInline.c
new file mode 100644
index 0000000..40a208f
--- /dev/null
+++ b/debugging_demo/memtest86+/efi/Include/src/BaseLib/X64/GccInline.c
@@ -0,0 +1,562 @@
+/** @file

+  GCC inline implementation of BaseLib processor specific functions.

+

+  Copyright (c) 2006 - 2020, Intel Corporation. All rights reserved.<BR>

+  Portions copyright (c) 2008 - 2009, Apple Inc. All rights reserved.<BR>

+  SPDX-License-Identifier: BSD-2-Clause-Patent

+

+**/

+

+

+#include "BaseLibInternals.h"

+

+

+

+

+/**

+  Used to serialize load and store operations.

+

+  All loads and stores that proceed calls to this function are guaranteed to be

+  globally visible when this function returns.

+

+**/

+VOID

+EFIAPI

+MemoryFence (

+  VOID

+  )

+{

+  // This is a little bit of overkill and it is more about the compiler that it is

+  // actually processor synchronization. This is like the _ReadWriteBarrier

+  // Microsoft specific intrinsic

+  __asm__ __volatile__ ("":::"memory");

+}

+

+

+/**

+  Requests CPU to pause for a short period of time.

+

+  Requests CPU to pause for a short period of time. Typically used in MP

+  systems to prevent memory starvation while waiting for a spin lock.

+

+**/

+VOID

+EFIAPI

+CpuPause (

+  VOID

+  )

+{

+  __asm__ __volatile__ ("pause");

+}

+

+

+/**

+  Generates a breakpoint on the CPU.

+

+  Generates a breakpoint on the CPU. The breakpoint must be implemented such

+  that code can resume normal execution after the breakpoint.

+

+**/

+VOID

+EFIAPI

+CpuBreakpoint (

+  VOID

+  )

+{

+  __asm__ __volatile__ ("int $3");

+}

+

+

+/**

+  Reads the current value of the EFLAGS register.

+

+  Reads and returns the current value of the EFLAGS register. This function is

+  only available on IA-32 and X64. This returns a 32-bit value on IA-32 and a

+  64-bit value on X64.

+

+  @return EFLAGS on IA-32 or RFLAGS on X64.

+

+**/

+UINTN

+EFIAPI

+AsmReadEflags (

+  VOID

+  )

+{

+  UINTN Eflags;

+

+  __asm__ __volatile__ (

+    "pushfq         \n\t"

+    "pop     %0         "

+    : "=r" (Eflags)       // %0

+    );

+

+  return Eflags;

+}

+

+/**

+  Save the current floating point/SSE/SSE2 context to a buffer.

+

+  Saves the current floating point/SSE/SSE2 state to the buffer specified by

+  Buffer. Buffer must be aligned on a 16-byte boundary. This function is only

+  available on IA-32 and X64.

+

+  @param  Buffer  The pointer to a buffer to save the floating point/SSE/SSE2 context.

+

+**/

+VOID

+EFIAPI

+InternalX86FxSave (

+  OUT     IA32_FX_BUFFER            *Buffer

+  )

+{

+  __asm__ __volatile__ (

+    "fxsave %0"

+    :

+    : "m" (*Buffer)  // %0

+    );

+}

+

+

+/**

+  Restores the current floating point/SSE/SSE2 context from a buffer.

+

+  Restores the current floating point/SSE/SSE2 state from the buffer specified

+  by Buffer. Buffer must be aligned on a 16-byte boundary. This function is

+  only available on IA-32 and X64.

+

+  @param  Buffer  The pointer to a buffer to save the floating point/SSE/SSE2 context.

+

+**/

+VOID

+EFIAPI

+InternalX86FxRestore (

+  IN      CONST IA32_FX_BUFFER      *Buffer

+  )

+{

+  __asm__ __volatile__ (

+    "fxrstor %0"

+    :

+    : "m" (*Buffer)  // %0

+    );

+}

+

+

+/**

+  Reads the current value of 64-bit MMX Register #0 (MM0).

+

+  Reads and returns the current value of MM0. This function is only available

+  on IA-32 and X64.

+

+  @return The current value of MM0.

+

+**/

+UINT64

+EFIAPI

+AsmReadMm0 (

+  VOID

+  )

+{

+  UINT64  Data;

+

+  __asm__ __volatile__ (

+    "movd   %%mm0,  %0    \n\t"

+    : "=r"  (Data)       // %0

+    );

+

+  return Data;

+}

+

+

+/**

+  Reads the current value of 64-bit MMX Register #1 (MM1).

+

+  Reads and returns the current value of MM1. This function is only available

+  on IA-32 and X64.

+

+  @return The current value of MM1.

+

+**/

+UINT64

+EFIAPI

+AsmReadMm1 (

+  VOID

+  )

+{

+  UINT64  Data;

+

+  __asm__ __volatile__ (

+    "movd   %%mm1,  %0    \n\t"

+    : "=r"  (Data)       // %0

+    );

+

+  return Data;

+}

+

+

+/**

+  Reads the current value of 64-bit MMX Register #2 (MM2).

+

+  Reads and returns the current value of MM2. This function is only available

+  on IA-32 and X64.

+

+  @return The current value of MM2.

+

+**/

+UINT64

+EFIAPI

+AsmReadMm2 (

+  VOID

+  )

+{

+  UINT64  Data;

+

+  __asm__ __volatile__ (

+    "movd  %%mm2,  %0    \n\t"

+    : "=r"  (Data)       // %0

+    );

+

+  return Data;

+}

+

+

+/**

+  Reads the current value of 64-bit MMX Register #3 (MM3).

+

+  Reads and returns the current value of MM3. This function is only available

+  on IA-32 and X64.

+

+  @return The current value of MM3.

+

+**/

+UINT64

+EFIAPI

+AsmReadMm3 (

+  VOID

+  )

+{

+  UINT64  Data;

+

+  __asm__ __volatile__ (

+    "movd  %%mm3,  %0    \n\t"

+    : "=r"  (Data)       // %0

+    );

+

+  return Data;

+}

+

+

+/**

+  Reads the current value of 64-bit MMX Register #4 (MM4).

+

+  Reads and returns the current value of MM4. This function is only available

+  on IA-32 and X64.

+

+  @return The current value of MM4.

+

+**/

+UINT64

+EFIAPI

+AsmReadMm4 (

+  VOID

+  )

+{

+  UINT64  Data;

+

+  __asm__ __volatile__ (

+    "movd  %%mm4,  %0    \n\t"

+    : "=r"  (Data)       // %0

+    );

+

+  return Data;

+}

+

+

+/**

+  Reads the current value of 64-bit MMX Register #5 (MM5).

+

+  Reads and returns the current value of MM5. This function is only available

+  on IA-32 and X64.

+

+  @return The current value of MM5.

+

+**/

+UINT64

+EFIAPI

+AsmReadMm5 (

+  VOID

+  )

+{

+  UINT64  Data;

+

+  __asm__ __volatile__ (

+    "movd  %%mm5,  %0    \n\t"

+    : "=r"  (Data)       // %0

+    );

+

+  return Data;

+}

+

+

+/**

+  Reads the current value of 64-bit MMX Register #6 (MM6).

+

+  Reads and returns the current value of MM6. This function is only available

+  on IA-32 and X64.

+

+  @return The current value of MM6.

+

+**/

+UINT64

+EFIAPI

+AsmReadMm6 (

+  VOID

+  )

+{

+  UINT64  Data;

+

+  __asm__ __volatile__ (

+    "movd  %%mm6,  %0    \n\t"

+    : "=r"  (Data)       // %0

+    );

+

+  return Data;

+}

+

+

+/**

+  Reads the current value of 64-bit MMX Register #7 (MM7).

+

+  Reads and returns the current value of MM7. This function is only available

+  on IA-32 and X64.

+

+  @return The current value of MM7.

+

+**/

+UINT64

+EFIAPI

+AsmReadMm7 (

+  VOID

+  )

+{

+  UINT64  Data;

+

+  __asm__ __volatile__ (

+    "movd  %%mm7,  %0    \n\t"

+    : "=r"  (Data)       // %0

+    );

+

+  return Data;

+}

+

+

+/**

+  Writes the current value of 64-bit MMX Register #0 (MM0).

+

+  Writes the current value of MM0. This function is only available on IA32 and

+  X64.

+

+  @param  Value The 64-bit value to write to MM0.

+

+**/

+VOID

+EFIAPI

+AsmWriteMm0 (

+  IN      UINT64                    Value

+  )

+{

+  __asm__ __volatile__ (

+    "movd  %0, %%mm0"  // %0

+    :

+    : "m" (Value)

+    );

+}

+

+

+/**

+  Writes the current value of 64-bit MMX Register #1 (MM1).

+

+  Writes the current value of MM1. This function is only available on IA32 and

+  X64.

+

+  @param  Value The 64-bit value to write to MM1.

+

+**/

+VOID

+EFIAPI

+AsmWriteMm1 (

+  IN      UINT64                    Value

+  )

+{

+  __asm__ __volatile__ (

+    "movd  %0, %%mm1"  // %0

+    :

+    : "m" (Value)

+    );

+}

+

+

+/**

+  Writes the current value of 64-bit MMX Register #2 (MM2).

+

+  Writes the current value of MM2. This function is only available on IA32 and

+  X64.

+

+  @param  Value The 64-bit value to write to MM2.

+

+**/

+VOID

+EFIAPI

+AsmWriteMm2 (

+  IN      UINT64                    Value

+  )

+{

+  __asm__ __volatile__ (

+    "movd  %0, %%mm2"  // %0

+    :

+    : "m" (Value)

+    );

+}

+

+

+/**

+  Writes the current value of 64-bit MMX Register #3 (MM3).

+

+  Writes the current value of MM3. This function is only available on IA32 and

+  X64.

+

+  @param  Value The 64-bit value to write to MM3.

+

+**/

+VOID

+EFIAPI

+AsmWriteMm3 (

+  IN      UINT64                    Value

+  )

+{

+  __asm__ __volatile__ (

+    "movd  %0, %%mm3"  // %0

+    :

+    : "m" (Value)

+    );

+}

+

+

+/**

+  Writes the current value of 64-bit MMX Register #4 (MM4).

+

+  Writes the current value of MM4. This function is only available on IA32 and

+  X64.

+

+  @param  Value The 64-bit value to write to MM4.

+

+**/

+VOID

+EFIAPI

+AsmWriteMm4 (

+  IN      UINT64                    Value

+  )

+{

+  __asm__ __volatile__ (

+    "movd  %0, %%mm4"  // %0

+    :

+    : "m" (Value)

+    );

+}

+

+

+/**

+  Writes the current value of 64-bit MMX Register #5 (MM5).

+

+  Writes the current value of MM5. This function is only available on IA32 and

+  X64.

+

+  @param  Value The 64-bit value to write to MM5.

+

+**/

+VOID

+EFIAPI

+AsmWriteMm5 (

+  IN      UINT64                    Value

+  )

+{

+  __asm__ __volatile__ (

+    "movd  %0, %%mm5"  // %0

+    :

+    : "m" (Value)

+    );

+}

+

+

+/**

+  Writes the current value of 64-bit MMX Register #6 (MM6).

+

+  Writes the current value of MM6. This function is only available on IA32 and

+  X64.

+

+  @param  Value The 64-bit value to write to MM6.

+

+**/

+VOID

+EFIAPI

+AsmWriteMm6 (

+  IN      UINT64                    Value

+  )

+{

+  __asm__ __volatile__ (

+    "movd  %0, %%mm6"  // %0

+    :

+    : "m" (Value)

+    );

+}

+

+

+/**

+  Writes the current value of 64-bit MMX Register #7 (MM7).

+

+  Writes the current value of MM7. This function is only available on IA32 and

+  X64.

+

+  @param  Value The 64-bit value to write to MM7.

+

+**/

+VOID

+EFIAPI

+AsmWriteMm7 (

+  IN      UINT64                    Value

+  )

+{

+  __asm__ __volatile__ (

+    "movd  %0, %%mm7"  // %0

+    :

+    : "m" (Value)

+    );

+}

+

+

+/**

+  Reads the current value of Time Stamp Counter (TSC).

+

+  Reads and returns the current value of TSC. This function is only available

+  on IA-32 and X64.

+

+  @return The current value of TSC

+

+**/

+UINT64

+EFIAPI

+AsmReadTsc (

+  VOID

+  )

+{

+  UINT32  LowData;

+  UINT32  HiData;

+

+  __asm__ __volatile__ (

+    "rdtsc"

+    : "=a" (LowData),

+      "=d" (HiData)

+    );

+

+  return (((UINT64)HiData) << 32) | LowData;

+}

diff --git a/debugging_demo/memtest86+/efi/Include/src/BaseLib/X64/GccInlinePriv.c b/debugging_demo/memtest86+/efi/Include/src/BaseLib/X64/GccInlinePriv.c
new file mode 100644
index 0000000..98be19b
--- /dev/null
+++ b/debugging_demo/memtest86+/efi/Include/src/BaseLib/X64/GccInlinePriv.c
@@ -0,0 +1,1234 @@
+/** @file

+  GCC inline implementation of BaseLib processor specific functions that use

+  privlidged instructions.

+

+  Copyright (c) 2006 - 2020, Intel Corporation. All rights reserved.<BR>

+  Portions copyright (c) 2008 - 2009, Apple Inc. All rights reserved.<BR>

+  SPDX-License-Identifier: BSD-2-Clause-Patent

+

+**/

+

+

+#include "BaseLibInternals.h"

+

+/**

+  Enables CPU interrupts.

+

+  Enables CPU interrupts.

+

+**/

+VOID

+EFIAPI

+EnableInterrupts (

+  VOID

+  )

+{

+  __asm__ __volatile__ ("sti"::: "memory");

+}

+

+

+/**

+  Disables CPU interrupts.

+

+  Disables CPU interrupts.

+

+**/

+VOID

+EFIAPI

+DisableInterrupts (

+  VOID

+  )

+{

+  __asm__ __volatile__ ("cli"::: "memory");

+}

+

+/**

+  Returns a 64-bit Machine Specific Register(MSR).

+

+  Reads and returns the 64-bit MSR specified by Index. No parameter checking is

+  performed on Index, and some Index values may cause CPU exceptions. The

+  caller must either guarantee that Index is valid, or the caller must set up

+  exception handlers to catch the exceptions. This function is only available

+  on IA-32 and X64.

+

+  @param  Index The 32-bit MSR index to read.

+

+  @return The value of the MSR identified by Index.

+

+**/

+UINT64

+EFIAPI

+AsmReadMsr64 (

+  IN      UINT32                    Index

+  )

+{

+  UINT32 LowData;

+  UINT32 HighData;

+

+  __asm__ __volatile__ (

+    "rdmsr"

+    : "=a" (LowData),   // %0

+      "=d" (HighData)   // %1

+    : "c"  (Index)      // %2

+    );

+

+  return (((UINT64)HighData) << 32) | LowData;

+}

+

+/**

+  Writes a 64-bit value to a Machine Specific Register(MSR), and returns the

+  value.

+

+  Writes the 64-bit value specified by Value to the MSR specified by Index. The

+  64-bit value written to the MSR is returned. No parameter checking is

+  performed on Index or Value, and some of these may cause CPU exceptions. The

+  caller must either guarantee that Index and Value are valid, or the caller

+  must establish proper exception handlers. This function is only available on

+  IA-32 and X64.

+

+  @param  Index The 32-bit MSR index to write.

+  @param  Value The 64-bit value to write to the MSR.

+

+  @return Value

+

+**/

+UINT64

+EFIAPI

+AsmWriteMsr64 (

+  IN      UINT32                    Index,

+  IN      UINT64                    Value

+  )

+{

+  UINT32 LowData;

+  UINT32 HighData;

+

+  LowData  = (UINT32)(Value);

+  HighData = (UINT32)(Value >> 32);

+

+  __asm__ __volatile__ (

+    "wrmsr"

+    :

+    : "c" (Index),

+      "a" (LowData),

+      "d" (HighData)

+    );

+

+  return Value;

+}

+

+/**

+  Reads the current value of the Control Register 0 (CR0).

+

+  Reads and returns the current value of CR0. This function is only available

+  on IA-32 and X64. This returns a 32-bit value on IA-32 and a 64-bit value on

+  X64.

+

+  @return The value of the Control Register 0 (CR0).

+

+**/

+UINTN

+EFIAPI

+AsmReadCr0 (

+  VOID

+  )

+{

+  UINTN   Data;

+

+  __asm__ __volatile__ (

+    "mov  %%cr0,%0"

+    : "=r" (Data)           // %0

+    );

+

+  return Data;

+}

+

+

+/**

+  Reads the current value of the Control Register 2 (CR2).

+

+  Reads and returns the current value of CR2. This function is only available

+  on IA-32 and X64. This returns a 32-bit value on IA-32 and a 64-bit value on

+  X64.

+

+  @return The value of the Control Register 2 (CR2).

+

+**/

+UINTN

+EFIAPI

+AsmReadCr2 (

+  VOID

+  )

+{

+  UINTN Data;

+

+  __asm__ __volatile__ (

+    "mov  %%cr2,  %0"

+    : "=r" (Data)           // %0

+    );

+

+  return Data;

+}

+

+/**

+  Reads the current value of the Control Register 3 (CR3).

+

+  Reads and returns the current value of CR3. This function is only available

+  on IA-32 and X64. This returns a 32-bit value on IA-32 and a 64-bit value on

+  X64.

+

+  @return The value of the Control Register 3 (CR3).

+

+**/

+UINTN

+EFIAPI

+AsmReadCr3 (

+  VOID

+  )

+{

+  UINTN Data;

+

+  __asm__ __volatile__ (

+    "mov  %%cr3,  %0"

+    : "=r" (Data)           // %0

+    );

+

+  return Data;

+}

+

+

+/**

+  Reads the current value of the Control Register 4 (CR4).

+

+  Reads and returns the current value of CR4. This function is only available

+  on IA-32 and X64. This returns a 32-bit value on IA-32 and a 64-bit value on

+  X64.

+

+  @return The value of the Control Register 4 (CR4).

+

+**/

+UINTN

+EFIAPI

+AsmReadCr4 (

+  VOID

+  )

+{

+  UINTN Data;

+

+  __asm__ __volatile__ (

+    "mov  %%cr4,  %0"

+    : "=r" (Data)           // %0

+    );

+

+  return Data;

+}

+

+

+/**

+  Writes a value to Control Register 0 (CR0).

+

+  Writes and returns a new value to CR0. This function is only available on

+  IA-32 and X64. This writes a 32-bit value on IA-32 and a 64-bit value on X64.

+

+  @param  Cr0 The value to write to CR0.

+

+  @return The value written to CR0.

+

+**/

+UINTN

+EFIAPI

+AsmWriteCr0 (

+  UINTN  Cr0

+  )

+{

+  __asm__ __volatile__ (

+    "mov  %0, %%cr0"

+    :

+    : "r" (Cr0)

+    );

+  return Cr0;

+}

+

+

+/**

+  Writes a value to Control Register 2 (CR2).

+

+  Writes and returns a new value to CR2. This function is only available on

+  IA-32 and X64. This writes a 32-bit value on IA-32 and a 64-bit value on X64.

+

+  @param  Cr2 The value to write to CR2.

+

+  @return The value written to CR2.

+

+**/

+UINTN

+EFIAPI

+AsmWriteCr2 (

+  UINTN  Cr2

+  )

+{

+  __asm__ __volatile__ (

+    "mov  %0, %%cr2"

+    :

+    : "r" (Cr2)

+    );

+  return Cr2;

+}

+

+

+/**

+  Writes a value to Control Register 3 (CR3).

+

+  Writes and returns a new value to CR3. This function is only available on

+  IA-32 and X64. This writes a 32-bit value on IA-32 and a 64-bit value on X64.

+

+  @param  Cr3 The value to write to CR3.

+

+  @return The value written to CR3.

+

+**/

+UINTN

+EFIAPI

+AsmWriteCr3 (

+  UINTN  Cr3

+  )

+{

+  __asm__ __volatile__ (

+    "mov  %0, %%cr3"

+    :

+    : "r" (Cr3)

+    );

+  return Cr3;

+}

+

+

+/**

+  Writes a value to Control Register 4 (CR4).

+

+  Writes and returns a new value to CR4. This function is only available on

+  IA-32 and X64. This writes a 32-bit value on IA-32 and a 64-bit value on X64.

+

+  @param  Cr4 The value to write to CR4.

+

+  @return The value written to CR4.

+

+**/

+UINTN

+EFIAPI

+AsmWriteCr4 (

+  UINTN  Cr4

+  )

+{

+  __asm__ __volatile__ (

+    "mov  %0, %%cr4"

+    :

+    : "r" (Cr4)

+    );

+  return Cr4;

+}

+

+

+/**

+  Reads the current value of Debug Register 0 (DR0).

+

+  Reads and returns the current value of DR0. This function is only available

+  on IA-32 and X64. This returns a 32-bit value on IA-32 and a 64-bit value on

+  X64.

+

+  @return The value of Debug Register 0 (DR0).

+

+**/

+UINTN

+EFIAPI

+AsmReadDr0 (

+  VOID

+  )

+{

+  UINTN Data;

+

+  __asm__ __volatile__ (

+    "mov  %%dr0, %0"

+    : "=r" (Data)

+    );

+

+  return Data;

+}

+

+

+/**

+  Reads the current value of Debug Register 1 (DR1).

+

+  Reads and returns the current value of DR1. This function is only available

+  on IA-32 and X64. This returns a 32-bit value on IA-32 and a 64-bit value on

+  X64.

+

+  @return The value of Debug Register 1 (DR1).

+

+**/

+UINTN

+EFIAPI

+AsmReadDr1 (

+  VOID

+  )

+{

+  UINTN Data;

+

+  __asm__ __volatile__ (

+    "mov  %%dr1, %0"

+    : "=r" (Data)

+    );

+

+  return Data;

+}

+

+

+/**

+  Reads the current value of Debug Register 2 (DR2).

+

+  Reads and returns the current value of DR2. This function is only available

+  on IA-32 and X64. This returns a 32-bit value on IA-32 and a 64-bit value on

+  X64.

+

+  @return The value of Debug Register 2 (DR2).

+

+**/

+UINTN

+EFIAPI

+AsmReadDr2 (

+  VOID

+  )

+{

+  UINTN Data;

+

+  __asm__ __volatile__ (

+    "mov  %%dr2, %0"

+    : "=r" (Data)

+    );

+

+  return Data;

+}

+

+

+/**

+  Reads the current value of Debug Register 3 (DR3).

+

+  Reads and returns the current value of DR3. This function is only available

+  on IA-32 and X64. This returns a 32-bit value on IA-32 and a 64-bit value on

+  X64.

+

+  @return The value of Debug Register 3 (DR3).

+

+**/

+UINTN

+EFIAPI

+AsmReadDr3 (

+  VOID

+  )

+{

+  UINTN Data;

+

+  __asm__ __volatile__ (

+    "mov  %%dr3, %0"

+    : "=r" (Data)

+    );

+

+  return Data;

+}

+

+

+/**

+  Reads the current value of Debug Register 4 (DR4).

+

+  Reads and returns the current value of DR4. This function is only available

+  on IA-32 and X64. This returns a 32-bit value on IA-32 and a 64-bit value on

+  X64.

+

+  @return The value of Debug Register 4 (DR4).

+

+**/

+UINTN

+EFIAPI

+AsmReadDr4 (

+  VOID

+  )

+{

+  UINTN Data;

+

+  __asm__ __volatile__ (

+    "mov  %%dr4, %0"

+    : "=r" (Data)

+    );

+

+  return Data;

+}

+

+

+/**

+  Reads the current value of Debug Register 5 (DR5).

+

+  Reads and returns the current value of DR5. This function is only available

+  on IA-32 and X64. This returns a 32-bit value on IA-32 and a 64-bit value on

+  X64.

+

+  @return The value of Debug Register 5 (DR5).

+

+**/

+UINTN

+EFIAPI

+AsmReadDr5 (

+  VOID

+  )

+{

+  UINTN Data;

+

+  __asm__ __volatile__ (

+    "mov  %%dr5, %0"

+    : "=r" (Data)

+    );

+

+  return Data;

+}

+

+

+/**

+  Reads the current value of Debug Register 6 (DR6).

+

+  Reads and returns the current value of DR6. This function is only available

+  on IA-32 and X64. This returns a 32-bit value on IA-32 and a 64-bit value on

+  X64.

+

+  @return The value of Debug Register 6 (DR6).

+

+**/

+UINTN

+EFIAPI

+AsmReadDr6 (

+  VOID

+  )

+{

+  UINTN Data;

+

+  __asm__ __volatile__ (

+    "mov  %%dr6, %0"

+    : "=r" (Data)

+    );

+

+  return Data;

+}

+

+

+/**

+  Reads the current value of Debug Register 7 (DR7).

+

+  Reads and returns the current value of DR7. This function is only available

+  on IA-32 and X64. This returns a 32-bit value on IA-32 and a 64-bit value on

+  X64.

+

+  @return The value of Debug Register 7 (DR7).

+

+**/

+UINTN

+EFIAPI

+AsmReadDr7 (

+  VOID

+  )

+{

+  UINTN Data;

+

+  __asm__ __volatile__ (

+    "mov  %%dr7, %0"

+    : "=r" (Data)

+    );

+

+  return Data;

+}

+

+

+/**

+  Writes a value to Debug Register 0 (DR0).

+

+  Writes and returns a new value to DR0. This function is only available on

+  IA-32 and X64. This writes a 32-bit value on IA-32 and a 64-bit value on X64.

+

+  @param  Dr0 The value to write to Dr0.

+

+  @return The value written to Debug Register 0 (DR0).

+

+**/

+UINTN

+EFIAPI

+AsmWriteDr0 (

+  UINTN  Dr0

+  )

+{

+  __asm__ __volatile__ (

+    "mov  %0, %%dr0"

+    :

+    : "r" (Dr0)

+    );

+  return Dr0;

+}

+

+

+/**

+  Writes a value to Debug Register 1 (DR1).

+

+  Writes and returns a new value to DR1. This function is only available on

+  IA-32 and X64. This writes a 32-bit value on IA-32 and a 64-bit value on X64.

+

+  @param  Dr1 The value to write to Dr1.

+

+  @return The value written to Debug Register 1 (DR1).

+

+**/

+UINTN

+EFIAPI

+AsmWriteDr1 (

+  UINTN  Dr1

+  )

+{

+  __asm__ __volatile__ (

+    "mov  %0, %%dr1"

+    :

+    : "r" (Dr1)

+    );

+  return Dr1;

+}

+

+

+/**

+  Writes a value to Debug Register 2 (DR2).

+

+  Writes and returns a new value to DR2. This function is only available on

+  IA-32 and X64. This writes a 32-bit value on IA-32 and a 64-bit value on X64.

+

+  @param  Dr2 The value to write to Dr2.

+

+  @return The value written to Debug Register 2 (DR2).

+

+**/

+UINTN

+EFIAPI

+AsmWriteDr2 (

+  UINTN  Dr2

+  )

+{

+  __asm__ __volatile__ (

+    "mov  %0, %%dr2"

+    :

+    : "r" (Dr2)

+    );

+  return Dr2;

+}

+

+

+/**

+  Writes a value to Debug Register 3 (DR3).

+

+  Writes and returns a new value to DR3. This function is only available on

+  IA-32 and X64. This writes a 32-bit value on IA-32 and a 64-bit value on X64.

+

+  @param  Dr3 The value to write to Dr3.

+

+  @return The value written to Debug Register 3 (DR3).

+

+**/

+UINTN

+EFIAPI

+AsmWriteDr3 (

+  UINTN  Dr3

+  )

+{

+  __asm__ __volatile__ (

+    "mov  %0, %%dr3"

+    :

+    : "r" (Dr3)

+    );

+  return Dr3;

+}

+

+

+/**

+  Writes a value to Debug Register 4 (DR4).

+

+  Writes and returns a new value to DR4. This function is only available on

+  IA-32 and X64. This writes a 32-bit value on IA-32 and a 64-bit value on X64.

+

+  @param  Dr4 The value to write to Dr4.

+

+  @return The value written to Debug Register 4 (DR4).

+

+**/

+UINTN

+EFIAPI

+AsmWriteDr4 (

+  UINTN  Dr4

+  )

+{

+  __asm__ __volatile__ (

+    "mov  %0, %%dr4"

+    :

+    : "r" (Dr4)

+    );

+  return Dr4;

+}

+

+

+/**

+  Writes a value to Debug Register 5 (DR5).

+

+  Writes and returns a new value to DR5. This function is only available on

+  IA-32 and X64. This writes a 32-bit value on IA-32 and a 64-bit value on X64.

+

+  @param  Dr5 The value to write to Dr5.

+

+  @return The value written to Debug Register 5 (DR5).

+

+**/

+UINTN

+EFIAPI

+AsmWriteDr5 (

+  UINTN  Dr5

+  )

+{

+  __asm__ __volatile__ (

+    "mov  %0, %%dr5"

+    :

+    : "r" (Dr5)

+    );

+  return Dr5;

+}

+

+

+/**

+  Writes a value to Debug Register 6 (DR6).

+

+  Writes and returns a new value to DR6. This function is only available on

+  IA-32 and X64. This writes a 32-bit value on IA-32 and a 64-bit value on X64.

+

+  @param  Dr6 The value to write to Dr6.

+

+  @return The value written to Debug Register 6 (DR6).

+

+**/

+UINTN

+EFIAPI

+AsmWriteDr6 (

+  UINTN  Dr6

+  )

+{

+  __asm__ __volatile__ (

+    "mov  %0, %%dr6"

+    :

+    : "r" (Dr6)

+    );

+  return Dr6;

+}

+

+

+/**

+  Writes a value to Debug Register 7 (DR7).

+

+  Writes and returns a new value to DR7. This function is only available on

+  IA-32 and X64. This writes a 32-bit value on IA-32 and a 64-bit value on X64.

+

+  @param  Dr7 The value to write to Dr7.

+

+  @return The value written to Debug Register 7 (DR7).

+

+**/

+UINTN

+EFIAPI

+AsmWriteDr7 (

+  UINTN  Dr7

+  )

+{

+  __asm__ __volatile__ (

+    "mov  %0, %%dr7"

+    :

+    : "r" (Dr7)

+    );

+  return Dr7;

+}

+

+

+/**

+  Reads the current value of Code Segment Register (CS).

+

+  Reads and returns the current value of CS. This function is only available on

+  IA-32 and X64.

+

+  @return The current value of CS.

+

+**/

+UINT16

+EFIAPI

+AsmReadCs (

+  VOID

+  )

+{

+  UINT16  Data;

+

+  __asm__ __volatile__ (

+    "mov   %%cs, %0"

+    :"=a" (Data)

+    );

+

+  return Data;

+}

+

+

+/**

+  Reads the current value of Data Segment Register (DS).

+

+  Reads and returns the current value of DS. This function is only available on

+  IA-32 and X64.

+

+  @return The current value of DS.

+

+**/

+UINT16

+EFIAPI

+AsmReadDs (

+  VOID

+  )

+{

+  UINT16  Data;

+

+  __asm__ __volatile__ (

+    "mov  %%ds, %0"

+    :"=a" (Data)

+    );

+

+  return Data;

+}

+

+

+/**

+  Reads the current value of Extra Segment Register (ES).

+

+  Reads and returns the current value of ES. This function is only available on

+  IA-32 and X64.

+

+  @return The current value of ES.

+

+**/

+UINT16

+EFIAPI

+AsmReadEs (

+  VOID

+  )

+{

+  UINT16  Data;

+

+  __asm__ __volatile__ (

+    "mov  %%es, %0"

+    :"=a" (Data)

+    );

+

+  return Data;

+}

+

+

+/**

+  Reads the current value of FS Data Segment Register (FS).

+

+  Reads and returns the current value of FS. This function is only available on

+  IA-32 and X64.

+

+  @return The current value of FS.

+

+**/

+UINT16

+EFIAPI

+AsmReadFs (

+  VOID

+  )

+{

+  UINT16  Data;

+

+  __asm__ __volatile__ (

+    "mov  %%fs, %0"

+    :"=a" (Data)

+    );

+

+  return Data;

+}

+

+

+/**

+  Reads the current value of GS Data Segment Register (GS).

+

+  Reads and returns the current value of GS. This function is only available on

+  IA-32 and X64.

+

+  @return The current value of GS.

+

+**/

+UINT16

+EFIAPI

+AsmReadGs (

+  VOID

+  )

+{

+  UINT16  Data;

+

+  __asm__ __volatile__ (

+    "mov  %%gs, %0"

+    :"=a" (Data)

+    );

+

+  return Data;

+}

+

+

+/**

+  Reads the current value of Stack Segment Register (SS).

+

+  Reads and returns the current value of SS. This function is only available on

+  IA-32 and X64.

+

+  @return The current value of SS.

+

+**/

+UINT16

+EFIAPI

+AsmReadSs (

+  VOID

+  )

+{

+  UINT16  Data;

+

+  __asm__ __volatile__ (

+    "mov  %%ds, %0"

+    :"=a" (Data)

+    );

+

+  return Data;

+}

+

+

+/**

+  Reads the current value of Task Register (TR).

+

+  Reads and returns the current value of TR. This function is only available on

+  IA-32 and X64.

+

+  @return The current value of TR.

+

+**/

+UINT16

+EFIAPI

+AsmReadTr (

+  VOID

+  )

+{

+  UINT16  Data;

+

+  __asm__ __volatile__ (

+    "str  %0"

+    : "=r" (Data)

+    );

+

+  return Data;

+}

+

+

+/**

+  Reads the current Global Descriptor Table Register(GDTR) descriptor.

+

+  Reads and returns the current GDTR descriptor and returns it in Gdtr. This

+  function is only available on IA-32 and X64.

+

+  @param  Gdtr  The pointer to a GDTR descriptor.

+

+**/

+VOID

+EFIAPI

+InternalX86ReadGdtr (

+  OUT     IA32_DESCRIPTOR           *Gdtr

+  )

+{

+  __asm__ __volatile__ (

+    "sgdt %0"

+    : "=m" (*Gdtr)

+    );

+}

+

+

+/**

+  Writes the current Global Descriptor Table Register (GDTR) descriptor.

+

+  Writes and the current GDTR descriptor specified by Gdtr. This function is

+  only available on IA-32 and X64.

+

+  @param  Gdtr  The pointer to a GDTR descriptor.

+

+**/

+VOID

+EFIAPI

+InternalX86WriteGdtr (

+  IN      CONST IA32_DESCRIPTOR     *Gdtr

+  )

+{

+  __asm__ __volatile__ (

+    "lgdt %0"

+    :

+    : "m" (*Gdtr)

+    );

+

+}

+

+

+/**

+  Reads the current Interrupt Descriptor Table Register(GDTR) descriptor.

+

+  Reads and returns the current IDTR descriptor and returns it in Idtr. This

+  function is only available on IA-32 and X64.

+

+  @param  Idtr  The pointer to a IDTR descriptor.

+

+**/

+VOID

+EFIAPI

+InternalX86ReadIdtr (

+  OUT     IA32_DESCRIPTOR           *Idtr

+  )

+{

+  __asm__ __volatile__ (

+    "sidt  %0"

+    : "=m" (*Idtr)

+    );

+}

+

+

+/**

+  Writes the current Interrupt Descriptor Table Register(GDTR) descriptor.

+

+  Writes the current IDTR descriptor and returns it in Idtr. This function is

+  only available on IA-32 and X64.

+

+  @param  Idtr  The pointer to a IDTR descriptor.

+

+**/

+VOID

+EFIAPI

+InternalX86WriteIdtr (

+  IN      CONST IA32_DESCRIPTOR     *Idtr

+  )

+{

+  __asm__ __volatile__ (

+    "lidt %0"

+    :

+    : "m" (*Idtr)

+    );

+}

+

+

+/**

+  Reads the current Local Descriptor Table Register(LDTR) selector.

+

+  Reads and returns the current 16-bit LDTR descriptor value. This function is

+  only available on IA-32 and X64.

+

+  @return The current selector of LDT.

+

+**/

+UINT16

+EFIAPI

+AsmReadLdtr (

+  VOID

+  )

+{

+  UINT16  Data;

+

+  __asm__ __volatile__ (

+    "sldt  %0"

+    : "=g" (Data)   // %0

+    );

+

+  return Data;

+}

+

+

+/**

+  Writes the current Local Descriptor Table Register (GDTR) selector.

+

+  Writes and the current LDTR descriptor specified by Ldtr. This function is

+  only available on IA-32 and X64.

+

+  @param  Ldtr  16-bit LDTR selector value.

+

+**/

+VOID

+EFIAPI

+AsmWriteLdtr (

+  IN      UINT16                    Ldtr

+  )

+{

+  __asm__ __volatile__ (

+    "lldtw  %0"

+    :

+    : "g" (Ldtr)   // %0

+    );

+}

+

+/**

+  Reads the current value of a Performance Counter (PMC).

+

+  Reads and returns the current value of performance counter specified by

+  Index. This function is only available on IA-32 and X64.

+

+  @param  Index The 32-bit Performance Counter index to read.

+

+  @return The value of the PMC specified by Index.

+

+**/

+UINT64

+EFIAPI

+AsmReadPmc (

+  IN      UINT32                    Index

+  )

+{

+  UINT32  LowData;

+  UINT32  HiData;

+

+  __asm__ __volatile__ (

+    "rdpmc"

+    : "=a" (LowData),

+      "=d" (HiData)

+    : "c"  (Index)

+    );

+

+  return (((UINT64)HiData) << 32) | LowData;

+}

+

+/**

+  Sets up a monitor buffer that is used by AsmMwait().

+

+  Executes a MONITOR instruction with the register state specified by Eax, Ecx

+  and Edx. Returns Eax. This function is only available on IA-32 and X64.

+

+  @param  Eax The value to load into EAX or RAX before executing the MONITOR

+              instruction.

+  @param  Ecx The value to load into ECX or RCX before executing the MONITOR

+              instruction.

+  @param  Edx The value to load into EDX or RDX before executing the MONITOR

+              instruction.

+

+  @return Eax

+

+**/

+UINTN

+EFIAPI

+AsmMonitor (

+  IN      UINTN                     Eax,

+  IN      UINTN                     Ecx,

+  IN      UINTN                     Edx

+  )

+{

+  __asm__ __volatile__ (

+    "monitor"

+    :

+    : "a" (Eax),

+      "c" (Ecx),

+      "d" (Edx)

+    );

+

+  return Eax;

+}

+

+/**

+  Executes an MWAIT instruction.

+

+  Executes an MWAIT instruction with the register state specified by Eax and

+  Ecx. Returns Eax. This function is only available on IA-32 and X64.

+

+  @param  Eax The value to load into EAX or RAX before executing the MONITOR

+              instruction.

+  @param  Ecx The value to load into ECX or RCX before executing the MONITOR

+              instruction.

+

+  @return Eax

+

+**/

+UINTN

+EFIAPI

+AsmMwait (

+  IN      UINTN                     Eax,

+  IN      UINTN                     Ecx

+  )

+{

+  __asm__ __volatile__ (

+    "mwait"

+    :

+    : "a"  (Eax),

+      "c"  (Ecx)

+    );

+

+  return Eax;

+}

+

+/**

+  Executes a WBINVD instruction.

+

+  Executes a WBINVD instruction. This function is only available on IA-32 and

+  X64.

+

+**/

+VOID

+EFIAPI

+AsmWbinvd (

+  VOID

+  )

+{

+  __asm__ __volatile__ ("wbinvd":::"memory");

+}

+

+/**

+  Executes a INVD instruction.

+

+  Executes a INVD instruction. This function is only available on IA-32 and

+  X64.

+

+**/

+VOID

+EFIAPI

+AsmInvd (

+  VOID

+  )

+{

+  __asm__ __volatile__ ("invd":::"memory");

+

+}

+

+

+/**

+  Flushes a cache line from all the instruction and data caches within the

+  coherency domain of the CPU.

+

+  Flushed the cache line specified by LinearAddress, and returns LinearAddress.

+  This function is only available on IA-32 and X64.

+

+  @param  LinearAddress The address of the cache line to flush. If the CPU is

+                        in a physical addressing mode, then LinearAddress is a

+                        physical address. If the CPU is in a virtual

+                        addressing mode, then LinearAddress is a virtual

+                        address.

+

+  @return LinearAddress

+**/

+VOID *

+EFIAPI

+AsmFlushCacheLine (

+  IN      VOID                      *LinearAddress

+  )

+{

+  __asm__ __volatile__ (

+    "clflush (%0)"

+    :

+    : "r" (LinearAddress)

+    : "memory"

+    );

+

+    return LinearAddress;

+}

diff --git a/debugging_demo/memtest86+/efi/Include/src/BaseLib/X64/Invd.nasm b/debugging_demo/memtest86+/efi/Include/src/BaseLib/X64/Invd.nasm
new file mode 100644
index 0000000..5580f64
--- /dev/null
+++ b/debugging_demo/memtest86+/efi/Include/src/BaseLib/X64/Invd.nasm
@@ -0,0 +1,32 @@
+;------------------------------------------------------------------------------

+;

+; Copyright (c) 2006, Intel Corporation. All rights reserved.<BR>

+; SPDX-License-Identifier: BSD-2-Clause-Patent

+;

+; Module Name:

+;

+;   Invd.Asm

+;

+; Abstract:

+;

+;   AsmInvd function

+;

+; Notes:

+;

+;------------------------------------------------------------------------------

+

+    DEFAULT REL

+    SECTION .text

+

+;------------------------------------------------------------------------------

+; VOID

+; EFIAPI

+; AsmInvd (

+;   VOID

+;   );

+;------------------------------------------------------------------------------

+global ASM_PFX(AsmInvd)

+ASM_PFX(AsmInvd):

+    invd

+    ret

+

diff --git a/debugging_demo/memtest86+/efi/Include/src/BaseLib/X64/Lfence.nasm b/debugging_demo/memtest86+/efi/Include/src/BaseLib/X64/Lfence.nasm
new file mode 100644
index 0000000..25fd074
--- /dev/null
+++ b/debugging_demo/memtest86+/efi/Include/src/BaseLib/X64/Lfence.nasm
@@ -0,0 +1,31 @@
+;------------------------------------------------------------------------------ ;

+; Copyright (c) 2018, Intel Corporation. All rights reserved.<BR>

+; SPDX-License-Identifier: BSD-2-Clause-Patent

+;

+; Module Name:

+;

+;   Lfence.nasm

+;

+; Abstract:

+;

+;   Performs a serializing operation on all load-from-memory instructions that

+;   were issued prior to the call of this function.

+;

+; Notes:

+;

+;------------------------------------------------------------------------------

+

+    DEFAULT REL

+    SECTION .text

+

+;------------------------------------------------------------------------------

+; VOID

+; EFIAPI

+; AsmLfence (

+;   VOID

+;   );

+;------------------------------------------------------------------------------

+global ASM_PFX(AsmLfence)

+ASM_PFX(AsmLfence):

+    lfence

+    ret

diff --git a/debugging_demo/memtest86+/efi/Include/src/BaseLib/X64/LongJump.nasm b/debugging_demo/memtest86+/efi/Include/src/BaseLib/X64/LongJump.nasm
new file mode 100644
index 0000000..59f7092
--- /dev/null
+++ b/debugging_demo/memtest86+/efi/Include/src/BaseLib/X64/LongJump.nasm
@@ -0,0 +1,77 @@
+;------------------------------------------------------------------------------

+;

+; Copyright (c) 2006 - 2019, Intel Corporation. All rights reserved.<BR>

+; SPDX-License-Identifier: BSD-2-Clause-Patent

+;

+; Module Name:

+;

+;   LongJump.Asm

+;

+; Abstract:

+;

+;   Implementation of _LongJump() on x64.

+;

+;------------------------------------------------------------------------------

+

+%include "Nasm.inc"

+

+    DEFAULT REL

+    SECTION .text

+

+extern ASM_PFX(PcdGet32 (PcdControlFlowEnforcementPropertyMask))

+

+;------------------------------------------------------------------------------

+; VOID

+; EFIAPI

+; InternalLongJump (

+;   IN      BASE_LIBRARY_JUMP_BUFFER  *JumpBuffer,

+;   IN      UINTN                     Value

+;   );

+;------------------------------------------------------------------------------

+global ASM_PFX(InternalLongJump)

+ASM_PFX(InternalLongJump):

+

+    mov     eax, [ASM_PFX(PcdGet32 (PcdControlFlowEnforcementPropertyMask))]

+    test    eax, eax

+    jz      CetDone

+    mov     rax, cr4

+    bt      eax, 23                      ; check if CET is enabled

+    jnc     CetDone

+

+    push    rdx                          ; save rdx

+

+    mov     rdx, [rcx + 0xF8]            ; rdx = target SSP

+    READSSP_RAX

+    sub     rdx, rax                     ; rdx = delta

+    mov     rax, rdx                     ; rax = delta

+

+    shr     rax, 3                       ; rax = delta/sizeof(UINT64)

+    INCSSP_RAX

+

+    pop     rdx                          ; restore rdx

+CetDone:

+

+    mov     rbx, [rcx]

+    mov     rsp, [rcx + 8]

+    mov     rbp, [rcx + 0x10]

+    mov     rdi, [rcx + 0x18]

+    mov     rsi, [rcx + 0x20]

+    mov     r12, [rcx + 0x28]

+    mov     r13, [rcx + 0x30]

+    mov     r14, [rcx + 0x38]

+    mov     r15, [rcx + 0x40]

+    ; load non-volatile fp registers

+    ldmxcsr [rcx + 0x50]

+    movdqu  xmm6,  [rcx + 0x58]

+    movdqu  xmm7,  [rcx + 0x68]

+    movdqu  xmm8,  [rcx + 0x78]

+    movdqu  xmm9,  [rcx + 0x88]

+    movdqu  xmm10, [rcx + 0x98]

+    movdqu  xmm11, [rcx + 0xA8]

+    movdqu  xmm12, [rcx + 0xB8]

+    movdqu  xmm13, [rcx + 0xC8]

+    movdqu  xmm14, [rcx + 0xD8]

+    movdqu  xmm15, [rcx + 0xE8]

+    mov     rax, rdx               ; set return value

+    jmp     qword [rcx + 0x48]

+

diff --git a/debugging_demo/memtest86+/efi/Include/src/BaseLib/X64/Monitor.nasm b/debugging_demo/memtest86+/efi/Include/src/BaseLib/X64/Monitor.nasm
new file mode 100644
index 0000000..e1ccb83
--- /dev/null
+++ b/debugging_demo/memtest86+/efi/Include/src/BaseLib/X64/Monitor.nasm
@@ -0,0 +1,37 @@
+;------------------------------------------------------------------------------

+;

+; Copyright (c) 2006, Intel Corporation. All rights reserved.<BR>

+; SPDX-License-Identifier: BSD-2-Clause-Patent

+;

+; Module Name:

+;

+;   Monitor.Asm

+;

+; Abstract:

+;

+;   AsmMonitor function

+;

+; Notes:

+;

+;------------------------------------------------------------------------------

+

+    DEFAULT REL

+    SECTION .text

+

+;------------------------------------------------------------------------------

+; UINT64

+; EFIAPI

+; AsmMonitor (

+;   IN      UINTN                     Eax,

+;   IN      UINTN                     Ecx,

+;   IN      UINTN                     Edx

+;   );

+;------------------------------------------------------------------------------

+global ASM_PFX(AsmMonitor)

+ASM_PFX(AsmMonitor):

+    mov     eax, ecx

+    mov     ecx, edx

+    mov     edx, r8d

+    DB      0xf, 1, 0xc8                ; monitor

+    ret

+

diff --git a/debugging_demo/memtest86+/efi/Include/src/BaseLib/X64/Mwait.nasm b/debugging_demo/memtest86+/efi/Include/src/BaseLib/X64/Mwait.nasm
new file mode 100644
index 0000000..83fc895
--- /dev/null
+++ b/debugging_demo/memtest86+/efi/Include/src/BaseLib/X64/Mwait.nasm
@@ -0,0 +1,35 @@
+;------------------------------------------------------------------------------

+;

+; Copyright (c) 2006, Intel Corporation. All rights reserved.<BR>

+; SPDX-License-Identifier: BSD-2-Clause-Patent

+;

+; Module Name:

+;

+;   Mwait.Asm

+;

+; Abstract:

+;

+;   AsmMwait function

+;

+; Notes:

+;

+;------------------------------------------------------------------------------

+

+    DEFAULT REL

+    SECTION .text

+

+;------------------------------------------------------------------------------

+; UINT64

+; EFIAPI

+; AsmMwait (

+;   IN      UINTN                     Eax,

+;   IN      UINTN                     Ecx

+;   );

+;------------------------------------------------------------------------------

+global ASM_PFX(AsmMwait)

+ASM_PFX(AsmMwait):

+    mov     eax, ecx

+    mov     ecx, edx

+    DB      0xf, 1, 0xc9                ; mwait

+    ret

+

diff --git a/debugging_demo/memtest86+/efi/Include/src/BaseLib/X64/Non-existing.c b/debugging_demo/memtest86+/efi/Include/src/BaseLib/X64/Non-existing.c
new file mode 100644
index 0000000..e00cb7e
--- /dev/null
+++ b/debugging_demo/memtest86+/efi/Include/src/BaseLib/X64/Non-existing.c
@@ -0,0 +1,147 @@
+/** @file

+  Non-existing BaseLib functions on x64

+

+  Copyright (c) 2006 - 2008, Intel Corporation. All rights reserved.<BR>

+  SPDX-License-Identifier: BSD-2-Clause-Patent

+

+**/

+

+#include <Library/BaseLib.h>

+#include <Library/DebugLib.h>

+

+/**

+  Enables the 32-bit paging mode on the CPU.

+

+  Enables the 32-bit paging mode on the CPU. CR0, CR3, CR4, and the page tables

+  must be properly initialized prior to calling this service. This function

+  assumes the current execution mode is 32-bit protected mode. This function is

+  only available on IA-32. After the 32-bit paging mode is enabled, control is

+  transferred to the function specified by EntryPoint using the new stack

+  specified by NewStack and passing in the parameters specified by Context1 and

+  Context2. Context1 and Context2 are optional and may be NULL. The function

+  EntryPoint must never return.

+

+  There are a number of constraints that must be followed before calling this

+  function:

+  1)  Interrupts must be disabled.

+  2)  The caller must be in 32-bit protected mode with flat descriptors. This

+      means all descriptors must have a base of 0 and a limit of 4GB.

+  3)  CR0 and CR4 must be compatible with 32-bit protected mode with flat

+      descriptors.

+  4)  CR3 must point to valid page tables that will be used once the transition

+      is complete, and those page tables must guarantee that the pages for this

+      function and the stack are identity mapped.

+

+  @param  EntryPoint  A pointer to function to call with the new stack after

+                      paging is enabled.

+  @param  Context1    A pointer to the context to pass into the EntryPoint

+                      function as the first parameter after paging is enabled.

+  @param  Context2    A pointer to the context to pass into the EntryPoint

+                      function as the second parameter after paging is enabled.

+  @param  NewStack    A pointer to the new stack to use for the EntryPoint

+                      function after paging is enabled.

+

+**/

+VOID

+EFIAPI

+InternalX86EnablePaging32 (

+  IN      SWITCH_STACK_ENTRY_POINT  EntryPoint,

+  IN      VOID                      *Context1,  OPTIONAL

+  IN      VOID                      *Context2,  OPTIONAL

+  IN      VOID                      *NewStack

+  )

+{

+  //

+  // This function cannot work on x64 platform

+  //

+  ASSERT (FALSE);

+}

+

+/**

+  Disables the 32-bit paging mode on the CPU.

+

+  Disables the 32-bit paging mode on the CPU and returns to 32-bit protected

+  mode. This function assumes the current execution mode is 32-paged protected

+  mode. This function is only available on IA-32. After the 32-bit paging mode

+  is disabled, control is transferred to the function specified by EntryPoint

+  using the new stack specified by NewStack and passing in the parameters

+  specified by Context1 and Context2. Context1 and Context2 are optional and

+  may be NULL. The function EntryPoint must never return.

+

+  There are a number of constraints that must be followed before calling this

+  function:

+  1)  Interrupts must be disabled.

+  2)  The caller must be in 32-bit paged mode.

+  3)  CR0, CR3, and CR4 must be compatible with 32-bit paged mode.

+  4)  CR3 must point to valid page tables that guarantee that the pages for

+      this function and the stack are identity mapped.

+

+  @param  EntryPoint  A pointer to function to call with the new stack after

+                      paging is disabled.

+  @param  Context1    A pointer to the context to pass into the EntryPoint

+                      function as the first parameter after paging is disabled.

+  @param  Context2    A pointer to the context to pass into the EntryPoint

+                      function as the second parameter after paging is

+                      disabled.

+  @param  NewStack    A pointer to the new stack to use for the EntryPoint

+                      function after paging is disabled.

+

+**/

+VOID

+EFIAPI

+InternalX86DisablePaging32 (

+  IN      SWITCH_STACK_ENTRY_POINT  EntryPoint,

+  IN      VOID                      *Context1,  OPTIONAL

+  IN      VOID                      *Context2,  OPTIONAL

+  IN      VOID                      *NewStack

+  )

+{

+  //

+  // This function cannot work on x64 platform

+  //

+  ASSERT (FALSE);

+}

+

+

+/**

+  Enables the 64-bit paging mode on the CPU.

+

+  Enables the 64-bit paging mode on the CPU. CR0, CR3, CR4, and the page tables

+  must be properly initialized prior to calling this service. This function

+  assumes the current execution mode is 32-bit protected mode with flat

+  descriptors. This function is only available on IA-32. After the 64-bit

+  paging mode is enabled, control is transferred to the function specified by

+  EntryPoint using the new stack specified by NewStack and passing in the

+  parameters specified by Context1 and Context2. Context1 and Context2 are

+  optional and may be 0. The function EntryPoint must never return.

+

+  @param  Cs          The 16-bit selector to load in the CS before EntryPoint

+                      is called. The descriptor in the GDT that this selector

+                      references must be setup for long mode.

+  @param  EntryPoint  The 64-bit virtual address of the function to call with

+                      the new stack after paging is enabled.

+  @param  Context1    The 64-bit virtual address of the context to pass into

+                      the EntryPoint function as the first parameter after

+                      paging is enabled.

+  @param  Context2    The 64-bit virtual address of the context to pass into

+                      the EntryPoint function as the second parameter after

+                      paging is enabled.

+  @param  NewStack    The 64-bit virtual address of the new stack to use for

+                      the EntryPoint function after paging is enabled.

+

+**/

+VOID

+EFIAPI

+InternalX86EnablePaging64 (

+  IN      UINT16                    Cs,

+  IN      UINT64                    EntryPoint,

+  IN      UINT64                    Context1,  OPTIONAL

+  IN      UINT64                    Context2,  OPTIONAL

+  IN      UINT64                    NewStack

+  )

+{

+  //

+  // This function cannot work on x64 platform.

+  //

+  ASSERT (FALSE);

+}

diff --git a/debugging_demo/memtest86+/efi/Include/src/BaseLib/X64/RdRand.nasm b/debugging_demo/memtest86+/efi/Include/src/BaseLib/X64/RdRand.nasm
new file mode 100644
index 0000000..7e7fe99
--- /dev/null
+++ b/debugging_demo/memtest86+/efi/Include/src/BaseLib/X64/RdRand.nasm
@@ -0,0 +1,77 @@
+;------------------------------------------------------------------------------

+;

+; Copyright (c) 2015 - 2016, Intel Corporation. All rights reserved.<BR>

+; SPDX-License-Identifier: BSD-2-Clause-Patent

+;

+; Module Name:

+;

+;   RdRand.nasm

+;

+; Abstract:

+;

+;   Generates random number through CPU RdRand instruction under 64-bit platform.

+;

+; Notes:

+;

+;------------------------------------------------------------------------------

+

+    DEFAULT REL

+    SECTION .text

+

+;------------------------------------------------------------------------------

+;  Generates a 16 bit random number through RDRAND instruction.

+;  Return TRUE if Rand generated successfully, or FALSE if not.

+;

+;  BOOLEAN EFIAPI InternalX86RdRand16 (UINT16 *Rand);

+;------------------------------------------------------------------------------

+global ASM_PFX(InternalX86RdRand16)

+ASM_PFX(InternalX86RdRand16):

+    ; rdrand   ax                  ; generate a 16 bit RN into eax,

+                                   ; CF=1 if RN generated ok, otherwise CF=0

+    db     0xf, 0xc7, 0xf0         ; rdrand r16: "0f c7 /6  ModRM:r/m(w)"

+    jc     rn16_ok                 ; jmp if CF=1

+    xor    rax, rax                ; reg=0 if CF=0

+    ret                            ; return with failure status

+rn16_ok:

+    mov    [rcx], ax

+    mov    rax,  1

+    ret

+

+;------------------------------------------------------------------------------

+;  Generates a 32 bit random number through RDRAND instruction.

+;  Return TRUE if Rand generated successfully, or FALSE if not.

+;

+;  BOOLEAN EFIAPI InternalX86RdRand32 (UINT32 *Rand);

+;------------------------------------------------------------------------------

+global ASM_PFX(InternalX86RdRand32)

+ASM_PFX(InternalX86RdRand32):

+    ; rdrand   eax                 ; generate a 32 bit RN into eax,

+                                   ; CF=1 if RN generated ok, otherwise CF=0

+    db     0xf, 0xc7, 0xf0         ; rdrand r32: "0f c7 /6  ModRM:r/m(w)"

+    jc     rn32_ok                 ; jmp if CF=1

+    xor    rax, rax                ; reg=0 if CF=0

+    ret                            ; return with failure status

+rn32_ok:

+    mov    [rcx], eax

+    mov    rax,  1

+    ret

+

+;------------------------------------------------------------------------------

+;  Generates a 64 bit random number through one RDRAND instruction.

+;  Return TRUE if Rand generated successfully, or FALSE if not.

+;

+;  BOOLEAN EFIAPI InternalX86RdRand64 (UINT64 *Random);

+;------------------------------------------------------------------------------

+global ASM_PFX(InternalX86RdRand64)

+ASM_PFX(InternalX86RdRand64):

+    ; rdrand   rax                 ; generate a 64 bit RN into rax,

+                                   ; CF=1 if RN generated ok, otherwise CF=0

+    db     0x48, 0xf, 0xc7, 0xf0   ; rdrand r64: "REX.W + 0f c7 /6 ModRM:r/m(w)"

+    jc     rn64_ok                 ; jmp if CF=1

+    xor    rax, rax                ; reg=0 if CF=0

+    ret                            ; return with failure status

+rn64_ok:

+    mov    [rcx], rax

+    mov    rax, 1

+    ret

+

diff --git a/debugging_demo/memtest86+/efi/Include/src/BaseLib/X64/ReadCr0.nasm b/debugging_demo/memtest86+/efi/Include/src/BaseLib/X64/ReadCr0.nasm
new file mode 100644
index 0000000..aaa6f81
--- /dev/null
+++ b/debugging_demo/memtest86+/efi/Include/src/BaseLib/X64/ReadCr0.nasm
@@ -0,0 +1,32 @@
+;------------------------------------------------------------------------------

+;

+; Copyright (c) 2006, Intel Corporation. All rights reserved.<BR>

+; SPDX-License-Identifier: BSD-2-Clause-Patent

+;

+; Module Name:

+;

+;   ReadCr0.Asm

+;

+; Abstract:

+;

+;   AsmReadCr0 function

+;

+; Notes:

+;

+;------------------------------------------------------------------------------

+

+    DEFAULT REL

+    SECTION .text

+

+;------------------------------------------------------------------------------

+; UINTN

+; EFIAPI

+; AsmReadCr0 (

+;   VOID

+;   );

+;------------------------------------------------------------------------------

+global ASM_PFX(AsmReadCr0)

+ASM_PFX(AsmReadCr0):

+    mov     rax, cr0

+    ret

+

diff --git a/debugging_demo/memtest86+/efi/Include/src/BaseLib/X64/ReadCr2.nasm b/debugging_demo/memtest86+/efi/Include/src/BaseLib/X64/ReadCr2.nasm
new file mode 100644
index 0000000..74c4778
--- /dev/null
+++ b/debugging_demo/memtest86+/efi/Include/src/BaseLib/X64/ReadCr2.nasm
@@ -0,0 +1,32 @@
+;------------------------------------------------------------------------------

+;

+; Copyright (c) 2006, Intel Corporation. All rights reserved.<BR>

+; SPDX-License-Identifier: BSD-2-Clause-Patent

+;

+; Module Name:

+;

+;   ReadCr2.Asm

+;

+; Abstract:

+;

+;   AsmReadCr2 function

+;

+; Notes:

+;

+;------------------------------------------------------------------------------

+

+    DEFAULT REL

+    SECTION .text

+

+;------------------------------------------------------------------------------

+; UINTN

+; EFIAPI

+; AsmReadCr2 (

+;   VOID

+;   );

+;------------------------------------------------------------------------------

+global ASM_PFX(AsmReadCr2)

+ASM_PFX(AsmReadCr2):

+    mov     rax, cr2

+    ret

+

diff --git a/debugging_demo/memtest86+/efi/Include/src/BaseLib/X64/ReadCr3.nasm b/debugging_demo/memtest86+/efi/Include/src/BaseLib/X64/ReadCr3.nasm
new file mode 100644
index 0000000..ea8173f
--- /dev/null
+++ b/debugging_demo/memtest86+/efi/Include/src/BaseLib/X64/ReadCr3.nasm
@@ -0,0 +1,32 @@
+;------------------------------------------------------------------------------

+;

+; Copyright (c) 2006, Intel Corporation. All rights reserved.<BR>

+; SPDX-License-Identifier: BSD-2-Clause-Patent

+;

+; Module Name:

+;

+;   ReadCr3.Asm

+;

+; Abstract:

+;

+;   AsmReadCr3 function

+;

+; Notes:

+;

+;------------------------------------------------------------------------------

+

+    DEFAULT REL

+    SECTION .text

+

+;------------------------------------------------------------------------------

+; UINTN

+; EFIAPI

+; AsmReadCr3 (

+;   VOID

+;   );

+;------------------------------------------------------------------------------

+global ASM_PFX(AsmReadCr3)

+ASM_PFX(AsmReadCr3):

+    mov     rax, cr3

+    ret

+

diff --git a/debugging_demo/memtest86+/efi/Include/src/BaseLib/X64/ReadCr4.nasm b/debugging_demo/memtest86+/efi/Include/src/BaseLib/X64/ReadCr4.nasm
new file mode 100644
index 0000000..70c2650
--- /dev/null
+++ b/debugging_demo/memtest86+/efi/Include/src/BaseLib/X64/ReadCr4.nasm
@@ -0,0 +1,32 @@
+;------------------------------------------------------------------------------

+;

+; Copyright (c) 2006, Intel Corporation. All rights reserved.<BR>

+; SPDX-License-Identifier: BSD-2-Clause-Patent

+;

+; Module Name:

+;

+;   ReadCr4.Asm

+;

+; Abstract:

+;

+;   AsmReadCr4 function

+;

+; Notes:

+;

+;------------------------------------------------------------------------------

+

+    DEFAULT REL

+    SECTION .text

+

+;------------------------------------------------------------------------------

+; UINTN

+; EFIAPI

+; AsmReadCr4 (

+;   VOID

+;   );

+;------------------------------------------------------------------------------

+global ASM_PFX(AsmReadCr4)

+ASM_PFX(AsmReadCr4):

+    mov     rax, cr4

+    ret

+

diff --git a/debugging_demo/memtest86+/efi/Include/src/BaseLib/X64/ReadCs.nasm b/debugging_demo/memtest86+/efi/Include/src/BaseLib/X64/ReadCs.nasm
new file mode 100644
index 0000000..ec069b8
--- /dev/null
+++ b/debugging_demo/memtest86+/efi/Include/src/BaseLib/X64/ReadCs.nasm
@@ -0,0 +1,32 @@
+;------------------------------------------------------------------------------

+;

+; Copyright (c) 2006, Intel Corporation. All rights reserved.<BR>

+; SPDX-License-Identifier: BSD-2-Clause-Patent

+;

+; Module Name:

+;

+;   ReadCs.Asm

+;

+; Abstract:

+;

+;   AsmReadCs function

+;

+; Notes:

+;

+;------------------------------------------------------------------------------

+

+    DEFAULT REL

+    SECTION .text

+

+;------------------------------------------------------------------------------

+; UINT16

+; EFIAPI

+; AsmReadCs (

+;   VOID

+;   );

+;------------------------------------------------------------------------------

+global ASM_PFX(AsmReadCs)

+ASM_PFX(AsmReadCs):

+    mov     eax, cs

+    ret

+

diff --git a/debugging_demo/memtest86+/efi/Include/src/BaseLib/X64/ReadDr0.nasm b/debugging_demo/memtest86+/efi/Include/src/BaseLib/X64/ReadDr0.nasm
new file mode 100644
index 0000000..7973e52
--- /dev/null
+++ b/debugging_demo/memtest86+/efi/Include/src/BaseLib/X64/ReadDr0.nasm
@@ -0,0 +1,32 @@
+;------------------------------------------------------------------------------

+;

+; Copyright (c) 2006, Intel Corporation. All rights reserved.<BR>

+; SPDX-License-Identifier: BSD-2-Clause-Patent

+;

+; Module Name:

+;

+;   ReadDr0.Asm

+;

+; Abstract:

+;

+;   AsmReadDr0 function

+;

+; Notes:

+;

+;------------------------------------------------------------------------------

+

+    DEFAULT REL

+    SECTION .text

+

+;------------------------------------------------------------------------------

+; UINTN

+; EFIAPI

+; AsmReadDr0 (

+;   VOID

+;   );

+;------------------------------------------------------------------------------

+global ASM_PFX(AsmReadDr0)

+ASM_PFX(AsmReadDr0):

+    mov     rax, dr0

+    ret

+

diff --git a/debugging_demo/memtest86+/efi/Include/src/BaseLib/X64/ReadDr1.nasm b/debugging_demo/memtest86+/efi/Include/src/BaseLib/X64/ReadDr1.nasm
new file mode 100644
index 0000000..1a4b159
--- /dev/null
+++ b/debugging_demo/memtest86+/efi/Include/src/BaseLib/X64/ReadDr1.nasm
@@ -0,0 +1,32 @@
+;------------------------------------------------------------------------------

+;

+; Copyright (c) 2006, Intel Corporation. All rights reserved.<BR>

+; SPDX-License-Identifier: BSD-2-Clause-Patent

+;

+; Module Name:

+;

+;   ReadDr1.Asm

+;

+; Abstract:

+;

+;   AsmReadDr1 function

+;

+; Notes:

+;

+;------------------------------------------------------------------------------

+

+    DEFAULT REL

+    SECTION .text

+

+;------------------------------------------------------------------------------

+; UINTN

+; EFIAPI

+; AsmReadDr1 (

+;   VOID

+;   );

+;------------------------------------------------------------------------------

+global ASM_PFX(AsmReadDr1)

+ASM_PFX(AsmReadDr1):

+    mov     rax, dr1

+    ret

+

diff --git a/debugging_demo/memtest86+/efi/Include/src/BaseLib/X64/ReadDr2.nasm b/debugging_demo/memtest86+/efi/Include/src/BaseLib/X64/ReadDr2.nasm
new file mode 100644
index 0000000..d1e403d
--- /dev/null
+++ b/debugging_demo/memtest86+/efi/Include/src/BaseLib/X64/ReadDr2.nasm
@@ -0,0 +1,32 @@
+;------------------------------------------------------------------------------

+;

+; Copyright (c) 2006, Intel Corporation. All rights reserved.<BR>

+; SPDX-License-Identifier: BSD-2-Clause-Patent

+;

+; Module Name:

+;

+;   ReadDr2.Asm

+;

+; Abstract:

+;

+;   AsmReadDr2 function

+;

+; Notes:

+;

+;------------------------------------------------------------------------------

+

+    DEFAULT REL

+    SECTION .text

+

+;------------------------------------------------------------------------------

+; UINTN

+; EFIAPI

+; AsmReadDr2 (

+;   VOID

+;   );

+;------------------------------------------------------------------------------

+global ASM_PFX(AsmReadDr2)

+ASM_PFX(AsmReadDr2):

+    mov     rax, dr2

+    ret

+

diff --git a/debugging_demo/memtest86+/efi/Include/src/BaseLib/X64/ReadDr3.nasm b/debugging_demo/memtest86+/efi/Include/src/BaseLib/X64/ReadDr3.nasm
new file mode 100644
index 0000000..96a9c5b
--- /dev/null
+++ b/debugging_demo/memtest86+/efi/Include/src/BaseLib/X64/ReadDr3.nasm
@@ -0,0 +1,32 @@
+;------------------------------------------------------------------------------

+;

+; Copyright (c) 2006, Intel Corporation. All rights reserved.<BR>

+; SPDX-License-Identifier: BSD-2-Clause-Patent

+;

+; Module Name:

+;

+;   ReadDr3.Asm

+;

+; Abstract:

+;

+;   AsmReadDr3 function

+;

+; Notes:

+;

+;------------------------------------------------------------------------------

+

+    DEFAULT REL

+    SECTION .text

+

+;------------------------------------------------------------------------------

+; UINTN

+; EFIAPI

+; AsmReadDr3 (

+;   VOID

+;   );

+;------------------------------------------------------------------------------

+global ASM_PFX(AsmReadDr3)

+ASM_PFX(AsmReadDr3):

+    mov     rax, dr3

+    ret

+

diff --git a/debugging_demo/memtest86+/efi/Include/src/BaseLib/X64/ReadDr4.nasm b/debugging_demo/memtest86+/efi/Include/src/BaseLib/X64/ReadDr4.nasm
new file mode 100644
index 0000000..82c0a9a
--- /dev/null
+++ b/debugging_demo/memtest86+/efi/Include/src/BaseLib/X64/ReadDr4.nasm
@@ -0,0 +1,36 @@
+;------------------------------------------------------------------------------

+;

+; Copyright (c) 2006, Intel Corporation. All rights reserved.<BR>

+; SPDX-License-Identifier: BSD-2-Clause-Patent

+;

+; Module Name:

+;

+;   ReadDr4.Asm

+;

+; Abstract:

+;

+;   AsmReadDr4 function

+;

+; Notes:

+;

+;------------------------------------------------------------------------------

+

+    DEFAULT REL

+    SECTION .text

+

+;------------------------------------------------------------------------------

+; UINTN

+; EFIAPI

+; AsmReadDr4 (

+;   VOID

+;   );

+;------------------------------------------------------------------------------

+global ASM_PFX(AsmReadDr4)

+ASM_PFX(AsmReadDr4):

+    ;

+    ; There's no obvious reason to access this register, since it's aliased to

+    ; DR7 when DE=0 or an exception generated when DE=1

+    ;

+    DB      0xf, 0x21, 0xe0

+    ret

+

diff --git a/debugging_demo/memtest86+/efi/Include/src/BaseLib/X64/ReadDr5.nasm b/debugging_demo/memtest86+/efi/Include/src/BaseLib/X64/ReadDr5.nasm
new file mode 100644
index 0000000..c309c66
--- /dev/null
+++ b/debugging_demo/memtest86+/efi/Include/src/BaseLib/X64/ReadDr5.nasm
@@ -0,0 +1,36 @@
+;------------------------------------------------------------------------------

+;

+; Copyright (c) 2006, Intel Corporation. All rights reserved.<BR>

+; SPDX-License-Identifier: BSD-2-Clause-Patent

+;

+; Module Name:

+;

+;   ReadDr5.Asm

+;

+; Abstract:

+;

+;   AsmReadDr5 function

+;

+; Notes:

+;

+;------------------------------------------------------------------------------

+

+    DEFAULT REL

+    SECTION .text

+

+;------------------------------------------------------------------------------

+; UINTN

+; EFIAPI

+; AsmReadDr5 (

+;   VOID

+;   );

+;------------------------------------------------------------------------------

+global ASM_PFX(AsmReadDr5)

+ASM_PFX(AsmReadDr5):

+    ;

+    ; There's no obvious reason to access this register, since it's aliased to

+    ; DR7 when DE=0 or an exception generated when DE=1

+    ;

+    DB      0xf, 0x21, 0xe8

+    ret

+

diff --git a/debugging_demo/memtest86+/efi/Include/src/BaseLib/X64/ReadDr6.nasm b/debugging_demo/memtest86+/efi/Include/src/BaseLib/X64/ReadDr6.nasm
new file mode 100644
index 0000000..7bdc103
--- /dev/null
+++ b/debugging_demo/memtest86+/efi/Include/src/BaseLib/X64/ReadDr6.nasm
@@ -0,0 +1,32 @@
+;------------------------------------------------------------------------------

+;

+; Copyright (c) 2006, Intel Corporation. All rights reserved.<BR>

+; SPDX-License-Identifier: BSD-2-Clause-Patent

+;

+; Module Name:

+;

+;   ReadDr6.Asm

+;

+; Abstract:

+;

+;   AsmReadDr6 function

+;

+; Notes:

+;

+;------------------------------------------------------------------------------

+

+    DEFAULT REL

+    SECTION .text

+

+;------------------------------------------------------------------------------

+; UINTN

+; EFIAPI

+; AsmReadDr6 (

+;   VOID

+;   );

+;------------------------------------------------------------------------------

+global ASM_PFX(AsmReadDr6)

+ASM_PFX(AsmReadDr6):

+    mov     rax, dr6

+    ret

+

diff --git a/debugging_demo/memtest86+/efi/Include/src/BaseLib/X64/ReadDr7.nasm b/debugging_demo/memtest86+/efi/Include/src/BaseLib/X64/ReadDr7.nasm
new file mode 100644
index 0000000..219d2e4
--- /dev/null
+++ b/debugging_demo/memtest86+/efi/Include/src/BaseLib/X64/ReadDr7.nasm
@@ -0,0 +1,32 @@
+;------------------------------------------------------------------------------

+;

+; Copyright (c) 2006, Intel Corporation. All rights reserved.<BR>

+; SPDX-License-Identifier: BSD-2-Clause-Patent

+;

+; Module Name:

+;

+;   ReadDr7.Asm

+;

+; Abstract:

+;

+;   AsmReadDr7 function

+;

+; Notes:

+;

+;------------------------------------------------------------------------------

+

+    DEFAULT REL

+    SECTION .text

+

+;------------------------------------------------------------------------------

+; UINTN

+; EFIAPI

+; AsmReadDr7 (

+;   VOID

+;   );

+;------------------------------------------------------------------------------

+global ASM_PFX(AsmReadDr7)

+ASM_PFX(AsmReadDr7):

+    mov     rax, dr7

+    ret

+

diff --git a/debugging_demo/memtest86+/efi/Include/src/BaseLib/X64/ReadDs.nasm b/debugging_demo/memtest86+/efi/Include/src/BaseLib/X64/ReadDs.nasm
new file mode 100644
index 0000000..597450d
--- /dev/null
+++ b/debugging_demo/memtest86+/efi/Include/src/BaseLib/X64/ReadDs.nasm
@@ -0,0 +1,32 @@
+;------------------------------------------------------------------------------

+;

+; Copyright (c) 2006, Intel Corporation. All rights reserved.<BR>

+; SPDX-License-Identifier: BSD-2-Clause-Patent

+;

+; Module Name:

+;

+;   ReadDs.Asm

+;

+; Abstract:

+;

+;   AsmReadDs function

+;

+; Notes:

+;

+;------------------------------------------------------------------------------

+

+    DEFAULT REL

+    SECTION .text

+

+;------------------------------------------------------------------------------

+; UINT16

+; EFIAPI

+; AsmReadDs (

+;   VOID

+;   );

+;------------------------------------------------------------------------------

+global ASM_PFX(AsmReadDs)

+ASM_PFX(AsmReadDs):

+    mov     eax, ds

+    ret

+

diff --git a/debugging_demo/memtest86+/efi/Include/src/BaseLib/X64/ReadEflags.nasm b/debugging_demo/memtest86+/efi/Include/src/BaseLib/X64/ReadEflags.nasm
new file mode 100644
index 0000000..e0a5ea0
--- /dev/null
+++ b/debugging_demo/memtest86+/efi/Include/src/BaseLib/X64/ReadEflags.nasm
@@ -0,0 +1,33 @@
+;------------------------------------------------------------------------------

+;

+; Copyright (c) 2006, Intel Corporation. All rights reserved.<BR>

+; SPDX-License-Identifier: BSD-2-Clause-Patent

+;

+; Module Name:

+;

+;   ReadEflags.Asm

+;

+; Abstract:

+;

+;   AsmReadEflags function

+;

+; Notes:

+;

+;------------------------------------------------------------------------------

+

+    DEFAULT REL

+    SECTION .text

+

+;------------------------------------------------------------------------------

+; UINTN

+; EFIAPI

+; AsmReadEflags (

+;   VOID

+;   );

+;------------------------------------------------------------------------------

+global ASM_PFX(AsmReadEflags)

+ASM_PFX(AsmReadEflags):

+    pushfq

+    pop     rax

+    ret

+

diff --git a/debugging_demo/memtest86+/efi/Include/src/BaseLib/X64/ReadEs.nasm b/debugging_demo/memtest86+/efi/Include/src/BaseLib/X64/ReadEs.nasm
new file mode 100644
index 0000000..9633945
--- /dev/null
+++ b/debugging_demo/memtest86+/efi/Include/src/BaseLib/X64/ReadEs.nasm
@@ -0,0 +1,32 @@
+;------------------------------------------------------------------------------

+;

+; Copyright (c) 2006, Intel Corporation. All rights reserved.<BR>

+; SPDX-License-Identifier: BSD-2-Clause-Patent

+;

+; Module Name:

+;

+;   ReadEs.Asm

+;

+; Abstract:

+;

+;   AsmReadEs function

+;

+; Notes:

+;

+;------------------------------------------------------------------------------

+

+    DEFAULT REL

+    SECTION .text

+

+;------------------------------------------------------------------------------

+; UINT16

+; EFIAPI

+; AsmReadEs (

+;   VOID

+;   );

+;------------------------------------------------------------------------------

+global ASM_PFX(AsmReadEs)

+ASM_PFX(AsmReadEs):

+    mov     eax, es

+    ret

+

diff --git a/debugging_demo/memtest86+/efi/Include/src/BaseLib/X64/ReadFs.nasm b/debugging_demo/memtest86+/efi/Include/src/BaseLib/X64/ReadFs.nasm
new file mode 100644
index 0000000..9d032ff
--- /dev/null
+++ b/debugging_demo/memtest86+/efi/Include/src/BaseLib/X64/ReadFs.nasm
@@ -0,0 +1,32 @@
+;------------------------------------------------------------------------------

+;

+; Copyright (c) 2006, Intel Corporation. All rights reserved.<BR>

+; SPDX-License-Identifier: BSD-2-Clause-Patent

+;

+; Module Name:

+;

+;   ReadFs.Asm

+;

+; Abstract:

+;

+;   AsmReadFs function

+;

+; Notes:

+;

+;------------------------------------------------------------------------------

+

+    DEFAULT REL

+    SECTION .text

+

+;------------------------------------------------------------------------------

+; UINT16

+; EFIAPI

+; AsmReadFs (

+;   VOID

+;   );

+;------------------------------------------------------------------------------

+global ASM_PFX(AsmReadFs)

+ASM_PFX(AsmReadFs):

+    mov     eax, fs

+    ret

+

diff --git a/debugging_demo/memtest86+/efi/Include/src/BaseLib/X64/ReadGdtr.nasm b/debugging_demo/memtest86+/efi/Include/src/BaseLib/X64/ReadGdtr.nasm
new file mode 100644
index 0000000..1712c11
--- /dev/null
+++ b/debugging_demo/memtest86+/efi/Include/src/BaseLib/X64/ReadGdtr.nasm
@@ -0,0 +1,32 @@
+;------------------------------------------------------------------------------

+;

+; Copyright (c) 2006, Intel Corporation. All rights reserved.<BR>

+; SPDX-License-Identifier: BSD-2-Clause-Patent

+;

+; Module Name:

+;

+;   ReadGdtr.Asm

+;

+; Abstract:

+;

+;   AsmReadGdtr function

+;

+; Notes:

+;

+;------------------------------------------------------------------------------

+

+    DEFAULT REL

+    SECTION .text

+

+;------------------------------------------------------------------------------

+; VOID

+; EFIAPI

+; InternalX86ReadGdtr (

+;   OUT IA32_DESCRIPTOR  *Gdtr

+;   );

+;------------------------------------------------------------------------------

+global ASM_PFX(InternalX86ReadGdtr)

+ASM_PFX(InternalX86ReadGdtr):

+    sgdt    [rcx]

+    ret

+

diff --git a/debugging_demo/memtest86+/efi/Include/src/BaseLib/X64/ReadGs.nasm b/debugging_demo/memtest86+/efi/Include/src/BaseLib/X64/ReadGs.nasm
new file mode 100644
index 0000000..953fe9c
--- /dev/null
+++ b/debugging_demo/memtest86+/efi/Include/src/BaseLib/X64/ReadGs.nasm
@@ -0,0 +1,32 @@
+;------------------------------------------------------------------------------

+;

+; Copyright (c) 2006, Intel Corporation. All rights reserved.<BR>

+; SPDX-License-Identifier: BSD-2-Clause-Patent

+;

+; Module Name:

+;

+;   ReadGs.Asm

+;

+; Abstract:

+;

+;   AsmReadGs function

+;

+; Notes:

+;

+;------------------------------------------------------------------------------

+

+    DEFAULT REL

+    SECTION .text

+

+;------------------------------------------------------------------------------

+; UINT16

+; EFIAPI

+; AsmReadGs (

+;   VOID

+;   );

+;------------------------------------------------------------------------------

+global ASM_PFX(AsmReadGs)

+ASM_PFX(AsmReadGs):

+    mov     eax, gs

+    ret

+

diff --git a/debugging_demo/memtest86+/efi/Include/src/BaseLib/X64/ReadIdtr.nasm b/debugging_demo/memtest86+/efi/Include/src/BaseLib/X64/ReadIdtr.nasm
new file mode 100644
index 0000000..086ab70
--- /dev/null
+++ b/debugging_demo/memtest86+/efi/Include/src/BaseLib/X64/ReadIdtr.nasm
@@ -0,0 +1,32 @@
+;------------------------------------------------------------------------------

+;

+; Copyright (c) 2006, Intel Corporation. All rights reserved.<BR>

+; SPDX-License-Identifier: BSD-2-Clause-Patent

+;

+; Module Name:

+;

+;   ReadIdtr.Asm

+;

+; Abstract:

+;

+;   AsmReadIdtr function

+;

+; Notes:

+;

+;------------------------------------------------------------------------------

+

+    DEFAULT REL

+    SECTION .text

+

+;------------------------------------------------------------------------------

+; VOID

+; EFIAPI

+; InternalX86ReadIdtr (

+;   OUT     IA32_DESCRIPTOR           *Idtr

+;   );

+;------------------------------------------------------------------------------

+global ASM_PFX(InternalX86ReadIdtr)

+ASM_PFX(InternalX86ReadIdtr):

+    sidt    [rcx]

+    ret

+

diff --git a/debugging_demo/memtest86+/efi/Include/src/BaseLib/X64/ReadLdtr.nasm b/debugging_demo/memtest86+/efi/Include/src/BaseLib/X64/ReadLdtr.nasm
new file mode 100644
index 0000000..9339161
--- /dev/null
+++ b/debugging_demo/memtest86+/efi/Include/src/BaseLib/X64/ReadLdtr.nasm
@@ -0,0 +1,32 @@
+;------------------------------------------------------------------------------

+;

+; Copyright (c) 2006, Intel Corporation. All rights reserved.<BR>

+; SPDX-License-Identifier: BSD-2-Clause-Patent

+;

+; Module Name:

+;

+;   ReadLdtr.Asm

+;

+; Abstract:

+;

+;   AsmReadLdtr function

+;

+; Notes:

+;

+;------------------------------------------------------------------------------

+

+    DEFAULT REL

+    SECTION .text

+

+;------------------------------------------------------------------------------

+; UINT16

+; EFIAPI

+; AsmReadLdtr (

+;   VOID

+;   );

+;------------------------------------------------------------------------------

+global ASM_PFX(AsmReadLdtr)

+ASM_PFX(AsmReadLdtr):

+    sldt    eax

+    ret

+

diff --git a/debugging_demo/memtest86+/efi/Include/src/BaseLib/X64/ReadMm0.nasm b/debugging_demo/memtest86+/efi/Include/src/BaseLib/X64/ReadMm0.nasm
new file mode 100644
index 0000000..615721b
--- /dev/null
+++ b/debugging_demo/memtest86+/efi/Include/src/BaseLib/X64/ReadMm0.nasm
@@ -0,0 +1,35 @@
+;------------------------------------------------------------------------------

+;

+; Copyright (c) 2006, Intel Corporation. All rights reserved.<BR>

+; SPDX-License-Identifier: BSD-2-Clause-Patent

+;

+; Module Name:

+;

+;   ReadMm0.Asm

+;

+; Abstract:

+;

+;   AsmReadMm0 function

+;

+; Notes:

+;

+;------------------------------------------------------------------------------

+

+    DEFAULT REL

+    SECTION .text

+

+;------------------------------------------------------------------------------

+; UINT64

+; EFIAPI

+; AsmReadMm0 (

+;   VOID

+;   );

+;------------------------------------------------------------------------------

+global ASM_PFX(AsmReadMm0)

+ASM_PFX(AsmReadMm0):

+    ;

+    ; 64-bit MASM doesn't support MMX instructions, so use opcode here

+    ;

+    DB      0x48, 0xf, 0x7e, 0xc0

+    ret

+

diff --git a/debugging_demo/memtest86+/efi/Include/src/BaseLib/X64/ReadMm1.nasm b/debugging_demo/memtest86+/efi/Include/src/BaseLib/X64/ReadMm1.nasm
new file mode 100644
index 0000000..7b27393
--- /dev/null
+++ b/debugging_demo/memtest86+/efi/Include/src/BaseLib/X64/ReadMm1.nasm
@@ -0,0 +1,35 @@
+;------------------------------------------------------------------------------

+;

+; Copyright (c) 2006, Intel Corporation. All rights reserved.<BR>

+; SPDX-License-Identifier: BSD-2-Clause-Patent

+;

+; Module Name:

+;

+;   ReadMm1.Asm

+;

+; Abstract:

+;

+;   AsmReadMm1 function

+;

+; Notes:

+;

+;------------------------------------------------------------------------------

+

+    DEFAULT REL

+    SECTION .text

+

+;------------------------------------------------------------------------------

+; UINT64

+; EFIAPI

+; AsmReadMm1 (

+;   VOID

+;   );

+;------------------------------------------------------------------------------

+global ASM_PFX(AsmReadMm1)

+ASM_PFX(AsmReadMm1):

+    ;

+    ; 64-bit MASM doesn't support MMX instructions, so use opcode here

+    ;

+    DB      0x48, 0xf, 0x7e, 0xc8

+    ret

+

diff --git a/debugging_demo/memtest86+/efi/Include/src/BaseLib/X64/ReadMm2.nasm b/debugging_demo/memtest86+/efi/Include/src/BaseLib/X64/ReadMm2.nasm
new file mode 100644
index 0000000..c654b91
--- /dev/null
+++ b/debugging_demo/memtest86+/efi/Include/src/BaseLib/X64/ReadMm2.nasm
@@ -0,0 +1,35 @@
+;------------------------------------------------------------------------------

+;

+; Copyright (c) 2006, Intel Corporation. All rights reserved.<BR>

+; SPDX-License-Identifier: BSD-2-Clause-Patent

+;

+; Module Name:

+;

+;   ReadMm2.Asm

+;

+; Abstract:

+;

+;   AsmReadMm2 function

+;

+; Notes:

+;

+;------------------------------------------------------------------------------

+

+    DEFAULT REL

+    SECTION .text

+

+;------------------------------------------------------------------------------

+; UINT64

+; EFIAPI

+; AsmReadMm2 (

+;   VOID

+;   );

+;------------------------------------------------------------------------------

+global ASM_PFX(AsmReadMm2)

+ASM_PFX(AsmReadMm2):

+    ;

+    ; 64-bit MASM doesn't support MMX instructions, so use opcode here

+    ;

+    DB      0x48, 0xf, 0x7e, 0xd0

+    ret

+

diff --git a/debugging_demo/memtest86+/efi/Include/src/BaseLib/X64/ReadMm3.nasm b/debugging_demo/memtest86+/efi/Include/src/BaseLib/X64/ReadMm3.nasm
new file mode 100644
index 0000000..88d51c0
--- /dev/null
+++ b/debugging_demo/memtest86+/efi/Include/src/BaseLib/X64/ReadMm3.nasm
@@ -0,0 +1,35 @@
+;------------------------------------------------------------------------------

+;

+; Copyright (c) 2006, Intel Corporation. All rights reserved.<BR>

+; SPDX-License-Identifier: BSD-2-Clause-Patent

+;

+; Module Name:

+;

+;   ReadMm3.Asm

+;

+; Abstract:

+;

+;   AsmReadMm3 function

+;

+; Notes:

+;

+;------------------------------------------------------------------------------

+

+    DEFAULT REL

+    SECTION .text

+

+;------------------------------------------------------------------------------

+; UINT64

+; EFIAPI

+; AsmReadMm3 (

+;   VOID

+;   );

+;------------------------------------------------------------------------------

+global ASM_PFX(AsmReadMm3)

+ASM_PFX(AsmReadMm3):

+    ;

+    ; 64-bit MASM doesn't support MMX instructions, so use opcode here

+    ;

+    DB      0x48, 0xf, 0x7e, 0xd8

+    ret

+

diff --git a/debugging_demo/memtest86+/efi/Include/src/BaseLib/X64/ReadMm4.nasm b/debugging_demo/memtest86+/efi/Include/src/BaseLib/X64/ReadMm4.nasm
new file mode 100644
index 0000000..4252d20
--- /dev/null
+++ b/debugging_demo/memtest86+/efi/Include/src/BaseLib/X64/ReadMm4.nasm
@@ -0,0 +1,35 @@
+;------------------------------------------------------------------------------

+;

+; Copyright (c) 2006, Intel Corporation. All rights reserved.<BR>

+; SPDX-License-Identifier: BSD-2-Clause-Patent

+;

+; Module Name:

+;

+;   ReadMm4.Asm

+;

+; Abstract:

+;

+;   AsmReadMm4 function

+;

+; Notes:

+;

+;------------------------------------------------------------------------------

+

+    DEFAULT REL

+    SECTION .text

+

+;------------------------------------------------------------------------------

+; UINT64

+; EFIAPI

+; AsmReadMm4 (

+;   VOID

+;   );

+;------------------------------------------------------------------------------

+global ASM_PFX(AsmReadMm4)

+ASM_PFX(AsmReadMm4):

+    ;

+    ; 64-bit MASM doesn't support MMX instructions, so use opcode here

+    ;

+    DB      0x48, 0xf, 0x7e, 0xe0

+    ret

+

diff --git a/debugging_demo/memtest86+/efi/Include/src/BaseLib/X64/ReadMm5.nasm b/debugging_demo/memtest86+/efi/Include/src/BaseLib/X64/ReadMm5.nasm
new file mode 100644
index 0000000..d8f530d
--- /dev/null
+++ b/debugging_demo/memtest86+/efi/Include/src/BaseLib/X64/ReadMm5.nasm
@@ -0,0 +1,35 @@
+;------------------------------------------------------------------------------

+;

+; Copyright (c) 2006, Intel Corporation. All rights reserved.<BR>

+; SPDX-License-Identifier: BSD-2-Clause-Patent

+;

+; Module Name:

+;

+;   ReadMm5.Asm

+;

+; Abstract:

+;

+;   AsmReadMm5 function

+;

+; Notes:

+;

+;------------------------------------------------------------------------------

+

+    DEFAULT REL

+    SECTION .text

+

+;------------------------------------------------------------------------------

+; UINT64

+; EFIAPI

+; AsmReadMm5 (

+;   VOID

+;   );

+;------------------------------------------------------------------------------

+global ASM_PFX(AsmReadMm5)

+ASM_PFX(AsmReadMm5):

+    ;

+    ; 64-bit MASM doesn't support MMX instructions, so use opcode here

+    ;

+    DB      0x48, 0xf, 0x7e, 0xe8

+    ret

+

diff --git a/debugging_demo/memtest86+/efi/Include/src/BaseLib/X64/ReadMm6.nasm b/debugging_demo/memtest86+/efi/Include/src/BaseLib/X64/ReadMm6.nasm
new file mode 100644
index 0000000..6f6883c
--- /dev/null
+++ b/debugging_demo/memtest86+/efi/Include/src/BaseLib/X64/ReadMm6.nasm
@@ -0,0 +1,35 @@
+;------------------------------------------------------------------------------

+;

+; Copyright (c) 2006, Intel Corporation. All rights reserved.<BR>

+; SPDX-License-Identifier: BSD-2-Clause-Patent

+;

+; Module Name:

+;

+;   ReadMm6.Asm

+;

+; Abstract:

+;

+;   AsmReadMm6 function

+;

+; Notes:

+;

+;------------------------------------------------------------------------------

+

+    DEFAULT REL

+    SECTION .text

+

+;------------------------------------------------------------------------------

+; UINT64

+; EFIAPI

+; AsmReadMm6 (

+;   VOID

+;   );

+;------------------------------------------------------------------------------

+global ASM_PFX(AsmReadMm6)

+ASM_PFX(AsmReadMm6):

+    ;

+    ; 64-bit MASM doesn't support MMX instructions, so use opcode here

+    ;

+    DB      0x48, 0xf, 0x7e, 0xf0

+    ret

+

diff --git a/debugging_demo/memtest86+/efi/Include/src/BaseLib/X64/ReadMm7.nasm b/debugging_demo/memtest86+/efi/Include/src/BaseLib/X64/ReadMm7.nasm
new file mode 100644
index 0000000..573f15d
--- /dev/null
+++ b/debugging_demo/memtest86+/efi/Include/src/BaseLib/X64/ReadMm7.nasm
@@ -0,0 +1,35 @@
+;------------------------------------------------------------------------------

+;

+; Copyright (c) 2006, Intel Corporation. All rights reserved.<BR>

+; SPDX-License-Identifier: BSD-2-Clause-Patent

+;

+; Module Name:

+;

+;   ReadMm7.Asm

+;

+; Abstract:

+;

+;   AsmReadMm7 function

+;

+; Notes:

+;

+;------------------------------------------------------------------------------

+

+    DEFAULT REL

+    SECTION .text

+

+;------------------------------------------------------------------------------

+; UINT64

+; EFIAPI

+; AsmReadMm7 (

+;   VOID

+;   );

+;------------------------------------------------------------------------------

+global ASM_PFX(AsmReadMm7)

+ASM_PFX(AsmReadMm7):

+    ;

+    ; 64-bit MASM doesn't support MMX instructions, so use opcode here

+    ;

+    DB      0x48, 0xf, 0x7e, 0xf8

+    ret

+

diff --git a/debugging_demo/memtest86+/efi/Include/src/BaseLib/X64/ReadMsr64.c b/debugging_demo/memtest86+/efi/Include/src/BaseLib/X64/ReadMsr64.c
new file mode 100644
index 0000000..5ee7ca5
--- /dev/null
+++ b/debugging_demo/memtest86+/efi/Include/src/BaseLib/X64/ReadMsr64.c
@@ -0,0 +1,33 @@
+/** @file

+  CpuBreakpoint function.

+

+  Copyright (c) 2006 - 2008, Intel Corporation. All rights reserved.<BR>

+  SPDX-License-Identifier: BSD-2-Clause-Patent

+

+**/

+

+/**

+  Microsoft Visual Studio 7.1 Function Prototypes for I/O Intrinsics.

+**/

+

+unsigned __int64 __readmsr (int register);

+

+#pragma intrinsic(__readmsr)

+

+/**

+  Read data to MSR.

+

+  @param  Index                Register index of MSR.

+

+  @return Value read from MSR.

+

+**/

+UINT64

+EFIAPI

+AsmReadMsr64 (

+  IN UINT32  Index

+  )

+{

+  return __readmsr (Index);

+}

+

diff --git a/debugging_demo/memtest86+/efi/Include/src/BaseLib/X64/ReadMsr64.nasm b/debugging_demo/memtest86+/efi/Include/src/BaseLib/X64/ReadMsr64.nasm
new file mode 100644
index 0000000..df69255
--- /dev/null
+++ b/debugging_demo/memtest86+/efi/Include/src/BaseLib/X64/ReadMsr64.nasm
@@ -0,0 +1,34 @@
+;------------------------------------------------------------------------------

+;

+; Copyright (c) 2006, Intel Corporation. All rights reserved.<BR>

+; SPDX-License-Identifier: BSD-2-Clause-Patent

+;

+; Module Name:

+;

+;   ReadMsr64.Asm

+;

+; Abstract:

+;

+;   AsmReadMsr64 function

+;

+; Notes:

+;

+;------------------------------------------------------------------------------

+

+    DEFAULT REL

+    SECTION .text

+

+;------------------------------------------------------------------------------

+; UINT64

+; EFIAPI

+; AsmReadMsr64 (

+;   IN UINT32  Index

+;   );

+;------------------------------------------------------------------------------

+global ASM_PFX(AsmReadMsr64)

+ASM_PFX(AsmReadMsr64):

+    rdmsr                               ; edx & eax are zero extended

+    shl     rdx, 0x20

+    or      rax, rdx

+    ret

+

diff --git a/debugging_demo/memtest86+/efi/Include/src/BaseLib/X64/ReadPmc.nasm b/debugging_demo/memtest86+/efi/Include/src/BaseLib/X64/ReadPmc.nasm
new file mode 100644
index 0000000..1785a09
--- /dev/null
+++ b/debugging_demo/memtest86+/efi/Include/src/BaseLib/X64/ReadPmc.nasm
@@ -0,0 +1,34 @@
+;------------------------------------------------------------------------------

+;

+; Copyright (c) 2006, Intel Corporation. All rights reserved.<BR>

+; SPDX-License-Identifier: BSD-2-Clause-Patent

+;

+; Module Name:

+;

+;   ReadPmc.Asm

+;

+; Abstract:

+;

+;   AsmReadPmc function

+;

+; Notes:

+;

+;------------------------------------------------------------------------------

+

+    DEFAULT REL

+    SECTION .text

+

+;------------------------------------------------------------------------------

+; UINT64

+; EFIAPI

+; AsmReadPmc (

+;   IN UINT32   PmcIndex

+;   );

+;------------------------------------------------------------------------------

+global ASM_PFX(AsmReadPmc)

+ASM_PFX(AsmReadPmc):

+    rdpmc

+    shl     rdx, 0x20

+    or      rax, rdx

+    ret

+

diff --git a/debugging_demo/memtest86+/efi/Include/src/BaseLib/X64/ReadSs.nasm b/debugging_demo/memtest86+/efi/Include/src/BaseLib/X64/ReadSs.nasm
new file mode 100644
index 0000000..5fbe698
--- /dev/null
+++ b/debugging_demo/memtest86+/efi/Include/src/BaseLib/X64/ReadSs.nasm
@@ -0,0 +1,32 @@
+;------------------------------------------------------------------------------

+;

+; Copyright (c) 2006, Intel Corporation. All rights reserved.<BR>

+; SPDX-License-Identifier: BSD-2-Clause-Patent

+;

+; Module Name:

+;

+;   ReadSs.Asm

+;

+; Abstract:

+;

+;   AsmReadSs function

+;

+; Notes:

+;

+;------------------------------------------------------------------------------

+

+    DEFAULT REL

+    SECTION .text

+

+;------------------------------------------------------------------------------

+; UINT16

+; EFIAPI

+; AsmReadSs (

+;   VOID

+;   );

+;------------------------------------------------------------------------------

+global ASM_PFX(AsmReadSs)

+ASM_PFX(AsmReadSs):

+    mov     eax, ss

+    ret

+

diff --git a/debugging_demo/memtest86+/efi/Include/src/BaseLib/X64/ReadTr.nasm b/debugging_demo/memtest86+/efi/Include/src/BaseLib/X64/ReadTr.nasm
new file mode 100644
index 0000000..492ef6c
--- /dev/null
+++ b/debugging_demo/memtest86+/efi/Include/src/BaseLib/X64/ReadTr.nasm
@@ -0,0 +1,32 @@
+;------------------------------------------------------------------------------

+;

+; Copyright (c) 2006, Intel Corporation. All rights reserved.<BR>

+; SPDX-License-Identifier: BSD-2-Clause-Patent

+;

+; Module Name:

+;

+;   ReadTr.Asm

+;

+; Abstract:

+;

+;   AsmReadTr function

+;

+; Notes:

+;

+;------------------------------------------------------------------------------

+

+    DEFAULT REL

+    SECTION .text

+

+;------------------------------------------------------------------------------

+; UINT16

+; EFIAPI

+; AsmReadTr (

+;   VOID

+;   );

+;------------------------------------------------------------------------------

+global ASM_PFX(AsmReadTr)

+ASM_PFX(AsmReadTr):

+    str     eax

+    ret

+

diff --git a/debugging_demo/memtest86+/efi/Include/src/BaseLib/X64/ReadTsc.nasm b/debugging_demo/memtest86+/efi/Include/src/BaseLib/X64/ReadTsc.nasm
new file mode 100644
index 0000000..45672d6
--- /dev/null
+++ b/debugging_demo/memtest86+/efi/Include/src/BaseLib/X64/ReadTsc.nasm
@@ -0,0 +1,34 @@
+;------------------------------------------------------------------------------

+;

+; Copyright (c) 2006, Intel Corporation. All rights reserved.<BR>

+; SPDX-License-Identifier: BSD-2-Clause-Patent

+;

+; Module Name:

+;

+;   ReadTsc.Asm

+;

+; Abstract:

+;

+;   AsmReadTsc function

+;

+; Notes:

+;

+;------------------------------------------------------------------------------

+

+    DEFAULT REL

+    SECTION .text

+

+;------------------------------------------------------------------------------

+; UINT64

+; EFIAPI

+; AsmReadTsc (

+;   VOID

+;   );

+;------------------------------------------------------------------------------

+global ASM_PFX(AsmReadTsc)

+ASM_PFX(AsmReadTsc):

+    rdtsc

+    shl     rdx, 0x20

+    or      rax, rdx

+    ret

+

diff --git a/debugging_demo/memtest86+/efi/Include/src/BaseLib/X64/SetJump.nasm b/debugging_demo/memtest86+/efi/Include/src/BaseLib/X64/SetJump.nasm
new file mode 100644
index 0000000..5a68396
--- /dev/null
+++ b/debugging_demo/memtest86+/efi/Include/src/BaseLib/X64/SetJump.nasm
@@ -0,0 +1,81 @@
+;------------------------------------------------------------------------------

+;

+; Copyright (c) 2006 - 2019, Intel Corporation. All rights reserved.<BR>

+; SPDX-License-Identifier: BSD-2-Clause-Patent

+;

+; Module Name:

+;

+;   SetJump.Asm

+;

+; Abstract:

+;

+;   Implementation of SetJump() on x64.

+;

+;------------------------------------------------------------------------------

+

+%include "Nasm.inc"

+

+    DEFAULT REL

+    SECTION .text

+

+extern ASM_PFX(InternalAssertJumpBuffer)

+extern ASM_PFX(PcdGet32 (PcdControlFlowEnforcementPropertyMask))

+

+;------------------------------------------------------------------------------

+; UINTN

+; EFIAPI

+; SetJump (

+;   OUT     BASE_LIBRARY_JUMP_BUFFER  *JumpBuffer

+;   );

+;------------------------------------------------------------------------------

+global ASM_PFX(SetJump)

+ASM_PFX(SetJump):

+    push    rcx

+    add     rsp, -0x20

+    call    ASM_PFX(InternalAssertJumpBuffer)

+    add     rsp, 0x20

+    pop     rcx

+    pop     rdx

+

+    xor     rax, rax

+    mov     [rcx + 0xF8], rax            ; save 0 to SSP

+

+    mov     eax, [ASM_PFX(PcdGet32 (PcdControlFlowEnforcementPropertyMask))]

+    test    eax, eax

+    jz      CetDone

+    mov     rax, cr4

+    bt      eax, 23                      ; check if CET is enabled

+    jnc     CetDone

+

+    mov     rax, 1

+    INCSSP_RAX                           ; to read original SSP

+    READSSP_RAX

+    mov     [rcx + 0xF8], rax            ; save SSP

+

+CetDone:

+

+    mov     [rcx], rbx

+    mov     [rcx + 8], rsp

+    mov     [rcx + 0x10], rbp

+    mov     [rcx + 0x18], rdi

+    mov     [rcx + 0x20], rsi

+    mov     [rcx + 0x28], r12

+    mov     [rcx + 0x30], r13

+    mov     [rcx + 0x38], r14

+    mov     [rcx + 0x40], r15

+    mov     [rcx + 0x48], rdx

+    ; save non-volatile fp registers

+    stmxcsr [rcx + 0x50]

+    movdqu  [rcx + 0x58], xmm6

+    movdqu  [rcx + 0x68], xmm7

+    movdqu  [rcx + 0x78], xmm8

+    movdqu  [rcx + 0x88], xmm9

+    movdqu  [rcx + 0x98], xmm10

+    movdqu  [rcx + 0xA8], xmm11

+    movdqu  [rcx + 0xB8], xmm12

+    movdqu  [rcx + 0xC8], xmm13

+    movdqu  [rcx + 0xD8], xmm14

+    movdqu  [rcx + 0xE8], xmm15

+    xor     rax, rax

+    jmp     rdx

+

diff --git a/debugging_demo/memtest86+/efi/Include/src/BaseLib/X64/SwitchStack.nasm b/debugging_demo/memtest86+/efi/Include/src/BaseLib/X64/SwitchStack.nasm
new file mode 100644
index 0000000..7be666d
--- /dev/null
+++ b/debugging_demo/memtest86+/efi/Include/src/BaseLib/X64/SwitchStack.nasm
@@ -0,0 +1,45 @@
+;------------------------------------------------------------------------------

+;

+; Copyright (c) 2006 - 2008, Intel Corporation. All rights reserved.<BR>

+; SPDX-License-Identifier: BSD-2-Clause-Patent

+;

+; Module Name:

+;

+;   SwitchStack.Asm

+;

+; Abstract:

+;

+;------------------------------------------------------------------------------

+

+    DEFAULT REL

+    SECTION .text

+

+;------------------------------------------------------------------------------

+; Routine Description:

+;

+;   Routine for switching stacks with 2 parameters

+;

+; Arguments:

+;

+;   (rcx) EntryPoint    - Entry point with new stack.

+;   (rdx) Context1      - Parameter1 for entry point.

+;   (r8)  Context2      - Parameter2 for entry point.

+;   (r9)  NewStack      - The pointer to new stack.

+;

+; Returns:

+;

+;   None

+;

+;------------------------------------------------------------------------------

+global ASM_PFX(InternalSwitchStack)

+ASM_PFX(InternalSwitchStack):

+    mov     rax, rcx

+    mov     rcx, rdx

+    mov     rdx, r8

+    ;

+    ; Reserve space for register parameters (rcx, rdx, r8 & r9) on the stack,

+    ; in case the callee wishes to spill them.

+    ;

+    lea     rsp, [r9 - 0x20]

+    call    rax

+

diff --git a/debugging_demo/memtest86+/efi/Include/src/BaseLib/X64/Thunk16.nasm b/debugging_demo/memtest86+/efi/Include/src/BaseLib/X64/Thunk16.nasm
new file mode 100644
index 0000000..e83b31c
--- /dev/null
+++ b/debugging_demo/memtest86+/efi/Include/src/BaseLib/X64/Thunk16.nasm
@@ -0,0 +1,319 @@
+

+#include "BaseLibInternals.h"

+

+;------------------------------------------------------------------------------

+;

+; Copyright (c) 2006 - 2018, Intel Corporation. All rights reserved.<BR>

+; SPDX-License-Identifier: BSD-2-Clause-Patent

+;

+; Module Name:

+;

+;   Thunk.asm

+;

+; Abstract:

+;

+;   Real mode thunk

+;

+;------------------------------------------------------------------------------

+

+global ASM_PFX(m16Size)

+global ASM_PFX(mThunk16Attr)

+global ASM_PFX(m16Gdt)

+global ASM_PFX(m16GdtrBase)

+global ASM_PFX(mTransition)

+global ASM_PFX(m16Start)

+

+struc IA32_REGS

+

+  ._EDI:       resd      1

+  ._ESI:       resd      1

+  ._EBP:       resd      1

+  ._ESP:       resd      1

+  ._EBX:       resd      1

+  ._EDX:       resd      1

+  ._ECX:       resd      1

+  ._EAX:       resd      1

+  ._DS:        resw      1

+  ._ES:        resw      1

+  ._FS:        resw      1

+  ._GS:        resw      1

+  ._EFLAGS:    resq      1

+  ._EIP:       resd      1

+  ._CS:        resw      1

+  ._SS:        resw      1

+  .size:

+

+endstruc

+

+SECTION .data

+

+;

+; These are global constant to convey information to C code.

+;

+ASM_PFX(m16Size)         DW      ASM_PFX(InternalAsmThunk16) - ASM_PFX(m16Start)

+ASM_PFX(mThunk16Attr)    DW      _BackFromUserCode.ThunkAttrEnd - 4 - ASM_PFX(m16Start)

+ASM_PFX(m16Gdt)          DW      _NullSeg - ASM_PFX(m16Start)

+ASM_PFX(m16GdtrBase)     DW      _16GdtrBase - ASM_PFX(m16Start)

+ASM_PFX(mTransition)     DW      _EntryPoint - ASM_PFX(m16Start)

+

+SECTION .text

+

+ASM_PFX(m16Start):

+

+SavedGdt:

+            dw  0

+            dq  0

+

+;------------------------------------------------------------------------------

+; _BackFromUserCode() takes control in real mode after 'retf' has been executed

+; by user code. It will be shadowed to somewhere in memory below 1MB.

+;------------------------------------------------------------------------------

+_BackFromUserCode:

+    ;

+    ; The order of saved registers on the stack matches the order they appears

+    ; in IA32_REGS structure. This facilitates wrapper function to extract them

+    ; into that structure.

+    ;

+BITS    16

+    push    ss

+    push    cs

+    ;

+    ; Note: We can't use o32 on the next instruction because of a bug

+    ; in NASM 2.09.04 through 2.10rc1.

+    ;

+    call    dword .Base                 ; push eip

+.Base:

+    push    dword 0                     ; reserved high order 32 bits of EFlags

+    pushfd

+    cli                                 ; disable interrupts

+    push    gs

+    push    fs

+    push    es

+    push    ds

+    pushad

+    mov     edx, strict dword 0

+.ThunkAttrEnd:

+    test    dl, THUNK_ATTRIBUTE_DISABLE_A20_MASK_INT_15

+    jz      .1

+    mov     ax, 2401h

+    int     15h

+    cli                                 ; disable interrupts

+    jnc     .2

+.1:

+    test    dl, THUNK_ATTRIBUTE_DISABLE_A20_MASK_KBD_CTRL

+    jz      .2

+    in      al, 92h

+    or      al, 2

+    out     92h, al                     ; deactivate A20M#

+.2:

+    xor     eax, eax

+    mov     ax, ss

+    lea     ebp, [esp + IA32_REGS.size]

+    mov     [bp - IA32_REGS.size + IA32_REGS._ESP], ebp

+    mov     ebx, [bp - IA32_REGS.size + IA32_REGS._EIP]

+    shl     eax, 4                      ; shl eax, 4

+    add     ebp, eax                    ; add ebp, eax

+    mov     eax, cs

+    shl     eax, 4

+    lea     eax, [eax + ebx + (.X64JmpEnd - .Base)]

+    mov     [cs:bx + (.X64JmpEnd - 6 - .Base)], eax

+    mov     eax, strict dword 0

+.SavedCr4End:

+    mov     cr4, eax

+o32 lgdt [cs:bx + (SavedGdt - .Base)]

+    mov     ecx, 0c0000080h

+    rdmsr

+    or      ah, 1

+    wrmsr

+    mov     eax, strict dword 0

+.SavedCr0End:

+    mov     cr0, eax

+    jmp     0:strict dword 0

+.X64JmpEnd:

+BITS    64

+    nop

+    mov rsp, strict qword 0

+.SavedSpEnd:

+    nop

+    ret

+

+_EntryPoint:

+        DD      _ToUserCode - ASM_PFX(m16Start)

+        DW      CODE16

+_16Gdtr:

+        DW      GDT_SIZE - 1

+_16GdtrBase:

+        DQ      0

+_16Idtr:

+        DW      (1 << 10) - 1

+        DD      0

+

+;------------------------------------------------------------------------------

+; _ToUserCode() takes control in real mode before passing control to user code.

+; It will be shadowed to somewhere in memory below 1MB.

+;------------------------------------------------------------------------------

+_ToUserCode:

+BITS    16

+    mov     ss, dx                      ; set new segment selectors

+    mov     ds, dx

+    mov     es, dx

+    mov     fs, dx

+    mov     gs, dx

+    mov     ecx, 0c0000080h

+    mov     cr0, eax                    ; real mode starts at next instruction

+    rdmsr

+    and     ah, ~1

+    wrmsr

+    mov     cr4, ebp

+    mov     ss, si                      ; set up 16-bit stack segment

+    mov     esp, ebx                    ; set up 16-bit stack pointer

+    call    dword .Base                 ; push eip

+.Base:

+    pop     ebp                         ; ebp <- address of .Base

+    push    word [dword esp + IA32_REGS.size + 2]

+    lea     ax, [bp + (.RealMode - .Base)]

+    push    ax

+    retf                                ; execution begins at next instruction

+.RealMode:

+

+o32 lidt    [cs:bp + (_16Idtr - .Base)]

+

+    popad

+    pop     ds

+    pop     es

+    pop     fs

+    pop     gs

+    popfd

+    lea     esp, [esp + 4]        ; skip high order 32 bits of EFlags

+

+o32 retf                                ; transfer control to user code

+

+ALIGN   8

+

+CODE16  equ _16Code - $

+DATA16  equ _16Data - $

+DATA32  equ _32Data - $

+

+_NullSeg    DQ      0

+_16Code:

+            DW      -1

+            DW      0

+            DB      0

+            DB      9bh

+            DB      8fh                 ; 16-bit segment, 4GB limit

+            DB      0

+_16Data:

+            DW      -1

+            DW      0

+            DB      0

+            DB      93h

+            DB      8fh                 ; 16-bit segment, 4GB limit

+            DB      0

+_32Data:

+            DW      -1

+            DW      0

+            DB      0

+            DB      93h

+            DB      0cfh                ; 16-bit segment, 4GB limit

+            DB      0

+

+GDT_SIZE equ $ - _NullSeg

+

+;------------------------------------------------------------------------------

+; IA32_REGISTER_SET *

+; EFIAPI

+; InternalAsmThunk16 (

+;   IN      IA32_REGISTER_SET         *RegisterSet,

+;   IN OUT  VOID                      *Transition

+;   );

+;------------------------------------------------------------------------------

+global ASM_PFX(InternalAsmThunk16)

+ASM_PFX(InternalAsmThunk16):

+BITS    64

+    push    rbp

+    push    rbx

+    push    rsi

+    push    rdi

+

+    mov     ebx, ds

+    push    rbx          ; Save ds segment register on the stack

+    mov     ebx, es

+    push    rbx          ; Save es segment register on the stack

+    mov     ebx, ss

+    push    rbx          ; Save ss segment register on the stack

+

+    push    fs

+    push    gs

+    mov     rsi, rcx

+    movzx   r8d, word [rsi + IA32_REGS._SS]

+    mov     edi, [rsi + IA32_REGS._ESP]

+    lea     rdi, [edi - (IA32_REGS.size + 4)]

+    imul    eax, r8d, 16                ; eax <- r8d(stack segment) * 16

+    mov     ebx, edi                    ; ebx <- stack for 16-bit code

+    push    IA32_REGS.size / 4

+    add     edi, eax                    ; edi <- linear address of 16-bit stack

+    pop     rcx

+    rep     movsd                       ; copy RegSet

+    lea     ecx, [rdx + (_BackFromUserCode.SavedCr4End - ASM_PFX(m16Start))]

+    mov     eax, edx                    ; eax <- transition code address

+    and     edx, 0fh

+    shl     eax, 12                     ; segment address in high order 16 bits

+    lea     ax, [rdx + (_BackFromUserCode - ASM_PFX(m16Start))]  ; offset address

+    stosd                               ; [edi] <- return address of user code

+

+    sgdt    [rsp + 60h]       ; save GDT stack in argument space

+    movzx   r10, word [rsp + 60h]   ; r10 <- GDT limit

+    lea     r11, [rcx + (ASM_PFX(InternalAsmThunk16) - _BackFromUserCode.SavedCr4End) + 0xf]

+    and     r11, ~0xf            ; r11 <- 16-byte aligned shadowed GDT table in real mode buffer

+

+    mov     [rcx + (SavedGdt - _BackFromUserCode.SavedCr4End)], r10w      ; save the limit of shadowed GDT table

+    mov     [rcx + (SavedGdt - _BackFromUserCode.SavedCr4End) + 2], r11  ; save the base address of shadowed GDT table

+

+    mov     rsi, [rsp + 62h]  ; rsi <- the original GDT base address

+    xchg    rcx, r10                    ; save rcx to r10 and initialize rcx to be the limit of GDT table

+    inc     rcx                         ; rcx <- the size of memory to copy

+    xchg    rdi, r11                    ; save rdi to r11 and initialize rdi to the base address of shadowed GDT table

+    rep     movsb                       ; perform memory copy to shadow GDT table

+    mov     rcx, r10                    ; restore the orignal rcx before memory copy

+    mov     rdi, r11                    ; restore the original rdi before memory copy

+

+    sidt    [rsp + 50h]       ; save IDT stack in argument space

+    mov     rax, cr0

+    mov     [rcx + (_BackFromUserCode.SavedCr0End - 4 - _BackFromUserCode.SavedCr4End)], eax

+    and     eax, 7ffffffeh              ; clear PE, PG bits

+    mov     rbp, cr4

+    mov     [rcx - 4], ebp              ; save CR4 in _BackFromUserCode.SavedCr4End - 4

+    and     ebp, ~30h                ; clear PAE, PSE bits

+    mov     esi, r8d                    ; esi <- 16-bit stack segment

+    push    DATA32

+    pop     rdx                         ; rdx <- 32-bit data segment selector

+    lgdt    [rcx + (_16Gdtr - _BackFromUserCode.SavedCr4End)]

+    mov     ss, edx

+    pushfq

+    lea     edx, [rdx + DATA16 - DATA32]

+    lea     r8, [REL .RetFromRealMode]

+    push    r8

+    mov     r8d, cs

+    mov     [rcx + (_BackFromUserCode.X64JmpEnd - 2 - _BackFromUserCode.SavedCr4End)], r8w

+    mov     [rcx + (_BackFromUserCode.SavedSpEnd - 8 - _BackFromUserCode.SavedCr4End)], rsp

+    jmp     dword far [rcx + (_EntryPoint - _BackFromUserCode.SavedCr4End)]

+.RetFromRealMode:

+    popfq

+    lgdt    [rsp + 60h]       ; restore protected mode GDTR

+    lidt    [rsp + 50h]       ; restore protected mode IDTR

+    lea     eax, [rbp - IA32_REGS.size]

+    pop     gs

+    pop     fs

+    pop     rbx

+    mov     ss, ebx

+    pop     rbx

+    mov     es, ebx

+    pop     rbx

+    mov     ds, ebx

+

+    pop     rdi

+    pop     rsi

+    pop     rbx

+    pop     rbp

+

+    ret

diff --git a/debugging_demo/memtest86+/efi/Include/src/BaseLib/X64/VmgExit.nasm b/debugging_demo/memtest86+/efi/Include/src/BaseLib/X64/VmgExit.nasm
new file mode 100644
index 0000000..26f0345
--- /dev/null
+++ b/debugging_demo/memtest86+/efi/Include/src/BaseLib/X64/VmgExit.nasm
@@ -0,0 +1,32 @@
+;------------------------------------------------------------------------------

+;

+; Copyright (C) 2020, Advanced Micro Devices, Inc. All rights reserved.<BR>

+; SPDX-License-Identifier: BSD-2-Clause-Patent

+;

+; Module Name:

+;

+;   VmgExit.Asm

+;

+; Abstract:

+;

+;   AsmVmgExit function

+;

+; Notes:

+;

+;------------------------------------------------------------------------------

+

+    DEFAULT REL

+    SECTION .text

+

+;------------------------------------------------------------------------------

+; VOID

+; EFIAPI

+; AsmVmgExit (

+;   VOID

+;   );

+;------------------------------------------------------------------------------

+global ASM_PFX(AsmVmgExit)

+ASM_PFX(AsmVmgExit):

+    rep     vmmcall

+    ret

+

diff --git a/debugging_demo/memtest86+/efi/Include/src/BaseLib/X64/Wbinvd.nasm b/debugging_demo/memtest86+/efi/Include/src/BaseLib/X64/Wbinvd.nasm
new file mode 100644
index 0000000..90427fe
--- /dev/null
+++ b/debugging_demo/memtest86+/efi/Include/src/BaseLib/X64/Wbinvd.nasm
@@ -0,0 +1,32 @@
+;------------------------------------------------------------------------------

+;

+; Copyright (c) 2006, Intel Corporation. All rights reserved.<BR>

+; SPDX-License-Identifier: BSD-2-Clause-Patent

+;

+; Module Name:

+;

+;   Wbinvd.Asm

+;

+; Abstract:

+;

+;   AsmWbinvd function

+;

+; Notes:

+;

+;------------------------------------------------------------------------------

+

+    DEFAULT REL

+    SECTION .text

+

+;------------------------------------------------------------------------------

+; VOID

+; EFIAPI

+; AsmWbinvd (

+;   VOID

+;   );

+;------------------------------------------------------------------------------

+global ASM_PFX(AsmWbinvd)

+ASM_PFX(AsmWbinvd):

+    wbinvd

+    ret

+

diff --git a/debugging_demo/memtest86+/efi/Include/src/BaseLib/X64/WriteCr0.nasm b/debugging_demo/memtest86+/efi/Include/src/BaseLib/X64/WriteCr0.nasm
new file mode 100644
index 0000000..d351396
--- /dev/null
+++ b/debugging_demo/memtest86+/efi/Include/src/BaseLib/X64/WriteCr0.nasm
@@ -0,0 +1,33 @@
+;------------------------------------------------------------------------------

+;

+; Copyright (c) 2006, Intel Corporation. All rights reserved.<BR>

+; SPDX-License-Identifier: BSD-2-Clause-Patent

+;

+; Module Name:

+;

+;   WriteCr0.Asm

+;

+; Abstract:

+;

+;   AsmWriteCr0 function

+;

+; Notes:

+;

+;------------------------------------------------------------------------------

+

+    DEFAULT REL

+    SECTION .text

+

+;------------------------------------------------------------------------------

+; UINTN

+; EFIAPI

+; AsmWriteCr0 (

+;   UINTN  Cr0

+;   );

+;------------------------------------------------------------------------------

+global ASM_PFX(AsmWriteCr0)

+ASM_PFX(AsmWriteCr0):

+    mov     cr0, rcx

+    mov     rax, rcx

+    ret

+

diff --git a/debugging_demo/memtest86+/efi/Include/src/BaseLib/X64/WriteCr2.nasm b/debugging_demo/memtest86+/efi/Include/src/BaseLib/X64/WriteCr2.nasm
new file mode 100644
index 0000000..2b6bce0
--- /dev/null
+++ b/debugging_demo/memtest86+/efi/Include/src/BaseLib/X64/WriteCr2.nasm
@@ -0,0 +1,33 @@
+;------------------------------------------------------------------------------

+;

+; Copyright (c) 2006, Intel Corporation. All rights reserved.<BR>

+; SPDX-License-Identifier: BSD-2-Clause-Patent

+;

+; Module Name:

+;

+;   WriteCr2.Asm

+;

+; Abstract:

+;

+;   AsmWriteCr2 function

+;

+; Notes:

+;

+;------------------------------------------------------------------------------

+

+    DEFAULT REL

+    SECTION .text

+

+;------------------------------------------------------------------------------

+; UINTN

+; EFIAPI

+; AsmWriteCr2 (

+;   UINTN  Cr2

+;   );

+;------------------------------------------------------------------------------

+global ASM_PFX(AsmWriteCr2)

+ASM_PFX(AsmWriteCr2):

+    mov     cr2, rcx

+    mov     rax, rcx

+    ret

+

diff --git a/debugging_demo/memtest86+/efi/Include/src/BaseLib/X64/WriteCr3.nasm b/debugging_demo/memtest86+/efi/Include/src/BaseLib/X64/WriteCr3.nasm
new file mode 100644
index 0000000..fb0b5ba
--- /dev/null
+++ b/debugging_demo/memtest86+/efi/Include/src/BaseLib/X64/WriteCr3.nasm
@@ -0,0 +1,33 @@
+;------------------------------------------------------------------------------

+;

+; Copyright (c) 2006, Intel Corporation. All rights reserved.<BR>

+; SPDX-License-Identifier: BSD-2-Clause-Patent

+;

+; Module Name:

+;

+;   WriteCr3.Asm

+;

+; Abstract:

+;

+;   AsmWriteCr3 function

+;

+; Notes:

+;

+;------------------------------------------------------------------------------

+

+    DEFAULT REL

+    SECTION .text

+

+;------------------------------------------------------------------------------

+; UINTN

+; EFIAPI

+; AsmWriteCr3 (

+;   UINTN  Cr3

+;   );

+;------------------------------------------------------------------------------

+global ASM_PFX(AsmWriteCr3)

+ASM_PFX(AsmWriteCr3):

+    mov     cr3, rcx

+    mov     rax, rcx

+    ret

+

diff --git a/debugging_demo/memtest86+/efi/Include/src/BaseLib/X64/WriteCr4.nasm b/debugging_demo/memtest86+/efi/Include/src/BaseLib/X64/WriteCr4.nasm
new file mode 100644
index 0000000..483a996
--- /dev/null
+++ b/debugging_demo/memtest86+/efi/Include/src/BaseLib/X64/WriteCr4.nasm
@@ -0,0 +1,33 @@
+;------------------------------------------------------------------------------

+;

+; Copyright (c) 2006, Intel Corporation. All rights reserved.<BR>

+; SPDX-License-Identifier: BSD-2-Clause-Patent

+;

+; Module Name:

+;

+;   WriteCr4.Asm

+;

+; Abstract:

+;

+;   AsmWriteCr4 function

+;

+; Notes:

+;

+;------------------------------------------------------------------------------

+

+    DEFAULT REL

+    SECTION .text

+

+;------------------------------------------------------------------------------

+; UINTN

+; EFIAPI

+; AsmWriteCr4 (

+;   UINTN  Cr4

+;   );

+;------------------------------------------------------------------------------

+global ASM_PFX(AsmWriteCr4)

+ASM_PFX(AsmWriteCr4):

+    mov     cr4, rcx

+    mov     rax, rcx

+    ret

+

diff --git a/debugging_demo/memtest86+/efi/Include/src/BaseLib/X64/WriteDr0.nasm b/debugging_demo/memtest86+/efi/Include/src/BaseLib/X64/WriteDr0.nasm
new file mode 100644
index 0000000..3c88154
--- /dev/null
+++ b/debugging_demo/memtest86+/efi/Include/src/BaseLib/X64/WriteDr0.nasm
@@ -0,0 +1,33 @@
+;------------------------------------------------------------------------------

+;

+; Copyright (c) 2006, Intel Corporation. All rights reserved.<BR>

+; SPDX-License-Identifier: BSD-2-Clause-Patent

+;

+; Module Name:

+;

+;   WriteDr0.Asm

+;

+; Abstract:

+;

+;   AsmWriteDr0 function

+;

+; Notes:

+;

+;------------------------------------------------------------------------------

+

+    DEFAULT REL

+    SECTION .text

+

+;------------------------------------------------------------------------------

+; UINTN

+; EFIAPI

+; AsmWriteDr0 (

+;   IN UINTN Value

+;   );

+;------------------------------------------------------------------------------

+global ASM_PFX(AsmWriteDr0)

+ASM_PFX(AsmWriteDr0):

+    mov     dr0, rcx

+    mov     rax, rcx

+    ret

+

diff --git a/debugging_demo/memtest86+/efi/Include/src/BaseLib/X64/WriteDr1.nasm b/debugging_demo/memtest86+/efi/Include/src/BaseLib/X64/WriteDr1.nasm
new file mode 100644
index 0000000..6fcbbfc
--- /dev/null
+++ b/debugging_demo/memtest86+/efi/Include/src/BaseLib/X64/WriteDr1.nasm
@@ -0,0 +1,33 @@
+;------------------------------------------------------------------------------

+;

+; Copyright (c) 2006, Intel Corporation. All rights reserved.<BR>

+; SPDX-License-Identifier: BSD-2-Clause-Patent

+;

+; Module Name:

+;

+;   WriteDr1.Asm

+;

+; Abstract:

+;

+;   AsmWriteDr1 function

+;

+; Notes:

+;

+;------------------------------------------------------------------------------

+

+    DEFAULT REL

+    SECTION .text

+

+;------------------------------------------------------------------------------

+; UINTN

+; EFIAPI

+; AsmWriteDr1 (

+;   IN UINTN Value

+;   );

+;------------------------------------------------------------------------------

+global ASM_PFX(AsmWriteDr1)

+ASM_PFX(AsmWriteDr1):

+    mov     dr1, rcx

+    mov     rax, rcx

+    ret

+

diff --git a/debugging_demo/memtest86+/efi/Include/src/BaseLib/X64/WriteDr2.nasm b/debugging_demo/memtest86+/efi/Include/src/BaseLib/X64/WriteDr2.nasm
new file mode 100644
index 0000000..a8e0bfc
--- /dev/null
+++ b/debugging_demo/memtest86+/efi/Include/src/BaseLib/X64/WriteDr2.nasm
@@ -0,0 +1,33 @@
+;------------------------------------------------------------------------------

+;

+; Copyright (c) 2006, Intel Corporation. All rights reserved.<BR>

+; SPDX-License-Identifier: BSD-2-Clause-Patent

+;

+; Module Name:

+;

+;   WriteDr2.Asm

+;

+; Abstract:

+;

+;   AsmWriteDr2 function

+;

+; Notes:

+;

+;------------------------------------------------------------------------------

+

+    DEFAULT REL

+    SECTION .text

+

+;------------------------------------------------------------------------------

+; UINTN

+; EFIAPI

+; AsmWriteDr2 (

+;   IN UINTN Value

+;   );

+;------------------------------------------------------------------------------

+global ASM_PFX(AsmWriteDr2)

+ASM_PFX(AsmWriteDr2):

+    mov     dr2, rcx

+    mov     rax, rcx

+    ret

+

diff --git a/debugging_demo/memtest86+/efi/Include/src/BaseLib/X64/WriteDr3.nasm b/debugging_demo/memtest86+/efi/Include/src/BaseLib/X64/WriteDr3.nasm
new file mode 100644
index 0000000..ac46ab8
--- /dev/null
+++ b/debugging_demo/memtest86+/efi/Include/src/BaseLib/X64/WriteDr3.nasm
@@ -0,0 +1,33 @@
+;------------------------------------------------------------------------------

+;

+; Copyright (c) 2006, Intel Corporation. All rights reserved.<BR>

+; SPDX-License-Identifier: BSD-2-Clause-Patent

+;

+; Module Name:

+;

+;   WriteDr3.Asm

+;

+; Abstract:

+;

+;   AsmWriteDr3 function

+;

+; Notes:

+;

+;------------------------------------------------------------------------------

+

+    DEFAULT REL

+    SECTION .text

+

+;------------------------------------------------------------------------------

+; UINTN

+; EFIAPI

+; AsmWriteDr3 (

+;   IN UINTN Value

+;   );

+;------------------------------------------------------------------------------

+global ASM_PFX(AsmWriteDr3)

+ASM_PFX(AsmWriteDr3):

+    mov     dr3, rcx

+    mov     rax, rcx

+    ret

+

diff --git a/debugging_demo/memtest86+/efi/Include/src/BaseLib/X64/WriteDr4.nasm b/debugging_demo/memtest86+/efi/Include/src/BaseLib/X64/WriteDr4.nasm
new file mode 100644
index 0000000..c4b12c9
--- /dev/null
+++ b/debugging_demo/memtest86+/efi/Include/src/BaseLib/X64/WriteDr4.nasm
@@ -0,0 +1,37 @@
+;------------------------------------------------------------------------------

+;

+; Copyright (c) 2006, Intel Corporation. All rights reserved.<BR>

+; SPDX-License-Identifier: BSD-2-Clause-Patent

+;

+; Module Name:

+;

+;   WriteDr4.Asm

+;

+; Abstract:

+;

+;   AsmWriteDr4 function

+;

+; Notes:

+;

+;------------------------------------------------------------------------------

+

+    DEFAULT REL

+    SECTION .text

+

+;------------------------------------------------------------------------------

+; UINTN

+; EFIAPI

+; AsmWriteDr4 (

+;   IN UINTN Value

+;   );

+;------------------------------------------------------------------------------

+global ASM_PFX(AsmWriteDr4)

+ASM_PFX(AsmWriteDr4):

+    ;

+    ; There's no obvious reason to access this register, since it's aliased to

+    ; DR6 when DE=0 or an exception generated when DE=1

+    ;

+    DB      0xf, 0x23, 0xe1

+    mov     rax, rcx

+    ret

+

diff --git a/debugging_demo/memtest86+/efi/Include/src/BaseLib/X64/WriteDr5.nasm b/debugging_demo/memtest86+/efi/Include/src/BaseLib/X64/WriteDr5.nasm
new file mode 100644
index 0000000..986a4a9
--- /dev/null
+++ b/debugging_demo/memtest86+/efi/Include/src/BaseLib/X64/WriteDr5.nasm
@@ -0,0 +1,37 @@
+;------------------------------------------------------------------------------

+;

+; Copyright (c) 2006 - 2008, Intel Corporation. All rights reserved.<BR>

+; SPDX-License-Identifier: BSD-2-Clause-Patent

+;

+; Module Name:

+;

+;   WriteDr5.Asm

+;

+; Abstract:

+;

+;   AsmWriteDr5 function

+;

+; Notes:

+;

+;------------------------------------------------------------------------------

+

+    DEFAULT REL

+    SECTION .text

+

+;------------------------------------------------------------------------------

+; UINTN

+; EFIAPI

+; AsmWriteDr5 (

+;   IN UINTN Value

+;   );

+;------------------------------------------------------------------------------

+global ASM_PFX(AsmWriteDr5)

+ASM_PFX(AsmWriteDr5):

+    ;

+    ; There's no obvious reason to access this register, since it's aliased to

+    ; DR7 when DE=0 or an exception generated when DE=1

+    ;

+    DB      0xf, 0x23, 0xe9

+    mov     rax, rcx

+    ret

+

diff --git a/debugging_demo/memtest86+/efi/Include/src/BaseLib/X64/WriteDr6.nasm b/debugging_demo/memtest86+/efi/Include/src/BaseLib/X64/WriteDr6.nasm
new file mode 100644
index 0000000..196993d
--- /dev/null
+++ b/debugging_demo/memtest86+/efi/Include/src/BaseLib/X64/WriteDr6.nasm
@@ -0,0 +1,33 @@
+;------------------------------------------------------------------------------

+;

+; Copyright (c) 2006, Intel Corporation. All rights reserved.<BR>

+; SPDX-License-Identifier: BSD-2-Clause-Patent

+;

+; Module Name:

+;

+;   WriteDr6.Asm

+;

+; Abstract:

+;

+;   AsmWriteDr6 function

+;

+; Notes:

+;

+;------------------------------------------------------------------------------

+

+    DEFAULT REL

+    SECTION .text

+

+;------------------------------------------------------------------------------

+; UINTN

+; EFIAPI

+; AsmWriteDr6 (

+;   IN UINTN Value

+;   );

+;------------------------------------------------------------------------------

+global ASM_PFX(AsmWriteDr6)

+ASM_PFX(AsmWriteDr6):

+    mov     dr6, rcx

+    mov     rax, rcx

+    ret

+

diff --git a/debugging_demo/memtest86+/efi/Include/src/BaseLib/X64/WriteDr7.nasm b/debugging_demo/memtest86+/efi/Include/src/BaseLib/X64/WriteDr7.nasm
new file mode 100644
index 0000000..1b3c181
--- /dev/null
+++ b/debugging_demo/memtest86+/efi/Include/src/BaseLib/X64/WriteDr7.nasm
@@ -0,0 +1,33 @@
+;------------------------------------------------------------------------------

+;

+; Copyright (c) 2006, Intel Corporation. All rights reserved.<BR>

+; SPDX-License-Identifier: BSD-2-Clause-Patent

+;

+; Module Name:

+;

+;   WriteDr7.Asm

+;

+; Abstract:

+;

+;   AsmWriteDr7 function

+;

+; Notes:

+;

+;------------------------------------------------------------------------------

+

+    DEFAULT REL

+    SECTION .text

+

+;------------------------------------------------------------------------------

+; UINTN

+; EFIAPI

+; AsmWriteDr7 (

+;   IN UINTN Value

+;   );

+;------------------------------------------------------------------------------

+global ASM_PFX(AsmWriteDr7)

+ASM_PFX(AsmWriteDr7):

+    mov     dr7, rcx

+    mov     rax, rcx

+    ret

+

diff --git a/debugging_demo/memtest86+/efi/Include/src/BaseLib/X64/WriteGdtr.nasm b/debugging_demo/memtest86+/efi/Include/src/BaseLib/X64/WriteGdtr.nasm
new file mode 100644
index 0000000..0a26ba0
--- /dev/null
+++ b/debugging_demo/memtest86+/efi/Include/src/BaseLib/X64/WriteGdtr.nasm
@@ -0,0 +1,32 @@
+;------------------------------------------------------------------------------

+;

+; Copyright (c) 2006, Intel Corporation. All rights reserved.<BR>

+; SPDX-License-Identifier: BSD-2-Clause-Patent

+;

+; Module Name:

+;

+;   WriteGdtr.Asm

+;

+; Abstract:

+;

+;   AsmWriteGdtr function

+;

+; Notes:

+;

+;------------------------------------------------------------------------------

+

+    DEFAULT REL

+    SECTION .text

+

+;------------------------------------------------------------------------------

+; VOID

+; EFIAPI

+; InternalX86WriteGdtr (

+;   IN      CONST IA32_DESCRIPTOR     *Idtr

+;   );

+;------------------------------------------------------------------------------

+global ASM_PFX(InternalX86WriteGdtr)

+ASM_PFX(InternalX86WriteGdtr):

+    lgdt    [rcx]

+    ret

+

diff --git a/debugging_demo/memtest86+/efi/Include/src/BaseLib/X64/WriteIdtr.nasm b/debugging_demo/memtest86+/efi/Include/src/BaseLib/X64/WriteIdtr.nasm
new file mode 100644
index 0000000..c6155c0
--- /dev/null
+++ b/debugging_demo/memtest86+/efi/Include/src/BaseLib/X64/WriteIdtr.nasm
@@ -0,0 +1,35 @@
+;------------------------------------------------------------------------------

+;

+; Copyright (c) 2006 - 2010, Intel Corporation. All rights reserved.<BR>

+; SPDX-License-Identifier: BSD-2-Clause-Patent

+;

+; Module Name:

+;

+;   WriteIdtr.Asm

+;

+; Abstract:

+;

+;   AsmWriteIdtr function

+;

+; Notes:

+;

+;------------------------------------------------------------------------------

+

+    DEFAULT REL

+    SECTION .text

+

+;------------------------------------------------------------------------------

+; VOID

+; EFIAPI

+; InternalX86WriteIdtr (

+;   IN      CONST IA32_DESCRIPTOR     *Idtr

+;   );

+;------------------------------------------------------------------------------

+global ASM_PFX(InternalX86WriteIdtr)

+ASM_PFX(InternalX86WriteIdtr):

+    pushfq

+    cli

+    lidt    [rcx]

+    popfq

+    ret

+

diff --git a/debugging_demo/memtest86+/efi/Include/src/BaseLib/X64/WriteLdtr.nasm b/debugging_demo/memtest86+/efi/Include/src/BaseLib/X64/WriteLdtr.nasm
new file mode 100644
index 0000000..55881db
--- /dev/null
+++ b/debugging_demo/memtest86+/efi/Include/src/BaseLib/X64/WriteLdtr.nasm
@@ -0,0 +1,32 @@
+;------------------------------------------------------------------------------

+;

+; Copyright (c) 2006, Intel Corporation. All rights reserved.<BR>

+; SPDX-License-Identifier: BSD-2-Clause-Patent

+;

+; Module Name:

+;

+;   WriteLdtr.Asm

+;

+; Abstract:

+;

+;   AsmWriteLdtr function

+;

+; Notes:

+;

+;------------------------------------------------------------------------------

+

+    DEFAULT REL

+    SECTION .text

+

+;------------------------------------------------------------------------------

+; VOID

+; EFIAPI

+; AsmWriteLdtr (

+;   IN UINT16 Ldtr

+;   );

+;------------------------------------------------------------------------------

+global ASM_PFX(AsmWriteLdtr)

+ASM_PFX(AsmWriteLdtr):

+    lldt    cx

+    ret

+

diff --git a/debugging_demo/memtest86+/efi/Include/src/BaseLib/X64/WriteMm0.nasm b/debugging_demo/memtest86+/efi/Include/src/BaseLib/X64/WriteMm0.nasm
new file mode 100644
index 0000000..3f03529
--- /dev/null
+++ b/debugging_demo/memtest86+/efi/Include/src/BaseLib/X64/WriteMm0.nasm
@@ -0,0 +1,35 @@
+;------------------------------------------------------------------------------

+;

+; Copyright (c) 2006, Intel Corporation. All rights reserved.<BR>

+; SPDX-License-Identifier: BSD-2-Clause-Patent

+;

+; Module Name:

+;

+;   WriteMm0.Asm

+;

+; Abstract:

+;

+;   AsmWriteMm0 function

+;

+; Notes:

+;

+;------------------------------------------------------------------------------

+

+    DEFAULT REL

+    SECTION .text

+

+;------------------------------------------------------------------------------

+; VOID

+; EFIAPI

+; AsmWriteMm0 (

+;   IN UINT64   Value

+;   );

+;------------------------------------------------------------------------------

+global ASM_PFX(AsmWriteMm0)

+ASM_PFX(AsmWriteMm0):

+    ;

+    ; 64-bit MASM doesn't support MMX instructions, so use opcode here

+    ;

+    DB      0x48, 0xf, 0x6e, 0xc1

+    ret

+

diff --git a/debugging_demo/memtest86+/efi/Include/src/BaseLib/X64/WriteMm1.nasm b/debugging_demo/memtest86+/efi/Include/src/BaseLib/X64/WriteMm1.nasm
new file mode 100644
index 0000000..f552d40
--- /dev/null
+++ b/debugging_demo/memtest86+/efi/Include/src/BaseLib/X64/WriteMm1.nasm
@@ -0,0 +1,35 @@
+;------------------------------------------------------------------------------

+;

+; Copyright (c) 2006, Intel Corporation. All rights reserved.<BR>

+; SPDX-License-Identifier: BSD-2-Clause-Patent

+;

+; Module Name:

+;

+;   WriteMm1.Asm

+;

+; Abstract:

+;

+;   AsmWriteMm1 function

+;

+; Notes:

+;

+;------------------------------------------------------------------------------

+

+    DEFAULT REL

+    SECTION .text

+

+;------------------------------------------------------------------------------

+; VOID

+; EFIAPI

+; AsmWriteMm1 (

+;   IN UINT64   Value

+;   );

+;------------------------------------------------------------------------------

+global ASM_PFX(AsmWriteMm1)

+ASM_PFX(AsmWriteMm1):

+    ;

+    ; 64-bit MASM doesn't support MMX instructions, so use opcode here

+    ;

+    DB      0x48, 0xf, 0x6e, 0xc9

+    ret

+

diff --git a/debugging_demo/memtest86+/efi/Include/src/BaseLib/X64/WriteMm2.nasm b/debugging_demo/memtest86+/efi/Include/src/BaseLib/X64/WriteMm2.nasm
new file mode 100644
index 0000000..1bd176c
--- /dev/null
+++ b/debugging_demo/memtest86+/efi/Include/src/BaseLib/X64/WriteMm2.nasm
@@ -0,0 +1,35 @@
+;------------------------------------------------------------------------------

+;

+; Copyright (c) 2006, Intel Corporation. All rights reserved.<BR>

+; SPDX-License-Identifier: BSD-2-Clause-Patent

+;

+; Module Name:

+;

+;   WriteMm2.Asm

+;

+; Abstract:

+;

+;   AsmWriteMm2 function

+;

+; Notes:

+;

+;------------------------------------------------------------------------------

+

+    DEFAULT REL

+    SECTION .text

+

+;------------------------------------------------------------------------------

+; VOID

+; EFIAPI

+; AsmWriteMm2 (

+;   IN UINT64   Value

+;   );

+;------------------------------------------------------------------------------

+global ASM_PFX(AsmWriteMm2)

+ASM_PFX(AsmWriteMm2):

+    ;

+    ; 64-bit MASM doesn't support MMX instructions, so use opcode here

+    ;

+    DB      0x48, 0xf, 0x6e, 0xd1

+    ret

+

diff --git a/debugging_demo/memtest86+/efi/Include/src/BaseLib/X64/WriteMm3.nasm b/debugging_demo/memtest86+/efi/Include/src/BaseLib/X64/WriteMm3.nasm
new file mode 100644
index 0000000..403f140
--- /dev/null
+++ b/debugging_demo/memtest86+/efi/Include/src/BaseLib/X64/WriteMm3.nasm
@@ -0,0 +1,35 @@
+;------------------------------------------------------------------------------

+;

+; Copyright (c) 2006, Intel Corporation. All rights reserved.<BR>

+; SPDX-License-Identifier: BSD-2-Clause-Patent

+;

+; Module Name:

+;

+;   WriteMm3.Asm

+;

+; Abstract:

+;

+;   AsmWriteMm3 function

+;

+; Notes:

+;

+;------------------------------------------------------------------------------

+

+    DEFAULT REL

+    SECTION .text

+

+;------------------------------------------------------------------------------

+; VOID

+; EFIAPI

+; AsmWriteMm3 (

+;   IN UINT64   Value

+;   );

+;------------------------------------------------------------------------------

+global ASM_PFX(AsmWriteMm3)

+ASM_PFX(AsmWriteMm3):

+    ;

+    ; 64-bit MASM doesn't support MMX instructions, so use opcode here

+    ;

+    DB      0x48, 0xf, 0x6e, 0xd9

+    ret

+

diff --git a/debugging_demo/memtest86+/efi/Include/src/BaseLib/X64/WriteMm4.nasm b/debugging_demo/memtest86+/efi/Include/src/BaseLib/X64/WriteMm4.nasm
new file mode 100644
index 0000000..d99709d
--- /dev/null
+++ b/debugging_demo/memtest86+/efi/Include/src/BaseLib/X64/WriteMm4.nasm
@@ -0,0 +1,35 @@
+;------------------------------------------------------------------------------

+;

+; Copyright (c) 2006, Intel Corporation. All rights reserved.<BR>

+; SPDX-License-Identifier: BSD-2-Clause-Patent

+;

+; Module Name:

+;

+;   WriteMm4.Asm

+;

+; Abstract:

+;

+;   AsmWriteMm4 function

+;

+; Notes:

+;

+;------------------------------------------------------------------------------

+

+    DEFAULT REL

+    SECTION .text

+

+;------------------------------------------------------------------------------

+; VOID

+; EFIAPI

+; AsmWriteMm4 (

+;   IN UINT64   Value

+;   );

+;------------------------------------------------------------------------------

+global ASM_PFX(AsmWriteMm4)

+ASM_PFX(AsmWriteMm4):

+    ;

+    ; 64-bit MASM doesn't support MMX instructions, so use opcode here

+    ;

+    DB      0x48, 0xf, 0x6e, 0xe1

+    ret

+

diff --git a/debugging_demo/memtest86+/efi/Include/src/BaseLib/X64/WriteMm5.nasm b/debugging_demo/memtest86+/efi/Include/src/BaseLib/X64/WriteMm5.nasm
new file mode 100644
index 0000000..0467ac4
--- /dev/null
+++ b/debugging_demo/memtest86+/efi/Include/src/BaseLib/X64/WriteMm5.nasm
@@ -0,0 +1,35 @@
+;------------------------------------------------------------------------------

+;

+; Copyright (c) 2006, Intel Corporation. All rights reserved.<BR>

+; SPDX-License-Identifier: BSD-2-Clause-Patent

+;

+; Module Name:

+;

+;   WriteMm5.Asm

+;

+; Abstract:

+;

+;   AsmWriteMm5 function

+;

+; Notes:

+;

+;------------------------------------------------------------------------------

+

+    DEFAULT REL

+    SECTION .text

+

+;------------------------------------------------------------------------------

+; VOID

+; EFIAPI

+; AsmWriteMm5 (

+;   IN UINT64   Value

+;   );

+;------------------------------------------------------------------------------

+global ASM_PFX(AsmWriteMm5)

+ASM_PFX(AsmWriteMm5):

+    ;

+    ; 64-bit MASM doesn't support MMX instructions, so use opcode here

+    ;

+    DB      0x48, 0xf, 0x6e, 0xe9

+    ret

+

diff --git a/debugging_demo/memtest86+/efi/Include/src/BaseLib/X64/WriteMm6.nasm b/debugging_demo/memtest86+/efi/Include/src/BaseLib/X64/WriteMm6.nasm
new file mode 100644
index 0000000..6d2e5eb
--- /dev/null
+++ b/debugging_demo/memtest86+/efi/Include/src/BaseLib/X64/WriteMm6.nasm
@@ -0,0 +1,35 @@
+;------------------------------------------------------------------------------

+;

+; Copyright (c) 2006, Intel Corporation. All rights reserved.<BR>

+; SPDX-License-Identifier: BSD-2-Clause-Patent

+;

+; Module Name:

+;

+;   WriteMm6.Asm

+;

+; Abstract:

+;

+;   AsmWriteMm6 function

+;

+; Notes:

+;

+;------------------------------------------------------------------------------

+

+    DEFAULT REL

+    SECTION .text

+

+;------------------------------------------------------------------------------

+; VOID

+; EFIAPI

+; AsmWriteMm6 (

+;   IN UINT64   Value

+;   );

+;------------------------------------------------------------------------------

+global ASM_PFX(AsmWriteMm6)

+ASM_PFX(AsmWriteMm6):

+    ;

+    ; 64-bit MASM doesn't support MMX instructions, so use opcode here

+    ;

+    DB      0x48, 0xf, 0x6e, 0xf1

+    ret

+

diff --git a/debugging_demo/memtest86+/efi/Include/src/BaseLib/X64/WriteMm7.nasm b/debugging_demo/memtest86+/efi/Include/src/BaseLib/X64/WriteMm7.nasm
new file mode 100644
index 0000000..de72adf
--- /dev/null
+++ b/debugging_demo/memtest86+/efi/Include/src/BaseLib/X64/WriteMm7.nasm
@@ -0,0 +1,35 @@
+;------------------------------------------------------------------------------

+;

+; Copyright (c) 2006, Intel Corporation. All rights reserved.<BR>

+; SPDX-License-Identifier: BSD-2-Clause-Patent

+;

+; Module Name:

+;

+;   WriteMm7.Asm

+;

+; Abstract:

+;

+;   AsmWriteMm7 function

+;

+; Notes:

+;

+;------------------------------------------------------------------------------

+

+    DEFAULT REL

+    SECTION .text

+

+;------------------------------------------------------------------------------

+; VOID

+; EFIAPI

+; AsmWriteMm7 (

+;   IN UINT64   Value

+;   );

+;------------------------------------------------------------------------------

+global ASM_PFX(AsmWriteMm7)

+ASM_PFX(AsmWriteMm7):

+    ;

+    ; 64-bit MASM doesn't support MMX instructions, so use opcode here

+    ;

+    DB      0x48, 0xf, 0x6e, 0xf9

+    ret

+

diff --git a/debugging_demo/memtest86+/efi/Include/src/BaseLib/X64/WriteMsr64.c b/debugging_demo/memtest86+/efi/Include/src/BaseLib/X64/WriteMsr64.c
new file mode 100644
index 0000000..98c5458
--- /dev/null
+++ b/debugging_demo/memtest86+/efi/Include/src/BaseLib/X64/WriteMsr64.c
@@ -0,0 +1,36 @@
+/** @file

+  CpuBreakpoint function.

+

+  Copyright (c) 2006 - 2010, Intel Corporation. All rights reserved.<BR>

+  SPDX-License-Identifier: BSD-2-Clause-Patent

+

+**/

+

+/**

+  Microsoft Visual Studio 7.1 Function Prototypes for I/O Intrinsics.

+**/

+

+void __writemsr (unsigned long Register, unsigned __int64 Value);

+

+#pragma intrinsic(__writemsr)

+

+/**

+  Write data to MSR.

+

+  @param  Index                The register index of MSR.

+  @param  Value                Data wants to be written.

+

+  @return Value written to MSR.

+

+**/

+UINT64

+EFIAPI

+AsmWriteMsr64 (

+  IN UINT32  Index,

+  IN UINT64  Value

+  )

+{

+  __writemsr (Index, Value);

+  return Value;

+}

+

diff --git a/debugging_demo/memtest86+/efi/Include/src/BaseLib/X64/WriteMsr64.nasm b/debugging_demo/memtest86+/efi/Include/src/BaseLib/X64/WriteMsr64.nasm
new file mode 100644
index 0000000..11224d3
--- /dev/null
+++ b/debugging_demo/memtest86+/efi/Include/src/BaseLib/X64/WriteMsr64.nasm
@@ -0,0 +1,35 @@
+;------------------------------------------------------------------------------

+;

+; Copyright (c) 2006, Intel Corporation. All rights reserved.<BR>

+; SPDX-License-Identifier: BSD-2-Clause-Patent

+;

+; Module Name:

+;

+;   WriteMsr64.Asm

+;

+; Abstract:

+;

+;   AsmWriteMsr64 function

+;

+; Notes:

+;

+;------------------------------------------------------------------------------

+

+    DEFAULT REL

+    SECTION .text

+

+;------------------------------------------------------------------------------

+; UINT64

+; EFIAPI

+; AsmWriteMsr64 (

+;   IN UINT32  Index,

+;   IN UINT64  Value

+;   );

+;------------------------------------------------------------------------------

+global ASM_PFX(AsmWriteMsr64)

+ASM_PFX(AsmWriteMsr64):

+    mov     rax, rdx                    ; meanwhile, rax <- return value

+    shr     rdx, 0x20                    ; edx:eax contains the value to write

+    wrmsr

+    ret

+

diff --git a/debugging_demo/memtest86+/efi/Include/src/BaseLib/X64/WriteTr.nasm b/debugging_demo/memtest86+/efi/Include/src/BaseLib/X64/WriteTr.nasm
new file mode 100644
index 0000000..4e364bc
--- /dev/null
+++ b/debugging_demo/memtest86+/efi/Include/src/BaseLib/X64/WriteTr.nasm
@@ -0,0 +1,31 @@
+;------------------------------------------------------------------------------ ;

+; Copyright (c) 2017, Intel Corporation. All rights reserved.<BR>

+; SPDX-License-Identifier: BSD-2-Clause-Patent

+;

+; Module Name:

+;

+;   WriteTr.nasm

+;

+; Abstract:

+;

+;   Write TR register

+;

+; Notes:

+;

+;------------------------------------------------------------------------------

+

+    DEFAULT REL

+    SECTION .text

+

+;------------------------------------------------------------------------------

+; VOID

+; AsmWriteTr (

+;   UINT16 Selector

+;   );

+;------------------------------------------------------------------------------

+global ASM_PFX(AsmWriteTr)

+ASM_PFX(AsmWriteTr):

+    mov     eax, ecx

+    ltr     ax

+    ret

+

diff --git a/debugging_demo/memtest86+/efi/Include/src/BaseLib/X64/XGetBv.nasm b/debugging_demo/memtest86+/efi/Include/src/BaseLib/X64/XGetBv.nasm
new file mode 100644
index 0000000..09f3be8
--- /dev/null
+++ b/debugging_demo/memtest86+/efi/Include/src/BaseLib/X64/XGetBv.nasm
@@ -0,0 +1,34 @@
+;------------------------------------------------------------------------------

+;

+; Copyright (C) 2020, Advanced Micro Devices, Inc. All rights reserved.<BR>

+; SPDX-License-Identifier: BSD-2-Clause-Patent

+;

+; Module Name:

+;

+;   XGetBv.Asm

+;

+; Abstract:

+;

+;   AsmXgetBv function

+;

+; Notes:

+;

+;------------------------------------------------------------------------------

+

+    DEFAULT REL

+    SECTION .text

+

+;------------------------------------------------------------------------------

+; UINT64

+; EFIAPI

+; AsmXGetBv (

+;   IN UINT32  Index

+;   );

+;------------------------------------------------------------------------------

+global ASM_PFX(AsmXGetBv)

+ASM_PFX(AsmXGetBv):

+    xgetbv

+    shl     rdx, 32

+    or      rax, rdx

+    ret

+

diff --git a/debugging_demo/memtest86+/efi/Include/src/BaseLib/X86DisablePaging32.c b/debugging_demo/memtest86+/efi/Include/src/BaseLib/X86DisablePaging32.c
new file mode 100644
index 0000000..b7378c0
--- /dev/null
+++ b/debugging_demo/memtest86+/efi/Include/src/BaseLib/X86DisablePaging32.c
@@ -0,0 +1,60 @@
+/** @file

+  IA-32/x64 AsmDisablePaging32()

+

+  Copyright (c) 2006 - 2008, Intel Corporation. All rights reserved.<BR>

+  SPDX-License-Identifier: BSD-2-Clause-Patent

+

+**/

+

+

+

+

+#include "BaseLibInternals.h"

+

+/**

+  Disables the 32-bit paging mode on the CPU.

+

+  Disables the 32-bit paging mode on the CPU and returns to 32-bit protected

+  mode. This function assumes the current execution mode is 32-paged protected

+  mode. This function is only available on IA-32. After the 32-bit paging mode

+  is disabled, control is transferred to the function specified by EntryPoint

+  using the new stack specified by NewStack and passing in the parameters

+  specified by Context1 and Context2. Context1 and Context2 are optional and

+  may be NULL. The function EntryPoint must never return.

+

+  If the current execution mode is not 32-bit paged mode, then ASSERT().

+  If EntryPoint is NULL, then ASSERT().

+  If NewStack is NULL, then ASSERT().

+

+  There are a number of constraints that must be followed before calling this

+  function:

+  1)  Interrupts must be disabled.

+  2)  The caller must be in 32-bit paged mode.

+  3)  CR0, CR3, and CR4 must be compatible with 32-bit paged mode.

+  4)  CR3 must point to valid page tables that guarantee that the pages for

+      this function and the stack are identity mapped.

+

+  @param  EntryPoint  A pointer to function to call with the new stack after

+                      paging is disabled.

+  @param  Context1    A pointer to the context to pass into the EntryPoint

+                      function as the first parameter after paging is disabled.

+  @param  Context2    A pointer to the context to pass into the EntryPoint

+                      function as the second parameter after paging is

+                      disabled.

+  @param  NewStack    A pointer to the new stack to use for the EntryPoint

+                      function after paging is disabled.

+

+**/

+VOID

+EFIAPI

+AsmDisablePaging32 (

+  IN      SWITCH_STACK_ENTRY_POINT  EntryPoint,

+  IN      VOID                      *Context1,  OPTIONAL

+  IN      VOID                      *Context2,  OPTIONAL

+  IN      VOID                      *NewStack

+  )

+{

+  ASSERT (EntryPoint != NULL);

+  ASSERT (NewStack != NULL);

+  InternalX86DisablePaging32 (EntryPoint, Context1, Context2, NewStack);

+}

diff --git a/debugging_demo/memtest86+/efi/Include/src/BaseLib/X86DisablePaging64.c b/debugging_demo/memtest86+/efi/Include/src/BaseLib/X86DisablePaging64.c
new file mode 100644
index 0000000..867a8eb
--- /dev/null
+++ b/debugging_demo/memtest86+/efi/Include/src/BaseLib/X86DisablePaging64.c
@@ -0,0 +1,57 @@
+/** @file

+  IA-32/x64 AsmDisablePaging64()

+

+  Copyright (c) 2006 - 2008, Intel Corporation. All rights reserved.<BR>

+  SPDX-License-Identifier: BSD-2-Clause-Patent

+

+**/

+

+

+

+

+#include "BaseLibInternals.h"

+

+/**

+  Disables the 64-bit paging mode on the CPU.

+

+  Disables the 64-bit paging mode on the CPU and returns to 32-bit protected

+  mode. This function assumes the current execution mode is 64-paging mode.

+  This function is only available on x64. After the 64-bit paging mode is

+  disabled, control is transferred to the function specified by EntryPoint

+  using the new stack specified by NewStack and passing in the parameters

+  specified by Context1 and Context2. Context1 and Context2 are optional and

+  may be 0. The function EntryPoint must never return.

+

+  If the current execution mode is not 64-bit paged mode, then ASSERT().

+  If EntryPoint is 0, then ASSERT().

+  If NewStack is 0, then ASSERT().

+

+  @param  Cs          The 16-bit selector to load in the CS before EntryPoint

+                      is called. The descriptor in the GDT that this selector

+                      references must be setup for 32-bit protected mode.

+  @param  EntryPoint  The 64-bit virtual address of the function to call with

+                      the new stack after paging is disabled.

+  @param  Context1    The 64-bit virtual address of the context to pass into

+                      the EntryPoint function as the first parameter after

+                      paging is disabled.

+  @param  Context2    The 64-bit virtual address of the context to pass into

+                      the EntryPoint function as the second parameter after

+                      paging is disabled.

+  @param  NewStack    The 64-bit virtual address of the new stack to use for

+                      the EntryPoint function after paging is disabled.

+

+**/

+VOID

+EFIAPI

+AsmDisablePaging64 (

+  IN      UINT16                    Cs,

+  IN      UINT32                    EntryPoint,

+  IN      UINT32                    Context1,  OPTIONAL

+  IN      UINT32                    Context2,  OPTIONAL

+  IN      UINT32                    NewStack

+  )

+{

+  ASSERT (EntryPoint != 0);

+  ASSERT (NewStack != 0);

+  InternalX86DisablePaging64 (Cs, EntryPoint, Context1, Context2, NewStack);

+}

diff --git a/debugging_demo/memtest86+/efi/Include/src/BaseLib/X86EnablePaging32.c b/debugging_demo/memtest86+/efi/Include/src/BaseLib/X86EnablePaging32.c
new file mode 100644
index 0000000..32a0054
--- /dev/null
+++ b/debugging_demo/memtest86+/efi/Include/src/BaseLib/X86EnablePaging32.c
@@ -0,0 +1,63 @@
+/** @file

+  IA-32/x64 AsmEnablePaging32()

+

+  Copyright (c) 2006 - 2008, Intel Corporation. All rights reserved.<BR>

+  SPDX-License-Identifier: BSD-2-Clause-Patent

+

+**/

+

+

+

+

+#include "BaseLibInternals.h"

+

+/**

+  Enables the 32-bit paging mode on the CPU.

+

+  Enables the 32-bit paging mode on the CPU. CR0, CR3, CR4, and the page tables

+  must be properly initialized prior to calling this service. This function

+  assumes the current execution mode is 32-bit protected mode. This function is

+  only available on IA-32. After the 32-bit paging mode is enabled, control is

+  transferred to the function specified by EntryPoint using the new stack

+  specified by NewStack and passing in the parameters specified by Context1 and

+  Context2. Context1 and Context2 are optional and may be NULL. The function

+  EntryPoint must never return.

+

+  If the current execution mode is not 32-bit protected mode, then ASSERT().

+  If EntryPoint is NULL, then ASSERT().

+  If NewStack is NULL, then ASSERT().

+

+  There are a number of constraints that must be followed before calling this

+  function:

+  1)  Interrupts must be disabled.

+  2)  The caller must be in 32-bit protected mode with flat descriptors. This

+      means all descriptors must have a base of 0 and a limit of 4GB.

+  3)  CR0 and CR4 must be compatible with 32-bit protected mode with flat

+      descriptors.

+  4)  CR3 must point to valid page tables that will be used once the transition

+      is complete, and those page tables must guarantee that the pages for this

+      function and the stack are identity mapped.

+

+  @param  EntryPoint  A pointer to function to call with the new stack after

+                      paging is enabled.

+  @param  Context1    A pointer to the context to pass into the EntryPoint

+                      function as the first parameter after paging is enabled.

+  @param  Context2    A pointer to the context to pass into the EntryPoint

+                      function as the second parameter after paging is enabled.

+  @param  NewStack    A pointer to the new stack to use for the EntryPoint

+                      function after paging is enabled.

+

+**/

+VOID

+EFIAPI

+AsmEnablePaging32 (

+  IN      SWITCH_STACK_ENTRY_POINT  EntryPoint,

+  IN      VOID                      *Context1,  OPTIONAL

+  IN      VOID                      *Context2,  OPTIONAL

+  IN      VOID                      *NewStack

+  )

+{

+  ASSERT (EntryPoint != NULL);

+  ASSERT (NewStack != NULL);

+  InternalX86EnablePaging32 (EntryPoint, Context1, Context2, NewStack);

+}

diff --git a/debugging_demo/memtest86+/efi/Include/src/BaseLib/X86EnablePaging64.c b/debugging_demo/memtest86+/efi/Include/src/BaseLib/X86EnablePaging64.c
new file mode 100644
index 0000000..1323e68
--- /dev/null
+++ b/debugging_demo/memtest86+/efi/Include/src/BaseLib/X86EnablePaging64.c
@@ -0,0 +1,59 @@
+/** @file

+  IA-32/x64 AsmEnablePaging64()

+

+  Copyright (c) 2006 - 2008, Intel Corporation. All rights reserved.<BR>

+  SPDX-License-Identifier: BSD-2-Clause-Patent

+

+**/

+

+

+

+

+#include "BaseLibInternals.h"

+

+/**

+  Enables the 64-bit paging mode on the CPU.

+

+  Enables the 64-bit paging mode on the CPU. CR0, CR3, CR4, and the page tables

+  must be properly initialized prior to calling this service. This function

+  assumes the current execution mode is 32-bit protected mode with flat

+  descriptors. This function is only available on IA-32. After the 64-bit

+  paging mode is enabled, control is transferred to the function specified by

+  EntryPoint using the new stack specified by NewStack and passing in the

+  parameters specified by Context1 and Context2. Context1 and Context2 are

+  optional and may be 0. The function EntryPoint must never return.

+

+  If the current execution mode is not 32-bit protected mode with flat

+  descriptors, then ASSERT().

+  If EntryPoint is 0, then ASSERT().

+  If NewStack is 0, then ASSERT().

+

+  @param  Cs          The 16-bit selector to load in the CS before EntryPoint

+                      is called. The descriptor in the GDT that this selector

+                      references must be setup for long mode.

+  @param  EntryPoint  The 64-bit virtual address of the function to call with

+                      the new stack after paging is enabled.

+  @param  Context1    The 64-bit virtual address of the context to pass into

+                      the EntryPoint function as the first parameter after

+                      paging is enabled.

+  @param  Context2    The 64-bit virtual address of the context to pass into

+                      the EntryPoint function as the second parameter after

+                      paging is enabled.

+  @param  NewStack    The 64-bit virtual address of the new stack to use for

+                      the EntryPoint function after paging is enabled.

+

+**/

+VOID

+EFIAPI

+AsmEnablePaging64 (

+  IN      UINT16                    Cs,

+  IN      UINT64                    EntryPoint,

+  IN      UINT64                    Context1,  OPTIONAL

+  IN      UINT64                    Context2,  OPTIONAL

+  IN      UINT64                    NewStack

+  )

+{

+  ASSERT (EntryPoint != 0);

+  ASSERT (NewStack != 0);

+  InternalX86EnablePaging64 (Cs, EntryPoint, Context1, Context2, NewStack);

+}

diff --git a/debugging_demo/memtest86+/efi/Include/src/BaseLib/X86FxRestore.c b/debugging_demo/memtest86+/efi/Include/src/BaseLib/X86FxRestore.c
new file mode 100644
index 0000000..c4fa668
--- /dev/null
+++ b/debugging_demo/memtest86+/efi/Include/src/BaseLib/X86FxRestore.c
@@ -0,0 +1,43 @@
+/** @file

+  IA-32/x64 AsmFxRestore()

+

+  Copyright (c) 2006 - 2012, Intel Corporation. All rights reserved.<BR>

+  SPDX-License-Identifier: BSD-2-Clause-Patent

+

+**/

+

+

+

+

+#include "BaseLibInternals.h"

+

+/**

+  Restores the current floating point/SSE/SSE2 context from a buffer.

+

+  Restores the current floating point/SSE/SSE2 state from the buffer specified

+  by Buffer. Buffer must be aligned on a 16-byte boundary. This function is

+  only available on IA-32 and x64.

+

+  If Buffer is NULL, then ASSERT().

+  If Buffer is not aligned on a 16-byte boundary, then ASSERT().

+  If Buffer was not saved with AsmFxSave(), then ASSERT().

+

+  @param  Buffer  A pointer to a buffer to save the floating point/SSE/SSE2 context.

+

+**/

+VOID

+EFIAPI

+AsmFxRestore (

+  IN      CONST IA32_FX_BUFFER      *Buffer

+  )

+{

+  ASSERT (Buffer != NULL);

+  ASSERT (0 == ((UINTN)Buffer & 0xf));

+

+  //

+  // Check the flag recorded by AsmFxSave()

+  //

+  ASSERT (0xAA5555AA == *(UINT32 *) (&Buffer->Buffer[sizeof (Buffer->Buffer) - 4]));

+

+  InternalX86FxRestore (Buffer);

+}

diff --git a/debugging_demo/memtest86+/efi/Include/src/BaseLib/X86FxSave.c b/debugging_demo/memtest86+/efi/Include/src/BaseLib/X86FxSave.c
new file mode 100644
index 0000000..2621a08
--- /dev/null
+++ b/debugging_demo/memtest86+/efi/Include/src/BaseLib/X86FxSave.c
@@ -0,0 +1,42 @@
+/** @file

+  IA-32/x64 AsmFxSave()

+

+  Copyright (c) 2006 - 2012, Intel Corporation. All rights reserved.<BR>

+  SPDX-License-Identifier: BSD-2-Clause-Patent

+

+**/

+

+

+

+

+#include "BaseLibInternals.h"

+

+/**

+  Save the current floating point/SSE/SSE2 context to a buffer.

+

+  Saves the current floating point/SSE/SSE2 state to the buffer specified by

+  Buffer. Buffer must be aligned on a 16-byte boundary. This function is only

+  available on IA-32 and x64.

+

+  If Buffer is NULL, then ASSERT().

+  If Buffer is not aligned on a 16-byte boundary, then ASSERT().

+

+  @param  Buffer  A pointer to a buffer to save the floating point/SSE/SSE2 context.

+

+**/

+VOID

+EFIAPI

+AsmFxSave (

+  OUT     IA32_FX_BUFFER            *Buffer

+  )

+{

+  ASSERT (Buffer != NULL);

+  ASSERT (0 == ((UINTN)Buffer & 0xf));

+

+  InternalX86FxSave (Buffer);

+

+  //

+  // Mark one flag at end of Buffer, it will be check by AsmFxRestor()

+  //

+  *(UINT32 *) (&Buffer->Buffer[sizeof (Buffer->Buffer) - 4]) = 0xAA5555AA;

+}

diff --git a/debugging_demo/memtest86+/efi/Include/src/BaseLib/X86GetInterruptState.c b/debugging_demo/memtest86+/efi/Include/src/BaseLib/X86GetInterruptState.c
new file mode 100644
index 0000000..4363a7f
--- /dev/null
+++ b/debugging_demo/memtest86+/efi/Include/src/BaseLib/X86GetInterruptState.c
@@ -0,0 +1,35 @@
+/** @file

+  IA-32/x64 GetInterruptState()

+

+  Copyright (c) 2006 - 2008, Intel Corporation. All rights reserved.<BR>

+  SPDX-License-Identifier: BSD-2-Clause-Patent

+

+**/

+

+

+#include "BaseLibInternals.h"

+

+

+/**

+  Retrieves the current CPU interrupt state.

+

+  Returns TRUE is interrupts are currently enabled. Otherwise

+  returns FALSE.

+

+  @retval TRUE  CPU interrupts are enabled.

+  @retval FALSE CPU interrupts are disabled.

+

+**/

+BOOLEAN

+EFIAPI

+GetInterruptState (

+  VOID

+  )

+{

+  IA32_EFLAGS32                     EFlags;

+

+  EFlags.UintN = AsmReadEflags ();

+  return (BOOLEAN)(1 == EFlags.Bits.IF);

+}

+

+

diff --git a/debugging_demo/memtest86+/efi/Include/src/BaseLib/X86MemoryFence.c b/debugging_demo/memtest86+/efi/Include/src/BaseLib/X86MemoryFence.c
new file mode 100644
index 0000000..399b36b
--- /dev/null
+++ b/debugging_demo/memtest86+/efi/Include/src/BaseLib/X86MemoryFence.c
@@ -0,0 +1,26 @@
+/** @file

+  IA-32/x64 MemoryFence().

+

+  Copyright (c) 2006 - 2008, Intel Corporation. All rights reserved.<BR>

+  SPDX-License-Identifier: BSD-2-Clause-Patent

+

+**/

+

+

+

+

+/**

+  Used to serialize load and store operations.

+

+  All loads and stores that proceed calls to this function are guaranteed to be

+  globally visible when this function returns.

+

+**/

+VOID

+EFIAPI

+MemoryFence (

+  VOID

+  )

+{

+  return;

+}

diff --git a/debugging_demo/memtest86+/efi/Include/src/BaseLib/X86Msr.c b/debugging_demo/memtest86+/efi/Include/src/BaseLib/X86Msr.c
new file mode 100644
index 0000000..ea51ca9
--- /dev/null
+++ b/debugging_demo/memtest86+/efi/Include/src/BaseLib/X86Msr.c
@@ -0,0 +1,654 @@
+/** @file

+  IA-32/x64 MSR functions.

+

+  Copyright (c) 2006 - 2018, Intel Corporation. All rights reserved.<BR>

+  SPDX-License-Identifier: BSD-2-Clause-Patent

+

+**/

+

+

+#include "BaseLibInternals.h"

+

+

+/**

+  Returns the lower 32-bits of a Machine Specific Register(MSR).

+

+  Reads and returns the lower 32-bits of the MSR specified by Index.

+  No parameter checking is performed on Index, and some Index values may cause

+  CPU exceptions. The caller must either guarantee that Index is valid, or the

+  caller must set up exception handlers to catch the exceptions. This function

+  is only available on IA-32 and x64.

+

+  @param  Index The 32-bit MSR index to read.

+

+  @return The lower 32 bits of the MSR identified by Index.

+

+**/

+UINT32

+EFIAPI

+AsmReadMsr32 (

+  IN      UINT32                    Index

+  )

+{

+  return (UINT32)AsmReadMsr64 (Index);

+}

+

+/**

+  Writes a 32-bit value to a Machine Specific Register(MSR), and returns the value.

+  The upper 32-bits of the MSR are set to zero.

+

+  Writes the 32-bit value specified by Value to the MSR specified by Index. The

+  upper 32-bits of the MSR write are set to zero. The 32-bit value written to

+  the MSR is returned. No parameter checking is performed on Index or Value,

+  and some of these may cause CPU exceptions. The caller must either guarantee

+  that Index and Value are valid, or the caller must establish proper exception

+  handlers. This function is only available on IA-32 and x64.

+

+  @param  Index The 32-bit MSR index to write.

+  @param  Value The 32-bit value to write to the MSR.

+

+  @return Value

+

+**/

+UINT32

+EFIAPI

+AsmWriteMsr32 (

+  IN      UINT32                    Index,

+  IN      UINT32                    Value

+  )

+{

+  return (UINT32)AsmWriteMsr64 (Index, Value);

+}

+

+/**

+  Reads a 64-bit MSR, performs a bitwise OR on the lower 32-bits, and

+  writes the result back to the 64-bit MSR.

+

+  Reads the 64-bit MSR specified by Index, performs a bitwise OR

+  between the lower 32-bits of the read result and the value specified by

+  OrData, and writes the result to the 64-bit MSR specified by Index. The lower

+  32-bits of the value written to the MSR is returned. No parameter checking is

+  performed on Index or OrData, and some of these may cause CPU exceptions. The

+  caller must either guarantee that Index and OrData are valid, or the caller

+  must establish proper exception handlers. This function is only available on

+  IA-32 and x64.

+

+  @param  Index   The 32-bit MSR index to write.

+  @param  OrData  The value to OR with the read value from the MSR.

+

+  @return The lower 32-bit value written to the MSR.

+

+**/

+UINT32

+EFIAPI

+AsmMsrOr32 (

+  IN      UINT32                    Index,

+  IN      UINT32                    OrData

+  )

+{

+  return (UINT32)AsmMsrOr64 (Index, OrData);

+}

+

+/**

+  Reads a 64-bit MSR, performs a bitwise AND on the lower 32-bits, and writes

+  the result back to the 64-bit MSR.

+

+  Reads the 64-bit MSR specified by Index, performs a bitwise AND between the

+  lower 32-bits of the read result and the value specified by AndData, and

+  writes the result to the 64-bit MSR specified by Index. The lower 32-bits of

+  the value written to the MSR is returned. No parameter checking is performed

+  on Index or AndData, and some of these may cause CPU exceptions. The caller

+  must either guarantee that Index and AndData are valid, or the caller must

+  establish proper exception handlers. This function is only available on IA-32

+  and x64.

+

+  @param  Index   The 32-bit MSR index to write.

+  @param  AndData The value to AND with the read value from the MSR.

+

+  @return The lower 32-bit value written to the MSR.

+

+**/

+UINT32

+EFIAPI

+AsmMsrAnd32 (

+  IN      UINT32                    Index,

+  IN      UINT32                    AndData

+  )

+{

+  return (UINT32)AsmMsrAnd64 (Index, AndData);

+}

+

+/**

+  Reads a 64-bit MSR, performs a bitwise AND followed by a bitwise OR

+  on the lower 32-bits, and writes the result back to the 64-bit MSR.

+

+  Reads the 64-bit MSR specified by Index, performs a bitwise AND between the

+  lower 32-bits of the read result and the value specified by AndData

+  preserving the upper 32-bits, performs a bitwise OR between the

+  result of the AND operation and the value specified by OrData, and writes the

+  result to the 64-bit MSR specified by Address. The lower 32-bits of the value

+  written to the MSR is returned. No parameter checking is performed on Index,

+  AndData, or OrData, and some of these may cause CPU exceptions. The caller

+  must either guarantee that Index, AndData, and OrData are valid, or the

+  caller must establish proper exception handlers. This function is only

+  available on IA-32 and x64.

+

+  @param  Index   The 32-bit MSR index to write.

+  @param  AndData The value to AND with the read value from the MSR.

+  @param  OrData  The value to OR with the result of the AND operation.

+

+  @return The lower 32-bit value written to the MSR.

+

+**/

+UINT32

+EFIAPI

+AsmMsrAndThenOr32 (

+  IN      UINT32                    Index,

+  IN      UINT32                    AndData,

+  IN      UINT32                    OrData

+  )

+{

+  return (UINT32)AsmMsrAndThenOr64 (Index, AndData, OrData);

+}

+

+/**

+  Reads a bit field of an MSR.

+

+  Reads the bit field in the lower 32-bits of a 64-bit MSR. The bit field is

+  specified by the StartBit and the EndBit. The value of the bit field is

+  returned. The caller must either guarantee that Index is valid, or the caller

+  must set up exception handlers to catch the exceptions. This function is only

+  available on IA-32 and x64.

+

+  If StartBit is greater than 31, then ASSERT().

+  If EndBit is greater than 31, then ASSERT().

+  If EndBit is less than StartBit, then ASSERT().

+

+  @param  Index     The 32-bit MSR index to read.

+  @param  StartBit  The ordinal of the least significant bit in the bit field.

+                    Range 0..31.

+  @param  EndBit    The ordinal of the most significant bit in the bit field.

+                    Range 0..31.

+

+  @return The bit field read from the MSR.

+

+**/

+UINT32

+EFIAPI

+AsmMsrBitFieldRead32 (

+  IN      UINT32                    Index,

+  IN      UINTN                     StartBit,

+  IN      UINTN                     EndBit

+  )

+{

+  return BitFieldRead32 (AsmReadMsr32 (Index), StartBit, EndBit);

+}

+

+/**

+  Writes a bit field to an MSR.

+

+  Writes Value to a bit field in the lower 32-bits of a 64-bit MSR. The bit

+  field is specified by the StartBit and the EndBit. All other bits in the

+  destination MSR are preserved. The lower 32-bits of the MSR written is

+  returned. The caller must either guarantee that Index and the data written

+  is valid, or the caller must set up exception handlers to catch the exceptions.

+  This function is only available on IA-32 and x64.

+

+  If StartBit is greater than 31, then ASSERT().

+  If EndBit is greater than 31, then ASSERT().

+  If EndBit is less than StartBit, then ASSERT().

+  If Value is larger than the bitmask value range specified by StartBit and EndBit, then ASSERT().

+

+  @param  Index     The 32-bit MSR index to write.

+  @param  StartBit  The ordinal of the least significant bit in the bit field.

+                    Range 0..31.

+  @param  EndBit    The ordinal of the most significant bit in the bit field.

+                    Range 0..31.

+  @param  Value     The new value of the bit field.

+

+  @return The lower 32-bit of the value written to the MSR.

+

+**/

+UINT32

+EFIAPI

+AsmMsrBitFieldWrite32 (

+  IN      UINT32                    Index,

+  IN      UINTN                     StartBit,

+  IN      UINTN                     EndBit,

+  IN      UINT32                    Value

+  )

+{

+  ASSERT (EndBit < sizeof (Value) * 8);

+  ASSERT (StartBit <= EndBit);

+  return (UINT32)AsmMsrBitFieldWrite64 (Index, StartBit, EndBit, Value);

+}

+

+/**

+  Reads a bit field in a 64-bit MSR, performs a bitwise OR, and writes the

+  result back to the bit field in the 64-bit MSR.

+

+  Reads the 64-bit MSR specified by Index, performs a bitwise OR

+  between the read result and the value specified by OrData, and writes the

+  result to the 64-bit MSR specified by Index. The lower 32-bits of the value

+  written to the MSR are returned. Extra left bits in OrData are stripped. The

+  caller must either guarantee that Index and the data written is valid, or

+  the caller must set up exception handlers to catch the exceptions. This

+  function is only available on IA-32 and x64.

+

+  If StartBit is greater than 31, then ASSERT().

+  If EndBit is greater than 31, then ASSERT().

+  If EndBit is less than StartBit, then ASSERT().

+  If OrData is larger than the bitmask value range specified by StartBit and EndBit, then ASSERT().

+

+  @param  Index     The 32-bit MSR index to write.

+  @param  StartBit  The ordinal of the least significant bit in the bit field.

+                    Range 0..31.

+  @param  EndBit    The ordinal of the most significant bit in the bit field.

+                    Range 0..31.

+  @param  OrData    The value to OR with the read value from the MSR.

+

+  @return The lower 32-bit of the value written to the MSR.

+

+**/

+UINT32

+EFIAPI

+AsmMsrBitFieldOr32 (

+  IN      UINT32                    Index,

+  IN      UINTN                     StartBit,

+  IN      UINTN                     EndBit,

+  IN      UINT32                    OrData

+  )

+{

+  ASSERT (EndBit < sizeof (OrData) * 8);

+  ASSERT (StartBit <= EndBit);

+  return (UINT32)AsmMsrBitFieldOr64 (Index, StartBit, EndBit, OrData);

+}

+

+/**

+  Reads a bit field in a 64-bit MSR, performs a bitwise AND, and writes the

+  result back to the bit field in the 64-bit MSR.

+

+  Reads the 64-bit MSR specified by Index, performs a bitwise AND between the

+  read result and the value specified by AndData, and writes the result to the

+  64-bit MSR specified by Index. The lower 32-bits of the value written to the

+  MSR are returned. Extra left bits in AndData are stripped. The caller must

+  either guarantee that Index and the data written is valid, or the caller must

+  set up exception handlers to catch the exceptions. This function is only

+  available on IA-32 and x64.

+

+  If StartBit is greater than 31, then ASSERT().

+  If EndBit is greater than 31, then ASSERT().

+  If EndBit is less than StartBit, then ASSERT().

+  If AndData is larger than the bitmask value range specified by StartBit and EndBit, then ASSERT().

+

+  @param  Index     The 32-bit MSR index to write.

+  @param  StartBit  The ordinal of the least significant bit in the bit field.

+                    Range 0..31.

+  @param  EndBit    The ordinal of the most significant bit in the bit field.

+                    Range 0..31.

+  @param  AndData   The value to AND with the read value from the MSR.

+

+  @return The lower 32-bit of the value written to the MSR.

+

+**/

+UINT32

+EFIAPI

+AsmMsrBitFieldAnd32 (

+  IN      UINT32                    Index,

+  IN      UINTN                     StartBit,

+  IN      UINTN                     EndBit,

+  IN      UINT32                    AndData

+  )

+{

+  ASSERT (EndBit < sizeof (AndData) * 8);

+  ASSERT (StartBit <= EndBit);

+  return (UINT32)AsmMsrBitFieldAnd64 (Index, StartBit, EndBit, AndData);

+}

+

+/**

+  Reads a bit field in a 64-bit MSR, performs a bitwise AND followed by a

+  bitwise OR, and writes the result back to the bit field in the

+  64-bit MSR.

+

+  Reads the 64-bit MSR specified by Index, performs a bitwise AND followed by a

+  bitwise OR between the read result and the value specified by

+  AndData, and writes the result to the 64-bit MSR specified by Index. The

+  lower 32-bits of the value written to the MSR are returned. Extra left bits

+  in both AndData and OrData are stripped. The caller must either guarantee

+  that Index and the data written is valid, or the caller must set up exception

+  handlers to catch the exceptions. This function is only available on IA-32

+  and x64.

+

+  If StartBit is greater than 31, then ASSERT().

+  If EndBit is greater than 31, then ASSERT().

+  If EndBit is less than StartBit, then ASSERT().

+  If AndData is larger than the bitmask value range specified by StartBit and EndBit, then ASSERT().

+  If OrData is larger than the bitmask value range specified by StartBit and EndBit, then ASSERT().

+

+  @param  Index     The 32-bit MSR index to write.

+  @param  StartBit  The ordinal of the least significant bit in the bit field.

+                    Range 0..31.

+  @param  EndBit    The ordinal of the most significant bit in the bit field.

+                    Range 0..31.

+  @param  AndData   The value to AND with the read value from the MSR.

+  @param  OrData    The value to OR with the result of the AND operation.

+

+  @return The lower 32-bit of the value written to the MSR.

+

+**/

+UINT32

+EFIAPI

+AsmMsrBitFieldAndThenOr32 (

+  IN      UINT32                    Index,

+  IN      UINTN                     StartBit,

+  IN      UINTN                     EndBit,

+  IN      UINT32                    AndData,

+  IN      UINT32                    OrData

+  )

+{

+  ASSERT (EndBit < sizeof (AndData) * 8);

+  ASSERT (StartBit <= EndBit);

+  return (UINT32)AsmMsrBitFieldAndThenOr64 (

+                   Index,

+                   StartBit,

+                   EndBit,

+                   AndData,

+                   OrData

+                   );

+}

+

+/**

+  Reads a 64-bit MSR, performs a bitwise OR, and writes the result

+  back to the 64-bit MSR.

+

+  Reads the 64-bit MSR specified by Index, performs a bitwise OR

+  between the read result and the value specified by OrData, and writes the

+  result to the 64-bit MSR specified by Index. The value written to the MSR is

+  returned. No parameter checking is performed on Index or OrData, and some of

+  these may cause CPU exceptions. The caller must either guarantee that Index

+  and OrData are valid, or the caller must establish proper exception handlers.

+  This function is only available on IA-32 and x64.

+

+  @param  Index   The 32-bit MSR index to write.

+  @param  OrData  The value to OR with the read value from the MSR.

+

+  @return The value written back to the MSR.

+

+**/

+UINT64

+EFIAPI

+AsmMsrOr64 (

+  IN      UINT32                    Index,

+  IN      UINT64                    OrData

+  )

+{

+  return AsmWriteMsr64 (Index, AsmReadMsr64 (Index) | OrData);

+}

+

+/**

+  Reads a 64-bit MSR, performs a bitwise AND, and writes the result back to the

+  64-bit MSR.

+

+  Reads the 64-bit MSR specified by Index, performs a bitwise AND between the

+  read result and the value specified by OrData, and writes the result to the

+  64-bit MSR specified by Index. The value written to the MSR is returned. No

+  parameter checking is performed on Index or OrData, and some of these may

+  cause CPU exceptions. The caller must either guarantee that Index and OrData

+  are valid, or the caller must establish proper exception handlers. This

+  function is only available on IA-32 and x64.

+

+  @param  Index   The 32-bit MSR index to write.

+  @param  AndData The value to AND with the read value from the MSR.

+

+  @return The value written back to the MSR.

+

+**/

+UINT64

+EFIAPI

+AsmMsrAnd64 (

+  IN      UINT32                    Index,

+  IN      UINT64                    AndData

+  )

+{

+  return AsmWriteMsr64 (Index, AsmReadMsr64 (Index) & AndData);

+}

+

+/**

+  Reads a 64-bit MSR, performs a bitwise AND followed by a bitwise

+  OR, and writes the result back to the 64-bit MSR.

+

+  Reads the 64-bit MSR specified by Index, performs a bitwise AND between read

+  result and the value specified by AndData, performs a bitwise OR

+  between the result of the AND operation and the value specified by OrData,

+  and writes the result to the 64-bit MSR specified by Index. The value written

+  to the MSR is returned. No parameter checking is performed on Index, AndData,

+  or OrData, and some of these may cause CPU exceptions. The caller must either

+  guarantee that Index, AndData, and OrData are valid, or the caller must

+  establish proper exception handlers. This function is only available on IA-32

+  and x64.

+

+  @param  Index   The 32-bit MSR index to write.

+  @param  AndData The value to AND with the read value from the MSR.

+  @param  OrData  The value to OR with the result of the AND operation.

+

+  @return The value written back to the MSR.

+

+**/

+UINT64

+EFIAPI

+AsmMsrAndThenOr64 (

+  IN      UINT32                    Index,

+  IN      UINT64                    AndData,

+  IN      UINT64                    OrData

+  )

+{

+  return AsmWriteMsr64 (Index, (AsmReadMsr64 (Index) & AndData) | OrData);

+}

+

+/**

+  Reads a bit field of an MSR.

+

+  Reads the bit field in the 64-bit MSR. The bit field is specified by the

+  StartBit and the EndBit. The value of the bit field is returned. The caller

+  must either guarantee that Index is valid, or the caller must set up

+  exception handlers to catch the exceptions. This function is only available

+  on IA-32 and x64.

+

+  If StartBit is greater than 63, then ASSERT().

+  If EndBit is greater than 63, then ASSERT().

+  If EndBit is less than StartBit, then ASSERT().

+

+  @param  Index     The 32-bit MSR index to read.

+  @param  StartBit  The ordinal of the least significant bit in the bit field.

+                    Range 0..63.

+  @param  EndBit    The ordinal of the most significant bit in the bit field.

+                    Range 0..63.

+

+  @return The value read from the MSR.

+

+**/

+UINT64

+EFIAPI

+AsmMsrBitFieldRead64 (

+  IN      UINT32                    Index,

+  IN      UINTN                     StartBit,

+  IN      UINTN                     EndBit

+  )

+{

+  return BitFieldRead64 (AsmReadMsr64 (Index), StartBit, EndBit);

+}

+

+/**

+  Writes a bit field to an MSR.

+

+  Writes Value to a bit field in a 64-bit MSR. The bit field is specified by

+  the StartBit and the EndBit. All other bits in the destination MSR are

+  preserved. The MSR written is returned. The caller must either guarantee

+  that Index and the data written is valid, or the caller must set up exception

+  handlers to catch the exceptions. This function is only available on IA-32 and x64.

+

+  If StartBit is greater than 63, then ASSERT().

+  If EndBit is greater than 63, then ASSERT().

+  If EndBit is less than StartBit, then ASSERT().

+  If Value is larger than the bitmask value range specified by StartBit and EndBit, then ASSERT().

+

+  @param  Index     The 32-bit MSR index to write.

+  @param  StartBit  The ordinal of the least significant bit in the bit field.

+                    Range 0..63.

+  @param  EndBit    The ordinal of the most significant bit in the bit field.

+                    Range 0..63.

+  @param  Value     The new value of the bit field.

+

+  @return The value written back to the MSR.

+

+**/

+UINT64

+EFIAPI

+AsmMsrBitFieldWrite64 (

+  IN      UINT32                    Index,

+  IN      UINTN                     StartBit,

+  IN      UINTN                     EndBit,

+  IN      UINT64                    Value

+  )

+{

+  return AsmWriteMsr64 (

+           Index,

+           BitFieldWrite64 (AsmReadMsr64 (Index), StartBit, EndBit, Value)

+           );

+}

+

+/**

+  Reads a bit field in a 64-bit MSR, performs a bitwise OR, and

+  writes the result back to the bit field in the 64-bit MSR.

+

+  Reads the 64-bit MSR specified by Index, performs a bitwise OR

+  between the read result and the value specified by OrData, and writes the

+  result to the 64-bit MSR specified by Index. The value written to the MSR is

+  returned. Extra left bits in OrData are stripped. The caller must either

+  guarantee that Index and the data written is valid, or the caller must set up

+  exception handlers to catch the exceptions. This function is only available

+  on IA-32 and x64.

+

+  If StartBit is greater than 63, then ASSERT().

+  If EndBit is greater than 63, then ASSERT().

+  If EndBit is less than StartBit, then ASSERT().

+  If OrData is larger than the bitmask value range specified by StartBit and EndBit, then ASSERT().

+

+  @param  Index     The 32-bit MSR index to write.

+  @param  StartBit  The ordinal of the least significant bit in the bit field.

+                    Range 0..63.

+  @param  EndBit    The ordinal of the most significant bit in the bit field.

+                    Range 0..63.

+  @param  OrData    The value to OR with the read value from the bit field.

+

+  @return The value written back to the MSR.

+

+**/

+UINT64

+EFIAPI

+AsmMsrBitFieldOr64 (

+  IN      UINT32                    Index,

+  IN      UINTN                     StartBit,

+  IN      UINTN                     EndBit,

+  IN      UINT64                    OrData

+  )

+{

+  return AsmWriteMsr64 (

+           Index,

+           BitFieldOr64 (AsmReadMsr64 (Index), StartBit, EndBit, OrData)

+           );

+}

+

+/**

+  Reads a bit field in a 64-bit MSR, performs a bitwise AND, and writes the

+  result back to the bit field in the 64-bit MSR.

+

+  Reads the 64-bit MSR specified by Index, performs a bitwise AND between the

+  read result and the value specified by AndData, and writes the result to the

+  64-bit MSR specified by Index. The value written to the MSR is returned.

+  Extra left bits in AndData are stripped. The caller must either guarantee

+  that Index and the data written is valid, or the caller must set up exception

+  handlers to catch the exceptions. This function is only available on IA-32

+  and x64.

+

+  If StartBit is greater than 63, then ASSERT().

+  If EndBit is greater than 63, then ASSERT().

+  If EndBit is less than StartBit, then ASSERT().

+  If AndData is larger than the bitmask value range specified by StartBit and EndBit, then ASSERT().

+

+  @param  Index     The 32-bit MSR index to write.

+  @param  StartBit  The ordinal of the least significant bit in the bit field.

+                    Range 0..63.

+  @param  EndBit    The ordinal of the most significant bit in the bit field.

+                    Range 0..63.

+  @param  AndData   The value to AND with the read value from the bit field.

+

+  @return The value written back to the MSR.

+

+**/

+UINT64

+EFIAPI

+AsmMsrBitFieldAnd64 (

+  IN      UINT32                    Index,

+  IN      UINTN                     StartBit,

+  IN      UINTN                     EndBit,

+  IN      UINT64                    AndData

+  )

+{

+  return AsmWriteMsr64 (

+           Index,

+           BitFieldAnd64 (AsmReadMsr64 (Index), StartBit, EndBit, AndData)

+           );

+}

+

+/**

+  Reads a bit field in a 64-bit MSR, performs a bitwise AND followed by a

+  bitwise OR, and writes the result back to the bit field in the

+  64-bit MSR.

+

+  Reads the 64-bit MSR specified by Index, performs a bitwise AND followed by

+  a bitwise OR between the read result and the value specified by

+  AndData, and writes the result to the 64-bit MSR specified by Index. The

+  value written to the MSR is returned. Extra left bits in both AndData and

+  OrData are stripped. The caller must either guarantee that Index and the data

+  written is valid, or the caller must set up exception handlers to catch the

+  exceptions. This function is only available on IA-32 and x64.

+

+  If StartBit is greater than 63, then ASSERT().

+  If EndBit is greater than 63, then ASSERT().

+  If EndBit is less than StartBit, then ASSERT().

+  If AndData is larger than the bitmask value range specified by StartBit and EndBit, then ASSERT().

+  If OrData is larger than the bitmask value range specified by StartBit and EndBit, then ASSERT().

+

+  @param  Index     The 32-bit MSR index to write.

+  @param  StartBit  The ordinal of the least significant bit in the bit field.

+                    Range 0..63.

+  @param  EndBit    The ordinal of the most significant bit in the bit field.

+                    Range 0..63.

+  @param  AndData   The value to AND with the read value from the bit field.

+  @param  OrData    The value to OR with the result of the AND operation.

+

+  @return The value written back to the MSR.

+

+**/

+UINT64

+EFIAPI

+AsmMsrBitFieldAndThenOr64 (

+  IN      UINT32                    Index,

+  IN      UINTN                     StartBit,

+  IN      UINTN                     EndBit,

+  IN      UINT64                    AndData,

+  IN      UINT64                    OrData

+  )

+{

+  return AsmWriteMsr64 (

+           Index,

+           BitFieldAndThenOr64 (

+             AsmReadMsr64 (Index),

+             StartBit,

+             EndBit,

+             AndData,

+             OrData

+             )

+           );

+}

diff --git a/debugging_demo/memtest86+/efi/Include/src/BaseLib/X86PatchInstruction.c b/debugging_demo/memtest86+/efi/Include/src/BaseLib/X86PatchInstruction.c
new file mode 100644
index 0000000..fc70a35
--- /dev/null
+++ b/debugging_demo/memtest86+/efi/Include/src/BaseLib/X86PatchInstruction.c
@@ -0,0 +1,83 @@
+/** @file

+  IA-32/x64 PatchInstructionX86()

+

+  Copyright (C) 2018, Intel Corporation. All rights reserved.<BR>

+  Copyright (C) 2018, Red Hat, Inc.

+

+  SPDX-License-Identifier: BSD-2-Clause-Patent

+**/

+

+#include "BaseLibInternals.h"

+

+/**

+  Patch the immediate operand of an IA32 or X64 instruction such that the byte,

+  word, dword or qword operand is encoded at the end of the instruction's

+  binary representation.

+

+  This function should be used to update object code that was compiled with

+  NASM from assembly source code. Example:

+

+  NASM source code:

+

+        mov     eax, strict dword 0 ; the imm32 zero operand will be patched

+    ASM_PFX(gPatchCr3):

+        mov     cr3, eax

+

+  C source code:

+

+    X86_ASSEMBLY_PATCH_LABEL gPatchCr3;

+    PatchInstructionX86 (gPatchCr3, AsmReadCr3 (), 4);

+

+  @param[out] InstructionEnd  Pointer right past the instruction to patch. The

+                              immediate operand to patch is expected to

+                              comprise the trailing bytes of the instruction.

+                              If InstructionEnd is closer to address 0 than

+                              ValueSize permits, then ASSERT().

+

+  @param[in] PatchValue       The constant to write to the immediate operand.

+                              The caller is responsible for ensuring that

+                              PatchValue can be represented in the byte, word,

+                              dword or qword operand (as indicated through

+                              ValueSize); otherwise ASSERT().

+

+  @param[in] ValueSize        The size of the operand in bytes; must be 1, 2,

+                              4, or 8. ASSERT() otherwise.

+**/

+VOID

+EFIAPI

+PatchInstructionX86 (

+  OUT X86_ASSEMBLY_PATCH_LABEL *InstructionEnd,

+  IN  UINT64                   PatchValue,

+  IN  UINTN                    ValueSize

+  )

+{

+  //

+  // The equality ((UINTN)InstructionEnd == ValueSize) would assume a zero-size

+  // instruction at address 0; forbid it.

+  //

+  ASSERT ((UINTN)InstructionEnd > ValueSize);

+

+  switch (ValueSize) {

+  case 1:

+    ASSERT (PatchValue <= MAX_UINT8);

+    *((UINT8 *)(UINTN)InstructionEnd - 1) = (UINT8)PatchValue;

+    break;

+

+  case 2:

+    ASSERT (PatchValue <= MAX_UINT16);

+    WriteUnaligned16 ((UINT16 *)(UINTN)InstructionEnd - 1, (UINT16)PatchValue);

+    break;

+

+  case 4:

+    ASSERT (PatchValue <= MAX_UINT32);

+    WriteUnaligned32 ((UINT32 *)(UINTN)InstructionEnd - 1, (UINT32)PatchValue);

+    break;

+

+  case 8:

+    WriteUnaligned64 ((UINT64 *)(UINTN)InstructionEnd - 1, PatchValue);

+    break;

+

+  default:

+    ASSERT (FALSE);

+  }

+}

diff --git a/debugging_demo/memtest86+/efi/Include/src/BaseLib/X86RdRand.c b/debugging_demo/memtest86+/efi/Include/src/BaseLib/X86RdRand.c
new file mode 100644
index 0000000..dcbd969
--- /dev/null
+++ b/debugging_demo/memtest86+/efi/Include/src/BaseLib/X86RdRand.c
@@ -0,0 +1,73 @@
+/** @file

+  IA-32/x64 AsmRdRandxx()

+  Generates random number through CPU RdRand instruction.

+

+  Copyright (c) 2016, Intel Corporation. All rights reserved.<BR>

+  SPDX-License-Identifier: BSD-2-Clause-Patent

+

+**/

+

+#include "BaseLibInternals.h"

+

+/**

+  Generates a 16-bit random number through RDRAND instruction.

+

+  if Rand is NULL, then ASSERT().

+

+  @param[out]  Rand     Buffer pointer to store the random result.

+

+  @retval TRUE          RDRAND call was successful.

+  @retval FALSE         Failed attempts to call RDRAND.

+

+ **/

+BOOLEAN

+EFIAPI

+AsmRdRand16 (

+  OUT     UINT16                    *Rand

+  )

+{

+  ASSERT (Rand != NULL);

+  return InternalX86RdRand16 (Rand);

+}

+

+/**

+  Generates a 32-bit random number through RDRAND instruction.

+

+  if Rand is NULL, then ASSERT().

+

+  @param[out]  Rand     Buffer pointer to store the random result.

+

+  @retval TRUE          RDRAND call was successful.

+  @retval FALSE         Failed attempts to call RDRAND.

+

+**/

+BOOLEAN

+EFIAPI

+AsmRdRand32 (

+  OUT     UINT32                    *Rand

+  )

+{

+  ASSERT (Rand != NULL);

+  return InternalX86RdRand32 (Rand);

+}

+

+/**

+  Generates a 64-bit random number through RDRAND instruction.

+

+  if Rand is NULL, then ASSERT().

+

+  @param[out]  Rand     Buffer pointer to store the random result.

+

+  @retval TRUE          RDRAND call was successful.

+  @retval FALSE         Failed attempts to call RDRAND.

+

+**/

+BOOLEAN

+EFIAPI

+AsmRdRand64  (

+  OUT     UINT64                    *Rand

+  )

+{

+  ASSERT (Rand != NULL);

+  return InternalX86RdRand64 (Rand);

+}

diff --git a/debugging_demo/memtest86+/efi/Include/src/BaseLib/X86ReadGdtr.c b/debugging_demo/memtest86+/efi/Include/src/BaseLib/X86ReadGdtr.c
new file mode 100644
index 0000000..ca7c5de
--- /dev/null
+++ b/debugging_demo/memtest86+/efi/Include/src/BaseLib/X86ReadGdtr.c
@@ -0,0 +1,33 @@
+/** @file

+  IA-32/x64 AsmReadGdtr()

+

+  Copyright (c) 2006 - 2008, Intel Corporation. All rights reserved.<BR>

+  SPDX-License-Identifier: BSD-2-Clause-Patent

+

+**/

+

+

+

+

+#include "BaseLibInternals.h"

+

+/**

+  Reads the current Global Descriptor Table Register(GDTR) descriptor.

+

+  Reads and returns the current GDTR descriptor and returns it in Gdtr. This

+  function is only available on IA-32 and x64.

+

+  If Gdtr is NULL, then ASSERT().

+

+  @param  Gdtr  The pointer to a GDTR descriptor.

+

+**/

+VOID

+EFIAPI

+AsmReadGdtr (

+  OUT     IA32_DESCRIPTOR           *Gdtr

+  )

+{

+  ASSERT (Gdtr != NULL);

+  InternalX86ReadGdtr (Gdtr);

+}

diff --git a/debugging_demo/memtest86+/efi/Include/src/BaseLib/X86ReadIdtr.c b/debugging_demo/memtest86+/efi/Include/src/BaseLib/X86ReadIdtr.c
new file mode 100644
index 0000000..f9133f9
--- /dev/null
+++ b/debugging_demo/memtest86+/efi/Include/src/BaseLib/X86ReadIdtr.c
@@ -0,0 +1,33 @@
+/** @file

+  IA-32/x64 AsmReadIdtr()

+

+  Copyright (c) 2006 - 2008, Intel Corporation. All rights reserved.<BR>

+  SPDX-License-Identifier: BSD-2-Clause-Patent

+

+**/

+

+

+

+

+#include "BaseLibInternals.h"

+

+/**

+  Reads the current Interrupt Descriptor Table Register(IDTR) descriptor.

+

+  Reads and returns the current IDTR descriptor and returns it in Idtr. This

+  function is only available on IA-32 and x64.

+

+  If Idtr is NULL, then ASSERT().

+

+  @param  Idtr  The pointer to a IDTR descriptor.

+

+**/

+VOID

+EFIAPI

+AsmReadIdtr (

+  OUT     IA32_DESCRIPTOR           *Idtr

+  )

+{

+  ASSERT (Idtr != NULL);

+  InternalX86ReadIdtr (Idtr);

+}

diff --git a/debugging_demo/memtest86+/efi/Include/src/BaseLib/X86SpeculationBarrier.c b/debugging_demo/memtest86+/efi/Include/src/BaseLib/X86SpeculationBarrier.c
new file mode 100644
index 0000000..b28fd8d
--- /dev/null
+++ b/debugging_demo/memtest86+/efi/Include/src/BaseLib/X86SpeculationBarrier.c
@@ -0,0 +1,30 @@
+/** @file

+  SpeculationBarrier() function for IA32 and x64.

+

+  Copyright (C) 2018 - 2019, Intel Corporation. All rights reserved.<BR>

+

+  SPDX-License-Identifier: BSD-2-Clause-Patent

+

+**/

+

+#include <Library/BaseLib.h>

+

+/**

+  Uses as a barrier to stop speculative execution.

+

+  Ensures that no later instruction will execute speculatively, until all prior

+  instructions have completed.

+

+**/

+VOID

+EFIAPI

+SpeculationBarrier (

+  VOID

+  )

+{

+  if (PcdGet8 (PcdSpeculationBarrierType) == 0x01) {

+    AsmLfence ();

+  } else if (PcdGet8 (PcdSpeculationBarrierType) == 0x02) {

+    AsmCpuid (0x01, NULL, NULL, NULL, NULL);

+  }

+}

diff --git a/debugging_demo/memtest86+/efi/Include/src/BaseLib/X86Thunk.c b/debugging_demo/memtest86+/efi/Include/src/BaseLib/X86Thunk.c
new file mode 100644
index 0000000..5c8a039
--- /dev/null
+++ b/debugging_demo/memtest86+/efi/Include/src/BaseLib/X86Thunk.c
@@ -0,0 +1,262 @@
+/** @file

+  Real Mode Thunk Functions for IA32 and x64.

+

+  Copyright (c) 2006 - 2018, Intel Corporation. All rights reserved.<BR>

+  SPDX-License-Identifier: BSD-2-Clause-Patent

+

+**/

+

+

+#include "BaseLibInternals.h"

+

+extern CONST UINT8                  m16Start;

+extern CONST UINT16                 m16Size;

+extern CONST UINT16                 mThunk16Attr;

+extern CONST UINT16                 m16Gdt;

+extern CONST UINT16                 m16GdtrBase;

+extern CONST UINT16                 mTransition;

+

+/**

+  Invokes 16-bit code in big real mode and returns the updated register set.

+

+  This function transfers control to the 16-bit code specified by CS:EIP using

+  the stack specified by SS:ESP in RegisterSet. The updated registers are saved

+  on the real mode stack and the starting address of the save area is returned.

+

+  @param  RegisterSet Values of registers before invocation of 16-bit code.

+  @param  Transition  The pointer to the transition code under 1MB.

+

+  @return The pointer to a IA32_REGISTER_SET structure containing the updated

+          register values.

+

+**/

+IA32_REGISTER_SET *

+EFIAPI

+InternalAsmThunk16 (

+  IN      IA32_REGISTER_SET         *RegisterSet,

+  IN OUT  VOID                      *Transition

+  );

+

+/**

+  Retrieves the properties for 16-bit thunk functions.

+

+  Computes the size of the buffer and stack below 1MB required to use the

+  AsmPrepareThunk16(), AsmThunk16() and AsmPrepareAndThunk16() functions. This

+  buffer size is returned in RealModeBufferSize, and the stack size is returned

+  in ExtraStackSize. If parameters are passed to the 16-bit real mode code,

+  then the actual minimum stack size is ExtraStackSize plus the maximum number

+  of bytes that need to be passed to the 16-bit real mode code.

+

+  If RealModeBufferSize is NULL, then ASSERT().

+  If ExtraStackSize is NULL, then ASSERT().

+

+  @param  RealModeBufferSize  A pointer to the size of the buffer below 1MB

+                              required to use the 16-bit thunk functions.

+  @param  ExtraStackSize      A pointer to the extra size of stack below 1MB

+                              that the 16-bit thunk functions require for

+                              temporary storage in the transition to and from

+                              16-bit real mode.

+

+**/

+VOID

+EFIAPI

+AsmGetThunk16Properties (

+  OUT     UINT32                    *RealModeBufferSize,

+  OUT     UINT32                    *ExtraStackSize

+  )

+{

+  ASSERT (RealModeBufferSize != NULL);

+  ASSERT (ExtraStackSize != NULL);

+

+  *RealModeBufferSize = m16Size;

+

+  //

+  // Extra 4 bytes for return address, and another 4 bytes for mode transition

+  //

+  *ExtraStackSize = sizeof (IA32_DWORD_REGS) + 8;

+}

+

+/**

+  Prepares all structures a code required to use AsmThunk16().

+

+  Prepares all structures and code required to use AsmThunk16().

+

+  This interface is limited to be used in either physical mode or virtual modes with paging enabled where the

+  virtual to physical mappings for ThunkContext.RealModeBuffer is mapped 1:1.

+

+  If ThunkContext is NULL, then ASSERT().

+

+  @param  ThunkContext  A pointer to the context structure that describes the

+                        16-bit real mode code to call.

+

+**/

+VOID

+EFIAPI

+AsmPrepareThunk16 (

+  IN OUT  THUNK_CONTEXT             *ThunkContext

+  )

+{

+  IA32_SEGMENT_DESCRIPTOR           *RealModeGdt;

+

+  ASSERT (ThunkContext != NULL);

+  ASSERT ((UINTN)ThunkContext->RealModeBuffer < 0x100000);

+  ASSERT (ThunkContext->RealModeBufferSize >= m16Size);

+  ASSERT ((UINTN)ThunkContext->RealModeBuffer + m16Size <= 0x100000);

+

+  CopyMem (ThunkContext->RealModeBuffer, &m16Start, m16Size);

+

+  //

+  // Point RealModeGdt to the GDT to be used in transition

+  //

+  // RealModeGdt[0]: Reserved as NULL descriptor

+  // RealModeGdt[1]: Code Segment

+  // RealModeGdt[2]: Data Segment

+  // RealModeGdt[3]: Call Gate

+  //

+  RealModeGdt = (IA32_SEGMENT_DESCRIPTOR*)(

+                  (UINTN)ThunkContext->RealModeBuffer + m16Gdt);

+

+  //

+  // Update Code & Data Segment Descriptor

+  //

+  RealModeGdt[1].Bits.BaseLow =

+    (UINT32)(UINTN)ThunkContext->RealModeBuffer & ~0xf;

+  RealModeGdt[1].Bits.BaseMid =

+    (UINT32)(UINTN)ThunkContext->RealModeBuffer >> 16;

+

+  //

+  // Update transition code entry point offset

+  //

+  *(UINT32*)((UINTN)ThunkContext->RealModeBuffer + mTransition) +=

+    (UINT32)(UINTN)ThunkContext->RealModeBuffer & 0xf;

+

+  //

+  // Update Segment Limits for both Code and Data Segment Descriptors

+  //

+  if ((ThunkContext->ThunkAttributes & THUNK_ATTRIBUTE_BIG_REAL_MODE) == 0) {

+    //

+    // Set segment limits to 64KB

+    //

+    RealModeGdt[1].Bits.LimitHigh = 0;

+    RealModeGdt[1].Bits.G = 0;

+    RealModeGdt[2].Bits.LimitHigh = 0;

+    RealModeGdt[2].Bits.G = 0;

+  }

+

+  //

+  // Update GDTBASE for this thunk context

+  //

+  *(VOID**)((UINTN)ThunkContext->RealModeBuffer + m16GdtrBase) = RealModeGdt;

+

+  //

+  // Update Thunk Attributes

+  //

+  *(UINT32*)((UINTN)ThunkContext->RealModeBuffer + mThunk16Attr) =

+    ThunkContext->ThunkAttributes;

+}

+

+/**

+  Transfers control to a 16-bit real mode entry point and returns the results.

+

+  Transfers control to a 16-bit real mode entry point and returns the results.

+  AsmPrepareThunk16() must be called with ThunkContext before this function is used.

+  This function must be called with interrupts disabled.

+

+  The register state from the RealModeState field of ThunkContext is restored just prior

+  to calling the 16-bit real mode entry point.  This includes the EFLAGS field of RealModeState,

+  which is used to set the interrupt state when a 16-bit real mode entry point is called.

+  Control is transferred to the 16-bit real mode entry point specified by the CS and Eip fields of RealModeState.

+  The stack is initialized to the SS and ESP fields of RealModeState.  Any parameters passed to

+  the 16-bit real mode code must be populated by the caller at SS:ESP prior to calling this function.

+  The 16-bit real mode entry point is invoked with a 16-bit CALL FAR instruction,

+  so when accessing stack contents, the 16-bit real mode code must account for the 16-bit segment

+  and 16-bit offset of the return address that were pushed onto the stack. The 16-bit real mode entry

+  point must exit with a RETF instruction. The register state is captured into RealModeState immediately

+  after the RETF instruction is executed.

+

+  If EFLAGS specifies interrupts enabled, or any of the 16-bit real mode code enables interrupts,

+  or any of the 16-bit real mode code makes a SW interrupt, then the caller is responsible for making sure

+  the IDT at address 0 is initialized to handle any HW or SW interrupts that may occur while in 16-bit real mode.

+

+  If EFLAGS specifies interrupts enabled, or any of the 16-bit real mode code enables interrupts,

+  then the caller is responsible for making sure the 8259 PIC is in a state compatible with 16-bit real mode.

+  This includes the base vectors, the interrupt masks, and the edge/level trigger mode.

+

+  If THUNK_ATTRIBUTE_BIG_REAL_MODE is set in the ThunkAttributes field of ThunkContext, then the user code

+  is invoked in big real mode.  Otherwise, the user code is invoked in 16-bit real mode with 64KB segment limits.

+

+  If neither THUNK_ATTRIBUTE_DISABLE_A20_MASK_INT_15 nor THUNK_ATTRIBUTE_DISABLE_A20_MASK_KBD_CTRL are set in

+  ThunkAttributes, then it is assumed that the user code did not enable the A20 mask, and no attempt is made to

+  disable the A20 mask.

+

+  If THUNK_ATTRIBUTE_DISABLE_A20_MASK_INT_15 is set and THUNK_ATTRIBUTE_DISABLE_A20_MASK_KBD_CTRL is clear in

+  ThunkAttributes, then attempt to use the INT 15 service to disable the A20 mask.  If this INT 15 call fails,

+  then attempt to disable the A20 mask by directly accessing the 8042 keyboard controller I/O ports.

+

+  If THUNK_ATTRIBUTE_DISABLE_A20_MASK_INT_15 is clear and THUNK_ATTRIBUTE_DISABLE_A20_MASK_KBD_CTRL is set in

+  ThunkAttributes, then attempt to disable the A20 mask by directly accessing the 8042 keyboard controller I/O ports.

+

+  If ThunkContext is NULL, then ASSERT().

+  If AsmPrepareThunk16() was not previously called with ThunkContext, then ASSERT().

+  If both THUNK_ATTRIBUTE_DISABLE_A20_MASK_INT_15 and THUNK_ATTRIBUTE_DISABLE_A20_MASK_KBD_CTRL are set in

+  ThunkAttributes, then ASSERT().

+

+  This interface is limited to be used in either physical mode or virtual modes with paging enabled where the

+  virtual to physical mappings for ThunkContext.RealModeBuffer is mapped 1:1.

+

+  @param  ThunkContext  A pointer to the context structure that describes the

+                        16-bit real mode code to call.

+

+**/

+VOID

+EFIAPI

+AsmThunk16 (

+  IN OUT  THUNK_CONTEXT             *ThunkContext

+  )

+{

+  IA32_REGISTER_SET                 *UpdatedRegs;

+

+  ASSERT (ThunkContext != NULL);

+  ASSERT ((UINTN)ThunkContext->RealModeBuffer < 0x100000);

+  ASSERT (ThunkContext->RealModeBufferSize >= m16Size);

+  ASSERT ((UINTN)ThunkContext->RealModeBuffer + m16Size <= 0x100000);

+  ASSERT (((ThunkContext->ThunkAttributes & (THUNK_ATTRIBUTE_DISABLE_A20_MASK_INT_15 | THUNK_ATTRIBUTE_DISABLE_A20_MASK_KBD_CTRL)) != \

+           (THUNK_ATTRIBUTE_DISABLE_A20_MASK_INT_15 | THUNK_ATTRIBUTE_DISABLE_A20_MASK_KBD_CTRL)));

+

+  UpdatedRegs = InternalAsmThunk16 (

+                  ThunkContext->RealModeState,

+                  ThunkContext->RealModeBuffer

+                  );

+

+  CopyMem (ThunkContext->RealModeState, UpdatedRegs, sizeof (*UpdatedRegs));

+}

+

+/**

+  Prepares all structures and code for a 16-bit real mode thunk, transfers

+  control to a 16-bit real mode entry point, and returns the results.

+

+  Prepares all structures and code for a 16-bit real mode thunk, transfers

+  control to a 16-bit real mode entry point, and returns the results. If the

+  caller only need to perform a single 16-bit real mode thunk, then this

+  service should be used. If the caller intends to make more than one 16-bit

+  real mode thunk, then it is more efficient if AsmPrepareThunk16() is called

+  once and AsmThunk16() can be called for each 16-bit real mode thunk.

+

+  This interface is limited to be used in either physical mode or virtual modes with paging enabled where the

+  virtual to physical mappings for ThunkContext.RealModeBuffer is mapped 1:1.

+

+  See AsmPrepareThunk16() and AsmThunk16() for the detailed description and ASSERT() conditions.

+

+  @param  ThunkContext  A pointer to the context structure that describes the

+                        16-bit real mode code to call.

+

+**/

+VOID

+EFIAPI

+AsmPrepareAndThunk16 (

+  IN OUT  THUNK_CONTEXT             *ThunkContext

+  )

+{

+  AsmPrepareThunk16 (ThunkContext);

+  AsmThunk16 (ThunkContext);

+}

diff --git a/debugging_demo/memtest86+/efi/Include/src/BaseLib/X86UnitTestHost.c b/debugging_demo/memtest86+/efi/Include/src/BaseLib/X86UnitTestHost.c
new file mode 100644
index 0000000..d0e4284
--- /dev/null
+++ b/debugging_demo/memtest86+/efi/Include/src/BaseLib/X86UnitTestHost.c
@@ -0,0 +1,2977 @@
+/** @file

+  IA32/X64 specific Unit Test Host functions.

+

+  Copyright (c) 2020, Intel Corporation. All rights reserved.<BR>

+  SPDX-License-Identifier: BSD-2-Clause-Patent

+

+**/

+

+#include "UnitTestHost.h"

+

+///

+/// Defines for mUnitTestHostBaseLibSegment indexes

+///

+#define UNIT_TEST_HOST_BASE_LIB_SEGMENT_CS    0

+#define UNIT_TEST_HOST_BASE_LIB_SEGMENT_DS    1

+#define UNIT_TEST_HOST_BASE_LIB_SEGMENT_ES    2

+#define UNIT_TEST_HOST_BASE_LIB_SEGMENT_FS    3

+#define UNIT_TEST_HOST_BASE_LIB_SEGMENT_GS    4

+#define UNIT_TEST_HOST_BASE_LIB_SEGMENT_SS    5

+#define UNIT_TEST_HOST_BASE_LIB_SEGMENT_TR    6

+#define UNIT_TEST_HOST_BASE_LIB_SEGMENT_LDTR  7

+

+///

+/// Module global variables for simple system emulation of MSRs, CRx, DRx,

+/// GDTR, IDTR, and Segment Selectors.

+///

+STATIC UINT64           mUnitTestHostBaseLibMsr[2][0x1000];

+STATIC UINTN            mUnitTestHostBaseLibCr[5];

+STATIC UINTN            mUnitTestHostBaseLibDr[8];

+STATIC UINT16           mUnitTestHostBaseLibSegment[8];

+STATIC IA32_DESCRIPTOR  mUnitTestHostBaseLibGdtr;

+STATIC IA32_DESCRIPTOR  mUnitTestHostBaseLibIdtr;

+

+/**

+  Retrieves CPUID information.

+

+  Executes the CPUID instruction with EAX set to the value specified by Index.

+  This function always returns Index.

+  If Eax is not NULL, then the value of EAX after CPUID is returned in Eax.

+  If Ebx is not NULL, then the value of EBX after CPUID is returned in Ebx.

+  If Ecx is not NULL, then the value of ECX after CPUID is returned in Ecx.

+  If Edx is not NULL, then the value of EDX after CPUID is returned in Edx.

+  This function is only available on IA-32 and x64.

+

+  @param  Index The 32-bit value to load into EAX prior to invoking the CPUID

+                instruction.

+  @param  Eax   The pointer to the 32-bit EAX value returned by the CPUID

+                instruction. This is an optional parameter that may be NULL.

+  @param  Ebx   The pointer to the 32-bit EBX value returned by the CPUID

+                instruction. This is an optional parameter that may be NULL.

+  @param  Ecx   The pointer to the 32-bit ECX value returned by the CPUID

+                instruction. This is an optional parameter that may be NULL.

+  @param  Edx   The pointer to the 32-bit EDX value returned by the CPUID

+                instruction. This is an optional parameter that may be NULL.

+

+  @return Index.

+

+**/

+UINT32

+EFIAPI

+UnitTestHostBaseLibAsmCpuid (

+  IN      UINT32                    Index,

+  OUT     UINT32                    *Eax,  OPTIONAL

+  OUT     UINT32                    *Ebx,  OPTIONAL

+  OUT     UINT32                    *Ecx,  OPTIONAL

+  OUT     UINT32                    *Edx   OPTIONAL

+  )

+{

+  if (Eax != NULL) {

+    *Eax = 0;

+  }

+  if (Ebx != NULL) {

+    *Ebx = 0;

+  }

+  if (Ecx != NULL) {

+    *Ecx = 0;

+  }

+  if (Edx != NULL) {

+    *Edx = 0;

+  }

+  return Index;

+}

+

+/**

+  Retrieves CPUID information using an extended leaf identifier.

+

+  Executes the CPUID instruction with EAX set to the value specified by Index

+  and ECX set to the value specified by SubIndex. This function always returns

+  Index. This function is only available on IA-32 and x64.

+

+  If Eax is not NULL, then the value of EAX after CPUID is returned in Eax.

+  If Ebx is not NULL, then the value of EBX after CPUID is returned in Ebx.

+  If Ecx is not NULL, then the value of ECX after CPUID is returned in Ecx.

+  If Edx is not NULL, then the value of EDX after CPUID is returned in Edx.

+

+  @param  Index     The 32-bit value to load into EAX prior to invoking the

+                    CPUID instruction.

+  @param  SubIndex  The 32-bit value to load into ECX prior to invoking the

+                    CPUID instruction.

+  @param  Eax       The pointer to the 32-bit EAX value returned by the CPUID

+                    instruction. This is an optional parameter that may be

+                    NULL.

+  @param  Ebx       The pointer to the 32-bit EBX value returned by the CPUID

+                    instruction. This is an optional parameter that may be

+                    NULL.

+  @param  Ecx       The pointer to the 32-bit ECX value returned by the CPUID

+                    instruction. This is an optional parameter that may be

+                    NULL.

+  @param  Edx       The pointer to the 32-bit EDX value returned by the CPUID

+                    instruction. This is an optional parameter that may be

+                    NULL.

+

+  @return Index.

+

+**/

+UINT32

+EFIAPI

+UnitTestHostBaseLibAsmCpuidEx (

+  IN      UINT32                    Index,

+  IN      UINT32                    SubIndex,

+  OUT     UINT32                    *Eax,  OPTIONAL

+  OUT     UINT32                    *Ebx,  OPTIONAL

+  OUT     UINT32                    *Ecx,  OPTIONAL

+  OUT     UINT32                    *Edx   OPTIONAL

+  )

+{

+  if (Eax != NULL) {

+    *Eax = 0;

+  }

+  if (Ebx != NULL) {

+    *Ebx = 0;

+  }

+  if (Ecx != NULL) {

+    *Ecx = 0;

+  }

+  if (Edx != NULL) {

+    *Edx = 0;

+  }

+  return Index;

+}

+

+/**

+  Set CD bit and clear NW bit of CR0 followed by a WBINVD.

+

+  Disables the caches by setting the CD bit of CR0 to 1, clearing the NW bit of CR0 to 0,

+  and executing a WBINVD instruction.  This function is only available on IA-32 and x64.

+

+**/

+VOID

+EFIAPI

+UnitTestHostBaseLibAsmDisableCache (

+  VOID

+  )

+{

+}

+

+/**

+  Perform a WBINVD and clear both the CD and NW bits of CR0.

+

+  Enables the caches by executing a WBINVD instruction and then clear both the CD and NW

+  bits of CR0 to 0.  This function is only available on IA-32 and x64.

+

+**/

+VOID

+EFIAPI

+UnitTestHostBaseLibAsmEnableCache (

+  VOID

+  )

+{

+}

+

+/**

+  Returns a 64-bit Machine Specific Register(MSR).

+

+  Reads and returns the 64-bit MSR specified by Index. No parameter checking is

+  performed on Index, and some Index values may cause CPU exceptions. The

+  caller must either guarantee that Index is valid, or the caller must set up

+  exception handlers to catch the exceptions. This function is only available

+  on IA-32 and x64.

+

+  @param  Index The 32-bit MSR index to read.

+

+  @return The value of the MSR identified by Index.

+

+**/

+UINT64

+EFIAPI

+UnitTestHostBaseLibAsmReadMsr64 (

+  IN      UINT32                    Index

+  )

+{

+  if (Index < 0x1000) {

+    return mUnitTestHostBaseLibMsr[0][Index];

+  }

+  if (Index >= 0xC0000000 && Index < 0xC0001000) {

+    return mUnitTestHostBaseLibMsr[1][Index];

+  }

+  return 0;

+}

+

+/**

+  Writes a 64-bit value to a Machine Specific Register(MSR), and returns the

+  value.

+

+  Writes the 64-bit value specified by Value to the MSR specified by Index. The

+  64-bit value written to the MSR is returned. No parameter checking is

+  performed on Index or Value, and some of these may cause CPU exceptions. The

+  caller must either guarantee that Index and Value are valid, or the caller

+  must establish proper exception handlers. This function is only available on

+  IA-32 and x64.

+

+  @param  Index The 32-bit MSR index to write.

+  @param  Value The 64-bit value to write to the MSR.

+

+  @return Value

+

+**/

+UINT64

+EFIAPI

+UnitTestHostBaseLibAsmWriteMsr64 (

+  IN      UINT32                    Index,

+  IN      UINT64                    Value

+  )

+{

+  if (Index < 0x1000) {

+    mUnitTestHostBaseLibMsr[0][Index] = Value;

+  }

+  if (Index >= 0xC0000000 && Index < 0xC0001000) {

+    mUnitTestHostBaseLibMsr[1][Index - 0xC00000000] = Value;

+  }

+  return Value;

+}

+

+/**

+  Reads the current value of the Control Register 0 (CR0).

+

+  Reads and returns the current value of CR0. This function is only available

+  on IA-32 and x64. This returns a 32-bit value on IA-32 and a 64-bit value on

+  x64.

+

+  @return The value of the Control Register 0 (CR0).

+

+**/

+UINTN

+EFIAPI

+UnitTestHostBaseLibAsmReadCr0 (

+  VOID

+  )

+{

+  return mUnitTestHostBaseLibCr[0];

+}

+

+/**

+  Reads the current value of the Control Register 2 (CR2).

+

+  Reads and returns the current value of CR2. This function is only available

+  on IA-32 and x64. This returns a 32-bit value on IA-32 and a 64-bit value on

+  x64.

+

+  @return The value of the Control Register 2 (CR2).

+

+**/

+UINTN

+EFIAPI

+UnitTestHostBaseLibAsmReadCr2 (

+  VOID

+  )

+{

+  return mUnitTestHostBaseLibCr[2];

+}

+

+/**

+  Reads the current value of the Control Register 3 (CR3).

+

+  Reads and returns the current value of CR3. This function is only available

+  on IA-32 and x64. This returns a 32-bit value on IA-32 and a 64-bit value on

+  x64.

+

+  @return The value of the Control Register 3 (CR3).

+

+**/

+UINTN

+EFIAPI

+UnitTestHostBaseLibAsmReadCr3 (

+  VOID

+  )

+{

+  return mUnitTestHostBaseLibCr[3];

+}

+

+/**

+  Reads the current value of the Control Register 4 (CR4).

+

+  Reads and returns the current value of CR4. This function is only available

+  on IA-32 and x64. This returns a 32-bit value on IA-32 and a 64-bit value on

+  x64.

+

+  @return The value of the Control Register 4 (CR4).

+

+**/

+UINTN

+EFIAPI

+UnitTestHostBaseLibAsmReadCr4 (

+  VOID

+  )

+{

+  return mUnitTestHostBaseLibCr[4];

+}

+

+/**

+  Writes a value to Control Register 0 (CR0).

+

+  Writes and returns a new value to CR0. This function is only available on

+  IA-32 and x64. This writes a 32-bit value on IA-32 and a 64-bit value on x64.

+

+  @param  Cr0 The value to write to CR0.

+

+  @return The value written to CR0.

+

+**/

+UINTN

+EFIAPI

+UnitTestHostBaseLibAsmWriteCr0 (

+  UINTN  Cr0

+  )

+{

+  mUnitTestHostBaseLibCr[0] = Cr0;

+  return Cr0;

+}

+

+/**

+  Writes a value to Control Register 2 (CR2).

+

+  Writes and returns a new value to CR2. This function is only available on

+  IA-32 and x64. This writes a 32-bit value on IA-32 and a 64-bit value on x64.

+

+  @param  Cr2 The value to write to CR2.

+

+  @return The value written to CR2.

+

+**/

+UINTN

+EFIAPI

+UnitTestHostBaseLibAsmWriteCr2 (

+  UINTN  Cr2

+  )

+{

+  mUnitTestHostBaseLibCr[2] = Cr2;

+  return Cr2;

+}

+

+/**

+  Writes a value to Control Register 3 (CR3).

+

+  Writes and returns a new value to CR3. This function is only available on

+  IA-32 and x64. This writes a 32-bit value on IA-32 and a 64-bit value on x64.

+

+  @param  Cr3 The value to write to CR3.

+

+  @return The value written to CR3.

+

+**/

+UINTN

+EFIAPI

+UnitTestHostBaseLibAsmWriteCr3 (

+  UINTN  Cr3

+  )

+{

+  mUnitTestHostBaseLibCr[3] = Cr3;

+  return Cr3;

+}

+

+/**

+  Writes a value to Control Register 4 (CR4).

+

+  Writes and returns a new value to CR4. This function is only available on

+  IA-32 and x64. This writes a 32-bit value on IA-32 and a 64-bit value on x64.

+

+  @param  Cr4 The value to write to CR4.

+

+  @return The value written to CR4.

+

+**/

+UINTN

+EFIAPI

+UnitTestHostBaseLibAsmWriteCr4 (

+  UINTN  Cr4

+  )

+{

+  mUnitTestHostBaseLibCr[4] = Cr4;

+  return Cr4;

+}

+

+/**

+  Reads the current value of Debug Register 0 (DR0).

+

+  Reads and returns the current value of DR0. This function is only available

+  on IA-32 and x64. This returns a 32-bit value on IA-32 and a 64-bit value on

+  x64.

+

+  @return The value of Debug Register 0 (DR0).

+

+**/

+UINTN

+EFIAPI

+UnitTestHostBaseLibAsmReadDr0 (

+  VOID

+  )

+{

+  return mUnitTestHostBaseLibDr[0];

+}

+

+/**

+  Reads the current value of Debug Register 1 (DR1).

+

+  Reads and returns the current value of DR1. This function is only available

+  on IA-32 and x64. This returns a 32-bit value on IA-32 and a 64-bit value on

+  x64.

+

+  @return The value of Debug Register 1 (DR1).

+

+**/

+UINTN

+EFIAPI

+UnitTestHostBaseLibAsmReadDr1 (

+  VOID

+  )

+{

+  return mUnitTestHostBaseLibDr[1];

+}

+

+/**

+  Reads the current value of Debug Register 2 (DR2).

+

+  Reads and returns the current value of DR2. This function is only available

+  on IA-32 and x64. This returns a 32-bit value on IA-32 and a 64-bit value on

+  x64.

+

+  @return The value of Debug Register 2 (DR2).

+

+**/

+UINTN

+EFIAPI

+UnitTestHostBaseLibAsmReadDr2 (

+  VOID

+  )

+{

+  return mUnitTestHostBaseLibDr[2];

+}

+

+/**

+  Reads the current value of Debug Register 3 (DR3).

+

+  Reads and returns the current value of DR3. This function is only available

+  on IA-32 and x64. This returns a 32-bit value on IA-32 and a 64-bit value on

+  x64.

+

+  @return The value of Debug Register 3 (DR3).

+

+**/

+UINTN

+EFIAPI

+UnitTestHostBaseLibAsmReadDr3 (

+  VOID

+  )

+{

+  return mUnitTestHostBaseLibDr[3];

+}

+

+/**

+  Reads the current value of Debug Register 4 (DR4).

+

+  Reads and returns the current value of DR4. This function is only available

+  on IA-32 and x64. This returns a 32-bit value on IA-32 and a 64-bit value on

+  x64.

+

+  @return The value of Debug Register 4 (DR4).

+

+**/

+UINTN

+EFIAPI

+UnitTestHostBaseLibAsmReadDr4 (

+  VOID

+  )

+{

+  return mUnitTestHostBaseLibDr[4];

+}

+

+/**

+  Reads the current value of Debug Register 5 (DR5).

+

+  Reads and returns the current value of DR5. This function is only available

+  on IA-32 and x64. This returns a 32-bit value on IA-32 and a 64-bit value on

+  x64.

+

+  @return The value of Debug Register 5 (DR5).

+

+**/

+UINTN

+EFIAPI

+UnitTestHostBaseLibAsmReadDr5 (

+  VOID

+  )

+{

+  return mUnitTestHostBaseLibDr[5];

+}

+

+/**

+  Reads the current value of Debug Register 6 (DR6).

+

+  Reads and returns the current value of DR6. This function is only available

+  on IA-32 and x64. This returns a 32-bit value on IA-32 and a 64-bit value on

+  x64.

+

+  @return The value of Debug Register 6 (DR6).

+

+**/

+UINTN

+EFIAPI

+UnitTestHostBaseLibAsmReadDr6 (

+  VOID

+  )

+{

+  return mUnitTestHostBaseLibDr[6];

+}

+

+/**

+  Reads the current value of Debug Register 7 (DR7).

+

+  Reads and returns the current value of DR7. This function is only available

+  on IA-32 and x64. This returns a 32-bit value on IA-32 and a 64-bit value on

+  x64.

+

+  @return The value of Debug Register 7 (DR7).

+

+**/

+UINTN

+EFIAPI

+UnitTestHostBaseLibAsmReadDr7 (

+  VOID

+  )

+{

+  return mUnitTestHostBaseLibDr[7];

+}

+

+/**

+  Writes a value to Debug Register 0 (DR0).

+

+  Writes and returns a new value to DR0. This function is only available on

+  IA-32 and x64. This writes a 32-bit value on IA-32 and a 64-bit value on x64.

+

+  @param  Dr0 The value to write to Dr0.

+

+  @return The value written to Debug Register 0 (DR0).

+

+**/

+UINTN

+EFIAPI

+UnitTestHostBaseLibAsmWriteDr0 (

+  UINTN  Dr0

+  )

+{

+  mUnitTestHostBaseLibDr[0] = Dr0;

+  return Dr0;

+}

+

+/**

+  Writes a value to Debug Register 1 (DR1).

+

+  Writes and returns a new value to DR1. This function is only available on

+  IA-32 and x64. This writes a 32-bit value on IA-32 and a 64-bit value on x64.

+

+  @param  Dr1 The value to write to Dr1.

+

+  @return The value written to Debug Register 1 (DR1).

+

+**/

+UINTN

+EFIAPI

+UnitTestHostBaseLibAsmWriteDr1 (

+  UINTN  Dr1

+  )

+{

+  mUnitTestHostBaseLibDr[1] = Dr1;

+  return Dr1;

+}

+

+/**

+  Writes a value to Debug Register 2 (DR2).

+

+  Writes and returns a new value to DR2. This function is only available on

+  IA-32 and x64. This writes a 32-bit value on IA-32 and a 64-bit value on x64.

+

+  @param  Dr2 The value to write to Dr2.

+

+  @return The value written to Debug Register 2 (DR2).

+

+**/

+UINTN

+EFIAPI

+UnitTestHostBaseLibAsmWriteDr2 (

+  UINTN  Dr2

+  )

+{

+  mUnitTestHostBaseLibDr[2] = Dr2;

+  return Dr2;

+}

+

+/**

+  Writes a value to Debug Register 3 (DR3).

+

+  Writes and returns a new value to DR3. This function is only available on

+  IA-32 and x64. This writes a 32-bit value on IA-32 and a 64-bit value on x64.

+

+  @param  Dr3 The value to write to Dr3.

+

+  @return The value written to Debug Register 3 (DR3).

+

+**/

+UINTN

+EFIAPI

+UnitTestHostBaseLibAsmWriteDr3 (

+  UINTN  Dr3

+  )

+{

+  mUnitTestHostBaseLibDr[3] = Dr3;

+  return Dr3;

+}

+

+/**

+  Writes a value to Debug Register 4 (DR4).

+

+  Writes and returns a new value to DR4. This function is only available on

+  IA-32 and x64. This writes a 32-bit value on IA-32 and a 64-bit value on x64.

+

+  @param  Dr4 The value to write to Dr4.

+

+  @return The value written to Debug Register 4 (DR4).

+

+**/

+UINTN

+EFIAPI

+UnitTestHostBaseLibAsmWriteDr4 (

+  UINTN  Dr4

+  )

+{

+  mUnitTestHostBaseLibDr[4] = Dr4;

+  return Dr4;

+}

+

+/**

+  Writes a value to Debug Register 5 (DR5).

+

+  Writes and returns a new value to DR5. This function is only available on

+  IA-32 and x64. This writes a 32-bit value on IA-32 and a 64-bit value on x64.

+

+  @param  Dr5 The value to write to Dr5.

+

+  @return The value written to Debug Register 5 (DR5).

+

+**/

+UINTN

+EFIAPI

+UnitTestHostBaseLibAsmWriteDr5 (

+  UINTN  Dr5

+  )

+{

+  mUnitTestHostBaseLibDr[5] = Dr5;

+  return Dr5;

+}

+

+/**

+  Writes a value to Debug Register 6 (DR6).

+

+  Writes and returns a new value to DR6. This function is only available on

+  IA-32 and x64. This writes a 32-bit value on IA-32 and a 64-bit value on x64.

+

+  @param  Dr6 The value to write to Dr6.

+

+  @return The value written to Debug Register 6 (DR6).

+

+**/

+UINTN

+EFIAPI

+UnitTestHostBaseLibAsmWriteDr6 (

+  UINTN  Dr6

+  )

+{

+  mUnitTestHostBaseLibDr[6] = Dr6;

+  return Dr6;

+}

+

+/**

+  Writes a value to Debug Register 7 (DR7).

+

+  Writes and returns a new value to DR7. This function is only available on

+  IA-32 and x64. This writes a 32-bit value on IA-32 and a 64-bit value on x64.

+

+  @param  Dr7 The value to write to Dr7.

+

+  @return The value written to Debug Register 7 (DR7).

+

+**/

+UINTN

+EFIAPI

+UnitTestHostBaseLibAsmWriteDr7 (

+  UINTN  Dr7

+  )

+{

+  mUnitTestHostBaseLibDr[7] = Dr7;

+  return Dr7;

+}

+

+/**

+  Reads the current value of Code Segment Register (CS).

+

+  Reads and returns the current value of CS. This function is only available on

+  IA-32 and x64.

+

+  @return The current value of CS.

+

+**/

+UINT16

+EFIAPI

+UnitTestHostBaseLibAsmReadCs (

+  VOID

+  )

+{

+  return mUnitTestHostBaseLibSegment[UNIT_TEST_HOST_BASE_LIB_SEGMENT_CS];

+}

+

+/**

+  Reads the current value of Data Segment Register (DS).

+

+  Reads and returns the current value of DS. This function is only available on

+  IA-32 and x64.

+

+  @return The current value of DS.

+

+**/

+UINT16

+EFIAPI

+UnitTestHostBaseLibAsmReadDs (

+  VOID

+  )

+{

+  return mUnitTestHostBaseLibSegment[UNIT_TEST_HOST_BASE_LIB_SEGMENT_DS];

+}

+

+/**

+  Reads the current value of Extra Segment Register (ES).

+

+  Reads and returns the current value of ES. This function is only available on

+  IA-32 and x64.

+

+  @return The current value of ES.

+

+**/

+UINT16

+EFIAPI

+UnitTestHostBaseLibAsmReadEs (

+  VOID

+  )

+{

+  return mUnitTestHostBaseLibSegment[UNIT_TEST_HOST_BASE_LIB_SEGMENT_ES];

+}

+

+/**

+  Reads the current value of FS Data Segment Register (FS).

+

+  Reads and returns the current value of FS. This function is only available on

+  IA-32 and x64.

+

+  @return The current value of FS.

+

+**/

+UINT16

+EFIAPI

+UnitTestHostBaseLibAsmReadFs (

+  VOID

+  )

+{

+  return mUnitTestHostBaseLibSegment[UNIT_TEST_HOST_BASE_LIB_SEGMENT_FS];

+}

+

+/**

+  Reads the current value of GS Data Segment Register (GS).

+

+  Reads and returns the current value of GS. This function is only available on

+  IA-32 and x64.

+

+  @return The current value of GS.

+

+**/

+UINT16

+EFIAPI

+UnitTestHostBaseLibAsmReadGs (

+  VOID

+  )

+{

+  return mUnitTestHostBaseLibSegment[UNIT_TEST_HOST_BASE_LIB_SEGMENT_GS];

+}

+

+/**

+  Reads the current value of Stack Segment Register (SS).

+

+  Reads and returns the current value of SS. This function is only available on

+  IA-32 and x64.

+

+  @return The current value of SS.

+

+**/

+UINT16

+EFIAPI

+UnitTestHostBaseLibAsmReadSs (

+  VOID

+  )

+{

+  return mUnitTestHostBaseLibSegment[UNIT_TEST_HOST_BASE_LIB_SEGMENT_SS];

+}

+

+/**

+  Reads the current value of Task Register (TR).

+

+  Reads and returns the current value of TR. This function is only available on

+  IA-32 and x64.

+

+  @return The current value of TR.

+

+**/

+UINT16

+EFIAPI

+UnitTestHostBaseLibAsmReadTr (

+  VOID

+  )

+{

+  return mUnitTestHostBaseLibSegment[UNIT_TEST_HOST_BASE_LIB_SEGMENT_TR];

+}

+

+/**

+  Reads the current Global Descriptor Table Register(GDTR) descriptor.

+

+  Reads and returns the current GDTR descriptor and returns it in Gdtr. This

+  function is only available on IA-32 and x64.

+

+  If Gdtr is NULL, then ASSERT().

+

+  @param  Gdtr  The pointer to a GDTR descriptor.

+

+**/

+VOID

+EFIAPI

+UnitTestHostBaseLibAsmReadGdtr (

+  OUT     IA32_DESCRIPTOR           *Gdtr

+  )

+{

+  Gdtr = &mUnitTestHostBaseLibGdtr;

+}

+

+/**

+  Writes the current Global Descriptor Table Register (GDTR) descriptor.

+

+  Writes and the current GDTR descriptor specified by Gdtr. This function is

+  only available on IA-32 and x64.

+

+  If Gdtr is NULL, then ASSERT().

+

+  @param  Gdtr  The pointer to a GDTR descriptor.

+

+**/

+VOID

+EFIAPI

+UnitTestHostBaseLibAsmWriteGdtr (

+  IN      CONST IA32_DESCRIPTOR     *Gdtr

+  )

+{

+  CopyMem (&mUnitTestHostBaseLibGdtr, Gdtr, sizeof (IA32_DESCRIPTOR));

+}

+

+/**

+  Reads the current Interrupt Descriptor Table Register(IDTR) descriptor.

+

+  Reads and returns the current IDTR descriptor and returns it in Idtr. This

+  function is only available on IA-32 and x64.

+

+  If Idtr is NULL, then ASSERT().

+

+  @param  Idtr  The pointer to a IDTR descriptor.

+

+**/

+VOID

+EFIAPI

+UnitTestHostBaseLibAsmReadIdtr (

+  OUT     IA32_DESCRIPTOR           *Idtr

+  )

+{

+  Idtr = &mUnitTestHostBaseLibIdtr;

+}

+

+/**

+  Writes the current Interrupt Descriptor Table Register(IDTR) descriptor.

+

+  Writes the current IDTR descriptor and returns it in Idtr. This function is

+  only available on IA-32 and x64.

+

+  If Idtr is NULL, then ASSERT().

+

+  @param  Idtr  The pointer to a IDTR descriptor.

+

+**/

+VOID

+EFIAPI

+UnitTestHostBaseLibAsmWriteIdtr (

+  IN      CONST IA32_DESCRIPTOR     *Idtr

+  )

+{

+  CopyMem (&mUnitTestHostBaseLibIdtr, Idtr, sizeof (IA32_DESCRIPTOR));

+}

+

+/**

+  Reads the current Local Descriptor Table Register(LDTR) selector.

+

+  Reads and returns the current 16-bit LDTR descriptor value. This function is

+  only available on IA-32 and x64.

+

+  @return The current selector of LDT.

+

+**/

+UINT16

+EFIAPI

+UnitTestHostBaseLibAsmReadLdtr (

+  VOID

+  )

+{

+  return mUnitTestHostBaseLibSegment[UNIT_TEST_HOST_BASE_LIB_SEGMENT_LDTR];

+}

+

+/**

+  Writes the current Local Descriptor Table Register (LDTR) selector.

+

+  Writes and the current LDTR descriptor specified by Ldtr. This function is

+  only available on IA-32 and x64.

+

+  @param  Ldtr  16-bit LDTR selector value.

+

+**/

+VOID

+EFIAPI

+UnitTestHostBaseLibAsmWriteLdtr (

+  IN      UINT16                    Ldtr

+  )

+{

+  mUnitTestHostBaseLibSegment[UNIT_TEST_HOST_BASE_LIB_SEGMENT_LDTR] = Ldtr;

+}

+

+/**

+  Reads the current value of a Performance Counter (PMC).

+

+  Reads and returns the current value of performance counter specified by

+  Index. This function is only available on IA-32 and x64.

+

+  @param  Index The 32-bit Performance Counter index to read.

+

+  @return The value of the PMC specified by Index.

+

+**/

+UINT64

+EFIAPI

+UnitTestHostBaseLibAsmReadPmc (

+  IN      UINT32                    Index

+  )

+{

+  return 0;

+}

+

+/**

+  Sets up a monitor buffer that is used by AsmMwait().

+

+  Executes a MONITOR instruction with the register state specified by Eax, Ecx

+  and Edx. Returns Eax. This function is only available on IA-32 and x64.

+

+  @param  Eax The value to load into EAX or RAX before executing the MONITOR

+              instruction.

+  @param  Ecx The value to load into ECX or RCX before executing the MONITOR

+              instruction.

+  @param  Edx The value to load into EDX or RDX before executing the MONITOR

+              instruction.

+

+  @return Eax

+

+**/

+UINTN

+EFIAPI

+UnitTestHostBaseLibAsmMonitor (

+  IN      UINTN                     Eax,

+  IN      UINTN                     Ecx,

+  IN      UINTN                     Edx

+  )

+{

+  return Eax;

+}

+

+/**

+  Executes an MWAIT instruction.

+

+  Executes an MWAIT instruction with the register state specified by Eax and

+  Ecx. Returns Eax. This function is only available on IA-32 and x64.

+

+  @param  Eax The value to load into EAX or RAX before executing the MONITOR

+              instruction.

+  @param  Ecx The value to load into ECX or RCX before executing the MONITOR

+              instruction.

+

+  @return Eax

+

+**/

+UINTN

+EFIAPI

+UnitTestHostBaseLibAsmMwait (

+  IN      UINTN                     Eax,

+  IN      UINTN                     Ecx

+  )

+{

+  return Eax;

+}

+

+/**

+  Executes a WBINVD instruction.

+

+  Executes a WBINVD instruction. This function is only available on IA-32 and

+  x64.

+

+**/

+VOID

+EFIAPI

+UnitTestHostBaseLibAsmWbinvd (

+  VOID

+  )

+{

+}

+

+/**

+  Executes a INVD instruction.

+

+  Executes a INVD instruction. This function is only available on IA-32 and

+  x64.

+

+**/

+VOID

+EFIAPI

+UnitTestHostBaseLibAsmInvd (

+  VOID

+  )

+{

+}

+

+/**

+  Flushes a cache line from all the instruction and data caches within the

+  coherency domain of the CPU.

+

+  Flushed the cache line specified by LinearAddress, and returns LinearAddress.

+  This function is only available on IA-32 and x64.

+

+  @param  LinearAddress The address of the cache line to flush. If the CPU is

+                        in a physical addressing mode, then LinearAddress is a

+                        physical address. If the CPU is in a virtual

+                        addressing mode, then LinearAddress is a virtual

+                        address.

+

+  @return LinearAddress.

+**/

+VOID *

+EFIAPI

+UnitTestHostBaseLibAsmFlushCacheLine (

+  IN      VOID                      *LinearAddress

+  )

+{

+  return LinearAddress;

+}

+

+/**

+  Enables the 32-bit paging mode on the CPU.

+

+  Enables the 32-bit paging mode on the CPU. CR0, CR3, CR4, and the page tables

+  must be properly initialized prior to calling this service. This function

+  assumes the current execution mode is 32-bit protected mode. This function is

+  only available on IA-32. After the 32-bit paging mode is enabled, control is

+  transferred to the function specified by EntryPoint using the new stack

+  specified by NewStack and passing in the parameters specified by Context1 and

+  Context2. Context1 and Context2 are optional and may be NULL. The function

+  EntryPoint must never return.

+

+  If the current execution mode is not 32-bit protected mode, then ASSERT().

+  If EntryPoint is NULL, then ASSERT().

+  If NewStack is NULL, then ASSERT().

+

+  There are a number of constraints that must be followed before calling this

+  function:

+  1)  Interrupts must be disabled.

+  2)  The caller must be in 32-bit protected mode with flat descriptors. This

+      means all descriptors must have a base of 0 and a limit of 4GB.

+  3)  CR0 and CR4 must be compatible with 32-bit protected mode with flat

+      descriptors.

+  4)  CR3 must point to valid page tables that will be used once the transition

+      is complete, and those page tables must guarantee that the pages for this

+      function and the stack are identity mapped.

+

+  @param  EntryPoint  A pointer to function to call with the new stack after

+                      paging is enabled.

+  @param  Context1    A pointer to the context to pass into the EntryPoint

+                      function as the first parameter after paging is enabled.

+  @param  Context2    A pointer to the context to pass into the EntryPoint

+                      function as the second parameter after paging is enabled.

+  @param  NewStack    A pointer to the new stack to use for the EntryPoint

+                      function after paging is enabled.

+

+**/

+VOID

+EFIAPI

+UnitTestHostBaseLibAsmEnablePaging32 (

+  IN      SWITCH_STACK_ENTRY_POINT  EntryPoint,

+  IN      VOID                      *Context1,  OPTIONAL

+  IN      VOID                      *Context2,  OPTIONAL

+  IN      VOID                      *NewStack

+  )

+{

+  EntryPoint (Context1, Context2);

+}

+

+/**

+  Disables the 32-bit paging mode on the CPU.

+

+  Disables the 32-bit paging mode on the CPU and returns to 32-bit protected

+  mode. This function assumes the current execution mode is 32-paged protected

+  mode. This function is only available on IA-32. After the 32-bit paging mode

+  is disabled, control is transferred to the function specified by EntryPoint

+  using the new stack specified by NewStack and passing in the parameters

+  specified by Context1 and Context2. Context1 and Context2 are optional and

+  may be NULL. The function EntryPoint must never return.

+

+  If the current execution mode is not 32-bit paged mode, then ASSERT().

+  If EntryPoint is NULL, then ASSERT().

+  If NewStack is NULL, then ASSERT().

+

+  There are a number of constraints that must be followed before calling this

+  function:

+  1)  Interrupts must be disabled.

+  2)  The caller must be in 32-bit paged mode.

+  3)  CR0, CR3, and CR4 must be compatible with 32-bit paged mode.

+  4)  CR3 must point to valid page tables that guarantee that the pages for

+      this function and the stack are identity mapped.

+

+  @param  EntryPoint  A pointer to function to call with the new stack after

+                      paging is disabled.

+  @param  Context1    A pointer to the context to pass into the EntryPoint

+                      function as the first parameter after paging is disabled.

+  @param  Context2    A pointer to the context to pass into the EntryPoint

+                      function as the second parameter after paging is

+                      disabled.

+  @param  NewStack    A pointer to the new stack to use for the EntryPoint

+                      function after paging is disabled.

+

+**/

+VOID

+EFIAPI

+UnitTestHostBaseLibAsmDisablePaging32 (

+  IN      SWITCH_STACK_ENTRY_POINT  EntryPoint,

+  IN      VOID                      *Context1,  OPTIONAL

+  IN      VOID                      *Context2,  OPTIONAL

+  IN      VOID                      *NewStack

+  )

+{

+  EntryPoint (Context1, Context2);

+}

+

+/**

+  Enables the 64-bit paging mode on the CPU.

+

+  Enables the 64-bit paging mode on the CPU. CR0, CR3, CR4, and the page tables

+  must be properly initialized prior to calling this service. This function

+  assumes the current execution mode is 32-bit protected mode with flat

+  descriptors. This function is only available on IA-32. After the 64-bit

+  paging mode is enabled, control is transferred to the function specified by

+  EntryPoint using the new stack specified by NewStack and passing in the

+  parameters specified by Context1 and Context2. Context1 and Context2 are

+  optional and may be 0. The function EntryPoint must never return.

+

+  If the current execution mode is not 32-bit protected mode with flat

+  descriptors, then ASSERT().

+  If EntryPoint is 0, then ASSERT().

+  If NewStack is 0, then ASSERT().

+

+  @param  Cs          The 16-bit selector to load in the CS before EntryPoint

+                      is called. The descriptor in the GDT that this selector

+                      references must be setup for long mode.

+  @param  EntryPoint  The 64-bit virtual address of the function to call with

+                      the new stack after paging is enabled.

+  @param  Context1    The 64-bit virtual address of the context to pass into

+                      the EntryPoint function as the first parameter after

+                      paging is enabled.

+  @param  Context2    The 64-bit virtual address of the context to pass into

+                      the EntryPoint function as the second parameter after

+                      paging is enabled.

+  @param  NewStack    The 64-bit virtual address of the new stack to use for

+                      the EntryPoint function after paging is enabled.

+

+**/

+VOID

+EFIAPI

+UnitTestHostBaseLibAsmEnablePaging64 (

+  IN      UINT16                    Cs,

+  IN      UINT64                    EntryPoint,

+  IN      UINT64                    Context1,  OPTIONAL

+  IN      UINT64                    Context2,  OPTIONAL

+  IN      UINT64                    NewStack

+  )

+{

+  SWITCH_STACK_ENTRY_POINT  NewEntryPoint;

+

+  NewEntryPoint = (SWITCH_STACK_ENTRY_POINT)(UINTN)(EntryPoint);

+  NewEntryPoint ((VOID *)(UINTN)Context1, (VOID *)(UINTN)Context2);

+}

+

+/**

+  Disables the 64-bit paging mode on the CPU.

+

+  Disables the 64-bit paging mode on the CPU and returns to 32-bit protected

+  mode. This function assumes the current execution mode is 64-paging mode.

+  This function is only available on x64. After the 64-bit paging mode is

+  disabled, control is transferred to the function specified by EntryPoint

+  using the new stack specified by NewStack and passing in the parameters

+  specified by Context1 and Context2. Context1 and Context2 are optional and

+  may be 0. The function EntryPoint must never return.

+

+  If the current execution mode is not 64-bit paged mode, then ASSERT().

+  If EntryPoint is 0, then ASSERT().

+  If NewStack is 0, then ASSERT().

+

+  @param  Cs          The 16-bit selector to load in the CS before EntryPoint

+                      is called. The descriptor in the GDT that this selector

+                      references must be setup for 32-bit protected mode.

+  @param  EntryPoint  The 64-bit virtual address of the function to call with

+                      the new stack after paging is disabled.

+  @param  Context1    The 64-bit virtual address of the context to pass into

+                      the EntryPoint function as the first parameter after

+                      paging is disabled.

+  @param  Context2    The 64-bit virtual address of the context to pass into

+                      the EntryPoint function as the second parameter after

+                      paging is disabled.

+  @param  NewStack    The 64-bit virtual address of the new stack to use for

+                      the EntryPoint function after paging is disabled.

+

+**/

+VOID

+EFIAPI

+UnitTestHostBaseLibAsmDisablePaging64 (

+  IN      UINT16                    Cs,

+  IN      UINT32                    EntryPoint,

+  IN      UINT32                    Context1,  OPTIONAL

+  IN      UINT32                    Context2,  OPTIONAL

+  IN      UINT32                    NewStack

+  )

+{

+  SWITCH_STACK_ENTRY_POINT  NewEntryPoint;

+

+  NewEntryPoint = (SWITCH_STACK_ENTRY_POINT)(UINTN)(EntryPoint);

+  NewEntryPoint ((VOID *)(UINTN)Context1, (VOID *)(UINTN)Context2);

+}

+

+/**

+  Retrieves the properties for 16-bit thunk functions.

+

+  Computes the size of the buffer and stack below 1MB required to use the

+  AsmPrepareThunk16(), AsmThunk16() and AsmPrepareAndThunk16() functions. This

+  buffer size is returned in RealModeBufferSize, and the stack size is returned

+  in ExtraStackSize. If parameters are passed to the 16-bit real mode code,

+  then the actual minimum stack size is ExtraStackSize plus the maximum number

+  of bytes that need to be passed to the 16-bit real mode code.

+

+  If RealModeBufferSize is NULL, then ASSERT().

+  If ExtraStackSize is NULL, then ASSERT().

+

+  @param  RealModeBufferSize  A pointer to the size of the buffer below 1MB

+                              required to use the 16-bit thunk functions.

+  @param  ExtraStackSize      A pointer to the extra size of stack below 1MB

+                              that the 16-bit thunk functions require for

+                              temporary storage in the transition to and from

+                              16-bit real mode.

+

+**/

+VOID

+EFIAPI

+UnitTestHostBaseLibAsmGetThunk16Properties (

+  OUT     UINT32                    *RealModeBufferSize,

+  OUT     UINT32                    *ExtraStackSize

+  )

+{

+  *RealModeBufferSize = 0;

+  *ExtraStackSize     = 0;

+}

+

+/**

+  Prepares all structures a code required to use AsmThunk16().

+

+  Prepares all structures and code required to use AsmThunk16().

+

+  This interface is limited to be used in either physical mode or virtual modes with paging enabled where the

+  virtual to physical mappings for ThunkContext.RealModeBuffer is mapped 1:1.

+

+  If ThunkContext is NULL, then ASSERT().

+

+  @param  ThunkContext  A pointer to the context structure that describes the

+                        16-bit real mode code to call.

+

+**/

+VOID

+EFIAPI

+UnitTestHostBaseLibAsmPrepareThunk16 (

+  IN OUT  THUNK_CONTEXT             *ThunkContext

+  )

+{

+}

+

+/**

+  Transfers control to a 16-bit real mode entry point and returns the results.

+

+  Transfers control to a 16-bit real mode entry point and returns the results.

+  AsmPrepareThunk16() must be called with ThunkContext before this function is used.

+  This function must be called with interrupts disabled.

+

+  The register state from the RealModeState field of ThunkContext is restored just prior

+  to calling the 16-bit real mode entry point.  This includes the EFLAGS field of RealModeState,

+  which is used to set the interrupt state when a 16-bit real mode entry point is called.

+  Control is transferred to the 16-bit real mode entry point specified by the CS and Eip fields of RealModeState.

+  The stack is initialized to the SS and ESP fields of RealModeState.  Any parameters passed to

+  the 16-bit real mode code must be populated by the caller at SS:ESP prior to calling this function.

+  The 16-bit real mode entry point is invoked with a 16-bit CALL FAR instruction,

+  so when accessing stack contents, the 16-bit real mode code must account for the 16-bit segment

+  and 16-bit offset of the return address that were pushed onto the stack. The 16-bit real mode entry

+  point must exit with a RETF instruction. The register state is captured into RealModeState immediately

+  after the RETF instruction is executed.

+

+  If EFLAGS specifies interrupts enabled, or any of the 16-bit real mode code enables interrupts,

+  or any of the 16-bit real mode code makes a SW interrupt, then the caller is responsible for making sure

+  the IDT at address 0 is initialized to handle any HW or SW interrupts that may occur while in 16-bit real mode.

+

+  If EFLAGS specifies interrupts enabled, or any of the 16-bit real mode code enables interrupts,

+  then the caller is responsible for making sure the 8259 PIC is in a state compatible with 16-bit real mode.

+  This includes the base vectors, the interrupt masks, and the edge/level trigger mode.

+

+  If THUNK_ATTRIBUTE_BIG_REAL_MODE is set in the ThunkAttributes field of ThunkContext, then the user code

+  is invoked in big real mode.  Otherwise, the user code is invoked in 16-bit real mode with 64KB segment limits.

+

+  If neither THUNK_ATTRIBUTE_DISABLE_A20_MASK_INT_15 nor THUNK_ATTRIBUTE_DISABLE_A20_MASK_KBD_CTRL are set in

+  ThunkAttributes, then it is assumed that the user code did not enable the A20 mask, and no attempt is made to

+  disable the A20 mask.

+

+  If THUNK_ATTRIBUTE_DISABLE_A20_MASK_INT_15 is set and THUNK_ATTRIBUTE_DISABLE_A20_MASK_KBD_CTRL is clear in

+  ThunkAttributes, then attempt to use the INT 15 service to disable the A20 mask.  If this INT 15 call fails,

+  then attempt to disable the A20 mask by directly accessing the 8042 keyboard controller I/O ports.

+

+  If THUNK_ATTRIBUTE_DISABLE_A20_MASK_INT_15 is clear and THUNK_ATTRIBUTE_DISABLE_A20_MASK_KBD_CTRL is set in

+  ThunkAttributes, then attempt to disable the A20 mask by directly accessing the 8042 keyboard controller I/O ports.

+

+  If ThunkContext is NULL, then ASSERT().

+  If AsmPrepareThunk16() was not previously called with ThunkContext, then ASSERT().

+  If both THUNK_ATTRIBUTE_DISABLE_A20_MASK_INT_15 and THUNK_ATTRIBUTE_DISABLE_A20_MASK_KBD_CTRL are set in

+  ThunkAttributes, then ASSERT().

+

+  This interface is limited to be used in either physical mode or virtual modes with paging enabled where the

+  virtual to physical mappings for ThunkContext.RealModeBuffer are mapped 1:1.

+

+  @param  ThunkContext  A pointer to the context structure that describes the

+                        16-bit real mode code to call.

+

+**/

+VOID

+EFIAPI

+UnitTestHostBaseLibAsmThunk16 (

+  IN OUT  THUNK_CONTEXT             *ThunkContext

+  )

+{

+}

+

+/**

+  Prepares all structures and code for a 16-bit real mode thunk, transfers

+  control to a 16-bit real mode entry point, and returns the results.

+

+  Prepares all structures and code for a 16-bit real mode thunk, transfers

+  control to a 16-bit real mode entry point, and returns the results. If the

+  caller only need to perform a single 16-bit real mode thunk, then this

+  service should be used. If the caller intends to make more than one 16-bit

+  real mode thunk, then it is more efficient if AsmPrepareThunk16() is called

+  once and AsmThunk16() can be called for each 16-bit real mode thunk.

+

+  This interface is limited to be used in either physical mode or virtual modes with paging enabled where the

+  virtual to physical mappings for ThunkContext.RealModeBuffer is mapped 1:1.

+

+  See AsmPrepareThunk16() and AsmThunk16() for the detailed description and ASSERT() conditions.

+

+  @param  ThunkContext  A pointer to the context structure that describes the

+                        16-bit real mode code to call.

+

+**/

+VOID

+EFIAPI

+UnitTestHostBaseLibAsmPrepareAndThunk16 (

+  IN OUT  THUNK_CONTEXT             *ThunkContext

+  )

+{

+}

+

+/**

+  Load given selector into TR register.

+

+  @param[in] Selector     Task segment selector

+**/

+VOID

+EFIAPI

+UnitTestHostBaseLibAsmWriteTr (

+  IN UINT16 Selector

+  )

+{

+  mUnitTestHostBaseLibSegment[UNIT_TEST_HOST_BASE_LIB_SEGMENT_TR] = Selector;

+}

+

+/**

+  Performs a serializing operation on all load-from-memory instructions that

+  were issued prior the AsmLfence function.

+

+  Executes a LFENCE instruction. This function is only available on IA-32 and x64.

+

+**/

+VOID

+EFIAPI

+UnitTestHostBaseLibAsmLfence (

+  VOID

+  )

+{

+}

+

+/**

+  Patch the immediate operand of an IA32 or X64 instruction such that the byte,

+  word, dword or qword operand is encoded at the end of the instruction's

+  binary representation.

+

+  This function should be used to update object code that was compiled with

+  NASM from assembly source code. Example:

+

+  NASM source code:

+

+        mov     eax, strict dword 0 ; the imm32 zero operand will be patched

+    ASM_PFX(gPatchCr3):

+        mov     cr3, eax

+

+  C source code:

+

+    X86_ASSEMBLY_PATCH_LABEL gPatchCr3;

+    PatchInstructionX86 (gPatchCr3, AsmReadCr3 (), 4);

+

+  @param[out] InstructionEnd  Pointer right past the instruction to patch. The

+                              immediate operand to patch is expected to

+                              comprise the trailing bytes of the instruction.

+                              If InstructionEnd is closer to address 0 than

+                              ValueSize permits, then ASSERT().

+

+  @param[in] PatchValue       The constant to write to the immediate operand.

+                              The caller is responsible for ensuring that

+                              PatchValue can be represented in the byte, word,

+                              dword or qword operand (as indicated through

+                              ValueSize); otherwise ASSERT().

+

+  @param[in] ValueSize        The size of the operand in bytes; must be 1, 2,

+                              4, or 8. ASSERT() otherwise.

+**/

+VOID

+EFIAPI

+UnitTestHostBaseLibPatchInstructionX86 (

+  OUT X86_ASSEMBLY_PATCH_LABEL *InstructionEnd,

+  IN  UINT64                   PatchValue,

+  IN  UINTN                    ValueSize

+  )

+{

+}

+

+/**

+  Retrieves CPUID information.

+

+  Executes the CPUID instruction with EAX set to the value specified by Index.

+  This function always returns Index.

+  If Eax is not NULL, then the value of EAX after CPUID is returned in Eax.

+  If Ebx is not NULL, then the value of EBX after CPUID is returned in Ebx.

+  If Ecx is not NULL, then the value of ECX after CPUID is returned in Ecx.

+  If Edx is not NULL, then the value of EDX after CPUID is returned in Edx.

+  This function is only available on IA-32 and x64.

+

+  @param  Index The 32-bit value to load into EAX prior to invoking the CPUID

+                instruction.

+  @param  Eax   The pointer to the 32-bit EAX value returned by the CPUID

+                instruction. This is an optional parameter that may be NULL.

+  @param  Ebx   The pointer to the 32-bit EBX value returned by the CPUID

+                instruction. This is an optional parameter that may be NULL.

+  @param  Ecx   The pointer to the 32-bit ECX value returned by the CPUID

+                instruction. This is an optional parameter that may be NULL.

+  @param  Edx   The pointer to the 32-bit EDX value returned by the CPUID

+                instruction. This is an optional parameter that may be NULL.

+

+  @return Index.

+

+**/

+UINT32

+EFIAPI

+AsmCpuid (

+  IN      UINT32                    Index,

+  OUT     UINT32                    *Eax,  OPTIONAL

+  OUT     UINT32                    *Ebx,  OPTIONAL

+  OUT     UINT32                    *Ecx,  OPTIONAL

+  OUT     UINT32                    *Edx   OPTIONAL

+  )

+{

+  return gUnitTestHostBaseLib.X86->AsmCpuid (Index, Eax, Ebx, Ecx, Edx);

+}

+

+/**

+  Retrieves CPUID information using an extended leaf identifier.

+

+  Executes the CPUID instruction with EAX set to the value specified by Index

+  and ECX set to the value specified by SubIndex. This function always returns

+  Index. This function is only available on IA-32 and x64.

+

+  If Eax is not NULL, then the value of EAX after CPUID is returned in Eax.

+  If Ebx is not NULL, then the value of EBX after CPUID is returned in Ebx.

+  If Ecx is not NULL, then the value of ECX after CPUID is returned in Ecx.

+  If Edx is not NULL, then the value of EDX after CPUID is returned in Edx.

+

+  @param  Index     The 32-bit value to load into EAX prior to invoking the

+                    CPUID instruction.

+  @param  SubIndex  The 32-bit value to load into ECX prior to invoking the

+                    CPUID instruction.

+  @param  Eax       The pointer to the 32-bit EAX value returned by the CPUID

+                    instruction. This is an optional parameter that may be

+                    NULL.

+  @param  Ebx       The pointer to the 32-bit EBX value returned by the CPUID

+                    instruction. This is an optional parameter that may be

+                    NULL.

+  @param  Ecx       The pointer to the 32-bit ECX value returned by the CPUID

+                    instruction. This is an optional parameter that may be

+                    NULL.

+  @param  Edx       The pointer to the 32-bit EDX value returned by the CPUID

+                    instruction. This is an optional parameter that may be

+                    NULL.

+

+  @return Index.

+

+**/

+UINT32

+EFIAPI

+AsmCpuidEx (

+  IN      UINT32                    Index,

+  IN      UINT32                    SubIndex,

+  OUT     UINT32                    *Eax,  OPTIONAL

+  OUT     UINT32                    *Ebx,  OPTIONAL

+  OUT     UINT32                    *Ecx,  OPTIONAL

+  OUT     UINT32                    *Edx   OPTIONAL

+  )

+{

+  return gUnitTestHostBaseLib.X86->AsmCpuidEx (Index, SubIndex, Eax, Ebx, Ecx, Edx);

+}

+

+/**

+  Set CD bit and clear NW bit of CR0 followed by a WBINVD.

+

+  Disables the caches by setting the CD bit of CR0 to 1, clearing the NW bit of CR0 to 0,

+  and executing a WBINVD instruction.  This function is only available on IA-32 and x64.

+

+**/

+VOID

+EFIAPI

+AsmDisableCache (

+  VOID

+  )

+{

+  gUnitTestHostBaseLib.X86->AsmDisableCache ();

+}

+

+/**

+  Perform a WBINVD and clear both the CD and NW bits of CR0.

+

+  Enables the caches by executing a WBINVD instruction and then clear both the CD and NW

+  bits of CR0 to 0.  This function is only available on IA-32 and x64.

+

+**/

+VOID

+EFIAPI

+AsmEnableCache (

+  VOID

+  )

+{

+  gUnitTestHostBaseLib.X86->AsmEnableCache ();

+}

+

+/**

+  Returns a 64-bit Machine Specific Register(MSR).

+

+  Reads and returns the 64-bit MSR specified by Index. No parameter checking is

+  performed on Index, and some Index values may cause CPU exceptions. The

+  caller must either guarantee that Index is valid, or the caller must set up

+  exception handlers to catch the exceptions. This function is only available

+  on IA-32 and x64.

+

+  @param  Index The 32-bit MSR index to read.

+

+  @return The value of the MSR identified by Index.

+

+**/

+UINT64

+EFIAPI

+AsmReadMsr64 (

+  IN      UINT32                    Index

+  )

+{

+  return gUnitTestHostBaseLib.X86->AsmReadMsr64 (Index);

+}

+

+/**

+  Writes a 64-bit value to a Machine Specific Register(MSR), and returns the

+  value.

+

+  Writes the 64-bit value specified by Value to the MSR specified by Index. The

+  64-bit value written to the MSR is returned. No parameter checking is

+  performed on Index or Value, and some of these may cause CPU exceptions. The

+  caller must either guarantee that Index and Value are valid, or the caller

+  must establish proper exception handlers. This function is only available on

+  IA-32 and x64.

+

+  @param  Index The 32-bit MSR index to write.

+  @param  Value The 64-bit value to write to the MSR.

+

+  @return Value

+

+**/

+UINT64

+EFIAPI

+AsmWriteMsr64 (

+  IN      UINT32                    Index,

+  IN      UINT64                    Value

+  )

+{

+  return gUnitTestHostBaseLib.X86->AsmWriteMsr64 (Index, Value);

+}

+

+/**

+  Reads the current value of the Control Register 0 (CR0).

+

+  Reads and returns the current value of CR0. This function is only available

+  on IA-32 and x64. This returns a 32-bit value on IA-32 and a 64-bit value on

+  x64.

+

+  @return The value of the Control Register 0 (CR0).

+

+**/

+UINTN

+EFIAPI

+AsmReadCr0 (

+  VOID

+  )

+{

+  return gUnitTestHostBaseLib.X86->AsmReadCr0 ();

+}

+

+/**

+  Reads the current value of the Control Register 2 (CR2).

+

+  Reads and returns the current value of CR2. This function is only available

+  on IA-32 and x64. This returns a 32-bit value on IA-32 and a 64-bit value on

+  x64.

+

+  @return The value of the Control Register 2 (CR2).

+

+**/

+UINTN

+EFIAPI

+AsmReadCr2 (

+  VOID

+  )

+{

+  return gUnitTestHostBaseLib.X86->AsmReadCr2 ();

+}

+

+/**

+  Reads the current value of the Control Register 3 (CR3).

+

+  Reads and returns the current value of CR3. This function is only available

+  on IA-32 and x64. This returns a 32-bit value on IA-32 and a 64-bit value on

+  x64.

+

+  @return The value of the Control Register 3 (CR3).

+

+**/

+UINTN

+EFIAPI

+AsmReadCr3 (

+  VOID

+  )

+{

+  return gUnitTestHostBaseLib.X86->AsmReadCr3 ();

+}

+

+/**

+  Reads the current value of the Control Register 4 (CR4).

+

+  Reads and returns the current value of CR4. This function is only available

+  on IA-32 and x64. This returns a 32-bit value on IA-32 and a 64-bit value on

+  x64.

+

+  @return The value of the Control Register 4 (CR4).

+

+**/

+UINTN

+EFIAPI

+AsmReadCr4 (

+  VOID

+  )

+{

+  return gUnitTestHostBaseLib.X86->AsmReadCr4 ();

+}

+

+/**

+  Writes a value to Control Register 0 (CR0).

+

+  Writes and returns a new value to CR0. This function is only available on

+  IA-32 and x64. This writes a 32-bit value on IA-32 and a 64-bit value on x64.

+

+  @param  Cr0 The value to write to CR0.

+

+  @return The value written to CR0.

+

+**/

+UINTN

+EFIAPI

+AsmWriteCr0 (

+  UINTN  Cr0

+  )

+{

+  return gUnitTestHostBaseLib.X86->AsmWriteCr0 (Cr0);

+}

+

+/**

+  Writes a value to Control Register 2 (CR2).

+

+  Writes and returns a new value to CR2. This function is only available on

+  IA-32 and x64. This writes a 32-bit value on IA-32 and a 64-bit value on x64.

+

+  @param  Cr2 The value to write to CR2.

+

+  @return The value written to CR2.

+

+**/

+UINTN

+EFIAPI

+AsmWriteCr2 (

+  UINTN  Cr2

+  )

+{

+  return gUnitTestHostBaseLib.X86->AsmWriteCr2 (Cr2);

+}

+

+/**

+  Writes a value to Control Register 3 (CR3).

+

+  Writes and returns a new value to CR3. This function is only available on

+  IA-32 and x64. This writes a 32-bit value on IA-32 and a 64-bit value on x64.

+

+  @param  Cr3 The value to write to CR3.

+

+  @return The value written to CR3.

+

+**/

+UINTN

+EFIAPI

+AsmWriteCr3 (

+  UINTN  Cr3

+  )

+{

+  return gUnitTestHostBaseLib.X86->AsmWriteCr3 (Cr3);

+}

+

+/**

+  Writes a value to Control Register 4 (CR4).

+

+  Writes and returns a new value to CR4. This function is only available on

+  IA-32 and x64. This writes a 32-bit value on IA-32 and a 64-bit value on x64.

+

+  @param  Cr4 The value to write to CR4.

+

+  @return The value written to CR4.

+

+**/

+UINTN

+EFIAPI

+AsmWriteCr4 (

+  UINTN  Cr4

+  )

+{

+  return gUnitTestHostBaseLib.X86->AsmWriteCr4 (Cr4);

+}

+

+/**

+  Reads the current value of Debug Register 0 (DR0).

+

+  Reads and returns the current value of DR0. This function is only available

+  on IA-32 and x64. This returns a 32-bit value on IA-32 and a 64-bit value on

+  x64.

+

+  @return The value of Debug Register 0 (DR0).

+

+**/

+UINTN

+EFIAPI

+AsmReadDr0 (

+  VOID

+  )

+{

+  return gUnitTestHostBaseLib.X86->AsmReadDr0 ();

+}

+

+/**

+  Reads the current value of Debug Register 1 (DR1).

+

+  Reads and returns the current value of DR1. This function is only available

+  on IA-32 and x64. This returns a 32-bit value on IA-32 and a 64-bit value on

+  x64.

+

+  @return The value of Debug Register 1 (DR1).

+

+**/

+UINTN

+EFIAPI

+AsmReadDr1 (

+  VOID

+  )

+{

+  return gUnitTestHostBaseLib.X86->AsmReadDr1 ();

+}

+

+/**

+  Reads the current value of Debug Register 2 (DR2).

+

+  Reads and returns the current value of DR2. This function is only available

+  on IA-32 and x64. This returns a 32-bit value on IA-32 and a 64-bit value on

+  x64.

+

+  @return The value of Debug Register 2 (DR2).

+

+**/

+UINTN

+EFIAPI

+AsmReadDr2 (

+  VOID

+  )

+{

+  return gUnitTestHostBaseLib.X86->AsmReadDr2 ();

+}

+

+/**

+  Reads the current value of Debug Register 3 (DR3).

+

+  Reads and returns the current value of DR3. This function is only available

+  on IA-32 and x64. This returns a 32-bit value on IA-32 and a 64-bit value on

+  x64.

+

+  @return The value of Debug Register 3 (DR3).

+

+**/

+UINTN

+EFIAPI

+AsmReadDr3 (

+  VOID

+  )

+{

+  return gUnitTestHostBaseLib.X86->AsmReadDr3 ();

+}

+

+/**

+  Reads the current value of Debug Register 4 (DR4).

+

+  Reads and returns the current value of DR4. This function is only available

+  on IA-32 and x64. This returns a 32-bit value on IA-32 and a 64-bit value on

+  x64.

+

+  @return The value of Debug Register 4 (DR4).

+

+**/

+UINTN

+EFIAPI

+AsmReadDr4 (

+  VOID

+  )

+{

+  return gUnitTestHostBaseLib.X86->AsmReadDr4 ();

+}

+

+/**

+  Reads the current value of Debug Register 5 (DR5).

+

+  Reads and returns the current value of DR5. This function is only available

+  on IA-32 and x64. This returns a 32-bit value on IA-32 and a 64-bit value on

+  x64.

+

+  @return The value of Debug Register 5 (DR5).

+

+**/

+UINTN

+EFIAPI

+AsmReadDr5 (

+  VOID

+  )

+{

+  return gUnitTestHostBaseLib.X86->AsmReadDr5 ();

+}

+

+/**

+  Reads the current value of Debug Register 6 (DR6).

+

+  Reads and returns the current value of DR6. This function is only available

+  on IA-32 and x64. This returns a 32-bit value on IA-32 and a 64-bit value on

+  x64.

+

+  @return The value of Debug Register 6 (DR6).

+

+**/

+UINTN

+EFIAPI

+AsmReadDr6 (

+  VOID

+  )

+{

+  return gUnitTestHostBaseLib.X86->AsmReadDr6 ();

+}

+

+/**

+  Reads the current value of Debug Register 7 (DR7).

+

+  Reads and returns the current value of DR7. This function is only available

+  on IA-32 and x64. This returns a 32-bit value on IA-32 and a 64-bit value on

+  x64.

+

+  @return The value of Debug Register 7 (DR7).

+

+**/

+UINTN

+EFIAPI

+AsmReadDr7 (

+  VOID

+  )

+{

+  return gUnitTestHostBaseLib.X86->AsmReadDr7 ();

+}

+

+/**

+  Writes a value to Debug Register 0 (DR0).

+

+  Writes and returns a new value to DR0. This function is only available on

+  IA-32 and x64. This writes a 32-bit value on IA-32 and a 64-bit value on x64.

+

+  @param  Dr0 The value to write to Dr0.

+

+  @return The value written to Debug Register 0 (DR0).

+

+**/

+UINTN

+EFIAPI

+AsmWriteDr0 (

+  UINTN  Dr0

+  )

+{

+  return gUnitTestHostBaseLib.X86->AsmWriteDr0 (Dr0);

+}

+

+/**

+  Writes a value to Debug Register 1 (DR1).

+

+  Writes and returns a new value to DR1. This function is only available on

+  IA-32 and x64. This writes a 32-bit value on IA-32 and a 64-bit value on x64.

+

+  @param  Dr1 The value to write to Dr1.

+

+  @return The value written to Debug Register 1 (DR1).

+

+**/

+UINTN

+EFIAPI

+AsmWriteDr1 (

+  UINTN  Dr1

+  )

+{

+  return gUnitTestHostBaseLib.X86->AsmWriteDr1 (Dr1);

+}

+

+/**

+  Writes a value to Debug Register 2 (DR2).

+

+  Writes and returns a new value to DR2. This function is only available on

+  IA-32 and x64. This writes a 32-bit value on IA-32 and a 64-bit value on x64.

+

+  @param  Dr2 The value to write to Dr2.

+

+  @return The value written to Debug Register 2 (DR2).

+

+**/

+UINTN

+EFIAPI

+AsmWriteDr2 (

+  UINTN  Dr2

+  )

+{

+  return gUnitTestHostBaseLib.X86->AsmWriteDr2 (Dr2);

+}

+

+/**

+  Writes a value to Debug Register 3 (DR3).

+

+  Writes and returns a new value to DR3. This function is only available on

+  IA-32 and x64. This writes a 32-bit value on IA-32 and a 64-bit value on x64.

+

+  @param  Dr3 The value to write to Dr3.

+

+  @return The value written to Debug Register 3 (DR3).

+

+**/

+UINTN

+EFIAPI

+AsmWriteDr3 (

+  UINTN  Dr3

+  )

+{

+  return gUnitTestHostBaseLib.X86->AsmWriteDr3 (Dr3);

+}

+

+/**

+  Writes a value to Debug Register 4 (DR4).

+

+  Writes and returns a new value to DR4. This function is only available on

+  IA-32 and x64. This writes a 32-bit value on IA-32 and a 64-bit value on x64.

+

+  @param  Dr4 The value to write to Dr4.

+

+  @return The value written to Debug Register 4 (DR4).

+

+**/

+UINTN

+EFIAPI

+AsmWriteDr4 (

+  UINTN  Dr4

+  )

+{

+  return gUnitTestHostBaseLib.X86->AsmWriteDr4 (Dr4);

+}

+

+/**

+  Writes a value to Debug Register 5 (DR5).

+

+  Writes and returns a new value to DR5. This function is only available on

+  IA-32 and x64. This writes a 32-bit value on IA-32 and a 64-bit value on x64.

+

+  @param  Dr5 The value to write to Dr5.

+

+  @return The value written to Debug Register 5 (DR5).

+

+**/

+UINTN

+EFIAPI

+AsmWriteDr5 (

+  UINTN  Dr5

+  )

+{

+  return gUnitTestHostBaseLib.X86->AsmWriteDr5 (Dr5);

+}

+

+/**

+  Writes a value to Debug Register 6 (DR6).

+

+  Writes and returns a new value to DR6. This function is only available on

+  IA-32 and x64. This writes a 32-bit value on IA-32 and a 64-bit value on x64.

+

+  @param  Dr6 The value to write to Dr6.

+

+  @return The value written to Debug Register 6 (DR6).

+

+**/

+UINTN

+EFIAPI

+AsmWriteDr6 (

+  UINTN  Dr6

+  )

+{

+  return gUnitTestHostBaseLib.X86->AsmWriteDr6 (Dr6);

+}

+

+/**

+  Writes a value to Debug Register 7 (DR7).

+

+  Writes and returns a new value to DR7. This function is only available on

+  IA-32 and x64. This writes a 32-bit value on IA-32 and a 64-bit value on x64.

+

+  @param  Dr7 The value to write to Dr7.

+

+  @return The value written to Debug Register 7 (DR7).

+

+**/

+UINTN

+EFIAPI

+AsmWriteDr7 (

+  UINTN  Dr7

+  )

+{

+  return gUnitTestHostBaseLib.X86->AsmWriteDr7 (Dr7);

+}

+

+/**

+  Reads the current value of Code Segment Register (CS).

+

+  Reads and returns the current value of CS. This function is only available on

+  IA-32 and x64.

+

+  @return The current value of CS.

+

+**/

+UINT16

+EFIAPI

+AsmReadCs (

+  VOID

+  )

+{

+  return gUnitTestHostBaseLib.X86->AsmReadCs ();

+}

+

+/**

+  Reads the current value of Data Segment Register (DS).

+

+  Reads and returns the current value of DS. This function is only available on

+  IA-32 and x64.

+

+  @return The current value of DS.

+

+**/

+UINT16

+EFIAPI

+AsmReadDs (

+  VOID

+  )

+{

+  return gUnitTestHostBaseLib.X86->AsmReadDs ();

+}

+

+/**

+  Reads the current value of Extra Segment Register (ES).

+

+  Reads and returns the current value of ES. This function is only available on

+  IA-32 and x64.

+

+  @return The current value of ES.

+

+**/

+UINT16

+EFIAPI

+AsmReadEs (

+  VOID

+  )

+{

+  return gUnitTestHostBaseLib.X86->AsmReadEs ();

+}

+

+/**

+  Reads the current value of FS Data Segment Register (FS).

+

+  Reads and returns the current value of FS. This function is only available on

+  IA-32 and x64.

+

+  @return The current value of FS.

+

+**/

+UINT16

+EFIAPI

+AsmReadFs (

+  VOID

+  )

+{

+  return gUnitTestHostBaseLib.X86->AsmReadFs ();

+}

+

+/**

+  Reads the current value of GS Data Segment Register (GS).

+

+  Reads and returns the current value of GS. This function is only available on

+  IA-32 and x64.

+

+  @return The current value of GS.

+

+**/

+UINT16

+EFIAPI

+AsmReadGs (

+  VOID

+  )

+{

+  return gUnitTestHostBaseLib.X86->AsmReadGs ();

+}

+

+/**

+  Reads the current value of Stack Segment Register (SS).

+

+  Reads and returns the current value of SS. This function is only available on

+  IA-32 and x64.

+

+  @return The current value of SS.

+

+**/

+UINT16

+EFIAPI

+AsmReadSs (

+  VOID

+  )

+{

+  return gUnitTestHostBaseLib.X86->AsmReadSs ();

+}

+

+/**

+  Reads the current value of Task Register (TR).

+

+  Reads and returns the current value of TR. This function is only available on

+  IA-32 and x64.

+

+  @return The current value of TR.

+

+**/

+UINT16

+EFIAPI

+AsmReadTr (

+  VOID

+  )

+{

+  return gUnitTestHostBaseLib.X86->AsmReadTr ();

+}

+

+/**

+  Reads the current Global Descriptor Table Register(GDTR) descriptor.

+

+  Reads and returns the current GDTR descriptor and returns it in Gdtr. This

+  function is only available on IA-32 and x64.

+

+  If Gdtr is NULL, then ASSERT().

+

+  @param  Gdtr  The pointer to a GDTR descriptor.

+

+**/

+VOID

+EFIAPI

+AsmReadGdtr (

+  OUT     IA32_DESCRIPTOR           *Gdtr

+  )

+{

+  gUnitTestHostBaseLib.X86->AsmReadGdtr (Gdtr);

+}

+

+/**

+  Writes the current Global Descriptor Table Register (GDTR) descriptor.

+

+  Writes and the current GDTR descriptor specified by Gdtr. This function is

+  only available on IA-32 and x64.

+

+  If Gdtr is NULL, then ASSERT().

+

+  @param  Gdtr  The pointer to a GDTR descriptor.

+

+**/

+VOID

+EFIAPI

+AsmWriteGdtr (

+  IN      CONST IA32_DESCRIPTOR     *Gdtr

+  )

+{

+  gUnitTestHostBaseLib.X86->AsmWriteGdtr (Gdtr);

+}

+

+/**

+  Reads the current Interrupt Descriptor Table Register(IDTR) descriptor.

+

+  Reads and returns the current IDTR descriptor and returns it in Idtr. This

+  function is only available on IA-32 and x64.

+

+  If Idtr is NULL, then ASSERT().

+

+  @param  Idtr  The pointer to a IDTR descriptor.

+

+**/

+VOID

+EFIAPI

+AsmReadIdtr (

+  OUT     IA32_DESCRIPTOR           *Idtr

+  )

+{

+  gUnitTestHostBaseLib.X86->AsmReadIdtr (Idtr);

+}

+

+/**

+  Writes the current Interrupt Descriptor Table Register(IDTR) descriptor.

+

+  Writes the current IDTR descriptor and returns it in Idtr. This function is

+  only available on IA-32 and x64.

+

+  If Idtr is NULL, then ASSERT().

+

+  @param  Idtr  The pointer to a IDTR descriptor.

+

+**/

+VOID

+EFIAPI

+AsmWriteIdtr (

+  IN      CONST IA32_DESCRIPTOR     *Idtr

+  )

+{

+  gUnitTestHostBaseLib.X86->AsmWriteIdtr (Idtr);

+}

+

+/**

+  Reads the current Local Descriptor Table Register(LDTR) selector.

+

+  Reads and returns the current 16-bit LDTR descriptor value. This function is

+  only available on IA-32 and x64.

+

+  @return The current selector of LDT.

+

+**/

+UINT16

+EFIAPI

+AsmReadLdtr (

+  VOID

+  )

+{

+  return gUnitTestHostBaseLib.X86->AsmReadLdtr ();

+}

+

+/**

+  Writes the current Local Descriptor Table Register (LDTR) selector.

+

+  Writes and the current LDTR descriptor specified by Ldtr. This function is

+  only available on IA-32 and x64.

+

+  @param  Ldtr  16-bit LDTR selector value.

+

+**/

+VOID

+EFIAPI

+AsmWriteLdtr (

+  IN      UINT16                    Ldtr

+  )

+{

+  gUnitTestHostBaseLib.X86->AsmWriteLdtr (Ldtr);

+}

+

+/**

+  Reads the current value of a Performance Counter (PMC).

+

+  Reads and returns the current value of performance counter specified by

+  Index. This function is only available on IA-32 and x64.

+

+  @param  Index The 32-bit Performance Counter index to read.

+

+  @return The value of the PMC specified by Index.

+

+**/

+UINT64

+EFIAPI

+AsmReadPmc (

+  IN      UINT32                    Index

+  )

+{

+  return gUnitTestHostBaseLib.X86->AsmReadPmc (Index);

+}

+

+/**

+  Sets up a monitor buffer that is used by AsmMwait().

+

+  Executes a MONITOR instruction with the register state specified by Eax, Ecx

+  and Edx. Returns Eax. This function is only available on IA-32 and x64.

+

+  @param  Eax The value to load into EAX or RAX before executing the MONITOR

+              instruction.

+  @param  Ecx The value to load into ECX or RCX before executing the MONITOR

+              instruction.

+  @param  Edx The value to load into EDX or RDX before executing the MONITOR

+              instruction.

+

+  @return Eax

+

+**/

+UINTN

+EFIAPI

+AsmMonitor (

+  IN      UINTN                     Eax,

+  IN      UINTN                     Ecx,

+  IN      UINTN                     Edx

+  )

+{

+  return gUnitTestHostBaseLib.X86->AsmMonitor (Eax, Ecx, Edx);

+}

+

+/**

+  Executes an MWAIT instruction.

+

+  Executes an MWAIT instruction with the register state specified by Eax and

+  Ecx. Returns Eax. This function is only available on IA-32 and x64.

+

+  @param  Eax The value to load into EAX or RAX before executing the MONITOR

+              instruction.

+  @param  Ecx The value to load into ECX or RCX before executing the MONITOR

+              instruction.

+

+  @return Eax

+

+**/

+UINTN

+EFIAPI

+AsmMwait (

+  IN      UINTN                     Eax,

+  IN      UINTN                     Ecx

+  )

+{

+  return gUnitTestHostBaseLib.X86->AsmMwait (Eax, Ecx);

+}

+

+/**

+  Executes a WBINVD instruction.

+

+  Executes a WBINVD instruction. This function is only available on IA-32 and

+  x64.

+

+**/

+VOID

+EFIAPI

+AsmWbinvd (

+  VOID

+  )

+{

+  gUnitTestHostBaseLib.X86->AsmWbinvd ();

+}

+

+/**

+  Executes a INVD instruction.

+

+  Executes a INVD instruction. This function is only available on IA-32 and

+  x64.

+

+**/

+VOID

+EFIAPI

+AsmInvd (

+  VOID

+  )

+{

+  gUnitTestHostBaseLib.X86->AsmInvd ();

+}

+

+/**

+  Flushes a cache line from all the instruction and data caches within the

+  coherency domain of the CPU.

+

+  Flushed the cache line specified by LinearAddress, and returns LinearAddress.

+  This function is only available on IA-32 and x64.

+

+  @param  LinearAddress The address of the cache line to flush. If the CPU is

+                        in a physical addressing mode, then LinearAddress is a

+                        physical address. If the CPU is in a virtual

+                        addressing mode, then LinearAddress is a virtual

+                        address.

+

+  @return LinearAddress.

+**/

+VOID *

+EFIAPI

+AsmFlushCacheLine (

+  IN      VOID                      *LinearAddress

+  )

+{

+  return gUnitTestHostBaseLib.X86->AsmFlushCacheLine (LinearAddress);

+}

+

+/**

+  Enables the 32-bit paging mode on the CPU.

+

+  Enables the 32-bit paging mode on the CPU. CR0, CR3, CR4, and the page tables

+  must be properly initialized prior to calling this service. This function

+  assumes the current execution mode is 32-bit protected mode. This function is

+  only available on IA-32. After the 32-bit paging mode is enabled, control is

+  transferred to the function specified by EntryPoint using the new stack

+  specified by NewStack and passing in the parameters specified by Context1 and

+  Context2. Context1 and Context2 are optional and may be NULL. The function

+  EntryPoint must never return.

+

+  If the current execution mode is not 32-bit protected mode, then ASSERT().

+  If EntryPoint is NULL, then ASSERT().

+  If NewStack is NULL, then ASSERT().

+

+  There are a number of constraints that must be followed before calling this

+  function:

+  1)  Interrupts must be disabled.

+  2)  The caller must be in 32-bit protected mode with flat descriptors. This

+      means all descriptors must have a base of 0 and a limit of 4GB.

+  3)  CR0 and CR4 must be compatible with 32-bit protected mode with flat

+      descriptors.

+  4)  CR3 must point to valid page tables that will be used once the transition

+      is complete, and those page tables must guarantee that the pages for this

+      function and the stack are identity mapped.

+

+  @param  EntryPoint  A pointer to function to call with the new stack after

+                      paging is enabled.

+  @param  Context1    A pointer to the context to pass into the EntryPoint

+                      function as the first parameter after paging is enabled.

+  @param  Context2    A pointer to the context to pass into the EntryPoint

+                      function as the second parameter after paging is enabled.

+  @param  NewStack    A pointer to the new stack to use for the EntryPoint

+                      function after paging is enabled.

+

+**/

+VOID

+EFIAPI

+AsmEnablePaging32 (

+  IN      SWITCH_STACK_ENTRY_POINT  EntryPoint,

+  IN      VOID                      *Context1,  OPTIONAL

+  IN      VOID                      *Context2,  OPTIONAL

+  IN      VOID                      *NewStack

+  )

+{

+  gUnitTestHostBaseLib.X86->AsmEnablePaging32 (EntryPoint, Context1, Context2, NewStack);

+}

+

+/**

+  Disables the 32-bit paging mode on the CPU.

+

+  Disables the 32-bit paging mode on the CPU and returns to 32-bit protected

+  mode. This function assumes the current execution mode is 32-paged protected

+  mode. This function is only available on IA-32. After the 32-bit paging mode

+  is disabled, control is transferred to the function specified by EntryPoint

+  using the new stack specified by NewStack and passing in the parameters

+  specified by Context1 and Context2. Context1 and Context2 are optional and

+  may be NULL. The function EntryPoint must never return.

+

+  If the current execution mode is not 32-bit paged mode, then ASSERT().

+  If EntryPoint is NULL, then ASSERT().

+  If NewStack is NULL, then ASSERT().

+

+  There are a number of constraints that must be followed before calling this

+  function:

+  1)  Interrupts must be disabled.

+  2)  The caller must be in 32-bit paged mode.

+  3)  CR0, CR3, and CR4 must be compatible with 32-bit paged mode.

+  4)  CR3 must point to valid page tables that guarantee that the pages for

+      this function and the stack are identity mapped.

+

+  @param  EntryPoint  A pointer to function to call with the new stack after

+                      paging is disabled.

+  @param  Context1    A pointer to the context to pass into the EntryPoint

+                      function as the first parameter after paging is disabled.

+  @param  Context2    A pointer to the context to pass into the EntryPoint

+                      function as the second parameter after paging is

+                      disabled.

+  @param  NewStack    A pointer to the new stack to use for the EntryPoint

+                      function after paging is disabled.

+

+**/

+VOID

+EFIAPI

+AsmDisablePaging32 (

+  IN      SWITCH_STACK_ENTRY_POINT  EntryPoint,

+  IN      VOID                      *Context1,  OPTIONAL

+  IN      VOID                      *Context2,  OPTIONAL

+  IN      VOID                      *NewStack

+  )

+{

+  gUnitTestHostBaseLib.X86->AsmDisablePaging32 (EntryPoint, Context1, Context2, NewStack);

+}

+

+/**

+  Enables the 64-bit paging mode on the CPU.

+

+  Enables the 64-bit paging mode on the CPU. CR0, CR3, CR4, and the page tables

+  must be properly initialized prior to calling this service. This function

+  assumes the current execution mode is 32-bit protected mode with flat

+  descriptors. This function is only available on IA-32. After the 64-bit

+  paging mode is enabled, control is transferred to the function specified by

+  EntryPoint using the new stack specified by NewStack and passing in the

+  parameters specified by Context1 and Context2. Context1 and Context2 are

+  optional and may be 0. The function EntryPoint must never return.

+

+  If the current execution mode is not 32-bit protected mode with flat

+  descriptors, then ASSERT().

+  If EntryPoint is 0, then ASSERT().

+  If NewStack is 0, then ASSERT().

+

+  @param  Cs          The 16-bit selector to load in the CS before EntryPoint

+                      is called. The descriptor in the GDT that this selector

+                      references must be setup for long mode.

+  @param  EntryPoint  The 64-bit virtual address of the function to call with

+                      the new stack after paging is enabled.

+  @param  Context1    The 64-bit virtual address of the context to pass into

+                      the EntryPoint function as the first parameter after

+                      paging is enabled.

+  @param  Context2    The 64-bit virtual address of the context to pass into

+                      the EntryPoint function as the second parameter after

+                      paging is enabled.

+  @param  NewStack    The 64-bit virtual address of the new stack to use for

+                      the EntryPoint function after paging is enabled.

+

+**/

+VOID

+EFIAPI

+AsmEnablePaging64 (

+  IN      UINT16                    Cs,

+  IN      UINT64                    EntryPoint,

+  IN      UINT64                    Context1,  OPTIONAL

+  IN      UINT64                    Context2,  OPTIONAL

+  IN      UINT64                    NewStack

+  )

+{

+  gUnitTestHostBaseLib.X86->AsmEnablePaging64 (Cs, EntryPoint, Context1, Context2, NewStack);

+}

+

+/**

+  Disables the 64-bit paging mode on the CPU.

+

+  Disables the 64-bit paging mode on the CPU and returns to 32-bit protected

+  mode. This function assumes the current execution mode is 64-paging mode.

+  This function is only available on x64. After the 64-bit paging mode is

+  disabled, control is transferred to the function specified by EntryPoint

+  using the new stack specified by NewStack and passing in the parameters

+  specified by Context1 and Context2. Context1 and Context2 are optional and

+  may be 0. The function EntryPoint must never return.

+

+  If the current execution mode is not 64-bit paged mode, then ASSERT().

+  If EntryPoint is 0, then ASSERT().

+  If NewStack is 0, then ASSERT().

+

+  @param  Cs          The 16-bit selector to load in the CS before EntryPoint

+                      is called. The descriptor in the GDT that this selector

+                      references must be setup for 32-bit protected mode.

+  @param  EntryPoint  The 64-bit virtual address of the function to call with

+                      the new stack after paging is disabled.

+  @param  Context1    The 64-bit virtual address of the context to pass into

+                      the EntryPoint function as the first parameter after

+                      paging is disabled.

+  @param  Context2    The 64-bit virtual address of the context to pass into

+                      the EntryPoint function as the second parameter after

+                      paging is disabled.

+  @param  NewStack    The 64-bit virtual address of the new stack to use for

+                      the EntryPoint function after paging is disabled.

+

+**/

+VOID

+EFIAPI

+AsmDisablePaging64 (

+  IN      UINT16                    Cs,

+  IN      UINT32                    EntryPoint,

+  IN      UINT32                    Context1,  OPTIONAL

+  IN      UINT32                    Context2,  OPTIONAL

+  IN      UINT32                    NewStack

+  )

+{

+  gUnitTestHostBaseLib.X86->AsmDisablePaging64 (Cs, EntryPoint, Context1, Context2, NewStack);

+}

+

+/**

+  Retrieves the properties for 16-bit thunk functions.

+

+  Computes the size of the buffer and stack below 1MB required to use the

+  AsmPrepareThunk16(), AsmThunk16() and AsmPrepareAndThunk16() functions. This

+  buffer size is returned in RealModeBufferSize, and the stack size is returned

+  in ExtraStackSize. If parameters are passed to the 16-bit real mode code,

+  then the actual minimum stack size is ExtraStackSize plus the maximum number

+  of bytes that need to be passed to the 16-bit real mode code.

+

+  If RealModeBufferSize is NULL, then ASSERT().

+  If ExtraStackSize is NULL, then ASSERT().

+

+  @param  RealModeBufferSize  A pointer to the size of the buffer below 1MB

+                              required to use the 16-bit thunk functions.

+  @param  ExtraStackSize      A pointer to the extra size of stack below 1MB

+                              that the 16-bit thunk functions require for

+                              temporary storage in the transition to and from

+                              16-bit real mode.

+

+**/

+VOID

+EFIAPI

+AsmGetThunk16Properties (

+  OUT     UINT32                    *RealModeBufferSize,

+  OUT     UINT32                    *ExtraStackSize

+  )

+{

+  gUnitTestHostBaseLib.X86->AsmGetThunk16Properties (RealModeBufferSize, ExtraStackSize);

+}

+

+/**

+  Prepares all structures a code required to use AsmThunk16().

+

+  Prepares all structures and code required to use AsmThunk16().

+

+  This interface is limited to be used in either physical mode or virtual modes with paging enabled where the

+  virtual to physical mappings for ThunkContext.RealModeBuffer is mapped 1:1.

+

+  If ThunkContext is NULL, then ASSERT().

+

+  @param  ThunkContext  A pointer to the context structure that describes the

+                        16-bit real mode code to call.

+

+**/

+VOID

+EFIAPI

+AsmPrepareThunk16 (

+  IN OUT  THUNK_CONTEXT             *ThunkContext

+  )

+{

+  gUnitTestHostBaseLib.X86->AsmPrepareThunk16 (ThunkContext);

+}

+

+/**

+  Transfers control to a 16-bit real mode entry point and returns the results.

+

+  Transfers control to a 16-bit real mode entry point and returns the results.

+  AsmPrepareThunk16() must be called with ThunkContext before this function is used.

+  This function must be called with interrupts disabled.

+

+  The register state from the RealModeState field of ThunkContext is restored just prior

+  to calling the 16-bit real mode entry point.  This includes the EFLAGS field of RealModeState,

+  which is used to set the interrupt state when a 16-bit real mode entry point is called.

+  Control is transferred to the 16-bit real mode entry point specified by the CS and Eip fields of RealModeState.

+  The stack is initialized to the SS and ESP fields of RealModeState.  Any parameters passed to

+  the 16-bit real mode code must be populated by the caller at SS:ESP prior to calling this function.

+  The 16-bit real mode entry point is invoked with a 16-bit CALL FAR instruction,

+  so when accessing stack contents, the 16-bit real mode code must account for the 16-bit segment

+  and 16-bit offset of the return address that were pushed onto the stack. The 16-bit real mode entry

+  point must exit with a RETF instruction. The register state is captured into RealModeState immediately

+  after the RETF instruction is executed.

+

+  If EFLAGS specifies interrupts enabled, or any of the 16-bit real mode code enables interrupts,

+  or any of the 16-bit real mode code makes a SW interrupt, then the caller is responsible for making sure

+  the IDT at address 0 is initialized to handle any HW or SW interrupts that may occur while in 16-bit real mode.

+

+  If EFLAGS specifies interrupts enabled, or any of the 16-bit real mode code enables interrupts,

+  then the caller is responsible for making sure the 8259 PIC is in a state compatible with 16-bit real mode.

+  This includes the base vectors, the interrupt masks, and the edge/level trigger mode.

+

+  If THUNK_ATTRIBUTE_BIG_REAL_MODE is set in the ThunkAttributes field of ThunkContext, then the user code

+  is invoked in big real mode.  Otherwise, the user code is invoked in 16-bit real mode with 64KB segment limits.

+

+  If neither THUNK_ATTRIBUTE_DISABLE_A20_MASK_INT_15 nor THUNK_ATTRIBUTE_DISABLE_A20_MASK_KBD_CTRL are set in

+  ThunkAttributes, then it is assumed that the user code did not enable the A20 mask, and no attempt is made to

+  disable the A20 mask.

+

+  If THUNK_ATTRIBUTE_DISABLE_A20_MASK_INT_15 is set and THUNK_ATTRIBUTE_DISABLE_A20_MASK_KBD_CTRL is clear in

+  ThunkAttributes, then attempt to use the INT 15 service to disable the A20 mask.  If this INT 15 call fails,

+  then attempt to disable the A20 mask by directly accessing the 8042 keyboard controller I/O ports.

+

+  If THUNK_ATTRIBUTE_DISABLE_A20_MASK_INT_15 is clear and THUNK_ATTRIBUTE_DISABLE_A20_MASK_KBD_CTRL is set in

+  ThunkAttributes, then attempt to disable the A20 mask by directly accessing the 8042 keyboard controller I/O ports.

+

+  If ThunkContext is NULL, then ASSERT().

+  If AsmPrepareThunk16() was not previously called with ThunkContext, then ASSERT().

+  If both THUNK_ATTRIBUTE_DISABLE_A20_MASK_INT_15 and THUNK_ATTRIBUTE_DISABLE_A20_MASK_KBD_CTRL are set in

+  ThunkAttributes, then ASSERT().

+

+  This interface is limited to be used in either physical mode or virtual modes with paging enabled where the

+  virtual to physical mappings for ThunkContext.RealModeBuffer are mapped 1:1.

+

+  @param  ThunkContext  A pointer to the context structure that describes the

+                        16-bit real mode code to call.

+

+**/

+VOID

+EFIAPI

+AsmThunk16 (

+  IN OUT  THUNK_CONTEXT             *ThunkContext

+  )

+{

+  gUnitTestHostBaseLib.X86->AsmThunk16 (ThunkContext);

+}

+

+/**

+  Prepares all structures and code for a 16-bit real mode thunk, transfers

+  control to a 16-bit real mode entry point, and returns the results.

+

+  Prepares all structures and code for a 16-bit real mode thunk, transfers

+  control to a 16-bit real mode entry point, and returns the results. If the

+  caller only need to perform a single 16-bit real mode thunk, then this

+  service should be used. If the caller intends to make more than one 16-bit

+  real mode thunk, then it is more efficient if AsmPrepareThunk16() is called

+  once and AsmThunk16() can be called for each 16-bit real mode thunk.

+

+  This interface is limited to be used in either physical mode or virtual modes with paging enabled where the

+  virtual to physical mappings for ThunkContext.RealModeBuffer is mapped 1:1.

+

+  See AsmPrepareThunk16() and AsmThunk16() for the detailed description and ASSERT() conditions.

+

+  @param  ThunkContext  A pointer to the context structure that describes the

+                        16-bit real mode code to call.

+

+**/

+VOID

+EFIAPI

+AsmPrepareAndThunk16 (

+  IN OUT  THUNK_CONTEXT             *ThunkContext

+  )

+{

+  gUnitTestHostBaseLib.X86->AsmPrepareAndThunk16 (ThunkContext);

+}

+

+/**

+  Load given selector into TR register.

+

+  @param[in] Selector     Task segment selector

+**/

+VOID

+EFIAPI

+AsmWriteTr (

+  IN UINT16 Selector

+  )

+{

+  gUnitTestHostBaseLib.X86->AsmWriteTr (Selector);

+}

+

+/**

+  Performs a serializing operation on all load-from-memory instructions that

+  were issued prior the AsmLfence function.

+

+  Executes a LFENCE instruction. This function is only available on IA-32 and x64.

+

+**/

+VOID

+EFIAPI

+AsmLfence (

+  VOID

+  )

+{

+  gUnitTestHostBaseLib.X86->AsmLfence ();

+}

+

+/**

+  Patch the immediate operand of an IA32 or X64 instruction such that the byte,

+  word, dword or qword operand is encoded at the end of the instruction's

+  binary representation.

+

+  This function should be used to update object code that was compiled with

+  NASM from assembly source code. Example:

+

+  NASM source code:

+

+        mov     eax, strict dword 0 ; the imm32 zero operand will be patched

+    ASM_PFX(gPatchCr3):

+        mov     cr3, eax

+

+  C source code:

+

+    X86_ASSEMBLY_PATCH_LABEL gPatchCr3;

+    PatchInstructionX86 (gPatchCr3, AsmReadCr3 (), 4);

+

+  @param[out] InstructionEnd  Pointer right past the instruction to patch. The

+                              immediate operand to patch is expected to

+                              comprise the trailing bytes of the instruction.

+                              If InstructionEnd is closer to address 0 than

+                              ValueSize permits, then ASSERT().

+

+  @param[in] PatchValue       The constant to write to the immediate operand.

+                              The caller is responsible for ensuring that

+                              PatchValue can be represented in the byte, word,

+                              dword or qword operand (as indicated through

+                              ValueSize); otherwise ASSERT().

+

+  @param[in] ValueSize        The size of the operand in bytes; must be 1, 2,

+                              4, or 8. ASSERT() otherwise.

+**/

+VOID

+EFIAPI

+PatchInstructionX86 (

+  OUT X86_ASSEMBLY_PATCH_LABEL *InstructionEnd,

+  IN  UINT64                   PatchValue,

+  IN  UINTN                    ValueSize

+  )

+{

+  gUnitTestHostBaseLib.X86->PatchInstructionX86 (InstructionEnd, PatchValue, ValueSize);

+}

+

+///

+/// Common services

+///

+STATIC UNIT_TEST_HOST_BASE_LIB_COMMON  mUnitTestHostBaseLibCommon = {

+  UnitTestHostBaseLibEnableInterrupts,

+  UnitTestHostBaseLibDisableInterrupts,

+  UnitTestHostBaseLibEnableDisableInterrupts,

+  UnitTestHostBaseLibGetInterruptState,

+};

+

+///

+/// IA32/X64 services

+///

+STATIC UNIT_TEST_HOST_BASE_LIB_X86  mUnitTestHostBaseLibX86 = {

+  UnitTestHostBaseLibAsmCpuid,

+  UnitTestHostBaseLibAsmCpuidEx,

+  UnitTestHostBaseLibAsmDisableCache,

+  UnitTestHostBaseLibAsmEnableCache,

+  UnitTestHostBaseLibAsmReadMsr64,

+  UnitTestHostBaseLibAsmWriteMsr64,

+  UnitTestHostBaseLibAsmReadCr0,

+  UnitTestHostBaseLibAsmReadCr2,

+  UnitTestHostBaseLibAsmReadCr3,

+  UnitTestHostBaseLibAsmReadCr4,

+  UnitTestHostBaseLibAsmWriteCr0,

+  UnitTestHostBaseLibAsmWriteCr2,

+  UnitTestHostBaseLibAsmWriteCr3,

+  UnitTestHostBaseLibAsmWriteCr4,

+  UnitTestHostBaseLibAsmReadDr0,

+  UnitTestHostBaseLibAsmReadDr1,

+  UnitTestHostBaseLibAsmReadDr2,

+  UnitTestHostBaseLibAsmReadDr3,

+  UnitTestHostBaseLibAsmReadDr4,

+  UnitTestHostBaseLibAsmReadDr5,

+  UnitTestHostBaseLibAsmReadDr6,

+  UnitTestHostBaseLibAsmReadDr7,

+  UnitTestHostBaseLibAsmWriteDr0,

+  UnitTestHostBaseLibAsmWriteDr1,

+  UnitTestHostBaseLibAsmWriteDr2,

+  UnitTestHostBaseLibAsmWriteDr3,

+  UnitTestHostBaseLibAsmWriteDr4,

+  UnitTestHostBaseLibAsmWriteDr5,

+  UnitTestHostBaseLibAsmWriteDr6,

+  UnitTestHostBaseLibAsmWriteDr7,

+  UnitTestHostBaseLibAsmReadCs,

+  UnitTestHostBaseLibAsmReadDs,

+  UnitTestHostBaseLibAsmReadEs,

+  UnitTestHostBaseLibAsmReadFs,

+  UnitTestHostBaseLibAsmReadGs,

+  UnitTestHostBaseLibAsmReadSs,

+  UnitTestHostBaseLibAsmReadTr,

+  UnitTestHostBaseLibAsmReadGdtr,

+  UnitTestHostBaseLibAsmWriteGdtr,

+  UnitTestHostBaseLibAsmReadIdtr,

+  UnitTestHostBaseLibAsmWriteIdtr,

+  UnitTestHostBaseLibAsmReadLdtr,

+  UnitTestHostBaseLibAsmWriteLdtr,

+  UnitTestHostBaseLibAsmReadPmc,

+  UnitTestHostBaseLibAsmMonitor,

+  UnitTestHostBaseLibAsmMwait,

+  UnitTestHostBaseLibAsmWbinvd,

+  UnitTestHostBaseLibAsmInvd,

+  UnitTestHostBaseLibAsmFlushCacheLine,

+  UnitTestHostBaseLibAsmEnablePaging32,

+  UnitTestHostBaseLibAsmDisablePaging32,

+  UnitTestHostBaseLibAsmEnablePaging64,

+  UnitTestHostBaseLibAsmDisablePaging64,

+  UnitTestHostBaseLibAsmGetThunk16Properties,

+  UnitTestHostBaseLibAsmPrepareThunk16,

+  UnitTestHostBaseLibAsmThunk16,

+  UnitTestHostBaseLibAsmPrepareAndThunk16,

+  UnitTestHostBaseLibAsmWriteTr,

+  UnitTestHostBaseLibAsmLfence,

+  UnitTestHostBaseLibPatchInstructionX86

+};

+

+///

+/// Structure of hook functions for BaseLib functions that can not be used from

+/// a host application.  A simple emulation of these function is provided by

+/// default.  A specific unit test can provide its own implementation for any

+/// of these functions.

+///

+UNIT_TEST_HOST_BASE_LIB  gUnitTestHostBaseLib = {

+  &mUnitTestHostBaseLibCommon,

+  &mUnitTestHostBaseLibX86

+};

diff --git a/debugging_demo/memtest86+/efi/Include/src/BaseLib/X86WriteGdtr.c b/debugging_demo/memtest86+/efi/Include/src/BaseLib/X86WriteGdtr.c
new file mode 100644
index 0000000..1a570e3
--- /dev/null
+++ b/debugging_demo/memtest86+/efi/Include/src/BaseLib/X86WriteGdtr.c
@@ -0,0 +1,33 @@
+/** @file

+  IA-32/x64 AsmWriteGdtr()

+

+  Copyright (c) 2006 - 2008, Intel Corporation. All rights reserved.<BR>

+  SPDX-License-Identifier: BSD-2-Clause-Patent

+

+**/

+

+

+

+

+#include "BaseLibInternals.h"

+

+/**

+  Writes the current Global Descriptor Table Register (GDTR) descriptor.

+

+  Writes and the current GDTR descriptor specified by Gdtr. This function is

+  only available on IA-32 and x64.

+

+  If Gdtr is NULL, then ASSERT().

+

+  @param  Gdtr  The pointer to a GDTR descriptor.

+

+**/

+VOID

+EFIAPI

+AsmWriteGdtr (

+  IN      CONST IA32_DESCRIPTOR     *Gdtr

+  )

+{

+  ASSERT (Gdtr != NULL);

+  InternalX86WriteGdtr (Gdtr);

+}

diff --git a/debugging_demo/memtest86+/efi/Include/src/BaseLib/X86WriteIdtr.c b/debugging_demo/memtest86+/efi/Include/src/BaseLib/X86WriteIdtr.c
new file mode 100644
index 0000000..9ea979b
--- /dev/null
+++ b/debugging_demo/memtest86+/efi/Include/src/BaseLib/X86WriteIdtr.c
@@ -0,0 +1,33 @@
+/** @file

+  IA-32/x64 AsmWriteIdtr()

+

+  Copyright (c) 2006 - 2008, Intel Corporation. All rights reserved.<BR>

+  SPDX-License-Identifier: BSD-2-Clause-Patent

+

+**/

+

+

+

+

+#include "BaseLibInternals.h"

+

+/**

+  Writes the current Interrupt Descriptor Table Register(IDTR) descriptor.

+

+  Writes the current IDTR descriptor and returns it in Idtr. This function is

+  only available on IA-32 and x64.

+

+  If Idtr is NULL, then ASSERT().

+

+  @param  Idtr  The pointer to a IDTR descriptor.

+

+**/

+VOID

+EFIAPI

+AsmWriteIdtr (

+  IN      CONST IA32_DESCRIPTOR     *Idtr

+  )

+{

+  ASSERT (Idtr != NULL);

+  InternalX86WriteIdtr (Idtr);

+}

diff --git a/debugging_demo/memtest86+/efi/Include/src/BaseMemoryLib/CompareMemWrapper.c b/debugging_demo/memtest86+/efi/Include/src/BaseMemoryLib/CompareMemWrapper.c
new file mode 100644
index 0000000..57d82f0
--- /dev/null
+++ b/debugging_demo/memtest86+/efi/Include/src/BaseMemoryLib/CompareMemWrapper.c
@@ -0,0 +1,60 @@
+/** @file

+  CompareMem() 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"

+

+/**

+  Compares the contents of two buffers.

+

+  This function compares Length bytes of SourceBuffer to Length bytes of DestinationBuffer.

+  If all Length bytes of the two buffers are identical, then 0 is returned.  Otherwise, the

+  value returned is the first mismatched byte in SourceBuffer subtracted from the first

+  mismatched byte in DestinationBuffer.

+

+  If Length > 0 and DestinationBuffer is NULL, then ASSERT().

+  If Length > 0 and SourceBuffer is NULL, then ASSERT().

+  If Length is greater than (MAX_ADDRESS - DestinationBuffer + 1), then ASSERT().

+  If Length is greater than (MAX_ADDRESS - SourceBuffer + 1), then ASSERT().

+

+  @param  DestinationBuffer A pointer to the destination buffer to compare.

+  @param  SourceBuffer      A pointer to the source buffer to compare.

+  @param  Length            The number of bytes to compare.

+

+  @return 0                 All Length bytes of the two buffers are identical.

+  @retval Non-zero          The first mismatched byte in SourceBuffer subtracted from the first

+                            mismatched byte in DestinationBuffer.

+

+**/

+INTN

+EFIAPI

+CompareMem (

+  IN CONST VOID  *DestinationBuffer,

+  IN CONST VOID  *SourceBuffer,

+  IN UINTN       Length

+  )

+{

+  if (Length == 0 || DestinationBuffer == SourceBuffer) {

+    return 0;

+  }

+  ASSERT (DestinationBuffer != NULL);

+  ASSERT (SourceBuffer != NULL);

+  ASSERT ((Length - 1) <= (MAX_ADDRESS - (UINTN)DestinationBuffer));

+  ASSERT ((Length - 1) <= (MAX_ADDRESS - (UINTN)SourceBuffer));

+

+  return InternalMemCompareMem (DestinationBuffer, SourceBuffer, Length);

+}

diff --git a/debugging_demo/memtest86+/efi/Include/src/BaseMemoryLib/CopyMem.c b/debugging_demo/memtest86+/efi/Include/src/BaseMemoryLib/CopyMem.c
new file mode 100644
index 0000000..55e8616
--- /dev/null
+++ b/debugging_demo/memtest86+/efi/Include/src/BaseMemoryLib/CopyMem.c
@@ -0,0 +1,148 @@
+/** @file

+  Implementation of the InternalMemCopyMem routine. This function is broken

+  out into its own source file so that it can be excluded from a build for a

+  particular platform easily if an optimized version is desired.

+

+  Copyright (c) 2006 - 2016, Intel Corporation. All rights reserved.<BR>

+  Copyright (c) 2012 - 2013, ARM Ltd. All rights reserved.<BR>

+  Copyright (c) 2016, Linaro Ltd. All rights reserved.<BR>

+

+  SPDX-License-Identifier: BSD-2-Clause-Patent

+

+**/

+

+

+

+

+#include "MemLibInternals.h"

+

+/**

+  Copy Length bytes from Source to Destination.

+

+  @param  DestinationBuffer The target of the copy request.

+  @param  SourceBuffer      The place to copy from.

+  @param  Length            The number of bytes to copy.

+

+  @return Destination

+

+**/

+VOID *

+EFIAPI

+InternalMemCopyMem (

+  OUT     VOID                      *DestinationBuffer,

+  IN      CONST VOID                *SourceBuffer,

+  IN      UINTN                     Length

+  )

+{

+  //

+  // Declare the local variables that actually move the data elements as

+  // volatile to prevent the optimizer from replacing this function with

+  // the intrinsic memcpy()

+  //

+  volatile UINT8                    *Destination8;

+  CONST UINT8                       *Source8;

+  volatile UINT32                   *Destination32;

+  CONST UINT32                      *Source32;

+  volatile UINT64                   *Destination64;

+  CONST UINT64                      *Source64;

+  UINTN                             Alignment;

+

+  if ((((UINTN)DestinationBuffer & 0x7) == 0) && (((UINTN)SourceBuffer & 0x7) == 0) && (Length >= 8)) {

+    if (SourceBuffer > DestinationBuffer) {

+      Destination64 = (UINT64*)DestinationBuffer;

+      Source64 = (CONST UINT64*)SourceBuffer;

+      while (Length >= 8) {

+        *(Destination64++) = *(Source64++);

+        Length -= 8;

+      }

+

+      // Finish if there are still some bytes to copy

+      Destination8 = (UINT8*)Destination64;

+      Source8 = (CONST UINT8*)Source64;

+      while (Length-- != 0) {

+        *(Destination8++) = *(Source8++);

+      }

+    } else if (SourceBuffer < DestinationBuffer) {

+      Destination64 = (UINT64*)((UINTN)DestinationBuffer + Length);

+      Source64 = (CONST UINT64*)((UINTN)SourceBuffer + Length);

+

+      // Destination64 and Source64 were aligned on a 64-bit boundary

+      // but if length is not a multiple of 8 bytes then they won't be

+      // anymore.

+

+      Alignment = Length & 0x7;

+      if (Alignment != 0) {

+        Destination8 = (UINT8*)Destination64;

+        Source8 = (CONST UINT8*)Source64;

+

+        while (Alignment-- != 0) {

+          *(--Destination8) = *(--Source8);

+          --Length;

+        }

+        Destination64 = (UINT64*)Destination8;

+        Source64 = (CONST UINT64*)Source8;

+      }

+

+      while (Length > 0) {

+        *(--Destination64) = *(--Source64);

+        Length -= 8;

+      }

+    }

+  } else if ((((UINTN)DestinationBuffer & 0x3) == 0) && (((UINTN)SourceBuffer & 0x3) == 0) && (Length >= 4)) {

+    if (SourceBuffer > DestinationBuffer) {

+      Destination32 = (UINT32*)DestinationBuffer;

+      Source32 = (CONST UINT32*)SourceBuffer;

+      while (Length >= 4) {

+        *(Destination32++) = *(Source32++);

+        Length -= 4;

+      }

+

+      // Finish if there are still some bytes to copy

+      Destination8 = (UINT8*)Destination32;

+      Source8 = (CONST UINT8*)Source32;

+      while (Length-- != 0) {

+        *(Destination8++) = *(Source8++);

+      }

+    } else if (SourceBuffer < DestinationBuffer) {

+      Destination32 = (UINT32*)((UINTN)DestinationBuffer + Length);

+      Source32 = (CONST UINT32*)((UINTN)SourceBuffer + Length);

+

+      // Destination32 and Source32 were aligned on a 32-bit boundary

+      // but if length is not a multiple of 4 bytes then they won't be

+      // anymore.

+

+      Alignment = Length & 0x3;

+      if (Alignment != 0) {

+        Destination8 = (UINT8*)Destination32;

+        Source8 = (CONST UINT8*)Source32;

+

+        while (Alignment-- != 0) {

+          *(--Destination8) = *(--Source8);

+          --Length;

+        }

+        Destination32 = (UINT32*)Destination8;

+        Source32 = (CONST UINT32*)Source8;

+      }

+

+      while (Length > 0) {

+        *(--Destination32) = *(--Source32);

+        Length -= 4;

+      }

+    }

+  } else {

+    if (SourceBuffer > DestinationBuffer) {

+      Destination8 = (UINT8*)DestinationBuffer;

+      Source8 = (CONST UINT8*)SourceBuffer;

+      while (Length-- != 0) {

+        *(Destination8++) = *(Source8++);

+      }

+    } else if (SourceBuffer < DestinationBuffer) {

+      Destination8 = (UINT8*)DestinationBuffer + (Length - 1);

+      Source8 = (CONST UINT8*)SourceBuffer + (Length - 1);

+      while (Length-- != 0) {

+        *(Destination8--) = *(Source8--);

+      }

+    }

+  }

+  return DestinationBuffer;

+}

diff --git a/debugging_demo/memtest86+/efi/Include/src/BaseMemoryLib/CopyMemWrapper.c b/debugging_demo/memtest86+/efi/Include/src/BaseMemoryLib/CopyMemWrapper.c
new file mode 100644
index 0000000..1ac5f33
--- /dev/null
+++ b/debugging_demo/memtest86+/efi/Include/src/BaseMemoryLib/CopyMemWrapper.c
@@ -0,0 +1,57 @@
+/** @file

+  CopyMem() 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"

+

+/**

+  Copies a source buffer to a destination buffer, and returns the destination buffer.

+

+  This function copies Length bytes from SourceBuffer to DestinationBuffer, and returns

+  DestinationBuffer.  The implementation must be reentrant, and it must handle the case

+  where SourceBuffer overlaps DestinationBuffer.

+

+  If Length is greater than (MAX_ADDRESS - DestinationBuffer + 1), then ASSERT().

+  If Length is greater than (MAX_ADDRESS - SourceBuffer + 1), then ASSERT().

+

+  @param  DestinationBuffer   A pointer to the destination buffer of the memory copy.

+  @param  SourceBuffer        A pointer to the source buffer of the memory copy.

+  @param  Length              The number of bytes to copy from SourceBuffer to DestinationBuffer.

+

+  @return DestinationBuffer.

+

+**/

+VOID *

+EFIAPI

+CopyMem (

+  OUT VOID       *DestinationBuffer,

+  IN CONST VOID  *SourceBuffer,

+  IN UINTN       Length

+  )

+{

+  if (Length == 0) {

+    return DestinationBuffer;

+  }

+  ASSERT ((Length - 1) <= (MAX_ADDRESS - (UINTN)DestinationBuffer));

+  ASSERT ((Length - 1) <= (MAX_ADDRESS - (UINTN)SourceBuffer));

+

+  if (DestinationBuffer == SourceBuffer) {

+    return DestinationBuffer;

+  }

+  return InternalMemCopyMem (DestinationBuffer, SourceBuffer, Length);

+}

diff --git a/debugging_demo/memtest86+/efi/Include/src/BaseMemoryLib/IsZeroBufferWrapper.c b/debugging_demo/memtest86+/efi/Include/src/BaseMemoryLib/IsZeroBufferWrapper.c
new file mode 100644
index 0000000..10be081
--- /dev/null
+++ b/debugging_demo/memtest86+/efi/Include/src/BaseMemoryLib/IsZeroBufferWrapper.c
@@ -0,0 +1,48 @@
+/** @file

+  Implementation of IsZeroBuffer function.

+

+  The following BaseMemoryLib instances contain the same copy of this file:

+

+    BaseMemoryLib

+    BaseMemoryLibMmx

+    BaseMemoryLibSse2

+    BaseMemoryLibRepStr

+    BaseMemoryLibOptDxe

+    BaseMemoryLibOptPei

+    PeiMemoryLib

+    UefiMemoryLib

+

+  Copyright (c) 2016, Intel Corporation. All rights reserved.<BR>

+  SPDX-License-Identifier: BSD-2-Clause-Patent

+

+**/

+

+#include "MemLibInternals.h"

+

+/**

+  Checks if the contents of a buffer are all zeros.

+

+  This function checks whether the contents of a buffer are all zeros. If the

+  contents are all zeros, return TRUE. Otherwise, return FALSE.

+

+  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 buffer to be checked.

+  @param  Length      The size of the buffer (in bytes) to be checked.

+

+  @retval TRUE        Contents of the buffer are all zeros.

+  @retval FALSE       Contents of the buffer are not all zeros.

+

+**/

+BOOLEAN

+EFIAPI

+IsZeroBuffer (

+  IN CONST VOID  *Buffer,

+  IN UINTN       Length

+  )

+{

+  ASSERT (!(Buffer == NULL && Length > 0));

+  ASSERT ((Length - 1) <= (MAX_ADDRESS - (UINTN)Buffer));

+  return InternalMemIsZeroBuffer (Buffer, Length);

+}

diff --git a/debugging_demo/memtest86+/efi/Include/src/BaseMemoryLib/MemLibGeneric.c b/debugging_demo/memtest86+/efi/Include/src/BaseMemoryLib/MemLibGeneric.c
new file mode 100644
index 0000000..6a261ae
--- /dev/null
+++ b/debugging_demo/memtest86+/efi/Include/src/BaseMemoryLib/MemLibGeneric.c
@@ -0,0 +1,287 @@
+/** @file

+  Architecture Independent Base Memory Library Implementation.

+

+  The following BaseMemoryLib instances contain the same copy of this file:

+    BaseMemoryLib

+    PeiMemoryLib

+    UefiMemoryLib

+

+  Copyright (c) 2006 - 2016, Intel Corporation. All rights reserved.<BR>

+  SPDX-License-Identifier: BSD-2-Clause-Patent

+

+**/

+

+#include "MemLibInternals.h"

+

+/**

+  Fills a target buffer with a 16-bit value, and returns the target buffer.

+

+  @param  Buffer  The pointer to the target buffer to fill.

+  @param  Length  The count of 16-bit value to fill.

+  @param  Value   The value with which to fill Length bytes of Buffer.

+

+  @return Buffer

+

+**/

+VOID *

+EFIAPI

+InternalMemSetMem16 (

+  OUT     VOID                      *Buffer,

+  IN      UINTN                     Length,

+  IN      UINT16                    Value

+  )

+{

+  for (; Length != 0; Length--) {

+    ((UINT16*)Buffer)[Length - 1] = Value;

+  }

+  return Buffer;

+}

+

+/**

+  Fills a target buffer with a 32-bit value, and returns the target buffer.

+

+  @param  Buffer  The pointer to the target buffer to fill.

+  @param  Length  The count of 32-bit value to fill.

+  @param  Value   The value with which to fill Length bytes of Buffer.

+

+  @return Buffer

+

+**/

+VOID *

+EFIAPI

+InternalMemSetMem32 (

+  OUT     VOID                      *Buffer,

+  IN      UINTN                     Length,

+  IN      UINT32                    Value

+  )

+{

+  for (; Length != 0; Length--) {

+    ((UINT32*)Buffer)[Length - 1] = Value;

+  }

+  return Buffer;

+}

+

+/**

+  Fills a target buffer with a 64-bit value, and returns the target buffer.

+

+  @param  Buffer  The pointer to the target buffer to fill.

+  @param  Length  The count of 64-bit value to fill.

+  @param  Value   The value with which to fill Length bytes of Buffer.

+

+  @return Buffer

+

+**/

+VOID *

+EFIAPI

+InternalMemSetMem64 (

+  OUT     VOID                      *Buffer,

+  IN      UINTN                     Length,

+  IN      UINT64                    Value

+  )

+{

+  for (; Length != 0; Length--) {

+    ((UINT64*)Buffer)[Length - 1] = Value;

+  }

+  return Buffer;

+}

+

+/**

+  Set Buffer to 0 for Size bytes.

+

+  @param  Buffer Memory to set.

+  @param  Length The number of bytes to set.

+

+  @return Buffer

+

+**/

+VOID *

+EFIAPI

+InternalMemZeroMem (

+  OUT     VOID                      *Buffer,

+  IN      UINTN                     Length

+  )

+{

+  return InternalMemSetMem (Buffer, Length, 0);

+}

+

+/**

+  Compares two memory buffers of a given length.

+

+  @param  DestinationBuffer The first memory buffer.

+  @param  SourceBuffer      The second memory buffer.

+  @param  Length            Length of DestinationBuffer and SourceBuffer memory

+                            regions to compare. Must be non-zero.

+

+  @return 0                 All Length bytes of the two buffers are identical.

+  @retval Non-zero          The first mismatched byte in SourceBuffer subtracted from the first

+                            mismatched byte in DestinationBuffer.

+

+**/

+INTN

+EFIAPI

+InternalMemCompareMem (

+  IN      CONST VOID                *DestinationBuffer,

+  IN      CONST VOID                *SourceBuffer,

+  IN      UINTN                     Length

+  )

+{

+  while ((--Length != 0) &&

+         (*(INT8*)DestinationBuffer == *(INT8*)SourceBuffer)) {

+    DestinationBuffer = (INT8*)DestinationBuffer + 1;

+    SourceBuffer = (INT8*)SourceBuffer + 1;

+  }

+  return (INTN)*(UINT8*)DestinationBuffer - (INTN)*(UINT8*)SourceBuffer;

+}

+

+/**

+  Scans a target buffer for an 8-bit value, and returns a pointer to the

+  matching 8-bit value in the target buffer.

+

+  @param  Buffer  The pointer to the target buffer to scan.

+  @param  Length  The count of 8-bit value to scan. Must be non-zero.

+  @param  Value   The value to search for in the target buffer.

+

+  @return The pointer to the first occurrence, or NULL if not found.

+

+**/

+CONST VOID *

+EFIAPI

+InternalMemScanMem8 (

+  IN      CONST VOID                *Buffer,

+  IN      UINTN                     Length,

+  IN      UINT8                     Value

+  )

+{

+  CONST UINT8                       *Pointer;

+

+  Pointer = (CONST UINT8*)Buffer;

+  do {

+    if (*Pointer == Value) {

+      return Pointer;

+    }

+    ++Pointer;

+  } while (--Length != 0);

+  return NULL;

+}

+

+/**

+  Scans a target buffer for a 16-bit value, and returns a pointer to the

+  matching 16-bit value in the target buffer.

+

+  @param  Buffer  The pointer to the target buffer to scan.

+  @param  Length  The count of 16-bit value to scan. Must be non-zero.

+  @param  Value   The value to search for in the target buffer.

+

+  @return The pointer to the first occurrence, or NULL if not found.

+

+**/

+CONST VOID *

+EFIAPI

+InternalMemScanMem16 (

+  IN      CONST VOID                *Buffer,

+  IN      UINTN                     Length,

+  IN      UINT16                    Value

+  )

+{

+  CONST UINT16                      *Pointer;

+

+  Pointer = (CONST UINT16*)Buffer;

+  do {

+    if (*Pointer == Value) {

+      return Pointer;

+    }

+    ++Pointer;

+  } while (--Length != 0);

+  return NULL;

+}

+

+/**

+  Scans a target buffer for a 32-bit value, and returns a pointer to the

+  matching 32-bit value in the target buffer.

+

+  @param  Buffer  The pointer to the target buffer to scan.

+  @param  Length  The count of 32-bit value to scan. Must be non-zero.

+  @param  Value   The value to search for in the target buffer.

+

+  @return The pointer to the first occurrence, or NULL if not found.

+

+**/

+CONST VOID *

+EFIAPI

+InternalMemScanMem32 (

+  IN      CONST VOID                *Buffer,

+  IN      UINTN                     Length,

+  IN      UINT32                    Value

+  )

+{

+  CONST UINT32                      *Pointer;

+

+  Pointer = (CONST UINT32*)Buffer;

+  do {

+    if (*Pointer == Value) {

+      return Pointer;

+    }

+    ++Pointer;

+  } while (--Length != 0);

+  return NULL;

+}

+

+/**

+  Scans a target buffer for a 64-bit value, and returns a pointer to the

+  matching 64-bit value in the target buffer.

+

+  @param  Buffer  The pointer to the target buffer to scan.

+  @param  Length  The count of 64-bit value to scan. Must be non-zero.

+  @param  Value   The value to search for in the target buffer.

+

+  @return The pointer to the first occurrence, or NULL if not found.

+

+**/

+CONST VOID *

+EFIAPI

+InternalMemScanMem64 (

+  IN      CONST VOID                *Buffer,

+  IN      UINTN                     Length,

+  IN      UINT64                    Value

+  )

+{

+  CONST UINT64                      *Pointer;

+

+  Pointer = (CONST UINT64*)Buffer;

+  do {

+    if (*Pointer == Value) {

+      return Pointer;

+    }

+    ++Pointer;

+  } while (--Length != 0);

+  return NULL;

+}

+

+/**

+  Checks whether the contents of a buffer are all zeros.

+

+  @param  Buffer  The pointer to the buffer to be checked.

+  @param  Length  The size of the buffer (in bytes) to be checked.

+

+  @retval TRUE    Contents of the buffer are all zeros.

+  @retval FALSE   Contents of the buffer are not all zeros.

+

+**/

+BOOLEAN

+EFIAPI

+InternalMemIsZeroBuffer (

+  IN CONST VOID  *Buffer,

+  IN UINTN       Length

+  )

+{

+  CONST UINT8 *BufferData;

+  UINTN       Index;

+

+  BufferData = Buffer;

+  for (Index = 0; Index < Length; Index++) {

+    if (BufferData[Index] != 0) {

+      return FALSE;

+    }

+  }

+  return TRUE;

+}

diff --git a/debugging_demo/memtest86+/efi/Include/src/BaseMemoryLib/MemLibGuid.c b/debugging_demo/memtest86+/efi/Include/src/BaseMemoryLib/MemLibGuid.c
new file mode 100644
index 0000000..e2976dd
--- /dev/null
+++ b/debugging_demo/memtest86+/efi/Include/src/BaseMemoryLib/MemLibGuid.c
@@ -0,0 +1,165 @@
+/** @file

+  Implementation of GUID functions.

+

+  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"

+

+/**

+  Copies a source GUID to a destination GUID.

+

+  This function copies the contents of the 128-bit GUID specified by SourceGuid to

+  DestinationGuid, and returns DestinationGuid.

+

+  If DestinationGuid is NULL, then ASSERT().

+  If SourceGuid is NULL, then ASSERT().

+

+  @param  DestinationGuid   A pointer to the destination GUID.

+  @param  SourceGuid        A pointer to the source GUID.

+

+  @return DestinationGuid.

+

+**/

+GUID *

+EFIAPI

+CopyGuid (

+  OUT GUID       *DestinationGuid,

+  IN CONST GUID  *SourceGuid

+  )

+{

+  WriteUnaligned64 (

+    (UINT64*)DestinationGuid,

+    ReadUnaligned64 ((CONST UINT64*)SourceGuid)

+    );

+  WriteUnaligned64 (

+    (UINT64*)DestinationGuid + 1,

+    ReadUnaligned64 ((CONST UINT64*)SourceGuid + 1)

+    );

+  return DestinationGuid;

+}

+

+/**

+  Compares two GUIDs.

+

+  This function compares Guid1 to Guid2.  If the GUIDs are identical then TRUE is returned.

+  If there are any bit differences in the two GUIDs, then FALSE is returned.

+

+  If Guid1 is NULL, then ASSERT().

+  If Guid2 is NULL, then ASSERT().

+

+  @param  Guid1       A pointer to a 128 bit GUID.

+  @param  Guid2       A pointer to a 128 bit GUID.

+

+  @retval TRUE        Guid1 and Guid2 are identical.

+  @retval FALSE       Guid1 and Guid2 are not identical.

+

+**/

+BOOLEAN

+EFIAPI

+CompareGuid (

+  IN CONST GUID  *Guid1,

+  IN CONST GUID  *Guid2

+  )

+{

+  UINT64  LowPartOfGuid1;

+  UINT64  LowPartOfGuid2;

+  UINT64  HighPartOfGuid1;

+  UINT64  HighPartOfGuid2;

+

+  LowPartOfGuid1  = ReadUnaligned64 ((CONST UINT64*) Guid1);

+  LowPartOfGuid2  = ReadUnaligned64 ((CONST UINT64*) Guid2);

+  HighPartOfGuid1 = ReadUnaligned64 ((CONST UINT64*) Guid1 + 1);

+  HighPartOfGuid2 = ReadUnaligned64 ((CONST UINT64*) Guid2 + 1);

+

+  return (BOOLEAN) (LowPartOfGuid1 == LowPartOfGuid2 && HighPartOfGuid1 == HighPartOfGuid2);

+}

+

+/**

+  Scans a target buffer for a GUID, and returns a pointer to the matching GUID

+  in the target buffer.

+

+  This function searches the target buffer specified by Buffer and Length from

+  the lowest address to the highest address at 128-bit increments for the 128-bit

+  GUID value that matches Guid.  If a match is found, then a pointer to the matching

+  GUID 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 32-bit boundary, then ASSERT().

+  If Length is not aligned on a 128-bit 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  Guid    The value to search for in the target buffer.

+

+  @return A pointer to the matching Guid in the target buffer or NULL otherwise.

+

+**/

+VOID *

+EFIAPI

+ScanGuid (

+  IN CONST VOID  *Buffer,

+  IN UINTN       Length,

+  IN CONST GUID  *Guid

+  )

+{

+  CONST GUID                        *GuidPtr;

+

+  ASSERT (((UINTN)Buffer & (sizeof (Guid->Data1) - 1)) == 0);

+  ASSERT (Length <= (MAX_ADDRESS - (UINTN)Buffer + 1));

+  ASSERT ((Length & (sizeof (*GuidPtr) - 1)) == 0);

+

+  GuidPtr = (GUID*)Buffer;

+  Buffer  = GuidPtr + Length / sizeof (*GuidPtr);

+  while (GuidPtr < (CONST GUID*)Buffer) {

+    if (CompareGuid (GuidPtr, Guid)) {

+      return (VOID*)GuidPtr;

+    }

+    GuidPtr++;

+  }

+  return NULL;

+}

+

+/**

+  Checks if the given GUID is a zero GUID.

+

+  This function checks whether the given GUID is a zero GUID. If the GUID is

+  identical to a zero GUID then TRUE is returned. Otherwise, FALSE is returned.

+

+  If Guid is NULL, then ASSERT().

+

+  @param  Guid        The pointer to a 128 bit GUID.

+

+  @retval TRUE        Guid is a zero GUID.

+  @retval FALSE       Guid is not a zero GUID.

+

+**/

+BOOLEAN

+EFIAPI

+IsZeroGuid (

+  IN CONST GUID  *Guid

+  )

+{

+  UINT64  LowPartOfGuid;

+  UINT64  HighPartOfGuid;

+

+  LowPartOfGuid  = ReadUnaligned64 ((CONST UINT64*) Guid);

+  HighPartOfGuid = ReadUnaligned64 ((CONST UINT64*) Guid + 1);

+

+  return (BOOLEAN) (LowPartOfGuid == 0 && HighPartOfGuid == 0);

+}

diff --git a/debugging_demo/memtest86+/efi/Include/src/BaseMemoryLib/MemLibInternals.h b/debugging_demo/memtest86+/efi/Include/src/BaseMemoryLib/MemLibInternals.h
new file mode 100644
index 0000000..9d3730a
--- /dev/null
+++ b/debugging_demo/memtest86+/efi/Include/src/BaseMemoryLib/MemLibInternals.h
@@ -0,0 +1,245 @@
+/** @file

+  Declaration of internal functions for Base Memory Library.

+

+  The following BaseMemoryLib instances contain the same copy of this file:

+    BaseMemoryLib

+    BaseMemoryLibMmx

+    BaseMemoryLibSse2

+    BaseMemoryLibRepStr

+    BaseMemoryLibOptDxe

+    BaseMemoryLibOptPei

+

+  Copyright (c) 2006 - 2016, Intel Corporation. All rights reserved.<BR>

+  SPDX-License-Identifier: BSD-2-Clause-Patent

+

+**/

+

+#ifndef __MEM_LIB_INTERNALS__

+#define __MEM_LIB_INTERNALS__

+

+#include <Base.h>

+#include <Library/BaseMemoryLib.h>

+#include <Library/BaseLib.h>

+#include <Library/DebugLib.h>

+

+/**

+  Copy Length bytes from Source to Destination.

+

+  @param  DestinationBuffer Target of copy

+  @param  SourceBuffer      Place to copy from

+  @param  Length            The number of bytes to copy

+

+  @return Destination

+

+**/

+VOID *

+EFIAPI

+InternalMemCopyMem (

+  OUT     VOID                      *DestinationBuffer,

+  IN      CONST VOID                *SourceBuffer,

+  IN      UINTN                     Length

+  );

+

+/**

+  Set Buffer to Value for Size bytes.

+

+  @param  Buffer   The memory to set.

+  @param  Length   The number of bytes to set

+  @param  Value    The value of the set operation.

+

+  @return Buffer

+

+**/

+VOID *

+EFIAPI

+InternalMemSetMem (

+  OUT     VOID                      *Buffer,

+  IN      UINTN                     Length,

+  IN      UINT8                     Value

+  );

+

+/**

+  Fills a target buffer with a 16-bit value, and returns the target buffer.

+

+  @param  Buffer  The pointer to the target buffer to fill.

+  @param  Length  The count of 16-bit value to fill.

+  @param  Value   The value with which to fill Length bytes of Buffer.

+

+  @return Buffer

+

+**/

+VOID *

+EFIAPI

+InternalMemSetMem16 (

+  OUT     VOID                      *Buffer,

+  IN      UINTN                     Length,

+  IN      UINT16                    Value

+  );

+

+/**

+  Fills a target buffer with a 32-bit value, and returns the target buffer.

+

+  @param  Buffer  The pointer to the target buffer to fill.

+  @param  Length  The count of 32-bit value to fill.

+  @param  Value   The value with which to fill Length bytes of Buffer.

+

+  @return Buffer

+

+**/

+VOID *

+EFIAPI

+InternalMemSetMem32 (

+  OUT     VOID                      *Buffer,

+  IN      UINTN                     Length,

+  IN      UINT32                    Value

+  );

+

+/**

+  Fills a target buffer with a 64-bit value, and returns the target buffer.

+

+  @param  Buffer  The pointer to the target buffer to fill.

+  @param  Length  The count of 64-bit value to fill.

+  @param  Value   The value with which to fill Length bytes of Buffer.

+

+  @return Buffer

+

+**/

+VOID *

+EFIAPI

+InternalMemSetMem64 (

+  OUT     VOID                      *Buffer,

+  IN      UINTN                     Length,

+  IN      UINT64                    Value

+  );

+

+/**

+  Set Buffer to 0 for Size bytes.

+

+  @param  Buffer The memory to set.

+  @param  Length The number of bytes to set.

+

+  @return Buffer

+

+**/

+VOID *

+EFIAPI

+InternalMemZeroMem (

+  OUT     VOID                      *Buffer,

+  IN      UINTN                     Length

+  );

+

+/**

+  Compares two memory buffers of a given length.

+

+  @param  DestinationBuffer The first memory buffer.

+  @param  SourceBuffer      The second memory buffer.

+  @param  Length            The length of DestinationBuffer and SourceBuffer memory

+                            regions to compare. Must be non-zero.

+

+  @return 0                 All Length bytes of the two buffers are identical.

+  @retval Non-zero          The first mismatched byte in SourceBuffer subtracted from the first

+                            mismatched byte in DestinationBuffer.

+

+**/

+INTN

+EFIAPI

+InternalMemCompareMem (

+  IN      CONST VOID                *DestinationBuffer,

+  IN      CONST VOID                *SourceBuffer,

+  IN      UINTN                     Length

+  );

+

+/**

+  Scans a target buffer for an 8-bit value, and returns a pointer to the

+  matching 8-bit value in the target buffer.

+

+  @param  Buffer  The pointer to the target buffer to scan.

+  @param  Length  The count of 8-bit value to scan. Must be non-zero.

+  @param  Value   The value to search for in the target buffer.

+

+  @return The pointer to the first occurrence, or NULL if not found.

+

+**/

+CONST VOID *

+EFIAPI

+InternalMemScanMem8 (

+  IN      CONST VOID                *Buffer,

+  IN      UINTN                     Length,

+  IN      UINT8                     Value

+  );

+

+/**

+  Scans a target buffer for a 16-bit value, and returns a pointer to the

+  matching 16-bit value in the target buffer.

+

+  @param  Buffer  The pointer to the target buffer to scan.

+  @param  Length  The count of 16-bit value to scan. Must be non-zero.

+  @param  Value   The value to search for in the target buffer.

+

+  @return The pointer to the first occurrence, or NULL if not found.

+

+**/

+CONST VOID *

+EFIAPI

+InternalMemScanMem16 (

+  IN      CONST VOID                *Buffer,

+  IN      UINTN                     Length,

+  IN      UINT16                    Value

+  );

+

+/**

+  Scans a target buffer for a 32-bit value, and returns a pointer to the

+  matching 32-bit value in the target buffer.

+

+  @param  Buffer  The pointer to the target buffer to scan.

+  @param  Length  The count of 32-bit value to scan. Must be non-zero.

+  @param  Value   The value to search for in the target buffer.

+

+  @return The pointer to the first occurrence, or NULL if not found.

+

+**/

+CONST VOID *

+EFIAPI

+InternalMemScanMem32 (

+  IN      CONST VOID                *Buffer,

+  IN      UINTN                     Length,

+  IN      UINT32                    Value

+  );

+

+/**

+  Scans a target buffer for a 64-bit value, and returns a pointer to the

+  matching 64-bit value in the target buffer.

+

+  @param  Buffer  The pointer to the target buffer to scan.

+  @param  Length  The count of 64-bit value to scan. Must be non-zero.

+  @param  Value   The calue to search for in the target buffer.

+

+  @return The pointer to the first occurrence, or NULL if not found.

+

+**/

+CONST VOID *

+EFIAPI

+InternalMemScanMem64 (

+  IN      CONST VOID                *Buffer,

+  IN      UINTN                     Length,

+  IN      UINT64                    Value

+  );

+

+/**

+  Checks whether the contents of a buffer are all zeros.

+

+  @param  Buffer  The pointer to the buffer to be checked.

+  @param  Length  The size of the buffer (in bytes) to be checked.

+

+  @retval TRUE    Contents of the buffer are all zeros.

+  @retval FALSE   Contents of the buffer are not all zeros.

+

+**/

+BOOLEAN

+EFIAPI

+InternalMemIsZeroBuffer (

+  IN CONST VOID  *Buffer,

+  IN UINTN       Length

+  );

+

+#endif

diff --git a/debugging_demo/memtest86+/efi/Include/src/BaseMemoryLib/ScanMem16Wrapper.c b/debugging_demo/memtest86+/efi/Include/src/BaseMemoryLib/ScanMem16Wrapper.c
new file mode 100644
index 0000000..8201313
--- /dev/null
+++ b/debugging_demo/memtest86+/efi/Include/src/BaseMemoryLib/ScanMem16Wrapper.c
@@ -0,0 +1,61 @@
+/** @file

+  ScanMem16() 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 a 16-bit value, and returns a pointer to the matching 16-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 a 16-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 Buffer is not aligned on a 16-bit boundary, then ASSERT().

+  If Length is not aligned on a 16-bit 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

+ScanMem16 (

+  IN CONST VOID  *Buffer,

+  IN UINTN       Length,

+  IN UINT16      Value

+  )

+{

+  if (Length == 0) {

+    return NULL;

+  }

+

+  ASSERT (Buffer != NULL);

+  ASSERT (((UINTN)Buffer & (sizeof (Value) - 1)) == 0);

+  ASSERT ((Length - 1) <= (MAX_ADDRESS - (UINTN)Buffer));

+  ASSERT ((Length & (sizeof (Value) - 1)) == 0);

+

+  return (VOID*)InternalMemScanMem16 (Buffer, Length / sizeof (Value), Value);

+}

diff --git a/debugging_demo/memtest86+/efi/Include/src/BaseMemoryLib/ScanMem32Wrapper.c b/debugging_demo/memtest86+/efi/Include/src/BaseMemoryLib/ScanMem32Wrapper.c
new file mode 100644
index 0000000..22c0c79
--- /dev/null
+++ b/debugging_demo/memtest86+/efi/Include/src/BaseMemoryLib/ScanMem32Wrapper.c
@@ -0,0 +1,60 @@
+/** @file

+  ScanMem32() 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 a 32-bit value, and returns a pointer to the matching 32-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 a 32-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 Buffer is not aligned on a 32-bit boundary, then ASSERT().

+  If Length is not aligned on a 32-bit 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

+ScanMem32 (

+  IN CONST VOID  *Buffer,

+  IN UINTN       Length,

+  IN UINT32      Value

+  )

+{

+  if (Length == 0) {

+    return NULL;

+  }

+

+  ASSERT (Buffer != NULL);

+  ASSERT (((UINTN)Buffer & (sizeof (Value) - 1)) == 0);

+  ASSERT ((Length - 1) <= (MAX_ADDRESS - (UINTN)Buffer));

+  ASSERT ((Length & (sizeof (Value) - 1)) == 0);

+

+  return (VOID*)InternalMemScanMem32 (Buffer, Length / sizeof (Value), Value);

+}

diff --git a/debugging_demo/memtest86+/efi/Include/src/BaseMemoryLib/ScanMem64Wrapper.c b/debugging_demo/memtest86+/efi/Include/src/BaseMemoryLib/ScanMem64Wrapper.c
new file mode 100644
index 0000000..a617d87
--- /dev/null
+++ b/debugging_demo/memtest86+/efi/Include/src/BaseMemoryLib/ScanMem64Wrapper.c
@@ -0,0 +1,61 @@
+/** @file

+  ScanMem64() 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 a 64-bit value, and returns a pointer to the matching 64-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 a 64-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 Buffer is not aligned on a 64-bit boundary, then ASSERT().

+  If Length is not aligned on a 64-bit 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

+ScanMem64 (

+  IN CONST VOID  *Buffer,

+  IN UINTN       Length,

+  IN UINT64      Value

+  )

+{

+  if (Length == 0) {

+    return NULL;

+  }

+

+  ASSERT (Buffer != NULL);

+  ASSERT (((UINTN)Buffer & (sizeof (Value) - 1)) == 0);

+  ASSERT ((Length - 1) <= (MAX_ADDRESS - (UINTN)Buffer));

+  ASSERT ((Length & (sizeof (Value) - 1)) == 0);

+

+  return (VOID*)InternalMemScanMem64 (Buffer, Length / sizeof (Value), Value);

+}

diff --git a/debugging_demo/memtest86+/efi/Include/src/BaseMemoryLib/ScanMem8Wrapper.c b/debugging_demo/memtest86+/efi/Include/src/BaseMemoryLib/ScanMem8Wrapper.c
new file mode 100644
index 0000000..fb2c5a4
--- /dev/null
+++ b/debugging_demo/memtest86+/efi/Include/src/BaseMemoryLib/ScanMem8Wrapper.c
@@ -0,0 +1,93 @@
+/** @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);

+  }

+}

+

diff --git a/debugging_demo/memtest86+/efi/Include/src/BaseMemoryLib/SetMem.c b/debugging_demo/memtest86+/efi/Include/src/BaseMemoryLib/SetMem.c
new file mode 100644
index 0000000..d42abb1
--- /dev/null
+++ b/debugging_demo/memtest86+/efi/Include/src/BaseMemoryLib/SetMem.c
@@ -0,0 +1,81 @@
+/** @file

+  Implementation of the EfiSetMem routine. This function is broken

+  out into its own source file so that it can be excluded from a

+  build for a particular platform easily if an optimized version

+  is desired.

+

+  Copyright (c) 2006 - 2010, Intel Corporation. All rights reserved.<BR>

+  Copyright (c) 2012 - 2013, ARM Ltd. All rights reserved.<BR>

+  Copyright (c) 2016, Linaro Ltd. All rights reserved.<BR>

+

+  SPDX-License-Identifier: BSD-2-Clause-Patent

+

+**/

+

+

+

+

+#include "MemLibInternals.h"

+

+/**

+  Set Buffer to Value for Size bytes.

+

+  @param  Buffer   The memory to set.

+  @param  Length   The number of bytes to set.

+  @param  Value    The value of the set operation.

+

+  @return Buffer

+

+**/

+VOID *

+EFIAPI

+InternalMemSetMem (

+  OUT     VOID                      *Buffer,

+  IN      UINTN                     Length,

+  IN      UINT8                     Value

+  )

+{

+  //

+  // Declare the local variables that actually move the data elements as

+  // volatile to prevent the optimizer from replacing this function with

+  // the intrinsic memset()

+  //

+  volatile UINT8                    *Pointer8;

+  volatile UINT32                   *Pointer32;

+  volatile UINT64                   *Pointer64;

+  UINT32                            Value32;

+  UINT64                            Value64;

+

+  if ((((UINTN)Buffer & 0x7) == 0) && (Length >= 8)) {

+    // Generate the 64bit value

+    Value32 = (Value << 24) | (Value << 16) | (Value << 8) | Value;

+    Value64 = LShiftU64 (Value32, 32) | Value32;

+

+    Pointer64 = (UINT64*)Buffer;

+    while (Length >= 8) {

+      *(Pointer64++) = Value64;

+      Length -= 8;

+    }

+

+    // Finish with bytes if needed

+    Pointer8 = (UINT8*)Pointer64;

+  } else if ((((UINTN)Buffer & 0x3) == 0) && (Length >= 4)) {

+    // Generate the 32bit value

+    Value32 = (Value << 24) | (Value << 16) | (Value << 8) | Value;

+

+    Pointer32 = (UINT32*)Buffer;

+    while (Length >= 4) {

+      *(Pointer32++) = Value32;

+      Length -= 4;

+    }

+

+    // Finish with bytes if needed

+    Pointer8 = (UINT8*)Pointer32;

+  } else {

+    Pointer8 = (UINT8*)Buffer;

+  }

+  while (Length-- > 0) {

+    *(Pointer8++) = Value;

+  }

+  return Buffer;

+}

diff --git a/debugging_demo/memtest86+/efi/Include/src/BaseMemoryLib/SetMem16Wrapper.c b/debugging_demo/memtest86+/efi/Include/src/BaseMemoryLib/SetMem16Wrapper.c
new file mode 100644
index 0000000..9ac4641
--- /dev/null
+++ b/debugging_demo/memtest86+/efi/Include/src/BaseMemoryLib/SetMem16Wrapper.c
@@ -0,0 +1,58 @@
+/** @file

+  SetMem16() implementation.

+

+  The following BaseMemoryLib instances contain the same copy of this file:

+    BaseMemoryLib

+    BaseMemoryLibMmx

+    BaseMemoryLibSse2

+    BaseMemoryLibRepStr

+    BaseMemoryLibOptDxe

+    BaseMemoryLibOptPei

+    PeiMemoryLib

+    UefiMemoryLib

+

+  Copyright (c) 2006 - 2010, Intel Corporation. All rights reserved.<BR>

+  SPDX-License-Identifier: BSD-2-Clause-Patent

+

+**/

+

+#include "MemLibInternals.h"

+

+/**

+  Fills a target buffer with a 16-bit value, and returns the target buffer.

+

+  This function fills Length bytes of Buffer with the 16-bit value specified by

+  Value, and returns Buffer. Value is repeated every 16-bits in for Length

+  bytes of Buffer.

+

+  If Length > 0 and Buffer is NULL, then ASSERT().

+  If Length is greater than (MAX_ADDRESS - Buffer + 1), then ASSERT().

+  If Buffer is not aligned on a 16-bit boundary, then ASSERT().

+  If Length is not aligned on a 16-bit boundary, then ASSERT().

+

+  @param  Buffer  The pointer to the target buffer to fill.

+  @param  Length  The number of bytes in Buffer to fill.

+  @param  Value   The value with which to fill Length bytes of Buffer.

+

+  @return Buffer.

+

+**/

+VOID *

+EFIAPI

+SetMem16 (

+  OUT VOID   *Buffer,

+  IN UINTN   Length,

+  IN UINT16  Value

+  )

+{

+  if (Length == 0) {

+    return Buffer;

+  }

+

+  ASSERT (Buffer != NULL);

+  ASSERT ((Length - 1) <= (MAX_ADDRESS - (UINTN)Buffer));

+  ASSERT ((((UINTN)Buffer) & (sizeof (Value) - 1)) == 0);

+  ASSERT ((Length & (sizeof (Value) - 1)) == 0);

+

+  return InternalMemSetMem16 (Buffer, Length / sizeof (Value), Value);

+}

diff --git a/debugging_demo/memtest86+/efi/Include/src/BaseMemoryLib/SetMem32Wrapper.c b/debugging_demo/memtest86+/efi/Include/src/BaseMemoryLib/SetMem32Wrapper.c
new file mode 100644
index 0000000..e504deb
--- /dev/null
+++ b/debugging_demo/memtest86+/efi/Include/src/BaseMemoryLib/SetMem32Wrapper.c
@@ -0,0 +1,58 @@
+/** @file

+  SetMem32() implementation.

+

+  The following BaseMemoryLib instances contain the same copy of this file:

+    BaseMemoryLib

+    BaseMemoryLibMmx

+    BaseMemoryLibSse2

+    BaseMemoryLibRepStr

+    BaseMemoryLibOptDxe

+    BaseMemoryLibOptPei

+    PeiMemoryLib

+    UefiMemoryLib

+

+  Copyright (c) 2006 - 2010, Intel Corporation. All rights reserved.<BR>

+  SPDX-License-Identifier: BSD-2-Clause-Patent

+

+**/

+

+#include "MemLibInternals.h"

+

+/**

+  Fills a target buffer with a 32-bit value, and returns the target buffer.

+

+  This function fills Length bytes of Buffer with the 32-bit value specified by

+  Value, and returns Buffer. Value is repeated every 32-bits in for Length

+  bytes of Buffer.

+

+  If Length > 0 and Buffer is NULL, then ASSERT().

+  If Length is greater than (MAX_ADDRESS - Buffer + 1), then ASSERT().

+  If Buffer is not aligned on a 32-bit boundary, then ASSERT().

+  If Length is not aligned on a 32-bit boundary, then ASSERT().

+

+  @param  Buffer  The pointer to the target buffer to fill.

+  @param  Length  The number of bytes in Buffer to fill.

+  @param  Value   The value with which to fill Length bytes of Buffer.

+

+  @return Buffer.

+

+**/

+VOID *

+EFIAPI

+SetMem32 (

+  OUT VOID   *Buffer,

+  IN UINTN   Length,

+  IN UINT32  Value

+  )

+{

+  if (Length == 0) {

+    return Buffer;

+  }

+

+  ASSERT (Buffer != NULL);

+  ASSERT ((Length - 1) <= (MAX_ADDRESS - (UINTN)Buffer));

+  ASSERT ((((UINTN)Buffer) & (sizeof (Value) - 1)) == 0);

+  ASSERT ((Length & (sizeof (Value) - 1)) == 0);

+

+  return InternalMemSetMem32 (Buffer, Length / sizeof (Value), Value);

+}

diff --git a/debugging_demo/memtest86+/efi/Include/src/BaseMemoryLib/SetMem64Wrapper.c b/debugging_demo/memtest86+/efi/Include/src/BaseMemoryLib/SetMem64Wrapper.c
new file mode 100644
index 0000000..fbb3762
--- /dev/null
+++ b/debugging_demo/memtest86+/efi/Include/src/BaseMemoryLib/SetMem64Wrapper.c
@@ -0,0 +1,58 @@
+/** @file

+  SetMem64() implementation.

+

+  The following BaseMemoryLib instances contain the same copy of this file:

+    BaseMemoryLib

+    BaseMemoryLibMmx

+    BaseMemoryLibSse2

+    BaseMemoryLibRepStr

+    BaseMemoryLibOptDxe

+    BaseMemoryLibOptPei

+    PeiMemoryLib

+    UefiMemoryLib

+

+  Copyright (c) 2006 - 2010, Intel Corporation. All rights reserved.<BR>

+  SPDX-License-Identifier: BSD-2-Clause-Patent

+

+**/

+

+#include "MemLibInternals.h"

+

+/**

+  Fills a target buffer with a 64-bit value, and returns the target buffer.

+

+  This function fills Length bytes of Buffer with the 64-bit value specified by

+  Value, and returns Buffer. Value is repeated every 64-bits in for Length

+  bytes of Buffer.

+

+  If Length > 0 and Buffer is NULL, then ASSERT().

+  If Length is greater than (MAX_ADDRESS - Buffer + 1), then ASSERT().

+  If Buffer is not aligned on a 64-bit boundary, then ASSERT().

+  If Length is not aligned on a 64-bit boundary, then ASSERT().

+

+  @param  Buffer  The pointer to the target buffer to fill.

+  @param  Length  The number of bytes in Buffer to fill.

+  @param  Value   The value with which to fill Length bytes of Buffer.

+

+  @return Buffer.

+

+**/

+VOID *

+EFIAPI

+SetMem64 (

+  OUT VOID   *Buffer,

+  IN UINTN   Length,

+  IN UINT64  Value

+  )

+{

+  if (Length == 0) {

+    return Buffer;

+  }

+

+  ASSERT (Buffer != NULL);

+  ASSERT ((Length - 1) <= (MAX_ADDRESS - (UINTN)Buffer));

+  ASSERT ((((UINTN)Buffer) & (sizeof (Value) - 1)) == 0);

+  ASSERT ((Length & (sizeof (Value) - 1)) == 0);

+

+  return InternalMemSetMem64 (Buffer, Length / sizeof (Value), Value);

+}

diff --git a/debugging_demo/memtest86+/efi/Include/src/BaseMemoryLib/SetMemWrapper.c b/debugging_demo/memtest86+/efi/Include/src/BaseMemoryLib/SetMemWrapper.c
new file mode 100644
index 0000000..39ec8cb
--- /dev/null
+++ b/debugging_demo/memtest86+/efi/Include/src/BaseMemoryLib/SetMemWrapper.c
@@ -0,0 +1,85 @@
+/** @file

+  SetMem() and SetMemN() 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"

+

+/**

+  Fills a target buffer with a byte value, and returns the target buffer.

+

+  This function fills Length bytes of Buffer with Value, and returns Buffer.

+

+  If Length is greater than (MAX_ADDRESS - Buffer + 1), then ASSERT().

+

+  @param  Buffer    The memory to set.

+  @param  Length    The number of bytes to set.

+  @param  Value     The value with which to fill Length bytes of Buffer.

+

+  @return Buffer.

+

+**/

+VOID *

+EFIAPI

+SetMem (

+  OUT VOID  *Buffer,

+  IN UINTN  Length,

+  IN UINT8  Value

+  )

+{

+  if (Length == 0) {

+    return Buffer;

+  }

+

+  ASSERT ((Length - 1) <= (MAX_ADDRESS - (UINTN)Buffer));

+

+  return InternalMemSetMem (Buffer, Length, Value);

+}

+

+/**

+  Fills a target buffer with a value that is size UINTN, and returns the target buffer.

+

+  This function fills Length bytes of Buffer with the UINTN sized value specified by

+  Value, and returns Buffer. Value is repeated every sizeof(UINTN) bytes for Length

+  bytes of Buffer.

+

+  If Length > 0 and Buffer is NULL, then ASSERT().

+  If Length is greater than (MAX_ADDRESS - Buffer + 1), then ASSERT().

+  If Buffer is not aligned on a UINTN boundary, then ASSERT().

+  If Length is not aligned on a UINTN boundary, then ASSERT().

+

+  @param  Buffer  The pointer to the target buffer to fill.

+  @param  Length  The number of bytes in Buffer to fill.

+  @param  Value   The value with which to fill Length bytes of Buffer.

+

+  @return Buffer.

+

+**/

+VOID *

+EFIAPI

+SetMemN (

+  OUT VOID  *Buffer,

+  IN UINTN  Length,

+  IN UINTN  Value

+  )

+{

+  if (sizeof (UINTN) == sizeof (UINT64)) {

+    return SetMem64 (Buffer, Length, (UINT64)Value);

+  } else {

+    return SetMem32 (Buffer, Length, (UINT32)Value);

+  }

+}

diff --git a/debugging_demo/memtest86+/efi/Include/src/BaseMemoryLib/ZeroMemWrapper.c b/debugging_demo/memtest86+/efi/Include/src/BaseMemoryLib/ZeroMemWrapper.c
new file mode 100644
index 0000000..5964118
--- /dev/null
+++ b/debugging_demo/memtest86+/efi/Include/src/BaseMemoryLib/ZeroMemWrapper.c
@@ -0,0 +1,50 @@
+/** @file

+  ZeroMem() 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"

+

+/**

+  Fills a target buffer with zeros, and returns the target buffer.

+

+  This function fills Length bytes of Buffer with zeros, and returns Buffer.

+

+  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 fill with zeros.

+  @param  Length      The number of bytes in Buffer to fill with zeros.

+

+  @return Buffer.

+

+**/

+VOID *

+EFIAPI

+ZeroMem (

+  OUT VOID  *Buffer,

+  IN UINTN  Length

+  )

+{

+  if (Length == 0) {

+    return Buffer;

+  }

+

+  ASSERT (Buffer != NULL);

+  ASSERT (Length <= (MAX_ADDRESS - (UINTN)Buffer + 1));

+  return InternalMemZeroMem (Buffer, Length);

+}

diff --git a/debugging_demo/memtest86+/efi/Include/src/BasePrintLib/PrintLib.c b/debugging_demo/memtest86+/efi/Include/src/BasePrintLib/PrintLib.c
new file mode 100644
index 0000000..8bfbab0
--- /dev/null
+++ b/debugging_demo/memtest86+/efi/Include/src/BasePrintLib/PrintLib.c
@@ -0,0 +1,837 @@
+/** @file

+  Base Print Library instance implementation.

+

+  Copyright (c) 2006 - 2018, Intel Corporation. All rights reserved.<BR>

+  Portions copyright (c) 2008 - 2009, Apple Inc. All rights reserved.<BR>

+  SPDX-License-Identifier: BSD-2-Clause-Patent

+

+**/

+

+#include "PrintLibInternal.h"

+

+//

+// Declare a VA_LIST global variable that is used in calls to BasePrintLibSPrintMarker()

+// when the BASE_LIST parameter is valid and the VA_LIST parameter is ignored.

+// A NULL VA_LIST can not be passed into  BasePrintLibSPrintMarker() because some

+// compilers define VA_LIST to be a structure.

+//

+VA_LIST gNullVaList;

+

+#define ASSERT_UNICODE_BUFFER(Buffer) ASSERT ((((UINTN) (Buffer)) & 0x01) == 0)

+

+/**

+  Produces a Null-terminated Unicode string in an output buffer based on

+  a Null-terminated Unicode format string and a VA_LIST argument list.

+

+  This function is similar as vsnprintf_s defined in C11.

+

+  Produces a Null-terminated Unicode string in the output buffer specified by StartOfBuffer

+  and BufferSize.

+  The Unicode string is produced by parsing the format string specified by FormatString.

+  Arguments are pulled from the variable argument list specified by Marker based on the

+  contents of the format string.

+  The number of Unicode characters in the produced output buffer is returned not including

+  the Null-terminator.

+

+  If StartOfBuffer is not aligned on a 16-bit boundary, then ASSERT().

+  If FormatString is not aligned on a 16-bit boundary, then ASSERT().

+

+  If BufferSize > 1 and StartOfBuffer is NULL, then ASSERT(). Also, the output buffer is

+  unmodified and 0 is returned.

+  If BufferSize > 1 and FormatString is NULL, then ASSERT(). Also, the output buffer is

+  unmodified and 0 is returned.

+  If PcdMaximumUnicodeStringLength is not zero, and BufferSize >

+  (PcdMaximumUnicodeStringLength * sizeof (CHAR16) + 1), then ASSERT(). Also, the output

+  buffer is unmodified and 0 is returned.

+  If PcdMaximumUnicodeStringLength is not zero, and FormatString contains more than

+  PcdMaximumUnicodeStringLength Unicode characters not including the Null-terminator, then

+  ASSERT(). Also, the output buffer is unmodified and 0 is returned.

+

+  If BufferSize is 0 or 1, then the output buffer is unmodified and 0 is returned.

+

+  @param  StartOfBuffer   A pointer to the output buffer for the produced Null-terminated

+                          Unicode string.

+  @param  BufferSize      The size, in bytes, of the output buffer specified by StartOfBuffer.

+  @param  FormatString    A Null-terminated Unicode format string.

+  @param  Marker          VA_LIST marker for the variable argument list.

+

+  @return The number of Unicode characters in the produced output buffer not including the

+          Null-terminator.

+

+**/

+UINTN

+EFIAPI

+UnicodeVSPrint (

+  OUT CHAR16        *StartOfBuffer,

+  IN  UINTN         BufferSize,

+  IN  CONST CHAR16  *FormatString,

+  IN  VA_LIST       Marker

+  )

+{

+  ASSERT_UNICODE_BUFFER (StartOfBuffer);

+  ASSERT_UNICODE_BUFFER (FormatString);

+  return BasePrintLibSPrintMarker ((CHAR8 *)StartOfBuffer, BufferSize >> 1, FORMAT_UNICODE | OUTPUT_UNICODE, (CHAR8 *)FormatString, Marker, NULL);

+}

+

+/**

+  Produces a Null-terminated Unicode string in an output buffer based on

+  a Null-terminated Unicode format string and a BASE_LIST argument list.

+

+  Produces a Null-terminated Unicode string in the output buffer specified by StartOfBuffer

+  and BufferSize.

+  The Unicode string is produced by parsing the format string specified by FormatString.

+  Arguments are pulled from the variable argument list specified by Marker based on the

+  contents of the format string.

+  The number of Unicode characters in the produced output buffer is returned not including

+  the Null-terminator.

+

+  If StartOfBuffer is not aligned on a 16-bit boundary, then ASSERT().

+  If FormatString is not aligned on a 16-bit boundary, then ASSERT().

+

+  If BufferSize > 1 and StartOfBuffer is NULL, then ASSERT(). Also, the output buffer is

+  unmodified and 0 is returned.

+  If BufferSize > 1 and FormatString is NULL, then ASSERT(). Also, the output buffer is

+  unmodified and 0 is returned.

+  If PcdMaximumUnicodeStringLength is not zero, and BufferSize >

+  (PcdMaximumUnicodeStringLength * sizeof (CHAR16) + 1), then ASSERT(). Also, the output

+  buffer is unmodified and 0 is returned.

+  If PcdMaximumUnicodeStringLength is not zero, and FormatString contains more than

+  PcdMaximumUnicodeStringLength Unicode characters not including the Null-terminator, then

+  ASSERT(). Also, the output buffer is unmodified and 0 is returned.

+

+  If BufferSize is 0 or 1, then the output buffer is unmodified and 0 is returned.

+

+  @param  StartOfBuffer   A pointer to the output buffer for the produced Null-terminated

+                          Unicode string.

+  @param  BufferSize      The size, in bytes, of the output buffer specified by StartOfBuffer.

+  @param  FormatString    A Null-terminated Unicode format string.

+  @param  Marker          BASE_LIST marker for the variable argument list.

+

+  @return The number of Unicode characters in the produced output buffer not including the

+          Null-terminator.

+

+**/

+UINTN

+EFIAPI

+UnicodeBSPrint (

+  OUT CHAR16        *StartOfBuffer,

+  IN  UINTN         BufferSize,

+  IN  CONST CHAR16  *FormatString,

+  IN  BASE_LIST     Marker

+  )

+{

+  ASSERT_UNICODE_BUFFER (StartOfBuffer);

+  ASSERT_UNICODE_BUFFER (FormatString);

+  return BasePrintLibSPrintMarker ((CHAR8 *)StartOfBuffer, BufferSize >> 1, FORMAT_UNICODE | OUTPUT_UNICODE, (CHAR8 *)FormatString, gNullVaList, Marker);

+}

+

+/**

+  Produces a Null-terminated Unicode string in an output buffer based on a Null-terminated

+  Unicode format string and variable argument list.

+

+  This function is similar as snprintf_s defined in C11.

+

+  Produces a Null-terminated Unicode string in the output buffer specified by StartOfBuffer

+  and BufferSize.

+  The Unicode string is produced by parsing the format string specified by FormatString.

+  Arguments are pulled from the variable argument list based on the contents of the format string.

+  The number of Unicode characters in the produced output buffer is returned not including

+  the Null-terminator.

+

+  If StartOfBuffer is not aligned on a 16-bit boundary, then ASSERT().

+  If FormatString is not aligned on a 16-bit boundary, then ASSERT().

+

+  If BufferSize > 1 and StartOfBuffer is NULL, then ASSERT(). Also, the output buffer is

+  unmodified and 0 is returned.

+  If BufferSize > 1 and FormatString is NULL, then ASSERT(). Also, the output buffer is

+  unmodified and 0 is returned.

+  If PcdMaximumUnicodeStringLength is not zero, and BufferSize >

+  (PcdMaximumUnicodeStringLength * sizeof (CHAR16) + 1), then ASSERT(). Also, the output

+  buffer is unmodified and 0 is returned.

+  If PcdMaximumUnicodeStringLength is not zero, and FormatString contains more than

+  PcdMaximumUnicodeStringLength Unicode characters not including the Null-terminator, then

+  ASSERT(). Also, the output buffer is unmodified and 0 is returned.

+

+  If BufferSize is 0 or 1, then the output buffer is unmodified and 0 is returned.

+

+  @param  StartOfBuffer   A pointer to the output buffer for the produced Null-terminated

+                          Unicode string.

+  @param  BufferSize      The size, in bytes, of the output buffer specified by StartOfBuffer.

+  @param  FormatString    A Null-terminated Unicode format string.

+  @param  ...             Variable argument list whose contents are accessed based on the

+                          format string specified by FormatString.

+

+  @return The number of Unicode characters in the produced output buffer not including the

+          Null-terminator.

+

+**/

+UINTN

+EFIAPI

+UnicodeSPrint (

+  OUT CHAR16        *StartOfBuffer,

+  IN  UINTN         BufferSize,

+  IN  CONST CHAR16  *FormatString,

+  ...

+  )

+{

+  VA_LIST Marker;

+  UINTN   NumberOfPrinted;

+

+  VA_START (Marker, FormatString);

+  NumberOfPrinted = UnicodeVSPrint (StartOfBuffer, BufferSize, FormatString, Marker);

+  VA_END (Marker);

+  return NumberOfPrinted;

+}

+

+/**

+  Produces a Null-terminated Unicode string in an output buffer based on a Null-terminated

+  ASCII format string and a VA_LIST argument list.

+

+  This function is similar as vsnprintf_s defined in C11.

+

+  Produces a Null-terminated Unicode string in the output buffer specified by StartOfBuffer

+  and BufferSize.

+  The Unicode string is produced by parsing the format string specified by FormatString.

+  Arguments are pulled from the variable argument list specified by Marker based on the

+  contents of the format string.

+  The number of Unicode characters in the produced output buffer is returned not including

+  the Null-terminator.

+

+  If StartOfBuffer is not aligned on a 16-bit boundary, then ASSERT().

+

+  If BufferSize > 1 and StartOfBuffer is NULL, then ASSERT(). Also, the output buffer is

+  unmodified and 0 is returned.

+  If BufferSize > 1 and FormatString is NULL, then ASSERT(). Also, the output buffer is

+  unmodified and 0 is returned.

+  If PcdMaximumUnicodeStringLength is not zero, and BufferSize >

+  (PcdMaximumUnicodeStringLength * sizeof (CHAR16) + 1), then ASSERT(). Also, the output

+  buffer is unmodified and 0 is returned.

+  If PcdMaximumAsciiStringLength is not zero, and FormatString contains more than

+  PcdMaximumAsciiStringLength Ascii characters not including the Null-terminator, then

+  ASSERT(). Also, the output buffer is unmodified and 0 is returned.

+

+  If BufferSize is 0 or 1, then no output buffer is produced and 0 is returned.

+

+  @param  StartOfBuffer   A pointer to the output buffer for the produced Null-terminated

+                          Unicode string.

+  @param  BufferSize      The size, in bytes, of the output buffer specified by StartOfBuffer.

+  @param  FormatString    A Null-terminated ASCII format string.

+  @param  Marker          VA_LIST marker for the variable argument list.

+

+  @return The number of Unicode characters in the produced output buffer not including the

+          Null-terminator.

+

+**/

+UINTN

+EFIAPI

+UnicodeVSPrintAsciiFormat (

+  OUT CHAR16       *StartOfBuffer,

+  IN  UINTN        BufferSize,

+  IN  CONST CHAR8  *FormatString,

+  IN  VA_LIST      Marker

+  )

+{

+  ASSERT_UNICODE_BUFFER (StartOfBuffer);

+  return BasePrintLibSPrintMarker ((CHAR8 *)StartOfBuffer, BufferSize >> 1, OUTPUT_UNICODE, FormatString, Marker, NULL);

+}

+

+/**

+  Produces a Null-terminated Unicode string in an output buffer based on a Null-terminated

+  ASCII format string and a BASE_LIST argument list.

+

+  Produces a Null-terminated Unicode string in the output buffer specified by StartOfBuffer

+  and BufferSize.

+  The Unicode string is produced by parsing the format string specified by FormatString.

+  Arguments are pulled from the variable argument list specified by Marker based on the

+  contents of the format string.

+  The number of Unicode characters in the produced output buffer is returned not including

+  the Null-terminator.

+

+  If StartOfBuffer is not aligned on a 16-bit boundary, then ASSERT().

+

+  If BufferSize > 1 and StartOfBuffer is NULL, then ASSERT(). Also, the output buffer is

+  unmodified and 0 is returned.

+  If BufferSize > 1 and FormatString is NULL, then ASSERT(). Also, the output buffer is

+  unmodified and 0 is returned.

+  If PcdMaximumUnicodeStringLength is not zero, and BufferSize >

+  (PcdMaximumUnicodeStringLength * sizeof (CHAR16) + 1), then ASSERT(). Also, the output

+  buffer is unmodified and 0 is returned.

+  If PcdMaximumAsciiStringLength is not zero, and FormatString contains more than

+  PcdMaximumAsciiStringLength Ascii characters not including the Null-terminator, then

+  ASSERT(). Also, the output buffer is unmodified and 0 is returned.

+

+  If BufferSize is 0 or 1, then no output buffer is produced and 0 is returned.

+

+  @param  StartOfBuffer   A pointer to the output buffer for the produced Null-terminated

+                          Unicode string.

+  @param  BufferSize      The size, in bytes, of the output buffer specified by StartOfBuffer.

+  @param  FormatString    A Null-terminated ASCII format string.

+  @param  Marker          BASE_LIST marker for the variable argument list.

+

+  @return The number of Unicode characters in the produced output buffer not including the

+          Null-terminator.

+

+**/

+UINTN

+EFIAPI

+UnicodeBSPrintAsciiFormat (

+  OUT CHAR16       *StartOfBuffer,

+  IN  UINTN        BufferSize,

+  IN  CONST CHAR8  *FormatString,

+  IN  BASE_LIST    Marker

+  )

+{

+  ASSERT_UNICODE_BUFFER (StartOfBuffer);

+  return BasePrintLibSPrintMarker ((CHAR8 *)StartOfBuffer, BufferSize >> 1, OUTPUT_UNICODE, FormatString, gNullVaList, Marker);

+}

+

+/**

+  Produces a Null-terminated Unicode string in an output buffer based on a Null-terminated

+  ASCII format string and  variable argument list.

+

+  This function is similar as snprintf_s defined in C11.

+

+  Produces a Null-terminated Unicode string in the output buffer specified by StartOfBuffer

+  and BufferSize.

+  The Unicode string is produced by parsing the format string specified by FormatString.

+  Arguments are pulled from the variable argument list based on the contents of the

+  format string.

+  The number of Unicode characters in the produced output buffer is returned not including

+  the Null-terminator.

+

+  If StartOfBuffer is not aligned on a 16-bit boundary, then ASSERT().

+

+  If BufferSize > 1 and StartOfBuffer is NULL, then ASSERT(). Also, the output buffer is

+  unmodified and 0 is returned.

+  If BufferSize > 1 and FormatString is NULL, then ASSERT(). Also, the output buffer is

+  unmodified and 0 is returned.

+  If PcdMaximumUnicodeStringLength is not zero, and BufferSize >

+  (PcdMaximumUnicodeStringLength * sizeof (CHAR16) + 1), then ASSERT(). Also, the output

+  buffer is unmodified and 0 is returned.

+  If PcdMaximumAsciiStringLength is not zero, and FormatString contains more than

+  PcdMaximumAsciiStringLength Ascii characters not including the Null-terminator, then

+  ASSERT(). Also, the output buffer is unmodified and 0 is returned.

+

+  If BufferSize is 0 or 1, then no output buffer is produced and 0 is returned.

+

+  @param  StartOfBuffer   A pointer to the output buffer for the produced Null-terminated

+                          Unicode string.

+  @param  BufferSize      The size, in bytes, of the output buffer specified by StartOfBuffer.

+  @param  FormatString    A Null-terminated ASCII format string.

+  @param  ...             Variable argument list whose contents are accessed based on the

+                          format string specified by FormatString.

+

+  @return The number of Unicode characters in the produced output buffer not including the

+          Null-terminator.

+

+**/

+UINTN

+EFIAPI

+UnicodeSPrintAsciiFormat (

+  OUT CHAR16       *StartOfBuffer,

+  IN  UINTN        BufferSize,

+  IN  CONST CHAR8  *FormatString,

+  ...

+  )

+{

+  VA_LIST Marker;

+  UINTN   NumberOfPrinted;

+

+  VA_START (Marker, FormatString);

+  NumberOfPrinted = UnicodeVSPrintAsciiFormat (StartOfBuffer, BufferSize, FormatString, Marker);

+  VA_END (Marker);

+  return NumberOfPrinted;

+}

+

+

+/**

+  Converts a decimal value to a Null-terminated Unicode string.

+

+  Converts the decimal number specified by Value to a Null-terminated Unicode

+  string specified by Buffer containing at most Width characters. No padding of

+  spaces is ever performed. If Width is 0 then a width of

+  MAXIMUM_VALUE_CHARACTERS is assumed. If the conversion contains more than

+  Width characters, then only the first Width characters are placed in Buffer.

+  Additional conversion parameters are specified in Flags.

+

+  The Flags bit LEFT_JUSTIFY is always ignored.

+  All conversions are left justified in Buffer.

+  If Width is 0, PREFIX_ZERO is ignored in Flags.

+  If COMMA_TYPE is set in Flags, then PREFIX_ZERO is ignored in Flags, and

+  commas are inserted every 3rd digit starting from the right.

+  If RADIX_HEX is set in Flags, then the output buffer will be formatted in

+  hexadecimal format.

+  If Value is < 0 and RADIX_HEX is not set in Flags, then the fist character in

+  Buffer is a '-'.

+  If PREFIX_ZERO is set in Flags and PREFIX_ZERO is not being ignored, then

+  Buffer is padded with '0' characters so the combination of the optional '-'

+  sign character, '0' characters, digit characters for Value, and the

+  Null-terminator add up to Width characters.

+

+  If Buffer is not aligned on a 16-bit boundary, then ASSERT().

+  If an error would be returned, then the function will also ASSERT().

+

+  @param  Buffer      The pointer to the output buffer for the produced

+                      Null-terminated Unicode string.

+  @param  BufferSize  The size of Buffer in bytes, including the

+                      Null-terminator.

+  @param  Flags       The bitmask of flags that specify left justification,

+                      zero pad, and commas.

+  @param  Value       The 64-bit signed value to convert to a string.

+  @param  Width       The maximum number of Unicode characters to place in

+                      Buffer, not including the Null-terminator.

+

+  @retval RETURN_SUCCESS           The decimal value is converted.

+  @retval RETURN_BUFFER_TOO_SMALL  If BufferSize cannot hold the converted

+                                   value.

+  @retval RETURN_INVALID_PARAMETER If Buffer is NULL.

+                                   If PcdMaximumUnicodeStringLength is not

+                                   zero, and BufferSize is greater than

+                                   (PcdMaximumUnicodeStringLength *

+                                   sizeof (CHAR16) + 1).

+                                   If unsupported bits are set in Flags.

+                                   If both COMMA_TYPE and RADIX_HEX are set in

+                                   Flags.

+                                   If Width >= MAXIMUM_VALUE_CHARACTERS.

+

+**/

+RETURN_STATUS

+EFIAPI

+UnicodeValueToStringS (

+  IN OUT CHAR16  *Buffer,

+  IN UINTN       BufferSize,

+  IN UINTN       Flags,

+  IN INT64       Value,

+  IN UINTN       Width

+  )

+{

+  ASSERT_UNICODE_BUFFER(Buffer);

+  return BasePrintLibConvertValueToStringS ((CHAR8 *)Buffer, BufferSize, Flags, Value, Width, 2);

+}

+

+/**

+  Produces a Null-terminated ASCII string in an output buffer based on a Null-terminated

+  ASCII format string and a VA_LIST argument list.

+

+  This function is similar as vsnprintf_s defined in C11.

+

+  Produces a Null-terminated ASCII string in the output buffer specified by StartOfBuffer

+  and BufferSize.

+  The ASCII string is produced by parsing the format string specified by FormatString.

+  Arguments are pulled from the variable argument list specified by Marker based on

+  the contents of the format string.

+  The number of ASCII characters in the produced output buffer is returned not including

+  the Null-terminator.

+

+  If BufferSize > 0 and StartOfBuffer is NULL, then ASSERT(). Also, the output buffer is

+  unmodified and 0 is returned.

+  If BufferSize > 0 and FormatString is NULL, then ASSERT(). Also, the output buffer is

+  unmodified and 0 is returned.

+  If PcdMaximumAsciiStringLength is not zero, and BufferSize >

+  (PcdMaximumAsciiStringLength * sizeof (CHAR8)), then ASSERT(). Also, the output buffer

+  is unmodified and 0 is returned.

+  If PcdMaximumAsciiStringLength is not zero, and FormatString contains more than

+  PcdMaximumAsciiStringLength Ascii characters not including the Null-terminator, then

+  ASSERT(). Also, the output buffer is unmodified and 0 is returned.

+

+  If BufferSize is 0, then no output buffer is produced and 0 is returned.

+

+  @param  StartOfBuffer   A pointer to the output buffer for the produced Null-terminated

+                          ASCII string.

+  @param  BufferSize      The size, in bytes, of the output buffer specified by StartOfBuffer.

+  @param  FormatString    A Null-terminated ASCII format string.

+  @param  Marker          VA_LIST marker for the variable argument list.

+

+  @return The number of ASCII characters in the produced output buffer not including the

+          Null-terminator.

+

+**/

+UINTN

+EFIAPI

+AsciiVSPrint (

+  OUT CHAR8         *StartOfBuffer,

+  IN  UINTN         BufferSize,

+  IN  CONST CHAR8   *FormatString,

+  IN  VA_LIST       Marker

+  )

+{

+  return BasePrintLibSPrintMarker (StartOfBuffer, BufferSize, 0, FormatString, Marker, NULL);

+}

+

+/**

+  Produces a Null-terminated ASCII string in an output buffer based on a Null-terminated

+  ASCII format string and a BASE_LIST argument list.

+

+  Produces a Null-terminated ASCII string in the output buffer specified by StartOfBuffer

+  and BufferSize.

+  The ASCII string is produced by parsing the format string specified by FormatString.

+  Arguments are pulled from the variable argument list specified by Marker based on

+  the contents of the format string.

+  The number of ASCII characters in the produced output buffer is returned not including

+  the Null-terminator.

+

+  If BufferSize > 0 and StartOfBuffer is NULL, then ASSERT(). Also, the output buffer is

+  unmodified and 0 is returned.

+  If BufferSize > 0 and FormatString is NULL, then ASSERT(). Also, the output buffer is

+  unmodified and 0 is returned.

+  If PcdMaximumAsciiStringLength is not zero, and BufferSize >

+  (PcdMaximumAsciiStringLength * sizeof (CHAR8)), then ASSERT(). Also, the output buffer

+  is unmodified and 0 is returned.

+  If PcdMaximumAsciiStringLength is not zero, and FormatString contains more than

+  PcdMaximumAsciiStringLength Ascii characters not including the Null-terminator, then

+  ASSERT(). Also, the output buffer is unmodified and 0 is returned.

+

+  If BufferSize is 0, then no output buffer is produced and 0 is returned.

+

+  @param  StartOfBuffer   A pointer to the output buffer for the produced Null-terminated

+                          ASCII string.

+  @param  BufferSize      The size, in bytes, of the output buffer specified by StartOfBuffer.

+  @param  FormatString    A Null-terminated ASCII format string.

+  @param  Marker          BASE_LIST marker for the variable argument list.

+

+  @return The number of ASCII characters in the produced output buffer not including the

+          Null-terminator.

+

+**/

+UINTN

+EFIAPI

+AsciiBSPrint (

+  OUT CHAR8         *StartOfBuffer,

+  IN  UINTN         BufferSize,

+  IN  CONST CHAR8   *FormatString,

+  IN  BASE_LIST     Marker

+  )

+{

+  return BasePrintLibSPrintMarker (StartOfBuffer, BufferSize, 0, FormatString, gNullVaList, Marker);

+}

+

+/**

+  Produces a Null-terminated ASCII string in an output buffer based on a Null-terminated

+  ASCII format string and  variable argument list.

+

+  This function is similar as snprintf_s defined in C11.

+

+  Produces a Null-terminated ASCII string in the output buffer specified by StartOfBuffer

+  and BufferSize.

+  The ASCII string is produced by parsing the format string specified by FormatString.

+  Arguments are pulled from the variable argument list based on the contents of the

+  format string.

+  The number of ASCII characters in the produced output buffer is returned not including

+  the Null-terminator.

+

+  If BufferSize > 0 and StartOfBuffer is NULL, then ASSERT(). Also, the output buffer is

+  unmodified and 0 is returned.

+  If BufferSize > 0 and FormatString is NULL, then ASSERT(). Also, the output buffer is

+  unmodified and 0 is returned.

+  If PcdMaximumAsciiStringLength is not zero, and BufferSize >

+  (PcdMaximumAsciiStringLength * sizeof (CHAR8)), then ASSERT(). Also, the output buffer

+  is unmodified and 0 is returned.

+  If PcdMaximumAsciiStringLength is not zero, and FormatString contains more than

+  PcdMaximumAsciiStringLength Ascii characters not including the Null-terminator, then

+  ASSERT(). Also, the output buffer is unmodified and 0 is returned.

+

+  If BufferSize is 0, then no output buffer is produced and 0 is returned.

+

+  @param  StartOfBuffer   A pointer to the output buffer for the produced Null-terminated

+                          ASCII string.

+  @param  BufferSize      The size, in bytes, of the output buffer specified by StartOfBuffer.

+  @param  FormatString    A Null-terminated ASCII format string.

+  @param  ...             Variable argument list whose contents are accessed based on the

+                          format string specified by FormatString.

+

+  @return The number of ASCII characters in the produced output buffer not including the

+          Null-terminator.

+

+**/

+UINTN

+EFIAPI

+AsciiSPrint (

+  OUT CHAR8        *StartOfBuffer,

+  IN  UINTN        BufferSize,

+  IN  CONST CHAR8  *FormatString,

+  ...

+  )

+{

+  VA_LIST Marker;

+  UINTN   NumberOfPrinted;

+

+  VA_START (Marker, FormatString);

+  NumberOfPrinted = AsciiVSPrint (StartOfBuffer, BufferSize, FormatString, Marker);

+  VA_END (Marker);

+  return NumberOfPrinted;

+}

+

+/**

+  Produces a Null-terminated ASCII string in an output buffer based on a Null-terminated

+  Unicode format string and a VA_LIST argument list.

+

+  This function is similar as vsnprintf_s defined in C11.

+

+  Produces a Null-terminated ASCII string in the output buffer specified by StartOfBuffer

+  and BufferSize.

+  The ASCII string is produced by parsing the format string specified by FormatString.

+  Arguments are pulled from the variable argument list specified by Marker based on

+  the contents of the format string.

+  The number of ASCII characters in the produced output buffer is returned not including

+  the Null-terminator.

+

+  If FormatString is not aligned on a 16-bit boundary, then ASSERT().

+

+  If BufferSize > 0 and StartOfBuffer is NULL, then ASSERT(). Also, the output buffer is

+  unmodified and 0 is returned.

+  If BufferSize > 0 and FormatString is NULL, then ASSERT(). Also, the output buffer is

+  unmodified and 0 is returned.

+  If PcdMaximumAsciiStringLength is not zero, and BufferSize >

+  (PcdMaximumAsciiStringLength * sizeof (CHAR8)), then ASSERT(). Also, the output buffer

+  is unmodified and 0 is returned.

+  If PcdMaximumUnicodeStringLength is not zero, and FormatString contains more than

+  PcdMaximumUnicodeStringLength Unicode characters not including the Null-terminator, then

+  ASSERT(). Also, the output buffer is unmodified and 0 is returned.

+

+  If BufferSize is 0, then no output buffer is produced and 0 is returned.

+

+  @param  StartOfBuffer   A pointer to the output buffer for the produced Null-terminated

+                          ASCII string.

+  @param  BufferSize      The size, in bytes, of the output buffer specified by StartOfBuffer.

+  @param  FormatString    A Null-terminated Unicode format string.

+  @param  Marker          VA_LIST marker for the variable argument list.

+

+  @return The number of ASCII characters in the produced output buffer not including the

+          Null-terminator.

+

+**/

+UINTN

+EFIAPI

+AsciiVSPrintUnicodeFormat (

+  OUT CHAR8         *StartOfBuffer,

+  IN  UINTN         BufferSize,

+  IN  CONST CHAR16  *FormatString,

+  IN  VA_LIST       Marker

+  )

+{

+  ASSERT_UNICODE_BUFFER (FormatString);

+  return BasePrintLibSPrintMarker (StartOfBuffer, BufferSize, FORMAT_UNICODE, (CHAR8 *)FormatString, Marker, NULL);

+}

+

+/**

+  Produces a Null-terminated ASCII string in an output buffer based on a Null-terminated

+  Unicode format string and a BASE_LIST argument list.

+

+  Produces a Null-terminated ASCII string in the output buffer specified by StartOfBuffer

+  and BufferSize.

+  The ASCII string is produced by parsing the format string specified by FormatString.

+  Arguments are pulled from the variable argument list specified by Marker based on

+  the contents of the format string.

+  The number of ASCII characters in the produced output buffer is returned not including

+  the Null-terminator.

+

+  If FormatString is not aligned on a 16-bit boundary, then ASSERT().

+

+  If BufferSize > 0 and StartOfBuffer is NULL, then ASSERT(). Also, the output buffer is

+  unmodified and 0 is returned.

+  If BufferSize > 0 and FormatString is NULL, then ASSERT(). Also, the output buffer is

+  unmodified and 0 is returned.

+  If PcdMaximumAsciiStringLength is not zero, and BufferSize >

+  (PcdMaximumAsciiStringLength * sizeof (CHAR8)), then ASSERT(). Also, the output buffer

+  is unmodified and 0 is returned.

+  If PcdMaximumUnicodeStringLength is not zero, and FormatString contains more than

+  PcdMaximumUnicodeStringLength Unicode characters not including the Null-terminator, then

+  ASSERT(). Also, the output buffer is unmodified and 0 is returned.

+

+  If BufferSize is 0, then no output buffer is produced and 0 is returned.

+

+  @param  StartOfBuffer   A pointer to the output buffer for the produced Null-terminated

+                          ASCII string.

+  @param  BufferSize      The size, in bytes, of the output buffer specified by StartOfBuffer.

+  @param  FormatString    A Null-terminated Unicode format string.

+  @param  Marker          BASE_LIST marker for the variable argument list.

+

+  @return The number of ASCII characters in the produced output buffer not including the

+          Null-terminator.

+

+**/

+UINTN

+EFIAPI

+AsciiBSPrintUnicodeFormat (

+  OUT CHAR8         *StartOfBuffer,

+  IN  UINTN         BufferSize,

+  IN  CONST CHAR16  *FormatString,

+  IN  BASE_LIST     Marker

+  )

+{

+  ASSERT_UNICODE_BUFFER (FormatString);

+  return BasePrintLibSPrintMarker (StartOfBuffer, BufferSize, FORMAT_UNICODE, (CHAR8 *)FormatString, gNullVaList, Marker);

+}

+

+/**

+  Produces a Null-terminated ASCII string in an output buffer based on a Null-terminated

+  Unicode format string and  variable argument list.

+

+  This function is similar as snprintf_s defined in C11.

+

+  Produces a Null-terminated ASCII string in the output buffer specified by StartOfBuffer

+  and BufferSize.

+  The ASCII string is produced by parsing the format string specified by FormatString.

+  Arguments are pulled from the variable argument list based on the contents of the

+  format string.

+  The number of ASCII characters in the produced output buffer is returned not including

+  the Null-terminator.

+

+  If FormatString is not aligned on a 16-bit boundary, then ASSERT().

+

+  If BufferSize > 0 and StartOfBuffer is NULL, then ASSERT(). Also, the output buffer is

+  unmodified and 0 is returned.

+  If BufferSize > 0 and FormatString is NULL, then ASSERT(). Also, the output buffer is

+  unmodified and 0 is returned.

+  If PcdMaximumAsciiStringLength is not zero, and BufferSize >

+  (PcdMaximumAsciiStringLength * sizeof (CHAR8)), then ASSERT(). Also, the output buffer

+  is unmodified and 0 is returned.

+  If PcdMaximumUnicodeStringLength is not zero, and FormatString contains more than

+  PcdMaximumUnicodeStringLength Unicode characters not including the Null-terminator, then

+  ASSERT(). Also, the output buffer is unmodified and 0 is returned.

+

+  If BufferSize is 0, then no output buffer is produced and 0 is returned.

+

+  @param  StartOfBuffer   A pointer to the output buffer for the produced Null-terminated

+                          ASCII string.

+  @param  BufferSize      The size, in bytes, of the output buffer specified by StartOfBuffer.

+  @param  FormatString    A Null-terminated Unicode format string.

+  @param  ...             Variable argument list whose contents are accessed based on the

+                          format string specified by FormatString.

+

+  @return The number of ASCII characters in the produced output buffer not including the

+          Null-terminator.

+

+**/

+UINTN

+EFIAPI

+AsciiSPrintUnicodeFormat (

+  OUT CHAR8         *StartOfBuffer,

+  IN  UINTN         BufferSize,

+  IN  CONST CHAR16  *FormatString,

+  ...

+  )

+{

+  VA_LIST Marker;

+  UINTN   NumberOfPrinted;

+

+  VA_START (Marker, FormatString);

+  NumberOfPrinted = AsciiVSPrintUnicodeFormat (StartOfBuffer, BufferSize, FormatString, Marker);

+  VA_END (Marker);

+  return NumberOfPrinted;

+}

+

+/**

+  Converts a decimal value to a Null-terminated Ascii string.

+

+  Converts the decimal number specified by Value to a Null-terminated Ascii

+  string specified by Buffer containing at most Width characters. No padding of

+  spaces is ever performed. If Width is 0 then a width of

+  MAXIMUM_VALUE_CHARACTERS is assumed. If the conversion contains more than

+  Width characters, then only the first Width characters are placed in Buffer.

+  Additional conversion parameters are specified in Flags.

+

+  The Flags bit LEFT_JUSTIFY is always ignored.

+  All conversions are left justified in Buffer.

+  If Width is 0, PREFIX_ZERO is ignored in Flags.

+  If COMMA_TYPE is set in Flags, then PREFIX_ZERO is ignored in Flags, and

+  commas are inserted every 3rd digit starting from the right.

+  If RADIX_HEX is set in Flags, then the output buffer will be formatted in

+  hexadecimal format.

+  If Value is < 0 and RADIX_HEX is not set in Flags, then the fist character in

+  Buffer is a '-'.

+  If PREFIX_ZERO is set in Flags and PREFIX_ZERO is not being ignored, then

+  Buffer is padded with '0' characters so the combination of the optional '-'

+  sign character, '0' characters, digit characters for Value, and the

+  Null-terminator add up to Width characters.

+

+  If an error would be returned, then the function will ASSERT().

+

+  @param  Buffer      The pointer to the output buffer for the produced

+                      Null-terminated Ascii string.

+  @param  BufferSize  The size of Buffer in bytes, including the

+                      Null-terminator.

+  @param  Flags       The bitmask of flags that specify left justification,

+                      zero pad, and commas.

+  @param  Value       The 64-bit signed value to convert to a string.

+  @param  Width       The maximum number of Ascii characters to place in

+                      Buffer, not including the Null-terminator.

+

+  @retval RETURN_SUCCESS           The decimal value is converted.

+  @retval RETURN_BUFFER_TOO_SMALL  If BufferSize cannot hold the converted

+                                   value.

+  @retval RETURN_INVALID_PARAMETER If Buffer is NULL.

+                                   If PcdMaximumAsciiStringLength is not

+                                   zero, and BufferSize is greater than

+                                   PcdMaximumAsciiStringLength.

+                                   If unsupported bits are set in Flags.

+                                   If both COMMA_TYPE and RADIX_HEX are set in

+                                   Flags.

+                                   If Width >= MAXIMUM_VALUE_CHARACTERS.

+

+**/

+RETURN_STATUS

+EFIAPI

+AsciiValueToStringS (

+  IN OUT CHAR8   *Buffer,

+  IN UINTN       BufferSize,

+  IN UINTN       Flags,

+  IN INT64       Value,

+  IN UINTN       Width

+  )

+{

+  return BasePrintLibConvertValueToStringS (Buffer, BufferSize, Flags, Value, Width, 1);

+}

+

+/**

+  Returns the number of characters that would be produced by if the formatted

+  output were produced not including the Null-terminator.

+

+  If FormatString is not aligned on a 16-bit boundary, then ASSERT().

+

+  If FormatString is NULL, then ASSERT() and 0 is returned.

+  If PcdMaximumUnicodeStringLength is not zero, and FormatString contains more

+  than PcdMaximumUnicodeStringLength Unicode characters not including the

+  Null-terminator, then ASSERT() and 0 is returned.

+

+  @param[in]  FormatString    A Null-terminated Unicode format string.

+  @param[in]  Marker          VA_LIST marker for the variable argument list.

+

+  @return The number of characters that would be produced, not including the

+          Null-terminator.

+**/

+UINTN

+EFIAPI

+SPrintLength (

+  IN  CONST CHAR16   *FormatString,

+  IN  VA_LIST       Marker

+  )

+{

+  ASSERT_UNICODE_BUFFER (FormatString);

+  return BasePrintLibSPrintMarker (NULL, 0, FORMAT_UNICODE | OUTPUT_UNICODE | COUNT_ONLY_NO_PRINT, (CHAR8 *)FormatString, Marker, NULL);

+}

+

+/**

+  Returns the number of characters that would be produced by if the formatted

+  output were produced not including the Null-terminator.

+

+  If FormatString is NULL, then ASSERT() and 0 is returned.

+  If PcdMaximumAsciiStringLength is not zero, and FormatString contains more

+  than PcdMaximumAsciiStringLength Ascii characters not including the

+  Null-terminator, then ASSERT() and 0 is returned.

+

+  @param[in]  FormatString    A Null-terminated ASCII format string.

+  @param[in]  Marker          VA_LIST marker for the variable argument list.

+

+  @return The number of characters that would be produced, not including the

+          Null-terminator.

+**/

+UINTN

+EFIAPI

+SPrintLengthAsciiFormat (

+  IN  CONST CHAR8   *FormatString,

+  IN  VA_LIST       Marker

+  )

+{

+  return BasePrintLibSPrintMarker (NULL, 0, OUTPUT_UNICODE | COUNT_ONLY_NO_PRINT, (CHAR8 *)FormatString, Marker, NULL);

+}

diff --git a/debugging_demo/memtest86+/efi/Include/src/BasePrintLib/PrintLibInternal.c b/debugging_demo/memtest86+/efi/Include/src/BasePrintLib/PrintLibInternal.c
new file mode 100644
index 0000000..cdcd42d
--- /dev/null
+++ b/debugging_demo/memtest86+/efi/Include/src/BasePrintLib/PrintLibInternal.c
@@ -0,0 +1,1274 @@
+/** @file

+  Print Library internal worker functions.

+

+  Copyright (c) 2006 - 2018, Intel Corporation. All rights reserved.<BR>

+  SPDX-License-Identifier: BSD-2-Clause-Patent

+

+**/

+

+#include "PrintLibInternal.h"

+#include "Library/BaseLib.h"

+#include "Efi_Defs.h"

+

+#define WARNING_STATUS_NUMBER         5

+#define ERROR_STATUS_NUMBER           33

+

+//

+// Safe print checks

+//

+#define RSIZE_MAX             (PcdGet32 (PcdMaximumUnicodeStringLength))

+#define ASCII_RSIZE_MAX       (PcdGet32 (PcdMaximumAsciiStringLength))

+

+#define SAFE_PRINT_CONSTRAINT_CHECK(Expression, RetVal)  \

+  do { \

+    ASSERT (Expression); \

+    if (!(Expression)) { \

+      return RetVal; \

+    } \

+  } while (FALSE)

+

+GLOBAL_REMOVE_IF_UNREFERENCED CONST CHAR8 mHexStr[] = {'0','1','2','3','4','5','6','7','8','9','A','B','C','D','E','F'};

+

+//

+// Longest string: RETURN_WARN_BUFFER_TOO_SMALL => 24 characters plus NUL byte

+//

+GLOBAL_REMOVE_IF_UNREFERENCED CONST CHAR8 mWarningString[][24+1] = {

+  "Success",                      //  RETURN_SUCCESS                = 0

+  "Warning Unknown Glyph",        //  RETURN_WARN_UNKNOWN_GLYPH     = 1

+  "Warning Delete Failure",       //  RETURN_WARN_DELETE_FAILURE    = 2

+  "Warning Write Failure",        //  RETURN_WARN_WRITE_FAILURE     = 3

+  "Warning Buffer Too Small",     //  RETURN_WARN_BUFFER_TOO_SMALL  = 4

+  "Warning Stale Data",           //  RETURN_WARN_STALE_DATA        = 5

+};

+

+//

+// Longest string: RETURN_INCOMPATIBLE_VERSION => 20 characters plus NUL byte

+//

+GLOBAL_REMOVE_IF_UNREFERENCED CONST CHAR8 mErrorString[][20+1] = {

+  "Load Error",                   //  RETURN_LOAD_ERROR             = 1  | MAX_BIT

+  "Invalid Parameter",            //  RETURN_INVALID_PARAMETER      = 2  | MAX_BIT

+  "Unsupported",                  //  RETURN_UNSUPPORTED            = 3  | MAX_BIT

+  "Bad Buffer Size",              //  RETURN_BAD_BUFFER_SIZE        = 4  | MAX_BIT

+  "Buffer Too Small",             //  RETURN_BUFFER_TOO_SMALL,      = 5  | MAX_BIT

+  "Not Ready",                    //  RETURN_NOT_READY              = 6  | MAX_BIT

+  "Device Error",                 //  RETURN_DEVICE_ERROR           = 7  | MAX_BIT

+  "Write Protected",              //  RETURN_WRITE_PROTECTED        = 8  | MAX_BIT

+  "Out of Resources",             //  RETURN_OUT_OF_RESOURCES       = 9  | MAX_BIT

+  "Volume Corrupt",               //  RETURN_VOLUME_CORRUPTED       = 10 | MAX_BIT

+  "Volume Full",                  //  RETURN_VOLUME_FULL            = 11 | MAX_BIT

+  "No Media",                     //  RETURN_NO_MEDIA               = 12 | MAX_BIT

+  "Media changed",                //  RETURN_MEDIA_CHANGED          = 13 | MAX_BIT

+  "Not Found",                    //  RETURN_NOT_FOUND              = 14 | MAX_BIT

+  "Access Denied",                //  RETURN_ACCESS_DENIED          = 15 | MAX_BIT

+  "No Response",                  //  RETURN_NO_RESPONSE            = 16 | MAX_BIT

+  "No mapping",                   //  RETURN_NO_MAPPING             = 17 | MAX_BIT

+  "Time out",                     //  RETURN_TIMEOUT                = 18 | MAX_BIT

+  "Not started",                  //  RETURN_NOT_STARTED            = 19 | MAX_BIT

+  "Already started",              //  RETURN_ALREADY_STARTED        = 20 | MAX_BIT

+  "Aborted",                      //  RETURN_ABORTED                = 21 | MAX_BIT

+  "ICMP Error",                   //  RETURN_ICMP_ERROR             = 22 | MAX_BIT

+  "TFTP Error",                   //  RETURN_TFTP_ERROR             = 23 | MAX_BIT

+  "Protocol Error",               //  RETURN_PROTOCOL_ERROR         = 24 | MAX_BIT

+  "Incompatible Version",         //  RETURN_INCOMPATIBLE_VERSION   = 25 | MAX_BIT

+  "Security Violation",           //  RETURN_SECURITY_VIOLATION     = 26 | MAX_BIT

+  "CRC Error",                    //  RETURN_CRC_ERROR              = 27 | MAX_BIT

+  "End of Media",                 //  RETURN_END_OF_MEDIA           = 28 | MAX_BIT

+  "Reserved (29)",                //  RESERVED                      = 29 | MAX_BIT

+  "Reserved (30)",                //  RESERVED                      = 30 | MAX_BIT

+  "End of File",                  //  RETURN_END_OF_FILE            = 31 | MAX_BIT

+  "Invalid Language",             //  RETURN_INVALID_LANGUAGE       = 32 | MAX_BIT

+  "Compromised Data"              //  RETURN_COMPROMISED_DATA       = 33 | MAX_BIT

+};

+

+

+/**

+  Internal function that places the character into the Buffer.

+

+  Internal function that places ASCII or Unicode character into the Buffer.

+

+  @param  Buffer      The buffer to place the Unicode or ASCII string.

+  @param  EndBuffer   The end of the input Buffer. No characters will be

+                      placed after that.

+  @param  Length      The count of character to be placed into Buffer.

+                      (Negative value indicates no buffer fill.)

+  @param  Character   The character to be placed into Buffer.

+  @param  Increment   The character increment in Buffer.

+

+  @return Buffer.

+

+**/

+CHAR8 *

+BasePrintLibFillBuffer (

+  OUT CHAR8   *Buffer,

+  IN  CHAR8   *EndBuffer,

+  IN  INTN    Length,

+  IN  UINTN   Character,

+  IN  INTN    Increment

+  )

+{

+  INTN  Index;

+

+  for (Index = 0; Index < Length && Buffer < EndBuffer; Index++) {

+    *Buffer = (CHAR8) Character;

+    if (Increment != 1) {

+      *(Buffer + 1) = (CHAR8)(Character >> 8);

+    }

+    Buffer += Increment;

+  }

+

+  return Buffer;

+}

+

+/**

+  Internal function that convert a number to a string in Buffer.

+

+  Print worker function that converts a decimal or hexadecimal number to an ASCII string in Buffer.

+

+  @param  Buffer    Location to place the ASCII string of Value.

+  @param  Value     The value to convert to a Decimal or Hexadecimal string in Buffer.

+  @param  Radix     Radix of the value

+

+  @return A pointer to the end of buffer filled with ASCII string.

+

+**/

+CHAR8 *

+BasePrintLibValueToString (

+  IN OUT CHAR8  *Buffer,

+  IN INT64      Value,

+  IN UINTN      Radix

+  )

+{

+  UINT32  Remainder;

+

+  //

+  // Loop to convert one digit at a time in reverse order

+  //

+  *Buffer = 0;

+  do {

+    Value = (INT64)DivU64x32Remainder ((UINT64)Value, (UINT32)Radix, &Remainder);

+    *(++Buffer) = mHexStr[Remainder];

+  } while (Value != 0);

+

+  //

+  // Return pointer of the end of filled buffer.

+  //

+  return Buffer;

+}

+

+/**

+  Internal function that converts a decimal value to a Null-terminated string.

+

+  Converts the decimal number specified by Value to a Null-terminated

+  string specified by Buffer containing at most Width characters.

+  If Width is 0 then a width of  MAXIMUM_VALUE_CHARACTERS is assumed.

+  The total number of characters placed in Buffer is returned.

+  If the conversion contains more than Width characters, then only the first

+  Width characters are returned, and the total number of characters

+  required to perform the conversion is returned.

+  Additional conversion parameters are specified in Flags.

+  The Flags bit LEFT_JUSTIFY is always ignored.

+  All conversions are left justified in Buffer.

+  If Width is 0, PREFIX_ZERO is ignored in Flags.

+  If COMMA_TYPE is set in Flags, then PREFIX_ZERO is ignored in Flags, and commas

+  are inserted every 3rd digit starting from the right.

+  If Value is < 0, then the fist character in Buffer is a '-'.

+  If PREFIX_ZERO is set in Flags and PREFIX_ZERO is not being ignored,

+  then Buffer is padded with '0' characters so the combination of the optional '-'

+  sign character, '0' characters, digit characters for Value, and the Null-terminator

+  add up to Width characters.

+

+  If Buffer is NULL, then ASSERT().

+  If unsupported bits are set in Flags, then ASSERT().

+  If Width >= MAXIMUM_VALUE_CHARACTERS, then ASSERT()

+

+  @param  Buffer    The pointer to the output buffer for the produced Null-terminated

+                    string.

+  @param  Flags     The bitmask of flags that specify left justification, zero pad,

+                    and commas.

+  @param  Value     The 64-bit signed value to convert to a string.

+  @param  Width     The maximum number of characters to place in Buffer, not including

+                    the Null-terminator.

+  @param  Increment The character increment in Buffer.

+

+  @return Total number of characters required to perform the conversion.

+

+**/

+UINTN

+BasePrintLibConvertValueToString (

+  IN OUT CHAR8   *Buffer,

+  IN UINTN       Flags,

+  IN INT64       Value,

+  IN UINTN       Width,

+  IN UINTN       Increment

+  )

+{

+  CHAR8  *OriginalBuffer;

+  CHAR8  *EndBuffer;

+  CHAR8  ValueBuffer[MAXIMUM_VALUE_CHARACTERS];

+  CHAR8  *ValueBufferPtr;

+  UINTN  Count;

+  UINTN  Digits;

+  UINTN  Index;

+  UINTN  Radix;

+

+  //

+  // Make sure Buffer is not NULL and Width < MAXIMUM

+  //

+  ASSERT (Buffer != NULL);

+  ASSERT (Width < MAXIMUM_VALUE_CHARACTERS);

+  //

+  // Make sure Flags can only contain supported bits.

+  //

+  ASSERT ((Flags & ~(LEFT_JUSTIFY | COMMA_TYPE | PREFIX_ZERO | RADIX_HEX)) == 0);

+

+  //

+  // If both COMMA_TYPE and RADIX_HEX are set, then ASSERT ()

+  //

+  ASSERT (((Flags & COMMA_TYPE) == 0) || ((Flags & RADIX_HEX) == 0));

+

+  OriginalBuffer = Buffer;

+

+  //

+  // Width is 0 or COMMA_TYPE is set, PREFIX_ZERO is ignored.

+  //

+  if (Width == 0 || (Flags & COMMA_TYPE) != 0) {

+    Flags &= ~((UINTN) PREFIX_ZERO);

+  }

+  //

+  // If Width is 0 then a width of  MAXIMUM_VALUE_CHARACTERS is assumed.

+  //

+  if (Width == 0) {

+    Width = MAXIMUM_VALUE_CHARACTERS - 1;

+  }

+  //

+  // Set the tag for the end of the input Buffer.

+  //

+  EndBuffer = Buffer + Width * Increment;

+

+  //

+  // Convert decimal negative

+  //

+  if ((Value < 0) && ((Flags & RADIX_HEX) == 0)) {

+    Value = -Value;

+    Buffer = BasePrintLibFillBuffer (Buffer, EndBuffer, 1, '-', Increment);

+    Width--;

+  }

+

+  //

+  // Count the length of the value string.

+  //

+  Radix = ((Flags & RADIX_HEX) == 0)? 10 : 16;

+  ValueBufferPtr = BasePrintLibValueToString (ValueBuffer, Value, Radix);

+  Count = ValueBufferPtr - ValueBuffer;

+

+  //

+  // Append Zero

+  //

+  if ((Flags & PREFIX_ZERO) != 0) {

+    Buffer = BasePrintLibFillBuffer (Buffer, EndBuffer, Width - Count, '0', Increment);

+  }

+

+  //

+  // Print Comma type for every 3 characters

+  //

+  Digits = Count % 3;

+  if (Digits != 0) {

+    Digits = 3 - Digits;

+  }

+  for (Index = 0; Index < Count; Index++) {

+    Buffer = BasePrintLibFillBuffer (Buffer, EndBuffer, 1, *ValueBufferPtr--, Increment);

+    if ((Flags & COMMA_TYPE) != 0) {

+      Digits++;

+      if (Digits == 3) {

+        Digits = 0;

+        if ((Index + 1) < Count) {

+          Buffer = BasePrintLibFillBuffer (Buffer, EndBuffer, 1, ',', Increment);

+        }

+      }

+    }

+  }

+

+  //

+  // Print Null-terminator

+  //

+  BasePrintLibFillBuffer (Buffer, EndBuffer + Increment, 1, 0, Increment);

+

+  return ((Buffer - OriginalBuffer) / Increment);

+}

+

+/**

+  Internal function that converts a decimal value to a Null-terminated string.

+

+  Converts the decimal number specified by Value to a Null-terminated string

+  specified by Buffer containing at most Width characters. If Width is 0 then a

+  width of MAXIMUM_VALUE_CHARACTERS is assumed. If the conversion contains more

+  than Width characters, then only the first Width characters are placed in

+  Buffer. Additional conversion parameters are specified in Flags.

+  The Flags bit LEFT_JUSTIFY is always ignored.

+  All conversions are left justified in Buffer.

+  If Width is 0, PREFIX_ZERO is ignored in Flags.

+  If COMMA_TYPE is set in Flags, then PREFIX_ZERO is ignored in Flags, and

+  commas are inserted every 3rd digit starting from the right.

+  If Value is < 0, then the fist character in Buffer is a '-'.

+  If PREFIX_ZERO is set in Flags and PREFIX_ZERO is not being ignored,

+  then Buffer is padded with '0' characters so the combination of the optional

+  '-' sign character, '0' characters, digit characters for Value, and the

+  Null-terminator add up to Width characters.

+

+  If an error would be returned, the function will ASSERT().

+

+  @param  Buffer      The pointer to the output buffer for the produced

+                      Null-terminated string.

+  @param  BufferSize  The size of Buffer in bytes, including the

+                      Null-terminator.

+  @param  Flags       The bitmask of flags that specify left justification,

+                      zero pad, and commas.

+  @param  Value       The 64-bit signed value to convert to a string.

+  @param  Width       The maximum number of characters to place in Buffer,

+                      not including the Null-terminator.

+  @param  Increment   The character increment in Buffer.

+

+  @retval RETURN_SUCCESS           The decimal value is converted.

+  @retval RETURN_BUFFER_TOO_SMALL  If BufferSize cannot hold the converted

+                                   value.

+  @retval RETURN_INVALID_PARAMETER If Buffer is NULL.

+                                   If Increment is 1 and

+                                   PcdMaximumAsciiStringLength is not zero,

+                                   BufferSize is greater than

+                                   PcdMaximumAsciiStringLength.

+                                   If Increment is not 1 and

+                                   PcdMaximumUnicodeStringLength is not zero,

+                                   BufferSize is greater than

+                                   (PcdMaximumUnicodeStringLength *

+                                   sizeof (CHAR16) + 1).

+                                   If unsupported bits are set in Flags.

+                                   If both COMMA_TYPE and RADIX_HEX are set in

+                                   Flags.

+                                   If Width >= MAXIMUM_VALUE_CHARACTERS.

+

+**/

+RETURN_STATUS

+BasePrintLibConvertValueToStringS (

+  IN OUT CHAR8   *Buffer,

+  IN UINTN       BufferSize,

+  IN UINTN       Flags,

+  IN INT64       Value,

+  IN UINTN       Width,

+  IN UINTN       Increment

+  )

+{

+  CHAR8  *EndBuffer;

+  CHAR8  ValueBuffer[MAXIMUM_VALUE_CHARACTERS];

+  CHAR8  *ValueBufferPtr;

+  UINTN  Count;

+  UINTN  Digits;

+  UINTN  Index;

+  UINTN  Radix;

+

+  //

+  // 1. Buffer shall not be a null pointer.

+  //

+  SAFE_PRINT_CONSTRAINT_CHECK ((Buffer != NULL), RETURN_INVALID_PARAMETER);

+

+  //

+  // 2. BufferSize shall not be greater than (RSIZE_MAX * sizeof (CHAR16)) for

+  //    Unicode output string or shall not be greater than ASCII_RSIZE_MAX for

+  //    Ascii output string.

+  //

+  if (Increment == 1) {

+    //

+    // Ascii output string

+    //

+    if (ASCII_RSIZE_MAX != 0) {

+      SAFE_PRINT_CONSTRAINT_CHECK ((BufferSize <= ASCII_RSIZE_MAX), RETURN_INVALID_PARAMETER);

+    }

+  } else {

+    //

+    // Unicode output string

+    //

+    if (RSIZE_MAX != 0) {

+      SAFE_PRINT_CONSTRAINT_CHECK ((BufferSize <= RSIZE_MAX * sizeof (CHAR16) + 1), RETURN_INVALID_PARAMETER);

+    }

+  }

+

+  //

+  // 3. Flags shall be set properly.

+  //

+  SAFE_PRINT_CONSTRAINT_CHECK (((Flags & ~(LEFT_JUSTIFY | COMMA_TYPE | PREFIX_ZERO | RADIX_HEX)) == 0), RETURN_INVALID_PARAMETER);

+  SAFE_PRINT_CONSTRAINT_CHECK ((((Flags & COMMA_TYPE) == 0) || ((Flags & RADIX_HEX) == 0)), RETURN_INVALID_PARAMETER);

+

+  //

+  // 4. Width shall be smaller than MAXIMUM_VALUE_CHARACTERS.

+  //

+  SAFE_PRINT_CONSTRAINT_CHECK ((Width < MAXIMUM_VALUE_CHARACTERS), RETURN_INVALID_PARAMETER);

+

+  //

+  // Width is 0 or COMMA_TYPE is set, PREFIX_ZERO is ignored.

+  //

+  if (Width == 0 || (Flags & COMMA_TYPE) != 0) {

+    Flags &= ~((UINTN) PREFIX_ZERO);

+  }

+  //

+  // If Width is 0 then a width of MAXIMUM_VALUE_CHARACTERS is assumed.

+  //

+  if (Width == 0) {

+    Width = MAXIMUM_VALUE_CHARACTERS - 1;

+  }

+

+  //

+  // Count the characters of the output string.

+  //

+  Count = 0;

+  Radix = ((Flags & RADIX_HEX) == 0)? 10 : 16;

+

+  if ((Flags & PREFIX_ZERO) != 0) {

+    Count = Width;

+  } else {

+    if ((Value < 0) && ((Flags & RADIX_HEX) == 0)) {

+      Count++;  // minus sign

+      ValueBufferPtr = BasePrintLibValueToString (ValueBuffer, -Value, Radix);

+    } else {

+      ValueBufferPtr = BasePrintLibValueToString (ValueBuffer, Value, Radix);

+    }

+    Digits = ValueBufferPtr - ValueBuffer;

+    Count += Digits;

+

+    if ((Flags & COMMA_TYPE) != 0) {

+      Count += (Digits - 1) / 3;  // commas

+    }

+  }

+

+  Width = MIN (Count, Width);

+

+  //

+  // 5. BufferSize shall be large enough to hold the converted string.

+  //

+  SAFE_PRINT_CONSTRAINT_CHECK ((BufferSize >= (Width + 1) * Increment), RETURN_BUFFER_TOO_SMALL);

+

+  //

+  // Set the tag for the end of the input Buffer.

+  //

+  EndBuffer = Buffer + Width * Increment;

+

+  //

+  // Convert decimal negative

+  //

+  if ((Value < 0) && ((Flags & RADIX_HEX) == 0)) {

+    Value = -Value;

+    Buffer = BasePrintLibFillBuffer (Buffer, EndBuffer, 1, '-', Increment);

+    Width--;

+  }

+

+  //

+  // Count the length of the value string.

+  //

+  ValueBufferPtr = BasePrintLibValueToString (ValueBuffer, Value, Radix);

+  Count = ValueBufferPtr - ValueBuffer;

+

+  //

+  // Append Zero

+  //

+  if ((Flags & PREFIX_ZERO) != 0) {

+    Buffer = BasePrintLibFillBuffer (Buffer, EndBuffer, Width - Count, '0', Increment);

+  }

+

+  //

+  // Print Comma type for every 3 characters

+  //

+  Digits = Count % 3;

+  if (Digits != 0) {

+    Digits = 3 - Digits;

+  }

+  for (Index = 0; Index < Count; Index++) {

+    Buffer = BasePrintLibFillBuffer (Buffer, EndBuffer, 1, *ValueBufferPtr--, Increment);

+    if ((Flags & COMMA_TYPE) != 0) {

+      Digits++;

+      if (Digits == 3) {

+        Digits = 0;

+        if ((Index + 1) < Count) {

+          Buffer = BasePrintLibFillBuffer (Buffer, EndBuffer, 1, ',', Increment);

+        }

+      }

+    }

+  }

+

+  //

+  // Print Null-terminator

+  //

+  BasePrintLibFillBuffer (Buffer, EndBuffer + Increment, 1, 0, Increment);

+

+  return RETURN_SUCCESS;

+}

+

+/**

+  Worker function that produces a Null-terminated string in an output buffer

+  based on a Null-terminated format string and a VA_LIST argument list.

+

+  VSPrint function to process format and place the results in Buffer. Since a

+  VA_LIST is used this routine allows the nesting of Vararg routines. Thus

+  this is the main print working routine.

+

+  If COUNT_ONLY_NO_PRINT is set in Flags, Buffer will not be modified at all.

+

+  @param[out] Buffer          The character buffer to print the results of the

+                              parsing of Format into.

+  @param[in]  BufferSize      The maximum number of characters to put into

+                              buffer.

+  @param[in]  Flags           Initial flags value.

+                              Can only have FORMAT_UNICODE, OUTPUT_UNICODE,

+                              and COUNT_ONLY_NO_PRINT set.

+  @param[in]  Format          A Null-terminated format string.

+  @param[in]  VaListMarker    VA_LIST style variable argument list consumed by

+                              processing Format.

+  @param[in]  BaseListMarker  BASE_LIST style variable argument list consumed

+                              by processing Format.

+

+  @return The number of characters printed not including the Null-terminator.

+          If COUNT_ONLY_NO_PRINT was set returns the same, but without any

+          modification to Buffer.

+

+**/

+UINTN

+BasePrintLibSPrintMarker (

+  OUT CHAR8        *Buffer,

+  IN  UINTN        BufferSize,

+  IN  UINTN        Flags,

+  IN  CONST CHAR8  *Format,

+  IN  VA_LIST      VaListMarker,   OPTIONAL

+  IN  BASE_LIST    BaseListMarker  OPTIONAL

+  )

+{

+  CHAR8             *OriginalBuffer;

+  CHAR8             *EndBuffer;

+  CHAR8             ValueBuffer[MAXIMUM_VALUE_CHARACTERS];

+  UINT32            BytesPerOutputCharacter;

+  UINTN             BytesPerFormatCharacter;

+  UINTN             FormatMask;

+  UINTN             FormatCharacter;

+  UINTN             Width;

+  UINTN             Precision;

+  INT64             Value;

+  CONST CHAR8       *ArgumentString;

+  UINTN             Character;

+  GUID              *TmpGuid;

+  TIME              *TmpTime;

+  UINTN             Count;

+  UINTN             ArgumentMask;

+  INTN              BytesPerArgumentCharacter;

+  UINTN             ArgumentCharacter;

+  BOOLEAN           Done;

+  UINTN             Index;

+  CHAR8             Prefix;

+  BOOLEAN           ZeroPad;

+  BOOLEAN           Comma;

+  UINTN             Digits;

+  UINTN             Radix;

+  RETURN_STATUS     Status;

+  UINT32            GuidData1;

+  UINT16            GuidData2;

+  UINT16            GuidData3;

+  UINTN             LengthToReturn;

+

+  //

+  // If you change this code be sure to match the 2 versions of this function.

+  // Nearly identical logic is found in the BasePrintLib and

+  // DxePrintLibPrint2Protocol (both PrintLib instances).

+  //

+

+  //

+  // 1. Buffer shall not be a null pointer when both BufferSize > 0 and

+  //    COUNT_ONLY_NO_PRINT is not set in Flags.

+  //

+  if ((BufferSize > 0) && ((Flags & COUNT_ONLY_NO_PRINT) == 0)) {

+    SAFE_PRINT_CONSTRAINT_CHECK ((Buffer != NULL), 0);

+  }

+

+  //

+  // 2. Format shall not be a null pointer when BufferSize > 0 or when

+  //    COUNT_ONLY_NO_PRINT is set in Flags.

+  //

+  if ((BufferSize > 0) || ((Flags & COUNT_ONLY_NO_PRINT) != 0)) {

+    SAFE_PRINT_CONSTRAINT_CHECK ((Format != NULL), 0);

+  }

+

+  //

+  // 3. BufferSize shall not be greater than RSIZE_MAX for Unicode output or

+  //    ASCII_RSIZE_MAX for Ascii output.

+  //

+  if ((Flags & OUTPUT_UNICODE) != 0) {

+    if (RSIZE_MAX != 0) {

+      SAFE_PRINT_CONSTRAINT_CHECK ((BufferSize <= RSIZE_MAX), 0);

+    }

+    BytesPerOutputCharacter = 2;

+  } else {

+    if (ASCII_RSIZE_MAX != 0) {

+      SAFE_PRINT_CONSTRAINT_CHECK ((BufferSize <= ASCII_RSIZE_MAX), 0);

+    }

+    BytesPerOutputCharacter = 1;

+  }

+

+  //

+  // 4. Format shall not contain more than RSIZE_MAX Unicode characters or

+  //    ASCII_RSIZE_MAX Ascii characters.

+  //

+  if ((Flags & FORMAT_UNICODE) != 0) {

+    if (RSIZE_MAX != 0) {

+      SAFE_PRINT_CONSTRAINT_CHECK ((StrnLenS ((CHAR16 *)Format, RSIZE_MAX + 1) <= RSIZE_MAX), 0);

+    }

+    BytesPerFormatCharacter = 2;

+    FormatMask = 0xffff;

+  } else {

+    if (ASCII_RSIZE_MAX != 0) {

+      SAFE_PRINT_CONSTRAINT_CHECK ((AsciiStrnLenS (Format, ASCII_RSIZE_MAX + 1) <= ASCII_RSIZE_MAX), 0);

+    }

+    BytesPerFormatCharacter = 1;

+    FormatMask = 0xff;

+  }

+

+  if ((Flags & COUNT_ONLY_NO_PRINT) != 0) {

+    if (BufferSize == 0) {

+      Buffer = NULL;

+    }

+  } else {

+    //

+    // We can run without a Buffer for counting only.

+    //

+    if (BufferSize == 0) {

+      return 0;

+    }

+  }

+

+  LengthToReturn = 0;

+  EndBuffer = NULL;

+  OriginalBuffer = NULL;

+

+  //

+  // Reserve space for the Null terminator.

+  //

+  if (Buffer != NULL) {

+    BufferSize--;

+    OriginalBuffer = Buffer;

+

+    //

+    // Set the tag for the end of the input Buffer.

+    //

+    EndBuffer = Buffer + BufferSize * BytesPerOutputCharacter;

+  }

+

+  //

+  // Get the first character from the format string

+  //

+  FormatCharacter = ((*Format & 0xff) | ((BytesPerFormatCharacter == 1) ? 0 : (*(Format + 1) << 8))) & FormatMask;

+

+  //

+  // Loop until the end of the format string is reached or the output buffer is full

+  //

+  while (FormatCharacter != 0) {

+    if ((Buffer != NULL) && (Buffer >= EndBuffer)) {

+      break;

+    }

+    //

+    // Clear all the flag bits except those that may have been passed in

+    //

+    Flags &= (UINTN) (OUTPUT_UNICODE | FORMAT_UNICODE | COUNT_ONLY_NO_PRINT);

+

+    //

+    // Set the default width to zero, and the default precision to 1

+    //

+    Width     = 0;

+    Precision = 1;

+    Prefix    = 0;

+    Comma     = FALSE;

+    ZeroPad   = FALSE;

+    Count     = 0;

+    Digits    = 0;

+

+    switch (FormatCharacter) {

+    case '%':

+      //

+      // Parse Flags and Width

+      //

+      for (Done = FALSE; !Done; ) {

+        Format += BytesPerFormatCharacter;

+        FormatCharacter = ((*Format & 0xff) | ((BytesPerFormatCharacter == 1) ? 0 : (*(Format + 1) << 8))) & FormatMask;

+        switch (FormatCharacter) {

+        case '.':

+          Flags |= PRECISION;

+          break;

+        case '-':

+          Flags |= LEFT_JUSTIFY;

+          break;

+        case '+':

+          Flags |= PREFIX_SIGN;

+          break;

+        case ' ':

+          Flags |= PREFIX_BLANK;

+          break;

+        case ',':

+          Flags |= COMMA_TYPE;

+          break;

+        case 'L':

+        case 'l':

+          Flags |= LONG_TYPE;

+          break;

+        case '*':

+          if ((Flags & PRECISION) == 0) {

+            Flags |= PAD_TO_WIDTH;

+            if (BaseListMarker == NULL) {

+              Width = VA_ARG (VaListMarker, UINTN);

+            } else {

+              Width = BASE_ARG (BaseListMarker, UINTN);

+            }

+          } else {

+            if (BaseListMarker == NULL) {

+              Precision = VA_ARG (VaListMarker, UINTN);

+            } else {

+              Precision = BASE_ARG (BaseListMarker, UINTN);

+            }

+          }

+          break;

+        case '0':

+          if ((Flags & PRECISION) == 0) {

+            Flags |= PREFIX_ZERO;

+          }

+        case '1':

+        case '2':

+        case '3':

+        case '4':

+        case '5':

+        case '6':

+        case '7':

+        case '8':

+        case '9':

+          for (Count = 0; ((FormatCharacter >= '0') &&  (FormatCharacter <= '9')); ){

+            Count = (Count * 10) + FormatCharacter - '0';

+            Format += BytesPerFormatCharacter;

+            FormatCharacter = ((*Format & 0xff) | ((BytesPerFormatCharacter == 1) ? 0 : (*(Format + 1) << 8))) & FormatMask;

+          }

+          Format -= BytesPerFormatCharacter;

+          if ((Flags & PRECISION) == 0) {

+            Flags |= PAD_TO_WIDTH;

+            Width = Count;

+          } else {

+            Precision = Count;

+          }

+          break;

+

+        case '\0':

+          //

+          // Make no output if Format string terminates unexpectedly when

+          // looking up for flag, width, precision and type.

+          //

+          Format   -= BytesPerFormatCharacter;

+          Precision = 0;

+          //

+          // break skipped on purpose.

+          //

+        default:

+          Done = TRUE;

+          break;

+        }

+      }

+

+      //

+      // Handle each argument type

+      //

+      switch (FormatCharacter) {

+      case 'p':

+        //

+        // Flag space, +, 0, L & l are invalid for type p.

+        //

+        Flags &= ~((UINTN) (PREFIX_BLANK | PREFIX_SIGN | PREFIX_ZERO | LONG_TYPE));

+        if (sizeof (VOID *) > 4) {

+          Flags |= LONG_TYPE;

+        }

+        //

+        // break skipped on purpose

+        //

+      case 'X':

+        Flags |= PREFIX_ZERO;

+        //

+        // break skipped on purpose

+        //

+      case 'x':

+        Flags |= RADIX_HEX;

+        //

+        // break skipped on purpose

+        //

+      case 'u':

+        if ((Flags & RADIX_HEX) == 0) {

+          Flags &= ~((UINTN) (PREFIX_SIGN));

+          Flags |= UNSIGNED_TYPE;

+        }

+        //

+        // break skipped on purpose

+        //

+      case 'd':

+        if ((Flags & LONG_TYPE) == 0) {

+          //

+          // 'd', 'u', 'x', and 'X' that are not preceded by 'l' or 'L' are assumed to be type "int".

+          // This assumption is made so the format string definition is compatible with the ANSI C

+          // Specification for formatted strings.  It is recommended that the Base Types be used

+          // everywhere, but in this one case, compliance with ANSI C is more important, and

+          // provides an implementation that is compatible with that largest possible set of CPU

+          // architectures.  This is why the type "int" is used in this one case.

+          //

+          if (BaseListMarker == NULL) {

+            Value = VA_ARG (VaListMarker, int);

+          } else {

+            Value = BASE_ARG (BaseListMarker, int);

+          }

+        } else {

+          if (BaseListMarker == NULL) {

+            Value = VA_ARG (VaListMarker, INT64);

+          } else {

+            Value = BASE_ARG (BaseListMarker, INT64);

+          }

+        }

+        if ((Flags & PREFIX_BLANK) != 0) {

+          Prefix = ' ';

+        }

+        if ((Flags & PREFIX_SIGN) != 0) {

+          Prefix = '+';

+        }

+        if ((Flags & COMMA_TYPE) != 0) {

+          Comma = TRUE;

+        }

+        if ((Flags & RADIX_HEX) == 0) {

+          Radix = 10;

+          if (Comma) {

+            Flags &= ~((UINTN) PREFIX_ZERO);

+            Precision = 1;

+          }

+          if (Value < 0 && (Flags & UNSIGNED_TYPE) == 0) {

+            Flags |= PREFIX_SIGN;

+            Prefix = '-';

+            Value = -Value;

+          } else if ((Flags & UNSIGNED_TYPE) != 0 && (Flags & LONG_TYPE) == 0) {

+            //

+            // 'd', 'u', 'x', and 'X' that are not preceded by 'l' or 'L' are assumed to be type "int".

+            // This assumption is made so the format string definition is compatible with the ANSI C

+            // Specification for formatted strings.  It is recommended that the Base Types be used

+            // everywhere, but in this one case, compliance with ANSI C is more important, and

+            // provides an implementation that is compatible with that largest possible set of CPU

+            // architectures.  This is why the type "unsigned int" is used in this one case.

+            //

+            Value = (unsigned int)Value;

+          }

+        } else {

+          Radix = 16;

+          Comma = FALSE;

+          if ((Flags & LONG_TYPE) == 0 && Value < 0) {

+            //

+            // 'd', 'u', 'x', and 'X' that are not preceded by 'l' or 'L' are assumed to be type "int".

+            // This assumption is made so the format string definition is compatible with the ANSI C

+            // Specification for formatted strings.  It is recommended that the Base Types be used

+            // everywhere, but in this one case, compliance with ANSI C is more important, and

+            // provides an implementation that is compatible with that largest possible set of CPU

+            // architectures.  This is why the type "unsigned int" is used in this one case.

+            //

+            Value = (unsigned int)Value;

+          }

+        }

+        //

+        // Convert Value to a reversed string

+        //

+        Count = BasePrintLibValueToString (ValueBuffer, Value, Radix) - ValueBuffer;

+        if (Value == 0 && Precision == 0) {

+          Count = 0;

+        }

+        ArgumentString = (CHAR8 *)ValueBuffer + Count;

+

+        Digits = Count % 3;

+        if (Digits != 0) {

+          Digits = 3 - Digits;

+        }

+        if (Comma && Count != 0) {

+          Count += ((Count - 1) / 3);

+        }

+        if (Prefix != 0) {

+          Count++;

+          Precision++;

+        }

+        Flags |= ARGUMENT_REVERSED;

+        ZeroPad = TRUE;

+        if ((Flags & PREFIX_ZERO) != 0) {

+          if ((Flags & LEFT_JUSTIFY) == 0) {

+            if ((Flags & PAD_TO_WIDTH) != 0) {

+              if ((Flags & PRECISION) == 0) {

+                Precision = Width;

+              }

+            }

+          }

+        }

+        break;

+

+      case 's':

+      case 'S':

+        Flags |= ARGUMENT_UNICODE;

+        //

+        // break skipped on purpose

+        //

+      case 'a':

+        if (BaseListMarker == NULL) {

+          ArgumentString = VA_ARG (VaListMarker, CHAR8 *);

+        } else {

+          ArgumentString = BASE_ARG (BaseListMarker, CHAR8 *);

+        }

+        if (ArgumentString == NULL) {

+          Flags &= ~((UINTN) ARGUMENT_UNICODE);

+          ArgumentString = "<null string>";

+        }

+        //

+        // Set the default precision for string to be zero if not specified.

+        //

+        if ((Flags & PRECISION) == 0) {

+          Precision = 0;

+        }

+        break;

+

+      case 'c':

+        if (BaseListMarker == NULL) {

+          Character = VA_ARG (VaListMarker, UINTN) & 0xffff;

+        } else {

+          Character = BASE_ARG (BaseListMarker, UINTN) & 0xffff;

+        }

+        ArgumentString = (CHAR8 *)&Character;

+        Flags |= ARGUMENT_UNICODE;

+        break;

+

+      case 'g':

+        if (BaseListMarker == NULL) {

+          TmpGuid = VA_ARG (VaListMarker, GUID *);

+        } else {

+          TmpGuid = BASE_ARG (BaseListMarker, GUID *);

+        }

+        if (TmpGuid == NULL) {

+          ArgumentString = "<null guid>";

+        } else {

+          GuidData1 = ReadUnaligned32 (&(TmpGuid->Data1));

+          GuidData2 = ReadUnaligned16 (&(TmpGuid->Data2));

+          GuidData3 = ReadUnaligned16 (&(TmpGuid->Data3));

+          BasePrintLibSPrint (

+            ValueBuffer,

+            MAXIMUM_VALUE_CHARACTERS,

+            0,

+            "%08x-%04x-%04x-%02x%02x-%02x%02x%02x%02x%02x%02x",

+            GuidData1,

+            GuidData2,

+            GuidData3,

+            TmpGuid->Data4[0],

+            TmpGuid->Data4[1],

+            TmpGuid->Data4[2],

+            TmpGuid->Data4[3],

+            TmpGuid->Data4[4],

+            TmpGuid->Data4[5],

+            TmpGuid->Data4[6],

+            TmpGuid->Data4[7]

+            );

+          ArgumentString = ValueBuffer;

+        }

+        break;

+

+      case 't':

+        if (BaseListMarker == NULL) {

+          TmpTime = VA_ARG (VaListMarker, TIME *);

+        } else {

+          TmpTime = BASE_ARG (BaseListMarker, TIME *);

+        }

+        if (TmpTime == NULL) {

+          ArgumentString = "<null time>";

+        } else {

+          BasePrintLibSPrint (

+            ValueBuffer,

+            MAXIMUM_VALUE_CHARACTERS,

+            0,

+            "%02d/%02d/%04d  %02d:%02d",

+            TmpTime->Month,

+            TmpTime->Day,

+            TmpTime->Year,

+            TmpTime->Hour,

+            TmpTime->Minute

+            );

+          ArgumentString = ValueBuffer;

+        }

+        break;

+

+      case 'r':

+        if (BaseListMarker == NULL) {

+          Status = VA_ARG (VaListMarker, RETURN_STATUS);

+        } else {

+          Status = BASE_ARG (BaseListMarker, RETURN_STATUS);

+        }

+        ArgumentString = ValueBuffer;

+        if (RETURN_ERROR (Status)) {

+          //

+          // Clear error bit

+          //

+          Index = Status & ~MAX_BIT;

+          if (Index > 0 && Index <= ERROR_STATUS_NUMBER) {

+            ArgumentString = mErrorString [Index - 1];

+          }

+        } else {

+          Index = Status;

+          if (Index <= WARNING_STATUS_NUMBER) {

+            ArgumentString = mWarningString [Index];

+          }

+        }

+        if (ArgumentString == ValueBuffer) {

+          BasePrintLibSPrint ((CHAR8 *) ValueBuffer, MAXIMUM_VALUE_CHARACTERS, 0, "%08X", Status);

+        }

+        break;

+

+      case '\r':

+        Format += BytesPerFormatCharacter;

+        FormatCharacter = ((*Format & 0xff) | ((BytesPerFormatCharacter == 1) ? 0 : (*(Format + 1) << 8))) & FormatMask;

+        if (FormatCharacter == '\n') {

+          //

+          // Translate '\r\n' to '\r\n'

+          //

+          ArgumentString = "\r\n";

+        } else {

+          //

+          // Translate '\r' to '\r'

+          //

+          ArgumentString = "\r";

+          Format   -= BytesPerFormatCharacter;

+        }

+        break;

+

+      case '\n':

+        //

+        // Translate '\n' to '\r\n' and '\n\r' to '\r\n'

+        //

+        ArgumentString = "\r\n";

+        Format += BytesPerFormatCharacter;

+        FormatCharacter = ((*Format & 0xff) | ((BytesPerFormatCharacter == 1) ? 0 : (*(Format + 1) << 8))) & FormatMask;

+        if (FormatCharacter != '\r') {

+          Format   -= BytesPerFormatCharacter;

+        }

+        break;

+

+      case '%':

+      default:

+        //

+        // if the type is '%' or unknown, then print it to the screen

+        //

+        ArgumentString = (CHAR8 *)&FormatCharacter;

+        Flags |= ARGUMENT_UNICODE;

+        break;

+      }

+      break;

+

+    case '\r':

+      Format += BytesPerFormatCharacter;

+      FormatCharacter = ((*Format & 0xff) | ((BytesPerFormatCharacter == 1) ? 0 : (*(Format + 1) << 8))) & FormatMask;

+      if (FormatCharacter == '\n') {

+        //

+        // Translate '\r\n' to '\r\n'

+        //

+        ArgumentString = "\r\n";

+      } else {

+        //

+        // Translate '\r' to '\r'

+        //

+        ArgumentString = "\r";

+        Format   -= BytesPerFormatCharacter;

+      }

+      break;

+

+    case '\n':

+      //

+      // Translate '\n' to '\r\n' and '\n\r' to '\r\n'

+      //

+      ArgumentString = "\r\n";

+      Format += BytesPerFormatCharacter;

+      FormatCharacter = ((*Format & 0xff) | ((BytesPerFormatCharacter == 1) ? 0 : (*(Format + 1) << 8))) & FormatMask;

+      if (FormatCharacter != '\r') {

+        Format   -= BytesPerFormatCharacter;

+      }

+      break;

+

+    default:

+      ArgumentString = (CHAR8 *)&FormatCharacter;

+      Flags |= ARGUMENT_UNICODE;

+      break;

+    }

+

+    //

+    // Retrieve the ArgumentString attriubutes

+    //

+    if ((Flags & ARGUMENT_UNICODE) != 0) {

+      ArgumentMask = 0xffff;

+      BytesPerArgumentCharacter = 2;

+    } else {

+      ArgumentMask = 0xff;

+      BytesPerArgumentCharacter = 1;

+    }

+    if ((Flags & ARGUMENT_REVERSED) != 0) {

+      BytesPerArgumentCharacter = -BytesPerArgumentCharacter;

+    } else {

+      //

+      // Compute the number of characters in ArgumentString and store it in Count

+      // ArgumentString is either null-terminated, or it contains Precision characters

+      //

+      for (Count = 0;

+            (ArgumentString[Count * BytesPerArgumentCharacter] != '\0' ||

+             (BytesPerArgumentCharacter > 1 &&

+              ArgumentString[Count * BytesPerArgumentCharacter + 1]!= '\0')) &&

+            (Count < Precision || ((Flags & PRECISION) == 0));

+              Count++) {

+        ArgumentCharacter = ((ArgumentString[Count * BytesPerArgumentCharacter] & 0xff) | ((ArgumentString[Count * BytesPerArgumentCharacter + 1]) << 8)) & ArgumentMask;

+        if (ArgumentCharacter == 0) {

+          break;

+        }

+      }

+    }

+

+    if (Precision < Count) {

+      Precision = Count;

+    }

+

+    //

+    // Pad before the string

+    //

+    if ((Flags & (PAD_TO_WIDTH | LEFT_JUSTIFY)) == (PAD_TO_WIDTH)) {

+      LengthToReturn += ((Width - Precision) * BytesPerOutputCharacter);

+      if ((Flags & COUNT_ONLY_NO_PRINT) == 0 && Buffer != NULL) {

+        Buffer = BasePrintLibFillBuffer (Buffer, EndBuffer, Width - Precision, ' ', BytesPerOutputCharacter);

+      }

+    }

+

+    if (ZeroPad) {

+      if (Prefix != 0) {

+        LengthToReturn += (1 * BytesPerOutputCharacter);

+        if ((Flags & COUNT_ONLY_NO_PRINT) == 0 && Buffer != NULL) {

+          Buffer = BasePrintLibFillBuffer (Buffer, EndBuffer, 1, Prefix, BytesPerOutputCharacter);

+        }

+      }

+      LengthToReturn += ((Precision - Count) * BytesPerOutputCharacter);

+      if ((Flags & COUNT_ONLY_NO_PRINT) == 0 && Buffer != NULL) {

+        Buffer = BasePrintLibFillBuffer (Buffer, EndBuffer, Precision - Count, '0', BytesPerOutputCharacter);

+      }

+    } else {

+      LengthToReturn += ((Precision - Count) * BytesPerOutputCharacter);

+      if ((Flags & COUNT_ONLY_NO_PRINT) == 0 && Buffer != NULL) {

+        Buffer = BasePrintLibFillBuffer (Buffer, EndBuffer, Precision - Count, ' ', BytesPerOutputCharacter);

+      }

+      if (Prefix != 0) {

+        LengthToReturn += (1 * BytesPerOutputCharacter);

+        if ((Flags & COUNT_ONLY_NO_PRINT) == 0 && Buffer != NULL) {

+          Buffer = BasePrintLibFillBuffer (Buffer, EndBuffer, 1, Prefix, BytesPerOutputCharacter);

+        }

+      }

+    }

+

+    //

+    // Output the Prefix character if it is present

+    //

+    Index = 0;

+    if (Prefix != 0) {

+      Index++;

+    }

+

+    //

+    // Copy the string into the output buffer performing the required type conversions

+    //

+    while (Index < Count &&

+           (ArgumentString[0] != '\0' ||

+            (BytesPerArgumentCharacter > 1 && ArgumentString[1] != '\0'))) {

+      ArgumentCharacter = ((*ArgumentString & 0xff) | (((UINT8)*(ArgumentString + 1)) << 8)) & ArgumentMask;

+

+      LengthToReturn += (1 * BytesPerOutputCharacter);

+      if ((Flags & COUNT_ONLY_NO_PRINT) == 0 && Buffer != NULL) {

+        Buffer = BasePrintLibFillBuffer (Buffer, EndBuffer, 1, ArgumentCharacter, BytesPerOutputCharacter);

+      }

+      ArgumentString    += BytesPerArgumentCharacter;

+      Index++;

+      if (Comma) {

+        Digits++;

+        if (Digits == 3) {

+          Digits = 0;

+          Index++;

+          if (Index < Count) {

+            LengthToReturn += (1 * BytesPerOutputCharacter);

+            if ((Flags & COUNT_ONLY_NO_PRINT) == 0 && Buffer != NULL) {

+              Buffer = BasePrintLibFillBuffer (Buffer, EndBuffer, 1, ',', BytesPerOutputCharacter);

+            }

+          }

+        }

+      }

+    }

+

+    //

+    // Pad after the string

+    //

+    if ((Flags & (PAD_TO_WIDTH | LEFT_JUSTIFY)) == (PAD_TO_WIDTH | LEFT_JUSTIFY)) {

+      LengthToReturn += ((Width - Precision) * BytesPerOutputCharacter);

+      if ((Flags & COUNT_ONLY_NO_PRINT) == 0 && Buffer != NULL) {

+        Buffer = BasePrintLibFillBuffer (Buffer, EndBuffer, Width - Precision, ' ', BytesPerOutputCharacter);

+      }

+    }

+

+    //

+    // Get the next character from the format string

+    //

+    Format += BytesPerFormatCharacter;

+

+    //

+    // Get the next character from the format string

+    //

+    FormatCharacter = ((*Format & 0xff) | ((BytesPerFormatCharacter == 1) ? 0 : (*(Format + 1) << 8))) & FormatMask;

+  }

+

+  if ((Flags & COUNT_ONLY_NO_PRINT) != 0) {

+    return (LengthToReturn / BytesPerOutputCharacter);

+  }

+

+  ASSERT (Buffer != NULL);

+  //

+  // Null terminate the Unicode or ASCII string

+  //

+  BasePrintLibFillBuffer (Buffer, EndBuffer + BytesPerOutputCharacter, 1, 0, BytesPerOutputCharacter);

+

+  return ((Buffer - OriginalBuffer) / BytesPerOutputCharacter);

+}

+

+/**

+  Worker function that produces a Null-terminated string in an output buffer

+  based on a Null-terminated format string and variable argument list.

+

+  VSPrint function to process format and place the results in Buffer. Since a

+  VA_LIST is used this routine allows the nesting of Vararg routines. Thus

+  this is the main print working routine

+

+  @param  StartOfBuffer The character buffer to print the results of the parsing

+                        of Format into.

+  @param  BufferSize    The maximum number of characters to put into buffer.

+                        Zero means no limit.

+  @param  Flags         Initial flags value.

+                        Can only have FORMAT_UNICODE and OUTPUT_UNICODE set

+  @param  FormatString  A Null-terminated format string.

+  @param  ...           The variable argument list.

+

+  @return The number of characters printed.

+

+**/

+UINTN

+EFIAPI

+BasePrintLibSPrint (

+  OUT CHAR8        *StartOfBuffer,

+  IN  UINTN        BufferSize,

+  IN  UINTN        Flags,

+  IN  CONST CHAR8  *FormatString,

+  ...

+  )

+{

+  VA_LIST  Marker;

+  UINTN    NumberOfPrinted;

+

+  VA_START (Marker, FormatString);

+  NumberOfPrinted = BasePrintLibSPrintMarker (StartOfBuffer, BufferSize, Flags, FormatString, Marker, NULL);

+  VA_END (Marker);

+  return NumberOfPrinted;

+}

diff --git a/debugging_demo/memtest86+/efi/Include/src/BasePrintLib/PrintLibInternal.h b/debugging_demo/memtest86+/efi/Include/src/BasePrintLib/PrintLibInternal.h
new file mode 100644
index 0000000..c20a582
--- /dev/null
+++ b/debugging_demo/memtest86+/efi/Include/src/BasePrintLib/PrintLibInternal.h
@@ -0,0 +1,271 @@
+/** @file

+  Base Print Library instance Internal Functions definition.

+

+  Copyright (c) 2006 - 2018, Intel Corporation. All rights reserved.<BR>

+  SPDX-License-Identifier: BSD-2-Clause-Patent

+

+**/

+

+#ifndef __PRINT_LIB_INTERNAL_H__

+#define __PRINT_LIB_INTERNAL_H__

+

+#include <Base.h>

+#include <Library/PrintLib.h>

+#include <Library/BaseLib.h>

+#include <Library/DebugLib.h>

+#include <Library/PcdLib.h>

+

+

+//

+// Print primitives

+//

+#define PREFIX_SIGN           BIT1

+#define PREFIX_BLANK          BIT2

+#define LONG_TYPE             BIT4

+#define OUTPUT_UNICODE        BIT6

+#define FORMAT_UNICODE        BIT8

+#define PAD_TO_WIDTH          BIT9

+#define ARGUMENT_UNICODE      BIT10

+#define PRECISION             BIT11

+#define ARGUMENT_REVERSED     BIT12

+#define COUNT_ONLY_NO_PRINT   BIT13

+#define UNSIGNED_TYPE         BIT14

+

+//

+// Record date and time information

+//

+typedef struct {

+  UINT16  Year;

+  UINT8   Month;

+  UINT8   Day;

+  UINT8   Hour;

+  UINT8   Minute;

+  UINT8   Second;

+  UINT8   Pad1;

+  UINT32  Nanosecond;

+  INT16   TimeZone;

+  UINT8   Daylight;

+  UINT8   Pad2;

+} TIME;

+

+/**

+  Worker function that produces a Null-terminated string in an output buffer

+  based on a Null-terminated format string and a VA_LIST argument list.

+

+  VSPrint function to process format and place the results in Buffer. Since a

+  VA_LIST is used this routine allows the nesting of Vararg routines. Thus

+  this is the main print working routine.

+

+  If COUNT_ONLY_NO_PRINT is set in Flags, Buffer will not be modified at all.

+

+  @param[out] Buffer          The character buffer to print the results of the

+                              parsing of Format into.

+  @param[in]  BufferSize      The maximum number of characters to put into

+                              buffer.

+  @param[in]  Flags           Initial flags value.

+                              Can only have FORMAT_UNICODE, OUTPUT_UNICODE,

+                              and COUNT_ONLY_NO_PRINT set.

+  @param[in]  Format          A Null-terminated format string.

+  @param[in]  VaListMarker    VA_LIST style variable argument list consumed by

+                              processing Format.

+  @param[in]  BaseListMarker  BASE_LIST style variable argument list consumed

+                              by processing Format.

+

+  @return The number of characters printed not including the Null-terminator.

+          If COUNT_ONLY_NO_PRINT was set returns the same, but without any

+          modification to Buffer.

+

+**/

+UINTN

+BasePrintLibSPrintMarker (

+  OUT CHAR8        *Buffer,

+  IN  UINTN        BufferSize,

+  IN  UINTN        Flags,

+  IN  CONST CHAR8  *Format,

+  IN  VA_LIST      VaListMarker,   OPTIONAL

+  IN  BASE_LIST    BaseListMarker  OPTIONAL

+  );

+

+/**

+  Worker function that produces a Null-terminated string in an output buffer

+  based on a Null-terminated format string and variable argument list.

+

+  VSPrint function to process format and place the results in Buffer. Since a

+  VA_LIST is used this routine allows the nesting of Vararg routines. Thus

+  this is the main print working routine

+

+  @param  StartOfBuffer The character buffer to print the results of the parsing

+                        of Format into.

+  @param  BufferSize    The maximum number of characters to put into buffer.

+                        Zero means no limit.

+  @param  Flags         Initial flags value.

+                        Can only have FORMAT_UNICODE and OUTPUT_UNICODE set

+  @param  FormatString  Null-terminated format string.

+  @param  ...           The variable argument list.

+

+  @return The number of characters printed.

+

+**/

+UINTN

+EFIAPI

+BasePrintLibSPrint (

+  OUT CHAR8        *StartOfBuffer,

+  IN  UINTN        BufferSize,

+  IN  UINTN        Flags,

+  IN  CONST CHAR8  *FormatString,

+  ...

+  );

+

+/**

+  Internal function that places the character into the Buffer.

+

+  Internal function that places ASCII or Unicode character into the Buffer.

+

+  @param  Buffer      Buffer to place the Unicode or ASCII string.

+  @param  EndBuffer   The end of the input Buffer. No characters will be

+                      placed after that.

+  @param  Length      The count of character to be placed into Buffer.

+                      (Negative value indicates no buffer fill.)

+  @param  Character   The character to be placed into Buffer.

+  @param  Increment   The character increment in Buffer.

+

+  @return Buffer      Buffer filled with the input Character.

+

+**/

+CHAR8 *

+BasePrintLibFillBuffer (

+  OUT CHAR8   *Buffer,

+  IN  CHAR8   *EndBuffer,

+  IN  INTN    Length,

+  IN  UINTN   Character,

+  IN  INTN    Increment

+  );

+

+/**

+  Internal function that convert a number to a string in Buffer.

+

+  Print worker function that converts a decimal or hexadecimal number to an ASCII string in Buffer.

+

+  @param  Buffer    Location to place the ASCII string of Value.

+  @param  Value     The value to convert to a Decimal or Hexadecimal string in Buffer.

+  @param  Radix     Radix of the value

+

+  @return A pointer to the end of buffer filled with ASCII string.

+

+**/

+CHAR8 *

+BasePrintLibValueToString (

+  IN OUT CHAR8  *Buffer,

+  IN INT64      Value,

+  IN UINTN      Radix

+  );

+

+/**

+  Internal function that converts a decimal value to a Null-terminated string.

+

+  Converts the decimal number specified by Value to a Null-terminated

+  string specified by Buffer containing at most Width characters.

+  If Width is 0 then a width of  MAXIMUM_VALUE_CHARACTERS is assumed.

+  The total number of characters placed in Buffer is returned.

+  If the conversion contains more than Width characters, then only the first

+  Width characters are returned, and the total number of characters

+  required to perform the conversion is returned.

+  Additional conversion parameters are specified in Flags.

+  The Flags bit LEFT_JUSTIFY is always ignored.

+  All conversions are left justified in Buffer.

+  If Width is 0, PREFIX_ZERO is ignored in Flags.

+  If COMMA_TYPE is set in Flags, then PREFIX_ZERO is ignored in Flags, and commas

+  are inserted every 3rd digit starting from the right.

+  If Value is < 0, then the fist character in Buffer is a '-'.

+  If PREFIX_ZERO is set in Flags and PREFIX_ZERO is not being ignored,

+  then Buffer is padded with '0' characters so the combination of the optional '-'

+  sign character, '0' characters, digit characters for Value, and the Null-terminator

+  add up to Width characters.

+

+  If Buffer is NULL, then ASSERT().

+  If unsupported bits are set in Flags, then ASSERT().

+  If Width >= MAXIMUM_VALUE_CHARACTERS, then ASSERT()

+

+  @param  Buffer    The pointer to the output buffer for the produced Null-terminated

+                    string.

+  @param  Flags     The bitmask of flags that specify left justification, zero pad,

+                    and commas.

+  @param  Value     The 64-bit signed value to convert to a string.

+  @param  Width     The maximum number of characters to place in Buffer, not including

+                    the Null-terminator.

+  @param  Increment Character increment in Buffer.

+

+  @return Total number of characters required to perform the conversion.

+

+**/

+UINTN

+BasePrintLibConvertValueToString (

+  IN OUT CHAR8   *Buffer,

+  IN UINTN       Flags,

+  IN INT64       Value,

+  IN UINTN       Width,

+  IN UINTN       Increment

+  );

+

+/**

+  Internal function that converts a decimal value to a Null-terminated string.

+

+  Converts the decimal number specified by Value to a Null-terminated string

+  specified by Buffer containing at most Width characters. If Width is 0 then a

+  width of MAXIMUM_VALUE_CHARACTERS is assumed. If the conversion contains more

+  than Width characters, then only the first Width characters are placed in

+  Buffer. Additional conversion parameters are specified in Flags.

+  The Flags bit LEFT_JUSTIFY is always ignored.

+  All conversions are left justified in Buffer.

+  If Width is 0, PREFIX_ZERO is ignored in Flags.

+  If COMMA_TYPE is set in Flags, then PREFIX_ZERO is ignored in Flags, and

+  commas are inserted every 3rd digit starting from the right.

+  If Value is < 0, then the fist character in Buffer is a '-'.

+  If PREFIX_ZERO is set in Flags and PREFIX_ZERO is not being ignored,

+  then Buffer is padded with '0' characters so the combination of the optional

+  '-' sign character, '0' characters, digit characters for Value, and the

+  Null-terminator add up to Width characters.

+

+  If an error would be returned, the function will ASSERT().

+

+  @param  Buffer      The pointer to the output buffer for the produced

+                      Null-terminated string.

+  @param  BufferSize  The size of Buffer in bytes, including the

+                      Null-terminator.

+  @param  Flags       The bitmask of flags that specify left justification,

+                      zero pad, and commas.

+  @param  Value       The 64-bit signed value to convert to a string.

+  @param  Width       The maximum number of characters to place in Buffer,

+                      not including the Null-terminator.

+  @param  Increment   The character increment in Buffer.

+

+  @retval RETURN_SUCCESS           The decimal value is converted.

+  @retval RETURN_BUFFER_TOO_SMALL  If BufferSize cannot hold the converted

+                                   value.

+  @retval RETURN_INVALID_PARAMETER If Buffer is NULL.

+                                   If Increment is 1 and

+                                   PcdMaximumAsciiStringLength is not zero,

+                                   BufferSize is greater than

+                                   PcdMaximumAsciiStringLength.

+                                   If Increment is not 1 and

+                                   PcdMaximumUnicodeStringLength is not zero,

+                                   BufferSize is greater than

+                                   (PcdMaximumUnicodeStringLength *

+                                   sizeof (CHAR16) + 1).

+                                   If unsupported bits are set in Flags.

+                                   If both COMMA_TYPE and RADIX_HEX are set in

+                                   Flags.

+                                   If Width >= MAXIMUM_VALUE_CHARACTERS.

+

+**/

+RETURN_STATUS

+BasePrintLibConvertValueToStringS (

+  IN OUT CHAR8   *Buffer,

+  IN UINTN       BufferSize,

+  IN UINTN       Flags,

+  IN INT64       Value,

+  IN UINTN       Width,

+  IN UINTN       Increment

+  );

+

+#endif

diff --git a/debugging_demo/memtest86+/efi/Include/src/MemoryAllocationLib.c b/debugging_demo/memtest86+/efi/Include/src/MemoryAllocationLib.c
new file mode 100644
index 0000000..554b6a7
--- /dev/null
+++ b/debugging_demo/memtest86+/efi/Include/src/MemoryAllocationLib.c
@@ -0,0 +1,815 @@
+/** @file

+  Support routines for memory allocation routines based

+  on boot services for Dxe phase drivers.

+

+  Copyright (c) 2006 - 2018, Intel Corporation. All rights reserved.<BR>

+  SPDX-License-Identifier: BSD-2-Clause-Patent

+

+**/

+

+

+#include <Uefi.h>

+

+

+#include <Library/MemoryAllocationLib.h>

+#include <Library/UefiBootServicesTableLib.h>

+#include <Library/BaseMemoryLib.h>

+#include <Library/DebugLib.h>

+

+/**

+  Allocates one or more 4KB pages of a certain memory type.

+

+  Allocates the number of 4KB pages of a certain memory type and returns a pointer to the allocated

+  buffer.  The buffer returned is aligned on a 4KB boundary.  If Pages is 0, then NULL is returned.

+  If there is not enough memory remaining to satisfy the request, then NULL is returned.

+

+  @param  MemoryType            The type of memory to allocate.

+  @param  Pages                 The number of 4 KB pages to allocate.

+

+  @return A pointer to the allocated buffer or NULL if allocation fails.

+

+**/

+VOID *

+InternalAllocatePages (

+  IN EFI_MEMORY_TYPE  MemoryType,

+  IN UINTN            Pages

+  )

+{

+  EFI_STATUS            Status;

+  EFI_PHYSICAL_ADDRESS  Memory;

+

+  if (Pages == 0) {

+    return NULL;

+  }

+

+  Status = gBS->AllocatePages (AllocateAnyPages, MemoryType, Pages, &Memory);

+  if (EFI_ERROR (Status)) {

+    return NULL;

+  }

+  return (VOID *) (UINTN) Memory;

+}

+

+/**

+  Allocates one or more 4KB pages of type EfiBootServicesData.

+

+  Allocates the number of 4KB pages of type EfiBootServicesData and returns a pointer to the

+  allocated buffer.  The buffer returned is aligned on a 4KB boundary.  If Pages is 0, then NULL

+  is returned.  If there is not enough memory remaining to satisfy the request, then NULL is

+  returned.

+

+  @param  Pages                 The number of 4 KB pages to allocate.

+

+  @return A pointer to the allocated buffer or NULL if allocation fails.

+

+**/

+VOID *

+EFIAPI

+AllocatePages (

+  IN UINTN  Pages

+  )

+{

+  return InternalAllocatePages (EfiBootServicesData, Pages);

+}

+

+/**

+  Allocates one or more 4KB pages of type EfiRuntimeServicesData.

+

+  Allocates the number of 4KB pages of type EfiRuntimeServicesData and returns a pointer to the

+  allocated buffer.  The buffer returned is aligned on a 4KB boundary.  If Pages is 0, then NULL

+  is returned.  If there is not enough memory remaining to satisfy the request, then NULL is

+  returned.

+

+  @param  Pages                 The number of 4 KB pages to allocate.

+

+  @return A pointer to the allocated buffer or NULL if allocation fails.

+

+**/

+VOID *

+EFIAPI

+AllocateRuntimePages (

+  IN UINTN  Pages

+  )

+{

+  return InternalAllocatePages (EfiRuntimeServicesData, Pages);

+}

+

+/**

+  Allocates one or more 4KB pages of type EfiReservedMemoryType.

+

+  Allocates the number of 4KB pages of type EfiReservedMemoryType and returns a pointer to the

+  allocated buffer.  The buffer returned is aligned on a 4KB boundary.  If Pages is 0, then NULL

+  is returned.  If there is not enough memory remaining to satisfy the request, then NULL is

+  returned.

+

+  @param  Pages                 The number of 4 KB pages to allocate.

+

+  @return A pointer to the allocated buffer or NULL if allocation fails.

+

+**/

+VOID *

+EFIAPI

+AllocateReservedPages (

+  IN UINTN  Pages

+  )

+{

+  return InternalAllocatePages (EfiReservedMemoryType, Pages);

+}

+

+/**

+  Frees one or more 4KB pages that were previously allocated with one of the page allocation

+  functions in the Memory Allocation Library.

+

+  Frees the number of 4KB pages specified by Pages from the buffer specified by Buffer.  Buffer

+  must have been allocated on a previous call to the page allocation services of the Memory

+  Allocation Library.  If it is not possible to free allocated pages, then this function will

+  perform no actions.

+

+  If Buffer was not allocated with a page allocation function in the Memory Allocation Library,

+  then ASSERT().

+  If Pages is zero, then ASSERT().

+

+  @param  Buffer                The pointer to the buffer of pages to free.

+  @param  Pages                 The number of 4 KB pages to free.

+

+**/

+VOID

+EFIAPI

+FreePages (

+  IN VOID   *Buffer,

+  IN UINTN  Pages

+  )

+{

+  EFI_STATUS  Status;

+

+  ASSERT (Pages != 0);

+  Status = gBS->FreePages ((EFI_PHYSICAL_ADDRESS) (UINTN) Buffer, Pages);

+  ASSERT_EFI_ERROR (Status);

+}

+

+/**

+  Allocates one or more 4KB pages of a certain memory type at a specified alignment.

+

+  Allocates the number of 4KB pages specified by Pages of a certain memory type with an alignment

+  specified by Alignment.  The allocated buffer is returned.  If Pages is 0, then NULL is returned.

+  If there is not enough memory at the specified alignment remaining to satisfy the request, then

+  NULL is returned.

+  If Alignment is not a power of two and Alignment is not zero, then ASSERT().

+  If Pages plus EFI_SIZE_TO_PAGES (Alignment) overflows, then ASSERT().

+

+  @param  MemoryType            The type of memory to allocate.

+  @param  Pages                 The number of 4 KB pages to allocate.

+  @param  Alignment             The requested alignment of the allocation.  Must be a power of two.

+                                If Alignment is zero, then byte alignment is used.

+

+  @return A pointer to the allocated buffer or NULL if allocation fails.

+

+**/

+VOID *

+InternalAllocateAlignedPages (

+  IN EFI_MEMORY_TYPE  MemoryType,

+  IN UINTN            Pages,

+  IN UINTN            Alignment

+  )

+{

+  EFI_STATUS            Status;

+  EFI_PHYSICAL_ADDRESS  Memory;

+  UINTN                 AlignedMemory;

+  UINTN                 AlignmentMask;

+  UINTN                 UnalignedPages;

+  UINTN                 RealPages;

+

+  //

+  // Alignment must be a power of two or zero.

+  //

+  ASSERT ((Alignment & (Alignment - 1)) == 0);

+

+  if (Pages == 0) {

+    return NULL;

+  }

+  if (Alignment > EFI_PAGE_SIZE) {

+    //

+    // Calculate the total number of pages since alignment is larger than page size.

+    //

+    AlignmentMask  = Alignment - 1;

+    RealPages      = Pages + EFI_SIZE_TO_PAGES (Alignment);

+    //

+    // Make sure that Pages plus EFI_SIZE_TO_PAGES (Alignment) does not overflow.

+    //

+    ASSERT (RealPages > Pages);

+

+    Status         = gBS->AllocatePages (AllocateAnyPages, MemoryType, RealPages, &Memory);

+    if (EFI_ERROR (Status)) {

+      return NULL;

+    }

+    AlignedMemory  = ((UINTN) Memory + AlignmentMask) & ~AlignmentMask;

+    UnalignedPages = EFI_SIZE_TO_PAGES (AlignedMemory - (UINTN) Memory);

+    if (UnalignedPages > 0) {

+      //

+      // Free first unaligned page(s).

+      //

+      Status = gBS->FreePages (Memory, UnalignedPages);

+      ASSERT_EFI_ERROR (Status);

+    }

+    Memory         = AlignedMemory + EFI_PAGES_TO_SIZE (Pages);

+    UnalignedPages = RealPages - Pages - UnalignedPages;

+    if (UnalignedPages > 0) {

+      //

+      // Free last unaligned page(s).

+      //

+      Status = gBS->FreePages (Memory, UnalignedPages);

+      ASSERT_EFI_ERROR (Status);

+    }

+  } else {

+    //

+    // Do not over-allocate pages in this case.

+    //

+    Status = gBS->AllocatePages (AllocateAnyPages, MemoryType, Pages, &Memory);

+    if (EFI_ERROR (Status)) {

+      return NULL;

+    }

+    AlignedMemory  = (UINTN) Memory;

+  }

+  return (VOID *) AlignedMemory;

+}

+

+/**

+  Allocates one or more 4KB pages of type EfiBootServicesData at a specified alignment.

+

+  Allocates the number of 4KB pages specified by Pages of type EfiBootServicesData with an

+  alignment specified by Alignment.  The allocated buffer is returned.  If Pages is 0, then NULL is

+  returned.  If there is not enough memory at the specified alignment remaining to satisfy the

+  request, then NULL is returned.

+

+  If Alignment is not a power of two and Alignment is not zero, then ASSERT().

+  If Pages plus EFI_SIZE_TO_PAGES (Alignment) overflows, then ASSERT().

+

+  @param  Pages                 The number of 4 KB pages to allocate.

+  @param  Alignment             The requested alignment of the allocation.  Must be a power of two.

+                                If Alignment is zero, then byte alignment is used.

+

+  @return A pointer to the allocated buffer or NULL if allocation fails.

+

+**/

+VOID *

+EFIAPI

+AllocateAlignedPages (

+  IN UINTN  Pages,

+  IN UINTN  Alignment

+  )

+{

+  return InternalAllocateAlignedPages (EfiBootServicesData, Pages, Alignment);

+}

+

+/**

+  Allocates one or more 4KB pages of type EfiRuntimeServicesData at a specified alignment.

+

+  Allocates the number of 4KB pages specified by Pages of type EfiRuntimeServicesData with an

+  alignment specified by Alignment.  The allocated buffer is returned.  If Pages is 0, then NULL is

+  returned.  If there is not enough memory at the specified alignment remaining to satisfy the

+  request, then NULL is returned.

+

+  If Alignment is not a power of two and Alignment is not zero, then ASSERT().

+  If Pages plus EFI_SIZE_TO_PAGES (Alignment) overflows, then ASSERT().

+

+  @param  Pages                 The number of 4 KB pages to allocate.

+  @param  Alignment             The requested alignment of the allocation.  Must be a power of two.

+                                If Alignment is zero, then byte alignment is used.

+

+  @return A pointer to the allocated buffer or NULL if allocation fails.

+

+**/

+VOID *

+EFIAPI

+AllocateAlignedRuntimePages (

+  IN UINTN  Pages,

+  IN UINTN  Alignment

+  )

+{

+  return InternalAllocateAlignedPages (EfiRuntimeServicesData, Pages, Alignment);

+}

+

+/**

+  Allocates one or more 4KB pages of type EfiReservedMemoryType at a specified alignment.

+

+  Allocates the number of 4KB pages specified by Pages of type EfiReservedMemoryType with an

+  alignment specified by Alignment.  The allocated buffer is returned.  If Pages is 0, then NULL is

+  returned.  If there is not enough memory at the specified alignment remaining to satisfy the

+  request, then NULL is returned.

+

+  If Alignment is not a power of two and Alignment is not zero, then ASSERT().

+  If Pages plus EFI_SIZE_TO_PAGES (Alignment) overflows, then ASSERT().

+

+  @param  Pages                 The number of 4 KB pages to allocate.

+  @param  Alignment             The requested alignment of the allocation.  Must be a power of two.

+                                If Alignment is zero, then byte alignment is used.

+

+  @return A pointer to the allocated buffer or NULL if allocation fails.

+

+**/

+VOID *

+EFIAPI

+AllocateAlignedReservedPages (

+  IN UINTN  Pages,

+  IN UINTN  Alignment

+  )

+{

+  return InternalAllocateAlignedPages (EfiReservedMemoryType, Pages, Alignment);

+}

+

+/**

+  Frees one or more 4KB pages that were previously allocated with one of the aligned page

+  allocation functions in the Memory Allocation Library.

+

+  Frees the number of 4KB pages specified by Pages from the buffer specified by Buffer.  Buffer

+  must have been allocated on a previous call to the aligned page allocation services of the Memory

+  Allocation Library.  If it is not possible to free allocated pages, then this function will

+  perform no actions.

+

+  If Buffer was not allocated with an aligned page allocation function in the Memory Allocation

+  Library, then ASSERT().

+  If Pages is zero, then ASSERT().

+

+  @param  Buffer                The pointer to the buffer of pages to free.

+  @param  Pages                 The number of 4 KB pages to free.

+

+**/

+VOID

+EFIAPI

+FreeAlignedPages (

+  IN VOID   *Buffer,

+  IN UINTN  Pages

+  )

+{

+  EFI_STATUS  Status;

+

+  ASSERT (Pages != 0);

+  Status = gBS->FreePages ((EFI_PHYSICAL_ADDRESS) (UINTN) Buffer, Pages);

+  ASSERT_EFI_ERROR (Status);

+}

+

+/**

+  Allocates a buffer of a certain pool type.

+

+  Allocates the number bytes specified by AllocationSize of a certain pool type and returns a

+  pointer to the allocated buffer.  If AllocationSize is 0, then a valid buffer of 0 size is

+  returned.  If there is not enough memory remaining to satisfy the request, then NULL is returned.

+

+  @param  MemoryType            The type of memory to allocate.

+  @param  AllocationSize        The number of bytes to allocate.

+

+  @return A pointer to the allocated buffer or NULL if allocation fails.

+

+**/

+VOID *

+InternalAllocatePool (

+  IN EFI_MEMORY_TYPE  MemoryType,

+  IN UINTN            AllocationSize

+  )

+{

+  EFI_STATUS  Status;

+  VOID        *Memory;

+

+  Status = gBS->AllocatePool (MemoryType, AllocationSize, &Memory);

+  if (EFI_ERROR (Status)) {

+    Memory = NULL;

+  }

+  return Memory;

+}

+

+/**

+  Allocates a buffer of type EfiBootServicesData.

+

+  Allocates the number bytes specified by AllocationSize of type EfiBootServicesData and returns a

+  pointer to the allocated buffer.  If AllocationSize is 0, then a valid buffer of 0 size is

+  returned.  If there is not enough memory remaining to satisfy the request, then NULL is returned.

+

+  @param  AllocationSize        The number of bytes to allocate.

+

+  @return A pointer to the allocated buffer or NULL if allocation fails.

+

+**/

+VOID *

+EFIAPI

+AllocatePool (

+  IN UINTN  AllocationSize

+  )

+{

+  return InternalAllocatePool (EfiBootServicesData, AllocationSize);

+}

+

+/**

+  Allocates a buffer of type EfiRuntimeServicesData.

+

+  Allocates the number bytes specified by AllocationSize of type EfiRuntimeServicesData and returns

+  a pointer to the allocated buffer.  If AllocationSize is 0, then a valid buffer of 0 size is

+  returned.  If there is not enough memory remaining to satisfy the request, then NULL is returned.

+

+  @param  AllocationSize        The number of bytes to allocate.

+

+  @return A pointer to the allocated buffer or NULL if allocation fails.

+

+**/

+VOID *

+EFIAPI

+AllocateRuntimePool (

+  IN UINTN  AllocationSize

+  )

+{

+  return InternalAllocatePool (EfiRuntimeServicesData, AllocationSize);

+}

+

+/**

+  Allocates a buffer of type EfiReservedMemoryType.

+

+  Allocates the number bytes specified by AllocationSize of type EfiReservedMemoryType and returns

+  a pointer to the allocated buffer.  If AllocationSize is 0, then a valid buffer of 0 size is

+  returned.  If there is not enough memory remaining to satisfy the request, then NULL is returned.

+

+  @param  AllocationSize        The number of bytes to allocate.

+

+  @return A pointer to the allocated buffer or NULL if allocation fails.

+

+**/

+VOID *

+EFIAPI

+AllocateReservedPool (

+  IN UINTN  AllocationSize

+  )

+{

+  return InternalAllocatePool (EfiReservedMemoryType, AllocationSize);

+}

+

+/**

+  Allocates and zeros a buffer of a certain pool type.

+

+  Allocates the number bytes specified by AllocationSize of a certain pool type, clears the buffer

+  with zeros, and returns a pointer to the allocated buffer.  If AllocationSize is 0, then a valid

+  buffer of 0 size is returned.  If there is not enough memory remaining to satisfy the request,

+  then NULL is returned.

+

+  @param  PoolType              The type of memory to allocate.

+  @param  AllocationSize        The number of bytes to allocate and zero.

+

+  @return A pointer to the allocated buffer or NULL if allocation fails.

+

+**/

+VOID *

+InternalAllocateZeroPool (

+  IN EFI_MEMORY_TYPE  PoolType,

+  IN UINTN            AllocationSize

+  )

+{

+  VOID  *Memory;

+

+  Memory = InternalAllocatePool (PoolType, AllocationSize);

+  if (Memory != NULL) {

+    Memory = ZeroMem (Memory, AllocationSize);

+  }

+  return Memory;

+}

+

+/**

+  Allocates and zeros a buffer of type EfiBootServicesData.

+

+  Allocates the number bytes specified by AllocationSize of type EfiBootServicesData, clears the

+  buffer with zeros, and returns a pointer to the allocated buffer.  If AllocationSize is 0, then a

+  valid buffer of 0 size is returned.  If there is not enough memory remaining to satisfy the

+  request, then NULL is returned.

+

+  @param  AllocationSize        The number of bytes to allocate and zero.

+

+  @return A pointer to the allocated buffer or NULL if allocation fails.

+

+**/

+VOID *

+EFIAPI

+AllocateZeroPool (

+  IN UINTN  AllocationSize

+  )

+{

+  return InternalAllocateZeroPool (EfiBootServicesData, AllocationSize);

+}

+

+/**

+  Allocates and zeros a buffer of type EfiRuntimeServicesData.

+

+  Allocates the number bytes specified by AllocationSize of type EfiRuntimeServicesData, clears the

+  buffer with zeros, and returns a pointer to the allocated buffer.  If AllocationSize is 0, then a

+  valid buffer of 0 size is returned.  If there is not enough memory remaining to satisfy the

+  request, then NULL is returned.

+

+  @param  AllocationSize        The number of bytes to allocate and zero.

+

+  @return A pointer to the allocated buffer or NULL if allocation fails.

+

+**/

+VOID *

+EFIAPI

+AllocateRuntimeZeroPool (

+  IN UINTN  AllocationSize

+  )

+{

+  return InternalAllocateZeroPool (EfiRuntimeServicesData, AllocationSize);

+}

+

+/**

+  Allocates and zeros a buffer of type EfiReservedMemoryType.

+

+  Allocates the number bytes specified by AllocationSize of type EfiReservedMemoryType, clears the

+  buffer with zeros, and returns a pointer to the allocated buffer.  If AllocationSize is 0, then a

+  valid buffer of 0 size is returned.  If there is not enough memory remaining to satisfy the

+  request, then NULL is returned.

+

+  @param  AllocationSize        The number of bytes to allocate and zero.

+

+  @return A pointer to the allocated buffer or NULL if allocation fails.

+

+**/

+VOID *

+EFIAPI

+AllocateReservedZeroPool (

+  IN UINTN  AllocationSize

+  )

+{

+  return InternalAllocateZeroPool (EfiReservedMemoryType, AllocationSize);

+}

+

+/**

+  Copies a buffer to an allocated buffer of a certain pool type.

+

+  Allocates the number bytes specified by AllocationSize of a certain pool type, copies

+  AllocationSize bytes from Buffer to the newly allocated buffer, and returns a pointer to the

+  allocated buffer.  If AllocationSize is 0, then a valid buffer of 0 size is returned.  If there

+  is not enough memory remaining to satisfy the request, then NULL is returned.

+  If Buffer is NULL, then ASSERT().

+  If AllocationSize is greater than (MAX_ADDRESS - Buffer + 1), then ASSERT().

+

+  @param  PoolType              The type of pool to allocate.

+  @param  AllocationSize        The number of bytes to allocate and zero.

+  @param  Buffer                The buffer to copy to the allocated buffer.

+

+  @return A pointer to the allocated buffer or NULL if allocation fails.

+

+**/

+VOID *

+InternalAllocateCopyPool (

+  IN EFI_MEMORY_TYPE  PoolType,

+  IN UINTN            AllocationSize,

+  IN CONST VOID       *Buffer

+  )

+{

+  VOID  *Memory;

+

+  ASSERT (Buffer != NULL);

+  ASSERT (AllocationSize <= (MAX_ADDRESS - (UINTN) Buffer + 1));

+

+  Memory = InternalAllocatePool (PoolType, AllocationSize);

+  if (Memory != NULL) {

+     Memory = CopyMem (Memory, Buffer, AllocationSize);

+  }

+  return Memory;

+}

+

+/**

+  Copies a buffer to an allocated buffer of type EfiBootServicesData.

+

+  Allocates the number bytes specified by AllocationSize of type EfiBootServicesData, copies

+  AllocationSize bytes from Buffer to the newly allocated buffer, and returns a pointer to the

+  allocated buffer.  If AllocationSize is 0, then a valid buffer of 0 size is returned.  If there

+  is not enough memory remaining to satisfy the request, then NULL is returned.

+

+  If Buffer is NULL, then ASSERT().

+  If AllocationSize is greater than (MAX_ADDRESS - Buffer + 1), then ASSERT().

+

+  @param  AllocationSize        The number of bytes to allocate and zero.

+  @param  Buffer                The buffer to copy to the allocated buffer.

+

+  @return A pointer to the allocated buffer or NULL if allocation fails.

+

+**/

+VOID *

+EFIAPI

+AllocateCopyPool (

+  IN UINTN       AllocationSize,

+  IN CONST VOID  *Buffer

+  )

+{

+  return InternalAllocateCopyPool (EfiBootServicesData, AllocationSize, Buffer);

+}

+

+/**

+  Copies a buffer to an allocated buffer of type EfiRuntimeServicesData.

+

+  Allocates the number bytes specified by AllocationSize of type EfiRuntimeServicesData, copies

+  AllocationSize bytes from Buffer to the newly allocated buffer, and returns a pointer to the

+  allocated buffer.  If AllocationSize is 0, then a valid buffer of 0 size is returned.  If there

+  is not enough memory remaining to satisfy the request, then NULL is returned.

+

+  If Buffer is NULL, then ASSERT().

+  If AllocationSize is greater than (MAX_ADDRESS - Buffer + 1), then ASSERT().

+

+  @param  AllocationSize        The number of bytes to allocate and zero.

+  @param  Buffer                The buffer to copy to the allocated buffer.

+

+  @return A pointer to the allocated buffer or NULL if allocation fails.

+

+**/

+VOID *

+EFIAPI

+AllocateRuntimeCopyPool (

+  IN UINTN       AllocationSize,

+  IN CONST VOID  *Buffer

+  )

+{

+  return InternalAllocateCopyPool (EfiRuntimeServicesData, AllocationSize, Buffer);

+}

+

+/**

+  Copies a buffer to an allocated buffer of type EfiReservedMemoryType.

+

+  Allocates the number bytes specified by AllocationSize of type EfiReservedMemoryType, copies

+  AllocationSize bytes from Buffer to the newly allocated buffer, and returns a pointer to the

+  allocated buffer.  If AllocationSize is 0, then a valid buffer of 0 size is returned.  If there

+  is not enough memory remaining to satisfy the request, then NULL is returned.

+

+  If Buffer is NULL, then ASSERT().

+  If AllocationSize is greater than (MAX_ADDRESS - Buffer + 1), then ASSERT().

+

+  @param  AllocationSize        The number of bytes to allocate and zero.

+  @param  Buffer                The buffer to copy to the allocated buffer.

+

+  @return A pointer to the allocated buffer or NULL if allocation fails.

+

+**/

+VOID *

+EFIAPI

+AllocateReservedCopyPool (

+  IN UINTN       AllocationSize,

+  IN CONST VOID  *Buffer

+  )

+{

+  return InternalAllocateCopyPool (EfiReservedMemoryType, AllocationSize, Buffer);

+}

+

+/**

+  Reallocates a buffer of a specified memory type.

+

+  Allocates and zeros the number bytes specified by NewSize from memory of the type

+  specified by PoolType.  If OldBuffer is not NULL, then the smaller of OldSize and

+  NewSize bytes are copied from OldBuffer to the newly allocated buffer, and

+  OldBuffer is freed.  A pointer to the newly allocated buffer is returned.

+  If NewSize is 0, then a valid buffer of 0 size is  returned.  If there is not

+  enough memory remaining to satisfy the request, then NULL is returned.

+

+  If the allocation of the new buffer is successful and the smaller of NewSize and OldSize

+  is greater than (MAX_ADDRESS - OldBuffer + 1), then ASSERT().

+

+  @param  PoolType       The type of pool to allocate.

+  @param  OldSize        The size, in bytes, of OldBuffer.

+  @param  NewSize        The size, in bytes, of the buffer to reallocate.

+  @param  OldBuffer      The buffer to copy to the allocated buffer.  This is an optional

+                         parameter that may be NULL.

+

+  @return A pointer to the allocated buffer or NULL if allocation fails.

+

+**/

+VOID *

+InternalReallocatePool (

+  IN EFI_MEMORY_TYPE  PoolType,

+  IN UINTN            OldSize,

+  IN UINTN            NewSize,

+  IN VOID             *OldBuffer  OPTIONAL

+  )

+{

+  VOID  *NewBuffer;

+

+  NewBuffer = InternalAllocateZeroPool (PoolType, NewSize);

+  if (NewBuffer != NULL && OldBuffer != NULL) {

+    CopyMem (NewBuffer, OldBuffer, MIN (OldSize, NewSize));

+    FreePool (OldBuffer);

+  }

+  return NewBuffer;

+}

+

+/**

+  Reallocates a buffer of type EfiBootServicesData.

+

+  Allocates and zeros the number bytes specified by NewSize from memory of type

+  EfiBootServicesData.  If OldBuffer is not NULL, then the smaller of OldSize and

+  NewSize bytes are copied from OldBuffer to the newly allocated buffer, and

+  OldBuffer is freed.  A pointer to the newly allocated buffer is returned.

+  If NewSize is 0, then a valid buffer of 0 size is  returned.  If there is not

+  enough memory remaining to satisfy the request, then NULL is returned.

+

+  If the allocation of the new buffer is successful and the smaller of NewSize and OldSize

+  is greater than (MAX_ADDRESS - OldBuffer + 1), then ASSERT().

+

+  @param  OldSize        The size, in bytes, of OldBuffer.

+  @param  NewSize        The size, in bytes, of the buffer to reallocate.

+  @param  OldBuffer      The buffer to copy to the allocated buffer.  This is an optional

+                         parameter that may be NULL.

+

+  @return A pointer to the allocated buffer or NULL if allocation fails.

+

+**/

+VOID *

+EFIAPI

+ReallocatePool (

+  IN UINTN  OldSize,

+  IN UINTN  NewSize,

+  IN VOID   *OldBuffer  OPTIONAL

+  )

+{

+  return InternalReallocatePool (EfiBootServicesData, OldSize, NewSize, OldBuffer);

+}

+

+/**

+  Reallocates a buffer of type EfiRuntimeServicesData.

+

+  Allocates and zeros the number bytes specified by NewSize from memory of type

+  EfiRuntimeServicesData.  If OldBuffer is not NULL, then the smaller of OldSize and

+  NewSize bytes are copied from OldBuffer to the newly allocated buffer, and

+  OldBuffer is freed.  A pointer to the newly allocated buffer is returned.

+  If NewSize is 0, then a valid buffer of 0 size is  returned.  If there is not

+  enough memory remaining to satisfy the request, then NULL is returned.

+

+  If the allocation of the new buffer is successful and the smaller of NewSize and OldSize

+  is greater than (MAX_ADDRESS - OldBuffer + 1), then ASSERT().

+

+  @param  OldSize        The size, in bytes, of OldBuffer.

+  @param  NewSize        The size, in bytes, of the buffer to reallocate.

+  @param  OldBuffer      The buffer to copy to the allocated buffer.  This is an optional

+                         parameter that may be NULL.

+

+  @return A pointer to the allocated buffer or NULL if allocation fails.

+

+**/

+VOID *

+EFIAPI

+ReallocateRuntimePool (

+  IN UINTN  OldSize,

+  IN UINTN  NewSize,

+  IN VOID   *OldBuffer  OPTIONAL

+  )

+{

+  return InternalReallocatePool (EfiRuntimeServicesData, OldSize, NewSize, OldBuffer);

+}

+

+/**

+  Reallocates a buffer of type EfiReservedMemoryType.

+

+  Allocates and zeros the number bytes specified by NewSize from memory of type

+  EfiReservedMemoryType.  If OldBuffer is not NULL, then the smaller of OldSize and

+  NewSize bytes are copied from OldBuffer to the newly allocated buffer, and

+  OldBuffer is freed.  A pointer to the newly allocated buffer is returned.

+  If NewSize is 0, then a valid buffer of 0 size is  returned.  If there is not

+  enough memory remaining to satisfy the request, then NULL is returned.

+

+  If the allocation of the new buffer is successful and the smaller of NewSize and OldSize

+  is greater than (MAX_ADDRESS - OldBuffer + 1), then ASSERT().

+

+  @param  OldSize        The size, in bytes, of OldBuffer.

+  @param  NewSize        The size, in bytes, of the buffer to reallocate.

+  @param  OldBuffer      The buffer to copy to the allocated buffer.  This is an optional

+                         parameter that may be NULL.

+

+  @return A pointer to the allocated buffer or NULL if allocation fails.

+

+**/

+VOID *

+EFIAPI

+ReallocateReservedPool (

+  IN UINTN  OldSize,

+  IN UINTN  NewSize,

+  IN VOID   *OldBuffer  OPTIONAL

+  )

+{

+  return InternalReallocatePool (EfiReservedMemoryType, OldSize, NewSize, OldBuffer);

+}

+

+/**

+  Frees a buffer that was previously allocated with one of the pool allocation functions in the

+  Memory Allocation Library.

+

+  Frees the buffer specified by Buffer.  Buffer must have been allocated on a previous call to the

+  pool allocation services of the Memory Allocation Library.  If it is not possible to free pool

+  resources, then this function will perform no actions.

+

+  If Buffer was not allocated with a pool allocation function in the Memory Allocation Library,

+  then ASSERT().

+

+  @param  Buffer                The pointer to the buffer to free.

+

+**/

+VOID

+EFIAPI

+FreePool (

+  IN VOID   *Buffer

+  )

+{

+  EFI_STATUS    Status;

+

+  Status = gBS->FreePool (Buffer);

+  ASSERT_EFI_ERROR (Status);

+}

+

diff --git a/debugging_demo/memtest86+/efi/Include/src/PcdLib.c b/debugging_demo/memtest86+/efi/Include/src/PcdLib.c
new file mode 100644
index 0000000..265fae5
--- /dev/null
+++ b/debugging_demo/memtest86+/efi/Include/src/PcdLib.c
@@ -0,0 +1,1113 @@
+/** @file

+  A emptry template implementation of PCD Library.

+

+  Copyright (c) 2006 - 2018, Intel Corporation. All rights reserved.<BR>

+  SPDX-License-Identifier: BSD-2-Clause-Patent

+

+**/

+

+#include <Base.h>

+

+#include <Library/DebugLib.h>

+#include <Library/PcdLib.h>

+#include <Library/BaseMemoryLib.h>

+

+

+/**

+  This function provides a means by which SKU support can be established in the PCD infrastructure.

+

+  Sets the current SKU in the PCD database to the value specified by SkuId.  SkuId is returned.

+

+  @param[in]  SkuId The SKU value that will be used when the PCD service will retrieve and

+                    set values associated with a PCD token.

+

+  @return Return the SKU ID that just be set.

+

+**/

+UINTN

+EFIAPI

+LibPcdSetSku (

+  IN UINTN   SkuId

+  )

+{

+  ASSERT (FALSE);

+

+  return 0;

+}

+

+/**

+  This function provides a means by which to retrieve a value for a given PCD token.

+

+  Returns the 8-bit value for the token specified by TokenNumber.

+

+  @param[in]  TokenNumber The PCD token number to retrieve a current value for.

+

+  @return Returns the 8-bit value for the token specified by TokenNumber.

+

+**/

+UINT8

+EFIAPI

+LibPcdGet8 (

+  IN UINTN             TokenNumber

+  )

+{

+  ASSERT (FALSE);

+

+  return 0;

+}

+

+

+

+/**

+  This function provides a means by which to retrieve a value for a given PCD token.

+

+  Returns the 16-bit value for the token specified by TokenNumber.

+

+  @param[in]  TokenNumber The PCD token number to retrieve a current value for.

+

+  @return Returns the 16-bit value for the token specified by TokenNumber.

+

+**/

+UINT16

+EFIAPI

+LibPcdGet16 (

+  IN UINTN             TokenNumber

+  )

+{

+  ASSERT (FALSE);

+

+  return 0;

+}

+

+

+

+/**

+  This function provides a means by which to retrieve a value for a given PCD token.

+

+  Returns the 32-bit value for the token specified by TokenNumber.

+

+  @param[in]  TokenNumber The PCD token number to retrieve a current value for.

+

+  @return Returns the 32-bit value for the token specified by TokenNumber.

+

+**/

+UINT32

+EFIAPI

+LibPcdGet32 (

+  IN UINTN             TokenNumber

+  )

+{

+  ASSERT (FALSE);

+

+  return 0;

+}

+

+

+

+/**

+  This function provides a means by which to retrieve a value for a given PCD token.

+

+  Returns the 64-bit value for the token specified by TokenNumber.

+

+  @param[in]  TokenNumber The PCD token number to retrieve a current value for.

+

+  @return Returns the 64-bit value for the token specified by TokenNumber.

+

+**/

+UINT64

+EFIAPI

+LibPcdGet64 (

+  IN UINTN             TokenNumber

+  )

+{

+  ASSERT (FALSE);

+

+  return 0;

+}

+

+

+

+/**

+  This function provides a means by which to retrieve a value for a given PCD token.

+

+  Returns the pointer to the buffer of the token specified by TokenNumber.

+

+  @param[in]  TokenNumber The PCD token number to retrieve a current value for.

+

+  @return Returns the pointer to the token specified by TokenNumber.

+

+**/

+VOID *

+EFIAPI

+LibPcdGetPtr (

+  IN UINTN             TokenNumber

+  )

+{

+  ASSERT (FALSE);

+

+  return 0;

+}

+

+

+

+/**

+  This function provides a means by which to retrieve a value for a given PCD token.

+

+  Returns the Boolean value of the token specified by TokenNumber.

+

+  @param[in]  TokenNumber The PCD token number to retrieve a current value for.

+

+  @return Returns the Boolean value of the token specified by TokenNumber.

+

+**/

+BOOLEAN

+EFIAPI

+LibPcdGetBool (

+  IN UINTN             TokenNumber

+  )

+{

+  ASSERT (FALSE);

+

+  return 0;

+}

+

+

+

+/**

+  This function provides a means by which to retrieve the size of a given PCD token.

+

+  @param[in]  TokenNumber The PCD token number to retrieve a current value for.

+

+  @return Returns the size of the token specified by TokenNumber.

+

+**/

+UINTN

+EFIAPI

+LibPcdGetSize (

+  IN UINTN             TokenNumber

+  )

+{

+  ASSERT (FALSE);

+

+  return 0;

+}

+

+

+

+/**

+  This function provides a means by which to retrieve a value for a given PCD token.

+

+  Returns the 8-bit value for the token specified by TokenNumber and Guid.

+

+  If Guid is NULL, then ASSERT().

+

+  @param[in]  Guid The pointer to a 128-bit unique value that designates

+              which namespace to retrieve a value from.

+  @param[in]  TokenNumber The PCD token number to retrieve a current value for.

+

+  @return Return the UINT8.

+

+**/

+UINT8

+EFIAPI

+LibPcdGetEx8 (

+  IN CONST GUID        *Guid,

+  IN UINTN             TokenNumber

+  )

+{

+  ASSERT (FALSE);

+

+  return 0;

+}

+

+

+

+/**

+  This function provides a means by which to retrieve a value for a given PCD token.

+

+  Returns the 16-bit value for the token specified by TokenNumber and Guid.

+

+  If Guid is NULL, then ASSERT().

+

+  @param[in]  Guid The pointer to a 128-bit unique value that designates

+              which namespace to retrieve a value from.

+  @param[in]  TokenNumber The PCD token number to retrieve a current value for.

+

+  @return Return the UINT16.

+

+**/

+UINT16

+EFIAPI

+LibPcdGetEx16 (

+  IN CONST GUID        *Guid,

+  IN UINTN             TokenNumber

+  )

+{

+  ASSERT (FALSE);

+

+  return 0;

+}

+

+

+

+/**

+  Returns the 32-bit value for the token specified by TokenNumber and Guid.

+  If Guid is NULL, then ASSERT().

+

+  @param[in]  Guid The pointer to a 128-bit unique value that designates

+              which namespace to retrieve a value from.

+  @param[in]  TokenNumber The PCD token number to retrieve a current value for.

+

+  @return Return the UINT32.

+

+**/

+UINT32

+EFIAPI

+LibPcdGetEx32 (

+  IN CONST GUID        *Guid,

+  IN UINTN             TokenNumber

+  )

+{

+  ASSERT (FALSE);

+

+  return 0;

+}

+

+

+

+/**

+  This function provides a means by which to retrieve a value for a given PCD token.

+

+  Returns the 64-bit value for the token specified by TokenNumber and Guid.

+

+  If Guid is NULL, then ASSERT().

+

+  @param[in]  Guid          The pointer to a 128-bit unique value that designates

+                            which namespace to retrieve a value from.

+  @param[in]  TokenNumber   The PCD token number to retrieve a current value for.

+

+  @return Return the UINT64.

+

+**/

+UINT64

+EFIAPI

+LibPcdGetEx64 (

+  IN CONST GUID        *Guid,

+  IN UINTN             TokenNumber

+  )

+{

+  ASSERT (FALSE);

+

+  return 0;

+}

+

+

+

+/**

+  This function provides a means by which to retrieve a value for a given PCD token.

+

+  Returns the pointer to the buffer of token specified by TokenNumber and Guid.

+

+  If Guid is NULL, then ASSERT().

+

+  @param[in]  Guid          The pointer to a 128-bit unique value that designates

+                            which namespace to retrieve a value from.

+  @param[in]  TokenNumber   The PCD token number to retrieve a current value for.

+

+  @return Return the VOID* pointer.

+

+**/

+VOID *

+EFIAPI

+LibPcdGetExPtr (

+  IN CONST GUID        *Guid,

+  IN UINTN             TokenNumber

+  )

+{

+  ASSERT (FALSE);

+

+  return 0;

+}

+

+

+

+/**

+  This function provides a means by which to retrieve a value for a given PCD token.

+

+  Returns the Boolean value of the token specified by TokenNumber and Guid.

+

+  If Guid is NULL, then ASSERT().

+

+  @param[in]  Guid          The pointer to a 128-bit unique value that designates

+                            which namespace to retrieve a value from.

+  @param[in]  TokenNumber   The PCD token number to retrieve a current value for.

+

+  @return Return the BOOLEAN.

+

+**/

+BOOLEAN

+EFIAPI

+LibPcdGetExBool (

+  IN CONST GUID        *Guid,

+  IN UINTN             TokenNumber

+  )

+{

+  ASSERT (FALSE);

+

+  return 0;

+}

+

+

+

+/**

+  This function provides a means by which to retrieve the size of a given PCD token.

+

+  Returns the size of the token specified by TokenNumber and Guid.

+

+  If Guid is NULL, then ASSERT().

+

+  @param[in]  Guid          The pointer to a 128-bit unique value that designates

+                            which namespace to retrieve a value from.

+  @param[in]  TokenNumber   The PCD token number to retrieve a current value for.

+

+  @return Return the size.

+

+**/

+UINTN

+EFIAPI

+LibPcdGetExSize (

+  IN CONST GUID        *Guid,

+  IN UINTN             TokenNumber

+  )

+{

+  ASSERT (FALSE);

+

+  return 0;

+}

+

+

+/**

+  This function provides a means by which to set a value for a given PCD token.

+

+  Sets the 8-bit value for the token specified by TokenNumber

+  to the value specified by Value.

+

+  @param[in] TokenNumber    The PCD token number to set a current value for.

+  @param[in] Value          The 8-bit value to set.

+

+  @return The status of the set operation.

+

+**/

+RETURN_STATUS

+EFIAPI

+LibPcdSet8S (

+  IN UINTN          TokenNumber,

+  IN UINT8          Value

+  )

+{

+  ASSERT (FALSE);

+

+  return RETURN_INVALID_PARAMETER;

+}

+

+/**

+  This function provides a means by which to set a value for a given PCD token.

+

+  Sets the 16-bit value for the token specified by TokenNumber

+  to the value specified by Value.

+

+  @param[in] TokenNumber    The PCD token number to set a current value for.

+  @param[in] Value          The 16-bit value to set.

+

+  @return The status of the set operation.

+

+**/

+RETURN_STATUS

+EFIAPI

+LibPcdSet16S (

+  IN UINTN          TokenNumber,

+  IN UINT16         Value

+  )

+{

+  ASSERT (FALSE);

+

+  return RETURN_INVALID_PARAMETER;

+}

+

+/**

+  This function provides a means by which to set a value for a given PCD token.

+

+  Sets the 32-bit value for the token specified by TokenNumber

+  to the value specified by Value.

+

+  @param[in] TokenNumber    The PCD token number to set a current value for.

+  @param[in] Value          The 32-bit value to set.

+

+  @return The status of the set operation.

+

+**/

+RETURN_STATUS

+EFIAPI

+LibPcdSet32S (

+  IN UINTN          TokenNumber,

+  IN UINT32         Value

+  )

+{

+  ASSERT (FALSE);

+

+  return RETURN_INVALID_PARAMETER;

+}

+

+/**

+  This function provides a means by which to set a value for a given PCD token.

+

+  Sets the 64-bit value for the token specified by TokenNumber

+  to the value specified by Value.

+

+  @param[in] TokenNumber    The PCD token number to set a current value for.

+  @param[in] Value          The 64-bit value to set.

+

+  @return The status of the set operation.

+

+**/

+RETURN_STATUS

+EFIAPI

+LibPcdSet64S (

+  IN UINTN          TokenNumber,

+  IN UINT64         Value

+  )

+{

+  ASSERT (FALSE);

+

+  return RETURN_INVALID_PARAMETER;

+}

+

+/**

+  This function provides a means by which to set a value for a given PCD token.

+

+  Sets a buffer for the token specified by TokenNumber to the value specified

+  by Buffer and SizeOfBuffer. If SizeOfBuffer is greater than the maximum size

+  support by TokenNumber, then set SizeOfBuffer to the maximum size supported by

+  TokenNumber and return EFI_INVALID_PARAMETER to indicate that the set operation

+  was not actually performed.

+

+  If SizeOfBuffer is set to MAX_ADDRESS, then SizeOfBuffer must be set to the

+  maximum size supported by TokenName and EFI_INVALID_PARAMETER must be returned.

+

+  If SizeOfBuffer is NULL, then ASSERT().

+  If SizeOfBuffer > 0 and Buffer is NULL, then ASSERT().

+

+  @param[in]      TokenNumber   The PCD token number to set a current value for.

+  @param[in, out] SizeOfBuffer  The size, in bytes, of Buffer.

+  @param[in]      Buffer        A pointer to the buffer to set.

+

+  @return The status of the set operation.

+

+**/

+RETURN_STATUS

+EFIAPI

+LibPcdSetPtrS (

+  IN       UINTN    TokenNumber,

+  IN OUT   UINTN    *SizeOfBuffer,

+  IN CONST VOID     *Buffer

+  )

+{

+  ASSERT (FALSE);

+

+  return RETURN_INVALID_PARAMETER;

+}

+

+/**

+  This function provides a means by which to set a value for a given PCD token.

+

+  Sets the boolean value for the token specified by TokenNumber

+  to the value specified by Value.

+

+  @param[in] TokenNumber    The PCD token number to set a current value for.

+  @param[in] Value          The boolean value to set.

+

+  @return The status of the set operation.

+

+**/

+RETURN_STATUS

+EFIAPI

+LibPcdSetBoolS (

+  IN UINTN          TokenNumber,

+  IN BOOLEAN        Value

+  )

+{

+  ASSERT (FALSE);

+

+  return RETURN_INVALID_PARAMETER;

+}

+

+/**

+  This function provides a means by which to set a value for a given PCD token.

+

+  Sets the 8-bit value for the token specified by TokenNumber

+  to the value specified by Value.

+

+  If Guid is NULL, then ASSERT().

+

+  @param[in] Guid           The pointer to a 128-bit unique value that

+                            designates which namespace to set a value from.

+  @param[in] TokenNumber    The PCD token number to set a current value for.

+  @param[in] Value          The 8-bit value to set.

+

+  @return The status of the set operation.

+

+**/

+RETURN_STATUS

+EFIAPI

+LibPcdSetEx8S (

+  IN CONST GUID     *Guid,

+  IN UINTN          TokenNumber,

+  IN UINT8          Value

+  )

+{

+  ASSERT (FALSE);

+

+  return RETURN_INVALID_PARAMETER;

+}

+

+/**

+  This function provides a means by which to set a value for a given PCD token.

+

+  Sets the 16-bit value for the token specified by TokenNumber

+  to the value specified by Value.

+

+  If Guid is NULL, then ASSERT().

+

+  @param[in] Guid           The pointer to a 128-bit unique value that

+                            designates which namespace to set a value from.

+  @param[in] TokenNumber    The PCD token number to set a current value for.

+  @param[in] Value          The 16-bit value to set.

+

+  @return The status of the set operation.

+

+**/

+RETURN_STATUS

+EFIAPI

+LibPcdSetEx16S (

+  IN CONST GUID     *Guid,

+  IN UINTN          TokenNumber,

+  IN UINT16         Value

+  )

+{

+  ASSERT (FALSE);

+

+  return RETURN_INVALID_PARAMETER;

+}

+

+/**

+  This function provides a means by which to set a value for a given PCD token.

+

+  Sets the 32-bit value for the token specified by TokenNumber

+  to the value specified by Value.

+

+  If Guid is NULL, then ASSERT().

+

+  @param[in] Guid           The pointer to a 128-bit unique value that

+                            designates which namespace to set a value from.

+  @param[in] TokenNumber    The PCD token number to set a current value for.

+  @param[in] Value          The 32-bit value to set.

+

+  @return The status of the set operation.

+

+**/

+RETURN_STATUS

+EFIAPI

+LibPcdSetEx32S (

+  IN CONST GUID     *Guid,

+  IN UINTN          TokenNumber,

+  IN UINT32         Value

+  )

+{

+  ASSERT (FALSE);

+

+  return RETURN_INVALID_PARAMETER;

+}

+

+/**

+  This function provides a means by which to set a value for a given PCD token.

+

+  Sets the 64-bit value for the token specified by TokenNumber

+  to the value specified by Value.

+

+  If Guid is NULL, then ASSERT().

+

+  @param[in] Guid           The pointer to a 128-bit unique value that

+                            designates which namespace to set a value from.

+  @param[in] TokenNumber    The PCD token number to set a current value for.

+  @param[in] Value          The 64-bit value to set.

+

+  @return The status of the set operation.

+

+**/

+RETURN_STATUS

+EFIAPI

+LibPcdSetEx64S (

+  IN CONST GUID     *Guid,

+  IN UINTN          TokenNumber,

+  IN UINT64         Value

+  )

+{

+  ASSERT (FALSE);

+

+  return RETURN_INVALID_PARAMETER;

+}

+

+/**

+  This function provides a means by which to set a value for a given PCD token.

+

+  Sets a buffer for the token specified by TokenNumber to the value specified by

+  Buffer and SizeOfBuffer. If SizeOfBuffer is greater than the maximum size

+  support by TokenNumber, then set SizeOfBuffer to the maximum size supported by

+  TokenNumber and return EFI_INVALID_PARAMETER to indicate that the set operation

+  was not actually performed.

+

+  If Guid is NULL, then ASSERT().

+  If SizeOfBuffer is NULL, then ASSERT().

+  If SizeOfBuffer > 0 and Buffer is NULL, then ASSERT().

+

+  @param[in]      Guid          Pointer to a 128-bit unique value that

+                                designates which namespace to set a value from.

+  @param[in]      TokenNumber   The PCD token number to set a current value for.

+  @param[in, out] SizeOfBuffer  The size, in bytes, of Buffer.

+  @param[in]      Buffer        A pointer to the buffer to set.

+

+  @return The status of the set operation.

+

+**/

+RETURN_STATUS

+EFIAPI

+LibPcdSetExPtrS (

+  IN CONST GUID     *Guid,

+  IN       UINTN    TokenNumber,

+  IN OUT   UINTN    *SizeOfBuffer,

+  IN       VOID     *Buffer

+  )

+{

+  ASSERT (FALSE);

+

+  return RETURN_INVALID_PARAMETER;

+}

+

+/**

+  This function provides a means by which to set a value for a given PCD token.

+

+  Sets the boolean value for the token specified by TokenNumber

+  to the value specified by Value.

+

+  If Guid is NULL, then ASSERT().

+

+  @param[in] Guid           The pointer to a 128-bit unique value that

+                            designates which namespace to set a value from.

+  @param[in] TokenNumber    The PCD token number to set a current value for.

+  @param[in] Value          The boolean value to set.

+

+  @return The status of the set operation.

+

+**/

+RETURN_STATUS

+EFIAPI

+LibPcdSetExBoolS (

+  IN CONST GUID     *Guid,

+  IN UINTN          TokenNumber,

+  IN BOOLEAN        Value

+  )

+{

+  ASSERT (FALSE);

+

+  return RETURN_INVALID_PARAMETER;

+}

+

+/**

+  Set up a notification function that is called when a specified token is set.

+

+  When the token specified by TokenNumber and Guid is set,

+  then notification function specified by NotificationFunction is called.

+  If Guid is NULL, then the default token space is used.

+

+  If NotificationFunction is NULL, then ASSERT().

+

+  @param[in]  Guid      The pointer to a 128-bit unique value that designates which

+                        namespace to set a value from.  If NULL, then the default

+                        token space is used.

+  @param[in]  TokenNumber   The PCD token number to monitor.

+  @param[in]  NotificationFunction  The function to call when the token

+                                    specified by Guid and TokenNumber is set.

+

+**/

+VOID

+EFIAPI

+LibPcdCallbackOnSet (

+  IN CONST GUID               *Guid,       OPTIONAL

+  IN UINTN                    TokenNumber,

+  IN PCD_CALLBACK             NotificationFunction

+  )

+{

+  ASSERT (FALSE);

+}

+

+

+

+/**

+  Disable a notification function that was established with LibPcdCallbackonSet().

+

+  Disable a notification function that was previously established with LibPcdCallbackOnSet().

+

+  If NotificationFunction is NULL, then ASSERT().

+  If LibPcdCallbackOnSet() was not previously called with Guid, TokenNumber,

+  and NotificationFunction, then ASSERT().

+

+  @param[in]  Guid          Specify the GUID token space.

+  @param[in]  TokenNumber   Specify the token number.

+  @param[in]  NotificationFunction The callback function to be unregistered.

+

+**/

+VOID

+EFIAPI

+LibPcdCancelCallback (

+  IN CONST GUID               *Guid,       OPTIONAL

+  IN UINTN                    TokenNumber,

+  IN PCD_CALLBACK             NotificationFunction

+  )

+{

+  ASSERT (FALSE);

+}

+

+

+

+/**

+  Retrieves the next token in a token space.

+

+  Retrieves the next PCD token number from the token space specified by Guid.

+  If Guid is NULL, then the default token space is used.  If TokenNumber is 0,

+  then the first token number is returned.  Otherwise, the token number that

+  follows TokenNumber in the token space is returned.  If TokenNumber is the last

+  token number in the token space, then 0 is returned.

+

+  If TokenNumber is not 0 and is not in the token space specified by Guid, then ASSERT().

+

+  @param[in]  Guid        The pointer to a 128-bit unique value that designates which namespace

+                          to set a value from.  If NULL, then the default token space is used.

+  @param[in]  TokenNumber The previous PCD token number.  If 0, then retrieves the first PCD

+                          token number.

+

+  @return The next valid token number.

+

+**/

+UINTN

+EFIAPI

+LibPcdGetNextToken (

+  IN CONST GUID               *Guid,       OPTIONAL

+  IN UINTN                    TokenNumber

+  )

+{

+  ASSERT (FALSE);

+

+  return 0;

+}

+

+

+

+/**

+  Used to retrieve the list of available PCD token space GUIDs.

+

+  Returns the PCD token space GUID that follows TokenSpaceGuid in the list of token spaces

+  in the platform.

+  If TokenSpaceGuid is NULL, then a pointer to the first PCD token spaces returned.

+  If TokenSpaceGuid is the last PCD token space GUID in the list, then NULL is returned.

+

+  @param  TokenSpaceGuid  The pointer to a PCD token space GUID.

+

+  @return The next valid token namespace.

+

+**/

+GUID *

+EFIAPI

+LibPcdGetNextTokenSpace (

+  IN CONST GUID  *TokenSpaceGuid

+  )

+{

+  ASSERT (FALSE);

+

+  return NULL;

+}

+

+

+/**

+  Sets a value of a patchable PCD entry that is type pointer.

+

+  Sets the PCD entry specified by PatchVariable to the value specified by Buffer

+  and SizeOfBuffer.  Buffer is returned.  If SizeOfBuffer is greater than

+  MaximumDatumSize, then set SizeOfBuffer to MaximumDatumSize and return

+  NULL to indicate that the set operation was not actually performed.

+  If SizeOfBuffer is set to MAX_ADDRESS, then SizeOfBuffer must be set to

+  MaximumDatumSize and NULL must be returned.

+

+  If PatchVariable is NULL, then ASSERT().

+  If SizeOfBuffer is NULL, then ASSERT().

+  If SizeOfBuffer > 0 and Buffer is NULL, then ASSERT().

+

+  @param[out] PatchVariable     A pointer to the global variable in a module that is

+                                the target of the set operation.

+  @param[in] MaximumDatumSize   The maximum size allowed for the PCD entry specified by PatchVariable.

+  @param[in, out] SizeOfBuffer  A pointer to the size, in bytes, of Buffer.

+  @param[in] Buffer             A pointer to the buffer to used to set the target variable.

+

+  @return Return the pointer to the buffer that was set.

+

+**/

+VOID *

+EFIAPI

+LibPatchPcdSetPtr (

+  OUT       VOID        *PatchVariable,

+  IN        UINTN       MaximumDatumSize,

+  IN OUT    UINTN       *SizeOfBuffer,

+  IN CONST  VOID        *Buffer

+  )

+{

+  ASSERT (PatchVariable != NULL);

+  ASSERT (SizeOfBuffer  != NULL);

+

+  if (*SizeOfBuffer > 0) {

+    ASSERT (Buffer != NULL);

+  }

+

+  if ((*SizeOfBuffer > MaximumDatumSize) ||

+      (*SizeOfBuffer == MAX_ADDRESS)) {

+    *SizeOfBuffer = MaximumDatumSize;

+    return NULL;

+  }

+

+  CopyMem (PatchVariable, Buffer, *SizeOfBuffer);

+

+  return (VOID *) Buffer;

+}

+

+/**

+  Sets a value of a patchable PCD entry that is type pointer.

+

+  Sets the PCD entry specified by PatchVariable to the value specified

+  by Buffer and SizeOfBuffer. If SizeOfBuffer is greater than MaximumDatumSize,

+  then set SizeOfBuffer to MaximumDatumSize and return RETURN_INVALID_PARAMETER

+  to indicate that the set operation was not actually performed.

+  If SizeOfBuffer is set to MAX_ADDRESS, then SizeOfBuffer must be set to

+  MaximumDatumSize and RETURN_INVALID_PARAMETER must be returned.

+

+  If PatchVariable is NULL, then ASSERT().

+  If SizeOfBuffer is NULL, then ASSERT().

+  If SizeOfBuffer > 0 and Buffer is NULL, then ASSERT().

+

+  @param[out] PatchVariable     A pointer to the global variable in a module that is

+                                the target of the set operation.

+  @param[in] MaximumDatumSize   The maximum size allowed for the PCD entry specified by PatchVariable.

+  @param[in, out] SizeOfBuffer  A pointer to the size, in bytes, of Buffer.

+  @param[in] Buffer             A pointer to the buffer to used to set the target variable.

+

+  @return The status of the set operation.

+

+**/

+RETURN_STATUS

+EFIAPI

+LibPatchPcdSetPtrS (

+  OUT      VOID     *PatchVariable,

+  IN       UINTN    MaximumDatumSize,

+  IN OUT   UINTN    *SizeOfBuffer,

+  IN CONST VOID     *Buffer

+  )

+{

+  ASSERT (PatchVariable != NULL);

+  ASSERT (SizeOfBuffer  != NULL);

+

+  if (*SizeOfBuffer > 0) {

+    ASSERT (Buffer != NULL);

+  }

+

+  if ((*SizeOfBuffer > MaximumDatumSize) ||

+      (*SizeOfBuffer == MAX_ADDRESS)) {

+    *SizeOfBuffer = MaximumDatumSize;

+    return RETURN_INVALID_PARAMETER;

+  }

+

+  CopyMem (PatchVariable, Buffer, *SizeOfBuffer);

+

+  return RETURN_SUCCESS;

+}

+

+/**

+  Sets a value and size of a patchable PCD entry that is type pointer.

+

+  Sets the PCD entry specified by PatchVariable to the value specified by Buffer

+  and SizeOfBuffer.  Buffer is returned.  If SizeOfBuffer is greater than

+  MaximumDatumSize, then set SizeOfBuffer to MaximumDatumSize and return

+  NULL to indicate that the set operation was not actually performed.

+  If SizeOfBuffer is set to MAX_ADDRESS, then SizeOfBuffer must be set to

+  MaximumDatumSize and NULL must be returned.

+

+  If PatchVariable is NULL, then ASSERT().

+  If SizeOfPatchVariable is NULL, then ASSERT().

+  If SizeOfBuffer is NULL, then ASSERT().

+  If SizeOfBuffer > 0 and Buffer is NULL, then ASSERT().

+

+  @param[out] PatchVariable     A pointer to the global variable in a module that is

+                                the target of the set operation.

+  @param[out] SizeOfPatchVariable A pointer to the size, in bytes, of PatchVariable.

+  @param[in] MaximumDatumSize   The maximum size allowed for the PCD entry specified by PatchVariable.

+  @param[in, out] SizeOfBuffer  A pointer to the size, in bytes, of Buffer.

+  @param[in] Buffer             A pointer to the buffer to used to set the target variable.

+

+  @return Return the pointer to the buffer been set.

+

+**/

+VOID *

+EFIAPI

+LibPatchPcdSetPtrAndSize (

+  OUT       VOID        *PatchVariable,

+  OUT       UINTN       *SizeOfPatchVariable,

+  IN        UINTN       MaximumDatumSize,

+  IN OUT    UINTN       *SizeOfBuffer,

+  IN CONST  VOID        *Buffer

+  )

+{

+  ASSERT (PatchVariable != NULL);

+  ASSERT (SizeOfPatchVariable != NULL);

+  ASSERT (SizeOfBuffer  != NULL);

+

+  if (*SizeOfBuffer > 0) {

+    ASSERT (Buffer != NULL);

+  }

+

+  if ((*SizeOfBuffer > MaximumDatumSize) ||

+      (*SizeOfBuffer == MAX_ADDRESS)) {

+    *SizeOfBuffer = MaximumDatumSize;

+    return NULL;

+  }

+

+  CopyMem (PatchVariable, Buffer, *SizeOfBuffer);

+  *SizeOfPatchVariable = *SizeOfBuffer;

+

+  return (VOID *) Buffer;

+}

+

+/**

+  Sets a value and size of a patchable PCD entry that is type pointer.

+

+  Sets the PCD entry specified by PatchVariable to the value specified

+  by Buffer and SizeOfBuffer. If SizeOfBuffer is greater than MaximumDatumSize,

+  then set SizeOfBuffer to MaximumDatumSize and return RETURN_INVALID_PARAMETER

+  to indicate that the set operation was not actually performed.

+  If SizeOfBuffer is set to MAX_ADDRESS, then SizeOfBuffer must be set to

+  MaximumDatumSize and RETURN_INVALID_PARAMETER must be returned.

+

+  If PatchVariable is NULL, then ASSERT().

+  If SizeOfPatchVariable is NULL, then ASSERT().

+  If SizeOfBuffer is NULL, then ASSERT().

+  If SizeOfBuffer > 0 and Buffer is NULL, then ASSERT().

+

+  @param[out] PatchVariable     A pointer to the global variable in a module that is

+                                the target of the set operation.

+  @param[out] SizeOfPatchVariable A pointer to the size, in bytes, of PatchVariable.

+  @param[in] MaximumDatumSize   The maximum size allowed for the PCD entry specified by PatchVariable.

+  @param[in, out] SizeOfBuffer  A pointer to the size, in bytes, of Buffer.

+  @param[in] Buffer             A pointer to the buffer to used to set the target variable.

+

+  @return The status of the set operation.

+

+**/

+RETURN_STATUS

+EFIAPI

+LibPatchPcdSetPtrAndSizeS (

+  OUT      VOID     *PatchVariable,

+  OUT      UINTN    *SizeOfPatchVariable,

+  IN       UINTN    MaximumDatumSize,

+  IN OUT   UINTN    *SizeOfBuffer,

+  IN CONST VOID     *Buffer

+  )

+{

+  ASSERT (PatchVariable != NULL);

+  ASSERT (SizeOfPatchVariable != NULL);

+  ASSERT (SizeOfBuffer  != NULL);

+

+  if (*SizeOfBuffer > 0) {

+    ASSERT (Buffer != NULL);

+  }

+

+  if ((*SizeOfBuffer > MaximumDatumSize) ||

+      (*SizeOfBuffer == MAX_ADDRESS)) {

+    *SizeOfBuffer = MaximumDatumSize;

+    return RETURN_INVALID_PARAMETER;

+  }

+

+  CopyMem (PatchVariable, Buffer, *SizeOfBuffer);

+  *SizeOfPatchVariable = *SizeOfBuffer;

+

+  return RETURN_SUCCESS;

+}

+

+/**

+  Retrieve additional information associated with a PCD token.

+

+  This includes information such as the type of value the TokenNumber is associated with as well as possible

+  human readable name that is associated with the token.

+

+  If TokenNumber is not in the default token space specified, then ASSERT().

+

+  @param[in]    TokenNumber The PCD token number.

+  @param[out]   PcdInfo     The returned information associated with the requested TokenNumber.

+                            The caller is responsible for freeing the buffer that is allocated by callee for PcdInfo->PcdName.

+**/

+VOID

+EFIAPI

+LibPcdGetInfo (

+  IN        UINTN           TokenNumber,

+  OUT       PCD_INFO        *PcdInfo

+  )

+{

+  ASSERT (FALSE);

+}

+

+/**

+  Retrieve additional information associated with a PCD token.

+

+  This includes information such as the type of value the TokenNumber is associated with as well as possible

+  human readable name that is associated with the token.

+

+  If TokenNumber is not in the token space specified by Guid, then ASSERT().

+

+  @param[in]    Guid        The 128-bit unique value that designates the namespace from which to extract the value.

+  @param[in]    TokenNumber The PCD token number.

+  @param[out]   PcdInfo     The returned information associated with the requested TokenNumber.

+                            The caller is responsible for freeing the buffer that is allocated by callee for PcdInfo->PcdName.

+**/

+VOID

+EFIAPI

+LibPcdGetInfoEx (

+  IN CONST  GUID            *Guid,

+  IN        UINTN           TokenNumber,

+  OUT       PCD_INFO        *PcdInfo

+  )

+{

+  ASSERT (FALSE);

+}

+

+/**

+  Retrieve the currently set SKU Id.

+

+  @return   The currently set SKU Id. If the platform has not set at a SKU Id, then the

+            default SKU Id value of 0 is returned. If the platform has set a SKU Id, then the currently set SKU

+            Id is returned.

+**/

+UINTN

+EFIAPI

+LibPcdGetSku (

+  VOID

+  )

+{

+  ASSERT (FALSE);

+

+  return 0;

+}

+

diff --git a/debugging_demo/memtest86+/efi/Include/src/UefiBootServicesTableLib.c b/debugging_demo/memtest86+/efi/Include/src/UefiBootServicesTableLib.c
new file mode 100644
index 0000000..4fb6bc8
--- /dev/null
+++ b/debugging_demo/memtest86+/efi/Include/src/UefiBootServicesTableLib.c
@@ -0,0 +1,60 @@
+/** @file

+  This library retrieve the EFI_BOOT_SERVICES pointer from EFI system table in

+  library's constructor.

+

+  Copyright (c) 2006 - 2018, Intel Corporation. All rights reserved.<BR>

+  SPDX-License-Identifier: BSD-2-Clause-Patent

+

+**/

+

+

+#include <Uefi.h>

+

+#include <Library/UefiBootServicesTableLib.h>

+#include <Library/DebugLib.h>

+

+EFI_HANDLE         gImageHandle = NULL;

+EFI_SYSTEM_TABLE   *gST         = NULL;

+EFI_BOOT_SERVICES  *gBS         = NULL;

+

+/**

+  The constructor function caches the pointer of Boot Services Table.

+

+  The constructor function caches the pointer of Boot Services Table through System Table.

+  It will ASSERT() if the pointer of System Table is NULL.

+  It will ASSERT() if the pointer of Boot Services Table is NULL.

+  It will always return EFI_SUCCESS.

+

+  @param  ImageHandle   The firmware allocated handle for the EFI image.

+  @param  SystemTable   A pointer to the EFI System Table.

+

+  @retval EFI_SUCCESS   The constructor always returns EFI_SUCCESS.

+

+**/

+EFI_STATUS

+EFIAPI

+UefiBootServicesTableLibConstructor (

+  IN EFI_HANDLE        ImageHandle,

+  IN EFI_SYSTEM_TABLE  *SystemTable

+  )

+{

+  //

+  // Cache the Image Handle

+  //

+  gImageHandle = ImageHandle;

+  ASSERT (gImageHandle != NULL);

+

+  //

+  // Cache pointer to the EFI System Table

+  //

+  gST = SystemTable;

+  ASSERT (gST != NULL);

+

+  //

+  // Cache pointer to the EFI Boot Services Table

+  //

+  gBS = SystemTable->BootServices;

+  ASSERT (gBS != NULL);

+

+  return EFI_SUCCESS;

+}

diff --git a/debugging_demo/memtest86+/efi/Include/src/UefiDebugLibStdErr/DebugLib.c b/debugging_demo/memtest86+/efi/Include/src/UefiDebugLibStdErr/DebugLib.c
new file mode 100644
index 0000000..6140bbd
--- /dev/null
+++ b/debugging_demo/memtest86+/efi/Include/src/UefiDebugLibStdErr/DebugLib.c
@@ -0,0 +1,377 @@
+/** @file

+  UEFI Debug Lib that sends messages to the Standard Error Device in the EFI System Table.

+

+  Copyright (c) 2006 - 2019, Intel Corporation. All rights reserved.<BR>

+  SPDX-License-Identifier: BSD-2-Clause-Patent

+

+**/

+

+

+#include <Uefi.h>

+

+#include <Library/DebugLib.h>

+#include <Library/PrintLib.h>

+#include <Library/PcdLib.h>

+#include <Library/BaseLib.h>

+#include <Library/BaseMemoryLib.h>

+#include <Library/DebugPrintErrorLevelLib.h>

+

+#include "Efi_Defs.h"

+

+//

+// Define the maximum debug and assert message length that this library supports

+//

+#define MAX_DEBUG_MESSAGE_LENGTH  0x100

+

+

+//

+// VA_LIST can not initialize to NULL for all compiler, so we use this to

+// indicate a null VA_LIST

+//

+VA_LIST     mVaListNull;

+

+extern BOOLEAN                mPostEBS;

+extern EFI_SYSTEM_TABLE       *mDebugST;

+

+/**

+  Prints a debug message to the debug output device if the specified error level is enabled.

+

+  If any bit in ErrorLevel is also set in DebugPrintErrorLevelLib function

+  GetDebugPrintErrorLevel (), then print the message specified by Format and the

+  associated variable argument list to the debug output device.

+

+  If Format is NULL, then ASSERT().

+

+  @param  ErrorLevel  The error level of the debug message.

+  @param  Format      The format string for the debug message to print.

+  @param  ...         The variable argument list whose contents are accessed

+                      based on the format string specified by Format.

+

+**/

+VOID

+EFIAPI

+DebugPrint (

+  IN  UINTN        ErrorLevel,

+  IN  CONST CHAR8  *Format,

+  ...

+  )

+{

+  VA_LIST         Marker;

+

+  VA_START (Marker, Format);

+  DebugVPrint (ErrorLevel, Format, Marker);

+  VA_END (Marker);

+}

+

+

+/**

+  Prints a debug message to the debug output device if the specified

+  error level is enabled base on Null-terminated format string and a

+  VA_LIST argument list or a BASE_LIST argument list.

+

+  If any bit in ErrorLevel is also set in DebugPrintErrorLevelLib function

+  GetDebugPrintErrorLevel (), then print the message specified by Format and

+  the associated variable argument list to the debug output device.

+

+  If Format is NULL, then ASSERT().

+

+  @param  ErrorLevel      The error level of the debug message.

+  @param  Format          Format string for the debug message to print.

+  @param  VaListMarker    VA_LIST marker for the variable argument list.

+  @param  BaseListMarker  BASE_LIST marker for the variable argument list.

+

+**/

+VOID

+DebugPrintMarker (

+  IN  UINTN         ErrorLevel,

+  IN  CONST CHAR8   *Format,

+  IN  VA_LIST       VaListMarker,

+  IN  BASE_LIST     BaseListMarker

+  )

+{

+  CHAR16   Buffer[MAX_DEBUG_MESSAGE_LENGTH];

+

+  if (!mPostEBS) {

+    //

+    // If Format is NULL, then ASSERT().

+    //

+    ASSERT (Format != NULL);

+

+    //

+    // Check driver debug mask value and global mask

+    //

+    if ((ErrorLevel & GetDebugPrintErrorLevel ()) == 0) {

+      return;

+    }

+

+    //

+    // Convert the DEBUG() message to a Unicode String

+    //

+    if (BaseListMarker == NULL) {

+      UnicodeVSPrintAsciiFormat (Buffer, sizeof (Buffer), Format, VaListMarker);

+    } else {

+      UnicodeBSPrintAsciiFormat (Buffer, sizeof (Buffer), Format, BaseListMarker);

+    }

+

+    //

+    // Send the print string to the Standard Error device

+    //

+    if ((mDebugST != NULL) && (mDebugST->StdErr != NULL)) {

+      mDebugST->StdErr->OutputString (mDebugST->StdErr, Buffer);

+    }

+  }

+}

+

+

+/**

+  Prints a debug message to the debug output device if the specified

+  error level is enabled.

+

+  If any bit in ErrorLevel is also set in DebugPrintErrorLevelLib function

+  GetDebugPrintErrorLevel (), then print the message specified by Format and

+  the associated variable argument list to the debug output device.

+

+  If Format is NULL, then ASSERT().

+

+  @param  ErrorLevel    The error level of the debug message.

+  @param  Format        Format string for the debug message to print.

+  @param  VaListMarker  VA_LIST marker for the variable argument list.

+

+**/

+VOID

+EFIAPI

+DebugVPrint (

+  IN  UINTN         ErrorLevel,

+  IN  CONST CHAR8   *Format,

+  IN  VA_LIST       VaListMarker

+  )

+{

+  DebugPrintMarker (ErrorLevel, Format, VaListMarker, NULL);

+}

+

+

+/**

+  Prints a debug message to the debug output device if the specified

+  error level is enabled.

+  This function use BASE_LIST which would provide a more compatible

+  service than VA_LIST.

+

+  If any bit in ErrorLevel is also set in DebugPrintErrorLevelLib function

+  GetDebugPrintErrorLevel (), then print the message specified by Format and

+  the associated variable argument list to the debug output device.

+

+  If Format is NULL, then ASSERT().

+

+  @param  ErrorLevel      The error level of the debug message.

+  @param  Format          Format string for the debug message to print.

+  @param  BaseListMarker  BASE_LIST marker for the variable argument list.

+

+**/

+VOID

+EFIAPI

+DebugBPrint (

+  IN  UINTN         ErrorLevel,

+  IN  CONST CHAR8   *Format,

+  IN  BASE_LIST     BaseListMarker

+  )

+{

+  DebugPrintMarker (ErrorLevel, Format, mVaListNull, BaseListMarker);

+}

+

+

+/**

+  Prints an assert message containing a filename, line number, and description.

+  This may be followed by a breakpoint or a dead loop.

+

+  Print a message of the form "ASSERT <FileName>(<LineNumber>): <Description>\n"

+  to the debug output device.  If DEBUG_PROPERTY_ASSERT_BREAKPOINT_ENABLED bit of

+  PcdDebugProperyMask is set then CpuBreakpoint() is called. Otherwise, if

+  DEBUG_PROPERTY_ASSERT_DEADLOOP_ENABLED bit of PcdDebugProperyMask is set then

+  CpuDeadLoop() is called.  If neither of these bits are set, then this function

+  returns immediately after the message is printed to the debug output device.

+  DebugAssert() must actively prevent recursion.  If DebugAssert() is called while

+  processing another DebugAssert(), then DebugAssert() must return immediately.

+

+  If FileName is NULL, then a <FileName> string of "(NULL) Filename" is printed.

+  If Description is NULL, then a <Description> string of "(NULL) Description" is printed.

+

+  @param  FileName     The pointer to the name of the source file that generated

+                       the assert condition.

+  @param  LineNumber   The line number in the source file that generated the

+                       assert condition

+  @param  Description  The pointer to the description of the assert condition.

+

+**/

+VOID

+EFIAPI

+DebugAssert (

+  IN CONST CHAR8  *FileName,

+  IN UINTN        LineNumber,

+  IN CONST CHAR8  *Description

+  )

+{

+  CHAR16  Buffer[MAX_DEBUG_MESSAGE_LENGTH];

+

+  if (!mPostEBS) {

+    //

+    // Generate the ASSERT() message in Unicode format

+    //

+    UnicodeSPrintAsciiFormat (

+      Buffer,

+      sizeof (Buffer),

+      "ASSERT [%a] %a(%d): %a\n",

+      gEfiCallerBaseName,

+      FileName,

+      LineNumber,

+      Description

+      );

+

+    //

+    // Send the print string to the Standard Error device

+    //

+    if ((mDebugST != NULL) && (mDebugST->StdErr != NULL)) {

+      mDebugST->StdErr->OutputString (mDebugST->StdErr, Buffer);

+    }

+

+    //

+    // Generate a Breakpoint, DeadLoop, or NOP based on PCD settings

+    //

+    if ((PcdGet8(PcdDebugPropertyMask) & DEBUG_PROPERTY_ASSERT_BREAKPOINT_ENABLED) != 0) {

+      CpuBreakpoint ();

+    } else if ((PcdGet8(PcdDebugPropertyMask) & DEBUG_PROPERTY_ASSERT_DEADLOOP_ENABLED) != 0) {

+      CpuDeadLoop ();

+    }

+  }

+}

+

+

+/**

+  Fills a target buffer with PcdDebugClearMemoryValue, and returns the target buffer.

+

+  This function fills Length bytes of Buffer with the value specified by

+  PcdDebugClearMemoryValue, and returns Buffer.

+

+  If 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 be filled with PcdDebugClearMemoryValue.

+  @param   Length  The number of bytes in Buffer to fill with zeros PcdDebugClearMemoryValue.

+

+  @return  Buffer  The pointer to the target buffer filled with PcdDebugClearMemoryValue.

+

+**/

+VOID *

+EFIAPI

+DebugClearMemory (

+  OUT VOID  *Buffer,

+  IN UINTN  Length

+  )

+{

+  //

+  // If Buffer is NULL, then ASSERT().

+  //

+  ASSERT (Buffer != NULL);

+

+  //

+  // SetMem() checks for the the ASSERT() condition on Length and returns Buffer

+  //

+  return SetMem (Buffer, Length, PcdGet8(PcdDebugClearMemoryValue));

+}

+

+

+/**

+  Returns TRUE if ASSERT() macros are enabled.

+

+  This function returns TRUE if the DEBUG_PROPERTY_DEBUG_ASSERT_ENABLED bit of

+  PcdDebugProperyMask is set.  Otherwise FALSE is returned.

+

+  @retval  TRUE    The DEBUG_PROPERTY_DEBUG_ASSERT_ENABLED bit of PcdDebugProperyMask is set.

+  @retval  FALSE   The DEBUG_PROPERTY_DEBUG_ASSERT_ENABLED bit of PcdDebugProperyMask is clear.

+

+**/

+BOOLEAN

+EFIAPI

+DebugAssertEnabled (

+  VOID

+  )

+{

+  return (BOOLEAN) ((PcdGet8(PcdDebugPropertyMask) & DEBUG_PROPERTY_DEBUG_ASSERT_ENABLED) != 0);

+}

+

+

+/**

+  Returns TRUE if DEBUG() macros are enabled.

+

+  This function returns TRUE if the DEBUG_PROPERTY_DEBUG_PRINT_ENABLED bit of

+  PcdDebugProperyMask is set.  Otherwise FALSE is returned.

+

+  @retval  TRUE    The DEBUG_PROPERTY_DEBUG_PRINT_ENABLED bit of PcdDebugProperyMask is set.

+  @retval  FALSE   The DEBUG_PROPERTY_DEBUG_PRINT_ENABLED bit of PcdDebugProperyMask is clear.

+

+**/

+BOOLEAN

+EFIAPI

+DebugPrintEnabled (

+  VOID

+  )

+{

+  return (BOOLEAN) ((PcdGet8(PcdDebugPropertyMask) & DEBUG_PROPERTY_DEBUG_PRINT_ENABLED) != 0);

+}

+

+

+/**

+  Returns TRUE if DEBUG_CODE() macros are enabled.

+

+  This function returns TRUE if the DEBUG_PROPERTY_DEBUG_CODE_ENABLED bit of

+  PcdDebugProperyMask is set.  Otherwise FALSE is returned.

+

+  @retval  TRUE    The DEBUG_PROPERTY_DEBUG_CODE_ENABLED bit of PcdDebugProperyMask is set.

+  @retval  FALSE   The DEBUG_PROPERTY_DEBUG_CODE_ENABLED bit of PcdDebugProperyMask is clear.

+

+**/

+BOOLEAN

+EFIAPI

+DebugCodeEnabled (

+  VOID

+  )

+{

+  return (BOOLEAN) ((PcdGet8(PcdDebugPropertyMask) & DEBUG_PROPERTY_DEBUG_CODE_ENABLED) != 0);

+}

+

+

+/**

+  Returns TRUE if DEBUG_CLEAR_MEMORY() macro is enabled.

+

+  This function returns TRUE if the DEBUG_PROPERTY_CLEAR_MEMORY_ENABLED bit of

+  PcdDebugProperyMask is set.  Otherwise FALSE is returned.

+

+  @retval  TRUE    The DEBUG_PROPERTY_CLEAR_MEMORY_ENABLED bit of PcdDebugProperyMask is set.

+  @retval  FALSE   The DEBUG_PROPERTY_CLEAR_MEMORY_ENABLED bit of PcdDebugProperyMask is clear.

+

+**/

+BOOLEAN

+EFIAPI

+DebugClearMemoryEnabled (

+  VOID

+  )

+{

+  return (BOOLEAN) ((PcdGet8(PcdDebugPropertyMask) & DEBUG_PROPERTY_CLEAR_MEMORY_ENABLED) != 0);

+}

+

+/**

+  Returns TRUE if any one of the bit is set both in ErrorLevel and PcdFixedDebugPrintErrorLevel.

+

+  This function compares the bit mask of ErrorLevel and PcdFixedDebugPrintErrorLevel.

+

+  @retval  TRUE    Current ErrorLevel is supported.

+  @retval  FALSE   Current ErrorLevel is not supported.

+

+**/

+BOOLEAN

+EFIAPI

+DebugPrintLevelEnabled (

+  IN  CONST UINTN        ErrorLevel

+  )

+{

+  return (BOOLEAN) ((ErrorLevel & PcdGet32(PcdFixedDebugPrintErrorLevel)) != 0);

+}

diff --git a/debugging_demo/memtest86+/efi/Include/src/UefiDebugLibStdErr/DebugLibConstructor.c b/debugging_demo/memtest86+/efi/Include/src/UefiDebugLibStdErr/DebugLibConstructor.c
new file mode 100644
index 0000000..b4ac17c
--- /dev/null
+++ b/debugging_demo/memtest86+/efi/Include/src/UefiDebugLibStdErr/DebugLibConstructor.c
@@ -0,0 +1,99 @@
+/** @file

+  UEFI Dxe DebugLib constructor that prevent some debug service after ExitBootServices event,

+  because some pointer is nulled at that phase.

+

+  Copyright (c) 2018, Microsoft Corporation

+  Copyright (c) 2015 - 2019, Intel Corporation. All rights reserved.<BR>

+

+  SPDX-License-Identifier: BSD-2-Clause-Patent

+**/

+

+#include <Uefi.h>

+#include <Library/BaseLib.h>

+#include <Library/BaseMemoryLib.h>

+

+//

+// BOOLEAN value to indicate if it is at the post ExitBootServices pahse

+//

+BOOLEAN     mPostEBS = FALSE;

+

+static EFI_EVENT   mExitBootServicesEvent;

+

+//

+// Pointer to SystemTable

+// This library instance may have a cycle consume with UefiBootServicesTableLib

+// because of the constructors.

+//

+EFI_SYSTEM_TABLE      *mDebugST;

+

+/**

+  This routine sets the mPostEBS for exit boot servies true

+  to prevent DebugPort protocol dereferences when the pointer is nulled.

+

+  @param  Event        Event whose notification function is being invoked.

+  @param  Context      Pointer to the notification function's context.

+

+**/

+VOID

+EFIAPI

+ExitBootServicesCallback (

+  EFI_EVENT   Event,

+  VOID*       Context

+  )

+{

+  mPostEBS = TRUE;

+  return;

+}

+

+/**

+  The constructor gets the pointers to the system table.

+  And create a event to indicate it is after ExitBootServices.

+

+  @param  ImageHandle     The firmware allocated handle for the EFI image.

+  @param  SystemTable     A pointer to the EFI System Table.

+

+  @retval EFI_SUCCESS     The constructor always returns EFI_SUCCESS.

+

+**/

+EFI_STATUS

+EFIAPI

+DxeDebugLibConstructor(

+  IN EFI_HANDLE                 ImageHandle,

+  IN EFI_SYSTEM_TABLE           *SystemTable

+  )

+{

+  mDebugST = SystemTable;

+

+  SystemTable->BootServices->CreateEvent (

+                                EVT_SIGNAL_EXIT_BOOT_SERVICES,

+                                TPL_NOTIFY,

+                                ExitBootServicesCallback,

+                                NULL,

+                                &mExitBootServicesEvent

+                                );

+

+  return EFI_SUCCESS;

+}

+

+/**

+  The destructor closes Exit Boot Services Event.

+

+  @param  ImageHandle   The firmware allocated handle for the EFI image.

+  @param  SystemTable   A pointer to the EFI System Table.

+

+  @retval EFI_SUCCESS   The destructor always returns EFI_SUCCESS.

+

+**/

+EFI_STATUS

+EFIAPI

+DxeDebugLibDestructor(

+  IN EFI_HANDLE                 ImageHandle,

+  IN EFI_SYSTEM_TABLE           *SystemTable

+  )

+{

+  if (mExitBootServicesEvent != NULL) {

+    SystemTable->BootServices->CloseEvent (mExitBootServicesEvent);

+  }

+

+  return EFI_SUCCESS;

+}

diff --git a/debugging_demo/memtest86+/efi/Include/src/UefiDevicePathLib/DevicePathFromText.c b/debugging_demo/memtest86+/efi/Include/src/UefiDevicePathLib/DevicePathFromText.c
new file mode 100644
index 0000000..1515d2d
--- /dev/null
+++ b/debugging_demo/memtest86+/efi/Include/src/UefiDevicePathLib/DevicePathFromText.c
@@ -0,0 +1,3666 @@
+/** @file

+  DevicePathFromText protocol as defined in the UEFI 2.0 specification.

+

+Copyright (c) 2013 - 2018, Intel Corporation. All rights reserved.<BR>

+SPDX-License-Identifier: BSD-2-Clause-Patent

+

+**/

+

+#include "UefiDevicePathLib.h"

+

+/**

+

+  Duplicates a string.

+

+  @param  Src  Source string.

+

+  @return The duplicated string.

+

+**/

+CHAR16 *

+UefiDevicePathLibStrDuplicate (

+  IN CONST CHAR16  *Src

+  )

+{

+  return AllocateCopyPool (StrSize (Src), Src);

+}

+

+/**

+

+  Get parameter in a pair of parentheses follow the given node name.

+  For example, given the "Pci(0,1)" and NodeName "Pci", it returns "0,1".

+

+  @param  Str      Device Path Text.

+  @param  NodeName Name of the node.

+

+  @return Parameter text for the node.

+

+**/

+CHAR16 *

+GetParamByNodeName (

+  IN CHAR16 *Str,

+  IN CHAR16 *NodeName

+  )

+{

+  CHAR16  *ParamStr;

+  CHAR16  *StrPointer;

+  UINTN   NodeNameLength;

+  UINTN   ParameterLength;

+

+  //

+  // Check whether the node name matchs

+  //

+  NodeNameLength = StrLen (NodeName);

+  if (StrnCmp (Str, NodeName, NodeNameLength) != 0) {

+    return NULL;

+  }

+

+  ParamStr = Str + NodeNameLength;

+  if (!IS_LEFT_PARENTH (*ParamStr)) {

+    return NULL;

+  }

+

+  //

+  // Skip the found '(' and find first occurrence of ')'

+  //

+  ParamStr++;

+  ParameterLength = 0;

+  StrPointer = ParamStr;

+  while (!IS_NULL (*StrPointer)) {

+    if (IS_RIGHT_PARENTH (*StrPointer)) {

+      break;

+    }

+    StrPointer++;

+    ParameterLength++;

+  }

+  if (IS_NULL (*StrPointer)) {

+    //

+    // ')' not found

+    //

+    return NULL;

+  }

+

+  ParamStr = AllocateCopyPool ((ParameterLength + 1) * sizeof (CHAR16), ParamStr);

+  if (ParamStr == NULL) {

+    return NULL;

+  }

+  //

+  // Terminate the parameter string

+  //

+  ParamStr[ParameterLength] = L'\0';

+

+  return ParamStr;

+}

+

+/**

+  Gets current sub-string from a string list, before return

+  the list header is moved to next sub-string. The sub-string is separated

+  by the specified character. For example, the separator is ',', the string

+  list is "2,0,3", it returns "2", the remain list move to "0,3"

+

+  @param  List        A string list separated by the specified separator

+  @param  Separator   The separator character

+

+  @return A pointer to the current sub-string

+

+**/

+CHAR16 *

+SplitStr (

+  IN OUT CHAR16 **List,

+  IN     CHAR16 Separator

+  )

+{

+  CHAR16  *Str;

+  CHAR16  *ReturnStr;

+

+  Str = *List;

+  ReturnStr = Str;

+

+  if (IS_NULL (*Str)) {

+    return ReturnStr;

+  }

+

+  //

+  // Find first occurrence of the separator

+  //

+  while (!IS_NULL (*Str)) {

+    if (*Str == Separator) {

+      break;

+    }

+    Str++;

+  }

+

+  if (*Str == Separator) {

+    //

+    // Find a sub-string, terminate it

+    //

+    *Str = L'\0';

+    Str++;

+  }

+

+  //

+  // Move to next sub-string

+  //

+  *List = Str;

+

+  return ReturnStr;

+}

+

+/**

+  Gets the next parameter string from the list.

+

+  @param List            A string list separated by the specified separator

+

+  @return A pointer to the current sub-string

+

+**/

+CHAR16 *

+GetNextParamStr (

+  IN OUT CHAR16 **List

+  )

+{

+  //

+  // The separator is comma

+  //

+  return SplitStr (List, L',');

+}

+

+/**

+  Get one device node from entire device path text.

+

+  @param DevicePath      On input, the current Device Path node; on output, the next device path node

+  @param IsInstanceEnd   This node is the end of a device path instance

+

+  @return A device node text or NULL if no more device node available

+

+**/

+CHAR16 *

+GetNextDeviceNodeStr (

+  IN OUT CHAR16   **DevicePath,

+  OUT    BOOLEAN  *IsInstanceEnd

+  )

+{

+  CHAR16  *Str;

+  CHAR16  *ReturnStr;

+  UINTN   ParenthesesStack;

+

+  Str = *DevicePath;

+  if (IS_NULL (*Str)) {

+    return NULL;

+  }

+

+  //

+  // Skip the leading '/', '(', ')' and ','

+  //

+  while (!IS_NULL (*Str)) {

+    if (!IS_SLASH (*Str) &&

+        !IS_COMMA (*Str) &&

+        !IS_LEFT_PARENTH (*Str) &&

+        !IS_RIGHT_PARENTH (*Str)) {

+      break;

+    }

+    Str++;

+  }

+

+  ReturnStr = Str;

+

+  //

+  // Scan for the separator of this device node, '/' or ','

+  //

+  ParenthesesStack = 0;

+  while (!IS_NULL (*Str)) {

+    if ((IS_COMMA (*Str) || IS_SLASH (*Str)) && (ParenthesesStack == 0)) {

+      break;

+    }

+

+    if (IS_LEFT_PARENTH (*Str)) {

+      ParenthesesStack++;

+    } else if (IS_RIGHT_PARENTH (*Str)) {

+      ParenthesesStack--;

+    }

+

+    Str++;

+  }

+

+  if (ParenthesesStack != 0) {

+    //

+    // The '(' doesn't pair with ')', invalid device path text

+    //

+    return NULL;

+  }

+

+  if (IS_COMMA (*Str)) {

+    *IsInstanceEnd = TRUE;

+    *Str = L'\0';

+    Str++;

+  } else {

+    *IsInstanceEnd = FALSE;

+    if (!IS_NULL (*Str)) {

+      *Str = L'\0';

+      Str++;

+    }

+  }

+

+  *DevicePath = Str;

+

+  return ReturnStr;

+}

+

+

+/**

+  Return whether the integer string is a hex string.

+

+  @param Str             The integer string

+

+  @retval TRUE   Hex string

+  @retval FALSE  Decimal string

+

+**/

+BOOLEAN

+IsHexStr (

+  IN CHAR16   *Str

+  )

+{

+  //

+  // skip preceeding white space

+  //

+  while ((*Str != 0) && *Str == L' ') {

+    Str ++;

+  }

+  //

+  // skip preceeding zeros

+  //

+  while ((*Str != 0) && *Str == L'0') {

+    Str ++;

+  }

+

+  return (BOOLEAN) (*Str == L'x' || *Str == L'X');

+}

+

+/**

+

+  Convert integer string to uint.

+

+  @param Str             The integer string. If leading with "0x" or "0X", it's hexadecimal.

+

+  @return A UINTN value represented by Str

+

+**/

+UINTN

+Strtoi (

+  IN CHAR16  *Str

+  )

+{

+  if (IsHexStr (Str)) {

+    return StrHexToUintn (Str);

+  } else {

+    return StrDecimalToUintn (Str);

+  }

+}

+

+/**

+

+  Convert integer string to 64 bit data.

+

+  @param Str             The integer string. If leading with "0x" or "0X", it's hexadecimal.

+  @param Data            A pointer to the UINT64 value represented by Str

+

+**/

+VOID

+Strtoi64 (

+  IN  CHAR16  *Str,

+  OUT UINT64  *Data

+  )

+{

+  if (IsHexStr (Str)) {

+    *Data = StrHexToUint64 (Str);

+  } else {

+    *Data = StrDecimalToUint64 (Str);

+  }

+}

+

+/**

+  Converts a Unicode string to ASCII string.

+

+  @param Str             The equivalent Unicode string

+  @param AsciiStr        On input, it points to destination ASCII string buffer; on output, it points

+                         to the next ASCII string next to it

+

+**/

+VOID

+StrToAscii (

+  IN     CHAR16 *Str,

+  IN OUT CHAR8  **AsciiStr

+  )

+{

+  CHAR8 *Dest;

+

+  Dest = *AsciiStr;

+  while (!IS_NULL (*Str)) {

+    *(Dest++) = (CHAR8) *(Str++);

+  }

+  *Dest = 0;

+

+  //

+  // Return the string next to it

+  //

+  *AsciiStr = Dest + 1;

+}

+

+/**

+  Converts a generic text device path node to device path structure.

+

+  @param Type            The type of the device path node.

+  @param TextDeviceNode  The input text device path node.

+

+  @return A pointer to device path structure.

+**/

+EFI_DEVICE_PATH_PROTOCOL *

+DevPathFromTextGenericPath (

+  IN UINT8  Type,

+  IN CHAR16 *TextDeviceNode

+  )

+{

+  EFI_DEVICE_PATH_PROTOCOL *Node;

+  CHAR16                   *SubtypeStr;

+  CHAR16                   *DataStr;

+  UINTN                    DataLength;

+

+  SubtypeStr = GetNextParamStr (&TextDeviceNode);

+  DataStr    = GetNextParamStr (&TextDeviceNode);

+

+  if (DataStr == NULL) {

+    DataLength = 0;

+  } else {

+    DataLength = StrLen (DataStr) / 2;

+  }

+  Node = CreateDeviceNode (

+           Type,

+           (UINT8) Strtoi (SubtypeStr),

+           (UINT16) (sizeof (EFI_DEVICE_PATH_PROTOCOL) + DataLength)

+           );

+

+  StrHexToBytes (DataStr, DataLength * 2, (UINT8 *) (Node + 1), DataLength);

+  return Node;

+}

+

+/**

+  Converts a generic text device path node to device path structure.

+

+  @param TextDeviceNode  The input Text device path node.

+

+  @return A pointer to device path structure.

+

+**/

+EFI_DEVICE_PATH_PROTOCOL *

+DevPathFromTextPath (

+  IN CHAR16 *TextDeviceNode

+  )

+{

+  CHAR16                   *TypeStr;

+

+  TypeStr    = GetNextParamStr (&TextDeviceNode);

+

+  return DevPathFromTextGenericPath ((UINT8) Strtoi (TypeStr), TextDeviceNode);

+}

+

+/**

+  Converts a generic hardware text device path node to Hardware device path structure.

+

+  @param TextDeviceNode  The input Text device path node.

+

+  @return A pointer to Hardware device path structure.

+

+**/

+EFI_DEVICE_PATH_PROTOCOL *

+DevPathFromTextHardwarePath (

+  IN CHAR16 *TextDeviceNode

+  )

+{

+  return DevPathFromTextGenericPath (HARDWARE_DEVICE_PATH, TextDeviceNode);

+}

+

+/**

+  Converts a text device path node to Hardware PCI device path structure.

+

+  @param TextDeviceNode  The input Text device path node.

+

+  @return A pointer to Hardware PCI device path structure.

+

+**/

+EFI_DEVICE_PATH_PROTOCOL *

+DevPathFromTextPci (

+  IN CHAR16 *TextDeviceNode

+  )

+{

+  CHAR16          *FunctionStr;

+  CHAR16          *DeviceStr;

+  PCI_DEVICE_PATH *Pci;

+

+  DeviceStr   = GetNextParamStr (&TextDeviceNode);

+  FunctionStr = GetNextParamStr (&TextDeviceNode);

+  Pci         = (PCI_DEVICE_PATH *) CreateDeviceNode (

+                                      HARDWARE_DEVICE_PATH,

+                                      HW_PCI_DP,

+                                      (UINT16) sizeof (PCI_DEVICE_PATH)

+                                      );

+

+  Pci->Function = (UINT8) Strtoi (FunctionStr);

+  Pci->Device   = (UINT8) Strtoi (DeviceStr);

+

+  return (EFI_DEVICE_PATH_PROTOCOL *) Pci;

+}

+

+/**

+  Converts a text device path node to Hardware PC card device path structure.

+

+  @param TextDeviceNode  The input Text device path node.

+

+  @return A pointer to Hardware PC card device path structure.

+

+**/

+EFI_DEVICE_PATH_PROTOCOL *

+DevPathFromTextPcCard (

+  IN CHAR16 *TextDeviceNode

+  )

+{

+  CHAR16              *FunctionNumberStr;

+  PCCARD_DEVICE_PATH  *Pccard;

+

+  FunctionNumberStr = GetNextParamStr (&TextDeviceNode);

+  Pccard            = (PCCARD_DEVICE_PATH *) CreateDeviceNode (

+                                               HARDWARE_DEVICE_PATH,

+                                               HW_PCCARD_DP,

+                                               (UINT16) sizeof (PCCARD_DEVICE_PATH)

+                                               );

+

+  Pccard->FunctionNumber  = (UINT8) Strtoi (FunctionNumberStr);

+

+  return (EFI_DEVICE_PATH_PROTOCOL *) Pccard;

+}

+

+/**

+  Converts a text device path node to Hardware memory map device path structure.

+

+  @param TextDeviceNode  The input Text device path node.

+

+  @return A pointer to Hardware memory map device path structure.

+

+**/

+EFI_DEVICE_PATH_PROTOCOL *

+DevPathFromTextMemoryMapped (

+  IN CHAR16 *TextDeviceNode

+  )

+{

+  CHAR16              *MemoryTypeStr;

+  CHAR16              *StartingAddressStr;

+  CHAR16              *EndingAddressStr;

+  MEMMAP_DEVICE_PATH  *MemMap;

+

+  MemoryTypeStr      = GetNextParamStr (&TextDeviceNode);

+  StartingAddressStr = GetNextParamStr (&TextDeviceNode);

+  EndingAddressStr   = GetNextParamStr (&TextDeviceNode);

+  MemMap             = (MEMMAP_DEVICE_PATH *) CreateDeviceNode (

+                                               HARDWARE_DEVICE_PATH,

+                                               HW_MEMMAP_DP,

+                                               (UINT16) sizeof (MEMMAP_DEVICE_PATH)

+                                               );

+

+  MemMap->MemoryType = (UINT32) Strtoi (MemoryTypeStr);

+  Strtoi64 (StartingAddressStr, &MemMap->StartingAddress);

+  Strtoi64 (EndingAddressStr, &MemMap->EndingAddress);

+

+  return (EFI_DEVICE_PATH_PROTOCOL *) MemMap;

+}

+

+/**

+  Converts a text device path node to Vendor device path structure based on the input Type

+  and SubType.

+

+  @param TextDeviceNode  The input Text device path node.

+  @param Type            The type of device path node.

+  @param SubType         The subtype of device path node.

+

+  @return A pointer to the newly-created Vendor device path structure.

+

+**/

+EFI_DEVICE_PATH_PROTOCOL *

+ConvertFromTextVendor (

+  IN CHAR16 *TextDeviceNode,

+  IN UINT8  Type,

+  IN UINT8  SubType

+  )

+{

+  CHAR16              *GuidStr;

+  CHAR16              *DataStr;

+  UINTN               Length;

+  VENDOR_DEVICE_PATH  *Vendor;

+

+  GuidStr = GetNextParamStr (&TextDeviceNode);

+

+  DataStr = GetNextParamStr (&TextDeviceNode);

+  Length  = StrLen (DataStr);

+  //

+  // Two hex characters make up 1 buffer byte

+  //

+  Length  = (Length + 1) / 2;

+

+  Vendor  = (VENDOR_DEVICE_PATH *) CreateDeviceNode (

+                                     Type,

+                                     SubType,

+                                     (UINT16) (sizeof (VENDOR_DEVICE_PATH) + Length)

+                                     );

+

+  StrToGuid (GuidStr, &Vendor->Guid);

+  StrHexToBytes (DataStr, Length * 2, (UINT8 *) (Vendor + 1), Length);

+

+  return (EFI_DEVICE_PATH_PROTOCOL *) Vendor;

+}

+

+/**

+  Converts a text device path node to Vendor Hardware device path structure.

+

+  @param TextDeviceNode  The input Text device path node.

+

+  @return A pointer to the newly-created Vendor Hardware device path structure.

+

+**/

+EFI_DEVICE_PATH_PROTOCOL *

+DevPathFromTextVenHw (

+  IN CHAR16 *TextDeviceNode

+  )

+{

+  return ConvertFromTextVendor (

+           TextDeviceNode,

+           HARDWARE_DEVICE_PATH,

+           HW_VENDOR_DP

+           );

+}

+

+/**

+  Converts a text device path node to Hardware Controller device path structure.

+

+  @param TextDeviceNode  The input Text device path node.

+

+  @return A pointer to the newly-created Hardware Controller device path structure.

+

+**/

+EFI_DEVICE_PATH_PROTOCOL *

+DevPathFromTextCtrl (

+  IN CHAR16 *TextDeviceNode

+  )

+{

+  CHAR16                  *ControllerStr;

+  CONTROLLER_DEVICE_PATH  *Controller;

+

+  ControllerStr = GetNextParamStr (&TextDeviceNode);

+  Controller    = (CONTROLLER_DEVICE_PATH *) CreateDeviceNode (

+                                               HARDWARE_DEVICE_PATH,

+                                               HW_CONTROLLER_DP,

+                                               (UINT16) sizeof (CONTROLLER_DEVICE_PATH)

+                                               );

+  Controller->ControllerNumber = (UINT32) Strtoi (ControllerStr);

+

+  return (EFI_DEVICE_PATH_PROTOCOL *) Controller;

+}

+

+/**

+  Converts a text device path node to BMC device path structure.

+

+  @param TextDeviceNode  The input Text device path node.

+

+  @return A pointer to the newly-created BMC device path structure.

+

+**/

+EFI_DEVICE_PATH_PROTOCOL *

+DevPathFromTextBmc (

+  IN CHAR16 *TextDeviceNode

+  )

+{

+  CHAR16                *InterfaceTypeStr;

+  CHAR16                *BaseAddressStr;

+  BMC_DEVICE_PATH       *BmcDp;

+

+  InterfaceTypeStr = GetNextParamStr (&TextDeviceNode);

+  BaseAddressStr   = GetNextParamStr (&TextDeviceNode);

+  BmcDp            = (BMC_DEVICE_PATH *) CreateDeviceNode (

+                                           HARDWARE_DEVICE_PATH,

+                                           HW_BMC_DP,

+                                           (UINT16) sizeof (BMC_DEVICE_PATH)

+                                           );

+

+  BmcDp->InterfaceType = (UINT8) Strtoi (InterfaceTypeStr);

+  WriteUnaligned64 (

+    (UINT64 *) (&BmcDp->BaseAddress),

+    StrHexToUint64 (BaseAddressStr)

+    );

+

+  return (EFI_DEVICE_PATH_PROTOCOL *) BmcDp;

+}

+

+/**

+  Converts a generic ACPI text device path node to ACPI device path structure.

+

+  @param TextDeviceNode  The input Text device path node.

+

+  @return A pointer to ACPI device path structure.

+

+**/

+EFI_DEVICE_PATH_PROTOCOL *

+DevPathFromTextAcpiPath (

+  IN CHAR16 *TextDeviceNode

+  )

+{

+  return DevPathFromTextGenericPath (ACPI_DEVICE_PATH, TextDeviceNode);

+}

+

+/**

+  Converts a string to EisaId.

+

+  @param Text   The input string.

+

+  @return UINT32 EISA ID.

+**/

+UINT32

+EisaIdFromText (

+  IN CHAR16 *Text

+  )

+{

+  return (((Text[0] - 'A' + 1) & 0x1f) << 10)

+       + (((Text[1] - 'A' + 1) & 0x1f) <<  5)

+       + (((Text[2] - 'A' + 1) & 0x1f) <<  0)

+       + (UINT32) (StrHexToUintn (&Text[3]) << 16)

+       ;

+}

+

+/**

+  Converts a text device path node to ACPI HID device path structure.

+

+  @param TextDeviceNode  The input Text device path node.

+

+  @return A pointer to the newly-created ACPI HID device path structure.

+

+**/

+EFI_DEVICE_PATH_PROTOCOL *

+DevPathFromTextAcpi (

+  IN CHAR16 *TextDeviceNode

+  )

+{

+  CHAR16                *HIDStr;

+  CHAR16                *UIDStr;

+  ACPI_HID_DEVICE_PATH  *Acpi;

+

+  HIDStr = GetNextParamStr (&TextDeviceNode);

+  UIDStr = GetNextParamStr (&TextDeviceNode);

+  Acpi   = (ACPI_HID_DEVICE_PATH *) CreateDeviceNode (

+                                      ACPI_DEVICE_PATH,

+                                      ACPI_DP,

+                                      (UINT16) sizeof (ACPI_HID_DEVICE_PATH)

+                                      );

+

+  Acpi->HID = EisaIdFromText (HIDStr);

+  Acpi->UID = (UINT32) Strtoi (UIDStr);

+

+  return (EFI_DEVICE_PATH_PROTOCOL *) Acpi;

+}

+

+/**

+  Converts a text device path node to ACPI HID device path structure.

+

+  @param TextDeviceNode  The input Text device path node.

+  @param PnPId           The input plug and play identification.

+

+  @return A pointer to the newly-created ACPI HID device path structure.

+

+**/

+EFI_DEVICE_PATH_PROTOCOL *

+ConvertFromTextAcpi (

+  IN CHAR16 *TextDeviceNode,

+  IN UINT32  PnPId

+  )

+{

+  CHAR16                *UIDStr;

+  ACPI_HID_DEVICE_PATH  *Acpi;

+

+  UIDStr = GetNextParamStr (&TextDeviceNode);

+  Acpi   = (ACPI_HID_DEVICE_PATH *) CreateDeviceNode (

+                                      ACPI_DEVICE_PATH,

+                                      ACPI_DP,

+                                      (UINT16) sizeof (ACPI_HID_DEVICE_PATH)

+                                      );

+

+  Acpi->HID = EFI_PNP_ID (PnPId);

+  Acpi->UID = (UINT32) Strtoi (UIDStr);

+

+  return (EFI_DEVICE_PATH_PROTOCOL *) Acpi;

+}

+

+/**

+  Converts a text device path node to PCI root device path structure.

+

+  @param TextDeviceNode  The input Text device path node.

+

+  @return A pointer to the newly-created PCI root device path structure.

+

+**/

+EFI_DEVICE_PATH_PROTOCOL *

+DevPathFromTextPciRoot (

+  IN CHAR16 *TextDeviceNode

+  )

+{

+  return ConvertFromTextAcpi (TextDeviceNode, 0x0a03);

+}

+

+/**

+  Converts a text device path node to PCIE root device path structure.

+

+  @param TextDeviceNode  The input Text device path node.

+

+  @return A pointer to the newly-created PCIE root device path structure.

+

+**/

+EFI_DEVICE_PATH_PROTOCOL *

+DevPathFromTextPcieRoot (

+  IN CHAR16 *TextDeviceNode

+  )

+{

+  return ConvertFromTextAcpi (TextDeviceNode, 0x0a08);

+}

+

+/**

+  Converts a text device path node to Floppy device path structure.

+

+  @param TextDeviceNode  The input Text device path node.

+

+  @return A pointer to the newly-created Floppy device path structure.

+

+**/

+EFI_DEVICE_PATH_PROTOCOL *

+DevPathFromTextFloppy (

+  IN CHAR16 *TextDeviceNode

+  )

+{

+  return ConvertFromTextAcpi (TextDeviceNode, 0x0604);

+}

+

+/**

+  Converts a text device path node to Keyboard device path structure.

+

+  @param TextDeviceNode  The input Text device path node.

+

+  @return A pointer to the newly-created  Keyboard device path structure.

+

+**/

+EFI_DEVICE_PATH_PROTOCOL *

+DevPathFromTextKeyboard (

+  IN CHAR16 *TextDeviceNode

+  )

+{

+  return ConvertFromTextAcpi (TextDeviceNode, 0x0301);

+}

+

+/**

+  Converts a text device path node to Serial device path structure.

+

+  @param TextDeviceNode  The input Text device path node.

+

+  @return A pointer to the newly-created Serial device path structure.

+

+**/

+EFI_DEVICE_PATH_PROTOCOL *

+DevPathFromTextSerial (

+  IN CHAR16 *TextDeviceNode

+  )

+{

+  return ConvertFromTextAcpi (TextDeviceNode, 0x0501);

+}

+

+/**

+  Converts a text device path node to Parallel Port device path structure.

+

+  @param TextDeviceNode  The input Text device path node.

+

+  @return A pointer to the newly-created Parallel Port device path structure.

+

+**/

+EFI_DEVICE_PATH_PROTOCOL *

+DevPathFromTextParallelPort (

+  IN CHAR16 *TextDeviceNode

+  )

+{

+  return ConvertFromTextAcpi (TextDeviceNode, 0x0401);

+}

+

+/**

+  Converts a text device path node to ACPI extension device path structure.

+

+  @param TextDeviceNode  The input Text device path node.

+

+  @return A pointer to the newly-created ACPI extension device path structure.

+

+**/

+EFI_DEVICE_PATH_PROTOCOL *

+DevPathFromTextAcpiEx (

+  IN CHAR16 *TextDeviceNode

+  )

+{

+  CHAR16                         *HIDStr;

+  CHAR16                         *CIDStr;

+  CHAR16                         *UIDStr;

+  CHAR16                         *HIDSTRStr;

+  CHAR16                         *CIDSTRStr;

+  CHAR16                         *UIDSTRStr;

+  CHAR8                          *AsciiStr;

+  UINT16                         Length;

+  ACPI_EXTENDED_HID_DEVICE_PATH  *AcpiEx;

+

+  HIDStr    = GetNextParamStr (&TextDeviceNode);

+  CIDStr    = GetNextParamStr (&TextDeviceNode);

+  UIDStr    = GetNextParamStr (&TextDeviceNode);

+  HIDSTRStr = GetNextParamStr (&TextDeviceNode);

+  CIDSTRStr = GetNextParamStr (&TextDeviceNode);

+  UIDSTRStr = GetNextParamStr (&TextDeviceNode);

+

+  Length    = (UINT16) (sizeof (ACPI_EXTENDED_HID_DEVICE_PATH) + StrLen (HIDSTRStr) + 1);

+  Length    = (UINT16) (Length + StrLen (UIDSTRStr) + 1);

+  Length    = (UINT16) (Length + StrLen (CIDSTRStr) + 1);

+  AcpiEx = (ACPI_EXTENDED_HID_DEVICE_PATH *) CreateDeviceNode (

+                                               ACPI_DEVICE_PATH,

+                                               ACPI_EXTENDED_DP,

+                                               Length

+                                               );

+

+  AcpiEx->HID = EisaIdFromText (HIDStr);

+  AcpiEx->CID = EisaIdFromText (CIDStr);

+  AcpiEx->UID = (UINT32) Strtoi (UIDStr);

+

+  AsciiStr = (CHAR8 *) ((UINT8 *)AcpiEx + sizeof (ACPI_EXTENDED_HID_DEVICE_PATH));

+  StrToAscii (HIDSTRStr, &AsciiStr);

+  StrToAscii (UIDSTRStr, &AsciiStr);

+  StrToAscii (CIDSTRStr, &AsciiStr);

+

+  return (EFI_DEVICE_PATH_PROTOCOL *) AcpiEx;

+}

+

+/**

+  Converts a text device path node to ACPI extension device path structure.

+

+  @param TextDeviceNode  The input Text device path node.

+

+  @return A pointer to the newly-created ACPI extension device path structure.

+

+**/

+EFI_DEVICE_PATH_PROTOCOL *

+DevPathFromTextAcpiExp (

+  IN CHAR16 *TextDeviceNode

+  )

+{

+  CHAR16                         *HIDStr;

+  CHAR16                         *CIDStr;

+  CHAR16                         *UIDSTRStr;

+  CHAR8                          *AsciiStr;

+  UINT16                         Length;

+  ACPI_EXTENDED_HID_DEVICE_PATH  *AcpiEx;

+

+  HIDStr    = GetNextParamStr (&TextDeviceNode);

+  CIDStr    = GetNextParamStr (&TextDeviceNode);

+  UIDSTRStr = GetNextParamStr (&TextDeviceNode);

+  Length    = (UINT16) (sizeof (ACPI_EXTENDED_HID_DEVICE_PATH) + StrLen (UIDSTRStr) + 3);

+  AcpiEx    = (ACPI_EXTENDED_HID_DEVICE_PATH *) CreateDeviceNode (

+                                                  ACPI_DEVICE_PATH,

+                                                  ACPI_EXTENDED_DP,

+                                                  Length

+                                                  );

+

+  AcpiEx->HID = EisaIdFromText (HIDStr);

+  //

+  // According to UEFI spec, the CID parametr is optional and has a default value of 0.

+  // So when the CID parametr is not specified or specified as 0 in the text device node.

+  // Set the CID to 0 in the ACPI extension device path structure.

+  //

+  if (*CIDStr == L'\0' || *CIDStr == L'0') {

+    AcpiEx->CID = 0;

+  } else {

+    AcpiEx->CID = EisaIdFromText (CIDStr);

+  }

+  AcpiEx->UID = 0;

+

+  AsciiStr = (CHAR8 *) ((UINT8 *)AcpiEx + sizeof (ACPI_EXTENDED_HID_DEVICE_PATH));

+  //

+  // HID string is NULL

+  //

+  *AsciiStr = '\0';

+  //

+  // Convert UID string

+  //

+  AsciiStr++;

+  StrToAscii (UIDSTRStr, &AsciiStr);

+  //

+  // CID string is NULL

+  //

+  *AsciiStr = '\0';

+

+  return (EFI_DEVICE_PATH_PROTOCOL *) AcpiEx;

+}

+

+/**

+  Converts a text device path node to ACPI _ADR device path structure.

+

+  @param TextDeviceNode  The input Text device path node.

+

+  @return A pointer to the newly-created ACPI _ADR device path structure.

+

+**/

+EFI_DEVICE_PATH_PROTOCOL *

+DevPathFromTextAcpiAdr (

+  IN CHAR16 *TextDeviceNode

+  )

+{

+  CHAR16                *DisplayDeviceStr;

+  ACPI_ADR_DEVICE_PATH  *AcpiAdr;

+  UINTN                 Index;

+  UINTN                 Length;

+

+  AcpiAdr = (ACPI_ADR_DEVICE_PATH *) CreateDeviceNode (

+                                       ACPI_DEVICE_PATH,

+                                       ACPI_ADR_DP,

+                                       (UINT16) sizeof (ACPI_ADR_DEVICE_PATH)

+                                       );

+  ASSERT (AcpiAdr != NULL);

+

+  for (Index = 0; ; Index++) {

+    DisplayDeviceStr = GetNextParamStr (&TextDeviceNode);

+    if (IS_NULL (*DisplayDeviceStr)) {

+      break;

+    }

+    if (Index > 0) {

+      Length  = DevicePathNodeLength (AcpiAdr);

+      AcpiAdr = ReallocatePool (

+                  Length,

+                  Length + sizeof (UINT32),

+                  AcpiAdr

+                  );

+      ASSERT (AcpiAdr != NULL);

+      SetDevicePathNodeLength (AcpiAdr, Length + sizeof (UINT32));

+    }

+

+    (&AcpiAdr->ADR)[Index] = (UINT32) Strtoi (DisplayDeviceStr);

+  }

+

+  return (EFI_DEVICE_PATH_PROTOCOL *) AcpiAdr;

+}

+

+/**

+  Converts a generic messaging text device path node to messaging device path structure.

+

+  @param TextDeviceNode  The input Text device path node.

+

+  @return A pointer to messaging device path structure.

+

+**/

+EFI_DEVICE_PATH_PROTOCOL *

+DevPathFromTextMsg (

+  IN CHAR16 *TextDeviceNode

+  )

+{

+  return DevPathFromTextGenericPath (MESSAGING_DEVICE_PATH, TextDeviceNode);

+}

+

+/**

+  Converts a text device path node to Parallel Port device path structure.

+

+  @param TextDeviceNode  The input Text device path node.

+

+  @return A pointer to the newly-created Parallel Port device path structure.

+

+**/

+EFI_DEVICE_PATH_PROTOCOL *

+DevPathFromTextAta (

+IN CHAR16 *TextDeviceNode

+)

+{

+  CHAR16            *PrimarySecondaryStr;

+  CHAR16            *SlaveMasterStr;

+  CHAR16            *LunStr;

+  ATAPI_DEVICE_PATH *Atapi;

+

+  Atapi = (ATAPI_DEVICE_PATH *) CreateDeviceNode (

+    MESSAGING_DEVICE_PATH,

+    MSG_ATAPI_DP,

+    (UINT16) sizeof (ATAPI_DEVICE_PATH)

+    );

+

+  PrimarySecondaryStr = GetNextParamStr (&TextDeviceNode);

+  SlaveMasterStr      = GetNextParamStr (&TextDeviceNode);

+  LunStr              = GetNextParamStr (&TextDeviceNode);

+

+  if (StrCmp (PrimarySecondaryStr, L"Primary") == 0) {

+    Atapi->PrimarySecondary = 0;

+  } else if (StrCmp (PrimarySecondaryStr, L"Secondary") == 0) {

+    Atapi->PrimarySecondary = 1;

+  } else {

+    Atapi->PrimarySecondary = (UINT8) Strtoi (PrimarySecondaryStr);

+  }

+  if (StrCmp (SlaveMasterStr, L"Master") == 0) {

+    Atapi->SlaveMaster      = 0;

+  } else if (StrCmp (SlaveMasterStr, L"Slave") == 0) {

+    Atapi->SlaveMaster      = 1;

+  } else {

+    Atapi->SlaveMaster      = (UINT8) Strtoi (SlaveMasterStr);

+  }

+

+  Atapi->Lun                = (UINT16) Strtoi (LunStr);

+

+  return (EFI_DEVICE_PATH_PROTOCOL *) Atapi;

+}

+

+/**

+  Converts a text device path node to SCSI device path structure.

+

+  @param TextDeviceNode  The input Text device path node.

+

+  @return A pointer to the newly-created SCSI device path structure.

+

+**/

+EFI_DEVICE_PATH_PROTOCOL *

+DevPathFromTextScsi (

+  IN CHAR16 *TextDeviceNode

+  )

+{

+  CHAR16            *PunStr;

+  CHAR16            *LunStr;

+  SCSI_DEVICE_PATH  *Scsi;

+

+  PunStr = GetNextParamStr (&TextDeviceNode);

+  LunStr = GetNextParamStr (&TextDeviceNode);

+  Scsi   = (SCSI_DEVICE_PATH *) CreateDeviceNode (

+                                   MESSAGING_DEVICE_PATH,

+                                   MSG_SCSI_DP,

+                                   (UINT16) sizeof (SCSI_DEVICE_PATH)

+                                   );

+

+  Scsi->Pun = (UINT16) Strtoi (PunStr);

+  Scsi->Lun = (UINT16) Strtoi (LunStr);

+

+  return (EFI_DEVICE_PATH_PROTOCOL *) Scsi;

+}

+

+/**

+  Converts a text device path node to Fibre device path structure.

+

+  @param TextDeviceNode  The input Text device path node.

+

+  @return A pointer to the newly-created Fibre device path structure.

+

+**/

+EFI_DEVICE_PATH_PROTOCOL *

+DevPathFromTextFibre (

+  IN CHAR16 *TextDeviceNode

+  )

+{

+  CHAR16                    *WWNStr;

+  CHAR16                    *LunStr;

+  FIBRECHANNEL_DEVICE_PATH  *Fibre;

+

+  WWNStr = GetNextParamStr (&TextDeviceNode);

+  LunStr = GetNextParamStr (&TextDeviceNode);

+  Fibre  = (FIBRECHANNEL_DEVICE_PATH *) CreateDeviceNode (

+                                          MESSAGING_DEVICE_PATH,

+                                          MSG_FIBRECHANNEL_DP,

+                                          (UINT16) sizeof (FIBRECHANNEL_DEVICE_PATH)

+                                          );

+

+  Fibre->Reserved = 0;

+  Strtoi64 (WWNStr, &Fibre->WWN);

+  Strtoi64 (LunStr, &Fibre->Lun);

+

+  return (EFI_DEVICE_PATH_PROTOCOL *) Fibre;

+}

+

+/**

+  Converts a text device path node to FibreEx device path structure.

+

+  @param TextDeviceNode  The input Text device path node.

+

+  @return A pointer to the newly-created FibreEx device path structure.

+

+**/

+EFI_DEVICE_PATH_PROTOCOL *

+DevPathFromTextFibreEx (

+  IN CHAR16 *TextDeviceNode

+  )

+{

+  CHAR16                      *WWNStr;

+  CHAR16                      *LunStr;

+  FIBRECHANNELEX_DEVICE_PATH  *FibreEx;

+

+  WWNStr  = GetNextParamStr (&TextDeviceNode);

+  LunStr  = GetNextParamStr (&TextDeviceNode);

+  FibreEx = (FIBRECHANNELEX_DEVICE_PATH *) CreateDeviceNode (

+                                             MESSAGING_DEVICE_PATH,

+                                             MSG_FIBRECHANNELEX_DP,

+                                             (UINT16) sizeof (FIBRECHANNELEX_DEVICE_PATH)

+                                             );

+

+  FibreEx->Reserved = 0;

+  Strtoi64 (WWNStr, (UINT64 *) (&FibreEx->WWN));

+  Strtoi64 (LunStr, (UINT64 *) (&FibreEx->Lun));

+

+  *(UINT64 *) (&FibreEx->WWN) = SwapBytes64 (*(UINT64 *) (&FibreEx->WWN));

+  *(UINT64 *) (&FibreEx->Lun) = SwapBytes64 (*(UINT64 *) (&FibreEx->Lun));

+

+  return (EFI_DEVICE_PATH_PROTOCOL *) FibreEx;

+}

+

+/**

+  Converts a text device path node to 1394 device path structure.

+

+  @param TextDeviceNode  The input Text device path node.

+

+  @return A pointer to the newly-created 1394 device path structure.

+

+**/

+EFI_DEVICE_PATH_PROTOCOL *

+DevPathFromText1394 (

+  IN CHAR16 *TextDeviceNode

+  )

+{

+  CHAR16            *GuidStr;

+  F1394_DEVICE_PATH *F1394DevPath;

+

+  GuidStr = GetNextParamStr (&TextDeviceNode);

+  F1394DevPath  = (F1394_DEVICE_PATH *) CreateDeviceNode (

+                                          MESSAGING_DEVICE_PATH,

+                                          MSG_1394_DP,

+                                          (UINT16) sizeof (F1394_DEVICE_PATH)

+                                          );

+

+  F1394DevPath->Reserved = 0;

+  F1394DevPath->Guid     = StrHexToUint64 (GuidStr);

+

+  return (EFI_DEVICE_PATH_PROTOCOL *) F1394DevPath;

+}

+

+/**

+  Converts a text device path node to USB device path structure.

+

+  @param TextDeviceNode  The input Text device path node.

+

+  @return A pointer to the newly-created USB device path structure.

+

+**/

+EFI_DEVICE_PATH_PROTOCOL *

+DevPathFromTextUsb (

+  IN CHAR16 *TextDeviceNode

+  )

+{

+  CHAR16          *PortStr;

+  CHAR16          *InterfaceStr;

+  USB_DEVICE_PATH *Usb;

+

+  PortStr               = GetNextParamStr (&TextDeviceNode);

+  InterfaceStr          = GetNextParamStr (&TextDeviceNode);

+  Usb                   = (USB_DEVICE_PATH *) CreateDeviceNode (

+                                                MESSAGING_DEVICE_PATH,

+                                                MSG_USB_DP,

+                                                (UINT16) sizeof (USB_DEVICE_PATH)

+                                                );

+

+  Usb->ParentPortNumber = (UINT8) Strtoi (PortStr);

+  Usb->InterfaceNumber  = (UINT8) Strtoi (InterfaceStr);

+

+  return (EFI_DEVICE_PATH_PROTOCOL *) Usb;

+}

+

+/**

+  Converts a text device path node to I20 device path structure.

+

+  @param TextDeviceNode  The input Text device path node.

+

+  @return A pointer to the newly-created I20 device path structure.

+

+**/

+EFI_DEVICE_PATH_PROTOCOL *

+DevPathFromTextI2O (

+  IN CHAR16 *TextDeviceNode

+  )

+{

+  CHAR16          *TIDStr;

+  I2O_DEVICE_PATH *I2ODevPath;

+

+  TIDStr     = GetNextParamStr (&TextDeviceNode);

+  I2ODevPath = (I2O_DEVICE_PATH *) CreateDeviceNode (

+                                    MESSAGING_DEVICE_PATH,

+                                    MSG_I2O_DP,

+                                    (UINT16) sizeof (I2O_DEVICE_PATH)

+                                    );

+

+  I2ODevPath->Tid  = (UINT32) Strtoi (TIDStr);

+

+  return (EFI_DEVICE_PATH_PROTOCOL *) I2ODevPath;

+}

+

+/**

+  Converts a text device path node to Infini Band device path structure.

+

+  @param TextDeviceNode  The input Text device path node.

+

+  @return A pointer to the newly-created Infini Band device path structure.

+

+**/

+EFI_DEVICE_PATH_PROTOCOL *

+DevPathFromTextInfiniband (

+  IN CHAR16 *TextDeviceNode

+  )

+{

+  CHAR16                  *FlagsStr;

+  CHAR16                  *GuidStr;

+  CHAR16                  *SidStr;

+  CHAR16                  *TidStr;

+  CHAR16                  *DidStr;

+  INFINIBAND_DEVICE_PATH  *InfiniBand;

+

+  FlagsStr   = GetNextParamStr (&TextDeviceNode);

+  GuidStr    = GetNextParamStr (&TextDeviceNode);

+  SidStr     = GetNextParamStr (&TextDeviceNode);

+  TidStr     = GetNextParamStr (&TextDeviceNode);

+  DidStr     = GetNextParamStr (&TextDeviceNode);

+  InfiniBand = (INFINIBAND_DEVICE_PATH *) CreateDeviceNode (

+                                            MESSAGING_DEVICE_PATH,

+                                            MSG_INFINIBAND_DP,

+                                            (UINT16) sizeof (INFINIBAND_DEVICE_PATH)

+                                            );

+

+  InfiniBand->ResourceFlags = (UINT32) Strtoi (FlagsStr);

+  StrToGuid (GuidStr, (EFI_GUID *) InfiniBand->PortGid);

+  Strtoi64 (SidStr, &InfiniBand->ServiceId);

+  Strtoi64 (TidStr, &InfiniBand->TargetPortId);

+  Strtoi64 (DidStr, &InfiniBand->DeviceId);

+

+  return (EFI_DEVICE_PATH_PROTOCOL *) InfiniBand;

+}

+

+/**

+  Converts a text device path node to Vendor-Defined Messaging device path structure.

+

+  @param TextDeviceNode  The input Text device path node.

+

+  @return A pointer to the newly-created Vendor-Defined Messaging device path structure.

+

+**/

+EFI_DEVICE_PATH_PROTOCOL *

+DevPathFromTextVenMsg (

+  IN CHAR16 *TextDeviceNode

+  )

+{

+  return ConvertFromTextVendor (

+            TextDeviceNode,

+            MESSAGING_DEVICE_PATH,

+            MSG_VENDOR_DP

+            );

+}

+

+/**

+  Converts a text device path node to Vendor defined PC-ANSI device path structure.

+

+  @param TextDeviceNode  The input Text device path node.

+

+  @return A pointer to the newly-created Vendor defined PC-ANSI device path structure.

+

+**/

+EFI_DEVICE_PATH_PROTOCOL *

+DevPathFromTextVenPcAnsi (

+  IN CHAR16 *TextDeviceNode

+  )

+{

+  VENDOR_DEVICE_PATH  *Vendor;

+

+  Vendor = (VENDOR_DEVICE_PATH *) CreateDeviceNode (

+                                    MESSAGING_DEVICE_PATH,

+                                    MSG_VENDOR_DP,

+                                    (UINT16) sizeof (VENDOR_DEVICE_PATH));

+  CopyGuid (&Vendor->Guid, &gEfiPcAnsiGuid);

+

+  return (EFI_DEVICE_PATH_PROTOCOL *) Vendor;

+}

+

+/**

+  Converts a text device path node to Vendor defined VT100 device path structure.

+

+  @param TextDeviceNode  The input Text device path node.

+

+  @return A pointer to the newly-created Vendor defined VT100 device path structure.

+

+**/

+EFI_DEVICE_PATH_PROTOCOL *

+DevPathFromTextVenVt100 (

+  IN CHAR16 *TextDeviceNode

+  )

+{

+  VENDOR_DEVICE_PATH  *Vendor;

+

+  Vendor = (VENDOR_DEVICE_PATH *) CreateDeviceNode (

+                                    MESSAGING_DEVICE_PATH,

+                                    MSG_VENDOR_DP,

+                                    (UINT16) sizeof (VENDOR_DEVICE_PATH));

+  CopyGuid (&Vendor->Guid, &gEfiVT100Guid);

+

+  return (EFI_DEVICE_PATH_PROTOCOL *) Vendor;

+}

+

+/**

+  Converts a text device path node to Vendor defined VT100 Plus device path structure.

+

+  @param TextDeviceNode  The input Text device path node.

+

+  @return A pointer to the newly-created Vendor defined VT100 Plus device path structure.

+

+**/

+EFI_DEVICE_PATH_PROTOCOL *

+DevPathFromTextVenVt100Plus (

+  IN CHAR16 *TextDeviceNode

+  )

+{

+  VENDOR_DEVICE_PATH  *Vendor;

+

+  Vendor = (VENDOR_DEVICE_PATH *) CreateDeviceNode (

+                                    MESSAGING_DEVICE_PATH,

+                                    MSG_VENDOR_DP,

+                                    (UINT16) sizeof (VENDOR_DEVICE_PATH));

+  CopyGuid (&Vendor->Guid, &gEfiVT100PlusGuid);

+

+  return (EFI_DEVICE_PATH_PROTOCOL *) Vendor;

+}

+

+/**

+  Converts a text device path node to Vendor defined UTF8 device path structure.

+

+  @param TextDeviceNode  The input Text device path node.

+

+  @return A pointer to the newly-created Vendor defined UTF8 device path structure.

+

+**/

+EFI_DEVICE_PATH_PROTOCOL *

+DevPathFromTextVenUtf8 (

+  IN CHAR16 *TextDeviceNode

+  )

+{

+  VENDOR_DEVICE_PATH  *Vendor;

+

+  Vendor = (VENDOR_DEVICE_PATH *) CreateDeviceNode (

+                                    MESSAGING_DEVICE_PATH,

+                                    MSG_VENDOR_DP,

+                                    (UINT16) sizeof (VENDOR_DEVICE_PATH));

+  CopyGuid (&Vendor->Guid, &gEfiVTUTF8Guid);

+

+  return (EFI_DEVICE_PATH_PROTOCOL *) Vendor;

+}

+

+/**

+  Converts a text device path node to UART Flow Control device path structure.

+

+  @param TextDeviceNode  The input Text device path node.

+

+  @return A pointer to the newly-created UART Flow Control device path structure.

+

+**/

+EFI_DEVICE_PATH_PROTOCOL *

+DevPathFromTextUartFlowCtrl (

+  IN CHAR16 *TextDeviceNode

+  )

+{

+  CHAR16                        *ValueStr;

+  UART_FLOW_CONTROL_DEVICE_PATH *UartFlowControl;

+

+  ValueStr        = GetNextParamStr (&TextDeviceNode);

+  UartFlowControl = (UART_FLOW_CONTROL_DEVICE_PATH *) CreateDeviceNode (

+                                                        MESSAGING_DEVICE_PATH,

+                                                        MSG_VENDOR_DP,

+                                                        (UINT16) sizeof (UART_FLOW_CONTROL_DEVICE_PATH)

+                                                        );

+

+  CopyGuid (&UartFlowControl->Guid, &gEfiUartDevicePathGuid);

+  if (StrCmp (ValueStr, L"XonXoff") == 0) {

+    UartFlowControl->FlowControlMap = 2;

+  } else if (StrCmp (ValueStr, L"Hardware") == 0) {

+    UartFlowControl->FlowControlMap = 1;

+  } else {

+    UartFlowControl->FlowControlMap = 0;

+  }

+

+  return (EFI_DEVICE_PATH_PROTOCOL *) UartFlowControl;

+}

+

+/**

+  Converts a text device path node to Serial Attached SCSI device path structure.

+

+  @param TextDeviceNode  The input Text device path node.

+

+  @return A pointer to the newly-created Serial Attached SCSI device path structure.

+

+**/

+EFI_DEVICE_PATH_PROTOCOL *

+DevPathFromTextSAS (

+  IN CHAR16 *TextDeviceNode

+  )

+{

+  CHAR16          *AddressStr;

+  CHAR16          *LunStr;

+  CHAR16          *RTPStr;

+  CHAR16          *SASSATAStr;

+  CHAR16          *LocationStr;

+  CHAR16          *ConnectStr;

+  CHAR16          *DriveBayStr;

+  CHAR16          *ReservedStr;

+  UINT16          Info;

+  UINT16          Uint16;

+  SAS_DEVICE_PATH *Sas;

+

+  AddressStr  = GetNextParamStr (&TextDeviceNode);

+  LunStr      = GetNextParamStr (&TextDeviceNode);

+  RTPStr      = GetNextParamStr (&TextDeviceNode);

+  SASSATAStr  = GetNextParamStr (&TextDeviceNode);

+  LocationStr = GetNextParamStr (&TextDeviceNode);

+  ConnectStr  = GetNextParamStr (&TextDeviceNode);

+  DriveBayStr = GetNextParamStr (&TextDeviceNode);

+  ReservedStr = GetNextParamStr (&TextDeviceNode);

+  Sas         = (SAS_DEVICE_PATH *) CreateDeviceNode (

+                                       MESSAGING_DEVICE_PATH,

+                                       MSG_VENDOR_DP,

+                                       (UINT16) sizeof (SAS_DEVICE_PATH)

+                                       );

+

+  CopyGuid (&Sas->Guid, &gEfiSasDevicePathGuid);

+  Strtoi64 (AddressStr, &Sas->SasAddress);

+  Strtoi64 (LunStr, &Sas->Lun);

+  Sas->RelativeTargetPort = (UINT16) Strtoi (RTPStr);

+

+  if (StrCmp (SASSATAStr, L"NoTopology") == 0) {

+    Info = 0x0;

+

+  } else if ((StrCmp (SASSATAStr, L"SATA") == 0) || (StrCmp (SASSATAStr, L"SAS") == 0)) {

+

+    Uint16 = (UINT16) Strtoi (DriveBayStr);

+    if (Uint16 == 0) {

+      Info = 0x1;

+    } else {

+      Info = (UINT16) (0x2 | ((Uint16 - 1) << 8));

+    }

+

+    if (StrCmp (SASSATAStr, L"SATA") == 0) {

+      Info |= BIT4;

+    }

+

+    //

+    // Location is an integer between 0 and 1 or else

+    // the keyword Internal (0) or External (1).

+    //

+    if (StrCmp (LocationStr, L"External") == 0) {

+      Uint16 = 1;

+    } else if (StrCmp (LocationStr, L"Internal") == 0) {

+      Uint16 = 0;

+    } else {

+      Uint16 = ((UINT16) Strtoi (LocationStr) & BIT0);

+    }

+    Info |= (Uint16 << 5);

+

+    //

+    // Connect is an integer between 0 and 3 or else

+    // the keyword Direct (0) or Expanded (1).

+    //

+    if (StrCmp (ConnectStr, L"Expanded") == 0) {

+      Uint16 = 1;

+    } else if (StrCmp (ConnectStr, L"Direct") == 0) {

+      Uint16 = 0;

+    } else {

+      Uint16 = ((UINT16) Strtoi (ConnectStr) & (BIT0 | BIT1));

+    }

+    Info |= (Uint16 << 6);

+

+  } else {

+    Info = (UINT16) Strtoi (SASSATAStr);

+  }

+

+  Sas->DeviceTopology = Info;

+  Sas->Reserved       = (UINT32) Strtoi (ReservedStr);

+

+  return (EFI_DEVICE_PATH_PROTOCOL *) Sas;

+}

+

+/**

+  Converts a text device path node to Serial Attached SCSI Ex device path structure.

+

+  @param TextDeviceNode  The input Text device path node.

+

+  @return A pointer to the newly-created Serial Attached SCSI Ex device path structure.

+

+**/

+EFI_DEVICE_PATH_PROTOCOL *

+DevPathFromTextSasEx (

+  IN CHAR16 *TextDeviceNode

+  )

+{

+  CHAR16            *AddressStr;

+  CHAR16            *LunStr;

+  CHAR16            *RTPStr;

+  CHAR16            *SASSATAStr;

+  CHAR16            *LocationStr;

+  CHAR16            *ConnectStr;

+  CHAR16            *DriveBayStr;

+  UINT16            Info;

+  UINT16            Uint16;

+  UINT64            SasAddress;

+  UINT64            Lun;

+  SASEX_DEVICE_PATH *SasEx;

+

+  AddressStr  = GetNextParamStr (&TextDeviceNode);

+  LunStr      = GetNextParamStr (&TextDeviceNode);

+  RTPStr      = GetNextParamStr (&TextDeviceNode);

+  SASSATAStr  = GetNextParamStr (&TextDeviceNode);

+  LocationStr = GetNextParamStr (&TextDeviceNode);

+  ConnectStr  = GetNextParamStr (&TextDeviceNode);

+  DriveBayStr = GetNextParamStr (&TextDeviceNode);

+  SasEx       = (SASEX_DEVICE_PATH *) CreateDeviceNode (

+                                        MESSAGING_DEVICE_PATH,

+                                        MSG_SASEX_DP,

+                                        (UINT16) sizeof (SASEX_DEVICE_PATH)

+                                        );

+

+  Strtoi64 (AddressStr, &SasAddress);

+  Strtoi64 (LunStr,     &Lun);

+  WriteUnaligned64 ((UINT64 *) &SasEx->SasAddress, SwapBytes64 (SasAddress));

+  WriteUnaligned64 ((UINT64 *) &SasEx->Lun,        SwapBytes64 (Lun));

+  SasEx->RelativeTargetPort      = (UINT16) Strtoi (RTPStr);

+

+  if (StrCmp (SASSATAStr, L"NoTopology") == 0) {

+    Info = 0x0;

+

+  } else if ((StrCmp (SASSATAStr, L"SATA") == 0) || (StrCmp (SASSATAStr, L"SAS") == 0)) {

+

+    Uint16 = (UINT16) Strtoi (DriveBayStr);

+    if (Uint16 == 0) {

+      Info = 0x1;

+    } else {

+      Info = (UINT16) (0x2 | ((Uint16 - 1) << 8));

+    }

+

+    if (StrCmp (SASSATAStr, L"SATA") == 0) {

+      Info |= BIT4;

+    }

+

+    //

+    // Location is an integer between 0 and 1 or else

+    // the keyword Internal (0) or External (1).

+    //

+    if (StrCmp (LocationStr, L"External") == 0) {

+      Uint16 = 1;

+    } else if (StrCmp (LocationStr, L"Internal") == 0) {

+      Uint16 = 0;

+    } else {

+      Uint16 = ((UINT16) Strtoi (LocationStr) & BIT0);

+    }

+    Info |= (Uint16 << 5);

+

+    //

+    // Connect is an integer between 0 and 3 or else

+    // the keyword Direct (0) or Expanded (1).

+    //

+    if (StrCmp (ConnectStr, L"Expanded") == 0) {

+      Uint16 = 1;

+    } else if (StrCmp (ConnectStr, L"Direct") == 0) {

+      Uint16 = 0;

+    } else {

+      Uint16 = ((UINT16) Strtoi (ConnectStr) & (BIT0 | BIT1));

+    }

+    Info |= (Uint16 << 6);

+

+  } else {

+    Info = (UINT16) Strtoi (SASSATAStr);

+  }

+

+  SasEx->DeviceTopology = Info;

+

+  return (EFI_DEVICE_PATH_PROTOCOL *) SasEx;

+}

+

+/**

+  Converts a text device path node to NVM Express Namespace device path structure.

+

+  @param TextDeviceNode  The input Text device path node.

+

+  @return A pointer to the newly-created NVM Express Namespace device path structure.

+

+**/

+EFI_DEVICE_PATH_PROTOCOL *

+DevPathFromTextNVMe (

+  IN CHAR16 *TextDeviceNode

+  )

+{

+  CHAR16                     *NamespaceIdStr;

+  CHAR16                     *NamespaceUuidStr;

+  NVME_NAMESPACE_DEVICE_PATH *Nvme;

+  UINT8                      *Uuid;

+  UINTN                      Index;

+

+  NamespaceIdStr   = GetNextParamStr (&TextDeviceNode);

+  NamespaceUuidStr = GetNextParamStr (&TextDeviceNode);

+  Nvme = (NVME_NAMESPACE_DEVICE_PATH *) CreateDeviceNode (

+    MESSAGING_DEVICE_PATH,

+    MSG_NVME_NAMESPACE_DP,

+    (UINT16) sizeof (NVME_NAMESPACE_DEVICE_PATH)

+    );

+

+  Nvme->NamespaceId = (UINT32) Strtoi (NamespaceIdStr);

+  Uuid = (UINT8 *) &Nvme->NamespaceUuid;

+

+  Index = sizeof (Nvme->NamespaceUuid) / sizeof (UINT8);

+  while (Index-- != 0) {

+    Uuid[Index] = (UINT8) StrHexToUintn (SplitStr (&NamespaceUuidStr, L'-'));

+  }

+

+  return (EFI_DEVICE_PATH_PROTOCOL *) Nvme;

+}

+

+/**

+  Converts a text device path node to UFS device path structure.

+

+  @param TextDeviceNode  The input Text device path node.

+

+  @return A pointer to the newly-created UFS device path structure.

+

+**/

+EFI_DEVICE_PATH_PROTOCOL *

+DevPathFromTextUfs (

+  IN CHAR16 *TextDeviceNode

+  )

+{

+  CHAR16            *PunStr;

+  CHAR16            *LunStr;

+  UFS_DEVICE_PATH   *Ufs;

+

+  PunStr = GetNextParamStr (&TextDeviceNode);

+  LunStr = GetNextParamStr (&TextDeviceNode);

+  Ufs    = (UFS_DEVICE_PATH *) CreateDeviceNode (

+                                 MESSAGING_DEVICE_PATH,

+                                 MSG_UFS_DP,

+                                 (UINT16) sizeof (UFS_DEVICE_PATH)

+                                 );

+

+  Ufs->Pun = (UINT8) Strtoi (PunStr);

+  Ufs->Lun = (UINT8) Strtoi (LunStr);

+

+  return (EFI_DEVICE_PATH_PROTOCOL *) Ufs;

+}

+

+/**

+  Converts a text device path node to SD (Secure Digital) device path structure.

+

+  @param TextDeviceNode  The input Text device path node.

+

+  @return A pointer to the newly-created SD device path structure.

+

+**/

+EFI_DEVICE_PATH_PROTOCOL *

+DevPathFromTextSd (

+  IN CHAR16 *TextDeviceNode

+  )

+{

+  CHAR16            *SlotNumberStr;

+  SD_DEVICE_PATH    *Sd;

+

+  SlotNumberStr = GetNextParamStr (&TextDeviceNode);

+  Sd            = (SD_DEVICE_PATH *) CreateDeviceNode (

+                                       MESSAGING_DEVICE_PATH,

+                                       MSG_SD_DP,

+                                       (UINT16) sizeof (SD_DEVICE_PATH)

+                                       );

+

+  Sd->SlotNumber = (UINT8) Strtoi (SlotNumberStr);

+

+  return (EFI_DEVICE_PATH_PROTOCOL *) Sd;

+}

+

+/**

+  Converts a text device path node to EMMC (Embedded MMC) device path structure.

+

+  @param TextDeviceNode  The input Text device path node.

+

+  @return A pointer to the newly-created EMMC device path structure.

+

+**/

+EFI_DEVICE_PATH_PROTOCOL *

+DevPathFromTextEmmc (

+  IN CHAR16 *TextDeviceNode

+  )

+{

+  CHAR16            *SlotNumberStr;

+  EMMC_DEVICE_PATH  *Emmc;

+

+  SlotNumberStr = GetNextParamStr (&TextDeviceNode);

+  Emmc          = (EMMC_DEVICE_PATH *) CreateDeviceNode (

+                                       MESSAGING_DEVICE_PATH,

+                                       MSG_EMMC_DP,

+                                       (UINT16) sizeof (EMMC_DEVICE_PATH)

+                                       );

+

+  Emmc->SlotNumber = (UINT8) Strtoi (SlotNumberStr);

+

+  return (EFI_DEVICE_PATH_PROTOCOL *) Emmc;

+}

+

+/**

+  Converts a text device path node to Debug Port device path structure.

+

+  @param TextDeviceNode  The input Text device path node.

+

+  @return A pointer to the newly-created Debug Port device path structure.

+

+**/

+EFI_DEVICE_PATH_PROTOCOL *

+DevPathFromTextDebugPort (

+  IN CHAR16 *TextDeviceNode

+  )

+{

+  VENDOR_DEVICE_PATH  *Vend;

+

+  Vend = (VENDOR_DEVICE_PATH *) CreateDeviceNode (

+                                                    MESSAGING_DEVICE_PATH,

+                                                    MSG_VENDOR_DP,

+                                                    (UINT16) sizeof (VENDOR_DEVICE_PATH)

+                                                    );

+

+  CopyGuid (&Vend->Guid, &gEfiDebugPortProtocolGuid);

+

+  return (EFI_DEVICE_PATH_PROTOCOL *) Vend;

+}

+

+/**

+  Converts a text device path node to MAC device path structure.

+

+  @param TextDeviceNode  The input Text device path node.

+

+  @return A pointer to the newly-created MAC device path structure.

+

+**/

+EFI_DEVICE_PATH_PROTOCOL *

+DevPathFromTextMAC (

+  IN CHAR16 *TextDeviceNode

+  )

+{

+  CHAR16                *AddressStr;

+  CHAR16                *IfTypeStr;

+  UINTN                 Length;

+  MAC_ADDR_DEVICE_PATH  *MACDevPath;

+

+  AddressStr    = GetNextParamStr (&TextDeviceNode);

+  IfTypeStr     = GetNextParamStr (&TextDeviceNode);

+  MACDevPath    = (MAC_ADDR_DEVICE_PATH *) CreateDeviceNode (

+                                              MESSAGING_DEVICE_PATH,

+                                              MSG_MAC_ADDR_DP,

+                                              (UINT16) sizeof (MAC_ADDR_DEVICE_PATH)

+                                              );

+

+  MACDevPath->IfType   = (UINT8) Strtoi (IfTypeStr);

+

+  Length = sizeof (EFI_MAC_ADDRESS);

+  if (MACDevPath->IfType == 0x01 || MACDevPath->IfType == 0x00) {

+    Length = 6;

+  }

+

+  StrHexToBytes (AddressStr, Length * 2, MACDevPath->MacAddress.Addr, Length);

+

+  return (EFI_DEVICE_PATH_PROTOCOL *) MACDevPath;

+}

+

+

+/**

+  Converts a text format to the network protocol ID.

+

+  @param Text  String of protocol field.

+

+  @return Network protocol ID .

+

+**/

+UINTN

+NetworkProtocolFromText (

+  IN CHAR16 *Text

+  )

+{

+  if (StrCmp (Text, L"UDP") == 0) {

+    return RFC_1700_UDP_PROTOCOL;

+  }

+

+  if (StrCmp (Text, L"TCP") == 0) {

+    return RFC_1700_TCP_PROTOCOL;

+  }

+

+  return Strtoi (Text);

+}

+

+

+/**

+  Converts a text device path node to IPV4 device path structure.

+

+  @param TextDeviceNode  The input Text device path node.

+

+  @return A pointer to the newly-created IPV4 device path structure.

+

+**/

+EFI_DEVICE_PATH_PROTOCOL *

+DevPathFromTextIPv4 (

+  IN CHAR16 *TextDeviceNode

+  )

+{

+  CHAR16            *RemoteIPStr;

+  CHAR16            *ProtocolStr;

+  CHAR16            *TypeStr;

+  CHAR16            *LocalIPStr;

+  CHAR16            *GatewayIPStr;

+  CHAR16            *SubnetMaskStr;

+  IPv4_DEVICE_PATH  *IPv4;

+

+  RemoteIPStr           = GetNextParamStr (&TextDeviceNode);

+  ProtocolStr           = GetNextParamStr (&TextDeviceNode);

+  TypeStr               = GetNextParamStr (&TextDeviceNode);

+  LocalIPStr            = GetNextParamStr (&TextDeviceNode);

+  GatewayIPStr          = GetNextParamStr (&TextDeviceNode);

+  SubnetMaskStr         = GetNextParamStr (&TextDeviceNode);

+  IPv4                  = (IPv4_DEVICE_PATH *) CreateDeviceNode (

+                                                 MESSAGING_DEVICE_PATH,

+                                                 MSG_IPv4_DP,

+                                                 (UINT16) sizeof (IPv4_DEVICE_PATH)

+                                                 );

+

+  StrToIpv4Address (RemoteIPStr, NULL, &IPv4->RemoteIpAddress, NULL);

+  IPv4->Protocol = (UINT16) NetworkProtocolFromText (ProtocolStr);

+  if (StrCmp (TypeStr, L"Static") == 0) {

+    IPv4->StaticIpAddress = TRUE;

+  } else {

+    IPv4->StaticIpAddress = FALSE;

+  }

+

+  StrToIpv4Address (LocalIPStr, NULL, &IPv4->LocalIpAddress, NULL);

+  if (!IS_NULL (*GatewayIPStr) && !IS_NULL (*SubnetMaskStr)) {

+    StrToIpv4Address (GatewayIPStr,  NULL, &IPv4->GatewayIpAddress, NULL);

+    StrToIpv4Address (SubnetMaskStr, NULL, &IPv4->SubnetMask,       NULL);

+  } else {

+    ZeroMem (&IPv4->GatewayIpAddress, sizeof (IPv4->GatewayIpAddress));

+    ZeroMem (&IPv4->SubnetMask,    sizeof (IPv4->SubnetMask));

+  }

+

+  IPv4->LocalPort       = 0;

+  IPv4->RemotePort      = 0;

+

+  return (EFI_DEVICE_PATH_PROTOCOL *) IPv4;

+}

+

+/**

+  Converts a text device path node to IPV6 device path structure.

+

+  @param TextDeviceNode  The input Text device path node.

+

+  @return A pointer to the newly-created IPV6 device path structure.

+

+**/

+EFI_DEVICE_PATH_PROTOCOL *

+DevPathFromTextIPv6 (

+  IN CHAR16 *TextDeviceNode

+  )

+{

+  CHAR16            *RemoteIPStr;

+  CHAR16            *ProtocolStr;

+  CHAR16            *TypeStr;

+  CHAR16            *LocalIPStr;

+  CHAR16            *GatewayIPStr;

+  CHAR16            *PrefixLengthStr;

+  IPv6_DEVICE_PATH  *IPv6;

+

+  RemoteIPStr           = GetNextParamStr (&TextDeviceNode);

+  ProtocolStr           = GetNextParamStr (&TextDeviceNode);

+  TypeStr               = GetNextParamStr (&TextDeviceNode);

+  LocalIPStr            = GetNextParamStr (&TextDeviceNode);

+  PrefixLengthStr       = GetNextParamStr (&TextDeviceNode);

+  GatewayIPStr          = GetNextParamStr (&TextDeviceNode);

+  IPv6                  = (IPv6_DEVICE_PATH *) CreateDeviceNode (

+                                                 MESSAGING_DEVICE_PATH,

+                                                 MSG_IPv6_DP,

+                                                 (UINT16) sizeof (IPv6_DEVICE_PATH)

+                                                 );

+

+  StrToIpv6Address (RemoteIPStr, NULL, &IPv6->RemoteIpAddress, NULL);

+  IPv6->Protocol        = (UINT16) NetworkProtocolFromText (ProtocolStr);

+  if (StrCmp (TypeStr, L"Static") == 0) {

+    IPv6->IpAddressOrigin = 0;

+  } else if (StrCmp (TypeStr, L"StatelessAutoConfigure") == 0) {

+    IPv6->IpAddressOrigin = 1;

+  } else {

+    IPv6->IpAddressOrigin = 2;

+  }

+

+  StrToIpv6Address (LocalIPStr, NULL, &IPv6->LocalIpAddress, NULL);

+  if (!IS_NULL (*GatewayIPStr) && !IS_NULL (*PrefixLengthStr)) {

+    StrToIpv6Address (GatewayIPStr, NULL, &IPv6->GatewayIpAddress, NULL);

+    IPv6->PrefixLength = (UINT8) Strtoi (PrefixLengthStr);

+  } else {

+    ZeroMem (&IPv6->GatewayIpAddress, sizeof (IPv6->GatewayIpAddress));

+    IPv6->PrefixLength = 0;

+  }

+

+  IPv6->LocalPort       = 0;

+  IPv6->RemotePort      = 0;

+

+  return (EFI_DEVICE_PATH_PROTOCOL *) IPv6;

+}

+

+/**

+  Converts a text device path node to UART device path structure.

+

+  @param TextDeviceNode  The input Text device path node.

+

+  @return A pointer to the newly-created UART device path structure.

+

+**/

+EFI_DEVICE_PATH_PROTOCOL *

+DevPathFromTextUart (

+  IN CHAR16 *TextDeviceNode

+  )

+{

+  CHAR16            *BaudStr;

+  CHAR16            *DataBitsStr;

+  CHAR16            *ParityStr;

+  CHAR16            *StopBitsStr;

+  UART_DEVICE_PATH  *Uart;

+

+  BaudStr         = GetNextParamStr (&TextDeviceNode);

+  DataBitsStr     = GetNextParamStr (&TextDeviceNode);

+  ParityStr       = GetNextParamStr (&TextDeviceNode);

+  StopBitsStr     = GetNextParamStr (&TextDeviceNode);

+  Uart            = (UART_DEVICE_PATH *) CreateDeviceNode (

+                                           MESSAGING_DEVICE_PATH,

+                                           MSG_UART_DP,

+                                           (UINT16) sizeof (UART_DEVICE_PATH)

+                                           );

+

+  if (StrCmp (BaudStr, L"DEFAULT") == 0) {

+    Uart->BaudRate = 115200;

+  } else {

+    Strtoi64 (BaudStr, &Uart->BaudRate);

+  }

+  Uart->DataBits  = (UINT8) ((StrCmp (DataBitsStr, L"DEFAULT") == 0) ? 8 : Strtoi (DataBitsStr));

+  switch (*ParityStr) {

+  case L'D':

+    Uart->Parity = 0;

+    break;

+

+  case L'N':

+    Uart->Parity = 1;

+    break;

+

+  case L'E':

+    Uart->Parity = 2;

+    break;

+

+  case L'O':

+    Uart->Parity = 3;

+    break;

+

+  case L'M':

+    Uart->Parity = 4;

+    break;

+

+  case L'S':

+    Uart->Parity = 5;

+    break;

+

+  default:

+    Uart->Parity = (UINT8) Strtoi (ParityStr);

+    break;

+  }

+

+  if (StrCmp (StopBitsStr, L"D") == 0) {

+    Uart->StopBits = (UINT8) 0;

+  } else if (StrCmp (StopBitsStr, L"1") == 0) {

+    Uart->StopBits = (UINT8) 1;

+  } else if (StrCmp (StopBitsStr, L"1.5") == 0) {

+    Uart->StopBits = (UINT8) 2;

+  } else if (StrCmp (StopBitsStr, L"2") == 0) {

+    Uart->StopBits = (UINT8) 3;

+  } else {

+    Uart->StopBits = (UINT8) Strtoi (StopBitsStr);

+  }

+

+  return (EFI_DEVICE_PATH_PROTOCOL *) Uart;

+}

+

+/**

+  Converts a text device path node to USB class device path structure.

+

+  @param TextDeviceNode  The input Text device path node.

+  @param UsbClassText    A pointer to USB_CLASS_TEXT structure to be integrated to USB Class Text.

+

+  @return A pointer to the newly-created USB class device path structure.

+

+**/

+EFI_DEVICE_PATH_PROTOCOL *

+ConvertFromTextUsbClass (

+  IN CHAR16         *TextDeviceNode,

+  IN USB_CLASS_TEXT *UsbClassText

+  )

+{

+  CHAR16                *VIDStr;

+  CHAR16                *PIDStr;

+  CHAR16                *ClassStr;

+  CHAR16                *SubClassStr;

+  CHAR16                *ProtocolStr;

+  USB_CLASS_DEVICE_PATH *UsbClass;

+

+  UsbClass    = (USB_CLASS_DEVICE_PATH *) CreateDeviceNode (

+                                            MESSAGING_DEVICE_PATH,

+                                            MSG_USB_CLASS_DP,

+                                            (UINT16) sizeof (USB_CLASS_DEVICE_PATH)

+                                            );

+

+  VIDStr      = GetNextParamStr (&TextDeviceNode);

+  PIDStr      = GetNextParamStr (&TextDeviceNode);

+  if (UsbClassText->ClassExist) {

+    ClassStr = GetNextParamStr (&TextDeviceNode);

+    if (*ClassStr == L'\0') {

+      UsbClass->DeviceClass = 0xFF;

+    } else {

+      UsbClass->DeviceClass = (UINT8) Strtoi (ClassStr);

+    }

+  } else {

+    UsbClass->DeviceClass = UsbClassText->Class;

+  }

+  if (UsbClassText->SubClassExist) {

+    SubClassStr = GetNextParamStr (&TextDeviceNode);

+    if (*SubClassStr == L'\0') {

+      UsbClass->DeviceSubClass = 0xFF;

+    } else {

+      UsbClass->DeviceSubClass = (UINT8) Strtoi (SubClassStr);

+    }

+  } else {

+    UsbClass->DeviceSubClass = UsbClassText->SubClass;

+  }

+

+  ProtocolStr = GetNextParamStr (&TextDeviceNode);

+

+  if (*VIDStr == L'\0') {

+    UsbClass->VendorId        = 0xFFFF;

+  } else {

+    UsbClass->VendorId        = (UINT16) Strtoi (VIDStr);

+  }

+  if (*PIDStr == L'\0') {

+    UsbClass->ProductId       = 0xFFFF;

+  } else {

+    UsbClass->ProductId       = (UINT16) Strtoi (PIDStr);

+  }

+  if (*ProtocolStr == L'\0') {

+    UsbClass->DeviceProtocol  = 0xFF;

+  } else {

+    UsbClass->DeviceProtocol  = (UINT8) Strtoi (ProtocolStr);

+  }

+

+  return (EFI_DEVICE_PATH_PROTOCOL *) UsbClass;

+}

+

+

+/**

+  Converts a text device path node to USB class device path structure.

+

+  @param TextDeviceNode  The input Text device path node.

+

+  @return A pointer to the newly-created USB class device path structure.

+

+**/

+EFI_DEVICE_PATH_PROTOCOL *

+DevPathFromTextUsbClass (

+  IN CHAR16 *TextDeviceNode

+  )

+{

+  USB_CLASS_TEXT  UsbClassText;

+

+  UsbClassText.ClassExist    = TRUE;

+  UsbClassText.SubClassExist = TRUE;

+

+  return ConvertFromTextUsbClass (TextDeviceNode, &UsbClassText);

+}

+

+/**

+  Converts a text device path node to USB audio device path structure.

+

+  @param TextDeviceNode  The input Text device path node.

+

+  @return A pointer to the newly-created USB audio device path structure.

+

+**/

+EFI_DEVICE_PATH_PROTOCOL *

+DevPathFromTextUsbAudio (

+  IN CHAR16 *TextDeviceNode

+  )

+{

+  USB_CLASS_TEXT  UsbClassText;

+

+  UsbClassText.ClassExist    = FALSE;

+  UsbClassText.Class         = USB_CLASS_AUDIO;

+  UsbClassText.SubClassExist = TRUE;

+

+  return ConvertFromTextUsbClass (TextDeviceNode, &UsbClassText);

+}

+

+/**

+  Converts a text device path node to USB CDC Control device path structure.

+

+  @param TextDeviceNode  The input Text device path node.

+

+  @return A pointer to the newly-created USB CDC Control device path structure.

+

+**/

+EFI_DEVICE_PATH_PROTOCOL *

+DevPathFromTextUsbCDCControl (

+  IN CHAR16 *TextDeviceNode

+  )

+{

+  USB_CLASS_TEXT  UsbClassText;

+

+  UsbClassText.ClassExist    = FALSE;

+  UsbClassText.Class         = USB_CLASS_CDCCONTROL;

+  UsbClassText.SubClassExist = TRUE;

+

+  return ConvertFromTextUsbClass (TextDeviceNode, &UsbClassText);

+}

+

+/**

+  Converts a text device path node to USB HID device path structure.

+

+  @param TextDeviceNode  The input Text device path node.

+

+  @return A pointer to the newly-created USB HID device path structure.

+

+**/

+EFI_DEVICE_PATH_PROTOCOL *

+DevPathFromTextUsbHID (

+  IN CHAR16 *TextDeviceNode

+  )

+{

+  USB_CLASS_TEXT  UsbClassText;

+

+  UsbClassText.ClassExist    = FALSE;

+  UsbClassText.Class         = USB_CLASS_HID;

+  UsbClassText.SubClassExist = TRUE;

+

+  return ConvertFromTextUsbClass (TextDeviceNode, &UsbClassText);

+}

+

+/**

+  Converts a text device path node to USB Image device path structure.

+

+  @param TextDeviceNode  The input Text device path node.

+

+  @return A pointer to the newly-created USB Image device path structure.

+

+**/

+EFI_DEVICE_PATH_PROTOCOL *

+DevPathFromTextUsbImage (

+  IN CHAR16 *TextDeviceNode

+  )

+{

+  USB_CLASS_TEXT  UsbClassText;

+

+  UsbClassText.ClassExist    = FALSE;

+  UsbClassText.Class         = USB_CLASS_IMAGE;

+  UsbClassText.SubClassExist = TRUE;

+

+  return ConvertFromTextUsbClass (TextDeviceNode, &UsbClassText);

+}

+

+/**

+  Converts a text device path node to USB Print device path structure.

+

+  @param TextDeviceNode  The input Text device path node.

+

+  @return A pointer to the newly-created USB Print device path structure.

+

+**/

+EFI_DEVICE_PATH_PROTOCOL *

+DevPathFromTextUsbPrinter (

+  IN CHAR16 *TextDeviceNode

+  )

+{

+  USB_CLASS_TEXT  UsbClassText;

+

+  UsbClassText.ClassExist    = FALSE;

+  UsbClassText.Class         = USB_CLASS_PRINTER;

+  UsbClassText.SubClassExist = TRUE;

+

+  return ConvertFromTextUsbClass (TextDeviceNode, &UsbClassText);

+}

+

+/**

+  Converts a text device path node to USB mass storage device path structure.

+

+  @param TextDeviceNode  The input Text device path node.

+

+  @return A pointer to the newly-created USB mass storage device path structure.

+

+**/

+EFI_DEVICE_PATH_PROTOCOL *

+DevPathFromTextUsbMassStorage (

+  IN CHAR16 *TextDeviceNode

+  )

+{

+  USB_CLASS_TEXT  UsbClassText;

+

+  UsbClassText.ClassExist    = FALSE;

+  UsbClassText.Class         = USB_CLASS_MASS_STORAGE;

+  UsbClassText.SubClassExist = TRUE;

+

+  return ConvertFromTextUsbClass (TextDeviceNode, &UsbClassText);

+}

+

+/**

+  Converts a text device path node to USB HUB device path structure.

+

+  @param TextDeviceNode  The input Text device path node.

+

+  @return A pointer to the newly-created USB HUB device path structure.

+

+**/

+EFI_DEVICE_PATH_PROTOCOL *

+DevPathFromTextUsbHub (

+  IN CHAR16 *TextDeviceNode

+  )

+{

+  USB_CLASS_TEXT  UsbClassText;

+

+  UsbClassText.ClassExist    = FALSE;

+  UsbClassText.Class         = USB_CLASS_HUB;

+  UsbClassText.SubClassExist = TRUE;

+

+  return ConvertFromTextUsbClass (TextDeviceNode, &UsbClassText);

+}

+

+/**

+  Converts a text device path node to USB CDC data device path structure.

+

+  @param TextDeviceNode  The input Text device path node.

+

+  @return A pointer to the newly-created USB CDC data device path structure.

+

+**/

+EFI_DEVICE_PATH_PROTOCOL *

+DevPathFromTextUsbCDCData (

+  IN CHAR16 *TextDeviceNode

+  )

+{

+  USB_CLASS_TEXT  UsbClassText;

+

+  UsbClassText.ClassExist    = FALSE;

+  UsbClassText.Class         = USB_CLASS_CDCDATA;

+  UsbClassText.SubClassExist = TRUE;

+

+  return ConvertFromTextUsbClass (TextDeviceNode, &UsbClassText);

+}

+

+/**

+  Converts a text device path node to USB smart card device path structure.

+

+  @param TextDeviceNode  The input Text device path node.

+

+  @return A pointer to the newly-created USB smart card device path structure.

+

+**/

+EFI_DEVICE_PATH_PROTOCOL *

+DevPathFromTextUsbSmartCard (

+  IN CHAR16 *TextDeviceNode

+  )

+{

+  USB_CLASS_TEXT  UsbClassText;

+

+  UsbClassText.ClassExist    = FALSE;

+  UsbClassText.Class         = USB_CLASS_SMART_CARD;

+  UsbClassText.SubClassExist = TRUE;

+

+  return ConvertFromTextUsbClass (TextDeviceNode, &UsbClassText);

+}

+

+/**

+  Converts a text device path node to USB video device path structure.

+

+  @param TextDeviceNode  The input Text device path node.

+

+  @return A pointer to the newly-created USB video device path structure.

+

+**/

+EFI_DEVICE_PATH_PROTOCOL *

+DevPathFromTextUsbVideo (

+  IN CHAR16 *TextDeviceNode

+  )

+{

+  USB_CLASS_TEXT  UsbClassText;

+

+  UsbClassText.ClassExist    = FALSE;

+  UsbClassText.Class         = USB_CLASS_VIDEO;

+  UsbClassText.SubClassExist = TRUE;

+

+  return ConvertFromTextUsbClass (TextDeviceNode, &UsbClassText);

+}

+

+/**

+  Converts a text device path node to USB diagnostic device path structure.

+

+  @param TextDeviceNode  The input Text device path node.

+

+  @return A pointer to the newly-created USB diagnostic device path structure.

+

+**/

+EFI_DEVICE_PATH_PROTOCOL *

+DevPathFromTextUsbDiagnostic (

+  IN CHAR16 *TextDeviceNode

+  )

+{

+  USB_CLASS_TEXT  UsbClassText;

+

+  UsbClassText.ClassExist    = FALSE;

+  UsbClassText.Class         = USB_CLASS_DIAGNOSTIC;

+  UsbClassText.SubClassExist = TRUE;

+

+  return ConvertFromTextUsbClass (TextDeviceNode, &UsbClassText);

+}

+

+/**

+  Converts a text device path node to USB wireless device path structure.

+

+  @param TextDeviceNode  The input Text device path node.

+

+  @return A pointer to the newly-created USB wireless device path structure.

+

+**/

+EFI_DEVICE_PATH_PROTOCOL *

+DevPathFromTextUsbWireless (

+  IN CHAR16 *TextDeviceNode

+  )

+{

+  USB_CLASS_TEXT  UsbClassText;

+

+  UsbClassText.ClassExist    = FALSE;

+  UsbClassText.Class         = USB_CLASS_WIRELESS;

+  UsbClassText.SubClassExist = TRUE;

+

+  return ConvertFromTextUsbClass (TextDeviceNode, &UsbClassText);

+}

+

+/**

+  Converts a text device path node to USB device firmware update device path structure.

+

+  @param TextDeviceNode  The input Text device path node.

+

+  @return A pointer to the newly-created USB device firmware update device path structure.

+

+**/

+EFI_DEVICE_PATH_PROTOCOL *

+DevPathFromTextUsbDeviceFirmwareUpdate (

+  IN CHAR16 *TextDeviceNode

+  )

+{

+  USB_CLASS_TEXT  UsbClassText;

+

+  UsbClassText.ClassExist    = FALSE;

+  UsbClassText.Class         = USB_CLASS_RESERVE;

+  UsbClassText.SubClassExist = FALSE;

+  UsbClassText.SubClass      = USB_SUBCLASS_FW_UPDATE;

+

+  return ConvertFromTextUsbClass (TextDeviceNode, &UsbClassText);

+}

+

+/**

+  Converts a text device path node to USB IRDA bridge device path structure.

+

+  @param TextDeviceNode  The input Text device path node.

+

+  @return A pointer to the newly-created USB IRDA bridge device path structure.

+

+**/

+EFI_DEVICE_PATH_PROTOCOL *

+DevPathFromTextUsbIrdaBridge (

+  IN CHAR16 *TextDeviceNode

+  )

+{

+  USB_CLASS_TEXT  UsbClassText;

+

+  UsbClassText.ClassExist    = FALSE;

+  UsbClassText.Class         = USB_CLASS_RESERVE;

+  UsbClassText.SubClassExist = FALSE;

+  UsbClassText.SubClass      = USB_SUBCLASS_IRDA_BRIDGE;

+

+  return ConvertFromTextUsbClass (TextDeviceNode, &UsbClassText);

+}

+

+/**

+  Converts a text device path node to USB text and measurement device path structure.

+

+  @param TextDeviceNode  The input Text device path node.

+

+  @return A pointer to the newly-created USB text and measurement device path structure.

+

+**/

+EFI_DEVICE_PATH_PROTOCOL *

+DevPathFromTextUsbTestAndMeasurement (

+  IN CHAR16 *TextDeviceNode

+  )

+{

+  USB_CLASS_TEXT  UsbClassText;

+

+  UsbClassText.ClassExist    = FALSE;

+  UsbClassText.Class         = USB_CLASS_RESERVE;

+  UsbClassText.SubClassExist = FALSE;

+  UsbClassText.SubClass      = USB_SUBCLASS_TEST;

+

+  return ConvertFromTextUsbClass (TextDeviceNode, &UsbClassText);

+}

+

+/**

+  Converts a text device path node to USB WWID device path structure.

+

+  @param TextDeviceNode  The input Text device path node.

+

+  @return A pointer to the newly-created USB WWID device path structure.

+

+**/

+EFI_DEVICE_PATH_PROTOCOL *

+DevPathFromTextUsbWwid (

+  IN CHAR16 *TextDeviceNode

+  )

+{

+  CHAR16                *VIDStr;

+  CHAR16                *PIDStr;

+  CHAR16                *InterfaceNumStr;

+  CHAR16                *SerialNumberStr;

+  USB_WWID_DEVICE_PATH  *UsbWwid;

+  UINTN                 SerialNumberStrLen;

+

+  VIDStr                   = GetNextParamStr (&TextDeviceNode);

+  PIDStr                   = GetNextParamStr (&TextDeviceNode);

+  InterfaceNumStr          = GetNextParamStr (&TextDeviceNode);

+  SerialNumberStr          = GetNextParamStr (&TextDeviceNode);

+  SerialNumberStrLen       = StrLen (SerialNumberStr);

+  if (SerialNumberStrLen >= 2 &&

+      SerialNumberStr[0] == L'\"' &&

+      SerialNumberStr[SerialNumberStrLen - 1] == L'\"'

+    ) {

+    SerialNumberStr[SerialNumberStrLen - 1] = L'\0';

+    SerialNumberStr++;

+    SerialNumberStrLen -= 2;

+  }

+  UsbWwid                  = (USB_WWID_DEVICE_PATH *) CreateDeviceNode (

+                                                         MESSAGING_DEVICE_PATH,

+                                                         MSG_USB_WWID_DP,

+                                                         (UINT16) (sizeof (USB_WWID_DEVICE_PATH) + SerialNumberStrLen * sizeof (CHAR16))

+                                                         );

+  UsbWwid->VendorId        = (UINT16) Strtoi (VIDStr);

+  UsbWwid->ProductId       = (UINT16) Strtoi (PIDStr);

+  UsbWwid->InterfaceNumber = (UINT16) Strtoi (InterfaceNumStr);

+

+  //

+  // There is no memory allocated in UsbWwid for the '\0' in SerialNumberStr.

+  // Therefore, the '\0' will not be copied.

+  //

+  CopyMem (

+    (UINT8 *) UsbWwid + sizeof (USB_WWID_DEVICE_PATH),

+    SerialNumberStr,

+    SerialNumberStrLen * sizeof (CHAR16)

+    );

+

+  return (EFI_DEVICE_PATH_PROTOCOL *) UsbWwid;

+}

+

+/**

+  Converts a text device path node to Logic Unit device path structure.

+

+  @param TextDeviceNode  The input Text device path node.

+

+  @return A pointer to the newly-created Logic Unit device path structure.

+

+**/

+EFI_DEVICE_PATH_PROTOCOL *

+DevPathFromTextUnit (

+  IN CHAR16 *TextDeviceNode

+  )

+{

+  CHAR16                          *LunStr;

+  DEVICE_LOGICAL_UNIT_DEVICE_PATH *LogicalUnit;

+

+  LunStr      = GetNextParamStr (&TextDeviceNode);

+  LogicalUnit = (DEVICE_LOGICAL_UNIT_DEVICE_PATH *) CreateDeviceNode (

+                                                      MESSAGING_DEVICE_PATH,

+                                                      MSG_DEVICE_LOGICAL_UNIT_DP,

+                                                      (UINT16) sizeof (DEVICE_LOGICAL_UNIT_DEVICE_PATH)

+                                                      );

+

+  LogicalUnit->Lun  = (UINT8) Strtoi (LunStr);

+

+  return (EFI_DEVICE_PATH_PROTOCOL *) LogicalUnit;

+}

+

+/**

+  Converts a text device path node to iSCSI device path structure.

+

+  @param TextDeviceNode  The input Text device path node.

+

+  @return A pointer to the newly-created iSCSI device path structure.

+

+**/

+EFI_DEVICE_PATH_PROTOCOL *

+DevPathFromTextiSCSI (

+  IN CHAR16 *TextDeviceNode

+  )

+{

+  UINT16                      Options;

+  CHAR16                      *NameStr;

+  CHAR16                      *PortalGroupStr;

+  CHAR16                      *LunStr;

+  CHAR16                      *HeaderDigestStr;

+  CHAR16                      *DataDigestStr;

+  CHAR16                      *AuthenticationStr;

+  CHAR16                      *ProtocolStr;

+  CHAR8                       *AsciiStr;

+  ISCSI_DEVICE_PATH_WITH_NAME *ISCSIDevPath;

+  UINT64                      Lun;

+

+  NameStr           = GetNextParamStr (&TextDeviceNode);

+  PortalGroupStr    = GetNextParamStr (&TextDeviceNode);

+  LunStr            = GetNextParamStr (&TextDeviceNode);

+  HeaderDigestStr   = GetNextParamStr (&TextDeviceNode);

+  DataDigestStr     = GetNextParamStr (&TextDeviceNode);

+  AuthenticationStr = GetNextParamStr (&TextDeviceNode);

+  ProtocolStr       = GetNextParamStr (&TextDeviceNode);

+  ISCSIDevPath      = (ISCSI_DEVICE_PATH_WITH_NAME *) CreateDeviceNode (

+                                                        MESSAGING_DEVICE_PATH,

+                                                        MSG_ISCSI_DP,

+                                                        (UINT16) (sizeof (ISCSI_DEVICE_PATH_WITH_NAME) + StrLen (NameStr))

+                                                        );

+

+  AsciiStr = ISCSIDevPath->TargetName;

+  StrToAscii (NameStr, &AsciiStr);

+

+  ISCSIDevPath->TargetPortalGroupTag = (UINT16) Strtoi (PortalGroupStr);

+  Strtoi64 (LunStr, &Lun);

+  WriteUnaligned64 ((UINT64 *) &ISCSIDevPath->Lun, SwapBytes64 (Lun));

+

+  Options = 0x0000;

+  if (StrCmp (HeaderDigestStr, L"CRC32C") == 0) {

+    Options |= 0x0002;

+  }

+

+  if (StrCmp (DataDigestStr, L"CRC32C") == 0) {

+    Options |= 0x0008;

+  }

+

+  if (StrCmp (AuthenticationStr, L"None") == 0) {

+    Options |= 0x0800;

+  }

+

+  if (StrCmp (AuthenticationStr, L"CHAP_UNI") == 0) {

+    Options |= 0x1000;

+  }

+

+  ISCSIDevPath->LoginOption      = (UINT16) Options;

+

+  if (IS_NULL (*ProtocolStr) || (StrCmp (ProtocolStr, L"TCP") == 0)) {

+    ISCSIDevPath->NetworkProtocol = 0;

+  } else {

+    //

+    // Undefined and reserved.

+    //

+    ISCSIDevPath->NetworkProtocol = 1;

+  }

+

+  return (EFI_DEVICE_PATH_PROTOCOL *) ISCSIDevPath;

+}

+

+/**

+  Converts a text device path node to VLAN device path structure.

+

+  @param TextDeviceNode  The input Text device path node.

+

+  @return A pointer to the newly-created VLAN device path structure.

+

+**/

+EFI_DEVICE_PATH_PROTOCOL *

+DevPathFromTextVlan (

+  IN CHAR16 *TextDeviceNode

+  )

+{

+  CHAR16            *VlanStr;

+  VLAN_DEVICE_PATH  *Vlan;

+

+  VlanStr = GetNextParamStr (&TextDeviceNode);

+  Vlan    = (VLAN_DEVICE_PATH *) CreateDeviceNode (

+                                   MESSAGING_DEVICE_PATH,

+                                   MSG_VLAN_DP,

+                                   (UINT16) sizeof (VLAN_DEVICE_PATH)

+                                   );

+

+  Vlan->VlanId = (UINT16) Strtoi (VlanStr);

+

+  return (EFI_DEVICE_PATH_PROTOCOL *) Vlan;

+}

+

+/**

+  Converts a text device path node to Bluetooth device path structure.

+

+  @param TextDeviceNode  The input Text device path node.

+

+  @return A pointer to the newly-created Bluetooth device path structure.

+

+**/

+EFI_DEVICE_PATH_PROTOCOL *

+DevPathFromTextBluetooth (

+  IN CHAR16 *TextDeviceNode

+  )

+{

+  CHAR16                  *BluetoothStr;

+  BLUETOOTH_DEVICE_PATH   *BluetoothDp;

+

+  BluetoothStr = GetNextParamStr (&TextDeviceNode);

+  BluetoothDp  = (BLUETOOTH_DEVICE_PATH *) CreateDeviceNode (

+                                             MESSAGING_DEVICE_PATH,

+                                             MSG_BLUETOOTH_DP,

+                                             (UINT16) sizeof (BLUETOOTH_DEVICE_PATH)

+                                             );

+  StrHexToBytes (

+    BluetoothStr,

+    sizeof (BLUETOOTH_ADDRESS) * 2,

+    BluetoothDp->BD_ADDR.Address,

+    sizeof (BLUETOOTH_ADDRESS)

+    );

+  return (EFI_DEVICE_PATH_PROTOCOL *) BluetoothDp;

+}

+

+/**

+  Converts a text device path node to Wi-Fi device path structure.

+

+  @param TextDeviceNode  The input Text device path node.

+

+  @return A pointer to the newly-created Wi-Fi device path structure.

+

+**/

+EFI_DEVICE_PATH_PROTOCOL *

+DevPathFromTextWiFi (

+  IN CHAR16 *TextDeviceNode

+  )

+{

+  CHAR16                *SSIdStr;

+  CHAR8                 AsciiStr[33];

+  UINTN                 DataLen;

+  WIFI_DEVICE_PATH      *WiFiDp;

+

+  SSIdStr = GetNextParamStr (&TextDeviceNode);

+  WiFiDp  = (WIFI_DEVICE_PATH *) CreateDeviceNode (

+                                   MESSAGING_DEVICE_PATH,

+                                   MSG_WIFI_DP,

+                                   (UINT16) sizeof (WIFI_DEVICE_PATH)

+                                   );

+

+  if (NULL != SSIdStr) {

+    DataLen = StrLen (SSIdStr);

+    if (StrLen (SSIdStr) > 32) {

+      SSIdStr[32] = L'\0';

+      DataLen     = 32;

+    }

+

+    UnicodeStrToAsciiStrS (SSIdStr, AsciiStr, sizeof (AsciiStr));

+    CopyMem (WiFiDp->SSId, AsciiStr, DataLen);

+  }

+

+  return (EFI_DEVICE_PATH_PROTOCOL *) WiFiDp;

+}

+

+/**

+  Converts a text device path node to Bluetooth LE device path structure.

+

+  @param TextDeviceNode  The input Text device path node.

+

+  @return A pointer to the newly-created Bluetooth LE device path structure.

+

+**/

+EFI_DEVICE_PATH_PROTOCOL *

+DevPathFromTextBluetoothLE (

+  IN CHAR16 *TextDeviceNode

+  )

+{

+  CHAR16                     *BluetoothLeAddrStr;

+  CHAR16                     *BluetoothLeAddrTypeStr;

+  BLUETOOTH_LE_DEVICE_PATH   *BluetoothLeDp;

+

+  BluetoothLeAddrStr     = GetNextParamStr (&TextDeviceNode);

+  BluetoothLeAddrTypeStr = GetNextParamStr (&TextDeviceNode);

+  BluetoothLeDp = (BLUETOOTH_LE_DEVICE_PATH *) CreateDeviceNode (

+                                                 MESSAGING_DEVICE_PATH,

+                                                 MSG_BLUETOOTH_LE_DP,

+                                                 (UINT16) sizeof (BLUETOOTH_LE_DEVICE_PATH)

+                                                 );

+

+  BluetoothLeDp->Address.Type = (UINT8) Strtoi (BluetoothLeAddrTypeStr);

+  StrHexToBytes (

+    BluetoothLeAddrStr, sizeof (BluetoothLeDp->Address.Address) * 2,

+    BluetoothLeDp->Address.Address, sizeof (BluetoothLeDp->Address.Address)

+    );

+  return (EFI_DEVICE_PATH_PROTOCOL *) BluetoothLeDp;

+}

+

+/**

+  Converts a text device path node to DNS device path structure.

+

+  @param TextDeviceNode  The input Text device path node.

+

+  @return A pointer to the newly-created DNS device path structure.

+

+**/

+EFI_DEVICE_PATH_PROTOCOL *

+DevPathFromTextDns (

+  IN CHAR16 *TextDeviceNode

+  )

+{

+  CHAR16            *DeviceNodeStr;

+  CHAR16            *DeviceNodeStrPtr;

+  UINT32            DnsServerIpCount;

+  UINT16            DnsDeviceNodeLength;

+  DNS_DEVICE_PATH   *DnsDeviceNode;

+  UINT32            DnsServerIpIndex;

+  CHAR16            *DnsServerIp;

+

+

+  //

+  // Count the DNS server address number.

+  //

+  DeviceNodeStr = UefiDevicePathLibStrDuplicate (TextDeviceNode);

+  if (DeviceNodeStr == NULL) {

+    return NULL;

+  }

+

+  DeviceNodeStrPtr = DeviceNodeStr;

+

+  DnsServerIpCount = 0;

+  while (DeviceNodeStrPtr != NULL && *DeviceNodeStrPtr != L'\0') {

+    GetNextParamStr (&DeviceNodeStrPtr);

+    DnsServerIpCount ++;

+  }

+

+  FreePool (DeviceNodeStr);

+  DeviceNodeStr = NULL;

+

+  //

+  // One or more instances of the DNS server address in EFI_IP_ADDRESS,

+  // otherwise, NULL will be returned.

+  //

+  if (DnsServerIpCount == 0) {

+    return NULL;

+  }

+

+  //

+  // Create the DNS DeviceNode.

+  //

+  DnsDeviceNodeLength = (UINT16) (sizeof (EFI_DEVICE_PATH_PROTOCOL) + sizeof (UINT8) + DnsServerIpCount * sizeof (EFI_IP_ADDRESS));

+  DnsDeviceNode       = (DNS_DEVICE_PATH *) CreateDeviceNode (

+                                              MESSAGING_DEVICE_PATH,

+                                              MSG_DNS_DP,

+                                              DnsDeviceNodeLength

+                                              );

+  if (DnsDeviceNode == NULL) {

+    return NULL;

+  }

+

+  //

+  // Confirm the DNS server address is IPv4 or IPv6 type.

+  //

+  DeviceNodeStrPtr = TextDeviceNode;

+  while (!IS_NULL (*DeviceNodeStrPtr)) {

+    if (*DeviceNodeStrPtr == L'.') {

+      DnsDeviceNode->IsIPv6 = 0x00;

+      break;

+    }

+

+    if (*DeviceNodeStrPtr == L':') {

+      DnsDeviceNode->IsIPv6 = 0x01;

+      break;

+    }

+

+    DeviceNodeStrPtr++;

+  }

+

+  for (DnsServerIpIndex = 0; DnsServerIpIndex < DnsServerIpCount; DnsServerIpIndex++) {

+    DnsServerIp = GetNextParamStr (&TextDeviceNode);

+    if (DnsDeviceNode->IsIPv6 == 0x00) {

+      StrToIpv4Address (DnsServerIp,  NULL, &(DnsDeviceNode->DnsServerIp[DnsServerIpIndex].v4), NULL);

+    } else {

+      StrToIpv6Address (DnsServerIp, NULL, &(DnsDeviceNode->DnsServerIp[DnsServerIpIndex].v6), NULL);

+    }

+  }

+

+  return (EFI_DEVICE_PATH_PROTOCOL *) DnsDeviceNode;

+}

+

+/**

+  Converts a text device path node to URI device path structure.

+

+  @param TextDeviceNode  The input Text device path node.

+

+  @return A pointer to the newly-created URI device path structure.

+

+**/

+EFI_DEVICE_PATH_PROTOCOL *

+DevPathFromTextUri (

+  IN CHAR16 *TextDeviceNode

+  )

+{

+  CHAR16           *UriStr;

+  UINTN            UriLength;

+  URI_DEVICE_PATH  *Uri;

+

+  UriStr = GetNextParamStr (&TextDeviceNode);

+  UriLength = StrnLenS (UriStr, MAX_UINT16 - sizeof (URI_DEVICE_PATH));

+  Uri    = (URI_DEVICE_PATH *) CreateDeviceNode (

+                                 MESSAGING_DEVICE_PATH,

+                                 MSG_URI_DP,

+                                 (UINT16) (sizeof (URI_DEVICE_PATH) + UriLength)

+                                 );

+

+  while (UriLength-- != 0) {

+    Uri->Uri[UriLength] = (CHAR8) UriStr[UriLength];

+  }

+

+  return (EFI_DEVICE_PATH_PROTOCOL *) Uri;

+}

+

+/**

+  Converts a media text device path node to media device path structure.

+

+  @param TextDeviceNode  The input Text device path node.

+

+  @return A pointer to media device path structure.

+

+**/

+EFI_DEVICE_PATH_PROTOCOL *

+DevPathFromTextMediaPath (

+  IN CHAR16 *TextDeviceNode

+  )

+{

+  return DevPathFromTextGenericPath (MEDIA_DEVICE_PATH, TextDeviceNode);

+}

+

+/**

+  Converts a text device path node to HD device path structure.

+

+  @param TextDeviceNode  The input Text device path node.

+

+  @return A pointer to the newly-created HD device path structure.

+

+**/

+EFI_DEVICE_PATH_PROTOCOL *

+DevPathFromTextHD (

+  IN CHAR16 *TextDeviceNode

+  )

+{

+  CHAR16                *PartitionStr;

+  CHAR16                *TypeStr;

+  CHAR16                *SignatureStr;

+  CHAR16                *StartStr;

+  CHAR16                *SizeStr;

+  UINT32                Signature32;

+  HARDDRIVE_DEVICE_PATH *Hd;

+

+  PartitionStr        = GetNextParamStr (&TextDeviceNode);

+  TypeStr             = GetNextParamStr (&TextDeviceNode);

+  SignatureStr        = GetNextParamStr (&TextDeviceNode);

+  StartStr            = GetNextParamStr (&TextDeviceNode);

+  SizeStr             = GetNextParamStr (&TextDeviceNode);

+  Hd                  = (HARDDRIVE_DEVICE_PATH *) CreateDeviceNode (

+                                                    MEDIA_DEVICE_PATH,

+                                                    MEDIA_HARDDRIVE_DP,

+                                                    (UINT16) sizeof (HARDDRIVE_DEVICE_PATH)

+                                                    );

+

+  Hd->PartitionNumber = (UINT32) Strtoi (PartitionStr);

+

+  ZeroMem (Hd->Signature, 16);

+  Hd->MBRType = (UINT8) 0;

+

+  if (StrCmp (TypeStr, L"MBR") == 0) {

+    Hd->SignatureType = SIGNATURE_TYPE_MBR;

+    Hd->MBRType       = 0x01;

+

+    Signature32       = (UINT32) Strtoi (SignatureStr);

+    CopyMem (Hd->Signature, &Signature32, sizeof (UINT32));

+  } else if (StrCmp (TypeStr, L"GPT") == 0) {

+    Hd->SignatureType = SIGNATURE_TYPE_GUID;

+    Hd->MBRType       = 0x02;

+

+    StrToGuid (SignatureStr, (EFI_GUID *) Hd->Signature);

+  } else {

+    Hd->SignatureType = (UINT8) Strtoi (TypeStr);

+  }

+

+  Strtoi64 (StartStr, &Hd->PartitionStart);

+  Strtoi64 (SizeStr, &Hd->PartitionSize);

+

+  return (EFI_DEVICE_PATH_PROTOCOL *) Hd;

+}

+

+/**

+  Converts a text device path node to CDROM device path structure.

+

+  @param TextDeviceNode  The input Text device path node.

+

+  @return A pointer to the newly-created CDROM device path structure.

+

+**/

+EFI_DEVICE_PATH_PROTOCOL *

+DevPathFromTextCDROM (

+  IN CHAR16 *TextDeviceNode

+  )

+{

+  CHAR16            *EntryStr;

+  CHAR16            *StartStr;

+  CHAR16            *SizeStr;

+  CDROM_DEVICE_PATH *CDROMDevPath;

+

+  EntryStr              = GetNextParamStr (&TextDeviceNode);

+  StartStr              = GetNextParamStr (&TextDeviceNode);

+  SizeStr               = GetNextParamStr (&TextDeviceNode);

+  CDROMDevPath          = (CDROM_DEVICE_PATH *) CreateDeviceNode (

+                                                  MEDIA_DEVICE_PATH,

+                                                  MEDIA_CDROM_DP,

+                                                  (UINT16) sizeof (CDROM_DEVICE_PATH)

+                                                  );

+

+  CDROMDevPath->BootEntry = (UINT32) Strtoi (EntryStr);

+  Strtoi64 (StartStr, &CDROMDevPath->PartitionStart);

+  Strtoi64 (SizeStr, &CDROMDevPath->PartitionSize);

+

+  return (EFI_DEVICE_PATH_PROTOCOL *) CDROMDevPath;

+}

+

+/**

+  Converts a text device path node to Vendor-defined media device path structure.

+

+  @param TextDeviceNode  The input Text device path node.

+

+  @return A pointer to the newly-created Vendor-defined media device path structure.

+

+**/

+EFI_DEVICE_PATH_PROTOCOL *

+DevPathFromTextVenMedia (

+  IN CHAR16 *TextDeviceNode

+  )

+{

+  return ConvertFromTextVendor (

+           TextDeviceNode,

+           MEDIA_DEVICE_PATH,

+           MEDIA_VENDOR_DP

+           );

+}

+

+/**

+  Converts a text device path node to File device path structure.

+

+  @param TextDeviceNode  The input Text device path node.

+

+  @return A pointer to the newly-created File device path structure.

+

+**/

+EFI_DEVICE_PATH_PROTOCOL *

+DevPathFromTextFilePath (

+  IN CHAR16 *TextDeviceNode

+  )

+{

+  FILEPATH_DEVICE_PATH  *File;

+

+  File = (FILEPATH_DEVICE_PATH *) CreateDeviceNode (

+                                    MEDIA_DEVICE_PATH,

+                                    MEDIA_FILEPATH_DP,

+                                    (UINT16) (sizeof (FILEPATH_DEVICE_PATH) + StrLen (TextDeviceNode) * 2)

+                                    );

+

+  StrCpyS (File->PathName, StrLen (TextDeviceNode) + 1, TextDeviceNode);

+

+  return (EFI_DEVICE_PATH_PROTOCOL *) File;

+}

+

+/**

+  Converts a text device path node to Media protocol device path structure.

+

+  @param TextDeviceNode  The input Text device path node.

+

+  @return A pointer to the newly-created Media protocol device path structure.

+

+**/

+EFI_DEVICE_PATH_PROTOCOL *

+DevPathFromTextMedia (

+  IN CHAR16 *TextDeviceNode

+  )

+{

+  CHAR16                      *GuidStr;

+  MEDIA_PROTOCOL_DEVICE_PATH  *Media;

+

+  GuidStr = GetNextParamStr (&TextDeviceNode);

+  Media   = (MEDIA_PROTOCOL_DEVICE_PATH *) CreateDeviceNode (

+                                             MEDIA_DEVICE_PATH,

+                                             MEDIA_PROTOCOL_DP,

+                                             (UINT16) sizeof (MEDIA_PROTOCOL_DEVICE_PATH)

+                                             );

+

+  StrToGuid (GuidStr, &Media->Protocol);

+

+  return (EFI_DEVICE_PATH_PROTOCOL *) Media;

+}

+

+/**

+  Converts a text device path node to firmware volume device path structure.

+

+  @param TextDeviceNode  The input Text device path node.

+

+  @return A pointer to the newly-created firmware volume device path structure.

+

+**/

+EFI_DEVICE_PATH_PROTOCOL *

+DevPathFromTextFv (

+  IN CHAR16 *TextDeviceNode

+  )

+{

+  CHAR16                    *GuidStr;

+  MEDIA_FW_VOL_DEVICE_PATH  *Fv;

+

+  GuidStr = GetNextParamStr (&TextDeviceNode);

+  Fv      = (MEDIA_FW_VOL_DEVICE_PATH *) CreateDeviceNode (

+                                           MEDIA_DEVICE_PATH,

+                                           MEDIA_PIWG_FW_VOL_DP,

+                                           (UINT16) sizeof (MEDIA_FW_VOL_DEVICE_PATH)

+                                           );

+

+  StrToGuid (GuidStr, &Fv->FvName);

+

+  return (EFI_DEVICE_PATH_PROTOCOL *) Fv;

+}

+

+/**

+  Converts a text device path node to firmware file device path structure.

+

+  @param TextDeviceNode  The input Text device path node.

+

+  @return A pointer to the newly-created firmware file device path structure.

+

+**/

+EFI_DEVICE_PATH_PROTOCOL *

+DevPathFromTextFvFile (

+  IN CHAR16 *TextDeviceNode

+  )

+{

+  CHAR16                             *GuidStr;

+  MEDIA_FW_VOL_FILEPATH_DEVICE_PATH  *FvFile;

+

+  GuidStr = GetNextParamStr (&TextDeviceNode);

+  FvFile  = (MEDIA_FW_VOL_FILEPATH_DEVICE_PATH *) CreateDeviceNode (

+                                                    MEDIA_DEVICE_PATH,

+                                                    MEDIA_PIWG_FW_FILE_DP,

+                                                    (UINT16) sizeof (MEDIA_FW_VOL_FILEPATH_DEVICE_PATH)

+                                                    );

+

+  StrToGuid (GuidStr, &FvFile->FvFileName);

+

+  return (EFI_DEVICE_PATH_PROTOCOL *) FvFile;

+}

+

+/**

+  Converts a text device path node to text relative offset device path structure.

+

+  @param TextDeviceNode  The input Text device path node.

+

+  @return A pointer to the newly-created Text device path structure.

+

+**/

+EFI_DEVICE_PATH_PROTOCOL *

+DevPathFromTextRelativeOffsetRange (

+  IN CHAR16 *TextDeviceNode

+  )

+{

+  CHAR16                                  *StartingOffsetStr;

+  CHAR16                                  *EndingOffsetStr;

+  MEDIA_RELATIVE_OFFSET_RANGE_DEVICE_PATH *Offset;

+

+  StartingOffsetStr = GetNextParamStr (&TextDeviceNode);

+  EndingOffsetStr   = GetNextParamStr (&TextDeviceNode);

+  Offset            = (MEDIA_RELATIVE_OFFSET_RANGE_DEVICE_PATH *) CreateDeviceNode (

+                                                                    MEDIA_DEVICE_PATH,

+                                                                    MEDIA_RELATIVE_OFFSET_RANGE_DP,

+                                                                    (UINT16) sizeof (MEDIA_RELATIVE_OFFSET_RANGE_DEVICE_PATH)

+                                                                    );

+

+  Strtoi64 (StartingOffsetStr, &Offset->StartingOffset);

+  Strtoi64 (EndingOffsetStr, &Offset->EndingOffset);

+

+  return (EFI_DEVICE_PATH_PROTOCOL *) Offset;

+}

+

+/**

+  Converts a text device path node to text ram disk device path structure.

+

+  @param TextDeviceNode  The input Text device path node.

+

+  @return A pointer to the newly-created Text device path structure.

+

+**/

+EFI_DEVICE_PATH_PROTOCOL *

+DevPathFromTextRamDisk (

+  IN CHAR16 *TextDeviceNode

+  )

+{

+  CHAR16                                  *StartingAddrStr;

+  CHAR16                                  *EndingAddrStr;

+  CHAR16                                  *TypeGuidStr;

+  CHAR16                                  *InstanceStr;

+  MEDIA_RAM_DISK_DEVICE_PATH              *RamDisk;

+  UINT64                                  StartingAddr;

+  UINT64                                  EndingAddr;

+

+  StartingAddrStr = GetNextParamStr (&TextDeviceNode);

+  EndingAddrStr   = GetNextParamStr (&TextDeviceNode);

+  InstanceStr     = GetNextParamStr (&TextDeviceNode);

+  TypeGuidStr     = GetNextParamStr (&TextDeviceNode);

+  RamDisk         = (MEDIA_RAM_DISK_DEVICE_PATH *) CreateDeviceNode (

+                                                     MEDIA_DEVICE_PATH,

+                                                     MEDIA_RAM_DISK_DP,

+                                                     (UINT16) sizeof (MEDIA_RAM_DISK_DEVICE_PATH)

+                                                     );

+

+  Strtoi64 (StartingAddrStr, &StartingAddr);

+  WriteUnaligned64 ((UINT64 *) &(RamDisk->StartingAddr[0]), StartingAddr);

+  Strtoi64 (EndingAddrStr, &EndingAddr);

+  WriteUnaligned64 ((UINT64 *) &(RamDisk->EndingAddr[0]), EndingAddr);

+  RamDisk->Instance = (UINT16) Strtoi (InstanceStr);

+  StrToGuid (TypeGuidStr, &RamDisk->TypeGuid);

+

+  return (EFI_DEVICE_PATH_PROTOCOL *) RamDisk;

+}

+

+/**

+  Converts a text device path node to text virtual disk device path structure.

+

+  @param TextDeviceNode  The input Text device path node.

+

+  @return A pointer to the newly-created Text device path structure.

+

+**/

+EFI_DEVICE_PATH_PROTOCOL *

+DevPathFromTextVirtualDisk (

+  IN CHAR16 *TextDeviceNode

+  )

+{

+  CHAR16                                  *StartingAddrStr;

+  CHAR16                                  *EndingAddrStr;

+  CHAR16                                  *InstanceStr;

+  MEDIA_RAM_DISK_DEVICE_PATH              *RamDisk;

+  UINT64                                  StartingAddr;

+  UINT64                                  EndingAddr;

+

+  StartingAddrStr = GetNextParamStr (&TextDeviceNode);

+  EndingAddrStr   = GetNextParamStr (&TextDeviceNode);

+  InstanceStr     = GetNextParamStr (&TextDeviceNode);

+

+  RamDisk         = (MEDIA_RAM_DISK_DEVICE_PATH *) CreateDeviceNode (

+                                                     MEDIA_DEVICE_PATH,

+                                                     MEDIA_RAM_DISK_DP,

+                                                     (UINT16) sizeof (MEDIA_RAM_DISK_DEVICE_PATH)

+                                                     );

+

+  Strtoi64 (StartingAddrStr, &StartingAddr);

+  WriteUnaligned64 ((UINT64 *) &(RamDisk->StartingAddr[0]), StartingAddr);

+  Strtoi64 (EndingAddrStr, &EndingAddr);

+  WriteUnaligned64 ((UINT64 *) &(RamDisk->EndingAddr[0]), EndingAddr);

+  RamDisk->Instance = (UINT16) Strtoi (InstanceStr);

+  CopyGuid (&RamDisk->TypeGuid, &gEfiVirtualDiskGuid);

+

+  return (EFI_DEVICE_PATH_PROTOCOL *) RamDisk;

+}

+

+/**

+  Converts a text device path node to text virtual cd device path structure.

+

+  @param TextDeviceNode  The input Text device path node.

+

+  @return A pointer to the newly-created Text device path structure.

+

+**/

+EFI_DEVICE_PATH_PROTOCOL *

+DevPathFromTextVirtualCd (

+  IN CHAR16 *TextDeviceNode

+  )

+{

+  CHAR16                                  *StartingAddrStr;

+  CHAR16                                  *EndingAddrStr;

+  CHAR16                                  *InstanceStr;

+  MEDIA_RAM_DISK_DEVICE_PATH              *RamDisk;

+  UINT64                                  StartingAddr;

+  UINT64                                  EndingAddr;

+

+  StartingAddrStr = GetNextParamStr (&TextDeviceNode);

+  EndingAddrStr   = GetNextParamStr (&TextDeviceNode);

+  InstanceStr     = GetNextParamStr (&TextDeviceNode);

+

+  RamDisk         = (MEDIA_RAM_DISK_DEVICE_PATH *) CreateDeviceNode (

+                                                     MEDIA_DEVICE_PATH,

+                                                     MEDIA_RAM_DISK_DP,

+                                                     (UINT16) sizeof (MEDIA_RAM_DISK_DEVICE_PATH)

+                                                     );

+

+  Strtoi64 (StartingAddrStr, &StartingAddr);

+  WriteUnaligned64 ((UINT64 *) &(RamDisk->StartingAddr[0]), StartingAddr);

+  Strtoi64 (EndingAddrStr, &EndingAddr);

+  WriteUnaligned64 ((UINT64 *) &(RamDisk->EndingAddr[0]), EndingAddr);

+  RamDisk->Instance = (UINT16) Strtoi (InstanceStr);

+  CopyGuid (&RamDisk->TypeGuid, &gEfiVirtualCdGuid);

+

+  return (EFI_DEVICE_PATH_PROTOCOL *) RamDisk;

+}

+

+/**

+  Converts a text device path node to text persistent virtual disk device path structure.

+

+  @param TextDeviceNode  The input Text device path node.

+

+  @return A pointer to the newly-created Text device path structure.

+

+**/

+EFI_DEVICE_PATH_PROTOCOL *

+DevPathFromTextPersistentVirtualDisk (

+  IN CHAR16 *TextDeviceNode

+  )

+{

+  CHAR16                                  *StartingAddrStr;

+  CHAR16                                  *EndingAddrStr;

+  CHAR16                                  *InstanceStr;

+  MEDIA_RAM_DISK_DEVICE_PATH              *RamDisk;

+  UINT64                                  StartingAddr;

+  UINT64                                  EndingAddr;

+

+  StartingAddrStr = GetNextParamStr (&TextDeviceNode);

+  EndingAddrStr   = GetNextParamStr (&TextDeviceNode);

+  InstanceStr     = GetNextParamStr (&TextDeviceNode);

+

+  RamDisk         = (MEDIA_RAM_DISK_DEVICE_PATH *) CreateDeviceNode (

+                                                     MEDIA_DEVICE_PATH,

+                                                     MEDIA_RAM_DISK_DP,

+                                                     (UINT16) sizeof (MEDIA_RAM_DISK_DEVICE_PATH)

+                                                     );

+

+  Strtoi64 (StartingAddrStr, &StartingAddr);

+  WriteUnaligned64 ((UINT64 *) &(RamDisk->StartingAddr[0]), StartingAddr);

+  Strtoi64 (EndingAddrStr, &EndingAddr);

+  WriteUnaligned64 ((UINT64 *) &(RamDisk->EndingAddr[0]), EndingAddr);

+  RamDisk->Instance = (UINT16) Strtoi (InstanceStr);

+  CopyGuid (&RamDisk->TypeGuid, &gEfiPersistentVirtualDiskGuid);

+

+  return (EFI_DEVICE_PATH_PROTOCOL *) RamDisk;

+}

+

+/**

+  Converts a text device path node to text persistent virtual cd device path structure.

+

+  @param TextDeviceNode  The input Text device path node.

+

+  @return A pointer to the newly-created Text device path structure.

+

+**/

+EFI_DEVICE_PATH_PROTOCOL *

+DevPathFromTextPersistentVirtualCd (

+  IN CHAR16 *TextDeviceNode

+  )

+{

+  CHAR16                                  *StartingAddrStr;

+  CHAR16                                  *EndingAddrStr;

+  CHAR16                                  *InstanceStr;

+  MEDIA_RAM_DISK_DEVICE_PATH              *RamDisk;

+  UINT64                                  StartingAddr;

+  UINT64                                  EndingAddr;

+

+  StartingAddrStr = GetNextParamStr (&TextDeviceNode);

+  EndingAddrStr   = GetNextParamStr (&TextDeviceNode);

+  InstanceStr     = GetNextParamStr (&TextDeviceNode);

+

+  RamDisk         = (MEDIA_RAM_DISK_DEVICE_PATH *) CreateDeviceNode (

+                                                     MEDIA_DEVICE_PATH,

+                                                     MEDIA_RAM_DISK_DP,

+                                                     (UINT16) sizeof (MEDIA_RAM_DISK_DEVICE_PATH)

+                                                     );

+

+  Strtoi64 (StartingAddrStr, &StartingAddr);

+  WriteUnaligned64 ((UINT64 *) &(RamDisk->StartingAddr[0]), StartingAddr);

+  Strtoi64 (EndingAddrStr, &EndingAddr);

+  WriteUnaligned64 ((UINT64 *) &(RamDisk->EndingAddr[0]), EndingAddr);

+  RamDisk->Instance = (UINT16) Strtoi (InstanceStr);

+  CopyGuid (&RamDisk->TypeGuid, &gEfiPersistentVirtualCdGuid);

+

+  return (EFI_DEVICE_PATH_PROTOCOL *) RamDisk;

+}

+

+/**

+  Converts a BBS text device path node to BBS device path structure.

+

+  @param TextDeviceNode  The input Text device path node.

+

+  @return A pointer to BBS device path structure.

+

+**/

+EFI_DEVICE_PATH_PROTOCOL *

+DevPathFromTextBbsPath (

+  IN CHAR16 *TextDeviceNode

+  )

+{

+  return DevPathFromTextGenericPath (BBS_DEVICE_PATH, TextDeviceNode);

+}

+

+/**

+  Converts a text device path node to BIOS Boot Specification device path structure.

+

+  @param TextDeviceNode  The input Text device path node.

+

+  @return A pointer to the newly-created BIOS Boot Specification device path structure.

+

+**/

+EFI_DEVICE_PATH_PROTOCOL *

+DevPathFromTextBBS (

+  IN CHAR16 *TextDeviceNode

+  )

+{

+  CHAR16              *TypeStr;

+  CHAR16              *IdStr;

+  CHAR16              *FlagsStr;

+  CHAR8               *AsciiStr;

+  BBS_BBS_DEVICE_PATH *Bbs;

+

+  TypeStr   = GetNextParamStr (&TextDeviceNode);

+  IdStr     = GetNextParamStr (&TextDeviceNode);

+  FlagsStr  = GetNextParamStr (&TextDeviceNode);

+  Bbs       = (BBS_BBS_DEVICE_PATH *) CreateDeviceNode (

+                                        BBS_DEVICE_PATH,

+                                        BBS_BBS_DP,

+                                        (UINT16) (sizeof (BBS_BBS_DEVICE_PATH) + StrLen (IdStr))

+                                        );

+

+  if (StrCmp (TypeStr, L"Floppy") == 0) {

+    Bbs->DeviceType = BBS_TYPE_FLOPPY;

+  } else if (StrCmp (TypeStr, L"HD") == 0) {

+    Bbs->DeviceType = BBS_TYPE_HARDDRIVE;

+  } else if (StrCmp (TypeStr, L"CDROM") == 0) {

+    Bbs->DeviceType = BBS_TYPE_CDROM;

+  } else if (StrCmp (TypeStr, L"PCMCIA") == 0) {

+    Bbs->DeviceType = BBS_TYPE_PCMCIA;

+  } else if (StrCmp (TypeStr, L"USB") == 0) {

+    Bbs->DeviceType = BBS_TYPE_USB;

+  } else if (StrCmp (TypeStr, L"Network") == 0) {

+    Bbs->DeviceType = BBS_TYPE_EMBEDDED_NETWORK;

+  } else {

+    Bbs->DeviceType = (UINT16) Strtoi (TypeStr);

+  }

+

+  AsciiStr = Bbs->String;

+  StrToAscii (IdStr, &AsciiStr);

+

+  Bbs->StatusFlag = (UINT16) Strtoi (FlagsStr);

+

+  return (EFI_DEVICE_PATH_PROTOCOL *) Bbs;

+}

+

+/**

+  Converts a text device path node to SATA device path structure.

+

+  @param TextDeviceNode  The input Text device path node.

+

+  @return A pointer to the newly-created SATA device path structure.

+

+**/

+EFI_DEVICE_PATH_PROTOCOL *

+DevPathFromTextSata (

+  IN CHAR16 *TextDeviceNode

+  )

+{

+  SATA_DEVICE_PATH *Sata;

+  CHAR16           *Param1;

+  CHAR16           *Param2;

+  CHAR16           *Param3;

+

+  Param1 = GetNextParamStr (&TextDeviceNode);

+  Param2 = GetNextParamStr (&TextDeviceNode);

+  Param3 = GetNextParamStr (&TextDeviceNode);

+

+  Sata = (SATA_DEVICE_PATH *) CreateDeviceNode (

+                                MESSAGING_DEVICE_PATH,

+                                MSG_SATA_DP,

+                                (UINT16) sizeof (SATA_DEVICE_PATH)

+                                );

+  Sata->HBAPortNumber            = (UINT16) Strtoi (Param1);

+

+  //

+  // According to UEFI spec, if PMPN is not provided, the default is 0xFFFF

+  //

+  if (*Param2 == L'\0' ) {

+    Sata->PortMultiplierPortNumber = 0xFFFF;

+  } else {

+    Sata->PortMultiplierPortNumber = (UINT16) Strtoi (Param2);

+  }

+  Sata->Lun                      = (UINT16) Strtoi (Param3);

+

+  return (EFI_DEVICE_PATH_PROTOCOL *) Sata;

+}

+

+GLOBAL_REMOVE_IF_UNREFERENCED DEVICE_PATH_FROM_TEXT_TABLE mUefiDevicePathLibDevPathFromTextTable[] = {

+  {L"Path",                    DevPathFromTextPath                    },

+

+  {L"HardwarePath",            DevPathFromTextHardwarePath            },

+  {L"Pci",                     DevPathFromTextPci                     },

+  {L"PcCard",                  DevPathFromTextPcCard                  },

+  {L"MemoryMapped",            DevPathFromTextMemoryMapped            },

+  {L"VenHw",                   DevPathFromTextVenHw                   },

+  {L"Ctrl",                    DevPathFromTextCtrl                    },

+  {L"BMC",                     DevPathFromTextBmc                     },

+

+  {L"AcpiPath",                DevPathFromTextAcpiPath                },

+  {L"Acpi",                    DevPathFromTextAcpi                    },

+  {L"PciRoot",                 DevPathFromTextPciRoot                 },

+  {L"PcieRoot",                DevPathFromTextPcieRoot                },

+  {L"Floppy",                  DevPathFromTextFloppy                  },

+  {L"Keyboard",                DevPathFromTextKeyboard                },

+  {L"Serial",                  DevPathFromTextSerial                  },

+  {L"ParallelPort",            DevPathFromTextParallelPort            },

+  {L"AcpiEx",                  DevPathFromTextAcpiEx                  },

+  {L"AcpiExp",                 DevPathFromTextAcpiExp                 },

+  {L"AcpiAdr",                 DevPathFromTextAcpiAdr                 },

+

+  {L"Msg",                     DevPathFromTextMsg                     },

+  {L"Ata",                     DevPathFromTextAta                     },

+  {L"Scsi",                    DevPathFromTextScsi                    },

+  {L"Fibre",                   DevPathFromTextFibre                   },

+  {L"FibreEx",                 DevPathFromTextFibreEx                 },

+  {L"I1394",                   DevPathFromText1394                    },

+  {L"USB",                     DevPathFromTextUsb                     },

+  {L"I2O",                     DevPathFromTextI2O                     },

+  {L"Infiniband",              DevPathFromTextInfiniband              },

+  {L"VenMsg",                  DevPathFromTextVenMsg                  },

+  {L"VenPcAnsi",               DevPathFromTextVenPcAnsi               },

+  {L"VenVt100",                DevPathFromTextVenVt100                },

+  {L"VenVt100Plus",            DevPathFromTextVenVt100Plus            },

+  {L"VenUtf8",                 DevPathFromTextVenUtf8                 },

+  {L"UartFlowCtrl",            DevPathFromTextUartFlowCtrl            },

+  {L"SAS",                     DevPathFromTextSAS                     },

+  {L"SasEx",                   DevPathFromTextSasEx                   },

+  {L"NVMe",                    DevPathFromTextNVMe                    },

+  {L"UFS",                     DevPathFromTextUfs                     },

+  {L"SD",                      DevPathFromTextSd                      },

+  {L"eMMC",                    DevPathFromTextEmmc                    },

+  {L"DebugPort",               DevPathFromTextDebugPort               },

+  {L"MAC",                     DevPathFromTextMAC                     },

+  {L"IPv4",                    DevPathFromTextIPv4                    },

+  {L"IPv6",                    DevPathFromTextIPv6                    },

+  {L"Uart",                    DevPathFromTextUart                    },

+  {L"UsbClass",                DevPathFromTextUsbClass                },

+  {L"UsbAudio",                DevPathFromTextUsbAudio                },

+  {L"UsbCDCControl",           DevPathFromTextUsbCDCControl           },

+  {L"UsbHID",                  DevPathFromTextUsbHID                  },

+  {L"UsbImage",                DevPathFromTextUsbImage                },

+  {L"UsbPrinter",              DevPathFromTextUsbPrinter              },

+  {L"UsbMassStorage",          DevPathFromTextUsbMassStorage          },

+  {L"UsbHub",                  DevPathFromTextUsbHub                  },

+  {L"UsbCDCData",              DevPathFromTextUsbCDCData              },

+  {L"UsbSmartCard",            DevPathFromTextUsbSmartCard            },

+  {L"UsbVideo",                DevPathFromTextUsbVideo                },

+  {L"UsbDiagnostic",           DevPathFromTextUsbDiagnostic           },

+  {L"UsbWireless",             DevPathFromTextUsbWireless             },

+  {L"UsbDeviceFirmwareUpdate", DevPathFromTextUsbDeviceFirmwareUpdate },

+  {L"UsbIrdaBridge",           DevPathFromTextUsbIrdaBridge           },

+  {L"UsbTestAndMeasurement",   DevPathFromTextUsbTestAndMeasurement   },

+  {L"UsbWwid",                 DevPathFromTextUsbWwid                 },

+  {L"Unit",                    DevPathFromTextUnit                    },

+  {L"iSCSI",                   DevPathFromTextiSCSI                   },

+  {L"Vlan",                    DevPathFromTextVlan                    },

+  {L"Dns",                     DevPathFromTextDns                     },

+  {L"Uri",                     DevPathFromTextUri                     },

+  {L"Bluetooth",               DevPathFromTextBluetooth               },

+  {L"Wi-Fi",                   DevPathFromTextWiFi                    },

+  {L"BluetoothLE",             DevPathFromTextBluetoothLE             },

+  {L"MediaPath",               DevPathFromTextMediaPath               },

+  {L"HD",                      DevPathFromTextHD                      },

+  {L"CDROM",                   DevPathFromTextCDROM                   },

+  {L"VenMedia",                DevPathFromTextVenMedia                },

+  {L"Media",                   DevPathFromTextMedia                   },

+  {L"Fv",                      DevPathFromTextFv                      },

+  {L"FvFile",                  DevPathFromTextFvFile                  },

+  {L"Offset",                  DevPathFromTextRelativeOffsetRange     },

+  {L"RamDisk",                 DevPathFromTextRamDisk                 },

+  {L"VirtualDisk",             DevPathFromTextVirtualDisk             },

+  {L"VirtualCD",               DevPathFromTextVirtualCd               },

+  {L"PersistentVirtualDisk",   DevPathFromTextPersistentVirtualDisk   },

+  {L"PersistentVirtualCD",     DevPathFromTextPersistentVirtualCd     },

+

+  {L"BbsPath",                 DevPathFromTextBbsPath                 },

+  {L"BBS",                     DevPathFromTextBBS                     },

+  {L"Sata",                    DevPathFromTextSata                    },

+  {NULL, NULL}

+};

+

+/**

+  Convert text to the binary representation of a device node.

+

+  @param TextDeviceNode  TextDeviceNode points to the text representation of a device

+                         node. Conversion starts with the first character and continues

+                         until the first non-device node character.

+

+  @return A pointer to the EFI device node or NULL if TextDeviceNode is NULL or there was

+          insufficient memory or text unsupported.

+

+**/

+EFI_DEVICE_PATH_PROTOCOL *

+EFIAPI

+UefiDevicePathLibConvertTextToDeviceNode (

+  IN CONST CHAR16 *TextDeviceNode

+  )

+{

+  DEVICE_PATH_FROM_TEXT    FromText;

+  CHAR16                   *ParamStr;

+  EFI_DEVICE_PATH_PROTOCOL *DeviceNode;

+  CHAR16                   *DeviceNodeStr;

+  UINTN                    Index;

+

+  if ((TextDeviceNode == NULL) || (IS_NULL (*TextDeviceNode))) {

+    return NULL;

+  }

+

+  ParamStr      = NULL;

+  FromText      = NULL;

+  DeviceNodeStr = UefiDevicePathLibStrDuplicate (TextDeviceNode);

+  ASSERT (DeviceNodeStr != NULL);

+

+  for (Index = 0; mUefiDevicePathLibDevPathFromTextTable[Index].Function != NULL; Index++) {

+    ParamStr = GetParamByNodeName (DeviceNodeStr, mUefiDevicePathLibDevPathFromTextTable[Index].DevicePathNodeText);

+    if (ParamStr != NULL) {

+      FromText = mUefiDevicePathLibDevPathFromTextTable[Index].Function;

+      break;

+    }

+  }

+

+  if (FromText == NULL) {

+    //

+    // A file path

+    //

+    FromText = DevPathFromTextFilePath;

+    DeviceNode = FromText (DeviceNodeStr);

+  } else {

+    DeviceNode = FromText (ParamStr);

+    FreePool (ParamStr);

+  }

+

+  FreePool (DeviceNodeStr);

+

+  return DeviceNode;

+}

+

+/**

+  Convert text to the binary representation of a device path.

+

+

+  @param TextDevicePath  TextDevicePath points to the text representation of a device

+                         path. Conversion starts with the first character and continues

+                         until the first non-device node character.

+

+  @return A pointer to the allocated device path or NULL if TextDeviceNode is NULL or

+          there was insufficient memory.

+

+**/

+EFI_DEVICE_PATH_PROTOCOL *

+EFIAPI

+UefiDevicePathLibConvertTextToDevicePath (

+  IN CONST CHAR16 *TextDevicePath

+  )

+{

+  EFI_DEVICE_PATH_PROTOCOL *DeviceNode;

+  EFI_DEVICE_PATH_PROTOCOL *NewDevicePath;

+  CHAR16                   *DevicePathStr;

+  CHAR16                   *Str;

+  CHAR16                   *DeviceNodeStr;

+  BOOLEAN                  IsInstanceEnd;

+  EFI_DEVICE_PATH_PROTOCOL *DevicePath;

+

+  if ((TextDevicePath == NULL) || (IS_NULL (*TextDevicePath))) {

+    return NULL;

+  }

+

+  DevicePath = (EFI_DEVICE_PATH_PROTOCOL *) AllocatePool (END_DEVICE_PATH_LENGTH);

+  ASSERT (DevicePath != NULL);

+  SetDevicePathEndNode (DevicePath);

+

+  DevicePathStr = UefiDevicePathLibStrDuplicate (TextDevicePath);

+

+  Str           = DevicePathStr;

+  while ((DeviceNodeStr = GetNextDeviceNodeStr (&Str, &IsInstanceEnd)) != NULL) {

+    DeviceNode = UefiDevicePathLibConvertTextToDeviceNode (DeviceNodeStr);

+

+    NewDevicePath = AppendDevicePathNode (DevicePath, DeviceNode);

+    FreePool (DevicePath);

+    FreePool (DeviceNode);

+    DevicePath = NewDevicePath;

+

+    if (IsInstanceEnd) {

+      DeviceNode = (EFI_DEVICE_PATH_PROTOCOL *) AllocatePool (END_DEVICE_PATH_LENGTH);

+      ASSERT (DeviceNode != NULL);

+      SetDevicePathEndNode (DeviceNode);

+      DeviceNode->SubType = END_INSTANCE_DEVICE_PATH_SUBTYPE;

+

+      NewDevicePath = AppendDevicePathNode (DevicePath, DeviceNode);

+      FreePool (DevicePath);

+      FreePool (DeviceNode);

+      DevicePath = NewDevicePath;

+    }

+  }

+

+  FreePool (DevicePathStr);

+  return DevicePath;

+}

diff --git a/debugging_demo/memtest86+/efi/Include/src/UefiDevicePathLib/DevicePathToText.c b/debugging_demo/memtest86+/efi/Include/src/UefiDevicePathLib/DevicePathToText.c
new file mode 100644
index 0000000..fb65ebd
--- /dev/null
+++ b/debugging_demo/memtest86+/efi/Include/src/UefiDevicePathLib/DevicePathToText.c
@@ -0,0 +1,2455 @@
+/** @file

+  DevicePathToText protocol as defined in the UEFI 2.0 specification.

+

+  (C) Copyright 2015 Hewlett-Packard Development Company, L.P.<BR>

+Copyright (c) 2013 - 2018, Intel Corporation. All rights reserved.<BR>

+SPDX-License-Identifier: BSD-2-Clause-Patent

+

+**/

+

+#include "UefiDevicePathLib.h"

+

+/**

+  Concatenates a formatted unicode string to allocated pool. The caller must

+  free the resulting buffer.

+

+  @param Str             Tracks the allocated pool, size in use, and

+                         amount of pool allocated.

+  @param Fmt             The format string

+  @param ...             Variable arguments based on the format string.

+

+  @return Allocated buffer with the formatted string printed in it.

+          The caller must free the allocated buffer. The buffer

+          allocation is not packed.

+

+**/

+CHAR16 *

+EFIAPI

+UefiDevicePathLibCatPrint (

+  IN OUT POOL_PRINT   *Str,

+  IN CHAR16           *Fmt,

+  ...

+  )

+{

+  UINTN   Count;

+  VA_LIST Args;

+

+  VA_START (Args, Fmt);

+  Count = SPrintLength (Fmt, Args);

+  VA_END(Args);

+

+  if ((Str->Count + (Count + 1)) * sizeof (CHAR16) > Str->Capacity) {

+    Str->Capacity = (Str->Count + (Count + 1) * 2) * sizeof (CHAR16);

+    Str->Str = ReallocatePool (

+                 Str->Count * sizeof (CHAR16),

+                 Str->Capacity,

+                 Str->Str

+                 );

+    ASSERT (Str->Str != NULL);

+  }

+  VA_START (Args, Fmt);

+  UnicodeVSPrint (&Str->Str[Str->Count], Str->Capacity - Str->Count * sizeof (CHAR16), Fmt, Args);

+  Str->Count += Count;

+

+  VA_END (Args);

+  return Str->Str;

+}

+

+/**

+  Converts a PCI device path structure to its string representative.

+

+  @param Str             The string representative of input device.

+  @param DevPath         The input device path structure.

+  @param DisplayOnly     If DisplayOnly is TRUE, then the shorter text representation

+                         of the display node is used, where applicable. If DisplayOnly

+                         is FALSE, then the longer text representation of the display node

+                         is used.

+  @param AllowShortcuts  If AllowShortcuts is TRUE, then the shortcut forms of text

+                         representation for a device node can be used, where applicable.

+

+**/

+VOID

+DevPathToTextPci (

+  IN OUT POOL_PRINT  *Str,

+  IN VOID            *DevPath,

+  IN BOOLEAN         DisplayOnly,

+  IN BOOLEAN         AllowShortcuts

+  )

+{

+  PCI_DEVICE_PATH *Pci;

+

+  Pci = DevPath;

+  UefiDevicePathLibCatPrint (Str, L"Pci(0x%x,0x%x)", Pci->Device, Pci->Function);

+}

+

+/**

+  Converts a PC Card device path structure to its string representative.

+

+  @param Str             The string representative of input device.

+  @param DevPath         The input device path structure.

+  @param DisplayOnly     If DisplayOnly is TRUE, then the shorter text representation

+                         of the display node is used, where applicable. If DisplayOnly

+                         is FALSE, then the longer text representation of the display node

+                         is used.

+  @param AllowShortcuts  If AllowShortcuts is TRUE, then the shortcut forms of text

+                         representation for a device node can be used, where applicable.

+

+**/

+VOID

+DevPathToTextPccard (

+  IN OUT POOL_PRINT  *Str,

+  IN VOID            *DevPath,

+  IN BOOLEAN         DisplayOnly,

+  IN BOOLEAN         AllowShortcuts

+  )

+{

+  PCCARD_DEVICE_PATH  *Pccard;

+

+  Pccard = DevPath;

+  UefiDevicePathLibCatPrint (Str, L"PcCard(0x%x)", Pccard->FunctionNumber);

+}

+

+/**

+  Converts a Memory Map device path structure to its string representative.

+

+  @param Str             The string representative of input device.

+  @param DevPath         The input device path structure.

+  @param DisplayOnly     If DisplayOnly is TRUE, then the shorter text representation

+                         of the display node is used, where applicable. If DisplayOnly

+                         is FALSE, then the longer text representation of the display node

+                         is used.

+  @param AllowShortcuts  If AllowShortcuts is TRUE, then the shortcut forms of text

+                         representation for a device node can be used, where applicable.

+

+**/

+VOID

+DevPathToTextMemMap (

+  IN OUT POOL_PRINT  *Str,

+  IN VOID            *DevPath,

+  IN BOOLEAN         DisplayOnly,

+  IN BOOLEAN         AllowShortcuts

+  )

+{

+  MEMMAP_DEVICE_PATH  *MemMap;

+

+  MemMap = DevPath;

+  UefiDevicePathLibCatPrint (

+    Str,

+    L"MemoryMapped(0x%x,0x%lx,0x%lx)",

+    MemMap->MemoryType,

+    MemMap->StartingAddress,

+    MemMap->EndingAddress

+    );

+}

+

+/**

+  Converts a Vendor device path structure to its string representative.

+

+  @param Str             The string representative of input device.

+  @param DevPath         The input device path structure.

+  @param DisplayOnly     If DisplayOnly is TRUE, then the shorter text representation

+                         of the display node is used, where applicable. If DisplayOnly

+                         is FALSE, then the longer text representation of the display node

+                         is used.

+  @param AllowShortcuts  If AllowShortcuts is TRUE, then the shortcut forms of text

+                         representation for a device node can be used, where applicable.

+

+**/

+VOID

+DevPathToTextVendor (

+  IN OUT POOL_PRINT  *Str,

+  IN VOID            *DevPath,

+  IN BOOLEAN         DisplayOnly,

+  IN BOOLEAN         AllowShortcuts

+  )

+{

+  VENDOR_DEVICE_PATH  *Vendor;

+  CHAR16              *Type;

+  UINTN               Index;

+  UINTN               DataLength;

+  UINT32              FlowControlMap;

+  UINT16              Info;

+

+  Vendor = (VENDOR_DEVICE_PATH *) DevPath;

+  switch (DevicePathType (&Vendor->Header)) {

+  case HARDWARE_DEVICE_PATH:

+    Type = L"Hw";

+    break;

+

+  case MESSAGING_DEVICE_PATH:

+    Type = L"Msg";

+    if (AllowShortcuts) {

+      if (CompareGuid (&Vendor->Guid, &gEfiPcAnsiGuid)) {

+        UefiDevicePathLibCatPrint (Str, L"VenPcAnsi()");

+        return ;

+      } else if (CompareGuid (&Vendor->Guid, &gEfiVT100Guid)) {

+        UefiDevicePathLibCatPrint (Str, L"VenVt100()");

+        return ;

+      } else if (CompareGuid (&Vendor->Guid, &gEfiVT100PlusGuid)) {

+        UefiDevicePathLibCatPrint (Str, L"VenVt100Plus()");

+        return ;

+      } else if (CompareGuid (&Vendor->Guid, &gEfiVTUTF8Guid)) {

+        UefiDevicePathLibCatPrint (Str, L"VenUtf8()");

+        return ;

+      } else if (CompareGuid (&Vendor->Guid, &gEfiUartDevicePathGuid)) {

+        FlowControlMap = (((UART_FLOW_CONTROL_DEVICE_PATH *) Vendor)->FlowControlMap);

+        switch (FlowControlMap & 0x00000003) {

+        case 0:

+          UefiDevicePathLibCatPrint (Str, L"UartFlowCtrl(%s)", L"None");

+          break;

+

+        case 1:

+          UefiDevicePathLibCatPrint (Str, L"UartFlowCtrl(%s)", L"Hardware");

+          break;

+

+        case 2:

+          UefiDevicePathLibCatPrint (Str, L"UartFlowCtrl(%s)", L"XonXoff");

+          break;

+

+        default:

+          break;

+        }

+

+        return ;

+      } else if (CompareGuid (&Vendor->Guid, &gEfiSasDevicePathGuid)) {

+        UefiDevicePathLibCatPrint (

+          Str,

+          L"SAS(0x%lx,0x%lx,0x%x,",

+          ((SAS_DEVICE_PATH *) Vendor)->SasAddress,

+          ((SAS_DEVICE_PATH *) Vendor)->Lun,

+          ((SAS_DEVICE_PATH *) Vendor)->RelativeTargetPort

+          );

+        Info = (((SAS_DEVICE_PATH *) Vendor)->DeviceTopology);

+        if (((Info & 0x0f) == 0) && ((Info & BIT7) == 0)) {

+          UefiDevicePathLibCatPrint (Str, L"NoTopology,0,0,0,");

+        } else if (((Info & 0x0f) <= 2) && ((Info & BIT7) == 0)) {

+          UefiDevicePathLibCatPrint (

+            Str,

+            L"%s,%s,%s,",

+            ((Info & BIT4) != 0) ? L"SATA" : L"SAS",

+            ((Info & BIT5) != 0) ? L"External" : L"Internal",

+            ((Info & BIT6) != 0) ? L"Expanded" : L"Direct"

+            );

+          if ((Info & 0x0f) == 1) {

+            UefiDevicePathLibCatPrint (Str, L"0,");

+          } else {

+            //

+            // Value 0x0 thru 0xFF -> Drive 1 thru Drive 256

+            //

+            UefiDevicePathLibCatPrint (Str, L"0x%x,", ((Info >> 8) & 0xff) + 1);

+          }

+        } else {

+          UefiDevicePathLibCatPrint (Str, L"0x%x,0,0,0,", Info);

+        }

+

+        UefiDevicePathLibCatPrint (Str, L"0x%x)", ((SAS_DEVICE_PATH *) Vendor)->Reserved);

+        return ;

+      } else if (CompareGuid (&Vendor->Guid, &gEfiDebugPortProtocolGuid)) {

+        UefiDevicePathLibCatPrint (Str, L"DebugPort()");

+        return ;

+      }

+    }

+    break;

+

+  case MEDIA_DEVICE_PATH:

+    Type = L"Media";

+    break;

+

+  default:

+    Type = L"?";

+    break;

+  }

+

+  DataLength = DevicePathNodeLength (&Vendor->Header) - sizeof (VENDOR_DEVICE_PATH);

+  UefiDevicePathLibCatPrint (Str, L"Ven%s(%g", Type, &Vendor->Guid);

+  if (DataLength != 0) {

+    UefiDevicePathLibCatPrint (Str, L",");

+    for (Index = 0; Index < DataLength; Index++) {

+      UefiDevicePathLibCatPrint (Str, L"%02x", ((VENDOR_DEVICE_PATH_WITH_DATA *) Vendor)->VendorDefinedData[Index]);

+    }

+  }

+

+  UefiDevicePathLibCatPrint (Str, L")");

+}

+

+/**

+  Converts a Controller device path structure to its string representative.

+

+  @param Str             The string representative of input device.

+  @param DevPath         The input device path structure.

+  @param DisplayOnly     If DisplayOnly is TRUE, then the shorter text representation

+                         of the display node is used, where applicable. If DisplayOnly

+                         is FALSE, then the longer text representation of the display node

+                         is used.

+  @param AllowShortcuts  If AllowShortcuts is TRUE, then the shortcut forms of text

+                         representation for a device node can be used, where applicable.

+

+**/

+VOID

+DevPathToTextController (

+  IN OUT POOL_PRINT  *Str,

+  IN VOID            *DevPath,

+  IN BOOLEAN         DisplayOnly,

+  IN BOOLEAN         AllowShortcuts

+  )

+{

+  CONTROLLER_DEVICE_PATH  *Controller;

+

+  Controller = DevPath;

+  UefiDevicePathLibCatPrint (

+    Str,

+    L"Ctrl(0x%x)",

+    Controller->ControllerNumber

+    );

+}

+

+/**

+  Converts a BMC device path structure to its string representative.

+

+  @param Str             The string representative of input device.

+  @param DevPath         The input device path structure.

+  @param DisplayOnly     If DisplayOnly is TRUE, then the shorter text representation

+                         of the display node is used, where applicable. If DisplayOnly

+                         is FALSE, then the longer text representation of the display node

+                         is used.

+  @param AllowShortcuts  If AllowShortcuts is TRUE, then the shortcut forms of text

+                         representation for a device node can be used, where applicable.

+

+**/

+VOID

+DevPathToTextBmc (

+  IN OUT POOL_PRINT  *Str,

+  IN VOID            *DevPath,

+  IN BOOLEAN         DisplayOnly,

+  IN BOOLEAN         AllowShortcuts

+  )

+{

+  BMC_DEVICE_PATH    *Bmc;

+

+  Bmc = DevPath;

+  UefiDevicePathLibCatPrint (

+    Str,

+    L"BMC(0x%x,0x%lx)",

+    Bmc->InterfaceType,

+    ReadUnaligned64 ((UINT64 *) (&Bmc->BaseAddress))

+    );

+}

+

+/**

+  Converts a ACPI device path structure to its string representative.

+

+  @param Str             The string representative of input device.

+  @param DevPath         The input device path structure.

+  @param DisplayOnly     If DisplayOnly is TRUE, then the shorter text representation

+                         of the display node is used, where applicable. If DisplayOnly

+                         is FALSE, then the longer text representation of the display node

+                         is used.

+  @param AllowShortcuts  If AllowShortcuts is TRUE, then the shortcut forms of text

+                         representation for a device node can be used, where applicable.

+

+**/

+VOID

+DevPathToTextAcpi (

+  IN OUT POOL_PRINT  *Str,

+  IN VOID            *DevPath,

+  IN BOOLEAN         DisplayOnly,

+  IN BOOLEAN         AllowShortcuts

+  )

+{

+  ACPI_HID_DEVICE_PATH  *Acpi;

+

+  Acpi = DevPath;

+  if ((Acpi->HID & PNP_EISA_ID_MASK) == PNP_EISA_ID_CONST) {

+    switch (EISA_ID_TO_NUM (Acpi->HID)) {

+    case 0x0a03:

+      UefiDevicePathLibCatPrint (Str, L"PciRoot(0x%x)", Acpi->UID);

+      break;

+

+    case 0x0a08:

+      UefiDevicePathLibCatPrint (Str, L"PcieRoot(0x%x)", Acpi->UID);

+      break;

+

+    case 0x0604:

+      UefiDevicePathLibCatPrint (Str, L"Floppy(0x%x)", Acpi->UID);

+      break;

+

+    case 0x0301:

+      UefiDevicePathLibCatPrint (Str, L"Keyboard(0x%x)", Acpi->UID);

+      break;

+

+    case 0x0501:

+      UefiDevicePathLibCatPrint (Str, L"Serial(0x%x)", Acpi->UID);

+      break;

+

+    case 0x0401:

+      UefiDevicePathLibCatPrint (Str, L"ParallelPort(0x%x)", Acpi->UID);

+      break;

+

+    default:

+      UefiDevicePathLibCatPrint (Str, L"Acpi(PNP%04x,0x%x)", EISA_ID_TO_NUM (Acpi->HID), Acpi->UID);

+      break;

+    }

+  } else {

+    UefiDevicePathLibCatPrint (Str, L"Acpi(0x%08x,0x%x)", Acpi->HID, Acpi->UID);

+  }

+}

+

+/**

+  Converts a ACPI extended HID device path structure to its string representative.

+

+  @param Str             The string representative of input device.

+  @param DevPath         The input device path structure.

+  @param DisplayOnly     If DisplayOnly is TRUE, then the shorter text representation

+                         of the display node is used, where applicable. If DisplayOnly

+                         is FALSE, then the longer text representation of the display node

+                         is used.

+  @param AllowShortcuts  If AllowShortcuts is TRUE, then the shortcut forms of text

+                         representation for a device node can be used, where applicable.

+

+**/

+VOID

+DevPathToTextAcpiEx (

+  IN OUT POOL_PRINT  *Str,

+  IN VOID            *DevPath,

+  IN BOOLEAN         DisplayOnly,

+  IN BOOLEAN         AllowShortcuts

+  )

+{

+  ACPI_EXTENDED_HID_DEVICE_PATH  *AcpiEx;

+  CHAR8                          *HIDStr;

+  CHAR8                          *UIDStr;

+  CHAR8                          *CIDStr;

+  CHAR16                         HIDText[11];

+  CHAR16                         CIDText[11];

+

+  AcpiEx = DevPath;

+  HIDStr = (CHAR8 *) (((UINT8 *) AcpiEx) + sizeof (ACPI_EXTENDED_HID_DEVICE_PATH));

+  UIDStr = HIDStr + AsciiStrLen (HIDStr) + 1;

+  CIDStr = UIDStr + AsciiStrLen (UIDStr) + 1;

+

+  if (DisplayOnly) {

+    if ((EISA_ID_TO_NUM (AcpiEx->HID) == 0x0A03) ||

+        (EISA_ID_TO_NUM (AcpiEx->CID) == 0x0A03 && EISA_ID_TO_NUM (AcpiEx->HID) != 0x0A08)) {

+      if (AcpiEx->UID == 0) {

+        UefiDevicePathLibCatPrint (Str, L"PciRoot(%a)", UIDStr);

+      } else {

+        UefiDevicePathLibCatPrint (Str, L"PciRoot(0x%x)", AcpiEx->UID);

+      }

+      return;

+    }

+

+    if (EISA_ID_TO_NUM (AcpiEx->HID) == 0x0A08 || EISA_ID_TO_NUM (AcpiEx->CID) == 0x0A08) {

+      if (AcpiEx->UID == 0) {

+        UefiDevicePathLibCatPrint (Str, L"PcieRoot(%a)", UIDStr);

+      } else {

+        UefiDevicePathLibCatPrint (Str, L"PcieRoot(0x%x)", AcpiEx->UID);

+      }

+      return;

+    }

+  }

+

+  //

+  // Converts EISA identification to string.

+  //

+  UnicodeSPrint (

+    HIDText,

+    sizeof (HIDText),

+    L"%c%c%c%04X",

+    ((AcpiEx->HID >> 10) & 0x1f) + 'A' - 1,

+    ((AcpiEx->HID >>  5) & 0x1f) + 'A' - 1,

+    ((AcpiEx->HID >>  0) & 0x1f) + 'A' - 1,

+    (AcpiEx->HID >> 16) & 0xFFFF

+    );

+  UnicodeSPrint (

+    CIDText,

+    sizeof (CIDText),

+    L"%c%c%c%04X",

+    ((AcpiEx->CID >> 10) & 0x1f) + 'A' - 1,

+    ((AcpiEx->CID >>  5) & 0x1f) + 'A' - 1,

+    ((AcpiEx->CID >>  0) & 0x1f) + 'A' - 1,

+    (AcpiEx->CID >> 16) & 0xFFFF

+    );

+

+  if ((*HIDStr == '\0') && (*CIDStr == '\0') && (*UIDStr != '\0')) {

+    //

+    // use AcpiExp()

+    //

+    if (AcpiEx->CID == 0) {

+      UefiDevicePathLibCatPrint (

+        Str,

+        L"AcpiExp(%s,0,%a)",

+        HIDText,

+        UIDStr

+       );

+    } else {

+      UefiDevicePathLibCatPrint (

+        Str,

+        L"AcpiExp(%s,%s,%a)",

+        HIDText,

+        CIDText,

+        UIDStr

+       );

+    }

+  } else {

+    if (DisplayOnly) {

+      //

+      // display only

+      //

+      if (AcpiEx->HID == 0) {

+        UefiDevicePathLibCatPrint (Str, L"AcpiEx(%a,", HIDStr);

+      } else {

+        UefiDevicePathLibCatPrint (Str, L"AcpiEx(%s,", HIDText);

+      }

+

+      if (AcpiEx->CID == 0) {

+        UefiDevicePathLibCatPrint (Str, L"%a,", CIDStr);

+      } else {

+        UefiDevicePathLibCatPrint (Str, L"%s,", CIDText);

+      }

+

+      if (AcpiEx->UID == 0) {

+        UefiDevicePathLibCatPrint (Str, L"%a)", UIDStr);

+      } else {

+        UefiDevicePathLibCatPrint (Str, L"0x%x)", AcpiEx->UID);

+      }

+    } else {

+      UefiDevicePathLibCatPrint (

+        Str,

+        L"AcpiEx(%s,%s,0x%x,%a,%a,%a)",

+        HIDText,

+        CIDText,

+        AcpiEx->UID,

+        HIDStr,

+        CIDStr,

+        UIDStr

+        );

+    }

+  }

+}

+

+/**

+  Converts a ACPI address device path structure to its string representative.

+

+  @param Str             The string representative of input device.

+  @param DevPath         The input device path structure.

+  @param DisplayOnly     If DisplayOnly is TRUE, then the shorter text representation

+                         of the display node is used, where applicable. If DisplayOnly

+                         is FALSE, then the longer text representation of the display node

+                         is used.

+  @param AllowShortcuts  If AllowShortcuts is TRUE, then the shortcut forms of text

+                         representation for a device node can be used, where applicable.

+

+**/

+VOID

+DevPathToTextAcpiAdr (

+  IN OUT POOL_PRINT  *Str,

+  IN VOID            *DevPath,

+  IN BOOLEAN         DisplayOnly,

+  IN BOOLEAN         AllowShortcuts

+  )

+{

+  ACPI_ADR_DEVICE_PATH    *AcpiAdr;

+  UINT16                  Index;

+  UINT16                  Length;

+  UINT16                  AdditionalAdrCount;

+

+  AcpiAdr            = DevPath;

+  Length             = (UINT16) DevicePathNodeLength ((EFI_DEVICE_PATH_PROTOCOL *) AcpiAdr);

+  AdditionalAdrCount = (UINT16) ((Length - 8) / 4);

+

+  UefiDevicePathLibCatPrint (Str, L"AcpiAdr(0x%x", AcpiAdr->ADR);

+  for (Index = 0; Index < AdditionalAdrCount; Index++) {

+    UefiDevicePathLibCatPrint (Str, L",0x%x", *(UINT32 *) ((UINT8 *) AcpiAdr + 8 + Index * 4));

+  }

+  UefiDevicePathLibCatPrint (Str, L")");

+}

+

+/**

+  Converts a ATAPI device path structure to its string representative.

+

+  @param Str             The string representative of input device.

+  @param DevPath         The input device path structure.

+  @param DisplayOnly     If DisplayOnly is TRUE, then the shorter text representation

+                         of the display node is used, where applicable. If DisplayOnly

+                         is FALSE, then the longer text representation of the display node

+                         is used.

+  @param AllowShortcuts  If AllowShortcuts is TRUE, then the shortcut forms of text

+                         representation for a device node can be used, where applicable.

+

+**/

+VOID

+DevPathToTextAtapi (

+  IN OUT POOL_PRINT  *Str,

+  IN VOID            *DevPath,

+  IN BOOLEAN         DisplayOnly,

+  IN BOOLEAN         AllowShortcuts

+  )

+{

+  ATAPI_DEVICE_PATH *Atapi;

+

+  Atapi = DevPath;

+

+  if (DisplayOnly) {

+    UefiDevicePathLibCatPrint (Str, L"Ata(0x%x)", Atapi->Lun);

+  } else {

+    UefiDevicePathLibCatPrint (

+      Str,

+      L"Ata(%s,%s,0x%x)",

+      (Atapi->PrimarySecondary == 1) ? L"Secondary" : L"Primary",

+      (Atapi->SlaveMaster == 1) ? L"Slave" : L"Master",

+      Atapi->Lun

+      );

+  }

+}

+

+/**

+  Converts a SCSI device path structure to its string representative.

+

+  @param Str             The string representative of input device.

+  @param DevPath         The input device path structure.

+  @param DisplayOnly     If DisplayOnly is TRUE, then the shorter text representation

+                         of the display node is used, where applicable. If DisplayOnly

+                         is FALSE, then the longer text representation of the display node

+                         is used.

+  @param AllowShortcuts  If AllowShortcuts is TRUE, then the shortcut forms of text

+                         representation for a device node can be used, where applicable.

+

+**/

+VOID

+DevPathToTextScsi (

+  IN OUT POOL_PRINT  *Str,

+  IN VOID            *DevPath,

+  IN BOOLEAN         DisplayOnly,

+  IN BOOLEAN         AllowShortcuts

+  )

+{

+  SCSI_DEVICE_PATH  *Scsi;

+

+  Scsi = DevPath;

+  UefiDevicePathLibCatPrint (Str, L"Scsi(0x%x,0x%x)", Scsi->Pun, Scsi->Lun);

+}

+

+/**

+  Converts a Fibre device path structure to its string representative.

+

+  @param Str             The string representative of input device.

+  @param DevPath         The input device path structure.

+  @param DisplayOnly     If DisplayOnly is TRUE, then the shorter text representation

+                         of the display node is used, where applicable. If DisplayOnly

+                         is FALSE, then the longer text representation of the display node

+                         is used.

+  @param AllowShortcuts  If AllowShortcuts is TRUE, then the shortcut forms of text

+                         representation for a device node can be used, where applicable.

+

+**/

+VOID

+DevPathToTextFibre (

+  IN OUT POOL_PRINT  *Str,

+  IN VOID            *DevPath,

+  IN BOOLEAN         DisplayOnly,

+  IN BOOLEAN         AllowShortcuts

+  )

+{

+  FIBRECHANNEL_DEVICE_PATH  *Fibre;

+

+  Fibre = DevPath;

+  UefiDevicePathLibCatPrint (Str, L"Fibre(0x%lx,0x%lx)", Fibre->WWN, Fibre->Lun);

+}

+

+/**

+  Converts a FibreEx device path structure to its string representative.

+

+  @param Str             The string representative of input device.

+  @param DevPath         The input device path structure.

+  @param DisplayOnly     If DisplayOnly is TRUE, then the shorter text representation

+                         of the display node is used, where applicable. If DisplayOnly

+                         is FALSE, then the longer text representation of the display node

+                         is used.

+  @param AllowShortcuts  If AllowShortcuts is TRUE, then the shortcut forms of text

+                         representation for a device node can be used, where applicable.

+

+**/

+VOID

+DevPathToTextFibreEx (

+  IN OUT POOL_PRINT  *Str,

+  IN VOID            *DevPath,

+  IN BOOLEAN         DisplayOnly,

+  IN BOOLEAN         AllowShortcuts

+  )

+{

+  FIBRECHANNELEX_DEVICE_PATH  *FibreEx;

+  UINTN                       Index;

+

+  FibreEx = DevPath;

+  UefiDevicePathLibCatPrint (Str, L"FibreEx(0x");

+  for (Index = 0; Index < sizeof (FibreEx->WWN) / sizeof (FibreEx->WWN[0]); Index++) {

+    UefiDevicePathLibCatPrint (Str, L"%02x", FibreEx->WWN[Index]);

+  }

+  UefiDevicePathLibCatPrint (Str, L",0x");

+  for (Index = 0; Index < sizeof (FibreEx->Lun) / sizeof (FibreEx->Lun[0]); Index++) {

+    UefiDevicePathLibCatPrint (Str, L"%02x", FibreEx->Lun[Index]);

+  }

+  UefiDevicePathLibCatPrint (Str, L")");

+}

+

+/**

+  Converts a Sas Ex device path structure to its string representative.

+

+  @param Str             The string representative of input device.

+  @param DevPath         The input device path structure.

+  @param DisplayOnly     If DisplayOnly is TRUE, then the shorter text representation

+                         of the display node is used, where applicable. If DisplayOnly

+                         is FALSE, then the longer text representation of the display node

+                         is used.

+  @param AllowShortcuts  If AllowShortcuts is TRUE, then the shortcut forms of text

+                         representation for a device node can be used, where applicable.

+

+**/

+VOID

+DevPathToTextSasEx (

+  IN OUT POOL_PRINT  *Str,

+  IN VOID            *DevPath,

+  IN BOOLEAN         DisplayOnly,

+  IN BOOLEAN         AllowShortcuts

+  )

+{

+  SASEX_DEVICE_PATH  *SasEx;

+  UINTN              Index;

+

+  SasEx = DevPath;

+  UefiDevicePathLibCatPrint (Str, L"SasEx(0x");

+

+  for (Index = 0; Index < sizeof (SasEx->SasAddress) / sizeof (SasEx->SasAddress[0]); Index++) {

+    UefiDevicePathLibCatPrint (Str, L"%02x", SasEx->SasAddress[Index]);

+  }

+  UefiDevicePathLibCatPrint (Str, L",0x");

+  for (Index = 0; Index < sizeof (SasEx->Lun) / sizeof (SasEx->Lun[0]); Index++) {

+    UefiDevicePathLibCatPrint (Str, L"%02x", SasEx->Lun[Index]);

+  }

+  UefiDevicePathLibCatPrint (Str, L",0x%x,", SasEx->RelativeTargetPort);

+

+  if (((SasEx->DeviceTopology & 0x0f) == 0) && ((SasEx->DeviceTopology & BIT7) == 0)) {

+    UefiDevicePathLibCatPrint (Str, L"NoTopology,0,0,0");

+  } else if (((SasEx->DeviceTopology & 0x0f) <= 2) && ((SasEx->DeviceTopology & BIT7) == 0)) {

+    UefiDevicePathLibCatPrint (

+      Str,

+      L"%s,%s,%s,",

+      ((SasEx->DeviceTopology & BIT4) != 0) ? L"SATA" : L"SAS",

+      ((SasEx->DeviceTopology & BIT5) != 0) ? L"External" : L"Internal",

+      ((SasEx->DeviceTopology & BIT6) != 0) ? L"Expanded" : L"Direct"

+      );

+    if ((SasEx->DeviceTopology & 0x0f) == 1) {

+      UefiDevicePathLibCatPrint (Str, L"0");

+    } else {

+      //

+      // Value 0x0 thru 0xFF -> Drive 1 thru Drive 256

+      //

+      UefiDevicePathLibCatPrint (Str, L"0x%x", ((SasEx->DeviceTopology >> 8) & 0xff) + 1);

+    }

+  } else {

+    UefiDevicePathLibCatPrint (Str, L"0x%x,0,0,0", SasEx->DeviceTopology);

+  }

+

+  UefiDevicePathLibCatPrint (Str, L")");

+  return ;

+

+}

+

+/**

+  Converts a NVM Express Namespace device path structure to its string representative.

+

+  @param Str             The string representative of input device.

+  @param DevPath         The input device path structure.

+  @param DisplayOnly     If DisplayOnly is TRUE, then the shorter text representation

+                         of the display node is used, where applicable. If DisplayOnly

+                         is FALSE, then the longer text representation of the display node

+                         is used.

+  @param AllowShortcuts  If AllowShortcuts is TRUE, then the shortcut forms of text

+                         representation for a device node can be used, where applicable.

+

+**/

+VOID

+DevPathToTextNVMe (

+  IN OUT POOL_PRINT  *Str,

+  IN VOID            *DevPath,

+  IN BOOLEAN         DisplayOnly,

+  IN BOOLEAN         AllowShortcuts

+  )

+{

+  NVME_NAMESPACE_DEVICE_PATH *Nvme;

+  UINT8                      *Uuid;

+

+  Nvme = DevPath;

+  Uuid = (UINT8 *) &Nvme->NamespaceUuid;

+  UefiDevicePathLibCatPrint (

+    Str,

+    L"NVMe(0x%x,%02x-%02x-%02x-%02x-%02x-%02x-%02x-%02x)",

+    Nvme->NamespaceId,

+    Uuid[7], Uuid[6], Uuid[5], Uuid[4],

+    Uuid[3], Uuid[2], Uuid[1], Uuid[0]

+    );

+}

+

+/**

+  Converts a UFS device path structure to its string representative.

+

+  @param Str             The string representative of input device.

+  @param DevPath         The input device path structure.

+  @param DisplayOnly     If DisplayOnly is TRUE, then the shorter text representation

+                         of the display node is used, where applicable. If DisplayOnly

+                         is FALSE, then the longer text representation of the display node

+                         is used.

+  @param AllowShortcuts  If AllowShortcuts is TRUE, then the shortcut forms of text

+                         representation for a device node can be used, where applicable.

+

+**/

+VOID

+DevPathToTextUfs (

+  IN OUT POOL_PRINT  *Str,

+  IN VOID            *DevPath,

+  IN BOOLEAN         DisplayOnly,

+  IN BOOLEAN         AllowShortcuts

+  )

+{

+  UFS_DEVICE_PATH  *Ufs;

+

+  Ufs = DevPath;

+  UefiDevicePathLibCatPrint (Str, L"UFS(0x%x,0x%x)", Ufs->Pun, Ufs->Lun);

+}

+

+/**

+  Converts a SD (Secure Digital) device path structure to its string representative.

+

+  @param Str             The string representative of input device.

+  @param DevPath         The input device path structure.

+  @param DisplayOnly     If DisplayOnly is TRUE, then the shorter text representation

+                         of the display node is used, where applicable. If DisplayOnly

+                         is FALSE, then the longer text representation of the display node

+                         is used.

+  @param AllowShortcuts  If AllowShortcuts is TRUE, then the shortcut forms of text

+                         representation for a device node can be used, where applicable.

+

+**/

+VOID

+DevPathToTextSd (

+  IN OUT POOL_PRINT  *Str,

+  IN VOID            *DevPath,

+  IN BOOLEAN         DisplayOnly,

+  IN BOOLEAN         AllowShortcuts

+  )

+{

+  SD_DEVICE_PATH             *Sd;

+

+  Sd = DevPath;

+  UefiDevicePathLibCatPrint (

+    Str,

+    L"SD(0x%x)",

+    Sd->SlotNumber

+    );

+}

+

+/**

+  Converts a EMMC (Embedded MMC) device path structure to its string representative.

+

+  @param Str             The string representative of input device.

+  @param DevPath         The input device path structure.

+  @param DisplayOnly     If DisplayOnly is TRUE, then the shorter text representation

+                         of the display node is used, where applicable. If DisplayOnly

+                         is FALSE, then the longer text representation of the display node

+                         is used.

+  @param AllowShortcuts  If AllowShortcuts is TRUE, then the shortcut forms of text

+                         representation for a device node can be used, where applicable.

+

+**/

+VOID

+DevPathToTextEmmc (

+  IN OUT POOL_PRINT  *Str,

+  IN VOID            *DevPath,

+  IN BOOLEAN         DisplayOnly,

+  IN BOOLEAN         AllowShortcuts

+  )

+{

+  EMMC_DEVICE_PATH             *Emmc;

+

+  Emmc = DevPath;

+  UefiDevicePathLibCatPrint (

+    Str,

+    L"eMMC(0x%x)",

+    Emmc->SlotNumber

+    );

+}

+

+/**

+  Converts a 1394 device path structure to its string representative.

+

+  @param Str             The string representative of input device.

+  @param DevPath         The input device path structure.

+  @param DisplayOnly     If DisplayOnly is TRUE, then the shorter text representation

+                         of the display node is used, where applicable. If DisplayOnly

+                         is FALSE, then the longer text representation of the display node

+                         is used.

+  @param AllowShortcuts  If AllowShortcuts is TRUE, then the shortcut forms of text

+                         representation for a device node can be used, where applicable.

+

+**/

+VOID

+DevPathToText1394 (

+  IN OUT POOL_PRINT  *Str,

+  IN VOID            *DevPath,

+  IN BOOLEAN         DisplayOnly,

+  IN BOOLEAN         AllowShortcuts

+  )

+{

+  F1394_DEVICE_PATH *F1394DevPath;

+

+  F1394DevPath = DevPath;

+  //

+  // Guid has format of IEEE-EUI64

+  //

+  UefiDevicePathLibCatPrint (Str, L"I1394(%016lx)", F1394DevPath->Guid);

+}

+

+/**

+  Converts a USB device path structure to its string representative.

+

+  @param Str             The string representative of input device.

+  @param DevPath         The input device path structure.

+  @param DisplayOnly     If DisplayOnly is TRUE, then the shorter text representation

+                         of the display node is used, where applicable. If DisplayOnly

+                         is FALSE, then the longer text representation of the display node

+                         is used.

+  @param AllowShortcuts  If AllowShortcuts is TRUE, then the shortcut forms of text

+                         representation for a device node can be used, where applicable.

+

+**/

+VOID

+DevPathToTextUsb (

+  IN OUT POOL_PRINT  *Str,

+  IN VOID            *DevPath,

+  IN BOOLEAN         DisplayOnly,

+  IN BOOLEAN         AllowShortcuts

+  )

+{

+  USB_DEVICE_PATH *Usb;

+

+  Usb = DevPath;

+  UefiDevicePathLibCatPrint (Str, L"USB(0x%x,0x%x)", Usb->ParentPortNumber, Usb->InterfaceNumber);

+}

+

+/**

+  Converts a USB WWID device path structure to its string representative.

+

+  @param Str             The string representative of input device.

+  @param DevPath         The input device path structure.

+  @param DisplayOnly     If DisplayOnly is TRUE, then the shorter text representation

+                         of the display node is used, where applicable. If DisplayOnly

+                         is FALSE, then the longer text representation of the display node

+                         is used.

+  @param AllowShortcuts  If AllowShortcuts is TRUE, then the shortcut forms of text

+                         representation for a device node can be used, where applicable.

+

+**/

+VOID

+DevPathToTextUsbWWID (

+  IN OUT POOL_PRINT  *Str,

+  IN VOID            *DevPath,

+  IN BOOLEAN         DisplayOnly,

+  IN BOOLEAN         AllowShortcuts

+  )

+{

+  USB_WWID_DEVICE_PATH  *UsbWWId;

+  CHAR16                *SerialNumberStr;

+  CHAR16                *NewStr;

+  UINT16                Length;

+

+  UsbWWId = DevPath;

+

+  SerialNumberStr = (CHAR16 *) ((UINT8 *) UsbWWId + sizeof (USB_WWID_DEVICE_PATH));

+  Length = (UINT16) ((DevicePathNodeLength ((EFI_DEVICE_PATH_PROTOCOL *) UsbWWId) - sizeof (USB_WWID_DEVICE_PATH)) / sizeof (CHAR16));

+  if (Length >= 1 && SerialNumberStr [Length - 1] != 0) {

+    //

+    // In case no NULL terminator in SerialNumber, create a new one with NULL terminator

+    //

+    NewStr = AllocateCopyPool ((Length + 1) * sizeof (CHAR16), SerialNumberStr);

+    ASSERT (NewStr != NULL);

+    NewStr [Length] = 0;

+    SerialNumberStr = NewStr;

+  }

+

+  UefiDevicePathLibCatPrint (

+    Str,

+    L"UsbWwid(0x%x,0x%x,0x%x,\"%s\")",

+    UsbWWId->VendorId,

+    UsbWWId->ProductId,

+    UsbWWId->InterfaceNumber,

+    SerialNumberStr

+    );

+}

+

+/**

+  Converts a Logic Unit device path structure to its string representative.

+

+  @param Str             The string representative of input device.

+  @param DevPath         The input device path structure.

+  @param DisplayOnly     If DisplayOnly is TRUE, then the shorter text representation

+                         of the display node is used, where applicable. If DisplayOnly

+                         is FALSE, then the longer text representation of the display node

+                         is used.

+  @param AllowShortcuts  If AllowShortcuts is TRUE, then the shortcut forms of text

+                         representation for a device node can be used, where applicable.

+

+**/

+VOID

+DevPathToTextLogicalUnit (

+  IN OUT POOL_PRINT  *Str,

+  IN VOID            *DevPath,

+  IN BOOLEAN         DisplayOnly,

+  IN BOOLEAN         AllowShortcuts

+  )

+{

+  DEVICE_LOGICAL_UNIT_DEVICE_PATH *LogicalUnit;

+

+  LogicalUnit = DevPath;

+  UefiDevicePathLibCatPrint (Str, L"Unit(0x%x)", LogicalUnit->Lun);

+}

+

+/**

+  Converts a USB class device path structure to its string representative.

+

+  @param Str             The string representative of input device.

+  @param DevPath         The input device path structure.

+  @param DisplayOnly     If DisplayOnly is TRUE, then the shorter text representation

+                         of the display node is used, where applicable. If DisplayOnly

+                         is FALSE, then the longer text representation of the display node

+                         is used.

+  @param AllowShortcuts  If AllowShortcuts is TRUE, then the shortcut forms of text

+                         representation for a device node can be used, where applicable.

+

+**/

+VOID

+DevPathToTextUsbClass (

+  IN OUT POOL_PRINT  *Str,

+  IN VOID            *DevPath,

+  IN BOOLEAN         DisplayOnly,

+  IN BOOLEAN         AllowShortcuts

+  )

+{

+  USB_CLASS_DEVICE_PATH *UsbClass;

+  BOOLEAN               IsKnownSubClass;

+

+

+  UsbClass = DevPath;

+

+  IsKnownSubClass = TRUE;

+  switch (UsbClass->DeviceClass) {

+  case USB_CLASS_AUDIO:

+    UefiDevicePathLibCatPrint (Str, L"UsbAudio");

+    break;

+

+  case USB_CLASS_CDCCONTROL:

+    UefiDevicePathLibCatPrint (Str, L"UsbCDCControl");

+    break;

+

+  case USB_CLASS_HID:

+    UefiDevicePathLibCatPrint (Str, L"UsbHID");

+    break;

+

+  case USB_CLASS_IMAGE:

+    UefiDevicePathLibCatPrint (Str, L"UsbImage");

+    break;

+

+  case USB_CLASS_PRINTER:

+    UefiDevicePathLibCatPrint (Str, L"UsbPrinter");

+    break;

+

+  case USB_CLASS_MASS_STORAGE:

+    UefiDevicePathLibCatPrint (Str, L"UsbMassStorage");

+    break;

+

+  case USB_CLASS_HUB:

+    UefiDevicePathLibCatPrint (Str, L"UsbHub");

+    break;

+

+  case USB_CLASS_CDCDATA:

+    UefiDevicePathLibCatPrint (Str, L"UsbCDCData");

+    break;

+

+  case USB_CLASS_SMART_CARD:

+    UefiDevicePathLibCatPrint (Str, L"UsbSmartCard");

+    break;

+

+  case USB_CLASS_VIDEO:

+    UefiDevicePathLibCatPrint (Str, L"UsbVideo");

+    break;

+

+  case USB_CLASS_DIAGNOSTIC:

+    UefiDevicePathLibCatPrint (Str, L"UsbDiagnostic");

+    break;

+

+  case USB_CLASS_WIRELESS:

+    UefiDevicePathLibCatPrint (Str, L"UsbWireless");

+    break;

+

+  default:

+    IsKnownSubClass = FALSE;

+    break;

+  }

+

+  if (IsKnownSubClass) {

+    UefiDevicePathLibCatPrint (

+      Str,

+      L"(0x%x,0x%x,0x%x,0x%x)",

+      UsbClass->VendorId,

+      UsbClass->ProductId,

+      UsbClass->DeviceSubClass,

+      UsbClass->DeviceProtocol

+      );

+    return;

+  }

+

+  if (UsbClass->DeviceClass == USB_CLASS_RESERVE) {

+    if (UsbClass->DeviceSubClass == USB_SUBCLASS_FW_UPDATE) {

+      UefiDevicePathLibCatPrint (

+        Str,

+        L"UsbDeviceFirmwareUpdate(0x%x,0x%x,0x%x)",

+        UsbClass->VendorId,

+        UsbClass->ProductId,

+        UsbClass->DeviceProtocol

+        );

+      return;

+    } else if (UsbClass->DeviceSubClass == USB_SUBCLASS_IRDA_BRIDGE) {

+      UefiDevicePathLibCatPrint (

+        Str,

+        L"UsbIrdaBridge(0x%x,0x%x,0x%x)",

+        UsbClass->VendorId,

+        UsbClass->ProductId,

+        UsbClass->DeviceProtocol

+        );

+      return;

+    } else if (UsbClass->DeviceSubClass == USB_SUBCLASS_TEST) {

+      UefiDevicePathLibCatPrint (

+        Str,

+        L"UsbTestAndMeasurement(0x%x,0x%x,0x%x)",

+        UsbClass->VendorId,

+        UsbClass->ProductId,

+        UsbClass->DeviceProtocol

+        );

+      return;

+    }

+  }

+

+  UefiDevicePathLibCatPrint (

+    Str,

+    L"UsbClass(0x%x,0x%x,0x%x,0x%x,0x%x)",

+    UsbClass->VendorId,

+    UsbClass->ProductId,

+    UsbClass->DeviceClass,

+    UsbClass->DeviceSubClass,

+    UsbClass->DeviceProtocol

+    );

+}

+

+/**

+  Converts a SATA device path structure to its string representative.

+

+  @param Str             The string representative of input device.

+  @param DevPath         The input device path structure.

+  @param DisplayOnly     If DisplayOnly is TRUE, then the shorter text representation

+                         of the display node is used, where applicable. If DisplayOnly

+                         is FALSE, then the longer text representation of the display node

+                         is used.

+  @param AllowShortcuts  If AllowShortcuts is TRUE, then the shortcut forms of text

+                         representation for a device node can be used, where applicable.

+

+**/

+VOID

+DevPathToTextSata (

+  IN OUT POOL_PRINT  *Str,

+  IN VOID            *DevPath,

+  IN BOOLEAN         DisplayOnly,

+  IN BOOLEAN         AllowShortcuts

+  )

+{

+  SATA_DEVICE_PATH *Sata;

+

+  Sata = DevPath;

+  UefiDevicePathLibCatPrint (

+    Str,

+    L"Sata(0x%x,0x%x,0x%x)",

+    Sata->HBAPortNumber,

+    Sata->PortMultiplierPortNumber,

+    Sata->Lun

+    );

+}

+

+/**

+  Converts a I20 device path structure to its string representative.

+

+  @param Str             The string representative of input device.

+  @param DevPath         The input device path structure.

+  @param DisplayOnly     If DisplayOnly is TRUE, then the shorter text representation

+                         of the display node is used, where applicable. If DisplayOnly

+                         is FALSE, then the longer text representation of the display node

+                         is used.

+  @param AllowShortcuts  If AllowShortcuts is TRUE, then the shortcut forms of text

+                         representation for a device node can be used, where applicable.

+

+**/

+VOID

+DevPathToTextI2O (

+  IN OUT POOL_PRINT  *Str,

+  IN VOID            *DevPath,

+  IN BOOLEAN         DisplayOnly,

+  IN BOOLEAN         AllowShortcuts

+  )

+{

+  I2O_DEVICE_PATH *I2ODevPath;

+

+  I2ODevPath = DevPath;

+  UefiDevicePathLibCatPrint (Str, L"I2O(0x%x)", I2ODevPath->Tid);

+}

+

+/**

+  Converts a MAC address device path structure to its string representative.

+

+  @param Str             The string representative of input device.

+  @param DevPath         The input device path structure.

+  @param DisplayOnly     If DisplayOnly is TRUE, then the shorter text representation

+                         of the display node is used, where applicable. If DisplayOnly

+                         is FALSE, then the longer text representation of the display node

+                         is used.

+  @param AllowShortcuts  If AllowShortcuts is TRUE, then the shortcut forms of text

+                         representation for a device node can be used, where applicable.

+

+**/

+VOID

+DevPathToTextMacAddr (

+  IN OUT POOL_PRINT  *Str,

+  IN VOID            *DevPath,

+  IN BOOLEAN         DisplayOnly,

+  IN BOOLEAN         AllowShortcuts

+  )

+{

+  MAC_ADDR_DEVICE_PATH  *MacDevPath;

+  UINTN                 HwAddressSize;

+  UINTN                 Index;

+

+  MacDevPath = DevPath;

+

+  HwAddressSize = sizeof (EFI_MAC_ADDRESS);

+  if (MacDevPath->IfType == 0x01 || MacDevPath->IfType == 0x00) {

+    HwAddressSize = 6;

+  }

+

+  UefiDevicePathLibCatPrint (Str, L"MAC(");

+

+  for (Index = 0; Index < HwAddressSize; Index++) {

+    UefiDevicePathLibCatPrint (Str, L"%02x", MacDevPath->MacAddress.Addr[Index]);

+  }

+

+  UefiDevicePathLibCatPrint (Str, L",0x%x)", MacDevPath->IfType);

+}

+

+/**

+  Converts network protocol string to its text representation.

+

+  @param Str             The string representative of input device.

+  @param Protocol        The network protocol ID.

+

+**/

+VOID

+CatNetworkProtocol (

+  IN OUT POOL_PRINT  *Str,

+  IN UINT16          Protocol

+  )

+{

+  if (Protocol == RFC_1700_TCP_PROTOCOL) {

+    UefiDevicePathLibCatPrint (Str, L"TCP");

+  } else if (Protocol == RFC_1700_UDP_PROTOCOL) {

+    UefiDevicePathLibCatPrint (Str, L"UDP");

+  } else {

+    UefiDevicePathLibCatPrint (Str, L"0x%x", Protocol);

+  }

+}

+

+/**

+  Converts IP v4 address to its text representation.

+

+  @param Str             The string representative of input device.

+  @param Address         The IP v4 address.

+**/

+VOID

+CatIPv4Address (

+  IN OUT POOL_PRINT   *Str,

+  IN EFI_IPv4_ADDRESS *Address

+  )

+{

+  UefiDevicePathLibCatPrint (Str, L"%d.%d.%d.%d", Address->Addr[0], Address->Addr[1], Address->Addr[2], Address->Addr[3]);

+}

+

+/**

+  Converts IP v6 address to its text representation.

+

+  @param Str             The string representative of input device.

+  @param Address         The IP v6 address.

+**/

+VOID

+CatIPv6Address (

+  IN OUT POOL_PRINT   *Str,

+  IN EFI_IPv6_ADDRESS *Address

+  )

+{

+  UefiDevicePathLibCatPrint (

+    Str, L"%02x%02x:%02x%02x:%02x%02x:%02x%02x:%02x%02x:%02x%02x:%02x%02x:%02x%02x",

+    Address->Addr[0],  Address->Addr[1],

+    Address->Addr[2],  Address->Addr[3],

+    Address->Addr[4],  Address->Addr[5],

+    Address->Addr[6],  Address->Addr[7],

+    Address->Addr[8],  Address->Addr[9],

+    Address->Addr[10], Address->Addr[11],

+    Address->Addr[12], Address->Addr[13],

+    Address->Addr[14], Address->Addr[15]

+  );

+}

+

+/**

+  Converts a IPv4 device path structure to its string representative.

+

+  @param Str             The string representative of input device.

+  @param DevPath         The input device path structure.

+  @param DisplayOnly     If DisplayOnly is TRUE, then the shorter text representation

+                         of the display node is used, where applicable. If DisplayOnly

+                         is FALSE, then the longer text representation of the display node

+                         is used.

+  @param AllowShortcuts  If AllowShortcuts is TRUE, then the shortcut forms of text

+                         representation for a device node can be used, where applicable.

+

+**/

+VOID

+DevPathToTextIPv4 (

+  IN OUT POOL_PRINT  *Str,

+  IN VOID            *DevPath,

+  IN BOOLEAN         DisplayOnly,

+  IN BOOLEAN         AllowShortcuts

+  )

+{

+  IPv4_DEVICE_PATH  *IPDevPath;

+

+  IPDevPath = DevPath;

+  UefiDevicePathLibCatPrint (Str, L"IPv4(");

+  CatIPv4Address (Str, &IPDevPath->RemoteIpAddress);

+

+  if (DisplayOnly) {

+    UefiDevicePathLibCatPrint (Str, L")");

+    return ;

+  }

+

+  UefiDevicePathLibCatPrint (Str, L",");

+  CatNetworkProtocol (Str, IPDevPath->Protocol);

+

+  UefiDevicePathLibCatPrint (Str, L",%s,", IPDevPath->StaticIpAddress ? L"Static" : L"DHCP");

+  CatIPv4Address (Str, &IPDevPath->LocalIpAddress);

+  if (DevicePathNodeLength (IPDevPath) == sizeof (IPv4_DEVICE_PATH)) {

+    UefiDevicePathLibCatPrint (Str, L",");

+    CatIPv4Address (Str, &IPDevPath->GatewayIpAddress);

+    UefiDevicePathLibCatPrint (Str, L",");

+    CatIPv4Address (Str, &IPDevPath->SubnetMask);

+  }

+  UefiDevicePathLibCatPrint (Str, L")");

+}

+

+/**

+  Converts a IPv6 device path structure to its string representative.

+

+  @param Str             The string representative of input device.

+  @param DevPath         The input device path structure.

+  @param DisplayOnly     If DisplayOnly is TRUE, then the shorter text representation

+                         of the display node is used, where applicable. If DisplayOnly

+                         is FALSE, then the longer text representation of the display node

+                         is used.

+  @param AllowShortcuts  If AllowShortcuts is TRUE, then the shortcut forms of text

+                         representation for a device node can be used, where applicable.

+

+**/

+VOID

+DevPathToTextIPv6 (

+  IN OUT POOL_PRINT  *Str,

+  IN VOID            *DevPath,

+  IN BOOLEAN         DisplayOnly,

+  IN BOOLEAN         AllowShortcuts

+  )

+{

+  IPv6_DEVICE_PATH  *IPDevPath;

+

+  IPDevPath = DevPath;

+  UefiDevicePathLibCatPrint (Str, L"IPv6(");

+  CatIPv6Address (Str, &IPDevPath->RemoteIpAddress);

+  if (DisplayOnly) {

+    UefiDevicePathLibCatPrint (Str, L")");

+    return ;

+  }

+

+  UefiDevicePathLibCatPrint (Str, L",");

+  CatNetworkProtocol (Str, IPDevPath->Protocol);

+

+  switch (IPDevPath->IpAddressOrigin) {

+    case 0:

+      UefiDevicePathLibCatPrint (Str, L",Static,");

+      break;

+    case 1:

+      UefiDevicePathLibCatPrint (Str, L",StatelessAutoConfigure,");

+      break;

+    default:

+      UefiDevicePathLibCatPrint (Str, L",StatefulAutoConfigure,");

+      break;

+  }

+

+  CatIPv6Address (Str, &IPDevPath->LocalIpAddress);

+

+  if (DevicePathNodeLength (IPDevPath) == sizeof (IPv6_DEVICE_PATH)) {

+    UefiDevicePathLibCatPrint (Str, L",0x%x,", IPDevPath->PrefixLength);

+    CatIPv6Address (Str, &IPDevPath->GatewayIpAddress);

+  }

+  UefiDevicePathLibCatPrint (Str, L")");

+}

+

+/**

+  Converts an Infini Band device path structure to its string representative.

+

+  @param Str             The string representative of input device.

+  @param DevPath         The input device path structure.

+  @param DisplayOnly     If DisplayOnly is TRUE, then the shorter text representation

+                         of the display node is used, where applicable. If DisplayOnly

+                         is FALSE, then the longer text representation of the display node

+                         is used.

+  @param AllowShortcuts  If AllowShortcuts is TRUE, then the shortcut forms of text

+                         representation for a device node can be used, where applicable.

+

+**/

+VOID

+DevPathToTextInfiniBand (

+  IN OUT POOL_PRINT  *Str,

+  IN VOID            *DevPath,

+  IN BOOLEAN         DisplayOnly,

+  IN BOOLEAN         AllowShortcuts

+  )

+{

+  INFINIBAND_DEVICE_PATH  *InfiniBand;

+

+  InfiniBand = DevPath;

+  UefiDevicePathLibCatPrint (

+    Str,

+    L"Infiniband(0x%x,%g,0x%lx,0x%lx,0x%lx)",

+    InfiniBand->ResourceFlags,

+    InfiniBand->PortGid,

+    InfiniBand->ServiceId,

+    InfiniBand->TargetPortId,

+    InfiniBand->DeviceId

+    );

+}

+

+/**

+  Converts a UART device path structure to its string representative.

+

+  @param Str             The string representative of input device.

+  @param DevPath         The input device path structure.

+  @param DisplayOnly     If DisplayOnly is TRUE, then the shorter text representation

+                         of the display node is used, where applicable. If DisplayOnly

+                         is FALSE, then the longer text representation of the display node

+                         is used.

+  @param AllowShortcuts  If AllowShortcuts is TRUE, then the shortcut forms of text

+                         representation for a device node can be used, where applicable.

+

+**/

+VOID

+DevPathToTextUart (

+  IN OUT POOL_PRINT  *Str,

+  IN VOID            *DevPath,

+  IN BOOLEAN         DisplayOnly,

+  IN BOOLEAN         AllowShortcuts

+  )

+{

+  UART_DEVICE_PATH  *Uart;

+  CHAR8             Parity;

+

+  Uart = DevPath;

+  switch (Uart->Parity) {

+  case 0:

+    Parity = 'D';

+    break;

+

+  case 1:

+    Parity = 'N';

+    break;

+

+  case 2:

+    Parity = 'E';

+    break;

+

+  case 3:

+    Parity = 'O';

+    break;

+

+  case 4:

+    Parity = 'M';

+    break;

+

+  case 5:

+    Parity = 'S';

+    break;

+

+  default:

+    Parity = 'x';

+    break;

+  }

+

+  if (Uart->BaudRate == 0) {

+    UefiDevicePathLibCatPrint (Str, L"Uart(DEFAULT,");

+  } else {

+    UefiDevicePathLibCatPrint (Str, L"Uart(%ld,", Uart->BaudRate);

+  }

+

+  if (Uart->DataBits == 0) {

+    UefiDevicePathLibCatPrint (Str, L"DEFAULT,");

+  } else {

+    UefiDevicePathLibCatPrint (Str, L"%d,", Uart->DataBits);

+  }

+

+  UefiDevicePathLibCatPrint (Str, L"%c,", Parity);

+

+  switch (Uart->StopBits) {

+  case 0:

+    UefiDevicePathLibCatPrint (Str, L"D)");

+    break;

+

+  case 1:

+    UefiDevicePathLibCatPrint (Str, L"1)");

+    break;

+

+  case 2:

+    UefiDevicePathLibCatPrint (Str, L"1.5)");

+    break;

+

+  case 3:

+    UefiDevicePathLibCatPrint (Str, L"2)");

+    break;

+

+  default:

+    UefiDevicePathLibCatPrint (Str, L"x)");

+    break;

+  }

+}

+

+/**

+  Converts an iSCSI device path structure to its string representative.

+

+  @param Str             The string representative of input device.

+  @param DevPath         The input device path structure.

+  @param DisplayOnly     If DisplayOnly is TRUE, then the shorter text representation

+                         of the display node is used, where applicable. If DisplayOnly

+                         is FALSE, then the longer text representation of the display node

+                         is used.

+  @param AllowShortcuts  If AllowShortcuts is TRUE, then the shortcut forms of text

+                         representation for a device node can be used, where applicable.

+

+**/

+VOID

+DevPathToTextiSCSI (

+  IN OUT POOL_PRINT  *Str,

+  IN VOID            *DevPath,

+  IN BOOLEAN         DisplayOnly,

+  IN BOOLEAN         AllowShortcuts

+  )

+{

+  ISCSI_DEVICE_PATH_WITH_NAME *ISCSIDevPath;

+  UINT16                      Options;

+  UINTN                       Index;

+

+  ISCSIDevPath = DevPath;

+  UefiDevicePathLibCatPrint (

+    Str,

+    L"iSCSI(%a,0x%x,0x",

+    ISCSIDevPath->TargetName,

+    ISCSIDevPath->TargetPortalGroupTag

+    );

+  for (Index = 0; Index < sizeof (ISCSIDevPath->Lun) / sizeof (UINT8); Index++) {

+    UefiDevicePathLibCatPrint (Str, L"%02x", ((UINT8 *)&ISCSIDevPath->Lun)[Index]);

+  }

+  Options = ISCSIDevPath->LoginOption;

+  UefiDevicePathLibCatPrint (Str, L",%s,", (((Options >> 1) & 0x0001) != 0) ? L"CRC32C" : L"None");

+  UefiDevicePathLibCatPrint (Str, L"%s,", (((Options >> 3) & 0x0001) != 0) ? L"CRC32C" : L"None");

+  if (((Options >> 11) & 0x0001) != 0) {

+    UefiDevicePathLibCatPrint (Str, L"%s,", L"None");

+  } else if (((Options >> 12) & 0x0001) != 0) {

+    UefiDevicePathLibCatPrint (Str, L"%s,", L"CHAP_UNI");

+  } else {

+    UefiDevicePathLibCatPrint (Str, L"%s,", L"CHAP_BI");

+

+  }

+

+  UefiDevicePathLibCatPrint (Str, L"%s)", (ISCSIDevPath->NetworkProtocol == 0) ? L"TCP" : L"reserved");

+}

+

+/**

+  Converts a VLAN device path structure to its string representative.

+

+  @param Str             The string representative of input device.

+  @param DevPath         The input device path structure.

+  @param DisplayOnly     If DisplayOnly is TRUE, then the shorter text representation

+                         of the display node is used, where applicable. If DisplayOnly

+                         is FALSE, then the longer text representation of the display node

+                         is used.

+  @param AllowShortcuts  If AllowShortcuts is TRUE, then the shortcut forms of text

+                         representation for a device node can be used, where applicable.

+

+**/

+VOID

+DevPathToTextVlan (

+  IN OUT POOL_PRINT  *Str,

+  IN VOID            *DevPath,

+  IN BOOLEAN         DisplayOnly,

+  IN BOOLEAN         AllowShortcuts

+  )

+{

+  VLAN_DEVICE_PATH  *Vlan;

+

+  Vlan = DevPath;

+  UefiDevicePathLibCatPrint (Str, L"Vlan(%d)", Vlan->VlanId);

+}

+

+/**

+  Converts a Bluetooth device path structure to its string representative.

+

+  @param Str             The string representative of input device.

+  @param DevPath         The input device path structure.

+  @param DisplayOnly     If DisplayOnly is TRUE, then the shorter text representation

+                         of the display node is used, where applicable. If DisplayOnly

+                         is FALSE, then the longer text representation of the display node

+                         is used.

+  @param AllowShortcuts  If AllowShortcuts is TRUE, then the shortcut forms of text

+                         representation for a device node can be used, where applicable.

+

+**/

+VOID

+DevPathToTextBluetooth (

+  IN OUT POOL_PRINT  *Str,

+  IN VOID            *DevPath,

+  IN BOOLEAN         DisplayOnly,

+  IN BOOLEAN         AllowShortcuts

+  )

+{

+  BLUETOOTH_DEVICE_PATH  *Bluetooth;

+

+  Bluetooth = DevPath;

+  UefiDevicePathLibCatPrint (

+    Str,

+    L"Bluetooth(%02x%02x%02x%02x%02x%02x)",

+    Bluetooth->BD_ADDR.Address[0],

+    Bluetooth->BD_ADDR.Address[1],

+    Bluetooth->BD_ADDR.Address[2],

+    Bluetooth->BD_ADDR.Address[3],

+    Bluetooth->BD_ADDR.Address[4],

+    Bluetooth->BD_ADDR.Address[5]

+    );

+}

+

+/**

+  Converts a Wi-Fi device path structure to its string representative.

+

+  @param Str             The string representative of input device.

+  @param DevPath         The input device path structure.

+  @param DisplayOnly     If DisplayOnly is TRUE, then the shorter text representation

+                         of the display node is used, where applicable. If DisplayOnly

+                         is FALSE, then the longer text representation of the display node

+                         is used.

+  @param AllowShortcuts  If AllowShortcuts is TRUE, then the shortcut forms of text

+                         representation for a device node can be used, where applicable.

+

+**/

+VOID

+DevPathToTextWiFi (

+  IN OUT POOL_PRINT  *Str,

+  IN VOID            *DevPath,

+  IN BOOLEAN         DisplayOnly,

+  IN BOOLEAN         AllowShortcuts

+  )

+{

+  WIFI_DEVICE_PATH      *WiFi;

+  UINT8                 SSId[33];

+

+  WiFi = DevPath;

+

+  SSId[32] = '\0';

+  CopyMem (SSId, WiFi->SSId, 32);

+

+  UefiDevicePathLibCatPrint (Str, L"Wi-Fi(%a)", SSId);

+}

+

+/**

+  Converts a Bluetooth device path structure to its string representative.

+

+  @param Str             The string representative of input device.

+  @param DevPath         The input device path structure.

+  @param DisplayOnly     If DisplayOnly is TRUE, then the shorter text representation

+                         of the display node is used, where applicable. If DisplayOnly

+                         is FALSE, then the longer text representation of the display node

+                         is used.

+  @param AllowShortcuts  If AllowShortcuts is TRUE, then the shortcut forms of text

+                         representation for a device node can be used, where applicable.

+

+**/

+VOID

+DevPathToTextBluetoothLE (

+  IN OUT POOL_PRINT  *Str,

+  IN VOID            *DevPath,

+  IN BOOLEAN         DisplayOnly,

+  IN BOOLEAN         AllowShortcuts

+  )

+{

+  BLUETOOTH_LE_DEVICE_PATH  *BluetoothLE;

+

+  BluetoothLE = DevPath;

+  UefiDevicePathLibCatPrint (

+    Str,

+    L"BluetoothLE(%02x%02x%02x%02x%02x%02x,0x%02x)",

+    BluetoothLE->Address.Address[0],

+    BluetoothLE->Address.Address[1],

+    BluetoothLE->Address.Address[2],

+    BluetoothLE->Address.Address[3],

+    BluetoothLE->Address.Address[4],

+    BluetoothLE->Address.Address[5],

+    BluetoothLE->Address.Type

+    );

+}

+

+/**

+  Converts a DNS device path structure to its string representative.

+

+  @param Str             The string representative of input device.

+  @param DevPath         The input device path structure.

+  @param DisplayOnly     If DisplayOnly is TRUE, then the shorter text representation

+                         of the display node is used, where applicable. If DisplayOnly

+                         is FALSE, then the longer text representation of the display node

+                         is used.

+  @param AllowShortcuts  If AllowShortcuts is TRUE, then the shortcut forms of text

+                         representation for a device node can be used, where applicable.

+

+**/

+VOID

+DevPathToTextDns (

+  IN OUT POOL_PRINT  *Str,

+  IN VOID            *DevPath,

+  IN BOOLEAN         DisplayOnly,

+  IN BOOLEAN         AllowShortcuts

+  )

+{

+  DNS_DEVICE_PATH  *DnsDevPath;

+  UINT32           DnsServerIpCount;

+  UINT32           DnsServerIpIndex;

+

+  DnsDevPath     = DevPath;

+  DnsServerIpCount = (UINT32) (DevicePathNodeLength(DnsDevPath) - sizeof (EFI_DEVICE_PATH_PROTOCOL) - sizeof (DnsDevPath->IsIPv6)) / sizeof (EFI_IP_ADDRESS);

+

+  UefiDevicePathLibCatPrint (Str, L"Dns(");

+

+  for (DnsServerIpIndex = 0; DnsServerIpIndex < DnsServerIpCount; DnsServerIpIndex++) {

+    if (DnsDevPath->IsIPv6 == 0x00) {

+      CatIPv4Address (Str, &(DnsDevPath->DnsServerIp[DnsServerIpIndex].v4));

+    } else {

+      CatIPv6Address (Str, &(DnsDevPath->DnsServerIp[DnsServerIpIndex].v6));

+    }

+

+    if (DnsServerIpIndex < DnsServerIpCount - 1) {

+      UefiDevicePathLibCatPrint (Str, L",");

+    }

+  }

+

+  UefiDevicePathLibCatPrint (Str, L")");

+}

+

+/**

+  Converts a URI device path structure to its string representative.

+

+  @param Str             The string representative of input device.

+  @param DevPath         The input device path structure.

+  @param DisplayOnly     If DisplayOnly is TRUE, then the shorter text representation

+                         of the display node is used, where applicable. If DisplayOnly

+                         is FALSE, then the longer text representation of the display node

+                         is used.

+  @param AllowShortcuts  If AllowShortcuts is TRUE, then the shortcut forms of text

+                         representation for a device node can be used, where applicable.

+

+**/

+VOID

+DevPathToTextUri (

+  IN OUT POOL_PRINT  *Str,

+  IN VOID            *DevPath,

+  IN BOOLEAN         DisplayOnly,

+  IN BOOLEAN         AllowShortcuts

+  )

+{

+  URI_DEVICE_PATH    *Uri;

+  UINTN              UriLength;

+  CHAR8              *UriStr;

+

+  //

+  // Uri in the device path may not be null terminated.

+  //

+  Uri       = DevPath;

+  UriLength = DevicePathNodeLength (Uri) - sizeof (URI_DEVICE_PATH);

+  UriStr = AllocatePool (UriLength + 1);

+  ASSERT (UriStr != NULL);

+

+  CopyMem (UriStr, Uri->Uri, UriLength);

+  UriStr[UriLength] = '\0';

+  UefiDevicePathLibCatPrint (Str, L"Uri(%a)", UriStr);

+  FreePool (UriStr);

+}

+

+/**

+  Converts a Hard drive device path structure to its string representative.

+

+  @param Str             The string representative of input device.

+  @param DevPath         The input device path structure.

+  @param DisplayOnly     If DisplayOnly is TRUE, then the shorter text representation

+                         of the display node is used, where applicable. If DisplayOnly

+                         is FALSE, then the longer text representation of the display node

+                         is used.

+  @param AllowShortcuts  If AllowShortcuts is TRUE, then the shortcut forms of text

+                         representation for a device node can be used, where applicable.

+

+**/

+VOID

+DevPathToTextHardDrive (

+  IN OUT POOL_PRINT  *Str,

+  IN VOID            *DevPath,

+  IN BOOLEAN         DisplayOnly,

+  IN BOOLEAN         AllowShortcuts

+  )

+{

+  HARDDRIVE_DEVICE_PATH *Hd;

+

+  Hd = DevPath;

+  switch (Hd->SignatureType) {

+  case SIGNATURE_TYPE_MBR:

+    UefiDevicePathLibCatPrint (

+      Str,

+      L"HD(%d,%s,0x%08x,",

+      Hd->PartitionNumber,

+      L"MBR",

+      *((UINT32 *) (&(Hd->Signature[0])))

+      );

+    break;

+

+  case SIGNATURE_TYPE_GUID:

+    UefiDevicePathLibCatPrint (

+      Str,

+      L"HD(%d,%s,%g,",

+      Hd->PartitionNumber,

+      L"GPT",

+      (EFI_GUID *) &(Hd->Signature[0])

+      );

+    break;

+

+  default:

+    UefiDevicePathLibCatPrint (

+      Str,

+      L"HD(%d,%d,0,",

+      Hd->PartitionNumber,

+      Hd->SignatureType

+      );

+    break;

+  }

+

+  UefiDevicePathLibCatPrint (Str, L"0x%lx,0x%lx)", Hd->PartitionStart, Hd->PartitionSize);

+}

+

+/**

+  Converts a CDROM device path structure to its string representative.

+

+  @param Str             The string representative of input device.

+  @param DevPath         The input device path structure.

+  @param DisplayOnly     If DisplayOnly is TRUE, then the shorter text representation

+                         of the display node is used, where applicable. If DisplayOnly

+                         is FALSE, then the longer text representation of the display node

+                         is used.

+  @param AllowShortcuts  If AllowShortcuts is TRUE, then the shortcut forms of text

+                         representation for a device node can be used, where applicable.

+

+**/

+VOID

+DevPathToTextCDROM (

+  IN OUT POOL_PRINT  *Str,

+  IN VOID            *DevPath,

+  IN BOOLEAN         DisplayOnly,

+  IN BOOLEAN         AllowShortcuts

+  )

+{

+  CDROM_DEVICE_PATH *Cd;

+

+  Cd = DevPath;

+  if (DisplayOnly) {

+    UefiDevicePathLibCatPrint (Str, L"CDROM(0x%x)", Cd->BootEntry);

+    return ;

+  }

+

+  UefiDevicePathLibCatPrint (Str, L"CDROM(0x%x,0x%lx,0x%lx)", Cd->BootEntry, Cd->PartitionStart, Cd->PartitionSize);

+}

+

+/**

+  Converts a File device path structure to its string representative.

+

+  @param Str             The string representative of input device.

+  @param DevPath         The input device path structure.

+  @param DisplayOnly     If DisplayOnly is TRUE, then the shorter text representation

+                         of the display node is used, where applicable. If DisplayOnly

+                         is FALSE, then the longer text representation of the display node

+                         is used.

+  @param AllowShortcuts  If AllowShortcuts is TRUE, then the shortcut forms of text

+                         representation for a device node can be used, where applicable.

+

+**/

+VOID

+DevPathToTextFilePath (

+  IN OUT POOL_PRINT  *Str,

+  IN VOID            *DevPath,

+  IN BOOLEAN         DisplayOnly,

+  IN BOOLEAN         AllowShortcuts

+  )

+{

+  FILEPATH_DEVICE_PATH  *Fp;

+

+  Fp = DevPath;

+  UefiDevicePathLibCatPrint (Str, L"%s", Fp->PathName);

+}

+

+/**

+  Converts a Media protocol device path structure to its string representative.

+

+  @param Str             The string representative of input device.

+  @param DevPath         The input device path structure.

+  @param DisplayOnly     If DisplayOnly is TRUE, then the shorter text representation

+                         of the display node is used, where applicable. If DisplayOnly

+                         is FALSE, then the longer text representation of the display node

+                         is used.

+  @param AllowShortcuts  If AllowShortcuts is TRUE, then the shortcut forms of text

+                         representation for a device node can be used, where applicable.

+

+**/

+VOID

+DevPathToTextMediaProtocol (

+  IN OUT POOL_PRINT  *Str,

+  IN VOID            *DevPath,

+  IN BOOLEAN         DisplayOnly,

+  IN BOOLEAN         AllowShortcuts

+  )

+{

+  MEDIA_PROTOCOL_DEVICE_PATH  *MediaProt;

+

+  MediaProt = DevPath;

+  UefiDevicePathLibCatPrint (Str, L"Media(%g)", &MediaProt->Protocol);

+}

+

+/**

+  Converts a Firmware Volume device path structure to its string representative.

+

+  @param Str             The string representative of input device.

+  @param DevPath         The input device path structure.

+  @param DisplayOnly     If DisplayOnly is TRUE, then the shorter text representation

+                         of the display node is used, where applicable. If DisplayOnly

+                         is FALSE, then the longer text representation of the display node

+                         is used.

+  @param AllowShortcuts  If AllowShortcuts is TRUE, then the shortcut forms of text

+                         representation for a device node can be used, where applicable.

+

+**/

+VOID

+DevPathToTextFv (

+  IN OUT POOL_PRINT  *Str,

+  IN VOID            *DevPath,

+  IN BOOLEAN         DisplayOnly,

+  IN BOOLEAN         AllowShortcuts

+  )

+{

+  MEDIA_FW_VOL_DEVICE_PATH  *Fv;

+

+  Fv = DevPath;

+  UefiDevicePathLibCatPrint (Str, L"Fv(%g)", &Fv->FvName);

+}

+

+/**

+  Converts a Firmware Volume File device path structure to its string representative.

+

+  @param Str             The string representative of input device.

+  @param DevPath         The input device path structure.

+  @param DisplayOnly     If DisplayOnly is TRUE, then the shorter text representation

+                         of the display node is used, where applicable. If DisplayOnly

+                         is FALSE, then the longer text representation of the display node

+                         is used.

+  @param AllowShortcuts  If AllowShortcuts is TRUE, then the shortcut forms of text

+                         representation for a device node can be used, where applicable.

+

+**/

+VOID

+DevPathToTextFvFile (

+  IN OUT POOL_PRINT  *Str,

+  IN VOID            *DevPath,

+  IN BOOLEAN         DisplayOnly,

+  IN BOOLEAN         AllowShortcuts

+  )

+{

+  MEDIA_FW_VOL_FILEPATH_DEVICE_PATH  *FvFile;

+

+  FvFile = DevPath;

+  UefiDevicePathLibCatPrint (Str, L"FvFile(%g)", &FvFile->FvFileName);

+}

+

+/**

+  Converts a Relative Offset device path structure to its string representative.

+

+  @param Str             The string representative of input device.

+  @param DevPath         The input device path structure.

+  @param DisplayOnly     If DisplayOnly is TRUE, then the shorter text representation

+                         of the display node is used, where applicable. If DisplayOnly

+                         is FALSE, then the longer text representation of the display node

+                         is used.

+  @param AllowShortcuts  If AllowShortcuts is TRUE, then the shortcut forms of text

+                         representation for a device node can be used, where applicable.

+

+**/

+VOID

+DevPathRelativeOffsetRange (

+  IN OUT POOL_PRINT       *Str,

+  IN VOID                 *DevPath,

+  IN BOOLEAN              DisplayOnly,

+  IN BOOLEAN              AllowShortcuts

+  )

+{

+  MEDIA_RELATIVE_OFFSET_RANGE_DEVICE_PATH *Offset;

+

+  Offset = DevPath;

+  UefiDevicePathLibCatPrint (

+    Str,

+    L"Offset(0x%lx,0x%lx)",

+    Offset->StartingOffset,

+    Offset->EndingOffset

+    );

+}

+

+/**

+  Converts a Ram Disk device path structure to its string representative.

+

+  @param Str             The string representative of input device.

+  @param DevPath         The input device path structure.

+  @param DisplayOnly     If DisplayOnly is TRUE, then the shorter text representation

+                         of the display node is used, where applicable. If DisplayOnly

+                         is FALSE, then the longer text representation of the display node

+                         is used.

+  @param AllowShortcuts  If AllowShortcuts is TRUE, then the shortcut forms of text

+                         representation for a device node can be used, where applicable.

+

+**/

+VOID

+DevPathToTextRamDisk (

+  IN OUT POOL_PRINT       *Str,

+  IN VOID                 *DevPath,

+  IN BOOLEAN              DisplayOnly,

+  IN BOOLEAN              AllowShortcuts

+  )

+{

+  MEDIA_RAM_DISK_DEVICE_PATH *RamDisk;

+

+  RamDisk = DevPath;

+

+  if (CompareGuid (&RamDisk->TypeGuid, &gEfiVirtualDiskGuid)) {

+    UefiDevicePathLibCatPrint (

+      Str,

+      L"VirtualDisk(0x%lx,0x%lx,%d)",

+      LShiftU64 ((UINT64)RamDisk->StartingAddr[1], 32) | RamDisk->StartingAddr[0],

+      LShiftU64 ((UINT64)RamDisk->EndingAddr[1], 32) | RamDisk->EndingAddr[0],

+      RamDisk->Instance

+      );

+  } else if (CompareGuid (&RamDisk->TypeGuid, &gEfiVirtualCdGuid)) {

+    UefiDevicePathLibCatPrint (

+      Str,

+      L"VirtualCD(0x%lx,0x%lx,%d)",

+      LShiftU64 ((UINT64)RamDisk->StartingAddr[1], 32) | RamDisk->StartingAddr[0],

+      LShiftU64 ((UINT64)RamDisk->EndingAddr[1], 32) | RamDisk->EndingAddr[0],

+      RamDisk->Instance

+      );

+  } else if (CompareGuid (&RamDisk->TypeGuid, &gEfiPersistentVirtualDiskGuid)) {

+    UefiDevicePathLibCatPrint (

+      Str,

+      L"PersistentVirtualDisk(0x%lx,0x%lx,%d)",

+      LShiftU64 ((UINT64)RamDisk->StartingAddr[1], 32) | RamDisk->StartingAddr[0],

+      LShiftU64 ((UINT64)RamDisk->EndingAddr[1], 32) | RamDisk->EndingAddr[0],

+      RamDisk->Instance

+      );

+  } else if (CompareGuid (&RamDisk->TypeGuid, &gEfiPersistentVirtualCdGuid)) {

+    UefiDevicePathLibCatPrint (

+      Str,

+      L"PersistentVirtualCD(0x%lx,0x%lx,%d)",

+      LShiftU64 ((UINT64)RamDisk->StartingAddr[1], 32) | RamDisk->StartingAddr[0],

+      LShiftU64 ((UINT64)RamDisk->EndingAddr[1], 32) | RamDisk->EndingAddr[0],

+      RamDisk->Instance

+      );

+  } else {

+    UefiDevicePathLibCatPrint (

+      Str,

+      L"RamDisk(0x%lx,0x%lx,%d,%g)",

+      LShiftU64 ((UINT64)RamDisk->StartingAddr[1], 32) | RamDisk->StartingAddr[0],

+      LShiftU64 ((UINT64)RamDisk->EndingAddr[1], 32) | RamDisk->EndingAddr[0],

+      RamDisk->Instance,

+      &RamDisk->TypeGuid

+      );

+  }

+}

+

+/**

+  Converts a BIOS Boot Specification device path structure to its string representative.

+

+  @param Str             The string representative of input device.

+  @param DevPath         The input device path structure.

+  @param DisplayOnly     If DisplayOnly is TRUE, then the shorter text representation

+                         of the display node is used, where applicable. If DisplayOnly

+                         is FALSE, then the longer text representation of the display node

+                         is used.

+  @param AllowShortcuts  If AllowShortcuts is TRUE, then the shortcut forms of text

+                         representation for a device node can be used, where applicable.

+

+**/

+VOID

+DevPathToTextBBS (

+  IN OUT POOL_PRINT  *Str,

+  IN VOID            *DevPath,

+  IN BOOLEAN         DisplayOnly,

+  IN BOOLEAN         AllowShortcuts

+  )

+{

+  BBS_BBS_DEVICE_PATH *Bbs;

+  CHAR16              *Type;

+

+  Bbs = DevPath;

+  switch (Bbs->DeviceType) {

+  case BBS_TYPE_FLOPPY:

+    Type = L"Floppy";

+    break;

+

+  case BBS_TYPE_HARDDRIVE:

+    Type = L"HD";

+    break;

+

+  case BBS_TYPE_CDROM:

+    Type = L"CDROM";

+    break;

+

+  case BBS_TYPE_PCMCIA:

+    Type = L"PCMCIA";

+    break;

+

+  case BBS_TYPE_USB:

+    Type = L"USB";

+    break;

+

+  case BBS_TYPE_EMBEDDED_NETWORK:

+    Type = L"Network";

+    break;

+

+  default:

+    Type = NULL;

+    break;

+  }

+

+  if (Type != NULL) {

+    UefiDevicePathLibCatPrint (Str, L"BBS(%s,%a", Type, Bbs->String);

+  } else {

+    UefiDevicePathLibCatPrint (Str, L"BBS(0x%x,%a", Bbs->DeviceType, Bbs->String);

+  }

+

+  if (DisplayOnly) {

+    UefiDevicePathLibCatPrint (Str, L")");

+    return ;

+  }

+

+  UefiDevicePathLibCatPrint (Str, L",0x%x)", Bbs->StatusFlag);

+}

+

+/**

+  Converts an End-of-Device-Path structure to its string representative.

+

+  @param Str             The string representative of input device.

+  @param DevPath         The input device path structure.

+  @param DisplayOnly     If DisplayOnly is TRUE, then the shorter text representation

+                         of the display node is used, where applicable. If DisplayOnly

+                         is FALSE, then the longer text representation of the display node

+                         is used.

+  @param AllowShortcuts  If AllowShortcuts is TRUE, then the shortcut forms of text

+                         representation for a device node can be used, where applicable.

+

+**/

+VOID

+DevPathToTextEndInstance (

+  IN OUT POOL_PRINT  *Str,

+  IN VOID            *DevPath,

+  IN BOOLEAN         DisplayOnly,

+  IN BOOLEAN         AllowShortcuts

+  )

+{

+  UefiDevicePathLibCatPrint (Str, L",");

+}

+

+GLOBAL_REMOVE_IF_UNREFERENCED const DEVICE_PATH_TO_TEXT_GENERIC_TABLE mUefiDevicePathLibToTextTableGeneric[] = {

+  {HARDWARE_DEVICE_PATH,  L"HardwarePath"   },

+  {ACPI_DEVICE_PATH,      L"AcpiPath"       },

+  {MESSAGING_DEVICE_PATH, L"Msg"            },

+  {MEDIA_DEVICE_PATH,     L"MediaPath"      },

+  {BBS_DEVICE_PATH,       L"BbsPath"        },

+  {0, NULL}

+};

+

+/**

+  Converts an unknown device path structure to its string representative.

+

+  @param Str             The string representative of input device.

+  @param DevPath         The input device path structure.

+  @param DisplayOnly     If DisplayOnly is TRUE, then the shorter text representation

+                         of the display node is used, where applicable. If DisplayOnly

+                         is FALSE, then the longer text representation of the display node

+                         is used.

+  @param AllowShortcuts  If AllowShortcuts is TRUE, then the shortcut forms of text

+                         representation for a device node can be used, where applicable.

+

+**/

+VOID

+DevPathToTextNodeGeneric (

+  IN OUT POOL_PRINT  *Str,

+  IN VOID            *DevPath,

+  IN BOOLEAN         DisplayOnly,

+  IN BOOLEAN         AllowShortcuts

+  )

+{

+  EFI_DEVICE_PATH_PROTOCOL *Node;

+  UINTN                    Index;

+

+  Node = DevPath;

+

+  for (Index = 0; mUefiDevicePathLibToTextTableGeneric[Index].Text != NULL; Index++) {

+    if (DevicePathType (Node) == mUefiDevicePathLibToTextTableGeneric[Index].Type) {

+      break;

+    }

+  }

+

+  if (mUefiDevicePathLibToTextTableGeneric[Index].Text == NULL) {

+    //

+    // It's a node whose type cannot be recognized

+    //

+    UefiDevicePathLibCatPrint (Str, L"Path(%d,%d", DevicePathType (Node), DevicePathSubType (Node));

+  } else {

+    //

+    // It's a node whose type can be recognized

+    //

+    UefiDevicePathLibCatPrint (Str, L"%s(%d", mUefiDevicePathLibToTextTableGeneric[Index].Text, DevicePathSubType (Node));

+  }

+

+  Index = sizeof (EFI_DEVICE_PATH_PROTOCOL);

+  if (Index < DevicePathNodeLength (Node)) {

+    UefiDevicePathLibCatPrint (Str, L",");

+    for (; Index < DevicePathNodeLength (Node); Index++) {

+      UefiDevicePathLibCatPrint (Str, L"%02x", ((UINT8 *) Node)[Index]);

+    }

+  }

+

+  UefiDevicePathLibCatPrint (Str, L")");

+}

+

+GLOBAL_REMOVE_IF_UNREFERENCED const DEVICE_PATH_TO_TEXT_TABLE mUefiDevicePathLibToTextTable[] = {

+  {HARDWARE_DEVICE_PATH,  HW_PCI_DP,                        DevPathToTextPci            },

+  {HARDWARE_DEVICE_PATH,  HW_PCCARD_DP,                     DevPathToTextPccard         },

+  {HARDWARE_DEVICE_PATH,  HW_MEMMAP_DP,                     DevPathToTextMemMap         },

+  {HARDWARE_DEVICE_PATH,  HW_VENDOR_DP,                     DevPathToTextVendor         },

+  {HARDWARE_DEVICE_PATH,  HW_CONTROLLER_DP,                 DevPathToTextController     },

+  {HARDWARE_DEVICE_PATH,  HW_BMC_DP,                        DevPathToTextBmc            },

+  {ACPI_DEVICE_PATH,      ACPI_DP,                          DevPathToTextAcpi           },

+  {ACPI_DEVICE_PATH,      ACPI_EXTENDED_DP,                 DevPathToTextAcpiEx         },

+  {ACPI_DEVICE_PATH,      ACPI_ADR_DP,                      DevPathToTextAcpiAdr        },

+  {MESSAGING_DEVICE_PATH, MSG_ATAPI_DP,                     DevPathToTextAtapi          },

+  {MESSAGING_DEVICE_PATH, MSG_SCSI_DP,                      DevPathToTextScsi           },

+  {MESSAGING_DEVICE_PATH, MSG_FIBRECHANNEL_DP,              DevPathToTextFibre          },

+  {MESSAGING_DEVICE_PATH, MSG_FIBRECHANNELEX_DP,            DevPathToTextFibreEx        },

+  {MESSAGING_DEVICE_PATH, MSG_SASEX_DP,                     DevPathToTextSasEx          },

+  {MESSAGING_DEVICE_PATH, MSG_NVME_NAMESPACE_DP,            DevPathToTextNVMe           },

+  {MESSAGING_DEVICE_PATH, MSG_UFS_DP,                       DevPathToTextUfs            },

+  {MESSAGING_DEVICE_PATH, MSG_SD_DP,                        DevPathToTextSd             },

+  {MESSAGING_DEVICE_PATH, MSG_EMMC_DP,                      DevPathToTextEmmc           },

+  {MESSAGING_DEVICE_PATH, MSG_1394_DP,                      DevPathToText1394           },

+  {MESSAGING_DEVICE_PATH, MSG_USB_DP,                       DevPathToTextUsb            },

+  {MESSAGING_DEVICE_PATH, MSG_USB_WWID_DP,                  DevPathToTextUsbWWID        },

+  {MESSAGING_DEVICE_PATH, MSG_DEVICE_LOGICAL_UNIT_DP,       DevPathToTextLogicalUnit    },

+  {MESSAGING_DEVICE_PATH, MSG_USB_CLASS_DP,                 DevPathToTextUsbClass       },

+  {MESSAGING_DEVICE_PATH, MSG_SATA_DP,                      DevPathToTextSata           },

+  {MESSAGING_DEVICE_PATH, MSG_I2O_DP,                       DevPathToTextI2O            },

+  {MESSAGING_DEVICE_PATH, MSG_MAC_ADDR_DP,                  DevPathToTextMacAddr        },

+  {MESSAGING_DEVICE_PATH, MSG_IPv4_DP,                      DevPathToTextIPv4           },

+  {MESSAGING_DEVICE_PATH, MSG_IPv6_DP,                      DevPathToTextIPv6           },

+  {MESSAGING_DEVICE_PATH, MSG_INFINIBAND_DP,                DevPathToTextInfiniBand     },

+  {MESSAGING_DEVICE_PATH, MSG_UART_DP,                      DevPathToTextUart           },

+  {MESSAGING_DEVICE_PATH, MSG_VENDOR_DP,                    DevPathToTextVendor         },

+  {MESSAGING_DEVICE_PATH, MSG_ISCSI_DP,                     DevPathToTextiSCSI          },

+  {MESSAGING_DEVICE_PATH, MSG_VLAN_DP,                      DevPathToTextVlan           },

+  {MESSAGING_DEVICE_PATH, MSG_DNS_DP,                       DevPathToTextDns            },

+  {MESSAGING_DEVICE_PATH, MSG_URI_DP,                       DevPathToTextUri            },

+  {MESSAGING_DEVICE_PATH, MSG_BLUETOOTH_DP,                 DevPathToTextBluetooth      },

+  {MESSAGING_DEVICE_PATH, MSG_WIFI_DP,                      DevPathToTextWiFi           },

+  {MESSAGING_DEVICE_PATH, MSG_BLUETOOTH_LE_DP,              DevPathToTextBluetoothLE    },

+  {MEDIA_DEVICE_PATH,     MEDIA_HARDDRIVE_DP,               DevPathToTextHardDrive      },

+  {MEDIA_DEVICE_PATH,     MEDIA_CDROM_DP,                   DevPathToTextCDROM          },

+  {MEDIA_DEVICE_PATH,     MEDIA_VENDOR_DP,                  DevPathToTextVendor         },

+  {MEDIA_DEVICE_PATH,     MEDIA_PROTOCOL_DP,                DevPathToTextMediaProtocol  },

+  {MEDIA_DEVICE_PATH,     MEDIA_FILEPATH_DP,                DevPathToTextFilePath       },

+  {MEDIA_DEVICE_PATH,     MEDIA_PIWG_FW_VOL_DP,             DevPathToTextFv             },

+  {MEDIA_DEVICE_PATH,     MEDIA_PIWG_FW_FILE_DP,            DevPathToTextFvFile         },

+  {MEDIA_DEVICE_PATH,     MEDIA_RELATIVE_OFFSET_RANGE_DP,   DevPathRelativeOffsetRange  },

+  {MEDIA_DEVICE_PATH,     MEDIA_RAM_DISK_DP,                DevPathToTextRamDisk        },

+  {BBS_DEVICE_PATH,       BBS_BBS_DP,                       DevPathToTextBBS            },

+  {END_DEVICE_PATH_TYPE,  END_INSTANCE_DEVICE_PATH_SUBTYPE, DevPathToTextEndInstance    },

+  {0, 0, NULL}

+};

+

+/**

+  Converts a device node to its string representation.

+

+  @param DeviceNode        A Pointer to the device node to be converted.

+  @param DisplayOnly       If DisplayOnly is TRUE, then the shorter text representation

+                           of the display node is used, where applicable. If DisplayOnly

+                           is FALSE, then the longer text representation of the display node

+                           is used.

+  @param AllowShortcuts    If AllowShortcuts is TRUE, then the shortcut forms of text

+                           representation for a device node can be used, where applicable.

+

+  @return A pointer to the allocated text representation of the device node or NULL if DeviceNode

+          is NULL or there was insufficient memory.

+

+**/

+CHAR16 *

+EFIAPI

+UefiDevicePathLibConvertDeviceNodeToText (

+  IN CONST EFI_DEVICE_PATH_PROTOCOL  *DeviceNode,

+  IN BOOLEAN                         DisplayOnly,

+  IN BOOLEAN                         AllowShortcuts

+  )

+{

+  POOL_PRINT          Str;

+  UINTN               Index;

+  DEVICE_PATH_TO_TEXT ToText;

+

+  if (DeviceNode == NULL) {

+    return NULL;

+  }

+

+  ZeroMem (&Str, sizeof (Str));

+

+  //

+  // Process the device path node

+  // If not found, use a generic function

+  //

+  ToText = DevPathToTextNodeGeneric;

+  for (Index = 0; mUefiDevicePathLibToTextTable[Index].Function != NULL; Index++) {

+    if (DevicePathType (DeviceNode) == mUefiDevicePathLibToTextTable[Index].Type &&

+        DevicePathSubType (DeviceNode) == mUefiDevicePathLibToTextTable[Index].SubType

+        ) {

+      ToText = mUefiDevicePathLibToTextTable[Index].Function;

+      break;

+    }

+  }

+

+  //

+  // Print this node

+  //

+  ToText (&Str, (VOID *) DeviceNode, DisplayOnly, AllowShortcuts);

+

+  ASSERT (Str.Str != NULL);

+  return Str.Str;

+}

+

+/**

+  Converts a device path to its text representation.

+

+  @param DevicePath      A Pointer to the device to be converted.

+  @param DisplayOnly     If DisplayOnly is TRUE, then the shorter text representation

+                         of the display node is used, where applicable. If DisplayOnly

+                         is FALSE, then the longer text representation of the display node

+                         is used.

+  @param AllowShortcuts  If AllowShortcuts is TRUE, then the shortcut forms of text

+                         representation for a device node can be used, where applicable.

+

+  @return A pointer to the allocated text representation of the device path or

+          NULL if DeviceNode is NULL or there was insufficient memory.

+

+**/

+CHAR16 *

+EFIAPI

+UefiDevicePathLibConvertDevicePathToText (

+  IN CONST EFI_DEVICE_PATH_PROTOCOL   *DevicePath,

+  IN BOOLEAN                          DisplayOnly,

+  IN BOOLEAN                          AllowShortcuts

+  )

+{

+  POOL_PRINT               Str;

+  EFI_DEVICE_PATH_PROTOCOL *Node;

+  EFI_DEVICE_PATH_PROTOCOL *AlignedNode;

+  UINTN                    Index;

+  DEVICE_PATH_TO_TEXT      ToText;

+

+  if (DevicePath == NULL) {

+    return NULL;

+  }

+

+  ZeroMem (&Str, sizeof (Str));

+

+  //

+  // Process each device path node

+  //

+  Node = (EFI_DEVICE_PATH_PROTOCOL *) DevicePath;

+  while (!IsDevicePathEnd (Node)) {

+    //

+    // Find the handler to dump this device path node

+    // If not found, use a generic function

+    //

+    ToText = DevPathToTextNodeGeneric;

+    for (Index = 0; mUefiDevicePathLibToTextTable[Index].Function != NULL; Index += 1) {

+

+      if (DevicePathType (Node) == mUefiDevicePathLibToTextTable[Index].Type &&

+          DevicePathSubType (Node) == mUefiDevicePathLibToTextTable[Index].SubType

+          ) {

+        ToText = mUefiDevicePathLibToTextTable[Index].Function;

+        break;

+      }

+    }

+    //

+    //  Put a path separator in if needed

+    //

+    if ((Str.Count != 0) && (ToText != DevPathToTextEndInstance)) {

+      if (Str.Str[Str.Count] != L',') {

+        UefiDevicePathLibCatPrint (&Str, L"/");

+      }

+    }

+

+    AlignedNode = AllocateCopyPool (DevicePathNodeLength (Node), Node);

+    //

+    // Print this node of the device path

+    //

+    ToText (&Str, AlignedNode, DisplayOnly, AllowShortcuts);

+    FreePool (AlignedNode);

+

+    //

+    // Next device path node

+    //

+    Node = NextDevicePathNode (Node);

+  }

+

+  if (Str.Str == NULL) {

+    return AllocateZeroPool (sizeof (CHAR16));

+  } else {

+    return Str.Str;

+  }

+}

diff --git a/debugging_demo/memtest86+/efi/Include/src/UefiDevicePathLib/DevicePathUtilities.c b/debugging_demo/memtest86+/efi/Include/src/UefiDevicePathLib/DevicePathUtilities.c
new file mode 100644
index 0000000..3295654
--- /dev/null
+++ b/debugging_demo/memtest86+/efi/Include/src/UefiDevicePathLib/DevicePathUtilities.c
@@ -0,0 +1,865 @@
+/** @file

+  Device Path services. The thing to remember is device paths are built out of

+  nodes. The device path is terminated by an end node that is length

+  sizeof(EFI_DEVICE_PATH_PROTOCOL). That would be why there is sizeof(EFI_DEVICE_PATH_PROTOCOL)

+  all over this file.

+

+  The only place where multi-instance device paths are supported is in

+  environment varibles. Multi-instance device paths should never be placed

+  on a Handle.

+

+  Copyright (c) 2006 - 2018, Intel Corporation. All rights reserved.<BR>

+  SPDX-License-Identifier: BSD-2-Clause-Patent

+

+**/

+

+#include "UefiDevicePathLib.h"

+#include "Efi_Defs.h"

+

+//

+// Template for an end-of-device path node.

+//

+GLOBAL_REMOVE_IF_UNREFERENCED CONST EFI_DEVICE_PATH_PROTOCOL  mUefiDevicePathLibEndDevicePath = {

+  END_DEVICE_PATH_TYPE,

+  END_ENTIRE_DEVICE_PATH_SUBTYPE,

+  {

+    END_DEVICE_PATH_LENGTH,

+    0

+  }

+};

+

+/**

+  Determine whether a given device path is valid.

+

+  @param  DevicePath  A pointer to a device path data structure.

+  @param  MaxSize     The maximum size of the device path data structure.

+

+  @retval TRUE        DevicePath is valid.

+  @retval FALSE       DevicePath is NULL.

+  @retval FALSE       Maxsize is less than sizeof(EFI_DEVICE_PATH_PROTOCOL).

+  @retval FALSE       The length of any node node in the DevicePath is less

+                      than sizeof (EFI_DEVICE_PATH_PROTOCOL).

+  @retval FALSE       If MaxSize is not zero, the size of the DevicePath

+                      exceeds MaxSize.

+  @retval FALSE       If PcdMaximumDevicePathNodeCount is not zero, the node

+                      count of the DevicePath exceeds PcdMaximumDevicePathNodeCount.

+**/

+BOOLEAN

+EFIAPI

+IsDevicePathValid (

+  IN CONST EFI_DEVICE_PATH_PROTOCOL *DevicePath,

+  IN       UINTN                    MaxSize

+  )

+{

+  UINTN Count;

+  UINTN Size;

+  UINTN NodeLength;

+

+  //

+  //Validate the input whether exists and its size big enough to touch the first node

+  //

+  if (DevicePath == NULL || (MaxSize > 0 && MaxSize < END_DEVICE_PATH_LENGTH)) {

+    return FALSE;

+  }

+

+  if (MaxSize == 0) {

+    MaxSize = MAX_UINTN;

+  }

+

+  for (Count = 0, Size = 0; !IsDevicePathEnd (DevicePath); DevicePath = NextDevicePathNode (DevicePath)) {

+    NodeLength = DevicePathNodeLength (DevicePath);

+    if (NodeLength < sizeof (EFI_DEVICE_PATH_PROTOCOL)) {

+      return FALSE;

+    }

+

+    if (NodeLength > MAX_UINTN - Size) {

+      return FALSE;

+    }

+    Size += NodeLength;

+

+    //

+    // Validate next node before touch it.

+    //

+    if (Size > MaxSize - END_DEVICE_PATH_LENGTH ) {

+      return FALSE;

+    }

+

+    if (PcdGet32 (PcdMaximumDevicePathNodeCount) > 0) {

+      Count++;

+      if (Count >= PcdGet32 (PcdMaximumDevicePathNodeCount)) {

+        return FALSE;

+      }

+    }

+

+    //

+    // FilePath must be a NULL-terminated string.

+    //

+    if (DevicePathType (DevicePath) == MEDIA_DEVICE_PATH &&

+        DevicePathSubType (DevicePath) == MEDIA_FILEPATH_DP &&

+        *(CHAR16 *)((UINT8 *)DevicePath + NodeLength - 2) != 0) {

+      return FALSE;

+    }

+  }

+

+  //

+  // Only return TRUE when the End Device Path node is valid.

+  //

+  return (BOOLEAN) (DevicePathNodeLength (DevicePath) == END_DEVICE_PATH_LENGTH);

+}

+

+

+/**

+  Returns the Type field of a device path node.

+

+  Returns the Type field of the device path node specified by Node.

+

+  If Node is NULL, then ASSERT().

+

+  @param  Node      A pointer to a device path node data structure.

+

+  @return The Type field of the device path node specified by Node.

+

+**/

+UINT8

+EFIAPI

+DevicePathType (

+  IN CONST VOID  *Node

+  )

+{

+  ASSERT (Node != NULL);

+  return ((EFI_DEVICE_PATH_PROTOCOL *)(Node))->Type;

+}

+

+/**

+  Returns the SubType field of a device path node.

+

+  Returns the SubType field of the device path node specified by Node.

+

+  If Node is NULL, then ASSERT().

+

+  @param  Node      A pointer to a device path node data structure.

+

+  @return The SubType field of the device path node specified by Node.

+

+**/

+UINT8

+EFIAPI

+DevicePathSubType (

+  IN CONST VOID  *Node

+  )

+{

+  ASSERT (Node != NULL);

+  return ((EFI_DEVICE_PATH_PROTOCOL *)(Node))->SubType;

+}

+

+/**

+  Returns the 16-bit Length field of a device path node.

+

+  Returns the 16-bit Length field of the device path node specified by Node.

+  Node is not required to be aligned on a 16-bit boundary, so it is recommended

+  that a function such as ReadUnaligned16() be used to extract the contents of

+  the Length field.

+

+  If Node is NULL, then ASSERT().

+

+  @param  Node      A pointer to a device path node data structure.

+

+  @return The 16-bit Length field of the device path node specified by Node.

+

+**/

+UINTN

+EFIAPI

+DevicePathNodeLength (

+  IN CONST VOID  *Node

+  )

+{

+  ASSERT (Node != NULL);

+  return ReadUnaligned16 ((UINT16 *)&((EFI_DEVICE_PATH_PROTOCOL *)(Node))->Length[0]);

+}

+

+/**

+  Returns a pointer to the next node in a device path.

+

+  Returns a pointer to the device path node that follows the device path node

+  specified by Node.

+

+  If Node is NULL, then ASSERT().

+

+  @param  Node      A pointer to a device path node data structure.

+

+  @return a pointer to the device path node that follows the device path node

+  specified by Node.

+

+**/

+EFI_DEVICE_PATH_PROTOCOL *

+EFIAPI

+NextDevicePathNode (

+  IN CONST VOID  *Node

+  )

+{

+  ASSERT (Node != NULL);

+  return (EFI_DEVICE_PATH_PROTOCOL *)((UINT8 *)(Node) + DevicePathNodeLength(Node));

+}

+

+/**

+  Determines if a device path node is an end node of a device path.

+  This includes nodes that are the end of a device path instance and nodes that

+  are the end of an entire device path.

+

+  Determines if the device path node specified by Node is an end node of a device path.

+  This includes nodes that are the end of a device path instance and nodes that are the

+  end of an entire device path.  If Node represents an end node of a device path,

+  then TRUE is returned.  Otherwise, FALSE is returned.

+

+  If Node is NULL, then ASSERT().

+

+  @param  Node      A pointer to a device path node data structure.

+

+  @retval TRUE      The device path node specified by Node is an end node of a

+                    device path.

+  @retval FALSE     The device path node specified by Node is not an end node of

+                    a device path.

+

+**/

+BOOLEAN

+EFIAPI

+IsDevicePathEndType (

+  IN CONST VOID  *Node

+  )

+{

+  ASSERT (Node != NULL);

+  return (BOOLEAN) (DevicePathType (Node) == END_DEVICE_PATH_TYPE);

+}

+

+/**

+  Determines if a device path node is an end node of an entire device path.

+

+  Determines if a device path node specified by Node is an end node of an entire

+  device path. If Node represents the end of an entire device path, then TRUE is

+  returned.  Otherwise, FALSE is returned.

+

+  If Node is NULL, then ASSERT().

+

+  @param  Node      A pointer to a device path node data structure.

+

+  @retval TRUE      The device path node specified by Node is the end of an entire

+                    device path.

+  @retval FALSE     The device path node specified by Node is not the end of an

+                    entire device path.

+

+**/

+BOOLEAN

+EFIAPI

+IsDevicePathEnd (

+  IN CONST VOID  *Node

+  )

+{

+  ASSERT (Node != NULL);

+  return (BOOLEAN) (IsDevicePathEndType (Node) && DevicePathSubType(Node) == END_ENTIRE_DEVICE_PATH_SUBTYPE);

+}

+

+/**

+  Determines if a device path node is an end node of a device path instance.

+

+  Determines if a device path node specified by Node is an end node of a device

+  path instance. If Node represents the end of a device path instance, then TRUE

+  is returned.  Otherwise, FALSE is returned.

+

+  If Node is NULL, then ASSERT().

+

+  @param  Node      A pointer to a device path node data structure.

+

+  @retval TRUE      The device path node specified by Node is the end of a device

+                    path instance.

+  @retval FALSE     The device path node specified by Node is not the end of a

+                    device path instance.

+

+**/

+BOOLEAN

+EFIAPI

+IsDevicePathEndInstance (

+  IN CONST VOID  *Node

+  )

+{

+  ASSERT (Node != NULL);

+  return (BOOLEAN) (IsDevicePathEndType (Node) && DevicePathSubType(Node) == END_INSTANCE_DEVICE_PATH_SUBTYPE);

+}

+

+/**

+  Sets the length, in bytes, of a device path node.

+

+  Sets the length of the device path node specified by Node to the value specified

+  by NodeLength.  NodeLength is returned.  Node is not required to be aligned on

+  a 16-bit boundary, so it is recommended that a function such as WriteUnaligned16()

+  be used to set the contents of the Length field.

+

+  If Node is NULL, then ASSERT().

+  If NodeLength >= SIZE_64KB, then ASSERT().

+  If NodeLength < sizeof (EFI_DEVICE_PATH_PROTOCOL), then ASSERT().

+

+  @param  Node      A pointer to a device path node data structure.

+  @param  Length    The length, in bytes, of the device path node.

+

+  @return Length

+

+**/

+UINT16

+EFIAPI

+SetDevicePathNodeLength (

+  IN OUT VOID  *Node,

+  IN UINTN     Length

+  )

+{

+  ASSERT (Node != NULL);

+  ASSERT ((Length >= sizeof (EFI_DEVICE_PATH_PROTOCOL)) && (Length < SIZE_64KB));

+  return WriteUnaligned16 ((UINT16 *)&((EFI_DEVICE_PATH_PROTOCOL *)(Node))->Length[0], (UINT16)(Length));

+}

+

+/**

+  Fills in all the fields of a device path node that is the end of an entire device path.

+

+  Fills in all the fields of a device path node specified by Node so Node represents

+  the end of an entire device path.  The Type field of Node is set to

+  END_DEVICE_PATH_TYPE, the SubType field of Node is set to

+  END_ENTIRE_DEVICE_PATH_SUBTYPE, and the Length field of Node is set to

+  END_DEVICE_PATH_LENGTH.  Node is not required to be aligned on a 16-bit boundary,

+  so it is recommended that a function such as WriteUnaligned16() be used to set

+  the contents of the Length field.

+

+  If Node is NULL, then ASSERT().

+

+  @param  Node      A pointer to a device path node data structure.

+

+**/

+VOID

+EFIAPI

+SetDevicePathEndNode (

+  OUT VOID  *Node

+  )

+{

+  ASSERT (Node != NULL);

+  CopyMem (Node, &mUefiDevicePathLibEndDevicePath, sizeof (mUefiDevicePathLibEndDevicePath));

+}

+

+/**

+  Returns the size of a device path in bytes.

+

+  This function returns the size, in bytes, of the device path data structure

+  specified by DevicePath including the end of device path node.

+  If DevicePath is NULL or invalid, then 0 is returned.

+

+  @param  DevicePath  A pointer to a device path data structure.

+

+  @retval 0           If DevicePath is NULL or invalid.

+  @retval Others      The size of a device path in bytes.

+

+**/

+UINTN

+EFIAPI

+UefiDevicePathLibGetDevicePathSize (

+  IN CONST EFI_DEVICE_PATH_PROTOCOL  *DevicePath

+  )

+{

+  CONST EFI_DEVICE_PATH_PROTOCOL  *Start;

+

+  if (DevicePath == NULL) {

+    return 0;

+  }

+

+  if (!IsDevicePathValid (DevicePath, 0)) {

+    return 0;

+  }

+

+  //

+  // Search for the end of the device path structure

+  //

+  Start = DevicePath;

+  while (!IsDevicePathEnd (DevicePath)) {

+    DevicePath = NextDevicePathNode (DevicePath);

+  }

+

+  //

+  // Compute the size and add back in the size of the end device path structure

+  //

+  return ((UINTN) DevicePath - (UINTN) Start) + DevicePathNodeLength (DevicePath);

+}

+

+/**

+  Creates a new copy of an existing device path.

+

+  This function allocates space for a new copy of the device path specified by DevicePath.

+  If DevicePath is NULL, then NULL is returned.  If the memory is successfully

+  allocated, then the contents of DevicePath are copied to the newly allocated

+  buffer, and a pointer to that buffer is returned.  Otherwise, NULL is returned.

+  The memory for the new device path is allocated from EFI boot services memory.

+  It is the responsibility of the caller to free the memory allocated.

+

+  @param  DevicePath    A pointer to a device path data structure.

+

+  @retval NULL          DevicePath is NULL or invalid.

+  @retval Others        A pointer to the duplicated device path.

+

+**/

+EFI_DEVICE_PATH_PROTOCOL *

+EFIAPI

+UefiDevicePathLibDuplicateDevicePath (

+  IN CONST EFI_DEVICE_PATH_PROTOCOL  *DevicePath

+  )

+{

+  UINTN                     Size;

+

+  //

+  // Compute the size

+  //

+  Size = GetDevicePathSize (DevicePath);

+  if (Size == 0) {

+    return NULL;

+  }

+

+  //

+  // Allocate space for duplicate device path

+  //

+

+  return AllocateCopyPool (Size, DevicePath);

+}

+

+/**

+  Creates a new device path by appending a second device path to a first device path.

+

+  This function creates a new device path by appending a copy of SecondDevicePath

+  to a copy of FirstDevicePath in a newly allocated buffer.  Only the end-of-device-path

+  device node from SecondDevicePath is retained. The newly created device path is

+  returned. If FirstDevicePath is NULL, then it is ignored, and a duplicate of

+  SecondDevicePath is returned.  If SecondDevicePath is NULL, then it is ignored,

+  and a duplicate of FirstDevicePath is returned. If both FirstDevicePath and

+  SecondDevicePath are NULL, then a copy of an end-of-device-path is returned.

+

+  If there is not enough memory for the newly allocated buffer, then NULL is returned.

+  The memory for the new device path is allocated from EFI boot services memory.

+  It is the responsibility of the caller to free the memory allocated.

+

+  @param  FirstDevicePath            A pointer to a device path data structure.

+  @param  SecondDevicePath           A pointer to a device path data structure.

+

+  @retval NULL      If there is not enough memory for the newly allocated buffer.

+  @retval NULL      If FirstDevicePath or SecondDevicePath is invalid.

+  @retval Others    A pointer to the new device path if success.

+                    Or a copy an end-of-device-path if both FirstDevicePath and SecondDevicePath are NULL.

+

+**/

+EFI_DEVICE_PATH_PROTOCOL *

+EFIAPI

+UefiDevicePathLibAppendDevicePath (

+  IN CONST EFI_DEVICE_PATH_PROTOCOL  *FirstDevicePath,  OPTIONAL

+  IN CONST EFI_DEVICE_PATH_PROTOCOL  *SecondDevicePath  OPTIONAL

+  )

+{

+  UINTN                     Size;

+  UINTN                     Size1;

+  UINTN                     Size2;

+  EFI_DEVICE_PATH_PROTOCOL  *NewDevicePath;

+  EFI_DEVICE_PATH_PROTOCOL  *DevicePath2;

+

+  //

+  // If there's only 1 path, just duplicate it.

+  //

+  if (FirstDevicePath == NULL) {

+    return DuplicateDevicePath ((SecondDevicePath != NULL) ? SecondDevicePath : &mUefiDevicePathLibEndDevicePath);

+  }

+

+  if (SecondDevicePath == NULL) {

+    return DuplicateDevicePath (FirstDevicePath);

+  }

+

+  if (!IsDevicePathValid (FirstDevicePath, 0) || !IsDevicePathValid (SecondDevicePath, 0)) {

+    return NULL;

+  }

+

+  //

+  // Allocate space for the combined device path. It only has one end node of

+  // length EFI_DEVICE_PATH_PROTOCOL.

+  //

+  Size1         = GetDevicePathSize (FirstDevicePath);

+  Size2         = GetDevicePathSize (SecondDevicePath);

+  Size          = Size1 + Size2 - END_DEVICE_PATH_LENGTH;

+

+  NewDevicePath = AllocatePool (Size);

+

+  if (NewDevicePath != NULL) {

+    NewDevicePath = CopyMem (NewDevicePath, FirstDevicePath, Size1);

+    //

+    // Over write FirstDevicePath EndNode and do the copy

+    //

+    DevicePath2 = (EFI_DEVICE_PATH_PROTOCOL *) ((CHAR8 *) NewDevicePath +

+                  (Size1 - END_DEVICE_PATH_LENGTH));

+    CopyMem (DevicePath2, SecondDevicePath, Size2);

+  }

+

+  return NewDevicePath;

+}

+

+/**

+  Creates a new path by appending the device node to the device path.

+

+  This function creates a new device path by appending a copy of the device node

+  specified by DevicePathNode to a copy of the device path specified by DevicePath

+  in an allocated buffer. The end-of-device-path device node is moved after the

+  end of the appended device node.

+  If DevicePathNode is NULL then a copy of DevicePath is returned.

+  If DevicePath is NULL then a copy of DevicePathNode, followed by an end-of-device

+  path device node is returned.

+  If both DevicePathNode and DevicePath are NULL then a copy of an end-of-device-path

+  device node is returned.

+  If there is not enough memory to allocate space for the new device path, then

+  NULL is returned.

+  The memory is allocated from EFI boot services memory. It is the responsibility

+  of the caller to free the memory allocated.

+

+  @param  DevicePath                 A pointer to a device path data structure.

+  @param  DevicePathNode             A pointer to a single device path node.

+

+  @retval NULL      If there is not enough memory for the new device path.

+  @retval Others    A pointer to the new device path if success.

+                    A copy of DevicePathNode followed by an end-of-device-path node

+                    if both FirstDevicePath and SecondDevicePath are NULL.

+                    A copy of an end-of-device-path node if both FirstDevicePath

+                    and SecondDevicePath are NULL.

+

+**/

+EFI_DEVICE_PATH_PROTOCOL *

+EFIAPI

+UefiDevicePathLibAppendDevicePathNode (

+  IN CONST EFI_DEVICE_PATH_PROTOCOL  *DevicePath,     OPTIONAL

+  IN CONST EFI_DEVICE_PATH_PROTOCOL  *DevicePathNode  OPTIONAL

+  )

+{

+  EFI_DEVICE_PATH_PROTOCOL  *TempDevicePath;

+  EFI_DEVICE_PATH_PROTOCOL  *NextNode;

+  EFI_DEVICE_PATH_PROTOCOL  *NewDevicePath;

+  UINTN                     NodeLength;

+

+  if (DevicePathNode == NULL) {

+    return DuplicateDevicePath ((DevicePath != NULL) ? DevicePath : &mUefiDevicePathLibEndDevicePath);

+  }

+  //

+  // Build a Node that has a terminator on it

+  //

+  NodeLength = DevicePathNodeLength (DevicePathNode);

+

+  TempDevicePath = AllocatePool (NodeLength + END_DEVICE_PATH_LENGTH);

+  if (TempDevicePath == NULL) {

+    return NULL;

+  }

+  TempDevicePath = CopyMem (TempDevicePath, DevicePathNode, NodeLength);

+  //

+  // Add and end device path node to convert Node to device path

+  //

+  NextNode = NextDevicePathNode (TempDevicePath);

+  SetDevicePathEndNode (NextNode);

+  //

+  // Append device paths

+  //

+  NewDevicePath = AppendDevicePath (DevicePath, TempDevicePath);

+

+  FreePool (TempDevicePath);

+

+  return NewDevicePath;

+}

+

+/**

+  Creates a new device path by appending the specified device path instance to the specified device

+  path.

+

+  This function creates a new device path by appending a copy of the device path

+  instance specified by DevicePathInstance to a copy of the device path specified

+  by DevicePath in a allocated buffer.

+  The end-of-device-path device node is moved after the end of the appended device

+  path instance and a new end-of-device-path-instance node is inserted between.

+  If DevicePath is NULL, then a copy if DevicePathInstance is returned.

+  If DevicePathInstance is NULL, then NULL is returned.

+  If DevicePath or DevicePathInstance is invalid, then NULL is returned.

+  If there is not enough memory to allocate space for the new device path, then

+  NULL is returned.

+  The memory is allocated from EFI boot services memory. It is the responsibility

+  of the caller to free the memory allocated.

+

+  @param  DevicePath                 A pointer to a device path data structure.

+  @param  DevicePathInstance         A pointer to a device path instance.

+

+  @return A pointer to the new device path.

+

+**/

+EFI_DEVICE_PATH_PROTOCOL *

+EFIAPI

+UefiDevicePathLibAppendDevicePathInstance (

+  IN CONST EFI_DEVICE_PATH_PROTOCOL  *DevicePath,        OPTIONAL

+  IN CONST EFI_DEVICE_PATH_PROTOCOL  *DevicePathInstance OPTIONAL

+  )

+{

+  EFI_DEVICE_PATH_PROTOCOL  *NewDevicePath;

+  EFI_DEVICE_PATH_PROTOCOL  *TempDevicePath;

+  UINTN                     SrcSize;

+  UINTN                     InstanceSize;

+

+  if (DevicePath == NULL) {

+    return DuplicateDevicePath (DevicePathInstance);

+  }

+

+  if (DevicePathInstance == NULL) {

+    return NULL;

+  }

+

+  if (!IsDevicePathValid (DevicePath, 0) || !IsDevicePathValid (DevicePathInstance, 0)) {

+    return NULL;

+  }

+

+  SrcSize       = GetDevicePathSize (DevicePath);

+  InstanceSize  = GetDevicePathSize (DevicePathInstance);

+

+  NewDevicePath = AllocatePool (SrcSize + InstanceSize);

+  if (NewDevicePath != NULL) {

+

+    TempDevicePath = CopyMem (NewDevicePath, DevicePath, SrcSize);;

+

+    while (!IsDevicePathEnd (TempDevicePath)) {

+      TempDevicePath = NextDevicePathNode (TempDevicePath);

+    }

+

+    TempDevicePath->SubType  = END_INSTANCE_DEVICE_PATH_SUBTYPE;

+    TempDevicePath           = NextDevicePathNode (TempDevicePath);

+    CopyMem (TempDevicePath, DevicePathInstance, InstanceSize);

+  }

+

+  return NewDevicePath;

+}

+

+/**

+  Creates a copy of the current device path instance and returns a pointer to the next device path

+  instance.

+

+  This function creates a copy of the current device path instance. It also updates

+  DevicePath to point to the next device path instance in the device path (or NULL

+  if no more) and updates Size to hold the size of the device path instance copy.

+  If DevicePath is NULL, then NULL is returned.

+  If DevicePath points to a invalid device path, then NULL is returned.

+  If there is not enough memory to allocate space for the new device path, then

+  NULL is returned.

+  The memory is allocated from EFI boot services memory. It is the responsibility

+  of the caller to free the memory allocated.

+  If Size is NULL, then ASSERT().

+

+  @param  DevicePath                 On input, this holds the pointer to the current

+                                     device path instance. On output, this holds

+                                     the pointer to the next device path instance

+                                     or NULL if there are no more device path

+                                     instances in the device path pointer to a

+                                     device path data structure.

+  @param  Size                       On output, this holds the size of the device

+                                     path instance, in bytes or zero, if DevicePath

+                                     is NULL.

+

+  @return A pointer to the current device path instance.

+

+**/

+EFI_DEVICE_PATH_PROTOCOL *

+EFIAPI

+UefiDevicePathLibGetNextDevicePathInstance (

+  IN OUT EFI_DEVICE_PATH_PROTOCOL    **DevicePath,

+  OUT UINTN                          *Size

+  )

+{

+  EFI_DEVICE_PATH_PROTOCOL  *DevPath;

+  EFI_DEVICE_PATH_PROTOCOL  *ReturnValue;

+  UINT8                     Temp;

+

+  ASSERT (Size != NULL);

+

+  if (DevicePath == NULL || *DevicePath == NULL) {

+    *Size = 0;

+    return NULL;

+  }

+

+  if (!IsDevicePathValid (*DevicePath, 0)) {

+    return NULL;

+  }

+

+  //

+  // Find the end of the device path instance

+  //

+  DevPath = *DevicePath;

+  while (!IsDevicePathEndType (DevPath)) {

+    DevPath = NextDevicePathNode (DevPath);

+  }

+

+  //

+  // Compute the size of the device path instance

+  //

+  *Size = ((UINTN) DevPath - (UINTN) (*DevicePath)) + sizeof (EFI_DEVICE_PATH_PROTOCOL);

+

+  //

+  // Make a copy and return the device path instance

+  //

+  Temp              = DevPath->SubType;

+  DevPath->SubType  = END_ENTIRE_DEVICE_PATH_SUBTYPE;

+  ReturnValue       = DuplicateDevicePath (*DevicePath);

+  DevPath->SubType  = Temp;

+

+  //

+  // If DevPath is the end of an entire device path, then another instance

+  // does not follow, so *DevicePath is set to NULL.

+  //

+  if (DevicePathSubType (DevPath) == END_ENTIRE_DEVICE_PATH_SUBTYPE) {

+    *DevicePath = NULL;

+  } else {

+    *DevicePath = NextDevicePathNode (DevPath);

+  }

+

+  return ReturnValue;

+}

+

+/**

+  Creates a device node.

+

+  This function creates a new device node in a newly allocated buffer of size

+  NodeLength and initializes the device path node header with NodeType and NodeSubType.

+  The new device path node is returned.

+  If NodeLength is smaller than a device path header, then NULL is returned.

+  If there is not enough memory to allocate space for the new device path, then

+  NULL is returned.

+  The memory is allocated from EFI boot services memory. It is the responsibility

+  of the caller to free the memory allocated.

+

+  @param  NodeType                   The device node type for the new device node.

+  @param  NodeSubType                The device node sub-type for the new device node.

+  @param  NodeLength                 The length of the new device node.

+

+  @return The new device path.

+

+**/

+EFI_DEVICE_PATH_PROTOCOL *

+EFIAPI

+UefiDevicePathLibCreateDeviceNode (

+  IN UINT8                           NodeType,

+  IN UINT8                           NodeSubType,

+  IN UINT16                          NodeLength

+  )

+{

+  EFI_DEVICE_PATH_PROTOCOL      *DevicePath;

+

+  if (NodeLength < sizeof (EFI_DEVICE_PATH_PROTOCOL)) {

+    //

+    // NodeLength is less than the size of the header.

+    //

+    return NULL;

+  }

+

+  DevicePath = AllocateZeroPool (NodeLength);

+  if (DevicePath != NULL) {

+     DevicePath->Type    = NodeType;

+     DevicePath->SubType = NodeSubType;

+     SetDevicePathNodeLength (DevicePath, NodeLength);

+  }

+

+  return DevicePath;

+}

+

+/**

+  Determines if a device path is single or multi-instance.

+

+  This function returns TRUE if the device path specified by DevicePath is

+  multi-instance.

+  Otherwise, FALSE is returned.

+  If DevicePath is NULL or invalid, then FALSE is returned.

+

+  @param  DevicePath                 A pointer to a device path data structure.

+

+  @retval  TRUE                      DevicePath is multi-instance.

+  @retval  FALSE                     DevicePath is not multi-instance, or DevicePath

+                                     is NULL or invalid.

+

+**/

+BOOLEAN

+EFIAPI

+UefiDevicePathLibIsDevicePathMultiInstance (

+  IN CONST EFI_DEVICE_PATH_PROTOCOL  *DevicePath

+  )

+{

+  CONST EFI_DEVICE_PATH_PROTOCOL     *Node;

+

+  if (DevicePath == NULL) {

+    return FALSE;

+  }

+

+  if (!IsDevicePathValid (DevicePath, 0)) {

+    return FALSE;

+  }

+

+  Node = DevicePath;

+  while (!IsDevicePathEnd (Node)) {

+    if (IsDevicePathEndInstance (Node)) {

+      return TRUE;

+    }

+

+    Node = NextDevicePathNode (Node);

+  }

+

+  return FALSE;

+}

+

+

+/**

+  Allocates a device path for a file and appends it to an existing device path.

+

+  If Device is a valid device handle that contains a device path protocol, then a device path for

+  the file specified by FileName  is allocated and appended to the device path associated with the

+  handle Device.  The allocated device path is returned.  If Device is NULL or Device is a handle

+  that does not support the device path protocol, then a device path containing a single device

+  path node for the file specified by FileName is allocated and returned.

+  The memory for the new device path is allocated from EFI boot services memory. It is the responsibility

+  of the caller to free the memory allocated.

+

+  If FileName is NULL, then ASSERT().

+  If FileName is not aligned on a 16-bit boundary, then ASSERT().

+

+  @param  Device                     A pointer to a device handle.  This parameter

+                                     is optional and may be NULL.

+  @param  FileName                   A pointer to a Null-terminated Unicode string.

+

+  @return The allocated device path.

+

+**/

+EFI_DEVICE_PATH_PROTOCOL *

+EFIAPI

+FileDevicePath (

+  IN EFI_HANDLE                      Device,     OPTIONAL

+  IN CONST CHAR16                    *FileName

+  )

+{

+  UINTN                     Size;

+  FILEPATH_DEVICE_PATH      *FilePath;

+  EFI_DEVICE_PATH_PROTOCOL  *DevicePath;

+  EFI_DEVICE_PATH_PROTOCOL  *FileDevicePath;

+

+  DevicePath = NULL;

+

+  Size = StrSize (FileName);

+  FileDevicePath = AllocatePool (Size + SIZE_OF_FILEPATH_DEVICE_PATH + END_DEVICE_PATH_LENGTH);

+  if (FileDevicePath != NULL) {

+    FilePath = (FILEPATH_DEVICE_PATH *) FileDevicePath;

+    FilePath->Header.Type    = MEDIA_DEVICE_PATH;

+    FilePath->Header.SubType = MEDIA_FILEPATH_DP;

+    CopyMem (&FilePath->PathName, FileName, Size);

+    SetDevicePathNodeLength (&FilePath->Header, Size + SIZE_OF_FILEPATH_DEVICE_PATH);

+    SetDevicePathEndNode (NextDevicePathNode (&FilePath->Header));

+

+    if (Device != NULL) {

+      DevicePath = DevicePathFromHandle (Device);

+    }

+

+    DevicePath = AppendDevicePath (DevicePath, FileDevicePath);

+    FreePool (FileDevicePath);

+  }

+

+  return DevicePath;

+}

+

diff --git a/debugging_demo/memtest86+/efi/Include/src/UefiDevicePathLib/DevicePathUtilitiesDxeSmm.c b/debugging_demo/memtest86+/efi/Include/src/UefiDevicePathLib/DevicePathUtilitiesDxeSmm.c
new file mode 100644
index 0000000..7f3b607
--- /dev/null
+++ b/debugging_demo/memtest86+/efi/Include/src/UefiDevicePathLib/DevicePathUtilitiesDxeSmm.c
@@ -0,0 +1,51 @@
+/** @file

+  Device Path services. The thing to remember is device paths are built out of

+  nodes. The device path is terminated by an end node that is length

+  sizeof(EFI_DEVICE_PATH_PROTOCOL). That would be why there is sizeof(EFI_DEVICE_PATH_PROTOCOL)

+  all over this file.

+

+  The only place where multi-instance device paths are supported is in

+  environment varibles. Multi-instance device paths should never be placed

+  on a Handle.

+

+  Copyright (c) 2006 - 2018, Intel Corporation. All rights reserved.<BR>

+  Copyright (c) Microsoft Corporation.

+  SPDX-License-Identifier: BSD-2-Clause-Patent

+

+**/

+

+#include "UefiDevicePathLib.h"

+

+

+/**

+  Retrieves the device path protocol from a handle.

+

+  This function returns the device path protocol from the handle specified by Handle.

+  If Handle is NULL or Handle does not contain a device path protocol, then NULL

+  is returned.

+

+  @param  Handle                     The handle from which to retrieve the device

+                                     path protocol.

+

+  @return The device path protocol from the handle specified by Handle.

+

+**/

+EFI_DEVICE_PATH_PROTOCOL *

+EFIAPI

+DevicePathFromHandle (

+  IN EFI_HANDLE                      Handle

+  )

+{

+  EFI_DEVICE_PATH_PROTOCOL  *DevicePath;

+  EFI_STATUS                Status;

+

+  Status = gBS->HandleProtocol (

+                  Handle,

+                  &gEfiDevicePathProtocolGuid,

+                  (VOID *) &DevicePath

+                  );

+  if (EFI_ERROR (Status)) {

+    DevicePath = NULL;

+  }

+  return DevicePath;

+}

diff --git a/debugging_demo/memtest86+/efi/Include/src/UefiDevicePathLib/DevicePathUtilitiesStandaloneMm.c b/debugging_demo/memtest86+/efi/Include/src/UefiDevicePathLib/DevicePathUtilitiesStandaloneMm.c
new file mode 100644
index 0000000..930e778
--- /dev/null
+++ b/debugging_demo/memtest86+/efi/Include/src/UefiDevicePathLib/DevicePathUtilitiesStandaloneMm.c
@@ -0,0 +1,40 @@
+/** @file

+  Device Path services. The thing to remember is device paths are built out of

+  nodes. The device path is terminated by an end node that is length

+  sizeof(EFI_DEVICE_PATH_PROTOCOL). That would be why there is sizeof(EFI_DEVICE_PATH_PROTOCOL)

+  all over this file.

+

+  The only place where multi-instance device paths are supported is in

+  environment varibles. Multi-instance device paths should never be placed

+  on a Handle.

+

+  Copyright (c) 2006 - 2018, Intel Corporation. All rights reserved.<BR>

+  Copyright (c) Microsoft Corporation.

+  SPDX-License-Identifier: BSD-2-Clause-Patent

+

+**/

+

+#include "UefiDevicePathLib.h"

+

+

+/**

+  Retrieves the device path protocol from a handle.

+

+  This function returns the device path protocol from the handle specified by Handle.

+  If Handle is NULL or Handle does not contain a device path protocol, then NULL

+  is returned.

+

+  @param  Handle                     The handle from which to retrieve the device

+                                     path protocol.

+

+  @return The device path protocol from the handle specified by Handle.

+

+**/

+EFI_DEVICE_PATH_PROTOCOL *

+EFIAPI

+DevicePathFromHandle (

+  IN EFI_HANDLE                      Handle

+  )

+{

+  return NULL;

+}

diff --git a/debugging_demo/memtest86+/efi/Include/src/UefiDevicePathLib/UefiDevicePathLib.c b/debugging_demo/memtest86+/efi/Include/src/UefiDevicePathLib/UefiDevicePathLib.c
new file mode 100644
index 0000000..aac7686
--- /dev/null
+++ b/debugging_demo/memtest86+/efi/Include/src/UefiDevicePathLib/UefiDevicePathLib.c
@@ -0,0 +1,354 @@
+/** @file

+  Device Path services. The thing to remember is device paths are built out of

+  nodes. The device path is terminated by an end node that is length

+  sizeof(EFI_DEVICE_PATH_PROTOCOL). That would be why there is sizeof(EFI_DEVICE_PATH_PROTOCOL)

+  all over this file.

+

+  The only place where multi-instance device paths are supported is in

+  environment varibles. Multi-instance device paths should never be placed

+  on a Handle.

+

+  Copyright (c) 2006 - 2018, Intel Corporation. All rights reserved.<BR>

+  SPDX-License-Identifier: BSD-2-Clause-Patent

+

+**/

+

+

+#include "UefiDevicePathLib.h"

+

+/**

+  Returns the size of a device path in bytes.

+

+  This function returns the size, in bytes, of the device path data structure

+  specified by DevicePath including the end of device path node.

+  If DevicePath is NULL or invalid, then 0 is returned.

+

+  @param  DevicePath  A pointer to a device path data structure.

+

+  @retval 0           If DevicePath is NULL or invalid.

+  @retval Others      The size of a device path in bytes.

+

+**/

+UINTN

+EFIAPI

+GetDevicePathSize (

+  IN CONST EFI_DEVICE_PATH_PROTOCOL  *DevicePath

+  )

+{

+  return UefiDevicePathLibGetDevicePathSize (DevicePath);

+}

+

+/**

+  Creates a new copy of an existing device path.

+

+  This function allocates space for a new copy of the device path specified by DevicePath.

+  If DevicePath is NULL, then NULL is returned.  If the memory is successfully

+  allocated, then the contents of DevicePath are copied to the newly allocated

+  buffer, and a pointer to that buffer is returned.  Otherwise, NULL is returned.

+  The memory for the new device path is allocated from EFI boot services memory.

+  It is the responsibility of the caller to free the memory allocated.

+

+  @param  DevicePath    A pointer to a device path data structure.

+

+  @retval NULL          DevicePath is NULL or invalid.

+  @retval Others        A pointer to the duplicated device path.

+

+**/

+EFI_DEVICE_PATH_PROTOCOL *

+EFIAPI

+DuplicateDevicePath (

+  IN CONST EFI_DEVICE_PATH_PROTOCOL  *DevicePath

+  )

+{

+  return UefiDevicePathLibDuplicateDevicePath (DevicePath);

+}

+

+/**

+  Creates a new device path by appending a second device path to a first device path.

+

+  This function creates a new device path by appending a copy of SecondDevicePath

+  to a copy of FirstDevicePath in a newly allocated buffer.  Only the end-of-device-path

+  device node from SecondDevicePath is retained. The newly created device path is

+  returned. If FirstDevicePath is NULL, then it is ignored, and a duplicate of

+  SecondDevicePath is returned.  If SecondDevicePath is NULL, then it is ignored,

+  and a duplicate of FirstDevicePath is returned. If both FirstDevicePath and

+  SecondDevicePath are NULL, then a copy of an end-of-device-path is returned.

+

+  If there is not enough memory for the newly allocated buffer, then NULL is returned.

+  The memory for the new device path is allocated from EFI boot services memory.

+  It is the responsibility of the caller to free the memory allocated.

+

+  @param  FirstDevicePath            A pointer to a device path data structure.

+  @param  SecondDevicePath           A pointer to a device path data structure.

+

+  @retval NULL      If there is not enough memory for the newly allocated buffer.

+  @retval NULL      If FirstDevicePath or SecondDevicePath is invalid.

+  @retval Others    A pointer to the new device path if success.

+                    Or a copy an end-of-device-path if both FirstDevicePath and SecondDevicePath are NULL.

+

+**/

+EFI_DEVICE_PATH_PROTOCOL *

+EFIAPI

+AppendDevicePath (

+  IN CONST EFI_DEVICE_PATH_PROTOCOL  *FirstDevicePath,  OPTIONAL

+  IN CONST EFI_DEVICE_PATH_PROTOCOL  *SecondDevicePath  OPTIONAL

+  )

+{

+  return UefiDevicePathLibAppendDevicePath (FirstDevicePath, SecondDevicePath);

+}

+

+/**

+  Creates a new path by appending the device node to the device path.

+

+  This function creates a new device path by appending a copy of the device node

+  specified by DevicePathNode to a copy of the device path specified by DevicePath

+  in an allocated buffer. The end-of-device-path device node is moved after the

+  end of the appended device node.

+  If DevicePathNode is NULL then a copy of DevicePath is returned.

+  If DevicePath is NULL then a copy of DevicePathNode, followed by an end-of-device

+  path device node is returned.

+  If both DevicePathNode and DevicePath are NULL then a copy of an end-of-device-path

+  device node is returned.

+  If there is not enough memory to allocate space for the new device path, then

+  NULL is returned.

+  The memory is allocated from EFI boot services memory. It is the responsibility

+  of the caller to free the memory allocated.

+

+  @param  DevicePath                 A pointer to a device path data structure.

+  @param  DevicePathNode             A pointer to a single device path node.

+

+  @retval NULL      If there is not enough memory for the new device path.

+  @retval Others    A pointer to the new device path if success.

+                    A copy of DevicePathNode followed by an end-of-device-path node

+                    if both FirstDevicePath and SecondDevicePath are NULL.

+                    A copy of an end-of-device-path node if both FirstDevicePath

+                    and SecondDevicePath are NULL.

+

+**/

+EFI_DEVICE_PATH_PROTOCOL *

+EFIAPI

+AppendDevicePathNode (

+  IN CONST EFI_DEVICE_PATH_PROTOCOL  *DevicePath,     OPTIONAL

+  IN CONST EFI_DEVICE_PATH_PROTOCOL  *DevicePathNode  OPTIONAL

+  )

+{

+  return UefiDevicePathLibAppendDevicePathNode (DevicePath, DevicePathNode);

+}

+

+/**

+  Creates a new device path by appending the specified device path instance to the specified device

+  path.

+

+  This function creates a new device path by appending a copy of the device path

+  instance specified by DevicePathInstance to a copy of the device path specified

+  by DevicePath in a allocated buffer.

+  The end-of-device-path device node is moved after the end of the appended device

+  path instance and a new end-of-device-path-instance node is inserted between.

+  If DevicePath is NULL, then a copy if DevicePathInstance is returned.

+  If DevicePathInstance is NULL, then NULL is returned.

+  If DevicePath or DevicePathInstance is invalid, then NULL is returned.

+  If there is not enough memory to allocate space for the new device path, then

+  NULL is returned.

+  The memory is allocated from EFI boot services memory. It is the responsibility

+  of the caller to free the memory allocated.

+

+  @param  DevicePath                 A pointer to a device path data structure.

+  @param  DevicePathInstance         A pointer to a device path instance.

+

+  @return A pointer to the new device path.

+

+**/

+EFI_DEVICE_PATH_PROTOCOL *

+EFIAPI

+AppendDevicePathInstance (

+  IN CONST EFI_DEVICE_PATH_PROTOCOL  *DevicePath,        OPTIONAL

+  IN CONST EFI_DEVICE_PATH_PROTOCOL  *DevicePathInstance OPTIONAL

+  )

+{

+  return UefiDevicePathLibAppendDevicePathInstance (DevicePath, DevicePathInstance);

+}

+

+/**

+  Creates a copy of the current device path instance and returns a pointer to the next device path

+  instance.

+

+  This function creates a copy of the current device path instance. It also updates

+  DevicePath to point to the next device path instance in the device path (or NULL

+  if no more) and updates Size to hold the size of the device path instance copy.

+  If DevicePath is NULL, then NULL is returned.

+  If DevicePath points to a invalid device path, then NULL is returned.

+  If there is not enough memory to allocate space for the new device path, then

+  NULL is returned.

+  The memory is allocated from EFI boot services memory. It is the responsibility

+  of the caller to free the memory allocated.

+  If Size is NULL, then ASSERT().

+

+  @param  DevicePath                 On input, this holds the pointer to the current

+                                     device path instance. On output, this holds

+                                     the pointer to the next device path instance

+                                     or NULL if there are no more device path

+                                     instances in the device path pointer to a

+                                     device path data structure.

+  @param  Size                       On output, this holds the size of the device

+                                     path instance, in bytes or zero, if DevicePath

+                                     is NULL.

+

+  @return A pointer to the current device path instance.

+

+**/

+EFI_DEVICE_PATH_PROTOCOL *

+EFIAPI

+GetNextDevicePathInstance (

+  IN OUT EFI_DEVICE_PATH_PROTOCOL    **DevicePath,

+  OUT UINTN                          *Size

+  )

+{

+  return UefiDevicePathLibGetNextDevicePathInstance (DevicePath, Size);

+}

+

+/**

+  Creates a device node.

+

+  This function creates a new device node in a newly allocated buffer of size

+  NodeLength and initializes the device path node header with NodeType and NodeSubType.

+  The new device path node is returned.

+  If NodeLength is smaller than a device path header, then NULL is returned.

+  If there is not enough memory to allocate space for the new device path, then

+  NULL is returned.

+  The memory is allocated from EFI boot services memory. It is the responsibility

+  of the caller to free the memory allocated.

+

+  @param  NodeType                   The device node type for the new device node.

+  @param  NodeSubType                The device node sub-type for the new device node.

+  @param  NodeLength                 The length of the new device node.

+

+  @return The new device path.

+

+**/

+EFI_DEVICE_PATH_PROTOCOL *

+EFIAPI

+CreateDeviceNode (

+  IN UINT8                           NodeType,

+  IN UINT8                           NodeSubType,

+  IN UINT16                          NodeLength

+  )

+{

+  return UefiDevicePathLibCreateDeviceNode (NodeType, NodeSubType, NodeLength);

+}

+

+/**

+  Determines if a device path is single or multi-instance.

+

+  This function returns TRUE if the device path specified by DevicePath is

+  multi-instance.

+  Otherwise, FALSE is returned.

+  If DevicePath is NULL or invalid, then FALSE is returned.

+

+  @param  DevicePath                 A pointer to a device path data structure.

+

+  @retval  TRUE                      DevicePath is multi-instance.

+  @retval  FALSE                     DevicePath is not multi-instance, or DevicePath

+                                     is NULL or invalid.

+

+**/

+BOOLEAN

+EFIAPI

+IsDevicePathMultiInstance (

+  IN CONST EFI_DEVICE_PATH_PROTOCOL  *DevicePath

+  )

+{

+  return UefiDevicePathLibIsDevicePathMultiInstance (DevicePath);

+}

+

+/**

+  Converts a device node to its string representation.

+

+  @param DeviceNode        A Pointer to the device node to be converted.

+  @param DisplayOnly       If DisplayOnly is TRUE, then the shorter text representation

+                           of the display node is used, where applicable. If DisplayOnly

+                           is FALSE, then the longer text representation of the display node

+                           is used.

+  @param AllowShortcuts    If AllowShortcuts is TRUE, then the shortcut forms of text

+                           representation for a device node can be used, where applicable.

+

+  @return A pointer to the allocated text representation of the device node or NULL if DeviceNode

+          is NULL or there was insufficient memory.

+

+**/

+CHAR16 *

+EFIAPI

+ConvertDeviceNodeToText (

+  IN CONST EFI_DEVICE_PATH_PROTOCOL  *DeviceNode,

+  IN BOOLEAN                         DisplayOnly,

+  IN BOOLEAN                         AllowShortcuts

+  )

+{

+  return UefiDevicePathLibConvertDeviceNodeToText (DeviceNode, DisplayOnly, AllowShortcuts);

+}

+

+/**

+  Converts a device path to its text representation.

+

+  @param DevicePath      A Pointer to the device to be converted.

+  @param DisplayOnly     If DisplayOnly is TRUE, then the shorter text representation

+                         of the display node is used, where applicable. If DisplayOnly

+                         is FALSE, then the longer text representation of the display node

+                         is used.

+  @param AllowShortcuts  If AllowShortcuts is TRUE, then the shortcut forms of text

+                         representation for a device node can be used, where applicable.

+

+  @return A pointer to the allocated text representation of the device path or

+          NULL if DeviceNode is NULL or there was insufficient memory.

+

+**/

+CHAR16 *

+EFIAPI

+ConvertDevicePathToText (

+  IN CONST EFI_DEVICE_PATH_PROTOCOL   *DevicePath,

+  IN BOOLEAN                          DisplayOnly,

+  IN BOOLEAN                          AllowShortcuts

+  )

+{

+  return UefiDevicePathLibConvertDevicePathToText (DevicePath, DisplayOnly, AllowShortcuts);

+}

+

+/**

+  Convert text to the binary representation of a device node.

+

+  @param TextDeviceNode  TextDeviceNode points to the text representation of a device

+                         node. Conversion starts with the first character and continues

+                         until the first non-device node character.

+

+  @return A pointer to the EFI device node or NULL if TextDeviceNode is NULL or there was

+          insufficient memory or text unsupported.

+

+**/

+EFI_DEVICE_PATH_PROTOCOL *

+EFIAPI

+ConvertTextToDeviceNode (

+  IN CONST CHAR16 *TextDeviceNode

+  )

+{

+  return UefiDevicePathLibConvertTextToDeviceNode (TextDeviceNode);

+}

+

+/**

+  Convert text to the binary representation of a device path.

+

+

+  @param TextDevicePath  TextDevicePath points to the text representation of a device

+                         path. Conversion starts with the first character and continues

+                         until the first non-device node character.

+

+  @return A pointer to the allocated device path or NULL if TextDeviceNode is NULL or

+          there was insufficient memory.

+

+**/

+EFI_DEVICE_PATH_PROTOCOL *

+EFIAPI

+ConvertTextToDevicePath (

+  IN CONST CHAR16 *TextDevicePath

+  )

+{

+  return UefiDevicePathLibConvertTextToDevicePath (TextDevicePath);

+}

diff --git a/debugging_demo/memtest86+/efi/Include/src/UefiDevicePathLib/UefiDevicePathLib.h b/debugging_demo/memtest86+/efi/Include/src/UefiDevicePathLib/UefiDevicePathLib.h
new file mode 100644
index 0000000..9097c56
--- /dev/null
+++ b/debugging_demo/memtest86+/efi/Include/src/UefiDevicePathLib/UefiDevicePathLib.h
@@ -0,0 +1,451 @@
+/** @file

+  Definition for Device Path library.

+

+Copyright (c) 2013 - 2018, Intel Corporation. All rights reserved.<BR>

+SPDX-License-Identifier: BSD-2-Clause-Patent

+

+**/

+

+#ifndef _UEFI_DEVICE_PATH_LIB_H_

+#define _UEFI_DEVICE_PATH_LIB_H_

+#include <Uefi.h>

+#include <Protocol/DevicePathUtilities.h>

+#include <Protocol/DebugPort.h>

+#include <Protocol/DevicePathToText.h>

+#include <Protocol/DevicePathFromText.h>

+#include "Efi_Defs_GUID.h"

+#include <Library/DebugLib.h>

+#include <Library/PrintLib.h>

+#include <Library/BaseLib.h>

+#include <Library/BaseMemoryLib.h>

+#include <Library/MemoryAllocationLib.h>

+#include <Library/UefiBootServicesTableLib.h>

+#include <Library/DevicePathLib.h>

+#include <Library/PcdLib.h>

+#include <IndustryStandard/Bluetooth.h>

+

+#define IS_COMMA(a)                ((a) == L',')

+#define IS_HYPHEN(a)               ((a) == L'-')

+#define IS_DOT(a)                  ((a) == L'.')

+#define IS_LEFT_PARENTH(a)         ((a) == L'(')

+#define IS_RIGHT_PARENTH(a)        ((a) == L')')

+#define IS_SLASH(a)                ((a) == L'/')

+#define IS_NULL(a)                 ((a) == L'\0')

+

+

+//

+// Private Data structure

+//

+typedef struct {

+  CHAR16  *Str;

+  UINTN   Count;

+  UINTN   Capacity;

+} POOL_PRINT;

+

+typedef

+EFI_DEVICE_PATH_PROTOCOL  *

+(*DEVICE_PATH_FROM_TEXT) (

+  IN  CHAR16 *Str

+  );

+

+typedef

+VOID

+(*DEVICE_PATH_TO_TEXT) (

+  IN OUT POOL_PRINT  *Str,

+  IN VOID            *DevicePath,

+  IN BOOLEAN         DisplayOnly,

+  IN BOOLEAN         AllowShortcuts

+  );

+

+typedef struct {

+  UINT8                Type;

+  UINT8                SubType;

+  DEVICE_PATH_TO_TEXT  Function;

+} DEVICE_PATH_TO_TEXT_TABLE;

+

+typedef struct {

+  UINT8                Type;

+  CHAR16               *Text;

+} DEVICE_PATH_TO_TEXT_GENERIC_TABLE;

+

+typedef struct {

+  CHAR16                    *DevicePathNodeText;

+  DEVICE_PATH_FROM_TEXT     Function;

+} DEVICE_PATH_FROM_TEXT_TABLE;

+

+typedef struct {

+  BOOLEAN ClassExist;

+  UINT8   Class;

+  BOOLEAN SubClassExist;

+  UINT8   SubClass;

+} USB_CLASS_TEXT;

+

+#define USB_CLASS_AUDIO            1

+#define USB_CLASS_CDCCONTROL       2

+#define USB_CLASS_HID              3

+#define USB_CLASS_IMAGE            6

+#define USB_CLASS_PRINTER          7

+#define USB_CLASS_MASS_STORAGE     8

+#define USB_CLASS_HUB              9

+#define USB_CLASS_CDCDATA          10

+#define USB_CLASS_SMART_CARD       11

+#define USB_CLASS_VIDEO            14

+#define USB_CLASS_DIAGNOSTIC       220

+#define USB_CLASS_WIRELESS         224

+

+#define USB_CLASS_RESERVE          254

+#define USB_SUBCLASS_FW_UPDATE     1

+#define USB_SUBCLASS_IRDA_BRIDGE   2

+#define USB_SUBCLASS_TEST          3

+

+#define RFC_1700_UDP_PROTOCOL      17

+#define RFC_1700_TCP_PROTOCOL      6

+

+#pragma pack(1)

+

+typedef struct {

+  EFI_DEVICE_PATH_PROTOCOL  Header;

+  EFI_GUID                  Guid;

+  UINT8                     VendorDefinedData[1];

+} VENDOR_DEFINED_HARDWARE_DEVICE_PATH;

+

+typedef struct {

+  EFI_DEVICE_PATH_PROTOCOL  Header;

+  EFI_GUID                  Guid;

+  UINT8                     VendorDefinedData[1];

+} VENDOR_DEFINED_MESSAGING_DEVICE_PATH;

+

+typedef struct {

+  EFI_DEVICE_PATH_PROTOCOL  Header;

+  EFI_GUID                  Guid;

+  UINT8                     VendorDefinedData[1];

+} VENDOR_DEFINED_MEDIA_DEVICE_PATH;

+

+typedef struct {

+  EFI_DEVICE_PATH_PROTOCOL  Header;

+  UINT32                    Hid;

+  UINT32                    Uid;

+  UINT32                    Cid;

+  CHAR8                     HidUidCidStr[3];

+} ACPI_EXTENDED_HID_DEVICE_PATH_WITH_STR;

+

+typedef struct {

+  EFI_DEVICE_PATH_PROTOCOL  Header;

+  UINT16                    NetworkProtocol;

+  UINT16                    LoginOption;

+  UINT64                    Lun;

+  UINT16                    TargetPortalGroupTag;

+  CHAR8                     TargetName[1];

+} ISCSI_DEVICE_PATH_WITH_NAME;

+

+typedef struct {

+  EFI_DEVICE_PATH_PROTOCOL  Header;

+  EFI_GUID                  Guid;

+  UINT8                     VendorDefinedData[1];

+} VENDOR_DEVICE_PATH_WITH_DATA;

+

+#pragma pack()

+

+/**

+  Returns the size of a device path in bytes.

+

+  This function returns the size, in bytes, of the device path data structure

+  specified by DevicePath including the end of device path node.

+  If DevicePath is NULL or invalid, then 0 is returned.

+

+  @param  DevicePath  A pointer to a device path data structure.

+

+  @retval 0           If DevicePath is NULL or invalid.

+  @retval Others      The size of a device path in bytes.

+

+**/

+UINTN

+EFIAPI

+UefiDevicePathLibGetDevicePathSize (

+  IN CONST EFI_DEVICE_PATH_PROTOCOL  *DevicePath

+  );

+

+/**

+  Creates a new copy of an existing device path.

+

+  This function allocates space for a new copy of the device path specified by DevicePath.

+  If DevicePath is NULL, then NULL is returned.  If the memory is successfully

+  allocated, then the contents of DevicePath are copied to the newly allocated

+  buffer, and a pointer to that buffer is returned.  Otherwise, NULL is returned.

+  The memory for the new device path is allocated from EFI boot services memory.

+  It is the responsibility of the caller to free the memory allocated.

+

+  @param  DevicePath    A pointer to a device path data structure.

+

+  @retval NULL          DevicePath is NULL or invalid.

+  @retval Others        A pointer to the duplicated device path.

+

+**/

+EFI_DEVICE_PATH_PROTOCOL *

+EFIAPI

+UefiDevicePathLibDuplicateDevicePath (

+  IN CONST EFI_DEVICE_PATH_PROTOCOL  *DevicePath

+  );

+

+/**

+  Creates a new device path by appending a second device path to a first device path.

+

+  This function creates a new device path by appending a copy of SecondDevicePath

+  to a copy of FirstDevicePath in a newly allocated buffer.  Only the end-of-device-path

+  device node from SecondDevicePath is retained. The newly created device path is

+  returned. If FirstDevicePath is NULL, then it is ignored, and a duplicate of

+  SecondDevicePath is returned.  If SecondDevicePath is NULL, then it is ignored,

+  and a duplicate of FirstDevicePath is returned. If both FirstDevicePath and

+  SecondDevicePath are NULL, then a copy of an end-of-device-path is returned.

+

+  If there is not enough memory for the newly allocated buffer, then NULL is returned.

+  The memory for the new device path is allocated from EFI boot services memory.

+  It is the responsibility of the caller to free the memory allocated.

+

+  @param  FirstDevicePath            A pointer to a device path data structure.

+  @param  SecondDevicePath           A pointer to a device path data structure.

+

+  @retval NULL      If there is not enough memory for the newly allocated buffer.

+  @retval NULL      If FirstDevicePath or SecondDevicePath is invalid.

+  @retval Others    A pointer to the new device path if success.

+                    Or a copy an end-of-device-path if both FirstDevicePath and SecondDevicePath are NULL.

+

+**/

+EFI_DEVICE_PATH_PROTOCOL *

+EFIAPI

+UefiDevicePathLibAppendDevicePath (

+  IN CONST EFI_DEVICE_PATH_PROTOCOL  *FirstDevicePath,  OPTIONAL

+  IN CONST EFI_DEVICE_PATH_PROTOCOL  *SecondDevicePath  OPTIONAL

+  );

+

+/**

+  Creates a new path by appending the device node to the device path.

+

+  This function creates a new device path by appending a copy of the device node

+  specified by DevicePathNode to a copy of the device path specified by DevicePath

+  in an allocated buffer. The end-of-device-path device node is moved after the

+  end of the appended device node.

+  If DevicePathNode is NULL then a copy of DevicePath is returned.

+  If DevicePath is NULL then a copy of DevicePathNode, followed by an end-of-device

+  path device node is returned.

+  If both DevicePathNode and DevicePath are NULL then a copy of an end-of-device-path

+  device node is returned.

+  If there is not enough memory to allocate space for the new device path, then

+  NULL is returned.

+  The memory is allocated from EFI boot services memory. It is the responsibility

+  of the caller to free the memory allocated.

+

+  @param  DevicePath                 A pointer to a device path data structure.

+  @param  DevicePathNode             A pointer to a single device path node.

+

+  @retval NULL      If there is not enough memory for the new device path.

+  @retval Others    A pointer to the new device path if success.

+                    A copy of DevicePathNode followed by an end-of-device-path node

+                    if both FirstDevicePath and SecondDevicePath are NULL.

+                    A copy of an end-of-device-path node if both FirstDevicePath

+                    and SecondDevicePath are NULL.

+

+**/

+EFI_DEVICE_PATH_PROTOCOL *

+EFIAPI

+UefiDevicePathLibAppendDevicePathNode (

+  IN CONST EFI_DEVICE_PATH_PROTOCOL  *DevicePath,     OPTIONAL

+  IN CONST EFI_DEVICE_PATH_PROTOCOL  *DevicePathNode  OPTIONAL

+  );

+

+/**

+  Creates a new device path by appending the specified device path instance to the specified device

+  path.

+

+  This function creates a new device path by appending a copy of the device path

+  instance specified by DevicePathInstance to a copy of the device path specified

+  by DevicePath in a allocated buffer.

+  The end-of-device-path device node is moved after the end of the appended device

+  path instance and a new end-of-device-path-instance node is inserted between.

+  If DevicePath is NULL, then a copy if DevicePathInstance is returned.

+  If DevicePathInstance is NULL, then NULL is returned.

+  If DevicePath or DevicePathInstance is invalid, then NULL is returned.

+  If there is not enough memory to allocate space for the new device path, then

+  NULL is returned.

+  The memory is allocated from EFI boot services memory. It is the responsibility

+  of the caller to free the memory allocated.

+

+  @param  DevicePath                 A pointer to a device path data structure.

+  @param  DevicePathInstance         A pointer to a device path instance.

+

+  @return A pointer to the new device path.

+

+**/

+EFI_DEVICE_PATH_PROTOCOL *

+EFIAPI

+UefiDevicePathLibAppendDevicePathInstance (

+  IN CONST EFI_DEVICE_PATH_PROTOCOL  *DevicePath,        OPTIONAL

+  IN CONST EFI_DEVICE_PATH_PROTOCOL  *DevicePathInstance OPTIONAL

+  );

+

+/**

+  Creates a copy of the current device path instance and returns a pointer to the next device path

+  instance.

+

+  This function creates a copy of the current device path instance. It also updates

+  DevicePath to point to the next device path instance in the device path (or NULL

+  if no more) and updates Size to hold the size of the device path instance copy.

+  If DevicePath is NULL, then NULL is returned.

+  If DevicePath points to a invalid device path, then NULL is returned.

+  If there is not enough memory to allocate space for the new device path, then

+  NULL is returned.

+  The memory is allocated from EFI boot services memory. It is the responsibility

+  of the caller to free the memory allocated.

+  If Size is NULL, then ASSERT().

+

+  @param  DevicePath                 On input, this holds the pointer to the current

+                                     device path instance. On output, this holds

+                                     the pointer to the next device path instance

+                                     or NULL if there are no more device path

+                                     instances in the device path pointer to a

+                                     device path data structure.

+  @param  Size                       On output, this holds the size of the device

+                                     path instance, in bytes or zero, if DevicePath

+                                     is NULL.

+

+  @return A pointer to the current device path instance.

+

+**/

+EFI_DEVICE_PATH_PROTOCOL *

+EFIAPI

+UefiDevicePathLibGetNextDevicePathInstance (

+  IN OUT EFI_DEVICE_PATH_PROTOCOL    **DevicePath,

+  OUT UINTN                          *Size

+  );

+

+/**

+  Creates a device node.

+

+  This function creates a new device node in a newly allocated buffer of size

+  NodeLength and initializes the device path node header with NodeType and NodeSubType.

+  The new device path node is returned.

+  If NodeLength is smaller than a device path header, then NULL is returned.

+  If there is not enough memory to allocate space for the new device path, then

+  NULL is returned.

+  The memory is allocated from EFI boot services memory. It is the responsibility

+  of the caller to free the memory allocated.

+

+  @param  NodeType                   The device node type for the new device node.

+  @param  NodeSubType                The device node sub-type for the new device node.

+  @param  NodeLength                 The length of the new device node.

+

+  @return The new device path.

+

+**/

+EFI_DEVICE_PATH_PROTOCOL *

+EFIAPI

+UefiDevicePathLibCreateDeviceNode (

+  IN UINT8                           NodeType,

+  IN UINT8                           NodeSubType,

+  IN UINT16                          NodeLength

+  );

+

+/**

+  Determines if a device path is single or multi-instance.

+

+  This function returns TRUE if the device path specified by DevicePath is

+  multi-instance.

+  Otherwise, FALSE is returned.

+  If DevicePath is NULL or invalid, then FALSE is returned.

+

+  @param  DevicePath                 A pointer to a device path data structure.

+

+  @retval  TRUE                      DevicePath is multi-instance.

+  @retval  FALSE                     DevicePath is not multi-instance, or DevicePath

+                                     is NULL or invalid.

+

+**/

+BOOLEAN

+EFIAPI

+UefiDevicePathLibIsDevicePathMultiInstance (

+  IN CONST EFI_DEVICE_PATH_PROTOCOL  *DevicePath

+  );

+

+

+/**

+  Converts a device path to its text representation.

+

+  @param DevicePath      A Pointer to the device to be converted.

+  @param DisplayOnly     If DisplayOnly is TRUE, then the shorter text representation

+                         of the display node is used, where applicable. If DisplayOnly

+                         is FALSE, then the longer text representation of the display node

+                         is used.

+  @param AllowShortcuts  If AllowShortcuts is TRUE, then the shortcut forms of text

+                         representation for a device node can be used, where applicable.

+

+  @return A pointer to the allocated text representation of the device path or

+          NULL if DeviceNode is NULL or there was insufficient memory.

+

+**/

+CHAR16 *

+EFIAPI

+UefiDevicePathLibConvertDevicePathToText (

+  IN CONST EFI_DEVICE_PATH_PROTOCOL   *DevicePath,

+  IN BOOLEAN                          DisplayOnly,

+  IN BOOLEAN                          AllowShortcuts

+  );

+

+/**

+  Converts a device node to its string representation.

+

+  @param DeviceNode        A Pointer to the device node to be converted.

+  @param DisplayOnly       If DisplayOnly is TRUE, then the shorter text representation

+                           of the display node is used, where applicable. If DisplayOnly

+                           is FALSE, then the longer text representation of the display node

+                           is used.

+  @param AllowShortcuts    If AllowShortcuts is TRUE, then the shortcut forms of text

+                           representation for a device node can be used, where applicable.

+

+  @return A pointer to the allocated text representation of the device node or NULL if DeviceNode

+          is NULL or there was insufficient memory.

+

+**/

+CHAR16 *

+EFIAPI

+UefiDevicePathLibConvertDeviceNodeToText (

+  IN CONST EFI_DEVICE_PATH_PROTOCOL  *DeviceNode,

+  IN BOOLEAN                         DisplayOnly,

+  IN BOOLEAN                         AllowShortcuts

+  );

+

+/**

+  Convert text to the binary representation of a device node.

+

+  @param TextDeviceNode  TextDeviceNode points to the text representation of a device

+                         node. Conversion starts with the first character and continues

+                         until the first non-device node character.

+

+  @return A pointer to the EFI device node or NULL if TextDeviceNode is NULL or there was

+          insufficient memory or text unsupported.

+

+**/

+EFI_DEVICE_PATH_PROTOCOL *

+EFIAPI

+UefiDevicePathLibConvertTextToDeviceNode (

+  IN CONST CHAR16 *TextDeviceNode

+  );

+

+/**

+  Convert text to the binary representation of a device path.

+

+

+  @param TextDevicePath  TextDevicePath points to the text representation of a device

+                         path. Conversion starts with the first character and continues

+                         until the first non-device node character.

+

+  @return A pointer to the allocated device path or NULL if TextDeviceNode is NULL or

+          there was insufficient memory.

+

+**/

+EFI_DEVICE_PATH_PROTOCOL *

+EFIAPI

+UefiDevicePathLibConvertTextToDevicePath (

+  IN CONST CHAR16 *TextDevicePath

+  );

+

+#endif

diff --git a/debugging_demo/memtest86+/efi/Include/src/UefiDevicePathLib/UefiDevicePathLibOptionalDevicePathProtocol.c b/debugging_demo/memtest86+/efi/Include/src/UefiDevicePathLib/UefiDevicePathLibOptionalDevicePathProtocol.c
new file mode 100644
index 0000000..106ff24
--- /dev/null
+++ b/debugging_demo/memtest86+/efi/Include/src/UefiDevicePathLib/UefiDevicePathLibOptionalDevicePathProtocol.c
@@ -0,0 +1,478 @@
+/** @file

+  Device Path services. The thing to remember is device paths are built out of

+  nodes. The device path is terminated by an end node that is length

+  sizeof(EFI_DEVICE_PATH_PROTOCOL). That would be why there is sizeof(EFI_DEVICE_PATH_PROTOCOL)

+  all over this file.

+

+  The only place where multi-instance device paths are supported is in

+  environment varibles. Multi-instance device paths should never be placed

+  on a Handle.

+

+  Copyright (c) 2013 - 2018, Intel Corporation. All rights reserved.<BR>

+  SPDX-License-Identifier: BSD-2-Clause-Patent

+

+**/

+

+

+#include "UefiDevicePathLib.h"

+

+GLOBAL_REMOVE_IF_UNREFERENCED EFI_DEVICE_PATH_UTILITIES_PROTOCOL *mDevicePathLibDevicePathUtilities = NULL;

+GLOBAL_REMOVE_IF_UNREFERENCED EFI_DEVICE_PATH_TO_TEXT_PROTOCOL   *mDevicePathLibDevicePathToText    = NULL;

+GLOBAL_REMOVE_IF_UNREFERENCED EFI_DEVICE_PATH_FROM_TEXT_PROTOCOL *mDevicePathLibDevicePathFromText  = NULL;

+

+/**

+  The constructor function caches the pointer to DevicePathUtilites protocol,

+  DevicePathToText protocol and DevicePathFromText protocol.

+

+  The constructor function locates these three protocols from protocol database.

+  It will caches the pointer to local protocol instance if that operation fails

+  and it will always return EFI_SUCCESS.

+

+  @param  ImageHandle   The firmware allocated handle for the EFI image.

+  @param  SystemTable   A pointer to the EFI System Table.

+

+  @retval EFI_SUCCESS   The constructor always returns EFI_SUCCESS.

+

+**/

+EFI_STATUS

+EFIAPI

+UefiDevicePathLibOptionalDevicePathProtocolConstructor (

+  IN      EFI_HANDLE                ImageHandle,

+  IN      EFI_SYSTEM_TABLE          *SystemTable

+  )

+{

+  EFI_STATUS                        Status;

+

+  Status = gBS->LocateProtocol (

+                  &gEfiDevicePathUtilitiesProtocolGuid,

+                  NULL,

+                  (VOID**) &mDevicePathLibDevicePathUtilities

+                  );

+  ASSERT_EFI_ERROR (Status);

+  ASSERT (mDevicePathLibDevicePathUtilities != NULL);

+  return Status;

+}

+

+/**

+  Returns the size of a device path in bytes.

+

+  This function returns the size, in bytes, of the device path data structure

+  specified by DevicePath including the end of device path node.

+  If DevicePath is NULL or invalid, then 0 is returned.

+

+  @param  DevicePath  A pointer to a device path data structure.

+

+  @retval 0           If DevicePath is NULL or invalid.

+  @retval Others      The size of a device path in bytes.

+

+**/

+UINTN

+EFIAPI

+GetDevicePathSize (

+  IN CONST EFI_DEVICE_PATH_PROTOCOL  *DevicePath

+  )

+{

+  if (mDevicePathLibDevicePathUtilities != NULL) {

+    return mDevicePathLibDevicePathUtilities->GetDevicePathSize (DevicePath);

+  } else {

+    return UefiDevicePathLibGetDevicePathSize (DevicePath);

+  }

+}

+

+/**

+  Creates a new copy of an existing device path.

+

+  This function allocates space for a new copy of the device path specified by DevicePath.

+  If DevicePath is NULL, then NULL is returned.  If the memory is successfully

+  allocated, then the contents of DevicePath are copied to the newly allocated

+  buffer, and a pointer to that buffer is returned.  Otherwise, NULL is returned.

+  The memory for the new device path is allocated from EFI boot services memory.

+  It is the responsibility of the caller to free the memory allocated.

+

+  @param  DevicePath    A pointer to a device path data structure.

+

+  @retval NULL          DevicePath is NULL or invalid.

+  @retval Others        A pointer to the duplicated device path.

+

+**/

+EFI_DEVICE_PATH_PROTOCOL *

+EFIAPI

+DuplicateDevicePath (

+  IN CONST EFI_DEVICE_PATH_PROTOCOL  *DevicePath

+  )

+{

+  if (mDevicePathLibDevicePathUtilities != NULL) {

+    return mDevicePathLibDevicePathUtilities->DuplicateDevicePath (DevicePath);

+  } else {

+    return UefiDevicePathLibDuplicateDevicePath (DevicePath);

+  }

+}

+

+/**

+  Creates a new device path by appending a second device path to a first device path.

+

+  This function creates a new device path by appending a copy of SecondDevicePath

+  to a copy of FirstDevicePath in a newly allocated buffer.  Only the end-of-device-path

+  device node from SecondDevicePath is retained. The newly created device path is

+  returned. If FirstDevicePath is NULL, then it is ignored, and a duplicate of

+  SecondDevicePath is returned.  If SecondDevicePath is NULL, then it is ignored,

+  and a duplicate of FirstDevicePath is returned. If both FirstDevicePath and

+  SecondDevicePath are NULL, then a copy of an end-of-device-path is returned.

+

+  If there is not enough memory for the newly allocated buffer, then NULL is returned.

+  The memory for the new device path is allocated from EFI boot services memory.

+  It is the responsibility of the caller to free the memory allocated.

+

+  @param  FirstDevicePath            A pointer to a device path data structure.

+  @param  SecondDevicePath           A pointer to a device path data structure.

+

+  @retval NULL      If there is not enough memory for the newly allocated buffer.

+  @retval NULL      If FirstDevicePath or SecondDevicePath is invalid.

+  @retval Others    A pointer to the new device path if success.

+                    Or a copy an end-of-device-path if both FirstDevicePath and SecondDevicePath are NULL.

+

+**/

+EFI_DEVICE_PATH_PROTOCOL *

+EFIAPI

+AppendDevicePath (

+  IN CONST EFI_DEVICE_PATH_PROTOCOL  *FirstDevicePath,  OPTIONAL

+  IN CONST EFI_DEVICE_PATH_PROTOCOL  *SecondDevicePath  OPTIONAL

+  )

+{

+  if (mDevicePathLibDevicePathUtilities != NULL) {

+    return mDevicePathLibDevicePathUtilities->AppendDevicePath (FirstDevicePath, SecondDevicePath);

+  } else {

+    return UefiDevicePathLibAppendDevicePath (FirstDevicePath, SecondDevicePath);

+  }

+}

+

+/**

+  Creates a new path by appending the device node to the device path.

+

+  This function creates a new device path by appending a copy of the device node

+  specified by DevicePathNode to a copy of the device path specified by DevicePath

+  in an allocated buffer. The end-of-device-path device node is moved after the

+  end of the appended device node.

+  If DevicePathNode is NULL then a copy of DevicePath is returned.

+  If DevicePath is NULL then a copy of DevicePathNode, followed by an end-of-device

+  path device node is returned.

+  If both DevicePathNode and DevicePath are NULL then a copy of an end-of-device-path

+  device node is returned.

+  If there is not enough memory to allocate space for the new device path, then

+  NULL is returned.

+  The memory is allocated from EFI boot services memory. It is the responsibility

+  of the caller to free the memory allocated.

+

+  @param  DevicePath                 A pointer to a device path data structure.

+  @param  DevicePathNode             A pointer to a single device path node.

+

+  @retval NULL      If there is not enough memory for the new device path.

+  @retval Others    A pointer to the new device path if success.

+                    A copy of DevicePathNode followed by an end-of-device-path node

+                    if both FirstDevicePath and SecondDevicePath are NULL.

+                    A copy of an end-of-device-path node if both FirstDevicePath

+                    and SecondDevicePath are NULL.

+

+**/

+EFI_DEVICE_PATH_PROTOCOL *

+EFIAPI

+AppendDevicePathNode (

+  IN CONST EFI_DEVICE_PATH_PROTOCOL  *DevicePath,     OPTIONAL

+  IN CONST EFI_DEVICE_PATH_PROTOCOL  *DevicePathNode  OPTIONAL

+  )

+{

+  if (mDevicePathLibDevicePathUtilities != NULL) {

+    return mDevicePathLibDevicePathUtilities->AppendDeviceNode (DevicePath, DevicePathNode);

+  } else {

+    return UefiDevicePathLibAppendDevicePathNode (DevicePath, DevicePathNode);

+  }

+}

+

+/**

+  Creates a new device path by appending the specified device path instance to the specified device

+  path.

+

+  This function creates a new device path by appending a copy of the device path

+  instance specified by DevicePathInstance to a copy of the device path specified

+  by DevicePath in a allocated buffer.

+  The end-of-device-path device node is moved after the end of the appended device

+  path instance and a new end-of-device-path-instance node is inserted between.

+  If DevicePath is NULL, then a copy if DevicePathInstance is returned.

+  If DevicePathInstance is NULL, then NULL is returned.

+  If DevicePath or DevicePathInstance is invalid, then NULL is returned.

+  If there is not enough memory to allocate space for the new device path, then

+  NULL is returned.

+  The memory is allocated from EFI boot services memory. It is the responsibility

+  of the caller to free the memory allocated.

+

+  @param  DevicePath                 A pointer to a device path data structure.

+  @param  DevicePathInstance         A pointer to a device path instance.

+

+  @return A pointer to the new device path.

+

+**/

+EFI_DEVICE_PATH_PROTOCOL *

+EFIAPI

+AppendDevicePathInstance (

+  IN CONST EFI_DEVICE_PATH_PROTOCOL  *DevicePath,        OPTIONAL

+  IN CONST EFI_DEVICE_PATH_PROTOCOL  *DevicePathInstance OPTIONAL

+  )

+{

+  if (mDevicePathLibDevicePathUtilities != NULL) {

+    return mDevicePathLibDevicePathUtilities->AppendDevicePathInstance (DevicePath, DevicePathInstance);

+  } else {

+    return UefiDevicePathLibAppendDevicePathInstance (DevicePath, DevicePathInstance);

+  }

+}

+

+/**

+  Creates a copy of the current device path instance and returns a pointer to the next device path

+  instance.

+

+  This function creates a copy of the current device path instance. It also updates

+  DevicePath to point to the next device path instance in the device path (or NULL

+  if no more) and updates Size to hold the size of the device path instance copy.

+  If DevicePath is NULL, then NULL is returned.

+  If DevicePath points to a invalid device path, then NULL is returned.

+  If there is not enough memory to allocate space for the new device path, then

+  NULL is returned.

+  The memory is allocated from EFI boot services memory. It is the responsibility

+  of the caller to free the memory allocated.

+  If Size is NULL, then ASSERT().

+

+  @param  DevicePath                 On input, this holds the pointer to the current

+                                     device path instance. On output, this holds

+                                     the pointer to the next device path instance

+                                     or NULL if there are no more device path

+                                     instances in the device path pointer to a

+                                     device path data structure.

+  @param  Size                       On output, this holds the size of the device

+                                     path instance, in bytes or zero, if DevicePath

+                                     is NULL.

+

+  @return A pointer to the current device path instance.

+

+**/

+EFI_DEVICE_PATH_PROTOCOL *

+EFIAPI

+GetNextDevicePathInstance (

+  IN OUT EFI_DEVICE_PATH_PROTOCOL    **DevicePath,

+  OUT UINTN                          *Size

+  )

+{

+  if (mDevicePathLibDevicePathUtilities != NULL) {

+    return mDevicePathLibDevicePathUtilities->GetNextDevicePathInstance (DevicePath, Size);

+  } else {

+    return UefiDevicePathLibGetNextDevicePathInstance (DevicePath, Size);

+  }

+}

+

+/**

+  Creates a device node.

+

+  This function creates a new device node in a newly allocated buffer of size

+  NodeLength and initializes the device path node header with NodeType and NodeSubType.

+  The new device path node is returned.

+  If NodeLength is smaller than a device path header, then NULL is returned.

+  If there is not enough memory to allocate space for the new device path, then

+  NULL is returned.

+  The memory is allocated from EFI boot services memory. It is the responsibility

+  of the caller to free the memory allocated.

+

+  @param  NodeType                   The device node type for the new device node.

+  @param  NodeSubType                The device node sub-type for the new device node.

+  @param  NodeLength                 The length of the new device node.

+

+  @return The new device path.

+

+**/

+EFI_DEVICE_PATH_PROTOCOL *

+EFIAPI

+CreateDeviceNode (

+  IN UINT8                           NodeType,

+  IN UINT8                           NodeSubType,

+  IN UINT16                          NodeLength

+  )

+{

+  if (mDevicePathLibDevicePathUtilities != NULL) {

+    return mDevicePathLibDevicePathUtilities->CreateDeviceNode (NodeType, NodeSubType, NodeLength);

+  } else {

+    return UefiDevicePathLibCreateDeviceNode (NodeType, NodeSubType, NodeLength);

+  }

+}

+

+/**

+  Determines if a device path is single or multi-instance.

+

+  This function returns TRUE if the device path specified by DevicePath is

+  multi-instance.

+  Otherwise, FALSE is returned.

+  If DevicePath is NULL or invalid, then FALSE is returned.

+

+  @param  DevicePath                 A pointer to a device path data structure.

+

+  @retval  TRUE                      DevicePath is multi-instance.

+  @retval  FALSE                     DevicePath is not multi-instance, or DevicePath

+                                     is NULL or invalid.

+

+**/

+BOOLEAN

+EFIAPI

+IsDevicePathMultiInstance (

+  IN CONST EFI_DEVICE_PATH_PROTOCOL  *DevicePath

+  )

+{

+  if (mDevicePathLibDevicePathUtilities != NULL) {

+    return mDevicePathLibDevicePathUtilities->IsDevicePathMultiInstance (DevicePath);

+  } else {

+    return UefiDevicePathLibIsDevicePathMultiInstance (DevicePath);

+  }

+}

+

+/**

+  Locate and return the protocol instance identified by the ProtocolGuid.

+

+  @param ProtocolGuid     The GUID of the protocol.

+

+  @return A pointer to the protocol instance or NULL when absent.

+**/

+VOID *

+UefiDevicePathLibLocateProtocol (

+  EFI_GUID                         *ProtocolGuid

+  )

+{

+  EFI_STATUS Status;

+  VOID       *Protocol;

+  Status = gBS->LocateProtocol (

+                  ProtocolGuid,

+                  NULL,

+                  (VOID**) &Protocol

+                  );

+  if (EFI_ERROR (Status)) {

+    return NULL;

+  } else {

+    return Protocol;

+  }

+}

+

+/**

+  Converts a device node to its string representation.

+

+  @param DeviceNode        A Pointer to the device node to be converted.

+  @param DisplayOnly       If DisplayOnly is TRUE, then the shorter text representation

+                           of the display node is used, where applicable. If DisplayOnly

+                           is FALSE, then the longer text representation of the display node

+                           is used.

+  @param AllowShortcuts    If AllowShortcuts is TRUE, then the shortcut forms of text

+                           representation for a device node can be used, where applicable.

+

+  @return A pointer to the allocated text representation of the device node or NULL if DeviceNode

+          is NULL or there was insufficient memory.

+

+**/

+CHAR16 *

+EFIAPI

+ConvertDeviceNodeToText (

+  IN CONST EFI_DEVICE_PATH_PROTOCOL  *DeviceNode,

+  IN BOOLEAN                         DisplayOnly,

+  IN BOOLEAN                         AllowShortcuts

+  )

+{

+  if (mDevicePathLibDevicePathToText == NULL) {

+    mDevicePathLibDevicePathToText = UefiDevicePathLibLocateProtocol (&gEfiDevicePathToTextProtocolGuid);

+  }

+  if (mDevicePathLibDevicePathToText != NULL) {

+    return mDevicePathLibDevicePathToText->ConvertDeviceNodeToText (DeviceNode, DisplayOnly, AllowShortcuts);

+  }

+

+  return UefiDevicePathLibConvertDeviceNodeToText (DeviceNode, DisplayOnly, AllowShortcuts);

+}

+

+/**

+  Converts a device path to its text representation.

+

+  @param DevicePath      A Pointer to the device to be converted.

+  @param DisplayOnly     If DisplayOnly is TRUE, then the shorter text representation

+                         of the display node is used, where applicable. If DisplayOnly

+                         is FALSE, then the longer text representation of the display node

+                         is used.

+  @param AllowShortcuts  If AllowShortcuts is TRUE, then the shortcut forms of text

+                         representation for a device node can be used, where applicable.

+

+  @return A pointer to the allocated text representation of the device path or

+          NULL if DeviceNode is NULL or there was insufficient memory.

+

+**/

+CHAR16 *

+EFIAPI

+ConvertDevicePathToText (

+  IN CONST EFI_DEVICE_PATH_PROTOCOL   *DevicePath,

+  IN BOOLEAN                          DisplayOnly,

+  IN BOOLEAN                          AllowShortcuts

+  )

+{

+  if (mDevicePathLibDevicePathToText == NULL) {

+    mDevicePathLibDevicePathToText = UefiDevicePathLibLocateProtocol (&gEfiDevicePathToTextProtocolGuid);

+  }

+  if (mDevicePathLibDevicePathToText != NULL) {

+    return mDevicePathLibDevicePathToText->ConvertDevicePathToText (DevicePath, DisplayOnly, AllowShortcuts);

+  }

+

+  return UefiDevicePathLibConvertDevicePathToText (DevicePath, DisplayOnly, AllowShortcuts);

+}

+

+/**

+  Convert text to the binary representation of a device node.

+

+  @param TextDeviceNode  TextDeviceNode points to the text representation of a device

+                         node. Conversion starts with the first character and continues

+                         until the first non-device node character.

+

+  @return A pointer to the EFI device node or NULL if TextDeviceNode is NULL or there was

+          insufficient memory or text unsupported.

+

+**/

+EFI_DEVICE_PATH_PROTOCOL *

+EFIAPI

+ConvertTextToDeviceNode (

+  IN CONST CHAR16 *TextDeviceNode

+  )

+{

+  if (mDevicePathLibDevicePathFromText == NULL) {

+    mDevicePathLibDevicePathFromText = UefiDevicePathLibLocateProtocol (&gEfiDevicePathFromTextProtocolGuid);

+  }

+  if (mDevicePathLibDevicePathFromText != NULL) {

+    return mDevicePathLibDevicePathFromText->ConvertTextToDeviceNode (TextDeviceNode);

+  }

+

+  return UefiDevicePathLibConvertTextToDeviceNode (TextDeviceNode);

+}

+

+/**

+  Convert text to the binary representation of a device path.

+

+

+  @param TextDevicePath  TextDevicePath points to the text representation of a device

+                         path. Conversion starts with the first character and continues

+                         until the first non-device node character.

+

+  @return A pointer to the allocated device path or NULL if TextDeviceNode is NULL or

+          there was insufficient memory.

+

+**/

+EFI_DEVICE_PATH_PROTOCOL *

+EFIAPI

+ConvertTextToDevicePath (

+  IN CONST CHAR16 *TextDevicePath

+  )

+{

+  if (mDevicePathLibDevicePathFromText == NULL) {

+    mDevicePathLibDevicePathFromText = UefiDevicePathLibLocateProtocol (&gEfiDevicePathFromTextProtocolGuid);

+  }

+  if (mDevicePathLibDevicePathFromText != NULL) {

+    return mDevicePathLibDevicePathFromText->ConvertTextToDevicePath (TextDevicePath);

+  }

+

+  return UefiDevicePathLibConvertTextToDevicePath (TextDevicePath);

+}

+

diff --git a/debugging_demo/memtest86+/efi/Include/src/UefiLib/Acpi.c b/debugging_demo/memtest86+/efi/Include/src/UefiLib/Acpi.c
new file mode 100644
index 0000000..ae0ad01
--- /dev/null
+++ b/debugging_demo/memtest86+/efi/Include/src/UefiLib/Acpi.c
@@ -0,0 +1,421 @@
+/** @file

+  This module provides help function for finding ACPI table.

+

+  Copyright (c) 2018, Intel Corporation. All rights reserved.<BR>

+  SPDX-License-Identifier: BSD-2-Clause-Patent

+

+**/

+

+#include "UefiLibInternal.h"

+#include <IndustryStandard/Acpi.h>

+

+/**

+  This function scans ACPI table in XSDT/RSDT.

+

+  @param Sdt                    ACPI XSDT/RSDT.

+  @param TablePointerSize       Size of table pointer: 8(XSDT) or 4(RSDT).

+  @param Signature              ACPI table signature.

+  @param PreviousTable          Pointer to previous returned table to locate

+                                next table, or NULL to locate first table.

+  @param PreviousTableLocated   Pointer to the indicator about whether the

+                                previous returned table could be located, or

+                                NULL if PreviousTable is NULL.

+

+  If PreviousTable is NULL and PreviousTableLocated is not NULL, then ASSERT().

+  If PreviousTable is not NULL and PreviousTableLocated is NULL, then ASSERT().

+

+  @return ACPI table or NULL if not found.

+

+**/

+EFI_ACPI_COMMON_HEADER *

+ScanTableInSDT (

+  IN  EFI_ACPI_DESCRIPTION_HEADER   *Sdt,

+  IN  UINTN                         TablePointerSize,

+  IN  UINT32                        Signature,

+  IN  EFI_ACPI_COMMON_HEADER        *PreviousTable, OPTIONAL

+  OUT BOOLEAN                       *PreviousTableLocated OPTIONAL

+  )

+{

+  UINTN                             Index;

+  UINTN                             EntryCount;

+  UINT64                            EntryPtr;

+  UINTN                             BasePtr;

+  EFI_ACPI_COMMON_HEADER            *Table;

+

+  if (PreviousTableLocated != NULL) {

+    ASSERT (PreviousTable != NULL);

+    *PreviousTableLocated = FALSE;

+  } else {

+    ASSERT (PreviousTable == NULL);

+  }

+

+  if (Sdt == NULL) {

+    return NULL;

+  }

+

+  EntryCount = (Sdt->Length - sizeof (EFI_ACPI_DESCRIPTION_HEADER)) / TablePointerSize;

+

+  BasePtr = (UINTN)(Sdt + 1);

+  for (Index = 0; Index < EntryCount; Index ++) {

+    EntryPtr = 0;

+    CopyMem (&EntryPtr, (VOID *)(BasePtr + Index * TablePointerSize), TablePointerSize);

+    Table = (EFI_ACPI_COMMON_HEADER *)((UINTN)(EntryPtr));

+    if ((Table != NULL) && (Table->Signature == Signature)) {

+      if (PreviousTable != NULL) {

+        if (Table == PreviousTable) {

+          *PreviousTableLocated = TRUE;

+        } else if (*PreviousTableLocated) {

+          //

+          // Return next table.

+          //

+          return Table;

+        }

+      } else {

+        //

+        // Return first table.

+        //

+        return Table;

+      }

+

+    }

+  }

+

+  return NULL;

+}

+

+/**

+  To locate FACS in FADT.

+

+  @param Fadt   FADT table pointer.

+

+  @return FACS table pointer or NULL if not found.

+

+**/

+EFI_ACPI_COMMON_HEADER *

+LocateAcpiFacsFromFadt (

+  IN EFI_ACPI_2_0_FIXED_ACPI_DESCRIPTION_TABLE  *Fadt

+  )

+{

+  EFI_ACPI_COMMON_HEADER                        *Facs;

+  UINT64                                        Data64;

+

+  if (Fadt == NULL) {

+    return NULL;

+  }

+

+  if (Fadt->Header.Revision < EFI_ACPI_2_0_FIXED_ACPI_DESCRIPTION_TABLE_REVISION) {

+    Facs = (EFI_ACPI_COMMON_HEADER *)(UINTN)Fadt->FirmwareCtrl;

+  } else {

+    CopyMem (&Data64, &Fadt->XFirmwareCtrl, sizeof(UINT64));

+    if (Data64 != 0) {

+      Facs = (EFI_ACPI_COMMON_HEADER *)(UINTN)Data64;

+    } else {

+      Facs = (EFI_ACPI_COMMON_HEADER *)(UINTN)Fadt->FirmwareCtrl;

+    }

+  }

+  return Facs;

+}

+

+/**

+  To locate DSDT in FADT.

+

+  @param Fadt   FADT table pointer.

+

+  @return DSDT table pointer or NULL if not found.

+

+**/

+EFI_ACPI_COMMON_HEADER *

+LocateAcpiDsdtFromFadt (

+  IN EFI_ACPI_2_0_FIXED_ACPI_DESCRIPTION_TABLE  *Fadt

+  )

+{

+  EFI_ACPI_COMMON_HEADER                        *Dsdt;

+  UINT64                                        Data64;

+

+  if (Fadt == NULL) {

+    return NULL;

+  }

+

+  if (Fadt->Header.Revision < EFI_ACPI_2_0_FIXED_ACPI_DESCRIPTION_TABLE_REVISION) {

+    Dsdt = (EFI_ACPI_COMMON_HEADER *)(UINTN)Fadt->Dsdt;

+  } else {

+    CopyMem (&Data64, &Fadt->XDsdt, sizeof(UINT64));

+    if (Data64 != 0) {

+      Dsdt = (EFI_ACPI_COMMON_HEADER *)(UINTN)Data64;

+    } else {

+      Dsdt = (EFI_ACPI_COMMON_HEADER *)(UINTN)Fadt->Dsdt;

+    }

+  }

+  return Dsdt;

+}

+

+/**

+  To locate ACPI table in ACPI ConfigurationTable.

+

+  @param AcpiGuid               The GUID used to get ACPI ConfigurationTable.

+  @param Signature              ACPI table signature.

+  @param PreviousTable          Pointer to previous returned table to locate

+                                next table, or NULL to locate first table.

+  @param PreviousTableLocated   Pointer to the indicator to return whether the

+                                previous returned table could be located or not,

+                                or NULL if PreviousTable is NULL.

+

+  If PreviousTable is NULL and PreviousTableLocated is not NULL, then ASSERT().

+  If PreviousTable is not NULL and PreviousTableLocated is NULL, then ASSERT().

+  If AcpiGuid is NULL, then ASSERT().

+

+  @return ACPI table or NULL if not found.

+

+**/

+EFI_ACPI_COMMON_HEADER *

+LocateAcpiTableInAcpiConfigurationTable (

+  IN  EFI_GUID                  *AcpiGuid,

+  IN  UINT32                    Signature,

+  IN  EFI_ACPI_COMMON_HEADER    *PreviousTable, OPTIONAL

+  OUT BOOLEAN                   *PreviousTableLocated OPTIONAL

+  )

+{

+  EFI_STATUS                                    Status;

+  EFI_ACPI_COMMON_HEADER                        *Table;

+  EFI_ACPI_2_0_ROOT_SYSTEM_DESCRIPTION_POINTER  *Rsdp;

+  EFI_ACPI_DESCRIPTION_HEADER                   *Rsdt;

+  EFI_ACPI_DESCRIPTION_HEADER                   *Xsdt;

+  EFI_ACPI_2_0_FIXED_ACPI_DESCRIPTION_TABLE     *Fadt;

+

+  if (PreviousTableLocated != NULL) {

+    ASSERT (PreviousTable != NULL);

+    *PreviousTableLocated = FALSE;

+  } else {

+    ASSERT (PreviousTable == NULL);

+  }

+

+  Rsdp = NULL;

+  //

+  // Get ACPI ConfigurationTable (RSD_PTR)

+  //

+  Status = EfiGetSystemConfigurationTable(AcpiGuid, (VOID **)&Rsdp);

+  if (EFI_ERROR (Status) || (Rsdp == NULL)) {

+    return NULL;

+  }

+

+  Table = NULL;

+

+  //

+  // Search XSDT

+  //

+  if (Rsdp->Revision >= EFI_ACPI_2_0_ROOT_SYSTEM_DESCRIPTION_POINTER_REVISION) {

+    Xsdt = (EFI_ACPI_DESCRIPTION_HEADER *)(UINTN) Rsdp->XsdtAddress;

+    if (Signature == EFI_ACPI_2_0_DIFFERENTIATED_SYSTEM_DESCRIPTION_TABLE_SIGNATURE) {

+      ASSERT (PreviousTable == NULL);

+      //

+      // It is to locate DSDT,

+      // need to locate FADT first.

+      //

+      Fadt = (EFI_ACPI_2_0_FIXED_ACPI_DESCRIPTION_TABLE *) ScanTableInSDT (

+               Xsdt,

+               sizeof (UINT64),

+               EFI_ACPI_2_0_FIXED_ACPI_DESCRIPTION_TABLE_SIGNATURE,

+               NULL,

+               NULL

+               );

+      Table = LocateAcpiDsdtFromFadt (Fadt);

+    } else if (Signature == EFI_ACPI_2_0_FIRMWARE_ACPI_CONTROL_STRUCTURE_SIGNATURE) {

+      ASSERT (PreviousTable == NULL);

+      //

+      // It is to locate FACS,

+      // need to locate FADT first.

+      //

+      Fadt = (EFI_ACPI_2_0_FIXED_ACPI_DESCRIPTION_TABLE *) ScanTableInSDT (

+               Xsdt,

+               sizeof (UINT64),

+               EFI_ACPI_2_0_FIXED_ACPI_DESCRIPTION_TABLE_SIGNATURE,

+               NULL,

+               NULL

+               );

+      Table = LocateAcpiFacsFromFadt (Fadt);

+    } else {

+      Table = ScanTableInSDT (

+                Xsdt,

+                sizeof (UINT64),

+                Signature,

+                PreviousTable,

+                PreviousTableLocated

+                );

+    }

+  }

+

+  if (Table != NULL) {

+    return Table;

+  } else if ((PreviousTableLocated != NULL) &&

+              *PreviousTableLocated) {

+    //

+    // PreviousTable could be located in XSDT,

+    // but next table could not be located in XSDT.

+    //

+    return NULL;

+  }

+

+  //

+  // Search RSDT

+  //

+  Rsdt = (EFI_ACPI_DESCRIPTION_HEADER *)(UINTN) Rsdp->RsdtAddress;

+  if (Signature == EFI_ACPI_2_0_DIFFERENTIATED_SYSTEM_DESCRIPTION_TABLE_SIGNATURE) {

+    ASSERT (PreviousTable == NULL);

+    //

+    // It is to locate DSDT,

+    // need to locate FADT first.

+    //

+    Fadt = (EFI_ACPI_2_0_FIXED_ACPI_DESCRIPTION_TABLE *) ScanTableInSDT (

+             Rsdt,

+             sizeof (UINT32),

+             EFI_ACPI_2_0_FIXED_ACPI_DESCRIPTION_TABLE_SIGNATURE,

+             NULL,

+             NULL

+             );

+    Table = LocateAcpiDsdtFromFadt (Fadt);

+  } else if (Signature == EFI_ACPI_2_0_FIRMWARE_ACPI_CONTROL_STRUCTURE_SIGNATURE) {

+    ASSERT (PreviousTable == NULL);

+    //

+    // It is to locate FACS,

+    // need to locate FADT first.

+    //

+    Fadt = (EFI_ACPI_2_0_FIXED_ACPI_DESCRIPTION_TABLE *) ScanTableInSDT (

+             Rsdt,

+             sizeof (UINT32),

+             EFI_ACPI_2_0_FIXED_ACPI_DESCRIPTION_TABLE_SIGNATURE,

+             NULL,

+             NULL

+             );

+    Table = LocateAcpiFacsFromFadt (Fadt);

+  } else {

+    Table = ScanTableInSDT (

+              Rsdt,

+              sizeof (UINT32),

+              Signature,

+              PreviousTable,

+              PreviousTableLocated

+              );

+  }

+

+  return Table;

+}

+

+/**

+  This function locates next ACPI table in XSDT/RSDT based on Signature and

+  previous returned Table.

+

+  If PreviousTable is NULL:

+  This function will locate the first ACPI table in XSDT/RSDT based on

+  Signature in gEfiAcpi20TableGuid system configuration table first, and then

+  gEfiAcpi10TableGuid system configuration table.

+  This function will locate in XSDT first, and then RSDT.

+  For DSDT, this function will locate XDsdt in FADT first, and then Dsdt in

+  FADT.

+  For FACS, this function will locate XFirmwareCtrl in FADT first, and then

+  FirmwareCtrl in FADT.

+

+  If PreviousTable is not NULL:

+  1. If it could be located in XSDT in gEfiAcpi20TableGuid system configuration

+     table, then this function will just locate next table in XSDT in

+     gEfiAcpi20TableGuid system configuration table.

+  2. If it could be located in RSDT in gEfiAcpi20TableGuid system configuration

+     table, then this function will just locate next table in RSDT in

+     gEfiAcpi20TableGuid system configuration table.

+  3. If it could be located in RSDT in gEfiAcpi10TableGuid system configuration

+     table, then this function will just locate next table in RSDT in

+     gEfiAcpi10TableGuid system configuration table.

+

+  It's not supported that PreviousTable is not NULL but PreviousTable->Signature

+  is not same with Signature, NULL will be returned.

+

+  @param Signature          ACPI table signature.

+  @param PreviousTable      Pointer to previous returned table to locate next

+                            table, or NULL to locate first table.

+

+  @return Next ACPI table or NULL if not found.

+

+**/

+EFI_ACPI_COMMON_HEADER *

+EFIAPI

+EfiLocateNextAcpiTable (

+  IN UINT32                     Signature,

+  IN EFI_ACPI_COMMON_HEADER     *PreviousTable OPTIONAL

+  )

+{

+  EFI_ACPI_COMMON_HEADER        *Table;

+  BOOLEAN                       TempPreviousTableLocated;

+  BOOLEAN                       *PreviousTableLocated;

+

+  if (PreviousTable != NULL) {

+    if (PreviousTable->Signature != Signature) {

+      //

+      // PreviousTable->Signature is not same with Signature.

+      //

+      return NULL;

+    } else if ((Signature == EFI_ACPI_2_0_FIXED_ACPI_DESCRIPTION_TABLE_SIGNATURE) ||

+               (Signature == EFI_ACPI_2_0_DIFFERENTIATED_SYSTEM_DESCRIPTION_TABLE_SIGNATURE) ||

+               (Signature == EFI_ACPI_2_0_FIRMWARE_ACPI_CONTROL_STRUCTURE_SIGNATURE)) {

+      //

+      // There is only one FADT/DSDT/FACS table,

+      // so don't try to locate next one.

+      //

+      return NULL;

+    }

+

+    PreviousTableLocated = &TempPreviousTableLocated;

+    *PreviousTableLocated = FALSE;

+  } else {

+    PreviousTableLocated = NULL;

+  }

+

+  Table = LocateAcpiTableInAcpiConfigurationTable (

+            &gEfiAcpi20TableGuid,

+            Signature,

+            PreviousTable,

+            PreviousTableLocated

+            );

+  if (Table != NULL) {

+    return Table;

+  } else if ((PreviousTableLocated != NULL) &&

+              *PreviousTableLocated) {

+    //

+    // PreviousTable could be located in gEfiAcpi20TableGuid system

+    // configuration table, but next table could not be located in

+    // gEfiAcpi20TableGuid system configuration table.

+    //

+    return NULL;

+  }

+

+  return LocateAcpiTableInAcpiConfigurationTable (

+           &gEfiAcpi10TableGuid,

+           Signature,

+           PreviousTable,

+           PreviousTableLocated

+           );

+}

+

+/**

+  This function locates first ACPI table in XSDT/RSDT based on Signature.

+

+  This function will locate the first ACPI table in XSDT/RSDT based on

+  Signature in gEfiAcpi20TableGuid system configuration table first, and then

+  gEfiAcpi10TableGuid system configuration table.

+  This function will locate in XSDT first, and then RSDT.

+  For DSDT, this function will locate XDsdt in FADT first, and then Dsdt in

+  FADT.

+  For FACS, this function will locate XFirmwareCtrl in FADT first, and then

+  FirmwareCtrl in FADT.

+

+  @param Signature          ACPI table signature.

+

+  @return First ACPI table or NULL if not found.

+

+**/

+EFI_ACPI_COMMON_HEADER *

+EFIAPI

+EfiLocateFirstAcpiTable (

+  IN UINT32                     Signature

+  )

+{

+  return EfiLocateNextAcpiTable (Signature, NULL);

+}

diff --git a/debugging_demo/memtest86+/efi/Include/src/UefiLib/Console.c b/debugging_demo/memtest86+/efi/Include/src/UefiLib/Console.c
new file mode 100644
index 0000000..17ec31c
--- /dev/null
+++ b/debugging_demo/memtest86+/efi/Include/src/UefiLib/Console.c
@@ -0,0 +1,566 @@
+/** @file

+  This module provide help function for displaying unicode string.

+

+  Copyright (c) 2006 - 2018, Intel Corporation. All rights reserved.<BR>

+  SPDX-License-Identifier: BSD-2-Clause-Patent

+

+**/

+

+

+

+

+#include "UefiLibInternal.h"

+

+typedef struct {

+  CHAR16  WChar;

+  UINT32  Width;

+} UNICODE_WIDTH_ENTRY;

+

+#define NARROW_CHAR         0xFFF0

+#define WIDE_CHAR           0xFFF1

+

+GLOBAL_REMOVE_IF_UNREFERENCED CONST UNICODE_WIDTH_ENTRY mUnicodeWidthTable[] = {

+  //

+  // General script area

+  //

+  {(CHAR16)0x1FFF,  1},

+  /*

+   * Merge the blocks and replace them with the above entry as they fall to

+   * the same category and they are all narrow glyph. This will reduce search

+   * time and table size. The merge will omit the reserved code.

+   *

+   * Remove the above item if below is un-commented.

+   *

+  {(CHAR16)0x007F,  1},       // C0 controls and basic Latin. 0x0000-0x007F

+  {(CHAR16)0x00FF,  1},       // C1 controls and Latin-1 support. 0x0080-0x00FF

+  {(CHAR16)0x017F,  1},       // Latin extended-A. 0x0100-0x017F

+  {(CHAR16)0x024F,  1},       // Latin extended-B. 0x0180-0x024F

+  {(CHAR16)0x02AF,  1},       // IPA extensions. 0x0250-0x02AF

+  {(CHAR16)0x02FF,  1},       // Spacing modifier letters. 0x02B0-0x02FF

+  {(CHAR16)0x036F,  1},       // Combining diacritical marks. 0x0300-0x036F

+  {(CHAR16)0x03FF,  1},       // Greek. 0x0370-0x03FF

+  {(CHAR16)0x04FF,  1},       // Cyrillic. 0x0400-0x04FF

+  {(CHAR16)0x052F,  0},       // Unassigned. As Armenian in ver3.0. 0x0500-0x052F

+  {(CHAR16)0x058F,  1},       // Armenian. 0x0530-0x058F

+  {(CHAR16)0x05FF,  1},       // Hebrew. 0x0590-0x05FF

+  {(CHAR16)0x06FF,  1},       // Arabic. 0x0600-0x06FF

+  {(CHAR16)0x08FF,  0},       // Unassigned. 0x0700-0x08FF

+  {(CHAR16)0x097F,  1},       // Devanagari. 0x0900-0x097F

+  {(CHAR16)0x09FF,  1},       // Bengali. 0x0980-0x09FF

+  {(CHAR16)0x0A7F,  1},       // Gurmukhi. 0x0A00-0x0A7F

+  {(CHAR16)0x0AFF,  1},       // Gujarati. 0x0A80-0x0AFF

+  {(CHAR16)0x0B7F,  1},       // Oriya. 0x0B00-0x0B7F

+  {(CHAR16)0x0BFF,  1},       // Tamil. (See page 7-92). 0x0B80-0x0BFF

+  {(CHAR16)0x0C7F,  1},       // Telugu. 0x0C00-0x0C7F

+  {(CHAR16)0x0CFF,  1},       // Kannada. (See page 7-100). 0x0C80-0x0CFF

+  {(CHAR16)0x0D7F,  1},       // Malayalam (See page 7-104). 0x0D00-0x0D7F

+  {(CHAR16)0x0DFF,  0},       // Unassigned. 0x0D80-0x0DFF

+  {(CHAR16)0x0E7F,  1},       // Thai. 0x0E00-0x0E7F

+  {(CHAR16)0x0EFF,  1},       // Lao. 0x0E80-0x0EFF

+  {(CHAR16)0x0FBF,  1},       // Tibetan. 0x0F00-0x0FBF

+  {(CHAR16)0x109F,  0},       // Unassigned. 0x0FC0-0x109F

+  {(CHAR16)0x10FF,  1},       // Georgian. 0x10A0-0x10FF

+  {(CHAR16)0x11FF,  1},       // Hangul Jamo. 0x1100-0x11FF

+  {(CHAR16)0x1DFF,  0},       // Unassigned. 0x1200-0x1DFF

+  {(CHAR16)0x1EFF,  1},       // Latin extended additional. 0x1E00-0x1EFF

+  {(CHAR16)0x1FFF,  1},       // Greek extended. 0x1F00-0x1FFF

+  *

+  */

+

+  //

+  // Symbol area

+  //

+  {(CHAR16)0x2FFF,  1},

+  /*

+   * Merge the blocks and replace them with the above entry as they fall to

+   * the same category and they are all narrow glyph. This will reduce search

+   * time and table size. The merge will omit the reserved code.

+   *

+   * Remove the above item if below is un-commented.

+   *

+  {(CHAR16)0x206F,  1},       // General punctuation. (See page7-154). 0x200-0x206F

+  {(CHAR16)0x209F,  1},       // Superscripts and subscripts. 0x2070-0x209F

+  {(CHAR16)0x20CF,  1},       // Currency symbols. 0x20A0-0x20CF

+  {(CHAR16)0x20FF,  1},       // Combining diacritical marks for symbols. 0x20D0-0x20FF

+  {(CHAR16)0x214F,  1},       // Letterlike sympbols. 0x2100-0x214F

+  {(CHAR16)0x218F,  1},       // Number forms. 0x2150-0x218F

+  {(CHAR16)0x21FF,  1},       // Arrows. 0x2190-0x21FF

+  {(CHAR16)0x22FF,  1},       // Mathematical operators. 0x2200-0x22FF

+  {(CHAR16)0x23FF,  1},       // Miscellaneous technical. 0x2300-0x23FF

+  {(CHAR16)0x243F,  1},       // Control pictures. 0x2400-0x243F

+  {(CHAR16)0x245F,  1},       // Optical character recognition. 0x2440-0x245F

+  {(CHAR16)0x24FF,  1},       // Enclosed alphanumerics. 0x2460-0x24FF

+  {(CHAR16)0x257F,  1},       // Box drawing. 0x2500-0x257F

+  {(CHAR16)0x259F,  1},       // Block elements. 0x2580-0x259F

+  {(CHAR16)0x25FF,  1},       // Geometric shapes. 0x25A0-0x25FF

+  {(CHAR16)0x26FF,  1},       // Miscellaneous symbols. 0x2600-0x26FF

+  {(CHAR16)0x27BF,  1},       // Dingbats. 0x2700-0x27BF

+  {(CHAR16)0x2FFF,  0},       // Reserved. 0x27C0-0x2FFF

+  *

+  */

+

+  //

+  // CJK phonetics and symbol area

+  //

+  {(CHAR16)0x33FF,  2},

+  /*

+   * Merge the blocks and replace them with the above entry as they fall to

+   * the same category and they are all wide glyph. This will reduce search

+   * time and table size. The merge will omit the reserved code.

+   *

+   * Remove the above item if below is un-commented.

+   *

+  {(CHAR16)0x303F,  2},       // CJK symbols and punctuation. 0x3000-0x303F

+  {(CHAR16)0x309F,  2},       // Hiragana. 0x3040-0x309F

+  {(CHAR16)0x30FF,  2},       // Katakana. 0x30A0-0x30FF

+  {(CHAR16)0x312F,  2},       // Bopomofo. 0x3100-0x312F

+  {(CHAR16)0x318F,  2},       // Hangul compatibility jamo. 0x3130-0x318F

+  {(CHAR16)0x319F,  2},       // Kanbun. 0x3190-0x319F

+  {(CHAR16)0x31FF,  0},       // Reserved. As Bopomofo extended in ver3.0. 0x31A0-0x31FF

+  {(CHAR16)0x32FF,  2},       // Enclosed CJK letters and months. 0x3200-0x32FF

+  {(CHAR16)0x33FF,  2},       // CJK compatibility. 0x3300-0x33FF

+  *

+  */

+

+  //

+  // CJK ideograph area

+  //

+  {(CHAR16)0x9FFF,  2},

+  /*

+   * Merge the blocks and replace them with the above entry as they fall to

+   * the same category and they are all wide glyph. This will reduce search

+   * time and table size. The merge will omit the reserved code.

+   *

+   * Remove the above item if below is un-commented.

+   *

+  {(CHAR16)0x4DFF,  0},       // Reserved. 0x3400-0x4DBF as CJK unified ideographs

+                      // extension A in ver3.0. 0x3400-0x4DFF

+  {(CHAR16)0x9FFF,  2},       // CJK unified ideographs. 0x4E00-0x9FFF

+  *

+  */

+

+  //

+  // Reserved

+  //

+  {(CHAR16)0xABFF,  0},       // Reserved. 0xA000-0xA490 as Yi syllables. 0xA490-0xA4D0

+  // as Yi radicals in ver3.0. 0xA000-0xABFF

+  //

+  // Hangul syllables

+  //

+  {(CHAR16)0xD7FF,  2},

+  /*

+   * Merge the blocks and replace them with the above entry as they fall to

+   * the same category and they are all wide glyph. This will reduce search

+   * time and table size. The merge will omit the reserved code.

+   *

+   * Remove the above item if below is un-commented.

+   *

+  {(CHAR16)0xD7A3,  2},       // Hangul syllables. 0xAC00-0xD7A3

+  {(CHAR16)0xD7FF,  0},       // Reserved. 0xD7A3-0xD7FF

+  *

+  */

+

+  //

+  // Surrogates area

+  //

+  {(CHAR16)0xDFFF,  0},       // Surrogates, not used now. 0xD800-0xDFFF

+

+  //

+  // Private use area

+  //

+  {(CHAR16)0xF8FF,  0},       // Private use area. 0xE000-0xF8FF

+

+  //

+  // Compatibility area and specials

+  //

+  {(CHAR16)0xFAFF,  2},       // CJK compatibility ideographs. 0xF900-0xFAFF

+  {(CHAR16)0xFB4F,  1},       // Alphabetic presentation forms. 0xFB00-0xFB4F

+  {(CHAR16)0xFDFF,  1},       // Arabic presentation forms-A. 0xFB50-0xFDFF

+  {(CHAR16)0xFE1F,  0},       // Reserved. As variation selectors in ver3.0. 0xFE00-0xFE1F

+  {(CHAR16)0xFE2F,  1},       // Combining half marks. 0xFE20-0xFE2F

+  {(CHAR16)0xFE4F,  2},       // CJK compatibility forms. 0xFE30-0xFE4F

+  {(CHAR16)0xFE6F,  1},       // Small Form Variants. 0xFE50-0xFE6F

+  {(CHAR16)0xFEFF,  1},       // Arabic presentation forms-B. 0xFE70-0xFEFF

+  {(CHAR16)0xFFEF,  1},       // Half width and full width forms. 0xFF00-0xFFEF

+  {(CHAR16)0xFFFF,  0},       // Speicials. 0xFFF0-0xFFFF

+};

+

+/**

+  Retrieves the width of a Unicode character.

+

+  This function computes and returns the width of the Unicode character specified

+  by UnicodeChar.

+

+  @param  UnicodeChar   A Unicode character.

+

+  @retval 0             The width if UnicodeChar could not be determined.

+  @retval 1             UnicodeChar is a narrow glyph.

+  @retval 2             UnicodeChar is a wide glyph.

+

+**/

+UINTN

+EFIAPI

+GetGlyphWidth (

+  IN CHAR16  UnicodeChar

+  )

+{

+  UINTN                     Index;

+  UINTN                     Low;

+  UINTN                     High;

+  CONST UNICODE_WIDTH_ENTRY *Item;

+

+  Item  = NULL;

+  Low   = 0;

+  High  = (sizeof (mUnicodeWidthTable)) / (sizeof (UNICODE_WIDTH_ENTRY)) - 1;

+  while (Low <= High) {

+    Index = (Low + High) >> 1;

+    Item  = &(mUnicodeWidthTable[Index]);

+    if (Index == 0) {

+      if (UnicodeChar <= Item->WChar) {

+        break;

+      }

+

+      return 0;

+    }

+

+    if (UnicodeChar > Item->WChar) {

+      Low = Index + 1;

+    } else if (UnicodeChar <= mUnicodeWidthTable[Index - 1].WChar) {

+      High = Index - 1;

+    } else {

+      //

+      // Index - 1 < UnicodeChar <= Index. Found

+      //

+      break;

+    }

+  }

+

+  if (Low <= High) {

+    return Item->Width;

+  }

+

+  return 0;

+}

+

+/**

+  Computes the display length of a Null-terminated Unicode String.

+

+  This function computes and returns the display length of the Null-terminated

+  Unicode string specified by String.  If String is NULL then 0 is returned. If

+  any of the widths of the Unicode characters in String can not be determined,

+  then 0 is returned. The display width of String can be computed by summing the

+  display widths of each Unicode character in String.  Unicode characters that

+  are narrow glyphs have a width of 1, and Unicode characters that are width glyphs

+  have a width of 2.  If String is not aligned on a 16-bit boundary, then ASSERT().

+

+  @param  String      A pointer to a Null-terminated Unicode string.

+

+  @return The display length of the Null-terminated Unicode string specified by String.

+

+**/

+UINTN

+EFIAPI

+UnicodeStringDisplayLength (

+  IN CONST CHAR16  *String

+  )

+{

+  UINTN      Length;

+  UINTN      Width;

+

+  if (String == NULL) {

+    return 0;

+  }

+

+  Length = 0;

+  while (*String != 0) {

+    Width = GetGlyphWidth (*String);

+    if (Width == 0) {

+      return 0;

+    }

+

+    Length += Width;

+    String++;

+  }

+

+  return Length;

+}

+

+/**

+  Count the storage space of a Unicode string.

+

+  This function handles the Unicode string with NARROW_CHAR

+  and WIDE_CHAR control characters. NARROW_HCAR and WIDE_CHAR

+  does not count in the resultant output. If a WIDE_CHAR is

+  hit, then 2 Unicode character will consume an output storage

+  space with size of CHAR16 till a NARROW_CHAR is hit.

+

+  @param String          The input string to be counted.

+  @param LimitLen        Whether need to limit the string length.

+  @param MaxWidth        The max length this function supported.

+  @param Offset          The max index of the string can be show out.

+

+  @return Storage space for the input string.

+

+**/

+UINTN

+UefiLibGetStringWidth (

+  IN  CHAR16               *String,

+  IN  BOOLEAN              LimitLen,

+  IN  UINTN                MaxWidth,

+  OUT UINTN                *Offset

+  )

+{

+  UINTN Index;

+  UINTN Count;

+  UINTN IncrementValue;

+

+  if (String == NULL) {

+    return 0;

+  }

+

+  Index           = 0;

+  Count           = 0;

+  IncrementValue  = 1;

+

+  do {

+    //

+    // Advance to the null-terminator or to the first width directive

+    //

+    for (;(String[Index] != NARROW_CHAR) && (String[Index] != WIDE_CHAR) && (String[Index] != 0); Index++) {

+      Count = Count + IncrementValue;

+

+      if (LimitLen && Count > MaxWidth) {

+        break;

+      }

+    }

+

+    //

+    // We hit the null-terminator, we now have a count

+    //

+    if (String[Index] == 0) {

+      break;

+    }

+

+    if (LimitLen && Count > MaxWidth) {

+      *Offset = Index;

+      break;

+    }

+

+    //

+    // We encountered a narrow directive - strip it from the size calculation since it doesn't get printed

+    // and also set the flag that determines what we increment by.(if narrow, increment by 1, if wide increment by 2)

+    //

+    if (String[Index] == NARROW_CHAR) {

+      //

+      // Skip to the next character

+      //

+      Index++;

+      IncrementValue = 1;

+    } else {

+      //

+      // Skip to the next character

+      //

+      Index++;

+      IncrementValue = 2;

+    }

+  } while (String[Index] != 0);

+

+  return Count * sizeof (CHAR16);

+}

+

+/**

+  Draws a dialog box to the console output device specified by

+  ConOut defined in the EFI_SYSTEM_TABLE and waits for a keystroke

+  from the console input device specified by ConIn defined in the

+  EFI_SYSTEM_TABLE.

+

+  If there are no strings in the variable argument list, then ASSERT().

+  If all the strings in the variable argument list are empty, then ASSERT().

+

+  @param[in]   Attribute  Specifies the foreground and background color of the popup.

+  @param[out]  Key        A pointer to the EFI_KEY value of the key that was

+                          pressed.  This is an optional parameter that may be NULL.

+                          If it is NULL then no wait for a keypress will be performed.

+  @param[in]  ...         The variable argument list that contains pointers to Null-

+                          terminated Unicode strings to display in the dialog box.

+                          The variable argument list is terminated by a NULL.

+

+**/

+VOID

+EFIAPI

+CreatePopUp (

+  IN  UINTN          Attribute,

+  OUT EFI_INPUT_KEY  *Key,      OPTIONAL

+  ...

+  )

+{

+  EFI_STATUS                       Status;

+  VA_LIST                          Args;

+  EFI_SIMPLE_TEXT_OUTPUT_PROTOCOL  *ConOut;

+  EFI_SIMPLE_TEXT_OUTPUT_MODE      SavedConsoleMode;

+  UINTN                            Columns;

+  UINTN                            Rows;

+  UINTN                            Column;

+  UINTN                            Row;

+  UINTN                            NumberOfLines;

+  UINTN                            MaxLength;

+  CHAR16                           *String;

+  UINTN                            Length;

+  CHAR16                           *Line;

+  UINTN                            EventIndex;

+  CHAR16                           *TmpString;

+

+  //

+  // Determine the length of the longest line in the popup and the the total

+  // number of lines in the popup

+  //

+  VA_START (Args, Key);

+  MaxLength = 0;

+  NumberOfLines = 0;

+  while ((String = VA_ARG (Args, CHAR16 *)) != NULL) {

+    MaxLength = MAX (MaxLength, UefiLibGetStringWidth (String, FALSE, 0, NULL) / 2);

+    NumberOfLines++;

+  }

+  VA_END (Args);

+

+  //

+  // If the total number of lines in the popup is zero, then ASSERT()

+  //

+  ASSERT (NumberOfLines != 0);

+

+  //

+  // If the maximum length of all the strings is zero, then ASSERT()

+  //

+  ASSERT (MaxLength != 0);

+

+  //

+  // Cache a pointer to the Simple Text Output Protocol in the EFI System Table

+  //

+  ConOut = gST->ConOut;

+

+  //

+  // Save the current console cursor position and attributes

+  //

+  CopyMem (&SavedConsoleMode, ConOut->Mode, sizeof (SavedConsoleMode));

+

+  //

+  // Retrieve the number of columns and rows in the current console mode

+  //

+  ConOut->QueryMode (ConOut, SavedConsoleMode.Mode, &Columns, &Rows);

+

+  //

+  // Disable cursor and set the foreground and background colors specified by Attribute

+  //

+  ConOut->EnableCursor (ConOut, FALSE);

+  ConOut->SetAttribute (ConOut, Attribute);

+

+  //

+  // Limit NumberOfLines to height of the screen minus 3 rows for the box itself

+  //

+  NumberOfLines = MIN (NumberOfLines, Rows - 3);

+

+  //

+  // Limit MaxLength to width of the screen minus 2 columns for the box itself

+  //

+  MaxLength = MIN (MaxLength, Columns - 2);

+

+  //

+  // Compute the starting row and starting column for the popup

+  //

+  Row    = (Rows - (NumberOfLines + 3)) / 2;

+  Column = (Columns - (MaxLength + 2)) / 2;

+

+  //

+  // Allocate a buffer for a single line of the popup with borders and a Null-terminator

+  //

+  Line = AllocateZeroPool ((MaxLength + 3) * sizeof (CHAR16));

+  ASSERT (Line != NULL);

+

+  //

+  // Draw top of popup box

+  //

+  SetMem16 (Line, (MaxLength + 2) * 2, BOXDRAW_HORIZONTAL);

+  Line[0]             = BOXDRAW_DOWN_RIGHT;

+  Line[MaxLength + 1] = BOXDRAW_DOWN_LEFT;

+  Line[MaxLength + 2] = L'\0';

+  ConOut->SetCursorPosition (ConOut, Column, Row++);

+  ConOut->OutputString (ConOut, Line);

+

+  //

+  // Draw middle of the popup with strings

+  //

+  VA_START (Args, Key);

+  while ((String = VA_ARG (Args, CHAR16 *)) != NULL && NumberOfLines > 0) {

+    SetMem16 (Line, (MaxLength + 2) * 2, L' ');

+    Line[0]             = BOXDRAW_VERTICAL;

+    Line[MaxLength + 1] = BOXDRAW_VERTICAL;

+    Line[MaxLength + 2] = L'\0';

+    ConOut->SetCursorPosition (ConOut, Column, Row);

+    ConOut->OutputString (ConOut, Line);

+    Length = UefiLibGetStringWidth (String, FALSE, 0, NULL) / 2;

+    if (Length <= MaxLength) {

+      //

+      // Length <= MaxLength

+      //

+      ConOut->SetCursorPosition (ConOut, Column + 1 + (MaxLength - Length) / 2, Row++);

+      ConOut->OutputString (ConOut, String);

+    } else {

+      //

+      // Length > MaxLength

+      //

+      UefiLibGetStringWidth (String, TRUE, MaxLength, &Length);

+      TmpString = AllocateZeroPool ((Length + 1) * sizeof (CHAR16));

+      ASSERT (TmpString != NULL);

+      StrnCpyS (TmpString, Length + 1, String, Length - 3);

+      StrCatS (TmpString, Length + 1, L"...");

+

+      ConOut->SetCursorPosition (ConOut, Column + 1, Row++);

+      ConOut->OutputString (ConOut, TmpString);

+      FreePool (TmpString);

+    }

+    NumberOfLines--;

+  }

+  VA_END (Args);

+

+  //

+  // Draw bottom of popup box

+  //

+  SetMem16 (Line, (MaxLength + 2) * 2, BOXDRAW_HORIZONTAL);

+  Line[0]             = BOXDRAW_UP_RIGHT;

+  Line[MaxLength + 1] = BOXDRAW_UP_LEFT;

+  Line[MaxLength + 2] = L'\0';

+  ConOut->SetCursorPosition (ConOut, Column, Row++);

+  ConOut->OutputString (ConOut, Line);

+

+  //

+  // Free the allocated line buffer

+  //

+  FreePool (Line);

+

+  //

+  // Restore the cursor visibility, position, and attributes

+  //

+  ConOut->EnableCursor      (ConOut, SavedConsoleMode.CursorVisible);

+  ConOut->SetCursorPosition (ConOut, SavedConsoleMode.CursorColumn, SavedConsoleMode.CursorRow);

+  ConOut->SetAttribute      (ConOut, SavedConsoleMode.Attribute);

+

+  //

+  // Wait for a keystroke

+  //

+  if (Key != NULL) {

+    while (TRUE) {

+      Status = gST->ConIn->ReadKeyStroke (gST->ConIn, Key);

+      if (!EFI_ERROR (Status)) {

+        break;

+      }

+

+      //

+      // If we encounter error, continue to read another key in.

+      //

+      if (Status != EFI_NOT_READY) {

+        continue;

+      }

+      gBS->WaitForEvent (1, &gST->ConIn->WaitForKey, &EventIndex);

+    }

+  }

+}

diff --git a/debugging_demo/memtest86+/efi/Include/src/UefiLib/UefiDriverModel.c b/debugging_demo/memtest86+/efi/Include/src/UefiLib/UefiDriverModel.c
new file mode 100644
index 0000000..391a913
--- /dev/null
+++ b/debugging_demo/memtest86+/efi/Include/src/UefiLib/UefiDriverModel.c
@@ -0,0 +1,2021 @@
+/** @file

+  Library functions that abstract driver model protocols

+  installation and uninstallation.

+

+  Copyright (c) 2019, NVIDIA Corporation. All rights reserved.

+  Copyright (c) 2006 - 2018, Intel Corporation. All rights reserved.<BR>

+  SPDX-License-Identifier: BSD-2-Clause-Patent

+

+**/

+

+

+#include "UefiLibInternal.h"

+#include "Efi_Defs.h"

+

+/**

+  Installs and completes the initialization of a Driver Binding Protocol instance.

+

+  Installs the Driver Binding Protocol specified by DriverBinding onto the handle

+  specified by DriverBindingHandle. If DriverBindingHandle is NULL, then DriverBinding

+  is installed onto a newly created handle. DriverBindingHandle is typically the same

+  as the driver's ImageHandle, but it can be different if the driver produces multiple

+  Driver Binding Protocols.

+  If DriverBinding is NULL, then ASSERT().

+  If DriverBinding can not be installed onto a handle, then ASSERT().

+

+  @param  ImageHandle          The image handle of the driver.

+  @param  SystemTable          The EFI System Table that was passed to the driver's entry point.

+  @param  DriverBinding        A Driver Binding Protocol instance that this driver is producing.

+  @param  DriverBindingHandle  The handle that DriverBinding is to be installed onto.  If this

+                               parameter is NULL, then a new handle is created.

+

+  @retval EFI_SUCCESS           The protocol installation successfully completed.

+  @retval EFI_OUT_OF_RESOURCES  There was not enough system resources to install the protocol.

+  @retval Others                Status from gBS->InstallMultipleProtocolInterfaces().

+

+**/

+EFI_STATUS

+EFIAPI

+EfiLibInstallDriverBinding (

+  IN CONST EFI_HANDLE             ImageHandle,

+  IN CONST EFI_SYSTEM_TABLE       *SystemTable,

+  IN EFI_DRIVER_BINDING_PROTOCOL  *DriverBinding,

+  IN EFI_HANDLE                   DriverBindingHandle

+  )

+{

+  EFI_STATUS  Status;

+

+  ASSERT (DriverBinding != NULL);

+

+  //

+  // Update the ImageHandle and DriverBindingHandle fields of the Driver Binding Protocol

+  //

+  DriverBinding->ImageHandle         = ImageHandle;

+  DriverBinding->DriverBindingHandle = DriverBindingHandle;

+

+  Status = gBS->InstallMultipleProtocolInterfaces (

+                  &DriverBinding->DriverBindingHandle,

+                  &gEfiDriverBindingProtocolGuid, DriverBinding,

+                  NULL

+                  );

+  //

+  // ASSERT if the call to InstallMultipleProtocolInterfaces() failed

+  //

+  ASSERT_EFI_ERROR (Status);

+

+  return Status;

+}

+

+

+

+/**

+  Uninstalls a Driver Binding Protocol instance.

+

+  If DriverBinding is NULL, then ASSERT().

+  If DriverBinding can not be uninstalled, then ASSERT().

+

+  @param  DriverBinding        A Driver Binding Protocol instance that this driver produced.

+

+  @retval EFI_SUCCESS           The protocol uninstallation successfully completed.

+  @retval Others                Status from gBS->UninstallMultipleProtocolInterfaces().

+

+**/

+EFI_STATUS

+EFIAPI

+EfiLibUninstallDriverBinding (

+  IN EFI_DRIVER_BINDING_PROTOCOL  *DriverBinding

+  )

+{

+  EFI_STATUS  Status;

+

+  ASSERT (DriverBinding != NULL);

+

+  Status = gBS->UninstallMultipleProtocolInterfaces (

+                  DriverBinding->DriverBindingHandle,

+                  &gEfiDriverBindingProtocolGuid, DriverBinding,

+                  NULL

+                  );

+  //

+  // ASSERT if the call to UninstallMultipleProtocolInterfaces() failed

+  //

+  ASSERT_EFI_ERROR (Status);

+

+  return Status;

+}

+

+

+

+/**

+  Installs and completes the initialization of a Driver Binding Protocol instance and

+  optionally installs the Component Name, Driver Configuration and Driver Diagnostics Protocols.

+

+  Initializes a driver by installing the Driver Binding Protocol together with the

+  optional Component Name, optional Driver Configure and optional Driver Diagnostic

+  Protocols onto the driver's DriverBindingHandle. If DriverBindingHandle is NULL,

+  then the protocols are  installed onto a newly created handle. DriverBindingHandle

+  is typically the same as the driver's ImageHandle, but it can be different if the

+  driver produces multiple Driver Binding Protocols.

+  If DriverBinding is NULL, then ASSERT().

+  If the installation fails, then ASSERT().

+

+  @param  ImageHandle          The image handle of the driver.

+  @param  SystemTable          The EFI System Table that was passed to the driver's entry point.

+  @param  DriverBinding        A Driver Binding Protocol instance that this driver is producing.

+  @param  DriverBindingHandle  The handle that DriverBinding is to be installed onto.  If this

+                               parameter is NULL, then a new handle is created.

+  @param  ComponentName        A Component Name Protocol instance that this driver is producing.

+  @param  DriverConfiguration  A Driver Configuration Protocol instance that this driver is producing.

+  @param  DriverDiagnostics    A Driver Diagnostics Protocol instance that this driver is producing.

+

+  @retval EFI_SUCCESS           The protocol installation successfully completed.

+  @retval EFI_OUT_OF_RESOURCES  There was not enough memory in pool to install all the protocols.

+

+**/

+EFI_STATUS

+EFIAPI

+EfiLibInstallAllDriverProtocols (

+  IN CONST EFI_HANDLE                         ImageHandle,

+  IN CONST EFI_SYSTEM_TABLE                   *SystemTable,

+  IN EFI_DRIVER_BINDING_PROTOCOL              *DriverBinding,

+  IN EFI_HANDLE                               DriverBindingHandle,

+  IN CONST EFI_COMPONENT_NAME_PROTOCOL        *ComponentName,       OPTIONAL

+  IN CONST EFI_DRIVER_CONFIGURATION_PROTOCOL  *DriverConfiguration, OPTIONAL

+  IN CONST EFI_DRIVER_DIAGNOSTICS_PROTOCOL    *DriverDiagnostics    OPTIONAL

+  )

+{

+  EFI_STATUS  Status;

+

+  ASSERT (DriverBinding != NULL);

+

+  //

+  // Update the ImageHandle and DriverBindingHandle fields of the Driver Binding Protocol

+  //

+  DriverBinding->ImageHandle         = ImageHandle;

+  DriverBinding->DriverBindingHandle = DriverBindingHandle;

+

+  if (DriverDiagnostics == NULL || FeaturePcdGet(PcdDriverDiagnosticsDisable)) {

+    if (DriverConfiguration == NULL) {

+      if (ComponentName == NULL || FeaturePcdGet(PcdComponentNameDisable)) {

+        Status = gBS->InstallMultipleProtocolInterfaces (

+                        &DriverBinding->DriverBindingHandle,

+                        &gEfiDriverBindingProtocolGuid, DriverBinding,

+                        NULL

+                        );

+      } else {

+        Status = gBS->InstallMultipleProtocolInterfaces (

+                        &DriverBinding->DriverBindingHandle,

+                        &gEfiDriverBindingProtocolGuid, DriverBinding,

+                        &gEfiComponentNameProtocolGuid, ComponentName,

+                        NULL

+                        );

+      }

+    } else {

+      if (ComponentName == NULL || FeaturePcdGet(PcdComponentNameDisable)) {

+        Status = gBS->InstallMultipleProtocolInterfaces (

+                        &DriverBinding->DriverBindingHandle,

+                        &gEfiDriverBindingProtocolGuid,       DriverBinding,

+                        &gEfiDriverConfigurationProtocolGuid, DriverConfiguration,

+                        NULL

+                        );

+      } else {

+        Status = gBS->InstallMultipleProtocolInterfaces (

+                        &DriverBinding->DriverBindingHandle,

+                        &gEfiDriverBindingProtocolGuid,       DriverBinding,

+                        &gEfiComponentNameProtocolGuid,       ComponentName,

+                        &gEfiDriverConfigurationProtocolGuid, DriverConfiguration,

+                        NULL

+                        );

+      }

+    }

+  } else {

+    if (DriverConfiguration == NULL) {

+      if (ComponentName == NULL || FeaturePcdGet(PcdComponentNameDisable)) {

+        Status = gBS->InstallMultipleProtocolInterfaces (

+                        &DriverBinding->DriverBindingHandle,

+                        &gEfiDriverBindingProtocolGuid,     DriverBinding,

+                        &gEfiDriverDiagnosticsProtocolGuid, DriverDiagnostics,

+                        NULL

+                        );

+      } else {

+        Status = gBS->InstallMultipleProtocolInterfaces (

+                        &DriverBinding->DriverBindingHandle,

+                        &gEfiDriverBindingProtocolGuid,     DriverBinding,

+                        &gEfiComponentNameProtocolGuid,     ComponentName,

+                        &gEfiDriverDiagnosticsProtocolGuid, DriverDiagnostics,

+                        NULL

+                        );

+      }

+    } else {

+      if (ComponentName == NULL || FeaturePcdGet(PcdComponentNameDisable)) {

+       Status = gBS->InstallMultipleProtocolInterfaces (

+                        &DriverBinding->DriverBindingHandle,

+                        &gEfiDriverBindingProtocolGuid,       DriverBinding,

+                        &gEfiDriverConfigurationProtocolGuid, DriverConfiguration,

+                        &gEfiDriverDiagnosticsProtocolGuid,   DriverDiagnostics,

+                        NULL

+                        );

+      } else {

+        Status = gBS->InstallMultipleProtocolInterfaces (

+                        &DriverBinding->DriverBindingHandle,

+                        &gEfiDriverBindingProtocolGuid,       DriverBinding,

+                        &gEfiComponentNameProtocolGuid,       ComponentName,

+                        &gEfiDriverConfigurationProtocolGuid, DriverConfiguration,

+                        &gEfiDriverDiagnosticsProtocolGuid,   DriverDiagnostics,

+                        NULL

+                        );

+      }

+    }

+  }

+

+  //

+  // ASSERT if the call to InstallMultipleProtocolInterfaces() failed

+  //

+  ASSERT_EFI_ERROR (Status);

+

+  return Status;

+}

+

+

+

+/**

+  Uninstalls a Driver Binding Protocol instance and optionally uninstalls the

+  Component Name, Driver Configuration and Driver Diagnostics Protocols.

+

+  If DriverBinding is NULL, then ASSERT().

+  If the uninstallation fails, then ASSERT().

+

+  @param  DriverBinding        A Driver Binding Protocol instance that this driver produced.

+  @param  ComponentName        A Component Name Protocol instance that this driver produced.

+  @param  DriverConfiguration  A Driver Configuration Protocol instance that this driver produced.

+  @param  DriverDiagnostics    A Driver Diagnostics Protocol instance that this driver produced.

+

+  @retval EFI_SUCCESS           The protocol uninstallation successfully completed.

+  @retval Others                Status from gBS->UninstallMultipleProtocolInterfaces().

+

+**/

+EFI_STATUS

+EFIAPI

+EfiLibUninstallAllDriverProtocols (

+  IN EFI_DRIVER_BINDING_PROTOCOL              *DriverBinding,

+  IN CONST EFI_COMPONENT_NAME_PROTOCOL        *ComponentName,       OPTIONAL

+  IN CONST EFI_DRIVER_CONFIGURATION_PROTOCOL  *DriverConfiguration, OPTIONAL

+  IN CONST EFI_DRIVER_DIAGNOSTICS_PROTOCOL    *DriverDiagnostics    OPTIONAL

+  )

+{

+  EFI_STATUS  Status;

+

+  ASSERT (DriverBinding != NULL);

+

+  if (DriverDiagnostics == NULL || FeaturePcdGet(PcdDriverDiagnosticsDisable)) {

+    if (DriverConfiguration == NULL) {

+      if (ComponentName == NULL || FeaturePcdGet(PcdComponentNameDisable)) {

+        Status = gBS->UninstallMultipleProtocolInterfaces (

+                        DriverBinding->DriverBindingHandle,

+                        &gEfiDriverBindingProtocolGuid, DriverBinding,

+                        NULL

+                        );

+      } else {

+        Status = gBS->UninstallMultipleProtocolInterfaces (

+                        DriverBinding->DriverBindingHandle,

+                        &gEfiDriverBindingProtocolGuid, DriverBinding,

+                        &gEfiComponentNameProtocolGuid, ComponentName,

+                        NULL

+                        );

+      }

+    } else {

+      if (ComponentName == NULL || FeaturePcdGet(PcdComponentNameDisable)) {

+        Status = gBS->UninstallMultipleProtocolInterfaces (

+                        DriverBinding->DriverBindingHandle,

+                        &gEfiDriverBindingProtocolGuid,       DriverBinding,

+                        &gEfiDriverConfigurationProtocolGuid, DriverConfiguration,

+                        NULL

+                        );

+      } else {

+        Status = gBS->UninstallMultipleProtocolInterfaces (

+                        DriverBinding->DriverBindingHandle,

+                        &gEfiDriverBindingProtocolGuid,       DriverBinding,

+                        &gEfiComponentNameProtocolGuid,       ComponentName,

+                        &gEfiDriverConfigurationProtocolGuid, DriverConfiguration,

+                        NULL

+                        );

+      }

+    }

+  } else {

+    if (DriverConfiguration == NULL) {

+      if (ComponentName == NULL || FeaturePcdGet(PcdComponentNameDisable)) {

+        Status = gBS->UninstallMultipleProtocolInterfaces (

+                        DriverBinding->DriverBindingHandle,

+                        &gEfiDriverBindingProtocolGuid,     DriverBinding,

+                        &gEfiDriverDiagnosticsProtocolGuid, DriverDiagnostics,

+                        NULL

+                        );

+      } else {

+        Status = gBS->UninstallMultipleProtocolInterfaces (

+                        DriverBinding->DriverBindingHandle,

+                        &gEfiDriverBindingProtocolGuid,     DriverBinding,

+                        &gEfiComponentNameProtocolGuid,     ComponentName,

+                        &gEfiDriverDiagnosticsProtocolGuid, DriverDiagnostics,

+                        NULL

+                        );

+      }

+    } else {

+      if (ComponentName == NULL || FeaturePcdGet(PcdComponentNameDisable)) {

+       Status = gBS->UninstallMultipleProtocolInterfaces (

+                        DriverBinding->DriverBindingHandle,

+                        &gEfiDriverBindingProtocolGuid,       DriverBinding,

+                        &gEfiDriverConfigurationProtocolGuid, DriverConfiguration,

+                        &gEfiDriverDiagnosticsProtocolGuid,   DriverDiagnostics,

+                        NULL

+                        );

+      } else {

+        Status = gBS->UninstallMultipleProtocolInterfaces (

+                        DriverBinding->DriverBindingHandle,

+                        &gEfiDriverBindingProtocolGuid,       DriverBinding,

+                        &gEfiComponentNameProtocolGuid,       ComponentName,

+                        &gEfiDriverConfigurationProtocolGuid, DriverConfiguration,

+                        &gEfiDriverDiagnosticsProtocolGuid,   DriverDiagnostics,

+                        NULL

+                        );

+      }

+    }

+  }

+

+  //

+  // ASSERT if the call to UninstallMultipleProtocolInterfaces() failed

+  //

+  ASSERT_EFI_ERROR (Status);

+

+  return Status;

+}

+

+

+

+/**

+  Installs Driver Binding Protocol with optional Component Name and Component Name 2 Protocols.

+

+  Initializes a driver by installing the Driver Binding Protocol together with the

+  optional Component Name and optional Component Name 2 protocols onto the driver's

+  DriverBindingHandle.  If DriverBindingHandle is NULL, then the protocols are installed

+  onto a newly created handle.  DriverBindingHandle is typically the same as the driver's

+  ImageHandle, but it can be different if the driver produces multiple Driver Binding Protocols.

+  If DriverBinding is NULL, then ASSERT().

+  If the installation fails, then ASSERT().

+

+  @param  ImageHandle          The image handle of the driver.

+  @param  SystemTable          The EFI System Table that was passed to the driver's entry point.

+  @param  DriverBinding        A Driver Binding Protocol instance that this driver is producing.

+  @param  DriverBindingHandle  The handle that DriverBinding is to be installed onto.  If this

+                               parameter is NULL, then a new handle is created.

+  @param  ComponentName        A Component Name Protocol instance that this driver is producing.

+  @param  ComponentName2       A Component Name 2 Protocol instance that this driver is producing.

+

+  @retval EFI_SUCCESS           The protocol installation successfully completed.

+  @retval EFI_OUT_OF_RESOURCES  There was not enough memory in pool to install all the protocols.

+

+**/

+EFI_STATUS

+EFIAPI

+EfiLibInstallDriverBindingComponentName2 (

+  IN CONST EFI_HANDLE                         ImageHandle,

+  IN CONST EFI_SYSTEM_TABLE                   *SystemTable,

+  IN EFI_DRIVER_BINDING_PROTOCOL              *DriverBinding,

+  IN EFI_HANDLE                               DriverBindingHandle,

+  IN CONST EFI_COMPONENT_NAME_PROTOCOL        *ComponentName,       OPTIONAL

+  IN CONST EFI_COMPONENT_NAME2_PROTOCOL       *ComponentName2       OPTIONAL

+  )

+{

+  EFI_STATUS  Status;

+

+  ASSERT (DriverBinding != NULL);

+

+  //

+  // Update the ImageHandle and DriverBindingHandle fields of the Driver Binding Protocol

+  //

+  DriverBinding->ImageHandle         = ImageHandle;

+  DriverBinding->DriverBindingHandle = DriverBindingHandle;

+

+  if (ComponentName == NULL || FeaturePcdGet(PcdComponentNameDisable)) {

+    if (ComponentName2 == NULL || FeaturePcdGet(PcdComponentName2Disable)) {

+      Status = gBS->InstallMultipleProtocolInterfaces (

+                      &DriverBinding->DriverBindingHandle,

+                      &gEfiDriverBindingProtocolGuid, DriverBinding,

+                      NULL

+                      );

+      } else {

+      Status = gBS->InstallMultipleProtocolInterfaces (

+                      &DriverBinding->DriverBindingHandle,

+                      &gEfiDriverBindingProtocolGuid, DriverBinding,

+                      &gEfiComponentName2ProtocolGuid, ComponentName2,

+                      NULL

+                      );

+     }

+  } else {

+     if (ComponentName2 == NULL || FeaturePcdGet(PcdComponentName2Disable)) {

+       Status = gBS->InstallMultipleProtocolInterfaces (

+                       &DriverBinding->DriverBindingHandle,

+                       &gEfiDriverBindingProtocolGuid, DriverBinding,

+                       &gEfiComponentNameProtocolGuid, ComponentName,

+                       NULL

+                       );

+     } else {

+       Status = gBS->InstallMultipleProtocolInterfaces (

+                       &DriverBinding->DriverBindingHandle,

+                       &gEfiDriverBindingProtocolGuid, DriverBinding,

+                       &gEfiComponentNameProtocolGuid, ComponentName,

+                       &gEfiComponentName2ProtocolGuid, ComponentName2,

+                       NULL

+                       );

+    }

+  }

+

+  //

+  // ASSERT if the call to InstallMultipleProtocolInterfaces() failed

+  //

+  ASSERT_EFI_ERROR (Status);

+

+  return Status;

+}

+

+

+

+/**

+  Uninstalls Driver Binding Protocol with optional Component Name and Component Name 2 Protocols.

+

+  If DriverBinding is NULL, then ASSERT().

+  If the uninstallation fails, then ASSERT().

+

+  @param  DriverBinding        A Driver Binding Protocol instance that this driver produced.

+  @param  ComponentName        A Component Name Protocol instance that this driver produced.

+  @param  ComponentName2       A Component Name 2 Protocol instance that this driver produced.

+

+  @retval EFI_SUCCESS           The protocol installation successfully completed.

+  @retval Others                Status from gBS->UninstallMultipleProtocolInterfaces().

+

+**/

+EFI_STATUS

+EFIAPI

+EfiLibUninstallDriverBindingComponentName2 (

+  IN EFI_DRIVER_BINDING_PROTOCOL              *DriverBinding,

+  IN CONST EFI_COMPONENT_NAME_PROTOCOL        *ComponentName,       OPTIONAL

+  IN CONST EFI_COMPONENT_NAME2_PROTOCOL       *ComponentName2       OPTIONAL

+  )

+{

+  EFI_STATUS  Status;

+

+  ASSERT (DriverBinding != NULL);

+

+  if (ComponentName == NULL || FeaturePcdGet(PcdComponentNameDisable)) {

+    if (ComponentName2 == NULL || FeaturePcdGet(PcdComponentName2Disable)) {

+      Status = gBS->UninstallMultipleProtocolInterfaces (

+                      DriverBinding->DriverBindingHandle,

+                      &gEfiDriverBindingProtocolGuid, DriverBinding,

+                      NULL

+                      );

+      } else {

+      Status = gBS->UninstallMultipleProtocolInterfaces (

+                      DriverBinding->DriverBindingHandle,

+                      &gEfiDriverBindingProtocolGuid, DriverBinding,

+                      &gEfiComponentName2ProtocolGuid, ComponentName2,

+                      NULL

+                      );

+     }

+  } else {

+     if (ComponentName2 == NULL || FeaturePcdGet(PcdComponentName2Disable)) {

+       Status = gBS->UninstallMultipleProtocolInterfaces (

+                       DriverBinding->DriverBindingHandle,

+                       &gEfiDriverBindingProtocolGuid, DriverBinding,

+                       &gEfiComponentNameProtocolGuid, ComponentName,

+                       NULL

+                       );

+     } else {

+       Status = gBS->UninstallMultipleProtocolInterfaces (

+                       DriverBinding->DriverBindingHandle,

+                       &gEfiDriverBindingProtocolGuid, DriverBinding,

+                       &gEfiComponentNameProtocolGuid, ComponentName,

+                       &gEfiComponentName2ProtocolGuid, ComponentName2,

+                       NULL

+                       );

+    }

+  }

+

+  //

+  // ASSERT if the call to UninstallMultipleProtocolInterfaces() failed

+  //

+  ASSERT_EFI_ERROR (Status);

+

+  return Status;

+}

+

+

+

+/**

+  Installs Driver Binding Protocol with optional Component Name, Component Name 2, Driver

+  Configuration, Driver Configuration 2, Driver Diagnostics, and Driver Diagnostics 2 Protocols.

+

+  Initializes a driver by installing the Driver Binding Protocol together with the optional

+  Component Name, optional Component Name 2, optional Driver Configuration, optional Driver Configuration 2,

+  optional Driver Diagnostic, and optional Driver Diagnostic 2 Protocols onto the driver's DriverBindingHandle.

+  DriverBindingHandle is typically the same as the driver's ImageHandle, but it can be different if the driver

+  produces multiple Driver Binding Protocols.

+  If DriverBinding is NULL, then ASSERT().

+  If the installation fails, then ASSERT().

+

+

+  @param  ImageHandle           The image handle of the driver.

+  @param  SystemTable           The EFI System Table that was passed to the driver's entry point.

+  @param  DriverBinding         A Driver Binding Protocol instance that this driver is producing.

+  @param  DriverBindingHandle   The handle that DriverBinding is to be installed onto.  If this

+                                parameter is NULL, then a new handle is created.

+  @param  ComponentName         A Component Name Protocol instance that this driver is producing.

+  @param  ComponentName2        A Component Name 2 Protocol instance that this driver is producing.

+  @param  DriverConfiguration   A Driver Configuration Protocol instance that this driver is producing.

+  @param  DriverConfiguration2  A Driver Configuration Protocol 2 instance that this driver is producing.

+  @param  DriverDiagnostics     A Driver Diagnostics Protocol instance that this driver is producing.

+  @param  DriverDiagnostics2    A Driver Diagnostics Protocol 2 instance that this driver is producing.

+

+  @retval EFI_SUCCESS           The protocol installation successfully completed.

+  @retval EFI_OUT_OF_RESOURCES  There was not enough memory in pool to install all the protocols.

+

+**/

+EFI_STATUS

+EFIAPI

+EfiLibInstallAllDriverProtocols2 (

+  IN CONST EFI_HANDLE                         ImageHandle,

+  IN CONST EFI_SYSTEM_TABLE                   *SystemTable,

+  IN EFI_DRIVER_BINDING_PROTOCOL              *DriverBinding,

+  IN EFI_HANDLE                               DriverBindingHandle,

+  IN CONST EFI_COMPONENT_NAME_PROTOCOL        *ComponentName,        OPTIONAL

+  IN CONST EFI_COMPONENT_NAME2_PROTOCOL       *ComponentName2,       OPTIONAL

+  IN CONST EFI_DRIVER_CONFIGURATION_PROTOCOL  *DriverConfiguration,  OPTIONAL

+  IN CONST EFI_DRIVER_CONFIGURATION2_PROTOCOL *DriverConfiguration2, OPTIONAL

+  IN CONST EFI_DRIVER_DIAGNOSTICS_PROTOCOL    *DriverDiagnostics,    OPTIONAL

+  IN CONST EFI_DRIVER_DIAGNOSTICS2_PROTOCOL   *DriverDiagnostics2    OPTIONAL

+  )

+{

+  EFI_STATUS  Status;

+

+  ASSERT (DriverBinding != NULL);

+

+  //

+  // Update the ImageHandle and DriverBindingHandle fields of the Driver Binding Protocol

+  //

+  DriverBinding->ImageHandle         = ImageHandle;

+  DriverBinding->DriverBindingHandle = DriverBindingHandle;

+

+  if (DriverConfiguration2 == NULL) {

+    if (DriverConfiguration == NULL) {

+      if (DriverDiagnostics == NULL || FeaturePcdGet(PcdDriverDiagnosticsDisable)) {

+        if (DriverDiagnostics2 == NULL || FeaturePcdGet(PcdDriverDiagnostics2Disable)) {

+          if (ComponentName == NULL || FeaturePcdGet(PcdComponentNameDisable)) {

+            if (ComponentName2 == NULL || FeaturePcdGet(PcdComponentName2Disable)) {

+              Status = gBS->InstallMultipleProtocolInterfaces (

+                              &DriverBinding->DriverBindingHandle,

+                              &gEfiDriverBindingProtocolGuid, DriverBinding,

+                              NULL

+                              );

+            } else {

+              Status = gBS->InstallMultipleProtocolInterfaces (

+                              &DriverBinding->DriverBindingHandle,

+                              &gEfiDriverBindingProtocolGuid, DriverBinding,

+                              &gEfiComponentName2ProtocolGuid, ComponentName2,

+                              NULL

+                              );

+            }

+          } else {

+            if (ComponentName2 == NULL || FeaturePcdGet(PcdComponentName2Disable)) {

+              Status = gBS->InstallMultipleProtocolInterfaces (

+                              &DriverBinding->DriverBindingHandle,

+                              &gEfiDriverBindingProtocolGuid, DriverBinding,

+                              &gEfiComponentNameProtocolGuid, ComponentName,

+                              NULL

+                              );

+            } else {

+              Status = gBS->InstallMultipleProtocolInterfaces (

+                              &DriverBinding->DriverBindingHandle,

+                              &gEfiDriverBindingProtocolGuid, DriverBinding,

+                              &gEfiComponentNameProtocolGuid, ComponentName,

+                              &gEfiComponentName2ProtocolGuid, ComponentName2,

+                              NULL

+                              );

+            }

+          }

+        } else {

+          if (ComponentName == NULL || FeaturePcdGet(PcdComponentNameDisable)) {

+            if (ComponentName2 == NULL || FeaturePcdGet(PcdComponentName2Disable)) {

+              Status = gBS->InstallMultipleProtocolInterfaces (

+                              &DriverBinding->DriverBindingHandle,

+                              &gEfiDriverBindingProtocolGuid, DriverBinding,

+                              &gEfiDriverDiagnostics2ProtocolGuid, DriverDiagnostics2,

+                              NULL

+                              );

+            } else {

+              Status = gBS->InstallMultipleProtocolInterfaces (

+                              &DriverBinding->DriverBindingHandle,

+                              &gEfiDriverBindingProtocolGuid, DriverBinding,

+                              &gEfiComponentName2ProtocolGuid, ComponentName2,

+                              &gEfiDriverDiagnostics2ProtocolGuid, DriverDiagnostics2,

+                              NULL

+                              );

+            }

+          } else {

+            if (ComponentName2 == NULL || FeaturePcdGet(PcdComponentName2Disable)) {

+              Status = gBS->InstallMultipleProtocolInterfaces (

+                              &DriverBinding->DriverBindingHandle,

+                              &gEfiDriverBindingProtocolGuid, DriverBinding,

+                              &gEfiComponentNameProtocolGuid, ComponentName,

+                              &gEfiDriverDiagnostics2ProtocolGuid, DriverDiagnostics2,

+                              NULL

+                              );

+            } else {

+              Status = gBS->InstallMultipleProtocolInterfaces (

+                              &DriverBinding->DriverBindingHandle,

+                              &gEfiDriverBindingProtocolGuid, DriverBinding,

+                              &gEfiComponentNameProtocolGuid, ComponentName,

+                              &gEfiComponentName2ProtocolGuid, ComponentName2,

+                              &gEfiDriverDiagnostics2ProtocolGuid, DriverDiagnostics2,

+                              NULL

+                              );

+            }

+          }

+        }

+      } else {

+        if (DriverDiagnostics2 == NULL || FeaturePcdGet(PcdDriverDiagnostics2Disable)) {

+          if (ComponentName == NULL || FeaturePcdGet(PcdComponentNameDisable)) {

+            if (ComponentName2 == NULL || FeaturePcdGet(PcdComponentName2Disable)) {

+              Status = gBS->InstallMultipleProtocolInterfaces (

+                              &DriverBinding->DriverBindingHandle,

+                              &gEfiDriverBindingProtocolGuid, DriverBinding,

+                              &gEfiDriverDiagnosticsProtocolGuid, DriverDiagnostics,

+                              NULL

+                              );

+            } else {

+              Status = gBS->InstallMultipleProtocolInterfaces (

+                              &DriverBinding->DriverBindingHandle,

+                              &gEfiDriverBindingProtocolGuid, DriverBinding,

+                              &gEfiComponentName2ProtocolGuid, ComponentName2,

+                              &gEfiDriverDiagnosticsProtocolGuid, DriverDiagnostics,

+                              NULL

+                              );

+            }

+          } else {

+            if (ComponentName2 == NULL || FeaturePcdGet(PcdComponentName2Disable)) {

+              Status = gBS->InstallMultipleProtocolInterfaces (

+                              &DriverBinding->DriverBindingHandle,

+                              &gEfiDriverBindingProtocolGuid, DriverBinding,

+                              &gEfiComponentNameProtocolGuid, ComponentName,

+                              &gEfiDriverDiagnosticsProtocolGuid, DriverDiagnostics,

+                              NULL

+                              );

+            } else {

+              Status = gBS->InstallMultipleProtocolInterfaces (

+                              &DriverBinding->DriverBindingHandle,

+                              &gEfiDriverBindingProtocolGuid, DriverBinding,

+                              &gEfiComponentNameProtocolGuid, ComponentName,

+                              &gEfiComponentName2ProtocolGuid, ComponentName2,

+                              &gEfiDriverDiagnosticsProtocolGuid, DriverDiagnostics,

+                              NULL

+                              );

+            }

+          }

+        } else {

+          if (ComponentName == NULL || FeaturePcdGet(PcdComponentNameDisable)) {

+            if (ComponentName2 == NULL || FeaturePcdGet(PcdComponentName2Disable)) {

+              Status = gBS->InstallMultipleProtocolInterfaces (

+                              &DriverBinding->DriverBindingHandle,

+                              &gEfiDriverBindingProtocolGuid, DriverBinding,

+                              &gEfiDriverDiagnosticsProtocolGuid, DriverDiagnostics,

+                              &gEfiDriverDiagnostics2ProtocolGuid, DriverDiagnostics2,

+                              NULL

+                              );

+            } else {

+              Status = gBS->InstallMultipleProtocolInterfaces (

+                              &DriverBinding->DriverBindingHandle,

+                              &gEfiDriverBindingProtocolGuid, DriverBinding,

+                              &gEfiComponentName2ProtocolGuid, ComponentName2,

+                              &gEfiDriverDiagnosticsProtocolGuid, DriverDiagnostics,

+                              &gEfiDriverDiagnostics2ProtocolGuid, DriverDiagnostics2,

+                              NULL

+                              );

+            }

+          } else {

+            if (ComponentName2 == NULL || FeaturePcdGet(PcdComponentName2Disable)) {

+              Status = gBS->InstallMultipleProtocolInterfaces (

+                              &DriverBinding->DriverBindingHandle,

+                              &gEfiDriverBindingProtocolGuid, DriverBinding,

+                              &gEfiComponentNameProtocolGuid, ComponentName,

+                              &gEfiDriverDiagnosticsProtocolGuid, DriverDiagnostics,

+                              &gEfiDriverDiagnostics2ProtocolGuid, DriverDiagnostics2,

+                              NULL

+                              );

+            } else {

+              Status = gBS->InstallMultipleProtocolInterfaces (

+                              &DriverBinding->DriverBindingHandle,

+                              &gEfiDriverBindingProtocolGuid, DriverBinding,

+                              &gEfiComponentNameProtocolGuid, ComponentName,

+                              &gEfiComponentName2ProtocolGuid, ComponentName2,

+                              &gEfiDriverDiagnosticsProtocolGuid, DriverDiagnostics,

+                              &gEfiDriverDiagnostics2ProtocolGuid, DriverDiagnostics2,

+                              NULL

+                              );

+            }

+          }

+        }

+      }

+    } else {

+      if (DriverDiagnostics == NULL || FeaturePcdGet(PcdDriverDiagnosticsDisable)) {

+        if (DriverDiagnostics2 == NULL || FeaturePcdGet(PcdDriverDiagnostics2Disable)) {

+          if (ComponentName == NULL || FeaturePcdGet(PcdComponentNameDisable)) {

+            if (ComponentName2 == NULL || FeaturePcdGet(PcdComponentName2Disable)) {

+              Status = gBS->InstallMultipleProtocolInterfaces (

+                              &DriverBinding->DriverBindingHandle,

+                              &gEfiDriverBindingProtocolGuid, DriverBinding,

+                              &gEfiDriverConfigurationProtocolGuid, DriverConfiguration,

+                              NULL

+                              );

+            } else {

+              Status = gBS->InstallMultipleProtocolInterfaces (

+                              &DriverBinding->DriverBindingHandle,

+                              &gEfiDriverBindingProtocolGuid, DriverBinding,

+                              &gEfiComponentName2ProtocolGuid, ComponentName2,

+                              &gEfiDriverConfigurationProtocolGuid, DriverConfiguration,

+                              NULL

+                              );

+            }

+          } else {

+            if (ComponentName2 == NULL || FeaturePcdGet(PcdComponentName2Disable)) {

+              Status = gBS->InstallMultipleProtocolInterfaces (

+                              &DriverBinding->DriverBindingHandle,

+                              &gEfiDriverBindingProtocolGuid, DriverBinding,

+                              &gEfiComponentNameProtocolGuid, ComponentName,

+                              &gEfiDriverConfigurationProtocolGuid, DriverConfiguration,

+                              NULL

+                              );

+            } else {

+              Status = gBS->InstallMultipleProtocolInterfaces (

+                              &DriverBinding->DriverBindingHandle,

+                              &gEfiDriverBindingProtocolGuid, DriverBinding,

+                              &gEfiComponentNameProtocolGuid, ComponentName,

+                              &gEfiComponentName2ProtocolGuid, ComponentName2,

+                              &gEfiDriverConfigurationProtocolGuid, DriverConfiguration,

+                              NULL

+                              );

+            }

+          }

+        } else {

+          if (ComponentName == NULL || FeaturePcdGet(PcdComponentNameDisable)) {

+            if (ComponentName2 == NULL || FeaturePcdGet(PcdComponentName2Disable)) {

+              Status = gBS->InstallMultipleProtocolInterfaces (

+                              &DriverBinding->DriverBindingHandle,

+                              &gEfiDriverBindingProtocolGuid, DriverBinding,

+                              &gEfiDriverConfigurationProtocolGuid, DriverConfiguration,

+                              &gEfiDriverDiagnostics2ProtocolGuid, DriverDiagnostics2,

+                              NULL

+                              );

+            } else {

+              Status = gBS->InstallMultipleProtocolInterfaces (

+                              &DriverBinding->DriverBindingHandle,

+                              &gEfiDriverBindingProtocolGuid, DriverBinding,

+                              &gEfiComponentName2ProtocolGuid, ComponentName2,

+                              &gEfiDriverConfigurationProtocolGuid, DriverConfiguration,

+                              &gEfiDriverDiagnostics2ProtocolGuid, DriverDiagnostics2,

+                              NULL

+                              );

+            }

+          } else {

+            if (ComponentName2 == NULL || FeaturePcdGet(PcdComponentName2Disable)) {

+              Status = gBS->InstallMultipleProtocolInterfaces (

+                              &DriverBinding->DriverBindingHandle,

+                              &gEfiDriverBindingProtocolGuid, DriverBinding,

+                              &gEfiComponentNameProtocolGuid, ComponentName,

+                              &gEfiDriverConfigurationProtocolGuid, DriverConfiguration,

+                              &gEfiDriverDiagnostics2ProtocolGuid, DriverDiagnostics2,

+                              NULL

+                              );

+            } else {

+              Status = gBS->InstallMultipleProtocolInterfaces (

+                              &DriverBinding->DriverBindingHandle,

+                              &gEfiDriverBindingProtocolGuid, DriverBinding,

+                              &gEfiComponentNameProtocolGuid, ComponentName,

+                              &gEfiComponentName2ProtocolGuid, ComponentName2,

+                              &gEfiDriverConfigurationProtocolGuid, DriverConfiguration,

+                              &gEfiDriverDiagnostics2ProtocolGuid, DriverDiagnostics2,

+                              NULL

+                              );

+            }

+          }

+        }

+      } else {

+        if (DriverDiagnostics2 == NULL || FeaturePcdGet(PcdDriverDiagnostics2Disable)) {

+          if (ComponentName == NULL || FeaturePcdGet(PcdComponentNameDisable)) {

+            if (ComponentName2 == NULL || FeaturePcdGet(PcdComponentName2Disable)) {

+              Status = gBS->InstallMultipleProtocolInterfaces (

+                              &DriverBinding->DriverBindingHandle,

+                              &gEfiDriverBindingProtocolGuid, DriverBinding,

+                              &gEfiDriverConfigurationProtocolGuid, DriverConfiguration,

+                              &gEfiDriverDiagnosticsProtocolGuid, DriverDiagnostics,

+                              NULL

+                              );

+            } else {

+              Status = gBS->InstallMultipleProtocolInterfaces (

+                              &DriverBinding->DriverBindingHandle,

+                              &gEfiDriverBindingProtocolGuid, DriverBinding,

+                              &gEfiComponentName2ProtocolGuid, ComponentName2,

+                              &gEfiDriverConfigurationProtocolGuid, DriverConfiguration,

+                              &gEfiDriverDiagnosticsProtocolGuid, DriverDiagnostics,

+                              NULL

+                              );

+            }

+          } else {

+            if (ComponentName2 == NULL || FeaturePcdGet(PcdComponentName2Disable)) {

+              Status = gBS->InstallMultipleProtocolInterfaces (

+                              &DriverBinding->DriverBindingHandle,

+                              &gEfiDriverBindingProtocolGuid, DriverBinding,

+                              &gEfiComponentNameProtocolGuid, ComponentName,

+                              &gEfiDriverConfigurationProtocolGuid, DriverConfiguration,

+                              &gEfiDriverDiagnosticsProtocolGuid, DriverDiagnostics,

+                              NULL

+                              );

+            } else {

+              Status = gBS->InstallMultipleProtocolInterfaces (

+                              &DriverBinding->DriverBindingHandle,

+                              &gEfiDriverBindingProtocolGuid, DriverBinding,

+                              &gEfiComponentNameProtocolGuid, ComponentName,

+                              &gEfiComponentName2ProtocolGuid, ComponentName2,

+                              &gEfiDriverConfigurationProtocolGuid, DriverConfiguration,

+                              &gEfiDriverDiagnosticsProtocolGuid, DriverDiagnostics,

+                              NULL

+                              );

+            }

+          }

+        } else {

+          if (ComponentName == NULL || FeaturePcdGet(PcdComponentNameDisable)) {

+            if (ComponentName2 == NULL || FeaturePcdGet(PcdComponentName2Disable)) {

+              Status = gBS->InstallMultipleProtocolInterfaces (

+                              &DriverBinding->DriverBindingHandle,

+                              &gEfiDriverBindingProtocolGuid, DriverBinding,

+                              &gEfiDriverConfigurationProtocolGuid, DriverConfiguration,

+                              &gEfiDriverDiagnosticsProtocolGuid, DriverDiagnostics,

+                              &gEfiDriverDiagnostics2ProtocolGuid, DriverDiagnostics2,

+                              NULL

+                              );

+            } else {

+              Status = gBS->InstallMultipleProtocolInterfaces (

+                              &DriverBinding->DriverBindingHandle,

+                              &gEfiDriverBindingProtocolGuid, DriverBinding,

+                              &gEfiComponentName2ProtocolGuid, ComponentName2,

+                              &gEfiDriverConfigurationProtocolGuid, DriverConfiguration,

+                              &gEfiDriverDiagnosticsProtocolGuid, DriverDiagnostics,

+                              &gEfiDriverDiagnostics2ProtocolGuid, DriverDiagnostics2,

+                              NULL

+                              );

+            }

+          } else {

+            if (ComponentName2 == NULL || FeaturePcdGet(PcdComponentName2Disable)) {

+              Status = gBS->InstallMultipleProtocolInterfaces (

+                              &DriverBinding->DriverBindingHandle,

+                              &gEfiDriverBindingProtocolGuid, DriverBinding,

+                              &gEfiComponentNameProtocolGuid, ComponentName,

+                              &gEfiDriverConfigurationProtocolGuid, DriverConfiguration,

+                              &gEfiDriverDiagnosticsProtocolGuid, DriverDiagnostics,

+                              &gEfiDriverDiagnostics2ProtocolGuid, DriverDiagnostics2,

+                              NULL

+                              );

+            } else {

+              Status = gBS->InstallMultipleProtocolInterfaces (

+                              &DriverBinding->DriverBindingHandle,

+                              &gEfiDriverBindingProtocolGuid, DriverBinding,

+                              &gEfiComponentNameProtocolGuid, ComponentName,

+                              &gEfiComponentName2ProtocolGuid, ComponentName2,

+                              &gEfiDriverConfigurationProtocolGuid, DriverConfiguration,

+                              &gEfiDriverDiagnosticsProtocolGuid, DriverDiagnostics,

+                              &gEfiDriverDiagnostics2ProtocolGuid, DriverDiagnostics2,

+                              NULL

+                              );

+            }

+          }

+        }

+      }

+    }

+  } else {

+    if (DriverConfiguration == NULL) {

+      if (DriverDiagnostics == NULL || FeaturePcdGet(PcdDriverDiagnosticsDisable)) {

+        if (DriverDiagnostics2 == NULL || FeaturePcdGet(PcdDriverDiagnostics2Disable)) {

+          if (ComponentName == NULL || FeaturePcdGet(PcdComponentNameDisable)) {

+            if (ComponentName2 == NULL || FeaturePcdGet(PcdComponentName2Disable)) {

+              Status = gBS->InstallMultipleProtocolInterfaces (

+                              &DriverBinding->DriverBindingHandle,

+                              &gEfiDriverBindingProtocolGuid, DriverBinding,

+                              &gEfiDriverConfiguration2ProtocolGuid, DriverConfiguration2,

+                              NULL

+                              );

+            } else {

+              Status = gBS->InstallMultipleProtocolInterfaces (

+                              &DriverBinding->DriverBindingHandle,

+                              &gEfiDriverBindingProtocolGuid, DriverBinding,

+                              &gEfiComponentName2ProtocolGuid, ComponentName2,

+                              &gEfiDriverConfiguration2ProtocolGuid, DriverConfiguration2,

+                              NULL

+                              );

+            }

+          } else {

+            if (ComponentName2 == NULL || FeaturePcdGet(PcdComponentName2Disable)) {

+              Status = gBS->InstallMultipleProtocolInterfaces (

+                              &DriverBinding->DriverBindingHandle,

+                              &gEfiDriverBindingProtocolGuid, DriverBinding,

+                              &gEfiComponentNameProtocolGuid, ComponentName,

+                              &gEfiDriverConfiguration2ProtocolGuid, DriverConfiguration2,

+                              NULL

+                              );

+            } else {

+              Status = gBS->InstallMultipleProtocolInterfaces (

+                              &DriverBinding->DriverBindingHandle,

+                              &gEfiDriverBindingProtocolGuid, DriverBinding,

+                              &gEfiComponentNameProtocolGuid, ComponentName,

+                              &gEfiComponentName2ProtocolGuid, ComponentName2,

+                              &gEfiDriverConfiguration2ProtocolGuid, DriverConfiguration2,

+                              NULL

+                              );

+            }

+          }

+        } else {

+          if (ComponentName == NULL || FeaturePcdGet(PcdComponentNameDisable)) {

+            if (ComponentName2 == NULL || FeaturePcdGet(PcdComponentName2Disable)) {

+              Status = gBS->InstallMultipleProtocolInterfaces (

+                              &DriverBinding->DriverBindingHandle,

+                              &gEfiDriverBindingProtocolGuid, DriverBinding,

+                              &gEfiDriverDiagnostics2ProtocolGuid, DriverDiagnostics2,

+                              &gEfiDriverConfiguration2ProtocolGuid, DriverConfiguration2,

+                              NULL

+                              );

+            } else {

+              Status = gBS->InstallMultipleProtocolInterfaces (

+                              &DriverBinding->DriverBindingHandle,

+                              &gEfiDriverBindingProtocolGuid, DriverBinding,

+                              &gEfiComponentName2ProtocolGuid, ComponentName2,

+                              &gEfiDriverConfiguration2ProtocolGuid, DriverConfiguration2,

+                              &gEfiDriverDiagnostics2ProtocolGuid, DriverDiagnostics2,

+                              NULL

+                              );

+            }

+          } else {

+            if (ComponentName2 == NULL || FeaturePcdGet(PcdComponentName2Disable)) {

+              Status = gBS->InstallMultipleProtocolInterfaces (

+                              &DriverBinding->DriverBindingHandle,

+                              &gEfiDriverBindingProtocolGuid, DriverBinding,

+                              &gEfiComponentNameProtocolGuid, ComponentName,

+                              &gEfiDriverConfiguration2ProtocolGuid, DriverConfiguration2,

+                              &gEfiDriverDiagnostics2ProtocolGuid, DriverDiagnostics2,

+                              NULL

+                              );

+            } else {

+              Status = gBS->InstallMultipleProtocolInterfaces (

+                              &DriverBinding->DriverBindingHandle,

+                              &gEfiDriverBindingProtocolGuid, DriverBinding,

+                              &gEfiComponentNameProtocolGuid, ComponentName,

+                              &gEfiComponentName2ProtocolGuid, ComponentName2,

+                              &gEfiDriverConfiguration2ProtocolGuid, DriverConfiguration2,

+                              &gEfiDriverDiagnostics2ProtocolGuid, DriverDiagnostics2,

+                              NULL

+                              );

+            }

+          }

+        }

+      } else {

+        if (DriverDiagnostics2 == NULL || FeaturePcdGet(PcdDriverDiagnostics2Disable)) {

+          if (ComponentName == NULL || FeaturePcdGet(PcdComponentNameDisable)) {

+            if (ComponentName2 == NULL || FeaturePcdGet(PcdComponentName2Disable)) {

+              Status = gBS->InstallMultipleProtocolInterfaces (

+                              &DriverBinding->DriverBindingHandle,

+                              &gEfiDriverBindingProtocolGuid, DriverBinding,

+                              &gEfiDriverDiagnosticsProtocolGuid, DriverDiagnostics,

+                              &gEfiDriverConfiguration2ProtocolGuid, DriverConfiguration2,

+                              NULL

+                              );

+            } else {

+              Status = gBS->InstallMultipleProtocolInterfaces (

+                              &DriverBinding->DriverBindingHandle,

+                              &gEfiDriverBindingProtocolGuid, DriverBinding,

+                              &gEfiComponentName2ProtocolGuid, ComponentName2,

+                              &gEfiDriverConfiguration2ProtocolGuid, DriverConfiguration2,

+                              &gEfiDriverDiagnosticsProtocolGuid, DriverDiagnostics,

+                              NULL

+                              );

+            }

+          } else {

+            if (ComponentName2 == NULL || FeaturePcdGet(PcdComponentName2Disable)) {

+              Status = gBS->InstallMultipleProtocolInterfaces (

+                              &DriverBinding->DriverBindingHandle,

+                              &gEfiDriverBindingProtocolGuid, DriverBinding,

+                              &gEfiComponentNameProtocolGuid, ComponentName,

+                              &gEfiDriverDiagnosticsProtocolGuid, DriverDiagnostics,

+                              &gEfiDriverConfiguration2ProtocolGuid, DriverConfiguration2,

+                              NULL

+                              );

+            } else {

+              Status = gBS->InstallMultipleProtocolInterfaces (

+                              &DriverBinding->DriverBindingHandle,

+                              &gEfiDriverBindingProtocolGuid, DriverBinding,

+                              &gEfiComponentNameProtocolGuid, ComponentName,

+                              &gEfiComponentName2ProtocolGuid, ComponentName2,

+                              &gEfiDriverConfiguration2ProtocolGuid, DriverConfiguration2,

+                              &gEfiDriverDiagnosticsProtocolGuid, DriverDiagnostics,

+                              NULL

+                              );

+            }

+          }

+        } else {

+          if (ComponentName == NULL || FeaturePcdGet(PcdComponentNameDisable)) {

+            if (ComponentName2 == NULL || FeaturePcdGet(PcdComponentName2Disable)) {

+              Status = gBS->InstallMultipleProtocolInterfaces (

+                              &DriverBinding->DriverBindingHandle,

+                              &gEfiDriverBindingProtocolGuid, DriverBinding,

+                              &gEfiDriverConfiguration2ProtocolGuid, DriverConfiguration2,

+                              &gEfiDriverDiagnosticsProtocolGuid, DriverDiagnostics,

+                              &gEfiDriverDiagnostics2ProtocolGuid, DriverDiagnostics2,

+                              NULL

+                              );

+            } else {

+              Status = gBS->InstallMultipleProtocolInterfaces (

+                              &DriverBinding->DriverBindingHandle,

+                              &gEfiDriverBindingProtocolGuid, DriverBinding,

+                              &gEfiComponentName2ProtocolGuid, ComponentName2,

+                              &gEfiDriverConfiguration2ProtocolGuid, DriverConfiguration2,

+                              &gEfiDriverDiagnosticsProtocolGuid, DriverDiagnostics,

+                              &gEfiDriverDiagnostics2ProtocolGuid, DriverDiagnostics2,

+                              NULL

+                              );

+            }

+          } else {

+            if (ComponentName2 == NULL || FeaturePcdGet(PcdComponentName2Disable)) {

+              Status = gBS->InstallMultipleProtocolInterfaces (

+                              &DriverBinding->DriverBindingHandle,

+                              &gEfiDriverBindingProtocolGuid, DriverBinding,

+                              &gEfiComponentNameProtocolGuid, ComponentName,

+                              &gEfiDriverConfiguration2ProtocolGuid, DriverConfiguration2,

+                              &gEfiDriverDiagnosticsProtocolGuid, DriverDiagnostics,

+                              &gEfiDriverDiagnostics2ProtocolGuid, DriverDiagnostics2,

+                              NULL

+                              );

+            } else {

+              Status = gBS->InstallMultipleProtocolInterfaces (

+                              &DriverBinding->DriverBindingHandle,

+                              &gEfiDriverBindingProtocolGuid, DriverBinding,

+                              &gEfiComponentNameProtocolGuid, ComponentName,

+                              &gEfiComponentName2ProtocolGuid, ComponentName2,

+                              &gEfiDriverConfiguration2ProtocolGuid, DriverConfiguration2,

+                              &gEfiDriverDiagnosticsProtocolGuid, DriverDiagnostics,

+                              &gEfiDriverDiagnostics2ProtocolGuid, DriverDiagnostics2,

+                              NULL

+                              );

+            }

+          }

+        }

+      }

+    } else {

+      if (DriverDiagnostics == NULL || FeaturePcdGet(PcdDriverDiagnosticsDisable)) {

+        if (DriverDiagnostics2 == NULL || FeaturePcdGet(PcdDriverDiagnostics2Disable)) {

+          if (ComponentName == NULL || FeaturePcdGet(PcdComponentNameDisable)) {

+            if (ComponentName2 == NULL || FeaturePcdGet(PcdComponentName2Disable)) {

+              Status = gBS->InstallMultipleProtocolInterfaces (

+                              &DriverBinding->DriverBindingHandle,

+                              &gEfiDriverBindingProtocolGuid, DriverBinding,

+                              &gEfiDriverConfigurationProtocolGuid, DriverConfiguration,

+                              &gEfiDriverConfiguration2ProtocolGuid, DriverConfiguration2,

+                              NULL

+                              );

+            } else {

+              Status = gBS->InstallMultipleProtocolInterfaces (

+                              &DriverBinding->DriverBindingHandle,

+                              &gEfiDriverBindingProtocolGuid, DriverBinding,

+                              &gEfiComponentName2ProtocolGuid, ComponentName2,

+                              &gEfiDriverConfigurationProtocolGuid, DriverConfiguration,

+                              &gEfiDriverConfiguration2ProtocolGuid, DriverConfiguration2,

+                              NULL

+                              );

+            }

+          } else {

+            if (ComponentName2 == NULL || FeaturePcdGet(PcdComponentName2Disable)) {

+              Status = gBS->InstallMultipleProtocolInterfaces (

+                              &DriverBinding->DriverBindingHandle,

+                              &gEfiDriverBindingProtocolGuid, DriverBinding,

+                              &gEfiComponentNameProtocolGuid, ComponentName,

+                              &gEfiDriverConfigurationProtocolGuid, DriverConfiguration,

+                              &gEfiDriverConfiguration2ProtocolGuid, DriverConfiguration2,

+                              NULL

+                              );

+            } else {

+              Status = gBS->InstallMultipleProtocolInterfaces (

+                              &DriverBinding->DriverBindingHandle,

+                              &gEfiDriverBindingProtocolGuid, DriverBinding,

+                              &gEfiComponentNameProtocolGuid, ComponentName,

+                              &gEfiComponentName2ProtocolGuid, ComponentName2,

+                              &gEfiDriverConfigurationProtocolGuid, DriverConfiguration,

+                              &gEfiDriverConfiguration2ProtocolGuid, DriverConfiguration2,

+                              NULL

+                              );

+            }

+          }

+        } else {

+          if (ComponentName == NULL || FeaturePcdGet(PcdComponentNameDisable)) {

+            if (ComponentName2 == NULL || FeaturePcdGet(PcdComponentName2Disable)) {

+              Status = gBS->InstallMultipleProtocolInterfaces (

+                              &DriverBinding->DriverBindingHandle,

+                              &gEfiDriverBindingProtocolGuid, DriverBinding,

+                              &gEfiDriverConfigurationProtocolGuid, DriverConfiguration,

+                              &gEfiDriverConfiguration2ProtocolGuid, DriverConfiguration2,

+                              &gEfiDriverDiagnostics2ProtocolGuid, DriverDiagnostics2,

+                              NULL

+                              );

+            } else {

+              Status = gBS->InstallMultipleProtocolInterfaces (

+                              &DriverBinding->DriverBindingHandle,

+                              &gEfiDriverBindingProtocolGuid, DriverBinding,

+                              &gEfiComponentName2ProtocolGuid, ComponentName2,

+                              &gEfiDriverConfigurationProtocolGuid, DriverConfiguration,

+                              &gEfiDriverConfiguration2ProtocolGuid, DriverConfiguration2,

+                              &gEfiDriverDiagnostics2ProtocolGuid, DriverDiagnostics2,

+                              NULL

+                              );

+            }

+          } else {

+            if (ComponentName2 == NULL || FeaturePcdGet(PcdComponentName2Disable)) {

+              Status = gBS->InstallMultipleProtocolInterfaces (

+                              &DriverBinding->DriverBindingHandle,

+                              &gEfiDriverBindingProtocolGuid, DriverBinding,

+                              &gEfiComponentNameProtocolGuid, ComponentName,

+                              &gEfiDriverConfigurationProtocolGuid, DriverConfiguration,

+                              &gEfiDriverConfiguration2ProtocolGuid, DriverConfiguration2,

+                              &gEfiDriverDiagnostics2ProtocolGuid, DriverDiagnostics2,

+                              NULL

+                              );

+            } else {

+              Status = gBS->InstallMultipleProtocolInterfaces (

+                              &DriverBinding->DriverBindingHandle,

+                              &gEfiDriverBindingProtocolGuid, DriverBinding,

+                              &gEfiComponentNameProtocolGuid, ComponentName,

+                              &gEfiComponentName2ProtocolGuid, ComponentName2,

+                              &gEfiDriverConfigurationProtocolGuid, DriverConfiguration,

+                              &gEfiDriverConfiguration2ProtocolGuid, DriverConfiguration2,

+                              &gEfiDriverDiagnostics2ProtocolGuid, DriverDiagnostics2,

+                              NULL

+                              );

+            }

+          }

+        }

+      } else {

+        if (DriverDiagnostics2 == NULL || FeaturePcdGet(PcdDriverDiagnostics2Disable)) {

+          if (ComponentName == NULL || FeaturePcdGet(PcdComponentNameDisable)) {

+            if (ComponentName2 == NULL || FeaturePcdGet(PcdComponentName2Disable)) {

+              Status = gBS->InstallMultipleProtocolInterfaces (

+                              &DriverBinding->DriverBindingHandle,

+                              &gEfiDriverBindingProtocolGuid, DriverBinding,

+                              &gEfiDriverConfigurationProtocolGuid, DriverConfiguration,

+                              &gEfiDriverConfiguration2ProtocolGuid, DriverConfiguration2,

+                              &gEfiDriverDiagnosticsProtocolGuid, DriverDiagnostics,

+                              NULL

+                              );

+            } else {

+              Status = gBS->InstallMultipleProtocolInterfaces (

+                              &DriverBinding->DriverBindingHandle,

+                              &gEfiDriverBindingProtocolGuid, DriverBinding,

+                              &gEfiComponentName2ProtocolGuid, ComponentName2,

+                              &gEfiDriverConfigurationProtocolGuid, DriverConfiguration,

+                              &gEfiDriverConfiguration2ProtocolGuid, DriverConfiguration2,

+                              &gEfiDriverDiagnosticsProtocolGuid, DriverDiagnostics,

+                              NULL

+                              );

+            }

+          } else {

+            if (ComponentName2 == NULL || FeaturePcdGet(PcdComponentName2Disable)) {

+              Status = gBS->InstallMultipleProtocolInterfaces (

+                              &DriverBinding->DriverBindingHandle,

+                              &gEfiDriverBindingProtocolGuid, DriverBinding,

+                              &gEfiComponentNameProtocolGuid, ComponentName,

+                              &gEfiDriverConfigurationProtocolGuid, DriverConfiguration,

+                              &gEfiDriverConfiguration2ProtocolGuid, DriverConfiguration2,

+                              &gEfiDriverDiagnosticsProtocolGuid, DriverDiagnostics,

+                              NULL

+                              );

+            } else {

+              Status = gBS->InstallMultipleProtocolInterfaces (

+                              &DriverBinding->DriverBindingHandle,

+                              &gEfiDriverBindingProtocolGuid, DriverBinding,

+                              &gEfiComponentNameProtocolGuid, ComponentName,

+                              &gEfiComponentName2ProtocolGuid, ComponentName2,

+                              &gEfiDriverConfigurationProtocolGuid, DriverConfiguration,

+                              &gEfiDriverConfiguration2ProtocolGuid, DriverConfiguration2,

+                              &gEfiDriverDiagnosticsProtocolGuid, DriverDiagnostics,

+                              NULL

+                              );

+            }

+          }

+        } else {

+          if (ComponentName == NULL || FeaturePcdGet(PcdComponentNameDisable)) {

+            if (ComponentName2 == NULL || FeaturePcdGet(PcdComponentName2Disable)) {

+              Status = gBS->InstallMultipleProtocolInterfaces (

+                              &DriverBinding->DriverBindingHandle,

+                              &gEfiDriverBindingProtocolGuid, DriverBinding,

+                              &gEfiDriverConfigurationProtocolGuid, DriverConfiguration,

+                              &gEfiDriverConfiguration2ProtocolGuid, DriverConfiguration2,

+                              &gEfiDriverDiagnosticsProtocolGuid, DriverDiagnostics,

+                              &gEfiDriverDiagnostics2ProtocolGuid, DriverDiagnostics2,

+                              NULL

+                              );

+            } else {

+              Status = gBS->InstallMultipleProtocolInterfaces (

+                              &DriverBinding->DriverBindingHandle,

+                              &gEfiDriverBindingProtocolGuid, DriverBinding,

+                              &gEfiComponentName2ProtocolGuid, ComponentName2,

+                              &gEfiDriverConfigurationProtocolGuid, DriverConfiguration,

+                              &gEfiDriverConfiguration2ProtocolGuid, DriverConfiguration2,

+                              &gEfiDriverDiagnosticsProtocolGuid, DriverDiagnostics,

+                              &gEfiDriverDiagnostics2ProtocolGuid, DriverDiagnostics2,

+                              NULL

+                              );

+            }

+          } else {

+            if (ComponentName2 == NULL || FeaturePcdGet(PcdComponentName2Disable)) {

+              Status = gBS->InstallMultipleProtocolInterfaces (

+                              &DriverBinding->DriverBindingHandle,

+                              &gEfiDriverBindingProtocolGuid, DriverBinding,

+                              &gEfiComponentNameProtocolGuid, ComponentName,

+                              &gEfiDriverConfigurationProtocolGuid, DriverConfiguration,

+                              &gEfiDriverConfiguration2ProtocolGuid, DriverConfiguration2,

+                              &gEfiDriverDiagnosticsProtocolGuid, DriverDiagnostics,

+                              &gEfiDriverDiagnostics2ProtocolGuid, DriverDiagnostics2,

+                              NULL

+                              );

+            } else {

+              Status = gBS->InstallMultipleProtocolInterfaces (

+                              &DriverBinding->DriverBindingHandle,

+                              &gEfiDriverBindingProtocolGuid, DriverBinding,

+                              &gEfiComponentNameProtocolGuid, ComponentName,

+                              &gEfiComponentName2ProtocolGuid, ComponentName2,

+                              &gEfiDriverConfigurationProtocolGuid, DriverConfiguration,

+                              &gEfiDriverConfiguration2ProtocolGuid, DriverConfiguration2,

+                              &gEfiDriverDiagnosticsProtocolGuid, DriverDiagnostics,

+                              &gEfiDriverDiagnostics2ProtocolGuid, DriverDiagnostics2,

+                              NULL

+                              );

+            }

+          }

+        }

+      }

+    }

+  }

+

+  //

+  // ASSERT if the call to InstallMultipleProtocolInterfaces() failed

+  //

+  ASSERT_EFI_ERROR (Status);

+

+  return Status;

+}

+

+

+

+/**

+  Uninstalls Driver Binding Protocol with optional Component Name, Component Name 2, Driver

+  Configuration, Driver Configuration 2, Driver Diagnostics, and Driver Diagnostics 2 Protocols.

+

+  If DriverBinding is NULL, then ASSERT().

+  If the installation fails, then ASSERT().

+

+

+  @param  DriverBinding         A Driver Binding Protocol instance that this driver produced.

+  @param  ComponentName         A Component Name Protocol instance that this driver produced.

+  @param  ComponentName2        A Component Name 2 Protocol instance that this driver produced.

+  @param  DriverConfiguration   A Driver Configuration Protocol instance that this driver produced.

+  @param  DriverConfiguration2  A Driver Configuration Protocol 2 instance that this driver produced.

+  @param  DriverDiagnostics     A Driver Diagnostics Protocol instance that this driver produced.

+  @param  DriverDiagnostics2    A Driver Diagnostics Protocol 2 instance that this driver produced.

+

+  @retval EFI_SUCCESS           The protocol uninstallation successfully completed.

+  @retval Others                Status from gBS->UninstallMultipleProtocolInterfaces().

+

+**/

+EFI_STATUS

+EFIAPI

+EfiLibUninstallAllDriverProtocols2 (

+  IN EFI_DRIVER_BINDING_PROTOCOL              *DriverBinding,

+  IN CONST EFI_COMPONENT_NAME_PROTOCOL        *ComponentName,        OPTIONAL

+  IN CONST EFI_COMPONENT_NAME2_PROTOCOL       *ComponentName2,       OPTIONAL

+  IN CONST EFI_DRIVER_CONFIGURATION_PROTOCOL  *DriverConfiguration,  OPTIONAL

+  IN CONST EFI_DRIVER_CONFIGURATION2_PROTOCOL *DriverConfiguration2, OPTIONAL

+  IN CONST EFI_DRIVER_DIAGNOSTICS_PROTOCOL    *DriverDiagnostics,    OPTIONAL

+  IN CONST EFI_DRIVER_DIAGNOSTICS2_PROTOCOL   *DriverDiagnostics2    OPTIONAL

+  )

+{

+  EFI_STATUS  Status;

+

+  ASSERT (DriverBinding != NULL);

+

+  if (DriverConfiguration2 == NULL) {

+    if (DriverConfiguration == NULL) {

+      if (DriverDiagnostics == NULL || FeaturePcdGet(PcdDriverDiagnosticsDisable)) {

+        if (DriverDiagnostics2 == NULL || FeaturePcdGet(PcdDriverDiagnostics2Disable)) {

+          if (ComponentName == NULL || FeaturePcdGet(PcdComponentNameDisable)) {

+            if (ComponentName2 == NULL || FeaturePcdGet(PcdComponentName2Disable)) {

+              Status = gBS->UninstallMultipleProtocolInterfaces (

+                              DriverBinding->DriverBindingHandle,

+                              &gEfiDriverBindingProtocolGuid, DriverBinding,

+                              NULL

+                              );

+            } else {

+              Status = gBS->UninstallMultipleProtocolInterfaces (

+                              DriverBinding->DriverBindingHandle,

+                              &gEfiDriverBindingProtocolGuid, DriverBinding,

+                              &gEfiComponentName2ProtocolGuid, ComponentName2,

+                              NULL

+                              );

+            }

+          } else {

+            if (ComponentName2 == NULL || FeaturePcdGet(PcdComponentName2Disable)) {

+              Status = gBS->UninstallMultipleProtocolInterfaces (

+                              DriverBinding->DriverBindingHandle,

+                              &gEfiDriverBindingProtocolGuid, DriverBinding,

+                              &gEfiComponentNameProtocolGuid, ComponentName,

+                              NULL

+                              );

+            } else {

+              Status = gBS->UninstallMultipleProtocolInterfaces (

+                              DriverBinding->DriverBindingHandle,

+                              &gEfiDriverBindingProtocolGuid, DriverBinding,

+                              &gEfiComponentNameProtocolGuid, ComponentName,

+                              &gEfiComponentName2ProtocolGuid, ComponentName2,

+                              NULL

+                              );

+            }

+          }

+        } else {

+          if (ComponentName == NULL || FeaturePcdGet(PcdComponentNameDisable)) {

+            if (ComponentName2 == NULL || FeaturePcdGet(PcdComponentName2Disable)) {

+              Status = gBS->UninstallMultipleProtocolInterfaces (

+                              DriverBinding->DriverBindingHandle,

+                              &gEfiDriverBindingProtocolGuid, DriverBinding,

+                              &gEfiDriverDiagnostics2ProtocolGuid, DriverDiagnostics2,

+                              NULL

+                              );

+            } else {

+              Status = gBS->UninstallMultipleProtocolInterfaces (

+                              DriverBinding->DriverBindingHandle,

+                              &gEfiDriverBindingProtocolGuid, DriverBinding,

+                              &gEfiComponentName2ProtocolGuid, ComponentName2,

+                              &gEfiDriverDiagnostics2ProtocolGuid, DriverDiagnostics2,

+                              NULL

+                              );

+            }

+          } else {

+            if (ComponentName2 == NULL || FeaturePcdGet(PcdComponentName2Disable)) {

+              Status = gBS->UninstallMultipleProtocolInterfaces (

+                              DriverBinding->DriverBindingHandle,

+                              &gEfiDriverBindingProtocolGuid, DriverBinding,

+                              &gEfiComponentNameProtocolGuid, ComponentName,

+                              &gEfiDriverDiagnostics2ProtocolGuid, DriverDiagnostics2,

+                              NULL

+                              );

+            } else {

+              Status = gBS->UninstallMultipleProtocolInterfaces (

+                              DriverBinding->DriverBindingHandle,

+                              &gEfiDriverBindingProtocolGuid, DriverBinding,

+                              &gEfiComponentNameProtocolGuid, ComponentName,

+                              &gEfiComponentName2ProtocolGuid, ComponentName2,

+                              &gEfiDriverDiagnostics2ProtocolGuid, DriverDiagnostics2,

+                              NULL

+                              );

+            }

+          }

+        }

+      } else {

+        if (DriverDiagnostics2 == NULL || FeaturePcdGet(PcdDriverDiagnostics2Disable)) {

+          if (ComponentName == NULL || FeaturePcdGet(PcdComponentNameDisable)) {

+            if (ComponentName2 == NULL || FeaturePcdGet(PcdComponentName2Disable)) {

+              Status = gBS->UninstallMultipleProtocolInterfaces (

+                              DriverBinding->DriverBindingHandle,

+                              &gEfiDriverBindingProtocolGuid, DriverBinding,

+                              &gEfiDriverDiagnosticsProtocolGuid, DriverDiagnostics,

+                              NULL

+                              );

+            } else {

+              Status = gBS->UninstallMultipleProtocolInterfaces (

+                              DriverBinding->DriverBindingHandle,

+                              &gEfiDriverBindingProtocolGuid, DriverBinding,

+                              &gEfiComponentName2ProtocolGuid, ComponentName2,

+                              &gEfiDriverDiagnosticsProtocolGuid, DriverDiagnostics,

+                              NULL

+                              );

+            }

+          } else {

+            if (ComponentName2 == NULL || FeaturePcdGet(PcdComponentName2Disable)) {

+              Status = gBS->UninstallMultipleProtocolInterfaces (

+                              DriverBinding->DriverBindingHandle,

+                              &gEfiDriverBindingProtocolGuid, DriverBinding,

+                              &gEfiComponentNameProtocolGuid, ComponentName,

+                              &gEfiDriverDiagnosticsProtocolGuid, DriverDiagnostics,

+                              NULL

+                              );

+            } else {

+              Status = gBS->UninstallMultipleProtocolInterfaces (

+                              DriverBinding->DriverBindingHandle,

+                              &gEfiDriverBindingProtocolGuid, DriverBinding,

+                              &gEfiComponentNameProtocolGuid, ComponentName,

+                              &gEfiComponentName2ProtocolGuid, ComponentName2,

+                              &gEfiDriverDiagnosticsProtocolGuid, DriverDiagnostics,

+                              NULL

+                              );

+            }

+          }

+        } else {

+          if (ComponentName == NULL || FeaturePcdGet(PcdComponentNameDisable)) {

+            if (ComponentName2 == NULL || FeaturePcdGet(PcdComponentName2Disable)) {

+              Status = gBS->UninstallMultipleProtocolInterfaces (

+                              DriverBinding->DriverBindingHandle,

+                              &gEfiDriverBindingProtocolGuid, DriverBinding,

+                              &gEfiDriverDiagnosticsProtocolGuid, DriverDiagnostics,

+                              &gEfiDriverDiagnostics2ProtocolGuid, DriverDiagnostics2,

+                              NULL

+                              );

+            } else {

+              Status = gBS->UninstallMultipleProtocolInterfaces (

+                              DriverBinding->DriverBindingHandle,

+                              &gEfiDriverBindingProtocolGuid, DriverBinding,

+                              &gEfiComponentName2ProtocolGuid, ComponentName2,

+                              &gEfiDriverDiagnosticsProtocolGuid, DriverDiagnostics,

+                              &gEfiDriverDiagnostics2ProtocolGuid, DriverDiagnostics2,

+                              NULL

+                              );

+            }

+          } else {

+            if (ComponentName2 == NULL || FeaturePcdGet(PcdComponentName2Disable)) {

+              Status = gBS->UninstallMultipleProtocolInterfaces (

+                              DriverBinding->DriverBindingHandle,

+                              &gEfiDriverBindingProtocolGuid, DriverBinding,

+                              &gEfiComponentNameProtocolGuid, ComponentName,

+                              &gEfiDriverDiagnosticsProtocolGuid, DriverDiagnostics,

+                              &gEfiDriverDiagnostics2ProtocolGuid, DriverDiagnostics2,

+                              NULL

+                              );

+            } else {

+              Status = gBS->UninstallMultipleProtocolInterfaces (

+                              DriverBinding->DriverBindingHandle,

+                              &gEfiDriverBindingProtocolGuid, DriverBinding,

+                              &gEfiComponentNameProtocolGuid, ComponentName,

+                              &gEfiComponentName2ProtocolGuid, ComponentName2,

+                              &gEfiDriverDiagnosticsProtocolGuid, DriverDiagnostics,

+                              &gEfiDriverDiagnostics2ProtocolGuid, DriverDiagnostics2,

+                              NULL

+                              );

+            }

+          }

+        }

+      }

+    } else {

+      if (DriverDiagnostics == NULL || FeaturePcdGet(PcdDriverDiagnosticsDisable)) {

+        if (DriverDiagnostics2 == NULL || FeaturePcdGet(PcdDriverDiagnostics2Disable)) {

+          if (ComponentName == NULL || FeaturePcdGet(PcdComponentNameDisable)) {

+            if (ComponentName2 == NULL || FeaturePcdGet(PcdComponentName2Disable)) {

+              Status = gBS->UninstallMultipleProtocolInterfaces (

+                              DriverBinding->DriverBindingHandle,

+                              &gEfiDriverBindingProtocolGuid, DriverBinding,

+                              &gEfiDriverConfigurationProtocolGuid, DriverConfiguration,

+                              NULL

+                              );

+            } else {

+              Status = gBS->UninstallMultipleProtocolInterfaces (

+                              DriverBinding->DriverBindingHandle,

+                              &gEfiDriverBindingProtocolGuid, DriverBinding,

+                              &gEfiComponentName2ProtocolGuid, ComponentName2,

+                              &gEfiDriverConfigurationProtocolGuid, DriverConfiguration,

+                              NULL

+                              );

+            }

+          } else {

+            if (ComponentName2 == NULL || FeaturePcdGet(PcdComponentName2Disable)) {

+              Status = gBS->UninstallMultipleProtocolInterfaces (

+                              DriverBinding->DriverBindingHandle,

+                              &gEfiDriverBindingProtocolGuid, DriverBinding,

+                              &gEfiComponentNameProtocolGuid, ComponentName,

+                              &gEfiDriverConfigurationProtocolGuid, DriverConfiguration,

+                              NULL

+                              );

+            } else {

+              Status = gBS->UninstallMultipleProtocolInterfaces (

+                              DriverBinding->DriverBindingHandle,

+                              &gEfiDriverBindingProtocolGuid, DriverBinding,

+                              &gEfiComponentNameProtocolGuid, ComponentName,

+                              &gEfiComponentName2ProtocolGuid, ComponentName2,

+                              &gEfiDriverConfigurationProtocolGuid, DriverConfiguration,

+                              NULL

+                              );

+            }

+          }

+        } else {

+          if (ComponentName == NULL || FeaturePcdGet(PcdComponentNameDisable)) {

+            if (ComponentName2 == NULL || FeaturePcdGet(PcdComponentName2Disable)) {

+              Status = gBS->UninstallMultipleProtocolInterfaces (

+                              DriverBinding->DriverBindingHandle,

+                              &gEfiDriverBindingProtocolGuid, DriverBinding,

+                              &gEfiDriverConfigurationProtocolGuid, DriverConfiguration,

+                              &gEfiDriverDiagnostics2ProtocolGuid, DriverDiagnostics2,

+                              NULL

+                              );

+            } else {

+              Status = gBS->UninstallMultipleProtocolInterfaces (

+                              DriverBinding->DriverBindingHandle,

+                              &gEfiDriverBindingProtocolGuid, DriverBinding,

+                              &gEfiComponentName2ProtocolGuid, ComponentName2,

+                              &gEfiDriverConfigurationProtocolGuid, DriverConfiguration,

+                              &gEfiDriverDiagnostics2ProtocolGuid, DriverDiagnostics2,

+                              NULL

+                              );

+            }

+          } else {

+            if (ComponentName2 == NULL || FeaturePcdGet(PcdComponentName2Disable)) {

+              Status = gBS->UninstallMultipleProtocolInterfaces (

+                              DriverBinding->DriverBindingHandle,

+                              &gEfiDriverBindingProtocolGuid, DriverBinding,

+                              &gEfiComponentNameProtocolGuid, ComponentName,

+                              &gEfiDriverConfigurationProtocolGuid, DriverConfiguration,

+                              &gEfiDriverDiagnostics2ProtocolGuid, DriverDiagnostics2,

+                              NULL

+                              );

+            } else {

+              Status = gBS->UninstallMultipleProtocolInterfaces (

+                              DriverBinding->DriverBindingHandle,

+                              &gEfiDriverBindingProtocolGuid, DriverBinding,

+                              &gEfiComponentNameProtocolGuid, ComponentName,

+                              &gEfiComponentName2ProtocolGuid, ComponentName2,

+                              &gEfiDriverConfigurationProtocolGuid, DriverConfiguration,

+                              &gEfiDriverDiagnostics2ProtocolGuid, DriverDiagnostics2,

+                              NULL

+                              );

+            }

+          }

+        }

+      } else {

+        if (DriverDiagnostics2 == NULL || FeaturePcdGet(PcdDriverDiagnostics2Disable)) {

+          if (ComponentName == NULL || FeaturePcdGet(PcdComponentNameDisable)) {

+            if (ComponentName2 == NULL || FeaturePcdGet(PcdComponentName2Disable)) {

+              Status = gBS->UninstallMultipleProtocolInterfaces (

+                              DriverBinding->DriverBindingHandle,

+                              &gEfiDriverBindingProtocolGuid, DriverBinding,

+                              &gEfiDriverConfigurationProtocolGuid, DriverConfiguration,

+                              &gEfiDriverDiagnosticsProtocolGuid, DriverDiagnostics,

+                              NULL

+                              );

+            } else {

+              Status = gBS->UninstallMultipleProtocolInterfaces (

+                              DriverBinding->DriverBindingHandle,

+                              &gEfiDriverBindingProtocolGuid, DriverBinding,

+                              &gEfiComponentName2ProtocolGuid, ComponentName2,

+                              &gEfiDriverConfigurationProtocolGuid, DriverConfiguration,

+                              &gEfiDriverDiagnosticsProtocolGuid, DriverDiagnostics,

+                              NULL

+                              );

+            }

+          } else {

+            if (ComponentName2 == NULL || FeaturePcdGet(PcdComponentName2Disable)) {

+              Status = gBS->UninstallMultipleProtocolInterfaces (

+                              DriverBinding->DriverBindingHandle,

+                              &gEfiDriverBindingProtocolGuid, DriverBinding,

+                              &gEfiComponentNameProtocolGuid, ComponentName,

+                              &gEfiDriverConfigurationProtocolGuid, DriverConfiguration,

+                              &gEfiDriverDiagnosticsProtocolGuid, DriverDiagnostics,

+                              NULL

+                              );

+            } else {

+              Status = gBS->UninstallMultipleProtocolInterfaces (

+                              DriverBinding->DriverBindingHandle,

+                              &gEfiDriverBindingProtocolGuid, DriverBinding,

+                              &gEfiComponentNameProtocolGuid, ComponentName,

+                              &gEfiComponentName2ProtocolGuid, ComponentName2,

+                              &gEfiDriverConfigurationProtocolGuid, DriverConfiguration,

+                              &gEfiDriverDiagnosticsProtocolGuid, DriverDiagnostics,

+                              NULL

+                              );

+            }

+          }

+        } else {

+          if (ComponentName == NULL || FeaturePcdGet(PcdComponentNameDisable)) {

+            if (ComponentName2 == NULL || FeaturePcdGet(PcdComponentName2Disable)) {

+              Status = gBS->UninstallMultipleProtocolInterfaces (

+                              DriverBinding->DriverBindingHandle,

+                              &gEfiDriverBindingProtocolGuid, DriverBinding,

+                              &gEfiDriverConfigurationProtocolGuid, DriverConfiguration,

+                              &gEfiDriverDiagnosticsProtocolGuid, DriverDiagnostics,

+                              &gEfiDriverDiagnostics2ProtocolGuid, DriverDiagnostics2,

+                              NULL

+                              );

+            } else {

+              Status = gBS->UninstallMultipleProtocolInterfaces (

+                              DriverBinding->DriverBindingHandle,

+                              &gEfiDriverBindingProtocolGuid, DriverBinding,

+                              &gEfiComponentName2ProtocolGuid, ComponentName2,

+                              &gEfiDriverConfigurationProtocolGuid, DriverConfiguration,

+                              &gEfiDriverDiagnosticsProtocolGuid, DriverDiagnostics,

+                              &gEfiDriverDiagnostics2ProtocolGuid, DriverDiagnostics2,

+                              NULL

+                              );

+            }

+          } else {

+            if (ComponentName2 == NULL || FeaturePcdGet(PcdComponentName2Disable)) {

+              Status = gBS->UninstallMultipleProtocolInterfaces (

+                              DriverBinding->DriverBindingHandle,

+                              &gEfiDriverBindingProtocolGuid, DriverBinding,

+                              &gEfiComponentNameProtocolGuid, ComponentName,

+                              &gEfiDriverConfigurationProtocolGuid, DriverConfiguration,

+                              &gEfiDriverDiagnosticsProtocolGuid, DriverDiagnostics,

+                              &gEfiDriverDiagnostics2ProtocolGuid, DriverDiagnostics2,

+                              NULL

+                              );

+            } else {

+              Status = gBS->UninstallMultipleProtocolInterfaces (

+                              DriverBinding->DriverBindingHandle,

+                              &gEfiDriverBindingProtocolGuid, DriverBinding,

+                              &gEfiComponentNameProtocolGuid, ComponentName,

+                              &gEfiComponentName2ProtocolGuid, ComponentName2,

+                              &gEfiDriverConfigurationProtocolGuid, DriverConfiguration,

+                              &gEfiDriverDiagnosticsProtocolGuid, DriverDiagnostics,

+                              &gEfiDriverDiagnostics2ProtocolGuid, DriverDiagnostics2,

+                              NULL

+                              );

+            }

+          }

+        }

+      }

+    }

+  } else {

+    if (DriverConfiguration == NULL) {

+      if (DriverDiagnostics == NULL || FeaturePcdGet(PcdDriverDiagnosticsDisable)) {

+        if (DriverDiagnostics2 == NULL || FeaturePcdGet(PcdDriverDiagnostics2Disable)) {

+          if (ComponentName == NULL || FeaturePcdGet(PcdComponentNameDisable)) {

+            if (ComponentName2 == NULL || FeaturePcdGet(PcdComponentName2Disable)) {

+              Status = gBS->UninstallMultipleProtocolInterfaces (

+                              DriverBinding->DriverBindingHandle,

+                              &gEfiDriverBindingProtocolGuid, DriverBinding,

+                              &gEfiDriverConfiguration2ProtocolGuid, DriverConfiguration2,

+                              NULL

+                              );

+            } else {

+              Status = gBS->UninstallMultipleProtocolInterfaces (

+                              DriverBinding->DriverBindingHandle,

+                              &gEfiDriverBindingProtocolGuid, DriverBinding,

+                              &gEfiComponentName2ProtocolGuid, ComponentName2,

+                              &gEfiDriverConfiguration2ProtocolGuid, DriverConfiguration2,

+                              NULL

+                              );

+            }

+          } else {

+            if (ComponentName2 == NULL || FeaturePcdGet(PcdComponentName2Disable)) {

+              Status = gBS->UninstallMultipleProtocolInterfaces (

+                              DriverBinding->DriverBindingHandle,

+                              &gEfiDriverBindingProtocolGuid, DriverBinding,

+                              &gEfiComponentNameProtocolGuid, ComponentName,

+                              &gEfiDriverConfiguration2ProtocolGuid, DriverConfiguration2,

+                              NULL

+                              );

+            } else {

+              Status = gBS->UninstallMultipleProtocolInterfaces (

+                              DriverBinding->DriverBindingHandle,

+                              &gEfiDriverBindingProtocolGuid, DriverBinding,

+                              &gEfiComponentNameProtocolGuid, ComponentName,

+                              &gEfiComponentName2ProtocolGuid, ComponentName2,

+                              &gEfiDriverConfiguration2ProtocolGuid, DriverConfiguration2,

+                              NULL

+                              );

+            }

+          }

+        } else {

+          if (ComponentName == NULL || FeaturePcdGet(PcdComponentNameDisable)) {

+            if (ComponentName2 == NULL || FeaturePcdGet(PcdComponentName2Disable)) {

+              Status = gBS->UninstallMultipleProtocolInterfaces (

+                              DriverBinding->DriverBindingHandle,

+                              &gEfiDriverBindingProtocolGuid, DriverBinding,

+                              &gEfiDriverDiagnostics2ProtocolGuid, DriverDiagnostics2,

+                              &gEfiDriverConfiguration2ProtocolGuid, DriverConfiguration2,

+                              NULL

+                              );

+            } else {

+              Status = gBS->UninstallMultipleProtocolInterfaces (

+                              DriverBinding->DriverBindingHandle,

+                              &gEfiDriverBindingProtocolGuid, DriverBinding,

+                              &gEfiComponentName2ProtocolGuid, ComponentName2,

+                              &gEfiDriverConfiguration2ProtocolGuid, DriverConfiguration2,

+                              &gEfiDriverDiagnostics2ProtocolGuid, DriverDiagnostics2,

+                              NULL

+                              );

+            }

+          } else {

+            if (ComponentName2 == NULL || FeaturePcdGet(PcdComponentName2Disable)) {

+              Status = gBS->UninstallMultipleProtocolInterfaces (

+                              DriverBinding->DriverBindingHandle,

+                              &gEfiDriverBindingProtocolGuid, DriverBinding,

+                              &gEfiComponentNameProtocolGuid, ComponentName,

+                              &gEfiDriverConfiguration2ProtocolGuid, DriverConfiguration2,

+                              &gEfiDriverDiagnostics2ProtocolGuid, DriverDiagnostics2,

+                              NULL

+                              );

+            } else {

+              Status = gBS->UninstallMultipleProtocolInterfaces (

+                              DriverBinding->DriverBindingHandle,

+                              &gEfiDriverBindingProtocolGuid, DriverBinding,

+                              &gEfiComponentNameProtocolGuid, ComponentName,

+                              &gEfiComponentName2ProtocolGuid, ComponentName2,

+                              &gEfiDriverConfiguration2ProtocolGuid, DriverConfiguration2,

+                              &gEfiDriverDiagnostics2ProtocolGuid, DriverDiagnostics2,

+                              NULL

+                              );

+            }

+          }

+        }

+      } else {

+        if (DriverDiagnostics2 == NULL || FeaturePcdGet(PcdDriverDiagnostics2Disable)) {

+          if (ComponentName == NULL || FeaturePcdGet(PcdComponentNameDisable)) {

+            if (ComponentName2 == NULL || FeaturePcdGet(PcdComponentName2Disable)) {

+              Status = gBS->UninstallMultipleProtocolInterfaces (

+                              DriverBinding->DriverBindingHandle,

+                              &gEfiDriverBindingProtocolGuid, DriverBinding,

+                              &gEfiDriverDiagnosticsProtocolGuid, DriverDiagnostics,

+                              &gEfiDriverConfiguration2ProtocolGuid, DriverConfiguration2,

+                              NULL

+                              );

+            } else {

+              Status = gBS->UninstallMultipleProtocolInterfaces (

+                              DriverBinding->DriverBindingHandle,

+                              &gEfiDriverBindingProtocolGuid, DriverBinding,

+                              &gEfiComponentName2ProtocolGuid, ComponentName2,

+                              &gEfiDriverConfiguration2ProtocolGuid, DriverConfiguration2,

+                              &gEfiDriverDiagnosticsProtocolGuid, DriverDiagnostics,

+                              NULL

+                              );

+            }

+          } else {

+            if (ComponentName2 == NULL || FeaturePcdGet(PcdComponentName2Disable)) {

+              Status = gBS->UninstallMultipleProtocolInterfaces (

+                              DriverBinding->DriverBindingHandle,

+                              &gEfiDriverBindingProtocolGuid, DriverBinding,

+                              &gEfiComponentNameProtocolGuid, ComponentName,

+                              &gEfiDriverDiagnosticsProtocolGuid, DriverDiagnostics,

+                              &gEfiDriverConfiguration2ProtocolGuid, DriverConfiguration2,

+                              NULL

+                              );

+            } else {

+              Status = gBS->UninstallMultipleProtocolInterfaces (

+                              DriverBinding->DriverBindingHandle,

+                              &gEfiDriverBindingProtocolGuid, DriverBinding,

+                              &gEfiComponentNameProtocolGuid, ComponentName,

+                              &gEfiComponentName2ProtocolGuid, ComponentName2,

+                              &gEfiDriverConfiguration2ProtocolGuid, DriverConfiguration2,

+                              &gEfiDriverDiagnosticsProtocolGuid, DriverDiagnostics,

+                              NULL

+                              );

+            }

+          }

+        } else {

+          if (ComponentName == NULL || FeaturePcdGet(PcdComponentNameDisable)) {

+            if (ComponentName2 == NULL || FeaturePcdGet(PcdComponentName2Disable)) {

+              Status = gBS->UninstallMultipleProtocolInterfaces (

+                              DriverBinding->DriverBindingHandle,

+                              &gEfiDriverBindingProtocolGuid, DriverBinding,

+                              &gEfiDriverConfiguration2ProtocolGuid, DriverConfiguration2,

+                              &gEfiDriverDiagnosticsProtocolGuid, DriverDiagnostics,

+                              &gEfiDriverDiagnostics2ProtocolGuid, DriverDiagnostics2,

+                              NULL

+                              );

+            } else {

+              Status = gBS->UninstallMultipleProtocolInterfaces (

+                              DriverBinding->DriverBindingHandle,

+                              &gEfiDriverBindingProtocolGuid, DriverBinding,

+                              &gEfiComponentName2ProtocolGuid, ComponentName2,

+                              &gEfiDriverConfiguration2ProtocolGuid, DriverConfiguration2,

+                              &gEfiDriverDiagnosticsProtocolGuid, DriverDiagnostics,

+                              &gEfiDriverDiagnostics2ProtocolGuid, DriverDiagnostics2,

+                              NULL

+                              );

+            }

+          } else {

+            if (ComponentName2 == NULL || FeaturePcdGet(PcdComponentName2Disable)) {

+              Status = gBS->UninstallMultipleProtocolInterfaces (

+                              DriverBinding->DriverBindingHandle,

+                              &gEfiDriverBindingProtocolGuid, DriverBinding,

+                              &gEfiComponentNameProtocolGuid, ComponentName,

+                              &gEfiDriverConfiguration2ProtocolGuid, DriverConfiguration2,

+                              &gEfiDriverDiagnosticsProtocolGuid, DriverDiagnostics,

+                              &gEfiDriverDiagnostics2ProtocolGuid, DriverDiagnostics2,

+                              NULL

+                              );

+            } else {

+              Status = gBS->UninstallMultipleProtocolInterfaces (

+                              DriverBinding->DriverBindingHandle,

+                              &gEfiDriverBindingProtocolGuid, DriverBinding,

+                              &gEfiComponentNameProtocolGuid, ComponentName,

+                              &gEfiComponentName2ProtocolGuid, ComponentName2,

+                              &gEfiDriverConfiguration2ProtocolGuid, DriverConfiguration2,

+                              &gEfiDriverDiagnosticsProtocolGuid, DriverDiagnostics,

+                              &gEfiDriverDiagnostics2ProtocolGuid, DriverDiagnostics2,

+                              NULL

+                              );

+            }

+          }

+        }

+      }

+    } else {

+      if (DriverDiagnostics == NULL || FeaturePcdGet(PcdDriverDiagnosticsDisable)) {

+        if (DriverDiagnostics2 == NULL || FeaturePcdGet(PcdDriverDiagnostics2Disable)) {

+          if (ComponentName == NULL || FeaturePcdGet(PcdComponentNameDisable)) {

+            if (ComponentName2 == NULL || FeaturePcdGet(PcdComponentName2Disable)) {

+              Status = gBS->UninstallMultipleProtocolInterfaces (

+                              DriverBinding->DriverBindingHandle,

+                              &gEfiDriverBindingProtocolGuid, DriverBinding,

+                              &gEfiDriverConfigurationProtocolGuid, DriverConfiguration,

+                              &gEfiDriverConfiguration2ProtocolGuid, DriverConfiguration2,

+                              NULL

+                              );

+            } else {

+              Status = gBS->UninstallMultipleProtocolInterfaces (

+                              DriverBinding->DriverBindingHandle,

+                              &gEfiDriverBindingProtocolGuid, DriverBinding,

+                              &gEfiComponentName2ProtocolGuid, ComponentName2,

+                              &gEfiDriverConfigurationProtocolGuid, DriverConfiguration,

+                              &gEfiDriverConfiguration2ProtocolGuid, DriverConfiguration2,

+                              NULL

+                              );

+            }

+          } else {

+            if (ComponentName2 == NULL || FeaturePcdGet(PcdComponentName2Disable)) {

+              Status = gBS->UninstallMultipleProtocolInterfaces (

+                              DriverBinding->DriverBindingHandle,

+                              &gEfiDriverBindingProtocolGuid, DriverBinding,

+                              &gEfiComponentNameProtocolGuid, ComponentName,

+                              &gEfiDriverConfigurationProtocolGuid, DriverConfiguration,

+                              &gEfiDriverConfiguration2ProtocolGuid, DriverConfiguration2,

+                              NULL

+                              );

+            } else {

+              Status = gBS->UninstallMultipleProtocolInterfaces (

+                              DriverBinding->DriverBindingHandle,

+                              &gEfiDriverBindingProtocolGuid, DriverBinding,

+                              &gEfiComponentNameProtocolGuid, ComponentName,

+                              &gEfiComponentName2ProtocolGuid, ComponentName2,

+                              &gEfiDriverConfigurationProtocolGuid, DriverConfiguration,

+                              &gEfiDriverConfiguration2ProtocolGuid, DriverConfiguration2,

+                              NULL

+                              );

+            }

+          }

+        } else {

+          if (ComponentName == NULL || FeaturePcdGet(PcdComponentNameDisable)) {

+            if (ComponentName2 == NULL || FeaturePcdGet(PcdComponentName2Disable)) {

+              Status = gBS->UninstallMultipleProtocolInterfaces (

+                              DriverBinding->DriverBindingHandle,

+                              &gEfiDriverBindingProtocolGuid, DriverBinding,

+                              &gEfiDriverConfigurationProtocolGuid, DriverConfiguration,

+                              &gEfiDriverConfiguration2ProtocolGuid, DriverConfiguration2,

+                              &gEfiDriverDiagnostics2ProtocolGuid, DriverDiagnostics2,

+                              NULL

+                              );

+            } else {

+              Status = gBS->UninstallMultipleProtocolInterfaces (

+                              DriverBinding->DriverBindingHandle,

+                              &gEfiDriverBindingProtocolGuid, DriverBinding,

+                              &gEfiComponentName2ProtocolGuid, ComponentName2,

+                              &gEfiDriverConfigurationProtocolGuid, DriverConfiguration,

+                              &gEfiDriverConfiguration2ProtocolGuid, DriverConfiguration2,

+                              &gEfiDriverDiagnostics2ProtocolGuid, DriverDiagnostics2,

+                              NULL

+                              );

+            }

+          } else {

+            if (ComponentName2 == NULL || FeaturePcdGet(PcdComponentName2Disable)) {

+              Status = gBS->UninstallMultipleProtocolInterfaces (

+                              DriverBinding->DriverBindingHandle,

+                              &gEfiDriverBindingProtocolGuid, DriverBinding,

+                              &gEfiComponentNameProtocolGuid, ComponentName,

+                              &gEfiDriverConfigurationProtocolGuid, DriverConfiguration,

+                              &gEfiDriverConfiguration2ProtocolGuid, DriverConfiguration2,

+                              &gEfiDriverDiagnostics2ProtocolGuid, DriverDiagnostics2,

+                              NULL

+                              );

+            } else {

+              Status = gBS->UninstallMultipleProtocolInterfaces (

+                              DriverBinding->DriverBindingHandle,

+                              &gEfiDriverBindingProtocolGuid, DriverBinding,

+                              &gEfiComponentNameProtocolGuid, ComponentName,

+                              &gEfiComponentName2ProtocolGuid, ComponentName2,

+                              &gEfiDriverConfigurationProtocolGuid, DriverConfiguration,

+                              &gEfiDriverConfiguration2ProtocolGuid, DriverConfiguration2,

+                              &gEfiDriverDiagnostics2ProtocolGuid, DriverDiagnostics2,

+                              NULL

+                              );

+            }

+          }

+        }

+      } else {

+        if (DriverDiagnostics2 == NULL || FeaturePcdGet(PcdDriverDiagnostics2Disable)) {

+          if (ComponentName == NULL || FeaturePcdGet(PcdComponentNameDisable)) {

+            if (ComponentName2 == NULL || FeaturePcdGet(PcdComponentName2Disable)) {

+              Status = gBS->UninstallMultipleProtocolInterfaces (

+                              DriverBinding->DriverBindingHandle,

+                              &gEfiDriverBindingProtocolGuid, DriverBinding,

+                              &gEfiDriverConfigurationProtocolGuid, DriverConfiguration,

+                              &gEfiDriverConfiguration2ProtocolGuid, DriverConfiguration2,

+                              &gEfiDriverDiagnosticsProtocolGuid, DriverDiagnostics,

+                              NULL

+                              );

+            } else {

+              Status = gBS->UninstallMultipleProtocolInterfaces (

+                              DriverBinding->DriverBindingHandle,

+                              &gEfiDriverBindingProtocolGuid, DriverBinding,

+                              &gEfiComponentName2ProtocolGuid, ComponentName2,

+                              &gEfiDriverConfigurationProtocolGuid, DriverConfiguration,

+                              &gEfiDriverConfiguration2ProtocolGuid, DriverConfiguration2,

+                              &gEfiDriverDiagnosticsProtocolGuid, DriverDiagnostics,

+                              NULL

+                              );

+            }

+          } else {

+            if (ComponentName2 == NULL || FeaturePcdGet(PcdComponentName2Disable)) {

+              Status = gBS->UninstallMultipleProtocolInterfaces (

+                              DriverBinding->DriverBindingHandle,

+                              &gEfiDriverBindingProtocolGuid, DriverBinding,

+                              &gEfiComponentNameProtocolGuid, ComponentName,

+                              &gEfiDriverConfigurationProtocolGuid, DriverConfiguration,

+                              &gEfiDriverConfiguration2ProtocolGuid, DriverConfiguration2,

+                              &gEfiDriverDiagnosticsProtocolGuid, DriverDiagnostics,

+                              NULL

+                              );

+            } else {

+              Status = gBS->UninstallMultipleProtocolInterfaces (

+                              DriverBinding->DriverBindingHandle,

+                              &gEfiDriverBindingProtocolGuid, DriverBinding,

+                              &gEfiComponentNameProtocolGuid, ComponentName,

+                              &gEfiComponentName2ProtocolGuid, ComponentName2,

+                              &gEfiDriverConfigurationProtocolGuid, DriverConfiguration,

+                              &gEfiDriverConfiguration2ProtocolGuid, DriverConfiguration2,

+                              &gEfiDriverDiagnosticsProtocolGuid, DriverDiagnostics,

+                              NULL

+                              );

+            }

+          }

+        } else {

+          if (ComponentName == NULL || FeaturePcdGet(PcdComponentNameDisable)) {

+            if (ComponentName2 == NULL || FeaturePcdGet(PcdComponentName2Disable)) {

+              Status = gBS->UninstallMultipleProtocolInterfaces (

+                              DriverBinding->DriverBindingHandle,

+                              &gEfiDriverBindingProtocolGuid, DriverBinding,

+                              &gEfiDriverConfigurationProtocolGuid, DriverConfiguration,

+                              &gEfiDriverConfiguration2ProtocolGuid, DriverConfiguration2,

+                              &gEfiDriverDiagnosticsProtocolGuid, DriverDiagnostics,

+                              &gEfiDriverDiagnostics2ProtocolGuid, DriverDiagnostics2,

+                              NULL

+                              );

+            } else {

+              Status = gBS->UninstallMultipleProtocolInterfaces (

+                              DriverBinding->DriverBindingHandle,

+                              &gEfiDriverBindingProtocolGuid, DriverBinding,

+                              &gEfiComponentName2ProtocolGuid, ComponentName2,

+                              &gEfiDriverConfigurationProtocolGuid, DriverConfiguration,

+                              &gEfiDriverConfiguration2ProtocolGuid, DriverConfiguration2,

+                              &gEfiDriverDiagnosticsProtocolGuid, DriverDiagnostics,

+                              &gEfiDriverDiagnostics2ProtocolGuid, DriverDiagnostics2,

+                              NULL

+                              );

+            }

+          } else {

+            if (ComponentName2 == NULL || FeaturePcdGet(PcdComponentName2Disable)) {

+              Status = gBS->UninstallMultipleProtocolInterfaces (

+                              DriverBinding->DriverBindingHandle,

+                              &gEfiDriverBindingProtocolGuid, DriverBinding,

+                              &gEfiComponentNameProtocolGuid, ComponentName,

+                              &gEfiDriverConfigurationProtocolGuid, DriverConfiguration,

+                              &gEfiDriverConfiguration2ProtocolGuid, DriverConfiguration2,

+                              &gEfiDriverDiagnosticsProtocolGuid, DriverDiagnostics,

+                              &gEfiDriverDiagnostics2ProtocolGuid, DriverDiagnostics2,

+                              NULL

+                              );

+            } else {

+              Status = gBS->UninstallMultipleProtocolInterfaces (

+                              DriverBinding->DriverBindingHandle,

+                              &gEfiDriverBindingProtocolGuid, DriverBinding,

+                              &gEfiComponentNameProtocolGuid, ComponentName,

+                              &gEfiComponentName2ProtocolGuid, ComponentName2,

+                              &gEfiDriverConfigurationProtocolGuid, DriverConfiguration,

+                              &gEfiDriverConfiguration2ProtocolGuid, DriverConfiguration2,

+                              &gEfiDriverDiagnosticsProtocolGuid, DriverDiagnostics,

+                              &gEfiDriverDiagnostics2ProtocolGuid, DriverDiagnostics2,

+                              NULL

+                              );

+            }

+          }

+        }

+      }

+    }

+  }

+

+  //

+  // ASSERT if the call to UninstallMultipleProtocolInterfaces() failed

+  //

+  ASSERT_EFI_ERROR (Status);

+

+  return Status;

+}

diff --git a/debugging_demo/memtest86+/efi/Include/src/UefiLib/UefiLib.c b/debugging_demo/memtest86+/efi/Include/src/UefiLib/UefiLib.c
new file mode 100644
index 0000000..b6a33a0
--- /dev/null
+++ b/debugging_demo/memtest86+/efi/Include/src/UefiLib/UefiLib.c
@@ -0,0 +1,1921 @@
+/** @file

+  The UEFI Library provides functions and macros that simplify the development of

+  UEFI Drivers and UEFI Applications.  These functions and macros help manage EFI

+  events, build simple locks utilizing EFI Task Priority Levels (TPLs), install

+  EFI Driver Model related protocols, manage Unicode string tables for UEFI Drivers,

+  and print messages on the console output and standard error devices.

+

+  Copyright (c) 2006 - 2018, Intel Corporation. All rights reserved.<BR>

+  SPDX-License-Identifier: BSD-2-Clause-Patent

+

+**/

+

+

+#include "UefiLibInternal.h"

+

+/**

+  Empty constructor function that is required to resolve dependencies between

+  libraries.

+

+    ** DO NOT REMOVE **

+

+  @param  ImageHandle   The firmware allocated handle for the EFI image.

+  @param  SystemTable   A pointer to the EFI System Table.

+

+  @retval EFI_SUCCESS   The constructor executed correctly.

+

+**/

+EFI_STATUS

+EFIAPI

+UefiLibConstructor (

+  IN EFI_HANDLE        ImageHandle,

+  IN EFI_SYSTEM_TABLE  *SystemTable

+  )

+{

+  return EFI_SUCCESS;

+}

+

+/**

+  Compare whether two names of languages are identical.

+

+  @param  Language1 Name of language 1.

+  @param  Language2 Name of language 2.

+

+  @retval TRUE      Language 1 and language 2 are the same.

+  @retval FALSE     Language 1 and language 2 are not the same.

+

+**/

+BOOLEAN

+CompareIso639LanguageCode (

+  IN CONST CHAR8  *Language1,

+  IN CONST CHAR8  *Language2

+  )

+{

+  UINT32  Name1;

+  UINT32  Name2;

+

+  Name1 = ReadUnaligned24 ((CONST UINT32 *) Language1);

+  Name2 = ReadUnaligned24 ((CONST UINT32 *) Language2);

+

+  return (BOOLEAN) (Name1 == Name2);

+}

+

+/**

+  Retrieves a pointer to the system configuration table from the EFI System Table

+  based on a specified GUID.

+

+  This function searches the list of configuration tables stored in the EFI System Table

+  for a table with a GUID that matches TableGuid.  If a match is found, then a pointer to

+  the configuration table is returned in Table., and EFI_SUCCESS is returned. If a matching GUID

+  is not found, then EFI_NOT_FOUND is returned.

+  If TableGuid is NULL, then ASSERT().

+  If Table is NULL, then ASSERT().

+

+  @param  TableGuid       The pointer to table's GUID type.

+  @param  Table           The pointer to the table associated with TableGuid in the EFI System Table.

+

+  @retval EFI_SUCCESS     A configuration table matching TableGuid was found.

+  @retval EFI_NOT_FOUND   A configuration table matching TableGuid could not be found.

+

+**/

+EFI_STATUS

+EFIAPI

+EfiGetSystemConfigurationTable (

+  IN  EFI_GUID  *TableGuid,

+  OUT VOID      **Table

+  )

+{

+  EFI_SYSTEM_TABLE  *SystemTable;

+  UINTN             Index;

+

+  ASSERT (TableGuid != NULL);

+  ASSERT (Table != NULL);

+

+  SystemTable = gST;

+  *Table = NULL;

+  for (Index = 0; Index < SystemTable->NumberOfTableEntries; Index++) {

+    if (CompareGuid (TableGuid, &(SystemTable->ConfigurationTable[Index].VendorGuid))) {

+      *Table = SystemTable->ConfigurationTable[Index].VendorTable;

+      return EFI_SUCCESS;

+    }

+  }

+

+  return EFI_NOT_FOUND;

+}

+

+/**

+  Creates and returns a notification event and registers that event with all the protocol

+  instances specified by ProtocolGuid.

+

+  This function causes the notification function to be executed for every protocol of type

+  ProtocolGuid instance that exists in the system when this function is invoked. If there are

+  no instances of ProtocolGuid in the handle database at the time this function is invoked,

+  then the notification function is still executed one time. In addition, every time a protocol

+  of type ProtocolGuid instance is installed or reinstalled, the notification function is also

+  executed. This function returns the notification event that was created.

+  If ProtocolGuid is NULL, then ASSERT().

+  If NotifyTpl is not a legal TPL value, then ASSERT().

+  If NotifyFunction is NULL, then ASSERT().

+  If Registration is NULL, then ASSERT().

+

+

+  @param  ProtocolGuid    Supplies GUID of the protocol upon whose installation the event is fired.

+  @param  NotifyTpl       Supplies the task priority level of the event notifications.

+  @param  NotifyFunction  Supplies the function to notify when the event is signaled.

+  @param  NotifyContext   The context parameter to pass to NotifyFunction.

+  @param  Registration    A pointer to a memory location to receive the registration value.

+                          This value is passed to LocateHandle() to obtain new handles that

+                          have been added that support the ProtocolGuid-specified protocol.

+

+  @return The notification event that was created.

+

+**/

+EFI_EVENT

+EFIAPI

+EfiCreateProtocolNotifyEvent(

+  IN  EFI_GUID          *ProtocolGuid,

+  IN  EFI_TPL           NotifyTpl,

+  IN  EFI_EVENT_NOTIFY  NotifyFunction,

+  IN  VOID              *NotifyContext,  OPTIONAL

+  OUT VOID              **Registration

+  )

+{

+  EFI_STATUS  Status;

+  EFI_EVENT   Event;

+

+  ASSERT (ProtocolGuid != NULL);

+  ASSERT (NotifyFunction != NULL);

+  ASSERT (Registration != NULL);

+

+  //

+  // Create the event

+  //

+

+  Status = gBS->CreateEvent (

+                  EVT_NOTIFY_SIGNAL,

+                  NotifyTpl,

+                  NotifyFunction,

+                  NotifyContext,

+                  &Event

+                  );

+  ASSERT_EFI_ERROR (Status);

+

+  //

+  // Register for protocol notifications on this event

+  //

+

+  Status = gBS->RegisterProtocolNotify (

+                  ProtocolGuid,

+                  Event,

+                  Registration

+                  );

+

+  ASSERT_EFI_ERROR (Status);

+

+  //

+  // Kick the event so we will perform an initial pass of

+  // current installed drivers

+  //

+

+  gBS->SignalEvent (Event);

+  return Event;

+}

+

+/**

+  Creates a named event that can be signaled with EfiNamedEventSignal().

+

+  This function creates an event using NotifyTpl, NoifyFunction, and NotifyContext.

+  This event is signaled with EfiNamedEventSignal(). This provides the ability for one or more

+  listeners on the same event named by the GUID specified by Name.

+  If Name is NULL, then ASSERT().

+  If NotifyTpl is not a legal TPL value, then ASSERT().

+  If NotifyFunction is NULL, then ASSERT().

+

+  @param  Name                  Supplies the GUID name of the event.

+  @param  NotifyTpl             Supplies the task priority level of the event notifications.

+  @param  NotifyFunction        Supplies the function to notify when the event is signaled.

+  @param  NotifyContext         The context parameter to pass to NotifyFunction.

+  @param  Registration          A pointer to a memory location to receive the registration value.

+

+  @retval EFI_SUCCESS           A named event was created.

+  @retval EFI_OUT_OF_RESOURCES  There are not enough resource to create the named event.

+

+**/

+EFI_STATUS

+EFIAPI

+EfiNamedEventListen (

+  IN CONST EFI_GUID    *Name,

+  IN EFI_TPL           NotifyTpl,

+  IN EFI_EVENT_NOTIFY  NotifyFunction,

+  IN CONST VOID        *NotifyContext,  OPTIONAL

+  OUT VOID             *Registration OPTIONAL

+  )

+{

+  EFI_STATUS  Status;

+  EFI_EVENT   Event;

+  VOID        *RegistrationLocal;

+

+  ASSERT (Name != NULL);

+  ASSERT (NotifyFunction != NULL);

+  ASSERT (NotifyTpl <= TPL_HIGH_LEVEL);

+

+  //

+  // Create event

+  //

+  Status = gBS->CreateEvent (

+                  EVT_NOTIFY_SIGNAL,

+                  NotifyTpl,

+                  NotifyFunction,

+                  (VOID *) NotifyContext,

+                  &Event

+                  );

+  ASSERT_EFI_ERROR (Status);

+

+  //

+  // The Registration is not optional to RegisterProtocolNotify().

+  // To make it optional to EfiNamedEventListen(), may need to substitute with a local.

+  //

+  if (Registration != NULL) {

+    RegistrationLocal = Registration;

+  } else {

+    RegistrationLocal = &RegistrationLocal;

+  }

+

+  //

+  // Register for an installation of protocol interface

+  //

+

+  Status = gBS->RegisterProtocolNotify (

+                  (EFI_GUID *) Name,

+                  Event,

+                  RegistrationLocal

+                  );

+  ASSERT_EFI_ERROR (Status);

+

+  return Status;

+}

+

+/**

+  Signals a named event created with EfiNamedEventListen().

+

+  This function signals the named event specified by Name. The named event must have been

+  created with EfiNamedEventListen().

+  If Name is NULL, then ASSERT().

+

+  @param  Name                  Supplies the GUID name of the event.

+

+  @retval EFI_SUCCESS           A named event was signaled.

+  @retval EFI_OUT_OF_RESOURCES  There are not enough resource to signal the named event.

+

+**/

+EFI_STATUS

+EFIAPI

+EfiNamedEventSignal (

+  IN CONST EFI_GUID  *Name

+  )

+{

+  EFI_STATUS  Status;

+  EFI_HANDLE  Handle;

+

+  ASSERT(Name != NULL);

+

+  Handle = NULL;

+  Status = gBS->InstallProtocolInterface (

+                  &Handle,

+                  (EFI_GUID *) Name,

+                  EFI_NATIVE_INTERFACE,

+                  NULL

+                  );

+  ASSERT_EFI_ERROR (Status);

+

+  Status = gBS->UninstallProtocolInterface (

+                  Handle,

+                  (EFI_GUID *) Name,

+                  NULL

+                  );

+  ASSERT_EFI_ERROR (Status);

+

+  return Status;

+}

+

+/**

+  Signals an event group by placing a new event in the group temporarily and

+  signaling it.

+

+  @param[in] EventGroup          Supplies the unique identifier of the event

+                                 group to signal.

+

+  @retval EFI_SUCCESS            The event group was signaled successfully.

+  @retval EFI_INVALID_PARAMETER  EventGroup is NULL.

+  @return                        Error codes that report problems about event

+                                 creation or signaling.

+**/

+EFI_STATUS

+EFIAPI

+EfiEventGroupSignal (

+  IN CONST EFI_GUID *EventGroup

+  )

+{

+  EFI_STATUS Status;

+  EFI_EVENT  Event;

+

+  if (EventGroup == NULL) {

+    return EFI_INVALID_PARAMETER;

+  }

+

+  Status = gBS->CreateEventEx (

+                  EVT_NOTIFY_SIGNAL,

+                  TPL_CALLBACK,

+                  EfiEventEmptyFunction,

+                  NULL,

+                  EventGroup,

+                  &Event

+                  );

+  if (EFI_ERROR (Status)) {

+    return Status;

+  }

+

+  Status = gBS->SignalEvent (Event);

+  gBS->CloseEvent (Event);

+

+  return Status;

+}

+

+/**

+  An empty function that can be used as NotifyFunction parameter of

+  CreateEvent() or CreateEventEx().

+

+  @param Event              Event whose notification function is being invoked.

+  @param Context            The pointer to the notification function's context,

+                            which is implementation-dependent.

+

+**/

+VOID

+EFIAPI

+EfiEventEmptyFunction (

+  IN EFI_EVENT              Event,

+  IN VOID                   *Context

+  )

+{

+}

+

+/**

+  Returns the current TPL.

+

+  This function returns the current TPL.  There is no EFI service to directly

+  retrieve the current TPL. Instead, the RaiseTPL() function is used to raise

+  the TPL to TPL_HIGH_LEVEL.  This will return the current TPL.  The TPL level

+  can then immediately be restored back to the current TPL level with a call

+  to RestoreTPL().

+

+  @return The current TPL.

+

+**/

+EFI_TPL

+EFIAPI

+EfiGetCurrentTpl (

+  VOID

+  )

+{

+  EFI_TPL Tpl;

+

+  Tpl = gBS->RaiseTPL (TPL_HIGH_LEVEL);

+  gBS->RestoreTPL (Tpl);

+

+  return Tpl;

+}

+

+

+/**

+  Initializes a basic mutual exclusion lock.

+

+  This function initializes a basic mutual exclusion lock to the released state

+  and returns the lock.  Each lock provides mutual exclusion access at its task

+  priority level.  Since there is no preemption or multiprocessor support in EFI,

+  acquiring the lock only consists of raising to the locks TPL.

+  If Lock is NULL, then ASSERT().

+  If Priority is not a valid TPL value, then ASSERT().

+

+  @param  Lock       A pointer to the lock data structure to initialize.

+  @param  Priority   EFI TPL is associated with the lock.

+

+  @return The lock.

+

+**/

+EFI_LOCK *

+EFIAPI

+EfiInitializeLock (

+  IN OUT EFI_LOCK  *Lock,

+  IN EFI_TPL        Priority

+  )

+{

+  ASSERT (Lock != NULL);

+  ASSERT (Priority <= TPL_HIGH_LEVEL);

+

+  Lock->Tpl       = Priority;

+  Lock->OwnerTpl  = TPL_APPLICATION;

+  Lock->Lock      = EfiLockReleased ;

+  return Lock;

+}

+

+/**

+  Acquires ownership of a lock.

+

+  This function raises the system's current task priority level to the task

+  priority level of the mutual exclusion lock.  Then, it places the lock in the

+  acquired state.

+  If Lock is NULL, then ASSERT().

+  If Lock is not initialized, then ASSERT().

+  If Lock is already in the acquired state, then ASSERT().

+

+  @param  Lock              A pointer to the lock to acquire.

+

+**/

+VOID

+EFIAPI

+EfiAcquireLock (

+  IN EFI_LOCK  *Lock

+  )

+{

+  ASSERT (Lock != NULL);

+  ASSERT (Lock->Lock == EfiLockReleased);

+

+  Lock->OwnerTpl = gBS->RaiseTPL (Lock->Tpl);

+  Lock->Lock     = EfiLockAcquired;

+}

+

+/**

+  Acquires ownership of a lock.

+

+  This function raises the system's current task priority level to the task priority

+  level of the mutual exclusion lock.  Then, it attempts to place the lock in the acquired state.

+  If the lock is already in the acquired state, then EFI_ACCESS_DENIED is returned.

+  Otherwise, EFI_SUCCESS is returned.

+  If Lock is NULL, then ASSERT().

+  If Lock is not initialized, then ASSERT().

+

+  @param  Lock              A pointer to the lock to acquire.

+

+  @retval EFI_SUCCESS       The lock was acquired.

+  @retval EFI_ACCESS_DENIED The lock could not be acquired because it is already owned.

+

+**/

+EFI_STATUS

+EFIAPI

+EfiAcquireLockOrFail (

+  IN EFI_LOCK  *Lock

+  )

+{

+

+  ASSERT (Lock != NULL);

+  ASSERT (Lock->Lock != EfiLockUninitialized);

+

+  if (Lock->Lock == EfiLockAcquired) {

+    //

+    // Lock is already owned, so bail out

+    //

+    return EFI_ACCESS_DENIED;

+  }

+

+  Lock->OwnerTpl = gBS->RaiseTPL (Lock->Tpl);

+

+  Lock->Lock = EfiLockAcquired;

+

+  return EFI_SUCCESS;

+}

+

+/**

+  Releases ownership of a lock.

+

+  This function transitions a mutual exclusion lock from the acquired state to

+  the released state, and restores the system's task priority level to its

+  previous level.

+  If Lock is NULL, then ASSERT().

+  If Lock is not initialized, then ASSERT().

+  If Lock is already in the released state, then ASSERT().

+

+  @param  Lock  A pointer to the lock to release.

+

+**/

+VOID

+EFIAPI

+EfiReleaseLock (

+  IN EFI_LOCK  *Lock

+  )

+{

+  EFI_TPL Tpl;

+

+  ASSERT (Lock != NULL);

+  ASSERT (Lock->Lock == EfiLockAcquired);

+

+  Tpl = Lock->OwnerTpl;

+

+  Lock->Lock = EfiLockReleased;

+

+  gBS->RestoreTPL (Tpl);

+}

+

+/**

+  Tests whether a controller handle is being managed by a specific driver.

+

+  This function tests whether the driver specified by DriverBindingHandle is

+  currently managing the controller specified by ControllerHandle.  This test

+  is performed by evaluating if the the protocol specified by ProtocolGuid is

+  present on ControllerHandle and is was opened by DriverBindingHandle with an

+  attribute of EFI_OPEN_PROTOCOL_BY_DRIVER.

+  If ProtocolGuid is NULL, then ASSERT().

+

+  @param  ControllerHandle     A handle for a controller to test.

+  @param  DriverBindingHandle  Specifies the driver binding handle for the

+                               driver.

+  @param  ProtocolGuid         Specifies the protocol that the driver specified

+                               by DriverBindingHandle opens in its Start()

+                               function.

+

+  @retval EFI_SUCCESS          ControllerHandle is managed by the driver

+                               specified by DriverBindingHandle.

+  @retval EFI_UNSUPPORTED      ControllerHandle is not managed by the driver

+                               specified by DriverBindingHandle.

+

+**/

+EFI_STATUS

+EFIAPI

+EfiTestManagedDevice (

+  IN CONST EFI_HANDLE       ControllerHandle,

+  IN CONST EFI_HANDLE       DriverBindingHandle,

+  IN CONST EFI_GUID         *ProtocolGuid

+  )

+{

+  EFI_STATUS     Status;

+  VOID           *ManagedInterface;

+

+  ASSERT (ProtocolGuid != NULL);

+

+  Status = gBS->OpenProtocol (

+                  ControllerHandle,

+                  (EFI_GUID *) ProtocolGuid,

+                  &ManagedInterface,

+                  DriverBindingHandle,

+                  ControllerHandle,

+                  EFI_OPEN_PROTOCOL_BY_DRIVER

+                  );

+  if (!EFI_ERROR (Status)) {

+    gBS->CloseProtocol (

+           ControllerHandle,

+           (EFI_GUID *) ProtocolGuid,

+           DriverBindingHandle,

+           ControllerHandle

+           );

+    return EFI_UNSUPPORTED;

+  }

+

+  if (Status != EFI_ALREADY_STARTED) {

+    return EFI_UNSUPPORTED;

+  }

+

+  return EFI_SUCCESS;

+}

+

+/**

+  Tests whether a child handle is a child device of the controller.

+

+  This function tests whether ChildHandle is one of the children of

+  ControllerHandle.  This test is performed by checking to see if the protocol

+  specified by ProtocolGuid is present on ControllerHandle and opened by

+  ChildHandle with an attribute of EFI_OPEN_PROTOCOL_BY_CHILD_CONTROLLER.

+  If ProtocolGuid is NULL, then ASSERT().

+

+  @param  ControllerHandle     A handle for a (parent) controller to test.

+  @param  ChildHandle          A child handle to test.

+  @param  ProtocolGuid         Supplies the protocol that the child controller

+                               opens on its parent controller.

+

+  @retval EFI_SUCCESS          ChildHandle is a child of the ControllerHandle.

+  @retval EFI_UNSUPPORTED      ChildHandle is not a child of the

+                               ControllerHandle.

+

+**/

+EFI_STATUS

+EFIAPI

+EfiTestChildHandle (

+  IN CONST EFI_HANDLE       ControllerHandle,

+  IN CONST EFI_HANDLE       ChildHandle,

+  IN CONST EFI_GUID         *ProtocolGuid

+  )

+{

+  EFI_STATUS                            Status;

+  EFI_OPEN_PROTOCOL_INFORMATION_ENTRY   *OpenInfoBuffer;

+  UINTN                                 EntryCount;

+  UINTN                                 Index;

+

+  ASSERT (ProtocolGuid != NULL);

+

+  //

+  // Retrieve the list of agents that are consuming the specific protocol

+  // on ControllerHandle.

+  //

+  Status = gBS->OpenProtocolInformation (

+                  ControllerHandle,

+                  (EFI_GUID *) ProtocolGuid,

+                  &OpenInfoBuffer,

+                  &EntryCount

+                  );

+  if (EFI_ERROR (Status)) {

+    return EFI_UNSUPPORTED;

+  }

+

+  //

+  // Inspect if ChildHandle is one of the agents.

+  //

+  Status = EFI_UNSUPPORTED;

+  for (Index = 0; Index < EntryCount; Index++) {

+    if ((OpenInfoBuffer[Index].ControllerHandle == ChildHandle) &&

+        (OpenInfoBuffer[Index].Attributes & EFI_OPEN_PROTOCOL_BY_CHILD_CONTROLLER) != 0) {

+      Status = EFI_SUCCESS;

+      break;

+    }

+  }

+

+  FreePool (OpenInfoBuffer);

+  return Status;

+}

+

+/**

+  This function checks the supported languages list for a target language,

+  This only supports RFC 4646 Languages.

+

+  @param  SupportedLanguages  The supported languages

+  @param  TargetLanguage      The target language

+

+  @retval Returns EFI_SUCCESS if the language is supported,

+          EFI_UNSUPPORTED otherwise

+**/

+EFI_STATUS

+EFIAPI

+IsLanguageSupported (

+  IN CONST CHAR8 *SupportedLanguages,

+  IN CONST CHAR8 *TargetLanguage

+  )

+{

+  UINTN Index;

+  while (*SupportedLanguages != 0) {

+    for (Index = 0; SupportedLanguages[Index] != 0 && SupportedLanguages[Index] != ';'; Index++);

+    if ((AsciiStrnCmp(SupportedLanguages, TargetLanguage, Index) == 0) && (TargetLanguage[Index] == 0)) {

+      return EFI_SUCCESS;

+    }

+    SupportedLanguages += Index;

+    for (; *SupportedLanguages != 0 && *SupportedLanguages == ';'; SupportedLanguages++);

+  }

+

+  return EFI_UNSUPPORTED;

+}

+

+/**

+  This function looks up a Unicode string in UnicodeStringTable.

+

+  If Language is a member of SupportedLanguages and a Unicode string is found in

+  UnicodeStringTable that matches the language code specified by Language, then it

+  is returned in UnicodeString.

+

+  @param  Language                A pointer to the ISO 639-2 language code for the

+                                  Unicode string to look up and return.

+  @param  SupportedLanguages      A pointer to the set of ISO 639-2 language codes

+                                  that the Unicode string table supports.  Language

+                                  must be a member of this set.

+  @param  UnicodeStringTable      A pointer to the table of Unicode strings.

+  @param  UnicodeString           A pointer to the Unicode string from UnicodeStringTable

+                                  that matches the language specified by Language.

+

+  @retval EFI_SUCCESS             The Unicode string that matches the language

+                                  specified by Language was found

+                                  in the table of Unicode strings UnicodeStringTable,

+                                  and it was returned in UnicodeString.

+  @retval EFI_INVALID_PARAMETER   Language is NULL.

+  @retval EFI_INVALID_PARAMETER   UnicodeString is NULL.

+  @retval EFI_UNSUPPORTED         SupportedLanguages is NULL.

+  @retval EFI_UNSUPPORTED         UnicodeStringTable is NULL.

+  @retval EFI_UNSUPPORTED         The language specified by Language is not a

+                                  member of SupportedLanguages.

+  @retval EFI_UNSUPPORTED         The language specified by Language is not

+                                  supported by UnicodeStringTable.

+

+**/

+EFI_STATUS

+EFIAPI

+LookupUnicodeString (

+  IN CONST CHAR8                     *Language,

+  IN CONST CHAR8                     *SupportedLanguages,

+  IN CONST EFI_UNICODE_STRING_TABLE  *UnicodeStringTable,

+  OUT CHAR16                         **UnicodeString

+  )

+{

+  //

+  // Make sure the parameters are valid

+  //

+  if (Language == NULL || UnicodeString == NULL) {

+    return EFI_INVALID_PARAMETER;

+  }

+

+  //

+  // If there are no supported languages, or the Unicode String Table is empty, then the

+  // Unicode String specified by Language is not supported by this Unicode String Table

+  //

+  if (SupportedLanguages == NULL || UnicodeStringTable == NULL) {

+    return EFI_UNSUPPORTED;

+  }

+

+  //

+  // Make sure Language is in the set of Supported Languages

+  //

+  while (*SupportedLanguages != 0) {

+    if (CompareIso639LanguageCode (Language, SupportedLanguages)) {

+

+      //

+      // Search the Unicode String Table for the matching Language specifier

+      //

+      while (UnicodeStringTable->Language != NULL) {

+        if (CompareIso639LanguageCode (Language, UnicodeStringTable->Language)) {

+

+          //

+          // A matching string was found, so return it

+          //

+          *UnicodeString = UnicodeStringTable->UnicodeString;

+          return EFI_SUCCESS;

+        }

+

+        UnicodeStringTable++;

+      }

+

+      return EFI_UNSUPPORTED;

+    }

+

+    SupportedLanguages += 3;

+  }

+

+  return EFI_UNSUPPORTED;

+}

+

+

+

+/**

+  This function looks up a Unicode string in UnicodeStringTable.

+

+  If Language is a member of SupportedLanguages and a Unicode string is found in

+  UnicodeStringTable that matches the language code specified by Language, then

+  it is returned in UnicodeString.

+

+  @param  Language             A pointer to an ASCII string containing the ISO 639-2 or the

+                               RFC 4646 language code for the Unicode string to look up and

+                               return. If Iso639Language is TRUE, then this ASCII string is

+                               not assumed to be Null-terminated, and only the first three

+                               characters are used. If Iso639Language is FALSE, then this ASCII

+                               string must be Null-terminated.

+  @param  SupportedLanguages   A pointer to a Null-terminated ASCII string that contains a

+                               set of ISO 639-2 or RFC 4646 language codes that the Unicode

+                               string table supports.  Language must be a member of this set.

+                               If Iso639Language is TRUE, then this string contains one or more

+                               ISO 639-2 language codes with no separator characters. If Iso639Language

+                               is FALSE, then is string contains one or more RFC 4646 language

+                               codes separated by ';'.

+  @param  UnicodeStringTable   A pointer to the table of Unicode strings. Type EFI_UNICODE_STRING_TABLE

+                               is defined in "Related Definitions".

+  @param  UnicodeString        A pointer to the Null-terminated Unicode string from UnicodeStringTable

+                               that matches the language specified by Language.

+  @param  Iso639Language       Specifies the supported language code format. If it is TRUE, then

+                               Language and SupportedLanguages follow ISO 639-2 language code format.

+                               Otherwise, they follow RFC 4646 language code format.

+

+

+  @retval  EFI_SUCCESS            The Unicode string that matches the language specified by Language

+                                  was found in the table of Unicode strings UnicodeStringTable, and

+                                  it was returned in UnicodeString.

+  @retval  EFI_INVALID_PARAMETER  Language is NULL.

+  @retval  EFI_INVALID_PARAMETER  UnicodeString is NULL.

+  @retval  EFI_UNSUPPORTED        SupportedLanguages is NULL.

+  @retval  EFI_UNSUPPORTED        UnicodeStringTable is NULL.

+  @retval  EFI_UNSUPPORTED        The language specified by Language is not a member of SupportedLanguages.

+  @retval  EFI_UNSUPPORTED        The language specified by Language is not supported by UnicodeStringTable.

+

+**/

+EFI_STATUS

+EFIAPI

+LookupUnicodeString2 (

+  IN CONST CHAR8                     *Language,

+  IN CONST CHAR8                     *SupportedLanguages,

+  IN CONST EFI_UNICODE_STRING_TABLE  *UnicodeStringTable,

+  OUT CHAR16                         **UnicodeString,

+  IN BOOLEAN                         Iso639Language

+  )

+{

+  BOOLEAN   Found;

+  UINTN     Index;

+  CHAR8     *LanguageString;

+

+  //

+  // Make sure the parameters are valid

+  //

+  if (Language == NULL || UnicodeString == NULL) {

+    return EFI_INVALID_PARAMETER;

+  }

+

+  //

+  // If there are no supported languages, or the Unicode String Table is empty, then the

+  // Unicode String specified by Language is not supported by this Unicode String Table

+  //

+  if (SupportedLanguages == NULL || UnicodeStringTable == NULL) {

+    return EFI_UNSUPPORTED;

+  }

+

+  //

+  // Make sure Language is in the set of Supported Languages

+  //

+  Found = FALSE;

+  if (Iso639Language) {

+    while (*SupportedLanguages != 0) {

+      if (CompareIso639LanguageCode (Language, SupportedLanguages)) {

+        Found = TRUE;

+        break;

+      }

+      SupportedLanguages += 3;

+    }

+  } else {

+    Found = !IsLanguageSupported(SupportedLanguages, Language);

+  }

+

+

+  //

+  // If Language is not a member of SupportedLanguages, then return EFI_UNSUPPORTED

+  //

+  if (!Found) {

+    return EFI_UNSUPPORTED;

+  }

+

+  //

+  // Search the Unicode String Table for the matching Language specifier

+  //

+  while (UnicodeStringTable->Language != NULL) {

+    LanguageString = UnicodeStringTable->Language;

+    while (0 != *LanguageString) {

+      for (Index = 0 ;LanguageString[Index] != 0 && LanguageString[Index] != ';'; Index++);

+      if (AsciiStrnCmp(LanguageString, Language, Index) == 0) {

+        *UnicodeString = UnicodeStringTable->UnicodeString;

+        return EFI_SUCCESS;

+      }

+      LanguageString += Index;

+      for (Index = 0 ;LanguageString[Index] != 0 && LanguageString[Index] == ';'; Index++);

+    }

+    UnicodeStringTable++;

+  }

+

+  return EFI_UNSUPPORTED;

+}

+

+

+/**

+  This function adds a Unicode string to UnicodeStringTable.

+

+  If Language is a member of SupportedLanguages then UnicodeString is added to

+  UnicodeStringTable.  New buffers are allocated for both Language and

+  UnicodeString.  The contents of Language and UnicodeString are copied into

+  these new buffers.  These buffers are automatically freed when

+  FreeUnicodeStringTable() is called.

+

+  @param  Language                A pointer to the ISO 639-2 language code for the Unicode

+                                  string to add.

+  @param  SupportedLanguages      A pointer to the set of ISO 639-2 language codes

+                                  that the Unicode string table supports.

+                                  Language must be a member of this set.

+  @param  UnicodeStringTable      A pointer to the table of Unicode strings.

+  @param  UnicodeString           A pointer to the Unicode string to add.

+

+  @retval EFI_SUCCESS             The Unicode string that matches the language

+                                  specified by Language was found in the table of

+                                  Unicode strings UnicodeStringTable, and it was

+                                  returned in UnicodeString.

+  @retval EFI_INVALID_PARAMETER   Language is NULL.

+  @retval EFI_INVALID_PARAMETER   UnicodeString is NULL.

+  @retval EFI_INVALID_PARAMETER   UnicodeString is an empty string.

+  @retval EFI_UNSUPPORTED         SupportedLanguages is NULL.

+  @retval EFI_ALREADY_STARTED     A Unicode string with language Language is

+                                  already present in UnicodeStringTable.

+  @retval EFI_OUT_OF_RESOURCES    There is not enough memory to add another

+                                  Unicode string to UnicodeStringTable.

+  @retval EFI_UNSUPPORTED         The language specified by Language is not a

+                                  member of SupportedLanguages.

+

+**/

+EFI_STATUS

+EFIAPI

+AddUnicodeString (

+  IN     CONST CHAR8               *Language,

+  IN     CONST CHAR8               *SupportedLanguages,

+  IN OUT EFI_UNICODE_STRING_TABLE  **UnicodeStringTable,

+  IN     CONST CHAR16              *UnicodeString

+  )

+{

+  UINTN                     NumberOfEntries;

+  EFI_UNICODE_STRING_TABLE  *OldUnicodeStringTable;

+  EFI_UNICODE_STRING_TABLE  *NewUnicodeStringTable;

+  UINTN                     UnicodeStringLength;

+

+  //

+  // Make sure the parameter are valid

+  //

+  if (Language == NULL || UnicodeString == NULL || UnicodeStringTable == NULL) {

+    return EFI_INVALID_PARAMETER;

+  }

+

+  //

+  // If there are no supported languages, then a Unicode String can not be added

+  //

+  if (SupportedLanguages == NULL) {

+    return EFI_UNSUPPORTED;

+  }

+

+  //

+  // If the Unicode String is empty, then a Unicode String can not be added

+  //

+  if (UnicodeString[0] == 0) {

+    return EFI_INVALID_PARAMETER;

+  }

+

+  //

+  // Make sure Language is a member of SupportedLanguages

+  //

+  while (*SupportedLanguages != 0) {

+    if (CompareIso639LanguageCode (Language, SupportedLanguages)) {

+

+      //

+      // Determine the size of the Unicode String Table by looking for a NULL Language entry

+      //

+      NumberOfEntries = 0;

+      if (*UnicodeStringTable != NULL) {

+        OldUnicodeStringTable = *UnicodeStringTable;

+        while (OldUnicodeStringTable->Language != NULL) {

+          if (CompareIso639LanguageCode (Language, OldUnicodeStringTable->Language)) {

+            return EFI_ALREADY_STARTED;

+          }

+

+          OldUnicodeStringTable++;

+          NumberOfEntries++;

+        }

+      }

+

+      //

+      // Allocate space for a new Unicode String Table.  It must hold the current number of

+      // entries, plus 1 entry for the new Unicode String, plus 1 entry for the end of table

+      // marker

+      //

+      NewUnicodeStringTable = AllocatePool ((NumberOfEntries + 2) * sizeof (EFI_UNICODE_STRING_TABLE));

+      if (NewUnicodeStringTable == NULL) {

+        return EFI_OUT_OF_RESOURCES;

+      }

+

+      //

+      // If the current Unicode String Table contains any entries, then copy them to the

+      // newly allocated Unicode String Table.

+      //

+      if (*UnicodeStringTable != NULL) {

+        CopyMem (

+           NewUnicodeStringTable,

+           *UnicodeStringTable,

+           NumberOfEntries * sizeof (EFI_UNICODE_STRING_TABLE)

+           );

+      }

+

+      //

+      // Allocate space for a copy of the Language specifier

+      //

+      NewUnicodeStringTable[NumberOfEntries].Language = AllocateCopyPool (3, Language);

+      if (NewUnicodeStringTable[NumberOfEntries].Language == NULL) {

+        FreePool (NewUnicodeStringTable);

+        return EFI_OUT_OF_RESOURCES;

+      }

+

+      //

+      // Compute the length of the Unicode String

+      //

+      for (UnicodeStringLength = 0; UnicodeString[UnicodeStringLength] != 0; UnicodeStringLength++)

+        ;

+

+      //

+      // Allocate space for a copy of the Unicode String

+      //

+      NewUnicodeStringTable[NumberOfEntries].UnicodeString = AllocateCopyPool (

+                                                              (UnicodeStringLength + 1) * sizeof (CHAR16),

+                                                              UnicodeString

+                                                              );

+      if (NewUnicodeStringTable[NumberOfEntries].UnicodeString == NULL) {

+        FreePool (NewUnicodeStringTable[NumberOfEntries].Language);

+        FreePool (NewUnicodeStringTable);

+        return EFI_OUT_OF_RESOURCES;

+      }

+

+      //

+      // Mark the end of the Unicode String Table

+      //

+      NewUnicodeStringTable[NumberOfEntries + 1].Language       = NULL;

+      NewUnicodeStringTable[NumberOfEntries + 1].UnicodeString  = NULL;

+

+      //

+      // Free the old Unicode String Table

+      //

+      if (*UnicodeStringTable != NULL) {

+        FreePool (*UnicodeStringTable);

+      }

+

+      //

+      // Point UnicodeStringTable at the newly allocated Unicode String Table

+      //

+      *UnicodeStringTable = NewUnicodeStringTable;

+

+      return EFI_SUCCESS;

+    }

+

+    SupportedLanguages += 3;

+  }

+

+  return EFI_UNSUPPORTED;

+}

+

+

+/**

+  This function adds the Null-terminated Unicode string specified by UnicodeString

+  to UnicodeStringTable.

+

+  If Language is a member of SupportedLanguages then UnicodeString is added to

+  UnicodeStringTable.  New buffers are allocated for both Language and UnicodeString.

+  The contents of Language and UnicodeString are copied into these new buffers.

+  These buffers are automatically freed when EfiLibFreeUnicodeStringTable() is called.

+

+  @param  Language            A pointer to an ASCII string containing the ISO 639-2 or

+                              the RFC 4646 language code for the Unicode string to add.

+                              If Iso639Language is TRUE, then this ASCII string is not

+                              assumed to be Null-terminated, and only the first three

+                              chacters are used. If Iso639Language is FALSE, then this

+                              ASCII string must be Null-terminated.

+  @param  SupportedLanguages  A pointer to a Null-terminated ASCII string that contains

+                              a set of ISO 639-2 or RFC 4646 language codes that the Unicode

+                              string table supports.  Language must be a member of this set.

+                              If Iso639Language is TRUE, then this string contains one or more

+                              ISO 639-2 language codes with no separator characters.

+                              If Iso639Language is FALSE, then is string contains one or more

+                              RFC 4646 language codes separated by ';'.

+  @param  UnicodeStringTable  A pointer to the table of Unicode strings. Type EFI_UNICODE_STRING_TABLE

+                              is defined in "Related Definitions".

+  @param  UnicodeString       A pointer to the Unicode string to add.

+  @param  Iso639Language      Specifies the supported language code format. If it is TRUE,

+                              then Language and SupportedLanguages follow ISO 639-2 language code format.

+                              Otherwise, they follow RFC 4646 language code format.

+

+  @retval EFI_SUCCESS            The Unicode string that matches the language specified by

+                                 Language was found in the table of Unicode strings UnicodeStringTable,

+                                 and it was returned in UnicodeString.

+  @retval EFI_INVALID_PARAMETER  Language is NULL.

+  @retval EFI_INVALID_PARAMETER  UnicodeString is NULL.

+  @retval EFI_INVALID_PARAMETER  UnicodeString is an empty string.

+  @retval EFI_UNSUPPORTED        SupportedLanguages is NULL.

+  @retval EFI_ALREADY_STARTED    A Unicode string with language Language is already present in

+                                 UnicodeStringTable.

+  @retval EFI_OUT_OF_RESOURCES   There is not enough memory to add another Unicode string UnicodeStringTable.

+  @retval EFI_UNSUPPORTED        The language specified by Language is not a member of SupportedLanguages.

+

+**/

+EFI_STATUS

+EFIAPI

+AddUnicodeString2 (

+  IN     CONST CHAR8               *Language,

+  IN     CONST CHAR8               *SupportedLanguages,

+  IN OUT EFI_UNICODE_STRING_TABLE  **UnicodeStringTable,

+  IN     CONST CHAR16              *UnicodeString,

+  IN     BOOLEAN                   Iso639Language

+  )

+{

+  UINTN                     NumberOfEntries;

+  EFI_UNICODE_STRING_TABLE  *OldUnicodeStringTable;

+  EFI_UNICODE_STRING_TABLE  *NewUnicodeStringTable;

+  UINTN                     UnicodeStringLength;

+  BOOLEAN                   Found;

+  UINTN                     Index;

+  CHAR8                     *LanguageString;

+

+  //

+  // Make sure the parameter are valid

+  //

+  if (Language == NULL || UnicodeString == NULL || UnicodeStringTable == NULL) {

+    return EFI_INVALID_PARAMETER;

+  }

+

+  //

+  // If there are no supported languages, then a Unicode String can not be added

+  //

+  if (SupportedLanguages == NULL) {

+    return EFI_UNSUPPORTED;

+  }

+

+  //

+  // If the Unicode String is empty, then a Unicode String can not be added

+  //

+  if (UnicodeString[0] == 0) {

+    return EFI_INVALID_PARAMETER;

+  }

+

+  //

+  // Make sure Language is a member of SupportedLanguages

+  //

+  Found = FALSE;

+  if (Iso639Language) {

+    while (*SupportedLanguages != 0) {

+      if (CompareIso639LanguageCode (Language, SupportedLanguages)) {

+        Found = TRUE;

+        break;

+      }

+      SupportedLanguages += 3;

+    }

+  } else {

+    Found = !IsLanguageSupported(SupportedLanguages, Language);

+  }

+  //

+  // If Language is not a member of SupportedLanguages, then return EFI_UNSUPPORTED

+  //

+  if (!Found) {

+    return EFI_UNSUPPORTED;

+  }

+

+  //

+  // Determine the size of the Unicode String Table by looking for a NULL Language entry

+  //

+  NumberOfEntries = 0;

+  if (*UnicodeStringTable != NULL) {

+    OldUnicodeStringTable = *UnicodeStringTable;

+    while (OldUnicodeStringTable->Language != NULL) {

+      LanguageString = OldUnicodeStringTable->Language;

+

+      while (*LanguageString != 0) {

+        for (Index = 0; LanguageString[Index] != 0 && LanguageString[Index] != ';'; Index++);

+

+        if (AsciiStrnCmp (Language, LanguageString, Index) == 0) {

+          return EFI_ALREADY_STARTED;

+        }

+        LanguageString += Index;

+        for (; *LanguageString != 0 && *LanguageString == ';'; LanguageString++);

+      }

+      OldUnicodeStringTable++;

+      NumberOfEntries++;

+    }

+  }

+

+  //

+  // Allocate space for a new Unicode String Table.  It must hold the current number of

+  // entries, plus 1 entry for the new Unicode String, plus 1 entry for the end of table

+  // marker

+  //

+  NewUnicodeStringTable = AllocatePool ((NumberOfEntries + 2) * sizeof (EFI_UNICODE_STRING_TABLE));

+  if (NewUnicodeStringTable == NULL) {

+    return EFI_OUT_OF_RESOURCES;

+  }

+

+  //

+  // If the current Unicode String Table contains any entries, then copy them to the

+  // newly allocated Unicode String Table.

+  //

+  if (*UnicodeStringTable != NULL) {

+    CopyMem (

+      NewUnicodeStringTable,

+      *UnicodeStringTable,

+      NumberOfEntries * sizeof (EFI_UNICODE_STRING_TABLE)

+      );

+  }

+

+  //

+  // Allocate space for a copy of the Language specifier

+  //

+  NewUnicodeStringTable[NumberOfEntries].Language = AllocateCopyPool (AsciiStrSize(Language), Language);

+  if (NewUnicodeStringTable[NumberOfEntries].Language == NULL) {

+    FreePool (NewUnicodeStringTable);

+    return EFI_OUT_OF_RESOURCES;

+  }

+

+  //

+  // Compute the length of the Unicode String

+  //

+  for (UnicodeStringLength = 0; UnicodeString[UnicodeStringLength] != 0; UnicodeStringLength++);

+

+  //

+  // Allocate space for a copy of the Unicode String

+  //

+  NewUnicodeStringTable[NumberOfEntries].UnicodeString = AllocateCopyPool (StrSize (UnicodeString), UnicodeString);

+  if (NewUnicodeStringTable[NumberOfEntries].UnicodeString == NULL) {

+    FreePool (NewUnicodeStringTable[NumberOfEntries].Language);

+    FreePool (NewUnicodeStringTable);

+    return EFI_OUT_OF_RESOURCES;

+  }

+

+  //

+  // Mark the end of the Unicode String Table

+  //

+  NewUnicodeStringTable[NumberOfEntries + 1].Language       = NULL;

+  NewUnicodeStringTable[NumberOfEntries + 1].UnicodeString  = NULL;

+

+  //

+  // Free the old Unicode String Table

+  //

+  if (*UnicodeStringTable != NULL) {

+    FreePool (*UnicodeStringTable);

+  }

+

+  //

+  // Point UnicodeStringTable at the newly allocated Unicode String Table

+  //

+  *UnicodeStringTable = NewUnicodeStringTable;

+

+  return EFI_SUCCESS;

+}

+

+/**

+  This function frees the table of Unicode strings in UnicodeStringTable.

+

+  If UnicodeStringTable is NULL, then EFI_SUCCESS is returned.

+  Otherwise, each language code, and each Unicode string in the Unicode string

+  table are freed, and EFI_SUCCESS is returned.

+

+  @param  UnicodeStringTable  A pointer to the table of Unicode strings.

+

+  @retval EFI_SUCCESS         The Unicode string table was freed.

+

+**/

+EFI_STATUS

+EFIAPI

+FreeUnicodeStringTable (

+  IN EFI_UNICODE_STRING_TABLE  *UnicodeStringTable

+  )

+{

+  UINTN Index;

+

+  //

+  // If the Unicode String Table is NULL, then it is already freed

+  //

+  if (UnicodeStringTable == NULL) {

+    return EFI_SUCCESS;

+  }

+

+  //

+  // Loop through the Unicode String Table until we reach the end of table marker

+  //

+  for (Index = 0; UnicodeStringTable[Index].Language != NULL; Index++) {

+

+    //

+    // Free the Language string from the Unicode String Table

+    //

+    FreePool (UnicodeStringTable[Index].Language);

+

+    //

+    // Free the Unicode String from the Unicode String Table

+    //

+    if (UnicodeStringTable[Index].UnicodeString != NULL) {

+      FreePool (UnicodeStringTable[Index].UnicodeString);

+    }

+  }

+

+  //

+  // Free the Unicode String Table itself

+  //

+  FreePool (UnicodeStringTable);

+

+  return EFI_SUCCESS;

+}

+

+

+/**

+  Returns the status whether get the variable success. The function retrieves

+  variable  through the UEFI Runtime Service GetVariable().  The

+  returned buffer is allocated using AllocatePool().  The caller is responsible

+  for freeing this buffer with FreePool().

+

+  If Name  is NULL, then ASSERT().

+  If Guid  is NULL, then ASSERT().

+  If Value is NULL, then ASSERT().

+

+  @param[in]  Name  The pointer to a Null-terminated Unicode string.

+  @param[in]  Guid  The pointer to an EFI_GUID structure

+  @param[out] Value The buffer point saved the variable info.

+  @param[out] Size  The buffer size of the variable.

+

+  @return EFI_OUT_OF_RESOURCES      Allocate buffer failed.

+  @return EFI_SUCCESS               Find the specified variable.

+  @return Others Errors             Return errors from call to gRT->GetVariable.

+

+**/

+EFI_STATUS

+EFIAPI

+GetVariable2 (

+  IN CONST CHAR16    *Name,

+  IN CONST EFI_GUID  *Guid,

+  OUT VOID           **Value,

+  OUT UINTN          *Size OPTIONAL

+  )

+{

+  EFI_STATUS  Status;

+  UINTN       BufferSize;

+

+  ASSERT (Name != NULL && Guid != NULL && Value != NULL);

+

+  //

+  // Try to get the variable size.

+  //

+  BufferSize = 0;

+  *Value     = NULL;

+  if (Size != NULL) {

+    *Size  = 0;

+  }

+

+  Status = gRT->GetVariable ((CHAR16 *) Name, (EFI_GUID *) Guid, NULL, &BufferSize, *Value);

+  if (Status != EFI_BUFFER_TOO_SMALL) {

+    return Status;

+  }

+

+  //

+  // Allocate buffer to get the variable.

+  //

+  *Value = AllocatePool (BufferSize);

+  ASSERT (*Value != NULL);

+  if (*Value == NULL) {

+    return EFI_OUT_OF_RESOURCES;

+  }

+

+  //

+  // Get the variable data.

+  //

+  Status = gRT->GetVariable ((CHAR16 *) Name, (EFI_GUID *) Guid, NULL, &BufferSize, *Value);

+  if (EFI_ERROR (Status)) {

+    FreePool(*Value);

+    *Value = NULL;

+  }

+

+  if (Size != NULL) {

+    *Size = BufferSize;

+  }

+

+  return Status;

+}

+

+/** Return the attributes of the variable.

+

+  Returns the status whether get the variable success. The function retrieves

+  variable  through the UEFI Runtime Service GetVariable().  The

+  returned buffer is allocated using AllocatePool().  The caller is responsible

+  for freeing this buffer with FreePool().  The attributes are returned if

+  the caller provides a valid Attribute parameter.

+

+  If Name  is NULL, then ASSERT().

+  If Guid  is NULL, then ASSERT().

+  If Value is NULL, then ASSERT().

+

+  @param[in]  Name  The pointer to a Null-terminated Unicode string.

+  @param[in]  Guid  The pointer to an EFI_GUID structure

+  @param[out] Value The buffer point saved the variable info.

+  @param[out] Size  The buffer size of the variable.

+  @param[out] Attr  The pointer to the variable attributes as found in var store

+

+  @retval EFI_OUT_OF_RESOURCES      Allocate buffer failed.

+  @retval EFI_SUCCESS               Find the specified variable.

+  @retval Others Errors             Return errors from call to gRT->GetVariable.

+

+**/

+EFI_STATUS

+EFIAPI

+GetVariable3(

+  IN CONST CHAR16       *Name,

+  IN CONST EFI_GUID     *Guid,

+     OUT VOID           **Value,

+     OUT UINTN          *Size OPTIONAL,

+     OUT UINT32         *Attr OPTIONAL

+  )

+{

+  EFI_STATUS  Status;

+  UINTN       BufferSize;

+

+  ASSERT(Name != NULL && Guid != NULL && Value != NULL);

+

+  //

+  // Try to get the variable size.

+  //

+  BufferSize = 0;

+  *Value = NULL;

+  if (Size != NULL) {

+    *Size = 0;

+  }

+

+  if (Attr != NULL) {

+    *Attr = 0;

+  }

+

+  Status = gRT->GetVariable((CHAR16 *)Name, (EFI_GUID *)Guid, Attr, &BufferSize, *Value);

+  if (Status != EFI_BUFFER_TOO_SMALL) {

+    return Status;

+  }

+

+  //

+  // Allocate buffer to get the variable.

+  //

+  *Value = AllocatePool(BufferSize);

+  ASSERT(*Value != NULL);

+  if (*Value == NULL) {

+    return EFI_OUT_OF_RESOURCES;

+  }

+

+  //

+  // Get the variable data.

+  //

+  Status = gRT->GetVariable((CHAR16 *)Name, (EFI_GUID *)Guid, Attr, &BufferSize, *Value);

+  if (EFI_ERROR(Status)) {

+    FreePool(*Value);

+    *Value = NULL;

+  }

+

+  if (Size != NULL) {

+    *Size = BufferSize;

+  }

+

+  return Status;

+}

+

+/**

+  Returns a pointer to an allocated buffer that contains the contents of a

+  variable retrieved through the UEFI Runtime Service GetVariable().  This

+  function always uses the EFI_GLOBAL_VARIABLE GUID to retrieve variables.

+  The returned buffer is allocated using AllocatePool().  The caller is

+  responsible for freeing this buffer with FreePool().

+

+  If Name is NULL, then ASSERT().

+  If Value is NULL, then ASSERT().

+

+  @param[in]  Name  The pointer to a Null-terminated Unicode string.

+  @param[out] Value The buffer point saved the variable info.

+  @param[out] Size  The buffer size of the variable.

+

+  @return EFI_OUT_OF_RESOURCES      Allocate buffer failed.

+  @return EFI_SUCCESS               Find the specified variable.

+  @return Others Errors             Return errors from call to gRT->GetVariable.

+

+**/

+EFI_STATUS

+EFIAPI

+GetEfiGlobalVariable2 (

+  IN CONST CHAR16    *Name,

+  OUT VOID           **Value,

+  OUT UINTN          *Size OPTIONAL

+  )

+{

+  return GetVariable2 (Name, &gEfiGlobalVariableGuid, Value, Size);

+}

+

+/**

+  Returns a pointer to an allocated buffer that contains the best matching language

+  from a set of supported languages.

+

+  This function supports both ISO 639-2 and RFC 4646 language codes, but language

+  code types may not be mixed in a single call to this function.  The language

+  code returned is allocated using AllocatePool().  The caller is responsible for

+  freeing the allocated buffer using FreePool().  This function supports a variable

+  argument list that allows the caller to pass in a prioritized list of language

+  codes to test against all the language codes in SupportedLanguages.

+

+  If SupportedLanguages is NULL, then ASSERT().

+

+  @param[in]  SupportedLanguages  A pointer to a Null-terminated ASCII string that

+                                  contains a set of language codes in the format

+                                  specified by Iso639Language.

+  @param[in]  Iso639Language      If not zero, then all language codes are assumed to be

+                                  in ISO 639-2 format.  If zero, then all language

+                                  codes are assumed to be in RFC 4646 language format

+  @param[in]  ...                 A variable argument list that contains pointers to

+                                  Null-terminated ASCII strings that contain one or more

+                                  language codes in the format specified by Iso639Language.

+                                  The first language code from each of these language

+                                  code lists is used to determine if it is an exact or

+                                  close match to any of the language codes in

+                                  SupportedLanguages.  Close matches only apply to RFC 4646

+                                  language codes, and the matching algorithm from RFC 4647

+                                  is used to determine if a close match is present.  If

+                                  an exact or close match is found, then the matching

+                                  language code from SupportedLanguages is returned.  If

+                                  no matches are found, then the next variable argument

+                                  parameter is evaluated.  The variable argument list

+                                  is terminated by a NULL.

+

+  @retval NULL   The best matching language could not be found in SupportedLanguages.

+  @retval NULL   There are not enough resources available to return the best matching

+                 language.

+  @retval Other  A pointer to a Null-terminated ASCII string that is the best matching

+                 language in SupportedLanguages.

+

+**/

+CHAR8 *

+EFIAPI

+GetBestLanguage (

+  IN CONST CHAR8  *SupportedLanguages,

+  IN UINTN        Iso639Language,

+  ...

+  )

+{

+  VA_LIST      Args;

+  CHAR8        *Language;

+  UINTN        CompareLength;

+  UINTN        LanguageLength;

+  CONST CHAR8  *Supported;

+  CHAR8        *BestLanguage;

+

+  ASSERT (SupportedLanguages != NULL);

+

+  VA_START (Args, Iso639Language);

+  while ((Language = VA_ARG (Args, CHAR8 *)) != NULL) {

+    //

+    // Default to ISO 639-2 mode

+    //

+    CompareLength  = 3;

+    LanguageLength = MIN (3, AsciiStrLen (Language));

+

+    //

+    // If in RFC 4646 mode, then determine the length of the first RFC 4646 language code in Language

+    //

+    if (Iso639Language == 0) {

+      for (LanguageLength = 0; Language[LanguageLength] != 0 && Language[LanguageLength] != ';'; LanguageLength++);

+    }

+

+    //

+    // Trim back the length of Language used until it is empty

+    //

+    while (LanguageLength > 0) {

+      //

+      // Loop through all language codes in SupportedLanguages

+      //

+      for (Supported = SupportedLanguages; *Supported != '\0'; Supported += CompareLength) {

+        //

+        // In RFC 4646 mode, then Loop through all language codes in SupportedLanguages

+        //

+        if (Iso639Language == 0) {

+          //

+          // Skip ';' characters in Supported

+          //

+          for (; *Supported != '\0' && *Supported == ';'; Supported++);

+          //

+          // Determine the length of the next language code in Supported

+          //

+          for (CompareLength = 0; Supported[CompareLength] != 0 && Supported[CompareLength] != ';'; CompareLength++);

+          //

+          // If Language is longer than the Supported, then skip to the next language

+          //

+          if (LanguageLength > CompareLength) {

+            continue;

+          }

+        }

+        //

+        // See if the first LanguageLength characters in Supported match Language

+        //

+        if (AsciiStrnCmp (Supported, Language, LanguageLength) == 0) {

+          VA_END (Args);

+          //

+          // Allocate, copy, and return the best matching language code from SupportedLanguages

+          //

+          BestLanguage = AllocateZeroPool (CompareLength + 1);

+          if (BestLanguage == NULL) {

+            return NULL;

+          }

+          return CopyMem (BestLanguage, Supported, CompareLength);

+        }

+      }

+

+      if (Iso639Language != 0) {

+        //

+        // If ISO 639 mode, then each language can only be tested once

+        //

+        LanguageLength = 0;

+      } else {

+        //

+        // If RFC 4646 mode, then trim Language from the right to the next '-' character

+        //

+        for (LanguageLength--; LanguageLength > 0 && Language[LanguageLength] != '-'; LanguageLength--);

+      }

+    }

+  }

+  VA_END (Args);

+

+  //

+  // No matches were found

+  //

+  return NULL;

+}

+

+/**

+  Returns an array of protocol instance that matches the given protocol.

+

+  @param[in]  Protocol      Provides the protocol to search for.

+  @param[out] NoProtocols   The number of protocols returned in Buffer.

+  @param[out] Buffer        A pointer to the buffer to return the requested

+                            array of protocol instances that match Protocol.

+                            The returned buffer is allocated using

+                            EFI_BOOT_SERVICES.AllocatePool().  The caller is

+                            responsible for freeing this buffer with

+                            EFI_BOOT_SERVICES.FreePool().

+

+  @retval EFI_SUCCESS            The array of protocols was returned in Buffer,

+                                 and the number of protocols in Buffer was

+                                 returned in NoProtocols.

+  @retval EFI_NOT_FOUND          No protocols found.

+  @retval EFI_OUT_OF_RESOURCES   There is not enough pool memory to store the

+                                 matching results.

+  @retval EFI_INVALID_PARAMETER  Protocol is NULL.

+  @retval EFI_INVALID_PARAMETER  NoProtocols is NULL.

+  @retval EFI_INVALID_PARAMETER  Buffer is NULL.

+

+**/

+EFI_STATUS

+EFIAPI

+EfiLocateProtocolBuffer (

+  IN  EFI_GUID  *Protocol,

+  OUT UINTN     *NoProtocols,

+  OUT VOID      ***Buffer

+  )

+{

+  EFI_STATUS  Status;

+  UINTN       NoHandles;

+  EFI_HANDLE  *HandleBuffer;

+  UINTN       Index;

+

+  //

+  // Check input parameters

+  //

+  if (Protocol == NULL || NoProtocols == NULL || Buffer == NULL) {

+    return EFI_INVALID_PARAMETER;

+  }

+

+  //

+  // Initialze output parameters

+  //

+  *NoProtocols = 0;

+  *Buffer = NULL;

+

+  //

+  // Retrieve the array of handles that support Protocol

+  //

+  Status = gBS->LocateHandleBuffer (

+                  ByProtocol,

+                  Protocol,

+                  NULL,

+                  &NoHandles,

+                  &HandleBuffer

+                  );

+  if (EFI_ERROR (Status)) {

+    return Status;

+  }

+

+  //

+  // Allocate array of protocol instances

+  //

+  Status = gBS->AllocatePool (

+                  EfiBootServicesData,

+                  NoHandles * sizeof (VOID *),

+                  (VOID **)Buffer

+                  );

+  if (EFI_ERROR (Status)) {

+    //

+    // Free the handle buffer

+    //

+    gBS->FreePool (HandleBuffer);

+    return EFI_OUT_OF_RESOURCES;

+  }

+  ZeroMem (*Buffer, NoHandles * sizeof (VOID *));

+

+  //

+  // Lookup Protocol on each handle in HandleBuffer to fill in the array of

+  // protocol instances.  Handle case where protocol instance was present when

+  // LocateHandleBuffer() was called, but is not present when HandleProtocol()

+  // is called.

+  //

+  for (Index = 0, *NoProtocols = 0; Index < NoHandles; Index++) {

+    Status = gBS->HandleProtocol (

+                    HandleBuffer[Index],

+                    Protocol,

+                    &((*Buffer)[*NoProtocols])

+                    );

+    if (!EFI_ERROR (Status)) {

+      (*NoProtocols)++;

+    }

+  }

+

+  //

+  // Free the handle buffer

+  //

+  gBS->FreePool (HandleBuffer);

+

+  //

+  // Make sure at least one protocol instance was found

+  //

+  if (*NoProtocols == 0) {

+    gBS->FreePool (*Buffer);

+    *Buffer = NULL;

+    return EFI_NOT_FOUND;

+  }

+

+  return EFI_SUCCESS;

+}

+

+/**

+  Open or create a file or directory, possibly creating the chain of

+  directories leading up to the directory.

+

+  EfiOpenFileByDevicePath() first locates EFI_SIMPLE_FILE_SYSTEM_PROTOCOL on

+  FilePath, and opens the root directory of that filesystem with

+  EFI_SIMPLE_FILE_SYSTEM_PROTOCOL.OpenVolume().

+

+  On the remaining device path, the longest initial sequence of

+  FILEPATH_DEVICE_PATH nodes is node-wise traversed with

+  EFI_FILE_PROTOCOL.Open().

+

+  (As a consequence, if OpenMode includes EFI_FILE_MODE_CREATE, and Attributes

+  includes EFI_FILE_DIRECTORY, and each FILEPATH_DEVICE_PATH specifies a single

+  pathname component, then EfiOpenFileByDevicePath() ensures that the specified

+  series of subdirectories exist on return.)

+

+  The EFI_FILE_PROTOCOL identified by the last FILEPATH_DEVICE_PATH node is

+  output to the caller; intermediate EFI_FILE_PROTOCOL instances are closed. If

+  there are no FILEPATH_DEVICE_PATH nodes past the node that identifies the

+  filesystem, then the EFI_FILE_PROTOCOL of the root directory of the

+  filesystem is output to the caller. If a device path node that is different

+  from FILEPATH_DEVICE_PATH is encountered relative to the filesystem, the

+  traversal is stopped with an error, and a NULL EFI_FILE_PROTOCOL is output.

+

+  @param[in,out] FilePath  On input, the device path to the file or directory

+                           to open or create. The caller is responsible for

+                           ensuring that the device path pointed-to by FilePath

+                           is well-formed. On output, FilePath points one past

+                           the last node in the original device path that has

+                           been successfully processed. FilePath is set on

+                           output even if EfiOpenFileByDevicePath() returns an

+                           error.

+

+  @param[out] File         On error, File is set to NULL. On success, File is

+                           set to the EFI_FILE_PROTOCOL of the root directory

+                           of the filesystem, if there are no

+                           FILEPATH_DEVICE_PATH nodes in FilePath; otherwise,

+                           File is set to the EFI_FILE_PROTOCOL identified by

+                           the last node in FilePath.

+

+  @param[in] OpenMode      The OpenMode parameter to pass to

+                           EFI_FILE_PROTOCOL.Open().

+

+  @param[in] Attributes    The Attributes parameter to pass to

+                           EFI_FILE_PROTOCOL.Open().

+

+  @retval EFI_SUCCESS            The file or directory has been opened or

+                                 created.

+

+  @retval EFI_INVALID_PARAMETER  FilePath is NULL; or File is NULL; or FilePath

+                                 contains a device path node, past the node

+                                 that identifies

+                                 EFI_SIMPLE_FILE_SYSTEM_PROTOCOL, that is not a

+                                 FILEPATH_DEVICE_PATH node.

+

+  @retval EFI_OUT_OF_RESOURCES   Memory allocation failed.

+

+  @return                        Error codes propagated from the

+                                 LocateDevicePath() and OpenProtocol() boot

+                                 services, and from the

+                                 EFI_SIMPLE_FILE_SYSTEM_PROTOCOL.OpenVolume()

+                                 and EFI_FILE_PROTOCOL.Open() member functions.

+**/

+EFI_STATUS

+EFIAPI

+EfiOpenFileByDevicePath (

+  IN OUT EFI_DEVICE_PATH_PROTOCOL  **FilePath,

+  OUT    EFI_FILE_PROTOCOL         **File,

+  IN     UINT64                    OpenMode,

+  IN     UINT64                    Attributes

+  )

+{

+  EFI_STATUS                      Status;

+  EFI_HANDLE                      FileSystemHandle;

+  EFI_SIMPLE_FILE_SYSTEM_PROTOCOL *FileSystem;

+  EFI_FILE_PROTOCOL               *LastFile;

+  FILEPATH_DEVICE_PATH            *FilePathNode;

+  CHAR16                          *AlignedPathName;

+  CHAR16                          *PathName;

+  EFI_FILE_PROTOCOL               *NextFile;

+

+  if (File == NULL) {

+    return EFI_INVALID_PARAMETER;

+  }

+  *File = NULL;

+

+  if (FilePath == NULL) {

+    return EFI_INVALID_PARAMETER;

+  }

+

+  //

+  // Look up the filesystem.

+  //

+  Status = gBS->LocateDevicePath (

+                  &gEfiSimpleFileSystemProtocolGuid,

+                  FilePath,

+                  &FileSystemHandle

+                  );

+  if (EFI_ERROR (Status)) {

+    return Status;

+  }

+  Status = gBS->OpenProtocol (

+                  FileSystemHandle,

+                  &gEfiSimpleFileSystemProtocolGuid,

+                  (VOID **)&FileSystem,

+                  gImageHandle,

+                  NULL,

+                  EFI_OPEN_PROTOCOL_GET_PROTOCOL

+                  );

+  if (EFI_ERROR (Status)) {

+    return Status;

+  }

+

+  //

+  // Open the root directory of the filesystem. After this operation succeeds,

+  // we have to release LastFile on error.

+  //

+  Status = FileSystem->OpenVolume (FileSystem, &LastFile);

+  if (EFI_ERROR (Status)) {

+    return Status;

+  }

+

+  //

+  // Traverse the device path nodes relative to the filesystem.

+  //

+  while (!IsDevicePathEnd (*FilePath)) {

+    if (DevicePathType (*FilePath) != MEDIA_DEVICE_PATH ||

+        DevicePathSubType (*FilePath) != MEDIA_FILEPATH_DP) {

+      Status = EFI_INVALID_PARAMETER;

+      goto CloseLastFile;

+    }

+    FilePathNode = (FILEPATH_DEVICE_PATH *)*FilePath;

+

+    //

+    // FilePathNode->PathName may be unaligned, and the UEFI specification

+    // requires pointers that are passed to protocol member functions to be

+    // aligned. Create an aligned copy of the pathname if necessary.

+    //

+    if ((UINTN)FilePathNode->PathName % sizeof *FilePathNode->PathName == 0) {

+      AlignedPathName = NULL;

+      PathName = FilePathNode->PathName;

+    } else {

+      AlignedPathName = AllocateCopyPool (

+                          (DevicePathNodeLength (FilePathNode) -

+                           SIZE_OF_FILEPATH_DEVICE_PATH),

+                          FilePathNode->PathName

+                          );

+      if (AlignedPathName == NULL) {

+        Status = EFI_OUT_OF_RESOURCES;

+        goto CloseLastFile;

+      }

+      PathName = AlignedPathName;

+    }

+

+    //

+    // Open or create the file corresponding to the next pathname fragment.

+    //

+    Status = LastFile->Open (

+                         LastFile,

+                         &NextFile,

+                         PathName,

+                         OpenMode,

+                         Attributes

+                         );

+

+    //

+    // Release any AlignedPathName on both error and success paths; PathName is

+    // no longer needed.

+    //

+    if (AlignedPathName != NULL) {

+      FreePool (AlignedPathName);

+    }

+    if (EFI_ERROR (Status)) {

+      goto CloseLastFile;

+    }

+

+    //

+    // Advance to the next device path node.

+    //

+    LastFile->Close (LastFile);

+    LastFile = NextFile;

+    *FilePath = NextDevicePathNode (FilePathNode);

+  }

+

+  *File = LastFile;

+  return EFI_SUCCESS;

+

+CloseLastFile:

+  LastFile->Close (LastFile);

+

+  //

+  // We are on the error path; we must have set an error Status for returning

+  // to the caller.

+  //

+  ASSERT (EFI_ERROR (Status));

+  return Status;

+}

diff --git a/debugging_demo/memtest86+/efi/Include/src/UefiLib/UefiLibInternal.h b/debugging_demo/memtest86+/efi/Include/src/UefiLib/UefiLibInternal.h
new file mode 100644
index 0000000..d2b2c44
--- /dev/null
+++ b/debugging_demo/memtest86+/efi/Include/src/UefiLib/UefiLibInternal.h
@@ -0,0 +1,38 @@
+/** @file

+  Internal include file for UefiLib.

+

+  Copyright (c) 2007 - 2017, Intel Corporation. All rights reserved.<BR>

+   SPDX-License-Identifier: BSD-2-Clause-Patent

+**/

+

+#ifndef __UEFI_LIB_INTERNAL_H_

+#define __UEFI_LIB_INTERNAL_H_

+

+

+#include <Uefi.h>

+#include <Protocol/DriverBinding.h>

+#include <Protocol/ComponentName.h>

+#include <Protocol/ComponentName2.h>

+#include <Protocol/DriverConfiguration.h>

+#include <Protocol/DriverConfiguration2.h>

+#include <Protocol/DriverDiagnostics.h>

+#include <Protocol/DriverDiagnostics2.h>

+#include <Protocol/LoadedImage.h>

+#include <Protocol/GraphicsOutput.h>

+#include <Protocol/UgaDraw.h>

+#include <Protocol/HiiFont.h>

+

+#include "Efi_Defs_GUID.h"

+#include <Guid/GlobalVariable.h>

+#include <Library/UefiLib.h>

+#include <Library/UefiBootServicesTableLib.h>

+#include <Library/UefiRuntimeServicesTableLib.h>

+#include <Library/BaseLib.h>

+#include <Library/BaseMemoryLib.h>

+#include <Library/DebugLib.h>

+#include <Library/MemoryAllocationLib.h>

+#include <Library/PcdLib.h>

+#include <Library/PrintLib.h>

+#include <Library/DevicePathLib.h>

+

+#endif

diff --git a/debugging_demo/memtest86+/efi/Include/src/UefiLib/UefiLibPrint.c b/debugging_demo/memtest86+/efi/Include/src/UefiLib/UefiLibPrint.c
new file mode 100644
index 0000000..e848a92
--- /dev/null
+++ b/debugging_demo/memtest86+/efi/Include/src/UefiLib/UefiLibPrint.c
@@ -0,0 +1,817 @@
+/** @file

+  Mde UEFI library API implementation.

+  Print to StdErr or ConOut defined in EFI_SYSTEM_TABLE

+

+  Copyright (c) 2007 - 2018, Intel Corporation. All rights reserved.<BR>

+  SPDX-License-Identifier: BSD-2-Clause-Patent

+

+**/

+

+#include "UefiLibInternal.h"

+#include "Efi_Defs.h"

+

+GLOBAL_REMOVE_IF_UNREFERENCED EFI_GRAPHICS_OUTPUT_BLT_PIXEL mEfiColors[16] = {

+  { 0x00, 0x00, 0x00, 0x00 },

+  { 0x98, 0x00, 0x00, 0x00 },

+  { 0x00, 0x98, 0x00, 0x00 },

+  { 0x98, 0x98, 0x00, 0x00 },

+  { 0x00, 0x00, 0x98, 0x00 },

+  { 0x98, 0x00, 0x98, 0x00 },

+  { 0x00, 0x98, 0x98, 0x00 },

+  { 0x98, 0x98, 0x98, 0x00 },

+  { 0x10, 0x10, 0x10, 0x00 },

+  { 0xff, 0x10, 0x10, 0x00 },

+  { 0x10, 0xff, 0x10, 0x00 },

+  { 0xff, 0xff, 0x10, 0x00 },

+  { 0x10, 0x10, 0xff, 0x00 },

+  { 0xf0, 0x10, 0xff, 0x00 },

+  { 0x10, 0xff, 0xff, 0x00 },

+  { 0xff, 0xff, 0xff, 0x00 }

+};

+

+/**

+  Internal function which prints a formatted Unicode string to the console output device

+  specified by Console

+

+  This function prints a formatted Unicode string to the console output device

+  specified by Console and returns the number of Unicode characters that printed

+  to it.  If the length of the formatted Unicode string is greater than PcdUefiLibMaxPrintBufferSize,

+  then only the first PcdUefiLibMaxPrintBufferSize characters are sent to Console.

+  If Format is NULL, then ASSERT().

+  If Format is not aligned on a 16-bit boundary, then ASSERT().

+

+  @param Format   A Null-terminated Unicode format string.

+  @param Console  The output console.

+  @param Marker   A VA_LIST marker for the variable argument list.

+

+  @return The number of Unicode characters in the produced

+          output buffer, not including the Null-terminator.

+**/

+UINTN

+InternalPrint (

+  IN  CONST CHAR16                     *Format,

+  IN  EFI_SIMPLE_TEXT_OUTPUT_PROTOCOL  *Console,

+  IN  VA_LIST                          Marker

+  )

+{

+  EFI_STATUS  Status;

+  UINTN       Return;

+  CHAR16      *Buffer;

+  UINTN       BufferSize;

+

+  ASSERT (Format != NULL);

+  ASSERT (((UINTN) Format & BIT0) == 0);

+  ASSERT (Console != NULL);

+

+  BufferSize = (PcdGet32 (PcdUefiLibMaxPrintBufferSize) + 1) * sizeof (CHAR16);

+

+  Buffer = (CHAR16 *) AllocatePool(BufferSize);

+  ASSERT (Buffer != NULL);

+

+  Return = UnicodeVSPrint (Buffer, BufferSize, Format, Marker);

+

+  if (Console != NULL && Return > 0) {

+    //

+    // To be extra safe make sure Console has been initialized

+    //

+    Status = Console->OutputString (Console, Buffer);

+    if (EFI_ERROR (Status)) {

+      Return = 0;

+    }

+  }

+

+  FreePool (Buffer);

+

+  return Return;

+}

+

+/**

+  Prints a formatted Unicode string to the console output device specified by

+  ConOut defined in the EFI_SYSTEM_TABLE.

+

+  This function prints a formatted Unicode string to the console output device

+  specified by ConOut in EFI_SYSTEM_TABLE and returns the number of Unicode

+  characters that printed to ConOut.  If the length of the formatted Unicode

+  string is greater than PcdUefiLibMaxPrintBufferSize, then only the first

+  PcdUefiLibMaxPrintBufferSize characters are sent to ConOut.

+  If Format is NULL, then ASSERT().

+  If Format is not aligned on a 16-bit boundary, then ASSERT().

+  If gST->ConOut is NULL, then ASSERT().

+

+  @param Format   A Null-terminated Unicode format string.

+  @param ...      A Variable argument list whose contents are accessed based

+                  on the format string specified by Format.

+

+  @return The number of Unicode characters printed to ConOut.

+

+**/

+UINTN

+EFIAPI

+Print (

+  IN CONST CHAR16  *Format,

+  ...

+  )

+{

+  VA_LIST Marker;

+  UINTN   Return;

+

+  VA_START (Marker, Format);

+

+  Return = InternalPrint (Format, gST->ConOut, Marker);

+

+  VA_END (Marker);

+

+  return Return;

+}

+

+/**

+  Prints a formatted Unicode string to the console output device specified by

+  StdErr defined in the EFI_SYSTEM_TABLE.

+

+  This function prints a formatted Unicode string to the console output device

+  specified by StdErr in EFI_SYSTEM_TABLE and returns the number of Unicode

+  characters that printed to StdErr.  If the length of the formatted Unicode

+  string is greater than PcdUefiLibMaxPrintBufferSize, then only the first

+  PcdUefiLibMaxPrintBufferSize characters are sent to StdErr.

+  If Format is NULL, then ASSERT().

+  If Format is not aligned on a 16-bit boundary, then ASSERT().

+  If gST->StdErr is NULL, then ASSERT().

+

+  @param Format   A Null-terminated Unicode format string.

+  @param ...      Variable argument list whose contents are accessed based

+                  on the format string specified by Format.

+

+  @return The number of Unicode characters printed to StdErr.

+

+**/

+UINTN

+EFIAPI

+ErrorPrint (

+  IN CONST CHAR16  *Format,

+  ...

+  )

+{

+  VA_LIST Marker;

+  UINTN   Return;

+

+  VA_START (Marker, Format);

+

+  Return = InternalPrint( Format, gST->StdErr, Marker);

+

+  VA_END (Marker);

+

+  return Return;

+}

+

+

+/**

+  Internal function which prints a formatted ASCII string to the console output device

+  specified by Console

+

+  This function prints a formatted ASCII string to the console output device

+  specified by Console and returns the number of ASCII characters that printed

+  to it.  If the length of the formatted ASCII string is greater than PcdUefiLibMaxPrintBufferSize,

+  then only the first PcdUefiLibMaxPrintBufferSize characters are sent to Console.

+

+  If Format is NULL, then ASSERT().

+

+  @param Format   A Null-terminated ASCII format string.

+  @param Console  The output console.

+  @param Marker   VA_LIST marker for the variable argument list.

+

+  @return The number of Unicode characters in the produced

+          output buffer not including the Null-terminator.

+

+**/

+UINTN

+AsciiInternalPrint (

+  IN  CONST CHAR8                      *Format,

+  IN  EFI_SIMPLE_TEXT_OUTPUT_PROTOCOL  *Console,

+  IN  VA_LIST                          Marker

+  )

+{

+  EFI_STATUS  Status;

+  UINTN       Return;

+  CHAR16      *Buffer;

+  UINTN       BufferSize;

+

+  ASSERT (Format != NULL);

+  ASSERT (Console != NULL);

+

+  BufferSize = (PcdGet32 (PcdUefiLibMaxPrintBufferSize) + 1) * sizeof (CHAR16);

+

+  Buffer = (CHAR16 *) AllocatePool(BufferSize);

+  ASSERT (Buffer != NULL);

+

+  Return = UnicodeVSPrintAsciiFormat (Buffer, BufferSize, Format, Marker);

+

+  if (Console != NULL) {

+    //

+    // To be extra safe make sure Console has been initialized

+    //

+    Status = Console->OutputString (Console, Buffer);

+    if (EFI_ERROR (Status)) {

+      Return = 0;

+    }

+  }

+

+  FreePool (Buffer);

+

+  return Return;

+}

+

+/**

+  Prints a formatted ASCII string to the console output device specified by

+  ConOut defined in the EFI_SYSTEM_TABLE.

+

+  This function prints a formatted ASCII string to the console output device

+  specified by ConOut in EFI_SYSTEM_TABLE and returns the number of ASCII

+  characters that printed to ConOut.  If the length of the formatted ASCII

+  string is greater than PcdUefiLibMaxPrintBufferSize, then only the first

+  PcdUefiLibMaxPrintBufferSize characters are sent to ConOut.

+  If Format is NULL, then ASSERT().

+  If gST->ConOut is NULL, then ASSERT().

+

+  @param Format   A Null-terminated ASCII format string.

+  @param ...      Variable argument list whose contents are accessed based

+                  on the format string specified by Format.

+

+  @return The number of ASCII characters printed to ConOut.

+

+**/

+UINTN

+EFIAPI

+AsciiPrint (

+  IN CONST CHAR8  *Format,

+  ...

+  )

+{

+  VA_LIST Marker;

+  UINTN   Return;

+  ASSERT (Format != NULL);

+

+  VA_START (Marker, Format);

+

+  Return = AsciiInternalPrint( Format, gST->ConOut, Marker);

+

+  VA_END (Marker);

+

+  return Return;

+}

+

+/**

+  Prints a formatted ASCII string to the console output device specified by

+  StdErr defined in the EFI_SYSTEM_TABLE.

+

+  This function prints a formatted ASCII string to the console output device

+  specified by StdErr in EFI_SYSTEM_TABLE and returns the number of ASCII

+  characters that printed to StdErr.  If the length of the formatted ASCII

+  string is greater than PcdUefiLibMaxPrintBufferSize, then only the first

+  PcdUefiLibMaxPrintBufferSize characters are sent to StdErr.

+  If Format is NULL, then ASSERT().

+  If gST->StdErr is NULL, then ASSERT().

+

+  @param Format   A Null-terminated ASCII format string.

+  @param ...      Variable argument list whose contents are accessed based

+                  on the format string specified by Format.

+

+  @return The number of ASCII characters printed to ConErr.

+

+**/

+UINTN

+EFIAPI

+AsciiErrorPrint (

+  IN CONST CHAR8  *Format,

+  ...

+  )

+{

+  VA_LIST Marker;

+  UINTN   Return;

+

+  ASSERT (Format != NULL);

+

+  VA_START (Marker, Format);

+

+  Return = AsciiInternalPrint( Format, gST->StdErr, Marker);

+

+  VA_END (Marker);

+

+  return Return;

+}

+

+/**

+  Internal function to print a formatted Unicode string to a graphics console device specified by

+  ConsoleOutputHandle defined in the EFI_SYSTEM_TABLE at the given (X,Y) coordinates.

+

+  This function prints a formatted Unicode string to the graphics console device

+  specified by ConsoleOutputHandle in EFI_SYSTEM_TABLE and returns the number of

+  Unicode characters printed. The EFI_HII_FONT_PROTOCOL is used to convert the

+  string to a bitmap using the glyphs registered with the

+  HII database.  No wrapping is performed, so any portions of the string the fall

+  outside the active display region will not be displayed.

+

+  If a graphics console device is not associated with the ConsoleOutputHandle

+  defined in the EFI_SYSTEM_TABLE then no string is printed, and 0 is returned.

+  If the EFI_HII_FONT_PROTOCOL is not present in the handle database, then no

+  string is printed, and 0 is returned.

+

+  @param  PointX       An X coordinate to print the string.

+  @param  PointY       A Y coordinate to print the string.

+  @param  Foreground   The foreground color of the string being printed.  This is

+                       an optional parameter that may be NULL.  If it is NULL,

+                       then the foreground color of the current ConOut device

+                       in the EFI_SYSTEM_TABLE is used.

+  @param  Background   The background color of the string being printed.  This is

+                       an optional parameter that may be NULL.  If it is NULL,

+                       then the background color of the current ConOut device

+                       in the EFI_SYSTEM_TABLE is used.

+  @param  Buffer       A Null-terminated Unicode formatted string.

+  @param  PrintNum     The number of Unicode formatted string to be printed.

+

+  @return  The number of Unicode Characters printed. Zero means no any character

+           displayed successfully.

+

+**/

+UINTN

+InternalPrintGraphic (

+  IN UINTN                            PointX,

+  IN UINTN                            PointY,

+  IN EFI_GRAPHICS_OUTPUT_BLT_PIXEL    *Foreground,

+  IN EFI_GRAPHICS_OUTPUT_BLT_PIXEL    *Background,

+  IN CHAR16                           *Buffer,

+  IN UINTN                            PrintNum

+  )

+{

+  EFI_STATUS                          Status;

+  UINT32                              HorizontalResolution;

+  UINT32                              VerticalResolution;

+  UINT32                              ColorDepth;

+  UINT32                              RefreshRate;

+  EFI_HII_FONT_PROTOCOL               *HiiFont;

+  EFI_IMAGE_OUTPUT                    *Blt;

+  EFI_FONT_DISPLAY_INFO               FontInfo;

+  EFI_HII_ROW_INFO                    *RowInfoArray;

+  UINTN                               RowInfoArraySize;

+  EFI_GRAPHICS_OUTPUT_PROTOCOL        *GraphicsOutput;

+  EFI_UGA_DRAW_PROTOCOL               *UgaDraw;

+  EFI_SIMPLE_TEXT_OUTPUT_PROTOCOL     *Sto;

+  EFI_HANDLE                          ConsoleHandle;

+  UINTN                               Width;

+  UINTN                               Height;

+  UINTN                               Delta;

+

+  HorizontalResolution  = 0;

+  VerticalResolution    = 0;

+  Blt                   = NULL;

+  RowInfoArray          = NULL;

+

+  ConsoleHandle = gST->ConsoleOutHandle;

+

+  ASSERT( ConsoleHandle != NULL);

+

+  Status = gBS->HandleProtocol (

+                  ConsoleHandle,

+                  &gEfiGraphicsOutputProtocolGuid,

+                  (VOID **) &GraphicsOutput

+                  );

+

+  UgaDraw = NULL;

+  if (EFI_ERROR (Status) && FeaturePcdGet (PcdUgaConsumeSupport)) {

+    //

+    // If no GOP available, try to open UGA Draw protocol if supported.

+    //

+    GraphicsOutput = NULL;

+

+    Status = gBS->HandleProtocol (

+                    ConsoleHandle,

+                    &gEfiUgaDrawProtocolGuid,

+                    (VOID **) &UgaDraw

+                    );

+  }

+  if (EFI_ERROR (Status)) {

+    goto Error;

+  }

+

+  Status = gBS->HandleProtocol (

+                  ConsoleHandle,

+                  &gEfiSimpleTextOutProtocolGuid,

+                  (VOID **) &Sto

+                  );

+

+  if (EFI_ERROR (Status)) {

+    goto Error;

+  }

+

+  if (GraphicsOutput != NULL) {

+    HorizontalResolution = GraphicsOutput->Mode->Info->HorizontalResolution;

+    VerticalResolution = GraphicsOutput->Mode->Info->VerticalResolution;

+  } else if (UgaDraw != NULL && FeaturePcdGet (PcdUgaConsumeSupport)) {

+    UgaDraw->GetMode (UgaDraw, &HorizontalResolution, &VerticalResolution, &ColorDepth, &RefreshRate);

+  } else {

+    goto Error;

+  }

+

+  ASSERT ((HorizontalResolution != 0) && (VerticalResolution !=0));

+

+  Status = gBS->LocateProtocol (&gEfiHiiFontProtocolGuid, NULL, (VOID **) &HiiFont);

+  if (EFI_ERROR (Status)) {

+    goto Error;

+  }

+

+  Blt = (EFI_IMAGE_OUTPUT *) AllocateZeroPool (sizeof (EFI_IMAGE_OUTPUT));

+  ASSERT (Blt != NULL);

+

+  Blt->Width        = (UINT16) (HorizontalResolution);

+  Blt->Height       = (UINT16) (VerticalResolution);

+

+  ZeroMem (&FontInfo, sizeof (EFI_FONT_DISPLAY_INFO));

+

+  if (Foreground != NULL) {

+    CopyMem (&FontInfo.ForegroundColor, Foreground, sizeof (EFI_GRAPHICS_OUTPUT_BLT_PIXEL));

+  } else {

+    CopyMem (

+      &FontInfo.ForegroundColor,

+      &mEfiColors[Sto->Mode->Attribute & 0x0f],

+      sizeof (EFI_GRAPHICS_OUTPUT_BLT_PIXEL)

+      );

+  }

+  if (Background != NULL) {

+    CopyMem (&FontInfo.BackgroundColor, Background, sizeof (EFI_GRAPHICS_OUTPUT_BLT_PIXEL));

+  } else {

+    CopyMem (

+      &FontInfo.BackgroundColor,

+      &mEfiColors[Sto->Mode->Attribute >> 4],

+      sizeof (EFI_GRAPHICS_OUTPUT_BLT_PIXEL)

+      );

+  }

+

+  if (GraphicsOutput != NULL) {

+    Blt->Image.Screen = GraphicsOutput;

+

+    Status = HiiFont->StringToImage (

+                         HiiFont,

+                         EFI_HII_IGNORE_IF_NO_GLYPH | EFI_HII_OUT_FLAG_CLIP |

+                         EFI_HII_OUT_FLAG_CLIP_CLEAN_X | EFI_HII_OUT_FLAG_CLIP_CLEAN_Y |

+                         EFI_HII_IGNORE_LINE_BREAK | EFI_HII_DIRECT_TO_SCREEN,

+                         Buffer,

+                         &FontInfo,

+                         &Blt,

+                         PointX,

+                         PointY,

+                         &RowInfoArray,

+                         &RowInfoArraySize,

+                         NULL

+                         );

+    if (EFI_ERROR (Status)) {

+      goto Error;

+    }

+

+  } else if (FeaturePcdGet (PcdUgaConsumeSupport)) {

+    ASSERT (UgaDraw!= NULL);

+

+    //

+    // Ensure Width * Height * sizeof (EFI_GRAPHICS_OUTPUT_BLT_PIXEL) doesn't overflow.

+    //

+    if (Blt->Width > DivU64x32 (MAX_UINTN, Blt->Height * sizeof (EFI_GRAPHICS_OUTPUT_BLT_PIXEL))) {

+      goto Error;

+    }

+

+    Blt->Image.Bitmap = AllocateZeroPool ((UINT32) Blt->Width * Blt->Height * sizeof (EFI_GRAPHICS_OUTPUT_BLT_PIXEL));

+    ASSERT (Blt->Image.Bitmap != NULL);

+

+    //

+    //  StringToImage only support blt'ing image to device using GOP protocol. If GOP is not supported in this platform,

+    //  we ask StringToImage to print the string to blt buffer, then blt to device using UgaDraw.

+    //

+    Status = HiiFont->StringToImage (

+                         HiiFont,

+                         EFI_HII_IGNORE_IF_NO_GLYPH | EFI_HII_OUT_FLAG_CLIP |

+                         EFI_HII_OUT_FLAG_CLIP_CLEAN_X | EFI_HII_OUT_FLAG_CLIP_CLEAN_Y |

+                         EFI_HII_IGNORE_LINE_BREAK,

+                         Buffer,

+                         &FontInfo,

+                         &Blt,

+                         PointX,

+                         PointY,

+                         &RowInfoArray,

+                         &RowInfoArraySize,

+                         NULL

+                         );

+

+    if (!EFI_ERROR (Status)) {

+      ASSERT (RowInfoArray != NULL);

+      //

+      // Explicit Line break characters are ignored, so the updated parameter RowInfoArraySize by StringToImage will

+      // always be 1 or 0 (if there is no valid Unicode Char can be printed). ASSERT here to make sure.

+      //

+      ASSERT (RowInfoArraySize <= 1);

+

+      if (RowInfoArraySize != 0) {

+        Width  = RowInfoArray[0].LineWidth;

+        Height = RowInfoArray[0].LineHeight;

+        Delta  = Blt->Width * sizeof (EFI_GRAPHICS_OUTPUT_BLT_PIXEL);

+      } else {

+        Width  = 0;

+        Height = 0;

+        Delta  = 0;

+      }

+      Status = UgaDraw->Blt (

+                          UgaDraw,

+                          (EFI_UGA_PIXEL *) Blt->Image.Bitmap,

+                          EfiUgaBltBufferToVideo,

+                          PointX,

+                          PointY,

+                          PointX,

+                          PointY,

+                          Width,

+                          Height,

+                          Delta

+                          );

+    } else {

+      goto Error;

+    }

+    FreePool (Blt->Image.Bitmap);

+  } else {

+    goto Error;

+  }

+  //

+  // Calculate the number of actual printed characters

+  //

+  if (RowInfoArraySize != 0) {

+    PrintNum = RowInfoArray[0].EndIndex - RowInfoArray[0].StartIndex + 1;

+  } else {

+    PrintNum = 0;

+  }

+

+  FreePool (RowInfoArray);

+  FreePool (Blt);

+  return PrintNum;

+

+Error:

+  if (Blt != NULL) {

+    FreePool (Blt);

+  }

+  return 0;

+}

+

+/**

+  Prints a formatted Unicode string to a graphics console device specified by

+  ConsoleOutputHandle defined in the EFI_SYSTEM_TABLE at the given (X,Y) coordinates.

+

+  This function prints a formatted Unicode string to the graphics console device

+  specified by ConsoleOutputHandle in EFI_SYSTEM_TABLE and returns the number of

+  Unicode characters displayed, not including partial characters that may be clipped

+  by the right edge of the display.  If the length of the formatted Unicode string is

+  greater than PcdUefiLibMaxPrintBufferSize, then at most the first

+  PcdUefiLibMaxPrintBufferSize characters are printed.The EFI_HII_FONT_PROTOCOL

+  StringToImage() service is used to convert the string to a bitmap using the glyphs

+  registered with the HII database. No wrapping is performed, so any portions of the

+  string the fall outside the active display region will not be displayed. Please see

+  Section 27.2.6 of the UEFI Specification for a description of the supported string

+  format including the set of control codes supported by the StringToImage() service.

+

+  If a graphics console device is not associated with the ConsoleOutputHandle

+  defined in the EFI_SYSTEM_TABLE then no string is printed, and 0 is returned.

+  If the EFI_HII_FONT_PROTOCOL is not present in the handle database, then no

+  string is printed, and 0 is returned.

+  If Format is NULL, then ASSERT().

+  If Format is not aligned on a 16-bit boundary, then ASSERT().

+  If gST->ConsoleOutputHandle is NULL, then ASSERT().

+

+  @param  PointX       An X coordinate to print the string.

+  @param  PointY       A Y coordinate to print the string.

+  @param  ForeGround   The foreground color of the string being printed.  This is

+                       an optional parameter that may be NULL.  If it is NULL,

+                       then the foreground color of the current ConOut device

+                       in the EFI_SYSTEM_TABLE is used.

+  @param  BackGround   The background color of the string being printed.  This is

+                       an optional parameter that may be NULL.  If it is NULL,

+                       then the background color of the current ConOut device

+                       in the EFI_SYSTEM_TABLE is used.

+  @param  Format       A Null-terminated Unicode format string.  See Print Library

+                       for the supported format string syntax.

+  @param  ...          A Variable argument list whose contents are accessed based on

+                       the format string specified by Format.

+

+  @return  The number of Unicode characters printed.

+

+**/

+UINTN

+EFIAPI

+PrintXY (

+  IN UINTN                            PointX,

+  IN UINTN                            PointY,

+  IN EFI_GRAPHICS_OUTPUT_BLT_PIXEL    *ForeGround, OPTIONAL

+  IN EFI_GRAPHICS_OUTPUT_BLT_PIXEL    *BackGround, OPTIONAL

+  IN CONST CHAR16                     *Format,

+  ...

+  )

+{

+  VA_LIST                             Marker;

+  CHAR16                              *Buffer;

+  UINTN                               BufferSize;

+  UINTN                               PrintNum;

+  UINTN                               ReturnNum;

+

+  ASSERT (Format != NULL);

+  ASSERT (((UINTN) Format & BIT0) == 0);

+

+  VA_START (Marker, Format);

+

+  BufferSize = (PcdGet32 (PcdUefiLibMaxPrintBufferSize) + 1) * sizeof (CHAR16);

+

+  Buffer = (CHAR16 *) AllocatePool (BufferSize);

+  ASSERT (Buffer != NULL);

+

+  PrintNum = UnicodeVSPrint (Buffer, BufferSize, Format, Marker);

+

+  VA_END (Marker);

+

+  ReturnNum = InternalPrintGraphic (PointX, PointY, ForeGround, BackGround, Buffer, PrintNum);

+

+  FreePool (Buffer);

+

+  return ReturnNum;

+}

+

+/**

+  Prints a formatted ASCII string to a graphics console device specified by

+  ConsoleOutputHandle defined in the EFI_SYSTEM_TABLE at the given (X,Y) coordinates.

+

+  This function prints a formatted ASCII string to the graphics console device

+  specified by ConsoleOutputHandle in EFI_SYSTEM_TABLE and returns the number of

+  ASCII characters displayed, not including partial characters that may be clipped

+  by the right edge of the display.  If the length of the formatted ASCII string is

+  greater than PcdUefiLibMaxPrintBufferSize, then at most the first

+  PcdUefiLibMaxPrintBufferSize characters are printed.The EFI_HII_FONT_PROTOCOL

+  StringToImage() service is used to convert the string to a bitmap using the glyphs

+  registered with the HII database. No wrapping is performed, so any portions of the

+  string the fall outside the active display region will not be displayed. Please see

+  Section 27.2.6 of the UEFI Specification for a description of the supported string

+  format including the set of control codes supported by the StringToImage() service.

+

+  If a graphics console device is not associated with the ConsoleOutputHandle

+  defined in the EFI_SYSTEM_TABLE then no string is printed, and 0 is returned.

+  If the EFI_HII_FONT_PROTOCOL is not present in the handle database, then no

+  string is printed, and 0 is returned.

+  If Format is NULL, then ASSERT().

+  If gST->ConsoleOutputHandle is NULL, then ASSERT().

+

+  @param  PointX       An X coordinate to print the string.

+  @param  PointY       A Y coordinate to print the string.

+  @param  ForeGround   The foreground color of the string being printed.  This is

+                       an optional parameter that may be NULL.  If it is NULL,

+                       then the foreground color of the current ConOut device

+                       in the EFI_SYSTEM_TABLE is used.

+  @param  BackGround   The background color of the string being printed.  This is

+                       an optional parameter that may be NULL.  If it is NULL,

+                       then the background color of the current ConOut device

+                       in the EFI_SYSTEM_TABLE is used.

+  @param  Format       A Null-terminated ASCII format string.  See Print Library

+                       for the supported format string syntax.

+  @param  ...          Variable argument list whose contents are accessed based on

+                       the format string specified by Format.

+

+  @return  The number of ASCII characters printed.

+

+**/

+UINTN

+EFIAPI

+AsciiPrintXY (

+  IN UINTN                            PointX,

+  IN UINTN                            PointY,

+  IN EFI_GRAPHICS_OUTPUT_BLT_PIXEL    *ForeGround, OPTIONAL

+  IN EFI_GRAPHICS_OUTPUT_BLT_PIXEL    *BackGround, OPTIONAL

+  IN CONST CHAR8                      *Format,

+  ...

+  )

+{

+  VA_LIST                             Marker;

+  CHAR16                              *Buffer;

+  UINTN                               BufferSize;

+  UINTN                               PrintNum;

+  UINTN                               ReturnNum;

+

+  ASSERT (Format != NULL);

+

+  VA_START (Marker, Format);

+

+  BufferSize = (PcdGet32 (PcdUefiLibMaxPrintBufferSize) + 1) * sizeof (CHAR16);

+

+  Buffer = (CHAR16 *) AllocatePool (BufferSize);

+  ASSERT (Buffer != NULL);

+

+  PrintNum = UnicodeSPrintAsciiFormat (Buffer, BufferSize, Format, Marker);

+

+  VA_END (Marker);

+

+  ReturnNum = InternalPrintGraphic (PointX, PointY, ForeGround, BackGround, Buffer, PrintNum);

+

+  FreePool (Buffer);

+

+  return ReturnNum;

+}

+

+/**

+  Appends a formatted Unicode string to a Null-terminated Unicode string

+

+  This function appends a formatted Unicode string to the Null-terminated

+  Unicode string specified by String.   String is optional and may be NULL.

+  Storage for the formatted Unicode string returned is allocated using

+  AllocatePool().  The pointer to the appended string is returned.  The caller

+  is responsible for freeing the returned string.

+

+  If String is not NULL and not aligned on a 16-bit boundary, then ASSERT().

+  If FormatString is NULL, then ASSERT().

+  If FormatString is not aligned on a 16-bit boundary, then ASSERT().

+

+  @param[in] String         A Null-terminated Unicode string.

+  @param[in] FormatString   A Null-terminated Unicode format string.

+  @param[in]  Marker        VA_LIST marker for the variable argument list.

+

+  @retval NULL    There was not enough available memory.

+  @return         Null-terminated Unicode string is that is the formatted

+                  string appended to String.

+**/

+CHAR16*

+EFIAPI

+CatVSPrint (

+  IN  CHAR16  *String, OPTIONAL

+  IN  CONST CHAR16  *FormatString,

+  IN  VA_LIST       Marker

+  )

+{

+  UINTN   CharactersRequired;

+  UINTN   SizeRequired;

+  CHAR16  *BufferToReturn;

+  VA_LIST ExtraMarker;

+

+  VA_COPY (ExtraMarker, Marker);

+  CharactersRequired = SPrintLength(FormatString, ExtraMarker);

+  VA_END (ExtraMarker);

+

+  if (String != NULL) {

+    SizeRequired = StrSize(String) + (CharactersRequired * sizeof(CHAR16));

+  } else {

+    SizeRequired = sizeof(CHAR16) + (CharactersRequired * sizeof(CHAR16));

+  }

+

+  BufferToReturn = AllocatePool(SizeRequired);

+

+  if (BufferToReturn == NULL) {

+    return NULL;

+  } else {

+    BufferToReturn[0] = L'\0';

+  }

+

+  if (String != NULL) {

+    StrCpyS(BufferToReturn, SizeRequired / sizeof(CHAR16), String);

+  }

+

+  UnicodeVSPrint(BufferToReturn + StrLen(BufferToReturn), (CharactersRequired+1) * sizeof(CHAR16), FormatString, Marker);

+

+  ASSERT(StrSize(BufferToReturn)==SizeRequired);

+

+  return (BufferToReturn);

+}

+

+/**

+  Appends a formatted Unicode string to a Null-terminated Unicode string

+

+  This function appends a formatted Unicode string to the Null-terminated

+  Unicode string specified by String.   String is optional and may be NULL.

+  Storage for the formatted Unicode string returned is allocated using

+  AllocatePool().  The pointer to the appended string is returned.  The caller

+  is responsible for freeing the returned string.

+

+  If String is not NULL and not aligned on a 16-bit boundary, then ASSERT().

+  If FormatString is NULL, then ASSERT().

+  If FormatString is not aligned on a 16-bit boundary, then ASSERT().

+

+  @param[in] String         A Null-terminated Unicode string.

+  @param[in] FormatString   A Null-terminated Unicode format string.

+  @param[in] ...            The variable argument list whose contents are

+                            accessed based on the format string specified by

+                            FormatString.

+

+  @retval NULL    There was not enough available memory.

+  @return         Null-terminated Unicode string is that is the formatted

+                  string appended to String.

+**/

+CHAR16 *

+EFIAPI

+CatSPrint (

+  IN  CHAR16  *String, OPTIONAL

+  IN  CONST CHAR16  *FormatString,

+  ...

+  )

+{

+  VA_LIST   Marker;

+  CHAR16    *NewString;

+

+  VA_START (Marker, FormatString);

+  NewString = CatVSPrint(String, FormatString, Marker);

+  VA_END (Marker);

+  return NewString;

+}

+

diff --git a/debugging_demo/memtest86+/efi/Include/src/UefiLib/UefiNotTiano.c b/debugging_demo/memtest86+/efi/Include/src/UefiLib/UefiNotTiano.c
new file mode 100644
index 0000000..5e32f4a
--- /dev/null
+++ b/debugging_demo/memtest86+/efi/Include/src/UefiLib/UefiNotTiano.c
@@ -0,0 +1,330 @@
+/** @file

+  Library functions that abstract areas of conflict between framework and UEFI 2.0.

+

+  Help Port Framework code that has conflicts with UEFI 2.0 by hiding the

+  old conflicts with library functions and supporting implementations of the old

+  (EDK/EFI 1.10) and new (EDK II/UEFI 2.0) way. This module is a DXE driver as

+  it contains DXE enum extensions for EFI event services.

+

+Copyright (c) 2006 - 2018, Intel Corporation. All rights reserved.<BR>

+SPDX-License-Identifier: BSD-2-Clause-Patent

+

+**/

+

+

+

+#include "UefiLibInternal.h"

+

+/**

+  Creates an EFI event in the Legacy Boot Event Group.

+

+  Prior to UEFI 2.0 this was done via a non blessed UEFI extensions and this library

+  abstracts the implementation mechanism of this event from the caller. This function

+  abstracts the creation of the Legacy Boot Event. The Framework moved from a proprietary

+  to UEFI 2.0 based mechanism.  This library abstracts the caller from how this event

+  is created to prevent to code form having to change with the version of the

+  specification supported.

+  If LegacyBootEvent is NULL, then ASSERT().

+

+  @param  LegacyBootEvent   Returns the EFI event returned from gBS->CreateEvent(Ex).

+

+  @retval EFI_SUCCESS       Event was created.

+  @retval Other             Event was not created.

+

+**/

+EFI_STATUS

+EFIAPI

+EfiCreateEventLegacyBoot (

+  OUT EFI_EVENT  *LegacyBootEvent

+  )

+{

+  return EfiCreateEventLegacyBootEx (

+           TPL_CALLBACK,

+           EfiEventEmptyFunction,

+           NULL,

+           LegacyBootEvent

+           );

+}

+

+/**

+  Create an EFI event in the Legacy Boot Event Group and allows

+  the caller to specify a notification function.

+

+  This function abstracts the creation of the Legacy Boot Event.

+  The Framework moved from a proprietary to UEFI 2.0 based mechanism.

+  This library abstracts the caller from how this event is created to prevent

+  to code form having to change with the version of the specification supported.

+  If LegacyBootEvent is NULL, then ASSERT().

+

+  @param  NotifyTpl         The task priority level of the event.

+  @param  NotifyFunction    The notification function to call when the event is signaled.

+  @param  NotifyContext     The content to pass to NotifyFunction when the event is signaled.

+  @param  LegacyBootEvent   Returns the EFI event returned from gBS->CreateEvent(Ex).

+

+  @retval EFI_SUCCESS       Event was created.

+  @retval Other             Event was not created.

+

+**/

+EFI_STATUS

+EFIAPI

+EfiCreateEventLegacyBootEx (

+  IN  EFI_TPL           NotifyTpl,

+  IN  EFI_EVENT_NOTIFY  NotifyFunction,  OPTIONAL

+  IN  VOID              *NotifyContext,  OPTIONAL

+  OUT EFI_EVENT         *LegacyBootEvent

+  )

+{

+  EFI_STATUS        Status;

+  EFI_EVENT_NOTIFY  WorkerNotifyFunction;

+

+  ASSERT (LegacyBootEvent != NULL);

+

+  if (gST->Hdr.Revision < EFI_2_00_SYSTEM_TABLE_REVISION) {

+    DEBUG ((EFI_D_ERROR, "EFI1.1 can't support LegacyBootEvent!"));

+    ASSERT (FALSE);

+

+    return EFI_UNSUPPORTED;

+  } else {

+    //

+    // For UEFI 2.0 and the future use an Event Group

+    //

+    if (NotifyFunction == NULL) {

+      //

+      // CreateEventEx will check NotifyFunction is NULL or not and return error.

+      // Use dummy routine for the case NotifyFunction is NULL.

+      //

+      WorkerNotifyFunction = EfiEventEmptyFunction;

+    } else {

+      WorkerNotifyFunction = NotifyFunction;

+    }

+    Status = gBS->CreateEventEx (

+                    EVT_NOTIFY_SIGNAL,

+                    NotifyTpl,

+                    WorkerNotifyFunction,

+                    NotifyContext,

+                    &gEfiEventLegacyBootGuid,

+                    LegacyBootEvent

+                    );

+  }

+

+  return Status;

+}

+

+/**

+  Create an EFI event in the Ready To Boot Event Group.

+

+  Prior to UEFI 2.0 this was done via a non-standard UEFI extension, and this library

+  abstracts the implementation mechanism of this event from the caller.

+  This function abstracts the creation of the Ready to Boot Event.  The Framework

+  moved from a proprietary to UEFI 2.0-based mechanism.  This library abstracts

+  the caller from how this event is created to prevent the code form having to

+  change with the version of the specification supported.

+  If ReadyToBootEvent is NULL, then ASSERT().

+

+  @param  ReadyToBootEvent  Returns the EFI event returned from gBS->CreateEvent(Ex).

+

+  @retval EFI_SUCCESS       Event was created.

+  @retval Other             Event was not created.

+

+**/

+EFI_STATUS

+EFIAPI

+EfiCreateEventReadyToBoot (

+  OUT EFI_EVENT  *ReadyToBootEvent

+  )

+{

+  return EfiCreateEventReadyToBootEx (

+           TPL_CALLBACK,

+           EfiEventEmptyFunction,

+           NULL,

+           ReadyToBootEvent

+           );

+}

+

+/**

+  Create an EFI event in the Ready To Boot Event Group and allows

+  the caller to specify a notification function.

+

+  This function abstracts the creation of the Ready to Boot Event.

+  The Framework moved from a proprietary to UEFI 2.0 based mechanism.

+  This library abstracts the caller from how this event is created to prevent

+  to code form having to change with the version of the specification supported.

+  If ReadyToBootEvent is NULL, then ASSERT().

+

+  @param  NotifyTpl         The task priority level of the event.

+  @param  NotifyFunction    The notification function to call when the event is signaled.

+  @param  NotifyContext     The content to pass to NotifyFunction when the event is signaled.

+  @param  ReadyToBootEvent  Returns the EFI event returned from gBS->CreateEvent(Ex).

+

+  @retval EFI_SUCCESS       Event was created.

+  @retval Other             Event was not created.

+

+**/

+EFI_STATUS

+EFIAPI

+EfiCreateEventReadyToBootEx (

+  IN  EFI_TPL           NotifyTpl,

+  IN  EFI_EVENT_NOTIFY  NotifyFunction,  OPTIONAL

+  IN  VOID              *NotifyContext,  OPTIONAL

+  OUT EFI_EVENT         *ReadyToBootEvent

+  )

+{

+  EFI_STATUS        Status;

+  EFI_EVENT_NOTIFY  WorkerNotifyFunction;

+

+  ASSERT (ReadyToBootEvent != NULL);

+

+  if (gST->Hdr.Revision < EFI_2_00_SYSTEM_TABLE_REVISION) {

+    DEBUG ((EFI_D_ERROR, "EFI1.1 can't support ReadyToBootEvent!"));

+    ASSERT (FALSE);

+

+    return EFI_UNSUPPORTED;

+  } else {

+    //

+    // For UEFI 2.0 and the future use an Event Group

+    //

+    if (NotifyFunction == NULL) {

+      //

+      // CreateEventEx will check NotifyFunction is NULL or not and return error.

+      // Use dummy routine for the case NotifyFunction is NULL.

+      //

+      WorkerNotifyFunction = EfiEventEmptyFunction;

+    } else {

+      WorkerNotifyFunction = NotifyFunction;

+    }

+    Status = gBS->CreateEventEx (

+                    EVT_NOTIFY_SIGNAL,

+                    NotifyTpl,

+                    WorkerNotifyFunction,

+                    NotifyContext,

+                    &gEfiEventReadyToBootGuid,

+                    ReadyToBootEvent

+                    );

+  }

+

+  return Status;

+}

+

+

+/**

+  Create, Signal, and Close the Ready to Boot event using EfiSignalEventReadyToBoot().

+

+  This function abstracts the signaling of the Ready to Boot Event. The Framework moved

+  from a proprietary to UEFI 2.0 based mechanism. This library abstracts the caller

+  from how this event is created to prevent to code form having to change with the

+  version of the specification supported.

+

+**/

+VOID

+EFIAPI

+EfiSignalEventReadyToBoot (

+  VOID

+  )

+{

+  EFI_STATUS    Status;

+  EFI_EVENT     ReadyToBootEvent;

+

+  Status = EfiCreateEventReadyToBoot (&ReadyToBootEvent);

+  if (!EFI_ERROR (Status)) {

+    gBS->SignalEvent (ReadyToBootEvent);

+    gBS->CloseEvent (ReadyToBootEvent);

+  }

+}

+

+/**

+  Create, Signal, and Close the Ready to Boot event using EfiSignalEventLegacyBoot().

+

+  This function abstracts the signaling of the Legacy Boot Event. The Framework moved from

+  a proprietary to UEFI 2.0 based mechanism.  This library abstracts the caller from how

+  this event is created to prevent to code form having to change with the version of the

+  specification supported.

+

+**/

+VOID

+EFIAPI

+EfiSignalEventLegacyBoot (

+  VOID

+  )

+{

+  EFI_STATUS    Status;

+  EFI_EVENT     LegacyBootEvent;

+

+  Status = EfiCreateEventLegacyBoot (&LegacyBootEvent);

+  if (!EFI_ERROR (Status)) {

+    gBS->SignalEvent (LegacyBootEvent);

+    gBS->CloseEvent (LegacyBootEvent);

+  }

+}

+

+

+/**

+  Check to see if the Firmware Volume (FV) Media Device Path is valid

+

+  The Framework FwVol Device Path changed to conform to the UEFI 2.0 specification.

+  This library function abstracts validating a device path node.

+  Check the MEDIA_FW_VOL_FILEPATH_DEVICE_PATH data structure to see if it's valid.

+  If it is valid, then return the GUID file name from the device path node.  Otherwise,

+  return NULL.  This device path changed in the DXE CIS version 0.92 in a non back ward

+  compatible way to not conflict with the UEFI 2.0 specification.  This function abstracts

+  the differences from the caller.

+  If FvDevicePathNode is NULL, then ASSERT().

+

+  @param  FvDevicePathNode  The pointer to FV device path to check.

+

+  @retval NULL              FvDevicePathNode is not valid.

+  @retval Other             FvDevicePathNode is valid and pointer to NameGuid was returned.

+

+**/

+EFI_GUID *

+EFIAPI

+EfiGetNameGuidFromFwVolDevicePathNode (

+  IN CONST MEDIA_FW_VOL_FILEPATH_DEVICE_PATH  *FvDevicePathNode

+  )

+{

+  ASSERT (FvDevicePathNode != NULL);

+

+  if (DevicePathType (&FvDevicePathNode->Header) == MEDIA_DEVICE_PATH &&

+      DevicePathSubType (&FvDevicePathNode->Header) == MEDIA_PIWG_FW_FILE_DP) {

+    return (EFI_GUID *) &FvDevicePathNode->FvFileName;

+  }

+

+  return NULL;

+}

+

+

+/**

+  Initialize a Firmware Volume (FV) Media Device Path node.

+

+  The Framework FwVol Device Path changed to conform to the UEFI 2.0 specification.

+  This library function abstracts initializing a device path node.

+  Initialize the MEDIA_FW_VOL_FILEPATH_DEVICE_PATH data structure.  This device

+  path changed in the DXE CIS version 0.92 in a non back ward compatible way to

+  not conflict with the UEFI 2.0 specification.  This function abstracts the

+  differences from the caller.

+  If FvDevicePathNode is NULL, then ASSERT().

+  If NameGuid is NULL, then ASSERT().

+

+  @param  FvDevicePathNode  The pointer to a FV device path node to initialize

+  @param  NameGuid          FV file name to use in FvDevicePathNode

+

+**/

+VOID

+EFIAPI

+EfiInitializeFwVolDevicepathNode (

+  IN OUT MEDIA_FW_VOL_FILEPATH_DEVICE_PATH  *FvDevicePathNode,

+  IN CONST EFI_GUID                         *NameGuid

+  )

+{

+  ASSERT (FvDevicePathNode != NULL);

+  ASSERT (NameGuid          != NULL);

+

+  //

+  // Use the new Device path that does not conflict with the UEFI

+  //

+  FvDevicePathNode->Header.Type     = MEDIA_DEVICE_PATH;

+  FvDevicePathNode->Header.SubType  = MEDIA_PIWG_FW_FILE_DP;

+  SetDevicePathNodeLength (&FvDevicePathNode->Header, sizeof (MEDIA_FW_VOL_FILEPATH_DEVICE_PATH));

+

+  CopyGuid (&FvDevicePathNode->FvFileName, NameGuid);

+}

+

diff --git a/debugging_demo/memtest86+/efi/Include/src/UefiRuntimeServicesTableLib.c b/debugging_demo/memtest86+/efi/Include/src/UefiRuntimeServicesTableLib.c
new file mode 100644
index 0000000..e2e9193
--- /dev/null
+++ b/debugging_demo/memtest86+/efi/Include/src/UefiRuntimeServicesTableLib.c
@@ -0,0 +1,43 @@
+/** @file

+  UEFI Runtime Services Table Library.

+

+  This library instance retrieve EFI_RUNTIME_SERVICES pointer from EFI system table

+  in library's constructor.

+

+  Copyright (c) 2006 - 2008, Intel Corporation. All rights reserved.<BR>

+  SPDX-License-Identifier: BSD-2-Clause-Patent

+

+**/

+

+#include <Uefi.h>

+#include <Library/DebugLib.h>

+

+EFI_RUNTIME_SERVICES  *gRT = NULL;

+

+/**

+  The constructor function caches the pointer of Runtime Services Table.

+

+  The constructor function caches the pointer of Runtime Services Table.

+  It will ASSERT() if the pointer of Runtime Services Table is NULL.

+  It will always return EFI_SUCCESS.

+

+  @param  ImageHandle   The firmware allocated handle for the EFI image.

+  @param  SystemTable   A pointer to the EFI System Table.

+

+  @retval EFI_SUCCESS   The constructor always returns EFI_SUCCESS.

+

+**/

+EFI_STATUS

+EFIAPI

+UefiRuntimeServicesTableLibConstructor (

+  IN EFI_HANDLE        ImageHandle,

+  IN EFI_SYSTEM_TABLE  *SystemTable

+  )

+{

+  //

+  // Cache pointer to the EFI Runtime Services Table

+  //

+  gRT = SystemTable->RuntimeServices;

+  ASSERT (gRT != NULL);

+  return EFI_SUCCESS;

+}

diff --git a/debugging_demo/memtest86+/efi/Include/static_library_files (copy).lst b/debugging_demo/memtest86+/efi/Include/static_library_files (copy).lst
new file mode 100644
index 0000000..c0f8931
--- /dev/null
+++ b/debugging_demo/memtest86+/efi/Include/static_library_files (copy).lst
@@ -0,0 +1,13 @@
+OUTPUT/Memtest.lib
+libs/BaseLib.lib
+libs/BaseMemoryLib.lib
+libs/BasePcdLibNull.lib
+libs/BaseDebugPrintErrorLevelLib.lib
+libs/BasePrintLib.lib
+libs/UefiDebugLibStdErr.lib
+libs/UefiBootServicesTableLib.lib
+libs/UefiMemoryAllocationLib.lib
+libs/UefiRuntimeServicesTableLib.lib
+libs/UefiDevicePathLib.lib
+libs/UefiApplicationEntryPoint.lib
+libs/UefiLib.lib
diff --git a/debugging_demo/memtest86+/efi/Include/static_library_files.lst b/debugging_demo/memtest86+/efi/Include/static_library_files.lst
new file mode 100644
index 0000000..c0f8931
--- /dev/null
+++ b/debugging_demo/memtest86+/efi/Include/static_library_files.lst
@@ -0,0 +1,13 @@
+OUTPUT/Memtest.lib
+libs/BaseLib.lib
+libs/BaseMemoryLib.lib
+libs/BasePcdLibNull.lib
+libs/BaseDebugPrintErrorLevelLib.lib
+libs/BasePrintLib.lib
+libs/UefiDebugLibStdErr.lib
+libs/UefiBootServicesTableLib.lib
+libs/UefiMemoryAllocationLib.lib
+libs/UefiRuntimeServicesTableLib.lib
+libs/UefiDevicePathLib.lib
+libs/UefiApplicationEntryPoint.lib
+libs/UefiLib.lib
diff --git a/debugging_demo/memtest86+/efi/Include/stdin.h b/debugging_demo/memtest86+/efi/Include/stdin.h
new file mode 100644
index 0000000..e3a08e1
--- /dev/null
+++ b/debugging_demo/memtest86+/efi/Include/stdin.h
@@ -0,0 +1,52 @@
+#ifndef I386_STDINT_H
+#define I386_STDINT_H
+
+/* Exact integral types */
+typedef unsigned char      uint8_t;
+typedef signed char        int8_t; 
+
+typedef unsigned short     uint16_t;
+typedef signed short       int16_t;
+
+typedef unsigned int       uint32_t;
+typedef signed int         int32_t;
+
+typedef unsigned long long uint64_t;
+typedef signed long long   int64_t;
+
+/* Small types */
+typedef unsigned char      uint_least8_t;
+typedef signed char        int_least8_t; 
+
+typedef unsigned short     uint_least16_t;
+typedef signed short       int_least16_t;
+
+typedef unsigned int       uint_least32_t;
+typedef signed int         int_least32_t;
+
+typedef unsigned long long uint_least64_t;
+typedef signed long long   int_least64_t;
+
+/* Fast Types */
+typedef unsigned char      uint_fast8_t;
+typedef signed char        int_fast8_t; 
+
+typedef unsigned int       uint_fast16_t;
+typedef signed int         int_fast16_t;
+
+typedef unsigned int       uint_fast32_t;
+typedef signed int         int_fast32_t;
+
+typedef unsigned long long uint_fast64_t;
+typedef signed long long   int_fast64_t;
+
+/* Types for `void *' pointers.  */
+typedef int                intptr_t;
+typedef unsigned int       uintptr_t;
+
+/* Largest integral types */
+typedef long long int      intmax_t;
+typedef unsigned long long uintmax_t;
+
+
+#endif /* I386_STDINT_H */
\ No newline at end of file
diff --git a/debugging_demo/run.sh b/debugging_demo/run.sh
new file mode 100755
index 0000000..cff68e8
--- /dev/null
+++ b/debugging_demo/run.sh
@@ -0,0 +1,4 @@
+#!/bin/bash
+
+(cd ../test_code;
+./run.sh)